beta-2

Fixed some typos

.gitignore

@@ -15,5 +15,8 @@ data.json
 lib
 
 #VSCode
-.vscode
-yarn.lock
+.vscode
+yarn.lock
+.DS_Store
+.lock
+.lock

.nvmrc

@@ -0,0 +1 @@
+18

README-BUILD.md

@@ -0,0 +1,32 @@
+The project runs with `node 18`. 
+
+After running `npm -i` you'll need to make two manual changes:
+
+## postprocess
+postprocess is used in rollup.config.js.
+However, the version available on npmjs does not work, after installing packages you need this update: 
+`npm install brettz9/rollup-plugin-postprocess#update --save-dev``
+
+More info here: https://github.com/developit/rollup-plugin-postprocess/issues/10
+
+## colormaster
+1.2.1 misses 3 plugin references after installing the package you need to update
+`node_modules/colormaster/package.json` adding the following to the `exports:` section:
+```typescript
+,
+    "./plugins/luv": {
+      "import": "./plugins/luv.mjs",
+      "require": "./plugins/luv.js",
+      "default": "./plugins/luv.mjs"
+    },
+    "./plugins/uvw": {
+      "import": "./plugins/uvw.mjs",
+      "require": "./plugins/uvw.js",
+      "default": "./plugins/uvw.mjs"
+    },
+    "./plugins/ryb": {
+      "import": "./plugins/ryb.mjs",
+      "require": "./plugins/ryb.js",
+      "default": "./plugins/ryb.mjs"
+    }
+```

README.md

@@ -4,7 +4,9 @@ The Obsidian-Excalidraw plugin integrates [Excalidraw](https://excalidraw.com/),
 
 ## Video Walkthrough
 
-<a href="https://youtu.be/o0exK-xFP3k" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/156931370-aa4d88de-c4a8-46cc-aeb2-dc09aa0bea39.jpg" width="300"/></a>
+<a href="https://youtu.be/o0exK-xFP3k" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/156931370-aa4d88de-c4a8-46cc-aeb2-dc09aa0bea39.jpg" width="300"/></a> 
+<a href="https://youtu.be/QKnQgSjJVuc" target="_blank"><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/thumbnail-getting-started.jpg" width="300"/></a>
+
 
 <details><summary>10 Part (slightly outdated) Video Walkthrough</summary>
 <a href="https://youtu.be/sY4FoflGaiM" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/125160304-7f211180-e17c-11eb-8363-c52723de1ffd.jpg" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;1  Getting Started</a><br>
@@ -27,7 +29,7 @@ The Obsidian-Excalidraw plugin integrates [Excalidraw](https://excalidraw.com/),
 </details>
 <details><summary>The Script Engine Store - Excalidraw Automation</summary>
 <a href="https://youtu.be/hePJcObHIso" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/145684531-8d9c2992-59ac-4ebc-804a-4cce1777ded2.jpg" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;Introducing the Script Engine</a><br>
-<a href="https://youtu.be/lzYdOQ6z8F0" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/147889174-6c306d0d-2d29-46cc-a53f-3f0013cf14de.jpg" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;Script Enginge Store</a><br>
+<a href="https://youtu.be/lzYdOQ6z8F0" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/147889174-6c306d0d-2d29-46cc-a53f-3f0013cf14de.jpg" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;Script Engine Store</a><br>
 </details>
 <details><summary>Working with colors</summary>
 <a href="https://youtu.be/6PLGHBH9VZ4" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/194773147-5418a0ab-6be5-4eb0-a8e4-d6af21b1b483.png" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;Colors - Excalidraw Basics (Custom)</a><br>
@@ -44,7 +46,7 @@ The Obsidian-Excalidraw plugin integrates [Excalidraw](https://excalidraw.com/),
 </details>
 <details><summary>Powertools</summary>
 <a href="https://youtu.be/NOuddK6xrr8" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/147283367-e5689385-ea51-4983-81a3-04d810d39f62.jpg" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;Sticky Notes (word wrapping)</a><br>
-<a href="https://youtu.be/eKFmrSQhFA4" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/149659524-2a4e0a24-40c9-4e66-a6b1-c92f3b88ecd5.jpg" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;Fourt Font</a><br>
+<a href="https://youtu.be/eKFmrSQhFA4" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/149659524-2a4e0a24-40c9-4e66-a6b1-c92f3b88ecd5.jpg" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;Fourth Font</a><br>
 <a href="https://youtu.be/vlC1-iBvIfo" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/199207784-8bbe14e0-7d10-47d7-971d-20dce8dbd659.png" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;SVG import</a><br>
 <a href="https://youtu.be/7gu4ETx7zro" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/202916770-28f2fa64-1ba2-4b40-a7fe-d721b42634f7.png" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;OCR</a><br>
 <a href="https://youtu.be/U2LkBRBk4LY" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/159369910-6371f08d-b5fa-454d-9c6c-948f7e7a7d26.jpg" width="100" style="vertical-align: middle;"/>&nbsp;&nbsp;Bind/unbind text from container, Frontmatter tags to customize export</a><br>
@@ -62,51 +64,46 @@ The Obsidian-Excalidraw plugin integrates [Excalidraw](https://excalidraw.com/),
 
 ## Features
 
-- 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.
+- 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
 
-Settings will allow you to customize Excalidraw to your needs. The plugin comes with tons of settings. I tried adding meaningful explanations to these settings, so please be patient and look for the setting, for most requests a setting already exists.
+Settings will allow you to customize Excalidraw to your needs. The plugin comes with tons of settings. I tried adding meaningful explanations to these settings, so please be patient and look for the setting, for most requests, a setting already exists.
 
 Plugin settings are grouped into the following sections:
-- **Basic settings**: such as default folders to use
-- **Saving**: compression and autosave timer
-- **Filename**: configure the automatically created Excalidraw filename
-- **Display**: settings that effect the handling of Excalidraw (e.g.: left-handed mode, theme settings, mouse wheel and pinch zoom settings, zoom to fit settings)
-- **Links and transclusions**: Settings that effect how links and embedded items behave on the Excalidraw canvas
-- **Markdown-embed settings**: These settings control how markdown documents from your Vault embedded into Excalidraw drawings will behave
-- **Embed & Export**: Settings that control how Excalidraw images are displayed when embedding them into markdown documents
-- **Auto-export Settings**: You can configure Excalidraw to create a PNG or SVG copy of your drawing each time it gets saved
-- **Compatibility features**: Check these settings if you edit the Excalidraw drawings outside Obsidian (e.g. in LogSeq, Visual Studio, on the web, etc.)
+- **Basic settings**: such as default folders to use.
+- **Saving**: compression and autosave timer.
+- **Filename**: configure the automatically created Excalidraw filename.
+- **Display**: settings that effect the handling of Excalidraw (e.g.: left-handed mode, theme settings, mouse wheel and pinch zoom settings, zoom to fit settings).
+- **Links and transclusions**: Settings that effect how links and embedded items behave on the Excalidraw canvas.
+- **Markdown-embed settings**: These settings control how markdown documents from your Vault embedded into Excalidraw drawings will behave.
+- **Embed & Export**: Settings that control how Excalidraw images are displayed when embedding them into markdown documents.
+- **Auto-export Settings**: You can configure Excalidraw to create a PNG or SVG copy of your drawing each time it gets saved.
+- **Compatibility features**: Check these settings if you edit the Excalidraw drawings outside Obsidian (e.g. in LogSeq, Visual Studio, on the web, etc.).
 - **Experimental features**: There are advanced features that are implemented as "clever" hacks. Features include defining a fourth font, adding a custom icon to distinguish Exalidraw files in the Obsidian file explorer, OCR settings, and more.
-- **Settings for installed Scripts**: Some of the scripts you install from the Script Library come with settings. Script settings are installed the first time you run the script. So to access settings for a script, install the script, run it for the first time, then look for the settings in plugin settings.
+- **Settings for installed Scripts**: Some of the scripts you install from the Script Library come with settings. Script settings are installed the first time you run the script. So to access settings for a script, install the script, run it for the first time and then look for the settings in plugin settings.
 
 #### Templates
 
-- 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.
-    - 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.
+- 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.
+  - 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.
 
 #### Export
 
 - 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`.
+  - Auto-export SVG and/or PNG files, including the 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.
@@ -114,141 +111,144 @@ Plugin settings are grouped into the following sections:
 - Enable / disable autosave.
 
 ### Embedding your drawings into markdown documents
-- 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.
-- Excalidraw drawings do not display in Obsidian Publish. If you want to use Excalidraw in your published documents, you can configure in plugin settings, under `Embed & Export`, to automatically insert a PNG or SVG version of the drawing in your document when creating a new file. See `type of file to insert into document`
-    - Under `Export settings` you can also configure to automatically export a dark and light version of the image, in case your published site supports dark and light mode.
 
-### Hyperlinks
-- 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
-- Transclusions are supported
-    - `![[myfile#^blockref]]` will convert in the drawing into the transcluded text of the block
-    - `![[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
-- <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
+- 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.
+- Excalidraw drawings do not display in Obsidian Publish. If you want to use Excalidraw in your published documents, you can configure in plugin settings, under `Embed & Export`, to automatically insert a PNG or SVG version of the drawing in your document when creating a new file. See `type of file to insert into document`
+  - Under `Export settings`, you can also configure to automatically export a dark and light version of the image, in case your published site supports dark and light modes.
+
+### Hyperlinks and Drag & Drop support
+
+![](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/images/excalidraw-modifiers.png)
+
+#### Hyperlinks
+
+- 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 the backlinks of documents.
+- Transclusions are supported:
+  - `![[myfile#^blockref]]` will convert the drawing into the transcluded text of the block
+  - `![[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.
+- <kbd>CTRL/CMD + hover</kbd> to bring up the Obsidian quick preview for the link. (On Mac, it is <kbd>CTRL+CMD+hover</kbd>).
+- Using the block reference, you can also reference & transclude text that appears on drawings, in other documents.
+
+#### Drag & Drop support
+
+- You can drag files from the Obsidian file explorer, and they will become links to those files in Excalidraw. See the table above for the various modifier key combinations.
+- Note: Anchoring an image to 100% of its size is a very niche feature with a very particular behavior that I built primarily for myself.
+  - (even more so than other features in Excalidraw Obsidian - also built primarily for myself 😉).
+  - This will reset your embedded image to 100% size every time you open the Excalidraw drawing,
+      or in case you have embedded an Excalidraw drawing on your canvas inserted using this function,
+      every time you update the embedded drawing, it will be scaled back to 100% size.
+  - This means that even if you resize the image on the drawing, it will reset to 100% the next time you open
+      the file, or you modify the original embedded object. This feature is useful when you
+      decompose a drawing into separate Excalidraw files, but when combined onto a single canvas
+      you want the individual pieces to maintain their actual sizes. I use this feature to
+      construct book-on-a-page summaries from atomic drawings.
+- 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.
+- You can drag and drop YouTube links and thumbnails, and they will be YouTube links with thumbnails in Excalidraw.
 
 ### LaTeX
-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, ICO, GIF, WEBP, Excalidraw) from Obsidian's file explorer while pressing the
-    <kbd>CTRL</kbd> (<kbd>SHIFT</kbd> on Mac) button will embed the image into your drawing.
-    - If in addition to <kbd>CTRL</kbd> or <kbd>SHIFT</kbd> you also hold down <kbd>ALT</kbd>,
-        the image will be inserted at 100% of its size.
-    - Note: this is a very niche feature with a very particular behavior that I built primarily for myself
-    - (even more so than other features in Excalidraw Obsidian - also built primarily for myself 😉).
-    - This will reset your embedded image to 100% size every time you open the Excalidraw drawing,
-        or in case you have embedded an Excalidraw drawing on your canvas inserted using this function,
-        every time you update the embedded drawing, it will be scaled back to 100% size.
-    - This means that even if you resize the image on the drawing, it will reset to 100% the next time you open
-        the file or you modify the original embedded object. This feature is useful when you
-        decompose a drawing into separate Excalidraw files, but when combined onto a single canvas
-        you want the individual pieces to maintain their actual sizes. I use this feature to
-        construct Book-on-a-Page summaries from atomic drawings.
-- 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.
+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.
 
 ### Image support
-- On iOS and Android you can add images from your camera by pressing the add image button in Excalidraw.
+
+- 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.
-- URL link to images on the web: You can drag images from a webpage to Excalidraw. If you hold down the CTRL button while dropping the image to Excalidraw, the image will not be saved to your vault. Excalidraw will load the image from the URL. Note, that if you do not have internet access, or these images are deleted from the internet, they will also disappear from your drawing.
-- If you page an image URL to excalidraw (simply click copy on the url, then click paste on the excalidraw canvas), the image will be inserted with a link to the image on the web. Again, the image won't be save to your vault, only the link.
-- If you drop a YouTube video link it will be convereted into a thumbnail photo with an element link pointing to the video.
+- URL link to images on the web: You can drag images from a webpage to Excalidraw. If you hold down the CTRL button while dropping the image to Excalidraw, the image will not be saved to your vault. Excalidraw will load the image from the URL. Note that if you do not have internet access or if these images are deleted from the internet, they will also disappear from your drawing.
+- If you page an image URL to excalidraw (simply click copy on the url, then click paste on the excalidraw canvas), the image will be inserted with a link to the image on the web. Again, the image won't be saved to your vault, only the link.
+- If you drop a YouTube video link, it will be converted into a thumbnail photo with an element link pointing to the video.
 
 ### Block referencing parts of images
-For more details see this [video](https://youtu.be/yZQoJg2RCKI)
+
+For more details, see this [video](https://youtu.be/yZQoJg2RCKI)
 - 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.
+  - 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 a 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.
 
 ### Markdown
-- 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
-    - Anything you add between the frontmatter and the `# Text Elements` heading will be ignored by Excalidraw, i.e. you can add whatever you like here, it will be preserved as part of the document.
-    - Excalidraw documents now show in graph view.
-    - The following front matter keys will customize how the drawing is displayed - overriding general settings:
-        - `excalidraw-link-prefix: "📍"` preview prefix for internal links
-        - `excalidraw-url-prefix: "🌐"` preview prefix for external links
-        - `excalidraw-link-brackets: true|false` whether or not to display brackets around links in preview
-        - `excalidraw-default-mode: view|zen` Open this document in view mode or zen mode by defult. Default view mode is excellent for presentation slides.
-    - 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-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.
+
+- 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.
+  - Anything you add between the frontmatter and the `# Text Elements` heading will be ignored by Excalidraw, i.e. you can add whatever you like here, and it will be preserved as part of the document.
+  - Excalidraw documents now show up in graph view.
+  - The following front matter keys will customize how the drawing is displayed - overriding general settings:
+    - `excalidraw-link-prefix: "📍"` preview prefix for internal links
+    - `excalidraw-url-prefix: "🌐"` preview prefix for external links
+    - `excalidraw-link-brackets: true|false` whether or not to display brackets around links in preview
+    - `excalidraw-default-mode: view|zen` Open this document in view mode or zen mode by defult. The default view mode is excellent for presentation slides.
+  - 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-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 <kbd>CTRL/CMD</kbd> while dropping the file onto the canvas.
+
+Drag the desired file from the Obsidian file explorer and hold down <kbd>SHIFT</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 (<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 <kbd>CTRL/CMD+ALT/OPT</kbd> click on the image to edit properties of the embed:
-    - `[[filename#^blockref|WIDTHxMAXHEIGHT]]`
+- 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 (<kbd>CTRL+Shift+i</kbd>/<kbd>CMD+OPT+i</kbd>) and
+    - Execute the following command: `ExcalidrawAutomate.mostRecentMarkdownSVG`
+- You can control the 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 <kbd>WIN+CTRL</kbd>/<kbd>CMD+CTRL</kbd> click on the image to edit the properties of the embed:
+  - `[[filename#^blockref|WIDTHxMAXHEIGHT]]`
 
 ### Custom Font, Custom Pen, OCR support, SVG import
-- In plugin settings you can add a custom 4th font. For more details see this [video](https://youtu.be/eKFmrSQhFA4)
-- The plugin includes OCR support using Taskbone OCR. For more details see this [video](https://youtu.be/7gu4ETx7zro)
-- You can convert SVG files into Excalidraw drawings (with some limitation). For more details see this [video](https://youtu.be/vlC1-iBvIfo)
-- You can define custom freedraw pens. See documentation [here](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Alternative%20Pens.md), [video](https://youtu.be/uZz5MgzWXiM)
+
+- In plugin settings, you can add a custom fourth font. For more details, see this [video](https://youtu.be/eKFmrSQhFA4)
+- The plugin includes OCR support using Taskbone OCR. For more details, see this [video](https://youtu.be/7gu4ETx7zro)
+- You can convert SVG files into Excalidraw drawings (with some limitation). For more details, see this [video](https://youtu.be/vlC1-iBvIfo)
+- You can define custom freedraw pens. See documentation [here].(https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Alternative%20Pens.md), [video](https://youtu.be/uZz5MgzWXiM)
 
 ### Script Engine
-- 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).
-- You can organize scripts into groups on the Obsidian Tools Panel in Excalidraw by moving scripts and accompanying SVG icon files to folders. See demo [video](https://youtu.be/wTtaXmRJ7wg?t=16).
+
+- 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).
+- You can organize scripts into groups on the Obsidian Tools Panel in Excalidraw by moving scripts and accompanying SVG icon files to folders. See the demo [video](https://youtu.be/wTtaXmRJ7wg?t=16).
 
 ### Other
+
 - Left-handed mode
 - Includes full
     - [QuickAdd](https://github.com/chhoumann/quickadd),
@@ -273,7 +273,7 @@ report a bug or request an enhancement.
 
 ## Say Thank You
 
-If you are enjoying Excalidraw then please support my work and enthusiasm by buying me a coffee on
+If you are enjoying Excalidraw, then please support my work and enthusiasm by buying me a coffee on
 [https://ko-fi/zsolt](https://ko-fi.com/zsolt).
 
 Please also help spread the word by sharing about the Obsidian Excalidraw Plugin on Twitter, Reddit,
@@ -288,4 +288,4 @@ You can find me on Twitter [@zsviczian](https://twitter.com/zsviczian), and on m
 ## Friends of Excalidraw
 If you enjoy Excalidraw, consider giving [ExcaliBrain](https://github.com/zsviczian/excalibrain) a try (also available via Obsidian Community Plugins).
 
-<a href="https://youtu.be/gOkniMkDPyM" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/169708346-9e41289d-9536-43ec-8f70-2d2ad2d369d6.png" width="300"/></a>
+<a href="https://youtu.be/gOkniMkDPyM" target="_blank"><img src="https://user-images.githubusercontent.com/14358394/169708346-9e41289d-9536-43ec-8f70-2d2ad2d369d6.png" width="300"/></a>

TODO.md

@@ -1,14 +0,0 @@
-[x] do not embed font into SVG when embedding Excalidraw into other Excalidraw
-[x] add ```html <SVG>...</SVG> ``` codeblock to excalidraw markdown
-[x] read pre-saved `<SVG>` when generating image preview
-[x] update code to adopt change files moving from AppState to App 
-- Add "files" to legacy excalidraw export
-
-[x] PNG preview
-[x] markdown embed SVG 190
-[x] markdown embed PNG
-[x] embed Excalidraw into other Excalidraw
-
-
-
-

docs/API/ExcalidrawAutomate.d.ts

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

docs/API/attributes_functions_overview.md

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

docs/API/introduction.md

@@ -21,7 +21,7 @@ The second line resets ExcalidrawAutomate to defaults. This is important as you
 
 You can change the styling between adding different elements. My logic for separating element styling and creation is based on the assumption that you will probably set a stroke color, stroke style, stroke roughness, etc. and draw most of your elements using that. There would be no point in setting all these parameters each time you add an element.
 
-### Before we dive deeper, here are three a simple example [Templater](https://github.com/SilentVoid13/Templater) scripts
+### Before we dive deeper, here are three simple example [Templater](https://github.com/SilentVoid13/Templater) scripts
 #### 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.
 

ea-scripts/Add Next Step in Process.md

@@ -67,6 +67,7 @@ if(!isFirst) {
   ea.copyViewElementsToEAforEditing([fromElement]);
 
   const previousTextElements = elements.filter((el)=>el.type==="text");
+  const previousRectElements = elements.filter((el)=> ['ellipse', 'rectangle', 'diamond'].includes(el.type));
   if(previousTextElements.length>0) {
     const el = previousTextElements[0];
     ea.style.strokeColor = el.strokeColor;
@@ -77,7 +78,7 @@ if(!isFirst) {
 	textWidth = ea.measureText(text).width;
 
   id = ea.addText(
-    fixWidth 
+    fixWidth
     ? fromElement.x+fromElement.width/2-width/2
     : fromElement.x+fromElement.width/2-textWidth/2-textPadding,
     fromElement.y+fromElement.height+gapBetweenElements,
@@ -85,7 +86,8 @@ if(!isFirst) {
     {
       wrapAt: wrapLineLen,
       textAlign: "center",
-      box: "rectangle",
+      textVerticalAlign: "middle",
+      box: previousRectElements.length > 0 ? previousRectElements[0].type : false,
       ...fixWidth
       ? {width: width, boxPadding:0}
       : {boxPadding: textPadding}
@@ -104,14 +106,19 @@ if(!isFirst) {
     }
   );
 
-	const rect = ea.getElement(id);
-  rect.strokeColor = fromElement.strokeColor;
-  rect.strokeWidth = fromElement.strokeWidth;
-	rect.strokeStyle = fromElement.strokeStyle;
-	rect.roughness = fromElement.roughness;
-	rect.strokeSharpness = fromElement.strokeSharpness;
-	rect.backgroundColor = fromElement.backgroundColor;
-  rect.fillStyle = fromElement.fillStyle;
+  if (previousRectElements.length>0) {
+    const rect = ea.getElement(id);
+    rect.strokeColor = fromElement.strokeColor;
+    rect.strokeWidth = fromElement.strokeWidth;
+    rect.strokeStyle = fromElement.strokeStyle;
+    rect.roughness = fromElement.roughness;
+    rect.roundness = fromElement.roundness;
+    rect.strokeSharpness = fromElement.strokeSharpness;
+    rect.backgroundColor = fromElement.backgroundColor;
+    rect.fillStyle = fromElement.fillStyle;
+    rect.width = fromElement.width;
+    rect.height = fromElement.height;
+  }
 
   await ea.addElementsToView(false,false);
 } else {
@@ -122,6 +129,7 @@ if(!isFirst) {
     {
       wrapAt: wrapLineLen,
       textAlign: "center",
+      textVerticalAlign: "middle",
       box: "rectangle",
       boxPadding: textPadding,
 		  ...fixWidth?{width: width}:null

ea-scripts/Auto Draw for Pen.md

@@ -0,0 +1,67 @@
+/*
+Automatically switches between the select and draw tools, based on whether a pen is being used.
+
+1. Choose the select tool
+2. Hover/use the pen to draw, move it away to return to select mode
+*This is based on pen hover status, so will only work if your pen supports hover!*
+If you click draw with the mouse or press select with the pen, switching will be disabled until the opposite input method is used.
+
+**Note:** This script will stay active until the *Obsidian* window is closed.
+
+Compatible with my *Hardware Eraser Support* script
+
+```javascript
+*/
+(function() {
+    'use strict';
+    
+    let promise
+    let timeout
+    let disable
+
+    function handlePointer(e) {
+        ea.setView("active");
+        var activeTool = ea.getExcalidrawAPI().getAppState().activeTool;
+        function setActiveTool(t) {
+            ea.getExcalidrawAPI().setActiveTool(t)
+        }
+
+        if (e.pointerType === 'pen') {
+            if (disable) return
+            if (!promise && activeTool.type==='selection') {
+                setActiveTool({type:"freedraw"})
+            }
+
+            if (timeout) clearTimeout(timeout)
+
+            function setTimeoutX(a,b) {
+                timeout = setTimeout(a,b)
+                return timeout
+            }
+    
+            function revert() {
+                activeTool = ea.getExcalidrawAPI().getAppState().activeTool;
+                disable = false
+                if (activeTool.type==='freedraw') {
+                    setActiveTool({type:"selection"})
+                } else if (activeTool.type==='selection') {
+                    disable = true
+                }
+                promise = false
+            }
+
+            promise = new Promise(resolve => setTimeoutX(resolve, 500))
+            promise.then(() => revert())
+        }
+    }
+    function handleClick(e) {
+        ea.setView("active");
+        if (e.pointerType !== 'pen') {
+            disable = false
+        }
+    }
+
+    window.addEventListener('pointermove', handlePointer, { capture: true })
+    window.addEventListener('pointerdown', handleClick, { capture: true })
+
+})();

ea-scripts/Auto Draw for Pen.svg

@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 27.2.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 448 512" style="enable-background:new 0 0 448 512;" xml:space="preserve">
+<style type="text/css">
+	.st0{stroke:#000000;stroke-width:2;stroke-miterlimit:10;}
+</style>
+<g>
+	<g>
+		<path class="st0" d="M355.8,234.1"/>
+	</g>
+	<g>
+		<path d="M32.3,139.7l28.8,24.2l63.5-71.7L95.7,67c-7.2-6.3-18.2-5.6-24.5,1.6l-40.6,46.6C24.3,122.4,25,133.3,32.3,139.7z"/>
+		<path d="M61.2,165.3l-29.6-24.9c-3.7-3.3-5.9-7.8-6.3-12.7c-0.3-4.9,1.3-9.6,4.5-13.2L70.5,68c6.7-7.6,18.3-8.4,25.9-1.7L126,92.1
+			L61.2,165.3z M32.9,138.9l28,23.6l62.2-70.2l-28-24.6c-6.8-5.9-17.1-5.2-23.1,1.5l-40.6,46.6c-2.9,3.3-4.3,7.5-4,11.8
+			C27.6,132,29.6,136,32.9,138.9z"/>
+	</g>
+	<g>
+		<polygon points="218.7,240.1 212.3,168.6 197.2,155.4 133.7,228.1 148.9,241.3 		"/>
+		<path d="M148.5,242.3l-16.2-14.1l64.8-74.2l16.2,14.1l6.5,73L148.5,242.3z M135.1,228l14.1,12.3l68.4-1.2l-6.2-70.1l-14.1-12.3
+			L135.1,228z"/>
+	</g>
+	<g>
+		<polygon points="192.6,151.6 129.1,224.3 66.2,168.4 129.6,96.7 		"/>
+		<path d="M129.2,225.7l-64.5-57.2l64.8-73.2l64.5,56.2L129.2,225.7z M67.6,168.3l61.5,54.6l62.2-71.2l-61.5-53.6L67.6,168.3z"/>
+	</g>
+	<g>
+		<path d="M109.7,381.6c-23.7-22.2-40-49.3-48.9-78.2c8.2-0.9,22.4-3.6,30.1-12.3c-12.6-12.5-25.3-25-37.9-37.5c0-0.1,0-0.3,0-0.4
+			l-23.6-22c-6,60.7,15.5,123.7,63.7,168.8s112.5,62.4,172.7,52.4l-24.1-22.6C194.8,432.3,146.9,416.4,109.7,381.6z"/>
+		<path d="M232.6,456.1c-19.6,0-39.2-2.8-57.9-8.3c-30.9-9.1-58.6-24.9-82.3-47.1C68.7,378.6,51.1,352,40,321.8
+			c-10.6-28.8-14.6-60.2-11.6-90.7l0.2-2L54,252.8v0.4c6.2,6.1,12.4,12.3,18.6,18.4c6.3,6.3,12.7,12.5,19,18.8l0.7,0.7l-0.6,0.7
+			c-7.2,8.1-19.8,11.3-29.5,12.5c9.2,29.2,25.9,55.6,48.3,76.6l0,0c35.8,33.5,82.4,50.5,131.3,47.9l0.4,0l25.9,24.3l-2,0.3
+			C255,455.2,243.8,456.1,232.6,456.1z M30.2,233.3c-5.6,62.5,17.5,122.9,63.6,166c46,43.1,107.8,62.1,169.8,52.5l-22.3-20.9
+			c-49.2,2.5-96.2-14.7-132.3-48.5l0,0c-22.9-21.5-39.9-48.7-49.2-78.6l-0.4-1.2l1.2-0.1c9.3-1,21.6-3.8,28.8-11.3
+			c-6.1-6-12.2-12.1-18.3-18.1c-6.3-6.2-12.6-12.5-18.9-18.7L52,254v-0.4L30.2,233.3z"/>
+	</g>
+	<g>
+		<path d="M368.8,105.4c-56-52.4-133.5-67.2-201.3-45.5l21,19.6c56.1-13.2,117.7,1.1,163.1,43.7c33,30.9,51.7,71.2,55.9,112.7
+			c-0.2-0.4-0.3-0.6-0.3-0.6s-25.1-0.1-36.5,12.7c11.8,11.6,23.5,23.3,35.3,34.9v0.1l2.4,2.3c0.4,0.4,0.9,0.9,1.3,1.3l0,0l17.7,16.6
+			C444.7,234.1,424.8,157.7,368.8,105.4z"/>
+		<path d="M428,305.1L409,287.3l-1.3-1.3l-2.7-2.6v-0.1c-5.8-5.7-11.5-11.4-17.3-17.1c-5.9-5.8-11.8-11.7-17.7-17.5l-0.7-0.7
+			l0.6-0.7c10.5-11.8,31.7-12.9,36.4-13c-4.7-42.1-24.3-81.3-55.4-110.4c-43.5-40.9-104.2-57.1-162.2-43.5l-0.5,0.1l-22.6-21.1
+			l1.6-0.5c70.5-22.6,148-5,202.3,45.7c54.3,50.7,76.9,126.9,58.9,198.8L428,305.1z M407,282.6l3.4,3.3l16.4,15.4
+			c17.1-70.7-5.3-145.3-58.7-195.2l0,0c-53.3-49.9-129.3-67.4-198.7-45.8l19.4,18.1c58.5-13.6,119.6,2.9,163.5,44.1
+			c31.9,29.8,51.8,70.1,56.2,113.3l0.5,5.4l-2.5-4.9c-3.8,0.1-24.3,1.1-34.5,11.7c5.7,5.6,11.3,11.2,17,16.8
+			c5.9,5.8,11.7,11.6,17.6,17.4L407,282.6L407,282.6z"/>
+	</g>
+	<polygon points="425.2,382.2 302.7,283.9 299.4,437.6 340.9,383.8 382.3,456.5 398,447.5 359.4,379.8 	"/>
+</g>
+</svg>

ea-scripts/Boolean Operations.md

@@ -0,0 +1,369 @@
+/*
+With This Script it is possible to make boolean Operations on Shapes. 
+The style of the resulting shape will be the style of the highest ranking Element that was used. 
+The ranking of the elemtns is based on their background. The "denser" the background, the higher the ranking (the order of backgroundstyles is shown below). If they have the same background the opacity will decide. If thats also the same its decided by the order they were created.
+The ranking is also important for the diffrence operation, so a tranparent object for example will cut a hole into a solid object.
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-boolean-operations-showcase.png)
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-boolean-operations-element-ranking.png)
+
+
+See documentation for more details:
+https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html
+
+```javascript
+*/
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.9.20")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+const ShadowGroupMarker = "ShadowCloneOf-";
+
+const elements = ea.getViewSelectedElements().filter(
+  el=>["ellipse", "rectangle", "diamond"].includes(el.type) ||
+    el.groupIds.some(id => id.startsWith(ShadowGroupMarker)) ||
+    (["line", "arrow"].includes(el.type) && el.roundness === null)
+);
+if(elements.length === 0) {
+  new Notice ("Select ellipses, rectangles or diamonds");
+  return;
+}
+
+const PolyBool = ea.getPolyBool();
+const polyboolAction = await utils.suggester(["union (a + b)", "intersect (a && b)", "diffrence (a - b)", "reversed diffrence (b - a)", "xor"], [
+  PolyBool.union, PolyBool.intersect, PolyBool.difference, PolyBool.differenceRev, PolyBool.xor
+], "What would you like todo with the object");
+
+const shadowClones = elements.filter(element => element.groupIds.some(id => id.startsWith(ShadowGroupMarker)));
+shadowClones.forEach(shadowClone => {
+  let parentId = shadowClone.groupIds
+    .filter(id => id.startsWith(ShadowGroupMarker))[0]
+    .slice(ShadowGroupMarker.length);
+  const shadowCloneIndex = elements.findIndex(element => element.id == parentId);
+  if (shadowCloneIndex == -1) return;
+  elements[shadowCloneIndex].backgroundColor = shadowClone.backgroundColor;
+  elements[shadowCloneIndex].fillStyle = shadowClone.fillStyle;
+})
+const borderElements = elements.filter(element => !element.groupIds.some(id => id.startsWith(ShadowGroupMarker)));
+groups = ea.getMaximumGroups(borderElements);
+groups = groups.map((group) => group.sort((a, b) => RankElement(b) - RankElement(a)));
+groups.sort((a, b) => RankElement(b[0]) - RankElement(a[0]));
+
+ea.style.strokeColor = groups[0][0].strokeColor;
+ea.style.backgroundColor = groups[0][0].backgroundColor;
+ea.style.fillStyle = groups[0][0].fillStyle;
+ea.style.strokeWidth = groups[0][0].strokeWidth;
+ea.style.strokeStyle = groups[0][0].strokeStyle;
+ea.style.roughness = groups[0][0].roughness;
+ea.style.opacity = groups[0][0].opacity;
+
+const basePolygons = groups.shift().map(element => traceElement(element));
+const toolPolygons = groups.flatMap(group => group.map(element => traceElement(element)));
+
+const result = polyboolAction({
+  regions: basePolygons,
+  inverted: false
+}, {
+  regions: toolPolygons,
+  inverted: false
+});
+const polygonHierachy = subordinateInnerPolygons(result.regions);
+drawPolygonHierachy(polygonHierachy);
+ea.deleteViewElements(elements);
+ea.addElementsToView(false,false,true);
+return;
+
+
+
+function traceElement(element) {
+  const diamondPath = (diamond) => [
+      SxVEC(1/2, [0, diamond.height]),
+      SxVEC(1/2, [diamond.width, 0]),
+      addVec([SxVEC(1/2, [0, diamond.height]), ([diamond.width, 0])]),
+      addVec([SxVEC(1/2, [diamond.width, 0]), ([0, diamond.height])]),
+      SxVEC(1/2, [0, diamond.height])
+    ];
+  const rectanglePath = (rectangle) => [
+    [0,0],
+    [0, rectangle.height],
+    [rectangle.width, rectangle.height],
+    [rectangle.width, 0],
+    [0, 0]
+  ]
+  const ellipsePath = (ellipse) => {
+    const angle = ellipse.angle;
+    const width = ellipse.width;
+    const height = ellipse.height;
+    const ellipseAtPoint = (t) => {
+      const spanningVector = [width/2*Math.cos(t), height/2*Math.sin(t)];
+      const baseVector = [width/2, height/2];
+      return addVec([spanningVector, baseVector]);
+    }
+    let points = [];
+    step = (2*Math.PI)/64
+    for (let t = 0; t < 2*Math.PI; t = t + step) {
+      points.push(ellipseAtPoint(t));
+    }
+    return points;
+  }
+  let polygon;
+  let correctForPolygon = [0, 0];
+  switch (element.type) {
+    case "diamond":
+      polygon = diamondPath(element);
+      break;
+    case "rectangle":
+      polygon = rectanglePath(element);
+      break;
+    case "ellipse":
+      polygon = ellipsePath(element);
+      break;
+    case "line":
+    case "arrow":
+      if (element.angle != 0) {
+        let smallestX = 0;
+        let smallestY = 0;
+        element.points.forEach(point => {
+          if (point[0] < smallestX) smallestX = point[0];
+          if (point[1] < smallestY) smallestY = point[1];
+        });
+        polygon = element.points.map(point => {
+          return [
+            point[0] -= smallestX,
+            point[1] -= smallestY
+          ];
+        });
+        correctForPolygon = [smallestX, smallestY];
+        break;
+      }
+      if (element.roundness) {
+        new Notice("This script does not work with curved lines or arrows yet!");
+        return [];
+      }
+      polygon = element.points; 
+      default:
+          break;
+    }
+  if (element.angle == 0) return polygon.map(v => addVec([v, [element.x, element.y]]));
+  
+  polygon = polygon.map(v => addVec([v, SxVEC(-1/2, [element.width, element.height])]));
+  polygon = rotateVectorsByAngle(polygon, element.angle);
+  return polygon.map(v => addVec([v, [element.x, element.y], SxVEC(1/2, [element.width, element.height]), correctForPolygon]));
+}
+
+function RankElement(element) {
+  let score = 0;
+  const backgroundRank = [
+    "dashed",
+    "none",
+    "hachure",
+    "zigzag",
+    "zigzag-line",
+    "cross-hatch",
+    "solid"
+  ]
+  score += (backgroundRank.findIndex((fillStyle) => fillStyle == element.fillStyle) + 1) * 10;
+  if (element.backgroundColor == "transparent") score -= 100;
+  if (element.points && getVectorLength(element.points[element.points.length - 1]) > 8) score -= 100; 
+  if (score < 0) score = 0;
+  score += element.opacity / 100;
+  return score;
+}
+
+function drawPolygonHierachy(polygonHierachy) {
+  const backgroundColor = ea.style.backgroundColor;
+  const strokeColor = ea.style.strokeColor;
+  const setInnerStyle = () => {
+    ea.style.backgroundColor = backgroundColor;
+    ea.style.strokeColor = "transparent";
+  }
+  const setBorderStyle = () => {
+    ea.style.backgroundColor = "transparent";
+    ea.style.strokeColor = strokeColor;
+  }
+  const setFilledStyle = () => {
+    ea.style.backgroundColor = backgroundColor;
+    ea.style.strokeColor = strokeColor;
+  }
+  
+  polygonHierachy.forEach(polygon => {
+    setFilledStyle();
+    let path = polygon.path;
+    path.push(polygon.path[0]);
+    if (polygon.innerPolygons.length === 0) {
+      ea.addLine(path);
+      return;
+    }
+    const outerBorder = path;
+    const innerPolygons = addInnerPolygons(polygon.innerPolygons);
+    path = path.concat(innerPolygons.backgroundPath);
+    path.push(polygon.path[0]);
+    setInnerStyle();
+    const backgroundId = ea.addLine(path);
+    setBorderStyle();
+    const outerBorderId = ea.addLine(outerBorder)
+    const innerBorderIds = innerPolygons.borderPaths.map(path => ea.addLine(path));
+    const allIds = [innerBorderIds, outerBorderId, backgroundId].flat();
+    ea.addToGroup(allIds);
+    const background = ea.getElement(backgroundId);
+    background.groupIds.push(ShadowGroupMarker + outerBorderId);
+  });
+}
+
+function addInnerPolygons(polygonHierachy) {
+  let firstPath = [];
+  let secondPath = [];
+  let borderPaths = [];
+  polygonHierachy.forEach(polygon => {
+    let path = polygon.path;
+    path.push(polygon.path[0]);
+    borderPaths.push(path);
+    firstPath = firstPath.concat(path);
+    secondPath.push(polygon.path[0]);
+    drawPolygonHierachy(polygon.innerPolygons);
+  });
+  return {
+    backgroundPath: firstPath.concat(secondPath.reverse()), 
+    borderPaths: borderPaths
+  };
+}
+
+function subordinateInnerPolygons(polygons) {
+  const polygonObjectPrototype = (polygon) => {
+    return {
+      path: polygon,
+      innerPolygons: []
+    };
+  }
+
+  const insertPolygonIntoHierachy = (polygon, hierarchy) => {
+    for (let i = 0; i < hierarchy.length; i++) {
+      const polygonObject = hierarchy[i];
+      let inside = null;
+      let pointIndex = 0;
+      do {
+        inside = pointInPolygon(polygon[pointIndex], polygonObject.path);
+        pointIndex++
+      } while (inside === null);
+      if (inside) {
+        hierarchy[i].innerPolygons = insertPolygonIntoHierachy(polygon, hierarchy[i].innerPolygons);
+        return hierarchy;
+      }
+    }
+    polygon = polygonObjectPrototype(polygon);
+    for (let i = 0; i < hierarchy.length; i++) {
+      const polygonObject = hierarchy[i];
+      let inside = null;
+      let pointIndex = 0;
+      do {
+        inside = pointInPolygon(polygonObject.path[pointIndex], polygon.path);
+        pointIndex++
+      } while (inside === null);
+      if (inside) {
+        polygon.innerPolygons.push(hierarchy.splice(i, 1)[0]);
+        i--;
+      }
+    }
+    hierarchy.push(polygon);
+    return hierarchy;
+  }
+
+  let polygonHierachy = [];
+  polygons.forEach(polygon => {
+    polygonHierachy = insertPolygonIntoHierachy(polygon, polygonHierachy);
+  })
+
+  return polygonHierachy;
+}
+
+/**
+ * Checks if the given point lays in the polygon
+ * @param point array [x, y]
+ * @param polygon array [[x, y], ...]
+ * @returns true if inside, false if not, null if the point is on one of the polygons vertecies
+ */
+function pointInPolygon(point, polygon) {
+  const x = point[0];
+  const y = point[1];
+  let inside = false;
+
+  // odd even test if point is in polygon
+  for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+    const xi = polygon[i][0];
+    const yi = polygon[i][1];
+    const xj = polygon[j][0];
+    const yj = polygon[j][1];
+
+    const intersect =
+      yi > y !== yj > y &&
+      x < ((xj - xi) * (y - yi)) / (yj - yi) + xi;
+
+    if (intersect) {
+      inside = !inside;
+    }
+
+    if ((x === xi && y === yi) || (x === xj && y === yj)) {
+      return null;
+    }
+  }
+
+  return inside;
+}
+
+
+function getVectorLength(vector) {
+  return Math.sqrt(vector[0]**2+vector[1]**2);
+}
+
+/**
+ * Adds two Vectors together
+ */
+function addVec(vectors) {
+  return vectors.reduce((acc, vec) => [acc[0] + vec[0], acc[1] + vec[1]], [0, 0]);
+}
+
+/**
+ * Returns the negative of the vector
+ */
+function negVec(vector) {
+  return [-vector[0], -vector[1]];
+}
+ 
+/**
+ * Multiplies Vector with a scalar
+ */
+function SxVEC(scalar, vector) {
+  return [vector[0] * scalar, vector[1] * scalar];
+}
+
+function rotateVector (vec, ang)  {
+  var cos = Math.cos(ang);
+  var sin = Math.sin(ang);
+  return [vec[0] * cos - vec[1] * sin, vec[0] * sin + vec[1] * cos];
+}
+
+function rotateVectorsByAngle(vectors, angle) {
+  const cosAngle = Math.cos(angle);
+  const sinAngle = Math.sin(angle);
+
+  const rotationMatrix = [
+    [cosAngle, -sinAngle],
+    [sinAngle, cosAngle]
+  ];
+
+  return applyTranformationMatrix(vectors, rotationMatrix);
+}
+
+function applyTranformationMatrix(vectors, transformationMatrix) {
+  const result = [];
+  for (const vector of vectors) {
+    const x = vector[0];
+    const y = vector[1];
+
+    const newX = transformationMatrix[0][0] * x + transformationMatrix[0][1] * y;
+    const newY = transformationMatrix[1][0] * x + transformationMatrix[1][1] * y;
+
+    result.push([newX, newY]);
+  }
+
+  return result;
+}

ea-scripts/Concatenate lines.md

@@ -0,0 +1,102 @@
+/*
+Connects two lines. Lines may be type of arrow or line. The resulting line will carry the style of the line higher in the drawing layers (bring to front the one you want to control the look and feel). Arrows are connected intelligently.
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-concatenate-lines.png)
+```js*/
+const lines = ea.getViewSelectedElements().filter(el=>el.type==="line" || el.type==="arrow");
+if(lines.length !== 2) {
+  new Notice ("Select two lines or arrows");
+  return;
+}
+
+// https://math.stackexchange.com/questions/2204520/how-do-i-rotate-a-line-segment-in-a-specific-point-on-the-line
+const rotate = (point, element) => {
+  const [x1, y1] = point;
+  const x2 = element.x + element.width/2;
+  const y2 = element.y - element.height/2;
+  const angle = element.angle;
+  return [
+    (x1 - x2) * Math.cos(angle) - (y1 - y2) * Math.sin(angle) + x2,
+    (x1 - x2) * Math.sin(angle) + (y1 - y2) * Math.cos(angle) + y2,
+  ];
+}
+
+const points = lines.map(
+  el=>el.points.map(p=>rotate([p[0]+el.x, p[1]+el.y],el))
+);
+
+const last = (p) => p[p.length-1];
+const first = (p) => p[0];
+const distance = (p1,p2) => Math.sqrt((p1[0]-p2[0])**2+(p1[1]-p2[1])**2);
+
+const distances = [
+	distance(first(points[0]),first(points[1])),
+	distance(first(points[0]),last (points[1])),
+	distance(last (points[0]),first(points[1])),
+	distance(last (points[0]),last (points[1]))
+];
+
+const connectDirection = distances.indexOf(Math.min(...distances));
+
+let newPoints = [];
+switch(connectDirection) {
+	case 0: //first-first
+	  newPoints = [...points[0].reverse(),...points[1].slice(1)];
+	  break;
+	case 1: //first-last
+	  newPoints = [...points[0].reverse(),...points[1].reverse().slice(1)];
+	  break;	
+	case 2: //last-first
+	  newPoints = [...points[0],...points[1].slice(1)];
+	  break;
+  case 3: //last-last
+	  newPoints = [...points[0],...points[1].reverse().slice(1)];
+	  break;
+}
+
+["strokeColor", "backgrounColor", "fillStyle", "roundness", "roughness", "strokeWidth", "strokeStyle", "opacity"].forEach(prop=>{
+	ea.style[prop] = lines[1][prop];
+})
+
+ea.style.startArrowHead = null;
+ea.style.endArrowHead = null;
+
+ea.copyViewElementsToEAforEditing(lines);
+ea.getElements().forEach(el=>{el.isDeleted = true});
+
+const lineTypes = parseInt(lines.map(line => line.type === "line" ? '1' : '0').join(''),2);
+
+switch (lineTypes) {
+  case 0: //arrow - arrow
+    ea.addArrow(
+      newPoints,
+		  connectDirection === 0 //first-first
+		  ? { startArrowHead: lines[0].endArrowhead, endArrowHead: lines[1].endArrowhead }
+		  : connectDirection === 1 //first-last
+		    ? { startArrowHead: lines[0].endArrowhead, endArrowHead: lines[1].startArrowhead }
+		    : connectDirection === 2 //last-first
+		      ? { startArrowHead: lines[0].startArrowhead, endArrowHead: lines[1].endArrowhead }
+		      //3: last-last
+		      : { startArrowHead: lines[0].startArrowhead, endArrowHead: lines[1].startArrowhead }
+	  );
+    break;
+  case 1: //arrow - line
+    reverse = connectDirection === 0 || connectDirection === 1;
+    ea.addArrow(newPoints,{
+      startArrowHead: reverse ? lines[0].endArrowhead : lines[0].startArrowhead,
+      endArrowHead: reverse ? lines[0].startArrowhead : lines[0].endArrowhead
+    });
+    break;
+  case 2: //line - arrow
+    reverse = connectDirection === 1 || connectDirection === 3;
+    ea.addArrow(newPoints,{
+      startArrowHead: reverse ? lines[1].endArrowhead : lines[1].startArrowhead,
+      endArrowHead: reverse ? lines[1].startArrowhead : lines[1].endArrowhead
+    });
+    break;
+  case 3: //line - line
+    ea.addLine(newPoints);
+    break;
+}
+
+
+ea.addElementsToView();

ea-scripts/Concatenate lines.svg

@@ -0,0 +1,17 @@
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 72.75819749055177 80.03703336574608" width="72.75819749055177" height="80.03703336574608">
+  <!-- svg-source:excalidraw -->
+  
+  <defs>
+    <style class="style-fonts">
+      @font-face {
+        font-family: "Virgil";
+        src: url("https://excalidraw.com/Virgil.woff2");
+      }
+      @font-face {
+        font-family: "Cascadia";
+        src: url("https://excalidraw.com/Cascadia.woff2");
+      }
+    </style>
+    
+  </defs>
+  <g stroke-linecap="round"><g transform="translate(4 4) rotate(0 12.71901889991409 17.183109917454658)"><path d="M0 0 C0 7.02, 0 14.05, 0 34.37 M0 34.37 C7.62 34.37, 15.24 34.37, 25.44 34.37" stroke="black" stroke-width="4.5" fill="none" stroke-dasharray="1.5 10"></path></g></g><mask></mask><g stroke-linecap="round"><g transform="translate(51.379765518092086 61.93633577499986) rotate(0 5.684341886080802e-14 7.050348795373111)"><path d="M0 0 C0 4.06, 0 8.11, 0 14.1" stroke="black" stroke-width="4.5" fill="none" stroke-dasharray="1.5 10"></path></g></g><mask></mask><g stroke-linecap="round" transform="translate(34.0013341989918 20.987787610339183) rotate(0 17.378431645779926 17.378431645779983)"><path d="M34.76 17.38 C34.76 18.38, 34.67 19.41, 34.49 20.4 C34.32 21.39, 34.05 22.38, 33.71 23.32 C33.36 24.27, 32.93 25.2, 32.43 26.07 C31.93 26.94, 31.34 27.78, 30.69 28.55 C30.04 29.32, 29.32 30.04, 28.55 30.69 C27.78 31.34, 26.94 31.93, 26.07 32.43 C25.2 32.93, 24.27 33.36, 23.32 33.71 C22.38 34.05, 21.39 34.32, 20.4 34.49 C19.41 34.67, 18.38 34.76, 17.38 34.76 C16.37 34.76, 15.35 34.67, 14.36 34.49 C13.37 34.32, 12.38 34.05, 11.43 33.71 C10.49 33.36, 9.56 32.93, 8.69 32.43 C7.82 31.93, 6.98 31.34, 6.21 30.69 C5.44 30.04, 4.71 29.32, 4.07 28.55 C3.42 27.78, 2.83 26.94, 2.33 26.07 C1.83 25.2, 1.39 24.27, 1.05 23.32 C0.7 22.38, 0.44 21.39, 0.26 20.4 C0.09 19.41, 0 18.38, 0 17.38 C0 16.37, 0.09 15.35, 0.26 14.36 C0.44 13.37, 0.7 12.38, 1.05 11.43 C1.39 10.49, 1.83 9.56, 2.33 8.69 C2.83 7.82, 3.42 6.98, 4.07 6.21 C4.71 5.44, 5.44 4.71, 6.21 4.07 C6.98 3.42, 7.82 2.83, 8.69 2.33 C9.56 1.83, 10.49 1.39, 11.43 1.05 C12.38 0.7, 13.37 0.44, 14.36 0.26 C15.35 0.09, 16.37 0, 17.38 0 C18.38 0, 19.41 0.09, 20.4 0.26 C21.39 0.44, 22.38 0.7, 23.32 1.05 C24.27 1.39, 25.2 1.83, 26.07 2.33 C26.94 2.83, 27.78 3.42, 28.55 4.07 C29.32 4.71, 30.04 5.44, 30.69 6.21 C31.34 6.98, 31.93 7.82, 32.43 8.69 C32.93 9.56, 33.36 10.49, 33.71 11.43 C34.05 12.38, 34.32 13.37, 34.49 14.36 C34.67 15.35, 34.71 16.88, 34.76 17.38 C34.8 17.88, 34.8 16.88, 34.76 17.38" stroke="black" stroke-width="4" fill="none"></path></g><g stroke-linecap="round"><g transform="translate(41.72257566145686 38.36621939788711) rotate(0 9.65718949485347 0)"><path d="M0 0 C4.11 0, 8.22 0, 19.31 0 M0 0 C6.95 0, 13.9 0, 19.31 0" stroke="black" stroke-width="4" fill="none"></path></g></g><mask></mask><g stroke-linecap="round"><g transform="translate(41.72257587602678 38.36622004108449) rotate(89.99999999999994 9.65718949485347 0)"><path d="M0 0 C5.31 0, 10.62 0, 19.31 0 M0 0 C4.56 0, 9.13 0, 19.31 0" stroke="black" stroke-width="4" fill="none"></path></g></g><mask></mask></svg>

ea-scripts/Create DrawIO file.md

@@ -0,0 +1,33 @@
+/*
+Creates a new draw.io diagram file and opens the file in the [Diagram plugin](https://github.com/zapthedingbat/drawio-obsidian) in a new tab.
+```js*/
+
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.9.7")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+
+const drawIO = app.plugins.plugins["drawio-obsidian"];
+if(!drawIO || !drawIO?._loaded) {
+  new Notice("Can't find the draw.io diagram plugin");
+}
+
+filename = await utils.inputPrompt("Diagram name?");
+if(!filename) return;
+filename = filename.toLowerCase().endsWith(".svg") ? filename : filename + ".svg";
+const filepath = await ea.getAttachmentFilepath(filename);
+if(!filepath) return;
+const leaf = app.workspace.getLeaf('tab')
+if(!leaf) return;
+
+const file = await this.app.vault.create(filepath, `<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><!--${ea.generateElementId()}--><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="300px" height="300px" viewBox="-0.5 -0.5 1 1" content="&lt;mxGraphModel&gt;&lt;root&gt;&lt;mxCell id=&quot;0&quot;/&gt;&lt;mxCell id=&quot;1&quot; parent=&quot;0&quot;/&gt;&lt;/root&gt;&lt;/mxGraphModel&gt;"></svg>`);
+
+await ea.addImage(0,0,file);
+await ea.addElementsToView(true,true);
+
+leaf.setViewState({
+  type: "diagram-edit",
+  state: {
+    file: filepath
+  }
+});

ea-scripts/Create DrawIO file.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" viewBox="24 26 68 68" stroke="#000"><path fill="none" stroke="#000" stroke-miterlimit="10" stroke-width="3.553" d="m58.069 43.384-17.008 29.01"/><path fill="none" stroke="#000" stroke-miterlimit="10" stroke-width="3.501" d="m58.068 43.384 17.008 29.01"/><path fill="#000" d="M52.773 77.084a3.564 3.564 0 0 1-3.553 3.553H36.999a3.564 3.564 0 0 1-3.553-3.553v-9.379a3.564 3.564 0 0 1 3.553-3.553h12.222a3.564 3.564 0 0 1 3.553 3.553v9.379zM67.762 48.074a3.564 3.564 0 0 1-3.553 3.553H51.988a3.564 3.564 0 0 1-3.553-3.553v-9.379a3.564 3.564 0 0 1 3.553-3.553H64.21a3.564 3.564 0 0 1 3.553 3.553v9.379zM82.752 77.084a3.564 3.564 0 0 1-3.553 3.553H66.977a3.564 3.564 0 0 1-3.553-3.553v-9.379a3.564 3.564 0 0 1 3.553-3.553h12.222a3.564 3.564 0 0 1 3.553 3.553v9.379z"/></svg>

ea-scripts/Deconstruct selected elements into new drawing.md

@@ -3,13 +3,60 @@
 
 Select some elements in the scene. The script will take these elements and move them into a new Excalidraw file, and open that file. The selected elements will also be replaced in your original drawing with the embedded Excalidraw file (the one that was just created). You will be prompted for the file name of the new deconstructed image. The script is useful if you want to break a larger drawing into smaller reusable parts that you want to reference in multiple drawings.
 
+<iframe width="560" height="315" src="https://www.youtube.com/embed/HRtaaD34Zzg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/mvMQcz401yo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
 ```javascript
 */
-if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.7.29")) {
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.9.19")) {
   new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
   return;
 }
 
+// -------------------------------
+// Utility variables and functions
+// -------------------------------
+const excalidrawTemplate = app.metadataCache.getFirstLinkpathDest(ea.plugin.settings.templateFilePath,"");
+if(typeof window.ExcalidrawDeconstructElements === "undefined") {
+	window.ExcalidrawDeconstructElements = {
+	  openDeconstructedImage: true,
+	  templatePath: excalidrawTemplate?.path??""
+	};
+}
+
+const splitFolderAndFilename = (filepath) => {
+  const lastIndex = filepath.lastIndexOf("/");
+  return {
+    foldername: ea.obsidian.normalizePath(filepath.substring(0, lastIndex)),
+    filename: (lastIndex == -1 ? filepath : filepath.substring(lastIndex + 1)) + ".md"
+  };
+}
+
+let settings = ea.getScriptSettings();
+//set default values on first run
+if(!settings["Templates"]) {
+	settings = {
+	  "Templates" : {
+			value: "",
+      description: "Comma-separated list of template filepaths"
+		}
+	};
+	await ea.setScriptSettings(settings);
+}
+
+const templates = settings["Templates"]
+  .value
+  .split(",")
+  .map(p=>app.metadataCache.getFirstLinkpathDest(p.trim(),""))
+  .concat(excalidrawTemplate)
+  .filter(f=>Boolean(f))
+  .sort((a,b) => a.basename.localeCompare(b.basename));
+
+
+// ------------------------------------
+// Prepare elements to be deconstructed
+// ------------------------------------
 const els = ea.getViewSelectedElements();
 if (els.length === 0) {
   new Notice("You must select elements first")
@@ -20,53 +67,114 @@ const bb = ea.getBoundingBox(els);
 ea.copyViewElementsToEAforEditing(els);
 
 ea.getElements().filter(el=>el.type==="image").forEach(el=>{
-    const img = ea.targetView.excalidrawData.getFile(el.fileId);
-    const path = (img?.linkParts?.original)??(img?.file?.path);
-    if(img && path) {
-	    ea.imagesDict[el.fileId] = {
-	      mimeType: img.mimeType,
-	      id: el.fileId,
-	      dataURL: img.img,
-	      created: img.mtime,
-	      file: path,
-	      hasSVGwithBitmap: img.isSVGwithBitmap,
-	      latex: null,
-	    };
-	    return;
+  const img = ea.targetView.excalidrawData.getFile(el.fileId);
+  const path = (img?.linkParts?.original)??(img?.file?.path);
+  if(img && path) {
+	  ea.imagesDict[el.fileId] = {
+	    mimeType: img.mimeType,
+	    id: el.fileId,
+	    dataURL: img.img,
+	    created: img.mtime,
+	    file: path,
+	    hasSVGwithBitmap: img.isSVGwithBitmap,
+     latex: null,
+   };
+   return;
 	}
 	const equation = ea.targetView.excalidrawData.getEquation(el.fileId);
 	eqImg = ea.targetView.getScene()?.files[el.fileId]
 	if(equation && eqImg) {
-          ea.imagesDict[el.fileId] = {
-	      mimeType: eqImg.mimeType,
-	      id: el.fileId,
-	      dataURL: eqImg.dataURL,
-	      created: eqImg.created,
-	      file: null,
-	      hasSVGwithBitmap: null,
-	      latex: equation.latex,
-	    };
-	    return;
+    ea.imagesDict[el.fileId] = {
+	    mimeType: eqImg.mimeType,
+	    id: el.fileId,
+	    dataURL: eqImg.dataURL,
+	    created: eqImg.created,
+	    file: null,
+	    hasSVGwithBitmap: null,
+	    latex: equation.latex,
+	  };
+	  return;
 	}
 });
 
-let folder = ea.targetView.file.path;
-folder = folder.lastIndexOf("/")===-1?"":folder.substring(0,folder.lastIndexOf("/"))+"/";
-const fname = await utils.inputPrompt("Filename for new file","Filename","");
-const template = app.metadataCache.getFirstLinkpathDest(ea.plugin.settings.templateFilePath,"");
+
+// ------------
+// Input prompt
+// ------------
+let shouldAnchor = false;
+const actionButtons = [
+  {
+    caption: "Insert @100%",
+    tooltip: "Anchor to 100% size",
+    action: () => {
+      shouldAnchor = true;
+    }
+  },
+  {
+    caption: "Insert",
+    tooltip: "Insert without anchoring",
+    action: () => {
+      shouldAnchor = false;
+    }
+  }];
+
+const customControls =  (container) => {
+  new ea.obsidian.Setting(container)
+    .setName(`Select template`)
+    .addDropdown(dropdown => {
+      templates.forEach(file => dropdown.addOption(file.path, file.basename));
+      if(templates.length === 0) dropdown.addOption(null, "none");
+      dropdown
+        .setValue(window.ExcalidrawDeconstructElements.templatePath)
+        .onChange(value => {
+           window.ExcalidrawDeconstructElements.templatePath = value;
+        })
+    })
+
+  new ea.obsidian.Setting(container)
+    .setName(`Open deconstructed image`)
+    .addToggle((toggle) => toggle
+      .setValue(window.ExcalidrawDeconstructElements.openDeconstructedImage)
+      .onChange(value => {
+        window.ExcalidrawDeconstructElements.openDeconstructedImage = value;
+      })
+    )
+}
+
+const path = await utils.inputPrompt(
+  "Filename for new file",
+  "Filename",
+  await ea.getAttachmentFilepath("deconstructed"),
+  actionButtons,
+  2,
+  false,
+  customControls
+);
+
+if(!path) return;
+
+// ----------------------
+// Execute deconstruction
+// ----------------------
+const {foldername, filename} = splitFolderAndFilename(path);
 
 const newPath = await ea.create ({
-  filename: fname + ".md",
-  foldername: folder,
-  templatePath: template?.path,
-  onNewPane: true
+  filename,
+  foldername,
+  templatePath: window.ExcalidrawDeconstructElements.templatePath,
+  onNewPane: true,
+  silent: !window.ExcalidrawDeconstructElements.openDeconstructedImage
 });
 
 setTimeout(async ()=>{
-  const file = app.metadataCache.getFirstLinkpathDest(newPath,"")
+  const file = app.metadataCache.getFirstLinkpathDest(newPath,"");
   ea.deleteViewElements(els);
   ea.clear();
-  await ea.addImage(bb.topX,bb.topY,file,false);
+  await ea.addImage(bb.topX,bb.topY,file,false, shouldAnchor);
   await ea.addElementsToView(false, true, true);
   ea.getExcalidrawAPI().history.clear(); //to avoid undo/redo messing up the decomposition
 },1000);
+
+if(!window.ExcalidrawDeconstructElements.openDeconstructedImage) {
+  new Notice("Deconstruction ready");
+}

ea-scripts/Ellipse Selected Elements.md

@@ -0,0 +1,61 @@
+/*
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-ellipse-elements.png)
+
+This script will add an encapsulating ellipse around the currently selected elements in Excalidraw.
+
+See documentation for more details:
+https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html
+
+```javascript
+*/
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.5.21")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+settings = ea.getScriptSettings();
+//set default values on first run
+if(!settings["Default padding"]) {
+	settings = {
+		"Prompt for padding?": true,
+	  "Default padding" : {
+			value: 10,
+		  description: "Padding between the bounding box of the selected elements, and the ellipse the script creates"
+		}
+	};
+	ea.setScriptSettings(settings);
+}
+
+let padding = settings["Default padding"].value;
+
+if(settings["Prompt for padding?"]) {
+	padding = parseInt (await utils.inputPrompt("padding?","number",padding.toString()));
+}
+
+if(isNaN(padding)) {
+  new Notice("The padding value provided is not a number");
+  return;
+}
+elements = ea.getViewSelectedElements();
+const box = ea.getBoundingBox(elements);
+color = ea
+        .getExcalidrawAPI()
+        .getAppState()
+        .currentItemStrokeColor;
+//uncomment for random color:
+//color = '#'+(Math.random()*0xFFFFFF<<0).toString(16).padStart(6,"0");
+ea.style.strokeColor = color;
+
+const ellipseWidth = box.width/Math.sqrt(2);
+const ellipseHeight = box.height/Math.sqrt(2);
+
+const topX = box.topX - (ellipseWidth - box.width/2);
+const topY = box.topY - (ellipseHeight - box.height/2);
+id = ea.addEllipse(
+	topX - padding,
+	topY - padding,
+	2*ellipseWidth + 2*padding,
+	2*ellipseHeight + 2*padding
+);
+ea.copyViewElementsToEAforEditing(elements);
+ea.addToGroup([id].concat(elements.map((el)=>el.id)));
+ea.addElementsToView(false,false);

ea-scripts/Excalidraw Collaboration Frame.md

@@ -0,0 +1,12 @@
+/* 
+Creates a new Excalidraw.com collaboration room and places the link to the room on the clipboard.
+```js*/
+const room = Array.from(window.crypto.getRandomValues(new Uint8Array(10))).map((byte) => `0${byte.toString(16)}`.slice(-2)).join("");
+const key = (await window.crypto.subtle.exportKey("jwk",await window.crypto.subtle.generateKey({name:"AES-GCM",length:128},true,["encrypt", "decrypt"]))).k;
+const link = `https://excalidraw.com/#room=${room},${key}`;
+
+ea.addIFrame(0,0,800,600,link);
+ea.addElementsToView(true,true);
+
+window.navigator.clipboard.writeText(link);
+new Notice("The collaboration room link is available on the clipboard.",4000);

ea-scripts/Excalidraw Collaboration Frame.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke-width="2" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"><g stroke-width="1.5"></path><circle cx="9" cy="7" r="4"></circle><path d="M3 21v-2a4 4 0 0 1 4 -4h4a4 4 0 0 1 4 4v2"></path><path d="M16 3.13a4 4 0 0 1 0 7.75"></path><path d="M21 21v-2a4 4 0 0 0 -3 -3.85"></path></g></svg>

ea-scripts/Folder Note Core - Make Current Drawing a Folder.md

@@ -0,0 +1,9 @@
+/*
+This script adds the `Folder Note Core: Make current document folder note` function to Excalidraw drawings. Running this script will convert the active Excalidraw drawing into a folder note. If you already have embedded images in your drawing, those attachments will not be moved when the folder note is created. You need to take care of those attachments separately, or convert the drawing to a folder note prior to adding the attachments. The script requires the [Folder Note Core](https://github.com/aidenlx/folder-note-core) plugin. 
+
+```javascript*/
+const FNC = app.plugins.plugins['folder-note-core']?.resolver;
+const file = ea.targetView.file;
+if(!FNC) return;
+if(!FNC.createFolderForNoteCheck(file)) return;
+FNC.createFolderForNote(file);

ea-scripts/Folder Note Core - Make Current Drawing a Folder.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path fill="none" stroke-width="2" d="M10.5 20H4a2 2 0 0 1-2-2V5c0-1.1.9-2 2-2h3.93a2 2 0 0 1 1.66.9l.82 1.2a2 2 0 0 0 1.66.9H20a2 2 0 0 1 2 2v3"></path>
+  <circle fill="none" stroke-width="2" cx="18" cy="18" r="3"></circle>
+  <path fill="none" stroke-width="2" d="M18 14v1"></path>
+  <path fill="none" stroke-width="2" d="M18 21v1"></path>
+  <path fill="none" stroke-width="2" d="M22 18h-1"></path>
+  <path fill="none" stroke-width="2" d="M15 18h-1"></path>
+  <path fill="none" stroke-width="2" d="m21 15-.88.88"></path>
+  <path fill="none" stroke-width="2" d="M15.88 20.12 15 21"></path>
+  <path fill="none" stroke-width="2" d="m21 21-.88-.88"></path>
+  <path fill="none" stroke-width="2" d="M15.88 15.88 15 15"></path>
+</svg>

ea-scripts/Hardware Eraser Support.md

@@ -0,0 +1,75 @@
+/*
+Adds support for pen inversion, a.k.a. the hardware eraser on the back of your pen.
+
+Simply use the eraser on a supported pen, and it will erase. Your previous tool will be restored when the eraser leaves the screen.
+(Tested with a surface pen, but should work with all windows ink devices, and probably others)
+
+**Note:** This script will stay active until the *Obsidian* window is closed.
+
+Compatible with my *Auto Draw for Pen* script
+
+```javascript
+*/
+
+(function() {
+    'use strict';
+
+    let activated
+    let revert
+    
+    function handlePointer(e) {
+        const activeTool = ea.getExcalidrawAPI().getAppState().activeTool;
+        const isEraser = e.pointerType === 'pen' && e.buttons & 32
+        function setActiveTool(t) {
+            ea.getExcalidrawAPI().setActiveTool(t)
+        }
+        if (!activated && isEraser) {
+            //Store previous tool
+            const btns = document.querySelectorAll('.App-toolbar input.ToolIcon_type_radio')
+            for (const i in btns) {
+                if (btns[i]?.checked) {
+                    revert = btns[i]
+                }
+            }
+            revert = activeTool
+
+            // Activate eraser tool
+            setActiveTool({type: "eraser"})
+            activated = true
+
+            // Force Excalidraw to recognize this the same as pen tip
+            // https://github.com/excalidraw/excalidraw/blob/4a9fac2d1e5c4fac334201ef53c6f5d2b5f6f9f5/src/components/App.tsx#L2945-L2951
+            Object.defineProperty(e, 'button', {
+                value: 0,
+                writable: false
+            });
+        }
+        // Keep on eraser!
+        if (isEraser && activated) {
+            setActiveTool({type: "eraser"})
+        }
+        if (activated && !isEraser) {
+            // Revert tool on release
+            // revert.click()
+            setActiveTool(revert)
+            activated = false
+            
+            // Force delete "limbo" elements
+            // This doesn't happen on the web app
+            // It's a bug caused by switching to eraser during a stroke
+            ea.setView("active");
+            var del = []
+            for (const i in ea.getViewElements()) {
+                const element = ea.getViewElements()[i];
+                if (element.opacity === 20) {
+                    del.push(element)
+                }
+            }
+            ea.deleteViewElements(del)
+            setActiveTool(revert)
+        }
+    }
+    
+    window.addEventListener('pointerdown', handlePointer, { capture: true })
+    window.addEventListener('pointermove', handlePointer, { capture: true })
+})();

ea-scripts/Hardware Eraser Support.svg

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 27.2.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 448 512" style="enable-background:new 0 0 448 512;" xml:space="preserve">
+<style type="text/css">
+	.st0{stroke:#000000;stroke-width:2;stroke-miterlimit:10;}
+</style>
+<path class="st0" d="M355.8,234.1"/>
+<g>
+	<path class="st0" d="M404.8,293.5L306.9,208l-120,137.4l97.9,85.5c13.6,11.9,34.4,10.5,46.3-3.1l76.8-88
+		C419.9,326.2,418.5,305.5,404.8,293.5z M389.4,322.2l-78.2,89.6c-3.8,4.3-10.4,4.8-14.8,1l-77.8-68l92-105.3l77.8,68
+		C392.8,311.2,393.2,317.8,389.4,322.2z"/>
+	<polygon class="st0" points="52.4,103.7 64.4,238.9 93,263.8 213,126.4 184.4,101.4 	"/>
+	
+		<rect x="108.3" y="185.1" transform="matrix(0.6578 -0.7532 0.7532 0.6578 -108.9276 230.7956)" class="st0" width="182.4" height="100.3"/>
+	<path class="st0" d="M109.7,381.6c-23.7-22.2-40-49.3-48.9-78.2c8.2-0.9,22.4-3.6,30.1-12.3c-12.6-12.5-25.3-25-37.9-37.5
+		c0-0.1,0-0.3,0-0.4l-23.6-22c-6,60.7,15.5,123.7,63.7,168.8s112.5,62.4,172.7,52.4l-24.1-22.6C194.8,432.3,146.9,416.4,109.7,381.6
+		z"/>
+	<path class="st0" d="M368.8,105.4c-56-52.4-133.5-67.2-201.3-45.5l21,19.6c56.1-13.2,117.7,1.1,163.1,43.7
+		c33,30.9,51.7,71.2,55.9,112.7c-0.2-0.4-0.3-0.6-0.3-0.6s-25.1-0.1-36.5,12.7c11.8,11.6,23.5,23.3,35.3,34.9c0,0,0,0.1,0,0.1
+		l2.4,2.3c0.4,0.4,0.9,0.9,1.3,1.3c0,0,0,0,0,0l17.7,16.6C444.7,234.1,424.8,157.7,368.8,105.4z"/>
+</g>
+</svg>

ea-scripts/Invert colors.md

@@ -0,0 +1,53 @@
+/*
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-invert-colors.jpg)
+
+The script inverts the colors on the canvas including the color palette in Element Properties.
+
+```javascript
+*/
+const defaultColorPalette = { // https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/1.6.8
+  elementStroke:["#000000","#343a40","#495057","#c92a2a","#a61e4d","#862e9c","#5f3dc4","#364fc7","#1864ab","#0b7285","#087f5b","#2b8a3e","#5c940d","#e67700","#d9480f"],
+  elementBackground:["transparent","#ced4da","#868e96","#fa5252","#e64980","#be4bdb","#7950f2","#4c6ef5","#228be6","#15aabf","#12b886","#40c057","#82c91e","#fab005","#fd7e14"],
+  canvasBackground:["#ffffff","#f8f9fa","#f1f3f5","#fff5f5","#fff0f6","#f8f0fc","#f3f0ff","#edf2ff","#e7f5ff","#e3fafc","#e6fcf5","#ebfbee","#f4fce3","#fff9db","#fff4e6"]
+};
+
+const api = ea.getExcalidrawAPI();
+const st = api.getAppState();
+
+let colorPalette = st.colorPalette ?? defaultColorPalette;
+if (Object.entries(colorPalette).length === 0) colorPalette = defaultColorPalette;
+if(!colorPalette.elementStroke || Object.entries(colorPalette.elementStroke).length === 0) colorPalette.elementStroke = defaultColorPalette.elementStroke;
+if(!colorPalette.elementBackground || Object.entries(colorPalette.elementBackground).length === 0) colorPalette.elementBackground = defaultColorPalette.elementBackground;
+if(!colorPalette.canvasBackground || Object.entries(colorPalette.canvasBackground).length === 0) colorPalette.canvasBackground = defaultColorPalette.canvasBackground;
+
+const invertColor = (color) => {
+	if(color.toLowerCase()==="transparent") return color;
+	const cm = ea.getCM(color);
+	const lightness = cm.lightness;
+	cm.lightnessTo(Math.abs(lightness-100));
+	switch (cm.format) {
+		case "hsl": return cm.stringHSL();
+		case "rgb": return cm.stringRGB();
+		case "hsv": return cm.stringHSV();
+		default: return cm.stringHEX({alpha: false});
+	}
+}
+
+const invertPaletteColors = (palette) => Object.keys(palette).forEach(key => palette[key] = invertColor(palette[key]));
+Object.keys(colorPalette).forEach(key => invertPaletteColors(colorPalette[key]));
+
+ea.copyViewElementsToEAforEditing(ea.getViewElements());
+ea.getElements().forEach(el=>{
+	el.strokeColor = invertColor(el.strokeColor);
+	el.backgroundColor = invertColor(el.backgroundColor);
+});
+
+ea.viewUpdateScene({
+  appState:{
+	  colorPalette,
+	  viewBackgroundColor: invertColor(st.viewBackgroundColor),
+	  currentItemStrokeColor: invertColor(st.currentItemStrokeColor),
+	  currentItemBackgroundColor: invertColor(st.currentItemBackgroundColor)
+  },
+  elements: ea.getElements()
+});

ea-scripts/Invert colors.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path stroke-width="2" fill="none" d="M12 16a4 4 0 1 0 0-8 4 4 0 0 0 0 8z"></path>
+  <path stroke-width="2" fill="none" d="M12 8a2.828 2.828 0 1 0 4 4"></path>
+  <path stroke-width="2" fill="none" d="M12 2v2"></path>
+  <path stroke-width="2" fill="none" d="M12 20v2"></path>
+  <path stroke-width="2" fill="none" d="m4.93 4.93 1.41 1.41"></path>
+  <path stroke-width="2" fill="none" d="m17.66 17.66 1.41 1.41"></path>
+  <path stroke-width="2" fill="none" d="M2 12h2"></path>
+  <path stroke-width="2" fill="none" d="M20 12h2"></path>
+  <path stroke-width="2" fill="none" d="m6.34 17.66-1.41 1.41"></path>
+  <path stroke-width="2" fill="none" d="m19.07 4.93-1.41 1.41"></path>
+
+</svg>

ea-scripts/Mindmap format.md

@@ -55,6 +55,8 @@ if (!settings["MindMap Format"]) {
   ea.setScriptSettings(settings);
 }
 
+const sceneElements = ea.getExcalidrawAPI().getSceneElements();
+
 // default X coordinate of the middle point of the arc
 const defaultDotX = Number(settings["curve length"].value);
 // The default length from the middle point of the arc on the X axis
@@ -137,9 +139,16 @@ const setTextXY = (rect, text) => {
 };
 
 const setChildrenXY = (parent, children, line, elementsMap) => {
-  children.x = parent.x + parent.width + line.points[2][0];
-  children.y =
-    parent.y + parent.height / 2 + line.points[2][1] - children.height / 2;
+  x = parent.x + parent.width + line.points[2][0];
+  y = parent.y + parent.height / 2 + line.points[2][1] - children.height / 2;
+  distX = children.x - x;
+  distY = children.y - y;
+
+  ea.getElementsInTheSameGroupWithElement(children, sceneElements).forEach((el) => {
+    el.x = el.x - distX;
+    el.y = el.y - distY;
+  });
+
   if (
     ["rectangle", "diamond", "ellipse"].includes(children.type) &&
     ![null, undefined].includes(children.boundElements)

ea-scripts/Organic Line Legacy.md

@@ -0,0 +1,36 @@
+/*
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-organic-line-legacy.jpg)
+
+Converts selected freedraw lines such that pencil pressure will decrease from maximum to minimum from the beginning of the line to its end. The resulting line is placed at the back of the layers, under all other items. Helpful when drawing organic mindmaps.
+
+This is the old script from this [video](https://youtu.be/JMcNDdj_lPs?t=479). Since it's release this has been superseded by custom pens that you can enable in plugin settings. For more on custom pens, watch [this](https://youtu.be/OjNhjaH2KjI) 
+
+The benefit of the approach in this implementation of custom pens is that it will look the same on excalidraw.com when you copy your drawing over for sharing with non-Obsidian users. Otherwise custom pens are faster to use and much more configurable.
+
+```javascript
+*/
+let elements = ea.getViewSelectedElements().filter((el)=>["freedraw","line","arrow"].includes(el.type));
+if(elements.length === 0) {
+  elements = ea.getViewSelectedElements();
+  const len = elements.length;
+  if(len === 0 || ["freedraw","line","arrow"].includes(elements[len].type)) {
+    return;
+  }
+  elements = [elements[len]];
+} 
+
+ea.copyViewElementsToEAforEditing(elements);
+
+ea.getElements().forEach((el)=>{
+  el.simulatePressure = false;
+  el.type = "freedraw";
+  el.pressures = [];
+  const len = el.points.length;
+  for(i=0;i<len;i++)
+    el.pressures.push((len-i)/len);
+});
+
+await ea.addElementsToView(false,true);
+elements.forEach((el)=>ea.moveViewElementToZIndex(el.id,0));
+const ids=ea.getElements().map(el=>el.id);
+ea.selectElementsInView(ea.getViewElements().filter(el=>ids.contains(el.id)));

ea-scripts/PDF Page Text to Clipboard.md

@@ -0,0 +1,37 @@
+/*
+Copies the text from the selected PDF page on the Excalidraw canvas to the clipboard.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/Kwt_8WdOUT4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+Link:: https://youtu.be/Kwt_8WdOUT4
+
+
+```js*/
+const el = ea.getViewSelectedElements().filter(el=>el.type==="image")[0];
+if(!el) {
+  new Notice("Select a PDF page");
+  return;
+}
+const f = ea.getViewFileForImageElement(el);
+if(f.extension.toLowerCase() !== "pdf") {
+  new Notice("Select a PDF page");
+  return;
+}
+
+const pageNum = parseInt(ea.targetView.excalidrawData.getFile(el.fileId).linkParts.ref.replace(/\D/g, ""));
+if(isNaN(pageNum)) {
+  new Notice("Can't find page number");
+  return;
+}
+
+const pdfDoc = await window.pdfjsLib.getDocument(app.vault.getResourcePath(f)).promise;
+const page = await pdfDoc.getPage(pageNum);
+const text = await page.getTextContent();
+if(!text) {
+	new Notice("Could not get text");
+	return;
+}
+pdfDoc.destroy();
+window.navigator.clipboard.writeText(
+  text.items.reduce((acc, cur) => acc + cur.str.replace(/\x00/ug, '') + (cur.hasEOL ? "\n" : ""),"")
+);
+new Notice("Page text is available on the clipboard");

ea-scripts/PDF Page Text to Clipboard.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512"><!--! Font Awesome Pro 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path d="M64 0C28.7 0 0 28.7 0 64V448c0 35.3 28.7 64 64 64H320c35.3 0 64-28.7 64-64V160H256c-17.7 0-32-14.3-32-32V0H64zM256 0V128H384L256 0zM112 256H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16zm0 64H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16zm0 64H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16z"/></svg>

ea-scripts/Palette loader.md

@@ -1,19 +1,42 @@
 /*
+
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/epYNx2FSf2w" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+Link:: https://youtu.be/epYNx2FSf2w
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/diBT5iaoAYo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+Link:: https://youtu.be/diBT5iaoAYo
+
 Design your palette at http://paletton.com/
 Once you are happy with your colors, click Tables/Export in the bottom right of the screen:
 ![|400](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-sketch-palette-loader-1.jpg)
 Then click "Color swatches/as Sketch Palette"
+
 ![|400](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-sketch-palette-loader-2.jpg)
 Copy the contents of the page to a markdown file in your vault. Place the file in the Excalidraw/Palettes folder (you can change this folder in settings).
+
 ![|400](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-sketch-palette-loader-3.jpg)
+
 ![|400](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-sketch-palette-loader-4.jpg)
 
-```javascript
+Excalidraw  appState Custom Palette Data Object:
+```js
+colorPalette: {
+  canvasBackground: [string, string, string, string, string][] | string[],
+  elementBackground: [string, string, string, string, string][] | string[],
+  elementStroke: [string, string, string, string, string][] | string[],
+  topPicks: {
+    canvasBackground: [string, string, string, string, string],
+    elementStroke: [string, string, string, string, string],
+    elementBackground: [string, string, string, string, string] 
+  },
+}
+
 */
 //--------------------------
 // Load settings
 //--------------------------
-if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.7.19")) {
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.9.2")) {
   new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
   return;
 }
@@ -51,138 +74,256 @@ if(paletteFolder === "" || paletteFolder === "/") {
 if(!paletteFolder.endsWith("/")) paletteFolder += "/";
 
 
-//--------------------------
-// Select palette
-//--------------------------
-const palettes = app.vault.getFiles()
-  .filter(f=>f.extension === "md" && f.path.toLowerCase() === paletteFolder + f.name.toLowerCase())
-  .sort((a,b)=>a.basename.toLowerCase()<b.basename.toLowerCase()?-1:1);
-const file = await utils.suggester(["Excalidraw Default"].concat(palettes.map(f=>f.name)),["Default"].concat(palettes), "Choose a palette, press ESC to abort");
-if(!file) return;
-
-if(file === "Default") {
-  api.updateScene({
-    appState: {
-	    colorPalette: {}
+//-----------------------
+// UPDATE CustomPalette
+//-----------------------
+const updateColorPalette = (paletteFragment) => {
+  const st = ea.getExcalidrawAPI().getAppState();
+  colorPalette = st.colorPalette ?? {};
+  if(paletteFragment?.topPicks) {
+    if(!colorPalette.topPicks) {
+      colorPalette.topPicks = {
+        ...paletteFragment.topPicks
+      };
+    } else {
+      colorPalette.topPicks = {
+        ...colorPalette.topPicks,
+        ...paletteFragment.topPicks
+      }
     }
-  });
-  return;
+  } else {
+    colorPalette = {
+      ...colorPalette,
+      ...paletteFragment
+    }
+  }
+  ea.viewUpdateScene({appState: {colorPalette}});
+  ea.addElementsToView(true,true); //elements is empty, but this will save the file
 }
 
-//--------------------------
-// Load palette
-//--------------------------
-const sketchPalette = await app.vault.read(file);
 
-const parseJSON = (data) => {
-  try {
-    return JSON.parse(data);
-  } catch(e) {
+//----------------
+// LOAD PALETTE
+//----------------
+const loadPalette = async () => {
+  //--------------------------
+  // Select palette
+  //--------------------------
+  const palettes = app.vault.getFiles()
+    .filter(f=>f.extension === "md" && f.path.toLowerCase() === paletteFolder + f.name.toLowerCase())
+    .sort((a,b)=>a.basename.toLowerCase()<b.basename.toLowerCase()?-1:1);
+  const file = await utils.suggester(["Excalidraw Default"].concat(palettes.map(f=>f.name)),["Default"].concat(palettes), "Choose a palette, press ESC to abort");
+  if(!file) return;
+
+  if(file === "Default") {
+    api.updateScene({
+      appState: {
+        colorPalette: {}
+      }
+    });
+    return;
+  }
+
+  //--------------------------
+  // Load palette
+  //--------------------------
+  const sketchPalette = await app.vault.read(file);
+
+  const parseJSON = (data) => {
+    try {
+      return JSON.parse(data);
+    } catch(e) {
+	  return;
+    }
+  }
+
+  const loadPaletteFromPlainText = (data) => {
+    const colors = [];
+    data.replaceAll("\r","").split("\n").forEach(c=>{
+      c = c.trim();
+      if(c==="") return;
+      if(c.match(/[^hslrga-fA-F\(\d\.\,\%\s)#]/)) return;
+      const cm = ea.getCM(c);
+      if(cm) colors.push(cm.stringHEX({alpha: false}));
+    })
+    return colors;
+  }
+
+  const paletteJSON = parseJSON(sketchPalette);
+
+  const colors = paletteJSON
+    ? paletteJSON.colors.map(c=>ea.getCM({r:c.red*255,g:c.green*255,b:c.blue*255,a:c.alpha}).stringHEX({alpha: false}))
+    : loadPaletteFromPlainText(sketchPalette);
+  const baseColor = ea.getCM(colors[0]);
+
+  // Add black, white, transparent, gary
+  const palette = [[
+    "transparent",
+    "black",
+    baseColor.mix({color: lightGray, ratio:0.95}).stringHEX({alpha: false}),
+    baseColor.mix({color: darkGray, ratio:0.95}).stringHEX({alpha: false}),
+    "white"
+  ]];
+
+  // Create Excalidraw palette
+  for(i=0;i<Math.floor(colors.length/5);i++) {
+    palette.push([
+	  colors[i*5+1],
+      colors[i*5+2],
+      colors[i*5],
+      colors[i*5+3],
+      colors[i*5+4]
+    ]);
+  }
+
+  const getShades = (c,type) => {
+    cm = ea.getCM(c);
+    const lightness = cm.lightness;
+    if(lightness === 0 || lightness === 100) return c;
+
+	switch(type) {
+	  case "canvas":
+        return [
+          c,
+          ea.getCM(c).lightnessTo((100-lightness)*0.5+lightness).stringHEX({alpha: false}),
+          ea.getCM(c).lightnessTo((100-lightness)*0.25+lightness).stringHEX({alpha: false}),
+          ea.getCM(c).lightnessTo(lightness*0.5).stringHEX({alpha: false}),
+          ea.getCM(c).lightnessTo(lightness*0.25).stringHEX({alpha: false}),
+        ];
+      case "stroke":
+        return [
+          ea.getCM(c).lightnessTo((100-lightness)*0.5+lightness).stringHEX({alpha: false}),
+	      ea.getCM(c).lightnessTo((100-lightness)*0.25+lightness).stringHEX({alpha: false}),
+	      ea.getCM(c).lightnessTo(lightness*0.5).stringHEX({alpha: false}),
+	      ea.getCM(c).lightnessTo(lightness*0.25).stringHEX({alpha: false}),
+	      c,
+        ];
+      case "background":
+        return [
+          ea.getCM(c).lightnessTo((100-lightness)*0.5+lightness).stringHEX({alpha: false}),
+          c,
+          ea.getCM(c).lightnessTo((100-lightness)*0.25+lightness).stringHEX({alpha: false}),
+          ea.getCM(c).lightnessTo(lightness*0.5).stringHEX({alpha: false}),
+          ea.getCM(c).lightnessTo(lightness*0.25).stringHEX({alpha: false}),
+        ];
+	}
+  }
+
+  const paletteSize = palette.flat().length;
+  const newPalette = {
+    canvasBackground: palette.flat().map(c=>getShades(c,"canvas")),
+    elementStroke: palette.flat().map(c=>getShades(c,"stroke")),
+    elementBackground: palette.flat().map(c=>getShades(c,"background"))
+  };
+
+
+  //--------------------------
+  // Check if palette has the same size as the current. Is re-paint possible?
+  //--------------------------
+  const oldPalette = api.getAppState().colorPalette;
+
+  //You can only switch and repaint equal size palettes
+  let canRepaint = Boolean(oldPalette) && Object.keys(oldPalette).length === 3 &&
+    oldPalette.canvasBackground.length  === paletteSize &&
+    oldPalette.elementBackground.length === paletteSize &&
+    oldPalette.elementStroke.length     === paletteSize;
+
+  //Check that the palette for canvas background, element stroke and element background are the same
+  for(i=0;canRepaint && i<paletteSize;i++) {
+    if(
+      oldPalette.canvasBackground[i] !== oldPalette.elementBackground[i] ||
+      oldPalette.canvasBackground[i] !== oldPalette.elementStroke[i]
+    ) {
+      canRepaint = false;
+      break;
+    }
+  }
+
+  const shouldRepaint = canRepaint && await utils.suggester(["Try repainting the drawing with the new palette","Just load the new palette"], [true, false],"ESC will load the palette without repainting");
+
+
+  //--------------------------
+  // Apply palette
+  //--------------------------
+  if(shouldRepaint) {
+    const map = new Map();
+    for(i=0;i<paletteSize;i++) {
+      map.set(oldPalette.canvasBackground[i],newPalette.canvasBackground[i])
+    }
+
+    ea.copyViewElementsToEAforEditing(ea.getViewElements());
+    ea.getElements().forEach(el=>{
+      el.strokeColor = map.get(el.strokeColor)??el.strokeColor;
+      el.backgroundColor = map.get(el.backgroundColor)??el.backgroundColor;
+    })
+
+    const canvasColor = api.getAppState().viewBackgroundColor;
+
+    await api.updateScene({
+      appState: {
+        viewBackgroundColor: map.get(canvasColor)??canvasColor
+      }
+    });
+
+    ea.addElementsToView();
+  }
+  updateColorPalette(newPalette);
+}
+
+//-------------
+// TOP PICKS
+//-------------
+const topPicks = async () => {
+  const elements = ea.getViewSelectedElements().filter(el=>["rectangle", "diamond", "ellipse", "line"].includes(el.type));
+  if(elements.length !== 5) {
+    new Notice("Select 5 elements, the script will use the background color of these elements",6000);
+    return;
+  }
+
+  const colorType = await utils.suggester(["View Background", "Element Background", "Stroke"],["view", "background", "stroke"], "Which top-picks would you like to set?");
+
+  if(!colorType) {
+    new Notice("You did not select which color to set");
+    return;
+  }
+
+  const topPicks = elements.map(el=>el.backgroundColor);
+  switch(colorType) {
+    case "view": updateColorPalette({topPicks: {canvasBackground: topPicks}}); break;
+    case "stroke": updateColorPalette({topPicks: {elementStroke: topPicks}}); break;
+    default: updateColorPalette({topPicks: {elementBackground: topPicks}}); break;
+  }
+}
+
+//-----------------------------------
+// Copy palette from another file
+//-----------------------------------
+const copyPaletteFromFile = async () => {
+  const files = app.vault.getFiles().filter(f => ea.isExcalidrawFile(f)).sort((a,b)=>a.name > b.name ? 1 : -1);
+  const file = await utils.suggester(files.map(f=>f.path),files,"Select the file to copy from");
+  if(!file) {
+    return;
+  }
+  scene = await ea.getSceneFromFile(file);
+  if(!scene || !scene.appState) {
+	  new Notice("unknown error");
 	  return;
   }
+  ea.viewUpdateScene({appState: {colorPalette: {...scene.appState.colorPalette}}});
+  ea.addElementsToView(true,true);
 }
 
-const loadPaletteFromPlainText = (data) => {
-  const colors = [];
-  data.replaceAll("\r","").split("\n").forEach(c=>{
-    c = c.trim();
-    if(c==="") return;
-    if(c.match(/[^hslrga-fA-F\(\d\.\,\%\s)#]/)) return;
-    const cm = ea.getCM(c);
-    if(cm) colors.push(cm.stringHEX({alpha: false}));
-  })
-  return colors;
-}
+//----------
+// START
+//----------
+const action = await utils.suggester(
+  ["Load palette from file", "Set top-picks based on the background color of 5 selected elements", "Copy palette from another Excalidraw File"],
+  ["palette","top-picks","copy"]
+);
+if(!action) return;
 
-const paletteJSON = parseJSON(sketchPalette);
-
-const colors = paletteJSON
-  ? paletteJSON.colors.map(c=>ea.getCM({r:c.red*255,g:c.green*255,b:c.blue*255,a:c.alpha}).stringHEX({alpha: false}))
-  : loadPaletteFromPlainText(sketchPalette);
-const baseColor = ea.getCM(colors[0]);
-
-// Add black, white, transparent, gary
-const palette = [[
-  "transparent",
-  "black",
-  baseColor.mix({color: lightGray, ratio:0.95}).stringHEX({alpha: false}),
-  baseColor.mix({color: darkGray, ratio:0.95}).stringHEX({alpha: false}),
-  "white"
-]];
-
-// Create Excalidraw palette
-for(i=0;i<Math.floor(colors.length/5);i++) {
-  palette.push([
-	  colors[i*5+1],
-    colors[i*5+2],
-    colors[i*5],
-    colors[i*5+3],
-    colors[i*5+4]
-  ]);
-}
-
-const paletteSize = palette.flat().length;
-const newPalette = {
-  canvasBackground: palette.flat(),
-  elementStroke: palette.flat(),
-  elementBackground: palette.flat()
-};
-
-
-//--------------------------
-// Check if palette has the same size as the current. Is re-paint possible?
-//--------------------------
-const oldPalette = api.getAppState().colorPalette;
-
-//You can only switch and repaint equal size palettes
-let canRepaint = Object.keys(oldPalette).length === 3 &&
-  oldPalette.canvasBackground.length  === paletteSize &&
-  oldPalette.elementBackground.length === paletteSize &&
-  oldPalette.elementStroke.length     === paletteSize;
-
-//Check that the palette for canvas background, element stroke and element background are the same
-for(i=0;canRepaint && i<paletteSize;i++) {
-  if(
-    oldPalette.canvasBackground[i] !== oldPalette.elementBackground[i] ||
-    oldPalette.canvasBackground[i] !== oldPalette.elementStroke[i]
-  ) {
-    canRepaint = false;
-    break;
-  }
-}
-
-const shouldRepaint = canRepaint && await utils.suggester(["Try repainting the drawing with the new palette","Just load the new palette"], [true, false],"ESC will load the palette without repainting");
-
-
-//--------------------------
-// Apply palette
-//--------------------------
-if(shouldRepaint) {
-  const map = new Map();
-  for(i=0;i<paletteSize;i++) {
-    map.set(oldPalette.canvasBackground[i],newPalette.canvasBackground[i])
-  }
-
-  ea.copyViewElementsToEAforEditing(ea.getViewElements());
-  ea.getElements().forEach(el=>{
-    el.strokeColor = map.get(el.strokeColor)??el.strokeColor;
-    el.backgroundColor = map.get(el.backgroundColor)??el.backgroundColor;
-  })
-
-  const canvasColor = api.getAppState().viewBackgroundColor;
-
-  await api.updateScene({
-    appState: {
-      colorPalette: newPalette,
-      viewBackgroundColor: map.get(canvasColor)??canvasColor
-    }
-  });
-
-  ea.addElementsToView();
-} else {
-  api.updateScene({
-    appState: {
-	    colorPalette: newPalette
-    }
-  });
-}
+switch(action) {
+  case "palette": loadPalette(); break;
+  case "top-picks": topPicks(); break;
+  case "copy": copyPaletteFromFile(); break;
+}

ea-scripts/README.md

@@ -33,6 +33,7 @@ Open the script you are interested in and save it to your Obsidian Vault includi
 |[Add Link to Existing File and Open](Add%20Link%20to%20Existing%20File%20and%20Open.md)|Prompts for a file from the vault. Adds a link to the selected element pointing to the selected file. You can control in settings to open the file in the current active pane or an adjacent pane.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-add-link-and-open.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Add Link to New Page and Open](Add%20Link%20and%20Open%20Page.md)|Prompts for filename. Offers option to create and open a new Markdown or Excalidraw document. Adds link pointing to the new file, to the selected objects in the drawing. You can control in settings to open the file in the current active pane or an adjacent pane.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-add-link-to-new-page-and-pen.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Add Next Step in Process](Add%20Link%20to%20New%20Page%20and%20Open.md)|This script will prompt you for the title of the process step, then will create a stick note with the text. If an element is selected then the script will connect this new step with an arrow to the previous step (the selected element). If no element is selected, then the script assumes this is the first step in the process and will only output the sticky note with the text that was entered.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-add-process-step.jpg)|[@zsviczian](https://github.com/zsviczian)|
+|[Split Ellipse](Boolean%20Operations.md)|With This Script it is possible to make boolean Operations on Shapes.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-boolean-operations-showcase.png)|[@GColoy](https://github.com/GColoy)|
 |[Box Each Selected Groups](Box%20Each%20Selected%20Groups.md)|This script will add encapsulating boxes around each of the currently selected groups in Excalidraw.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-box-each-selected-groups.png)|[@1-2-3](https://github.com/1-2-3)|
 |[Box Selected Elements](Box%20Selected%20Elements.md)|This script will add an encapsulating box around the currently selected elements in Excalidraw.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-box-elements.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Change shape of selected elements](Change%20shape%20of%20selected%20elements.md)|The script allows you to change the shape of selected Rectangles, Diamonds and Ellipses|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-change-shape.jpg)|[@zsviczian](https://github.com/zsviczian)|
@@ -71,7 +72,11 @@ Open the script you are interested in and save it to your Obsidian Vault includi
 |[Set stroke width of selected elements](Set%20Stroke%20Width%20of%20Selected%20Elements.md)|This script will set the stroke width of selected elements. This is helpful, for example, when you scale freedraw sketches and want to reduce or increase their line width.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-stroke-width.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Split text by lines](Split%20text%20by%20lines.md)|Split lines of text into separate text elements for easier reorganization|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-split-lines.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Set Text Alignment](Set%20Text%20Alignment.md)|Sets text alignment of text block (cetner, right, left). Useful if you want to set a keyboard shortcut for selecting text alignment.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-align.jpg)|[@zsviczian](https://github.com/zsviczian)|
+|[Split Ellipse](Split%20Ellipse.md)|This script splits an ellipse at any point where a line intersects it.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-splitEllipse-demo1.png)|[@GColoy](https://github.com/GColoy)|
 |[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)|
+|[Toggle Grid](Toggle%20Grid.md)|Toggles the grid.||[@GColoy](https://github.com/GColoy)|
 |[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 <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)|
+|[Hardware Eraser Suppoer](Hardware%20Eraser%20Support.md)|Allows the use of pen inversion/hardware erasers on supported pens.|[@threethan](https://github.com/threethan)|
+|[Hardware Eraser Suppoer](Auto%20Draw%20for%20Pen.md)|Automatically switched from the Select tool to the Draw tool when a pen is hovered, and then back.|[@threethan](https://github.com/threethan)|

ea-scripts/Scribble Helper.md

@@ -1,29 +1,388 @@
 /*
 ![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-scribble-helper.jpg)
 
-iOS scribble helper for better handwriting experience with text elements. If no elements are selected then the script creates a text element at the pointer position and you can use the edit box to modify the text with scribble. If a text element is selected then the script opens the input prompt where you can modify this text with scribble.
+Scribble Helper can improve handwriting and add links. It lets you create and edit text elements, including wrapped text and sticky notes, by double-tapping on the canvas. When you run the script, it creates an event handler that will activate the editor when you double-tap. If you select a text element on the canvas before running the script, it will open the editor for that element. If you use a pen, you can set it up to only activate Scribble Helper when you double-tap with the pen. The event handler is removed when you run the script a second time or switch to a different tab.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/BvYkOaly-QM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
 ```javascript
 */
-
-
-elements = ea.getViewSelectedElements().filter(el=>el.type==="text");
-if(elements.length > 1) {
-  new Notice ("Select only 1 or 0 text elements.")
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.8.25")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
   return;
 }
 
-const text = await utils.inputPrompt("Edit text","",(elements.length === 1)?elements[0].rawText:"");
-if(!text) return;
+const helpLINK = "https://youtu.be/BvYkOaly-QM";
+const DBLCLICKTIMEOUT = 300;
+const maxWidth = 600;
+const padding = 6;
+const api = ea.getExcalidrawAPI();
+const win = ea.targetView.ownerWindow;
+if(!win.ExcalidrawScribbleHelper) win.ExcalidrawScribbleHelper = {};
+if(typeof win.ExcalidrawScribbleHelper.penOnly === "undefined") {
+  win.ExcalidrawScribbleHelper.penOnly = false;
+}
+let windowOpen = false; //to prevent the modal window to open again while writing with scribble
+let prevZoomValue = api.getAppState().zoom.value; //used to avoid trigger on pinch zoom
 
-if(elements.length === 1) {
-	ea.copyViewElementsToEAforEditing(elements);
-  ea.getElements()[0].originalText = text;
-  ea.getElements()[0].text = text;
-  ea.getElements()[0].rawText = text;
+// -------------
+// Load settings
+// -------------
+let settings = ea.getScriptSettings();
+//set default values on first-ever run of the script
+if(!settings["Default action"]) {
+  settings = {
+    "Default action" : {
+      value: "Text",
+      valueset: ["Text","Sticky","Wrap"],
+      description: "What type of element should CTRL/CMD+ENTER create. TEXT: A regular text element. " +
+        "STICKY: A sticky note with border color and background color " +
+        "(using the current setting of the canvas). STICKY: A sticky note with transparent " +
+        "border and background color."
+    },
+  };
+  await ea.setScriptSettings(settings);
+}
+
+if(typeof win.ExcalidrawScribbleHelper.action === "undefined") {
+  win.ExcalidrawScribbleHelper.action = settings["Default action"].value;
+}
+
+//---------------------------------------
+// Color Palette for stroke color setting
+//---------------------------------------
+// https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/1.6.8
+const defaultStrokeColors = [
+    "#000000", "#343a40", "#495057", "#c92a2a", "#a61e4d",
+    "#862e9c", "#5f3dc4", "#364fc7", "#1864ab", "#0b7285",
+    "#087f5b", "#2b8a3e", "#5c940d", "#e67700", "#d9480f"
+  ];
+
+const loadColorPalette = () => {
+  const st = api.getAppState();
+  const strokeColors = new Set();
+  let strokeColorPalette = st.colorPalette?.elementStroke ?? defaultStrokeColors;
+  if(Object.entries(strokeColorPalette).length === 0) {
+    strokeColorPalette = defaultStrokeColors;
+  }
+
+  ea.getViewElements().forEach(el => {
+    if(el.strokeColor.toLowerCase()==="transparent") return;
+    strokeColors.add(el.strokeColor);
+  });
+
+  strokeColorPalette.forEach(color => {
+    strokeColors.add(color)
+  });
+
+  strokeColors.add(st.currentItemStrokeColor ?? ea.style.strokeColor);
+  return strokeColors;
+}
+
+//----------------------------------------------------------
+// Define variables to cache element location on first click
+//----------------------------------------------------------
+// if a single element is selected when the action is started, update that existing text
+let containerElements = ea.getViewSelectedElements()
+  .filter(el=>["arrow","rectangle","ellipse","line","diamond"].contains(el.type));
+let selectedTextElements = ea.getViewSelectedElements().filter(el=>el.type==="text");
+
+//-------------------------------------------
+// Functions to add and remove event listners
+//-------------------------------------------
+const addEventHandler = (handler) => {
+  if(win.ExcalidrawScribbleHelper.eventHandler) {
+    win.removeEventListner("pointerdown", handler);
+  }
+  win.addEventListener("pointerdown",handler);
+  win.ExcalidrawScribbleHelper.eventHandler = handler;
+  win.ExcalidrawScribbleHelper.window = win;
+}
+
+const removeEventHandler = (handler) => {
+  win.removeEventListener("pointerdown",handler);
+  delete win.ExcalidrawScribbleHelper.eventHandler;
+  delete win.ExcalidrawScribbleHelper.window;
+}
+
+//Stop the script if scribble helper is clicked and no eligable element is selected
+let silent = false;
+if (win.ExcalidrawScribbleHelper?.eventHandler) {
+  removeEventHandler(win.ExcalidrawScribbleHelper.eventHandler);
+  delete win.ExcalidrawScribbleHelper.eventHandler;
+  delete win.ExcalidrawScribbleHelper.window;
+  if(!(containerElements.length === 1 || selectedTextElements.length === 1)) {
+    new Notice ("Scribble Helper was stopped",1000);
+    return;
+  }
+  silent = true;
+}
+
+// ----------------------
+// Custom dialog controls
+// ----------------------
+if (typeof win.ExcalidrawScribbleHelper.penOnly === "undefined") {
+  win.ExcalidrawScribbleHelper.penOnly = undefined;
+}
+if (typeof win.ExcalidrawScribbleHelper.penDetected === "undefined") {
+  win.ExcalidrawScribbleHelper.penDetected = false;
+}
+let timer = Date.now();
+let eventHandler = () => {};
+
+const customControls =  (container) => {
+  const helpDIV = container.createDiv();
+  helpDIV.innerHTML = `<a href="${helpLINK}" target="_blank">Click here for help</a>`;
+  const viewBackground = api.getAppState().viewBackgroundColor;
+  const el1 = new ea.obsidian.Setting(container)
+    .setName(`Text color`)
+    .addDropdown(dropdown => {
+      Array.from(loadColorPalette()).forEach(color => {
+        const options = dropdown.addOption(color, color).selectEl.options;
+        options[options.length-1].setAttribute("style",`color: ${color
+          }; background: ${viewBackground};`);
+      });
+      dropdown
+        .setValue(ea.style.strokeColor)
+        .onChange(value => {
+          ea.style.strokeColor = value;
+          el1.nameEl.style.color = value;
+        })
+    })
+  el1.nameEl.style.color = ea.style.strokeColor;
+  el1.nameEl.style.background = viewBackground;
+  el1.nameEl.style.fontWeight = "bold";
+								 
+  const el2 = new ea.obsidian.Setting(container)
+    .setName(`Trigger editor by pen double tap only`)
+    .addToggle((toggle) => toggle
+      .setValue(win.ExcalidrawScribbleHelper.penOnly)
+      .onChange(value => {
+        win.ExcalidrawScribbleHelper.penOnly = value;
+      })
+    )
+  el2.settingEl.style.border = "none";
+  el2.settingEl.style.display = win.ExcalidrawScribbleHelper.penDetected ? "" : "none";
+}
+
+// -------------------------------
+// Click / dbl click event handler
+// -------------------------------
+eventHandler = async (evt) => {
+  if(windowOpen) return;
+  if(ea.targetView !== app.workspace.activeLeaf.view) removeEventHandler(eventHandler);
+  if(evt && evt.target && !evt.target.hasClass("excalidraw__canvas")) return;
+  if(evt && (evt.ctrlKey || evt.altKey || evt.metaKey || evt.shiftKey)) return;  
+  const st = api.getAppState();
+  win.ExcalidrawScribbleHelper.penDetected = st.penDetected;
+  
+  //don't trigger text editor when editing a line or arrow
+  if(st.editingElement && ["arrow","line"].contains(st.editingElment.type)) return; 
+  
+  if(typeof win.ExcalidrawScribbleHelper.penOnly === "undefined") {
+    win.ExcalidrawScribbleHelper.penOnly = false;
+  }
+  
+  if (evt && win.ExcalidrawScribbleHelper.penOnly &&
+    win.ExcalidrawScribbleHelper.penDetected && evt.pointerType !== "pen") return;
+  const now = Date.now();
+  
+  //the <50 condition is to avoid false double click when pinch zooming
+  if((now-timer > DBLCLICKTIMEOUT) || (now-timer < 50)) {
+    prevZoomValue = st.zoom.value;
+    timer = now;
+    containerElements = ea.getViewSelectedElements()
+      .filter(el=>["arrow","rectangle","ellipse","line","diamond"].contains(el.type));
+    selectedTextElements = ea.getViewSelectedElements().filter(el=>el.type==="text");
+	  return;
+  }
+  //further safeguard against triggering when pinch zooming
+  if(st.zoom.value !== prevZoomValue) return;
+  
+  //sleeping to allow keyboard to pop up on mobile devices
+  await sleep(200);
+  ea.clear();
+
+  //if a single element with text is selected, edit the text
+  //(this can be an arrow, a sticky note, or just a text element)
+  if(selectedTextElements.length === 1) {
+    editExistingTextElement(selectedTextElements);
+    return;
+  }
+  
+  let containerID;
+  let container;
+  //if no text elements are selected (i.e. not multiple text  elements selected),
+  //check if there is a single eligeable container selected
+  if(selectedTextElements.length === 0) {
+    if(containerElements.length === 1) {
+      ea.copyViewElementsToEAforEditing(containerElements);
+      containerID = containerElements[0].id
+      container = ea.getElement(containerID);
+    }
+  }
+  
+  const {x,y} = ea.targetView.currentPosition;
+
+  if(ea.targetView !== app.workspace.activeLeaf.view) return;
+  const actionButtons = [
+    {
+      caption: `A`,
+      tooltip: "Add as Text Element",
+      action: () => {
+        win.ExcalidrawScribbleHelper.action="Text";
+        if(settings["Default action"].value!=="Text") {
+          settings["Default action"].value = "Text";
+          ea.setScriptSettings(settings);
+        };
+        return;
+      }
+    },
+    {
+      caption: "📝",
+      tooltip: "Add as Sticky Note (rectangle with border color and background color)",
+      action: () => {
+        win.ExcalidrawScribbleHelper.action="Sticky";
+        if(settings["Default action"].value!=="Sticky") {
+          settings["Default action"].value = "Sticky";
+          ea.setScriptSettings(settings);
+        };
+        return;
+      }
+    },
+    {
+      caption: "☱",
+      tooltip: "Add as Wrapped Text (rectangle with transparent border and background)",
+      action: () => {
+        win.ExcalidrawScribbleHelper.action="Wrap";
+        if(settings["Default action"].value!=="Wrap") {
+          settings["Default action"].value = "Wrap";
+          ea.setScriptSettings(settings);
+        };
+        return;
+      }
+    }
+  ];
+  if(win.ExcalidrawScribbleHelper.action !== "Text") actionButtons.push(actionButtons.shift());
+  if(win.ExcalidrawScribbleHelper.action === "Wrap") actionButtons.push(actionButtons.shift());
+
+  ea.style.strokeColor = st.currentItemStrokeColor ?? ea.style.strokeColor;
+  ea.style.roughness = st.currentItemRoughness ?? ea.style.roughness;
+  ea.setStrokeSharpness(st.currentItemRoundness === "round" ? 0 : st.currentItemRoundness)
+  ea.style.backgroundColor = st.currentItemBackgroundColor ?? ea.style.backgroundColor;
+  ea.style.fillStyle = st.currentItemFillStyle ?? ea.style.fillStyle;
+  ea.style.fontFamily = st.currentItemFontFamily ?? ea.style.fontFamily;
+  ea.style.fontSize = st.currentItemFontSize ?? ea.style.fontSize;
+  ea.style.textAlign = (container && ["arrow","line"].contains(container.type))
+    ? "center"
+    : (container && ["rectangle","diamond","ellipse"].contains(container.type))
+      ? "center"
+      : st.currentItemTextAlign ?? "center";
+  ea.style.verticalAlign = "middle";
+
+  windowOpen = true;
+  const text = await utils.inputPrompt (
+    "Edit text", "", "", containerID?undefined:actionButtons, 5, true, customControls, true
+  );
+  windowOpen = false;
+
+  if(!text || text.trim() === "") return;
+
+  const textId = ea.addText(x,y, text);
+  if (!container && (win.ExcalidrawScribbleHelper.action === "Text")) {
+    ea.addElementsToView(false, false, true);
+    addEventHandler(eventHandler);
+    return;
+  }
+  const textEl = ea.getElement(textId);
+
+  if(!container && (win.ExcalidrawScribbleHelper.action === "Wrap")) {
+    ea.style.backgroundColor = "transparent";
+    ea.style.strokeColor = "transparent";
+  }
+
+  if(!container && (win.ExcalidrawScribbleHelper.action === "Sticky")) {
+    textEl.textAlign = "center";
+  }
+
+  const boxes = [];
+  if(container) {
+    boxes.push(containerID);
+    const linearElement = ["arrow","line"].contains(container.type);
+    const l = linearElement ? container.points.length-1 : 0;
+    const dx = linearElement && (container.points[l][0] < 0) ? -1 : 1;
+    const dy = linearElement && (container.points[l][1] < 0) ? -1 : 1;
+    cx = container.x + dx*container.width/2;
+    cy = container.y + dy*container.height/2;
+    textEl.x = cx - textEl.width/2;
+    textEl.y = cy - textEl.height/2;
+  }
+
+  if(!container) {
+    const width = textEl.width+2*padding;
+    const widthOK = width<=maxWidth;
+    containerID = ea.addRect(
+      textEl.x-padding,
+      textEl.y-padding,
+      widthOK ? width : maxWidth,
+      textEl.height + 2 * padding
+    );
+    container = ea.getElement(containerID);
+  } 
+  boxes.push(containerID);
+  container.boundElements=[{type:"text",id: textId}];
+  textEl.containerId = containerID;
+  //ensuring the correct order of elements, first container, then text
+  delete ea.elementsDict[textEl.id];
+  ea.elementsDict[textEl.id] = textEl;
+
+  await ea.addElementsToView(false,false,true);
+  const containers = ea.getViewElements().filter(el=>boxes.includes(el.id));
+  if(["rectangle","diamond","ellipse"].includes(container.type)) api.updateContainerSize(containers);
+  ea.selectElementsInView(containers);
+};
+
+// ---------------------
+// Edit Existing Element
+// ---------------------
+const editExistingTextElement = async (elements) => {
+  windowOpen = true;
+  ea.copyViewElementsToEAforEditing(elements);
+  const el = ea.getElements()[0];
+  ea.style.strokeColor = el.strokeColor;
+  const text = await utils.inputPrompt(
+    "Edit text","",elements[0].rawText,undefined,5,true,customControls,true
+  ); 
+  windowOpen = false;
+  if(!text) return;
+  
+  el.strokeColor = ea.style.strokeColor;
+  el.originalText = text;
+  el.text = text;
+  el.rawText = text;
+  ea.refreshTextElementSize(el.id);
   await ea.addElementsToView(false,false);
-  return;
+  if(el.containerId) {
+    const containers = ea.getViewElements().filter(e=>e.id === el.containerId);
+    api.updateContainerSize(containers);
+    ea.selectElementsInView(containers);
+  }
 }
 
-ea.addText(0,0,text);
-await ea.addElementsToView(true, false, true);
+//--------------
+// Start actions
+//--------------
+if(!win.ExcalidrawScribbleHelper?.eventHandler) {
+  if(!silent) new Notice(
+    "To create a new text element,\ndouble-tap the screen.\n\n" +
+    "To edit text,\ndouble-tap an existing element.\n\n" +
+    "To stop the script,\ntap it again or switch to a different tab.",
+    5000
+  );
+  addEventHandler(eventHandler);
+}
+
+if(containerElements.length === 1 || selectedTextElements.length === 1) {
+  timer = timer - 100;
+  eventHandler();
+}

ea-scripts/Select Similar Elements.md

@@ -0,0 +1,204 @@
+/*
+
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-select-similar-elements.png)
+
+This script allows users to streamline their Obsidian-Excalidraw workflows by enabling the selection of elements based on similar properties. Users can precisely define which attributes such as stroke color, fill style, font family, and more, should match for selection. It's perfect for large canvases where manual selection would be cumbersome. Users can either run the script to find and select matching elements across the entire scene, or define a specific group of elements to apply the selection criteria within a defined timeframe. This script enhances control and efficiency in your Excalidraw experience.
+
+```js */
+
+let config = window.ExcalidrawSelectConfig;
+config = config && (Date.now() - config.timestamp < 60000) ? config : null;
+
+let elements = ea.getViewSelectedElements();
+if(!config && (elements.length !==1)) {
+  new Notice("Select a single element");
+  return;
+} else {
+  if(elements.length === 0) {
+    elements = ea.getViewElements();
+  }
+}
+
+const {angle, backgroundColor, fillStyle, fontFamily, fontSize, height, width, opacity, roughness, roundness, strokeColor, strokeStyle, strokeWidth, type, startArrowhead, endArrowhead} = ea.getViewSelectedElement();
+
+const fragWithHTML = (html) => createFragment((frag) => (frag.createDiv().innerHTML = html));
+  
+//--------------------------
+// RUN
+//--------------------------
+const run = () => {
+  selectedElements = ea.getViewElements().filter(el=>
+    ((typeof config.angle === "undefined") || (el.angle === config.angle)) &&
+    ((typeof config.backgroundColor === "undefined") || (el.backgroundColor === config.backgroundColor)) &&
+    ((typeof config.fillStyle === "undefined") || (el.fillStyle === config.fillStyle)) &&
+    ((typeof config.fontFamily === "undefined") || (el.fontFamily === config.fontFamily)) &&
+    ((typeof config.fontSize === "undefined") || (el.fontSize === config.fontSize)) &&
+	((typeof config.height === "undefined") || Math.abs(el.height - config.height) < 0.01) &&
+	((typeof config.width === "undefined") || Math.abs(el.width - config.width) < 0.01) &&
+    ((typeof config.opacity === "undefined") || (el.opacity === config.opacity)) &&
+    ((typeof config.roughness === "undefined") || (el.roughness === config.roughness)) &&
+    ((typeof config.roundness === "undefined") || (el.roundness === config.roundness)) &&
+    ((typeof config.strokeColor === "undefined") || (el.strokeColor === config.strokeColor)) &&
+    ((typeof config.strokeStyle === "undefined") || (el.strokeStyle === config.strokeStyle)) &&
+    ((typeof config.strokeWidth === "undefined") || (el.strokeWidth === config.strokeWidth)) &&
+    ((typeof config.type === "undefined") || (el.type === config.type)) &&
+    ((typeof config.startArrowhead === "undefined") || (el.startArrowhead === config.startArrowhead)) &&
+    ((typeof config.endArrowhead === "undefined") || (el.endArrowhead === config.endArrowhead))
+  )
+  ea.selectElementsInView(selectedElements);
+  delete window.ExcalidrawSelectConfig;
+}
+
+//--------------------------
+// Modal
+//--------------------------
+const showInstructions = () => {
+  const instructionsModal = new ea.obsidian.Modal(app);
+  instructionsModal.onOpen = () => {
+    instructionsModal.contentEl.createEl("h2", {text: "Instructions"});
+	instructionsModal.contentEl.createEl("p", {text: "Step 1: Choose the attributes that you want the selected elements to match."});
+	instructionsModal.contentEl.createEl("p", {text: "Step 2: Select an action:"});
+	instructionsModal.contentEl.createEl("ul", {}, el => {
+	  el.createEl("li", {text: "Click 'RUN' to find matching elements throughout the entire scene."});
+	  el.createEl("li", {text: "Click 'SELECT' to first choose a specific group of elements. Then run the 'Select Similar Elements' script once more on that group within 1 minute."});
+	});
+	instructionsModal.contentEl.createEl("p", {text: "Note: If you choose 'SELECT', make sure to click the 'Select Similar Elements' script again within 1 minute to apply your selection criteria to the group of elements you chose."});
+  };
+  instructionsModal.open();
+};
+
+const selectAttributesToCopy = () => {
+  const configModal = new ea.obsidian.Modal(app);
+  configModal.onOpen = () => {
+    config = {};
+	configModal.contentEl.createEl("h1", {text: "Select Similar Elements"});
+    new ea.obsidian.Setting(configModal.contentEl)
+      .setDesc("Choose the attributes you want the selected elements to match, then select an action.")
+      .addButton(button => button
+        .setButtonText("Instructions")
+        .onClick(showInstructions)
+      );
+
+    
+    // Add Toggles for the rest of the attributes
+	let attributes = [
+	  {name: "Element type", key: "type"},
+	  {name: "Stroke color", key: "strokeColor"},
+	  {name: "Background color", key: "backgroundColor"},
+	  {name: "Opacity", key: "opacity"},
+	  {name: "Fill style", key: "fillStyle"},
+	  {name: "Stroke style", key: "strokeStyle"},
+	  {name: "Stroke width", key: "strokeWidth"},
+	  {name: "Roughness", key: "roughness"},
+	  {name: "Roundness", key: "roundness"},           
+	  {name: "Font family", key: "fontFamily"},
+	  {name: "Font size", key: "fontSize"},
+	  {name: "Start arrowhead", key: "startArrowhead"},
+	  {name: "End arrowhead", key: "endArrowhead"},
+	  {name: "Height", key: "height"},
+	  {name: "Width", key: "width"},
+	];
+  
+	attributes.forEach(attr => {
+	  const attrValue = elements[0][attr.key];
+	  if(attrValue || (attr.key === "startArrowhead" && elements[0].type === "arrow") || (attr.key === "endArrowhead" && elements[0].type === "arrow")) {
+	    let description = '';
+	
+	    switch(attr.key) {
+	      case 'backgroundColor':
+	      case 'strokeColor':
+	        description = `<div style='background-color:${attrValue};'>${attrValue}</div>`;
+	        break;
+	      case 'roundness':
+	        description = attrValue === null ? 'Sharp' : 'Round';
+	        break;
+	      case 'roughness':
+	        description = attrValue === 0 ? 'Architect' : attrValue === 1 ? 'Artist' : 'Cartoonist';
+	        break;
+	      case 'strokeWidth':
+	        description = attrValue <= 0.5 ? 'Extra thin' : 
+	                      attrValue <= 1 ? 'Thin' :
+	                      attrValue <= 2 ? 'Bold' :
+	                      'Extra bold';
+	        break;
+	      case 'opacity':
+	        description = `${attrValue}%`;
+	        break;
+	      case 'width':
+	      case 'height':
+	        description = `${attrValue.toFixed(2)}`;
+			break;
+	      case 'startArrowhead':
+	      case 'endArrowhead':
+	        description = attrValue === null ? 'None' : `${attrValue.charAt(0).toUpperCase() + attrValue.slice(1)}`;
+	        break;
+	      case 'fontFamily':
+	        description = attrValue === 1 ? 'Hand-drawn' :
+	                      attrValue === 2 ? 'Normal' :
+	                      attrValue === 3 ? 'Code' :
+	                      'Custom 4th font';
+	        break;
+	      case 'fontSize':
+	        description = `${attrValue}`;
+	        break;
+	      default:
+	        console.log(attr.key);
+	        console.log(attrValue);
+	        description = `${attrValue.charAt(0).toUpperCase() + attrValue.slice(1)}`;
+	        break;
+	    }
+	
+	    new ea.obsidian.Setting(configModal.contentEl)
+	      .setName(`${attr.name}`)
+	      .setDesc(fragWithHTML(`${description}`))
+	      .addToggle(toggle => toggle
+	        .setValue(false)
+	        .onChange(value => {
+	          if(value) {
+	            config[attr.key] = attrValue;
+	          } else {
+	            delete config[attr.key];
+	          }
+	        })
+	      )
+	  }
+	});
+
+
+	//Add Toggle for the rest of the attirbutes. Organize attributes into a logical sequence or groups by adding
+	//configModal.contentEl.createEl("h") or similar to the code
+
+    new ea.obsidian.Setting(configModal.contentEl)
+      .addButton(button => button
+        .setButtonText("SELECT")
+        .onClick(()=>{
+	      config.timestamp = Date.now();
+	      window.ExcalidrawSelectConfig = config;
+	      configModal.close();
+        })
+      ) 
+	  .addButton(button => button
+		.setButtonText("RUN")
+		.setCta(true)
+        .onClick(()=>{
+          elements = ea.getViewElements();
+          run();
+          configModal.close();
+        })
+      )
+	}
+
+  
+	configModal.onClose = () => {
+      setTimeout(()=>delete configModal);
+	}
+	
+	configModal.open();
+}
+
+
+if(config) {
+  run();
+} else {
+  selectAttributesToCopy();
+}

ea-scripts/Select Similar Elements.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-filter"><polygon fill="none" stroke-width="2" points="22 3 2 3 10 12.46 10 19 14 21 14 12.46 22 3"/></svg>

ea-scripts/Set Grid.md

@@ -8,18 +8,44 @@ https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.h
 
 ```javascript
 */
-if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.8.11")) {
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.9.19")) {
   new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
   return;
 }
 
 const api = ea.getExcalidrawAPI();
 let appState = api.getAppState();
-const grid = parseInt(await utils.inputPrompt("Grid size?",null,appState.previousGridSize?.toString()??"20"));
+const gridColor = appState.gridColor;
+let gridFrequency = gridColor?.MajorGridFrequency ?? 5;
+
+const customControls =  (container) => {
+  new ea.obsidian.Setting(container)
+    .setName(`Major grid frequency`)
+    .addDropdown(dropdown => {
+      [2,3,4,5,6,7,8,9,10].forEach(grid=>dropdown.addOption(grid,grid));
+      dropdown
+        .setValue(gridFrequency)
+        .onChange(value => {
+           gridFrequency = value;
+        })
+    })
+}
+
+const grid = parseInt(await utils.inputPrompt(
+  "Grid size?",
+  null,
+  appState.previousGridSize?.toString()??"20",
+  null,
+  1,
+  false,
+  customControls
+));
 if(isNaN(grid)) return; //this is to avoid passing an illegal value to Excalidraw
+
 appState.gridSize = grid;
 appState.previousGridSize = grid;
+if(gridColor) gridColor.MajorGridFrequency = parseInt(gridFrequency);
 api.updateScene({
-  appState,
+  appState : {gridSize: grid, previousGridSize: grid, gridColor},
   commitToHistory:false
 });

ea-scripts/Set background color of unclosed line object by adding a shadow clone.md

@@ -1,7 +1,7 @@
 /*
 ![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-set-background-color-of-unclosed-line.jpg)
 
-Use this script to set the background color of unclosed (i.e. open) line and freedraw objects by creating a clone of the object. The script will set the stroke color of the clone to transparent and will add a straight line to close the object. Use settings to define the default background color, the fill style, and the strokeWidth of the clone. By default the clone will be grouped with the original object, you can disable this also in settings.
+Use this script to set the background color of unclosed (i.e. open) line, arrow and freedraw objects by creating a clone of the object. The script will set the stroke color of the clone to transparent and will add a straight line to close the object. Use settings to define the default background color, the fill style, and the strokeWidth of the clone. By default the clone will be grouped with the original object, you can disable this also in settings.
 
 ```javascript
 */
@@ -41,9 +41,9 @@ const backgroundColor = settings["Background Color"].value;
 const fillStyle = settings["Fill Style"].value;
 const shouldGroup = settings["Group 'shadow' with original"].value;
 
-const elements = ea.getViewSelectedElements().filter(el=>el.type==="line" || el.type==="freedraw");
+const elements = ea.getViewSelectedElements().filter(el=>el.type==="line" || el.type==="freedraw" || el.type==="arrow");
 if(elements.length === 0) {
-	new Notice("No line or freedraw object is selected");
+  new Notice("No line or freedraw object is selected");
 }
 
 ea.copyViewElementsToEAforEditing(elements);
@@ -52,19 +52,20 @@ elementsToMove = [];
 elements.forEach((el)=>{
   const newEl = ea.cloneElement(el);
   ea.elementsDict[newEl.id] = newEl;
-	newEl.roughness = 1;
-	if(!inheritStrokeWidth) newEl.strokeWidth = 2;
+  newEl.roughness = 1;
+  if(!inheritStrokeWidth) newEl.strokeWidth = 2;
   newEl.strokeColor = "transparent";
   newEl.backgroundColor = backgroundColor;
-	newEl.fillStyle = fillStyle;
-	const i = el.points.length-1;
-	newEl.points.push([ 
-    //adding an extra point close to the last point in case distance is long from last point to origin and there is a sharp bend. This will avoid a spike due to a tight curve.
-		el.points[i][0]*0.9,
+  newEl.fillStyle = fillStyle;
+  if (newEl.type === "arrow") newEl.type = "line";
+  const i = el.points.length-1;
+  newEl.points.push([ 
+  //adding an extra point close to the last point in case distance is long from last point to origin and there is a sharp bend. This will avoid a spike due to a tight curve.
+    el.points[i][0]*0.9,
     el.points[i][1]*0.9,
-	]);
+  ]);
   newEl.points.push([0,0]);
-	if(shouldGroup) ea.addToGroup([el.id,newEl.id]);
+  if(shouldGroup) ea.addToGroup([el.id,newEl.id]);
   elementsToMove.push({fillId: newEl.id, shapeId: el.id});
 });
 
@@ -72,9 +73,9 @@ await ea.addElementsToView(false,false);
 elementsToMove.forEach((x)=>{
   const viewElements = ea.getViewElements();
   ea.moveViewElementToZIndex(
-		x.fillId,
+    x.fillId,
     viewElements.indexOf(viewElements.filter(el=>el.id === x.shapeId)[0])-1
-	)
+  )
 });
 
 ea.selectElementsInView(ea.getElements());

ea-scripts/Slideshow.md

@@ -1,197 +1,539 @@
 /*
-![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-slideshow-1.jpg)
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/JwgtCrIVeEU" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
 ![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-slideshow-2.jpg)
 The script will convert your drawing into a slideshow presentation.
+If you select an arrow or line element, the script will use that as the presentation path.
+If you select nothing, but the file has a hidden presentation path, the script will use that for determining the slide sequence.
+If there are frames, the script will use the frames for the presentation. Frames are played in alphabetical order of their titles.
 
 ```javascript
 */
-
-if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.8.2")) {
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.9.23")) {
   new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
   return;
 }
 
+const hostLeaf = ea.targetView.leaf;
+const hostView = hostLeaf.view;
+const statusBarElement = document.querySelector("div.status-bar");
+const ctrlKey = ea.targetView.modifierKeyDown.ctrlKey || ea.targetView.modifierKeyDown.metaKey;
+const altKey = ea.targetView.modifierKeyDown.altKey || ctrlKey;
+
+//-------------------------------
 //constants
-const STEPCOUNT = 100;
+//-------------------------------
+const TRANSITION_STEP_COUNT = 100;
+const TRANSITION_DELAY = 1000; //maximum time for transition between slides in milliseconds
 const FRAME_SLEEP = 1; //milliseconds
+const EDIT_ZOOMOUT = 0.7; //70% of original slide zoom, set to a value between 1 and 0
+const FADE_LEVEL = 0.15; //opacity of the slideshow controls after fade delay (value between 0 and 1)
+//using outerHTML because the SVG object returned by Obsidin is in the main workspace window
+//but excalidraw might be open in a popout window which has a different document object
+const SVG_COG = ea.obsidian.getIcon("lucide-settings").outerHTML;
+const SVG_FINISH = ea.obsidian.getIcon("lucide-x").outerHTML;
+const SVG_RIGHT_ARROW = ea.obsidian.getIcon("lucide-arrow-right").outerHTML;
+const SVG_LEFT_ARROW = ea.obsidian.getIcon("lucide-arrow-left").outerHTML;
+const SVG_EDIT = ea.obsidian.getIcon("lucide-pencil").outerHTML;
+const SVG_MAXIMIZE = ea.obsidian.getIcon("lucide-maximize").outerHTML;
+const SVG_MINIMIZE = ea.obsidian.getIcon("lucide-minimize").outerHTML;
+const SVG_LASER_ON = ea.obsidian.getIcon("lucide-hand").outerHTML;
+const SVG_LASER_OFF = ea.obsidian.getIcon("lucide-wand").outerHTML;
 
+//-------------------------------
 //utility & convenience functions
-const doc = ea.targetView.ownerDocument;
-const win = ea.targetView.ownerWindow;
-const api = ea.getExcalidrawAPI();
+//-------------------------------
+let isLaserOn = false;
+let slide = 0;
+let isFullscreen = false;
+const ownerDocument = ea.targetView.ownerDocument;
+const startFullscreen = !altKey;
+//The plugin and Obsidian App run in the window object
+//When Excalidraw is open in a popout window, the Excalidraw component will run in the ownerWindow
+//and in this case ownerWindow !== window
+//For this reason event handlers are distributed between window and owner window depending on their role
+const ownerWindow = ea.targetView.ownerWindow;
+const excalidrawAPI = ea.getExcalidrawAPI();
+const frameRenderingOriginalState = excalidrawAPI.getAppState().frameRendering;
 const contentEl = ea.targetView.contentEl;
-const sleep = async (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const sleep = async (ms) => new Promise((resolve) => ownerWindow.setTimeout(resolve, ms));
+const getFrameName = (name, index) => name ?? `Frame ${(index+1).toString().padStart(2, '0')}`;
 
+//-------------------------------
 //clean up potential clutter from previous run
+//-------------------------------
 window.removePresentationEventHandlers?.();
 
-//check if line or arrow is selected, if not inform the user and terminate presentation
-const lineEl = ea.getViewSelectedElement();
-if(!lineEl || !["line","arrow"].contains(lineEl.type)) {
-  new Notice("Please select the line or arrow for the presentation path");
-  return;
+//1. check if line or arrow is selected, if not check if frames are available, if not inform the user and terminate presentation
+let presentationPathLineEl = ea.getViewElements()
+  .filter(el=>["line","arrow"].contains(el.type) && el.customData?.slideshow)[0];
+
+const frameClones = [];
+ea.getViewElements().filter(el=>el.type==="frame").forEach(f=>frameClones.push(ea.cloneElement(f)));
+for(i=0;i<frameClones.length;i++) {
+  frameClones[i].name = getFrameName(frameClones[i].name,i);
+}
+let frames = frameClones
+  .sort((el1,el2)=> el1.name > el2.name ? 1:-1); 
+
+let presentationPathType = "line"; // "frame"
+const selectedEl = ea.getViewSelectedElement();
+let shouldHideArrowAfterPresentation = true; //this controls if the hide arrow button is available in settings
+if(presentationPathLineEl && selectedEl && ["line","arrow"].contains(selectedEl.type)) {
+  excalidrawAPI.setToast({
+    message:"Using selected line instead of hidden line. Note that there is a hidden presentation path for this drawing. Run the slideshow script without selecting any elements to access the hidden presentation path",
+    duration: 5000,
+    closable: true
+  })
+  shouldHideArrowAfterPresentation = false;
+  presentationPathLineEl = selectedEl;
+}
+if(!presentationPathLineEl) presentationPathLineEl = selectedEl;
+if(!presentationPathLineEl || !["line","arrow"].contains(presentationPathLineEl.type)) {
+	if(frames.length > 0) {
+	  presentationPathType = "frame";
+	} else {
+	  excalidrawAPI.setToast({
+	    message:"Please select the line or arrow for the presentation path or add frames.",
+	    duration: 3000,
+	    closable: true
+	  })
+	  return;
+	}
 }
 
-//goto fullscreen
-if(app.isMobile) {
-  ea.viewToggleFullScreen(true);
-} else {
-  await contentEl.webkitRequestFullscreen();
-  await sleep(500);
-  ea.setViewModeEnabled(true);
-}
-const deltaWidth = () => contentEl.clientWidth-api.getAppState().width;
-let watchdog = 0;
-while (deltaWidth()>50 && watchdog++<20) await sleep(100); //wait for Excalidraw to resize to fullscreen
-contentEl.querySelector(".layer-ui__wrapper").addClass("excalidraw-hidden");
+//---------------------------------------------
+// generate slides[] array
+//---------------------------------------------
+let slides = [];
 
-//hide the arrow and save the arrow color before doing so
-const originalColor = {
-	strokeColor: lineEl.strokeColor,
-	backgroundColor: lineEl.backgroundColor
-}
-ea.copyViewElementsToEAforEditing([lineEl]);
-ea.getElement(lineEl.id).strokeColor = "transparent";
-ea.getElement(lineEl.id).backgroundColor = "transparent";
-await ea.addElementsToView();
-
-//----------------------------
-//scroll-to-location functions
-//----------------------------
-let slide = -1;
-const slideCount = Math.floor(lineEl.points.length/2)-1;
-
-const getNextSlide = (forward) => {
-  slide = forward
-    ? slide < slideCount ? slide + 1  : 0
-	: slide <= 0         ? slideCount : slide - 1;
-	return {pointA:lineEl.points[slide*2], pointB:lineEl.points[slide*2+1]}
+if(presentationPathType === "line") {
+	const getLineSlideRect = ({pointA, pointB}) => {
+	  const x1 = presentationPathLineEl.x+pointA[0];
+	  const y1 = presentationPathLineEl.y+pointA[1];
+	  const x2 = presentationPathLineEl.x+pointB[0];
+	  const y2 = presentationPathLineEl.y+pointB[1];
+	  return { x1, y1, x2, y2};
+	}
+	
+	const slideCount = Math.floor(presentationPathLineEl.points.length/2)-1;
+	for(i=0;i<=slideCount;i++) {
+	  slides.push(getLineSlideRect({
+	    pointA:presentationPathLineEl.points[i*2],
+	    pointB:presentationPathLineEl.points[i*2+1]
+	  }))
+	}
 }
 
-const getSlideRect = ({pointA, pointB}) => {
-  const {width, height} = api.getAppState();
-  const x1 = lineEl.x+pointA[0];
-  const y1 = lineEl.y+pointA[1];
-  const x2 = lineEl.x+pointB[0];
-  const y2 = lineEl.y+pointB[1];
-  const ratioX = width/Math.abs(x1-x2);
-  const ratioY = height/Math.abs(y1-y2);
-  let ratio = ratioX<ratioY?ratioX:ratioY;
-  if (ratio < 0.1) ratio = 0.1;
-  if (ratio > 10) ratio = 10;
-  const deltaX = (ratio===ratioY)?(width/ratio - Math.abs(x1-x2))/2:0;
-  const deltaY = (ratio===ratioX)?(height/ratio - Math.abs(y1-y2))/2:0;
+if(presentationPathType === "frame") {
+	for(frame of frames) {
+		slides.push({
+		  x1: frame.x,
+		  y1: frame.y,
+		  x2: frame.x + frame.width,
+		  y2: frame.y + frame.height
+		});
+	}
+	if(frameRenderingOriginalState.enabled) {
+  	excalidrawAPI.updateScene({
+	    appState: {
+	      frameRendering: {
+	        ...frameRenderingOriginalState,
+	        enabled: false
+	      }
+	    }
+	  });
+	}
+}
+
+//---------------------------------------
+// Toggle fullscreen
+//---------------------------------------
+let toggleFullscreenButton;
+let controlPanelEl;
+let selectSlideDropdown;
+
+const resetControlPanelElPosition = () => {
+  if(!controlPanelEl) return;
+  const top = contentEl.innerHeight; 
+  const left = contentEl.innerWidth/2; 
+  controlPanelEl.style.top = `calc(${top}px - var(--default-button-size)*2)`;
+  controlPanelEl.style.left = `calc(${left}px - var(--default-button-size)*5)`;
+  slide--;
+  navigate("fwd");
+}
+
+const waitForExcalidrawResize = async () => {
+  await sleep(100);
+	const deltaWidth = () => Math.abs(contentEl.clientWidth-excalidrawAPI.getAppState().width);
+	const deltaHeight = () => Math.abs(contentEl.clientHeight-excalidrawAPI.getAppState().height);
+	let watchdog = 0;
+	while ((deltaWidth()>50 || deltaHeight()>50) && watchdog++<20) await sleep(50); //wait for Excalidraw to resize to fullscreen
+}
+
+let preventFullscreenExit = true;
+const gotoFullscreen = async () => {
+  if(isFullscreen) return;
+  preventFullscreenExit = true;
+	if(app.isMobile) {
+	  ea.viewToggleFullScreen();
+	} else {
+		await contentEl.webkitRequestFullscreen();
+	}
+	await waitForExcalidrawResize();
+	const layerUIWrapper = contentEl.querySelector(".layer-ui__wrapper");
+	if(!layerUIWrapper.hasClass("excalidraw-hidden")) layerUIWrapper.addClass("excalidraw-hidden");
+	if(toggleFullscreenButton) toggleFullscreenButton.innerHTML = SVG_MINIMIZE;
+	resetControlPanelElPosition();
+	isFullscreen = true;
+}
+
+const exitFullscreen = async () => {
+  if(!isFullscreen) return;
+  preventFullscreenExit = true;
+  if(!app.isMobile && ownerDocument?.fullscreenElement) await ownerDocument.exitFullscreen();
+  if(app.isMobile) ea.viewToggleFullScreen();
+  if(toggleFullscreenButton) toggleFullscreenButton.innerHTML = SVG_MAXIMIZE;
+  await waitForExcalidrawResize();
+  resetControlPanelElPosition();
+  isFullscreen = false;
+}
+
+const toggleFullscreen = async () => {
+ if (isFullscreen) {
+   await exitFullscreen();
+ } else {
+	 await gotoFullscreen();
+ }
+}
+
+//-----------------------------------------------------
+// hide the arrow for the duration of the presentation
+// and save the arrow color before doing so
+//-----------------------------------------------------
+let isHidden;
+let originalProps;
+const toggleArrowVisibility = async (setToHidden) => {
+	ea.clear();
+	ea.copyViewElementsToEAforEditing(ea.getViewElements().filter(el=>el.id === presentationPathLineEl.id));
+	const el = ea.getElement(presentationPathLineEl.id);
+	el.strokeColor = "transparent";
+	el.backgroundColor = "transparent";
+	const customData = el.customData;
+	if(setToHidden && shouldHideArrowAfterPresentation) {
+		el.locked = true;
+		el.customData = {
+			...customData,
+			slideshow: {
+				originalProps,
+				hidden: true
+			}
+		}
+		isHidden = true;
+	} else {
+		if(customData) delete el.customData.slideshow;
+		isHidden = false;
+	}
+	await ea.addElementsToView();
+}
+
+if(presentationPathType==="line") {
+	originalProps = presentationPathLineEl.customData?.slideshow?.hidden
+	  ? presentationPathLineEl.customData.slideshow.originalProps
+	  : {
+		  strokeColor: presentationPathLineEl.strokeColor,
+		  backgroundColor: presentationPathLineEl.backgroundColor,
+		  locked: presentationPathLineEl.locked,
+	  };
+	isHidden = presentationPathLineEl.customData?.slideshow?.hidden ?? false;
+}
+
+//-----------------------------
+// scroll-to-location functions
+//-----------------------------
+const getNavigationRect = ({ x1, y1, x2, y2 }) => {
+  const { width, height } = excalidrawAPI.getAppState();
+  const ratioX = width / Math.abs(x1 - x2);
+  const ratioY = height / Math.abs(y1 - y2);
+  let ratio = Math.min(Math.max(ratioX, ratioY), 10);
+
+  const scaledWidth = Math.abs(x1 - x2) * ratio;
+  const scaledHeight = Math.abs(y1 - y2) * ratio;
+
+  if (scaledWidth > width || scaledHeight > height) {
+    ratio = Math.min(width / Math.abs(x1 - x2), height / Math.abs(y1 - y2));
+  }
+
+  const deltaX = (width / ratio - Math.abs(x1 - x2)) / 2;
+  const deltaY = (height / ratio - Math.abs(y1 - y2)) / 2;
+
   return {
-    left: (x1<x2?x1:x2)-deltaX,
-    top: (y1<y2?y1:y2)-deltaY,
-    right: (x1<x2?x2:x1)+deltaX,
-    bottom: (y1<y2?y2:y1)+deltaY,
-    nextZoom: ratio
+    left: (x1 < x2 ? x1 : x2) - deltaX,
+    top: (y1 < y2 ? y1 : y2) - deltaY,
+    right: (x1 < x2 ? x2 : x1) + deltaX,
+    bottom: (y1 < y2 ? y2 : y1) + deltaY,
+    nextZoom: ratio,
   };
+};
+
+const getNextSlideRect = (forward) => {
+  slide = forward
+    ? slide < slides.length-1 ? slide + 1     : 0
+    : slide <= 0            ? slides.length-1 : slide - 1;
+	return getNavigationRect(slides[slide]);
 }
 
 let busy = false;
-const scrollToNextRect = async ({left,top,right,bottom,nextZoom}) => {
+const scrollToNextRect = async ({left,top,right,bottom,nextZoom},steps = TRANSITION_STEP_COUNT) => {
+  const startTimer = Date.now();
   let watchdog = 0;
-  while(busy && watchdog++<15) await(100);
+  while(busy && watchdog++<15) await sleep(100);
   if(busy && watchdog >= 15) return;
   busy = true;
-  const {scrollX, scrollY, zoom} = api.getAppState();
-  const zoomStep = (zoom.value-nextZoom)/STEPCOUNT;
-  const xStep = (left+scrollX)/STEPCOUNT;
-  const yStep = (top+scrollY)/STEPCOUNT;
-  for(i=1;i<=STEPCOUNT;i++) {
-    api.updateScene({
+  excalidrawAPI.updateScene({appState:{shouldCacheIgnoreZoom:true}});
+  const {scrollX, scrollY, zoom} = excalidrawAPI.getAppState();
+  const zoomStep = (zoom.value-nextZoom)/steps;
+  const xStep = (left+scrollX)/steps;
+  const yStep = (top+scrollY)/steps;
+  let i=1;
+  while(i<=steps) {
+    excalidrawAPI.updateScene({
       appState: {
         scrollX:scrollX-(xStep*i),
         scrollY:scrollY-(yStep*i),
         zoom:{value:zoom.value-zoomStep*i},
-        shouldCacheIgnoreZoom:true,
       }
     });
-    await sleep(FRAME_SLEEP);
+    const ellapsed = Date.now()-startTimer;
+    if(ellapsed > TRANSITION_DELAY) {
+      i = i<steps ? steps : steps+1;
+    } else {
+      const timeProgress = ellapsed / TRANSITION_DELAY;
+      i=Math.min(Math.round(steps*timeProgress),steps)
+      await sleep(FRAME_SLEEP);
+    }
+  }
+  excalidrawAPI.updateScene({appState:{shouldCacheIgnoreZoom:false}});
+  if(isLaserOn) {
+    excalidrawAPI.setActiveTool({type: "laser"});
   }
-  api.updateScene({appState:{shouldCacheIgnoreZoom:false}});
   busy = false;
 }
 
 const navigate = async (dir) => {
   const forward = dir === "fwd";
   const prevSlide = slide;
-  const nextSlide = getNextSlide(forward);
+  const nextRect = getNextSlideRect(forward);
   
   //exit if user navigates from last slide forward or first slide backward
   const shouldExit = forward
     ? slide<=prevSlide
     : slide>=prevSlide;
   if(shouldExit) {
-    if(!app.isMobile) await doc.exitFullscreen();
     exitPresentation();
     return;
   }
-  if(slideNumberEl) slideNumberEl.innerText = `${slide+1}/${slideCount+1}`;
-  const nextRect = getSlideRect(nextSlide);
+  if(selectSlideDropdown) selectSlideDropdown.value = slide+1;
   await scrollToNextRect(nextRect);
 }
 
-//--------------------------------------
-//Slideshow control
-//--------------------------------------
-//create slideshow controlpanel container
-const top = contentEl.innerHeight; 
-const left = contentEl.innerWidth; 
-const containerEl = contentEl.createDiv({
-  cls: ["excalidraw","excalidraw-presentation-panel"],
-  attr: {
-    style: `
-      width: calc(var(--default-button-size)*3);
-      z-index:5;
-      position: absolute;
-      top:calc(${top}px - var(--default-button-size)*2);
-      left:calc(${left}px - var(--default-button-size)*3.5);`
-  }
-}); 
-const panelColumn = containerEl.createDiv({
-  cls: "panelColumn",
-});
-let slideNumberEl;
-panelColumn.createDiv({
-  cls: ["Island", "buttonList"],
-  attr: {
-    style: `
-      height: calc(var(--default-button-size)*1.5);
-      width: 100%;
-      background: var(--island-bg-color);`,
-  }
-}, el=>{
-  el.createEl("button",{
-    text: "<",
-    attr: {
-      style: `
-        margin-top: calc(var(--default-button-size)*0.25);
-        margin-left: calc(var(--default-button-size)*0.25);`
-    }
-  }, button => button .onclick = () => navigate("bkwd"));
-  el.createEl("button",{
-    text: ">",
-    attr: {
-      style: `
-        margin-top: calc(var(--default-button-size)*0.25);
-        margin-right: calc(var(--default-button-size)*0.25);`
-    }
-  }, button => button.onclick = () => navigate("fwd"));
-  slideNumberEl = el.createEl("span",{
-	  text: "1",
-	  cls: ["ToolIcon__keybinding"],
-  })
-});
+const navigateToSlide = (slideNumber) => {
+  if(slideNumber > slides.length) slideNumber = slides.length;
+  if(slideNumber < 1) slideNumber = 1;
+  slide = slideNumber - 2;
+  navigate("fwd");
+}
 
-//keyboard navigation
+//--------------------------------------
+// Slideshow control panel
+//--------------------------------------
+let controlPanelFadeTimout = 0;
+const setFadeTimeout = (delay) => {
+  delay = delay ?? TRANSITION_DELAY;
+  controlPanelFadeTimeout = ownerWindow.setTimeout(()=>{
+    controlPanelFadeTimout = 0;
+    if(ownerDocument.activeElement === selectSlideDropdown) {
+      setFadeTimeout(delay);
+      return;
+    }
+	  controlPanelEl.style.opacity = FADE_LEVEL;
+  },delay);
+}
+const clearFadeTimeout = () => {
+  if(controlPanelFadeTimeout) {
+	  ownerWindow.clearTimeout(controlPanelFadeTimeout);
+	  controlPanelFadeTimeout = 0;
+  }
+  controlPanelEl.style.opacity = 1;
+}
+
+const createPresentationNavigationPanel = () => {
+  //create slideshow controlpanel container
+  const top = contentEl.innerHeight; 
+  const left = contentEl.innerWidth/2; 
+  controlPanelEl = contentEl.querySelector(".excalidraw").createDiv({
+    cls: ["excalidraw-presentation-panel"],
+    attr: {
+      style: `
+        width: fit-content;
+        z-index:5;
+        position: absolute;
+        top:calc(${top}px - var(--default-button-size)*2);
+        left:calc(${left}px - var(--default-button-size)*5);`
+    }
+  });
+  setFadeTimeout(TRANSITION_DELAY*3);
+  
+  const panelColumn = controlPanelEl.createDiv({
+    cls: "panelColumn",
+  });
+  
+	panelColumn.createDiv({
+	  cls: ["Island", "buttonList"],
+	  attr: {
+	    style: `
+	      max-width: unset;
+	      justify-content: space-between;
+	      height: calc(var(--default-button-size)*1.5);
+	      width: 100%;
+	      background: var(--island-bg-color);
+	      display: flex;
+	      align-items: center;`,
+	  }
+	}, el=>{
+	  el.createEl("style", 
+	    { text: ` select:focus { box-shadow: var(--input-shadow);} `});
+	  el.createEl("button",{
+	    attr: {
+	      style: `
+	        margin-left: calc(var(--default-button-size)*0.25);`,
+	      "aria-label": "Previous slide",
+	      title: "Previous slide"
+	    }
+	  }, button => {
+	    button.innerHTML = SVG_LEFT_ARROW;
+	    button.onclick = () => navigate("bkwd")
+	  });
+    selectSlideDropdown = el.createEl("select", {
+      attr: {
+        style: `
+          font-size: inherit;
+          background-color: var(--island-bg-color);
+          border: none;
+          color: var(--color-gray-100);
+          cursor: pointer;
+        }`,
+        title: "Navigate to slide"
+      }
+    }, selectEl => {
+	    for (let i = 0; i < slides.length; i++) {
+	      const option = document.createElement("option");
+        option.text = (presentationPathType === "frame")
+          ? `${frames[i].name}/${slides.length}`
+          : option.text = `Slide ${i + 1}/${slides.length}`;
+	      option.value = i + 1;
+	      selectEl.add(option);
+	    }
+	    selectEl.addEventListener("change", () => {
+	      const selectedSlideNumber = parseInt(selectEl.value);
+	      selectEl.blur();
+	      navigateToSlide(selectedSlideNumber);
+	    });
+	  });
+	  el.createEl("button",{
+	    attr: {
+	      title: "Next slide"
+	    },
+	  }, button => {
+	    button.innerHTML = SVG_RIGHT_ARROW;
+	    button.onclick = () => navigate("fwd");
+	  });
+	  el.createDiv({
+		  attr: {
+	      style: `
+	        width: 1px;
+	        height: var(--default-button-size);
+	        background-color: var(--default-border-color);
+	        margin: 0px auto;`
+	      }
+	    });
+	    
+	  el.createEl("button",{
+	    attr: {
+	      title: "Toggle Laser Pointer and Panning Mode"
+	    }
+	  }, button => {
+	    button.innerHTML = isLaserOn ? SVG_LASER_ON : SVG_LASER_OFF;
+	    button.onclick = () => {
+		    isLaserOn = !isLaserOn;
+		    excalidrawAPI.setActiveTool({
+		      type: isLaserOn ? "laser" : "selection"
+		    })
+		    button.innerHTML = isLaserOn ? SVG_LASER_ON : SVG_LASER_OFF;
+	    }
+	  });
+	  
+ 	  el.createEl("button",{
+	    attr: {
+	      title: "Toggle fullscreen. If you hold ALT/OPT when starting the presentation it will not go fullscreen."
+	    },
+	  }, button => {
+	    toggleFullscreenButton = button;
+	    button.innerHTML = isFullscreen ? SVG_MINIMIZE : SVG_MAXIMIZE;
+	    button.onclick = () => toggleFullscreen();
+	  });
+	  if(presentationPathType === "line") {
+	    if(shouldHideArrowAfterPresentation) {
+		    new ea.obsidian.ToggleComponent(el)
+		      .setValue(isHidden)
+		      .onChange(value => {
+		        if(value) {
+		          excalidrawAPI.setToast({
+						    message:"The presentation path remain hidden after the presentation. No need to select the line again. Just click the slideshow button to start the next presentation.",
+						    duration: 5000,
+						    closable: true
+						  })
+		        }
+		        toggleArrowVisibility(value);
+		      })
+		      .toggleEl.setAttribute("title","Arrow visibility. ON: hidden after presentation, OFF: visible after presentation");
+		  }
+		  el.createEl("button",{
+		    attr: {
+		      title: "Edit slide"
+		    },
+		  }, button => {
+		    button.innerHTML = SVG_EDIT;
+		    button.onclick = () => {
+		      if(shouldHideArrowAfterPresentation) toggleArrowVisibility(false);
+		      exitPresentation(true);
+		    }
+		  });
+		}
+	  el.createEl("button",{
+	    attr: {
+	      style: `
+	        margin-right: calc(var(--default-button-size)*0.25);`,
+	      title: "End presentation"
+	    }
+	  }, button => {
+	    button.innerHTML = SVG_FINISH;
+	    button.onclick = () => exitPresentation()
+	  });
+	});
+}
+
+//--------------------
+// keyboard navigation
+//--------------------
 const keydownListener = (e) => {
+  if(hostLeaf !== app.workspace.activeLeaf) return;
+  if(hostLeaf.width === 0 && hostLeaf.height === 0) return;
   e.preventDefault();
   switch(e.key) {
-    case "escape":
-      if(app.isMobile) exitPresentation();
+    case "Escape":
+      exitPresentation();
       break;
     case "ArrowRight":
     case "ArrowDown": 
@@ -201,12 +543,28 @@ const keydownListener = (e) => {
     case "ArrowUp":
       navigate("bkwd");
       break;
-  }  
+    case "End":
+      slide = slides.length - 2;
+      navigate("fwd");
+      break;
+    case "Home":
+      slide = -1;
+      navigate("fwd");
+      break;
+    case "e": 
+      if(presentationPathType !== "line") return;
+      (async ()=>{
+        await toggleArrowVisibility(false);
+        exitPresentation(true);
+      })()
+      break;
+  }
 }
-doc.addEventListener('keydown',keydownListener);
 
-//slideshow panel drag
-let pos1 = pos2 = pos3 = pos4 = 0;
+//---------------------
+// slideshow panel drag
+//---------------------
+let posX1 = posY1 = posX2 = posY2 = 0;
 
 const updatePosition = (deltaY = 0, deltaX = 0) => {
   const {
@@ -214,69 +572,178 @@ const updatePosition = (deltaY = 0, deltaX = 0) => {
     offsetLeft,
     clientWidth: width,
     clientHeight: height,
-   } = containerEl;
-  containerEl.style.top = (offsetTop - deltaY) + 'px';
-  containerEl.style.left = (offsetLeft - deltaX) + 'px';
+   } = controlPanelEl;
+  controlPanelEl.style.top = (offsetTop - deltaY) + 'px';
+  controlPanelEl.style.left = (offsetLeft - deltaX) + 'px';
 }
    
-const pointerUp = () => {
-  win.removeEventListener('pointermove', onDrag, true);
+const onPointerUp = () => {
+  ownerWindow.removeEventListener('pointermove', onDrag, true);
 }
 
-const pointerDown = (e) => {
-  pos3 = e.clientX;
-  pos4 = e.clientY;
-  win.addEventListener('pointermove', onDrag, true);
+const onPointerDown = (e) => {
+	clearFadeTimeout();
+	setFadeTimeout();
+  const now = Date.now();
+  posX2 = e.clientX;
+  posY2 = e.clientY;
+  ownerWindow.addEventListener('pointermove', onDrag, true);
 }
 
 const onDrag = (e) => {
   e.preventDefault();
-  pos1 = pos3 - e.clientX;
-  pos2 = pos4 - e.clientY;
-  pos3 = e.clientX;
-  pos4 = e.clientY;
-  updatePosition(pos2, pos1);
+  posX1 = posX2 - e.clientX;
+  posY1 = posY2 - e.clientY;
+  posX2 = e.clientX;
+  posY2 = e.clientY;
+  updatePosition(posY1, posX1);
 }
 
-containerEl.addEventListener('pointerdown', pointerDown, false);
-win.addEventListener('pointerup', pointerUp, false);
-
-//event listners for terminating the presentation
-window.removePresentationEventHandlers = () => {
-  ea.onLinkClickHook = null;
-  containerEl.parentElement?.removeChild(containerEl);
-  if(!app.isMobile) win.removeEventListener('fullscreenchange', fullscreenListener);
-  doc.removeEventListener('keydown',keydownListener);
-  win.removeEventListener('pointerup',pointerUp);
-  contentEl.querySelector(".layer-ui__wrapper").removeClass("excalidraw-hidden");
-  delete window.removePresentationEventHandlers;
+const onMouseEnter = () => {
+	clearFadeTimeout();
 }
 
-const exitPresentation = () => {
-  window.removePresentationEventHandlers?.();
-  if(app.isMobile) ea.viewToggleFullScreen(true);
-  else ea.setViewModeEnabled(false);
-  ea.clear();
-  ea.copyViewElementsToEAforEditing(ea.getViewElements().filter(el=>el.id === lineEl.id));
-  ea.getElement(lineEl.id).strokeColor = originalColor.strokeColor;
-  ea.getElement(lineEl.id).backgroundColor = originalColor.backgroundColor;
-  ea.addElementsToView();  
-  ea.selectElementsInView(ea.getElements());
+const onMouseLeave = () => {
+	setFadeTimeout();
 }
 
-ea.onLinkClickHook = () => {
-  exitPresentation();
-  return true;
-};
-
 const fullscreenListener = (e) => {
+  if(preventFullscreenExit) {
+	  preventFullscreenExit = false;
+    return;
+  }
   e.preventDefault();
   exitPresentation();
 }
 
-if(!app.isMobile) {
-  win.addEventListener('fullscreenchange', fullscreenListener);
+const initializeEventListners = () => {
+	ownerWindow.addEventListener('keydown',keydownListener);
+  controlPanelEl.addEventListener('pointerdown', onPointerDown, false);
+  controlPanelEl.addEventListener('mouseenter', onMouseEnter, false);
+  controlPanelEl.addEventListener('mouseleave', onMouseLeave, false);
+  ownerWindow.addEventListener('pointerup', onPointerUp, false);
+
+	//event listners for terminating the presentation
+	window.removePresentationEventHandlers = () => {
+	  ea.onLinkClickHook = null;
+	  controlPanelEl.removeEventListener('pointerdown', onPointerDown, false);
+	  controlPanelEl.removeEventListener('mouseenter', onMouseEnter, false);
+	  controlPanelEl.removeEventListener('mouseleave', onMouseLeave, false);
+	  controlPanelEl.parentElement?.removeChild(controlPanelEl);
+	  if(!app.isMobile) {
+	    contentEl.removeEventListener('webkitfullscreenchange', fullscreenListener);
+	    contentEl.removeEventListener('fullscreenchange', fullscreenListener);
+	  }
+	  ownerWindow.removeEventListener('keydown',keydownListener);
+	  ownerWindow.removeEventListener('pointerup',onPointerUp);
+	  contentEl.querySelector(".layer-ui__wrapper")?.removeClass("excalidraw-hidden");
+	  delete window.removePresentationEventHandlers;
+	}
+
+	ea.onLinkClickHook = () => {
+    exitPresentation();
+    return true;
+  };
+  
+  if(!app.isMobile) {
+    contentEl.addEventListener('webkitfullscreenchange', fullscreenListener);
+    contentEl.addEventListener('fullscreenchange', fullscreenListener);
+  }
 }
 
-//navigate to the first slide on start
-setTimeout(()=>navigate("fwd"));
+//----------------------------
+// Exit presentation
+//----------------------------
+const exitPresentation = async (openForEdit = false) => {
+  //this is a hack, not sure why ea loses target view when other scripts are executed while the presentation is running
+  ea.targetView = hostView; 
+  isLaserOn = false;
+  statusBarElement.style.display = "inherit";
+  if(openForEdit) ea.targetView.preventAutozoom();
+  await exitFullscreen();
+  await waitForExcalidrawResize();
+  ea.setViewModeEnabled(false);
+  if(presentationPathType === "line") {
+	  ea.clear();
+	  ea.copyViewElementsToEAforEditing(ea.getViewElements().filter(el=>el.id === presentationPathLineEl.id));
+	  const el = ea.getElement(presentationPathLineEl.id);
+	  if(!isHidden) {
+	    el.strokeColor = originalProps.strokeColor;
+	    el.backgroundProps = originalProps.backgroundColor;
+	    el.locked = openForEdit ? false : originalProps.locked;
+	  }
+	  await ea.addElementsToView();
+	  if(!isHidden) ea.selectElementsInView([el]);
+	  if(openForEdit) {
+	    let nextRect = getNextSlideRect(--slide);
+	    const offsetW = (nextRect.right-nextRect.left)*(1-EDIT_ZOOMOUT)/2;
+	    const offsetH = (nextRect.bottom-nextRect.top)*(1-EDIT_ZOOMOUT)/2
+	    nextRect = {
+	      left: nextRect.left-offsetW,
+	      right: nextRect.right+offsetW,
+	      top: nextRect.top-offsetH,
+	      bottom: nextRect.bottom+offsetH,
+	      nextZoom: nextRect.nextZoom*EDIT_ZOOMOUT > 0.1 ? nextRect.nextZoom*EDIT_ZOOMOUT : 0.1 //0.1 is the minimu zoom value
+	    };
+	    await scrollToNextRect(nextRect,1);
+	    excalidrawAPI.startLineEditor(
+	      ea.getViewSelectedElement(),
+	      [slide*2,slide*2+1]
+	    );
+	  }
+	} else {
+	  if(frameRenderingOriginalState.enabled) {
+	  	excalidrawAPI.updateScene({
+		    appState: {
+		      frameRendering: {
+		        ...frameRenderingOriginalState,
+		        enabled: true
+		      }
+		    }
+		  });
+		}
+	}
+  window.removePresentationEventHandlers?.();
+  ownerWindow.setTimeout(()=>{
+    //Resets pointer offsets. Ugly solution. 
+    //During testing offsets were wrong after presentation, but don't know why.
+    //This should solve it even if they are wrong.
+    hostView.refresh();
+    excalidrawAPI.setActiveTool({type: "selection"});
+  })
+}
+
+//--------------------------
+// Start presentation or open presentation settings on double click
+//--------------------------
+const start = async () => {
+  statusBarElement.style.display = "none";
+  ea.setViewModeEnabled(true);
+  createPresentationNavigationPanel();
+  initializeEventListners();
+  if(startFullscreen) {
+    await gotoFullscreen();
+  } else {
+    resetControlPanelElPosition();
+  }
+  if(presentationPathType === "line") await toggleArrowVisibility(isHidden);
+}
+
+const timestamp = Date.now();
+if(window.ExcalidrawSlideshow && (window.ExcalidrawSlideshow.script === utils.scriptFile.path) && (timestamp - window.ExcalidrawSlideshow.timestamp <400) ) {
+  if(window.ExcalidrawSlideshowStartTimer) {
+    window.clearTimeout(window.ExcalidrawSlideshowStartTimer);
+    delete window.ExcalidrawSlideshowStartTimer;
+  }
+  await start();
+} else {
+  if(window.ExcalidrawSlideshowStartTimer) {
+    window.clearTimeout(window.ExcalidrawSlideshowStartTimer);
+    delete window.ExcalidrawSlideshowStartTimer;
+  }
+  window.ExcalidrawSlideshow = {
+    script: utils.scriptFile.path,
+    timestamp
+  };
+  window.ExcalidrawSlideshowStartTimer = window.setTimeout(start,500);
+}

ea-scripts/Split Ellipse.md

@@ -0,0 +1,208 @@
+/*
+
+This script splits an ellipse at any point where a line intersects it. If no lines are selected, it will use every line that intersects the ellipse. Otherwise, it will only use the selected lines. If there is no intersecting line, the ellipse will be converted into a line object. 
+There is also the option to close the object along the cut, which will close the cut in the shape of the line.
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-splitEllipse-demo1.jpg)
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-splitEllipse-demo2.jpg)
+Tip: To use an ellipse as the cutting object, you first have to use this script on it, since it will convert the ellipse into a line.
+
+
+See documentation for more details:
+https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html
+
+```javascript
+*/
+const elements = ea.getViewSelectedElements();
+const ellipse = elements.filter(el => el.type == "ellipse")[0];
+if (!ellipse) return;
+
+let lines = elements.filter(el => el.type == "line" || el.type == "arrow");
+if (lines.length == 0) lines = ea.getViewElements().filter(el => el.type == "line" || el.type == "arrow");
+const subLines = getSubLines(lines);
+
+const angles = subLines.flatMap(line => {
+  return intersectionAngleOfEllipseAndLine(ellipse, line.a, line.b).map(result => ({
+    angle: result,
+    cuttingLine: line
+  }));
+});
+
+if (angles.length === 0) angles.push({ angle: 0, cuttingLine: null });
+
+angles.sort((a, b) => a.angle - b.angle);
+
+const closeObject = await utils.suggester(["Yes", "No"], [true, false], "Close object along cutedge?")
+
+ea.style.strokeSharpness = closeObject ? "sharp" : "round";
+ea.style.strokeColor = ellipse.strokeColor;
+ea.style.strokeWidth = ellipse.strokeWidth;
+ea.style.backgroundColor = ellipse.backgroundColor;
+ea.style.fillStyle = ellipse.fillStyle;
+ea.style.roughness = ellipse.roughness;
+
+angles.forEach((angle, key) => {
+  const cuttingLine = angle.cuttingLine;
+  angle = angle.angle;
+  const nextAngleKey = (key + 1) < angles.length ? key + 1 : 0;
+  const nextAngle = angles[nextAngleKey].angle;
+  const AngleDelta = nextAngle - angle ? nextAngle - angle : Math.PI*2;
+  const pointAmount = Math.ceil((AngleDelta*64)/(Math.PI*2));
+  const stepSize = AngleDelta/pointAmount;
+  let points = drawEllipse(ellipse.x, ellipse.y, ellipse.width, ellipse.height, ellipse.angle, angle, nextAngle, stepSize);
+  if (closeObject && cuttingLine) points = points.concat(getCutLine(points[0], angles[key], angles[nextAngleKey], ellipse));
+
+  const lineId = ea.addLine(points);
+  const line = ea.getElement(lineId);
+  line.frameId = ellipse.frameId;
+  line.groupIds = ellipse.groupIds;
+});
+
+ea.deleteViewElements([ellipse]);
+ea.addElementsToView(false,false,true);
+return;
+
+function getSubLines(lines) {
+  return lines.flatMap((line, key) => {
+    return line.points.slice(1).map((pointB, i) => ({
+      a: addVectors([line.points[i], [line.x, line.y]]),
+      b: addVectors([pointB, [line.x, line.y]]),
+      originLineIndex: key,
+      indexPointA: i,
+    }));
+  });
+}
+
+function intersectionAngleOfEllipseAndLine(ellipse, pointA, pointB) {
+  /*
+  To understand the code in this function and subfunctions it might help to take a look at this geogebra file
+  https://www.geogebra.org/m/apbm3hs6
+  */
+  const c = multiplyVectorByScalar([ellipse.width, ellipse.height], (1/2));
+  const a = rotateVector(
+    addVectors([
+      pointA,
+      invVec([ellipse.x, ellipse.y]),
+      invVec(multiplyVectorByScalar([ellipse.width, ellipse.height], (1/2)))
+    ]),
+    -ellipse.angle
+  )
+  const l_b = rotateVector(
+    addVectors([
+      pointB,
+      invVec([ellipse.x, ellipse.y]),
+      invVec(multiplyVectorByScalar([ellipse.width, ellipse.height], (1/2)))
+    ]),
+    -ellipse.angle
+  );
+  const b = addVectors([
+    l_b,
+    invVec(a)
+  ]);
+  const solutions = calculateLineSegment(a[0], a[1], b[0], b[1], c[0], c[1]);
+  return solutions
+    .filter(num => isBetween(num, 0, 1))
+    .map(num => {
+      const point = [
+        (a[0] + b[0] * num) / ellipse.width,
+        (a[1] + b[1] * num) / ellipse.height
+      ];
+      return angleBetweenVectors([1, 0], point);
+    });
+}
+
+function drawEllipse(x, y, width, height, angle = 0, start = 0, end = Math.PI*2, step = Math.PI/32) {
+  const ellipse = (t) => {
+    const spanningVector = rotateVector([width/2*Math.cos(t), height/2*Math.sin(t)], angle);
+    const baseVector = [x+width/2, y+height/2];
+    return addVectors([baseVector, spanningVector]);
+  }
+
+  if(end <= start) end = end + Math.PI*2;
+
+  let points = [];
+  const almostEnd = end - step/2;
+  for (let t = start; t < almostEnd; t = t + step) {
+    points.push(ellipse(t));
+  }
+  points.push(ellipse(end))
+  return points;
+}
+
+function getCutLine(startpoint, currentAngle, nextAngle, ellipse) {
+  if (currentAngle.cuttingLine.originLineIndex != nextAngle.cuttingLine.originLineIndex) return [];
+  
+  const originLineIndex = currentAngle.cuttingLine.originLineIndex;
+  
+  if (lines[originLineIndex] == 2) return startpoint;
+  
+  const originLine = [];
+  lines[originLineIndex].points.forEach(p => originLine.push(addVectors([
+    p,
+    [lines[originLineIndex].x, lines[originLineIndex].y]
+  ])));
+
+  const edgepoints = [];
+  const direction = isInEllipse(originLine[clamp(nextAngle.cuttingLine.indexPointA - 1, 0, originLine.length - 1)], ellipse) ? -1 : 1
+  let i = isInEllipse(originLine[nextAngle.cuttingLine.indexPointA], ellipse) ? nextAngle.cuttingLine.indexPointA : nextAngle.cuttingLine.indexPointA + direction;
+  while (isInEllipse(originLine[i], ellipse)) {
+    edgepoints.push(originLine[i]);
+    i = (i + direction) % originLine.length;
+  }
+  edgepoints.push(startpoint);
+  return edgepoints;
+}
+
+function calculateLineSegment(ax, ay, bx, by, cx, cy) {
+  const sqrt = Math.sqrt((cx ** 2) * (cy ** 2) * (-(ay ** 2) * (bx ** 2) + 2 * ax * ay * bx * by - (ax ** 2) * (by ** 2) + (bx ** 2) * (cy ** 2) + (by ** 2) * (cx ** 2)));
+  const numerator = -(ay * by * (cx ** 2) + ax * bx * (cy ** 2));
+  const denominator = ((by ** 2) * (cx ** 2) + (bx ** 2) * (cy ** 2));
+  const t1 = (numerator + sqrt) / denominator;
+  const t2 = (numerator - sqrt) / denominator;
+
+  return [t1, t2];
+}
+
+function isInEllipse(point, ellipse) {
+  point = addVectors([point, invVec([ellipse.x, ellipse.y]), invVec(multiplyVectorByScalar([ellipse.width, ellipse.height], 1/2))]);
+  point = [point[0]*2/ellipse.width, point[1]*2/ellipse.height];
+  const distance = Math.sqrt(point[0]**2 + point[1]**2);
+  return distance < 1;
+}
+
+function angleBetweenVectors(v1, v2) {
+  let dotProduct = v1[0] * v2[0] + v1[1] * v2[1];
+  let determinant = v1[0] * v2[1] - v1[1] * v2[0];
+  let angle = Math.atan2(determinant, dotProduct);
+  return angle < 0 ? angle + 2 * Math.PI : angle;
+}
+
+function rotateVector (vec, ang)  {
+  var cos = Math.cos(ang);
+  var sin = Math.sin(ang);
+  return [vec[0] * cos - vec[1] * sin, vec[0] * sin + vec[1] * cos];
+}
+
+function addVectors(vectors) {
+  return vectors.reduce((acc, vec) => [acc[0] + vec[0], acc[1] + vec[1]], [0, 0]);
+}
+
+function invVec(vector) {
+  return [-vector[0], -vector[1]];
+}
+
+function multiplyVectorByScalar(vector, scalar) {
+  return [vector[0] * scalar, vector[1] * scalar];
+}
+
+function round(number, precision) {
+  var factor = Math.pow(10, precision);
+  return Math.round(number * factor) / factor;
+}
+
+function isBetween(num, min, max) {
+  return (num >= min && num <= max);
+}
+
+function clamp(number, min, max) {
+  return Math.max(min, Math.min(number, max));
+}

ea-scripts/Text Aura.md

@@ -0,0 +1,70 @@
+/* 
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-aura.jpg)
+Select a single text element, or a text element in a container. The container must have a transparent background.
+The script will add an aura to the text by adding 4 copies of the text each with the inverted stroke color of the original text element and with a very small X and Y offset. The resulting 4 + 1 (original) text elements or containers will be grouped.
+
+If you copy a color string on the clipboard before running the script, the script will use that color instead of the inverted color.
+
+```js*/
+els = ea.getViewSelectedElements();
+const isText = (els.length === 1) && els[0].type === "text";
+const isContainer = (els.length === 2) &&
+  ((els[0].type === "text" && els[1].id === els[0].containerId && els[1].backgroundColor.toLowerCase() === "transparent") ||
+    (els[1].type === "text" && els[0].id === els[1].containerId && els[0].backgroundColor.toLowerCase() === "transparent"));
+
+if (!(isText || isContainer)) {
+  new Notice ("Select a single text element, or a container with a text element and with transparent background color",10000);
+  return;
+}
+
+let strokeColor = ea
+  .getCM(els.filter(el=>el.type === "text")[0].strokeColor)
+  .invert({alpha: false})
+  .stringHEX({alpha: false});
+clipboardText = await navigator.clipboard.readText();
+if(clipboardText) {
+  const cm1 = ea.getCM(clipboardText);
+  if(cm1.format !== "invalid") {
+	strokeColor = cm1.stringHEX();
+  } else {
+    const cm2 = ea.getCM("#"+clipboardText);
+    if(cm2.format !== "invalid") {
+      strokeColor = cm2.stringHEX();
+    }
+  }
+}
+
+const offset = els.filter(el=>el.type === "text")[0].fontSize/24;
+
+let ids = [];
+
+const addClone = (offsetX, offsetY) => {
+  els.forEach(el=>{
+    const clone = ea.cloneElement(el);
+    ids.push(clone.id);
+    clone.x += offsetX;
+	clone.y += offsetY;
+	if(offsetX!==0 || offsetY!==0) {
+	  switch (clone.type) {
+	    case "text":
+		  clone.strokeColor = strokeColor; 
+		  break;
+	    default:
+		  clone.strokeColor = "transparent";
+		  break;
+	  }
+	}
+    ea.elementsDict[clone.id] = clone;
+  })
+}
+
+addClone(-offset,0);
+addClone(offset,0);
+addClone(0,offset);
+addClone(0,-offset);
+addClone(0,0);
+ea.copyViewElementsToEAforEditing(els);
+els.forEach(el=>ea.elementsDict[el.id].isDeleted = true);
+
+ea.addToGroup(ids);
+ea.addElementsToView(false, true, true);

ea-scripts/Text Aura.svg

@@ -0,0 +1,17 @@
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="120" height="120">
+  <!-- svg-source:excalidraw -->
+  
+  <defs>
+    <style class="style-fonts">
+      @font-face {
+        font-family: "Virgil";
+        src: url("https://excalidraw.com/Virgil.woff2");
+      }
+      @font-face {
+        font-family: "Cascadia";
+        src: url("https://excalidraw.com/Cascadia.woff2");
+      }
+    </style>
+    
+  </defs>
+  <g stroke-linecap="round"><g transform="translate(0 0) rotate(0 60 60)" fill-rule="evenodd"><path d="M0 0 L120 0 L120 40 L80 40 L80 120 L40 120 L40 40 L0 40 L0 0" stroke="none" stroke-width="0" fill="red" fill-rule="evenodd"></path><path d="M0 0 C41.51 0, 83.02 0, 120 0 M0 0 C30.58 0, 61.16 0, 120 0 M120 0 C120 12.11, 120 24.22, 120 40 M120 0 C120 13.92, 120 27.84, 120 40 M120 40 C108.75 40, 97.49 40, 80 40 M120 40 C107.65 40, 95.29 40, 80 40 M80 40 C80 66.51, 80 93.01, 80 120 M80 40 C80 70.33, 80 100.66, 80 120 M80 120 C66.08 120, 52.16 120, 40 120 M80 120 C70.07 120, 60.13 120, 40 120 M40 120 C40 89.21, 40 58.42, 40 40 M40 120 C40 92.66, 40 65.33, 40 40 M40 40 C25.35 40, 10.71 40, 0 40 M40 40 C27.7 40, 15.4 40, 0 40 M0 40 C0 24.03, 0 8.05, 0 0 M0 40 C0 27.82, 0 15.65, 0 0 M0 0 C0 0, 0 0, 0 0 M0 0 C0 0, 0 0, 0 0" stroke="transparent" stroke-width="0.5" fill="none"></path></g></g><mask></mask><g stroke-linecap="round"><g transform="translate(110 10) rotate(0 -50 50)" fill-rule="evenodd"><path d="M0 0 L-100 0 L-100 20 L-60 20 L-60 100 L-40 100 L-40 20 L0 20 L0 0" stroke="none" stroke-width="0" fill="currentColor" fill-rule="evenodd"></path><path d="M0 0 C-23.27 0, -46.54 0, -100 0 M0 0 C-23.31 0, -46.62 0, -100 0 M-100 0 C-100 6.13, -100 12.26, -100 20 M-100 0 C-100 5.84, -100 11.69, -100 20 M-100 20 C-87.37 20, -74.74 20, -60 20 M-100 20 C-88.34 20, -76.68 20, -60 20 M-60 20 C-60 37.78, -60 55.56, -60 100 M-60 20 C-60 39.34, -60 58.68, -60 100 M-60 100 C-52.58 100, -45.17 100, -40 100 M-60 100 C-54.72 100, -49.43 100, -40 100 M-40 100 C-40 83.83, -40 67.67, -40 20 M-40 100 C-40 77.76, -40 55.51, -40 20 M-40 20 C-25.4 20, -10.8 20, 0 20 M-40 20 C-28.47 20, -16.93 20, 0 20 M0 20 C0 15.42, 0 10.84, 0 0 M0 20 C0 14.54, 0 9.08, 0 0 M0 0 C0 0, 0 0, 0 0 M0 0 C0 0, 0 0, 0 0" stroke="currentColor" stroke-width="0.5" fill="none"></path></g></g><mask></mask></svg>

ea-scripts/Text to Sticky Notes.md

@@ -0,0 +1,126 @@
+/*
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-sticky-note-matrix.jpg)
+
+Converts selected plain text element to sticky notes by dividing the text element line by line into separate sticky notes. The color of the stikcy note as well as the arrangement of the grid can be configured in plugin settings.
+
+```javascript
+*/
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.5.21")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+let settings = ea.getScriptSettings();
+//set default values on first run
+if(!settings["Border color"]) {
+	settings = {
+	  "Border color" : {
+			value: "black",
+      description: "Any legal HTML color (#000000, rgb, color-name, etc.). Set to 'transparent' for transparent color."
+		},
+		"Background color" : {
+			value: "gold",
+      description: "Background color of the sticky note. Set to 'transparent' for transparent color."
+		},
+		"Background fill style" : {
+			value: "solid",
+      description: "Fill style of the sticky note",
+		  valueset: ["hachure","cross-hatch","solid"]
+		}
+	};
+	await ea.setScriptSettings(settings);
+}
+
+if(!settings["Max sticky note width"]) {
+  settings["Max sticky note width"] = {
+    value: "600",
+    description: "Maximum width of new sticky note. If text is longer, it will be wrapped",
+	  valueset: ["400","600","800","1000","1200","1400","2000"]
+  }
+  await ea.setScriptSettings(settings);
+}
+
+if(!settings["Sticky note width"]) {
+  settings["Sticky note width"] = {
+    value: "100",
+    description: "Preferred width of the sticky note. Set to 0 if unset.",
+  }
+  settings["Sticky note height"] = {
+    value: "120",
+    description: "Preferred height of the sticky note. Set to 0 if unset.",
+  }
+  settings["Rows per column"] = {
+    value: "3",
+    description: "If multiple text elements are converted to sticky notes in one step, how many rows before a next column is created. Only effective if fixed width & height are given. 0 for unset.",
+  }
+  settings["Gap"] = {
+    value: "10",
+    description: "Gap between rows and columns",
+  }
+  await ea.setScriptSettings(settings);
+}
+
+const pref_width = parseInt(settings["Sticky note width"].value);
+const pref_height = parseInt(settings["Sticky note height"].value);
+const pref_rows = parseInt(settings["Rows per column"].value);
+const pref_gap = parseInt(settings["Gap"].value);
+
+const maxWidth = parseInt(settings["Max sticky note width"].value);
+const strokeColor = settings["Border color"].value;
+const backgroundColor = settings["Background color"].value;
+const fillStyle = settings["Background fill style"].value;
+
+elements = ea.getViewSelectedElements().filter((el)=>el.type==="text");
+elements.forEach((el)=>{
+  ea.style.strokeColor = el.strokeColor;
+  ea.style.fontFamily  = el.fontFamily;
+  ea.style.fontSize    = el.fontSize;
+  const text = el.text.split("\n");
+  for(i=0;i<text.length;i++) {
+	  ea.addText(el.x,el.y+i*el.height/text.length,text[i].trim());
+  }
+});
+ea.deleteViewElements(elements);
+
+ea.style.strokeColor = strokeColor;
+ea.style.backgroundColor = backgroundColor;
+ea.style.fillStyle = fillStyle;
+const padding = 6;
+const boxes = [];
+
+const doMatrix = pref_width > 0 && pref_height > 0 && pref_rows > 0 && pref_gap > 0;
+let row = 0;
+let col = doMatrix ? -1 : 0;
+
+ea.getElements().forEach((el, idx)=>{
+  if(doMatrix) {
+		if(idx % pref_rows === 0) {
+			row=0;
+			col++;
+		} else {
+			row++;
+		}
+	}
+  const width = pref_width > 0 ? pref_width : el.width+2*padding;
+  const widthOK = pref_width > 0 || width<=maxWidth;
+  const id = ea.addRect(
+    (doMatrix?col*pref_width+col*pref_gap:0)+el.x-padding,
+    (doMatrix?row*pref_height+row*pref_gap:0),
+    widthOK?width:maxWidth,pref_height > 0 ? pref_height : el.height+2*padding
+  );
+  boxes.push(id);
+  ea.getElement(id).boundElements=[{type:"text",id:el.id}];
+  el.containerId = id;
+});
+
+const els = Object.entries(ea.elementsDict);
+let newEls = [];
+for(i=0;i<els.length/2;i++) {
+	newEls.push(els[els.length/2+i]);
+	newEls.push(els[i])
+}
+ea.elementsDict = Object.fromEntries(newEls);
+
+await ea.addElementsToView(false,true);
+const containers = ea.getViewElements().filter(el=>boxes.includes(el.id));
+ea.getExcalidrawAPI().updateContainerSize(containers);
+ea.selectElementsInView(containers);

ea-scripts/Text to Sticky Notes.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle stroke-width="2" cx="12" cy="5" r="1"></circle><circle stroke-width="2" cx="19" cy="5" r="1"></circle><circle stroke-width="2" cx="5" cy="5" r="1"></circle><circle stroke-width="2" cx="12" cy="12" r="1"></circle><circle stroke-width="2" cx="19" cy="12" r="1"></circle><circle stroke-width="2" cx="5" cy="12" r="1"></circle><circle stroke-width="2" cx="12" cy="19" r="1"></circle><circle stroke-width="2" cx="19" cy="19" r="1"></circle><circle stroke-width="2" cx="5" cy="19" r="1"></circle></svg>

ea-scripts/Toggle Grid.md

@@ -0,0 +1,33 @@
+/*
+Toggles the grid on and off. Especially useful when drawing with just a pen without a mouse or keyboard, as toggling the grid by left-clicking with the pen is sometimes quite tedious.
+
+See documentation for more details:
+https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html
+
+```javascript
+*/
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.8.11")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+const api = ea.getExcalidrawAPI();
+let {gridSize, previousGridSize} = api.getAppState();
+
+if (!previousGridSize) {
+  previousGridSize = 20
+}
+if (!gridSize) {
+  gridSize = previousGridSize;
+}
+else
+{
+  previousGridSize = gridSize;
+  gridSize = null;
+}
+ea.viewUpdateScene({
+  appState:{
+    gridSize,
+    previousGridSize
+  },
+  commitToHistory:false
+});

ea-scripts/Toggle Grid.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 567 489">
+   <path
+       d="M 20.803582,0.35478208 A 25,25 0 0 0 5.9442069,8.8176728 25,25 0 0 0 8.8172543,44.055954 L 31.254754,63.108689 c -0.121266,0.849954 -0.301322,1.680716 -0.388672,2.541015 -0.218469,2.151668 -0.330078,4.335551 -0.330078,6.544922 V 392.19462 c 0,2.20625 0.111609,4.38587 0.330078,6.53516 0.218468,2.14929 0.544482,4.26807 0.970703,6.34961 0.426219,2.08154 0.952918,4.12591 1.576172,6.12891 0.623252,2.00299 1.342775,3.96328 2.152343,5.87695 0.80957,1.91367 1.708193,3.7802 2.69336,5.59375 0.985166,1.81355 2.056984,3.57472 3.207031,5.27734 1.150047,1.70264 2.379385,3.34681 3.683594,4.92774 1.304208,1.58093 2.683206,3.09844 4.130859,4.54687 1.447654,1.44844 2.964542,2.82767 4.544922,4.13282 1.58038,1.30514 3.223392,2.53642 4.925781,3.6875 1.70239,1.15106 3.463664,2.22277 5.277344,3.20898 1.81368,0.98621 3.679496,1.88672 5.59375,2.69727 1.914254,0.81053 3.87675,1.5302 5.880859,2.15429 2.00411,0.6241 4.049565,1.15323 6.132813,1.58008 2.083248,0.42686 4.203801,0.75188 6.355469,0.9707 2.151667,0.21883 4.335552,0.33204 6.544922,0.33203 H 478.53601 c 2.20625,0 4.38587,-0.1132 6.53515,-0.33203 2.14929,-0.21882 4.26808,-0.54384 6.34961,-0.9707 0.30707,-0.063 0.59887,-0.16503 0.9043,-0.23242 l 33.48047,28.43164 a 25,25 0 0 0 35.23828,-2.87305 25,25 0 0 0 -2.87305,-35.23828 L 41.182488,5.9446259 A 25,25 0 0 0 29.485222,0.40556338 25,25 0 0 0 20.803582,0.35478208 Z M 94.536004,8.1946259 c -2.209366,0 -4.39326,0.1116097 -6.544922,0.3300781 -2.151664,0.2184684 -4.272226,0.5425319 -6.355469,0.9687499 -2.083244,0.42622 -4.128707,0.9548741 -6.132813,1.5781251 -2.004105,0.623253 -3.966609,1.340824 -5.880859,2.150391 -0.337447,0.142712 -0.651869,0.326303 -0.986328,0.474609 l 68.884767,58.498047 h 93.49024 23.52539 v 19.978516 79.392578 l 109.07422,92.6289 h 93.49218 21.4336 v 18.20313 79.39258 l 60.42383,51.31445 c 0.22119,-0.63745 0.49391,-1.25011 0.69531,-1.89648 0.62409,-2.00299 1.15127,-4.04738 1.57812,-6.12891 0.42686,-2.08153 0.75188,-4.20033 0.97071,-6.34961 0.21882,-2.14928 0.33203,-4.32892 0.33203,-6.53516 V 336.74736 271.15166 72.194626 c 0,-2.209349 -0.11321,-4.393275 -0.33203,-6.544922 -0.21882,-2.151647 -0.54386,-4.272242 -0.97071,-6.355469 -0.42685,-2.083227 -0.95403,-4.128722 -1.57812,-6.132812 -0.62409,-2.00409 -1.34376,-3.966624 -2.1543,-5.88086 -0.81054,-1.914234 -1.71302,-3.780086 -2.69922,-5.59375 -0.98619,-1.813662 -2.05792,-3.574971 -3.20898,-5.277343 -1.15106,-1.702373 -2.38041,-3.34737 -3.68555,-4.927735 -1.30514,-1.580364 -2.68439,-3.097282 -4.13281,-4.544922 -1.44842,-1.447638 -2.96596,-2.82471 -4.54688,-4.128906 -1.5809,-1.304195 -3.22708,-2.535511 -4.92968,-3.685547 -1.70262,-1.150034 -3.46187,-2.219921 -5.27539,-3.205078 -1.81353,-0.985156 -3.68011,-1.885752 -5.59375,-2.695312 -1.91366,-0.809561 -3.87593,-1.527143 -5.87891,-2.150391 -2.00298,-0.623246 -4.04739,-1.1519091 -6.12891,-1.5781251 -2.08151,-0.426215 -4.20034,-0.7502832 -6.34961,-0.9687499 -2.14925,-0.2184666 -4.32893,-0.3300781 -6.53515,-0.3300781 H 232.88952 155.64538 Z M 318.53601,72.194626 h 160 V 200.19462 H 458.97937 381.73718 318.53601 V 146.52275 80.927048 Z M 94.536004,116.84892 192.67859,200.19462 H 94.536004 Z m 0,147.3457 H 254.53601 v 128 H 94.536004 Z m 224.000006,42.87891 100.23437,85.12109 H 318.53601 Z" />
+</svg>

ea-scripts/index-new.md

@@ -25,26 +25,16 @@ I would love to include your contribution in the script library. If you have a s
 ---
 
 # List of available scripts
+
+## Layout and Organization
+**Keywords**: Design, Placement, Arrangement, Structure, Formatting, Alignment
+
 |    |     |
 |----|-----|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Add%20Connector%20Point.svg"></div>|[[#Add Connector Point]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Add%20Link%20to%20Existing%20File%20and%20Open.svg"/></div>|[[#Add Link to Existing File and Open]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Add%20Link%20to%20New%20Page%20and%20Open.svg"/></div>|[[#Add Link to New Page and Open]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Add%20Next%20Step%20in%20Process.svg"/></div>|[[#Add Next Step in Process]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Alternative%20Pens.svg"/></div>|[[#Alternative Pens]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Auto%20Layout.svg"/></div>|[[#Auto Layout]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Box%20Each%20Selected%20Groups.svg"/></div>|[[#Box Each Selected Groups]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Box%20Selected%20Elements.svg"/></div>|[[#Box Selected Elements]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Change%20shape%20of%20selected%20elements.svg"/></div>|[[#Change shape of selected elements]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Connect%20elements.svg"/></div>|[[#Connect elements]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Convert%20freedraw%20to%20line.svg"/></div>|[[#Convert freedraw to line]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Convert%20selected%20text%20elements%20to%20sticky%20notes.svg"/></div>|[[#Convert selected text elements to sticky notes]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Convert%20text%20to%20link%20with%20folder%20and%20alias.svg"/></div>|[[#Convert text to link with folder and alias]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Copy%20Selected%20Element%20Styles%20to%20Global.svg"/></div>|[[#Copy Selected Element Styles to Global]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Create%20new%20markdown%20file%20and%20embed%20into%20active%20drawing.svg"/></div>|[[#Create new markdown file and embed into active drawing]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Darken%20background%20color.svg"/></div>|[[#Darken background color]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Deconstruct%20selected%20elements%20into%20new%20drawing.svg"/></div>|[[#Deconstruct selected elements into new drawing]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Elbow%20connectors.svg"/></div>|[[#Elbow connectors]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Ellipse%20Selected%20Elements.svg"/></div>|[[#Ellipse Selected Elements]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Expand%20rectangles%20horizontally%20keep%20text%20centered.svg"/></div>|[[#Expand rectangles horizontally keep text centered]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Expand%20rectangles%20horizontally.svg"/></div>|[[#Expand rectangles horizontally]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Expand%20rectangles%20vertically%20keep%20text%20centered.svg"/></div>|[[#Expand rectangles vertically keep text centered]]|
@@ -55,30 +45,105 @@ 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/Grid%20Selected%20Images.svg"/></div>|[[#Grid selected images]]|
-|<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/Mindmap%20format.svg"/></div>|[[#Mindmap format]]|
-|<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/Zoom%20to%20Fit%20Selected%20Elements.svg"/></div>|[[#Zoom to Fit Selected Elements]]|
+
+## Connectors and Arrows
+**Keywords**: Links, Relations, Paths, Direction, Flow, Connections
+
+|    |     |
+|----|-----|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Add%20Connector%20Point.svg"></div>|[[#Add Connector Point]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Concatenate%20lines.svg"></div>|[[#Concatenate lines]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Connect%20elements.svg"/></div>|[[#Connect elements]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Elbow%20connectors.svg"/></div>|[[#Elbow connectors]]|
+|<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/Normalize%20Selected%20Arrows.svg"/></div>|[[#Normalize Selected Arrows]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Organic%20Line.svg"/></div>|[[#Organic Line]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Palette%20loader.svg"/></div>|[[#Palette Loader]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Rename%20Image.svg"/></div>|[[#Rename Image]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Repeat%20Elements.svg"/></div>|[[#Repeat Elements]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Reverse%20arrows.svg"/></div>|[[#Reverse arrows]]|
+
+## Text Manipulation
+**Keywords**: Editing, Font Control, Wording, Typography, Annotation, Modification
+
+|    |     |
+|----|-----|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Convert%20selected%20text%20elements%20to%20sticky%20notes.svg"/></div>|[[#Convert selected text elements to sticky notes]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Scribble%20Helper.svg"/></div>|[[#Scribble Helper]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Select%20Elements%20of%20Type.svg"/></div>|[[#Select Elements of Type]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20background%20color%20of%20unclosed%20line%20object%20by%20adding%20a%20shadow%20clone.svg"/></div>|[[#Set background color of unclosed line object by adding a shadow clone]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Dimensions.svg"/></div>|[[#Set Dimensions]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Font%20Family.svg"/></div>|[[#Set Font Family]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Grid.svg"/></div>|[[#Set Grid]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Link%20Alias.svg"/></div>|[[#Set Link Alias]]|
-|<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/Slideshow.svg"/></div>|[[#Slideshow]]|
 |<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/Text%20Arch.svg"/></div>|[[#Text Arch]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Text%20Aura.svg"/></div>|[[#Text Aura]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Text%20to%20Sticky%20Notes.svg"/></div>|[[#Text to Sticky Notes]]|
+
+## Styling and Appearance
+**Keywords**: Design, Look, Visuals, Graphics, Aesthetics, Presentation
+
+|    |     |
+|----|-----|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Change%20shape%20of%20selected%20elements.svg"/></div>|[[#Change shape of selected elements]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Darken%20background%20color.svg"/></div>|[[#Darken background color]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Invert%20colors.svg"/></div>|[[#Invert colors]]|
+|<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/Modify%20background%20color%20opacity.svg"/></div>|[[#Modify background color opacity]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Organic%20Line.svg"/></div>|[[#Organic Line]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Organic%20Line%20Legacy.svg"/></div>|[[#Organic Line Legacy]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20background%20color%20of%20unclosed%20line%20object%20by%20adding%20a%20shadow%20clone.svg"/></div>|[[#Set background color of unclosed line object by adding a shadow clone]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Dimensions.svg"/></div>|[[#Set Dimensions]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Grid.svg"/></div>|[[#Set Grid]]|
+|<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/Toggle%20Grid.svg"/></div>|[[#Toggle Grid]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Uniform%20size.svg"/></div>|[[#Uniform Size]]|
-|<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]]|
+
+## Linking and Embedding
+**Keywords**: Attach, Incorporate, Integrate, Associate, Insert, Reference
+
+|    |     |
+|----|-----|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Add%20Link%20to%20Existing%20File%20and%20Open.svg"/></div>|[[#Add Link to Existing File and Open]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Add%20Link%20to%20New%20Page%20and%20Open.svg"/></div>|[[#Add Link to New Page and Open]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Convert%20text%20to%20link%20with%20folder%20and%20alias.svg"/></div>|[[#Convert text to link with folder and alias]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Create%20DrawIO%20file.svg"/></div>|[[#Create DrawIO file]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Create%20new%20markdown%20file%20and%20embed%20into%20active%20drawing.svg"/></div>|[[#Create new markdown file and embed into active drawing]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Folder%20Note%20Core%20-%20Make%20Current%20Drawing%20a%20Folder.svg"/></div>|[[#Folder Note Core - Make Current Drawing a Folder]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Link%20Alias.svg"/></div>|[[#Set Link Alias]]|
+
+## Utilities and Tools
+**Keywords**: Functionalities, Instruments, Helpers, Aids, Features, Enhancements
+
+|    |     |
+|----|-----|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Auto%20Draw%20for%20Pen.svg"/></div>|[[#Auto Draw for Pen]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Boolean%20Operations.svg"/></div>|[[#Boolean Operations]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Copy%20Selected%20Element%20Styles%20to%20Global.svg"/></div>|[[#Copy Selected Element Styles to Global]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Hardware%20Eraser%20Support.svg"/></div>|[[#Hardware Eraser Support]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Palette%20loader.svg"/></div>|[[#Palette Loader]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/PDF%20Page%20Text%20to%20Clipboard.svg"/></div>|[[#PDF Page Text to Clipboard]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Rename%20Image.svg"/></div>|[[#Rename Image]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Repeat%20Elements.svg"/></div>|[[#Repeat Elements]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Select%20Elements%20of%20Type.svg"/></div>|[[#Select Elements of Type]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Select%20Similar%20Elements.svg"/></div>|[[#Select Similar Elements]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Slideshow.svg"/></div>|[[#Slideshow]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Split%20Ellipse.svg"/></div>|[[#Split Ellipse]]|
+
+## Collaboration and Export
+**Keywords**: Sharing, Teamwork, Exporting, Distribution, Cooperative, Publish
+
+|    |     |
+|----|-----|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Excalidraw%20Collaboration%20Frame.svg"/></div>|[[#Excalidraw Collaboration Frame]]|
+
+## Conversation and Creation
+**Keywords**: Transform, Generate, Craft, Produce, Change, Originate
+
+|    |     |
+|----|-----|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Add%20Next%20Step%20in%20Process.svg"/></div>|[[#Add Next Step in Process]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Convert%20freedraw%20to%20line.svg"/></div>|[[#Convert freedraw to line]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Deconstruct%20selected%20elements%20into%20new%20drawing.svg"/></div>|[[#Deconstruct selected elements into new drawing]]|
+
+---
+
+# Description and Installation
 
 ## Add Connector Point
 ```excalidraw-script-install
@@ -104,12 +169,11 @@ 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/Add%20Next%20Step%20in%20Process.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will prompt you for the title of the process step, then will create a stick note with the text. If an element is selected then the script will connect this new step with an arrow to the previous step (the selected element). If no element is selected, then the script assumes this is the first step in the process and will only output the sticky note with the text that was entered.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-add-process-step.jpg'></td></tr></table>
 
-## Alternative Pens
+## Auto Draw for Pen
 ```excalidraw-script-install
-https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Alternative%20Pens.md
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Auto%20Draw%20for%20Pen.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/Alternative%20Pens.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will load pen presets overriding the default freedraw line in Excalidraw. Once you've downloaded this script, check the script description for a detailed how to guide.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-alternative-pens.jpg'></td></tr></table>
-
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/threethan'>@threethan</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/Auto%20Draw%20for%20Pen.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Automatically switches from select mode to drawing mode when hovering a pen, and then back.</td></tr></table>
 
 ## Auto Layout
 ```excalidraw-script-install
@@ -117,6 +181,13 @@ 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/Auto%20Layout.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script performs automatic layout for the selected top-level grouping objects. It is powered by <a href='https://github.com/kieler/elkjs'>elkjs</a> and needs to be connected to the Internet.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-auto-layout.png'></td></tr></table>
 
+## Boolean Operations
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Boolean%20Operations.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/GColoy'>@GColoy</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/Boolean%20Operations.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">With This Script it is possible to make boolean Operations on Shapes.<br>The style of the resulting shape will be the style of the highest ranking Element that was used.<br>The ranking of the elemtns is based on their background. The "denser" the background, the higher the ranking (the order of backgroundstyles is shown below). If they have the same background the opacity will decide. If thats also the same its decided by the order they were created.<br>The ranking is also important for the diffrence operation, so a tranparent object for example will cut a hole into a solid object.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-boolean-operations-showcase.png'><br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-boolean-operations-element-ranking.png'></td></tr></table>
+
+
 ## Box Each Selected Groups
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Box%20Each%20Selected%20Groups.md
@@ -135,6 +206,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/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/Change%20shape%20of%20selected%20elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script allows you to change the shape and fill style of selected Rectangles, Diamonds, Ellipses, Lines, Arrows and Freedraw.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-change-shape.jpg'></td></tr></table>
 
+## Concatenate lines
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Concatenate%20lines.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/Concatenate%20lines.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will connect two objects with an arrow. If either of the objects are a set of grouped elements (e.g. a text element grouped with an encapsulating rectangle), the script will identify these groups, and connect the arrow to the largest object in the group (assuming you want to connect the arrow to the box around the text element).<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-concatenate-lines.png'></td></tr></table>
+
 ## Connect elements
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Connect%20elements.md
@@ -165,6 +242,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/Copy%20Selected%20Element%20Styles%20to%20Global.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will copy styles of any selected element into Excalidraw's global styles.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-copy-selected-element-styles-to-global.png'></td></tr></table>
 
+## Create DrawIO file
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Create%20DrawIO%20file.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/Create%20DrawIO%20file.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script will prompt you for a filename, then create a new draw.io diagram file and open the file in the <a href='https://github.com/zapthedingbat/drawio-obsidian'>Diagram plugin</a>, in a new tab.<br><iframe width="400" height="225" src="https://www.youtube.com/embed/DJcosmN-q2s" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></td></tr></table>
+
 ## Create new markdown file and embed into active drawing
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Create%20new%20markdown%20file%20and%20embed%20into%20active%20drawing.md
@@ -181,7 +264,7 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Deconstruct%20selected%20elements%20into%20new%20drawing.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/Deconstruct%20selected%20elements%20into%20new%20drawing.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Select some elements in the scene. The script will take these elements and move them into a new Excalidraw file, and open that file. The selected elements will also be replaced in your original drawing with the embedded Excalidraw file (the one that was just created). You will be prompted for the file name of the new deconstructed image. The script is useful if you want to break a larger drawing into smaller reusable parts that you want to reference in multiple drawings.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-deconstruct.jpg'></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/Deconstruct%20selected%20elements%20into%20new%20drawing.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Select some elements in the scene. The script will take these elements and move them into a new Excalidraw file, and open that file. The selected elements will also be replaced in your original drawing with the embedded Excalidraw file (the one that was just created). You will be prompted for the file name of the new deconstructed image. The script is useful if you want to break a larger drawing into smaller reusable parts that you want to reference in multiple drawings.<br><iframe width="400" height="225" src="https://www.youtube.com/embed/HRtaaD34Zzg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe><br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-deconstruct.jpg'></td></tr></table>
 
 ## Elbow connectors
 ```excalidraw-script-install
@@ -189,6 +272,18 @@ 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/Elbow%20connectors.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script converts the selected connectors to elbows.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/elbow-connectors.png'></td></tr></table>
 
+## Ellipse Selected Elements
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Ellipse%20Selected%20Elements.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/mazurov'>@mazurov</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/Ellipse%20Selected%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will add an encapsulating ellipse around the currently selected elements in Excalidraw.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-ellipse-elements.png'></td></tr></table>
+
+## Excalidraw Collaboration Frame
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Excalidraw%20Collaboration%20Frame.md
+```
+<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/Excalidraw%20Collaboration%20Frame.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Creates a new Excalidraw.com collaboration room and places the link to the room on the clipboard.<iframe width="400" height="225" src="https://www.youtube.com/embed/7isRfeAhEH4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></td></tr></table>
+
 ## Expand rectangles horizontally keep text centered
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Expand%20rectangles%20horizontally%20keep%20text%20centered.md
@@ -243,12 +338,30 @@ 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/Fixed%20vertical%20distance.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">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.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fixed-vertical-distance.png'></td></tr></table>
 
+## Folder Note Core - Make Current Drawing a Folder
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Folder%20Note%20Core%20-%20Make%20Current%20Drawing%20a%20Folder.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/Folder%20Note%20Core%20-%20Make%20Current%20Drawing%20a%20Folder.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script adds the `Folder Note Core: Make current document folder note` function to Excalidraw drawings. Running this script will convert the active Excalidraw drawing into a folder note. If you already have embedded images in your drawing, those attachments will not be moved when the folder note is created. You need to take care of those attachments separately, or convert the drawing to a folder note prior to adding the attachments. The script requires the <a href="https://github.com/aidenlx/folder-note-core" target="_blank">Folder Note Core</a> plugin.</td></tr></table>
+
 ## Grid selected images
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Grid%20Selected%20Images.md
 ```
 <table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/7flash'>@7flash</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/Grid%20Selected%20Images.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script arranges selected images into compact grid view, removing gaps in-between, resizing when necessary and breaking into multiple rows/columns.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-grid-selected-images.png'></td></tr></table>
 
+## Hardware Eraser Support
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Hardware%20Eraser%20Support.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/threethan'>@threethan</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/Hardware%20Eraser%20Support.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Allows you to use inversion, aka hardware eraser, on supported pens.</td></tr></table>
+
+## Invert colors
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Invert%20colors.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/Invert%20colors.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script inverts the colors on the canvas including the color palette in Element Properties.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-invert-colors.jpg'></td></tr></table>
+
 ## Lighten background color
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Lighten%20background%20color.md
@@ -283,7 +396,13 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Organic%20Line.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/Organic%20Line.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Converts selected freedraw lines such that pencil pressure will decrease from maximum to minimum from the beginning of the line to its end. The resulting line is placed at the back of the layers, under all other items. Helpful when drawing organic mindmaps.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-organic-line.jpg'></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/Organic%20Line.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Converts selected freedraw lines such that pencil pressure will decrease from maximum to minimum from the beginning of the line to its end. The resulting line is placed at the back of the layers, under all other items. Helpful when drawing organic mindmaps.<br>The script has been superseded by Custom Pens that you can enable in plugin settings. Find out more by watching this <a href="https://youtu.be/OjNhjaH2KjI" target="_blank">video</a><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-organic-line.jpg'></td></tr></table>
+
+## Organic Line Legacy
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Organic%20Line%20Legacy.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/Organic%20Line%20Legacy.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Converts selected freedraw lines such that pencil pressure will decrease from maximum to minimum from the beginning of the line to its end. The resulting line is placed at the back of the layers, under all other items. Helpful when drawing organic mindmaps.<br>This is the old script from this <a href="https://youtu.be/JMcNDdj_lPs?t=479" target="_blank">video</a>. Since it's release this has been superseded by custom pens that you can enable in plugin settings. For more on custom pens, watch <a href="https://youtu.be/OjNhjaH2KjI" target="_blank">this</a><br>The benefit of the approach in this implementation of custom pens is that it will look the same on excalidraw.com when you copy your drawing over for sharing with non-Obsidian users. Otherwise custom pens are faster to use and much more configurable.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-organic-line-legacy.jpg'></td></tr></table>
 
 ## Palette Loader
 ```excalidraw-script-install
@@ -291,6 +410,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/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/Palette%20loader.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Design your palette at <a href="http://paletton.com/" target="_blank">paletton.com</a> Once you are happy with your colors, click Tables/Export in the bottom right of the screen. Then click "Color swatches/as Sketch Palette", and copy the contents of the page to a markdown file in the palette folder of your vault (default is Excalidraw/Palette)<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-sketch-palette-loader-1.jpg'></td></tr></table>
 
+## PDF Page Text to Clipboard
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/PDF%20Page%20Text%20to%20Clipboard.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/PDF%20Page%20Text%20to%20Clipboard.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Copies the text from the selected PDF page on the Excalidraw canvas to the clipboard.<br><iframe width="400" height="225" src="https://www.youtube.com/embed/Kwt_8WdOUT4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe><br><a href='https://youtu.be/Kwt_8WdOUT4' target='_blank'>Link to video on YouTube</a></td></tr></table>
+
 ## Rename Image
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Rename%20Image.md
@@ -313,7 +438,7 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Scribble%20Helper.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/Scribble%20Helper.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">iOS scribble helper for better handwriting experience with text elements. If no elements are selected then the creates a text element at pointer position and you can use the edit box to modify the text with scribble. If a text element is selected then opens the input prompt where you can modify this text with scribble.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-scribble-helper.jpg'></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/Scribble%20Helper.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">iOS scribble helper for better handwriting experience with text elements. If no elements are selected then the creates a text element at pointer position and you can use the edit box to modify the text with scribble. If a text element is selected then opens the input prompt where you can modify this text with scribble.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-scribble-helper.jpg'><br><iframe width="560" height="315" src="https://www.youtube.com/embed/BvYkOaly-QM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></td></tr></table>
 
 ## Select Elements of Type
 ```excalidraw-script-install
@@ -321,6 +446,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/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/Select%20Elements%20of%20Type.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Prompts you with a list of the different element types in the active image. Only elements of the selected type will be selected on the canvas. If nothing is selected when running the script, then the script will process all the elements on the canvas. If some elements are selected when the script is executed, then the script will only process the selected elements.<br>The script is useful when, for example, you want to bring to front all the arrows, or want to change the color of all the text elements, etc.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-select-element-of-type.jpg'></td></tr></table>
 
+## Select Similar Elements
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Select%20Similar%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/Select%20Similar%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script allows you to streamline your Obsidian-Excalidraw workflows by enabling the selection of elements based on similar properties. you can precisely define which attributes such as stroke color, fill style, font family, and more, should match for selection. It's perfect for large canvases where manual selection would be cumbersome. You can either run the script to find and select matching elements across the entire scene, or define a specific group of elements to apply the selection criteria within a defined timeframe. This script enhances control and efficiency in your Excalidraw experience.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-select-similar-elements.png'></td></tr></table>
+
 ## Set background color of unclosed line object by adding a shadow clone
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20background%20color%20of%20unclosed%20line%20object%20by%20adding%20a%20shadow%20clone.md
@@ -367,7 +498,13 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Slideshow.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/Slideshow.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script will convert your drawing into a slideshow presentation.<br><iframe width="560" height="315" src="https://www.youtube.com/embed/HhRHFhWkmCk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></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/Slideshow.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script will convert your drawing into a slideshow presentation.<br><iframe width="560" height="315" src="https://www.youtube.com/embed/JwgtCrIVeEU" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></td></tr></table>
+
+## Split Ellipse
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Split%20Ellipse.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/GColoy'>@GColoy</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%20Ellipse.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script splits an ellipse at any point where a line intersects it. If no lines are selected, it will use every line that intersects the ellipse. Otherwise, it will only use the selected lines. If there is no intersecting line, the ellipse will be converted into a line object.<br>There is also the option to close the object along the cut, which will close the cut in the shape of the line.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-splitEllipse-demo1.png'><br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-splitEllipse-demo2.png'><br>Tip: To use an ellipse as the cutting object, you first have to use this script on it, since it will convert the ellipse into a line.</td></tr></table>
 
 ## Split text by lines
 ```excalidraw-script-install
@@ -381,6 +518,24 @@ 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/Text%20Arch.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Fit a text to the arch of a circle. The script will prompt you for the radius of the circle and then split your text to individual letters and place each letter to the arch defined by the radius. Setting a lower radius value will increase the arching of the text. Note that the arched-text will no longer be editable as a text element and it will no longer function as a markdown link. Emojis are currently not supported.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/text-arch.jpg'></td></tr></table>
 
+## Text Aura
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Text%20Aura.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/Text%20Aura.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Select a single text element, or a text element in a container. The container must have a transparent background.<br>The script will add an aura to the text by adding 4 copies of the text each with the inverted stroke color of the original text element and with a very small X and Y offset. The resulting 4 + 1 (original) text elements or containers will be grouped.<br>If you copy a color string on the clipboard before running the script, the script will use that color instead of the inverted color.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-aura.jpg'></td></tr></table>
+
+## Toggle Grid
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Toggle%20Grid.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/GColoy'>@GColoy</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/Toggle%20Grid.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Toggles the grid on and off.<br> Especially useful when drawing with just a pen without a mouse or keyboard, as toggling the grid by left-clicking with the pen is sometimes quite tedious.</table>
+
+## Text to Sticky Notes
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Text%20to%20Sticky%20Notes.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/Text%20to%20Sticky%20Notes.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Converts selected plain text element to sticky notes by dividing the text element line by line into separate sticky notes. The color of the stikcy note as well as the arrangement of the grid can be configured in plugin settings.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-sticky-note-matrix.jpg'></td></tr></table>
+
 ## Uniform Size
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Uniform%20size.md
@@ -391,4 +546,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 <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>
+<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-beta.json

@@ -1,8 +1,8 @@
 {
 	"id": "obsidian-excalidraw-plugin",
 	"name": "Excalidraw",
-	"version": "1.8.3-beta",
-	"minAppVersion": "0.16.0",
+	"version": "2.0.1-beta-2",
+	"minAppVersion": "1.1.6",
 	"description": "An Obsidian plugin to edit and view Excalidraw drawings",
 	"author": "Zsolt Viczian",
 	"authorUrl": "https://zsolt.blog",

manifest.json

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

package.json

@@ -1,6 +1,6 @@
 {
   "name": "obsidian-excalidraw-plugin",
-  "version": "1.8.10",
+  "version": "1.9.15",
   "description": "This is an Obsidian.md plugin that lets you view and edit Excalidraw drawings",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -10,60 +10,60 @@
   "scripts": {
     "dev": "cross-env NODE_ENV=development rollup --config rollup.config.js -w",
     "build": "cross-env NODE_ENV=production rollup --config rollup.config.js",
-    "lib": "cross-env NODE_ENV=lib rollup --config rollup.config.js -w",
-    "code:fix": "eslint --max-warnings=0 --ext .ts,.tsx ./src --fix"
+    "lib": "cross-env NODE_ENV=lib rollup --config rollup.config.js",
+    "code:fix": "eslint --max-warnings=0 --ext .ts,.tsx ./src --fix",
+    "madge": "madge --circular ."
   },
   "keywords": [],
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@types/lz-string": "^1.3.34",
-    "@zsviczian/excalidraw": "0.14.1-obsidian",
-    "clsx": "^1.2.1",
-    "lz-string": "^1.4.4",
+    "@zsviczian/excalidraw": "0.16.1-obsidian-8",
+    "chroma-js": "^2.4.2",
+    "clsx": "^2.0.0",
+    "colormaster": "^1.2.1",
+    "gl-matrix": "^3.4.3",
+    "lz-string": "^1.5.0",
     "monkey-around": "^2.3.0",
+    "polybooljs": "^1.2.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "react-scripts": "^5.0.1",
     "roughjs": "^4.5.2",
-    "colormaster": "1.2.1",
-    "chroma-js": "^2.4.2",
-    "gl-matrix": "^3.4.3"
+    "html2canvas": "^1.4.1",
+    "@popperjs/core": "^2.11.8",
+    "nanoid": "^4.0.2",
+    "lucide-react": "^0.263.1"
   },
   "devDependencies": {
-    "@babel/core": "^7.20.12",
-    "@babel/preset-env": "^7.20.2",
-    "@babel/preset-react": "^7.18.6",
+    "@babel/core": "^7.22.9",
+    "@babel/preset-env": "^7.22.10",
+    "@babel/preset-react": "^7.22.5",
     "@excalidraw/eslint-config": "^1.0.3",
     "@excalidraw/prettier-config": "^1.0.2",
-    "@popperjs/core": "^2.11.6",
     "@rollup/plugin-babel": "^6.0.3",
-    "@rollup/plugin-commonjs": "^24.0.0",
-    "@rollup/plugin-node-resolve": "^15.0.1",
+    "@rollup/plugin-commonjs": "^24.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.1",
     "@rollup/plugin-replace": "^5.0.2",
-    "@rollup/plugin-typescript": "^11.0.0",
-    "@types/js-beautify": "^1.13.3",
-    "@types/chroma-js": "^2.1.4",
-    "@types/node": "^18.11.18",
-    "@types/react-dom": "^18.0.10",
+    "@rollup/plugin-typescript": "^11.1.2",
+    "@types/chroma-js": "^2.4.0",
+    "@types/js-beautify": "^1.14.0",
+    "@types/node": "^20.5.6",
+    "@types/react-dom": "^18.2.7",
     "@zerollup/ts-transform-paths": "^1.7.18",
     "cross-env": "^7.0.3",
-    "eslint-config-prettier": "^8.6.0",
-    "eslint-plugin-prettier": "^4.2.1",
-    "html2canvas": "^1.4.1",
-    "nanoid": "^4.0.0",
-    "obsidian": "^1.1.1",
-    "prettier": "^2.8.2",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-prettier": "^5.0.0",
+    "obsidian": "^1.4.0",
+    "prettier": "^3.0.1",
     "rollup": "^2.70.1",
     "rollup-plugin-copy": "^3.4.0",
     "rollup-plugin-postprocess": "github:brettz9/rollup-plugin-postprocess#update",
     "rollup-plugin-terser": "^7.0.2",
     "rollup-plugin-typescript2": "^0.34.1",
-    "rollup-plugin-visualizer": "^5.9.0",
     "rollup-plugin-web-worker-loader": "^1.6.1",
-    "tslib": "^2.4.1",
+    "tslib": "^2.6.1",
     "ttypescript": "^1.5.15",
-    "typescript": "^4.9.4"
+    "typescript": "^5.2.2"
   },
   "resolutions": {
     "@typescript-eslint/typescript-estree": "5.3.0"

rollup.config.js

@@ -1,4 +1,3 @@
-import typescript from '@rollup/plugin-typescript';
 import { nodeResolve } from '@rollup/plugin-node-resolve';
 import commonjs from '@rollup/plugin-commonjs';
 import { env } from "process";
@@ -6,38 +5,37 @@ import babel from '@rollup/plugin-babel';
 import replace from "@rollup/plugin-replace";
 import { terser } from "rollup-plugin-terser";
 import copy from "rollup-plugin-copy";
-import ttypescript from "ttypescript";
 import typescript2 from "rollup-plugin-typescript2";
 import webWorker from "rollup-plugin-web-worker-loader";
 import fs from'fs';
 import LZString from 'lz-string';
 import postprocess from 'rollup-plugin-postprocess';
 
-const isProd = (process.env.NODE_ENV === "production");
+const isProd = (process.env.NODE_ENV === "production")
+const isLib = (process.env.NODE_ENV === "lib");
+console.log(`Running: ${process.env.NODE_ENV}`);
 
-const excalidraw_pkg = isProd
+const excalidraw_pkg = isLib ? "" : isProd
   ? fs.readFileSync("./node_modules/@zsviczian/excalidraw/dist/excalidraw.production.min.js", "utf8")
   : fs.readFileSync("./node_modules/@zsviczian/excalidraw/dist/excalidraw.development.js", "utf8");
-const react_pkg = isProd
+const react_pkg = isLib ? "" : isProd
   ? fs.readFileSync("./node_modules/react/umd/react.production.min.js", "utf8")
   : fs.readFileSync("./node_modules/react/umd/react.development.js", "utf8");
-const reactdom_pkg = isProd
+const reactdom_pkg = isLib ? "" : isProd
   ? fs.readFileSync("./node_modules/react-dom/umd/react-dom.production.min.js", "utf8")
   : fs.readFileSync("./node_modules/react-dom/umd/react-dom.development.js", "utf8");
-const lzstring_pkg = fs.readFileSync("./node_modules/lz-string/libs/lz-string.min.js", "utf8");
+const lzstring_pkg = isLib ? "" : fs.readFileSync("./node_modules/lz-string/libs/lz-string.min.js", "utf8");
 
-const manifestStr = fs.readFileSync("manifest.json", "utf-8");
-const manifest = JSON.parse(manifestStr);
-console.log(manifest.version);
+const manifestStr = isLib ? "" : fs.readFileSync("manifest.json", "utf-8");
+const manifest = isLib ? {} : JSON.parse(manifestStr);
+!isLib && console.log(manifest.version);
 
-const packageString = ';'+lzstring_pkg+'const EXCALIDRAW_PACKAGES = "' + LZString.compressToBase64(react_pkg + reactdom_pkg + excalidraw_pkg) + '";' +
+const packageString = isLib ? "" : ';'+lzstring_pkg+'const EXCALIDRAW_PACKAGES = "' + LZString.compressToBase64(react_pkg + reactdom_pkg + excalidraw_pkg) + '";' +
   'const {react, reactDOM, excalidrawLib} = window.eval.call(window, `(function() {' +
   '${LZString.decompressFromBase64(EXCALIDRAW_PACKAGES)};' +
   'return {react:React, reactDOM:ReactDOM, excalidrawLib: ExcalidrawLib};})();`);' +
   'const PLUGIN_VERSION="'+manifest.version+'";';
 
-
-
 const BASE_CONFIG = {
   input: 'src/main.ts',
   external: ['obsidian', '@zsviczian/excalidraw', 'react', 'react-dom'],
@@ -60,16 +58,24 @@ const BUILD_CONFIG = {
     exports: 'default',
   },
   plugins: [
+    typescript2({
+      tsconfig: isProd ? "tsconfig.json" : "tsconfig.dev.json",
+      inlineSources: !isProd
+    }),
     replace({
       preventAssignment: true,
       "process.env.NODE_ENV": JSON.stringify(env.NODE_ENV),
     }),
     babel({
+      presets: [['@babel/preset-env', {
+        targets: {
+          esmodules: true,
+        },
+      }]],
       exclude: "node_modules/**"
     }),
     commonjs(),
     nodeResolve({ browser: true, preferBuiltins: false }),
-    typescript({inlineSources: !isProd}),
     ...isProd 
     ? [
       terser({toplevel: false, compress: {passes: 2}}),
@@ -98,7 +104,7 @@ const LIB_CONFIG = {
     name: "Excalidraw (Library)",
   },
   plugins: getRollupPlugins(
-      { tsconfig: "tsconfig-lib.json", typescript: ttypescript },
+      { tsconfig: "tsconfig-lib.json"},
       copy({ targets: [{ src: "src/*.d.ts", dest: "lib/typings" }] })
   ),  
 }

src/EmbeddedFileLoader.ts

@@ -1,11 +1,15 @@
 //https://stackoverflow.com/questions/2068344/how-do-i-get-a-youtube-video-thumbnail-from-the-youtube-api
 //https://img.youtube.com/vi/uZz5MgzWXiM/maxresdefault.jpg
 
-import { FileId } from "@zsviczian/excalidraw/types/element/types";
+import { ExcalidrawElement, ExcalidrawImageElement, FileId } from "@zsviczian/excalidraw/types/element/types";
 import { BinaryFileData, DataURL } from "@zsviczian/excalidraw/types/types";
-import { App, MarkdownRenderer, Notice, requestUrl, RequestUrlResponse, TFile } from "obsidian";
+import { App, MarkdownRenderer, Notice, TFile } from "obsidian";
 import {
+  ASSISTANT_FONT,
   CASCADIA_FONT,
+  VIRGIL_FONT,
+} from "./constFonts";
+import {  
   DEFAULT_MD_EMBED_CSS,
   fileid,
   FRONTMATTER_KEY_BORDERCOLOR,
@@ -14,15 +18,15 @@ import {
   FRONTMATTER_KEY_MD_STYLE,
   IMAGE_TYPES,
   nanoid,
-  URLFETCHTIMEOUT,
-  VIRGIL_FONT,
-} from "./Constants";
+  THEME_FILTER,
+} from "./constants";
 import { createSVG } from "./ExcalidrawAutomate";
 import { ExcalidrawData, getTransclusion } from "./ExcalidrawData";
 import { ExportSettings } from "./ExcalidrawView";
 import { t } from "./lang/helpers";
 import { tex2dataURL } from "./LaTeX";
 import ExcalidrawPlugin from "./main";
+import { blobToBase64, getDataURLFromURL, getMimeType, getPDFDoc, getURLImageExtension, readLocalFileBinary } from "./utils/FileUtils";
 import {
   errorlog,
   getDataURL,
@@ -37,18 +41,42 @@ import {
   LinkParts,
   svgToBase64,
 } from "./utils/Utils";
+import { ValueOf } from "./types";
+import { getMermaidImageElements, getMermaidText, shouldRenderMermaid } from "./utils/MermaidUtils";
+import { mermaidToExcalidraw } from "src/constants";
 
-const THEME_FILTER = "invert(100%) hue-rotate(180deg) saturate(1.25)";
+//An ugly workaround for the following situation.
+//File A is a markdown file that has an embedded Excalidraw file B
+//Later file A is embedded into file B as a Markdown embed
+//Because MarkdownRenderer.renderMarkdown does not take a depth parameter as input
+//EmbeddedFileLoader cannot track the recursion depth (as it can when Excalidraw drawings are embedded)
+//For this reason, the markdown TFile is added to the Watchdog when rendering starts
+//and getObsidianImage is aborted if the file is already in the Watchdog stack
+const  markdownRendererRecursionWatcthdog = new Set<TFile>();
+
+export const IMAGE_MIME_TYPES = {
+  svg: "image/svg+xml",
+  png: "image/png",
+  jpg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  bmp: "image/bmp",
+  ico: "image/x-icon",
+  avif: "image/avif",
+  jfif: "image/jfif",
+} as const;
+
+type ImgData = {
+  mimeType: MimeType;
+  fileId: FileId;
+  dataURL: DataURL;
+  created: number;
+  hasSVGwithBitmap: boolean;
+  size: { height: number; width: number };
+};
+
+export declare type MimeType = ValueOf<typeof IMAGE_MIME_TYPES> | "application/octet-stream";
 
-export declare type MimeType =
-  | "image/svg+xml"
-  | "image/png"
-  | "image/jpeg"
-  | "image/gif"
-  | "image/webp"
-  | "image/bmp"
-  | "image/x-icon"
-  | "application/octet-stream";
 export type FileData = BinaryFileData & {
   size: Size;
   hasSVGwithBitmap: boolean;
@@ -60,6 +88,63 @@ export type Size = {
   width: number;
 };
 
+export interface ColorMap {
+  [color: string]: string;
+};
+
+/**
+ * Function takes an SVG and replaces all fill and stroke colors with the ones in the colorMap
+ * @param svg: SVGSVGElement
+ * @param colorMap: {[color: string]: string;} | null
+ * @returns svg with colors replaced
+ */
+const replaceSVGColors = (svg: SVGSVGElement | string, colorMap: ColorMap | null): SVGSVGElement | string => {
+  if(!colorMap) {
+    return svg;
+  }
+
+  if(typeof svg === 'string') {
+    // Replace colors in the SVG string
+    for (const [oldColor, newColor] of Object.entries(colorMap)) {
+      const fillRegex = new RegExp(`fill="${oldColor}"`, 'gi');
+      svg = svg.replaceAll(fillRegex, `fill="${newColor}"`);
+      const fillStyleRegex = new RegExp(`fill:${oldColor}`, 'gi');
+      svg = svg.replaceAll(fillStyleRegex, `fill:${newColor}`);
+      const strokeRegex = new RegExp(`stroke="${oldColor}"`, 'gi');
+      svg = svg.replaceAll(strokeRegex, `stroke="${newColor}"`);
+      const strokeStyleRegex = new RegExp(`stroke:${oldColor}`, 'gi');
+      svg = svg.replaceAll(strokeStyleRegex, `stroke:${newColor}`);
+    }
+    return svg;
+  }
+
+  // Modify the fill and stroke attributes of child nodes
+  const childNodes = (node: ChildNode) => {
+    if (node instanceof SVGElement) {
+      const oldFill = node.getAttribute('fill')?.toLocaleLowerCase();
+      const oldStroke = node.getAttribute('stroke')?.toLocaleLowerCase();
+
+      if (oldFill && colorMap[oldFill]) {
+        node.setAttribute('fill', colorMap[oldFill]);
+      }
+      if (oldStroke && colorMap[oldStroke]) {
+        node.setAttribute('stroke', colorMap[oldStroke]);
+      }
+    }
+    for(const child of node.childNodes) {
+      childNodes(child);
+    }
+  }
+
+  for (const child of svg.childNodes) {
+    childNodes(child);
+  }
+
+  return svg;
+}
+
+
+
 export class EmbeddedFile {
   public file: TFile = null;
   public isSVGwithBitmap: boolean = false;
@@ -72,24 +157,39 @@ export class EmbeddedFile {
   public linkParts: LinkParts;
   private hostPath: string;
   public attemptCounter: number = 0;
-  public isHyperlink: boolean = false;
+  public isHyperLink: boolean = false;
+  public isLocalLink: boolean = false;
   public hyperlink:DataURL;
+  public colorMap: ColorMap | null = null;
 
-  constructor(plugin: ExcalidrawPlugin, hostPath: string, imgPath: string) {
+  constructor(plugin: ExcalidrawPlugin, hostPath: string, imgPath: string, colorMapJSON?: string) {
     this.plugin = plugin;
     this.resetImage(hostPath, imgPath);
+    if(this.file && (this.plugin.ea.isExcalidrawFile(this.file) || this.file.extension.toLowerCase() === "svg")) {
+      try {
+        this.colorMap = colorMapJSON ? JSON.parse(colorMapJSON.toLocaleLowerCase()) : null;
+      } catch (error) {
+        this.colorMap = null;
+      }
+    }
   }
 
   public resetImage(hostPath: string, imgPath: string) {
     this.imgInverted = this.img = "";
     this.mtime = 0;
 
-    if(imgPath.startsWith("https://") || imgPath.startsWith("http://")){
-      this.isHyperlink = true;
+    if(imgPath.startsWith("https://") || imgPath.startsWith("http://") || imgPath.startsWith("ftp://") || imgPath.startsWith("ftps://")) {
+      this.isHyperLink = true;
       this.hyperlink = imgPath as DataURL;
       return;
     };
 
+    if(imgPath.startsWith("file://")) {
+      this.isLocalLink = true;
+      this.hyperlink = imgPath as DataURL;
+      return;
+    }
+
     this.linkParts = getLinkParts(imgPath);
     this.hostPath = hostPath;
     if (!this.linkParts.path) {
@@ -117,11 +217,11 @@ export class EmbeddedFile {
   }
 
   private fileChanged(): boolean {
-    if(this.isHyperlink) {
+    if(this.isHyperLink || this.isLocalLink) {
       return false;
     }
     if (!this.file) {
-      this.file = app.metadataCache.getFirstLinkpathDest(
+      this.file = this.plugin.app.metadataCache.getFirstLinkpathDest(
         this.linkParts.path,
         this.hostPath,
       ); // maybe the file has synchronized in the mean time
@@ -140,13 +240,13 @@ export class EmbeddedFile {
     isDark: boolean,
     isSVGwithBitmap: boolean,
   ) {
-    if (!this.file && !this.isHyperlink) {
+    if (!this.file && !this.isHyperLink && !this.isLocalLink) {
       return;
     }
     if (this.fileChanged()) {
       this.imgInverted = this.img = "";
     }
-    this.mtime = this.isHyperlink ? 0 : this.file.stat.mtime;
+    this.mtime = this.isHyperLink || this.isLocalLink ? 0 : this.file.stat.mtime;
     this.size = size;
     this.mimeType = mimeType;
     switch (isDark && isSVGwithBitmap) {
@@ -161,7 +261,7 @@ export class EmbeddedFile {
   }
 
   public isLoaded(isDark: boolean): boolean {
-    if(!this.isHyperlink) {  
+    if(!this.isHyperLink && !this.isLocalLink) {  
       if (!this.file) {
         this.file = app.metadataCache.getFirstLinkpathDest(
           this.linkParts.path,
@@ -183,7 +283,7 @@ export class EmbeddedFile {
   }
 
   public getImage(isDark: boolean) {
-    if (!this.file && !this.isHyperlink) {
+    if (!this.file && !this.isHyperLink && !this.isLocalLink) {
       return "";
     }
     if (isDark && this.isSVGwithBitmap) {
@@ -197,11 +297,12 @@ export class EmbeddedFile {
    * @returns true if image should scale such as the updated images has the same area as the previous images, false if the image should be displayed at 100%
    */
   public shouldScale() {
-    return this.isHyperlink || !Boolean(this.linkParts && this.linkParts.original && this.linkParts.original.endsWith("|100%"));
+    return this.isHyperLink || this.isLocalLink || !Boolean(this.linkParts && this.linkParts.original && this.linkParts.original.endsWith("|100%"));
   }
 }
 
 export class EmbeddedFilesLoader {
+  private pdfDocsMap: Map<string, any> = new Map();
   private plugin: ExcalidrawPlugin;
   private isDark: boolean;
   public terminate = false;
@@ -213,6 +314,11 @@ export class EmbeddedFilesLoader {
     this.uid = nanoid();
   }
 
+  public emptyPDFDocsMap() {
+    this.pdfDocsMap.forEach((pdfDoc) => pdfDoc.destroy());
+    this.pdfDocsMap.clear();
+  }
+
   public async getObsidianImage(inFile: TFile | EmbeddedFile, depth: number): Promise<{
     mimeType: MimeType;
     fileId: FileId;
@@ -221,14 +327,91 @@ export class EmbeddedFilesLoader {
     hasSVGwithBitmap: boolean;
     size: { height: number; width: number };
   }> {
+    const result = await this._getObsidianImage(inFile, depth);
+    this.emptyPDFDocsMap();
+    return result;
+  }
+  
+  private async getExcalidrawSVG ({
+    isDark,
+    file,
+    depth,
+    inFile,
+    hasSVGwithBitmap,
+    elements = [],
+  }: {
+    isDark: boolean;
+    file: TFile;
+    depth: number;
+    inFile: TFile | EmbeddedFile;
+    hasSVGwithBitmap: boolean;
+    elements?: ExcalidrawElement[];
+  }) : Promise<{dataURL: DataURL, hasSVGwithBitmap:boolean}> {
+    //debug({where:"EmbeddedFileLoader.getExcalidrawSVG",uid:this.uid,file:file.name});
+    const forceTheme = hasExportTheme(this.plugin, file)
+      ? getExportTheme(this.plugin, file, "light")
+      : undefined;
+    const exportSettings: ExportSettings = {
+      withBackground: hasExportBackground(this.plugin, file)
+        ? getWithBackground(this.plugin, file)
+        : false,
+      withTheme: !!forceTheme,
+    };
+    const svg = replaceSVGColors(
+      await createSVG(
+        file?.path,
+        true,
+        exportSettings,
+        this,
+        forceTheme,
+        null,
+        null,
+        elements,
+        this.plugin,
+        depth+1,
+        getExportPadding(this.plugin, file),
+      ),
+      inFile instanceof EmbeddedFile ? inFile.colorMap : null
+    ) as SVGSVGElement;
+
+    //https://stackoverflow.com/questions/51154171/remove-css-filter-on-child-elements
+    const imageList = svg.querySelectorAll(
+      "image:not([href^='data:image/svg'])",
+    );
+    if (imageList.length > 0) {
+      hasSVGwithBitmap = true;
+    }
+    if (hasSVGwithBitmap && isDark) { 
+      imageList.forEach((i) => {
+        const id = i.parentElement?.id;
+        svg.querySelectorAll(`use[href='#${id}']`).forEach((u) => {
+          u.setAttribute("filter", THEME_FILTER);
+        });
+      });
+    }
+    if (!hasSVGwithBitmap && svg.getAttribute("hasbitmap")) {
+      hasSVGwithBitmap = true;
+    }
+    const dURL = svgToBase64(svg.outerHTML) as DataURL;
+    return {dataURL: dURL as DataURL, hasSVGwithBitmap};
+  };
+
+  private async _getObsidianImage(inFile: TFile | EmbeddedFile, depth: number): Promise<ImgData> {
     if (!this.plugin || !inFile) {
       return null;
     }
-    const isHyperlink = inFile instanceof EmbeddedFile ? inFile.isHyperlink : false;
+
+    const isHyperLink = inFile instanceof EmbeddedFile ? inFile.isHyperLink : false;
+    const isLocalLink = inFile instanceof EmbeddedFile ? inFile.isLocalLink : false;
     const hyperlink = inFile instanceof EmbeddedFile ? inFile.hyperlink : "";
     const file: TFile = inFile instanceof EmbeddedFile ? inFile.file : inFile;
+    if(file && markdownRendererRecursionWatcthdog.has(file)) {
+      new Notice(`Loading of ${file.path}. Please check if there is an inifinite loop of one file embedded in the other.`);
+      return null;
+    }
+
     const linkParts =
-      isHyperlink
+      isHyperLink
         ? null
         : inFile instanceof EmbeddedFile
           ? inFile.linkParts
@@ -239,12 +422,15 @@ export class EmbeddedFilesLoader {
               ref: null,
               width: this.plugin.settings.mdSVGwidth,
               height: this.plugin.settings.mdSVGmaxHeight,
+              page: null,
             };
 
     let hasSVGwithBitmap = false;
-    const isExcalidrawFile = !isHyperlink && this.plugin.isExcalidrawFile(file);
+    const isExcalidrawFile = !isHyperLink && !isLocalLink && this.plugin.isExcalidrawFile(file);
+    const isPDF = !isHyperLink && !isLocalLink && file.extension.toLowerCase() === "pdf";
+
     if (
-      !isHyperlink &&
+      !isHyperLink && !isPDF && !isLocalLink &&
       !(
         IMAGE_TYPES.contains(file.extension) ||
         isExcalidrawFile ||
@@ -253,137 +439,72 @@ export class EmbeddedFilesLoader {
     ) {
       return null;
     }
-    const ab = isHyperlink
+    const ab = isHyperLink || isPDF
       ? null
-      : await app.vault.readBinary(file);
+      : isLocalLink
+        ? await readLocalFileBinary((inFile as EmbeddedFile).hyperlink.split("file://")[1])
+        : await app.vault.readBinary(file);
 
-    const getExcalidrawSVG = async (isDark: boolean) => {
-      //debug({where:"EmbeddedFileLoader.getExcalidrawSVG",uid:this.uid,file:file.name});
-      const forceTheme = hasExportTheme(this.plugin, file)
-        ? getExportTheme(this.plugin, file, "light")
-        : undefined;
-      const exportSettings: ExportSettings = {
-        withBackground: hasExportBackground(this.plugin, file)
-          ? getWithBackground(this.plugin, file)
-          : false,
-        withTheme: !!forceTheme,
-      };
-      const svg = await createSVG(
-        file.path,
-        true,
-        exportSettings,
-        this,
-        forceTheme,
-        null,
-        null,
-        [],
-        this.plugin,
-        depth+1,
-        getExportPadding(this.plugin, file),
-      );
-      //https://stackoverflow.com/questions/51154171/remove-css-filter-on-child-elements
-      const imageList = svg.querySelectorAll(
-        "image:not([href^='data:image/svg'])",
-      );
-      if (imageList.length > 0) {
-        hasSVGwithBitmap = true;
-      }
-      if (hasSVGwithBitmap && isDark) { 
-        imageList.forEach((i) => {
-          const id = i.parentElement?.id;
-          svg.querySelectorAll(`use[href='#${id}']`).forEach((u) => {
-            u.setAttribute("filter", THEME_FILTER);
-          });
-        });
-      }
-      if (!hasSVGwithBitmap && svg.getAttribute("hasbitmap")) {
-        hasSVGwithBitmap = true;
-      }
-      const dURL = svgToBase64(svg.outerHTML) as DataURL;
-      return dURL as DataURL;
-    };
-
-    const excalidrawSVG = isExcalidrawFile
-      ? await getExcalidrawSVG(this.isDark)
-      : null;
-    let mimeType: MimeType = "image/svg+xml";
-    const corelink = isHyperlink
-      ? hyperlink.split("?")[0]
-      : "";
-    const extension = isHyperlink
-      ? corelink.substring(corelink.lastIndexOf(".")+1)
-      : file.extension;
-    if (!isExcalidrawFile) {
-      switch (extension) {
-        case "png":
-          mimeType = "image/png";
-          break;
-        case "jpeg":
-          mimeType = "image/jpeg";
-          break;
-        case "jpg":
-          mimeType = "image/jpeg";
-          break;
-        case "gif":
-          mimeType = "image/gif";
-          break;
-        case "webp":
-          mimeType = "image/webp";
-          break;
-        case "bmp":
-          mimeType = "image/bmp";
-          break;
-        case "ico":
-          mimeType = "image/x-icon"
-          break;
-        case "svg":
-        case "md":
-          mimeType = "image/svg+xml";
-          break;
-        default:
-          mimeType = "application/octet-stream";
-      }
+    let dURL: DataURL = null;
+    if (isExcalidrawFile) {
+      const res = await this.getExcalidrawSVG({
+        isDark: this.isDark,
+        file,
+        depth,
+        inFile,
+        hasSVGwithBitmap,
+      });
+      dURL = res.dataURL;
+      hasSVGwithBitmap = res.hasSVGwithBitmap;
     }
-    let response:RequestUrlResponse;
-    if(isHyperlink && inFile instanceof EmbeddedFile) {
-      try {
-        response = await Promise.race([
-          (async () => new Promise<RequestUrlResponse>((resolve) => setTimeout(()=>resolve(null), URLFETCHTIMEOUT)))(),
-          requestUrl({url: inFile.hyperlink, method: "get", contentType: mimeType, throw: false })
-        ])
-      } catch (e) {
-        errorlog({where: this.getObsidianImage, message: `URL did not load within timeout period of ${URLFETCHTIMEOUT}ms`, url: inFile.hyperlink});
-      }
+
+    const excalidrawSVG = isExcalidrawFile ? dURL : null;
+
+    const [pdfDataURL, pdfSize] = isPDF
+      ? await this.pdfToDataURL(file,linkParts)
+      : [null, null];
+
+    let mimeType: MimeType = isPDF
+      ? "image/png"
+      : "image/svg+xml";
+
+    const extension = isHyperLink || isLocalLink
+      ? getURLImageExtension(hyperlink)
+      : file.extension;
+    if (!isExcalidrawFile && !isPDF) {
+      mimeType = getMimeType(extension);
     }
 
     let dataURL =
-      isHyperlink
+      isHyperLink
       ? (
           inFile instanceof EmbeddedFile
-            ? (response && response.status === 200 ? await getDataURL(response.arrayBuffer, mimeType) : inFile.hyperlink)
+            ? await getDataURLFromURL(inFile.hyperlink, mimeType)
             : null
         )
-      : excalidrawSVG ??
-        (file.extension === "svg"
-          ? await getSVGData(app, file)
-          : file.extension === "md"
+      : excalidrawSVG ?? pdfDataURL ??
+        (file?.extension === "svg"
+          ? await getSVGData(app, file, inFile instanceof EmbeddedFile ? inFile.colorMap : null)
+          : file?.extension === "md"
           ? null
           : await getDataURL(ab, mimeType));
 
-    if(!isHyperlink && !dataURL) {
-      const result = await this.convertMarkdownToSVG(this.plugin, file, linkParts);
+    if(!isHyperLink && !dataURL && !isLocalLink) {
+      markdownRendererRecursionWatcthdog.add(file);
+      const result = await this.convertMarkdownToSVG(this.plugin, file, linkParts, depth);
+      markdownRendererRecursionWatcthdog.delete(file);
       dataURL = result.dataURL;
       hasSVGwithBitmap = result.hasSVGwithBitmap;
     }
     try{
-      const size = await getImageSize(dataURL);
+      const size = isPDF ? pdfSize : await getImageSize(dataURL);
       return {
         mimeType,
         fileId: await generateIdFromFile(
-          isHyperlink? (new TextEncoder()).encode(dataURL as string) : ab
+          isHyperLink || isPDF ? (new TextEncoder()).encode(dataURL as string) : ab
         ),
         dataURL,
-        created: isHyperlink ? 0 : file.stat.mtime,
+        created: isHyperLink || isLocalLink ? 0 : file.stat.mtime,
         hasSVGwithBitmap,
         size,
       };
@@ -394,7 +515,7 @@ export class EmbeddedFilesLoader {
 
   public async loadSceneFiles(
     excalidrawData: ExcalidrawData,
-    addFiles: (files: FileData[], isDark: boolean) => void,
+    addFiles: (files: FileData[], isDark: boolean, final?: boolean) => void,
     depth:number
   ) {
     if(depth > 4) {
@@ -406,15 +527,15 @@ export class EmbeddedFilesLoader {
     if (this.isDark === undefined) {
       this.isDark = excalidrawData?.scene?.appState?.theme === "dark";
     }
-    let entry;
+    let entry: IteratorResult<[FileId, EmbeddedFile]>;
     const files: FileData[] = [];
     while (!this.terminate && !(entry = entries.next()).done) {
       const embeddedFile: EmbeddedFile = entry.value[1];
       if (!embeddedFile.isLoaded(this.isDark)) {
         //debug({where:"EmbeddedFileLoader.loadSceneFiles",uid:this.uid,status:"embedded Files are not loaded"});
-        const data = await this.getObsidianImage(embeddedFile, depth);
+        const data = await this._getObsidianImage(embeddedFile, depth);
         if (data) {
-          files.push({
+          const fileData = {
             mimeType: data.mimeType,
             id: entry.value[0],
             dataURL: data.dataURL,
@@ -422,10 +543,17 @@ export class EmbeddedFilesLoader {
             size: data.size,
             hasSVGwithBitmap: data.hasSVGwithBitmap,
             shouldScale: embeddedFile.shouldScale()
-          });
+          };
+          try  {
+            addFiles([fileData], this.isDark, false);
+          }
+          catch(e) {
+            errorlog({ where: "EmbeddedFileLoader.loadSceneFiles", error: e });
+          }
+          //files.push(fileData);
         }
       } else if (embeddedFile.isSVGwithBitmap) {
-        files.push({
+        const fileData = {
           mimeType: embeddedFile.mimeType,
           id: entry.value[0],
           dataURL: embeddedFile.getImage(this.isDark) as DataURL,
@@ -433,7 +561,14 @@ export class EmbeddedFilesLoader {
           size: embeddedFile.size,
           hasSVGwithBitmap: embeddedFile.isSVGwithBitmap,
           shouldScale: embeddedFile.shouldScale()
-        });
+        };
+        //files.push(fileData);
+        try  {
+          addFiles([fileData], this.isDark, false);
+        }
+        catch(e) {
+          errorlog({ where: "EmbeddedFileLoader.loadSceneFiles", error: e });
+        }
       }
     }
 
@@ -444,7 +579,7 @@ export class EmbeddedFilesLoader {
         const latex = equation.value[1].latex;
         const data = await tex2dataURL(latex, this.plugin);
         if (data) {
-          files.push({
+          const fileData = {
             mimeType: data.mimeType,
             id: equation.value[0],
             dataURL: data.dataURL,
@@ -452,27 +587,136 @@ export class EmbeddedFilesLoader {
             size: data.size,
             hasSVGwithBitmap: false,
             shouldScale: true
-          });
+          };
+          files.push(fileData);
         }
       }
     }
 
+    if(shouldRenderMermaid()) {
+      const mermaidElements = getMermaidImageElements(excalidrawData.scene.elements);
+      for(const element of mermaidElements) {
+        if(this.terminate) {
+          continue;
+        }
+        const data = getMermaidText(element);
+        const result = await mermaidToExcalidraw(data, {fontSize: 20}, true);
+        if(!result) {
+          continue;
+        }
+        if(result?.files) {
+          for (const key in result.files) {
+            const fileData = {
+              ...result.files[key],
+              id: element.fileId,
+              created: Date.now(),
+              hasSVGwithBitmap: false,
+              shouldScale: true,
+              size: await getImageSize(result.files[key].dataURL),
+            };
+            files.push(fileData);
+          }
+          continue;
+        }
+        if(result?.elements) {
+          //handle case that mermaidToExcalidraw has implemented this type of diagram in the mean time
+          const res = await this.getExcalidrawSVG({
+            isDark: this.isDark,
+            file: null,
+            depth,
+            inFile: null,
+            hasSVGwithBitmap: false,
+            elements: result.elements
+          });
+          if(res?.dataURL) {
+            const size = await getImageSize(res.dataURL);
+            const fileData:FileData = {
+              mimeType: "image/svg+xml",
+              id: element.fileId,
+              dataURL: res.dataURL,
+              created: Date.now(),
+              hasSVGwithBitmap: res.hasSVGwithBitmap,
+              size,
+              shouldScale: true,
+            };
+            files.push(fileData);
+          }
+          continue;
+        }  
+      }
+    };
+
+    this.emptyPDFDocsMap();
     if (this.terminate) {
       return;
     }
     //debug({where:"EmbeddedFileLoader.loadSceneFiles",uid:this.uid,status:"add Files"});
     try {
       //in try block because by the time files are loaded the user may have closed the view
-      addFiles(files, this.isDark);
+      addFiles(files, this.isDark, true);
     } catch (e) {
       errorlog({ where: "EmbeddedFileLoader.loadSceneFiles", error: e });
     }
   }
 
+  private async pdfToDataURL(
+    file: TFile,
+    linkParts: LinkParts,
+  ): Promise<[DataURL,{width:number, height:number}]> {
+    try {
+      let width = 0, height = 0;
+      const pdfDoc = this.pdfDocsMap.get(file.path) ?? await getPDFDoc(file);
+      if(!this.pdfDocsMap.has(file.path)) {
+        this.pdfDocsMap.set(file.path, pdfDoc);
+      }
+      const pageNum = isNaN(linkParts.page) ? 1 : (linkParts.page??1);
+      const scale = this.plugin.settings.pdfScale;
+
+      // Render the page
+      const renderPage = async (num:number) => {
+        const canvas = createEl("canvas");
+        const ctx = canvas.getContext('2d');
+        
+        // Get page
+        const page = await pdfDoc.getPage(num);
+        // Set scale
+        const viewport = page.getViewport({ scale });
+        height = canvas.height = viewport.height;
+        width = canvas.width = viewport.width;
+
+        const renderCtx = {
+          canvasContext: ctx,
+          background: 'rgba(0,0,0,0)',
+          viewport
+        };
+
+        await page.render(renderCtx).promise;
+        return canvas;
+      };
+
+      const canvas = await renderPage(pageNum); 
+      if(canvas) {
+        const result: [DataURL,{width:number, height:number}] = [`data:image/png;base64,${await new Promise((resolve, reject) => {
+          canvas.toBlob(async (blob) => {
+            const dataURL = await blobToBase64(blob);
+            resolve(dataURL);
+          });
+        })}` as DataURL, {width, height}];
+        canvas.width = 0; //free memory iOS bug
+        canvas.height = 0;
+        return result;
+      }
+    } catch(e) {
+      console.log(e);
+      return [null,null];
+    }
+  }
+
   private async convertMarkdownToSVG(
     plugin: ExcalidrawPlugin,
     file: TFile,
     linkParts: LinkParts,
+    depth: number,
   ): Promise<{dataURL: DataURL, hasSVGwithBitmap:boolean}> {
     //1.
     //get the markdown text
@@ -502,6 +746,9 @@ export class EmbeddedFilesLoader {
       case "Cascadia":
         fontDef = CASCADIA_FONT;
         break;
+      case "Assistant": 
+        fontDef = ASSISTANT_FONT;
+        break;
       case "":
         fontDef = "";
         break;
@@ -599,7 +846,7 @@ export class EmbeddedFilesLoader {
       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 embeddedFile = await this._getObsidianImage(ef,1);
       const img = createEl("img");
       if(width) img.setAttribute("width", width);
       if(height) img.setAttribute("height", height);
@@ -695,12 +942,12 @@ export class EmbeddedFilesLoader {
   };
 }
 
-const getSVGData = async (app: App, file: TFile): Promise<DataURL> => {
-  const svg = await app.vault.read(file);
+const getSVGData = async (app: App, file: TFile, colorMap: ColorMap | null): Promise<DataURL> => {
+  const svg = replaceSVGColors(await app.vault.read(file), colorMap) as string;
   return svgToBase64(svg) as DataURL;
 };
 
-const generateIdFromFile = async (file: ArrayBuffer): Promise<FileId> => {
+export const generateIdFromFile = async (file: ArrayBuffer): Promise<FileId> => {
   let id: FileId;
   try {
     const hashBuffer = await window.crypto.subtle.digest("SHA-1", file);

src/ExcalidrawData.ts

@@ -5,7 +5,7 @@
     originalText: this is the text without added linebreaks for wrapping. This will be parsed or markup depending on view mode
     rawText: text with original markdown markup and without the added linebreaks for wrapping
  */
-import { App, TFile } from "obsidian";
+import { App, Notice, TFile } from "obsidian";
 import {
   nanoid,
   FRONTMATTER_KEY_CUSTOM_PREFIX,
@@ -13,17 +13,26 @@ import {
   FRONTMATTER_KEY_CUSTOM_URL_PREFIX,
   FRONTMATTER_KEY_DEFAULT_MODE,
   fileid,
-  REG_BLOCK_REF_CLEAN,
   FRONTMATTER_KEY_LINKBUTTON_OPACITY,
   FRONTMATTER_KEY_ONLOAD_SCRIPT,
   FRONTMATTER_KEY_AUTOEXPORT,
-} from "./Constants";
+  FRONTMATTER_KEY_EMBEDDABLE_THEME,
+  DEVICE,
+  EMBEDDABLE_THEME_FRONTMATTER_VALUES,
+  getBoundTextMaxWidth,
+  getDefaultLineHeight,
+  getFontString,
+  wrapText,
+  ERROR_IFRAME_CONVERSION_CANCELED,
+  JSON_parse,
+} from "./constants";
 import { _measureText } from "./ExcalidrawAutomate";
 import ExcalidrawPlugin from "./main";
-import { JSON_parse } from "./Constants";
 import { TextMode } from "./ExcalidrawView";
 import {
+  addAppendUpdateCustomData,
   compress,
+  debug,
   decompress,
   //getBakPath,
   getBinaryFileFromDataURL,
@@ -31,17 +40,20 @@ import {
   getExportTheme,
   getLinkParts,
   hasExportTheme,
+  isVersionNewerThanOther,
   LinkParts,
   wrapTextAtCharLength,
 } from "./utils/Utils";
-import { getAttachmentsFolderAndFilePath, isObsidianThemeDark } from "./utils/ObsidianUtils";
+import { cleanBlockRef, cleanSectionHeading, getAttachmentsFolderAndFilePath, isObsidianThemeDark } from "./utils/ObsidianUtils";
 import {
   ExcalidrawElement,
   ExcalidrawImageElement,
   FileId,
 } from "@zsviczian/excalidraw/types/element/types";
-import { BinaryFiles, SceneData } from "@zsviczian/excalidraw/types/types";
-import { EmbeddedFile } from "./EmbeddedFileLoader";
+import { BinaryFiles, DataURL, SceneData } from "@zsviczian/excalidraw/types/types";
+import { EmbeddedFile, MimeType } from "./EmbeddedFileLoader";
+import { ConfirmationPrompt } from "./dialogs/Prompt";
+import { getMermaidImageElements, getMermaidText, shouldRenderMermaid } from "./utils/MermaidUtils";
 
 type SceneDataWithFiles = SceneData & { files: BinaryFiles };
 
@@ -53,13 +65,6 @@ declare module "obsidian" {
   }
 }
 
-const {
-  wrapText, 
-  getFontString, 
-  getMaxContainerWidth, 
-  //@ts-ignore
-} = excalidrawLib;
-
 export enum AutoexportPreference {
   none,
   both,
@@ -72,6 +77,15 @@ export const REGEX_LINK = {
   //![[link|alias]] [alias](link){num}
   //      1   2    3           4             5         67         8  9
   EXPR: /(!)?(\[\[([^|\]]+)\|?([^\]]+)?]]|\[([^\]]*)]\(([^)]*)\))(\{(\d+)\})?/g, //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/187
+  getResList: (text: string): IteratorResult<RegExpMatchArray, any>[] => {
+    const res = text.matchAll(REGEX_LINK.EXPR);
+    let parts: IteratorResult<RegExpMatchArray, any>;
+    const resultList = [];
+    while(!(parts = res.next()).done) {
+      resultList.push(parts);
+    }
+    return resultList;
+  },
   getRes: (text: string): IterableIterator<RegExpMatchArray> => {
     return text.matchAll(REGEX_LINK.EXPR);
   },
@@ -241,12 +255,14 @@ export class ExcalidrawData {
   private app: App;
   private showLinkBrackets: boolean;
   private linkPrefix: string;
+  public embeddableTheme: "light" | "dark" | "auto" | "default" = "auto";
   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
+  public files: Map<FileId, EmbeddedFile> = null; //fileId, path
   private equations: Map<FileId, { latex: string; isLoaded: boolean }> = null; //fileId, path
+  private mermaids: Map<FileId, { mermaid: string; isLoaded: boolean }> = null; //fileId, path
   private compatibilityMode: boolean = false;
   selectedElementIds: {[key:string]:boolean} = {}; //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/609
 
@@ -256,6 +272,7 @@ export class ExcalidrawData {
     this.app = plugin.app;
     this.files = new Map<FileId, EmbeddedFile>();
     this.equations = new Map<FileId, { latex: string; isLoaded: boolean }>();
+    this.mermaids = new Map<FileId, { mermaid: string; isLoaded: boolean }>();
   }
 
   /**
@@ -266,12 +283,28 @@ export class ExcalidrawData {
       return;
     }
 
+    const saveVersion = this.scene.source.split("https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/")[1]??"1.8.16";
+
     const elements = this.scene.elements;
     for (const el of elements) {
+      if(el.type === "iframe") {
+        el.type = "embeddable";
+      }
+
       if (el.boundElements) {
         const map = new Map<string, string>();
+        let alreadyHasText:boolean = false;
         el.boundElements.forEach((item: { id: string; type: string }) => {
-          map.set(item.id, item.type);
+          if(item.type === "text") {
+            if(!alreadyHasText) {
+              map.set(item.id, item.type);
+              alreadyHasText = true;
+            } else {
+              elements.find((el:ExcalidrawElement)=>el.id===item.id).containerId = null;
+            }
+          } else {
+            map.set(item.id, item.type);
+          }
         });
         const boundElements = Array.from(map, ([id, type]) => ({ id, type }));
         if (boundElements.length !== el.boundElements.length) {
@@ -356,12 +389,18 @@ export class ExcalidrawData {
         } catch (e) {}
       });
 
+      const ellipseAndRhombusContainerWrapping = !isVersionNewerThanOther(saveVersion,"1.8.16");
+
       //Remove from bound elements references that do not exist in the scene
       const containers = elements.filter(
         (container: any) =>
           container.boundElements && container.boundElements.length > 0,
       );
       containers.forEach((container: any) => {
+        if(ellipseAndRhombusContainerWrapping && !container.customData?.legacyTextWrap) {
+          addAppendUpdateCustomData(container, {legacyTextWrap: true});
+          //container.customData = {...container.customData, legacyTextWrap: true};
+        }
         const filteredBoundElements = container.boundElements.filter(
           (boundEl: any) => elements.some((el: any) => el.id === boundEl.id),
         );
@@ -408,9 +447,10 @@ export class ExcalidrawData {
     >();
     this.elementLinks = new Map<string, string>();
     if (this.file != file) {
-      //this is a reload - files and equations will take care of reloading when needed
+      //this is a reload - files, equations and mermaids will take care of reloading when needed
       this.files.clear();
       this.equations.clear();
+      this.mermaids.clear();
     }
     this.file = file;
     this.compatibilityMode = false;
@@ -421,6 +461,7 @@ export class ExcalidrawData {
     this.setLinkPrefix();
     this.setUrlPrefix();
     this.setAutoexportPreferences();
+    this.setembeddableThemePreference();
 
     this.scene = null;
 
@@ -473,6 +514,25 @@ export class ExcalidrawData {
       this.scene.appState.theme = isObsidianThemeDark() ? "dark" : "light";
     }
 
+    //once off migration of legacy scenes
+    if(this.scene?.elements?.some((el:any)=>el.type==="iframe")) {
+        const prompt = new ConfirmationPrompt(
+          this.plugin,
+          "This file contains embedded frames " +
+          "which will be migrated to a newer version for compatibility with " +
+          "<a href='https://excalidraw.com'>excalidraw.com</a>.<br>🔄 If you're using Obsidian on " + 
+          "multiple devices, you may proceed now, but please, before opening this " +
+          "file on your other devices, update Excalidraw on those as well.<br>🔍 More info is available "+
+          "<a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/1.9.9'>here</a>.<br>🌐 " +
+          "<a href='https://translate.google.com/?sl=en&tl=zh-CN&text=This%20file%20contains%20embedded%20frames%20which%20will%20be%20migrated%20to%20a%20newer%20version%20for%20compatibility%20with%20excalidraw.com.%0A%0AIf%20you%27re%20using%20Obsidian%20on%20multiple%20devices%2C%20you%20may%20proceed%20now%2C%20but%20please%2C%20before%20opening%20this%20file%20on%20your%20other%20devices%2C%20update%20Excalidraw%20on%20those%20as%20well.%0A%0AMore%20info%20is%20available%20here%3A%20https%3A%2F%2Fgithub.com%2Fzsviczian%2Fobsidian-excalidraw-plugin%2Freleases%2Ftag%2F1.9.9%27%3Ehere%3C%2Fa%3E.&op=translate'>" +
+          "Translate</a>.",
+        );
+        prompt.contentEl.focus();
+        const confirmation = await prompt.waitForClose
+        if(!confirmation) {
+          throw new Error(ERROR_IFRAME_CONVERSION_CANCELED);
+        }
+    }
     this.initializeNonInitializedFields();
 
     data = data.substring(0, sceneJSONandPOS.pos);
@@ -528,9 +588,6 @@ export class ExcalidrawData {
           if (parseRes.link) {
             textEl.link = parseRes.link;
           }
-          if(!parseRes.link && elementLink.done) {
-            textEl.link = null;
-          }          
           //this will set the rawText field of text elements imported from files before 1.3.14, and from other instances of Excalidraw
           if (textEl && (!textEl.rawText || textEl.rawText === "")) {
             textEl.rawText = text;
@@ -544,19 +601,20 @@ export class ExcalidrawData {
       data.indexOf("# Embedded files\n") + "# Embedded files\n".length,
     );
     //Load Embedded files
-    const REG_FILEID_FILEPATH = /([\w\d]*):\s*\[\[([^\]]*)]]\n/gm;
+    const REG_FILEID_FILEPATH = /([\w\d]*):\s*\[\[([^\]]*)]]\s?(\{[^}]*})?\n/gm;
     res = data.matchAll(REG_FILEID_FILEPATH);
     while (!(parts = res.next()).done) {
       const embeddedFile = new EmbeddedFile(
         this.plugin,
         this.file.path,
         parts.value[2],
+        parts.value[3],
       );
       this.setFile(parts.value[1] as FileId, embeddedFile);
     }
 
     //Load links
-    const REG_LINKID_FILEPATH = /([\w\d]*):\s*(https?:\/\/[^\s]*)\n/gm;
+    const REG_LINKID_FILEPATH = /([\w\d]*):\s*((?:https?|file|ftps?):\/\/[^\s]*)\n/gm;
     res = data.matchAll(REG_LINKID_FILEPATH);
     while (!(parts = res.next()).done) {
       const embeddedFile = new EmbeddedFile(
@@ -568,7 +626,7 @@ export class ExcalidrawData {
     }
 
     //Load Equations
-    const REG_FILEID_EQUATION = /([\w\d]*):\s*\$\$(.*)(\$\$\s*\n)/gm;
+    const REG_FILEID_EQUATION = /([\w\d]*):\s*\$\$([\s\S]*?)(\$\$\s*\n)/gm;
     res = data.matchAll(REG_FILEID_EQUATION);
     while (!(parts = res.next()).done) {
       this.setEquation(parts.value[1] as FileId, {
@@ -577,6 +635,16 @@ export class ExcalidrawData {
       });
     }
 
+    //Load Mermaids
+    const mermaidElements = getMermaidImageElements(this.scene.elements);
+    if(mermaidElements.length>0 && !shouldRenderMermaid()) {
+      new Notice ("Mermaid images are only supported in Obsidian 1.4.14 and above. Please update Obsidian to see the mermaid images in this drawing. Obsidian mobile 1.4.14 currently only avaiable to Obsidian insiders", 5000);
+    } else {
+      mermaidElements.forEach(el => 
+        this.setMermaid(el.fileId, {mermaid: getMermaidText(el), isLoaded: false})
+      );
+    }
+
     //Check to see if there are text elements in the JSON that were missed from the # Text Elements section
     //e.g. if the entire text elements section was deleted.
     this.findNewTextElementsInScene();
@@ -602,6 +670,7 @@ export class ExcalidrawData {
     this.setShowLinkBrackets();
     this.setLinkPrefix();
     this.setUrlPrefix();
+    this.setembeddableThemePreference();
     this.scene = JSON.parse(data);
     if (!this.scene.files) {
       this.scene.files = {}; //loading legacy scenes without the files element
@@ -612,6 +681,7 @@ export class ExcalidrawData {
     }
     this.files.clear();
     this.equations.clear();
+    this.mermaids.clear();
     this.findNewTextElementsInScene();
     this.findNewElementLinksInScene();
     await this.setTextMode(TextMode.raw, true); //legacy files are always displayed in raw mode.
@@ -638,6 +708,7 @@ export class ExcalidrawData {
         newText,
         sceneTextElement.fontSize,
         sceneTextElement.fontFamily,
+        sceneTextElement.lineHeight??getDefaultLineHeight(sceneTextElement.fontFamily),
       );
       sceneTextElement.text = newText;
       sceneTextElement.originalText = newOriginalText;
@@ -668,17 +739,21 @@ export class ExcalidrawData {
       const originalText =
         (await this.getText(te.id)) ?? te.originalText ?? te.text;
       const wrapAt = this.textElements.get(te.id)?.wrapAt;
-      this.updateTextElement(
-        te,
-        wrapAt ? wrapText(
+      try { //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1062
+        this.updateTextElement(
+          te,
+          wrapAt ? wrapText(
+            originalText,
+            getFontString({fontSize: te.fontSize, fontFamily: te.fontFamily}),
+            getBoundTextMaxWidth(container as any)
+          ) : originalText,
           originalText,
-          getFontString({fontSize: te.fontSize, fontFamily: te.fontFamily}),
-          getMaxContainerWidth(container)
-        ) : originalText,
-        originalText,
-        forceupdate,
-        container?.type,
-      ); //(await this.getText(te.id))??te.text serves the case when the whole #Text Elements section is deleted by accident
+          forceupdate,
+          container?.type,
+        ); //(await this.getText(te.id))??te.text serves the case when the whole #Text Elements section is deleted by accident
+      } catch(e) {
+        debug({where: "ExcalidrawData.updateSceneTextElements", fn: this.updateSceneTextElements, textElement: te});
+      }
     }
   }
 
@@ -934,8 +1009,9 @@ export class ExcalidrawData {
         if (parsedLink) {
           outString += parsedLink;
           if (!(urlIcon || linkIcon)) {
-            if (REGEX_LINK.getLink(parts).match(REG_LINKINDEX_HYPERLINK)) {
-              urlIcon = true;
+            const linkText = REGEX_LINK.getLink(parts);
+            if (linkText.match(REG_LINKINDEX_HYPERLINK)) {
+              urlIcon = !linkText.startsWith("cmd://"); //don't display the url icon for cmd:// links
             } else {
               linkIcon = true;
             }
@@ -1011,8 +1087,9 @@ export class ExcalidrawData {
       if (parsedLink) {
         outString += parsedLink;
         if (!(urlIcon || linkIcon)) {
-          if (REGEX_LINK.getLink(parts).match(REG_LINKINDEX_HYPERLINK)) {
-            urlIcon = true;
+          const linkText = REGEX_LINK.getLink(parts);
+          if (linkText.match(REG_LINKINDEX_HYPERLINK)) {
+            urlIcon = !linkText.startsWith("cmd://"); //don't display the url icon for cmd:// links
           } else {
             linkIcon = true;
           }
@@ -1053,6 +1130,7 @@ export class ExcalidrawData {
       outString += `${this.elementLinks.get(key)} ^${key}\n\n`;
     }
 
+    // deliberately not adding mermaids to here. It is enough to have the mermaidText in the image element's customData
     outString +=
       this.equations.size > 0 || this.files.size > 0
         ? "\n# Embedded files\n"
@@ -1066,14 +1144,15 @@ export class ExcalidrawData {
       for (const key of this.files.keys()) {
         const PATHREG = /(^[^#\|]*)/;
         const ef = this.files.get(key);
-        if(ef.isHyperlink) {
+        if(ef.isHyperLink || ef.isLocalLink) {
           outString += `${key}: ${ef.hyperlink}\n`;
         } else {
           //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/829
           const path = ef.file
-            ? ef.linkParts.original.replace(PATHREG,app.metadataCache.fileToLinktext(ef.file,this.file.path))
+            ? ef.linkParts.original.replace(PATHREG,this.app.metadataCache.fileToLinktext(ef.file,this.file.path))
             : ef.linkParts.original;
-          outString += `${key}: [[${path}]]\n`;
+          const colorMap = ef.colorMap ? " " + JSON.stringify(ef.colorMap) : "";
+          outString += `${key}: [[${path}]]${colorMap}\n`;
         }
       }
     }
@@ -1096,6 +1175,57 @@ export class ExcalidrawData {
     );
   }
 
+  public async saveDataURLtoVault(dataURL: DataURL, mimeType: MimeType, key: FileId) {
+    const scene = this.scene as SceneDataWithFiles;
+    let fname = `Pasted Image ${window
+      .moment()
+      .format("YYYYMMDDHHmmss_SSS")}`;
+  
+    switch (mimeType) {
+      case "image/png":
+        fname += ".png";
+        break;
+      case "image/jpeg":
+        fname += ".jpg";
+        break;
+      case "image/svg+xml":
+        fname += ".svg";
+        break;
+      case "image/gif":
+        fname += ".gif";
+        break;
+      default:
+        fname += ".png";
+    }
+    const filepath = (
+      await getAttachmentsFolderAndFilePath(this.app, this.file.path, fname)
+    ).filepath;
+
+    const arrayBuffer = await getBinaryFileFromDataURL(dataURL);
+    if(!arrayBuffer) return null;
+
+    const file = await this.app.vault.createBinary(
+      filepath,
+      arrayBuffer,
+    );
+
+    const embeddedFile = new EmbeddedFile(
+      this.plugin,
+      this.file.path,
+      filepath,
+    );
+    
+    embeddedFile.setImage(
+      dataURL,
+      mimeType,
+      { height: 0, width: 0 },
+      scene.appState?.theme === "dark",
+      mimeType === "image/svg+xml", //this treat all SVGs as if they had embedded images REF:addIMAGE
+    );
+    this.setFile(key as FileId, embeddedFile);
+    return file;
+  }
+
   /**
    * deletes fileIds from Excalidraw data for files no longer in the scene
    * @returns
@@ -1124,6 +1254,13 @@ export class ExcalidrawData {
       }
     });
 
+    this.mermaids.forEach((value, key) => {
+      if (!fileIds.contains(key)) {
+        this.mermaids.delete(key);
+        dirty = true;
+      }
+    });
+
     //check if there are any images that need to be processed in the new scene
     if (!scene.files || Object.keys(scene.files).length === 0) {
       return false;
@@ -1137,25 +1274,29 @@ export class ExcalidrawData {
     fileIds.forEach(fileId=>{
       if(processedIds.has(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.isHyperlink || (file.file && (file.file.extension !== "md" || this.plugin.isExcalidrawFile(file.file))))) {
+        const mermaid = this.getMermaid(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.isHyperLink || file.isLocalLink || (file.file && (file.file.extension !== "md" || this.plugin.isExcalidrawFile(file.file))))) {
+          return;
+        }
+        if(mermaid) {
           return;
         }
         const newId = fileid();
-        //scene.files[newId] = {...scene.files[fileId]};
-        (scene.elements.filter((el:ExcalidrawImageElement)=>el.fileId === fileId)[0] as any).fileId = newId;
+        (scene
+          .elements
+          .filter((el:ExcalidrawImageElement)=>el.fileId === fileId)
+          .sort((a,b)=>a.updated<b.updated ? 1 : -1)[0] as any)
+          .fileId = newId;
         dirty = true;
         processedIds.add(newId);
         if(file) {
           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.setEquation(newId as FileId, {latex:equation.latex, isLoaded:false});
-          //this.equations.set(newId as FileId, equation);
         }
       }
       processedIds.add(fileId);
@@ -1163,81 +1304,17 @@ export class ExcalidrawData {
 
 
     for (const key of Object.keys(scene.files)) {
-      if (!(this.hasFile(key as FileId) || this.hasEquation(key as FileId))) {
+      const mermaidElements = getMermaidImageElements(scene.elements.filter((el:ExcalidrawImageElement)=>el.fileId === key));
+      if (!(this.hasFile(key as FileId) || this.hasEquation(key as FileId) || this.hasMermaid(key as FileId) || mermaidElements.length > 0)) {
         dirty = true;
-        let fname = `Pasted Image ${window
-          .moment()
-          .format("YYYYMMDDHHmmss_SSS")}`;
-        const mimeType = scene.files[key].mimeType;
-        switch (mimeType) {
-          case "image/png":
-            fname += ".png";
-            break;
-          case "image/jpeg":
-            fname += ".jpg";
-            break;
-          case "image/svg+xml":
-            fname += ".svg";
-            break;
-          case "image/gif":
-            fname += ".gif";
-            break;
-          default:
-            fname += ".png";
-        }
-        const filepath = (
-          await getAttachmentsFolderAndFilePath(this.app, this.file.path, fname)
-        ).filepath;
-        const dataURL = scene.files[key].dataURL;
-        await this.app.vault.createBinary(
-          filepath,
-          getBinaryFileFromDataURL(dataURL),
+        await this.saveDataURLtoVault(
+          scene.files[key].dataURL,
+          scene.files[key].mimeType,
+          key as FileId
         );
-        const embeddedFile = new EmbeddedFile(
-          this.plugin,
-          this.file.path,
-          filepath,
-        );
-        embeddedFile.setImage(
-          dataURL,
-          mimeType,
-          { height: 0, width: 0 },
-          scene.appState?.theme === "dark",
-          mimeType === "image/svg+xml", //this treat all SVGs as if they had embedded images REF:addIMAGE
-        );
-        this.setFile(key as FileId, embeddedFile);
       }
     }
 
-    //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/297
-    /*const equations = new Set<string>();
-    const duplicateEqs = new Set<string>();
-    for (const key of fileIds) {
-      if (this.hasEquation(key as FileId)) {
-        if (equations.has(key)) {
-          duplicateEqs.add(key);
-        } else {
-          equations.add(key);
-        }
-      }
-    }
-    if (duplicateEqs.size > 0) {
-      for (const key of duplicateEqs.keys()) {
-        const elements = this.scene.elements.filter(
-          (el: ExcalidrawElement) => el.type === "image" && el.fileId === key,
-        );
-        for (let i = 1; i < elements.length; i++) {
-          const newFileId = fileid() as FileId;
-          this.setEquation(newFileId, {
-            latex: this.getEquation(key as FileId).latex,
-            isLoaded: false,
-          });
-          elements[i].fileId = newFileId;
-          dirty = true;
-        }
-      }
-    }*/
-
     return dirty;
   }
 
@@ -1267,6 +1344,7 @@ export class ExcalidrawData {
       this.setLinkPrefix() ||
       this.setUrlPrefix() ||
       this.setShowLinkBrackets() ||
+      this.setembeddableThemePreference() ||
       this.findNewElementLinksInScene();
     await this.updateTextElementsFromScene();
     if (result || this.findNewTextElementsInScene()) {
@@ -1280,7 +1358,12 @@ export class ExcalidrawData {
     return this.textElements.get(id)?.raw;
   }
 
-  public getParsedText(id: string): [string, string, string] {
+  /**
+   * returns parsed text with the correct line length
+   * @param id 
+   * @returns 
+   */
+  public getParsedText(id: string): [parseResultWrapped: string, parseResultOriginal: string, link: string] {
     const t = this.textElements.get(id);
     if (!t) {
       return [null, null, null];
@@ -1288,12 +1371,28 @@ export class ExcalidrawData {
     return [wrap(t.parsed, t.wrapAt), t.parsed, null];
   }
 
+  /**
+   * Attempts to quickparse (sycnhronously) the raw text.
+   * 
+   * If successful: 
+   *   - it will set the textElements cache with the parsed result, and
+   *   - return the parsed result as an array of 3 values: [parsedTextWrapped, parsedText, link]
+   * 
+   * If the text contains a transclusion:
+   *   - it will initiate the async parse, and
+   *   - it will return [null,null,null].
+   * @param elementID 
+   * @param rawText 
+   * @param rawOriginalText 
+   * @param updateSceneCallback 
+   * @returns [parseResultWrapped: string, parseResultOriginal: string, link: string]
+   */
   public setTextElement(
     elementID: string,
     rawText: string,
     rawOriginalText: string,
-    updateScene: Function,
-  ): [string, string, string] {
+    updateSceneCallback: Function,
+  ): [parseResultWrapped: string, parseResultOriginal: string, link: string] {
     const maxLineLen = estimateMaxLineLen(rawText, rawOriginalText);
     const [parseResult, link] = this.quickParse(rawOriginalText); //will return the parsed result if raw text does not include transclusion
     if (parseResult) {
@@ -1314,7 +1413,7 @@ export class ExcalidrawData {
         wrapAt: maxLineLen,
       });
       if (parsedText) {
-        updateScene(wrap(parsedText, maxLineLen), parsedText);
+        updateSceneCallback(wrap(parsedText, maxLineLen), parsedText);
       }
     });
     return [null, null, null];
@@ -1349,7 +1448,7 @@ export class ExcalidrawData {
   public getOpenMode(): { viewModeEnabled: boolean; zenModeEnabled: boolean } {
     const fileCache = this.app.metadataCache.getFileCache(this.file);
     let mode = this.plugin.settings.defaultMode === "view-mobile"
-      ? (this.plugin.device.isPhone ? "view" : "normal")
+      ? (DEVICE.isPhone ? "view" : "normal")
       : this.plugin.settings.defaultMode;
     if (
       fileCache?.frontmatter &&
@@ -1437,6 +1536,23 @@ export class ExcalidrawData {
     }
   }
 
+  private setembeddableThemePreference(): boolean {
+    const embeddableTheme = this.embeddableTheme;
+    const fileCache = this.app.metadataCache.getFileCache(this.file);
+    if (
+      fileCache?.frontmatter &&
+      fileCache.frontmatter[FRONTMATTER_KEY_EMBEDDABLE_THEME] != null
+    ) {
+      this.embeddableTheme = fileCache.frontmatter[FRONTMATTER_KEY_EMBEDDABLE_THEME].toLowerCase();
+      if (!EMBEDDABLE_THEME_FRONTMATTER_VALUES.includes(this.embeddableTheme)) {
+        this.embeddableTheme = "default";
+      }
+    } else {
+      this.embeddableTheme = this.plugin.settings.iframeMatchExcalidrawTheme ? "auto" : "default";
+    }
+    return embeddableTheme != this.embeddableTheme;
+  }
+
   private setShowLinkBrackets(): boolean {
     const showLinkBrackets = this.showLinkBrackets;
     const fileCache = this.app.metadataCache.getFileCache(this.file);
@@ -1453,7 +1569,7 @@ export class ExcalidrawData {
   }
 
   /** 
-   Files and equations copy/paste support
+   Files, equations and mermaid copy/paste support
    This is not a complete solution, it assumes the source document is opened first
    at that time the fileId is stored in the master files/equations map
    when pasted the map is checked if the file already exists
@@ -1468,9 +1584,10 @@ export class ExcalidrawData {
     }
     this.files.set(fileId, data);
 
-    if(data.isHyperlink) {
+    if(data.isHyperLink || data.isLocalLink) {
       this.plugin.filesMaster.set(fileId, {
-        isHyperlink: true,
+        isHyperLink: data.isHyperLink,
+        isLocalLink: data.isLocalLink,
         path: data.hyperlink,
         blockrefData: null,
         hasSVGwithBitmap: data.isSVGwithBitmap
@@ -1484,12 +1601,14 @@ export class ExcalidrawData {
 
     const parts = data.linkParts.original.split("#");
     this.plugin.filesMaster.set(fileId, {
-      isHyperlink: false,
+      isHyperLink: false,
+      isLocalLink: false,
       path:data.file.path + (data.shouldScale()?"":"|100%"),
       blockrefData: parts.length === 1
         ? null
         : parts[1],
       hasSVGwithBitmap: data.isSVGwithBitmap,
+      colorMapJSON: data.colorMap ? JSON.stringify(data.colorMap) : null,
     });
   }
 
@@ -1530,7 +1649,7 @@ export class ExcalidrawData {
     }
     if (this.plugin.filesMaster.has(fileId)) {
       const masterFile = this.plugin.filesMaster.get(fileId);
-      if(masterFile.isHyperlink) {
+      if(masterFile.isHyperLink || masterFile.isLocalLink) {
         this.files.set(
           fileId,
           new EmbeddedFile(this.plugin,this.file.path,masterFile.path)
@@ -1548,7 +1667,8 @@ export class ExcalidrawData {
         this.file.path,
         (masterFile.blockrefData
           ? path + "#" + masterFile.blockrefData
-          : path) + (fixScale?"|100%":"")
+          : path) + (fixScale?"|100%":""),
+        masterFile.colorMapJSON
       );
       this.files.set(fileId, embeddedFile);
       return true;
@@ -1556,6 +1676,9 @@ export class ExcalidrawData {
     return false;
   }
 
+  //--------------
+  //Equations
+  //--------------
   public setEquation(
     fileId: FileId,
     data: { latex: string; isLoaded: boolean },
@@ -1597,6 +1720,51 @@ export class ExcalidrawData {
     }
     return false;
   }
+
+  //--------------
+  //Mermaids
+  //--------------
+  public setMermaid(
+    fileId: FileId,
+    data: { mermaid: string; isLoaded: boolean },
+  ) {
+    this.mermaids.set(fileId, { mermaid: data.mermaid, isLoaded: data.isLoaded });
+    this.plugin.mermaidsMaster.set(fileId, data.mermaid);
+  }
+
+  public getMermaid(fileId: FileId): { mermaid: string; isLoaded: boolean } {
+    let result = this.mermaids.get(fileId);
+    if(result) return result;
+    const mermaid = this.plugin.mermaidsMaster.get(fileId);
+    if(!mermaid) return result;
+    this.mermaids.set(fileId, {mermaid, isLoaded: false});
+    return {mermaid, isLoaded: false};
+  }
+
+  public getMermaidEntries() {
+    return this.mermaids.entries();
+  }
+
+  public deleteMermaid(fileId: FileId) {
+    this.mermaids.delete(fileId);
+    //deliberately not deleting from plugin.mermaidsMaster
+    //could be present in other drawings as well
+  }
+
+  //Image copy/paste support
+  public hasMermaid(fileId: FileId): boolean {
+    if (this.mermaids.has(fileId)) {
+      return true;
+    }
+    if (this.plugin.mermaidsMaster.has(fileId)) {
+      this.mermaids.set(fileId, {
+        mermaid: this.plugin.mermaidsMaster.get(fileId),
+        isLoaded: false,
+      });
+      return true;
+    }
+    return false;
+  }
 }
 
 export const getTransclusion = async (
@@ -1611,18 +1779,19 @@ export const getTransclusion = async (
   if (!linkParts.path) {
     return { contents: linkParts.original.trim(), lineNum: 0 };
   } //filename not found
+
   if (!file || !(file instanceof TFile)) {
     return { contents: linkParts.original.trim(), lineNum: 0 };
   }
+
   const contents = await app.vault.read(file);
+
   if (!linkParts.ref) {
     //no blockreference
     return charCountLimit
       ? { contents: contents.substring(0, charCountLimit).trim(), lineNum: 0 }
       : { contents: contents.trim(), lineNum: 0 };
   }
-  //const isParagraphRef = parts.value[2] ? true : false; //does the reference contain a ^ character?
-  //const id = parts.value[3]; //the block ID or heading text
 
   const blocks = (
     await app.metadataCache.blockCache.getForFile(
@@ -1633,6 +1802,7 @@ export const getTransclusion = async (
   if (!blocks) {
     return { contents: linkParts.original.trim(), lineNum: 0 };
   }
+
   if (linkParts.isBlockRef) {
     let para = blocks.filter((block: any) => block.node.id == linkParts.ref)[0]
       ?.node;
@@ -1651,6 +1821,7 @@ export const getTransclusion = async (
       lineNum,
     };
   }
+
   const headings = blocks.filter(
     (block: any) => block.display.search(/^#+\s/) === 0,
   ); // startsWith("#"));
@@ -1682,12 +1853,19 @@ export const getTransclusion = async (
     //const refNoSpace = linkParts.ref.replaceAll(" ","");
     if (
       !startPos &&
-      (c?.value?.replaceAll(REG_BLOCK_REF_CLEAN, "") === linkParts.ref ||
-        c?.title?.replaceAll(REG_BLOCK_REF_CLEAN, "") === linkParts.ref ||
-        dataHeading?.replaceAll(REG_BLOCK_REF_CLEAN, "") === linkParts.ref ||
+      ((cleanBlockRef(c?.value) === linkParts.ref ||
+        cleanBlockRef(c?.title) === linkParts.ref ||
+        cleanBlockRef(dataHeading) === linkParts.ref ||
         (cc
-          ? cc[0]?.value?.replaceAll(REG_BLOCK_REF_CLEAN, "") === linkParts.ref
-          : false))
+          ? cleanBlockRef(cc[0]?.value) === linkParts.ref
+          : false)) || 
+        (cleanSectionHeading(c?.value) === linkParts.ref ||
+         cleanSectionHeading(c?.title) === linkParts.ref ||
+         cleanSectionHeading(dataHeading) === linkParts.ref ||
+          (cc
+            ? cleanSectionHeading(cc[0]?.value) === linkParts.ref
+            : false))
+        )
     ) {
       startPos = headings[i].node.children[0]?.position.start.offset; //
       depth = headings[i].node.depth;

src/ExcalidrawLib.d.ts

@@ -0,0 +1,138 @@
+import { RestoredDataState } from "@zsviczian/excalidraw/types/data/restore";
+import { ImportedDataState } from "@zsviczian/excalidraw/types/data/types";
+import { BoundingBox } from "@zsviczian/excalidraw/types/element/bounds";
+import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawFrameElement, ExcalidrawTextElement, FontFamilyValues, FontString, NonDeleted, NonDeletedExcalidrawElement, Theme } from "@zsviczian/excalidraw/types/element/types";
+import { AppState, BinaryFiles, ExportOpts, Point, Zoom } from "@zsviczian/excalidraw/types/types";
+import { Mutable } from "@zsviczian/excalidraw/types/utility-types";
+
+type EmbeddedLink =
+  | ({
+      aspectRatio: { w: number; h: number };
+      warning?: string;
+    } & (
+      | { type: "video" | "generic"; link: string }
+      | { type: "document"; srcdoc: (theme: Theme) => string }
+    ))
+  | null;
+
+declare namespace ExcalidrawLib {
+  type ElementUpdate<TElement extends ExcalidrawElement> = Omit<
+    Partial<TElement>,
+    "id" | "version" | "versionNonce"
+  >;
+
+  type ExportOpts = {
+    elements: readonly NonDeleted<ExcalidrawElement>[];
+    appState?: Partial<Omit<AppState, "offsetTop" | "offsetLeft">>;
+    files: BinaryFiles | null;
+    maxWidthOrHeight?: number;
+    getDimensions?: (
+      width: number,
+      height: number,
+    ) => { width: number; height: number; scale?: number };
+  };
+
+  function restore(
+    data: Pick<ImportedDataState, "appState" | "elements" | "files"> | null,
+    localAppState: Partial<AppState> | null | undefined,
+    localElements: readonly ExcalidrawElement[] | null | undefined,
+    elementsConfig?: { refreshDimensions?: boolean; repairBindings?: boolean },
+  ): RestoredDataState;
+
+  function exportToSvg(opts: Omit<ExportOpts, "getDimensions"> & {
+    elements: ExcalidrawElement[];
+    appState?: AppState;
+    files?: any;
+    exportPadding?: number;
+    exportingFrame: ExcalidrawFrameElement | null | undefined;
+    renderEmbeddables?: boolean;
+  }): Promise<SVGSVGElement>;
+
+  function sceneCoordsToViewportCoords(
+    sceneCoords: { sceneX: number; sceneY: number },
+    viewParams: {
+      zoom: Zoom;
+      offsetLeft: number;
+      offsetTop: number;
+      scrollX: number;
+      scrollY: number;
+    },
+  ): { x: number; y: number };
+
+  function viewportCoordsToSceneCoords(
+    viewportCoords: { clientX: number; clientY: number },
+    viewParams: {
+      zoom: Zoom;
+      offsetLeft: number;
+      offsetTop: number;
+      scrollX: number;
+      scrollY: number;
+    },
+  ): { x: number; y: number };
+
+  function determineFocusDistance(
+    element: ExcalidrawBindableElement,
+    a: Point,
+    b: Point,
+  ): number;
+
+  function intersectElementWithLine(
+    element: ExcalidrawBindableElement,
+    a: Point,
+    b: Point,
+    gap?: number,
+  ): Point[];
+
+  function getCommonBoundingBox(
+    elements: ExcalidrawElement[] | readonly NonDeleted<ExcalidrawElement>[],
+  ): BoundingBox;
+
+  function getMaximumGroups(
+    elements: ExcalidrawElement[],
+  ): ExcalidrawElement[][];
+
+  function measureText(
+    text: string,
+    font: FontString,
+    lineHeight: number,
+  ): { width: number; height: number; baseline: number };
+
+  function getDefaultLineHeight(fontFamily: FontFamilyValues): number;
+
+  function wrapText(text: string, font: FontString, maxWidth: number): string;
+
+  function getFontString({
+    fontSize,
+    fontFamily,
+  }: {
+    fontSize: number;
+    fontFamily: FontFamilyValues;
+  }): FontString;
+
+  function getBoundTextMaxWidth(container: ExcalidrawElement): number;
+
+  function exportToBlob(
+    opts: ExportOpts & {
+      mimeType?: string;
+      quality?: number;
+      exportPadding?: number;
+    },
+  ): Promise<Blob>;
+
+  function mutateElement<TElement extends Mutable<ExcalidrawElement>>(
+    element: TElement,
+    updates: ElementUpdate<TElement>,
+    informMutation?: boolean,
+  ): TElement;  
+
+  function getEmbedLink (link: string | null | undefined): EmbeddedLink;
+
+  function mermaidToExcalidraw(
+    mermaidDefinition: string,
+    opts: {fontSize: number},
+    forceSVG?: boolean,
+  ): Promise<{
+    elements: ExcalidrawElement[],
+    files:any
+  } | undefined>;
+}

src/LaTeX.ts

@@ -4,7 +4,7 @@ import ExcalidrawPlugin from "./main";
 import { FileData, MimeType } from "./EmbeddedFileLoader";
 import { FileId } from "@zsviczian/excalidraw/types/element/types";
 import { errorlog, getImageSize, log, sleep, svgToBase64 } from "./utils/Utils";
-import { fileid } from "./Constants";
+import { fileid } from "./constants";
 import html2canvas from "html2canvas";
 import { Notice } from "obsidian";
 
@@ -95,6 +95,9 @@ export async function mathjaxSVG(
   const eq = plugin.mathjax.tex2svg(tex, { display: true, scale: 4 });
   const svg = eq.querySelector("svg");
   if (svg) {
+    if(svg.width.baseVal.valueInSpecifiedUnits < 2) {
+      svg.width.baseVal.valueAsString = `${(svg.width.baseVal.valueInSpecifiedUnits+1).toFixed(3)}ex`;
+    }
     const dataURL = svgToBase64(svg.outerHTML);
     return {
       mimeType: "image/svg+xml",

src/MarkdownPostProcessor.ts

@@ -4,7 +4,7 @@ import {
   TFile,
   Vault,
 } from "obsidian";
-import { CTRL_OR_CMD, RERENDER_EVENT } from "./Constants";
+import { RERENDER_EVENT } from "./constants";
 import { EmbeddedFilesLoader } from "./EmbeddedFileLoader";
 import { createPNG, createSVG } from "./ExcalidrawAutomate";
 import { ExportSettings } from "./ExcalidrawView";
@@ -18,16 +18,19 @@ import {
   getExportPadding,
   getWithBackground,
   hasExportTheme,
-  svgToBase64,
+  convertSVGStringToElement,
 } from "./utils/Utils";
-import { isObsidianThemeDark } from "./utils/ObsidianUtils";
+import { getParentOfClass, isObsidianThemeDark, getFileCSSClasses } from "./utils/ObsidianUtils";
+import { linkClickModifierType } from "./utils/ModifierkeyHelper";
+import { ImageKey, imageCache } from "./utils/ImageCache";
+import { FILENAMEPARTS, PreviewImageType } from "./utils/UtilTypes";
 
 interface imgElementAttributes {
   file?: TFile;
   fname: string; //Excalidraw filename
   fwidth: string; //Display width of image
   fheight: string; //Display height of image
-  style: string; //css style to apply to IMG element
+  style: string[]; //css style to apply to IMG element
 }
 
 let plugin: ExcalidrawPlugin;
@@ -48,15 +51,205 @@ export const initializeMarkdownPostProcessor = (p: ExcalidrawPlugin) => {
   metadataCache = p.app.metadataCache;
 };
 
+const _getPNG = async ({imgAttributes,filenameParts,theme,cacheReady,img,file,exportSettings,loader}:{
+  imgAttributes: imgElementAttributes,
+  filenameParts: FILENAMEPARTS,
+  theme: string,
+  cacheReady: boolean,
+  img: HTMLImageElement,
+  file: TFile,
+  exportSettings: ExportSettings,
+  loader: EmbeddedFilesLoader,
+}):Promise<HTMLImageElement> => {
+  const width = parseInt(imgAttributes.fwidth);
+    const scale = width >= 2400
+      ? 5
+      : width >= 1800
+        ? 4
+        : width >= 1200
+          ? 3
+          : width >= 600
+            ? 2
+            : 1;
+  
+  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.PNG, scale};
+
+  if(cacheReady) {      
+    const src = await imageCache.getImageFromCache(cacheKey);
+    //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
+    if(src && typeof src === "string") {
+      img.src = src;
+      return img;
+    }
+  }
+
+  const quickPNG = !(filenameParts.hasGroupref || filenameParts.hasFrameref)
+    ? await getQuickImagePreview(plugin, file.path, "png")
+    : undefined;
+
+  const png =
+    quickPNG ??
+    (await createPNG(
+      (filenameParts.hasGroupref || filenameParts.hasFrameref)
+        ? filenameParts.filepath + filenameParts.linkpartReference
+        : file.path,
+      scale,
+      exportSettings,
+      loader,
+      theme,
+      null,
+      null,
+      [],
+      plugin,
+      0
+    ));
+  if (!png) {
+    return null;
+  }
+  img.src = URL.createObjectURL(png);
+  cacheReady && imageCache.addImageToCache(cacheKey, img.src, png);
+  return img;
+}
+
+const setStyle = ({element,imgAttributes,onCanvas}:{
+  element: HTMLElement,
+  imgAttributes: imgElementAttributes,
+  onCanvas: boolean,
+}
+) => {
+  let style = `max-width:${imgAttributes.fwidth}${imgAttributes.fwidth.match(/\d$/) ? "px":""}; `; //width:100%;`; //removed !important https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/886
+  if (imgAttributes.fheight) {
+    style += `height:${imgAttributes.fheight}px;`;
+  }
+  if(!onCanvas) element.setAttribute("style", style);
+  element.classList.add(...Array.from(imgAttributes.style))
+  if(!element.hasClass("excalidraw-embedded-img")) {
+    element.addClass("excalidraw-embedded-img");
+  }
+  if(
+    window.ExcalidrawAutomate.plugin.settings.canvasImmersiveEmbed &&
+    !element.hasClass("excalidraw-canvas-immersive")
+  ) {
+    element.addClass("excalidraw-canvas-immersive");
+  }
+}
+
+const _getSVGIMG = async ({filenameParts,theme,cacheReady,img,file,exportSettings,loader}:{
+  filenameParts: FILENAMEPARTS,
+  theme: string,
+  cacheReady: boolean,
+  img: HTMLImageElement,
+  file: TFile,
+  exportSettings: ExportSettings,
+  loader: EmbeddedFilesLoader,
+}):Promise<HTMLImageElement> => {
+  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.SVGIMG, scale:1};
+  if(cacheReady) {
+    const src = await imageCache.getImageFromCache(cacheKey);
+    if(src && typeof src === "string") {
+      img.setAttribute("src", src);
+      return img;
+    }
+  }
+
+  if(!(filenameParts.hasBlockref || filenameParts.hasSectionref)) {
+    const quickSVG = await getQuickImagePreview(plugin, file.path, "svg");
+    if (quickSVG) {
+      const svg = convertSVGStringToElement(quickSVG);
+      if (svg) {
+        return addSVGToImgSrc(img, svg, cacheReady, cacheKey);
+      }
+    }
+  }
+  
+  let svg = convertSVGStringToElement((
+    await createSVG(
+      filenameParts.hasGroupref || filenameParts.hasBlockref || filenameParts.hasSectionref || filenameParts.hasFrameref
+        ? filenameParts.filepath + filenameParts.linkpartReference
+        : file.path,
+      true,
+      exportSettings,
+      loader,
+      theme,
+      null,
+      null,
+      [],
+      plugin,
+      0,
+      getExportPadding(plugin, file),
+    )
+  ).outerHTML);
+  
+  if (!svg) {
+    return null;
+  }
+
+  svg = embedFontsInSVG(svg, plugin, false);
+  //need to remove width and height attributes to support area= embeds
+  svg.removeAttribute("width");
+  svg.removeAttribute("height");
+  return addSVGToImgSrc(img, svg, cacheReady, cacheKey);
+}
+
+const _getSVGNative = async ({filenameParts,theme,cacheReady,containerElement,file,exportSettings,loader}:{
+  filenameParts: FILENAMEPARTS,
+  theme: string,
+  cacheReady: boolean,
+  containerElement: HTMLDivElement,
+  file: TFile,
+  exportSettings: ExportSettings,
+  loader: EmbeddedFilesLoader,
+}):Promise<HTMLDivElement> => {
+  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.SVG, scale:1};
+  let maybeSVG;
+  if(cacheReady) {
+    maybeSVG = await imageCache.getImageFromCache(cacheKey);
+  }
+
+  let svg = maybeSVG && (maybeSVG instanceof SVGSVGElement)
+    ? maybeSVG
+    : convertSVGStringToElement((await createSVG(
+      filenameParts.hasGroupref || filenameParts.hasBlockref || filenameParts.hasSectionref || filenameParts.hasFrameref
+        ? filenameParts.filepath + filenameParts.linkpartReference
+        : file.path,
+      false,
+      exportSettings,
+      loader,
+      theme,
+      null,
+      null,
+      [],
+      plugin,
+      0,
+      getExportPadding(plugin, file),
+      undefined,
+      true
+    )).outerHTML);
+  
+  if (!svg) {
+    return null;
+  }
+
+  svg = embedFontsInSVG(svg, plugin, true);
+  svg.removeAttribute("width");
+  svg.removeAttribute("height");
+  containerElement.append(svg);
+  cacheReady && imageCache.addImageToCache(cacheKey,"", svg);
+  return containerElement;
+}
+
 /**
- * Generates an img element with the drawing encoded as a base64 SVG or a PNG (depending on settings)
+ * Generates an IMG or DIV element
+ * - The IMG element will have the drawing encoded as a base64 SVG or a PNG (depending on settings)
+ * - The DIV element will have the drawing as an SVG element
  * @param parts {imgElementAttributes} - display properties of the image
  * @returns {Promise<HTMLElement>} - the IMG HTML element containing the image
  */
 const getIMG = async (
   imgAttributes: imgElementAttributes,
   onCanvas: boolean = false,
-): Promise<HTMLElement> => {
+): Promise<HTMLImageElement | HTMLDivElement> => {
   let file = imgAttributes.file;
   if (!imgAttributes.file) {
     const f = vault.getAbstractFileByPath(imgAttributes.fname?.split("#")[0]);
@@ -69,7 +262,7 @@ const getIMG = async (
   const filenameParts = getEmbeddedFilenameParts(imgAttributes.fname);
 
   // https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/387
-  imgAttributes.style = imgAttributes.style.replaceAll(" ", "-");
+  imgAttributes.style = imgAttributes.style.map(s=>s.replaceAll(" ", "-"));
 
   const forceTheme = hasExportTheme(plugin, file)
     ? getExportTheme(plugin, file, "light")
@@ -79,13 +272,6 @@ const getIMG = async (
     withBackground: getWithBackground(plugin, file),
     withTheme: forceTheme ? true : plugin.settings.exportWithTheme,
   };
-  const img = createEl("img");
-  let style = `max-width:${imgAttributes.fwidth}${imgAttributes.fwidth.match(/\d$/) ? "px":""}; `; //width:100%;`; //removed !important https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/886
-  if (imgAttributes.fheight) {
-    style += `height:${imgAttributes.fheight}px;`;
-  }
-  if(!onCanvas) img.setAttribute("style", style);
-  img.addClass(imgAttributes.style);
 
   const theme =
     forceTheme ??
@@ -104,122 +290,72 @@ const getIMG = async (
     theme ? theme === "dark" : undefined,
   );
 
-  if (!plugin.settings.displaySVGInPreview) {
-    const width = parseInt(imgAttributes.fwidth);
-    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 =
-      quickPNG ??
-      (await createPNG(
-        filenameParts.hasGroupref
-          ? filenameParts.filepath + filenameParts.linkpartReference
-          : file.path,
-        scale,
-        exportSettings,
-        loader,
-        theme,
-        null,
-        null,
-        [],
-        plugin,
-        0
-      ));
-    if (!png) {
-      return null;
+  const cacheReady = imageCache.isReady();
+  
+  switch (plugin.settings.previewImageType) {
+    case PreviewImageType.PNG: {
+      const img = createEl("img");
+      setStyle({element:img,imgAttributes,onCanvas});
+      return _getPNG({imgAttributes,filenameParts,theme,cacheReady,img,file,exportSettings,loader});
     }
-    img.src = URL.createObjectURL(png);
-    return img;
-  }
-
-  if(!(filenameParts.hasBlockref || filenameParts.hasSectionref)) {
-    const quickSVG = await getQuickImagePreview(plugin, file.path, "svg");
-    if (quickSVG) {
-      img.setAttribute("src", svgToBase64(quickSVG));
-      return img;
+    case PreviewImageType.SVGIMG: {
+      const img = createEl("img");
+      setStyle({element:img,imgAttributes,onCanvas});
+      return _getSVGIMG({filenameParts,theme,cacheReady,img,file,exportSettings,loader});
+    }
+    case PreviewImageType.SVG:  {
+      const img = createEl("div");
+      setStyle({element:img,imgAttributes,onCanvas});
+      return _getSVGNative({filenameParts,theme,cacheReady,containerElement: img,file,exportSettings,loader});
     }
   }
-  const svgSnapshot = (
-    await createSVG(
-      filenameParts.hasGroupref || filenameParts.hasBlockref || filenameParts.hasSectionref
-        ? filenameParts.filepath + filenameParts.linkpartReference
-        : file.path,
-      true,
-      exportSettings,
-      loader,
-      theme,
-      null,
-      null,
-      [],
-      plugin,
-      0,
-      getExportPadding(plugin, file),
-    )
-  ).outerHTML;
-  let svg: SVGSVGElement = null;
-  const el = document.createElement("div");
-  el.innerHTML = svgSnapshot;
-  const firstChild = el.firstChild;
-  if (firstChild instanceof SVGSVGElement) {
-    svg = firstChild;
-  }
-  if (!svg) {
-    return null;
-  }
-  svg = embedFontsInSVG(svg, plugin);
-  //svg.removeAttribute("width");
-  //svg.removeAttribute("height");
-  img.setAttribute("src", svgToBase64(svg.outerHTML));
-  return img;
 };
 
+const addSVGToImgSrc = (img: HTMLImageElement, svg: SVGSVGElement, cacheReady: boolean, cacheKey: ImageKey):HTMLImageElement => {
+  const svgString = new XMLSerializer().serializeToString(svg);
+  const blob = new Blob([svgString], { type: 'image/svg+xml' });
+  const blobUrl = URL.createObjectURL(blob);
+  img.setAttribute("src", blobUrl);
+  cacheReady && imageCache.addImageToCache(cacheKey, blobUrl, blob);
+  return img;
+}
+
 const createImgElement = async (
   attr: imgElementAttributes,
   onCanvas: boolean = false,
 ) :Promise<HTMLElement> => {
-  const img = await getIMG(attr,onCanvas);
-  img.setAttribute("fileSource", attr.fname);
+  const imgOrDiv = await getIMG(attr,onCanvas);
+  if(!imgOrDiv) {
+    return null;
+  }
+  imgOrDiv.setAttribute("fileSource", attr.fname);
   if (attr.fwidth) {
-    img.setAttribute("w", attr.fwidth);
+    imgOrDiv.setAttribute("w", attr.fwidth);
   }
   if (attr.fheight) {
-    img.setAttribute("h", attr.fheight);
+    imgOrDiv.setAttribute("h", attr.fheight);
   }
-  img.setAttribute("draggable","false");
-  img.setAttribute("onCanvas",onCanvas?"true":"false");
+  imgOrDiv.setAttribute("draggable","false");
+  imgOrDiv.setAttribute("onCanvas",onCanvas?"true":"false");
 
   let timer:NodeJS.Timeout;
   const clickEvent = (ev:PointerEvent) => {
-    if (
-      ev.target instanceof Element &&
-      ev.target.tagName.toLowerCase() != "img"
-    ) {
+    if(!(ev.target instanceof Element)) {
       return;
     }
-    const src = img.getAttribute("fileSource");
+    const containerElement = ev.target.hasClass("excalidraw-embedded-img")
+      ? ev.target
+      : getParentOfClass(ev.target, "excalidraw-embedded-img");
+    if (!containerElement) {
+      return;
+    }
+    const src = imgOrDiv.getAttribute("fileSource");
     if (src) {
       const srcParts = src.match(/([^#]*)(.*)/);
       if(!srcParts) return;
       plugin.openDrawing(
         vault.getAbstractFileByPath(srcParts[1]) as TFile,
-        ev[CTRL_OR_CMD]
-          ? "new-pane"
-          : (ev.metaKey && !app.isMobile)
-            ? "popout-window"
-            : "active-pane",
+        linkClickModifierType(ev),
         true,
         srcParts[2],
       );
@@ -227,35 +363,41 @@ const createImgElement = async (
   };
   //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1003
   let pointerDownEvent:any;
-  img.addEventListener("pointermove",(ev)=>{
+  const eventElement = imgOrDiv as HTMLElement;
+  
+  /*plugin.settings.previewImageType === PreviewImageType.SVG
+    ? imgOrDiv.firstElementChild as HTMLElement
+    : imgOrDiv;*/
+
+  eventElement.addEventListener("pointermove",(ev)=>{
     if(!timer) return;
     if(Math.abs(ev.screenX-pointerDownEvent.screenX)>10 || Math.abs(ev.screenY-pointerDownEvent.screenY)>10) {
       clearTimeout(timer);
       timer = null;
     }
   });  
-  img.addEventListener("pointerdown",(ev)=>{
-    if(img?.parentElement?.hasClass("canvas-node-content")) return;
+  eventElement.addEventListener("pointerdown",(ev)=>{
+    if(imgOrDiv?.parentElement?.hasClass("canvas-node-content")) return;
     timer = setTimeout(()=>clickEvent(ev),500);
     pointerDownEvent = ev;
   });
-  img.addEventListener("pointerup",()=>{
+  eventElement.addEventListener("pointerup",()=>{
     if(timer) clearTimeout(timer);
     timer = null;
   })
-  img.addEventListener("dblclick",clickEvent);
-  img.addEventListener(RERENDER_EVENT, async (e) => {
+  eventElement.addEventListener("dblclick",clickEvent);
+  eventElement.addEventListener(RERENDER_EVENT, async (e) => {
     e.stopPropagation();
-    const parent = img.parentElement;
-    const imgMaxWidth = img.style.maxWidth;
-    const imgMaxHeigth = img.style.maxHeight;
-    const fileSource = img.getAttribute("fileSource");
-    const onCanvas = img.getAttribute("onCanvas") === "true";
+    const parent = imgOrDiv.parentElement;
+    const imgMaxWidth = imgOrDiv.style.maxWidth;
+    const imgMaxHeigth = imgOrDiv.style.maxHeight;
+    const fileSource = imgOrDiv.getAttribute("fileSource");
+    const onCanvas = imgOrDiv.getAttribute("onCanvas") === "true";
     const newImg = await createImgElement({
       fname: fileSource,
-      fwidth: img.getAttribute("w"),
-      fheight: img.getAttribute("h"),
-      style: img.getAttribute("class"),
+      fwidth: imgOrDiv.getAttribute("w"),
+      fheight: imgOrDiv.getAttribute("h"),
+      style: [...Array.from(imgOrDiv.classList)],
     }, onCanvas);
     parent.empty();
     if(!onCanvas) {
@@ -265,7 +407,21 @@ const createImgElement = async (
     newImg.setAttribute("fileSource",fileSource);
     parent.append(newImg);
   });
-  return img;
+  const cssClasses = getFileCSSClasses(attr.file);
+  cssClasses.forEach((cssClass) => {
+    if(imgOrDiv.hasClass(cssClass)) return;
+    imgOrDiv.addClass(cssClass);
+  });
+  if(window.ExcalidrawAutomate.plugin.settings.canvasImmersiveEmbed) {
+    if(!imgOrDiv.hasClass("excalidraw-canvas-immersive")) {
+      imgOrDiv.addClass("excalidraw-canvas-immersive");
+    }
+  } else {
+    if(imgOrDiv.hasClass("excalidraw-canvas-immersive")) {
+      imgOrDiv.removeClass("excalidraw-canvas-immersive");
+    }
+  }
+  return imgOrDiv;
 }
 
 const createImageDiv = async (
@@ -273,7 +429,7 @@ const createImageDiv = async (
   onCanvas: boolean = false
 ): Promise<HTMLDivElement> => {
   const img = await createImgElement(attr, onCanvas);
-  return createDiv(attr.style, (el) => el.append(img));
+  return createDiv(attr.style.join(" "), (el) => el.append(img));
 };
 
 const processReadingMode = async (
@@ -315,17 +471,24 @@ const processInternalEmbed = async (internalEmbedEl: Element, file: TFile ):Prom
     fname: "",
     fheight: "",
     fwidth: "",
-    style: "",
+    style: [],
   };
 
   const src = internalEmbedEl.getAttribute("src");
   if(!src) return;
+
+  //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1059
+  internalEmbedEl.removeClass("markdown-embed");
+  internalEmbedEl.removeClass("inline-embed");
+  internalEmbedEl.addClass("media-embed");
+  internalEmbedEl.addClass("image-embed");
+
   attr.fwidth = internalEmbedEl.getAttribute("width")
   ? internalEmbedEl.getAttribute("width")
   : getDefaultWidth(plugin);
   attr.fheight = internalEmbedEl.getAttribute("height");
   let alt = internalEmbedEl.getAttribute("alt");
-  attr.style = "excalidraw-svg";
+  attr.style = ["excalidraw-svg"];
   processAltText(src.split("#")[0],alt,attr);
   const fnameParts = getEmbeddedFilenameParts(src);
   attr.fname = file?.path + (fnameParts.hasBlockref||fnameParts.hasSectionref?fnameParts.linkpartReference:"");
@@ -344,14 +507,14 @@ const processAltText = (
     attr.fwidth = parts[2] ?? attr.fwidth;
     attr.fheight = parts[3] ?? attr.fheight;
     if (parts[4] && !parts[4].startsWith(fname)) {
-      attr.style = `excalidraw-svg${`-${parts[4]}`}`;
+      attr.style = [`excalidraw-svg${`-${parts[4]}`}`];
     }
     if (
       (!parts[4] || parts[4]==="") &&
       (!parts[2] || parts[2]==="") &&
       parts[0] && parts[0] !== ""
     ) {
-      attr.style = `excalidraw-svg${`-${parts[0]}`}`;
+      attr.style = [`excalidraw-svg${`-${parts[0]}`}`];
     }
   }
 }
@@ -360,7 +523,7 @@ 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) &&
+  return !(fnameParts.hasArearef || fnameParts.hasGroupref || fnameParts.hasFrameref) &&
     (fnameParts.hasBlockref || fnameParts.hasSectionref)
 }
 
@@ -409,7 +572,7 @@ const tmpObsidianWYSIWYG = async (
     fname: ctx.sourcePath,
     fheight: "",
     fwidth: getDefaultWidth(plugin),
-    style: "excalidraw-svg",
+    style: ["excalidraw-svg"],
   };
   
   attr.file = file;
@@ -429,11 +592,11 @@ const tmpObsidianWYSIWYG = async (
     const onCanvas = internalEmbedDiv.hasClass("canvas-node-content");
     const imgDiv = await createImageDiv(attr, onCanvas);
     if(markdownEmbed) {
-      if(onCanvas) {
-        internalEmbedDiv.removeClass("markdown-embed");
-        internalEmbedDiv.addClass("media-embed");
-        internalEmbedDiv.addClass("image-embed");
-      }
+      //display image on canvas without markdown frame
+      internalEmbedDiv.removeClass("markdown-embed");
+      internalEmbedDiv.removeClass("inline-embed");
+      internalEmbedDiv.addClass("media-embed");
+      internalEmbedDiv.addClass("image-embed");
       if(!onCanvas && imgDiv.firstChild instanceof HTMLElement) {
         imgDiv.firstChild.style.maxHeight = "100%";
         imgDiv.firstChild.style.maxWidth = null;
@@ -588,7 +751,7 @@ export const observer = new MutationObserver(async (m) => {
     fname: file.path,
     fwidth: "300",
     fheight: null,
-    style: "excalidraw-svg",
+    style: ["excalidraw-svg"],
   });
   const div = createDiv("", async (el) => {
     el.appendChild(img);
@@ -599,14 +762,11 @@ export const observer = new MutationObserver(async (m) => {
       if (src) {
         plugin.openDrawing(
           vault.getAbstractFileByPath(src) as TFile,
-          ev[CTRL_OR_CMD]
-            ? "new-pane"
-            : (ev.metaKey && !app.isMobile) 
-              ? "popout-window"
-              : "active-pane",
+          linkClickModifierType(ev)
         );
       } //.ctrlKey||ev.metaKey);
     });
   });
   node.appendChild(div);
 });
+

src/MarkdownPostProcessor_Legacy.ts

@@ -1,584 +0,0 @@
-import {
-  MarkdownPostProcessorContext,
-  MetadataCache,
-  TFile,
-  Vault,
-} from "obsidian";
-import { CTRL_OR_CMD, RERENDER_EVENT } from "./Constants";
-import { EmbeddedFilesLoader } from "./EmbeddedFileLoader";
-import { createPNG, createSVG } from "./ExcalidrawAutomate";
-import { ExportSettings } from "./ExcalidrawView";
-import ExcalidrawPlugin from "./main";
-import {getIMGFilename,} from "./utils/FileUtils";
-import {
-  embedFontsInSVG,
-  getEmbeddedFilenameParts,
-  getExportTheme,
-  getQuickImagePreview,
-  getExportPadding,
-  getWithBackground,
-  hasExportTheme,
-  svgToBase64,
-} from "./utils/Utils";
-import { isObsidianThemeDark } from "./utils/ObsidianUtils";
-
-interface imgElementAttributes {
-  file?: TFile;
-  fname: string; //Excalidraw filename
-  fwidth: string; //Display width of image
-  fheight: string; //Display height of image
-  style: string; //css style to apply to IMG element
-}
-
-let plugin: ExcalidrawPlugin;
-let vault: Vault;
-let metadataCache: MetadataCache;
-
-const getDefaultWidth = (plugin: ExcalidrawPlugin): string => {
-  const width = parseInt(plugin.settings.width);
-  if (isNaN(width) || width === 0 || width === null) {
-    return "400";
-  }
-  return plugin.settings.width;
-};
-
-export const initializeMarkdownPostProcessor_Legacy = (p: ExcalidrawPlugin) => {
-  plugin = p;
-  vault = p.app.vault;
-  metadataCache = p.app.metadataCache;
-};
-
-/**
- * Generates an img element with the drawing encoded as a base64 SVG or a PNG (depending on settings)
- * @param parts {imgElementAttributes} - display properties of the image
- * @returns {Promise<HTMLElement>} - the IMG HTML element containing the image
- */
-const getIMG = async (
-  imgAttributes: imgElementAttributes,
-): Promise<HTMLElement> => {
-  let file = imgAttributes.file;
-  if (!imgAttributes.file) {
-    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(" ", "-");
-
-  const forceTheme = hasExportTheme(plugin, file)
-    ? getExportTheme(plugin, file, "light")
-    : undefined;
-
-  const exportSettings: ExportSettings = {
-    withBackground: getWithBackground(plugin, file),
-    withTheme: forceTheme ? true : plugin.settings.exportWithTheme,
-  };
-  const img = createEl("img");
-  let style = `max-width:${imgAttributes.fwidth}px; width:100%;`; //removed !important https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/886
-  if (imgAttributes.fheight) {
-    style += `height:${imgAttributes.fheight}px;`;
-  }
-  img.setAttribute("style", style);
-  img.addClass(imgAttributes.style);
-
-  const theme =
-    forceTheme ??
-    (plugin.settings.previewMatchObsidianTheme
-      ? isObsidianThemeDark()
-        ? "dark"
-        : "light"
-      : !plugin.settings.exportWithTheme
-      ? "light"
-      : undefined);
-  if (theme) {
-    exportSettings.withTheme = true;
-  }
-  const loader = new EmbeddedFilesLoader(
-    plugin,
-    theme ? theme === "dark" : undefined,
-  );
-
-  if (!plugin.settings.displaySVGInPreview) {
-    const width = parseInt(imgAttributes.fwidth);
-    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 =
-      quickPNG ??
-      (await createPNG(
-        filenameParts.hasGroupref
-          ? filenameParts.filepath + filenameParts.linkpartReference
-          : file.path,
-        scale,
-        exportSettings,
-        loader,
-        theme,
-        null,
-        null,
-        [],
-        plugin,
-        0
-      ));
-    if (!png) {
-      return null;
-    }
-    img.src = URL.createObjectURL(png);
-    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(
-      filenameParts.hasGroupref || filenameParts.hasBlockref || filenameParts.hasSectionref
-        ? filenameParts.filepath + filenameParts.linkpartReference
-        : file.path,
-      true,
-      exportSettings,
-      loader,
-      theme,
-      null,
-      null,
-      [],
-      plugin,
-      0,
-      getExportPadding(plugin, file),
-    )
-  ).outerHTML;
-  let svg: SVGSVGElement = null;
-  const el = document.createElement("div");
-  el.innerHTML = svgSnapshot;
-  const firstChild = el.firstChild;
-  if (firstChild instanceof SVGSVGElement) {
-    svg = firstChild;
-  }
-  if (!svg) {
-    return null;
-  }
-  svg = embedFontsInSVG(svg, plugin);
-  svg.removeAttribute("width");
-  svg.removeAttribute("height");
-  img.setAttribute("src", svgToBase64(svg.outerHTML));
-  return img;
-};
-
-const createImageDiv = async (
-  attr: imgElementAttributes,
-): Promise<HTMLDivElement> => {
-  const img = await getIMG(attr);
-  return createDiv(attr.style, (el) => {
-    el.append(img);
-    el.setAttribute("src", attr.fname);
-    if (attr.fwidth) {
-      el.setAttribute("w", attr.fwidth);
-    }
-    if (attr.fheight) {
-      el.setAttribute("h", attr.fheight);
-    }
-    let timer:NodeJS.Timeout;
-    const clickEvent = (ev:PointerEvent) => {
-      if (
-        ev.target instanceof Element &&
-        ev.target.tagName.toLowerCase() != "img"
-      ) {
-        return;
-      }
-      const src = el.getAttribute("src");
-      if (src) {
-        const srcParts = src.match(/([^#]*)(.*)/);
-        if(!srcParts) return;
-        plugin.openDrawing(
-          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);
-    };
-    //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1003
-    let pointerDownEvent:any;
-    img.addEventListener("pointermove",(ev)=>{
-      if(!timer) return;
-      if(Math.abs(ev.screenX-pointerDownEvent.screenX)>10 || Math.abs(ev.screenY-pointerDownEvent.screenY)>10) {
-        clearTimeout(timer);
-        timer = null;
-      }
-    });
-    
-    img.addEventListener("pointerdown",(ev)=>{
-      timer = setTimeout(()=>clickEvent(ev),500);
-      pointerDownEvent = ev;
-    });
-
-    el.addEventListener("pointerup",()=>{
-      if(timer) clearTimeout(timer);
-      timer = null;
-    })
-    el.addEventListener("dblclick",clickEvent);
-    el.addEventListener(RERENDER_EVENT, async (e) => {
-      e.stopPropagation();
-      el.empty();
-      const img = await getIMG({
-        fname: el.getAttribute("src"),
-        fwidth: el.getAttribute("w"),
-        fheight: el.getAttribute("h"),
-        style: el.getAttribute("class"),
-      });
-      el.append(img);
-    });
-  });
-};
-
-const processReadingMode = async (
-  embeddedItems: NodeListOf<Element> | [HTMLElement],
-  ctx: MarkdownPostProcessorContext,
-) => {
-  //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: "",
-  };
-
-  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);
-}
-
-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,
-) => {
-  const file = app.vault.getAbstractFileByPath(ctx.sourcePath);
-  if(!(file instanceof TFile)) return;
-  if(!plugin.isExcalidrawFile(file)) return;
-
-  //@ts-ignore
-  if (ctx.remainingNestLevel < 4) {
-    return;
-  }
-
-  //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
-  //specified in setting should be displayed
-  //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 () => {
-    //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("dataview") &&
-      !internalEmbedDiv.hasClass("cm-preview-code-block") &&
-      !internalEmbedDiv.hasClass("cm-embed-block") &&
-      !internalEmbedDiv.hasClass("internal-embed") &&
-      internalEmbedDiv.parentElement
-    ) {
-      internalEmbedDiv = internalEmbedDiv.parentElement;
-    }
-     
-    if(
-      internalEmbedDiv.hasClass("dataview") ||
-      internalEmbedDiv.hasClass("cm-preview-code-block") ||
-      internalEmbedDiv.hasClass("cm-embed-block")
-    ) { 
-      return; //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/835
-    }
-
-    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();
-      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 imgDiv = await processInternalEmbed(internalEmbedDiv,file);
-    internalEmbedDiv.appendChild(imgDiv);
-
-    //timer to avoid the image flickering when the user is typing
-    let timer: NodeJS.Timeout = null;
-    const observer = new MutationObserver((m) => {
-      if (!["alt", "width", "height"].contains(m[0]?.attributeName)) {
-        return;
-      }
-      if (timer) {
-        clearTimeout(timer);
-      }
-      timer = setTimeout(async () => {
-        timer = null;
-        internalEmbedDiv.empty();
-        const imgDiv = await processInternalEmbed(internalEmbedDiv,file);
-        internalEmbedDiv.appendChild(imgDiv);    
-      }, 500);
-    });
-    observer.observe(internalEmbedDiv, {
-      attributes: true, //configure it to listen to attribute changes
-    });
-  });
-};
-
-/**
- *
- * @param el
- * @param ctx
- */
-export const markdownPostProcessor_Legacy = async (
-  el: HTMLElement,
-  ctx: MarkdownPostProcessorContext,
-) => {
-
-  //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) {
-    tmpObsidianWYSIWYG(el, ctx);
-    return;
-  }
-
-  //If the file being processed is an excalidraw file,
-  //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
-  const excalidrawFile = Boolean(ctx.frontmatter?.hasOwnProperty("excalidraw-plugin"));
-  if (excalidrawFile) {
-    el.style.display = "none";
-    return;
-  }
-
-  await processReadingMode(embeddedItems, ctx);
-};
-
-/**
- * internal-link quick preview
- * @param e
- * @returns
- */
-export const hoverEvent_Legacy = (e: any) => {
-  if (!e.linktext) {
-    plugin.hover.linkText = null;
-    return;
-  }
-  plugin.hover.linkText = e.linktext;
-  plugin.hover.sourcePath = e.sourcePath;
-};
-
-//monitoring for div.popover.hover-popover.file-embed.is-loaded to be added to the DOM tree
-export const observer_Legacy = new MutationObserver(async (m) => {
-  if (m.length == 0) {
-    return;
-  }
-  if (!plugin.hover.linkText) {
-    return;
-  }
-  const file = metadataCache.getFirstLinkpathDest(
-    plugin.hover.linkText,
-    plugin.hover.sourcePath ? plugin.hover.sourcePath : "",
-  );
-  if (!file) {
-    return;
-  }
-  if (!(file instanceof TFile)) {
-    return;
-  }
-  if (file.extension !== "excalidraw") {
-    return;
-  }
-
-  const svgFileName = getIMGFilename(file.path, "svg");
-  const svgFile = vault.getAbstractFileByPath(svgFileName);
-  if (svgFile && svgFile instanceof TFile) {
-    return;
-  } //If auto export SVG or PNG is enabled it will be inserted at the top of the excalidraw file. No need to manually insert hover preview
-
-  const pngFileName = getIMGFilename(file.path, "png");
-  const pngFile = vault.getAbstractFileByPath(pngFileName);
-  if (pngFile && pngFile instanceof TFile) {
-    return;
-  } //If auto export SVG or PNG is enabled it will be inserted at the top of the excalidraw file. No need to manually insert hover preview
-
-  if (!plugin.hover.linkText) {
-    return;
-  }
-  if (m.length != 1) {
-    return;
-  }
-  if (m[0].addedNodes.length != 1) {
-    return;
-  }
-  if (
-    //@ts-ignore
-    !m[0].addedNodes[0].classNames !=
-    "popover hover-popover file-embed is-loaded"
-  ) {
-    return;
-  }
-  const node = m[0].addedNodes[0];
-  node.empty();
-
-  //this div will be on top of original DIV. By stopping the propagation of the click
-  //I prevent the default Obsidian feature of openning the link in the native app
-  const img = await getIMG({
-    file,
-    fname: file.path,
-    fwidth: "300",
-    fheight: null,
-    style: "excalidraw-svg",
-  });
-  const div = createDiv("", async (el) => {
-    el.appendChild(img);
-    el.setAttribute("src", file.path);
-    el.onClickEvent((ev) => {
-      ev.stopImmediatePropagation();
-      const src = el.getAttribute("src");
-      if (src) {
-        plugin.openDrawing(
-          vault.getAbstractFileByPath(src) as TFile,
-          ev[CTRL_OR_CMD]
-            ? "new-pane"
-            : (ev.metaKey && !app.isMobile) 
-              ? "popout-window"
-              : "active-pane",
-        );
-      } //.ctrlKey||ev.metaKey);
-    });
-  });
-  node.appendChild(div);
-});

src/Scripts.ts

@@ -5,12 +5,13 @@ import {
   TFile,
   WorkspaceLeaf,
 } from "obsidian";
-import { PLUGIN_ID, VIEW_TYPE_EXCALIDRAW } from "./Constants";
+import { PLUGIN_ID, VIEW_TYPE_EXCALIDRAW } from "./constants";
 import ExcalidrawView from "./ExcalidrawView";
 import ExcalidrawPlugin from "./main";
-import { GenericInputPrompt, GenericSuggester } from "./dialogs/Prompt";
+import { ButtonDefinition, GenericInputPrompt, GenericSuggester } from "./dialogs/Prompt";
 import { getIMGFilename } from "./utils/FileUtils";
 import { splitFolderAndFilename } from "./utils/FileUtils";
+import { getEA } from "src";
 
 export type ScriptIconMap = {
   [key: string]: { name: string; group: string; svgString: string };
@@ -199,39 +200,48 @@ export class ScriptEngine {
 
     const commandId = `${PLUGIN_ID}:${basename}`;
     // @ts-ignore
-    if (!app.commands.commands[commandId]) {
+    if (!this.plugin.app.commands.commands[commandId]) {
       return;
     }
     // @ts-ignore
-    delete app.commands.commands[commandId];
+    delete this.plugin.app.commands.commands[commandId];
   }
 
   async executeScript(view: ExcalidrawView, script: string, title: string, file: TFile) {
     if (!view || !script || !title) {
       return;
     }
-    this.plugin.ea.reset();
-    this.plugin.ea.setView(view);
-    this.plugin.ea.activeScript = title;
+    const ea = getEA(view);
+    ea.activeScript = title;
 
     //https://stackoverflow.com/questions/45381204/get-asyncfunction-constructor-in-typescript changed tsconfig to es2017
     //https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction
     const AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
     let result = null;
     //try {
-    result = await new AsyncFunction("ea", "utils", script)(this.plugin.ea, {
+    result = await new AsyncFunction("ea", "utils", script)(ea, {
       inputPrompt: (
         header: string,
         placeholder?: string,
         value?: string,
-        buttons?: [{ caption: string; action: Function }],
+        buttons?: ButtonDefinition[],
+        lines?: number,
+        displayEditorButtons?: boolean,
+        customComponents?: (container: HTMLElement) => void,
+        blockPointerInputOutsideModal?: boolean,
       ) =>
         ScriptEngine.inputPrompt(
-          app,
+          view,
+          this.plugin,
+          this.plugin.app,
           header,
           placeholder,
           value,
           buttons,
+          lines,
+          displayEditorButtons,
+          customComponents,
+          blockPointerInputOutsideModal,
         ),
       suggester: (
         displayItems: string[],
@@ -251,10 +261,10 @@ export class ScriptEngine {
     /*} catch (e) {
       new Notice(t("SCRIPT_EXECUTION_ERROR"), 4000);
       errorlog({ script: this.plugin.ea.activeScript, error: e });
-    }*/
-    this.plugin.ea.activeScript = null;
-    return result;
-  }
+  }*/
+        ea.activeScript = null;
+        return result;
+}
 
   private updateToolPannels() {
     const leaves =
@@ -268,19 +278,31 @@ export class ScriptEngine {
   }
 
   public static async inputPrompt(
+    view: ExcalidrawView,
+    plugin: ExcalidrawPlugin,
     app: App,
     header: string,
     placeholder?: string,
     value?: string,
-    buttons?: [{ caption: string; action: Function }],
+    buttons?: ButtonDefinition[],
+    lines?: number,
+    displayEditorButtons?: boolean,
+    customComponents?: (container: HTMLElement) => void,
+    blockPointerInputOutsideModal?: boolean,
   ) {
     try {
       return await GenericInputPrompt.Prompt(
+        view,
+        plugin,
         app,
         header,
         placeholder,
         value,
         buttons,
+        lines,
+        displayEditorButtons,
+        customComponents,
+        blockPointerInputOutsideModal,
       );
     } catch {
       return undefined;

src/customEmbeddable.tsx

@@ -0,0 +1,415 @@
+import {  NonDeletedExcalidrawElement } from "@zsviczian/excalidraw/types/element/types";
+import ExcalidrawView from "./ExcalidrawView";
+import { Notice, WorkspaceLeaf, WorkspaceSplit } from "obsidian";
+import * as React from "react";
+import { ConstructableWorkspaceSplit, getContainerForDocument, isObsidianThemeDark } from "./utils/ObsidianUtils";
+import { DEVICE, EXTENDED_EVENT_TYPES, KEYBOARD_EVENT_TYPES } from "./constants";
+import { ExcalidrawImperativeAPI, UIAppState } from "@zsviczian/excalidraw/types/types";
+import { ObsidianCanvasNode } from "./utils/CanvasNodeFactory";
+import { processLinkText, patchMobileView } from "./utils/CustomEmbeddableUtils";
+import { EmbeddableMDCustomProps } from "./dialogs/EmbeddableSettings";
+
+declare module "obsidian" {
+  interface Workspace {
+    floatingSplit: any;
+  }
+
+  interface WorkspaceSplit {
+    containerEl: HTMLDivElement;
+  }
+}
+
+const getTheme = (view: ExcalidrawView, theme:string): string => view.excalidrawData.embeddableTheme === "dark"
+  ? "theme-dark"
+  : view.excalidrawData.embeddableTheme === "light" 
+    ? "theme-light"
+    : view.excalidrawData.embeddableTheme === "auto"
+      ? theme === "dark" ? "theme-dark" : "theme-light"
+      : isObsidianThemeDark() ? "theme-dark" : "theme-light";
+
+//--------------------------------------------------------------------------------
+//Render webview for anything other than Vimeo and Youtube
+//Vimeo and Youtube are rendered by Excalidraw because of the window messaging
+//required to control the video
+//--------------------------------------------------------------------------------
+export const renderWebView = (src: string, view: ExcalidrawView, id: string, appState: UIAppState):JSX.Element =>{
+  if(DEVICE.isDesktop) {
+    return (
+      <webview
+        ref={(ref) => view.updateEmbeddableRef(id, ref)}
+        className="excalidraw__embeddable"
+        title="Excalidraw Embedded Content"
+        allowFullScreen={true}
+        src={src}
+        style={{
+          overflow: "hidden",
+          borderRadius: "var(--embeddable-radius)",
+        }}
+      />
+    );
+  }
+  return (
+    <iframe
+      ref={(ref) => view.updateEmbeddableRef(id, ref)}
+      className="excalidraw__embeddable"
+      title="Excalidraw Embedded Content"
+      allowFullScreen={true}
+      allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+      src={src}
+      style={{
+        overflow: "hidden",
+        borderRadius: "var(--embeddable-radius)",
+      }}
+    />
+  );
+}
+
+//--------------------------------------------------------------------------------
+//Render WorkspaceLeaf or CanvasNode
+//--------------------------------------------------------------------------------
+function RenderObsidianView(
+  { mdProps, element, linkText, view, containerRef, activeEmbeddable, theme, canvasColor }:{
+  mdProps: EmbeddableMDCustomProps;
+  element: NonDeletedExcalidrawElement;
+  linkText: string;
+  view: ExcalidrawView;
+  containerRef: React.RefObject<HTMLDivElement>;
+  activeEmbeddable: {element: NonDeletedExcalidrawElement; state: string};
+  theme: string;
+  canvasColor: string;
+}): JSX.Element {
+  
+  const { subpath, file } = processLinkText(linkText, view);
+
+  if (!file) {
+    return null;
+  }
+  const react = view.plugin.getPackage(view.ownerWindow).react;
+  
+  //@ts-ignore
+  const leafRef = react.useRef<{leaf: WorkspaceLeaf; node?: ObsidianCanvasNode} | null>(null);
+  const isEditingRef = react.useRef(false);
+  const isActiveRef = react.useRef(false);
+  const themeRef = react.useRef(theme);
+  const elementRef = react.useRef(element);
+
+  // Update themeRef when theme changes
+  react.useEffect(() => {
+    themeRef.current = theme;
+  }, [theme]);
+
+  // Update elementRef when element changes
+  react.useEffect(() => {
+    elementRef.current = element;
+  }, [element]);
+ 
+  //--------------------------------------------------------------------------------
+  //block propagation of events to the parent if the iframe element is active
+  //--------------------------------------------------------------------------------
+  const stopPropagation = react.useCallback((event:React.PointerEvent<HTMLElement>) => {
+    if(isActiveRef.current) {
+      event.stopPropagation(); // Stop the event from propagating up the DOM tree
+    }
+  }, [isActiveRef.current]);
+
+  //runs once after mounting of the component and when the component is unmounted
+  react.useEffect(() => {
+    if(!containerRef?.current) {
+      return;
+    }
+
+    KEYBOARD_EVENT_TYPES.forEach((type) => containerRef.current.addEventListener(type, stopPropagation));
+    containerRef.current.addEventListener("click", handleClick);
+
+    return () => {
+      if(!containerRef?.current) {
+        return;
+      }
+      KEYBOARD_EVENT_TYPES.forEach((type) => containerRef.current.removeEventListener(type, stopPropagation));
+      EXTENDED_EVENT_TYPES.forEach((type) => containerRef.current.removeEventListener(type, stopPropagation));
+      containerRef.current.removeEventListener("click", handleClick);
+    }; //cleanup on unmount
+  }, []);
+
+  //blocking or not the propagation of events to the parent if the iframe is active
+  react.useEffect(() => {
+    EXTENDED_EVENT_TYPES.forEach((type) => containerRef.current.removeEventListener(type, stopPropagation));
+    if(!containerRef?.current) {
+      return;
+    }
+
+    if(isActiveRef.current) {
+      EXTENDED_EVENT_TYPES.forEach((type) => containerRef.current.addEventListener(type, stopPropagation));
+    }
+
+    return () => {
+      if(!containerRef?.current) {
+        return;
+      }
+      EXTENDED_EVENT_TYPES.forEach((type) => containerRef.current.removeEventListener(type, stopPropagation));
+    }; //cleanup on unmount
+  }, [isActiveRef.current, containerRef.current]);
+
+
+  //--------------------------------------------------------------------------------
+  //mount the workspace leaf or the canvas node depending on subpath
+  //--------------------------------------------------------------------------------
+  react.useEffect(() => {
+    if(!containerRef?.current) {
+      return;
+    }
+
+    while(containerRef.current.hasChildNodes()) {
+      containerRef.current.removeChild(containerRef.current.lastChild);
+    }
+
+    containerRef.current.parentElement.style.padding = "";
+
+    const doc = view.ownerDocument;
+    const rootSplit:WorkspaceSplit = new (WorkspaceSplit as ConstructableWorkspaceSplit)(app.workspace, "vertical");
+    rootSplit.getRoot = () => app.workspace[doc === document ? 'rootSplit' : 'floatingSplit'];
+    rootSplit.getContainer = () => getContainerForDocument(doc);
+    rootSplit.containerEl.style.width = '100%';
+    rootSplit.containerEl.style.height = '100%';
+    rootSplit.containerEl.style.borderRadius = "var(--embeddable-radius)";
+    leafRef.current = {
+      leaf: app.workspace.createLeafInParent(rootSplit, 0),
+      node: null
+    };
+
+    const setKeepOnTop = () => {
+      const keepontop = (app.workspace.activeLeaf === view.leaf) && DEVICE.isDesktop;
+      if (keepontop) {
+        //@ts-ignore
+        if(!view.ownerWindow.electronWindow.isAlwaysOnTop()) {
+          //@ts-ignore
+          view.ownerWindow.electronWindow.setAlwaysOnTop(true);
+          setTimeout(() => {
+            //@ts-ignore
+            view.ownerWindow.electronWindow.setAlwaysOnTop(false);
+          }, 500);
+        }
+      }
+    }
+
+    //if subpath is defined, create a canvas node else create a workspace leaf
+    if(subpath && view.canvasNodeFactory.isInitialized()) {
+      setKeepOnTop();
+      leafRef.current.node = view.canvasNodeFactory.createFileNote(file, subpath, containerRef.current, element.id);
+      view.updateEmbeddableLeafRef(element.id, leafRef.current);
+    } else {
+      (async () => {
+        await leafRef.current.leaf.openFile(file, {
+          active: false,
+          state: {mode:"preview"},
+          ...subpath ? { eState: { subpath }}:{},
+        });
+        const viewType = leafRef.current.leaf.view?.getViewType();
+        if(viewType === "canvas") {
+          leafRef.current.leaf.view.canvas?.setReadonly(true);
+        }
+        if ((viewType === "markdown") && view.canvasNodeFactory.isInitialized()) {
+          setKeepOnTop();
+          //I haven't found a better way of deciding if an .md file has its own view (e.g., kanban) or not
+          //This runs only when the file is added, thus should not be a major performance issue
+          await leafRef.current.leaf.setViewState({state: {file:null}})
+          leafRef.current.node = view.canvasNodeFactory.createFileNote(file, subpath, containerRef.current, element.id);
+          setColors(containerRef.current, element, mdProps, canvasColor);
+        } else {
+          const workspaceLeaf:HTMLDivElement = rootSplit.containerEl.querySelector("div.workspace-leaf");
+          if(workspaceLeaf) workspaceLeaf.style.borderRadius = "var(--embeddable-radius)";
+          containerRef.current.appendChild(rootSplit.containerEl);
+        }
+        patchMobileView(view);
+        view.updateEmbeddableLeafRef(element.id, leafRef.current);
+      })();
+    }
+
+    return () => {}; //cleanup on unmount
+  }, [linkText, subpath, containerRef]);
+  
+  const setColors = (canvasNode: HTMLDivElement, element: NonDeletedExcalidrawElement, mdProps: EmbeddableMDCustomProps, canvas: string) => {
+    if(!mdProps) return;
+    if (!leafRef.current?.hasOwnProperty("node")) return;
+
+    const canvasNodeContainer = containerRef.current?.firstElementChild as HTMLElement;
+    
+    if(mdProps.useObsidianDefaults) {
+      canvasNode?.style.removeProperty("--canvas-background");
+      canvasNodeContainer?.style.removeProperty("background-color");
+      canvasNode?.style.removeProperty("--canvas-border");
+      canvasNodeContainer?.style.removeProperty("border-color");
+      return;
+    }
+
+    const ea = view.plugin.ea;
+    if(mdProps.backgroundMatchElement) {
+      const opacity = (mdProps?.backgroundOpacity ?? 50)/100;
+      const color = element?.backgroundColor 
+        ? ea.getCM(element.backgroundColor).alphaTo(opacity).stringHEX()
+        : "transparent";
+      canvasNode?.style.setProperty("--canvas-background", color);
+      canvasNodeContainer?.style.setProperty("background-color", color);
+    } else if (!(mdProps?.backgroundMatchElement ?? true )) {
+      const color = mdProps.backgroundMatchCanvas
+        ? ea.getCM(canvasColor).alphaTo((mdProps.backgroundOpacity??100)/100).stringHEX()
+        : ea.getCM(mdProps.backgroundColor).alphaTo((mdProps.backgroundOpacity??100)/100).stringHEX();
+      containerRef.current?.style.setProperty("--canvas-background", color);
+      canvasNodeContainer?.style.setProperty("background-color", color);
+    }
+
+    if(mdProps.borderMatchElement) {
+      const opacity = (mdProps?.borderOpacity ?? 50)/100;
+      const color = element?.strokeColor
+      ? ea.getCM(element?.strokeColor).alphaTo(opacity).stringHEX()
+      : "transparent";
+      canvasNode?.style.setProperty("--canvas-border", color);
+      canvasNodeContainer?.style.setProperty("border-color", color);
+    } else if(!(mdProps?.borderMatchElement ?? true)) {
+      const color = ea.getCM(mdProps.borderColor).alphaTo((mdProps.borderOpacity??100)/100).stringHEX();
+      canvasNode?.style.setProperty("--canvas-border", color);
+      canvasNodeContainer?.style.setProperty("border-color", color);
+    }
+  }
+
+  react.useEffect(() => {
+    if(!containerRef.current) {
+      return;
+    }
+    const element = elementRef.current;
+    const canvasNode = containerRef.current;
+    if(!canvasNode.hasClass("canvas-node")) return;
+    setColors(canvasNode, element, mdProps, canvasColor);
+  }, [
+    mdProps,
+    elementRef.current,
+    containerRef.current,
+    canvasColor,
+  ])
+
+  react.useEffect(() => {
+    if(isEditingRef.current) {
+      if(leafRef.current?.node) {
+        containerRef.current?.addClasses(["is-editing", "is-focused"]);
+        view.canvasNodeFactory.stopEditing(leafRef.current.node);
+      }
+      isEditingRef.current = false;
+    }
+  }, [isEditingRef.current, leafRef]);
+
+
+  //--------------------------------------------------------------------------------
+  //Switch to edit mode when markdown view is clicked
+  //--------------------------------------------------------------------------------
+  const handleClick = react.useCallback((event: React.PointerEvent<HTMLElement>) => {
+    if(isActiveRef.current) {
+      event.stopPropagation();
+    }
+
+    if (isActiveRef.current && !isEditingRef.current && leafRef.current?.leaf) {
+      if(leafRef.current.leaf.view?.getViewType() === "markdown") {
+        const api:ExcalidrawImperativeAPI = view.excalidrawAPI;
+        const el = api.getSceneElements().filter(el=>el.id === element.id)[0];
+
+        if(!el || el.angle !== 0) {
+          new Notice("Sorry, cannot edit rotated markdown documents");
+          return;
+        }
+        //@ts-ignore
+        const modes = leafRef.current.leaf.view.modes;
+        if (!modes) {
+          return;
+        }
+        leafRef.current.leaf.view.setMode(modes['source']);
+        isEditingRef.current = true;
+        patchMobileView(view);
+      } else if (leafRef.current?.node) {
+        //Handle canvas node
+        const newTheme = getTheme(view, themeRef.current);
+        containerRef.current?.addClasses(["is-editing", "is-focused"]);
+        view.canvasNodeFactory.startEditing(leafRef.current.node, newTheme);
+      }
+    }
+  }, [leafRef.current?.leaf, element.id, view, themeRef.current]);
+
+  //--------------------------------------------------------------------------------
+  // Set isActiveRef and switch to preview mode when the iframe is not active
+  //--------------------------------------------------------------------------------
+  react.useEffect(() => {
+    if(!containerRef?.current || !leafRef?.current) {
+      return;
+    }
+
+    const previousIsActive = isActiveRef.current;
+    isActiveRef.current = (activeEmbeddable?.element.id === element.id) && (activeEmbeddable?.state === "active");
+
+    if (previousIsActive === isActiveRef.current) {
+      return;
+    }
+
+    if(leafRef.current.leaf?.view?.getViewType() === "markdown") {
+      //Handle markdown leaf
+      //@ts-ignore
+      const modes = leafRef.current.leaf.view.modes;
+      if(!modes) {
+        return;
+      }
+    
+      if(!isActiveRef.current) {
+        //@ts-ignore
+        leafRef.current.leaf.view.setMode(modes["preview"]);
+        isEditingRef.current = false;
+        return;
+      }  
+    } else if (leafRef.current?.node) {
+      //Handle canvas node
+      containerRef.current?.removeClasses(["is-editing", "is-focused"]);
+      view.canvasNodeFactory.stopEditing(leafRef.current.node);
+    }
+  }, [
+    containerRef,
+    leafRef,
+    isActiveRef,
+    activeEmbeddable?.element,
+    activeEmbeddable?.state,
+    element,
+    view,
+    isEditingRef,
+    view.canvasNodeFactory
+  ]);
+
+  return null;
+};
+
+
+export const CustomEmbeddable: React.FC<{element: NonDeletedExcalidrawElement; view: ExcalidrawView; appState: UIAppState; linkText: string}> = ({ element, view, appState, linkText }) => {
+  const react = view.plugin.getPackage(view.ownerWindow).react;
+  const containerRef: React.RefObject<HTMLDivElement> = react.useRef(null);
+  const theme = getTheme(view, appState.theme);
+  const mdProps: EmbeddableMDCustomProps = element.customData?.mdProps || null;
+
+  return (
+    <div
+      ref={containerRef}
+      style = {{
+        width: `100%`,
+        height: `100%`,
+        borderRadius: "var(--embeddable-radius)",
+        color: `var(--text-normal)`,
+      }}
+      className={`${theme} canvas-node ${
+        mdProps?.filenameVisible ? "" : "excalidraw-mdEmbed-hideFilename"}`}
+    >
+      <RenderObsidianView
+        mdProps={mdProps}
+        element={element}
+        linkText={linkText}
+        view={view}
+        containerRef={containerRef}
+        activeEmbeddable={appState.activeEmbeddable}
+        theme={appState.theme}
+        canvasColor={appState.viewBackgroundColor}
+      />
+    </div>
+  )
+}

src/dialogs/EmbeddableMDFileCustomDataSettingsComponent.ts

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

src/dialogs/EmbeddableSettings.ts

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

src/dialogs/ExportDialog.ts

@@ -1,6 +1,7 @@
 import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/types";
-import { Modal, Setting, SliderComponent, TFile } from "obsidian";
+import { Modal, Setting, TFile } from "obsidian";
 import { getEA } from "src";
+import { DEVICE } from "src/constants";
 import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
 import ExcalidrawView from "src/ExcalidrawView";
 import ExcalidrawPlugin from "src/main";
@@ -15,6 +16,8 @@ export class ExportDialog extends Modal {
   public transparent: boolean;
   public saveSettings: boolean;
   public dirty: boolean = false;
+  private selectedOnlySetting: Setting;
+  private hasSelectedElements: boolean = false;
   private boundingBox: {
     topX: number;
     topY: number;
@@ -22,6 +25,7 @@ export class ExportDialog extends Modal {
     height: number;
   };
   public embedScene: boolean;
+  public exportSelectedOnly: boolean;
   public saveToVault: boolean;
 
   constructor(
@@ -37,6 +41,7 @@ export class ExportDialog extends Modal {
     this.theme = getExportTheme(this.plugin, this.file, (this.api).getAppState().theme)
     this.boundingBox = this.ea.getBoundingBox(this.ea.getViewElements());
     this.embedScene = false;
+    this.exportSelectedOnly = false;
     this.saveToVault = true;
     this.transparent = !getWithBackground(this.plugin, this.file);
     this.saveSettings = false;
@@ -45,6 +50,9 @@ export class ExportDialog extends Modal {
   onOpen(): void {
     this.containerEl.classList.add("excalidraw-release");
     this.titleEl.setText(`Export Image`);
+    this.hasSelectedElements = this.view.getViewSelectedElements().length > 0;
+    //@ts-ignore
+    this.selectedOnlySetting.setVisibility(this.hasSelectedElements);
   }
 
   async onClose() {
@@ -95,99 +103,107 @@ export class ExportDialog extends Modal {
           })
       )
   
-    const themeMessage = () => `Export with ${this.theme} theme`;
-    const themeSetting = new Setting(this.contentEl)
-      .setName(themeMessage())
-      .setDesc(fragWithHTML("<b>Toggle on:</b> Export with light theme<br><b>Toggle off:</b> Export with dark theme"))
-      .addToggle(toggle =>
-        toggle
-          .setValue(this.theme === "dark" ? false : true)
+    new Setting(this.contentEl)
+      .setName("Export theme")
+      .addDropdown(dropdown => 
+        dropdown
+          .addOption("light","Light")
+          .addOption("dark","Dark")
+          .setValue(this.theme)
           .onChange(value => {
-            this.theme = value ? "light" : "dark";
-            themeSetting.setName(themeMessage());
+            this.theme = value;
           })
-        )
+      )
 
-    const transparencyMessage = () => `Export with ${this.transparent ? "transparent ":""}background`;
-    const transparentSetting = new Setting(this.contentEl)
-      .setName(transparencyMessage())
-      .setDesc(fragWithHTML("<b>Toggle on:</b> Export with transparent background<br><b>Toggle off:</b> Export with background"))
-      .addToggle(toggle =>
-        toggle
-          .setValue(this.transparent)
+    new Setting(this.contentEl)
+      .setName("Background color")
+      .addDropdown(dropdown => 
+        dropdown
+          .addOption("transparent","Transparent")
+          .addOption("with-color","Use scene background color")
+          .setValue(this.transparent?"transparent":"with-color")
           .onChange(value => {
-            this.transparent = value;
-            transparentSetting.setName(transparencyMessage())
+            this.transparent = value === "transparent";
           })
-        )
-
-    const saveSettingsMessage = () => this.saveSettings?"Save these settings as the preset for this image":"These are one-time settings"
-    const saveSettingsSetting= new Setting(this.contentEl)
-      .setName(saveSettingsMessage())
-      .setDesc(fragWithHTML("Saving these settings as preset will override general export settings for this image.<br><b>Toggle on: </b>Save as preset for this image<br><b>Toggle off: </b>Don't save as preset"))
-      .addToggle(toggle =>
-        toggle
-          .setValue(this.saveSettings)
+      )
+    
+    new Setting(this.contentEl)
+      .setName("Save or one-time settings?")
+      .addDropdown(dropdown => 
+        dropdown
+          .addOption("save","Save these settings as the preset for this image")
+          .addOption("one-time","These are one-time settings")
+          .setValue(this.saveSettings?"save":"one-time")
           .onChange(value => {
-            this.saveSettings = value;
-            saveSettingsSetting.setName(saveSettingsMessage())
+            this.saveSettings = value === "save";
           })
-        )
+      )
 
     this.contentEl.createEl("h1",{text:"Export settings"});
 
-    const embedSceneMessage = () => this.embedScene?"Embed scene":"Do not embed scene";
-    const embedSetting = new Setting(this.contentEl)
-      .setName(embedSceneMessage())
-      .setDesc(fragWithHTML("Embed the Excalidraw scene into the PNG or SVG image<br><b>Toggle on: </b>Embed scene<br><b>Toggle off: </b>Do not embed scene"))
-      .addToggle(toggle =>
-        toggle
-          .setValue(this.embedScene)
+    new Setting(this.contentEl)
+      .setName("Embed the Excalidraw scene in the exported file?")
+      .addDropdown(dropdown => 
+        dropdown
+          .addOption("embed","Embed scene")
+          .addOption("no-embed","Do not embed scene")
+          .setValue(this.embedScene?"embed":"no-embed")
           .onChange(value => {
-            this.embedScene = value;
-            embedSetting.setName(embedSceneMessage())
+            this.embedScene = value === "embed";
           })
-        )
+      )
 
-    if(this.plugin.device.isDesktop) {
-      const saveToMessage = () => this.saveToVault?"Save image to your Vault":"Export image outside your Vault";
-      const saveToSetting = new Setting(this.contentEl)
-        .setName(saveToMessage())
-        .setDesc(fragWithHTML("<b>Toggle on: </b>Save image to your Vault in the same folder as this drawing<br><b>Toggle off: </b>Save image outside your Vault"))
-        .addToggle(toggle =>
-          toggle
-            .setValue(this.saveToVault)
-            .onChange(value => {
-              this.saveToVault = value;
-              saveToSetting.setName(saveToMessage())
-            })
-          )
+    if(DEVICE.isDesktop) {
+      new Setting(this.contentEl)
+      .setName("Where to save the image?")
+      .addDropdown(dropdown => 
+        dropdown
+          .addOption("vault","Save image to your Vault")
+          .addOption("outside","Export image outside your Vault")
+          .setValue(this.saveToVault?"vault":"outside")
+          .onChange(value => {
+            this.saveToVault = value === "vault";
+          })
+      )
     }
 
+    this.selectedOnlySetting = new Setting(this.contentEl)
+      .setName("Export entire scene or just selected elements?")
+      .addDropdown(dropdown => 
+        dropdown
+          .addOption("all","Export entire scene")
+          .addOption("selected","Export selected elements")
+          .setValue(this.exportSelectedOnly?"selected":"all")
+          .onChange(value => {
+            this.exportSelectedOnly = value === "selected";
+          })
+      )
+
+
     const div = this.contentEl.createDiv({cls: "excalidraw-prompt-buttons-div"});
     const bPNG = div.createEl("button", { text: "PNG to File", cls: "excalidraw-prompt-button"});
     bPNG.onclick = () => {
       this.saveToVault 
-        ? this.view.savePNG()
-        : this.view.exportPNG();
+        ? this.view.savePNG(this.view.getScene(this.hasSelectedElements && this.exportSelectedOnly))
+        : this.view.exportPNG(this.embedScene,this.hasSelectedElements && this.exportSelectedOnly);
       this.close();
     };
     const bSVG = div.createEl("button", { text: "SVG to File", cls: "excalidraw-prompt-button" });
     bSVG.onclick = () => {
       this.saveToVault
-        ? this.view.saveSVG()
-        : this.view.exportSVG();
+        ? this.view.saveSVG(this.view.getScene(this.hasSelectedElements && this.exportSelectedOnly))
+        : this.view.exportSVG(this.embedScene,this.hasSelectedElements && this.exportSelectedOnly);
       this.close();
     };
     const bExcalidraw = div.createEl("button", { text: "Excalidraw", cls: "excalidraw-prompt-button" });
     bExcalidraw.onclick = () => {
-      this.view.exportExcalidraw();
+      this.view.exportExcalidraw(this.hasSelectedElements && this.exportSelectedOnly);
       this.close();
     };
-    if(this.plugin.device.isDesktop) {
+    if(DEVICE.isDesktop) {
       const bPNGClipboard = div.createEl("button", { text: "PNG to Clipboard", cls: "excalidraw-prompt-button" });
       bPNGClipboard.onclick = () => {
-        this.view.exportPNGToClipboard();
+        this.view.exportPNGToClipboard(this.embedScene, this.hasSelectedElements && this.exportSelectedOnly);
         this.close();
       };
     }

src/dialogs/FolderSuggester.ts

@@ -196,7 +196,7 @@ export abstract class SuggestionModal<T> extends FuzzySuggestModal<T> {
     // TODO: Figure out a better way to do this. Idea from Periodic Notes plugin
     this.app.keymap.pushScope(this.scope);
 
-    document.body.appendChild(this.suggestEl);
+    this.inputEl.ownerDocument.body.appendChild(this.suggestEl);
     this.popper = createPopper(this.inputEl, this.suggestEl, {
       placement: "bottom-start",
       modifiers: [
@@ -476,3 +476,91 @@ export class FolderSuggestionModal extends SuggestionModal<TFolder> {
     return this.folders;
   }
 }
+
+export class FileSuggestionModal extends SuggestionModal<TFile> {
+  text: TextComponent;
+  cache: CachedMetadata;
+  files: TFile[];
+  file: TFile;
+  constructor(app: App, input: TextComponent, items: TFile[]) {
+    super(app, input.inputEl, items);
+    this.limit = 20;
+    this.files = [...items];
+    this.text = input;
+    this.inputEl.addEventListener("input", () => this.getFile());
+  }
+
+  getFile() {
+    const v = this.inputEl.value;
+    const file = this.app.vault.getAbstractFileByPath(v);
+    if (file === this.file) {
+      return;
+    }
+    if (!(file instanceof TFile)) {
+      return;
+    }
+    this.file = file;
+
+    this.onInputChanged();
+  }
+
+  getSelectedItem() {
+    return this.file;
+  }
+
+  getItemText(item: TFile) {
+    return item.path;
+  }
+
+  onChooseItem(item: TFile) {
+    this.file = item;
+    this.text.setValue(item.path);
+    this.text.onChanged();
+  }
+
+  selectSuggestion({ item }: FuzzyMatch<TFile>) {
+    this.file = item;
+    this.text.setValue(item.path);
+    this.onClose();
+    this.text.onChanged();
+    this.close();
+  }
+  
+  renderSuggestion(result: FuzzyMatch<TFile>, el: HTMLElement) {
+    const { item, match: matches } = result || {};
+    const content = el.createDiv({
+      cls: "suggestion-content",
+    });
+    if (!item) {
+      content.setText(this.emptyStateText);
+      content.parentElement.addClass("is-selected");
+      return;
+    }
+
+    const pathLength = item.path.length - item.name.length;
+    const matchElements = matches.matches.map((m) => {
+      return createSpan("suggestion-highlight");
+    });
+    for (let i = pathLength; i < item.path.length; i++) {
+      const match = matches.matches.find((m) => m[0] === i);
+      if (match) {
+        const element = matchElements[matches.matches.indexOf(match)];
+        content.appendChild(element);
+        element.appendText(item.path.substring(match[0], match[1]));
+
+        i += match[1] - match[0] - 1;
+        continue;
+      }
+
+      content.appendText(item.path[i]);
+    }
+    el.createDiv({
+      cls: "suggestion-note",
+      text: item.path,
+    });
+  }
+
+  getItems() {
+    return this.files;
+  }
+}

src/dialogs/ImportSVGDialog.ts

@@ -1,5 +1,5 @@
 import { App, FuzzySuggestModal, TFile } from "obsidian";
-import { REG_LINKINDEX_INVALIDCHARS } from "../Constants";
+import { REG_LINKINDEX_INVALIDCHARS } from "../constants";
 import ExcalidrawView from "../ExcalidrawView";
 import { t } from "../lang/helpers";
 import ExcalidrawPlugin from "../main";
@@ -44,7 +44,7 @@ export class ImportSVGDialog extends FuzzySuggestModal<TFile> {
     const svg = await app.vault.read(item);
     if(!svg || svg === "") return;
     ea.importSVG(svg);
-    ea.addElementsToView(true, true, true);
+    ea.addElementsToView(true, true, true,true);
   }
 
   public start(view: ExcalidrawView) {

src/dialogs/InsertCommandDialog.ts

@@ -0,0 +1,41 @@
+import { App, FuzzySuggestModal, TFile } from "obsidian";
+import { REG_LINKINDEX_INVALIDCHARS } from "../constants";
+import { t } from "../lang/helpers";
+
+export class InsertCommandDialog extends FuzzySuggestModal<TFile> {
+  public app: App;
+  private addText: Function;
+
+  constructor(app: App) {
+    super(app);
+    this.app = app;
+    this.limit = 20;
+    this.setInstructions([
+      {
+        command: t("SELECT_COMMAND"),
+        purpose: "",
+      },
+    ]);
+    this.setPlaceholder(t("SELECT_COMMAND_PLACEHOLDER"));
+    this.emptyStateText = t("NO_MATCHING_COMMAND");
+  }
+
+  getItems(): any[] {
+    //@ts-ignore
+    return this.app.commands.listCommands();
+  }
+
+  getItemText(item: any): string {
+    return item.name;
+  }
+
+  onChooseItem(item: any): void {
+    const cmdId = item?.id;
+    this.addText(`⚙️[${item.name}](cmd://${item.id})`);
+  }
+
+  public start(addText: Function) {
+    this.addText = addText;
+    this.open();
+  }
+}

src/dialogs/InsertImageDialog.ts

@@ -1,6 +1,7 @@
 import { App, FuzzySuggestModal, TFile } from "obsidian";
+import { isALT, scaleToFullsizeModifier } from "src/utils/ModifierkeyHelper";
 import { fileURLToPath } from "url";
-import { IMAGE_TYPES, REG_LINKINDEX_INVALIDCHARS } from "../Constants";
+import { DEVICE, IMAGE_TYPES, REG_LINKINDEX_INVALIDCHARS } from "../constants";
 import ExcalidrawView from "../ExcalidrawView";
 import { t } from "../lang/helpers";
 import ExcalidrawPlugin from "../main";
@@ -25,11 +26,15 @@ export class InsertImageDialog extends FuzzySuggestModal<TFile> {
     this.emptyStateText = t("NO_MATCH");
     this.inputEl.onkeyup = (e) => {
       //@ts-ignore
-      if (e.key === "Enter" && e.altKey && this.chooser.values) {
+      if (e.key === "Enter" && scaleToFullsizeModifier(e) && this.chooser.values) {
         this.onChooseItem(
           //@ts-ignore
           this.chooser.values[this.chooser.selectedItem].item,
-          new KeyboardEvent("keypress",{altKey: true})
+          new KeyboardEvent("keypress",{
+            shiftKey: true,
+            metaKey: !(DEVICE.isIOS || DEVICE.isMacOS),
+            ctrlKey: (DEVICE.isIOS || DEVICE.isMacOS),
+          })
         );
         this.close();
       }
@@ -51,13 +56,12 @@ export class InsertImageDialog extends FuzzySuggestModal<TFile> {
   }
 
   onChooseItem(item: TFile, event: KeyboardEvent): void {
-    const ea = this.plugin.ea;
-    ea.reset();
-    ea.setView(this.view);
+    const ea = this.plugin.ea.getAPI(this.view);
     ea.canvas.theme = this.view.excalidrawAPI.getAppState().theme;
+    const scaleToFullsize = scaleToFullsizeModifier(event);
     (async () => {
-      await ea.addImage(0, 0, item, !event.altKey);
-      ea.addElementsToView(true, false, true);
+      await ea.addImage(0, 0, item, !scaleToFullsize);
+      ea.addElementsToView(true, true, true);
     })();
   }
 

src/dialogs/InsertLinkDialog.ts

@@ -1,5 +1,5 @@
 import { App, FuzzySuggestModal, TFile } from "obsidian";
-import { REG_LINKINDEX_INVALIDCHARS } from "../Constants";
+import { REG_LINKINDEX_INVALIDCHARS } from "../constants";
 import { t } from "../lang/helpers";
 
 export class InsertLinkDialog extends FuzzySuggestModal<TFile> {
@@ -45,7 +45,7 @@ export class InsertLinkDialog extends FuzzySuggestModal<TFile> {
         true,
       );
     }
-    this.addText(`[[${filepath + (item.alias ? `|${item.alias}` : "")}]]`);
+    this.addText(`[[${filepath + (item.alias ? `|${item.alias}` : "")}]]`, filepath, item.alias);
   }
 
   public start(drawingPath: string, addText: Function) {

src/dialogs/InsertPDFModal.ts

@@ -0,0 +1,424 @@
+import { ButtonComponent, TFile } from "obsidian";
+import ExcalidrawView from "../ExcalidrawView";
+import ExcalidrawPlugin from "../main";
+import { getPDFDoc } from "src/utils/FileUtils";
+import {  Modal, Setting, TextComponent } from "obsidian";
+import { FileSuggestionModal } from "./FolderSuggester";
+import { getEA } from "src";
+import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
+import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/types";
+
+export class InsertPDFModal extends Modal {
+  private borderBox: boolean = true;
+  private gapSize:number = 20;
+  private groupPages: boolean = false;
+  private direction: "down" | "right" = "right";
+  private numColumns: number = 1;
+  private numRows: number = 1;
+  private lockAfterImport: boolean = true;
+  private pagesToImport:number[] = [];
+  private pageDimensions: {width: number, height: number} = {width: 0, height: 0};
+  private importScale = 0.3;
+  private imageSizeMessage: HTMLElement;
+  private pdfDoc: any;
+  private pdfFile: TFile;
+  private dirty: boolean = false;
+
+  constructor(
+    private plugin: ExcalidrawPlugin,
+    private view: ExcalidrawView,
+  ) {
+    super(app);
+  }
+
+  open (file?: TFile) {
+    if(file && file.extension.toLowerCase() === "pdf") {
+      this.pdfFile = file;
+    }
+    super.open();
+  }
+
+  onOpen(): void {
+    this.containerEl.classList.add("excalidraw-release");
+    this.titleEl.setText(`Import PDF`);
+    this.createForm();
+  }
+
+  async onClose() {
+    if(this.dirty) {
+      this.plugin.settings.pdfImportScale = this.importScale;
+      this.plugin.settings.pdfBorderBox = this.borderBox;
+      this.plugin.settings.pdfGapSize = this.gapSize;
+      this.plugin.settings.pdfGroupPages = this.groupPages;
+      this.plugin.settings.pdfNumColumns = this.numColumns;
+      this.plugin.settings.pdfNumRows = this.numRows;
+      this.plugin.settings.pdfDirection = this.direction;
+      this.plugin.settings.pdfLockAfterImport = this.lockAfterImport;
+      this.plugin.saveSettings();
+    }
+    if(this.pdfDoc) {
+      this.pdfDoc.destroy();
+      this.pdfDoc = null;
+    }
+  }
+
+  private async getPageDimensions (pdfDoc: any) {
+    try {
+      const scale = this.plugin.settings.pdfScale;
+      const canvas = createEl("canvas");
+      const page = await pdfDoc.getPage(1);
+      // Set scale
+      const viewport = page.getViewport({ scale });
+      this.pageDimensions.height = viewport.height; 
+      this.pageDimensions.width = viewport.width;
+
+      //https://github.com/excalidraw/excalidraw/issues/4036
+      canvas.width = 0;
+      canvas.height = 0;
+      this.setImageSizeMessage();
+    } catch(e) {
+      console.log(e);
+    }
+  }
+
+
+  /**
+   * Creates a list of numbers from page ranges representing the pages to import.
+   * sets the pagesToImport property.
+   * @param pageRanges A string representing the pages to import. e.g.: 1,3-5,7,9-10
+   * @returns A list of numbers representing the pages to import.
+   */
+  private createPageListFromString(pageRanges:string):number[] {
+    const cleanNonDigits = (str:string) => str.replace(/\D/g, "");
+    this.pagesToImport = [];
+    const pageRangesArray:string[] = pageRanges.split(",");
+    pageRangesArray.forEach((pageRange) => {
+      const pageRangeArray = pageRange.split("-");
+      if(pageRangeArray.length === 1) {
+        const page = parseInt(cleanNonDigits(pageRangeArray[0]));
+        !isNaN(page) && this.pagesToImport.push(page);
+      } else if(pageRangeArray.length === 2) {
+
+        const start = parseInt(cleanNonDigits(pageRangeArray[0]));
+        const end = parseInt(cleanNonDigits(pageRangeArray[1]));
+        if(isNaN(start) || isNaN(end)) return;
+        for(let i = start; i <= end; i++) {
+          this.pagesToImport.push(i);
+        }
+      }
+    });
+    return this.pagesToImport;
+  }
+
+  private setImageSizeMessage = () => this.imageSizeMessage.innerText = `${Math.round(this.pageDimensions.width*this.importScale)} x ${Math.round(this.pageDimensions.height*this.importScale)}`;
+
+  async createForm() {
+    await this.plugin.loadSettings();
+    this.borderBox = this.plugin.settings.pdfBorderBox;
+    this.gapSize = this.plugin.settings.pdfGapSize;
+    this.groupPages = this.plugin.settings.pdfGroupPages;
+    this.numColumns = this.plugin.settings.pdfNumColumns;
+    this.numRows = this.plugin.settings.pdfNumRows;
+    this.direction = this.plugin.settings.pdfDirection;
+    this.lockAfterImport = this.plugin.settings.pdfLockAfterImport;
+    this.importScale = this.plugin.settings.pdfImportScale;
+
+    const ce = this.contentEl;   
+
+
+    let numPagesMessage: HTMLParagraphElement;
+    let numPages: number;
+    let importButton: ButtonComponent;
+    let importMessage: HTMLElement;
+    
+    const importButtonMessages = () => {
+      if(!this.pdfDoc) {
+        importMessage.innerText = "Please select a PDF file";
+        importButton.buttonEl.style.display="none";
+        return;
+      }      
+      if(this.pagesToImport.length === 0) {
+        importButton.buttonEl.style.display="none";
+        importMessage.innerText = "Please select pages to import";
+        return
+      }
+      if(Math.max(...this.pagesToImport) <= this.pdfDoc.numPages) {
+        importButton.buttonEl.style.display="block";
+        importMessage.innerText = "";
+        return;
+      }
+      else {
+        importButton.buttonEl.style.display="none";
+        importMessage.innerText = `The selected document has ${this.pdfDoc.numPages} pages. Please select pages between 1 and ${this.pdfDoc.numPages}`;
+        return
+      }
+    }
+
+    const numPagesMessages = () => {
+      if(numPages === 0) {
+        numPagesMessage.innerText = "Please select a PDF file";
+        return;
+      }
+      numPagesMessage.innerHTML = `There are <b>${numPages}</b> pages in the selected document.`;
+    }
+
+    const setFile = async (file: TFile) => {
+      if(this.pdfDoc) await this.pdfDoc.destroy();
+      this.pdfDoc = null;
+
+      if(file) {
+        this.pdfDoc = await getPDFDoc(file);
+        this.pdfFile = file;
+        if(this.pdfDoc) {
+          numPages = this.pdfDoc.numPages;
+          importButtonMessages();
+          numPagesMessages();
+          this.getPageDimensions(this.pdfDoc);
+        } else {
+          importButton.setDisabled(true);
+        }
+      } 
+    }
+
+    const search = new TextComponent(ce);
+    search.inputEl.style.width = "100%";
+    const suggester = new FileSuggestionModal(this.app, search,app.vault.getFiles().filter((f: TFile) => f.extension.toLowerCase() === "pdf"));
+    search.onChange(async () => {
+      const file = suggester.getSelectedItem();
+      await setFile(file);
+    });
+    
+    numPagesMessage = ce.createEl("p", {text: ""});
+    numPagesMessages();
+    let importPagesMessage: HTMLParagraphElement;
+    let pageRangesTextComponent: TextComponent
+    new Setting(ce)
+      .setName("Pages to import")
+      .addText(text => {
+        pageRangesTextComponent = text;
+        text
+          .setPlaceholder("e.g.: 1,3-5,7,9-10")
+          .onChange((value) => {
+            const pages = this.createPageListFromString(value);
+            if(pages.length > 15) {
+              importPagesMessage.innerHTML = `You are importing <b>${pages.length}</b> pages. ⚠️ This may take a while. ⚠️`;
+            } else {
+              importPagesMessage.innerHTML = `You are importing <b>${pages.length}</b> pages.`;
+            }
+            importButtonMessages();
+          })
+        text.inputEl.style.width = "100%";
+      })
+    importPagesMessage = ce.createEl("p", {text: ""});
+    
+    new Setting(ce)
+      .setName("Add border box")
+      .addToggle(toggle => toggle
+        .setValue(this.borderBox)
+        .onChange((value) => {
+          this.borderBox = value;
+          this.dirty = true;
+        }))
+
+    new Setting(ce)
+      .setName("Group pages")
+      .setDesc("This will group all pages into a single group. This is recommended if you are locking the pages after import, because the group will be easier to unlock later rather than unlocking one by one.")
+      .addToggle(toggle => toggle
+        .setValue(this.groupPages)
+        .onChange((value) => {
+          this.groupPages = value
+          this.dirty = true;
+        }))
+  
+        
+    new Setting(ce)
+      .setName("Lock pages on canvas after import")
+      .addToggle(toggle => toggle
+        .setValue(this.lockAfterImport)
+        .onChange((value) => {
+          this.lockAfterImport = value
+          this.dirty = true;
+        }))
+
+    let numColumnsSetting: Setting;
+    let numRowsSetting: Setting;
+    const colRowVisibility = () => {
+      switch(this.direction) {
+        case "down":
+          numColumnsSetting.settingEl.style.display = "none";
+          numRowsSetting.settingEl.style.display = "";
+          break;
+        case "right":
+          numColumnsSetting.settingEl.style.display = "";
+          numRowsSetting.settingEl.style.display = "none";
+          break;
+      }
+    }
+    
+    new Setting(ce)
+      .setName("Import direction")
+      .addDropdown(dropdown => dropdown
+        .addOptions({
+          "down": "Top > Down",
+          "right": "Left > Right"
+        })
+        .setValue(this.direction)
+        .onChange(value => {
+          this.direction = value as "down" | "right";
+          colRowVisibility();
+          this.dirty = true;
+        }))
+
+    let columnsText: HTMLDivElement;
+    numColumnsSetting = new Setting(ce);
+    numColumnsSetting
+      .setName("Number of columns")
+      .addSlider(slider => slider
+        .setLimits(1, 100, 1)
+        .setValue(this.numColumns)
+        .onChange(value => {
+          this.numColumns = value;
+          columnsText.innerText = ` ${value.toString()}`;
+          this.dirty = true;
+        }))
+      .settingEl.createDiv("", (el) => {
+        columnsText = el;
+        el.style.minWidth = "2.3em";
+        el.style.textAlign = "right";
+        el.innerText = ` ${this.numColumns.toString()}`;
+      });
+
+    let rowsText: HTMLDivElement;
+    numRowsSetting = new Setting(ce);
+    numRowsSetting
+      .setName("Number of rows")
+      .addSlider(slider => slider
+        .setLimits(1, 100, 1)
+        .setValue(this.numRows)
+        .onChange(value => {
+          this.numRows = value;
+          rowsText.innerText = ` ${value.toString()}`;
+          this.dirty = true;
+        }))
+      .settingEl.createDiv("", (el) => {
+        rowsText = el;
+        el.style.minWidth = "2.3em";
+        el.style.textAlign = "right";
+        el.innerText = ` ${this.numRows.toString()}`;
+      });
+    colRowVisibility();
+
+    let gapSizeText: HTMLDivElement;
+    new Setting(ce)
+      .setName("Size of gap between pages")
+      .addSlider(slider => slider
+        .setLimits(10, 200, 10)
+        .setValue(this.gapSize)
+        .onChange(value => {
+          this.gapSize = value;
+          gapSizeText.innerText = ` ${value.toString()}`;
+          this.dirty = true;
+        }))
+      .settingEl.createDiv("", (el) => {
+        gapSizeText = el;
+        el.style.minWidth = "2.3em";
+        el.style.textAlign = "right";
+        el.innerText = ` ${this.gapSize.toString()}`;
+      });
+
+    const importSizeSetting = new Setting(ce)
+      .setName("Imported page size")
+      .setDesc(`${this.pageDimensions.width*this.importScale} x ${this.pageDimensions.height*this.importScale}`)
+      .addSlider(slider => slider
+        .setLimits(0.1, 1.5, 0.1)
+        .setValue(this.importScale)
+        .onChange(value => {
+          this.importScale = value;
+          this.dirty = true;
+          this.setImageSizeMessage();
+        }))
+    
+    this.imageSizeMessage = importSizeSetting.descEl;
+
+    const actionButton = new Setting(ce)
+      .setDesc("Select a document first")
+      .addButton(button => {
+        button
+          .setButtonText("Import PDF")
+          .setCta()
+          .onClick(async () => {
+            const ea = getEA(this.view) as ExcalidrawAutomate;
+            let column = 0;
+            let row = 0;
+            const imgWidth = Math.round(this.pageDimensions.width*this.importScale);
+            const imgHeight = Math.round(this.pageDimensions.height*this.importScale);
+            for(let i = 0; i < this.pagesToImport.length; i++) {
+              const page = this.pagesToImport[i];
+              importMessage.innerText = `Importing page ${page} (${i+1} of ${this.pagesToImport.length})`;
+              const topX = Math.round(this.pageDimensions.width*this.importScale*column + this.gapSize*column);
+              const topY = Math.round(this.pageDimensions.height*this.importScale*row + this.gapSize*row);
+
+              ea.style.strokeColor = this.borderBox ? "#000000" : "transparent";
+              const boxID = ea.addRect(
+                topX,
+                topY,
+                imgWidth,
+                imgHeight
+              );
+              const boxEl = ea.getElement(boxID) as any;
+              if(this.lockAfterImport) boxEl.locked = true;
+
+              const imageID = await ea.addImage(
+                topX,
+                topY,
+                this.pdfFile.path + `#page=${page}`,
+                false,
+                false);
+              const imgEl = ea.getElement(imageID) as any;
+              imgEl.width = imgWidth;
+              imgEl.height = imgHeight;
+              if(this.lockAfterImport) imgEl.locked = true;
+
+              ea.addToGroup([boxID,imageID]);
+              
+              switch(this.direction) {
+                case "right":
+                  column = (column + 1) % this.numColumns;
+                  if(column === 0) row++;
+                  break;
+                case "down":
+                  row = (row + 1) % this.numRows;
+                  if(row === 0) column++;
+                  break;
+              }
+            }
+            if(this.groupPages) {
+              const ids = ea.getElements().map(el => el.id);
+              ea.addToGroup(ids);
+            }
+            await ea.addElementsToView(true,true,false);
+            const api = ea.getExcalidrawAPI() as ExcalidrawImperativeAPI;
+            const ids = ea.getElements().map(el => el.id);
+            const viewElements = ea.getViewElements().filter(el => ids.includes(el.id));
+            api.selectElements(viewElements);
+            api.zoomToFit(viewElements);
+            this.close();
+          })
+        importButton = button;
+        importButton.buttonEl.style.display = "none";
+      });
+    importMessage = actionButton.descEl;
+    importMessage.addClass("mod-warning");
+    if(this.pdfFile) {
+      search.setValue(this.pdfFile.path);
+      await setFile(this.pdfFile); //on drop if opened with a file
+      suggester.close();
+      pageRangesTextComponent.inputEl.focus();
+    } else {
+      search.inputEl.focus();
+    }
+
+    importButtonMessages();
+  }
+}
+

src/dialogs/Messages.ts

@@ -17,6 +17,689 @@ I develop this plugin as a hobby, spending my free time doing this. If you find
 
 <div class="ex-coffee-div"><a href="https://ko-fi.com/zsolt"><img src="https://cdn.ko-fi.com/cdn/kofi3.png?v=3" height=45></a></div>
 `,
+"2.0.1":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/xmqiBTrlbEM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## Fixed
+- bug with cssclasses in frontmatter
+- styling of help screen keyboard shortcuts [#1437](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1437)
+`,
+"2.0.0":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/JC1E-jeiWhI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New
+- Added support for applying CSS classes in frontmatter. Now, when embedding Excalidraw drawings into Obsidian Canvas, you can use [Canvas Candy](https://tfthacker.com/canvas-candy) classes. For instance, ${String.fromCharCode(96)}cssclasses: cc-border-none${String.fromCharCode(96)} removes the canvas node border around the drawing.
+- Introduced new context menu actions:
+  - Navigate to link or embedded image.
+  - Add any file from the vault to the canvas.
+  - Convert the selected text element or sticky note to an embedded markdown file.
+  - Add a link from the Vault to the selected element.
+- Frames are now rendered in exported images.
+- SVG Export includes the ${String.fromCharCode(96)}.excalidraw-svg${String.fromCharCode(96)} class, enabling post-processing of SVGs using publish.js when using custom domains with Obsidian Publish. Also, added a command palette action ${String.fromCharCode(96)}Obsidian Publish: Find SVG and PNG exports that are out of date${String.fromCharCode(96)}.
+- Added a new Command palette action to open the corresponding Excalidraw file based on the embedded SVG or PNG file. ${String.fromCharCode(96)}Open Excalidraw Drawing${String.fromCharCode(96)} [Issue #1411](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1411)
+
+## Fixed and Improved
+- Resolved issue with the Mermaid Timeline graph displaying all black. [Issue #1424](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1424)
+- Enabled toggling pen mode off after activation by a pen touch.
+- Now you are able to unlock elements on mobile; previously, locked elements couldn't be selected.
+- Fixed the disabled ${String.fromCharCode(96)}complete line button${String.fromCharCode(96)} for multipoint lines on mobile.
+![Mobile Editing Image](https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/e7051c75-818f-4800-ba16-ac276e229184)
+
+`,
+"1.9.28":`
+## Fixed & Improved
+- Fixed an issue where the toolbar lost focus, requiring two clicks. This caused a problem when the hand tool was activated from ExcalidrawAutomate script when opening a drawing, causing buttons to stop working. [#1344](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1344)
+- Resolved a caching issue affecting image area-links and group-links, making them work inconsistently. For more details, refer to the discussion on [Discord](https://discord.com/channels/1026825302900494357/1169311900308361318).
+- Improved frame colors with Dynamic Coloring.
+- Added support for multiline LaTeX formulas. [#1403](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1403)
+- Fixed the issue of Chinese characters overlapping in MathJax. [#1406](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1406)
+
+## New
+- Added support for Mermaid to Excalidraw **Sequence Diagrams**.
+- If an image contains an element link, clicking on the image will now open the link chooser, allowing you to decide whether to open the image or follow the element link.
+- When hovering over an image that also has an element link, the hover preview will display the contents of the link.
+- You can now choose to **import PDFs** in columns instead of rows. Additionally, you have the option to group all pages after import, which will improve the unlocking experience if you also lock pages on import.
+- Introduced configuration options for the **Laser Tool**, including pointer color, decay length, and time. ([#1408](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1408), [#1220](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1220))
+
+![image](https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/c0cad40a-1afc-42af-b41b-f912dd8a4e78)
+`,
+"1.9.27": `
+## New
+- Restructured plugin settings, added additional comments and relevant videos
+- Added setting to change PDF to Image resolution/scale. This has an effect when embedding PDF pages to Excalidraw. A lower value will result in less-sharp pages, but better overall performance. Also, larger pages (higher scale value) were not accepted by Excalidraw.com when copying from Obsidian due to the 2MB image file limit.  Find the "PDF to Image" setting under "Embedding Excalidraw into your Notes and Exporting" setting. [#1393](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1393)
+
+## Fixed
+- When multiple Excalidraw Scripts were executed parallel a race condition occurred causing scripts to override each other
+- I implemented a partial fix to "text detaching from figures when dragging them" [#1400](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1400)
+- Regression: extra thin stroke removed with 1.9.26 [#1399](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1399)`,
+"1.9.26":`
+## Fixes and improvements from Excalidraw.com
+- Freedraw shape selection issue, when fill-pattern is not solid [#7193](https://github.com/excalidraw/excalidraw/pull/7193)
+- Actions panel UX improvement [#6850](https://github.com/excalidraw/excalidraw/pull/6850)
+
+## Fixed in plugin
+- After inserting PDF pages as image the size of inserted images were incorrectly anchored preventing resizing of pages. The fix does not solve the issue with already imported pages, but pages you import in the future will not be anchored. 
+- Mobile toolbar flashes up on tab change on desktop
+- Toolbar buttons are active on the first click after opening a drawing. This addresses the "hand" issue raised here: [#1344](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1344)
+`,
+"1.9.25":`
+## Fixed
+- Fixed issues with creating Markdown or Excalidraw files for non-existing documents [#1385](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1385)
+- Resolved a bug where changing the section/block filter after duplicating a markdown embeddable now works correctly on the first attempt [#1387](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1387)
+
+## New
+- Easily create a markdown file and embed it as an embedded frame with a single click when clicking a link pointing to a non-existent file.
+![image](https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/4b9de54d-2382-4a52-b500-918ba2a60133)
+- Offline LaTeX support. The MathJax package is now included in the plugin, eliminating the need for an internet connection. [#1383](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1383), [#936](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/936), [#1289](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1289)
+
+## Minor Updates from excalidraw.com
+- Improved the laser pointer in dark mode.
+- Removed bound arrows from frames.
+- Enhanced fill rendering.
+- Maintained the z-order of elements added to frames.
+
+## New in ExcalidrawAutomate
+- Introduced two LZString functions in ExcalidrawAutomate:
+${String.fromCharCode(96,96,96)}typescript
+compressToBase64(str:string):string;
+decompressFromBase64(str:string):string;
+${String.fromCharCode(96,96,96)}
+`,
+"1.9.24":`
+## Fixed
+- Resolved some hidden Image and Backup Cache initialization errors.
+
+## New Features
+- Introducing the ${String.fromCharCode(96)}[[cmd://cmd-id]]${String.fromCharCode(96)} link type, along with a new Command Palette Action: ${String.fromCharCode(96)}Insert Obsidian Command as a link${String.fromCharCode(96)}. With this update, you can now add any command available on the Obsidian Command palette as a link in Excalidraw. When you click the link, the corresponding command will be executed. This feature opens up exciting possibilities for automating your drawings by creating Excalidraw Scripts and attaching them to elements.
+
+- I am thrilled to announce that you can now embed images directly from your local hard drive in Excalidraw. These files won't be moved into Obsidian. Please note, however, that these images won't be synchronized across your other devices. [#1365](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1365)
+
+Check out the [updated keyboard map](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/excalidraw-modifiers.png)
+
+<a href="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/excalidraw-modifiers.png"><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/excalidraw-modifiers.png" width="100%" alt="Keyboard map"/></a>
+
+Stay creative and productive with Excalidraw!
+`,
+"1.9.23":`
+## Fixed
+- Link navigation error in view mode introduced with 1.9.21 [#7120](https://github.com/excalidraw/excalidraw/pull/7120)
+`,
+"1.9.21":`
+## Fixed:
+- When moving a group of objects on the grid, each object snapped separately resulting in a jumbled-up image [#7082](https://github.com/excalidraw/excalidraw/issues/7082)
+
+## New from Excalidraw.com:
+- 🎉 Laser Pointer. Press "K" to activate the laser pointer, or find it under more tools. In View-Mode double click/tap the canvas to toggle the laser pointer
+
+![image](https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/d3fc079d-9428-4a93-9a9b-1947ce9b6b57)
+`,
+"1.9.20":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/QB2rKRxxYlg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## Fixed
+- Fourth Font displays correctly in SVG embeds mode
+- The re-colorMap map (see [1.9.19](https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/1.9.19) for more info) did not work when either of the fill or stroke color properties of the image was missing.
+- Excalidraw Pasting with middle mouse button on Linux [#1338](https://github.com/zsviczian/obsidian-excalidraw-plugin/pull/1338) 🙏@Aeases 
+
+### Fixed by excalidraw.com
+- Excalidraw's native eyedropper fixes [#7019](https://github.com/excalidraw/excalidraw/pull/7019)
+
+## New
+- Now you can insert [Mermaid](https://mermaid.live/) diagrams as Excalidraw elements into your drawings (currently only the [Flowchart](https://mermaid.js.org/syntax/flowchart.html) type is supported, [other diagram types](https://mermaid.js.org/intro/#diagram-types) are inserted as Mermaid native images. 
+  - ⚠️**This feature requires Obsidian API v1.4.14 (the latest desktop version). On Obsidian mobile API v1.4.14 is only available to Obsidian insiders currently**
+  - If you want to contribute to the project please head over to [mermaid-to-excalidraw](https://github.com/excalidraw/mermaid-to-excalidraw) and help create the converters for the other diagram types.
+- The Fourth Font now also supports the OTF format
+- Disable snap-to-grid in grid mode by holding down the CTRL/CMD while drawing or moving an element [#6983](https://github.com/excalidraw/excalidraw/pull/6983)
+- I updated the Excalidraw logo in Obsidian. This affects the logo on the tab and the ribbon.
+
+### New from excalidraw.com
+- Elements alignment snapping. Hold down the CTRL/CMD button while moving an element to snap it to other objects. [#6256](https://github.com/excalidraw/excalidraw/pull/6256)
+
+### New in the script library
+- The amazing shape [Boolean Operations](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Boolean%20Operations.md) script created by 🙏@GColoy is available in the script library.
+
+### New in Excalidraw Automate
+- ${String.fromCharCode(96)}getPolyBool()${String.fromCharCode(96)} returns a [PolyBool](https://github.com/velipso/polybooljs) object
+- sample mermaid code:
+${String.fromCharCode(96,96,96)}js
+ea = ExcalidrawAutomate();
+ea.setView();
+await ea.addMermaid(
+  ${String.fromCharCode(96)}flowchart TD
+    A[Christmas] -->|Get money| B(Go shopping)
+    B --> C{Let me think}
+    C -->|One| D[Laptop]
+    C -->|Two| E[iPhone]
+    C -->|Three| F[fa:fa-car Car]${String.fromCharCode(96)}
+);
+ea.addElementsToView();
+${String.fromCharCode(96,96,96)}`,
+"1.9.19":`
+## New
+- I added new features to the [Deconstruct Selected Elements](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Deconstruct%20selected%20elements%20into%20new%20drawing.md) script
+- I added a new script: [Text Aura](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Text%20Aura.md)
+- I updated the [Set Grid](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Set%20Grid.md) script. You can now set the Major/Minor tick frequency. [#1305](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1305)
+- The re-colorMap is now case-insensitive. The color map is a hidden feature. In Markdown View mode you can add a JSON map after the embedded SVG or Excalidraw image filename with a mapping of current colors to new colors.
+<img width="100%" src="https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/1d985a59-a2d2-48a2-9cef-686bfbe9ef02"/>
+
+## New in ExcalidrawAutomate
+- I added the ${String.fromCharCode(96)}silent${String.fromCharCode(96)} switch. If this is true, the created file will not be opened.
+${String.fromCharCode(96,96,96)}typescript
+  async create(params?: {
+    filename?: string;
+    foldername?: string;
+    templatePath?: string;
+    onNewPane?: boolean;
+    silent?: boolean;
+    frontmatterKeys?: {
+      "excalidraw-plugin"?: "raw" | "parsed";
+      "excalidraw-link-prefix"?: string;
+      "excalidraw-link-brackets"?: boolean;
+      "excalidraw-url-prefix"?: string;
+      "excalidraw-export-transparent"?: boolean;
+      "excalidraw-export-dark"?: boolean;
+      "excalidraw-export-padding"?: number;
+      "excalidraw-export-pngscale"?: number;
+      "excalidraw-default-mode"?: "view" | "zen";
+      "excalidraw-onload-script"?: string;
+      "excalidraw-linkbutton-opacity"?: number;
+      "excalidraw-autoexport"?: boolean;
+    };
+    plaintext?: string; //text to insert above the ${String.fromCharCode(96)}# Text Elements${String.fromCharCode(96)} section
+  }): Promise<string>
+${String.fromCharCode(96,96,96)}
+`,
+"1.9.18":`
+## New
+- Excalidraw now syncs with Obsidian's language settings, provided translations are available. [#1297](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1297)
+
+## Fixed
+- [#1285](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1285): Solved Obsidian crashes caused by copying images from Excalidraw into markdown notes. Going forward:
+  - Copying an image will paste its embed link,
+  - Copying a text element will paste the text,
+  - For all other elements with links, the link will be pasted.
+  - In all other cases nothing will be pasted.
+  
+- Resolved grid instability ([#1298](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1298)).
+- Fixed missing ${String.fromCharCode(96)}[[square brackets]]${String.fromCharCode(96)} in PDF section references, making the links functional.
+- Corrected the behavior of "Open current link in browser" for embedded YouTube and Vimeo frames. Clicking the globe button will now correctly open the links.
+`,
+"1.9.17":`
+## New 
+- Significant performance improvements from Excalidraw.com
+- When selecting a highlight in the Obsidian PDF editor and selecting "Copy as Quote" in the context menu, then paste this to Excalidraw, the text will arrive as a text element wrapped in a transparent sticky note with the link to the original highlight attached to the sticky note. You can override this behavior by SHIFT+CTRL/CMD pasting
+
+## Fixed
+- BUG: Image caching issue. Changes to the drawing do not reflect immediately in the note when re-opening the drawing [#1297](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1279)
+- Removed underline from links in NativeSVG embed.
+`,
+"1.9.16":`
+I apologize for this extra release. I accidentally built 1.9.15 with an older excalidraw.com package version. Fixes and new features (like the improved grid) are now available again. Otherwise, this is the same as 1.9.15. Sorry for the inconvenience.
+`,
+"1.9.15":`
+## New
+- There is now a search box in the Excliadraw Script Store. I categorized the scripts and added keywords to help easier navigation.
+
+## Fixed
+- The theme of the embedded Markdown document did not always honor plugin settings. With some themes, it worked, with others (including the default Obsidian theme, it didn't). 
+`,
+"1.9.14":`
+# Fixed
+- **Dynamic Styling**: Excalidraw ${String.fromCharCode(96)}Plugin Settings/Display/Dynamic Styling${String.fromCharCode(96)} did not handle theme changes correctly.
+- **Section References**: Section Headings that contained a dot (e.g. #2022.01.01) (or other special characters) did not work when focusing markdown embeds to a section. [#1262](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1262)
+- **PNG Export**: When using images from the web (i.e. based on URL and not a file from your Vault), embedding the Excalidraw file into a markdown document as PNG, or exporting as PNG failed. This is because due to browser cross-origin restrictions, Excalidraw is unable to access the image. In such cases, a placeholder will be included in the export, but the export will not fail, as until now.
+
+# New in ExcalidrawAutomate
+- ${String.fromCharCode(96)}getActiveEmbeddableViewOrEditor${String.fromCharCode(96)} will return the active editor and file in case of a markdown document or the active leaf.view for other files (e.g. PDF, MP4 player, Kanban, Canvas, etc) of the currently active embedded object. This function can be used by plugins to check if an editor is available and obtain the view or editor to perform their actions. Example: [package.json](https://github.com/zsviczian/excalibrain/blob/2056a021af7c3a53ed08203a77f6eae304ca6e39/package.json#L23), [Checking for EA](https://github.com/zsviczian/excalibrain/blob/2056a021af7c3a53ed08203a77f6eae304ca6e39/src/excalibrain-main.ts#L114-L127), and [Running the function](https://github.com/zsviczian/excalibrain/blob/2056a021af7c3a53ed08203a77f6eae304ca6e39/src/excalibrain-main.ts#L362-L399)
+
+${String.fromCharCode(96,96,96)}typescript
+public getActiveEmbeddableViewOrEditor (view?:ExcalidrawView): {view:any}|{file:TFile, editor:Editor}|null;
+${String.fromCharCode(96,96,96)}
+`,
+"1.9.13":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/opLd1SqaH_I" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+# New
+- **Templater support**: You can now execute Templater scripts on an embedded Markdown document when the document is active for editing
+- **Interactive image-embeds**: I added a new image embed option "SVG Native". In "SVG Native" mode embedded items such as videos, webpages, and links (including links within the Vault) work.
+- **Anchored image resizing**: When you embed an Excalidraw drawing using the Anchor to 100% option, resizing the image will be disabled.
+
+# Fixed
+- when opening a new document in the Excalidraw view while a markdown document was open for editing in an embeddable, Excalidraw terminated with errors
+- shift-click to select multiple elements
+- dynamic styling when canvas background with transparent
+ 
+# New in ExcalidrawAutomate
+- added openState to the ${String.fromCharCode(96)}openFileInNewOrAdjacentLeaf${String.fromCharCode(96)}. For details see: [OpenViewState](https://github.com/obsidianmd/obsidian-api/blob/f86f95386d439c19d9a77831d5cac5748d80e7ec/obsidian.d.ts#L2686-L2695)
+${String.fromCharCode(96,96,96)}typescript
+openFileInNewOrAdjacentLeaf(file: TFile, openState?: OpenViewState): WorkspaceLeaf
+${String.fromCharCode(96,96,96)}
+`,
+"1.9.12":`
+## New
+- If you create a Text Element that includes only a transclusion e.g.: ${String.fromCharCode(96)}![[My Image.png]]${String.fromCharCode(96)} then excalidraw will automatically replace the transclusion with the embedded image.
+- New Excalidraw splash screen icon contributed by Felix Häberle. 😍
+
+<div class="excalidraw-image-wrapper">
+<img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/excalidraw-sword-mini.png'/>
+</div>
+
+## Fixed
+- Popout windows behaved inconsistently losing focus at the time when a markdown file was embedded. Hopefully, this is now working as intended.
+- A number of small fixes that will also improve the ExcaliBrain experience
+`,
+"1.9.11":`
+# New
+- I added 2 new command palette actions: 1) to toggle frame clipping and 2) to toggle frame rendering.
+
+# Updated
+- I released a minor update to the slideshow script. Frame sequence (Frame 1, 2, 3, ...) will now be displayed in proper order. Frames will be hidden during the presentation (this was there before, but there was a change to excalidraw.com that broke this feature of the slideshow script).
+
+# Fixed: 
+- Excalidraw Automate error introduced with 1.9.10 - when elements are repositioned to cursor and no ExcalidrawView is active
+`,
+"1.9.10":`
+## New
+- @mazurov added a new script: [Ellipse Selected Elements](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Ellipse%20Selected%20Elements.md)
+
+## Fixed
+- **Image Saving Error**: Previously, inserting an image from Firebase Storage or other URLs could result in an error that prevented the entire drawing from being saved. I have now improved the error handling and image fetching from the web, ensuring smooth image insertion and saving.  
+- **Text Search Bug**: There was an issue where text search failed when frames had default names like "Frame 1," "Frame 2," etc. This has been resolved, and now the text search works correctly in such cases. ([#1239](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1239))   
+- **Image Positioning Fix**: An annoying bug caused the image to jump after inserting it using the "Insert Image" command palette action. I've fixed this issue, and now the image behaves as expected when positioning it for the first time.
+`,
+"1.9.9":`
+## ⚠️⚠️ IMPORTANT: PLEASE READ ⚠️⚠️
+
+I updated embedded frames for compatibility with excalidraw.com. To ensure everything works smoothly:
+
+🔄 Update Excalidraw on all your devices.
+
+This will avoid any issues with converted files and let you enjoy the new features seamlessly.
+
+Thank you for your understanding. If you have any questions, feel free to reach out.
+
+---
+
+## Fixed:
+- PNG image caching resulting in broken images after Obsidian restarts
+- SVG export now displays embedded iframes with the correct embed link (note this feature only works when you open the SVGs in a browser outside Obsidian).
+
+## Updated / fixed in Excalidraw Automate
+- I updated ${String.fromCharCode(96)}lib/ExcalidrawAutomate.d.ts${String.fromCharCode(96)} and published a new version of obsidian-excalidraw-plugin type library to npmjs.
+- Added new ExcalidrawAutomate functions: ${String.fromCharCode(96)} addEmbeddable()${String.fromCharCode(96)}, ${String.fromCharCode(96)}DEVICE${String.fromCharCode(96)}, ${String.fromCharCode(96)}newFilePrompt()${String.fromCharCode(96)}, and ${String.fromCharCode(96)}getLeaf()${String.fromCharCode(96)}
+- ${String.fromCharCode(96)}addImage${String.fromCharCode(96)} and ${String.fromCharCode(96)}addElementsToView${String.fromCharCode(96)} were extended with 1-1 additional optional parameter. As a result of ${String.fromCharCode(96)}shouldRestoreElements${String.fromCharCode(96)} defaulting to false, all elements in the scene will no longer be updated (iframes will not blink) when you add elements via script.
+- There is a new event hook: ${String.fromCharCode(96)}onPasteHook${String.fromCharCode(96)}. This will be called whenever the user pastes something to the canvas. You can use this callback if you want to do something additional during the onPaste event. In case you want to prevent the Excalidraw default onPaste action you must return false
+
+${String.fromCharCode(96,96,96)}typescript
+async addImage(
+  topX: number,
+  topY: number,
+  imageFile: TFile | string,
+  scale: boolean = true,
+  anchor: boolean = true,
+): Promise<string>;
+
+async addElementsToView(
+  repositionToCursor: boolean = false,
+  save: boolean = true,
+  newElementsOnTop: boolean = false,
+  shouldRestoreElements: boolean = false,
+): Promise<boolean>;
+
+ onPasteHook: (data: {
+  ea: ExcalidrawAutomate;
+  payload: ClipboardData;
+  event: ClipboardEvent;
+  excalidrawFile: TFile;
+  view: ExcalidrawView;
+  pointerPosition: { x: number; y: number };
+ }) => boolean = null;
+
+addEmbeddable(
+  topX: number,
+  topY: number,
+  width: number,
+  height: number,
+  url?: string,
+  file?: TFile
+): string;
+
+get DEVICE(): DeviceType;
+
+newFilePrompt(
+  newFileNameOrPath: string,
+  shouldOpenNewFile: boolean,
+  targetPane?: PaneTarget,
+  parentFile?: TFile
+): Promise<TFile | null>;
+
+getLeaf(
+  origo: WorkspaceLeaf,
+  targetPane?: PaneTarget
+): WorkspaceLeaf;
+${String.fromCharCode(96,96,96)}
+`,
+"1.9.8":`
+## New Features
+- Zoom to heading and block in markdown frames.
+- Added an iframe menu that allows users to change heading/block zoom, center the element, and open it in the browser.
+- Replaced twitframe with platform.twitter for tweets. The "Read more" and "Reply" buttons now work. Embedded tweets will honor theme settings.
+
+## Bug Fixes
+- Fixed an issue where embedded markdown frames disappeared in fullscreen mode. [#1197](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1197)
+- Resolved a problem with the "Embed Markdown as Image" feature where changes to embed properties were not always honored. [#1201](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1201)
+- When inserting any file from the Vault and embedding a Markdown document as an image, the embed now correctly honors the section heading if specified. [#1200](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1200)
+- SVG and PNG autoexport now function properly when closing a popout window. [#1209](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1209)
+- Many other minor fixes
+`,
+"1.9.7":`
+## Fixed:
+
+- Fixed an issue where using the color picker shortcut would cause the UI to disappear in mobile view mode.
+- You can now add YouTube playlists to iframes.
+- Fixed a bug where the "Add any file" dropdown suggester opened in the main Obsidian workspace instead of the popout window when Excalidraw was running. ([#1179](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1191))
+- Made some improvements to the logic of opening in the adjacent pane, although it is still not perfect.
+- Fixed an issue where Obsidian sync would result in the loss of the last approximately 20 seconds of work. Excalidraw's handling of sync is now fixed. ([#1189](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1189))
+
+## New:
+
+- Introducing Image Cache: Excalidraw will now cache rendered images embedded in Markdown documents, which will enhance the markdown rendering experience.
+- Backup Cache: Excalidraw now stores a backup on your device when saving, in case the application is terminated during a save operation. If you are using sync, you can find the latest backup on the device you last used to edit your drawing.
+- Added ${String.fromCharCode(96)}frame=${String.fromCharCode(96)} parameter to image references. ([#1194](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1194)) For more details about this feature, check out this [YouTube video](https://youtu.be/yZQoJg2RCKI).
+- When an SVG image from Draw.io is embedded in Excalidraw, clicking the image will open the file in the [Diagram plugin](https://github.com/zapthedingbat/drawio-obsidian) (if available).
+- Added the [Create DrawIO file](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Create%20DrawIO%20file.md) Excalidraw Automate Script to the library, which allows you to create a new draw.io drawing and add it to the current Excalidraw canvas.
+
+## New in ExcalidrawAutomate
+
+${String.fromCharCode(96,96,96)}typescript
+async getAttachmentFilepath(filename: string): Promise<string>
+${String.fromCharCode(96,96,96)}
+
+This asynchronous function retrieves the filepath to a new file, taking into account the attachments preference settings in Obsidian. It creates the attachment folder if it doesn't already exist. The function returns the complete path to the file. If the provided filename already exists, the function will append '_[number]' before the extension to generate a unique filename.
+
+${String.fromCharCode(96,96,96)}typescript
+getElementsInFrame(frameElement: ExcalidrawElement, elements: ExcalidrawElement[]): ExcalidrawElement[];
+${String.fromCharCode(96,96,96)}
+
+This function returns the elements contained within a frame.
+`,
+"1.9.6":`
+## Fixed
+- help shortcuts are really hard to see [#1176](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1179)
+- link icons not visible on elements after 1.9.5 release (reported on Discord)
+- PDFs in iFrames will now respect the ${String.fromCharCode(96)}[[document.pdf#page=155]]${String.fromCharCode(96)} format
+- Keyboard shortcuts were not working properly on external drop. Check [updated keyboard map](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/excalidraw-modifiers.png)
+
+<a href="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/excalidraw-modifiers.png"><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/excalidraw-modifiers.png" width="100%" alt="Keyboard map"/></a>
+`,
+"1.9.5":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/ICpoyMv6KSs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New
+- IFrame support: insert documents from your Obsidian Vault and insert youtube, Vimeo, and generally any website from the internet
+- Frame support: use frames to group items on your board
+
+## New in ExcalidrawAutomate
+- selectElementsInView now also accepts a list of element IDs
+- new addIFrame function that accepts an Obsidian file or a URL string
+${String.fromCharCode(96,96,96)}typescript
+selectElementsInView(elements: ExcalidrawElement[] | string[]): void;
+addIFrame(topX: number, topY: number, width: number, height: number, url?: string, file?: TFile): string;
+${String.fromCharCode(96,96,96)}
+`,
+
+"1.9.3":`
+## New from Excalidraw.com
+- Eyedropper tool. The eyedropper is triggered with "i". If you hold the ALT key  while clicking the color it will set the stroke color of the selected element, else the background color.
+- Flipping multiple elements
+- Improved stencil library rendering performance + the stencil library will remember the scroll position from the previous time it was open
+
+## Fixed
+- Replaced command palette and tab export SVG/PNG/Excalidraw actions with "export image" which will take the user to the export image dialog.
+`,
+"1.9.2":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/diBT5iaoAYo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New
+- Excalidraw.com Color Picker redesign [#6216](https://github.com/excalidraw/excalidraw/pull/6216)
+- Updated palette loader script in the script library
+- New ExcalidrawAutomate API to load Elements and AppState from another Excalidraw file.
+${String.fromCharCode(96,96,96)}typescript
+async getSceneFromFile(file: TFile): Promise<{elements: ExcalidrawElement[]; appState: AppState;}>
+${String.fromCharCode(96,96,96)}
+`,
+"1.9.1":`
+## Updates from Excalidraw.com
+- "Unlock all elements" - new action available via the context menu [#5894](https://github.com/excalidraw/excalidraw/pull/5894)
+- Minor improvements to improve the speed [#6560](https://github.com/excalidraw/excalidraw/pull/6560)
+- Retain Seed on Shift Paste [#6509](https://github.com/excalidraw/excalidraw/pull/6509)
+
+## New/Fixed
+- Clicking on the link handle (top right corner) will open the link in the same window
+- CTRL/CMD click on a link will open the link in a new tab and will focus on the new tab
+- Linking to parts of images. In some cases clicking search results, links, or backlinks did not focus on the right element according to the link.  Fixed.
+`,
+"1.9.0":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/nB4cOfn0xAs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## Fixed
+- Embedded images, markdowns, PDFs will load one by one, not in one go after a long wait
+
+## New
+- Embed PDF
+
+## New in ExcalidrawAutomate
+- onFileCreateHook: if set this hook is called whenever a new drawing is created using Excalidraw command palette menu actions. If the excalidraw file is created using Templater or other means, the trigger will not fire. [#1124](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1124)
+${String.fromCharCode(96,96,96)}typescript
+  onFileCreateHook: (data: {
+    ea: ExcalidrawAutomate;
+    excalidrawFile: TFile; //the file being created
+    view: ExcalidrawView;
+  }) => Promise<void>;
+  ${String.fromCharCode(96,96,96)}
+`,
+"1.8.26":`
+## Fixed
+- Dynamic styling did not pick up correctly
+  - the accent color with the default Obsidian theme
+  - the drawing theme color with the out of the box, default new drawing (not using a template)
+- The Obsidian tools panel did not pick up user scripts when installing your very first script. A reload of Obsidian was required.
+`,
+"1.8.25": `
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/BvYkOaly-QM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New & improved
+- Multi-link support
+- Updated [Scribble Helper](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Scribble%20Helper.md) script for better handwritten text support. 
+  - Add links to text elements
+  - Creating wrapped text in transparent sticky notes
+  - Add text to arrows and lines
+  - Handwriting support on iOS via Scribble
+
+## Fixed
+  - The long-standing issue of jumping text
+  
+`,
+"1.8.24": `
+## Updates from Excalidraw.com
+- fix: color picker keyboard handling not working
+- fix: center align text when bind to the container via context menu
+- fix: split "Edit selected shape" shortcut
+
+## Fixed
+- BUG: Area embed link of svg inside excalidraw embed entire svg instead of area [#1098](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1098)
+
+## New
+- I updated the [Scribble Helper](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Scribble%20Helper.md) script with tons of new features. I am still beta testing the script. I will release a demo video in the next few days.
+
+## New in Excalidraw Automate
+- I added many more configuration options for the scriptEngine utils.inputPrompt function. See [Scribble Helper](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Scribble%20Helper.md) for a demonstration of this new feature.
+${String.fromCharCode(96,96,96)}typescript
+  public static async inputPrompt(
+    view: ExcalidrawView,
+    plugin: ExcalidrawPlugin,
+    app: App,
+    header: string,
+    placeholder?: string,
+    value?: string,
+    buttons?: { caption: string; tooltip?:string; action: Function }[],
+    lines?: number,
+    displayEditorButtons?: boolean,
+    customComponents?: (container: HTMLElement) => void
+  )
+${String.fromCharCode(96,96,96)}`,
+"1.8.23": `
+## Fixes
+- Fixed palm rejection to prevent unwanted spikes when using the freedraw tool. ([#1065](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1065))
+- Fixed issue where images disappeared when zoomed in. ([#6417](https://github.com/excalidraw/excalidraw/pull/6417))
+- Autosave will now save the drawing when you change the theme from dark to light or vice versa. ([#1080](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1080))
+- Added padding to short LaTeX formulas to prevent cropping. ([#1053](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1053))
+
+## New Features
+- Added a new command palette action: Toggle to invert default binding behavior. This new feature allows you to switch between normal and inverted mode. In normal mode, arrows will bind to objects unless you hold the CTRL/CMD key while drawing the arrow or moving objects. In inverted mode, arrows will not bind to objects unless you hold the CTRL/CMD key while drawing the arrow or moving objects.
+- You can now set a template LaTeX formula in the plugin settings (under experimental features) to be used when creating a new LaTeX formula. ([#1090](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1090))
+- Redesigned the Image Export dialog. I hope dropdowns are now more intuitive than the toggles were.
+- Added the ability to export only the selected part of a drawing. See the Export dialog for more information.
+- Added a zigzag fill easter egg. See a demo of this feature [here](https://twitter.com/excalidraw/status/1645428942344445952?s=61&t=nivKLx2vgl6hdv2EbW4mZg).
+- Added a new expert function: recolor embedded Excalidraw and SVG images (not JPG, PNG, BMP, WEBP, GIF). See a demo of this feature here:
+
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/MIZ5hv-pSSs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+`,
+"1.8.22": `
+## Fixed
+- Styling of custom pen and script buttons in the side panel was inverted.
+- Minor tweaks to dynamic styling. [see this video to understand dynamic styling](https://youtu.be/fypDth_-8q0)
+
+## New
+- New scripts by @threethan:
+  - [Auto Draw for Pen](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Auto%20Draw%20for%20Pen.md): Automatically switches between the select and draw tools, based on whether a pen is being used. Supports most pens including Apple Pencil.
+  - [Hardware Eraser Support](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Hardware%20Eraser%20Support.md): Adds support for pen inversion, a.k.a. the hardware eraser on the back of your pen. Supports Windows based styluses. Does not suppoprt Apple Pencil or S-Pen.
+- Added separate buttons to support copying link, area or group references to objects on the drawing. [#1063](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1063). See [this video](https://youtu.be/yZQoJg2RCKI) for more details on how this works.
+- Hover preview will no longer trigger for image files (.png, .svg, .jpg, .gif, .webp, .bmp, .ico, .excalidraw)
+- Minor updates to the [Slideshow](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Slideshow.md) script. You can download the updated script from the Excalidraw script library.  The slideshow will now correctly run also when initiated in a popout window. When the drawing is in a popout window, the slideshow will not be full screen, but will only occupy the popout window. If you run the slideshow from the main Obsidian workspace, it will be displayed in full-screen mode.
+- Updated the Icon Library script to now include image keywords under each of the images to allow searching for keywords (CTRL/CMD+F). I've uploaded the new script to [here](https://gist.github.com/zsviczian/33ff695d5b990de1ebe8b82e541c26ad). If you need further information watch this [video](https://youtu.be/_OEljzZ33H8)
+
+## New in ExcalidrawAutomate
+- ${String.fromCharCode(96)}addText${String.fromCharCode(96)} ${String.fromCharCode(96)}formatting${String.fromCharCode(96)} parameter now accepts ${String.fromCharCode(96)}boxStrokeColor${String.fromCharCode(96)} and ${String.fromCharCode(96)}textVerticalAlign${String.fromCharCode(96)} values.
+${String.fromCharCode(96,96,96)}typescript
+addText(
+    topX: number,
+    topY: number,
+    text: string,
+    formatting?: {
+      wrapAt?: number;
+      width?: number;
+      height?: number;
+      textAlign?: "left" | "center" | "right";
+      box?: boolean | "box" | "blob" | "ellipse" | "diamond";
+      boxPadding?: number;
+      boxStrokeColor?: string;
+      textVerticalAlign?: "top" | "middle" | "bottom";
+    },
+    id?: string,
+  ): string;
+${String.fromCharCode(96,96,96)}
+- new ${String.fromCharCode(96)}onFileOpenHook${String.fromCharCode(96)}. If set, this callback is triggered, when an Excalidraw file is opened. You can use this callback in case you want to do something additional when the file is opened. This will run before the file level script defined in the ${String.fromCharCode(96)}excalidraw-onload-script${String.fromCharCode(96)} frontmatter is executed. Excalidraw will await the result of operations here.  Handle with care. If you change data such as the frontmatter of the underlying file, I haven't tested how it will behave.
+${String.fromCharCode(96,96,96)}typescript
+onFileOpenHook: (data: {
+  ea: ExcalidrawAutomate;
+  excalidrawFile: TFile; //the file being loaded
+  view: ExcalidrawView;
+}) => Promise<void>;
+${String.fromCharCode(96,96,96)}`,
+"1.8.21": `
+## Quality of Life improvements
+- Dynamic Styling (see plugin settings / Display). When Dynamic Styling is enabled it fixes Excalidraw issues with the Minimal Theme
+- New "Invert Colors" script
+
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/fypDth_-8q0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+### Note
+The few of you, that are using the Dynamic Styling Templater script, please remove it and restart Obsidian.
+`,
+"1.8.20": `
+## Fixed
+- Excalidraw froze Obsidian in certain rare situations [#1054](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1054)
+- File loading error [#1062](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1062)
+- Embedded images in markdown documents no longer have the line on the side. Image sizing works better. [#1059](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1059)
+- Locked elements will not show a hover preview [#1060](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1060)
+- CTRL/CMD + K correctly triggers add link [#1056](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1056)
+
+## New
+- Grid color adjusts to the view background color
+
+I'm sorry, but the sticky note editing issue on Android with the on-screen keyboard has still not been resolved. If you also experience this error, please help raise the priority with the core Excalidraw team by commenting on this issue: [#6330](https://github.com/excalidraw/excalidraw/issues/6330)
+`,
+"1.8.19": `
+## Fixed: Text wrapping issue in sticky notes
+
+I fixed an issue where text would wrap differently and words would disappear during text editing in sticky notes. You can check out the details on [GitHub #6318](https://github.com/excalidraw/excalidraw/issues/6331).
+
+I am aware of three additional issues related to container text editing that are still open. I apologize for any inconvenience caused by the recent change in how text size is calculated on Excalidraw.com, which has had a knock-on effect on Obsidian. I am actively working to address the following issues:
+
+- Pinch zooming while editing text in a text container [GitHub #6331](https://github.com/excalidraw/excalidraw/issues/6331)
+- Container text jumps on edit on Android with on-screen keyboard [GitHub #6330](https://github.com/excalidraw/excalidraw/issues/6330)
+- Shadow text when editing text containers without a keyboard on iOS [GitHub #6329](https://github.com/excalidraw/excalidraw/issues/6329)
+
+Thank you for your patience while I work on resolving these issues.
+`,
+"1.8.18": `
+## Fixed
+- Text scaling issue introduced in 1.8.17
+- [#1043](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1043): Error handling when ${String.fromCharCode(96)}onCanvasColorChangeHook${String.fromCharCode(96)} is executed. This is used in the [Dynamic Styling Script](https://youtu.be/LtR04fNTKTM). 
+`,
+"1.8.17": `
+## New from Excalidraw.com
+- Improved text wrapping in the ellipse and diamond shapes [6172](https://github.com/excalidraw/excalidraw/pull/6172)
+
+## New
+- Updated slideshow script
+
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/mQ2eLk_0TV4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## Fixed: 
+- "Save to..." in the Stencil Library menu now works as expected [#1032](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1032)
+`,
+"1.8.16": `
+**!!! Modifier keys have changed, please review the table below !!!**
+[Click this to see the new shortcuts overview image](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/excalidraw-modifiers.png)
+
+## Fixed 
+- This version was extensively tested and developed on MacOS to remove usability issues.
+- New command palette action to create a new drawing in a new tab
+- Modifier keys to open links in the active window, splitting the current view to the right, in a new tab, or in a popout window now behave consistently both in Excalidraw and when clicking a drawing that is embedded in a markdown note.
+- Drag & Drop properly works from within Obsidian, from a web browser, and from the OS file explorer
+
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/9HlipSIzRhc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+`,
+"1.8.14":`
+## Fixed
+- text element link gets deleted when the drawing is reloaded
+`,
 "1.8.13": `
 ## Fixed
 - When changing a text element in markdown mode, the change seem to have showed up when switching back to Excalidraw  mode, but then lost these changes when loading the file the next time.

src/dialogs/OpenDrawing.ts

@@ -1,6 +1,6 @@
 import { App, FuzzySuggestModal, TFile } from "obsidian";
 import ExcalidrawPlugin from "../main";
-import { EMPTY_MESSAGE } from "../Constants";
+import { EMPTY_MESSAGE } from "../constants";
 import { t } from "../lang/helpers";
 
 export enum openDialogAction {

src/dialogs/PenSettingsModal.ts

@@ -1,6 +1,6 @@
 import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/types";
 import { ColorComponent, Modal, Setting, SliderComponent, TextComponent, ToggleComponent } from "obsidian";
-import { COLOR_NAMES, VIEW_TYPE_EXCALIDRAW } from "src/Constants";
+import { COLOR_NAMES, VIEW_TYPE_EXCALIDRAW } from "src/constants";
 import ExcalidrawView from "src/ExcalidrawView";
 import ExcalidrawPlugin from "src/main";
 import { setPen } from "src/menu/ObsidianMenu";

src/dialogs/Prompt.ts

@@ -2,18 +2,25 @@ import {
   App,
   ButtonComponent,
   Modal,
-  TextComponent,
   FuzzyMatch,
   FuzzySuggestModal,
   Instruction,
   TFile,
   Notice,
+  TextAreaComponent,
 } from "obsidian";
 import ExcalidrawView from "../ExcalidrawView";
 import ExcalidrawPlugin from "../main";
-import { sleep } from "../utils/Utils";
-import { getNewOrAdjacentLeaf } from "../utils/ObsidianUtils";
+import { escapeRegExp, sleep } from "../utils/Utils";
+import { getLeaf } from "../utils/ObsidianUtils";
 import { checkAndCreateFolder, splitFolderAndFilename } from "src/utils/FileUtils";
+import { KeyEvent, isCTRL } from "src/utils/ModifierkeyHelper";
+import { t } from "src/lang/helpers";
+import { ExcalidrawElement, getEA } from "src";
+import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
+import { MAX_IMAGE_SIZE } from "src/constants";
+
+export type ButtonDefinition = { caption: string; tooltip?:string; action: Function };
 
 export class Prompt extends Modal {
   private promptEl: HTMLInputElement;
@@ -72,43 +79,75 @@ export class Prompt extends Modal {
 
 export class GenericInputPrompt extends Modal {
   public waitForClose: Promise<string>;
-
+  private view: ExcalidrawView;
+  private plugin: ExcalidrawPlugin;
   private resolvePromise: (input: string) => void;
   private rejectPromise: (reason?: any) => void;
   private didSubmit: boolean = false;
-  private inputComponent: TextComponent;
+  private inputComponent: TextAreaComponent;
   private input: string;
-  private buttons: [{ caption: string; action: Function }];
+  private buttons: ButtonDefinition[];
+  private lines: number = 1;
+  private displayEditorButtons: boolean = false;
   private readonly placeholder: string;
+  private selectionStart: number = 0;
+  private selectionEnd: number = 0;
+  private selectionUpdateTimer: number = 0;
+  private customComponents: (container: HTMLElement) => void;
+  private blockPointerInputOutsideModal: boolean = false;
 
   public static Prompt(
+    view: ExcalidrawView,
+    plugin: ExcalidrawPlugin,
     app: App,
     header: string,
     placeholder?: string,
     value?: string,
-    buttons?: [{ caption: string; action: Function }],
+    buttons?: ButtonDefinition[],
+    lines?: number,
+    displayEditorButtons?: boolean,
+    customComponents?: (container: HTMLElement) => void,
+    blockPointerInputOutsideModal?: boolean,
   ): Promise<string> {
     const newPromptModal = new GenericInputPrompt(
+      view,
+      plugin,
       app,
       header,
       placeholder,
       value,
       buttons,
+      lines,
+      displayEditorButtons,
+      customComponents,
+      blockPointerInputOutsideModal,
     );
     return newPromptModal.waitForClose;
   }
 
   protected constructor(
+    view: ExcalidrawView,
+    plugin: ExcalidrawPlugin,
     app: App,
     private header: string,
     placeholder?: string,
     value?: string,
-    buttons?: [{ caption: string; action: Function }],
+    buttons?: { caption: string; action: Function }[],
+    lines?: number,
+    displayEditorButtons?: boolean,
+    customComponents?: (container: HTMLElement) => void,
+    blockPointerInputOutsideModal?: boolean,
   ) {
     super(app);
+    this.view = view;
+    this.plugin = plugin;
     this.placeholder = placeholder;
     this.input = value;
     this.buttons = buttons;
+    this.lines = lines ?? 1;
+    this.displayEditorButtons = this.lines > 1 ? (displayEditorButtons ?? false) : false;
+    this.customComponents = customComponents;
+    this.blockPointerInputOutsideModal = blockPointerInputOutsideModal ?? false;
 
     this.waitForClose = new Promise<string>((resolve, reject) => {
       this.resolvePromise = resolve;
@@ -116,19 +155,27 @@ export class GenericInputPrompt extends Modal {
     });
 
     this.display();
+    this.inputComponent.inputEl.focus();
     this.open();
   }
 
   private display() {
     this.contentEl.empty();
+    if(this.blockPointerInputOutsideModal) {
+      //@ts-ignore
+      const bgEl = this.bgEl;
+      bgEl.style.pointerEvents = this.blockPointerInputOutsideModal ? "none" : "auto";
+    }
+
     this.titleEl.textContent = this.header;
 
     const mainContentContainer: HTMLDivElement = this.contentEl.createDiv();
     this.inputComponent = this.createInputField(
       mainContentContainer,
       this.placeholder,
-      this.input,
+      this.input
     );
+    this.customComponents?.(mainContentContainer);
     this.createButtonBar(mainContentContainer);
   }
 
@@ -137,15 +184,39 @@ export class GenericInputPrompt extends Modal {
     placeholder?: string,
     value?: string,
   ) {
-    const textComponent = new TextComponent(container);
+    const textComponent = new TextAreaComponent(container);
 
     textComponent.inputEl.style.width = "100%";
+    textComponent.inputEl.style.height = `${this.lines*2}em`;
+    if(this.lines === 1) {
+      textComponent.inputEl.style.resize = "none";
+      textComponent.inputEl.style.overflow = "hidden";
+    }
     textComponent
       .setPlaceholder(placeholder ?? "")
       .setValue(value ?? "")
-      .onChange((value) => (this.input = value))
-      .inputEl.addEventListener("keydown", this.submitEnterCallback);
+      .onChange((value) => (this.input = value));
 
+    let i = 0;
+
+    const checkcaret = () => {
+      //timer is implemented because on iPad with pencil the button click generates an event on the textarea
+      this.selectionUpdateTimer = this.view.ownerWindow.setTimeout(() => {
+        this.selectionStart = this.inputComponent.inputEl.selectionStart;
+        this.selectionEnd = this.inputComponent.inputEl.selectionEnd;
+      }, 30);
+    }
+
+    textComponent.inputEl.addEventListener("keydown", this.keyDownCallback);
+    textComponent.inputEl.addEventListener('keyup', checkcaret); // Every character written
+    textComponent.inputEl.addEventListener('pointerup', checkcaret); // Click down
+    textComponent.inputEl.addEventListener('touchend', checkcaret); // Click down
+    textComponent.inputEl.addEventListener('input', checkcaret); // Other input events
+    textComponent.inputEl.addEventListener('paste', checkcaret); // Clipboard actions
+    textComponent.inputEl.addEventListener('cut', checkcaret);
+    textComponent.inputEl.addEventListener('select', checkcaret); // Some browsers support this event
+    textComponent.inputEl.addEventListener('selectionchange', checkcaret);// Some browsers support this event
+      
     return textComponent;
   }
 
@@ -153,18 +224,33 @@ export class GenericInputPrompt extends Modal {
     container: HTMLElement,
     text: string,
     callback: (evt: MouseEvent) => any,
+    tooltip: string = "",
+    margin: string = "5px",
   ) {
     const btn = new ButtonComponent(container);
+    btn.buttonEl.style.padding = "0.5em";
+    btn.buttonEl.style.marginLeft = margin;
+    btn.setTooltip(tooltip);
     btn.setButtonText(text).onClick(callback);
     return btn;
   }
 
   private createButtonBar(mainContentContainer: HTMLDivElement) {
     const buttonBarContainer: HTMLDivElement = mainContentContainer.createDiv();
+    buttonBarContainer.style.display = "flex";
+    buttonBarContainer.style.justifyContent = "space-between";
+    buttonBarContainer.style.marginTop = "1rem";
+
+    const editorButtonContainer: HTMLDivElement = buttonBarContainer.createDiv();
+
+    const actionButtonContainer: HTMLDivElement = buttonBarContainer.createDiv();
+
     if (this.buttons && this.buttons.length > 0) {
       let b = null;
       for (const button of this.buttons) {
-        const btn = new ButtonComponent(buttonBarContainer);
+        const btn = new ButtonComponent(actionButtonContainer);
+        btn.buttonEl.style.marginLeft="5px";
+        if(button.tooltip) btn.setTooltip(button.tooltip);
         btn.setButtonText(button.caption).onClick((evt: MouseEvent) => {
           const res = button.action(this.input);
           if (res) {
@@ -175,31 +261,95 @@ export class GenericInputPrompt extends Modal {
         b = b ?? btn;
       }
       if (b) {
-        b.setCta().buttonEl.style.marginRight = "0";
+        b.setCta();
+        b.buttonEl.style.marginRight = "0";
       }
     } else {
       this.createButton(
-        buttonBarContainer,
-        "Ok",
+        actionButtonContainer,
+        "✅",
         this.submitClickCallback,
       ).setCta().buttonEl.style.marginRight = "0";
     }
-    this.createButton(buttonBarContainer, "Cancel", this.cancelClickCallback);
+    this.createButton(actionButtonContainer, "❌", this.cancelClickCallback, t("PROMPT_BUTTON_CANCEL"));
+    if(this.displayEditorButtons) {
+      this.createButton(editorButtonContainer, "⏎", ()=>this.insertStringBtnClickCallback("\n"), t("PROMPT_BUTTON_INSERT_LINE"), "0");
+      this.createButton(editorButtonContainer, "⌫", this.delBtnClickCallback, "Delete");
+      this.createButton(editorButtonContainer, "⎵", ()=>this.insertStringBtnClickCallback(" "), t("PROMPT_BUTTON_INSERT_SPACE"));
+      if(this.view) {
+        this.createButton(editorButtonContainer, "🔗", this.linkBtnClickCallback, t("PROMPT_BUTTON_INSERT_LINK"));
+      }
+      this.createButton(editorButtonContainer, "🔠", this.uppercaseBtnClickCallback, t("PROMPT_BUTTON_UPPERCASE"));
+    }
+  }
 
-    buttonBarContainer.style.display = "flex";
-    buttonBarContainer.style.flexDirection = "row-reverse";
-    buttonBarContainer.style.justifyContent = "flex-start";
-    buttonBarContainer.style.marginTop = "1rem";
+  private linkBtnClickCallback = () => {
+    this.view.ownerWindow.clearTimeout(this.selectionUpdateTimer); //timer is implemented because on iPad with pencil the button click generates an event on the textarea
+    const addText = (text: string) => {
+      const v = this.inputComponent.inputEl.value;
+      if(this.selectionStart>0 && v.slice(this.selectionStart-1, this.selectionStart) !== " ") text = " "+text;
+      if(this.selectionStart<v.length && v.slice(this.selectionStart, this.selectionStart+1) !== " ") text = text+" ";
+      const newVal = this.inputComponent.inputEl.value.slice(0, this.selectionStart) + text + this.inputComponent.inputEl.value.slice(this.selectionStart);
+      this.inputComponent.inputEl.value = newVal;
+      this.input = this.inputComponent.inputEl.value;
+      this.inputComponent.inputEl.focus();
+      this.selectionStart = this.selectionStart+text.length;
+      this.selectionEnd = this.selectionStart+text.length;
+      this.inputComponent.inputEl.setSelectionRange(this.selectionStart, this.selectionStart);
+
+    }
+    this.plugin.insertLinkDialog.start(this.view.file.path, addText);
+  }
+
+  private insertStringBtnClickCallback = (s: string) => {
+    this.view.ownerWindow.clearTimeout(this.selectionUpdateTimer); //timer is implemented because on iPad with pencil the button click generates an event on the textarea
+    const newVal = this.inputComponent.inputEl.value.slice(0, this.selectionStart) + s + this.inputComponent.inputEl.value.slice(this.selectionStart);
+    this.inputComponent.inputEl.value = newVal;
+    this.input = this.inputComponent.inputEl.value;
+    this.inputComponent.inputEl.focus();
+    this.selectionStart = this.selectionStart+1;
+    this.selectionEnd = this.selectionStart;
+    this.inputComponent.inputEl.setSelectionRange(this.selectionStart, this.selectionEnd);
+  }
+  
+  private delBtnClickCallback = () => {
+    this.view.ownerWindow.clearTimeout(this.selectionUpdateTimer); //timer is implemented because on iPad with pencil the button click generates an event on the textarea
+    if(this.input.length === 0) return;
+    const delStart = this.selectionEnd > this.selectionStart 
+      ? this.selectionStart
+      : this.selectionStart > 0 ? this.selectionStart-1 : 0;
+    const delEnd = this.selectionEnd;
+    const newVal = this.inputComponent.inputEl.value.slice(0, delStart ) + this.inputComponent.inputEl.value.slice(delEnd);
+    this.inputComponent.inputEl.value = newVal;
+    this.input = this.inputComponent.inputEl.value;
+    this.inputComponent.inputEl.focus();
+    this.selectionStart = delStart;
+    this.selectionEnd = delStart;
+    this.inputComponent.inputEl.setSelectionRange(delStart, delStart);
+  }
+
+  private uppercaseBtnClickCallback = () => {
+    this.view.ownerWindow.clearTimeout(this.selectionUpdateTimer); //timer is implemented because on iPad with pencil the button click generates an event on the textarea
+    if(this.selectionEnd === this.selectionStart) return;
+    const newVal = this.inputComponent.inputEl.value.slice(0, this.selectionStart) + this.inputComponent.inputEl.value.slice(this.selectionStart, this.selectionEnd).toUpperCase() + this.inputComponent.inputEl.value.slice(this.selectionEnd);
+    this.inputComponent.inputEl.value = newVal;
+    this.input = this.inputComponent.inputEl.value;
+    this.inputComponent.inputEl.focus();
+    this.inputComponent.inputEl.setSelectionRange(this.selectionStart, this.selectionEnd);
   }
 
   private submitClickCallback = () => this.submit();
   private cancelClickCallback = () => this.cancel();
 
-  private submitEnterCallback = (evt: KeyboardEvent) => {
-    if (evt.key === "Enter") {
+  private keyDownCallback = (evt: KeyboardEvent) => {
+    if ((evt.key === "Enter" && this.lines === 1) || (isCTRL(evt) && evt.key === "Enter")) {
       evt.preventDefault();
       this.submit();
     }
+    if (this.displayEditorButtons && evt.key === "k" && isCTRL(evt)) {
+      evt.preventDefault();
+      this.linkBtnClickCallback();
+    } 
   };
 
   private submit() {
@@ -222,13 +372,12 @@ export class GenericInputPrompt extends Modal {
   private removeInputListener() {
     this.inputComponent?.inputEl?.removeEventListener(
       "keydown",
-      this.submitEnterCallback,
+      this.keyDownCallback,
     );
   }
 
   onOpen() {
     super.onOpen();
-
     this.inputComponent.inputEl.focus();
     this.inputComponent.inputEl.select();
   }
@@ -310,99 +459,74 @@ export class GenericSuggester extends FuzzySuggestModal<any> {
   }
 }
 
-class MigrationPrompt extends Modal {
-  private plugin: ExcalidrawPlugin;
-
-  constructor(app: App, plugin: ExcalidrawPlugin) {
-    super(app);
-    this.plugin = plugin;
-  }
-
-  onOpen(): void {
-    this.titleEl.setText("Welcome to Excalidraw 1.2");
-    this.createForm();
-  }
-
-  onClose(): void {
-    this.contentEl.empty();
-  }
-
-  createForm(): void {
-    const div = this.contentEl.createDiv();
-    //    div.addClass("excalidraw-prompt-div");
-    //    div.style.maxWidth = "600px";
-    div.createEl("p", {
-      text: "This version comes with tons of new features and possibilities. Please read the description in Community Plugins to find out more.",
-    });
-    div.createEl("p", { text: "" }, (el) => {
-      el.innerHTML =
-        "Drawings you've created with version 1.1.x need to be converted to take advantage of the new features. You can also continue to use them in compatibility mode. " +
-        "During conversion your old *.excalidraw files will be replaced with new *.excalidraw.md files.";
-    });
-    div.createEl("p", { text: "" }, (el) => {
-      //files manually follow one of two options:
-      el.innerHTML =
-        "To convert your drawings you have the following options:<br><ul>" +
-        "<li>Click <code>CONVERT FILES</code> now to convert all of your *.excalidraw files, or if you prefer to make a backup first, then click <code>CANCEL</code>.</li>" +
-        "<li>In the Command Palette select <code>Excalidraw: Convert *.excalidraw files to *.excalidraw.md files</code></li>" +
-        "<li>Right click an <code>*.excalidraw</code> file in File Explorer and select one of the following options to convert files one by one: <ul>" +
-        "<li><code>*.excalidraw => *.excalidraw.md</code></li>" +
-        "<li><code>*.excalidraw => *.md (Logseq compatibility)</code>. This option will retain the original *.excalidraw file next to the new Obsidian format. " +
-        "Make sure you also enable <code>Compatibility features</code> in Settings for a full solution.</li></ul></li>" +
-        "<li>Open a drawing in compatibility mode and select <code>Convert to new format</code> from the <code>Options Menu</code></li></ul>";
-    });
-    div.createEl("p", {
-      text: "This message will only appear maximum 3 times in case you have *.excalidraw files in your Vault.",
-    });
-    const bConvert = div.createEl("button", { text: "CONVERT FILES" });
-    bConvert.onclick = () => {
-      this.plugin.convertExcalidrawToMD();
-      this.close();
-    };
-    const bCancel = div.createEl("button", { text: "CANCEL" });
-    bCancel.onclick = () => {
-      this.close();
-    };
-  }
-}
-
 export class NewFileActions extends Modal {
-  constructor(
-    private plugin: ExcalidrawPlugin,
-    private path: string,
-    private newPane: boolean,
-    private newWindow: boolean,
-    private view: ExcalidrawView,
-  ) {
+  public waitForClose: Promise<TFile|null>;
+  private resolvePromise: (file: TFile|null) => void;
+  private rejectPromise: (reason?: any) => void;
+  private newFile: TFile = null;
+  private plugin: ExcalidrawPlugin;
+  private path: string;
+  private keys: KeyEvent;
+  private view: ExcalidrawView;
+  private openNewFile: boolean;
+  private parentFile: TFile;
+  private sourceElement: ExcalidrawElement;
+
+  constructor({
+    plugin,
+    path,
+    keys,
+    view,
+    openNewFile = true,
+    parentFile,
+    sourceElement,
+  }: {
+    plugin: ExcalidrawPlugin;
+    path: string;
+    keys: KeyEvent;
+    view: ExcalidrawView;
+    openNewFile?: boolean;
+    parentFile?: TFile;
+    sourceElement?: ExcalidrawElement;
+  }) {
     super(plugin.app);
-  }
+    this.plugin = plugin;
+    this.path = path;
+    this.keys = keys;
+    this.view = view;
+    this.openNewFile = openNewFile;
+    this.sourceElement = sourceElement;
+    if(!parentFile) this.parentFile = view.file;
+    this.waitForClose = new Promise<TFile|null>((resolve, reject) => {
+      this.resolvePromise = resolve;
+      this.rejectPromise = reject;
+    });
+  } 
 
   onOpen(): void {
     this.createForm();
   }
 
-  async onClose() {}
-
   openFile(file: TFile): void {
-    if (!file) {
+    this.newFile = file;
+    if (!file || !this.openNewFile) {
       return;
     }
-    const leaf = this.newWindow
-      //@ts-ignore
-      ? app.workspace.openPopoutLeaf()
-      : this.newPane
-        ? getNewOrAdjacentLeaf(this.plugin, this.view.leaf)
-        : this.view.leaf;
+    const leaf = getLeaf(this.plugin,this.view.leaf,this.keys)
     leaf.openFile(file, {active:true});
-    //this.app.workspace.setActiveLeaf(leaf, true, true);
+  }
+
+  onClose() {
+    super.onClose();
+    this.resolvePromise(this.newFile);
   }
 
   createForm(): void {
-    this.titleEl.setText("New File");
+    this.titleEl.setText(t("PROMPT_TITLE_NEW_FILE"));
 
     this.contentEl.createDiv({
       cls: "excalidraw-prompt-center",
-      text: "File does not exist. Do you want to create it?",
+      text: t("PROMPT_FILE_DOES_NOT_EXIST"),
     });
     this.contentEl.createDiv({
       cls: "excalidraw-prompt-center filepath",
@@ -415,12 +539,12 @@ export class NewFileActions extends Modal {
 
       const checks = (): boolean => {
         if (!this.path || this.path === "") {
-          new Notice("Error: Filename for new file may not be empty");
+          new Notice(t("PROMPT_ERROR_NO_FILENAME"));
           return false;
         }
-        if (!this.view.file) {
+        if (!this.parentFile) {
           new Notice(
-            "Unknown error. It seems as if your drawing was closed or the drawing file is missing",
+            t("PROMPT_ERROR_DRAWING_CLOSED"),
           );
           return false;
         }
@@ -429,8 +553,8 @@ export class NewFileActions extends Modal {
 
       const createFile = async (data: string): Promise<TFile> => {
         if (!this.path.includes("/")) {
-          const re = new RegExp(`${this.view.file.name}$`, "g");
-          this.path = this.view.file.path.replace(re, this.path);
+          const re = new RegExp(`${escapeRegExp(this.parentFile.name)}$`, "g");
+          this.path = this.parentFile.path.replace(re, this.path);
         }
         if (!this.path.match(/\.md$/)) {
           this.path = `${this.path}.md`;
@@ -441,7 +565,31 @@ export class NewFileActions extends Modal {
         return f;
       };
 
-      const bMd = el.createEl("button", { text: "Create Markdown" });
+      if(this.sourceElement) {
+        const bEmbedMd = el.createEl("button", {
+          text: t("PROMPT_BUTTON_EMBED_MARKDOWN"),
+          attr: {"aria-label": t("PROMPT_BUTTON_EMBED_MARKDOWN_ARIA")},
+        });
+        bEmbedMd.onclick = async () => {
+          if (!checks) {
+            return;
+          }
+          const f = await createFile("");
+          if(f) {
+            const ea:ExcalidrawAutomate = getEA(this.view);
+            ea.copyViewElementsToEAforEditing([this.sourceElement]);
+            ea.getElement(this.sourceElement.id).isDeleted = true;
+            ea.addEmbeddable(this.sourceElement.x, this.sourceElement.y,MAX_IMAGE_SIZE, MAX_IMAGE_SIZE, undefined,f);
+            ea.addElementsToView();
+          }
+          this.close();
+        };
+      }
+
+      const bMd = el.createEl("button", {
+        text: t("PROMPT_BUTTON_CREATE_MARKDOWN"),
+        attr: {"aria-label": t("PROMPT_BUTTON_CREATE_MARKDOWN_ARIA")},
+      });
       bMd.onclick = async () => {
         if (!checks) {
           return;
@@ -451,7 +599,10 @@ export class NewFileActions extends Modal {
         this.close();
       };
 
-      const bEx = el.createEl("button", { text: "Create Excalidraw" });
+      const bEx = el.createEl("button", {
+        text: t("PROMPT_BUTTON_CREATE_EXCALIDRAW"),
+        attr: {"aria-label": t("PROMPT_BUTTON_CREATE_EXCALIDRAW_ARIA")},
+      });
       bEx.onclick = async () => {
         if (!checks) {
           return;
@@ -463,7 +614,7 @@ export class NewFileActions extends Modal {
       };
 
       const bCancel = el.createEl("button", {
-        text: "Never Mind",
+        text: t("PROMPT_BUTTON_NEVERMIND"),
       });
       bCancel.onclick = () => {
         this.close();
@@ -471,3 +622,74 @@ export class NewFileActions extends Modal {
     });
   }
 }
+
+export class ConfirmationPrompt extends Modal {
+  public waitForClose: Promise<boolean>;
+  private resolvePromise: (value: boolean) => void;
+  private rejectPromise: (reason?: any) => void;
+  private didConfirm: boolean = false;
+  private readonly message: string;
+
+  constructor(private plugin: ExcalidrawPlugin, message: string) {
+    super(plugin.app);
+    this.message = message;
+    this.waitForClose = new Promise<boolean>((resolve, reject) => {
+      this.resolvePromise = resolve;
+      this.rejectPromise = reject;
+    });
+
+    this.display();
+    this.open();
+  }
+
+  private display() {
+    this.contentEl.empty();
+    this.titleEl.textContent = t("PROMPT_TITLE_CONFIRMATION");
+
+    const messageEl = this.contentEl.createDiv();
+    messageEl.style.marginBottom = "1rem";
+    messageEl.innerHTML = this.message;
+
+    const buttonContainer = this.contentEl.createDiv();
+    buttonContainer.style.display = "flex";
+    buttonContainer.style.justifyContent = "flex-end";
+
+    const cancelButton = this.createButton(buttonContainer, t("PROMPT_BUTTON_CANCEL"), this.cancelClickCallback);
+    cancelButton.buttonEl.style.marginRight = "0.5rem";
+
+    const confirmButton = this.createButton(buttonContainer, t("PROMPT_BUTTON_OK"), this.confirmClickCallback);
+    confirmButton.buttonEl.style.marginRight = "0";
+
+    cancelButton.buttonEl.focus();
+  }
+
+  private createButton(container: HTMLElement, text: string, callback: (evt: MouseEvent) => void) {
+    const button = new ButtonComponent(container);
+    button.setButtonText(text).onClick(callback);
+    return button;
+  }
+
+  private cancelClickCallback = () => {
+    this.didConfirm = false;
+    this.close();
+  };
+
+  private confirmClickCallback = () => {
+    this.didConfirm = true;
+    this.close();
+  };
+
+  onOpen() {
+    super.onOpen();
+    this.contentEl.querySelector("button")?.focus();
+  }
+
+  onClose() {
+    super.onClose();
+    if (!this.didConfirm) {
+      this.resolvePromise(false);
+    } else {
+      this.resolvePromise(true);
+    }
+  }
+}

src/dialogs/PublishOutOfDateFiles.ts

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