2.2.7-1 beta release after refactoring

Update zh-cn.ts to 2.2.4

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,12 +1,22 @@
 ---
 name: Bug report
-about: Create a report to help me improve Excalidraw
+about: When something is clearly broken. Everything else is a feature request.
 title: 'BUG: '
 labels: ''
 assignees: ''
 
 ---
 
+Help me help you. I am a one man show doing this plugin as a part time hobby. There is no point in flooding me with issues, if there are too many, and they are poorly documented, I will just ignore them. Sorry...
+
+Before creating a bug report, please
+1. review recent release notes - maybe there is already an answer,
+2. search issues (including closed ones) to see if there is anything similar.
+
+⚠️ I will have to close all recorded bugs that do not provide this background information. Sorry, I need to control my workload/time. ⚠️
+
+--------
+
 **Your environment**
 Please run `Command Palette/Show Debug info` in Obsidian and paste the result here.
 

.gitignore

@@ -13,6 +13,7 @@ stats.html
 hot-reload.bat
 data.json
 lib
+dist
 
 #VSCode
 .vscode

.nvmrc

@@ -1 +1 @@
-18
+16

AutomateHowTo.md

@@ -195,7 +195,7 @@ This is relevant when setting a fix height using the `addText()` function.
 ### startArrowHead, endArrowHead
 String. Valid values are "arrow", "bar", "dot", and "none". Specifies the beginning and ending of an arrow.
 
-This is relavant when using the `addArrow()` and the `connectObjects()` functions.
+This is relevant when using the `addArrow()` and the `connectObjects()` functions.
 
 ## canvas
 Sets the properties of the canvas. 

README.md

@@ -3,8 +3,13 @@
 The Obsidian-Excalidraw plugin integrates [Excalidraw](https://excalidraw.com/), a feature rich sketching tool, into Obsidian. You can store and edit Excalidraw files in your vault, you can embed drawings into your documents, and you can link to documents and other drawings to/and from Excalidraw. For a showcase of Excalidraw features, please read my blog post [here](https://www.zsolt.blog/2021/03/showcasing-excalidraw.html) and/or watch the videos below.
 
 ## Video Walkthrough
+<a href="https://youtu.be/P_Q6avJGoWI" target="_blank"><img src="https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/da34bb33-7610-45e6-b36f-cb7a02a9141b" 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>
 
-<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>
+### Here's my complete catalog of videos:
+<a href="https://excalidraw-obsidian.online/Hobbies/Excalidraw+Blog/Catalogue+of+Videos"><img width="380" alt="image" src="https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/2577e5ad-7a21-4c62-acd5-4fe80c8a8a95"></a>
+<br>
 
 <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>
@@ -62,51 +67,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,137 +114,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.
+  - `![[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.
+  - 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 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>).
-- Using the block reference you can also reference & transclude text that appears on drawings, in other documents
+
+- 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 table above for the varios 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 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
+- 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.
+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>SHIFT</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>/<kbd>CMD+OPT+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>WIN+CTRL</kbd>/<kbd>CMD+CTRL</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),
@@ -269,7 +276,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,
@@ -284,4 +291,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>

docs/API/ExcalidrawAutomate.d.ts

@@ -0,0 +1,773 @@
+/// <reference types="react" />
+import ExcalidrawPlugin from "src/main";
+import { FillStyle, StrokeStyle, ExcalidrawElement, ExcalidrawBindableElement, FileId, NonDeletedExcalidrawElement, ExcalidrawImageElement, StrokeRoundness, RoundnessType } from "@zsviczian/excalidraw/types/excalidraw/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/excalidraw/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/excalidraw/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 available, 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 elementsDict
+     */
+    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;
+        storeAction?: "capture" | "none" | "update";
+    }, 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;
+    /**
+     * Deprecated. Use getCM / ColorMaster instead
+     * @param color
+     * @returns
+     */
+    hexStringToRgb(color: string): number[];
+    /**
+     * Deprecated. Use getCM / ColorMaster instead
+     * @param color
+     * @returns
+     */
+    rgbToHexString(color: number[]): string;
+    /**
+     * Deprecated. Use getCM / ColorMaster instead
+     * @param color
+     * @returns
+     */
+    hslToRgb(color: number[]): number[];
+    /**
+     * Deprecated. 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 available, 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,9 +145,17 @@ 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
+     * @returns elements from elementsDict
      */
     getElements(): ExcalidrawElement[];
     /**
@@ -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;
     /**
-     *
+     * Deprecated. Use getCM / ColorMaster instead
      * @param color
      * @returns
      */
     hexStringToRgb(color: string): number[];
     /**
-     *
+     * Deprecated. Use getCM / ColorMaster instead
      * @param color
      * @returns
      */
     rgbToHexString(color: number[]): string;
     /**
-     *
+     * Deprecated. Use getCM / ColorMaster instead
      * @param color
      * @returns
      */
     hslToRgb(color: number[]): number[];
     /**
-     *
+     * Deprecated. 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/element_style.md

@@ -88,4 +88,4 @@ This is relevant when setting a fix height using the `addText()` function.
 ### startArrowHead, endArrowHead
 String. Valid values are "arrow", "bar", "dot", and "none". Specifies the beginning and ending of an arrow.
 
-This is relavant when using the `addArrow()` and the `connectObjects()` functions.
+This is relevant when using the `addArrow()` and the `connectObjects()` functions.

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.
 

docs/API/utility.md

@@ -22,7 +22,7 @@ Places the generated drawing to the clipboard. Useful when you don't want to cre
 ```typescript
 getElements():ExcalidrawElement[];
 ```
-Returns the elements in ExcalidrawAutomate as an array of ExcalidrawElements. This format is usefull when working with ExcalidrawRef.
+Returns the elements in ExcalidrawAutomate as an array of ExcalidrawElements. This format is useful when working with ExcalidrawRef.
 
 ### getElement()
 ```typescript
@@ -156,7 +156,7 @@ You first need to set the view calling `setView()`.
 
 Gets the array of selected elements in the scene. Returns [] if no elements are selected.
 
-Note: you can call `getExcalidrawAPI().getSceneElements()` to retreive all the elements in the scene.
+Note: you can call `getExcalidrawAPI().getSceneElements()` to retrieve all the elements in the scene.
 
 #### viewToggleFullScreen()
 ```typescript
@@ -178,7 +178,7 @@ Same as `connectObjects()`, but ObjectB is the currently selected element in the
 async addElementsToView(repositionToCursor:boolean=false, save:boolean=false):Promise<boolean>
 ```
 Adds elements created with ExcalidrawAutomate to the target ExcalidrawView.
-`repositionToCursor` dafault is false
+`repositionToCursor` default is false
 - true: the elements will be moved such that the center point of the elements will be aligned with the current position of the pointer on ExcalidrawView. You can point and place elements to a desired location in your drawing using this switch.
 - false: elements will be positioned as defined by the x&y coordinates of each element.
 
@@ -204,7 +204,7 @@ onDropHook (data: {
 ```
 
 Callback function triggered when an draggable item is dropped on Excalidraw.
-The function should return a boolean value. True if the drop was handled by the hook and futher native processing should be stopped, and false if Excalidraw should continue with the processing of the drop.
+The function should return a boolean value. True if the drop was handled by the hook and further native processing should be stopped, and false if Excalidraw should continue with the processing of the drop.
 type of drop can be one of:
 - "file" if a file from Obsidian file explorer is dropped onto Excalidraw. In this case payload.files will contain the list of files dropped.
 - "text" if a link (e.g. url, or wiki link) or other text is dropped. In this case payload.text will contain the received string

docs/Examples/templater_mindmap.md

@@ -1,6 +1,6 @@
 # [◀ Excalidraw Automate How To](../readme.md)
 ## Generating a simple mindmap from a text outline
-This is a slightly more elaborate example. This will generate an a mindmap from a tabulated outline.
+This is a slightly more elaborate example. This will generate a mindmap from a tabulated outline.
 
 ### Output
 ![Drawing 2021-05-05 20 52 34](https://user-images.githubusercontent.com/14358394/117194124-00a69d00-ade4-11eb-8b75-5e18a9cbc3cd.png)

docs/ExcalidrawScriptsEngine.md

@@ -21,7 +21,7 @@ This will allow you to assign hotkeys to your favorite scripts just like to any
 
 ## Script development
 An Excalidraw script will automatically receive two objects:
-- `ea`: The Script Enginge will initialize the `ea` object including setting the active view to the View from which the script was called.
+- `ea`: The Script Engine will initialize the `ea` object including setting the active view to the View from which the script was called.
 - `utils`: I have borrowed functions exposed on utils from [QuickAdd](https://github.com/chhoumann/quickadd/blob/master/docs/QuickAddAPI.md), though currently not all QuickAdd utility functions are implemented in Excalidraw. As of now, these are the available functions. See the example below for details.
   - `inputPrompt: (header: string, placeholder?: string, value?: string, buttons?: [{caption:string, action:Function}])`
     - Opens a prompt that asks for an input. Returns a string with the input.

docs/readme.md

@@ -8,7 +8,7 @@ With a little work, using ExcalidrawAutomate you can generate simple mindmaps, b
 ## API documentation
 - **start here** [Introduction to the API](API/introduction.md)
 - [Overview of Attributes and Functions](API/attributes_functions_overview.md)
-- [Element Sytle](API/element_style.md)
+- [Element Style](API/element_style.md)
 - [Canvas Style](API/canvas_style.md)
 - [Adding Objects](API/objects.md)
 - [Utility Functions](API/utility.md)

ea-scripts/Archive/OCR - Optical Character Recognition.md

@@ -4,7 +4,7 @@
 THIS SCRIPT REQUIRES EXCALIDRAW 1.5.15
 
 The script will 
-  1) send the selected image file to [taskbone.com](https://taskbone.com) to exctract the text from the image, and
+  1) send the selected image file to [taskbone.com](https://taskbone.com) to extract the text from the image, and
   2) will add the text to your drawing as a text element
 
 I recommend also installing the [Transfer TextElements to Excalidraw markdown metadata](Transfer%20TextElements%20to%20Excalidraw%20markdown%20metadata.md) script as well.

ea-scripts/Archive/index.md

@@ -15,7 +15,7 @@ In the `Command Palette` installed scripts are prefixed with `Downloaded/`, thus
 
 ## Attention developers and hobby hackers
 <img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/hobby-programmer.svg' align='left' style='background-color:whitesmoke; width:80px; margin-right:15px; margin-bottom:10px;'/>
-If you want to modify scripts, I recommend moving them to the `Excalidraw Automate script folder` or a different subfolder under the script folder. Scripts in the `Downloaded` folder will be overwritten when you click the `Update this script` button. Note also, that at this time, I do not check if the script file has been updated on GitHub, thus the `Update this script` button is always visible once you have installed a script, not only when an update is availble (hope to build this feature in the future).
+If you want to modify scripts, I recommend moving them to the `Excalidraw Automate script folder` or a different subfolder under the script folder. Scripts in the `Downloaded` folder will be overwritten when you click the `Update this script` button. Note also, that at this time, I do not check if the script file has been updated on GitHub, thus the `Update this script` button is always visible once you have installed a script, not only when an update is available (hope to build this feature in the future).
 
 I would love to include your contribution in the script library. If you have a script of your own that you would like to share with the community, please open a [PR](https://github.com/zsviczian/obsidian-excalidraw-plugin/pulls) on GitHub. Be sure to include the following in your pull request
 - The [script file](https://github.com/zsviczian/obsidian-excalidraw-plugin/tree/master/ea-scripts) with a self explanetory name. The name of the file will be the name of the script in the Command Palette.
@@ -243,7 +243,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/OCR%20-%20Optical%20Character%20Recognition.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/OCR%20-%20Optical%20Character%20Recognition.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">REQUIRES EXCALIDRAW 1.5.15<br>The script will  1) send the selected image file to [taskbone.com](https://taskbone.com) to exctract the text from the image, and 2) will add the text to your drawing as a text element.<br><mark>⚠ Note that you will need to manually paste your token into the script after the first run! ⚠</mark><br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-ocr.jpg'><br><iframe width="560" height="315" src="https://www.youtube.com/embed/W2NMzR8s4eE" 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/OCR%20-%20Optical%20Character%20Recognition.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">REQUIRES EXCALIDRAW 1.5.15<br>The script will  1) send the selected image file to [taskbone.com](https://taskbone.com) to extract the text from the image, and 2) will add the text to your drawing as a text element.<br><mark>⚠ Note that you will need to manually paste your token into the script after the first run! ⚠</mark><br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-ocr.jpg'><br><iframe width="560" height="315" src="https://www.youtube.com/embed/W2NMzR8s4eE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></td></tr></table>
 
 ## Organic Line
 ```excalidraw-script-install

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 elements 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 difference operation, so a transparent 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)", "difference (a - b)", "reversed difference (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/Crop Vintage Mask.md

@@ -0,0 +1,75 @@
+/*
+Adds a rounded mask to the image by adding a full cover black mask and a rounded rectangle white mask. The script is also useful for adding just a black mask. In this case, run the script, then delete the white mask and add your custom white mask.
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-crop-vintage.jpg)
+```js*/
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("2.0.18")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+
+if(!ea.isExcalidrawMaskFile()) {
+  new Notice("This script only works with Mask Files");
+  return;
+}
+
+const frames = ea.getViewElements().filter(el=>el.type==="frame")
+if(frames.length !== 1) {
+  new Notice("Multiple frames found");
+  return;
+}
+const frame = frames[0];
+ea.copyViewElementsToEAforEditing(ea.getViewElements().filter(el=>el.frameId === frame.id));
+const frameId = ea.generateElementId();
+ea.style.fillStyle = "solid";
+ea.style.roughness = 0;
+ea.style.strokeColor = "transparent";
+ea.style.strokeWidth = 0.1;
+ea.style.opacity = 50;
+
+let blackEl = ea.getViewElements().find(el=>el.id === "allblack");
+let whiteEl = ea.getViewElements().find(el=>el.id === "whiteovr");
+
+if(blackEl && whiteEl) {
+  ea.copyViewElementsToEAforEditing([blackEl, whiteEl]);
+} else
+if (blackEl && !whiteEl) {
+  ea.copyViewElementsToEAforEditing([blackEl]);
+  ea.style.backgroundColor = "white";
+  ea.addRect(frame.x,frame.y,frame.width,frame.height, "whiteovr");
+} else
+if (!blackEl && whiteEl) {
+  ea.style.backgroundColor = "black";
+  ea.addRect(frame.x-2,frame.y-2,frame.width+4,frame.height+4, "allblack");
+  ea.copyViewElementsToEAforEditing([whiteEl]);
+} else {
+  ea.style.backgroundColor = "black";
+  ea.addRect(frame.x-2,frame.y-2,frame.width+4,frame.height+4, "allblack");
+  ea.style.backgroundColor = "white";
+  ea.addRect(frame.x,frame.y,frame.width,frame.height, "whiteovr");
+}
+blackEl = ea.getElement("allblack");
+whiteEl = ea.getElement("whiteovr");
+
+//this "magic" is required to ensure the frame element is above in sequence of the new rectangle elements
+ea.getElements().forEach(el=>{el.frameId = frameId});
+ea.copyViewElementsToEAforEditing(ea.getViewElements().filter(el=>el.id === frame.id));
+const newFrame = ea.getElement(frame.id); 
+newFrame.id = frameId;
+ea.elementsDict[frameId] = newFrame;
+ea.copyViewElementsToEAforEditing(ea.getViewElements().filter(el=>el.id === frame.id));
+ea.getElement(frame.id).isDeleted = true;
+
+let curve = await utils.inputPrompt(
+  "Set roundess",
+  "Positive whole number",
+  `${whiteEl.roundness?.value ?? "500"}`
+);
+
+if(!curve) return;
+curve = parseInt(curve);
+if(isNaN(curve) || curve < 0) {
+  new Notice ("Roudness is not a valid positive whole number");
+  return;
+}
+whiteEl.roundness = {type: 3, value: curve};
+ea.addElementsToView(false,false,true);

ea-scripts/Crop Vintage Mask.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" class="lucide lucide-squircle"><path fill="none" d="M12 3c7.2 0 9 1.8 9 9s-1.8 9-9 9-9-1.8-9-9 1.8-9 9-9"/></svg>

ea-scripts/Custom Zoom.md

@@ -0,0 +1,15 @@
+/*
+You can set a custom zoom level with this script. This allows you to set a zoom level below 10% or set the zoom level to a specific value.  Note however, that Excalidraw has a bug under 10% zoom, and a phantom copy of your image may appear on screen. If this happens, increase the zoom and the phantom should disappear, if it doesn't then close and open the drawing.
+
+```js*/
+const api = ea.getExcalidrawAPI();
+const appState = api.getAppState();
+const zoomStr = await utils.inputPrompt("Zoom [%]",null,`${appState.zoom.value*100}%`);
+if(!zoomStr) return;
+const zoomNum = parseFloat(zoomStr.match(/^\d*/)[0]);
+if(isNaN(zoomNum)) {
+  new Notice("You must provide a number");
+  return;
+}
+
+ea.getExcalidrawAPI().updateScene({appState:{zoom:{value: zoomNum/100 }}});

ea-scripts/Custom Zoom.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" class="lucide lucide-scan-search"><g stroke-width="2"><path d="M3 7V5a2 2 0 0 1 2-2h2"/><path d="M17 3h2a2 2 0 0 1 2 2v2"/><path d="M21 17v2a2 2 0 0 1-2 2h-2"/><path d="M7 21H5a2 2 0 0 1-2-2v-2"/><circle cx="12" cy="12" r="3"/><path d="m16 16-1.9-1.9"/></g></svg>

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

@@ -3,13 +3,70 @@
 
 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("2.0.25")) {
   new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
   return;
 }
 
+// -------------------------------
+// Utility variables and functions
+// -------------------------------
+const excalidrawTemplates = ea.getListOfTemplateFiles();
+if(typeof window.ExcalidrawDeconstructElements === "undefined") {
+	window.ExcalidrawDeconstructElements = {
+	  openDeconstructedImage: true,
+	  templatePath: excalidrawTemplates?.[0].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);
+}
+
+if(!settings["Default file name"]) {
+  settings["Default file name"] = {
+    value: "deconstructed",
+    description: "The default filename to use when deconstructing elements."
+  };
+  await ea.setScriptSettings(settings);
+}
+
+const DEFAULT_FILENAME = settings["Default file name"].value;
+
+const templates = settings["Templates"]
+  .value
+  .split(",")
+  .map(p=>app.metadataCache.getFirstLinkpathDest(p.trim(),""))
+  .concat(excalidrawTemplates)
+  .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 +77,126 @@ 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(DEFAULT_FILENAME),
+  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,"")
-  ea.deleteViewElements(els);
-  ea.clear();
-  await ea.addImage(bb.topX,bb.topY,file,false);
-  await ea.addElementsToView(false, true, true);
-  ea.getExcalidrawAPI().history.clear(); //to avoid undo/redo messing up the decomposition
-},1000);
+let f = app.vault.getAbstractFileByPath(newPath);
+let counter = 0;
+while((!f || !ea.isExcalidrawFile(f)) && counter++<100) {
+  await sleep(50);
+  f = app.vault.getAbstractFileByPath(newPath);
+}
+
+if(!f || !ea.isExcalidrawFile(f)) {
+  new Notice("Something went wrong");
+  return;
+}
+
+let padding = parseFloat(app.metadataCache.getCache(f.path)?.frontmatter["excalidraw-export-padding"]);
+if(isNaN(padding)) {
+  padding = ea.plugin.settings.exportPaddingSVG;
+}
+
+ea.getElements().forEach(el=>el.isDeleted = true);
+await ea.addImage(bb.topX-padding,bb.topY-padding,f,false, shouldAnchor);
+await ea.addElementsToView(false, true, true);
+ea.getExcalidrawAPI().history.clear();
+if(!window.ExcalidrawDeconstructElements.openDeconstructedImage) {
+  new Notice("Deconstruction ready");
+}

ea-scripts/ExcaliAI.md

@@ -0,0 +1,689 @@
+/*
+<iframe width="560" height="315" src="https://www.youtube.com/embed/A1vrSGBbWgo" 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-draw-a-ui.jpg)
+```js*/
+let dirty=false;
+
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("2.0.12")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+
+const outputTypes = {
+  "html": {
+    instruction: "Turn this into a single html file using tailwind. Return a single message containing only the html file in a codeblock.",
+    blocktype: "html"
+  },
+  "mermaid": {
+    instruction: "Return a single message containing only the mermaid diagram in a codeblock.",
+    blocktype: "mermaid"
+  },
+  "svg": {
+    instruction: "Return a single message containing only the SVG code in an html codeblock.",
+    blocktype: "svg"
+  },
+  "image-gen": {
+    instruction: "Return a single message with the generated image prompt in a codeblock",
+    blocktype: "image"
+  },
+    "image-gen-silent": {
+    instruction: "Return a single message with the generated image prompt in a codeblock",
+    blocktype: "image-silent"
+  },
+  "image-edit": {
+    instruction: "",
+    blocktype: "image"
+  }
+}
+
+const systemPrompts = {
+  "Challenge my thinking": {
+    prompt: `Your task is to interpret a screenshot of a whiteboard, translating its ideas into a Mermaid graph. The whiteboard will encompass thoughts on a subject. Within the mind map, distinguish ideas that challenge, dispute, or contradict the whiteboard content. Additionally, include concepts that expand, complement, or advance the user's thinking. Utilize the Mermaid graph diagram type and present the resulting Mermaid diagram within a code block. Ensure the Mermaid script excludes the use of parentheses ().`,
+    type: "mermaid",
+    help: "Translate your image and optional text prompt into a Mermaid mindmap. If there are conversion errors, edit the Mermaid script under 'More Tools'."
+  },
+  "Convert sketch to shapes": {
+    prompt: `Given an image featuring various geometric shapes drawn by the user, your objective is to analyze the input and generate SVG code that accurately represents these shapes. Your output will be the SVG code enclosed in an HTML code block.`,
+    type: "svg",
+    help: "Convert selected scribbles into shapes; works better with fewer shapes. Experimental and may not produce good drawings."
+  },
+  "Create a simple Excalidraw icon": {
+    prompt: `Given a description of an SVG image from the user, your objective is to generate the corresponding SVG code. Avoid incorporating textual elements within the generated SVG. Your output should be the resulting SVG code enclosed in an HTML code block.`,
+    type: "svg",
+    help: "Convert text prompts into simple icons inserted as Excalidraw elements. Expect only a text prompt. Experimental and may not produce good drawings."
+  },
+  
+  "Create a stick figure": {
+    prompt: "You will receive a prompt from the user. Your task involves drawing a simple stick figure or a scene involving a few stick figures based on the user's prompt. Create the stickfigure based on the following style description. DO NOT add any detail, just use it AS-IS: Create a simple stick figure character with a large round head and a face in the style of sketchy caricatures. The stick figure should have a rudimentary body composed of straight lines representing the arms and legs. Hands and toes should be should be represented with round shapes, do not add details such as fingers or toes. Use fine lines, smooth curves, rounded shapes. The stick figure should retain a playful and childlike simplicity, reminiscent of a doodle someone might draw on the corner of a notebook page. Create a black and white drawing, a hand-drawn figure on white background.",
+    type: "image-gen",
+    help: "Send only the text prompt to OpenAI. Provide a detailed description; OpenAI will enrich your prompt automatically. To avoid it, start your prompt like this 'DO NOT add any detail, just use it AS-IS:'"
+  },
+  "Edit an image": {
+    prompt: null,
+    type: "image-edit",
+    help: "Image elements will be used as the Image. Shapes on top of the image will be the Mask. Use the prompt to instruct Dall-e about the changes. Dall-e-2 model will be used."
+  },
+  "Generate an image from image and prompt": {
+    prompt: "Your task involves receiving an image and a textual prompt from the user. Your goal is to craft a detailed, accurate, and descriptive narrative of the image, tailored for effective image generation. Utilize the user-provided text prompt to inform and guide your depiction of the image. Ensure the resulting image remains text-free.",
+    type: "image-gen",
+    help: "Generate an image based on the drawing and prompt using ChatGPT-Vision and Dall-e. Provide a contextual text-prompt for accurate interpretation."
+  },
+  "Generate an image from prompt": {
+    prompt: null,
+    type: "image-gen",
+    help: "Send only the text prompt to OpenAI. Provide a detailed description; OpenAI will enrich your prompt automatically. To avoid it, start your prompt like this 'DO NOT add any detail, just use it AS-IS:'"
+  },
+  "Generate an image to illustrate a quote": {
+    prompt: "Your task involves transforming a user-provided quote into a detailed and imaginative illustration. Craft a visual representation that captures the essence of the quote and resonates well with a broad audience. If the Author's name is provided, aim to establish a connection between the illustration and the Author. This can be achieved by referencing a well-known story from the Author, situating the image in the Author's era or setting, or employing other creative methods of association. Additionally, provide preferences for styling, such as the chosen medium and artistic direction, to guide the image creation process. Ensure the resulting image remains text-free. Your task output should comprise a descriptive and detailed narrative aimed at facilitating the creation of a captivating illustration from the quote.",
+    type: "image-gen",
+    help: "ExcaliAI will create an image prompt to illustrate your text input - a quote - with GPT, then generate an image using Dall-e. In case you include the Author's name, GPT will try to generate an image that in some way references the Author."
+  },
+   "Generate 4 icon-variants based on input image": {
+    prompt: "Given a simple sketch and an optional text prompt from the user, your task is to generate a descriptive narrative tailored for effective image generation, capturing the style of the sketch. Utilize the text prompt to guide the description. Your objective is to instruct DALL-E to create a collage of four minimalist black and white hand-drawn pencil sketches in a 2x2 matrix format. Each sketch should convert the user's sketch into simple artistic SVG icons with transparent backgrounds. Ensure the resulting images remain text-free, maintaining a minimalist, easy-to-understand style, and omit framing borders. Only include a pencil in the drawing if it is explicitely metioned in the user prompt or included in the sketch.",
+    type: "image-gen-silent",
+    help: "Generate a collage of 4 icons based on the drawing using ChatGPT-Vision and Dall-e. You may provide a contextual text-prompt to improve accuracy of interpretation."
+  }, 
+  "Visual brainstorm": {
+    prompt: "Your objective is to interpret a screenshot of a whiteboard, creating an image aimed at sparking further thoughts on the subject. The whiteboard will present diverse ideas about a specific topic. Your generated image should achieve one of two purposes: highlighting concepts that challenge, dispute, or contradict the whiteboard content, or introducing ideas that expand, complement, or enrich the user's thinking. You have the option to include multiple tiles in the resulting image, resembling a sequence akin to a comic strip. Ensure that the image remains devoid of text.",
+    type: "image-gen",
+    help: "Use ChatGPT Visions and Dall-e to create an image based on your text prompt and image to spark new ideas."
+  },
+  "Wireframe to code": {
+    prompt: `You are an expert tailwind developer. A user will provide you with a low-fidelity wireframe of an application and you will return a single html file that uses tailwind to create the website. Use creative license to make the application more fleshed out. Write the necessary javascript code. If you need to insert an image, use placehold.co to create a placeholder image.`,
+    type: "html",
+    help: "Use GPT Visions to interpret the wireframe and generate a web application. YOu may copy the resulting code from the active embeddable's top left menu."
+  },
+}
+
+const IMAGE_WARNING = "The generated image is linked through a temporary OpenAI URL and will be removed in approximately 30 minutes. To save it permanently, choose 'Save image from URL to local file' from the Obsidian Command Palette."
+// --------------------------------------
+// Initialize values and settings
+// --------------------------------------
+let settings = ea.getScriptSettings();
+
+if(!settings["Agent's Task"]) {
+  settings = {
+    "Agent's Task": "Wireframe to code",
+    "User Prompt": "",
+  };
+  await ea.setScriptSettings(settings);
+}
+
+const OPENAI_API_KEY = ea.plugin.settings.openAIAPIToken;
+if(!OPENAI_API_KEY || OPENAI_API_KEY === "") {
+  new Notice("You must first configure your API key in Excalidraw Plugin Settings");
+  return;
+}
+
+let userPrompt = settings["User Prompt"] ?? "";
+let agentTask = settings["Agent's Task"];
+let imageSize = settings["Image Size"]??"1024x1024";
+
+if(!systemPrompts.hasOwnProperty(agentTask)) {
+  agentTask = Object.keys(systemPrompts)[0];
+}
+let imageModel, valideSizes;
+
+const setImageModelAndSizes = () => {
+  imageModel = systemPrompts[agentTask].type === "image-edit"
+    ? "dall-e-2"
+    : ea.plugin.settings.openAIDefaultImageGenerationModel;
+  validSizes = imageModel === "dall-e-2"
+    ? [`256x256`, `512x512`, `1024x1024`]
+    : (imageModel === "dall-e-3"
+      ? [`1024x1024`, `1792x1024`, `1024x1792`]
+      : [`1024x1024`])
+  if(!validSizes.includes(imageSize)) {
+    imageSize = "1024x1024";
+    dirty = true;
+  }
+}
+setImageModelAndSizes();
+
+// --------------------------------------
+// Generate Image Blob From Selected Excalidraw Elements
+// --------------------------------------
+const calculateImageScale = (elements) => {
+  const bb = ea.getBoundingBox(elements);
+  const size = (bb.width*bb.height);
+  const minRatio = Math.sqrt(360000/size);
+  const maxRatio = Math.sqrt(size/16000000);
+  return minRatio > 1 
+    ? minRatio
+    : (
+        maxRatio > 1 
+        ? 1/maxRatio
+        : 1
+      );
+}
+
+const createMask = async (dataURL) => {
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+
+    img.onload = () => {
+      const canvas = document.createElement('canvas');
+      canvas.width = img.width;
+      canvas.height = img.height;
+
+      const ctx = canvas.getContext('2d');
+      ctx.drawImage(img, 0, 0);
+
+      const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+      const data = imageData.data;
+      
+      for (let i = 0; i < data.length; i += 4) {
+        // If opaque (alpha > 0), make it transparent
+        if (data[i + 3] > 0) {
+          data[i + 3] = 0; // Set alpha to 0 (transparent)
+        } else if (data[i + 3] === 0) {
+          // If fully transparent, make it red
+          data[i] = 255; // Red
+          data[i + 1] = 0; // Green
+          data[i + 2] = 0; // Blue
+          data[i + 3] = 255; // make it opaque
+        }
+      }
+
+      ctx.putImageData(imageData, 0, 0);
+      const maskDataURL = canvas.toDataURL();
+
+      resolve(maskDataURL);
+    };
+
+    img.onerror = error => {
+      reject(error);
+    };
+
+    img.src = dataURL;
+  });
+}
+
+//https://platform.openai.com/docs/api-reference/images/createEdit
+//dall-e-2 image edit only works on square images
+//if targetDalleImageEdit === true then the image and the mask will be returned in two separate dataURLs
+let squareBB;
+
+const generateCanvasDataURL = async (view, targetDalleImageEdit=false) => {
+  let PADDING = 5;
+  await view.forceSave(true); //to ensure recently embedded PNG and other images are saved to file
+  const viewElements = ea.getViewSelectedElements();
+  if(viewElements.length === 0) {
+    return {imageDataURL: null, maskDataURL: null} ;
+  }
+  ea.copyViewElementsToEAforEditing(viewElements, true); //copying the images objects over to EA for PNG generation
+  
+  let maskDataURL;
+  const loader = ea.getEmbeddedFilesLoader(false);
+  let scale = calculateImageScale(ea.getElements());
+  const bb = ea.getBoundingBox(viewElements);
+  if(ea.getElements()
+    .filter(el=>el.type==="image")
+    .some(el=>Math.round(el.width) === Math.round(bb.width) && Math.round(el.height) === Math.round(bb.height))
+  ) { PADDING = 0; }
+  
+  let exportSettings = {withBackground: true, withTheme: true};
+  
+  if(targetDalleImageEdit) {
+    PADDING = 0;  
+    const strokeColor = ea.style.strokeColor;
+    const backgroundColor = ea.style.backgroundColor;
+    ea.style.backgroundColor = "transparent";
+    ea.style.strokeColor = "transparent";
+    let rectID;
+    if(bb.height > bb.width) {
+      rectID = ea.addRect(bb.topX-(bb.height-bb.width)/2, bb.topY,bb.height, bb.height);
+    }
+    if(bb.width > bb.height) {
+      rectID = ea.addRect(bb.topX, bb.topY-(bb.width-bb.height)/2,bb.width, bb.width);
+    }
+    if(bb.height === bb.width) {
+      rectID = ea.addRect(bb.topX, bb.topY, bb.width, bb.height);
+    }
+    const rect = ea.getElement(rectID);
+    squareBB = {topX: rect.x-PADDING, topY: rect.y-PADDING, width: rect.width + 2*PADDING, height: rect.height + 2*PADDING};
+    ea.style.strokeColor = strokeColor;
+    ea.style.backgroundColor = backgroundColor;
+    ea.getElements().filter(el=>el.type === "image").forEach(el=>{el.isDeleted = true});
+
+    dalleWidth = parseInt(imageSize.split("x")[0]);
+    scale = dalleWidth/squareBB.width;
+    exportSettings = {withBackground: false, withTheme: true};
+    maskDataURL= await ea.createPNGBase64(
+      null, scale, exportSettings, loader, "light", PADDING
+    );
+    maskDataURL = await createMask(maskDataURL)
+    ea.getElements().filter(el=>el.type === "image").forEach(el=>{el.isDeleted = false});
+    ea.getElements().filter(el=>el.type !== "image" && el.id !== rectID).forEach(el=>{el.isDeleted = true});
+  }
+
+  const imageDataURL = await ea.createPNGBase64(
+    null, scale, exportSettings, loader, "light", PADDING
+  );
+  ea.clear();
+  return {imageDataURL, maskDataURL};
+}
+
+let {imageDataURL, maskDataURL} = await generateCanvasDataURL(ea.targetView, systemPrompts[agentTask].type === "image-edit");
+
+// --------------------------------------
+// Support functions - embeddable spinner and error
+// --------------------------------------
+const spinner = await ea.convertStringToDataURL(`
+  <html><head><style>
+    html, body {width: 100%; height: 100%; color: ${ea.getExcalidrawAPI().getAppState().theme === "dark" ? "white" : "black"};}
+    body {display: flex; align-items: center; justify-content: center; flex-direction: column; gap: 1rem; overflow: hidden;}
+    .Spinner {display: flex; align-items: center; justify-content: center; margin-left: auto; margin-right: auto;}
+    .Spinner svg {animation: rotate 1.6s linear infinite; transform-origin: center center; width: 40px; height: 40px;}
+    .Spinner circle {stroke: currentColor; animation: dash 1.6s linear 0s infinite; stroke-linecap: round;}
+    @keyframes rotate {100% {transform: rotate(360deg);}}
+    @keyframes dash {
+      0% {stroke-dasharray: 1, 300; stroke-dashoffset: 0;}
+      50% {stroke-dasharray: 150, 300; stroke-dashoffset: -200;}
+      100% {stroke-dasharray: 1, 300; stroke-dashoffset: -280;}
+    }
+  </style></head><body>
+    <div class="Spinner">
+      <svg viewBox="0 0 100 100">
+        <circle cx="50" cy="50" r="46" stroke-width="8" fill="none" stroke-miter-limit="10"/>
+      </svg>
+    </div>
+    <div>Generating...</div>
+  </body></html>`);
+
+  const errorMessage = async (spinnerID, message) => {
+    const error = "Something went wrong! Check developer console for more.";
+    const details = message ? `<p>${message}</p>` : "";
+    const errorDataURL = await ea.convertStringToDataURL(`
+      <html><head><style>
+        html, body {height: 100%;}
+        body {display: flex; flex-direction: column; align-items: center; justify-content: center; color: red;}
+        h1, h3 {margin-top: 0;margin-bottom: 0.5rem;}
+      </style></head><body>
+        <h1>Error!</h1>
+        <h3>${error}</h3>${details}
+      </body></html>`);
+    new Notice (error);
+    ea.getElement(spinnerID).link = errorDataURL;
+    ea.addElementsToView(false,true);
+  }
+
+// --------------------------------------
+// Utility to write Mermaid to dialog
+// --------------------------------------
+const EDITOR_LS_KEYS = {
+  OAI_API_KEY: "excalidraw-oai-api-key",
+  MERMAID_TO_EXCALIDRAW: "mermaid-to-excalidraw",
+  PUBLISH_LIBRARY: "publish-library-data",
+};
+
+const setMermaidDataToStorage = (mermaidDefinition) => {
+  try {
+    window.localStorage.setItem(
+      EDITOR_LS_KEYS.MERMAID_TO_EXCALIDRAW,
+      JSON.stringify(mermaidDefinition)
+    );
+    return true;
+  } catch (error) {
+    console.warn(`localStorage.setItem error: ${error.message}`);
+    return false;
+  }
+};
+  
+// --------------------------------------
+// Submit Prompt
+// --------------------------------------
+const generateImage = async(text, spinnerID, bb, silent=false) => {
+  const requestObject = {
+    text,
+    imageGenerationProperties: {
+      size: imageSize, 
+      //quality: "standard", //not supported by dall-e-2
+      n:1,
+    },
+  };
+  
+  const result = await ea.postOpenAI(requestObject);
+  console.log({result, json:result?.json});
+  
+  if(!result?.json?.data?.[0]?.url) {
+    await errorMessage(spinnerID, result?.json?.error?.message);
+    return;
+  }
+  
+  const spinner = ea.getElement(spinnerID)
+  spinner.isDeleted = true;
+  const imageID = await ea.addImage(spinner.x, spinner.y, result.json.data[0].url);
+  const imageEl = ea.getElement(imageID);
+  const revisedPrompt = result.json.data[0].revised_prompt;
+  if(revisedPrompt && !silent) {
+    ea.style.fontSize = 16;
+    const rectID = ea.addText(imageEl.x+15, imageEl.y + imageEl.height + 50, revisedPrompt, {
+      width: imageEl.width-30,
+      textAlign: "center",
+      textVerticalAlign: "top",
+      box: true,
+    })
+    ea.getElement(rectID).strokeColor = "transparent";
+    ea.getElement(rectID).backgroundColor = "transparent";
+    ea.addToGroup(ea.getElements().filter(el=>el.id !== spinnerID).map(el=>el.id));
+  }
+  
+  await ea.addElementsToView(false, true, true);
+  if(silent) return;
+  ea.getExcalidrawAPI().setToast({
+    message: IMAGE_WARNING,
+    duration: 15000,
+    closable: true
+  });
+}
+
+const run = async (text) => {
+  if(!text && !imageDataURL) {
+    new Notice("No prompt, aborting");
+    return;
+  }
+
+  const systemPrompt = systemPrompts[agentTask];
+  const outputType = outputTypes[systemPrompt.type];
+  const isImageGenRequest = outputType.blocktype === "image" || outputType.blocktype === "image-silent";
+  const isImageEditRequest = systemPrompt.type === "image-edit";
+
+  if(isImageEditRequest) {
+    if(!text) {
+      new Notice("You must provide a text prompt with instructions for how the image should be modified");
+      return;
+    }
+    if(!imageDataURL || !maskDataURL) {
+      new Notice("You must provide an image and a mask");
+      return;
+    }
+  }
+  
+  //place spinner next to selected elements
+  const bb = ea.getBoundingBox(ea.getViewSelectedElements()); 
+  const spinnerID = ea.addEmbeddable(bb.topX+bb.width+100,bb.topY-(720-bb.height)/2,550,720,spinner);
+  
+  //this block is in an async call using the isEACompleted flag because otherwise during debug Obsidian
+  //goes black (not freezes, but does not get a new frame for some reason)
+  //palcing this in an async call solves this issue
+  //If you know why this is happening and can offer a better solution, please reach out to @zsviczian
+  let isEACompleted = false;
+  setTimeout(async()=>{
+    await ea.addElementsToView(false,true);
+    ea.clear();
+    const embeddable = ea.getViewElements().filter(el=>el.id===spinnerID);
+    ea.copyViewElementsToEAforEditing(embeddable);
+    const els = ea.getViewSelectedElements();
+    ea.viewZoomToElements(false, els.concat(embeddable));
+    isEACompleted = true;
+  });
+
+  if(isImageGenRequest && !systemPrompt.prompt && !isImageEditRequest) {
+    generateImage(text,spinnerID,bb);
+    return;
+  }
+  
+  const requestObject = isImageEditRequest
+  ? {
+      ...imageDataURL ? {image: imageDataURL} : {},
+      ...(text && text.trim() !== "") ? {text} : {},
+      imageGenerationProperties: {
+        size: imageSize, 
+        //quality: "standard", //not supported by dall-e-2
+        n:1,
+        mask: maskDataURL,
+      },
+    }
+  : {
+      ...imageDataURL ? {image: imageDataURL} : {},
+      ...(text && text.trim() !== "") ? {text} : {},
+      systemPrompt: systemPrompt.prompt,
+      instruction: outputType.instruction,
+    }
+  
+  //Get result from GPT
+  const result = await ea.postOpenAI(requestObject);
+  console.log({result, json:result?.json});
+
+  //checking that EA has completed. Because the postOpenAI call is an async await
+  //I don't expect EA not to be completed by now. However the devil never sleeps.
+  //This (the insomnia of the Devil) is why I have a watchdog here as well
+  let counter = 0
+  while(!isEACompleted && counter++<10) sleep(50);
+  if(!isEACompleted) {
+    await errorMessage(spinnerID, "Unexpected issue with ExcalidrawAutomate");
+    return;
+  }
+
+  if(isImageEditRequest) {   
+    if(!result?.json?.data?.[0]?.url) {
+      await errorMessage(spinnerID, result?.json?.error?.message);
+      return;
+    }
+    
+    const spinner = ea.getElement(spinnerID)
+    spinner.isDeleted = true;
+    const imageID = await ea.addImage(spinner.x, spinner.y, result.json.data[0].url);    
+    await ea.addElementsToView(false, true, true);
+    ea.getExcalidrawAPI().setToast({
+      message: IMAGE_WARNING,
+      duration: 15000,
+      closable: true
+    });
+    return;
+  }
+
+  if(!result?.json?.hasOwnProperty("choices")) {
+    await errorMessage(spinnerID, result?.json?.error?.message);
+    return;
+  }
+
+  //exctract codeblock and display result
+  let content = ea.extractCodeBlocks(result.json.choices[0]?.message?.content)[0]?.data;
+
+  if(!content) {
+    await errorMessage(spinnerID);
+    return;
+  }
+
+  if(isImageGenRequest) {
+    generateImage(content,spinnerID,bb,outputType.blocktype === "image-silent");
+    return;
+  }
+  
+  switch(outputType.blocktype) {
+    case "html":
+      ea.getElement(spinnerID).link = await ea.convertStringToDataURL(content);
+      ea.addElementsToView(false,true);
+      break;
+    case "svg":
+      ea.getElement(spinnerID).isDeleted = true;
+      ea.importSVG(content);
+      ea.addToGroup(ea.getElements().map(el=>el.id));
+      if(ea.getViewSelectedElements().length>0) {
+        ea.targetView.currentPosition = {x: bb.topX+bb.width+100, y: bb.topY};
+      }
+      ea.addElementsToView(true, false);
+      break;
+    case "mermaid":
+      if(content.startsWith("mermaid")) {
+        content = content.replace(/^mermaid/,"").trim();
+      }
+
+      try {
+        result = await ea.addMermaid(content);
+        if(typeof result === "string") {
+          await errorMessage(spinnerID, "Open [More Tools / Mermaid to Excalidraw] to manually fix the received mermaid script<br><br>" + result);
+          return;
+        }
+      } catch (e) {
+        ea.addText(0,0,content);
+      }
+      ea.getElement(spinnerID).isDeleted = true;
+      ea.targetView.currentPosition = {x: bb.topX+bb.width+100, y: bb.topY-bb.height};
+      await ea.addElementsToView(true, false);
+      setMermaidDataToStorage(content);
+      new Notice("Open More Tools/Mermaid to Excalidraw in the top tools menu to edit the generated diagram",8000);
+      break;
+  }
+}
+
+// --------------------------------------
+// User Interface
+// --------------------------------------
+let previewDiv;
+const fragWithHTML = (html) => createFragment((frag) => (frag.createDiv().innerHTML = html));
+const isImageGenerationTask = () => systemPrompts[agentTask].type === "image-gen" || systemPrompts[agentTask].type === "image-gen-silent" || systemPrompts[agentTask].type === "image-edit";
+const addPreviewImage = () => {
+  if(!previewDiv) return;
+  previewDiv.empty();
+  previewDiv.createEl("img",{
+    attr: {
+      style: `max-width: 100%;max-height: 30vh;`,
+      src: imageDataURL,
+    }
+  });
+  if(maskDataURL) {
+    previewDiv.createEl("img",{
+      attr: {
+        style: `max-width: 100%;max-height: 30vh;`,
+        src: maskDataURL,
+      }
+    });
+  }
+}
+
+const configModal = new ea.obsidian.Modal(app);
+configModal.modalEl.style.width="100%";
+configModal.modalEl.style.maxWidth="1000px";
+
+configModal.onOpen = async () => {
+  const contentEl = configModal.contentEl;
+  contentEl.createEl("h1", {text: "ExcaliAI"});
+
+  let systemPromptTextArea, systemPromptDiv, imageSizeSetting, imageSizeSettingDropdown, helpEl;
+  
+  new ea.obsidian.Setting(contentEl)
+    .setName("What would you like to do?")
+    .addDropdown(dropdown=>{
+      Object.keys(systemPrompts).forEach(key=>dropdown.addOption(key,key));
+      dropdown
+      .setValue(agentTask)
+      .onChange(async (value) => {
+        dirty = true;
+        const prevTask = agentTask;
+        agentTask = value;
+        if(
+          (systemPrompts[prevTask].type === "image-edit" && systemPrompts[value].type !== "image-edit") || 
+          (systemPrompts[prevTask].type !== "image-edit" && systemPrompts[value].type === "image-edit")
+        ) {
+          ({imageDataURL, maskDataURL} = await generateCanvasDataURL(ea.targetView, systemPrompts[value].type === "image-edit"));
+          addPreviewImage();
+          setImageModelAndSizes();
+          while (imageSizeSettingDropdown.selectEl.options.length > 0) { imageSizeSettingDropdown.selectEl.remove(0); }
+          validSizes.forEach(size=>imageSizeSettingDropdown.addOption(size,size));
+          imageSizeSettingDropdown.setValue(imageSize);
+        }
+        imageSizeSetting.settingEl.style.display = isImageGenerationTask() ? "" : "none";
+        const prompt = systemPrompts[value].prompt;
+        helpEl.innerHTML = `<b>Help: </b>` + systemPrompts[value].help;
+        if(prompt) {
+          systemPromptDiv.style.display = "";
+          systemPromptTextArea.setValue(systemPrompts[value].prompt);
+        } else {
+          systemPromptDiv.style.display = "none";
+        }
+      });
+   })
+
+  helpEl = contentEl.createEl("p");
+  helpEl.innerHTML = `<b>Help: </b>` + systemPrompts[agentTask].help;
+
+  systemPromptDiv = contentEl.createDiv();
+  systemPromptDiv.createEl("h4", {text: "Customize System Prompt"});
+  systemPromptDiv.createEl("span", {text: "Unless you know what you are doing I do not recommend changing the system prompt"})
+  const systemPromptSetting = new ea.obsidian.Setting(systemPromptDiv)
+    .addTextArea(text => {
+       systemPromptTextArea = text;
+       const prompt = systemPrompts[agentTask].prompt;
+       text.inputEl.style.minHeight = "10em";
+       text.inputEl.style.width = "100%";
+       text.setValue(prompt);
+       text.onChange(value => {
+         systemPrompts[value].prompt = value;
+       });
+       if(!prompt) systemPromptDiv.style.display = "none";
+    })
+  systemPromptSetting.nameEl.style.display = "none";
+  systemPromptSetting.descEl.style.display = "none";
+  systemPromptSetting.infoEl.style.display = "none";
+
+  contentEl.createEl("h4", {text: "User Prompt"});
+  const userPromptSetting = new ea.obsidian.Setting(contentEl)
+    .addTextArea(text => {
+       text.inputEl.style.minHeight = "10em";
+       text.inputEl.style.width = "100%";
+       text.setValue(userPrompt);
+       text.onChange(value => {
+         userPrompt = value;
+         dirty = true;
+       })
+    })
+  userPromptSetting.nameEl.style.display = "none";
+  userPromptSetting.descEl.style.display = "none";
+  userPromptSetting.infoEl.style.display = "none";
+
+  imageSizeSetting = new ea.obsidian.Setting(contentEl)
+    .setName("Select image size")
+    .setDesc(fragWithHTML("<mark>⚠️ Important ⚠️</mark>: " + IMAGE_WARNING))
+    .addDropdown(dropdown=>{
+      validSizes.forEach(size=>dropdown.addOption(size,size));
+      imageSizeSettingDropdown = dropdown;
+      dropdown
+        .setValue(imageSize)
+        .onChange(async (value) => {
+          dirty = true;
+          imageSize = value;
+          if(systemPrompts[agentTask].type === "image-edit") {
+            ({imageDataURL, maskDataURL} = await generateCanvasDataURL(ea.targetView, true));
+            addPreviewImage();
+          }
+        });
+   })
+   imageSizeSetting.settingEl.style.display = isImageGenerationTask() ? "" : "none";
+  
+  if(imageDataURL) {
+    previewDiv = contentEl.createDiv({
+      attr: {
+        style: "text-align: center;",
+      }
+    });
+    addPreviewImage();
+  } else {
+    contentEl.createEl("h4", {text: "No elements are selected from your canvas"});
+    contentEl.createEl("span", {text: "Because there are no Excalidraw elements selected on the canvas, only the text prompt will be sent to OpenAI."});
+  }
+  
+  new ea.obsidian.Setting(contentEl)
+    .addButton(button => 
+      button
+      .setButtonText("Run")
+      .onClick((event)=>{
+        run(userPrompt); //Obsidian crashes otherwise, likely has to do with requesting an new frame for react
+        configModal.close();
+      })
+    );
+}
+
+configModal.onClose = () => {
+  if(dirty) {
+    settings["User Prompt"] = userPrompt;
+    settings["Agent's Task"] = agentTask;
+    settings["Image Size"] = imageSize;
+    ea.setScriptSettings(settings);
+  }
+}
+  
+configModal.open();

ea-scripts/ExcaliAI.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><path d="M320 0c17.7 0 32 14.3 32 32V96H472c39.8 0 72 32.2 72 72V440c0 39.8-32.2 72-72 72H168c-39.8 0-72-32.2-72-72V168c0-39.8 32.2-72 72-72H288V32c0-17.7 14.3-32 32-32zM208 384c-8.8 0-16 7.2-16 16s7.2 16 16 16h32c8.8 0 16-7.2 16-16s-7.2-16-16-16H208zm96 0c-8.8 0-16 7.2-16 16s7.2 16 16 16h32c8.8 0 16-7.2 16-16s-7.2-16-16-16H304zm96 0c-8.8 0-16 7.2-16 16s7.2 16 16 16h32c8.8 0 16-7.2 16-16s-7.2-16-16-16H400zM264 256a40 40 0 1 0 -80 0 40 40 0 1 0 80 0zm152 40a40 40 0 1 0 0-80 40 40 0 1 0 0 80zM48 224H64V416H48c-26.5 0-48-21.5-48-48V272c0-26.5 21.5-48 48-48zm544 0c26.5 0 48 21.5 48 48v96c0 26.5-21.5 48-48 48H576V224h16z"/></svg>

ea-scripts/GPT-Draw-a-UI.md

@@ -0,0 +1,673 @@
+/*
+<iframe width="560" height="315" src="https://www.youtube.com/embed/A1vrSGBbWgo" 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-draw-a-ui.jpg)
+```js*/
+let dirty=false;
+
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("2.0.12")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+
+const outputTypes = {
+  "html": {
+    instruction: "Turn this into a single html file using tailwind. Return a single message containing only the html file in a codeblock.",
+    blocktype: "html"
+  },
+  "mermaid": {
+    instruction: "Return a single message containing only the mermaid diagram in a codeblock.",
+    blocktype: "mermaid"
+  },
+  "svg": {
+    instruction: "Return a single message containing only the SVG code in an html codeblock.",
+    blocktype: "svg"
+  },
+  "image-gen": {
+    instruction: "Return a single message with the generated image prompt in a codeblock",
+    blocktype: "image"
+  },
+  "image-edit": {
+    instruction: "",
+    blocktype: "image"
+  }
+}
+
+const systemPrompts = {
+  "Challenge my thinking": {
+    prompt: `Your task is to interpret a screenshot of a whiteboard, translating its ideas into a Mermaid graph. The whiteboard will encompass thoughts on a subject. Within the mind map, distinguish ideas that challenge, dispute, or contradict the whiteboard content. Additionally, include concepts that expand, complement, or advance the user's thinking. Utilize the Mermaid graph diagram type and present the resulting Mermaid diagram within a code block. Ensure the Mermaid script excludes the use of parentheses ().`,
+    type: "mermaid",
+    help: "Translate your image and optional text prompt into a Mermaid mindmap. If there are conversion errors, edit the Mermaid script under 'More Tools'."
+  },
+  "Convert sketch to shapes": {
+    prompt: `Given an image featuring various geometric shapes drawn by the user, your objective is to analyze the input and generate SVG code that accurately represents these shapes. Your output will be the SVG code enclosed in an HTML code block.`,
+    type: "svg",
+    help: "Convert selected scribbles into shapes; works better with fewer shapes. Experimental and may not produce good drawings."
+  },
+  "Create a simple Excalidraw icon": {
+    prompt: `Given a description of an SVG image from the user, your objective is to generate the corresponding SVG code. Avoid incorporating textual elements within the generated SVG. Your output should be the resulting SVG code enclosed in an HTML code block.`,
+    type: "svg",
+    help: "Convert text prompts into simple icons inserted as Excalidraw elements. Expect only a text prompt. Experimental and may not produce good drawings."
+  },
+  "Edit an image": {
+    prompt: null,
+    type: "image-edit",
+    help: "Image elements will be used as the Image. Shapes on top of the image will be the Mask. Use the prompt to instruct Dall-e about the changes. Dall-e-2 model will be used."
+  },
+  "Generate an image from image and prompt": {
+    prompt: "Your task involves receiving an image and a textual prompt from the user. Your goal is to craft a detailed, accurate, and descriptive narrative of the image, tailored for effective image generation. Utilize the user-provided text prompt to inform and guide your depiction of the image. Ensure the resulting image remains text-free.",
+    type: "image-gen",
+    help: "Generate an image based on the drawing and prompt using ChatGPT-Vision and Dall-e. Provide a contextual text-prompt for accurate interpretation."
+  },
+  "Generate an image from prompt": {
+    prompt: null,
+    type: "image-gen",
+    help: "Send only the text prompt to OpenAI. Provide a detailed description; OpenAI will enrich your prompt automatically. To avoid it, start your prompt like this 'DO NOT add any detail, just use it AS-IS:'"
+  },
+  "Generate an image to illustrate a quote": {
+    prompt: "Your task involves transforming a user-provided quote into a detailed and imaginative illustration. Craft a visual representation that captures the essence of the quote and resonates well with a broad audience. If the Author's name is provided, aim to establish a connection between the illustration and the Author. This can be achieved by referencing a well-known story from the Author, situating the image in the Author's era or setting, or employing other creative methods of association. Additionally, provide preferences for styling, such as the chosen medium and artistic direction, to guide the image creation process. Ensure the resulting image remains text-free. Your task output should comprise a descriptive and detailed narrative aimed at facilitating the creation of a captivating illustration from the quote.",
+    type: "image-gen",
+    help: "ExcaliAI will create an image prompt to illustrate your text input - a quote - with GPT, then generate an image using Dall-e.  In case you include the Author's name, GPT will try to generate an image that in some way references the Author."
+  },
+  "Visual brainstorm": {
+    prompt: "Your objective is to interpret a screenshot of a whiteboard, creating an image aimed at sparking further thoughts on the subject. The whiteboard will present diverse ideas about a specific topic. Your generated image should achieve one of two purposes: highlighting concepts that challenge, dispute, or contradict the whiteboard content, or introducing ideas that expand, complement, or enrich the user's thinking. You have the option to include multiple tiles in the resulting image, resembling a sequence akin to a comic strip. Ensure that the image remains devoid of text.",
+    type: "image-gen",
+    help: "Use ChatGPT Visions and Dall-e to create an image based on your text prompt and image to spark new ideas."
+  },
+  "Wireframe to code": {
+    prompt: `You are an expert tailwind developer. A user will provide you with a low-fidelity wireframe of an application and you will return a single html file that uses tailwind to create the website. Use creative license to make the application more fleshed out. Write the necessary javascript code. If you need to insert an image, use placehold.co to create a placeholder image.`,
+    type: "html",
+    help: "Use GPT Visions to interpret the wireframe and generate a web application. You may copy the resulting code from the active embeddable's top left menu."
+  },
+}
+
+const IMAGE_WARNING = "The generated image is linked through a temporary OpenAI URL and will be removed in approximately 30 minutes. To save it permanently, choose 'Save image from URL to local file' from the Obsidian Command Palette."
+// --------------------------------------
+// Initialize values and settings
+// --------------------------------------
+let settings = ea.getScriptSettings();
+
+if(!settings["Agent's Task"]) {
+  settings = {
+    "Agent's Task": "Wireframe to code",
+    "User Prompt": "",
+  };
+  await ea.setScriptSettings(settings);
+}
+
+const OPENAI_API_KEY = ea.plugin.settings.openAIAPIToken;
+if(!OPENAI_API_KEY || OPENAI_API_KEY === "") {
+  new Notice("You must first configure your API key in Excalidraw Plugin Settings");
+  return;
+}
+
+let userPrompt = settings["User Prompt"] ?? "";
+let agentTask = settings["Agent's Task"];
+let imageSize = settings["Image Size"]??"1024x1024";
+
+if(!systemPrompts.hasOwnProperty(agentTask)) {
+  agentTask = Object.keys(systemPrompts)[0];
+}
+let imageModel, valideSizes;
+
+const setImageModelAndSizes = () => {
+  imageModel = systemPrompts[agentTask].type === "image-edit"
+    ? "dall-e-2"
+    : ea.plugin.settings.openAIDefaultImageGenerationModel;
+  validSizes = imageModel === "dall-e-2"
+    ? [`256x256`, `512x512`, `1024x1024`]
+    : (imageModel === "dall-e-3"
+      ? [`1024x1024`, `1792x1024`, `1024x1792`]
+      : [`1024x1024`])
+  if(!validSizes.includes(imageSize)) {
+    imageSize = "1024x1024";
+    dirty = true;
+  }
+}
+setImageModelAndSizes();
+
+// --------------------------------------
+// Generate Image Blob From Selected Excalidraw Elements
+// --------------------------------------
+const calculateImageScale = (elements) => {
+  const bb = ea.getBoundingBox(elements);
+  const size = (bb.width*bb.height);
+  const minRatio = Math.sqrt(360000/size);
+  const maxRatio = Math.sqrt(size/16000000);
+  return minRatio > 1 
+    ? minRatio
+    : (
+        maxRatio > 1 
+        ? 1/maxRatio
+        : 1
+      );
+}
+
+const createMask = async (dataURL) => {
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+
+    img.onload = () => {
+      const canvas = document.createElement('canvas');
+      canvas.width = img.width;
+      canvas.height = img.height;
+
+      const ctx = canvas.getContext('2d');
+      ctx.drawImage(img, 0, 0);
+
+      const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+      const data = imageData.data;
+      
+      for (let i = 0; i < data.length; i += 4) {
+        // If opaque (alpha > 0), make it transparent
+        if (data[i + 3] > 0) {
+          data[i + 3] = 0; // Set alpha to 0 (transparent)
+        } else if (data[i + 3] === 0) {
+          // If fully transparent, make it red
+          data[i] = 255; // Red
+          data[i + 1] = 0; // Green
+          data[i + 2] = 0; // Blue
+          data[i + 3] = 255; // make it opaque
+        }
+      }
+
+      ctx.putImageData(imageData, 0, 0);
+      const maskDataURL = canvas.toDataURL();
+
+      resolve(maskDataURL);
+    };
+
+    img.onerror = error => {
+      reject(error);
+    };
+
+    img.src = dataURL;
+  });
+}
+
+//https://platform.openai.com/docs/api-reference/images/createEdit
+//dall-e-2 image edit only works on square images
+//if targetDalleImageEdit === true then the image and the mask will be returned in two separate dataURLs
+let squareBB;
+
+const generateCanvasDataURL = async (view, targetDalleImageEdit=false) => {
+  let PADDING = 5;
+  await view.forceSave(true); //to ensure recently embedded PNG and other images are saved to file
+  const viewElements = ea.getViewSelectedElements();
+  if(viewElements.length === 0) {
+    return {imageDataURL: null, maskDataURL: null} ;
+  }
+  ea.copyViewElementsToEAforEditing(viewElements, true); //copying the images objects over to EA for PNG generation
+  
+  let maskDataURL;
+  const loader = ea.getEmbeddedFilesLoader(false);
+  let scale = calculateImageScale(ea.getElements());
+  const bb = ea.getBoundingBox(viewElements);
+  if(ea.getElements()
+    .filter(el=>el.type==="image")
+    .some(el=>Math.round(el.width) === Math.round(bb.width) && Math.round(el.height) === Math.round(bb.height))
+  ) { PADDING = 0; }
+  
+  let exportSettings = {withBackground: true, withTheme: true};
+  
+  if(targetDalleImageEdit) {
+    PADDING = 0;  
+    const strokeColor = ea.style.strokeColor;
+    const backgroundColor = ea.style.backgroundColor;
+    ea.style.backgroundColor = "transparent";
+    ea.style.strokeColor = "transparent";
+    let rectID;
+    if(bb.height > bb.width) {
+      rectID = ea.addRect(bb.topX-(bb.height-bb.width)/2, bb.topY,bb.height, bb.height);
+    }
+    if(bb.width > bb.height) {
+      rectID = ea.addRect(bb.topX, bb.topY-(bb.width-bb.height)/2,bb.width, bb.width);
+    }
+    if(bb.height === bb.width) {
+      rectID = ea.addRect(bb.topX, bb.topY, bb.width, bb.height);
+    }
+    const rect = ea.getElement(rectID);
+    squareBB = {topX: rect.x-PADDING, topY: rect.y-PADDING, width: rect.width + 2*PADDING, height: rect.height + 2*PADDING};
+    ea.style.strokeColor = strokeColor;
+    ea.style.backgroundColor = backgroundColor;
+    ea.getElements().filter(el=>el.type === "image").forEach(el=>{el.isDeleted = true});
+
+    dalleWidth = parseInt(imageSize.split("x")[0]);
+    scale = dalleWidth/squareBB.width;
+    exportSettings = {withBackground: false, withTheme: true};
+    maskDataURL= await ea.createPNGBase64(
+      null, scale, exportSettings, loader, "light", PADDING
+    );
+    maskDataURL = await createMask(maskDataURL)
+    ea.getElements().filter(el=>el.type === "image").forEach(el=>{el.isDeleted = false});
+    ea.getElements().filter(el=>el.type !== "image" && el.id !== rectID).forEach(el=>{el.isDeleted = true});
+  }
+
+  const imageDataURL = await ea.createPNGBase64(
+    null, scale, exportSettings, loader, "light", PADDING
+  );
+  ea.clear();
+  return {imageDataURL, maskDataURL};
+}
+
+let {imageDataURL, maskDataURL} = await generateCanvasDataURL(ea.targetView, systemPrompts[agentTask].type === "image-edit");
+
+// --------------------------------------
+// Support functions - embeddable spinner and error
+// --------------------------------------
+const spinner = await ea.convertStringToDataURL(`
+  <html><head><style>
+    html, body {width: 100%; height: 100%; color: ${ea.getExcalidrawAPI().getAppState().theme === "dark" ? "white" : "black"};}
+    body {display: flex; align-items: center; justify-content: center; flex-direction: column; gap: 1rem; overflow: hidden;}
+    .Spinner {display: flex; align-items: center; justify-content: center; margin-left: auto; margin-right: auto;}
+    .Spinner svg {animation: rotate 1.6s linear infinite; transform-origin: center center; width: 40px; height: 40px;}
+    .Spinner circle {stroke: currentColor; animation: dash 1.6s linear 0s infinite; stroke-linecap: round;}
+    @keyframes rotate {100% {transform: rotate(360deg);}}
+    @keyframes dash {
+      0% {stroke-dasharray: 1, 300; stroke-dashoffset: 0;}
+      50% {stroke-dasharray: 150, 300; stroke-dashoffset: -200;}
+      100% {stroke-dasharray: 1, 300; stroke-dashoffset: -280;}
+    }
+  </style></head><body>
+    <div class="Spinner">
+      <svg viewBox="0 0 100 100">
+        <circle cx="50" cy="50" r="46" stroke-width="8" fill="none" stroke-miter-limit="10"/>
+      </svg>
+    </div>
+    <div>Generating...</div>
+  </body></html>`);
+
+  const errorMessage = async (spinnerID, message) => {
+    const error = "Something went wrong! Check developer console for more.";
+    const details = message ? `<p>${message}</p>` : "";
+    const errorDataURL = await ea.convertStringToDataURL(`
+      <html><head><style>
+        html, body {height: 100%;}
+        body {display: flex; flex-direction: column; align-items: center; justify-content: center; color: red;}
+        h1, h3 {margin-top: 0;margin-bottom: 0.5rem;}
+      </style></head><body>
+        <h1>Error!</h1>
+        <h3>${error}</h3>${details}
+      </body></html>`);
+    new Notice (error);
+    ea.getElement(spinnerID).link = errorDataURL;
+    ea.addElementsToView(false,true);
+  }
+
+// --------------------------------------
+// Utility to write Mermaid to dialog
+// --------------------------------------
+const EDITOR_LS_KEYS = {
+  OAI_API_KEY: "excalidraw-oai-api-key",
+  MERMAID_TO_EXCALIDRAW: "mermaid-to-excalidraw",
+  PUBLISH_LIBRARY: "publish-library-data",
+};
+
+const setMermaidDataToStorage = (mermaidDefinition) => {
+  try {
+    window.localStorage.setItem(
+      EDITOR_LS_KEYS.MERMAID_TO_EXCALIDRAW,
+      JSON.stringify(mermaidDefinition)
+    );
+    return true;
+  } catch (error) {
+    console.warn(`localStorage.setItem error: ${error.message}`);
+    return false;
+  }
+};
+  
+// --------------------------------------
+// Submit Prompt
+// --------------------------------------
+const generateImage = async(text, spinnerID, bb) => {
+  const requestObject = {
+    text,
+    imageGenerationProperties: {
+      size: imageSize, 
+      //quality: "standard", //not supported by dall-e-2
+      n:1,
+    },
+  };
+  
+  const result = await ea.postOpenAI(requestObject);
+  console.log({result, json:result?.json});
+  
+  if(!result?.json?.data?.[0]?.url) {
+    await errorMessage(spinnerID, result?.json?.error?.message);
+    return;
+  }
+  
+  const spinner = ea.getElement(spinnerID)
+  spinner.isDeleted = true;
+  const imageID = await ea.addImage(spinner.x, spinner.y, result.json.data[0].url);
+  const imageEl = ea.getElement(imageID);
+  const revisedPrompt = result.json.data[0].revised_prompt;
+  if(revisedPrompt) {
+    ea.style.fontSize = 16;
+    const rectID = ea.addText(imageEl.x+15, imageEl.y + imageEl.height + 50, revisedPrompt, {
+      width: imageEl.width-30,
+      textAlign: "center",
+      textVerticalAlign: "top",
+      box: true,
+    })
+    ea.getElement(rectID).strokeColor = "transparent";
+    ea.getElement(rectID).backgroundColor = "transparent";
+    ea.addToGroup(ea.getElements().filter(el=>el.id !== spinnerID).map(el=>el.id));
+  }
+  
+  await ea.addElementsToView(false, true, true);
+  ea.getExcalidrawAPI().setToast({
+    message: IMAGE_WARNING,
+    duration: 15000,
+    closable: true
+  });
+}
+
+const run = async (text) => {
+  if(!text && !imageDataURL) {
+    new Notice("No prompt, aborting");
+    return;
+  }
+
+  const systemPrompt = systemPrompts[agentTask];
+  const outputType = outputTypes[systemPrompt.type];
+  const isImageGenRequest = outputType.blocktype === "image";
+  const isImageEditRequest = systemPrompt.type === "image-edit";
+
+  if(isImageEditRequest) {
+    if(!text) {
+      new Notice("You must provide a text prompt with instructions for how the image should be modified");
+      return;
+    }
+    if(!imageDataURL || !maskDataURL) {
+      new Notice("You must provide an image and a mask");
+      return;
+    }
+  }
+  
+  //place spinner next to selected elements
+  const bb = ea.getBoundingBox(ea.getViewSelectedElements()); 
+  const spinnerID = ea.addEmbeddable(bb.topX+bb.width+100,bb.topY-(720-bb.height)/2,550,720,spinner);
+  
+  //this block is in an async call using the isEACompleted flag because otherwise during debug Obsidian
+  //goes black (not freezes, but does not get a new frame for some reason)
+  //palcing this in an async call solves this issue
+  //If you know why this is happening and can offer a better solution, please reach out to @zsviczian
+  let isEACompleted = false;
+  setTimeout(async()=>{
+    await ea.addElementsToView(false,true);
+    ea.clear();
+    const embeddable = ea.getViewElements().filter(el=>el.id===spinnerID);
+    ea.copyViewElementsToEAforEditing(embeddable);
+    const els = ea.getViewSelectedElements();
+    ea.viewZoomToElements(false, els.concat(embeddable));
+    isEACompleted = true;
+  });
+
+  if(isImageGenRequest && !systemPrompt.prompt && !isImageEditRequest) {
+    generateImage(text,spinnerID,bb);
+    return;
+  }
+  
+  const requestObject = isImageEditRequest
+  ? {
+      ...imageDataURL ? {image: imageDataURL} : {},
+      ...(text && text.trim() !== "") ? {text} : {},
+      imageGenerationProperties: {
+        size: imageSize, 
+        //quality: "standard", //not supported by dall-e-2
+        n:1,
+        mask: maskDataURL,
+      },
+    }
+  : {
+      ...imageDataURL ? {image: imageDataURL} : {},
+      ...(text && text.trim() !== "") ? {text} : {},
+      systemPrompt: systemPrompt.prompt,
+      instruction: outputType.instruction,
+    }
+  
+  //Get result from GPT
+  const result = await ea.postOpenAI(requestObject);
+  console.log({result, json:result?.json});
+
+  //checking that EA has completed. Because the postOpenAI call is an async await
+  //I don't expect EA not to be completed by now. However the devil never sleeps.
+  //This (the insomnia of the Devil) is why I have a watchdog here as well
+  let counter = 0
+  while(!isEACompleted && counter++<10) sleep(50);
+  if(!isEACompleted) {
+    await errorMessage(spinnerID, "Unexpected issue with ExcalidrawAutomate");
+    return;
+  }
+
+  if(isImageEditRequest) {   
+    if(!result?.json?.data?.[0]?.url) {
+      await errorMessage(spinnerID, result?.json?.error?.message);
+      return;
+    }
+    
+    const spinner = ea.getElement(spinnerID)
+    spinner.isDeleted = true;
+    const imageID = await ea.addImage(spinner.x, spinner.y, result.json.data[0].url);    
+    await ea.addElementsToView(false, true, true);
+    ea.getExcalidrawAPI().setToast({
+      message: IMAGE_WARNING,
+      duration: 15000,
+      closable: true
+    });
+    return;
+  }
+
+  if(!result?.json?.hasOwnProperty("choices")) {
+    await errorMessage(spinnerID, result?.json?.error?.message);
+    return;
+  }
+
+  //extract codeblock and display result
+  let content = ea.extractCodeBlocks(result.json.choices[0]?.message?.content)[0]?.data;
+
+  if(!content) {
+    await errorMessage(spinnerID);
+    return;
+  }
+
+  if(isImageGenRequest) {
+    generateImage(content,spinnerID,bb);
+    return;
+  }
+  
+  switch(outputType.blocktype) {
+    case "html":
+      ea.getElement(spinnerID).link = await ea.convertStringToDataURL(content);
+      ea.addElementsToView(false,true);
+      break;
+    case "svg":
+      ea.getElement(spinnerID).isDeleted = true;
+      ea.importSVG(content);
+      ea.addToGroup(ea.getElements().map(el=>el.id));
+      if(ea.getViewSelectedElements().length>0) {
+        ea.targetView.currentPosition = {x: bb.topX+bb.width+100, y: bb.topY};
+      }
+      ea.addElementsToView(true, false);
+      break;
+    case "mermaid":
+      if(content.startsWith("mermaid")) {
+        content = content.replace(/^mermaid/,"").trim();
+      }
+
+      try {
+        result = await ea.addMermaid(content);
+        if(typeof result === "string") {
+          await errorMessage(spinnerID, "Open [More Tools / Mermaid to Excalidraw] to manually fix the received mermaid script<br><br>" + result);
+          return;
+        }
+      } catch (e) {
+        ea.addText(0,0,content);
+      }
+      ea.getElement(spinnerID).isDeleted = true;
+      ea.targetView.currentPosition = {x: bb.topX+bb.width+100, y: bb.topY-bb.height};
+      await ea.addElementsToView(true, false);
+      setMermaidDataToStorage(content);
+      new Notice("Open More Tools/Mermaid to Excalidraw in the top tools menu to edit the generated diagram",8000);
+      break;
+  }
+}
+
+// --------------------------------------
+// User Interface
+// --------------------------------------
+let previewDiv;
+const fragWithHTML = (html) => createFragment((frag) => (frag.createDiv().innerHTML = html));
+const isImageGenerationTask = () => systemPrompts[agentTask].type === "image-gen" || systemPrompts[agentTask].type === "image-edit";
+const addPreviewImage = () => {
+  if(!previewDiv) return;
+  previewDiv.empty();
+  previewDiv.createEl("img",{
+    attr: {
+      style: `max-width: 100%;max-height: 30vh;`,
+      src: imageDataURL,
+    }
+  });
+  if(maskDataURL) {
+    previewDiv.createEl("img",{
+      attr: {
+        style: `max-width: 100%;max-height: 30vh;`,
+        src: maskDataURL,
+      }
+    });
+  }
+}
+
+const configModal = new ea.obsidian.Modal(app);
+configModal.modalEl.style.width="100%";
+configModal.modalEl.style.maxWidth="1000px";
+
+configModal.onOpen = async () => {
+  const contentEl = configModal.contentEl;
+  contentEl.createEl("h1", {text: "ExcaliAI"});
+
+  let systemPromptTextArea, systemPromptDiv, imageSizeSetting, imageSizeSettingDropdown, helpEl;
+  
+  new ea.obsidian.Setting(contentEl)
+    .setName("What would you like to do?")
+    .addDropdown(dropdown=>{
+      Object.keys(systemPrompts).forEach(key=>dropdown.addOption(key,key));
+      dropdown
+      .setValue(agentTask)
+      .onChange(async (value) => {
+        dirty = true;
+        const prevTask = agentTask;
+        agentTask = value;
+        if(
+          (systemPrompts[prevTask].type === "image-edit" && systemPrompts[value].type !== "image-edit") || 
+          (systemPrompts[prevTask].type !== "image-edit" && systemPrompts[value].type === "image-edit")
+        ) {
+          ({imageDataURL, maskDataURL} = await generateCanvasDataURL(ea.targetView, systemPrompts[value].type === "image-edit"));
+          addPreviewImage();
+          setImageModelAndSizes();
+          while (imageSizeSettingDropdown.selectEl.options.length > 0) { imageSizeSettingDropdown.selectEl.remove(0); }
+          validSizes.forEach(size=>imageSizeSettingDropdown.addOption(size,size));
+          imageSizeSettingDropdown.setValue(imageSize);
+        }
+        imageSizeSetting.settingEl.style.display = isImageGenerationTask() ? "" : "none";
+        const prompt = systemPrompts[value].prompt;
+        helpEl.innerHTML = `<b>Help: </b>` + systemPrompts[value].help;
+        if(prompt) {
+          systemPromptDiv.style.display = "";
+          systemPromptTextArea.setValue(systemPrompts[value].prompt);
+        } else {
+          systemPromptDiv.style.display = "none";
+        }
+      });
+   })
+
+  helpEl = contentEl.createEl("p");
+  helpEl.innerHTML = `<b>Help: </b>` + systemPrompts[agentTask].help;
+
+  systemPromptDiv = contentEl.createDiv();
+  systemPromptDiv.createEl("h4", {text: "Customize System Prompt"});
+  systemPromptDiv.createEl("span", {text: "Unless you know what you are doing I do not recommend changing the system prompt"})
+  const systemPromptSetting = new ea.obsidian.Setting(systemPromptDiv)
+    .addTextArea(text => {
+       systemPromptTextArea = text;
+       const prompt = systemPrompts[agentTask].prompt;
+       text.inputEl.style.minHeight = "10em";
+       text.inputEl.style.width = "100%";
+       text.setValue(prompt);
+       text.onChange(value => {
+         systemPrompts[value].prompt = value;
+       });
+       if(!prompt) systemPromptDiv.style.display = "none";
+    })
+  systemPromptSetting.nameEl.style.display = "none";
+  systemPromptSetting.descEl.style.display = "none";
+  systemPromptSetting.infoEl.style.display = "none";
+
+  contentEl.createEl("h4", {text: "User Prompt"});
+  const userPromptSetting = new ea.obsidian.Setting(contentEl)
+    .addTextArea(text => {
+       text.inputEl.style.minHeight = "10em";
+       text.inputEl.style.width = "100%";
+       text.setValue(userPrompt);
+       text.onChange(value => {
+         userPrompt = value;
+         dirty = true;
+       })
+    })
+  userPromptSetting.nameEl.style.display = "none";
+  userPromptSetting.descEl.style.display = "none";
+  userPromptSetting.infoEl.style.display = "none";
+
+  imageSizeSetting = new ea.obsidian.Setting(contentEl)
+    .setName("Select image size")
+    .setDesc(fragWithHTML("<mark>⚠️ Important ⚠️</mark>: " + IMAGE_WARNING))
+    .addDropdown(dropdown=>{
+      validSizes.forEach(size=>dropdown.addOption(size,size));
+      imageSizeSettingDropdown = dropdown;
+      dropdown
+        .setValue(imageSize)
+        .onChange(async (value) => {
+          dirty = true;
+          imageSize = value;
+          if(systemPrompts[agentTask].type === "image-edit") {
+            ({imageDataURL, maskDataURL} = await generateCanvasDataURL(ea.targetView, true));
+            addPreviewImage();
+          }
+        });
+   })
+   imageSizeSetting.settingEl.style.display = isImageGenerationTask() ? "" : "none";
+  
+  if(imageDataURL) {
+    previewDiv = contentEl.createDiv({
+      attr: {
+        style: "text-align: center;",
+      }
+    });
+    addPreviewImage();
+  } else {
+    contentEl.createEl("h4", {text: "No elements are selected from your canvas"});
+    contentEl.createEl("span", {text: "Because there are no Excalidraw elements selected on the canvas, only the text prompt will be sent to OpenAI."});
+  }
+  
+  new ea.obsidian.Setting(contentEl)
+    .addButton(button => 
+      button
+      .setButtonText("Run")
+      .onClick((event)=>{
+        run(userPrompt); //Obsidian crashes otherwise, likely has to do with requesting an new frame for react
+        configModal.close();
+      })
+    );
+}
+
+configModal.onClose = () => {
+  if(dirty) {
+    settings["User Prompt"] = userPrompt;
+    settings["Agent's Task"] = agentTask;
+    settings["Image Size"] = imageSize;
+    ea.setScriptSettings(settings);
+  }
+}
+  
+configModal.open();

ea-scripts/GPT-Draw-a-UI.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><path d="M320 0c17.7 0 32 14.3 32 32V96H472c39.8 0 72 32.2 72 72V440c0 39.8-32.2 72-72 72H168c-39.8 0-72-32.2-72-72V168c0-39.8 32.2-72 72-72H288V32c0-17.7 14.3-32 32-32zM208 384c-8.8 0-16 7.2-16 16s7.2 16 16 16h32c8.8 0 16-7.2 16-16s-7.2-16-16-16H208zm96 0c-8.8 0-16 7.2-16 16s7.2 16 16 16h32c8.8 0 16-7.2 16-16s-7.2-16-16-16H304zm96 0c-8.8 0-16 7.2-16 16s7.2 16 16 16h32c8.8 0 16-7.2 16-16s-7.2-16-16-16H400zM264 256a40 40 0 1 0 -80 0 40 40 0 1 0 80 0zm152 40a40 40 0 1 0 0-80 40 40 0 1 0 0 80zM48 224H64V416H48c-26.5 0-48-21.5-48-48V272c0-26.5 21.5-48 48-48zm544 0c26.5 0 48 21.5 48 48v96c0 26.5-21.5 48-48 48H576V224h16z"/></svg>

ea-scripts/Golden Ratio.md

@@ -0,0 +1,673 @@
+/*
+The script performs two different functions depending on the elements selected in the view.
+1) In case you select text elements, the script will cycle through a set of font scales. First the 2 larger fonts following the Fibonacci sequence (fontsize * φ; fonsize * φ^2), then the 2 smaller fonts (fontsize / φ; fontsize / φ^2), finally the original size, followed again by the 2 larger fonts. If you wait 2 seconds, the sequence clears and starts from which ever font size you are on. So if you want the 3rd larges font, then toggle twice, wait 2 sec, then toggle again.
+2) In case you select a single rectangle, the script will open the "Golden Grid", "Golden Spiral" window, where you can set up the type of grid or spiral you want to insert into the document.
+
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/golden-ratio.jpg)
+
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/2SHn_ruax-s" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+
+Gravitational point of spiral: $$\left[x,y\right]=\left[ x + \frac{{\text{width} \cdot \phi^2}}{{\phi^2 + 1}}\;, \; y + \frac{{\text{height} \cdot \phi^2}}{{\phi^2 + 1}} \right]$$
+Dimensions of inner rectangles in case of Double Spiral: $$[width, height] = \left[\frac{width\cdot(\phi^2+1)}{2\phi^2}\;, \;\frac{height\cdot(\phi^2+1)}{2\phi^2}\right]$$
+
+```js*/
+const phi = (1 + Math.sqrt(5)) / 2; // Golden Ratio (φ)
+const inversePhi = (1-1/phi);
+const pointsPerCurve = 20; // Number of points per curve segment
+const ownerWindow = ea.targetView.ownerWindow;
+const hostLeaf = ea.targetView.leaf;
+let dirty = false;
+const ids = [];
+
+const textEls = ea.getViewSelectedElements().filter(el=>el.type === "text");
+let rect = ea.getViewSelectedElements().length === 1 ? ea.getViewSelectedElement() : null;
+if(!rect || rect.type !== "rectangle") {
+  //Fontsize cycle
+  if(textEls.length>0) {
+    if(window.excalidrawGoldenRatio) {
+      clearTimeout(window.excalidrawGoldenRatio?.timer); 
+    } else {
+      window.excalidrawGoldenRatio = {timer: null, cycle:-1};
+    }
+    window.excalidrawGoldenRatio.timer = setTimeout(()=>{delete window.excalidrawGoldenRatio;},2000);
+    window.excalidrawGoldenRatio.cycle = (window.excalidrawGoldenRatio.cycle+1)%5;
+    
+    ea.copyViewElementsToEAforEditing(textEls);
+    ea.getElements().forEach(el=> {
+      el.fontSize = window.excalidrawGoldenRatio.cycle === 2
+        ? el.fontSize / Math.pow(phi,4)
+        : el.fontSize * phi;
+      const font = ExcalidrawLib.getFontString(el);
+      const lineHeight = ExcalidrawLib.getDefaultLineHeight(el.fontFamily);
+      const {width, height, baseline} = ExcalidrawLib.measureText(el.originalText, font, lineHeight);
+      el.width = width;
+      el.height = height;
+      el.baseline = baseline;
+    });
+    ea.addElementsToView();
+    return;
+  }
+  new Notice("Select text elements, or a select a single rectangle");
+  return;
+}
+ea.copyViewElementsToEAforEditing([rect]);
+rect = ea.getElement(rect.id);
+ea.style.strokeColor = rect.strokeColor;
+ea.style.strokeWidth = rect.strokeWidth;
+ea.style.roughness = rect.roughness;
+ea.style.angle = rect.angle;
+let {x,y,width,height} = rect;
+
+// --------------------------------------------
+// Load Settings
+// --------------------------------------------
+let settings = ea.getScriptSettings();
+if(!settings["Horizontal Grid"]) {
+  settings = {
+    "Horizontal Grid" : {
+	  value: "left-right",
+      valueset: ["none","letf-right","right-left","center-out","center-in"]
+	},
+    "Vertical Grid": {
+      value: "none",
+      valueset: ["none","top-down","bottom-up","center-out","center-in"]
+    },
+    "Size": {
+      value: "6",
+      valueset: ["2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20"]
+    },
+    "Aspect Choice": {
+      value: "none",
+      valueset: ["none","adjust-width","adjust-height"]
+    },
+    "Type": "grid",
+    "Spiral Orientation": {
+      value: "top-left",
+      valueset: ["double","top-left","top-right","bottom-right","bottom-left"]
+    },
+    "Lock Elements": false,
+    "Send to Back": false,
+    "Update Style": false,
+    "Bold Spiral": false,
+  };
+  await ea.setScriptSettings(settings);
+}
+
+let hDirection = settings["Horizontal Grid"].value;
+let vDirection = settings["Vertical Grid"].value;
+let aspectChoice = settings["Aspect Choice"].value;
+let type = settings["Type"];
+let spiralOrientation = settings["Spiral Orientation"].value;
+let lockElements = settings["Lock Elements"];
+let sendToBack = settings["Send to Back"];
+let size = parseInt(settings["Size"].value);
+let updateStyle = settings["Update Style"];
+let boldSpiral = settings["Bold Spiral"];
+
+// --------------------------------------------
+// Rotation
+// --------------------------------------------
+let centerX, centerY;
+const rotatePointAndAddToElementList = (elementID) => {
+    ids.push(elementID);
+    const line = ea.getElement(elementID);
+    
+    // Calculate the initial position of the line's center
+    const lineCenterX = line.x + line.width / 2;
+    const lineCenterY = line.y + line.height / 2;
+
+    // Calculate the difference between the line's center and the rectangle's center
+    const diffX = lineCenterX - (rect.x + rect.width / 2);
+    const diffY = lineCenterY - (rect.y + rect.height / 2);
+
+    // Apply the rotation to the difference
+    const cosTheta = Math.cos(rect.angle);
+    const sinTheta = Math.sin(rect.angle);
+    const rotatedX = diffX * cosTheta - diffY * sinTheta;
+    const rotatedY = diffX * sinTheta + diffY * cosTheta;
+
+    // Calculate the new position of the line's center with respect to the rectangle's center
+    const newLineCenterX = rotatedX + (rect.x + rect.width / 2);
+    const newLineCenterY = rotatedY + (rect.y + rect.height / 2);
+
+    // Update the line's coordinates by adjusting for the change in the center
+    line.x += newLineCenterX - lineCenterX;
+    line.y += newLineCenterY - lineCenterY;
+}
+
+const rotatePointsWithinRectangle = (points) => {
+    const centerX = rect.x + rect.width / 2;
+    const centerY = rect.y + rect.height / 2;
+
+    const cosTheta = Math.cos(rect.angle);
+    const sinTheta = Math.sin(rect.angle);
+
+    const rotatedPoints = points.map(([x, y]) => {
+        // Translate the point relative to the rectangle's center
+        const translatedX = x - centerX;
+        const translatedY = y - centerY;
+
+        // Apply the rotation to the translated coordinates
+        const rotatedX = translatedX * cosTheta - translatedY * sinTheta;
+        const rotatedY = translatedX * sinTheta + translatedY * cosTheta;
+
+        // Translate back to the original coordinate system
+        const finalX = rotatedX + centerX;
+        const finalY = rotatedY + centerY;
+
+        return [finalX, finalY];
+    });
+
+    return rotatedPoints;
+}
+
+// --------------------------------------------
+// Grid
+// --------------------------------------------
+const calculateGoldenSum = (baseOfGoldenGrid, pow) => {
+  const ratio = 1 / phi;
+  const geometricSum = baseOfGoldenGrid * ((1 - Math.pow(ratio, pow)) / (1 - ratio));
+  return geometricSum;
+};
+
+const findBaseForGoldenGrid = (targetValue, n, scenario) => {
+  const ratio = 1 / phi;
+      if (scenario === "center-out") {
+      return targetValue * (2-2*ratio) / (1 + ratio + 2*Math.pow(ratio,n));
+    } else if (scenario === "center-in") {
+      return targetValue*2*(1-ratio)*Math.pow(phi,n-1) /(2*Math.pow(phi,n-1)*(1-Math.pow(ratio,n))-1+ratio);
+    } else {
+      return targetValue * (1-ratio)/(1-Math.pow(ratio,n));
+    } 
+}
+
+const calculateOffsetVertical = (scenario, base) => {
+  if (scenario === "center-out") return base / 2;
+  if (scenario === "center-in") return base / Math.pow(phi, size + 1) / 2;
+  return 0;
+};
+
+const horizontal = (direction, scenario) => {
+  const base = findBaseForGoldenGrid(width, size + 1, scenario);
+  const totalGridWidth = calculateGoldenSum(base, size + 1);
+
+  for (i = 1; i <= size; i++) {
+    const offset =
+      scenario === "center-out"
+        ? totalGridWidth - calculateGoldenSum(base, i)
+        : calculateGoldenSum(base, size + 1 - i);
+
+    const x2 =
+      direction === "left"
+        ? x + offset
+        : x + width - offset;
+
+    rotatePointAndAddToElementList(
+      ea.addLine([
+        [x2, y],
+        [x2, y + height],
+      ])
+    );
+  }
+};
+
+const vertical = (direction, scenario) => {
+  const base = findBaseForGoldenGrid(height, size + 1, scenario);
+  const totalGridWidth = calculateGoldenSum(base, size + 1);
+
+  for (i = 1; i <= size; i++) {
+    const offset =
+      scenario === "center-out"
+        ? totalGridWidth - calculateGoldenSum(base, i)
+        : calculateGoldenSum(base, size + 1 - i);
+
+    const y2 =
+      direction === "top"
+        ? y + offset
+        : y + height - offset;
+
+    rotatePointAndAddToElementList(
+      ea.addLine([
+        [x, y2],
+        [x+width, y2],
+      ])
+    );
+  }
+};
+
+const centerHorizontal = (scenario) => {
+  width = width / 2;
+  horizontal("left", scenario);
+  x += width;
+  horizontal("right", scenario);
+  x -= width;
+  width = 2*width;
+  
+};
+
+const centerVertical = (scenario) => {
+  height = height / 2;
+  vertical("top", scenario);
+  y += height;
+  vertical("bottom", scenario);
+  y -= height;
+  height = 2*height;
+};
+
+const drawGrid = () => {
+  switch(hDirection) {
+    case "none": break;
+    case "left-right": horizontal("left"); break;
+    case "right-left": horizontal("right"); break;
+    case "center-out": centerHorizontal("center-out"); break;
+    case "center-in": centerHorizontal("center-in"); break;
+  }
+  switch(vDirection) {
+    case "none": break;
+    case "top-down": vertical("top"); break;
+    case "bottom-up": vertical("bottom"); break;
+    case "center-out": centerVertical("center-out"); break;
+    case "center-in": centerVertical("center-in"); break;
+  }
+}
+
+// --------------------------------------------
+// Draw Spiral
+// --------------------------------------------
+const drawSpiral = () => {
+  let nextX, nextY, nextW, nextH;
+  let spiralPoints = [];
+  let curveEndX, curveEndY, curveX, curveY;
+  
+  const phaseShift = {
+    "bottom-right": 0,
+    "bottom-left": 2,
+    "top-left": 2,
+    "top-right": 0,
+  }[spiralOrientation];
+
+  let curveStartX = {
+    "bottom-right": x,
+    "bottom-left": x+width,
+    "top-left": x+width,
+    "top-right": x,
+  }[spiralOrientation];
+  
+  let curveStartY = {
+    "bottom-right": y+height,
+    "bottom-left": y+height,
+    "top-left": y,
+    "top-right": y,
+  }[spiralOrientation];
+
+  const mirror = spiralOrientation === "bottom-left" || spiralOrientation === "top-right";
+  for (let i = phaseShift; i < size+phaseShift; i++) {
+    const curvePhase = i%4;
+    const linePhase = mirror?[0,3,2,1][curvePhase]:curvePhase;
+    const longHorizontal = width/phi;
+    const shortHorizontal = width*inversePhi;
+    const longVertical = height/phi;
+    const shortVertical = height*inversePhi;
+    switch(linePhase) {
+      case 0: //right
+        nextX = x + longHorizontal;
+        nextY = y;
+        nextW = shortHorizontal;
+        nextH = height;
+        break;
+      case 1: //down
+        nextX = x;
+        nextY = y + longVertical;
+        nextW = width;
+        nextH = shortVertical;
+        break;
+      case 2: //left
+        nextX = x;
+        nextY = y;
+        nextW = shortHorizontal;
+        nextH = height;
+        break;
+      case 3: //up
+        nextX = x;
+        nextY = y;
+        nextW = width;
+        nextH = shortVertical;
+        break;
+    }
+
+    switch(curvePhase) {
+      case 0: //right
+        curveEndX = nextX;
+        curveEndY = mirror ? nextY + nextH : nextY;
+        break;
+      case 1: //down
+        curveEndX = nextX + nextW;
+        curveEndY = mirror ? nextY + nextH : nextY;
+        break;
+      case 2: //left
+        curveEndX = nextX + nextW;
+        curveEndY = mirror ? nextY : nextY + nextH;
+        break;
+      case 3: //up
+        curveEndX = nextX;
+        curveEndY = mirror ? nextY : nextY + nextH;
+        break;    
+    }
+
+    // Add points for the curve segment
+  
+    for (let j = 0; j <= pointsPerCurve; j++) {
+      const t = j / pointsPerCurve;
+      const angle = -Math.PI / 2 * t;
+  
+      switch(curvePhase) {
+        case 0:
+          curveX = curveEndX + (curveStartX - curveEndX) * Math.cos(angle);
+          curveY = curveStartY + (curveStartY - curveEndY) * Math.sin(angle);
+          break;
+        case 1:
+          curveX = curveStartX + (curveStartX - curveEndX) * Math.sin(angle);
+          curveY = curveEndY + (curveStartY - curveEndY) * Math.cos(angle);
+          break;
+        case 2:
+          curveX = curveEndX + (curveStartX - curveEndX) * Math.cos(angle);
+          curveY = curveStartY + (curveStartY - curveEndY) * Math.sin(angle);
+          break;
+        case 3:
+          curveX = curveStartX + (curveStartX - curveEndX) * Math.sin(angle);
+          curveY = curveEndY + (curveStartY - curveEndY) * Math.cos(angle);
+          break;
+      }
+      spiralPoints.push([curveX, curveY]);
+    }
+    x = nextX;
+    y = nextY;
+    curveStartX = curveEndX;
+    curveStartY = curveEndY;
+    width = nextW;
+    height = nextH;
+    switch(linePhase) {
+      case 0: rotatePointAndAddToElementList(ea.addLine([[x,y],[x,y+height]]));break;
+      case 1: rotatePointAndAddToElementList(ea.addLine([[x,y],[x+width,y]]));break;
+      case 2: rotatePointAndAddToElementList(ea.addLine([[x+width,y],[x+width,y+height]]));break;
+      case 3: rotatePointAndAddToElementList(ea.addLine([[x,y+height],[x+width,y+height]]));break;
+    }
+  }
+  const strokeWidth = ea.style.strokeWidth;
+  ea.style.strokeWidth = strokeWidth * (boldSpiral ? 3 : 1);
+  const angle = ea.style.angle;
+  ea.style.angle = 0;
+  ids.push(ea.addLine(rotatePointsWithinRectangle(spiralPoints)));
+  ea.style.angle = angle;
+  ea.style.strokeWidth = strokeWidth;
+}
+
+// --------------------------------------------
+// Update Aspect Ratio
+// --------------------------------------------
+const updateAspectRatio = () => {
+  switch(aspectChoice) {
+    case "none": break;
+    case "adjust-width": rect.width = rect.height/phi; break;
+    case "adjust-height": rect.height = rect.width/phi; break;
+  }
+  ({x,y,width,height} = rect);
+  centerX = x + width/2;
+  centerY = y + height/2;
+}
+// --------------------------------------------
+// UI
+// --------------------------------------------
+draw = async () => {
+  if(updateStyle) {
+    ea.style.strokeWidth = 0.5; rect.strokeWidth;
+    ea.style.roughness = 0; rect.roughness;
+    ea.style.roundness = null;
+    rect.strokeWidth = 0.5;
+    rect.roughness = 0;
+    rect.roundness = null;
+  }
+  updateAspectRatio();
+  switch(type) {
+    case "grid": drawGrid(); break;
+    case "spiral":
+      if(spiralOrientation === "double") {
+        wInner = width * (Math.pow(phi,2)+1)/(2*Math.pow(phi,2));
+        hInner = height * (Math.pow(phi,2)+1)/(2*Math.pow(phi,2));
+        x2 = width - wInner + x;
+        y2 = height - hInner + y;
+        width = wInner;
+        height = hInner;
+        rotatePointAndAddToElementList(ea.addRect(x,y,width,height));
+        spiralOrientation = "bottom-right";
+        drawSpiral();
+        x = x2;
+        y = y2;
+        width = wInner;
+        height = hInner;
+        rotatePointAndAddToElementList(ea.addRect(x,y,width,height));
+        spiralOrientation = "top-left";
+        drawSpiral();
+        spiralOrientation = "double";
+      } else {
+        drawSpiral();
+      }
+      break;
+  }
+  ea.addToGroup(ids);
+  ids.push(rect.id);
+  ea.addToGroup(ids);
+  lockElements && ea.getElements().forEach(el=>{el.locked = true;});
+  await ea.addElementsToView(false,false,!sendToBack);
+  !lockElements && ea.selectElementsInView(ea.getViewElements().filter(el => ids.includes(el.id)));
+}
+
+const modal = new ea.obsidian.Modal(app);
+
+const fragWithHTML = (html) => createFragment((frag) => (frag.createDiv().innerHTML = html));
+
+const keydownListener = (e) => {
+  if(hostLeaf !== app.workspace.activeLeaf) return;
+  if(hostLeaf.width === 0 && hostLeaf.height === 0) return;
+  if(e.key === "Enter" && (e.ctrlKey || e.shiftKey || e.metaKey || e.altKey)) {
+    e.preventDefault();
+    modal.close();
+    draw()
+  }
+}
+ownerWindow.addEventListener('keydown',keydownListener);
+
+modal.onOpen = async () => {
+  const contentEl = modal.contentEl;
+  contentEl.createEl("h1", {text: "Golden Ratio"});
+
+  new ea.obsidian.Setting(contentEl)
+    .setName("Adjust Rectangle Aspect Ratio to Golden Ratio")
+    .addDropdown(dropdown=>dropdown
+      .addOption("none","None")
+      .addOption("adjust-width","Adjust Width")
+      .addOption("adjust-height","Adjust Height")
+      .setValue(aspectChoice)
+      .onChange(value => {
+        aspectChoice = value;
+        dirty = true;
+      })
+   );
+
+  new ea.obsidian.Setting(contentEl)
+    .setName("Change Line Style To: thin, architect, sharp")
+    .addToggle(toggle=>
+      toggle
+      .setValue(updateStyle)
+      .onChange(value => {
+        dirty = true;
+        updateStyle = value;
+      })
+    )
+  
+  let sizeEl;
+  new ea.obsidian.Setting(contentEl)
+    .setName("Number of lines")
+    .addSlider(slider => slider
+      .setLimits(2, 20, 1)
+      .setValue(size)
+      .onChange(value => {
+        sizeEl.innerText = ` ${value.toString()}`;
+        size = value;
+        dirty = true;
+      }),
+    )
+    .settingEl.createDiv("", el => {
+      sizeEl = el;
+      el.style.minWidth = "2.3em";
+      el.style.textAlign = "right";
+      el.innerText = ` ${size.toString()}`;
+    });
+    
+  new ea.obsidian.Setting(contentEl)
+    .setName("Lock Rectangle and Gridlines")
+    .addToggle(toggle=>
+      toggle
+      .setValue(lockElements)
+      .onChange(value => {
+        dirty = true;
+        lockElements = value;
+      })
+    )
+  
+  new ea.obsidian.Setting(contentEl)
+    .setName("Send to Back")
+    .addToggle(toggle=>
+      toggle
+      .setValue(sendToBack)
+      .onChange(value => {
+        dirty = true;
+        sendToBack = value;
+      })
+    )
+
+  let bGrid, bSpiral;
+  let sHGrid, sVGrid, sSpiral, sBoldSpiral;
+  const showGridSettings = (value) => {
+    value
+      ? (bGrid.setCta(), bSpiral.removeCta())
+      : (bGrid.removeCta(), bSpiral.setCta());
+    sHGrid.settingEl.style.display = value ? "" : "none";
+    sVGrid.settingEl.style.display = value ? "" : "none";
+    sSpiral.settingEl.style.display = !value ? "" : "none";
+    sBoldSpiral.settingEl.style.display = !value ? "" : "none";
+  }
+  
+  new ea.obsidian.Setting(contentEl)
+    .setName(fragWithHTML("<h3>Output Type</h3>"))
+    .addButton(button => {
+      bGrid = button;
+      button
+      .setButtonText("Grid")
+      .setCta(type === "grid")
+      .onClick(event => {
+        type = "grid";
+        showGridSettings(true);
+        dirty = true;
+      })
+    })
+    .addButton(button => {
+      bSpiral = button;
+      button
+      .setButtonText("Spiral")
+      .setCta(type === "spiral")
+      .onClick(event => {
+        type = "spiral";
+        showGridSettings(false);
+        dirty = true;
+      })
+    });
+
+  sSpiral = new ea.obsidian.Setting(contentEl)
+    .setName("Spiral Orientation")
+    .addDropdown(dropdown=>dropdown
+      .addOption("double","Double")
+      .addOption("top-left","Top left")
+      .addOption("top-right","Top right")
+      .addOption("bottom-right","Bottom right")
+      .addOption("bottom-left","Bottom left")
+      .setValue(spiralOrientation)
+      .onChange(value => {
+        spiralOrientation = value;
+        dirty = true;
+      })
+   );
+  
+  sBoldSpiral = new ea.obsidian.Setting(contentEl)
+    .setName("Spiral with Bold Line")
+    .addToggle(toggle=>
+      toggle
+      .setValue(boldSpiral)
+      .onChange(value => {
+        dirty = true;
+        boldSpiral = value;
+      })
+    )
+    
+  sHGrid = new ea.obsidian.Setting(contentEl)
+    .setName("Horizontal Grid")
+    .addDropdown(dropdown=>dropdown
+      .addOption("none","None")
+      .addOption("left-right","Left to right")
+      .addOption("right-left","Right to left")
+      .addOption("center-out","Center out")
+      .addOption("center-in","Center in")
+      .setValue(hDirection)
+      .onChange(value => {
+        hDirection = value;
+        dirty = true;
+      })
+   );
+
+  sVGrid = new ea.obsidian.Setting(contentEl)
+    .setName("Vertical Grid")
+    .addDropdown(dropdown=>dropdown
+      .addOption("none","None")
+      .addOption("top-down","Top down")
+      .addOption("bottom-up","Bottom up")
+      .addOption("center-out","Center out")
+      .addOption("center-in","Center in")
+      .setValue(vDirection)
+      .onChange(value => {
+        vDirection = value;
+        dirty = true;
+      })
+   );
+
+  showGridSettings(type === "grid");
+  new ea.obsidian.Setting(contentEl)
+    .addButton(button => button
+      .setButtonText("Run")
+      .setCta(true)
+      .onClick(async (event) => {
+        draw();
+        modal.close();
+      })
+    );
+}
+  
+modal.onClose = () => {
+  if(dirty) {
+    settings["Horizontal Grid"].value = hDirection;
+    settings["Vertical Grid"].value = vDirection;
+    settings["Size"].value = size.toString();
+    settings["Aspect Choice"].value = aspectChoice;
+    settings["Type"] = type;
+    settings["Spiral Orientation"].value = spiralOrientation;
+    settings["Lock Elements"] = lockElements;
+    settings["Send to Back"] = sendToBack;
+    settings["Update Style"] = updateStyle;
+    settings["Bold Spiral"] = boldSpiral;
+    ea.setScriptSettings(settings);
+  }
+  ownerWindow.removeEventListener('keydown',keydownListener);
+}
+  
+modal.open();

ea-scripts/Golden Ratio.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 642.8 373.7" stroke="currentColor"><path stroke-linecap="round" stroke-width="4" d="M5 5h633M5 5h633m0 0v364m0-364v364m0 0H5m633 0H5m0 0V5m0 364V5m242 0v364m0-364v364M5 144h242M5 144h242M154 5v139m0-139v139m0-53h93m-93 0h93m-57 0v53m0-53v53m-36-33h36m-36 0h36m-14-20v20m0-20v20m0-8h14m-14 0h14"/><path stroke-linecap="round" stroke-width="12" d="m638 5-5 57m5-57-5 57m0 0-14 55m14-55-14 55m0 0-24 53m24-53-24 53m0 0-32 49m32-49-32 49m0 0-40 43m40-43-40 43m0 0-46 37m46-37-46 37m0 0-53 30m53-30-53 30m0 0-56 22m56-22-56 22m0 0-60 13m60-13-60 13m0 0-61 5m61-5-61 5m0 0s0 0 0 0m0 0s0 0 0 0m0 0-38-3m38 3-38-3m0 0-37-8m37 8-37-8m0 0-35-14m35 14-35-14m0 0-32-18m32 18-32-18m0 0-29-23m29 23-29-23m0 0-25-27m25 27-25-27m0 0-20-30m20 30-20-30m0 0-14-33m14 33-14-33m0 0-9-34m9 34-9-34m0 0-3-35m3 35-3-35m0 0s0 0 0 0m0 0s0 0 0 0m0 0 2-22m-2 22 2-22m0 0 5-21m-5 21 5-21m0 0 9-20m-9 20 9-20m0 0 13-19M21 81l13-19m0 0 15-16M34 62l15-16m0 0 18-14M49 46l18-14m0 0 20-12M67 32c4-3 8-6 20-12m0 0 21-8m-21 8 21-8m0 0 23-5m-23 5 23-5m0 0 23-2m-23 2 23-2m0 0s0 0 0 0m0 0s0 0 0 0m0 0 15 1m-15-1 15 1m0 0 14 3m-14-3 14 3m0 0 13 5m-13-5 13 5m0 0 13 7m-13-7 13 7m0 0 11 9m-11-9 11 9m0 0 9 10m-9-10 9 10m0 0 8 12m-8-12 8 12m0 0 5 12m-5-12 5 12m0 0 4 13m-4-13 4 13m0 0 1 14m-1-14 1 14m0 0s0 0 0 0m0 0s0 0 0 0m0 0-1 8m1-8-1 8m0 0-2 8m2-8-2 8m0 0-4 8m4-8-4 8m0 0-4 7m4-7-4 7m0 0-6 6m6-6-6 6m0 0-7 6m7-6-7 6m0 0-7 4m7-4-7 4m0 0-9 3m9-3-9 3m0 0-8 2m8-2-8 2m0 0-9 1m9-1-9 1m0 0s0 0 0 0m0 0s0 0 0 0m0 0h-6m6 0h-6m0 0-5-2m5 2-5-2m0 0-5-2m5 2-5-2m0 0-5-2m5 2-5-2m0 0-4-4m4 4-4-4m0 0-4-4m4 4-4-4m0 0-3-4m3 4-3-4m0 0-2-5m2 5-2-5m0 0-1-5m1 5-1-5m0 0-1-5m1 5-1-5m0 0s0 0 0 0m0 0s0 0 0 0m0 0 1-3m-1 3 1-3m0 0v-3m0 3v-3m0 0 2-3m-2 3 2-3m0 0 2-3m-2 3 2-3m0 0 2-2m-2 2 2-2m0 0 2-2m-2 2 2-2m0 0 3-2m-3 2 3-2m0 0 3-1m-3 1 3-1m0 0 4-1m-4 1 4-1m0 0h3m-3 0h3m0 0s0 0 0 0m0 0s0 0 0 0m0 0h2m-2 0h2m0 0h2m-2 0h2m0 0 2 1m-2-1 2 1m0 0 2 1m-2-1 2 1m0 0 2 2m-2-2 2 2m0 0 1 1m-1-1 1 1m0 0 1 2m-1-2 1 2m0 0 1 2m-1-2 1 2m0 0v1m0-1v1m0 0 1 2m-1-2 1 2"/></svg>

ea-scripts/Grid Selected Images.md

@@ -29,7 +29,7 @@ try {
       elHeight /= 1.1;
     }  
   } else if (elWidth * elHeight < areaAvailable) {
-    while (elWidth * elHeight > areaAvailable) {
+    while (elWidth * elHeight < areaAvailable) {
       elWidth *= 1.1;
       elHeight *= 1.1;
     }
@@ -64,4 +64,4 @@ try {
   ea.addElementsToView(false, true, true);
 } catch (err) {
   _ = new Notice(err.toString())
-}
+}

ea-scripts/Invert colors.md

@@ -33,8 +33,20 @@ const invertColor = (color) => {
 	}
 }
 
-const invertPaletteColors = (palette) => Object.keys(palette).forEach(key => palette[key] = invertColor(palette[key]));
-Object.keys(colorPalette).forEach(key => invertPaletteColors(colorPalette[key]));
+function invertColorsRecursively(obj) {
+  if (typeof obj === 'string') {
+    return invertColor(obj);
+  } else if (Array.isArray(obj)) {
+    return obj.map(item => invertColorsRecursively(item));
+  } else if (typeof obj === 'object' && obj !== null) {
+    const result = {};
+    Object.keys(obj).forEach(key => result[key] = invertColorsRecursively(obj[key]));
+    return result;
+  } else {
+    return obj;
+  }
+}
+colorPalette = invertColorsRecursively(colorPalette);
 
 ea.copyViewElementsToEAforEditing(ea.getViewElements());
 ea.getElements().forEach(el=>{

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)|
@@ -57,7 +58,7 @@ Open the script you are interested in and save it to your Obsidian Vault includi
 |[Mindmap connector](Mindmap%20connector.md)|This script creates mindmap like lines (only right side and down available currently) for selected elements. The line will start according to the creation time of the elements. So you should create the header element first.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/mindmap%20connector.png)|[@xllowl](https://github.com/xllowl)|
 |[Modify background color opacity](Modify%20background%20color%20opacity.md)|This script changes the opacity of the background color of the selected boxes. The default background color in Excalidraw is so dark that the text is hard to read. You can lighten the color a bit by setting transparency. And you can tweak the transparency over and over again until you're happy with it. Although excalidraw has the opacity option in its native property Settings, it also changes the transparency of the border. Use this script to change only the opacity of the background color without affecting the border.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-modify-background-color-opacity.png)|[@1-2-3](https://github.com/1-2-3)|
 |[Normalize Selected Arrows](Normalize%20Selected%20Arrows.md)|This script will reset the start and end positions of the selected arrows. The arrow will point to the center of the connected box and will have a gap of 8px from the box.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-normalize-selected-arrows.png)|[@1-2-3](https://github.com/1-2-3)|
-|[OCR - Optical Character Recognition](OCR%20-%20Optical%20Character%20Recognition.md)|The script will  1) send the selected image file to [taskbone.com](https://taskbone.com) to exctract the text from the image, and 2) will add the text to your drawing as a text element.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-ocr.jpg)|[@zsviczian](https://github.com/zsviczian)|
+|[OCR - Optical Character Recognition](OCR%20-%20Optical%20Character%20Recognition.md)|The script will  1) send the selected image file to [taskbone.com](https://taskbone.com) to extract the text from the image, and 2) will add the text to your drawing as a text element.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-ocr.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Organic Line](Organic%20Line.md)|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.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-organic-line.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Repeat Elements](Repeat%20Elements.md)|This script will detect the difference between 2 selected elements, including position, size, angle, stroke and background color, and create several elements that repeat these differences based on the number of repetitions entered by the user.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-repeat-elements.png)|[@1-2-3](https://github.com/1-2-3)|
 |[Reverse arrows](Reverse%20arrows.md)|Reverse the direction of **arrows** within the scope of selected elements.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-reverse-arrow.jpg)|[@zsviczian](https://github.com/zsviczian)|

ea-scripts/Relative Font Size Cycle.md

@@ -0,0 +1,40 @@
+/*
+The script will cycle through S, M, L, XL font sizes scaled to the current canvas zoom.
+```js*/
+const FONTSIZES = [16, 20, 28, 36];
+const api = ea.getExcalidrawAPI();
+const st = api.getAppState();
+const zoom = st.zoom.value;
+const currentItemFontSize = st.currentItemFontSize;
+
+const fontsizes = FONTSIZES.map(s=>s/zoom);
+const els = ea.getViewSelectedElements().filter(el=>el.type === "text");
+
+const findClosestIndex = (val, list) => {
+  let closestIndex = 0;
+  let closestDifference = Math.abs(list[0] - val);
+  for (let i = 1; i < list.length; i++) {
+    const difference = Math.abs(list[i] - val);
+    if (difference <= closestDifference) {
+      closestDifference = difference;
+      closestIndex = i;
+    }
+  }
+  return closestIndex;
+}
+
+ea.viewUpdateScene({appState:{currentItemFontSize: fontsizes[(findClosestIndex(currentItemFontSize, fontsizes)+1) % fontsizes.length] }});
+
+if(els.length>0) {
+  ea.copyViewElementsToEAforEditing(els);
+  ea.getElements().forEach(el=> {
+    el.fontSize = fontsizes[(findClosestIndex(el.fontSize, fontsizes)+1) % fontsizes.length];
+    const font = ExcalidrawLib.getFontString(el);
+    const lineHeight = ExcalidrawLib.getDefaultLineHeight(el.fontFamily);
+    const {width, height, baseline} = ExcalidrawLib.measureText(el.originalText, font, lineHeight);
+    el.width = width;
+    el.height = height;
+    el.baseline = baseline;
+  });
+  ea.addElementsToView();
+}

ea-scripts/Relative Font Size Cycle.svg

@@ -0,0 +1,4 @@
+<svg viewBox="0 0 50 30" xmlns="http://www.w3.org/2000/svg">
+  <text fill="currentColor" x="10" y="30" font-size="16px" font-weight="light">A</text>
+  <text fill="currentColor" x="22" y="30" font-size="36px" font-weight="light">A</text>
+</svg>

ea-scripts/Repeat Texts.md

@@ -0,0 +1,96 @@
+/*
+
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-repeat-texts.png)
+In the following script, we address the concept of repetition through the lens of numerical progression. As visualized by the image, where multiple circles each labeled with an even task number are being condensed into a linear sequence, our script will similarly iterate through a set of numbers.
+
+Inspired from [Repeat Elements](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Repeat%20Elements.md)
+
+
+```javascript
+*/
+
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.7.19")) {
+  new Notice("This script requires a newer version of Excalidraw. Please install the latest version.");
+  return;
+}
+
+let repeatNum = parseInt(await utils.inputPrompt("repeat times?","number","5"));
+if(!repeatNum) {
+    new Notice("Please enter a number.");
+    return;
+}
+
+const selectedElements = ea.getViewSelectedElements().sort((lha,rha) => lha.x === rha.x ? lha.y - rha.y : lha.x - rha.x);
+
+const selectedBounds = selectedElements.filter(e => e.type !== "text");
+const selectedTexts = selectedElements.filter(e => e.type === "text");
+const selectedTextsById = selectedTexts.reduce((prev, next) => (prev[next.id] = next, prev), {})
+
+
+if(selectedTexts.length !== 2 || ![0, 2].includes(selectedBounds.length)) {
+    new Notice("Please select only 2 text elements.");
+    return;
+}
+
+if(selectedBounds.length === 2) {
+	if(selectedBounds[0].type !== selectedBounds[1].type) {
+	    new Notice("The selected elements must be of the same type.");
+		return;
+	}
+	if (!selectedBounds.every(e => e.boundElements?.length === 1)) {
+		new Notice("Only support the bound element with 1 text element.");
+		return;
+	}
+	if (!selectedBounds.every(e => !!selectedTextsById[e.boundElements?.[0]?.id])) {
+		new Notice("Bound element must refer to the text element.");
+		return;
+	}
+}
+
+const prevBoundEl = selectedBounds.length ? selectedBounds[0] : selectedTexts[0];
+const nextBoundEl = selectedBounds.length ? selectedBounds[1] : selectedTexts[1];
+const prevTextEl = prevBoundEl.type === 'text' ? prevBoundEl : selectedTextsById[prevBoundEl.boundElements[0].id]
+const nextTextEl = nextBoundEl.type === 'text' ? nextBoundEl : selectedTextsById[nextBoundEl.boundElements[0].id]
+
+const xDistance = nextBoundEl.x - prevBoundEl.x;
+const yDistance = nextBoundEl.y - prevBoundEl.y;
+
+const numReg = /\d+/
+let textNumDiff
+try {
+	const num0 = +prevTextEl.text.match(numReg)
+	const num1 = +nextTextEl.text.match(numReg)
+	textNumDiff = num1 - num0
+} catch(e) {
+	new Notice("Text must include a number!")
+	return;
+}
+
+const repeatEl = (newEl, step) => {
+    ea.elementsDict[newEl.id] = newEl;
+    newEl.x += xDistance * (step + 1);
+    newEl.y += yDistance * (step + 1);
+
+	if(newEl.text) {
+		const text = newEl.text.replace(numReg, (match) => +match + (step + 1) * textNumDiff)
+		newEl.originalText = text
+		newEl.rawText = text
+		newEl.text = text
+	}
+}
+
+ea.copyViewElementsToEAforEditing(selectedBounds);
+for(let i=0; i<repeatNum; i++) {
+	const newTextEl = ea.cloneElement(nextTextEl);
+	repeatEl(newTextEl, i)
+
+	if (selectedBounds.length) {
+	    const newBoundEl = ea.cloneElement(selectedBounds[1]);
+		newBoundEl.boundElements[0].id = newTextEl.id
+		newTextEl.containerId = newBoundEl.id
+		repeatEl(newBoundEl, i)
+	}
+}
+
+await ea.addElementsToView(false, false, true);
+

ea-scripts/Repeat Texts.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Svg Vector Icons : http://www.onlinewebfonts.com/icon -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 256 256" enable-background="new 0 0 256 256" xml:space="preserve">
+<metadata> Svg Vector Icons : http://www.onlinewebfonts.com/icon </metadata>
+<g><g><g><path fill="#000000" d="M101.2,18.7c-2,0.9-38,36.6-39.2,39c-1,1.9-1.1,4.2-0.4,6.2c0.6,1.5,37.3,38.6,39.3,39.6c1.7,0.9,5.2,0.8,7.1-0.1c1.9-0.9,3.7-3.5,4.1-5.8c0.6-3.5-0.2-4.5-12.5-16.8L88.2,69.2h44.3c38.7,0,44.8,0.1,48.6,0.7c24.2,4.2,43.2,22.6,48.1,46.8c3.3,16.4-1,34.2-11.5,47.6c-3.5,4.6-4.1,6.9-2.4,10.4c1.8,3.7,6.6,5.3,10.4,3.5c2.8-1.3,8.7-9.4,12.5-17.2c10.5-20.8,10.5-45.2,0-66.2c-10.3-20.6-28.6-34.8-51.8-40c-4.6-1.1-4.8-1.1-51.3-1.2c-25.7-0.1-46.7-0.3-46.7-0.5s5.2-5.5,11.5-11.9c9.4-9.4,11.6-11.9,12-13.3C113.6,21.6,107.3,16.1,101.2,18.7z"/><path fill="#000000" d="M34.9,73.4c-1.8,0.5-5.8,4.4-9.7,9.6c-7.9,10.4-12.8,22.4-14.5,35.4c-5.3,40.1,22.9,77.3,63.1,83.3c4,0.6,11.3,0.7,45.4,0.7c24,0,40.6,0.2,40.6,0.4c0,0.2-5,5.3-11.1,11.1c-11.3,11-12.9,13-12.9,16c0,4.1,3.8,7.9,7.9,7.9c0.7,0,2.1-0.3,3.1-0.7c2.3-1,38.1-36.6,39.3-39.2c1-2.1,1.1-4.2,0.4-6.1c-0.6-1.5-37.3-38.6-39.3-39.7c-1.9-1-6.1-0.6-8.1,0.8c-2.9,2-4,6.4-2.5,9.4c0.4,0.8,5.9,6.6,12.1,12.9l11.4,11.4h-40.4c-35,0-40.9-0.1-44.7-0.7c-24.2-4.1-43.4-22.9-48.2-47.1c-1.1-5.5-1.1-16.4,0-21.9c2.1-10.7,7-20.2,14.6-28.7c2.1-2.3,3.5-4.3,3.8-5.4c1-3.6-0.7-7.3-4.2-9C38.7,72.8,37.4,72.7,34.9,73.4z"/></g></g></g>
+</svg>

ea-scripts/Select Similar Elements.md

@@ -2,12 +2,12 @@
 
 ![](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.
+This script enables the selection of elements based on matching properties. Select the attributes (such as stroke color, fill style, font family, etc) that should match for selection. It's perfect for large scenes where manual selection of elements would be cumbersome. You can either run the script to select matching elements across the entire scene, or define a specific group of elements to apply the selection criteria to. 
 
 ```js */
 
 let config = window.ExcalidrawSelectConfig;
-config = config && (Date.now() - config.timestamp < 60000) ? config : null;
+config = Boolean(config) && (Date.now() - config.timestamp < 60000) ? config : null;
 
 let elements = ea.getViewSelectedElements();
 if(!config && (elements.length !==1)) {
@@ -19,7 +19,7 @@ if(!config && (elements.length !==1)) {
   }
 }
 
-const {angle, backgroundColor, fillStyle, fontFamily, fontSize, height, width, opacity, roughness, roundness, strokeColor, strokeStyle, strokeWidth, type, startArrowhead, endArrowhead} = ea.getViewSelectedElement();
+const {angle, backgroundColor, fillStyle, fontFamily, fontSize, height, width, opacity, roughness, roundness, strokeColor, strokeStyle, strokeWidth, type, startArrowhead, endArrowhead, fileId} = ea.getViewSelectedElement();
 
 const fragWithHTML = (html) => createFragment((frag) => (frag.createDiv().innerHTML = html));
   
@@ -27,14 +27,14 @@ const fragWithHTML = (html) => createFragment((frag) => (frag.createDiv().innerH
 // RUN
 //--------------------------
 const run = () => {
-  selectedElements = ea.getViewElements().filter(el=>
+  selectedElements = elements.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.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)) &&
@@ -43,7 +43,8 @@ const run = () => {
     ((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))
+    ((typeof config.endArrowhead === "undefined") || (el.endArrowhead === config.endArrowhead)) &&
+    ((typeof config.fileId === "undefined") || (el.fileId === config.fileId))
   )
   ea.selectElementsInView(selectedElements);
   delete window.ExcalidrawSelectConfig;
@@ -55,12 +56,12 @@ const run = () => {
 const showInstructions = () => {
   const instructionsModal = new ea.obsidian.Modal(app);
   instructionsModal.onOpen = () => {
-    instructionsModal.contentEl.createEl("h2", {text: "Instructions"});
+  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."});
+	  el.createEl("li", {text: "Click 'SELECT' to 1) first choose a specific group of elements in the scene, then 2) run the 'Select Similar Elements' once more within 1 minute to apply the filter criteria only to that group of elements."});
 	});
 	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."});
   };
@@ -70,14 +71,14 @@ const showInstructions = () => {
 const selectAttributesToCopy = () => {
   const configModal = new ea.obsidian.Modal(app);
   configModal.onOpen = () => {
-    config = {};
+  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)
-      );
+  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
@@ -97,6 +98,7 @@ const selectAttributesToCopy = () => {
 	  {name: "End arrowhead", key: "endArrowhead"},
 	  {name: "Height", key: "height"},
 	  {name: "Width", key: "width"},
+	  {name: "ImageID", key: "fileId"},
 	];
   
 	attributes.forEach(attr => {
@@ -142,8 +144,6 @@ const selectAttributesToCopy = () => {
 	        description = `${attrValue}`;
 	        break;
 	      default:
-	        console.log(attr.key);
-	        console.log(attrValue);
 	        description = `${attrValue.charAt(0).toUpperCase() + attrValue.slice(1)}`;
 	        break;
 	    }
@@ -165,7 +165,7 @@ const selectAttributesToCopy = () => {
 	});
 
 
-	//Add Toggle for the rest of the attirbutes. Organize attributes into a logical sequence or groups by adding
+	//Add Toggle for the rest of the attributes. 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)
@@ -190,7 +190,7 @@ const selectAttributesToCopy = () => {
 
   
 	configModal.onClose = () => {
-      setTimeout(()=>delete configModal);
+    setTimeout(()=>delete configModal);
 	}
 	
 	configModal.open();

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/Slideshow.md

@@ -1,24 +1,39 @@
 /*
 
-<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>
+# About the slideshow script
+The script will convert your drawing into a slideshow presentation.
+![Slideshow 3.0](https://www.youtube.com/JwgtCrIVeEU)
 
 ![](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.
+## Presentation options
+- 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.
+# Keyboard shortcuts and modifier keys
+**Forward**: Arrow Down, Arrow Right, or SPACE
+**Backward**: Arrow Up, Arrow Left
+**Finish presentation**: Backspace, ESC (I had issues with ESC not working in full screen presentation mode on Mac)
+
+**Run presentation in a window**: Hold down the ALT/OPT modifier key when clicking the presentation script button
+**Continue presentation**: Hold down SHIFT when clicking the presentation script button. (The feature also works in combination with the ALT/OPT modifier to start the presentation in a window). The feature will only resume while you are within the same Obsidian session (i.e. if you restart Obsidian, slideshow will no longer remember where you were). I have two use cases in mind for this feature: 
+1) When you are designing your presentation you may want to test how a slide looks. Using this feature you can get back to where you left off by starting the presentation with SHIFT.
+2) During presentation you may want to exit presentation mode to show something additional to your audience. You stop the presentation, show the additional thing you wanted, now you want to continue from where you left off. Hold down SHIFT when clicking the slideshow button.
 
 ```javascript
 */
-if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.8.17")) {
+if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("2.1.7")) {
   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;
-
+const shiftKey = ea.targetView.modifierKeyDown.shiftKey;
+const shouldStartWithLastSlide = shiftKey && window.ExcalidrawSlideshow &&
+      (window.ExcalidrawSlideshow.script === utils.scriptFile.path) && (typeof window.ExcalidrawSlideshow.slide === "number")
 //-------------------------------
 //constants
 //-------------------------------
@@ -26,7 +41,7 @@ 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)
+const FADE_LEVEL = 0.1; //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;
@@ -36,14 +51,18 @@ 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
 //-------------------------------
-let slide = 0;
+let isLaserOn = false;
+let slide = shouldStartWithLastSlide ? window.ExcalidrawSlideshow.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
@@ -171,7 +190,7 @@ let preventFullscreenExit = true;
 const gotoFullscreen = async () => {
   if(isFullscreen) return;
   preventFullscreenExit = true;
-	if(app.isMobile) {
+	if(ea.DEVICE.isMobile) {
 	  ea.viewToggleFullScreen();
 	} else {
 		await contentEl.webkitRequestFullscreen();
@@ -187,8 +206,8 @@ const gotoFullscreen = async () => {
 const exitFullscreen = async () => {
   if(!isFullscreen) return;
   preventFullscreenExit = true;
-  if(!app.isMobile && ownerDocument?.fullscreenElement) await ownerDocument.exitFullscreen();
-  if(app.isMobile) ea.viewToggleFullScreen();
+  if(!ea.DEVICE.isMobile && ownerDocument?.fullscreenElement) await ownerDocument.exitFullscreen();
+  if(ea.DEVICE.isMobile) ea.viewToggleFullScreen();
   if(toggleFullscreenButton) toggleFullscreenButton.innerHTML = SVG_MAXIMIZE;
   await waitForExcalidrawResize();
   resetControlPanelElPosition();
@@ -251,7 +270,7 @@ 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);
+  let ratio = Math.min(Math.max(ratioX, ratioY), 30);
 
   const scaledWidth = Math.abs(x1 - x2) * ratio;
   const scaledHeight = Math.abs(y1 - y2) * ratio;
@@ -283,7 +302,7 @@ let busy = false;
 const scrollToNextRect = async ({left,top,right,bottom,nextZoom},steps = TRANSITION_STEP_COUNT) => {
   const startTimer = Date.now();
   let watchdog = 0;
-  while(busy && watchdog++<15) await(100);
+  while(busy && watchdog++<15) await sleep(100);
   if(busy && watchdog >= 15) return;
   busy = true;
   excalidrawAPI.updateScene({appState:{shouldCacheIgnoreZoom:true}});
@@ -310,6 +329,9 @@ const scrollToNextRect = async ({left,top,right,bottom,nextZoom},steps = TRANSIT
     }
   }
   excalidrawAPI.updateScene({appState:{shouldCacheIgnoreZoom:false}});
+  if(isLaserOn) {
+    excalidrawAPI.setActiveTool({type: "laser"});
+  }
   busy = false;
 }
 
@@ -328,6 +350,9 @@ const navigate = async (dir) => {
   }
   if(selectSlideDropdown) selectSlideDropdown.value = slide+1;
   await scrollToNextRect(nextRect);
+  if(window.ExcalidrawSlideshow && (typeof window.ExcalidrawSlideshow.slide === "number")) {
+    window.ExcalidrawSlideshow.slide = slide;
+  }
 }
 
 const navigateToSlide = (slideNumber) => {
@@ -450,6 +475,22 @@ const createPresentationNavigationPanel = () => {
 	        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."
@@ -504,12 +545,15 @@ const createPresentationNavigationPanel = () => {
 // keyboard navigation
 //--------------------
 const keydownListener = (e) => {
-  if(ea.targetView.leaf !== app.workspace.activeLeaf) return;
+  if(hostLeaf !== app.workspace.activeLeaf) return;
+  if(hostLeaf.width === 0 && hostLeaf.height === 0) return;
   e.preventDefault();
   switch(e.key) {
+    case "Backspace":
     case "Escape":
       exitPresentation();
       break;
+    case "Space":
     case "ArrowRight":
     case "ArrowDown": 
       navigate("fwd");
@@ -605,7 +649,7 @@ const initializeEventListners = () => {
 	  controlPanelEl.removeEventListener('mouseenter', onMouseEnter, false);
 	  controlPanelEl.removeEventListener('mouseleave', onMouseLeave, false);
 	  controlPanelEl.parentElement?.removeChild(controlPanelEl);
-	  if(!app.isMobile) {
+	  if(!ea.DEVICE.isMobile) {
 	    contentEl.removeEventListener('webkitfullscreenchange', fullscreenListener);
 	    contentEl.removeEventListener('fullscreenchange', fullscreenListener);
 	  }
@@ -620,7 +664,7 @@ const initializeEventListners = () => {
     return true;
   };
   
-  if(!app.isMobile) {
+  if(!ea.DEVICE.isMobile) {
     contentEl.addEventListener('webkitfullscreenchange', fullscreenListener);
     contentEl.addEventListener('fullscreenchange', fullscreenListener);
   }
@@ -630,6 +674,9 @@ const initializeEventListners = () => {
 // 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();
@@ -680,7 +727,8 @@ const exitPresentation = async (openForEdit = false) => {
     //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.
-    ea.targetView.refresh(); 
+    hostView.refreshCanvasOffset();
+    excalidrawAPI.setActiveTool({type: "selection"});
   })
 }
 
@@ -690,6 +738,15 @@ const exitPresentation = async (openForEdit = false) => {
 const start = async () => {
   statusBarElement.style.display = "none";
   ea.setViewModeEnabled(true);
+  const helpButton = ea.targetView.excalidrawContainer?.querySelector(".ToolIcon__icon.help-icon");
+  if(helpButton) {
+    helpButton.style.display = "none";
+  }
+  const zoomButton = ea.targetView.excalidrawContainer?.querySelector(".Stack.Stack_vertical.zoom-actions");
+  if(zoomButton) {
+    zoomButton.style.display = "none";
+  }
+  
   createPresentationNavigationPanel();
   initializeEventListners();
   if(startFullscreen) {
@@ -714,7 +771,8 @@ if(window.ExcalidrawSlideshow && (window.ExcalidrawSlideshow.script === utils.sc
   }
   window.ExcalidrawSlideshow = {
     script: utils.scriptFile.path,
-    timestamp
+    timestamp,
+    slide: 0
   };
   window.ExcalidrawSlideshowStartTimer = window.setTimeout(start,500);
 }

ea-scripts/Split text by lines.md

@@ -18,10 +18,10 @@ elements.forEach((el)=>{
   ea.style.strokeColor = el.strokeColor;
   ea.style.fontFamily  = el.fontFamily;
   ea.style.fontSize    = el.fontSize;
-  const text = el.text.split("\n");
+  const text = el.rawText.split("\n");
   for(i=0;i<text.length;i++) {
-	ea.addText(el.x,el.y+i*el.height/text.length,text[i]);
+	ea.addText(el.x,el.y+i*el.height/text.length,text[i].trim());
   }
 });
-ea.addElementsToView(false,false);
+ea.addElementsToView(false,false,true);
 ea.deleteViewElements(elements);

ea-scripts/Text Arch.md

@@ -46,4 +46,4 @@ for(i=0;i<el.text.length;i++) {
   objectIDs.push(ea.addText(x,y,character));
 }
 ea.addToGroup(objectIDs);
-ea.addElementsToView(true);
+ea.addElementsToView(true, false, true);

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/index-new.md

@@ -15,7 +15,7 @@ In the `Command Palette` installed scripts are prefixed with `Downloaded/`, thus
 
 ## Attention developers and hobby hackers
 <img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/hobby-programmer.svg' align='left' style='background-color:whitesmoke; width:80px; margin-right:15px; margin-bottom:10px;'/>
-If you want to modify scripts, I recommend moving them to the `Excalidraw Automate script folder` or a different subfolder under the script folder. Scripts in the `Downloaded` folder will be overwritten when you click the `Update this script` button. Note also, that at this time, I do not check if the script file has been updated on GitHub, thus the `Update this script` button is always visible once you have installed a script, not only when an update is availble (hope to build this feature in the future).
+If you want to modify scripts, I recommend moving them to the `Excalidraw Automate script folder` or a different subfolder under the script folder. Scripts in the `Downloaded` folder will be overwritten when you click the `Update this script` button. Note also, that at this time, I do not check if the script file has been updated on GitHub, thus the `Update this script` button is always visible once you have installed a script, not only when an update is available (hope to build this feature in the future).
 
 I would love to include your contribution in the script library. If you have a script of your own that you would like to share with the community, please open a [PR](https://github.com/zsviczian/obsidian-excalidraw-plugin/pulls) on GitHub. Be sure to include the following in your pull request
 - The [script file](https://github.com/zsviczian/obsidian-excalidraw-plugin/tree/master/ea-scripts) with a self explanetory name. The name of the file will be the name of the script in the Command Palette.
@@ -44,6 +44,7 @@ I would love to include your contribution in the script library. If you have a s
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Fixed%20spacing.svg"/></div>|[[#Fixed spacing]]|
 |<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/Golden%20Ratio.svg"/></div>|[[#Golden Ratio]]|
 |<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/Mindmap%20format.svg"/></div>|[[#Mindmap format]]|
 |<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]]|
@@ -54,6 +55,7 @@ I would love to include your contribution in the script library. If you have a s
 |    |     |
 |----|-----|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/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]]|
@@ -66,11 +68,13 @@ 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/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/Relative%20Font%20Size%20Cycle.svg"/></div>|[[#Relative Font Size Cycle]]|
 |<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/Set%20Font%20Family.svg"/></div>|[[#Set Font Family]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Text%20Alignment.svg"/></div>|[[#Set Text Alignment]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Split%20text%20by%20lines.svg"/></div>|[[#Split text by lines]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/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
@@ -111,12 +115,17 @@ 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/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/Custom%20Zoom.svg"/></div>|[[#Custom Zoom]]|
 |<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/ExcaliAI.svg"/></div>|[[#ExcaliAI]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/GPT-Draw-a-UI.svg"/></div>|[[#GPT Draw-a-UI]]|
 |<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/Repeat%20Texts.svg"/></div>|[[#Repeat Texts]]|
 |<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]]|
@@ -138,6 +147,13 @@ 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/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]]|
 
+## Masking and cropping
+**Keywords**: Crop, Mask, Transform images
+
+|    |     |
+|----|-----|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Crop%20Vintage%20Mask.svg"/></div>|[[#Crop Vintage Mask]]|
+
 ---
 
 # Description and Installation
@@ -178,6 +194,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 elements 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 difference operation, so a transparent 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
@@ -196,6 +219,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
@@ -238,6 +267,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/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%20new%20markdown%20file%20and%20embed%20into%20active%20drawing.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 markdown document with the file name provided, open the new markdown document in an adjacent pane, and embed the markdown document into the active Excalidraw drawing.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-create-and-embed-new-markdown-file.jpg'></td></tr></table>
 
+## Crop Vintage Mask
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Crop%20Vintage%20Mask.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/Crop%20Vintage%20Mask.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Adds a rounded mask to the image by adding a full cover black mask and a rounded rectangle white mask. The script is also useful for adding just a black mask. In this case, run the script, then delete the white mask and add your custom white mask.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-crop-vintage.jpg'></td></tr></table>
+
+## Custom Zoom
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Custom%20Zoom.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/Custom%20Zoom.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">You can set a custom zoom level with this script. This allows you to set a zoom level below 10% or set the zoom level to a specific value.  Note however, that Excalidraw has a bug under 10% zoom... a phantom copy of your image may appear on screen. If this happens, increase the zoom and the phantom should disappear, if it doesn't, then close and open the drawing.</td></tr></table>
+
 ## Darken background color
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Darken%20background%20color.md
@@ -248,7 +289,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
@@ -328,12 +369,33 @@ 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/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>
 
+## Golden Ratio
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Golden%20Ratio.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/Golden%20Ratio.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script performs two different functions depending on the elements selected in the view.<br>
+1) In case you select text elements, the script will cycle through a set of font scales. First the 2 larger fonts following the Fibonacci sequence (fontsize * φ; fonsize * φ^2), then the 2 smaller fonts (fontsize / φ; fontsize / φ^2), finally the original size, followed again by the 2 larger fonts. If you wait 2 seconds, the sequence clears and starts from which ever font size you are on. So if you want the 3rd larges font, then toggle twice, wait 2 sec, then toggle again.<br>
+2) In case you select a single rectangle, the script will open the "Golden Grid", "Golden Spiral" window, where you can set up the type of grid or spiral you want to insert into the document.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/golden-ratio.jpg'><br><iframe width="400" height="225" src="https://www.youtube.com/embed/2SHn_ruax-s" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></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>
 
+## ExcaliAI
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/ExcaliAI.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/ExcaliAI.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Various AI features based on GPT Vision.<br><iframe width="400" height="225" src="https://www.youtube.com/embed/A1vrSGBbWgo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-draw-a-ui.jpg'></td></tr></table>
+
+## GPT Draw-a-UI
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/GPT-Draw-a-UI.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/GPT-Draw-a-UI.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script was discontinued in favor of ExcaliAI. Draw a UI and let GPT create the code for you.<br><iframe width="400" height="225" src="https://www.youtube.com/embed/y3kHl_6Ll4w" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-draw-a-ui.jpg'></td></tr></table>
+
+
 ## Hardware Eraser Support
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Hardware%20Eraser%20Support.md
@@ -400,6 +462,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/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>
 
+## Relative Font Size Cycle
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Relative%20Font%20Size%20Cycle.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/Relative%20Font%20Size%20Cycle.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script will cycle through S, M, L, XL font sizes scaled to the current canvas zoom.</td></tr></table>
+
 ## Rename Image
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Rename%20Image.md
@@ -412,6 +480,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/Repeat%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will detect the difference between 2 selected elements, including position, size, angle, stroke and background color, and create several elements that repeat these differences based on the number of repetitions entered by the user.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-repeat-elements.png'></td></tr></table>
 
+## Repeat Texts
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Repeat%20Texts.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/soraliu'>@soraliu</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/Repeat%20Texts.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">In the following script, we address the concept of repetition through the lens of numerical progression. As visualized by the image, where multiple circles each labeled with an even task number are being condensed into a linear sequence, our script will similarly iterate through a set of numbers</td></tr></table>
+
 ## Reverse arrows
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Reverse%20arrows.md
@@ -434,7 +508,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/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>
+<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.<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
@@ -502,6 +576,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/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
@@ -524,4 +604,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,7 +1,7 @@
 {
 	"id": "obsidian-excalidraw-plugin",
 	"name": "Excalidraw",
-	"version": "1.9.6.1-beta",
+	"version": "2.2.7-1",
 	"minAppVersion": "1.1.6",
 	"description": "An Obsidian plugin to edit and view Excalidraw drawings",
 	"author": "Zsolt Viczian",

manifest.json

@@ -1,11 +1,12 @@
 {
   "id": "obsidian-excalidraw-plugin",
   "name": "Excalidraw",
-  "version": "1.9.18",
+  "version": "2.2.7",
   "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.9.15",
+  "version": "2.2.5",
   "description": "This is an Obsidian.md plugin that lets you view and edit Excalidraw drawings",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -18,22 +18,24 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@zsviczian/excalidraw": "0.15.2-obsidian-13",
+    "@popperjs/core": "^2.11.8",
+    "@zsviczian/excalidraw": "0.17.1-obsidian-29",
     "chroma-js": "^2.4.2",
     "clsx": "^2.0.0",
     "colormaster": "^1.2.1",
     "gl-matrix": "^3.4.3",
-    "lz-string": "^1.5.0",
+    "lucide-react": "^0.263.1",
+    "mathjax-full": "^3.2.2",
     "monkey-around": "^2.3.0",
+    "nanoid": "^4.0.2",
+    "polybooljs": "^1.2.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "roughjs": "^4.5.2",
-    "html2canvas": "^1.4.1",
-    "@popperjs/core": "^2.11.8",
-    "nanoid": "^4.0.2",
-    "lucide-react": "^0.263.1"
+    "js-yaml": "^4.1.0"
   },
   "devDependencies": {
+    "dotenv": "^16.4.5",
     "@babel/core": "^7.22.9",
     "@babel/preset-env": "^7.22.10",
     "@babel/preset-react": "^7.22.5",
@@ -46,23 +48,32 @@
     "@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",
+    "@types/node": "^20.10.5",
+    "@types/react": "^18.2.45",
+    "@types/react-dom": "^18.2.18",
+    "@types/js-yaml": "^4.0.9",
     "@zerollup/ts-transform-paths": "^1.7.18",
     "cross-env": "^7.0.3",
+    "cssnano": "^6.0.2",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-prettier": "^5.0.0",
-    "obsidian": "^1.4.0",
+    "lz-string": "^1.5.0",
+    "obsidian": "1.5.7-1",
     "prettier": "^3.0.1",
     "rollup": "^2.70.1",
-    "rollup-plugin-copy": "^3.4.0",
+    "rollup-plugin-copy": "^3.5.0",
     "rollup-plugin-postprocess": "github:brettz9/rollup-plugin-postprocess#update",
     "rollup-plugin-terser": "^7.0.2",
     "rollup-plugin-typescript2": "^0.34.1",
     "rollup-plugin-web-worker-loader": "^1.6.1",
     "tslib": "^2.6.1",
     "ttypescript": "^1.5.15",
-    "typescript": "^5.2.2"
+    "typescript": "^5.2.2",
+    "@codemirror/commands": "^6.3.3",
+    "@codemirror/language": "^6.10.0",
+    "@codemirror/search": "^6.5.5",
+    "@codemirror/state": "^6.4.0",
+    "@codemirror/view": "^6.23.0"
   },
   "resolutions": {
     "@typescript-eslint/typescript-estree": "5.3.0"

rollup.config.js

@@ -1,17 +1,22 @@
 import { nodeResolve } from '@rollup/plugin-node-resolve';
 import commonjs from '@rollup/plugin-commonjs';
-import { env } from "process";
 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 typescript2 from "rollup-plugin-typescript2";
 import webWorker from "rollup-plugin-web-worker-loader";
-import fs from'fs';
+import fs from 'fs';
 import LZString from 'lz-string';
 import postprocess from 'rollup-plugin-postprocess';
+import cssnano from 'cssnano';
 
-const isProd = (process.env.NODE_ENV === "production")
+// Load environment variables
+import dotenv from 'dotenv';
+dotenv.config();
+
+const DIST_FOLDER = 'dist'; 
+const isProd = (process.env.NODE_ENV === "production");
 const isLib = (process.env.NODE_ENV === "lib");
 console.log(`Running: ${process.env.NODE_ENV}`);
 
@@ -24,47 +29,80 @@ const react_pkg = isLib ? "" : 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 = isLib ? "" : fs.readFileSync("./node_modules/lz-string/libs/lz-string.min.js", "utf8");
+if (!isLib) {
+  const excalidraw_styles = isProd
+    ? fs.readFileSync("./node_modules/@zsviczian/excalidraw/dist/styles.production.css", "utf8")
+    : fs.readFileSync("./node_modules/@zsviczian/excalidraw/dist/styles.development.css", "utf8");
+  const plugin_styles = fs.readFileSync("./styles.css", "utf8");
+  const styles = plugin_styles + excalidraw_styles;
+  cssnano()
+    .process(styles) // Process the CSS
+    .then(result => {
+      fs.writeFileSync(`./${DIST_FOLDER}/styles.css`, result.css);
+    })
+    .catch(error => {
+      console.error('Error while processing CSS:', error);
+    });
+}
 
 const manifestStr = isLib ? "" : fs.readFileSync("manifest.json", "utf-8");
 const manifest = isLib ? {} : JSON.parse(manifestStr);
-!isLib && console.log(manifest.version);
+if (!isLib) console.log(manifest.version);
 
-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 packageString = isLib
+  ? ""
+  : ';' + lzstring_pkg +
+    '\nconst EXCALIDRAW_PACKAGES = "' + LZString.compressToBase64(react_pkg + reactdom_pkg + excalidraw_pkg) + '";\n' +
+    'const {react, reactDOM, excalidrawLib} = window.eval.call(window, `(function() {' +
+    '${LZString.decompressFromBase64(EXCALIDRAW_PACKAGES)};' +
+    'return {react: React, reactDOM: ReactDOM, excalidrawLib: ExcalidrawLib};})();`);\n' +
+    'const PLUGIN_VERSION="' + manifest.version + '";';
 
 const BASE_CONFIG = {
   input: 'src/main.ts',
-  external: ['obsidian', '@zsviczian/excalidraw', 'react', 'react-dom'],
-}
+  external: [
+    '@codemirror/autocomplete',
+    '@codemirror/collab',
+    '@codemirror/commands',
+    '@codemirror/language',
+    '@codemirror/lint',
+    '@codemirror/search',
+    '@codemirror/state',
+    '@codemirror/view',
+    '@lezer/common',
+    '@lezer/highlight',
+    '@lezer/lr',
+    'obsidian',
+    '@zsviczian/excalidraw',
+    'react',
+    'react-dom'
+  ],
+};
 
-const getRollupPlugins = (tsconfig, ...plugins) =>
-    [
-        typescript2(tsconfig),
-        nodeResolve({ browser: true }),
-        commonjs(),
-        webWorker({ inline: true, forceInline: true, targetPlatform: "browser" }),
-    ].concat(plugins);
+const getRollupPlugins = (tsconfig, ...plugins) => [
+  typescript2(tsconfig),
+  nodeResolve({ browser: true }),
+  commonjs(),
+  webWorker({ inline: true, forceInline: true, targetPlatform: "browser" }),
+].concat(plugins);
 
 const BUILD_CONFIG = {
   ...BASE_CONFIG,
   output: {
-    dir: '.',
-    sourcemap: isProd?false:'inline',
+    dir: DIST_FOLDER,
+    entryFileNames: 'main.js',
     format: 'cjs',
     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),
+      "process.env.NODE_ENV": JSON.stringify(process.env.NODE_ENV),
     }),
     babel({
       presets: [['@babel/preset-env', {
@@ -72,27 +110,35 @@ const BUILD_CONFIG = {
           esmodules: true,
         },
       }]],
-      exclude: "node_modules/**"
+      exclude: "node_modules/**",
     }),
     commonjs(),
     nodeResolve({ browser: true, preferBuiltins: false }),
-    ...isProd 
-    ? [
-      terser({toplevel: false, compress: {passes: 2}}),
+    ...(isProd ? [
+      terser({
+        toplevel: false,
+        compress: { passes: 2 },
+      }),
       //!postprocess - the version available on npmjs does not work, need this update: 
       //  npm install brettz9/rollup-plugin-postprocess#update --save-dev
       //  https://github.com/developit/rollup-plugin-postprocess/issues/10
       postprocess([
-        [/,React=require\("react"\);/, packageString],
-      ])
-    ] 
-    : [
+        [/React=require\("react"\),state=require\("@codemirror\/state"\),view=require\("@codemirror\/view"\)/,
+        `state=require("@codemirror/state"),view=require("@codemirror/view")` + packageString],
+      ]),
+    ] : [
       postprocess([
         [/var React = require\('react'\);/, packageString],
-      ])
-    ],
+      ]),
+    ]),
+    copy({
+      targets: [
+        { src: 'manifest.json', dest: DIST_FOLDER },
+      ],
+      verbose: true, // Optional: To display copied files in the console
+    }),
   ],
-}
+};
 
 const LIB_CONFIG = {
   ...BASE_CONFIG,
@@ -104,16 +150,16 @@ const LIB_CONFIG = {
     name: "Excalidraw (Library)",
   },
   plugins: getRollupPlugins(
-      { tsconfig: "tsconfig-lib.json"},
-      copy({ targets: [{ src: "src/*.d.ts", dest: "lib/typings" }] })
-  ),  
-}
+    { tsconfig: "tsconfig-lib.json" },
+    copy({ targets: [{ src: "src/*.d.ts", dest: "lib/typings" }] })
+  ),
+};
 
 let config = [];
-if(process.env.NODE_ENV === "lib") {
+if (process.env.NODE_ENV === "lib") {
   config.push(LIB_CONFIG);
 } else {
   config.push(BUILD_CONFIG);
 }
 
-export default config;
+export default config;

src/CodeMirrorExtension/EditorHandler.ts

@@ -0,0 +1,45 @@
+import { Extension } from "@codemirror/state";
+import ExcalidrawPlugin from "src/main";
+import { HideTextBetweenCommentsExtension } from "./Fadeout";
+export const EDITOR_FADEOUT = "fadeOutExcalidrawMarkup";
+
+const editorExtensions: {[key:string]:Extension}= {
+  [EDITOR_FADEOUT]: HideTextBetweenCommentsExtension, 
+}
+
+export class EditorHandler {
+  private activeEditorExtensions: Extension[] = [];
+
+  constructor(private plugin: ExcalidrawPlugin) {}
+
+  setup(): void {
+    this.plugin.registerEditorExtension(this.activeEditorExtensions);
+    this.updateCMExtensionState(EDITOR_FADEOUT, this.plugin.settings.fadeOutExcalidrawMarkup);
+  }
+
+  updateCMExtensionState(
+    extensionIdentifier: string,
+    extensionState: boolean,
+  ) {
+    const extension = editorExtensions[extensionIdentifier];
+    if(!extension) return;
+    if (extensionState == true) {
+      this.activeEditorExtensions.push(extension);
+      // @ts-ignore
+      this.activeEditorExtensions[this.activeEditorExtensions.length - 1].exID = extensionIdentifier;
+    } else {
+      for (let i = 0; i < this.activeEditorExtensions.length; i++) {
+        const ext = this.activeEditorExtensions[i];
+        // @ts-ignore
+        if (ext.exID === extensionIdentifier) {
+          this.activeEditorExtensions.splice(i, 1);
+          break;
+        }
+      }
+    }
+    this.plugin.app.workspace.updateOptions();
+  }
+  update(): void {
+    this.plugin.app.workspace.updateOptions();
+  }
+}

src/CodeMirrorExtension/Fadeout.ts

@@ -0,0 +1,66 @@
+import { RangeSetBuilder } from "@codemirror/state";
+import { Decoration, DecorationSet, EditorView, ViewPlugin, ViewUpdate } from "@codemirror/view";
+
+const o30 = Decoration.line({ attributes: {class: "ex-opacity-30"} });
+const o15 = Decoration.line({ attributes: {class: "ex-opacity-15"} });
+const o8 = Decoration.line({ attributes: {class: "ex-opacity-8"} });
+const o5 = Decoration.line({ attributes: {class: "ex-opacity-5"} });
+const o0 = Decoration.line({ attributes: {class: "ex-opacity-0"} });
+
+export const HideTextBetweenCommentsExtension = ViewPlugin.fromClass(
+  class {
+    view: EditorView;
+    decorations: DecorationSet;
+    reExcalidrawData = /^%%(?:\r\n|\r|\n)# Excalidraw Data$/gm;
+    reTextElements = /^%%(?:\r\n|\r|\n)# Text Elements$/gm;
+    reDrawing = /^%%(?:\r\n|\r|\n)##? Drawing$/gm;
+    linecount = 0;
+    isExcalidraw = false;
+    
+    constructor(view: EditorView) {
+      this.view = view;
+      this.isExcalidraw = view.state.doc.toString().search(/^excalidraw-plugin: /m) > 0;
+      if(!this.isExcalidraw) {
+        this.decorations = Decoration.none;
+        return;
+      }
+      this.decorations = this.updateDecorations(view);
+    }
+
+    updateDecorations (view: EditorView) {
+      const { state } = view;
+      const { doc } = state;
+      
+      const text = doc.toString();
+
+      let start = text.search(this.reExcalidrawData);
+      if(start == -1) {
+        start = text.search(this.reTextElements);
+      }
+      if(start == -1) {
+        start = text.search(this.reDrawing);
+      }
+      if(start == -1) return Decoration.none;
+      
+      const startLine = doc.lineAt(start).number;
+      const endLine = doc.lines;
+      let builder = new RangeSetBuilder<Decoration>()
+      for (let l = startLine; l <= endLine; l++) {
+        const line = doc.line(l);
+        const pos = l-startLine;
+        builder.add(line.from, line.from, 
+          pos == 0 ? o30 : (pos == 1) ? o15 : (pos < 6) ? o8 : (pos < 12) ? o5 : o0);
+      }
+      return builder.finish()
+    }
+
+    update(update: ViewUpdate) {
+      if (this.isExcalidraw && update.docChanged) {
+        this.decorations = this.updateDecorations(update.view)
+      }
+    }
+  },
+  {
+    decorations: (x) => x.decorations,
+  }
+);

src/EmbeddedFileLoader.ts

@@ -1,29 +1,29 @@
 //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 { ExcalidrawImageElement, FileId } from "@zsviczian/excalidraw/types/element/types";
-import { BinaryFileData, DataURL } from "@zsviczian/excalidraw/types/types";
+import { ExcalidrawElement, FileId } from "@zsviczian/excalidraw/types/excalidraw/element/types";
+import { BinaryFileData, DataURL } from "@zsviczian/excalidraw/types/excalidraw/types";
 import { App, MarkdownRenderer, Notice, TFile } from "obsidian";
 import {
+  ASSISTANT_FONT,
   CASCADIA_FONT,
+  VIRGIL_FONT,
+} from "./constants/constFonts";
+import {  
   DEFAULT_MD_EMBED_CSS,
   fileid,
-  FRONTMATTER_KEY_BORDERCOLOR,
-  FRONTMATTER_KEY_FONT,
-  FRONTMATTER_KEY_FONTCOLOR,
-  FRONTMATTER_KEY_MD_STYLE,
   IMAGE_TYPES,
   nanoid,
   THEME_FILTER,
-  VIRGIL_FONT,
-} from "./constants";
+  FRONTMATTER_KEYS,
+} from "./constants/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 } from "./utils/FileUtils";
+import { blobToBase64, getDataURLFromURL, getMimeType, getPDFDoc, getURLImageExtension, hasExcalidrawEmbeddedImagesTreeChanged, readLocalFileBinary } from "./utils/FileUtils";
 import {
   errorlog,
   getDataURL,
@@ -37,9 +37,14 @@ import {
   hasExportTheme,
   LinkParts,
   svgToBase64,
+  isMaskFile,
+  embedFontsInSVG,
 } from "./utils/Utils";
 import { ValueOf } from "./types";
-import { has } from "./svgToExcalidraw/attributes";
+import { getMermaidImageElements, getMermaidText, shouldRenderMermaid } from "./utils/MermaidUtils";
+import { mermaidToExcalidraw } from "src/constants/constants";
+import { ImageKey, imageCache } from "./utils/ImageCache";
+import { PreviewImageType } from "./utils/UtilTypes";
 
 //An ugly workaround for the following situation.
 //File A is a markdown file that has an embedded Excalidraw file B
@@ -54,6 +59,7 @@ export const IMAGE_MIME_TYPES = {
   svg: "image/svg+xml",
   png: "image/png",
   jpg: "image/jpeg",
+  jpeg: "image/jpeg",
   gif: "image/gif",
   webp: "image/webp",
   bmp: "image/bmp",
@@ -102,10 +108,14 @@ const replaceSVGColors = (svg: SVGSVGElement | string, colorMap: ColorMap | null
   if(typeof svg === 'string') {
     // Replace colors in the SVG string
     for (const [oldColor, newColor] of Object.entries(colorMap)) {
-      const fillRegex = new RegExp(`fill="${oldColor}"`, 'g');
+      const fillRegex = new RegExp(`fill="${oldColor}"`, 'gi');
       svg = svg.replaceAll(fillRegex, `fill="${newColor}"`);
-      const strokeRegex = new RegExp(`stroke="${oldColor}"`, 'g');
+      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;
   }
@@ -113,8 +123,8 @@ const replaceSVGColors = (svg: SVGSVGElement | string, colorMap: ColorMap | null
   // Modify the fill and stroke attributes of child nodes
   const childNodes = (node: ChildNode) => {
     if (node instanceof SVGElement) {
-      const oldFill = node.getAttribute('fill');
-      const oldStroke = node.getAttribute('stroke');
+      const oldFill = node.getAttribute('fill')?.toLocaleLowerCase();
+      const oldStroke = node.getAttribute('stroke')?.toLocaleLowerCase();
 
       if (oldFill && colorMap[oldFill]) {
         node.setAttribute('fill', colorMap[oldFill]);
@@ -149,16 +159,17 @@ 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, colorMapJSON?: string) {
     this.plugin = plugin;
     this.resetImage(hostPath, imgPath);
-    if(this.file && (this.plugin.ea.isExcalidrawFile(this.file) || this.file.extension.toLowerCase() === "svg")) {
+    if(this.file && (this.plugin.isExcalidrawFile(this.file) || this.file.extension.toLowerCase() === "svg")) {
       try {
-        this.colorMap = colorMapJSON ? JSON.parse(colorMapJSON) : null;
+        this.colorMap = colorMapJSON ? JSON.parse(colorMapJSON.toLocaleLowerCase()) : null;
       } catch (error) {
         this.colorMap = null;
       }
@@ -169,12 +180,18 @@ export class EmbeddedFile {
     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) {
@@ -202,11 +219,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
@@ -215,7 +232,7 @@ export class EmbeddedFile {
         return false;
       }
     }
-    return this.mtime != this.file.stat.mtime;
+    return this.mtime !== this.file.stat.mtime;
   }
 
   public setImage(
@@ -225,13 +242,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) {
@@ -246,7 +263,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,
@@ -268,7 +285,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) {
@@ -282,7 +299,7 @@ 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%"));
   }
 }
 
@@ -317,12 +334,130 @@ export class EmbeddedFilesLoader {
     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 isMask = isMaskFile(this.plugin, file);
+    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,
+      isMask,
+    };
+
+    const hasColorMap = Boolean(inFile instanceof EmbeddedFile ? inFile.colorMap : null);
+    const shouldUseCache = !hasColorMap && this.plugin.settings.allowImageCacheInScene && file && imageCache.isReady();
+    const cacheKey:ImageKey = {
+      filepath: file.path,
+      blockref: null,
+      sectionref: null,
+      isDark,
+      previewImageType: PreviewImageType.SVG,
+      scale: 1,
+      isTransparent: !exportSettings.withBackground,
+      hasBlockref: false,
+      hasGroupref: false,
+      hasTaskbone: false,
+      hasArearef: false,
+      hasFrameref: false,
+      hasSectionref: false,
+      linkpartReference: null,
+      linkpartAlias: null,
+    }
+
+    const maybeSVG = shouldUseCache
+    ? await imageCache.getImageFromCache(cacheKey)
+    : undefined;
+
+    const svg = (maybeSVG && (maybeSVG instanceof SVGSVGElement))
+    ? maybeSVG
+    : replaceSVGColors(
+        await createSVG(
+          file?.path,
+          false, //false
+          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 && !Boolean(maybeSVG)) { 
+      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;
+    }
+    if(shouldUseCache && !Boolean(maybeSVG)) {
+      //cache SVG should have the width and height parameters and not the embedded font
+      //see svgWithFont below
+      imageCache.addImageToCache(cacheKey,"", svg);
+    }
+    const svgWithFont = embedFontsInSVG(svg, this.plugin);
+    if(!svgWithFont.hasAttribute("width") && svgWithFont.hasAttribute("viewBox")){
+      //2024.06.09
+      //this addresses backward compatibility issues where the cache does not have the width and height attributes
+      //this should be removed in the future
+      const vb = svgWithFont.getAttr("viewBox").split(" ");
+      Boolean(vb[2]) && svgWithFont.setAttribute("width", vb[2]);
+      Boolean(vb[3]) && svgWithFont.setAttribute("height", vb[3]);
+    }
+    const dURL = svgToBase64(svgWithFont.outerHTML) as DataURL;
+    return {dataURL: dURL as DataURL, hasSVGwithBitmap};
+  };
+
+  //this is a fix for backward compatibility - I messed up with generating the local link
+  private getLocalPath(path: string) {
+    const localPath = path.split("file://")[1]
+    if(localPath.startsWith("/")) {
+      return localPath.substring(1);
+    }
+    return localPath;
+  }
+
   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)) {
@@ -331,7 +466,7 @@ export class EmbeddedFilesLoader {
     }
 
     const linkParts =
-      isHyperlink
+      isHyperLink
         ? null
         : inFile instanceof EmbeddedFile
           ? inFile.linkParts
@@ -346,11 +481,11 @@ export class EmbeddedFilesLoader {
             };
 
     let hasSVGwithBitmap = false;
-    const isExcalidrawFile = !isHyperlink && this.plugin.isExcalidrawFile(file);
-    const isPDF = !isHyperlink && file.extension.toLowerCase() === "pdf";
+    const isExcalidrawFile = !isHyperLink && !isLocalLink && this.plugin.isExcalidrawFile(file);
+    const isPDF = !isHyperLink && !isLocalLink && file.extension.toLowerCase() === "pdf";
 
     if (
-      !isHyperlink && !isPDF &&
+      !isHyperLink && !isPDF && !isLocalLink &&
       !(
         IMAGE_TYPES.contains(file.extension) ||
         isExcalidrawFile ||
@@ -359,63 +494,26 @@ export class EmbeddedFilesLoader {
     ) {
       return null;
     }
-    const ab = isHyperlink || isPDF
+    const ab = isHyperLink || isPDF
       ? null
-      : await app.vault.readBinary(file);
+      : isLocalLink
+        ? await readLocalFileBinary(this.getLocalPath((inFile as EmbeddedFile).hyperlink))
+        : 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 = replaceSVGColors(
-        await createSVG(
-          file.path,
-          true,
-          exportSettings,
-          this,
-          forceTheme,
-          null,
-          null,
-          [],
-          this.plugin,
-          depth+1,
-          getExportPadding(this.plugin, file),
-        ),
-        inFile instanceof EmbeddedFile ? inFile.colorMap : null
-      ) as SVGSVGElement;
+    let dURL: DataURL = null;
+    if (isExcalidrawFile) {
+      const res = await this.getExcalidrawSVG({
+        isDark: this.isDark,
+        file,
+        depth,
+        inFile,
+        hasSVGwithBitmap,
+      });
+      dURL = res.dataURL;
+      hasSVGwithBitmap = res.hasSVGwithBitmap;
+    }
 
-      //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;
+    const excalidrawSVG = isExcalidrawFile ? dURL : null;
 
     const [pdfDataURL, pdfSize] = isPDF
       ? await this.pdfToDataURL(file,linkParts)
@@ -425,7 +523,7 @@ export class EmbeddedFilesLoader {
       ? "image/png"
       : "image/svg+xml";
 
-    const extension = isHyperlink
+    const extension = isHyperLink || isLocalLink
       ? getURLImageExtension(hyperlink)
       : file.extension;
     if (!isExcalidrawFile && !isPDF) {
@@ -433,20 +531,20 @@ export class EmbeddedFilesLoader {
     }
 
     let dataURL =
-      isHyperlink
+      isHyperLink
       ? (
           inFile instanceof EmbeddedFile
             ? await getDataURLFromURL(inFile.hyperlink, mimeType)
             : null
         )
       : excalidrawSVG ?? pdfDataURL ??
-        (file.extension === "svg"
+        (file?.extension === "svg"
           ? await getSVGData(app, file, inFile instanceof EmbeddedFile ? inFile.colorMap : null)
-          : file.extension === "md"
+          : file?.extension === "md"
           ? null
           : await getDataURL(ab, mimeType));
 
-    if(!isHyperlink && !dataURL) {
+    if(!isHyperLink && !dataURL && !isLocalLink) {
       markdownRendererRecursionWatcthdog.add(file);
       const result = await this.convertMarkdownToSVG(this.plugin, file, linkParts, depth);
       markdownRendererRecursionWatcthdog.delete(file);
@@ -458,10 +556,10 @@ export class EmbeddedFilesLoader {
       return {
         mimeType,
         fileId: await generateIdFromFile(
-          isHyperlink || isPDF ? (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,
       };
@@ -473,9 +571,11 @@ export class EmbeddedFilesLoader {
   public async loadSceneFiles(
     excalidrawData: ExcalidrawData,
     addFiles: (files: FileData[], isDark: boolean, final?: boolean) => void,
-    depth:number
+    depth:number,
+    isThemeChange:boolean = false,
   ) {
-    if(depth > 4) {
+    
+    if(depth > 7) {
       new Notice(t("INFINITE_LOOP_WARNING")+depth.toString(), 6000);
       return;
     }
@@ -492,7 +592,7 @@ export class EmbeddedFilesLoader {
         //debug({where:"EmbeddedFileLoader.loadSceneFiles",uid:this.uid,status:"embedded Files are not loaded"});
         const data = await this._getObsidianImage(embeddedFile, depth);
         if (data) {
-          const fileData = {
+          const fileData: FileData = {
             mimeType: data.mimeType,
             id: entry.value[0],
             dataURL: data.dataURL,
@@ -509,7 +609,8 @@ export class EmbeddedFilesLoader {
           }
           //files.push(fileData);
         }
-      } else if (embeddedFile.isSVGwithBitmap) {
+      } else if (embeddedFile.isSVGwithBitmap && (depth !== 0 || isThemeChange)) {
+        //this will reload the image in light/dark mode when switching themes
         const fileData = {
           mimeType: embeddedFile.mimeType,
           id: entry.value[0],
@@ -534,7 +635,7 @@ export class EmbeddedFilesLoader {
     while (!this.terminate && !(equation = equations.next()).done) {
       if (!excalidrawData.getEquation(equation.value[0]).isLoaded) {
         const latex = equation.value[1].latex;
-        const data = await tex2dataURL(latex, this.plugin);
+        const data = await tex2dataURL(latex);
         if (data) {
           const fileData = {
             mimeType: data.mimeType,
@@ -550,6 +651,59 @@ export class EmbeddedFilesLoader {
       }
     }
 
+    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;
@@ -639,9 +793,9 @@ export class EmbeddedFilesLoader {
     let fontName = plugin.settings.mdFont;
     if (
       fileCache?.frontmatter &&
-      Boolean(fileCache.frontmatter[FRONTMATTER_KEY_FONT])
+      Boolean(fileCache.frontmatter[FRONTMATTER_KEYS["font"].name])
     ) {
-      fontName = fileCache.frontmatter[FRONTMATTER_KEY_FONT];
+      fontName = fileCache.frontmatter[FRONTMATTER_KEYS["font"].name];
     }
     switch (fontName) {
       case "Virgil":
@@ -650,6 +804,9 @@ export class EmbeddedFilesLoader {
       case "Cascadia":
         fontDef = CASCADIA_FONT;
         break;
+      case "Assistant": 
+        fontDef = ASSISTANT_FONT;
+        break;
       case "":
         fontDef = "";
         break;
@@ -667,15 +824,15 @@ export class EmbeddedFilesLoader {
     }
 
     const fontColor = fileCache?.frontmatter
-      ? fileCache.frontmatter[FRONTMATTER_KEY_FONTCOLOR] ??
+      ? fileCache.frontmatter[FRONTMATTER_KEYS["font-color"].name] ??
         plugin.settings.mdFontColor
       : plugin.settings.mdFontColor;
   
     let style = fileCache?.frontmatter
-      ? fileCache.frontmatter[FRONTMATTER_KEY_MD_STYLE] ?? ""
+      ? fileCache.frontmatter[FRONTMATTER_KEYS["md-css"].name] ?? ""
       : "";
     let frontmatterCSSisAfile = false;
-    if (style && style != "") {
+    if (style && style !== "") {
       const f = plugin.app.metadataCache.getFirstLinkpathDest(style, file.path);
       if (f) {
         style = await plugin.app.vault.read(f);
@@ -695,7 +852,7 @@ export class EmbeddedFilesLoader {
     }
   
     const borderColor = fileCache?.frontmatter
-      ? fileCache.frontmatter[FRONTMATTER_KEY_BORDERCOLOR] ??
+      ? fileCache.frontmatter[FRONTMATTER_KEYS["border-color"].name] ??
         plugin.settings.mdBorderColor
       : plugin.settings.mdBorderColor;
   

src/ExcalidrawLib.d.ts

@@ -1,9 +1,9 @@
-import { RestoredDataState } from "@zsviczian/excalidraw/types/data/restore";
-import { ImportedDataState } from "@zsviczian/excalidraw/types/data/types";
-import { BoundingBox } from "@zsviczian/excalidraw/types/element/bounds";
-import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawTextElement, FontFamilyValues, FontString, NonDeleted, Theme } from "@zsviczian/excalidraw/types/element/types";
-import { AppState, BinaryFiles, ExportOpts, Point, Zoom } from "@zsviczian/excalidraw/types/types";
-import { Mutable } from "@zsviczian/excalidraw/types/utility-types";
+import { RestoredDataState } from "@zsviczian/excalidraw/types/excalidraw/data/restore";
+import { ImportedDataState } from "@zsviczian/excalidraw/types/excalidraw/data/types";
+import { BoundingBox } from "@zsviczian/excalidraw/types/excalidraw/element/bounds";
+import { ElementsMap, ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawFrameElement, ExcalidrawTextContainer, ExcalidrawTextElement, FontFamilyValues, FontString, NonDeleted, NonDeletedExcalidrawElement, Theme } from "@zsviczian/excalidraw/types/excalidraw/element/types";
+import { AppState, BinaryFiles, ExportOpts, Point, Zoom } from "@zsviczian/excalidraw/types/excalidraw/types";
+import { Mutable } from "@zsviczian/excalidraw/types/excalidraw/utility-types";
 
 type EmbeddedLink =
   | ({
@@ -44,6 +44,7 @@ declare namespace ExcalidrawLib {
     appState?: AppState;
     files?: any;
     exportPadding?: number;
+    exportingFrame: ExcalidrawFrameElement | null | undefined;
     renderEmbeddables?: boolean;
   }): Promise<SVGSVGElement>;
 
@@ -86,15 +87,34 @@ declare namespace ExcalidrawLib {
     elements: ExcalidrawElement[] | readonly NonDeleted<ExcalidrawElement>[],
   ): BoundingBox;
 
+  function getContainerElement(
+    element: ExcalidrawTextElement | null,
+    elementsMap: ElementsMap,
+  ): ExcalidrawTextContainer | null;
+
+  function refreshTextDimensions(
+    textElement: ExcalidrawTextElement,
+    container: ExcalidrawTextContainer | null,
+    elementsMap: ElementsMap,
+    text: string,
+  ): {
+    text: string,
+    x: number,
+    y: number,
+    width: number,
+    height: number,
+  };
+
   function getMaximumGroups(
     elements: ExcalidrawElement[],
+    elementsMap: ElementsMap,
   ): ExcalidrawElement[][];
 
   function measureText(
     text: string,
     font: FontString,
     lineHeight: number,
-  ): { width: number; height: number; baseline: number };
+  ): { width: number; height: number; };
 
   function getDefaultLineHeight(fontFamily: FontFamilyValues): number;
 
@@ -125,4 +145,14 @@ declare namespace ExcalidrawLib {
   ): TElement;  
 
   function getEmbedLink (link: string | null | undefined): EmbeddedLink;
+
+  function mermaidToExcalidraw(
+    mermaidDefinition: string,
+    opts: {fontSize: number},
+    forceSVG?: boolean,
+  ): Promise<{
+    elements?: ExcalidrawElement[];
+    files?: any;
+    error?: string;
+  } | undefined>;
 }

src/LaTeX.ts

@@ -1,14 +1,20 @@
-import { DataURL } from "@zsviczian/excalidraw/types/types";
+import { DataURL } from "@zsviczian/excalidraw/types/excalidraw/types";
+import {mathjax} from "mathjax-full/js/mathjax";
+import {TeX} from 'mathjax-full/js/input/tex.js';
+import {SVG} from 'mathjax-full/js/output/svg.js';
+import {LiteAdaptor, liteAdaptor} from 'mathjax-full/js/adaptors/liteAdaptor.js';
+import {RegisterHTMLHandler} from 'mathjax-full/js/handlers/html.js';
+import {AllPackages} from 'mathjax-full/js/input/tex/AllPackages.js';
+
 import ExcalidrawView from "./ExcalidrawView";
 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 html2canvas from "html2canvas";
-import { Notice } from "obsidian";
-
-declare let window: any;
+import { FileId } from "@zsviczian/excalidraw/types/excalidraw/element/types";
+import { getImageSize, svgToBase64 } from "./utils/Utils";
+import { fileid } from "./constants/constants";
+import { TFile } from "obsidian";
+import { MathDocument } from "mathjax-full/js/core/MathDocument";
+import { stripVTControlCharacters } from "util";
 
 export const updateEquation = async (
   equation: string,
@@ -17,7 +23,7 @@ export const updateEquation = async (
   addFiles: Function,
   plugin: ExcalidrawPlugin,
 ) => {
-  const data = await tex2dataURL(equation, plugin);
+  const data = await tex2dataURL(equation);
   if (data) {
     const files: FileData[] = [];
     files.push({
@@ -33,9 +39,23 @@ export const updateEquation = async (
   }
 };
 
+let adaptor: LiteAdaptor;
+let input: TeX<unknown, unknown, unknown>;
+let output: SVG<unknown, unknown, unknown>;
+let html: MathDocument<any, any, any>;
+let preamble: string;
+
+//https://github.com/xldenis/obsidian-latex/blob/master/main.ts
+const loadPreamble = async  () => {
+  const file = app.vault.getAbstractFileByPath("preamble.sty");
+  preamble = file && file instanceof TFile
+    ? await app.vault.read(file)
+    : null;
+};
+
 export async function tex2dataURL(
   tex: string,
-  plugin: ExcalidrawPlugin,
+  scale: number = 4 // Default scale value, adjust as needed
 ): Promise<{
   mimeType: MimeType;
   fileId: FileId;
@@ -43,102 +63,44 @@ export async function tex2dataURL(
   created: number;
   size: { height: number; width: number };
 }> {
-  //if network is slow, or not available, or mathjax has not yet fully loaded
-  let counter = 0;
-  while (!plugin.mathjax && !plugin.mathjaxLoaderFinished && counter < 10) {
-    await sleep(100);
-    counter++;
+  if(!adaptor) {
+    await loadPreamble();
+    adaptor = liteAdaptor();
+    RegisterHTMLHandler(adaptor);
+    input = new TeX({
+      packages: AllPackages,
+      ...Boolean(preamble) ? {
+        inlineMath: [['$', '$']],
+        displayMath: [['$$', '$$']]
+      } : {},
+    });
+    output = new SVG({ fontCache: "local" });
+    html = mathjax.document("", { InputJax: input, OutputJax: output });
   }
-
-  if(!plugin.mathjaxLoaderFinished) {
-    errorlog({where: "text2dataURL", fn: tex2dataURL, message:"mathjaxLoader not ready, using fallback. Try reloading Obsidian or restarting the Excalidraw plugin"});
-  }
-
-  //it is not clear why this works, but it seems that after loading the plugin sometimes only the third attempt is successful.
   try {
-    return await mathjaxSVG(tex, plugin);
-  } catch (e) {
-    await sleep(100);
-    try {
-      return await mathjaxSVG(tex, plugin);
-    } catch (e) {
-      await sleep(100);
-      try {
-        return await mathjaxSVG(tex, plugin);
-      } catch (e) {
-        if (plugin.mathjax) {
-          new Notice(
-            "Unknown error loading LaTeX. Using fallback solution. Try closing and reopening this drawing.",
-          );
-        } else {
-          new Notice(
-            "LaTeX support did not load. Using fallback solution. Try checking your network connection.",
-          );
-        }
-        //fallback
-        return await mathjaxImage2html(tex);
+    const node = html.convert(
+      Boolean(preamble) ? `${preamble}${tex}` : tex,
+      { display: true, scale }
+    );
+    const svg = new DOMParser().parseFromString(adaptor.innerHTML(node), "image/svg+xml").firstChild as SVGSVGElement;
+    if (svg) {
+      if(svg.width.baseVal.valueInSpecifiedUnits < 2) {
+        svg.width.baseVal.valueAsString = `${(svg.width.baseVal.valueInSpecifiedUnits+1).toFixed(3)}ex`;
       }
+      const img = svgToBase64(svg.outerHTML);
+      svg.width.baseVal.valueAsString = (svg.width.baseVal.valueInSpecifiedUnits * 10).toFixed(3);
+      svg.height.baseVal.valueAsString = (svg.height.baseVal.valueInSpecifiedUnits * 10).toFixed(3);
+      const dataURL = svgToBase64(svg.outerHTML);
+      return {
+        mimeType: "image/svg+xml",
+        fileId: fileid() as FileId,
+        dataURL: dataURL as DataURL,
+        created: Date.now(),
+        size: await getImageSize(img),
+      };
     }
-  }
-}
-
-export async function mathjaxSVG(
-  tex: string,
-  plugin: ExcalidrawPlugin,
-): Promise<{
-  mimeType: MimeType;
-  fileId: FileId;
-  dataURL: DataURL;
-  created: number;
-  size: { height: number; width: number };
-}> {
-  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",
-      fileId: fileid() as FileId,
-      dataURL: dataURL as DataURL,
-      created: Date.now(),
-      size: await getImageSize(dataURL),
-    };
+  } catch (e) {
+    console.error(e);
   }
   return null;
-}
-
-async function mathjaxImage2html(tex: string): Promise<{
-  mimeType: MimeType;
-  fileId: FileId;
-  dataURL: DataURL;
-  created: number;
-  size: { height: number; width: number };
-}> {
-  const div = document.body.createDiv();
-  div.style.display = "table"; //this will ensure div fits width of formula exactly
-  //@ts-ignore
-
-  const eq = window.MathJax.tex2chtml(tex, { display: true, scale: 4 }); //scale to ensure good resolution
-  eq.style.margin = "3px";
-  eq.style.color = "black";
-
-  //ipad support - removing mml as that was causing phantom double-image blur.
-  const el = eq.querySelector("mjx-assistive-mml");
-  if (el) {
-    el.parentElement.removeChild(el);
-  }
-  div.appendChild(eq);
-  window.MathJax.typeset();
-  const canvas = await html2canvas(div, { backgroundColor: null }); //transparent
-  document.body.removeChild(div);
-  return {
-    mimeType: "image/png",
-    fileId: fileid() as FileId,
-    dataURL: canvas.toDataURL() as DataURL,
-    created: Date.now(),
-    size: { height: canvas.height, width: canvas.width },
-  };
-}
+}

src/MarkdownPostProcessor.ts

@@ -1,10 +1,11 @@
 import {
   MarkdownPostProcessorContext,
   MetadataCache,
+  PaneType,
   TFile,
   Vault,
 } from "obsidian";
-import { RERENDER_EVENT } from "./constants";
+import { DEVICE, RERENDER_EVENT } from "./constants/constants";
 import { EmbeddedFilesLoader } from "./EmbeddedFileLoader";
 import { createPNG, createSVG } from "./ExcalidrawAutomate";
 import { ExportSettings } from "./ExcalidrawView";
@@ -19,18 +20,22 @@ import {
   getWithBackground,
   hasExportTheme,
   convertSVGStringToElement,
+  isMaskFile,
 } from "./utils/Utils";
-import { getParentOfClass, isObsidianThemeDark } from "./utils/ObsidianUtils";
+import { getParentOfClass, isObsidianThemeDark, getFileCSSClasses } from "./utils/ObsidianUtils";
 import { linkClickModifierType } from "./utils/ModifierkeyHelper";
 import { ImageKey, imageCache } from "./utils/ImageCache";
 import { FILENAMEPARTS, PreviewImageType } from "./utils/UtilTypes";
+import { CustomMutationObserver, DEBUGGING } from "./utils/DebugHelper";
+import { getExcalidrawFileForwardLinks } from "./utils/ExcalidrawViewUtils";
+import { linkPrompt } from "./dialogs/Prompt";
 
 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;
@@ -40,11 +45,20 @@ let metadataCache: MetadataCache;
 const getDefaultWidth = (plugin: ExcalidrawPlugin): string => {
   const width = parseInt(plugin.settings.width);
   if (isNaN(width) || width === 0 || width === null) {
+    if(getDefaultHeight(plugin)!=="") return "";
     return "400";
   }
   return plugin.settings.width;
 };
 
+const getDefaultHeight = (plugin: ExcalidrawPlugin): string => {
+  const height = parseInt(plugin.settings.height);
+  if (isNaN(height) || height === 0 || height === null) {
+    return "";
+  }
+  return plugin.settings.height;
+};
+
 export const initializeMarkdownPostProcessor = (p: ExcalidrawPlugin) => {
   plugin = p;
   vault = p.app.vault;
@@ -72,7 +86,7 @@ const _getPNG = async ({imgAttributes,filenameParts,theme,cacheReady,img,file,ex
             ? 2
             : 1;
   
-  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.PNG, scale};
+  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.PNG, scale, isTransparent: !exportSettings.withBackground};
 
   if(cacheReady) {      
     const src = await imageCache.getImageFromCache(cacheKey);
@@ -118,13 +132,26 @@ const setStyle = ({element,imgAttributes,onCanvas}:{
   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
+  let style = "";
+  if(imgAttributes.fwidth) {
+    style = `max-width:${imgAttributes.fwidth}${imgAttributes.fwidth.match(/\d$/) ? "px":""}; `; //width:100%;`; //removed !important https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/886
+  } else {
+    style = "width: fit-content;"
+  }
   if (imgAttributes.fheight) {
-    style += `height:${imgAttributes.fheight}px;`;
+    style += `${imgAttributes.fwidth?"min-":"max-"}height:${imgAttributes.fheight}px;`;
   }
   if(!onCanvas) element.setAttribute("style", style);
-  element.addClass(imgAttributes.style);
-  element.addClass("excalidraw-embedded-img");
+  element.classList.add(...Array.from(imgAttributes.style))
+  if(!element.hasClass("excalidraw-embedded-img")) {
+    element.addClass("excalidraw-embedded-img");
+  }
+  if(
+    window?.ExcalidrawAutomate?.plugin?.settings?.canvasImmersiveEmbed &&
+    !element.hasClass("excalidraw-canvas-immersive")
+  ) {
+    element.addClass("excalidraw-canvas-immersive");
+  }
 }
 
 const _getSVGIMG = async ({filenameParts,theme,cacheReady,img,file,exportSettings,loader}:{
@@ -136,7 +163,7 @@ const _getSVGIMG = async ({filenameParts,theme,cacheReady,img,file,exportSetting
   exportSettings: ExportSettings,
   loader: EmbeddedFilesLoader,
 }):Promise<HTMLImageElement> => {
-  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.SVGIMG, scale:1};
+  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.SVGIMG, scale:1, isTransparent: !exportSettings.withBackground};
   if(cacheReady) {
     const src = await imageCache.getImageFromCache(cacheKey);
     if(src && typeof src === "string") {
@@ -177,7 +204,7 @@ const _getSVGIMG = async ({filenameParts,theme,cacheReady,img,file,exportSetting
     return null;
   }
 
-  svg = embedFontsInSVG(svg, plugin);
+  svg = embedFontsInSVG(svg, plugin, false);
   //need to remove width and height attributes to support area= embeds
   svg.removeAttribute("width");
   svg.removeAttribute("height");
@@ -193,13 +220,13 @@ const _getSVGNative = async ({filenameParts,theme,cacheReady,containerElement,fi
   exportSettings: ExportSettings,
   loader: EmbeddedFilesLoader,
 }):Promise<HTMLDivElement> => {
-  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.SVG, scale:1};
+  const cacheKey = {...filenameParts, isDark: theme==="dark", previewImageType: PreviewImageType.SVG, scale:1, isTransparent: !exportSettings.withBackground};
   let maybeSVG;
   if(cacheReady) {
     maybeSVG = await imageCache.getImageFromCache(cacheKey);
   }
 
-  const svg = maybeSVG && (maybeSVG instanceof SVGSVGElement)
+  let svg = (maybeSVG && (maybeSVG instanceof SVGSVGElement))
     ? maybeSVG
     : convertSVGStringToElement((await createSVG(
       filenameParts.hasGroupref || filenameParts.hasBlockref || filenameParts.hasSectionref || filenameParts.hasFrameref
@@ -223,10 +250,14 @@ const _getSVGNative = async ({filenameParts,theme,cacheReady,containerElement,fi
     return null;
   }
 
+  //cache SVG should have the width and height parameters and not the embedded font
+  if(!Boolean(maybeSVG)) {
+    cacheReady && imageCache.addImageToCache(cacheKey,"", svg);
+  }
+  svg = embedFontsInSVG(svg, plugin, true);
   svg.removeAttribute("width");
   svg.removeAttribute("height");
   containerElement.append(svg);
-  cacheReady && imageCache.addImageToCache(cacheKey,"", svg);
   return containerElement;
 }
 
@@ -253,7 +284,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")
@@ -262,6 +293,7 @@ const getIMG = async (
   const exportSettings: ExportSettings = {
     withBackground: getWithBackground(plugin, file),
     withTheme: forceTheme ? true : plugin.settings.exportWithTheme,
+    isMask: isMaskFile(plugin, file),
   };
 
   const theme =
@@ -344,12 +376,31 @@ const createImgElement = async (
     if (src) {
       const srcParts = src.match(/([^#]*)(.*)/);
       if(!srcParts) return;
-      plugin.openDrawing(
-        vault.getAbstractFileByPath(srcParts[1]) as TFile,
-        linkClickModifierType(ev),
-        true,
-        srcParts[2],
-      );
+        const f = vault.getAbstractFileByPath(srcParts[1]) as TFile;
+        const linkModifier = linkClickModifierType(ev);
+        if (plugin.isExcalidrawFile(f) && isMaskFile(plugin, f)) {
+          (async () => {
+              const linkString = `[[${f.path}${srcParts[2]?"#"+srcParts[2]:""}]] ${getExcalidrawFileForwardLinks(plugin.app, f, new Set<string>())}`;
+              const result = await linkPrompt(linkString, plugin.app);
+              if(!result) return;
+              const [file, linkText, subpath] = result;
+              if(plugin.isExcalidrawFile(file)) {
+                plugin.openDrawing(file,linkModifier, true, subpath);
+                return;
+              }
+              let paneType: boolean | PaneType = false;
+              switch(linkModifier) {
+                case "active-pane": paneType = false; break;
+                case "new-pane": paneType = "split"; break;
+                case "popout-window": paneType = "window"; break;
+                case "new-tab": paneType = "tab"; break;
+                case "md-properties": paneType = "tab"; break;
+              }
+              plugin.app.workspace.openLinkText(linkText,"",paneType,subpath ? {eState: {subpath}} : {});
+          })()
+          return;
+        }
+      plugin.openDrawing(f,linkModifier,true,srcParts[2]);
     } //.ctrlKey||ev.metaKey);
   };
   //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1003
@@ -369,7 +420,10 @@ const createImgElement = async (
   });  
   eventElement.addEventListener("pointerdown",(ev)=>{
     if(imgOrDiv?.parentElement?.hasClass("canvas-node-content")) return;
-    timer = setTimeout(()=>clickEvent(ev),500);
+    //@ts-ignore
+    const PLUGIN = app.plugins.plugins["obsidian-excalidraw-plugin"] as ExcalidrawPlugin;
+    const timeoutValue = DEVICE.isDesktop ? PLUGIN.settings.longPressDesktop : PLUGIN.settings.longPressMobile;
+    timer = setTimeout(()=>clickEvent(ev),timeoutValue);
     pointerDownEvent = ev;
   });
   eventElement.addEventListener("pointerup",()=>{
@@ -388,8 +442,9 @@ const createImgElement = async (
       fname: fileSource,
       fwidth: imgOrDiv.getAttribute("w"),
       fheight: imgOrDiv.getAttribute("h"),
-      style: imgOrDiv.getAttribute("class"),
+      style: [...Array.from(imgOrDiv.classList)],
     }, onCanvas);
+    if(!newImg) return;
     parent.empty();
     if(!onCanvas) {
       newImg.style.maxHeight = imgMaxHeigth;
@@ -398,6 +453,20 @@ const createImgElement = async (
     newImg.setAttribute("fileSource",fileSource);
     parent.append(newImg);
   });
+  const cssClasses = getFileCSSClasses(attr.file);
+  cssClasses.forEach((cssClass) => {
+    if(imgOrDiv.hasClass(cssClass)) return;
+    imgOrDiv.addClass(cssClass);
+  });
+  if(window?.ExcalidrawAutomate?.plugin?.settings?.canvasImmersiveEmbed) {
+    if(!imgOrDiv.hasClass("excalidraw-canvas-immersive")) {
+      imgOrDiv.addClass("excalidraw-canvas-immersive");
+    }
+  } else {
+    if(imgOrDiv.hasClass("excalidraw-canvas-immersive")) {
+      imgOrDiv.removeClass("excalidraw-canvas-immersive");
+    }
+  }
   return imgOrDiv;
 }
 
@@ -406,7 +475,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 (
@@ -448,7 +517,7 @@ const processInternalEmbed = async (internalEmbedEl: Element, file: TFile ):Prom
     fname: "",
     fheight: "",
     fwidth: "",
-    style: "",
+    style: [],
   };
 
   const src = internalEmbedEl.getAttribute("src");
@@ -461,11 +530,13 @@ const processInternalEmbed = async (internalEmbedEl: Element, file: TFile ):Prom
   internalEmbedEl.addClass("image-embed");
 
   attr.fwidth = internalEmbedEl.getAttribute("width")
-  ? internalEmbedEl.getAttribute("width")
-  : getDefaultWidth(plugin);
-  attr.fheight = internalEmbedEl.getAttribute("height");
+    ? internalEmbedEl.getAttribute("width")
+    : getDefaultWidth(plugin);
+  attr.fheight = internalEmbedEl.getAttribute("height")
+    ? internalEmbedEl.getAttribute("height")
+    : getDefaultHeight(plugin);
   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:"");
@@ -484,14 +555,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]}`}`];
     }
   }
 }
@@ -524,8 +595,18 @@ const tmpObsidianWYSIWYG = async (
     
   //@ts-ignore
   const containerEl = ctx.containerEl;
+
+  if(!plugin.settings.renderImageInMarkdownReadingMode && containerEl.parentElement?.parentElement?.hasClass("markdown-reading-view")) {
+    return;
+  }
+
+  if(!plugin.settings.renderImageInMarkdownToPDF && containerEl.parentElement?.hasClass("print")) {
+    return;
+  }
+
   let internalEmbedDiv: HTMLElement = containerEl;
   while (
+    !internalEmbedDiv.hasClass("print") &&
     !internalEmbedDiv.hasClass("dataview") &&
     !internalEmbedDiv.hasClass("cm-preview-code-block") &&
     !internalEmbedDiv.hasClass("cm-embed-block") &&
@@ -536,7 +617,7 @@ const tmpObsidianWYSIWYG = async (
   ) {
     internalEmbedDiv = internalEmbedDiv.parentElement;
   }
-    
+
   if(
     internalEmbedDiv.hasClass("dataview") ||
     internalEmbedDiv.hasClass("cm-preview-code-block") ||
@@ -545,23 +626,50 @@ const tmpObsidianWYSIWYG = async (
     return; //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/835
   }
 
+  
+  if(!plugin.settings.renderImageInHoverPreviewForMDNotes) {
+    const isHoverPopover = internalEmbedDiv.parentElement?.hasClass("hover-popover");
+    const shouldOpenMD = Boolean(ctx.frontmatter?.["excalidraw-open-md"]);
+    if(isHoverPopover && shouldOpenMD) {
+      return;
+    }
+  }
+
+  const isPrinting = Boolean(internalEmbedDiv.hasClass("print"));
+
   const attr: imgElementAttributes = {
     fname: ctx.sourcePath,
-    fheight: "",
-    fwidth: getDefaultWidth(plugin),
-    style: "excalidraw-svg",
+    fheight: isPrinting ? "100%" : getDefaultHeight(plugin),
+    fwidth: isPrinting ? "100%" : getDefaultWidth(plugin),
+    style: ["excalidraw-svg"],
   };
   
   attr.file = file;
 
   const markdownEmbed = internalEmbedDiv.hasClass("markdown-embed");
-  const markdownReadingView = internalEmbedDiv.hasClass("markdown-reading-view");
+  const markdownReadingView = internalEmbedDiv.hasClass("markdown-reading-view") || isPrinting;
   if (!internalEmbedDiv.hasClass("internal-embed") && (markdownEmbed || markdownReadingView)) {
+    if(isPrinting) {
+      internalEmbedDiv = containerEl;
+    }
     //We are processing the markdown preview of an actual Excalidraw file
     //the excalidraw file in markdown preview mode
     const isFrontmatterDiv = Boolean(el.querySelector(".frontmatter"));
-    el.empty();
-    if(!isFrontmatterDiv) {
+    let areaPreview = false;
+    if(Boolean(ctx.frontmatter)) {
+      el.empty();
+    } else {
+      const warningEl = el.querySelector("div>h3[data-heading^='Unable to find section #^");
+      if(warningEl) {
+        const ref = warningEl.getAttr("data-heading").match(/Unable to find section (#\^(?:group=|area=|frame=)[^ ]*)/)?.[1];
+        if(ref) {
+          attr.fname = file.path + ref;
+          areaPreview = true;
+        }
+      }
+
+    }
+    if(!isFrontmatterDiv && !areaPreview) {
       if(el.parentElement === containerEl) containerEl.removeChild(el);
       return;
     }
@@ -604,7 +712,7 @@ const tmpObsidianWYSIWYG = async (
 
   //timer to avoid the image flickering when the user is typing
   let timer: NodeJS.Timeout = null;
-  const observer = new MutationObserver((m) => {
+  const markdownObserverFn: MutationCallback = (m) => {
     if (!["alt", "width", "height"].contains(m[0]?.attributeName)) {
       return;
     }
@@ -617,7 +725,10 @@ const tmpObsidianWYSIWYG = async (
       const imgDiv = await processInternalEmbed(internalEmbedDiv,file);
       internalEmbedDiv.appendChild(imgDiv);    
     }, 500);
-  });
+  }
+  const observer = DEBUGGING
+    ? new CustomMutationObserver(markdownObserverFn, "markdowPostProcessorObserverFn")
+    : new MutationObserver(markdownObserverFn);
   observer.observe(internalEmbedDiv, {
     attributes: true, //configure it to listen to attribute changes
   });
@@ -646,7 +757,8 @@ export const markdownPostProcessor = async (
   //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) {
+  const isPrinting = Boolean(document.body.querySelectorAll("body > .print"));
+  if (excalidrawFile && !isPrinting) {
     el.style.display = "none";
     return;
   }
@@ -669,13 +781,16 @@ export const hoverEvent = (e: any) => {
 };
 
 //monitoring for div.popover.hover-popover.file-embed.is-loaded to be added to the DOM tree
-export const observer = new MutationObserver(async (m) => {
-  if (m.length == 0) {
+const legacyExcalidrawPopoverObserverFn: MutationCallback = async (m) => {
+  if (m.length === 0) {
     return;
   }
   if (!plugin.hover.linkText) {
     return;
   }
+  if (!plugin.hover.linkText.endsWith("excalidraw")) {
+    return;
+  }
   const file = metadataCache.getFirstLinkpathDest(
     plugin.hover.linkText,
     plugin.hover.sourcePath ? plugin.hover.sourcePath : "",
@@ -705,16 +820,14 @@ export const observer = new MutationObserver(async (m) => {
   if (!plugin.hover.linkText) {
     return;
   }
-  if (m.length != 1) {
+  if (m.length !== 1) {
     return;
   }
-  if (m[0].addedNodes.length != 1) {
+  if (m[0].addedNodes.length !== 1) {
     return;
   }
   if (
-    //@ts-ignore
-    !m[0].addedNodes[0].classNames !=
-    "popover hover-popover file-embed is-loaded"
+    (m[0].addedNodes[0] as HTMLElement).className !== "popover hover-popover"
   ) {
     return;
   }
@@ -722,13 +835,13 @@ export const observer = new MutationObserver(async (m) => {
   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
+  //I prevent the default Obsidian feature of opening the link in the native app
   const img = await getIMG({
     file,
     fname: file.path,
     fwidth: "300",
     fheight: null,
-    style: "excalidraw-svg",
+    style: ["excalidraw-svg"],
   });
   const div = createDiv("", async (el) => {
     el.appendChild(img);
@@ -745,5 +858,9 @@ export const observer = new MutationObserver(async (m) => {
     });
   });
   node.appendChild(div);
-});
+};
+
+export const legacyExcalidrawPopoverObserver = DEBUGGING
+  ? new CustomMutationObserver(legacyExcalidrawPopoverObserverFn, "legacyExcalidrawPopoverObserverFn")
+  : new MutationObserver(legacyExcalidrawPopoverObserverFn);
 

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/constants";
 import ExcalidrawView from "./ExcalidrawView";
 import ExcalidrawPlugin from "./main";
 import { ButtonDefinition, GenericInputPrompt, GenericSuggester } from "./dialogs/Prompt";
 import { getIMGFilename } from "./utils/FileUtils";
 import { splitFolderAndFilename } from "./utils/FileUtils";
+import { getEA } from "src";
 
 export type ScriptIconMap = {
   [key: string]: { name: string; group: string; svgString: string };
@@ -42,6 +43,7 @@ export class ScriptEngine {
         this.loadScript(scriptFile);
       }
     };
+
     const deleteEventHandler = async (file: TFile) => {
       if (!(file instanceof TFile)) {
         return;
@@ -103,7 +105,7 @@ export class ScriptEngine {
   public getListofScripts(): TFile[] {
     this.scriptPath = this.plugin.settings.scriptFolderPath;
     if (!app.vault.getAbstractFileByPath(this.scriptPath)) {
-      this.scriptPath = null;
+      //this.scriptPath = null;
       return;
     }
     return app.vault
@@ -170,6 +172,7 @@ export class ScriptEngine {
           (async()=>{
             const script = await app.vault.read(f);
             if(script) {
+              //remove YAML frontmatter if present
               this.executeScript(view, script, scriptName,f);
             }
           })()
@@ -199,27 +202,27 @@ 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;
+    script = script.replace(/^---.*?---\n/gs, "");
+    const ea = getEA(view);
+    ea.activeScript = title;
 
     //https://stackoverflow.com/questions/45381204/get-asyncfunction-constructor-in-typescript changed tsconfig to es2017
     //https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction
     const AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
     let result = null;
     //try {
-    result = await new AsyncFunction("ea", "utils", script)(this.plugin.ea, {
+    result = await new AsyncFunction("ea", "utils", script)(ea, {
       inputPrompt: (
         header: string,
         placeholder?: string,
@@ -233,7 +236,7 @@ export class ScriptEngine {
         ScriptEngine.inputPrompt(
           view,
           this.plugin,
-          app,
+          this.plugin.app,
           header,
           placeholder,
           value,
@@ -262,7 +265,7 @@ export class ScriptEngine {
       new Notice(t("SCRIPT_EXECUTION_ERROR"), 4000);
       errorlog({ script: this.plugin.ea.activeScript, error: e });
   }*/
-        this.plugin.ea.activeScript = null;
+        //ea.activeScript = null;
         return result;
 }
 

src/constants/constants.ts

@@ -0,0 +1,399 @@
+import { customAlphabet } from "nanoid";
+import { DeviceType } from "../types";
+import { ExcalidrawLib } from "../ExcalidrawLib";
+import { moment } from "obsidian";
+import ExcalidrawPlugin from "src/main";
+//This is only for backward compatibility because an early version of obsidian included an encoding to avoid fantom links from littering Obsidian graph view
+declare const PLUGIN_VERSION:string;
+export let EXCALIDRAW_PLUGIN: ExcalidrawPlugin = null;
+export const setExcalidrawPlugin = (plugin: ExcalidrawPlugin) => {
+  EXCALIDRAW_PLUGIN = plugin;
+};
+const MD_EXCALIDRAW = "# Excalidraw Data";
+const MD_TEXTELEMENTS = "## Text Elements";
+const MD_ELEMENTLINKS = "## Element Links";
+const MD_EMBEDFILES = "## Embedded Files";
+const MD_DRAWING = "## Drawing";
+
+export const MD_EX_SECTIONS = [MD_EXCALIDRAW, MD_TEXTELEMENTS, MD_ELEMENTLINKS, MD_EMBEDFILES, MD_DRAWING];
+
+export const ERROR_IFRAME_CONVERSION_CANCELED = "iframe conversion canceled";
+
+declare const excalidrawLib: typeof ExcalidrawLib;
+
+export const LOCALE = moment.locale();
+
+export const obsidianToExcalidrawMap: { [key: string]: string } = {
+  'en': 'en-US',
+  'af': 'af-ZA', // Assuming South Africa for Afrikaans
+  'am': 'am-ET', // Assuming Ethiopia for Amharic
+  'ar': 'ar-SA',
+  'eu': 'eu-ES',
+  'be': 'be-BY', // Assuming Belarus for Belarusian
+  'bg': 'bg-BG',
+  'bn': 'bn-BD', // Assuming Bangladesh for Bengali
+  'ca': 'ca-ES',
+  'cs': 'cs-CZ',
+  'da': 'da-DK', // Assuming Denmark for Danish
+  'de': 'de-DE',
+  'el': 'el-GR',
+  'eo': 'eo-EO', // Esperanto doesn't have a country
+  'es': 'es-ES',
+  'fa': 'fa-IR',
+  'fi-fi': 'fi-FI',
+  'fr': 'fr-FR',
+  'gl': 'gl-ES',
+  'he': 'he-IL',
+  'hi': 'hi-IN',
+  'hu': 'hu-HU',
+  'id': 'id-ID',
+  'it': 'it-IT',
+  'ja': 'ja-JP',
+  'ko': 'ko-KR',
+  'lv': 'lv-LV',
+  'ml': 'ml-IN', // Assuming India for Malayalam
+  'ms': 'ms-MY', // Assuming Malaysia for Malay
+  'nl': 'nl-NL',
+  'no': 'nb-NO', // Using Norwegian Bokmål for Norwegian
+  'oc': 'oc-FR', // Assuming France for Occitan
+  'pl': 'pl-PL',
+  'pt': 'pt-PT',
+  'pt-BR': 'pt-BR',
+  'ro': 'ro-RO',
+  'ru': 'ru-RU',
+  'sr': 'sr-RS', // Assuming Serbia for Serbian
+  'se': 'sv-SE', // Assuming Swedish for 'se'
+  'sk': 'sk-SK',
+  'sq': 'sq-AL', // Assuming Albania for Albanian
+  'ta': 'ta-IN', // Assuming India for Tamil
+  'te': 'te-IN', // Assuming India for Telugu
+  'th': 'th-TH',
+  'tr': 'tr-TR',
+  'uk': 'uk-UA',
+  'ur': 'ur-PK', // Assuming Pakistan for Urdu
+  'vi': 'vi-VN',
+  'zh': 'zh-CN',
+  'zh-TW': 'zh-TW',
+};
+
+
+export const {
+  sceneCoordsToViewportCoords,
+  viewportCoordsToSceneCoords,
+  determineFocusDistance,
+  intersectElementWithLine,
+  getCommonBoundingBox,
+  getMaximumGroups,
+  measureText,
+  getDefaultLineHeight,
+  wrapText, 
+  getFontString, 
+  getBoundTextMaxWidth, 
+  exportToSvg,
+  exportToBlob,
+  mutateElement,
+  restore,
+  mermaidToExcalidraw,
+  getContainerElement,
+  refreshTextDimensions,
+} = excalidrawLib;
+
+export function JSON_parse(x: string): any {
+  return JSON.parse(x.replaceAll("[", "["));
+}
+export const isDarwin = /Mac|iPod|iPhone|iPad/.test(window.navigator.platform);
+
+export const DEVICE: DeviceType = {
+  isDesktop: !document.body.hasClass("is-tablet") && !document.body.hasClass("is-mobile"),
+  isPhone: document.body.hasClass("is-phone"),
+  isTablet: document.body.hasClass("is-tablet"),
+  isMobile: document.body.hasClass("is-mobile"), //running Obsidian Mobile, need to also check isTablet
+  isLinux: document.body.hasClass("mod-linux") && ! document.body.hasClass("is-android"),
+  isMacOS: document.body.hasClass("mod-macos") && ! document.body.hasClass("is-ios"),
+  isWindows: document.body.hasClass("mod-windows"),
+  isIOS: document.body.hasClass("is-ios"),
+  isAndroid: document.body.hasClass("is-android")
+};
+
+export const ROOTELEMENTSIZE = (() => {
+  const tempElement = document.createElement('div');
+  tempElement.style.fontSize = '1rem';
+  tempElement.style.display = 'none'; // Hide the element
+  document.body.appendChild(tempElement);
+  const computedStyle = getComputedStyle(tempElement);
+  const pixelSize = parseFloat(computedStyle.fontSize);
+  document.body.removeChild(tempElement);
+  return pixelSize;
+})();
+
+export const nanoid = customAlphabet(
+  "1234567890abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
+  8,
+);
+export const KEYCODE = {
+  ESC: 27,
+};
+export const ROUNDNESS = { //should at one point publish @zsviczian/excalidraw/types/constants
+  LEGACY: 1,
+  PROPORTIONAL_RADIUS: 2,
+  ADAPTIVE_RADIUS: 3,
+} as const;
+export const THEME_FILTER = "invert(100%) hue-rotate(180deg) saturate(1.25)";
+export const GITHUB_RELEASES = "https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/";
+export const URLFETCHTIMEOUT = 3000;
+export const PLUGIN_ID = "obsidian-excalidraw-plugin";
+export const SCRIPT_INSTALL_CODEBLOCK = "excalidraw-script-install";
+export const SCRIPT_INSTALL_FOLDER = "Downloaded";
+export const fileid = customAlphabet("1234567890abcdef", 40);
+export const REG_LINKINDEX_INVALIDCHARS = /[<>:"\\|?*#]/g;
+
+//taken from Obsidian source code
+export const REG_SECTION_REF_CLEAN = /([:#|^\\\r\n]|%%|\[\[|]])/g;
+export const REG_BLOCK_REF_CLEAN = /[!"#$%&()*+,.:;<=>?@^`{|}~\/\[\]\\\r\n]/g;
+//                                 /[!"#$%&()*+,.:;<=>?@^`{|}~\/\[\]\\]/g; 
+// https://discord.com/channels/686053708261228577/989603365606531104/1000128926619816048
+// /\+|\/|~|=|%|\(|\)|{|}|,|&|\.|\$|!|\?|;|\[|]|\^|#|\*|<|>|&|@|\||\\|"|:|\s/g;
+export const IMAGE_TYPES = ["jpeg", "jpg", "png", "gif", "svg", "webp", "bmp", "ico", "jtif", "tif"];
+export const ANIMATED_IMAGE_TYPES = ["gif", "webp", "apng", "svg"];
+export const EXPORT_TYPES = ["svg", "dark.svg", "light.svg", "png", "dark.png", "light.png"];
+export const MAX_IMAGE_SIZE = 500;
+
+export const FRONTMATTER_KEYS:{[key:string]: {name: string, type: string, depricated?:boolean}} = {
+  "plugin": {name: "excalidraw-plugin", type: "text"},
+  "export-transparent": {name: "excalidraw-export-transparent", type: "checkbox"},
+  "mask": {name: "excalidraw-mask", type: "checkbox"},
+  "export-dark": {name: "excalidraw-export-dark", type: "checkbox"},
+  "export-svgpadding": {name: "excalidraw-export-svgpadding", type: "number", depricated: true},
+  "export-padding": {name: "excalidraw-export-padding", type: "number"},
+  "export-pngscale": {name: "excalidraw-export-pngscale", type: "number"},
+  "export-embed-scene": {name: "excalidraw-export-embed-scene", type: "checkbox"},
+  "link-prefix": {name: "excalidraw-link-prefix", type: "text"},
+  "url-prefix": {name: "excalidraw-url-prefix", type: "text"},
+  "link-brackets": {name: "excalidraw-link-brackets", type: "checkbox"},
+  "onload-script": {name: "excalidraw-onload-script", type: "text"},
+  "linkbutton-opacity": {name: "excalidraw-linkbutton-opacity", type: "number"},
+  "default-mode": {name: "excalidraw-default-mode", type: "text"},
+  "font": {name: "excalidraw-font", type: "text"},
+  "font-color": {name: "excalidraw-font-color", type: "text"},
+  "border-color": {name: "excalidraw-border-color", type: "text"},
+  "md-css": {name: "excalidraw-css", type: "text"},
+  "autoexport": {name: "excalidraw-autoexport", type: "text"},
+  "iframe-theme": {name: "excalidraw-iframe-theme", type: "text", depricated: true},
+  "embeddable-theme": {name: "excalidraw-embeddable-theme", type: "text"},
+  "open-as-markdown": {name: "excalidraw-open-md", type: "checkbox"},
+};
+
+export const EMBEDDABLE_THEME_FRONTMATTER_VALUES = ["light", "dark", "auto", "dafault"];
+export const VIEW_TYPE_EXCALIDRAW = "excalidraw";
+export const ICON_NAME = "excalidraw-icon";
+export const MAX_COLORS = 5;
+export const COLOR_FREQ = 6;
+export const RERENDER_EVENT = "excalidraw-embed-rerender";
+export const BLANK_DRAWING =
+  `{"type":"excalidraw","version":2,"source":"${GITHUB_RELEASES+PLUGIN_VERSION}","elements":[],"appState":{"gridSize":null,"viewBackgroundColor":"#ffffff"}}`;
+export const DARK_BLANK_DRAWING =
+  `{"type":"excalidraw","version":2,"source":"${GITHUB_RELEASES+PLUGIN_VERSION}","elements":[],"appState":{"theme":"dark","gridSize":null,"viewBackgroundColor":"#ffffff"}}`;
+export const FRONTMATTER = [
+  "---",
+  "",
+  `${FRONTMATTER_KEYS["plugin"].name}: parsed`,
+  "tags: [excalidraw]",
+  "",
+  "---",
+  "==⚠  Switch to EXCALIDRAW VIEW in the MORE OPTIONS menu of this document. ⚠== You can decompress Drawing data with the command palette: 'Decompress current Excalidraw file'. For more info check in plugin settings under 'Saving'",
+  "",
+  "",
+].join("\n");
+export const EMPTY_MESSAGE = "Hit enter to create a new drawing";
+export const TEXT_DISPLAY_PARSED_ICON_NAME = "quote-glyph";
+export const TEXT_DISPLAY_RAW_ICON_NAME = "presentation";
+/*export const FULLSCREEN_ICON_NAME = "fullscreen";
+export const EXIT_FULLSCREEN_ICON_NAME = "exit-fullscreen";*/
+export const SCRIPTENGINE_ICON_NAME = "ScriptEngine";
+
+export const KEYBOARD_EVENT_TYPES = [
+  "keydown",
+  "keyup",
+  "keypress"
+];
+
+export const EXTENDED_EVENT_TYPES = [
+/*  "pointerdown",
+  "pointerup",
+  "pointermove",
+  "mousedown",
+  "mouseup",
+  "mousemove",
+  "mouseover",
+  "mouseout",
+  "mouseenter",
+  "mouseleave",
+  "dblclick",
+  "drag",
+  "dragend",
+  "dragenter",
+  "dragexit",
+  "dragleave",
+  "dragover",
+  "dragstart",
+  "drop",*/
+  "copy",
+  "cut",
+  "paste",
+  /*"wheel",
+  "touchstart",
+  "touchend",
+  "touchmove",*/
+];
+
+//export const TWITTER_REG = /^(?:http(?:s)?:\/\/)?(?:(?:w){3}.)?twitter.com/;
+
+
+export const COLOR_NAMES = new Map<string, string>();
+COLOR_NAMES.set("aliceblue", "#f0f8ff");
+COLOR_NAMES.set("antiquewhite", "#faebd7");
+COLOR_NAMES.set("aqua", "#00ffff");
+COLOR_NAMES.set("aquamarine", "#7fffd4");
+COLOR_NAMES.set("azure", "#f0ffff");
+COLOR_NAMES.set("beige", "#f5f5dc");
+COLOR_NAMES.set("bisque", "#ffe4c4");
+COLOR_NAMES.set("black", "#000000");
+COLOR_NAMES.set("blanchedalmond", "#ffebcd");
+COLOR_NAMES.set("blue", "#0000ff");
+COLOR_NAMES.set("blueviolet", "#8a2be2");
+COLOR_NAMES.set("brown", "#a52a2a");
+COLOR_NAMES.set("burlywood", "#deb887");
+COLOR_NAMES.set("cadetblue", "#5f9ea0");
+COLOR_NAMES.set("chartreuse", "#7fff00");
+COLOR_NAMES.set("chocolate", "#d2691e");
+COLOR_NAMES.set("coral", "#ff7f50");
+COLOR_NAMES.set("cornflowerblue", "#6495ed");
+COLOR_NAMES.set("cornsilk", "#fff8dc");
+COLOR_NAMES.set("crimson", "#dc143c");
+COLOR_NAMES.set("cyan", "#00ffff");
+COLOR_NAMES.set("darkblue", "#00008b");
+COLOR_NAMES.set("darkcyan", "#008b8b");
+COLOR_NAMES.set("darkgoldenrod", "#b8860b");
+COLOR_NAMES.set("darkgray", "#a9a9a9");
+COLOR_NAMES.set("darkgreen", "#006400");
+COLOR_NAMES.set("darkkhaki", "#bdb76b");
+COLOR_NAMES.set("darkmagenta", "#8b008b");
+COLOR_NAMES.set("darkolivegreen", "#556b2f");
+COLOR_NAMES.set("darkorange", "#ff8c00");
+COLOR_NAMES.set("darkorchid", "#9932cc");
+COLOR_NAMES.set("darkred", "#8b0000");
+COLOR_NAMES.set("darksalmon", "#e9967a");
+COLOR_NAMES.set("darkseagreen", "#8fbc8f");
+COLOR_NAMES.set("darkslateblue", "#483d8b");
+COLOR_NAMES.set("darkslategray", "#2f4f4f");
+COLOR_NAMES.set("darkturquoise", "#00ced1");
+COLOR_NAMES.set("darkviolet", "#9400d3");
+COLOR_NAMES.set("deeppink", "#ff1493");
+COLOR_NAMES.set("deepskyblue", "#00bfff");
+COLOR_NAMES.set("dimgray", "#696969");
+COLOR_NAMES.set("dodgerblue", "#1e90ff");
+COLOR_NAMES.set("firebrick", "#b22222");
+COLOR_NAMES.set("floralwhite", "#fffaf0");
+COLOR_NAMES.set("forestgreen", "#228b22");
+COLOR_NAMES.set("fuchsia", "#ff00ff");
+COLOR_NAMES.set("gainsboro", "#dcdcdc");
+COLOR_NAMES.set("ghostwhite", "#f8f8ff");
+COLOR_NAMES.set("gold", "#ffd700");
+COLOR_NAMES.set("goldenrod", "#daa520");
+COLOR_NAMES.set("gray", "#808080");
+COLOR_NAMES.set("green", "#008000");
+COLOR_NAMES.set("greenyellow", "#adff2f");
+COLOR_NAMES.set("honeydew", "#f0fff0");
+COLOR_NAMES.set("hotpink", "#ff69b4");
+COLOR_NAMES.set("indianred", "#cd5c5c");
+COLOR_NAMES.set("indigo", "#4b0082");
+COLOR_NAMES.set("ivory", "#fffff0");
+COLOR_NAMES.set("khaki", "#f0e68c");
+COLOR_NAMES.set("lavender", "#e6e6fa");
+COLOR_NAMES.set("lavenderblush", "#fff0f5");
+COLOR_NAMES.set("lawngreen", "#7cfc00");
+COLOR_NAMES.set("lemonchiffon", "#fffacd");
+COLOR_NAMES.set("lightblue", "#add8e6");
+COLOR_NAMES.set("lightcoral", "#f08080");
+COLOR_NAMES.set("lightcyan", "#e0ffff");
+COLOR_NAMES.set("lightgoldenrodyellow", "#fafad2");
+COLOR_NAMES.set("lightgrey", "#d3d3d3");
+COLOR_NAMES.set("lightgreen", "#90ee90");
+COLOR_NAMES.set("lightpink", "#ffb6c1");
+COLOR_NAMES.set("lightsalmon", "#ffa07a");
+COLOR_NAMES.set("lightseagreen", "#20b2aa");
+COLOR_NAMES.set("lightskyblue", "#87cefa");
+COLOR_NAMES.set("lightslategray", "#778899");
+COLOR_NAMES.set("lightsteelblue", "#b0c4de");
+COLOR_NAMES.set("lightyellow", "#ffffe0");
+COLOR_NAMES.set("lime", "#00ff00");
+COLOR_NAMES.set("limegreen", "#32cd32");
+COLOR_NAMES.set("linen", "#faf0e6");
+COLOR_NAMES.set("magenta", "#ff00ff");
+COLOR_NAMES.set("maroon", "#800000");
+COLOR_NAMES.set("mediumaquamarine", "#66cdaa");
+COLOR_NAMES.set("mediumblue", "#0000cd");
+COLOR_NAMES.set("mediumorchid", "#ba55d3");
+COLOR_NAMES.set("mediumpurple", "#9370d8");
+COLOR_NAMES.set("mediumseagreen", "#3cb371");
+COLOR_NAMES.set("mediumslateblue", "#7b68ee");
+COLOR_NAMES.set("mediumspringgreen", "#00fa9a");
+COLOR_NAMES.set("mediumturquoise", "#48d1cc");
+COLOR_NAMES.set("mediumvioletred", "#c71585");
+COLOR_NAMES.set("midnightblue", "#191970");
+COLOR_NAMES.set("mintcream", "#f5fffa");
+COLOR_NAMES.set("mistyrose", "#ffe4e1");
+COLOR_NAMES.set("moccasin", "#ffe4b5");
+COLOR_NAMES.set("navajowhite", "#ffdead");
+COLOR_NAMES.set("navy", "#000080");
+COLOR_NAMES.set("oldlace", "#fdf5e6");
+COLOR_NAMES.set("olive", "#808000");
+COLOR_NAMES.set("olivedrab", "#6b8e23");
+COLOR_NAMES.set("orange", "#ffa500");
+COLOR_NAMES.set("orangered", "#ff4500");
+COLOR_NAMES.set("orchid", "#da70d6");
+COLOR_NAMES.set("palegoldenrod", "#eee8aa");
+COLOR_NAMES.set("palegreen", "#98fb98");
+COLOR_NAMES.set("paleturquoise", "#afeeee");
+COLOR_NAMES.set("palevioletred", "#d87093");
+COLOR_NAMES.set("papayawhip", "#ffefd5");
+COLOR_NAMES.set("peachpuff", "#ffdab9");
+COLOR_NAMES.set("peru", "#cd853f");
+COLOR_NAMES.set("pink", "#ffc0cb");
+COLOR_NAMES.set("plum", "#dda0dd");
+COLOR_NAMES.set("powderblue", "#b0e0e6");
+COLOR_NAMES.set("purple", "#800080");
+COLOR_NAMES.set("rebeccapurple", "#663399");
+COLOR_NAMES.set("red", "#ff0000");
+COLOR_NAMES.set("rosybrown", "#bc8f8f");
+COLOR_NAMES.set("royalblue", "#4169e1");
+COLOR_NAMES.set("saddlebrown", "#8b4513");
+COLOR_NAMES.set("salmon", "#fa8072");
+COLOR_NAMES.set("sandybrown", "#f4a460");
+COLOR_NAMES.set("seagreen", "#2e8b57");
+COLOR_NAMES.set("seashell", "#fff5ee");
+COLOR_NAMES.set("sienna", "#a0522d");
+COLOR_NAMES.set("silver", "#c0c0c0");
+COLOR_NAMES.set("skyblue", "#87ceeb");
+COLOR_NAMES.set("slateblue", "#6a5acd");
+COLOR_NAMES.set("slategray", "#708090");
+COLOR_NAMES.set("snow", "#fffafa");
+COLOR_NAMES.set("springgreen", "#00ff7f");
+COLOR_NAMES.set("steelblue", "#4682b4");
+COLOR_NAMES.set("tan", "#d2b48c");
+COLOR_NAMES.set("teal", "#008080");
+COLOR_NAMES.set("thistle", "#d8bfd8");
+COLOR_NAMES.set("tomato", "#ff6347");
+COLOR_NAMES.set("turquoise", "#40e0d0");
+COLOR_NAMES.set("violet", "#ee82ee");
+COLOR_NAMES.set("wheat", "#f5deb3");
+COLOR_NAMES.set("white", "#ffffff");
+COLOR_NAMES.set("whitesmoke", "#f5f5f5");
+COLOR_NAMES.set("yellow", "#ffff00");
+COLOR_NAMES.set("yellowgreen", "#9acd32");
+export const DEFAULT_MD_EMBED_CSS = `.snw-reference{display: none;}.excalidraw-md-host{padding:0px 10px}.excalidraw-md-footer{height:5px}foreignObject{background-color:transparent}p{display:block;margin-block-start:1em;margin-block-end:1em;margin-inline-start:0px;margin-inline-end:0px;color:inherit}table,tr,th,td{color:inherit;border:1px solid;border-collapse:collapse;padding:3px}th{font-weight:bold;border-bottom:double;background-color:silver}.copy-code-button{display:none}code[class*=language-],pre[class*=language-]{color:#393a34;font-family:"Consolas","Bitstream Vera Sans Mono","Courier New",Courier,monospace;direction:ltr;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;font-size:.9em;line-height:1.2em;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre>code[class*=language-]{font-size:1em}pre[class*=language-]::-moz-selection,pre[class*=language-] ::-moz-selection,code[class*=language-]::-moz-selection,code[class*=language-] ::-moz-selection{background:#C1DEF1}pre[class*=language-]::selection,pre[class*=language-] ::selection,code[class*=language-]::selection,code[class*=language-] ::selection{background:#C1DEF1}pre[class*=language-]{padding:1em;margin:.5em 0;overflow:auto;background-color:#0000001a}:not(pre)>code[class*=language-]{padding:.2em;padding-top:1px;padding-bottom:1px;background:#f8f8f8;border:1px solid #dddddd}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:green;font-style:italic}.token.namespace{opacity:.7}.token.string{color:#a31515}.token.punctuation,.token.operator{color:#393a34}.token.url,.token.symbol,.token.number,.token.boolean,.token.variable,.token.constant,.token.inserted{color:#36acaa}.token.atrule,.token.keyword,.token.attr-value,.language-autohotkey .token.selector,.language-json .token.boolean,.language-json .token.number,code[class*=language-css]{color:#00f}.token.function{color:#393a34}.token.deleted,.language-autohotkey .token.tag{color:#9a050f}.token.selector,.language-autohotkey .token.keyword{color:#00009f}.token.important{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.class-name,.language-json .token.property{color:#2b91af}.token.tag,.token.selector{color:maroon}.token.attr-name,.token.property,.token.regex,.token.entity{color:red}.token.directive.tag .tag{background:#ffff00;color:#393a34}.line-numbers.line-numbers .line-numbers-rows{border-right-color:#a5a5a5}.line-numbers .line-numbers-rows>span:before{color:#2b91af}.line-highlight.line-highlight{background:rgba(193,222,241,.2);background:-webkit-linear-gradient(left,rgba(193,222,241,.2) 70%,rgba(221,222,241,0));background:linear-gradient(to right,rgba(193,222,241,.2) 70%,rgba(221,222,241,0))}blockquote{ font-style:italic;background-color:rgb(46,43,42,0.1);margin:0;margin-left:1em;border-radius:0 4px 4px 0;border:1px solid hsl(0,80%,32%);border-left-width:8px;border-top-width:0px;border-right-width:0px;border-bottom-width:0px;padding:10px 20px;margin-inline-start:30px;margin-inline-end:30px;}`;
+export const SCRIPTENGINE_ICON = `<g transform="translate(-8,-8)"><path d="M24.318 37.983c-1.234-1.232-8.433-3.903-7.401-7.387 1.057-3.484 9.893-12.443 13.669-13.517 3.776-1.074 6.142 6.523 9.012 7.073 2.87.55 6.797-1.572 8.207-3.694 1.384-2.148-3.147-7.413.15-9.168 3.298-1.755 16.389-2.646 19.611-1.284 3.247 1.363-1.611 7.335-.151 9.483 1.46 2.148 6.067 3.746 8.836 3.38 2.769-.368 4.154-6.733 7.728-5.633 3.575 1.1 12.36 8.828 13.67 12.233 1.308 3.406-5.186 5.423-5.79 8.2-.58 2.75-.026 6.705 2.265 8.355 2.266 1.65 9.642-1.78 11.404 1.598 1.762 3.38 1.007 15.35-.806 18.651-1.787 3.353-7.753-.367-9.969 1.31-2.215 1.65-3.901 5.92-3.373 8.67.504 2.777 7.754 4.48 6.445 7.885C96.49 87.543 87.15 95.454 83.5 96.685c-3.65 1.231-4.96-4.741-7.577-5.16-2.593-.393-6.57.707-8.03 2.75-1.436 2.017 2.668 7.806-.63 9.483-3.323 1.676-15.759 2.226-19.157.655-3.373-1.598.554-7.964-1.108-10.138-1.687-2.174-6.394-3.431-9.012-2.907-2.643.55-3.273 7.282-6.747 6.103-3.499-1.126-12.788-9.535-14.172-13.019-1.36-3.484 5.437-5.108 5.966-7.858.529-2.777-.68-7.073-2.744-8.697-2.064-1.624-7.93 2.41-9.642-1.126-1.737-3.537-2.441-16.765-.654-20.118 1.787-3.3 9.062 1.598 11.429.183 2.366-1.44 2.316-7.282 2.769-8.749m.126-.104c-1.234-1.232-8.433-3.903-7.401-7.387 1.057-3.484 9.893-12.443 13.669-13.517 3.776-1.074 6.142 6.523 9.012 7.073 2.87.55 6.797-1.572 8.207-3.694 1.384-2.148-3.147-7.413.15-9.168 3.298-1.755 16.389-2.646 19.611-1.284 3.247 1.363-1.611 7.335-.151 9.483 1.46 2.148 6.067 3.746 8.836 3.38 2.769-.368 4.154-6.733 7.728-5.633 3.575 1.1 12.36 8.828 13.67 12.233 1.308 3.406-5.186 5.423-5.79 8.2-.58 2.75-.026 6.705 2.265 8.355 2.266 1.65 9.642-1.78 11.404 1.598 1.762 3.38 1.007 15.35-.806 18.651-1.787 3.353-7.753-.367-9.969 1.31-2.215 1.65-3.901 5.92-3.373 8.67.504 2.777 7.754 4.48 6.445 7.885C96.49 87.543 87.15 95.454 83.5 96.685c-3.65 1.231-4.96-4.741-7.577-5.16-2.593-.393-6.57.707-8.03 2.75-1.436 2.017 2.668 7.806-.63 9.483-3.323 1.676-15.759 2.226-19.157.655-3.373-1.598.554-7.964-1.108-10.138-1.687-2.174-6.394-3.431-9.012-2.907-2.643.55-3.273 7.282-6.747 6.103-3.499-1.126-12.788-9.535-14.172-13.019-1.36-3.484 5.437-5.108 5.966-7.858.529-2.777-.68-7.073-2.744-8.697-2.064-1.624-7.93 2.41-9.642-1.126-1.737-3.537-2.441-16.765-.654-20.118 1.787-3.3 9.062 1.598 11.429.183 2.366-1.44 2.316-7.282 2.769-8.749" fill="none" stroke-width="2" stroke-linecap="round" stroke="currentColor"/><path d="M81.235 56.502a23.3 23.3 0 0 1-1.46 8.068 20.785 20.785 0 0 1-1.762 3.72 24.068 24.068 0 0 1-5.337 6.26 22.575 22.575 0 0 1-3.449 2.358 23.726 23.726 0 0 1-7.803 2.803 24.719 24.719 0 0 1-8.333 0 24.102 24.102 0 0 1-4.028-1.074 23.71 23.71 0 0 1-3.776-1.729 23.259 23.259 0 0 1-6.369-5.265 23.775 23.775 0 0 1-2.416-3.353 24.935 24.935 0 0 1-1.762-3.72 23.765 23.765 0 0 1-1.083-3.981 23.454 23.454 0 0 1 0-8.173c.252-1.336.604-2.698 1.083-3.956a24.935 24.935 0 0 1 1.762-3.72 22.587 22.587 0 0 1 2.416-3.378c.881-1.048 1.888-2.017 2.946-2.908a24.38 24.38 0 0 1 3.423-2.357 23.71 23.71 0 0 1 3.776-1.73 21.74 21.74 0 0 1 4.028-1.047 23.437 23.437 0 0 1 8.333 0 24.282 24.282 0 0 1 7.803 2.777 26.198 26.198 0 0 1 3.45 2.357 24.62 24.62 0 0 1 5.336 6.287 20.785 20.785 0 0 1 1.762 3.72 21.32 21.32 0 0 1 1.083 3.955c.251 1.336.302 3.405.377 4.086.05.681.05-.68 0 0" fill="none" stroke-width="4" stroke-linecap="round" stroke="currentColor"/><path d="M69.404 56.633c-6.596-3.3-13.216-6.6-19.51-9.744m19.51 9.744c-6.747-3.379-13.493-6.758-19.51-9.744m0 0v19.489m0-19.49v19.49m0 0c4.355-2.148 8.71-4.322 19.51-9.745m-19.51 9.745c3.978-1.965 7.93-3.956 19.51-9.745m0 0h0m0 0h0" fill="currentColor" stroke-linecap="round" stroke="currentColor" stroke-width="4"/></g>`;
+export const DISK_ICON_NAME = "save";
+export const EXPORT_IMG_ICON = ` <g transform="scale(4.166)" strokeWidth="1.25" fill="none" stroke="currentColor"><path stroke="none" d="M0 0h24v24H0z" fill="none"></path><path d="M15 8h.01"></path><path d="M12 20h-5a3 3 0 0 1 -3 -3v-10a3 3 0 0 1 3 -3h10a3 3 0 0 1 3 3v5"></path><path d="M4 15l4 -4c.928 -.893 2.072 -.893 3 0l4 4"></path><path d="M14 14l1 -1c.617 -.593 1.328 -.793 2.009 -.598"></path><path d="M19 16v6"></path><path d="M22 19l-3 3l-3 -3"></path></g>`;
+export const EXPORT_IMG_ICON_NAME = `export-img`;
+export const EXCALIDRAW_ICON = `<path d="M24 17h121v121H24z" style="fill:none" transform="matrix(.8843 0 0 .83471 -21.223 -14.19)"/><path d="M119.81 105.98a.549.549 0 0 0-.53-.12c-4.19-6.19-9.52-12.06-14.68-17.73l-.85-.93c0-.11-.05-.21-.12-.3a.548.548 0 0 0-.34-.2l-.17-.18-.12-.09c-.15-.32-.53-.56-.95-.35-1.58.81-3 1.97-4.4 3.04-1.87 1.43-3.7 2.92-5.42 4.52-.7.65-1.39 1.33-1.97 2.09-.28.37-.07.72.27.87-1.22 1.2-2.45 2.45-3.68 3.74-.11.12-.17.28-.16.44.01.16.09.31.22.41l2.16 1.65s.01.03.03.04c3.09 3.05 8.51 7.28 14.25 11.76.85.67 1.71 1.34 2.57 2.01.39.47.76.94 1.12 1.4.19.25.55.3.8.11.13.1.26.21.39.31a.57.57 0 0 0 .8-.1c.07-.09.1-.2.11-.31.04 0 .07.03.1.03.15 0 .31-.06.42-.18l10.18-11.12a.56.56 0 0 0-.04-.8l.01-.01Zm-29.23-3.85c.07.09.14.17.21.25 1.16.98 2.4 2.04 3.66 3.12l-5.12-3.91s-.32-.22-.52-.36c-.11-.08-.21-.16-.31-.24l-.38-.32s.07-.07.1-.11l.35-.35c1.72-1.74 4.67-4.64 6.19-6.06-1.61 1.62-4.87 6.37-4.17 7.98h-.01Zm17.53 13.81-4.22-3.22c-1.65-1.71-3.43-3.4-5.24-5.03 2.28 1.76 4.23 3.25 4.52 3.51 2.21 1.97 2.11 1.61 3.63 2.91l1.83 1.33c-.18.16-.36.33-.53.49l.01.01Zm1.06.81-.08-.06c.16-.13.33-.25.49-.38l-.4.44h-.01Zm-66.93-65.3c.14.72.27 1.43.4 2.11.69 3.7 1.33 7.03 2.55 9.56l.48 1.92c.19.73.46 1.64.71 1.83 2.85 2.52 7.22 6.28 11.89 9.82.21.16.5.15.7-.01.01.02.03.03.04.04.11.1.24.15.38.15.16 0 .31-.06.42-.19 5.98-6.65 10.43-12.12 13.6-16.7.2-.25.3-.54.29-.84.2-.24.41-.48.6-.68a.558.558 0 0 0-.1-.86.578.578 0 0 0-.17-.36c-1.39-1.34-2.42-2.31-3.46-3.28-1.84-1.72-3.74-3.5-7.77-7.51-.02-.02-.05-.04-.07-.06a.555.555 0 0 0-.22-.14c-1.11-.39-3.39-.78-6.26-1.28-4.22-.72-10-1.72-15.2-3.27h-.04v-.01s-.02 0-.03.02h-.01l.04-.02s-.31.01-.37.04c-.08.04-.14.09-.19.15-.05.06-.09.12-.47.2-.38.08.08 0 .11 0h-.11v.03c.07.34.05.58.16.97-.02.1.21 1.02.24 1.11l1.83 7.26h.03Zm30.95 6.54s-.03.04-.04.05l-.64-.71c.22.21.44.42.68.66Zm-7.09 9.39s-.07.08-.1.12l-.02-.02c.04-.03.08-.07.13-.1h-.01Zm-7.07 8.47Zm3.02-28.57c.35.35 1.74 1.65 2.06 1.97-1.45-.66-5.06-2.34-6.74-2.88 1.65.29 3.93.66 4.68.91Zm-19.18-2.77c.84 1.44 1.5 6.49 2.16 11.4-.37-1.58-.69-3.12-.99-4.6-.52-2.56-1-4.85-1.67-6.88.14.01.31.03.49.05 0 .01 0 .02.02.03h-.01Zm-.29-1.21c-.23-.02-.44-.04-.62-.05-.02-.04-.03-.08-.04-.12l.66.18v-.01Zm-2.22.45v-.02.02Zm78.54-1.18c.04-.23-1.1-1.24-.74-1.26.85-.04.86-1.35 0-1.31-1.13.06-2.27.32-3.37.53-1.98.37-3.95.78-5.92 1.21-4.39.94-8.77 1.93-13.1 3.11-1.36.37-2.86.7-4.11 1.36-.42.22-.4.67-.17.95-.09.05-.18.08-.28.09-.37.07-.74.13-1.11.19a.566.566 0 0 0-.39.86c-2.32 3.1-4.96 6.44-7.82 9.95-2.81 3.21-5.73 6.63-8.72 10.14-9.41 11.06-20.08 23.6-31.9 34.64-.23.21-.24.57-.03.8.05.06.12.1.19.13-.16.15-.32.3-.48.44-.1.09-.14.2-.16.32-.08.08-.16.17-.23.25-.21.23-.2.59.03.8.23.21.59.2.8-.03.04-.04.08-.09.12-.13a.84.84 0 0 1 1.22 0c.69.74 1.34 1.44 1.95 2.09l-1.38-1.15a.57.57 0 0 0-.8.07c-.2.24-.17.6.07.8l14.82 12.43c.11.09.24.13.37.13.15 0 .29-.06.4-.17l.36-.36a.56.56 0 0 0 .63-.12c20.09-20.18 36.27-35.43 54.8-49.06.17-.12.25-.32.23-.51a.57.57 0 0 0 .48-.39c3.42-10.46 4.08-19.72 4.28-24.27 0-.03.01-.05.02-.07.02-.05.03-.1.04-.14.03-.11.05-.19.05-.19.26-.78.17-1.53-.15-2.15v.02ZM82.98 58.94c.9-1.03 1.79-2.04 2.67-3.02-5.76 7.58-15.3 19.26-28.81 33.14 9.2-10.18 18.47-20.73 26.14-30.12Zm-32.55 52.81-.03-.03c.11.02.19.04.2.04a.47.47 0 0 0-.17 0v-.01Zm6.9 6.42-.05-.04.03-.03c.02 0 .03.02.04.02 0 .02-.02.03-.03.05h.01Zm8.36-7.21 1.38-1.44c.01.01.02.03.03.05-.47.46-.94.93-1.42 1.39h.01Zm2.24-2.21c.26-.3.56-.65.87-1.02.01-.01.02-.03.04-.04 3.29-3.39 6.68-6.82 10.18-10.25.02-.02.05-.04.07-.06.86-.66 1.82-1.39 2.72-2.08-4.52 4.32-9.11 8.78-13.88 13.46v-.01Zm21.65-55.88c-1.86 2.42-3.9 5.56-5.63 8.07-5.46 7.91-23.04 27.28-23.43 27.65-2.71 2.62-10.88 10.46-16.09 15.37-.14.13-.25.24-.34.35a.794.794 0 0 1 .03-1.13c24.82-23.4 39.88-42.89 46-51.38-.13.33-.24.69-.55 1.09l.01-.02Zm16.51 7.1-.01.02c0-.02-.02-.07.01-.02Zm-.91-5.13Zm-5.89 9.45c-2.26-1.31-3.32-3.27-2.71-5.25l.19-.66c.08-.19.17-.38.28-.57.59-.98 1.49-1.85 2.52-2.36.05-.02.1-.03.15-.04a.795.795 0 0 1-.04-.43c.05-.31.25-.58.66-.58.67 0 2.75.62 3.54 1.3.24.19.47.4.68.63.3.35.74.92.96 1.33.13.06.23.62.38.91.14.46.2.93.18 1.4 0 .02 0 .02.01.03-.03.07 0 .37-.04.4-.1.72-.36 1.43-.75 2.05-.04.05-.07.11-.11.16 0 .01-.02.02-.03.04-.3.43-.65.83-1.08 1.13-1.26.89-2.73 1.16-4.2.79a6.33 6.33 0 0 1-.57-.25l-.02-.03Zm16.27-1.63c-.49 2.05-1.09 4.19-1.8 6.38-.03.08-.03.16-.03.23-.1.01-.19.05-.27.11-4.44 3.26-8.73 6.62-12.98 10.11 3.67-3.32 7.39-6.62 11.23-9.95a6.409 6.409 0 0 0 2.11-3.74l.56-3.37.03-.1c.25-.71 1.34-.4 1.17.33h-.02Z" style="fill:currentColor;fill-rule:nonzero" transform="translate(-26.41 -29.49)"/>`;

src/constants/startupScript.md

@@ -0,0 +1,116 @@
+/*
+#exclude
+```js*/
+/**
+ * If set, this callback is triggered when the user closes an Excalidraw view.
+ *   onViewUnloadHook: (view: ExcalidrawView) => void = null;
+ */
+//ea.onViewUnloadHook = (view) => {};
+
+/**
+ * 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 = null;
+ */
+//ea.onViewModeChangeHook = (isViewModeEnabled, view, ea) => {};
+
+/**
+ * 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 = null;
+ */
+//ea.onLinkHoverHook = (element, linkText, view, ea) => {};
+   
+/**
+ * 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 = null;
+ */
+//ea.onLinkClickHook = (element,linkText,event, view, ea) => {};
+   
+/**
+ * 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; //Obsidian draggable object
+ *     type: "file" | "text" | "unknown";
+ *     payload: {
+ *       files: TFile[]; //TFile[] array of dropped files
+ *       text: string; //string
+ *     };
+ *     excalidrawFile: TFile; //the file receiving the drop event
+ *     view: ExcalidrawView; //the excalidraw view receiving the drop
+ *     pointerPosition: { x: number; y: number }; //the pointer position on canvas at the time of drop
+ *   }) => boolean = null;
+ */
+//ea.onDropHook = (data) => {};
+ 
+/**
+ * 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; //the file receiving the paste event
+ *     view: ExcalidrawView; //the excalidraw view receiving the paste
+ *     pointerPosition: { x: number; y: number }; //the pointer position on canvas
+ *   }) => boolean = null;
+ */
+//ea.onPasteHook = (data) => {};
+
+/**
+ * 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; //the file being loaded
+ *     view: ExcalidrawView;
+ *   }) => Promise<void>;
+ */
+//ea.onFileOpenHook = (data) => {};
+
+/**
+ * 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; //the file being created
+ *     view: ExcalidrawView;
+ *   }) => Promise<void>;
+ */
+//ea.onFileCreateHook = (data) => {}; 
+
+/**
+ * If set, this callback is triggered whenever the active canvas color changes
+ *   onCanvasColorChangeHook: (
+ *     ea: ExcalidrawAutomate,
+ *     view: ExcalidrawView, //the excalidraw view 
+ *     color: string,
+ *   ) => void = null;
+ */
+//ea.onCanvasColorChangeHook = (ea, view, color) => {};

src/customEmbeddable.tsx

@@ -1,12 +1,13 @@
-import { NonDeletedExcalidrawElement } from "@zsviczian/excalidraw/types/element/types";
+import {  NonDeletedExcalidrawElement } from "@zsviczian/excalidraw/types/excalidraw/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 { DEVICE, EXTENDED_EVENT_TYPES, KEYBOARD_EVENT_TYPES } from "./constants/constants";
+import { ExcalidrawImperativeAPI, UIAppState } from "@zsviczian/excalidraw/types/excalidraw/types";
 import { ObsidianCanvasNode } from "./utils/CanvasNodeFactory";
 import { processLinkText, patchMobileView } from "./utils/CustomEmbeddableUtils";
+import { EmbeddableMDCustomProps } from "./dialogs/EmbeddableSettings";
 
 declare module "obsidian" {
   interface Workspace {
@@ -18,13 +19,22 @@ declare module "obsidian" {
   }
 }
 
+const getTheme = (view: ExcalidrawView, theme:string): string => view.excalidrawData.embeddableTheme === "dark"
+  ? "theme-dark"
+  : view.excalidrawData.embeddableTheme === "light" 
+    ? "theme-light"
+    : view.excalidrawData.embeddableTheme === "auto"
+      ? theme === "dark" ? "theme-dark" : "theme-light"
+      : isObsidianThemeDark() ? "theme-dark" : "theme-light";
+
 //--------------------------------------------------------------------------------
 //Render webview for anything other than Vimeo and Youtube
 //Vimeo and Youtube are rendered by Excalidraw because of the window messaging
 //required to control the video
 //--------------------------------------------------------------------------------
 export const renderWebView = (src: string, view: ExcalidrawView, id: string, appState: UIAppState):JSX.Element =>{
-  if(DEVICE.isDesktop) {
+  const isDataURL = src.startsWith("data:");
+  if(DEVICE.isDesktop && !isDataURL) {
     return (
       <webview
         ref={(ref) => view.updateEmbeddableRef(id, ref)}
@@ -46,11 +56,12 @@ export const renderWebView = (src: string, view: ExcalidrawView, id: string, app
       title="Excalidraw Embedded Content"
       allowFullScreen={true}
       allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
-      src={src}
+      src={isDataURL ? null : src}
       style={{
         overflow: "hidden",
         borderRadius: "var(--embeddable-radius)",
       }}
+      srcDoc={isDataURL ? atob(src.split(',')[1]) : null}
     />
   );
 }
@@ -59,13 +70,15 @@ export const renderWebView = (src: string, view: ExcalidrawView, id: string, app
 //Render WorkspaceLeaf or CanvasNode
 //--------------------------------------------------------------------------------
 function RenderObsidianView(
-  { element, linkText, view, containerRef, appState, theme }:{
+  { mdProps, element, linkText, view, containerRef, activeEmbeddable, theme, canvasColor }:{
+  mdProps: EmbeddableMDCustomProps;
   element: NonDeletedExcalidrawElement;
   linkText: string;
   view: ExcalidrawView;
   containerRef: React.RefObject<HTMLDivElement>;
-  appState: UIAppState;
+  activeEmbeddable: {element: NonDeletedExcalidrawElement; state: string};
   theme: string;
+  canvasColor: string;
 }): JSX.Element {
   
   const { subpath, file } = processLinkText(linkText, view);
@@ -76,11 +89,22 @@ function RenderObsidianView(
   const react = view.plugin.getPackage(view.ownerWindow).react;
   
   //@ts-ignore
-  const leafRef = react.useRef<{leaf: WorkspaceLeaf; node?: ObsidianCanvasNode} | null>(null);
+  const leafRef = react.useRef<{leaf: WorkspaceLeaf; node?: ObsidianCanvasNode, editNode?: Function} | 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
   //--------------------------------------------------------------------------------
@@ -130,7 +154,7 @@ function RenderObsidianView(
 
 
   //--------------------------------------------------------------------------------
-  //mount the workspace leaf or the canvas node depending on subpath
+  //Mount the workspace leaf or the canvas node depending on subpath
   //--------------------------------------------------------------------------------
   react.useEffect(() => {
     if(!containerRef?.current) {
@@ -152,7 +176,8 @@ function RenderObsidianView(
     rootSplit.containerEl.style.borderRadius = "var(--embeddable-radius)";
     leafRef.current = {
       leaf: app.workspace.createLeafInParent(rootSplit, 0),
-      node: null
+      node: null,
+      editNode: null,
     };
 
     const setKeepOnTop = () => {
@@ -192,6 +217,7 @@ function RenderObsidianView(
           //This runs only when the file is added, thus should not be a major performance issue
           await leafRef.current.leaf.setViewState({state: {file:null}})
           leafRef.current.node = view.canvasNodeFactory.createFileNote(file, subpath, containerRef.current, element.id);
+          setColors(containerRef.current, element, mdProps, canvasColor);
         } else {
           const workspaceLeaf:HTMLDivElement = rootSplit.containerEl.querySelector("div.workspace-leaf");
           if(workspaceLeaf) workspaceLeaf.style.borderRadius = "var(--embeddable-radius)";
@@ -205,9 +231,93 @@ function RenderObsidianView(
     return () => {}; //cleanup on unmount
   }, [linkText, subpath, containerRef]);
   
+  //--------------------------------------------------------------------------------
+  //Set colors of the canvas node
+  //--------------------------------------------------------------------------------
+  const setColors = (canvasNode: HTMLDivElement, element: NonDeletedExcalidrawElement, mdProps: EmbeddableMDCustomProps, canvasColor: 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 
+        ? (element.backgroundColor.toLowerCase() === "transparent"
+          ? "transparent"
+          : ea.getCM(element.backgroundColor).alphaTo(opacity).stringHEX())
+        : "transparent";
+      
+      color === "transparent" ? canvasNode?.addClass("transparent") : canvasNode?.removeClass("transparent");        
+      canvasNode?.style.setProperty("--canvas-background", color);
+      canvasNode?.style.setProperty("--background-primary", color);
+      canvasNodeContainer?.style.setProperty("background-color", color);
+    } else if (!(mdProps?.backgroundMatchElement ?? true )) {
+      const opacity = (mdProps.backgroundOpacity??100)/100;
+      const color = mdProps.backgroundMatchCanvas
+        ? (canvasColor.toLowerCase() === "transparent"
+          ? "transparent"
+          : ea.getCM(canvasColor).alphaTo(opacity).stringHEX())
+        : ea.getCM(mdProps.backgroundColor).alphaTo((mdProps.backgroundOpacity??100)/100).stringHEX();
+      
+      color === "transparent" ? canvasNode?.addClass("transparent") : canvasNode?.removeClass("transparent");
+      canvasNode?.style.setProperty("--canvas-background", color);
+      canvasNode?.style.setProperty("--background-primary", color);
+      canvasNodeContainer?.style.setProperty("background-color", color);
+    }
+
+    if(mdProps.borderMatchElement) {
+      const opacity = (mdProps?.borderOpacity ?? 50)/100;
+      const color = element?.strokeColor
+        ? (element.strokeColor.toLowerCase() === "transparent"
+          ? "transparent"
+          : ea.getCM(element.strokeColor).alphaTo(opacity).stringHEX())
+        : "transparent";
+      canvasNode?.style.setProperty("--canvas-border", color);
+      canvasNode?.style.setProperty("--canvas-color", 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);
+      canvasNode?.style.setProperty("--canvas-color", color);
+      //canvasNodeContainer?.style.setProperty("border-color", color);
+    }
+  }
+
+  //--------------------------------------------------------------------------------
+  //Set colors of the canvas node
+  //--------------------------------------------------------------------------------
+  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,
+  ])
+
+  //--------------------------------------------------------------------------------
+  //Switch to preview mode when the iframe is not active
+  //--------------------------------------------------------------------------------
   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;
@@ -218,9 +328,9 @@ function RenderObsidianView(
   //--------------------------------------------------------------------------------
   //Switch to edit mode when markdown view is clicked
   //--------------------------------------------------------------------------------
-  const handleClick = react.useCallback((event: React.PointerEvent<HTMLElement>) => {
+  const handleClick = react.useCallback((event?: React.PointerEvent<HTMLElement>) => {
     if(isActiveRef.current) {
-      event.stopPropagation();
+      event?.stopPropagation();
     }
 
     if (isActiveRef.current && !isEditingRef.current && leafRef.current?.leaf) {
@@ -242,10 +352,28 @@ function RenderObsidianView(
         patchMobileView(view);
       } else if (leafRef.current?.node) {
         //Handle canvas node
-        view.canvasNodeFactory.startEditing(leafRef.current.node, theme);
+        const newTheme = getTheme(view, themeRef.current);
+        containerRef.current?.addClasses(["is-editing", "is-focused"]);
+        view.canvasNodeFactory.startEditing(leafRef.current.node, newTheme);
       }
     }
-  }, [leafRef.current?.leaf, element.id]);
+  }, [leafRef.current?.leaf, element.id, view, themeRef.current]);
+
+  if(leafRef.current)  leafRef.current.editNode = handleClick;
+  // Event listener for key press
+  react.useEffect(() => {
+    const handleKeyPress = (event: KeyboardEvent) => {
+      if (event.key === "Enter") {
+        handleClick(event); // Call handleClick function when Enter key is pressed
+      }
+    };
+
+    document.addEventListener("keydown", handleKeyPress); // Add event listener for key press
+
+    return () => {
+      document.removeEventListener("keydown", handleKeyPress); // Remove event listener when component unmounts
+    };
+  }, [handleClick]);
 
   //--------------------------------------------------------------------------------
   // Set isActiveRef and switch to preview mode when the iframe is not active
@@ -256,7 +384,7 @@ function RenderObsidianView(
     }
 
     const previousIsActive = isActiveRef.current;
-    isActiveRef.current = (appState.activeEmbeddable?.element.id === element.id) && (appState.activeEmbeddable?.state === "active");
+    isActiveRef.current = (activeEmbeddable?.element.id === element.id) && (activeEmbeddable?.state === "active");
 
     if (previousIsActive === isActiveRef.current) {
       return;
@@ -278,20 +406,17 @@ function RenderObsidianView(
       }  
     } else if (leafRef.current?.node) {
       //Handle canvas node
+      containerRef.current?.removeClasses(["is-editing", "is-focused"]);
       view.canvasNodeFactory.stopEditing(leafRef.current.node);
     }
   }, [
     containerRef,
     leafRef,
     isActiveRef,
-    appState.activeEmbeddable?.element,
-    appState.activeEmbeddable?.state,
+    activeEmbeddable?.element,
+    activeEmbeddable?.state,
     element,
     view,
-    linkText,
-    subpath,
-    file,
-    theme,
     isEditingRef,
     view.canvasNodeFactory
   ]);
@@ -299,17 +424,12 @@ function RenderObsidianView(
   return null;
 };
 
+
 export const CustomEmbeddable: React.FC<{element: NonDeletedExcalidrawElement; view: ExcalidrawView; appState: UIAppState; linkText: string}> = ({ element, view, appState, linkText }) => {
   const react = view.plugin.getPackage(view.ownerWindow).react;
   const containerRef: React.RefObject<HTMLDivElement> = react.useRef(null);
-  const theme = view.excalidrawData.embeddableTheme === "dark"
-    ? "theme-dark"
-    : view.excalidrawData.embeddableTheme === "light" 
-      ? "theme-light"
-      : view.excalidrawData.embeddableTheme === "auto"
-        ? appState.theme === "dark" ? "theme-dark" : "theme-light"
-        : isObsidianThemeDark() ? "theme-dark" : "theme-light";
-
+  const theme = getTheme(view, appState.theme);
+  const mdProps: EmbeddableMDCustomProps = element.customData?.mdProps || null;
   return (
     <div
       ref={containerRef}
@@ -319,15 +439,19 @@ export const CustomEmbeddable: React.FC<{element: NonDeletedExcalidrawElement; v
         borderRadius: "var(--embeddable-radius)",
         color: `var(--text-normal)`,
       }}
-      className={theme}
+      className={`${theme} canvas-node ${
+        mdProps?.filenameVisible && !mdProps.useObsidianDefaults ? "" : "excalidraw-mdEmbed-hideFilename"}`}
     >
       <RenderObsidianView
+        mdProps={mdProps}
         element={element}
         linkText={linkText}
         view={view}
         containerRef={containerRef}
-        appState={appState}
-        theme={theme}/>
+        activeEmbeddable={appState.activeEmbeddable}
+        theme={appState.theme}
+        canvasColor={appState.viewBackgroundColor}
+      />
     </div>
   )
 }

src/dialogs/EmbeddableMDFileCustomDataSettingsComponent.ts

@@ -0,0 +1,179 @@
+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,
+    private isMDFile: boolean = true,
+  ) { 
+    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
+    if(this.isMDFile) {
+      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 opacity 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();
+            })
+        );
+      
+      if(this.isMDFile) {
+        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,233 @@
+import { ExcalidrawEmbeddableElement } from "@zsviczian/excalidraw/types/excalidraw/element/types";
+import { Mutable } from "@zsviczian/excalidraw/types/excalidraw/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";
+import { isWinCTRLorMacCMD } from "src/utils/ModifierkeyHelper";
+import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/excalidraw/types";
+
+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 notExcalidrawIsInternal: boolean;
+  private isLocalURI: boolean;
+  private mdCustomData: EmbeddableMDCustomProps;
+  private onKeyDown: (ev: KeyboardEvent) => void;
+
+  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.notExcalidrawIsInternal = this.file && !this.view.plugin.isExcalidrawFile(this.file)
+    this.isMDFile = this.file && this.file.extension === "md"; // && !this.view.plugin.isExcalidrawFile(this.file);
+    this.isLocalURI = this.element.link.startsWith("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() {
+    this.containerEl.removeEventListener("keydown",this.onKeyDown);
+  }
+
+  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(`${t("ES_ZOOM_100_RELATIVE_DESC")}<br>Current zoom is <b>${Math.round(this.zoomValue*100)}%</b>`);
+    }
+
+    const zoomSetting = new Setting(this.contentEl)
+      .setName(t("ES_ZOOM"))
+      .setDesc(zoomValue())
+      .addButton(button =>
+        button
+          .setButtonText(t("ES_ZOOM_100"))
+          .onClick(() => {
+            const api = this.view.excalidrawAPI as ExcalidrawImperativeAPI;
+            this.zoomValue = 1/api.getAppState().zoom.value;
+            zoomSetting.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.notExcalidrawIsInternal) {
+      this.contentEl.createEl("h3",{text: t("ES_EMBEDDABLE_SETTINGS")});
+      new EmbeddalbeMDFileCustomDataSettingsComponent(this.contentEl,this.mdCustomData, undefined, this.isMDFile).render();
+    }
+  
+    new Setting(this.contentEl)
+    .addButton(button =>
+      button
+        .setButtonText(t("PROMPT_BUTTON_CANCEL"))
+        .setTooltip("ESC")
+        .onClick(() => {
+          this.close();
+        })
+    )
+    .addButton(button =>
+      button
+        .setButtonText(t("PROMPT_BUTTON_OK"))
+        .setTooltip("CTRL/Opt+Enter")
+        .setCta()
+        .onClick(()=>this.applySettings())
+    )
+
+
+    const onKeyDown = (ev: KeyboardEvent) => {
+      if(isWinCTRLorMacCMD(ev) && ev.key === "Enter") {
+        this.applySettings();
+      }
+    }
+
+    this.onKeyDown = onKeyDown;
+    this.containerEl.ownerDocument.addEventListener("keydown",onKeyDown);
+  }
+
+ 
+
+  private async applySettings() {
+    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.filename,
+          fnparts.folderpath,
+        );
+        if(this.app.vault.getAbstractFileByPath(newPath)) {
+          new Notice("File rename failed. A file with this name already exists.\n"+newPath,10000);
+        } else {
+          try {
+            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;
+          } catch(e) {
+            new Notice("File rename failed. "+e,10000);
+          }
+        }
+      }
+    }
+    if(this.isYouTube && this.youtubeStart !== getYouTubeStartAt(this.element.link)) {
+      dirty = true;
+      if(this.youtubeStart === "" || 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) {
+      (async() => {
+        await this.ea.addElementsToView();
+        //@ts-ignore
+        this.ea.viewUpdateScene({appState: {}});
+      })();
+
+    }
+    this.close();
+  };
+}
+

src/dialogs/ExportDialog.ts

@@ -1,11 +1,11 @@
-import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/types";
+import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/excalidraw/types";
 import { Modal, Setting, TFile } from "obsidian";
 import { getEA } from "src";
-import { DEVICE } from "src/constants";
+import { DEVICE } from "src/constants/constants";
 import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
 import ExcalidrawView from "src/ExcalidrawView";
 import ExcalidrawPlugin from "src/main";
-import { fragWithHTML, getExportPadding, getExportTheme, getPNGScale, getWithBackground } from "src/utils/Utils";
+import { fragWithHTML, getExportPadding, getExportTheme, getPNGScale, getWithBackground, shouldEmbedScene } from "src/utils/Utils";
 
 export class ExportDialog extends Modal {
   private ea: ExcalidrawAutomate;
@@ -40,7 +40,7 @@ export class ExportDialog extends Modal {
     this.scale = getPNGScale(this.plugin,this.file)
     this.theme = getExportTheme(this.plugin, this.file, (this.api).getAppState().theme)
     this.boundingBox = this.ea.getBoundingBox(this.ea.getViewElements());
-    this.embedScene = false;
+    this.embedScene = shouldEmbedScene(this.plugin, this.file);
     this.exportSelectedOnly = false;
     this.saveToVault = true;
     this.transparent = !getWithBackground(this.plugin, this.file);

src/dialogs/ImportSVGDialog.ts

@@ -1,8 +1,10 @@
 import { App, FuzzySuggestModal, TFile } from "obsidian";
-import { REG_LINKINDEX_INVALIDCHARS } from "../constants";
+import { REG_LINKINDEX_INVALIDCHARS } from "../constants/constants";
 import ExcalidrawView from "../ExcalidrawView";
 import { t } from "../lang/helpers";
 import ExcalidrawPlugin from "../main";
+import { getEA } from "src";
+import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
 
 export class ImportSVGDialog extends FuzzySuggestModal<TFile> {
   public app: App;
@@ -38,12 +40,11 @@ export class ImportSVGDialog extends FuzzySuggestModal<TFile> {
 
   async onChooseItem(item: TFile, event: KeyboardEvent): Promise<void> {
     if(!item) return;
-    const ea = this.plugin.ea;
-    ea.reset();
-    ea.setView(this.view);
+    const ea = getEA(this.view) as ExcalidrawAutomate;
     const svg = await app.vault.read(item);
     if(!svg || svg === "") return;
     ea.importSVG(svg);
+    ea.addToGroup(ea.getElements().map(el=>el.id));
     ea.addElementsToView(true, true, true,true);
   }
 

src/dialogs/InsertCommandDialog.ts

@@ -0,0 +1,41 @@
+import { App, FuzzySuggestModal, TFile } from "obsidian";
+import { REG_LINKINDEX_INVALIDCHARS } from "../constants/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,7 +1,6 @@
 import { App, FuzzySuggestModal, TFile } from "obsidian";
-import { isALT, scaleToFullsizeModifier } from "src/utils/ModifierkeyHelper";
-import { fileURLToPath } from "url";
-import { DEVICE, IMAGE_TYPES, REG_LINKINDEX_INVALIDCHARS } from "../constants";
+import { scaleToFullsizeModifier } from "src/utils/ModifierkeyHelper";
+import { DEVICE, IMAGE_TYPES, REG_LINKINDEX_INVALIDCHARS } from "../constants/constants";
 import ExcalidrawView from "../ExcalidrawView";
 import { t } from "../lang/helpers";
 import ExcalidrawPlugin from "../main";
@@ -60,6 +59,7 @@ export class InsertImageDialog extends FuzzySuggestModal<TFile> {
     ea.canvas.theme = this.view.excalidrawAPI.getAppState().theme;
     const scaleToFullsize = scaleToFullsizeModifier(event);
     (async () => {
+      //this.view.currentPosition = this.position;
       await ea.addImage(0, 0, item, !scaleToFullsize);
       ea.addElementsToView(true, true, true);
     })();

src/dialogs/InsertLinkDialog.ts

@@ -1,15 +1,17 @@
 import { App, FuzzySuggestModal, TFile } from "obsidian";
-import { REG_LINKINDEX_INVALIDCHARS } from "../constants";
+import { REG_LINKINDEX_INVALIDCHARS } from "../constants/constants";
 import { t } from "../lang/helpers";
+import ExcalidrawPlugin from "src/main";
+import { getLink } from "src/utils/FileUtils";
 
 export class InsertLinkDialog extends FuzzySuggestModal<TFile> {
   public app: App;
   private addText: Function;
   private drawingPath: string;
 
-  constructor(app: App) {
-    super(app);
-    this.app = app;
+  constructor(private plugin: ExcalidrawPlugin) {
+    super(plugin.app);
+    this.app = plugin.app;
     this.limit = 20;
     this.setInstructions([
       {
@@ -45,7 +47,8 @@ export class InsertLinkDialog extends FuzzySuggestModal<TFile> {
         true,
       );
     }
-    this.addText(`[[${filepath + (item.alias ? `|${item.alias}` : "")}]]`);
+    const link = getLink(this.plugin,{embed: false, path: filepath, alias: item.alias});
+    this.addText(getLink(this.plugin,{embed: false, path: filepath, alias: item.alias}), filepath, item.alias);
   }
 
   public start(drawingPath: string, addText: Function) {

src/dialogs/InsertPDFModal.ts

@@ -6,12 +6,15 @@ 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";
+import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/excalidraw/types";
 
 export class InsertPDFModal extends Modal {
   private borderBox: boolean = true;
   private gapSize:number = 20;
+  private groupPages: boolean = false;
+  private direction: "down" | "right" = "right";
   private numColumns: number = 1;
+  private numRows: number = 1;
   private lockAfterImport: boolean = true;
   private pagesToImport:number[] = [];
   private pageDimensions: {width: number, height: number} = {width: 0, height: 0};
@@ -21,7 +24,6 @@ export class InsertPDFModal extends Modal {
   private pdfFile: TFile;
   private dirty: boolean = false;
 
-
   constructor(
     private plugin: ExcalidrawPlugin,
     private view: ExcalidrawView,
@@ -47,7 +49,10 @@ export class InsertPDFModal extends Modal {
       this.plugin.settings.pdfImportScale = this.importScale;
       this.plugin.settings.pdfBorderBox = this.borderBox;
       this.plugin.settings.pdfGapSize = this.gapSize;
+      this.plugin.settings.pdfGroupPages = this.groupPages;
       this.plugin.settings.pdfNumColumns = this.numColumns;
+      this.plugin.settings.pdfNumRows = this.numRows;
+      this.plugin.settings.pdfDirection = this.direction;
       this.plugin.settings.pdfLockAfterImport = this.lockAfterImport;
       this.plugin.saveSettings();
     }
@@ -111,7 +116,10 @@ export class InsertPDFModal extends Modal {
     await this.plugin.loadSettings();
     this.borderBox = this.plugin.settings.pdfBorderBox;
     this.gapSize = this.plugin.settings.pdfGapSize;
+    this.groupPages = this.plugin.settings.pdfGroupPages;
     this.numColumns = this.plugin.settings.pdfNumColumns;
+    this.numRows = this.plugin.settings.pdfNumRows;
+    this.direction = this.plugin.settings.pdfDirection;
     this.lockAfterImport = this.plugin.settings.pdfLockAfterImport;
     this.importScale = this.plugin.settings.pdfImportScale;
 
@@ -154,6 +162,19 @@ export class InsertPDFModal extends Modal {
       numPagesMessage.innerHTML = `There are <b>${numPages}</b> pages in the selected document.`;
     }
 
+    let pageRangesTextComponent: TextComponent
+    let importPagesMessage: HTMLParagraphElement;
+
+    const rangeOnChange = (value:string) => {
+      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();
+    }
+
     const setFile = async (file: TFile) => {
       if(this.pdfDoc) await this.pdfDoc.destroy();
       this.pdfDoc = null;
@@ -163,6 +184,8 @@ export class InsertPDFModal extends Modal {
         this.pdfFile = file;
         if(this.pdfDoc) {
           numPages = this.pdfDoc.numPages;
+          pageRangesTextComponent.setValue(`1-${numPages}`);
+          rangeOnChange(`1-${numPages}`);
           importButtonMessages();
           numPagesMessages();
           this.getPageDimensions(this.pdfDoc);
@@ -182,23 +205,14 @@ export class InsertPDFModal extends Modal {
     
     numPagesMessage = ce.createEl("p", {text: ""});
     numPagesMessages();
-    let importPagesMessage: HTMLParagraphElement;
-    let pageRangesTextComponent: TextComponent
     new Setting(ce)
       .setName("Pages to import")
+      .setDesc("e.g.: 1,3-5,7,9-10")
       .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();
-          })
+          .setValue("")
+          .onChange((value) => rangeOnChange(value))
         text.inputEl.style.width = "100%";
       })
     importPagesMessage = ce.createEl("p", {text: ""});
@@ -211,7 +225,18 @@ export class InsertPDFModal extends Modal {
           this.borderBox = value;
           this.dirty = true;
         }))
-    
+
+    new Setting(ce)
+      .setName("Group pages")
+      .setDesc("This will group all pages into a single group. This is recommended if you are locking the pages after import, because the group will be easier to unlock later rather than unlocking one by one.")
+      .addToggle(toggle => toggle
+        .setValue(this.groupPages)
+        .onChange((value) => {
+          this.groupPages = value
+          this.dirty = true;
+        }))
+  
+        
     new Setting(ce)
       .setName("Lock pages on canvas after import")
       .addToggle(toggle => toggle
@@ -221,8 +246,38 @@ export class InsertPDFModal extends Modal {
           this.dirty = true;
         }))
 
-    let columnsText: HTMLDivElement;
+    let numColumnsSetting: Setting;
+    let numRowsSetting: Setting;
+    const colRowVisibility = () => {
+      switch(this.direction) {
+        case "down":
+          numColumnsSetting.settingEl.style.display = "none";
+          numRowsSetting.settingEl.style.display = "";
+          break;
+        case "right":
+          numColumnsSetting.settingEl.style.display = "";
+          numRowsSetting.settingEl.style.display = "none";
+          break;
+      }
+    }
+    
     new Setting(ce)
+      .setName("Import direction")
+      .addDropdown(dropdown => dropdown
+        .addOptions({
+          "down": "Top > Down",
+          "right": "Left > Right"
+        })
+        .setValue(this.direction)
+        .onChange(value => {
+          this.direction = value as "down" | "right";
+          colRowVisibility();
+          this.dirty = true;
+        }))
+
+    let columnsText: HTMLDivElement;
+    numColumnsSetting = new Setting(ce);
+    numColumnsSetting
       .setName("Number of columns")
       .addSlider(slider => slider
         .setLimits(1, 100, 1)
@@ -239,6 +294,26 @@ export class InsertPDFModal extends Modal {
         el.innerText = ` ${this.numColumns.toString()}`;
       });
 
+    let rowsText: HTMLDivElement;
+    numRowsSetting = new Setting(ce);
+    numRowsSetting
+      .setName("Number of rows")
+      .addSlider(slider => slider
+        .setLimits(1, 100, 1)
+        .setValue(this.numRows)
+        .onChange(value => {
+          this.numRows = value;
+          rowsText.innerText = ` ${value.toString()}`;
+          this.dirty = true;
+        }))
+      .settingEl.createDiv("", (el) => {
+        rowsText = el;
+        el.style.minWidth = "2.3em";
+        el.style.textAlign = "right";
+        el.innerText = ` ${this.numRows.toString()}`;
+      });
+    colRowVisibility();
+
     let gapSizeText: HTMLDivElement;
     new Setting(ce)
       .setName("Size of gap between pages")
@@ -256,7 +331,7 @@ export class InsertPDFModal extends Modal {
         el.style.textAlign = "right";
         el.innerText = ` ${this.gapSize.toString()}`;
       });
-  
+
     const importSizeSetting = new Setting(ce)
       .setName("Imported page size")
       .setDesc(`${this.pageDimensions.width*this.importScale} x ${this.pageDimensions.height*this.importScale}`)
@@ -303,6 +378,7 @@ export class InsertPDFModal extends Modal {
                 topX,
                 topY,
                 this.pdfFile.path + `#page=${page}`,
+                false,
                 false);
               const imgEl = ea.getElement(imageID) as any;
               imgEl.width = imgWidth;
@@ -310,9 +386,21 @@ export class InsertPDFModal extends Modal {
               if(this.lockAfterImport) imgEl.locked = true;
 
               ea.addToGroup([boxID,imageID]);
-
-              column = (column + 1) % this.numColumns;
-              if(column === 0) row++;
+              
+              switch(this.direction) {
+                case "right":
+                  column = (column + 1) % this.numColumns;
+                  if(column === 0) row++;
+                  break;
+                case "down":
+                  row = (row + 1) % this.numRows;
+                  if(row === 0) column++;
+                  break;
+              }
+            }
+            if(this.groupPages) {
+              const ids = ea.getElements().map(el => el.id);
+              ea.addToGroup(ids);
             }
             await ea.addElementsToView(true,true,false);
             const api = ea.getExcalidrawAPI() as ExcalidrawImperativeAPI;

src/dialogs/Messages.ts

@@ -6,7 +6,7 @@ If you'd like to learn more, please subscribe to my YouTube channel: [Visual PKM
 Thank you & Enjoy!
 
 <div class="excalidraw-videoWrapper"><div>
-<iframe src="https://www.youtube.com/embed/o0exK-xFP3k" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+<iframe src="https://www.youtube.com/embed/P_Q6avJGoWI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 </div></div>
 `;
 
@@ -17,6 +17,865 @@ 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.2.7": `
+## New
+- In Miscellaneous Settings: added **Load Excalidraw Properties into Obsidian Suggester**. This setting toggles the automatic loading of Excalidraw properties at startup. Enabled by default for easy use of front matter properties. Disabling it prevents auto-loading, but you'll need to manually remove unwanted properties using Obsidian properties view. A plugin restart is required after enabling auto-loading.
+
+## Fixed
+- Zotero support [1835](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1835)
+- Lines binding to elements and selections [#8146](https://github.com/excalidraw/excalidraw/issues/8146), and plugin getting stuck with dragging an element [#8131](https://github.com/excalidraw/excalidraw/issues/8131)`
+,
+"2.2.6": `
+## Fixed
+- CTRL+F search for text elements in drawing, the result did not get selected. This was a regression in 2.2.5 [#1822](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1822)
+
+## New
+- Zotero compatibility support for back-of-the-side markdown notes. This needs to be enabled in plugin settings under Compatibility [#1820](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1820)
+
+## New from Excalidraw.com
+- ${String.fromCharCode(96)}Stats & Element Properties${String.fromCharCode(96)}, accessible via the context menu, is now editable, e.g. you can type in the exact position and size of objects, change font size and set element angle.
+- Pasting mermaid diagrams from chatGPT will embed a diagram instead of the text
+`,
+"2.2.5": `
+## Fixed
+- Cursor visibility in dark mode [#1812](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1812)
+- SVG to Excalidraw now...
+  - converts elements inside the ${String.fromCharCode(96)}<switch>${String.fromCharCode(96)} tag, improving compatibility with SVGs from [The Noun Project](https://thenounproject.com/)
+  - sets visibility for all elements, preventing invisible converted images.
+- Cached images sometimes lost their font face and natural size when nested in an Excalidraw scene. This issue occurred when drawings were embedded in a markdown note (native SVG) and nested in a drawing simultaneously. Depending on the update and render sequence, these drawings sometimes appeared incorrectly in the Excalidraw scene.
+`,
+"2.2.4":`
+<div style="text-align: center;">
+  <a data-tooltip-position="top" aria-label="https://youtube.com/shorts/zF1p2yfk4f4" rel="noopener" class="external-link" href="https://youtube.com/shorts/zF1p2yfk4f4" target="_blank">
+    <img src="https://private-user-images.githubusercontent.com/14358394/335857018-c4f5c4c7-9b8f-427f-aa6f-8c1b189610af.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTczMjQxNDksIm5iZiI6MTcxNzMyMzg0OSwicGF0aCI6Ii8xNDM1ODM5NC8zMzU4NTcwMTgtYzRmNWM0YzctOWI4Zi00MjdmLWFhNmYtOGMxYjE4OTYxMGFmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA2MDIlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNjAyVDEwMjQwOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdhZGUwNDRkZmM2NmJjNTNiYjUwNjMxMmU2MGEyZTQwZGQwNmUyZmI5ZDFhNzMwMzg2OThjMjhmZmJkNzNiZDkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.wZfkXmBRcXwz0pN6q0EEvmwtxVAB9ymPk9a9upmGXYE" referrerpolicy="no-referrer" style="width: 150px; margin: 0 auto;">
+  </a>
+</div>
+
+## New from Excalidraw.com
+-  You can now set the text width even during creation. Simply drag with the text tool. Note, there's a minimum distance before the text enters the wrapped mode so there aren't false positives. [See example here](https://x.com/excalidraw/status/1795468201335075000)
+
+## New
+- Updated zh-cn translation. Thank you @dmscode 
+- New context menu and command palette action: "Move back-of-note card to File". This is only active when an eligible embeddable element is selected.
+
+## Fixed
+- Setting different autosaveIntervals on Desktop and Mobile will no longer trigger unnecessary commits to settings each time you open Excalidraw on a different device. Thanks @jmhammond for the contribution! [#1805](https://github.com/zsviczian/obsidian-excalidraw-plugin/pull/1805), [#1652](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1652), [#888](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/888)
+
+## Fixed in ExcalidrawAutomate
+- ${String.fromCharCode(96)}getCM(color)${String.fromCharCode(96)} was missing from ${String.fromCharCode(96)}ea.help()${String.fromCharCode(96)}. It is now added. getCM returns a ColorMaster object. ColorMaster is a powerful library should you want to create scripts to manipulate colors. Check out my [Scripting Colors](https://youtu.be/7gJDwNgQ6NU) video should you want to learn more. [#1806](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1806)
+`,
+"2.2.3":`
+## Fixed
+-  Undo history was not properly initialized [#1791](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1785)
+- Excalidraw did not save edits when switching to markdown view mode with a hotkey or terminating the popout window
+- SVG export did not maintain the aspect ratio of manually distorted images [#1780](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1780)
+
+## New
+- In pen mode, double tapping the screen will toggle the eraser tool when using freedraw tool, or one of the other tools in locked mode.
+- New setting under "Excalidraw appearance and behavior" to disable rendering of Excalidraw drawings in hover previews, in case the file has the ${String.fromCharCode(96)}excalidraw-open-md: true${String.fromCharCode(96)} frontmatter property [#1795](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1795)
+- Additional foolproofing of ${String.fromCharCode(96)}# Excalidraw Data${String.fromCharCode(96)}. The file is now more resilient to automated linting and other changes. There is also a new setting under "Compatibility Features" to add a dummy first text element to ${String.fromCharCode(96)}## Text Elements${String.fromCharCode(96)}. You can use this feature if your auto-linter adds empty lines after section headings.
+- Pasting markdown code blocks will create a back-of-the-note card with the code block. CTRL+SHIFT+V will paste the text as a normal text element. When copying code from Chat GPT the markdown code fence (triple backtick) is missing. In this case, you may use the new context menu action "Paste code block" to create a back of the note card with the code block.
+- Pasting long text will be wrapped in the text element.
+
+## New in ExcalidrawAutomate
+- Updated viewUpdateScene: This now implements the [new Excalidraw API](https://github.com/excalidraw/excalidraw/pull/7898)
+${String.fromCharCode(96, 96, 96)}ts
+  viewUpdateScene (
+    scene: {
+      elements?: ExcalidrawElement[],
+      appState?: AppState,
+      files?: BinaryFileData,
+      commitToHistory?: boolean,
+      storeAction?: "capture" | "none" | "update",
+    },
+    restore: boolean = false,
+  ):void ;
+  ${String.fromCharCode(96, 96, 96)}
+- Updated addText. The function now supports the new text-wrapping feature
+${String.fromCharCode(96, 96, 96)}ts
+  addText(
+    topX: number,
+    topY: number,
+    text: string,
+    formatting?: {
+      autoResize?: boolean; //Default is true. Setting this to false will wrap the text in the text element without the need for the container. If set to false, you must set a width value as well.
+      wrapAt?: number; //wrapAt is ignored if autoResize is set to false (and width is provided)
+      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)}
+  `,
+"2.2.2":`
+## Fixed
+- ExcaliBrain stopped working with 2.2.0
+
+![I apologize](https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/3b05aa28-788d-4329-9721-798ad58a6ca2)
+`,
+"2.2.1":`
+## Fixed
+- Text height becomes unreadable after 2.2.0 update [#1784](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1784)
+- Images are loaded with a rounded border when loading old Excalidraw files
+- Embedded Excalidraw images cache gets stuck with old version of the image
+- Extremely long loading times with legacy (3+ years old) Excalidraw files
+`,
+"2.2.0":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/dV0NEOwn5NM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+⚠️⚠️⚠️ BREAKING CHANGE ⚠️⚠️⚠️
+Files you save with 2.2.0 are not backward compatible with earlier plugin versions!
+
+## New from excalidraw.com
+- Wrapable text elements (without the need for transparent sticky notes!)
+
+## New
+- File format. I nested all Excalidraw markup under ${String.fromCharCode(96)}# Excalidraw Data${String.fromCharCode(96)}.  Here's the new structure.
+${String.fromCharCode(96,96,96)}markdown
+---
+excalidraw-plugin: parsed
+other-frontmatter-properties: values
+---
+back of the note bla bla bla
+
+# Excalidraw Data
+## Text Element
+## Element Links
+## Embedded Files
+%%
+## Drawing
+%%
+${String.fromCharCode(96,96,96)}
+- When opening Excalidraw in Markdown ${String.fromCharCode(96)}# Excalidraw Data${String.fromCharCode(96)} will be folded.
+- New command palette action: ${String.fromCharCode(96)}Open the back-of-the-note of the selected Excalidraw image${String.fromCharCode(96)}. The action is only visible when selecting an embedded Excalidraw drawing in the Scene. On a desktop, the command will open the back of the selected card in a popout window, and on a mobile, in a new tab.
+
+## Fixed
+- Drag and drop from Finder/Explorer (OS external). Images will retain their filenames. PDFs will be imported to the Vault. [#1779](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1779)
+`,
+"2.1.8":`
+## Fixed
+- Fixing issues that surfaced after upgrading to Obsidian 1.6.0
+  - Fixed Excalidraw hover previews
+  - Cursor for editing links, text elements, and frame names became virtually invisible if Obsidian was in dark mode and Excalidraw in light mode and vica versa.
+  - Rendering Excalidraw drawings in Markdown views, right after Obsidian loaded did not work.
+- I implemented more graceful fail if you submitted a malformed SVG for SVG to Excalidraw conversation. [#1768](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1768)
+
+## New
+- New setting under "Save" in plugin settings to NOT decompress JSON when switching to Markdown view mode. For details see description under "Save" settings. The benefit is smaller file size and fewer results in the Obsidian search. If you want to edit the JSON, you can always manually decompress JSON in markdown view mode with the command palette action "Excalidraw: Decompress JSON".
+`,
+"2.1.7:":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/P_Q6avJGoWI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## Updates from Excalidraw.com
+- Improved undo management.
+- Improved handle to scale images from the side.
+- Changed arrow binding behavior.
+- Many other minor fixes and improvements.
+
+## New
+- Introduced image caching for nested (embedded) Excalidraw drawings on the scene. This enhancement should lead to improved scene loading times, especially when dealing with numerous embedded Excalidraw drawings.
+- Added new OCR Command Palette actions. Users can now re-run OCR and run OCR for selected elements.
+
+## Fixed
+- Fixed an issue where cropping an embeddable PDF frame in the Excalidraw Scene caused distortion based on the embeddable element's aspect ratio. ([#1756](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1756))
+- Removed the listing of ${String.fromCharCode(96)}# Embedded files${String.fromCharCode(96)} section when adding a "Back of the note card". ([#1754](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1754))
+- Resolved the issue where closing the on-screen keyboard with the keyboard hide button of your phone, instead of tapping somewhere else on the Excalidraw scene, did not resize the scene correctly. ([#1729](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1729))
+- Fixed the problem where pasting a text element as text into markdown incorrectly pasted the text to the end of the MD note, with line breaks as rendered on screen in Excalidraw. Also addressed the issue where pasting an image element as an image resulted in it being pasted to the end of the document. ([#1749](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1749))
+- Corrected the color inversion of embedded images when changing the theme from light to dark, then back from dark to light, and again from light to dark on the third change.
+- Addressed the problem where cropping an image while unlocking and rotating it in the cropper did not reflect the rotation. Note that rotating the image in Cropper required switching to markdown view mode, changing the "locked": true property to false, then switching back to Excalidraw mode. This issue likely impacted only a very few power users. ([#1745](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1745))
+
+## New in ExcalidrawAutomate
+${String.fromCharCode(96,96,96)}ts
+/**
+   * Retruns the embedded images in the scene recursively. If excalidrawFile is not provided, 
+   * the function will use ea.targetView.file
+   * @param excalidrawFile 
+   * @returns TFile[] of all nested images and Excalidraw drawings recursively
+   */
+  public getEmbeddedImagesFiletree(excalidrawFile?: TFile): TFile[];
+${String.fromCharCode(96,96,96)}
+
+`,
+"2.1.6":`
+## Two minor fixes
+- Scaling of LaTeX formulas when the formula is changed
+- If the back of the note card only contains a block embed ${String.fromCharCode(96)}![[embed]]${String.fromCharCode(96)} this got removed when saving the Excalidraw file. This issue has been present since November, 2021 (v1.4.9).
+`,
+"2.1.5":`
+## New
+- Save "Snap to objects" with the scene state. If this is the only change you make to the scene, force save it using CTRL+S (note, use CTRL on Mac as well).
+- Added "Copy markdown link" to the context menu.
+
+## Fixed
+- Paste operation occasionally duplicated text elements.
+- Pasting multiple instances of the same image from excalidraw.com or another instance of Obsidian, or pasting an image from anywhere and making copies with ALT/OPT + drag immediately after pasting (before autosave triggered) led to broken images when reopening the drawing.
+- CTRL/CMD+Click on a Text Element with an element link did not work (previously, you had to click the top right link indicator). Now, you can click anywhere on the element.
+- Hover preview for elements with a link only worked when hovering over the element link. Now, you can hover anywhere. If there are multiple elements with links, the top-level element will take precedence.
+- Link navigation within drawing when the "Focus on Existing Tab" feature is enabled under "Links, transclusion and TODOs" in settings works again.
+- If a link points to a back-of-the-card section or block the drawing will automatically switch to markdown view mode and navigate to the block or section.
+- DynamicSytle, dark mode when canvas background is set to transparent.
+- Scale to maintain the aspect ratio of a markdown notes embedded as images.
+- You can now borrow interactive markdown embeds to tables, blockquotes, list elements and callouts - not just paragraphs.
+- Back of the drawing cards:
+    - Leaving the Section Name empty when creating the first back of the card note resulted in an error.
+    - If you add the markdown comment (${String.fromCharCode(96)}%%${String.fromCharCode(96)}) directly before ${String.fromCharCode(96)}# Text Elements${String.fromCharCode(96)}, a trailing ${String.fromCharCode(96)}#${String.fromCharCode(96)} will be added to your document, when adding a back of the card note. This is to hide the markdown comment from the card. The trailing (empty) ${String.fromCharCode(96)}#${String.fromCharCode(96)} will not be visible in reading mode, pdf exports, and when publishing with Obsidian Publish.
+Here's a sample markdown structure of your document:
+
+${String.fromCharCode(96,96,96)}markdown
+---
+excalidraw-plugin: parsed
+---
+# Your back of the card section
+bla bla bla
+
+#
+%%
+# Text Elements
+... the rest of the Excalidraw file
+${String.fromCharCode(96,96,96)}
+`,
+"2.1.4":`
+## Fixed
+- Fixed the **aspect ratio** of an Excalidraw embedded within another Excalidraw **not updating**. [#1707](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1707)
+- Some plugins automatically add document properties to all files in the Vault. Users with this configuration were **unable to run Excalidraw scripts**. Excalidraw now removes document properties from the script before execution.
+- The very last markdown edit sometimes **wasn't saved when immediately switching from Markdown to Excalidraw View**. I now force a save before switching views. 
+- The setting to disable/enable ${String.fromCharCode(96)}CTRL/CMD + CLICK on text with [[links]] or [](links) to open them${String.fromCharCode(96)} works again. [#1704](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1704)
+- **Annotation and cropping** of images in Markdown notes now also work **with Markdown links that have encoded characters** e.g.: ${String.fromCharCode(96)}![images with](markdown%20links)${String.fromCharCode(96)}.
+- Solved compatibility issue of **Taskbone OCR on Android**.
+
+## New
+- New settings:
+  - Under "Appearance and Behavior": Option to **render Excalidraw file as an image in Markdown reading mode**. This setting is disabled by default. [#1706](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1706), [#1705](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1705)
+  - Under "Embedding Excalidraw ... and Exporting"/"Export Settings": Option to **render Excalidraw file as an image when exporting to PDF** in Markdown mode. This option is disabled by default. When enabled, exporting an Excalidraw drawing in markdown view mode to PDF will render the image on the page.
+- **Enhanced annotation and cropping** of images in Markdown documents:
+  - Newly embedded **links will now follow the style of the original link**. If the original format was a ${String.fromCharCode(96)}![markdown](link)${String.fromCharCode(96)}, the annotated file will follow this format. For ${String.fromCharCode(96)}[[wiki links]]${String.fromCharCode(96)}, it will follow that style. Additionally, if an alias was specified like ${String.fromCharCode(96)}[[link|alias]]${String.fromCharCode(96)}, the annotated or cropped image will retain the alias.
+  - Introduced a new setting under "Saving" titled **"Preserve image size when annotating"**. This setting is disabled by default. When enabled, the embed link replacing the annotated image will maintain the size of the original image.
+- Option to **automatically embed the scene in exported PNG and SVG image files**. Including the scene will allow users to open the picture on Excalidraw.com or in another Obsidian Vault as an editable Excalidraw file.New setting is under the Export category. The new frontmatter tag is: ${String.fromCharCode(96)}excalidraw-export-embed-scene: true/false${String.fromCharCode(96)}.
+`,
+"2.1.3":`
+This is a republish of 2.1.2 with a minor change. Sorry about the frequent releases. I will hold back for a few weeks now.
+`,
+"2.1.2":`
+## Quality of Life Improvements
+- The "Insert Any File" option that disappeared from the Command Palette is now restored. [#1690](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1690)
+- Improved two-finger pan speed.
+- Fixed text wrapping issue that caused text to jump around when editing text in a sticky note when the Obsidian zoom level was not set to 100%.
+- Mask Generation in [ExcaliAI](https://youtu.be/3G8hsV-V-gQ) Edit Image now works properly again. [#1684](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1684)
+- Fixed aspect ratio change for .jpg, .png, .bmp, .webp, .SVG (non-Excalidraw) images. Previously, if the image was distorted (i.e. you held SHIFT while resizing it), it would revert to the original aspect ratio upon saving the drawing. Resetting the aspect ratio is the desired behavior for nested Excalidraw drawings since you might have changed the source image and want it to still display with the correct aspect ratio, however for other image files, the behavior is not desired. [#1698](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1698)
+- The command palette action "Set selected image element size to 100% of original" now works even on freshly pasted images, not just after saving the drawing. ([#1695](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1698))
+- If a text element has an element link (CTRL/CMD+K), but the link was not reflected in the Element Text, then CTRL/CMD+clicking the text element did not navigate to the link, only clicking the link indicator did. Now you can also CTRL/CMD click anywhere on the text element and it will navigate. Note, however, that links in the text element text take precedence over element links.
+`,
+"2.1.1":`
+## Fixed
+- Printing a markdown page that has an Excalidraw drawing on the back side, resulted in an empty PDF. This is now resolved.
+
+## New
+- Reduce the visual clutter by fading out the Excalidraw markup in markdown view mode. This feature needs to be enabled in plugin settings. You'll find the setting under ${String.fromCharCode(96)}Miscellaneous features${String.fromCharCode(96)}. Look for ${String.fromCharCode(96)}Fade out Excalidraw markup${String.fromCharCode(96)}. Depending on the location of the markdown comment ${String.fromCharCode(96)}%%${String.fromCharCode(96)}, if the comment starts before ${String.fromCharCode(96)}# Text Elements${String.fromCharCode(96)} then the fading will start from ${String.fromCharCode(96)}# Text Elements${String.fromCharCode(96)}, if the comment is before ${String.fromCharCode(96)}# Drawing${String.fromCharCode(96)} then the fading will only start with "drawing". If you delete the opening ${String.fromCharCode(96)}%%${String.fromCharCode(96)} the markup will be visible. Note, that if you place the comment before ${String.fromCharCode(96)}#Text Elements${String.fromCharCode(96)}, you will not be able to reference blocks in the ${String.fromCharCode(96)}# Text Elements${String.fromCharCode(96)} section, because Obsidian does not index blocks within comment blocks. Image references are not effective, they will work.
+
+<img src="https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/bb96cdb4-8c5f-4dc5-ad39-7fccee6d5cac" referrerpolicy="no-referrer" style="width: 150px; margin: 0 auto;">
+<img src="https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/e627fdb7-6820-4d7d-97f9-a030016be9aa" referrerpolicy="no-referrer" style="width: 100%; margin: 0 auto;">
+`,
+"2.1.0":`
+Bumping the version to 2.1.0 due to minor file format changes that aren't backward compatible. Essentially, 2.0.26 is already not backward compatible, but I forgot to update the version number.
+
+If you haven't watched the [walkthrough video](https://youtu.be/tHUcD4rWIuY) for 2.0.26, I recommend you do so.
+
+## New
+- Settings under ${String.fromCharCode(96)}Excalidraw Appearance and Behavior${String.fromCharCode(96)}
+  - Configure visibility of the crosshair cursor when using the pen tool. [#1673](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1673)
+  - Set the time delay for long press to open drawings from markdown under "Link Click and Modifier Keys".
+
+## 
+`,
+"2.0.26":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/tHUcD4rWIuY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New
+- Minor updates from [Excalidraw.com](https://excalidraw.com). The key change is text measurements that should result in consistent text sizing between desktop and mobile devices.
+- Now you can embed the markdown section of an Excalidraw note to your drawing. Simply select ${String.fromCharCode(96)}Insert ANY file${String.fromCharCode(96)}, choose the drawing, and select the relevant heading section to embed.
+  - This also works with "back-of-the-drawing" markdown sections. Use the context menu ${String.fromCharCode(96)}Add back-of-note Card${String.fromCharCode(96)}. The action is also available on the Command Palette and in the Excalidraw-Obsidian Tools Panel.
+- Editing an embedded markdown note is now easier. Just press Enter when the element is selected. [#1650](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1650)
+- The crosshair cursor is now hidden when the freedraw tool is active and using a pen. [#1659](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1659)
+- ${String.fromCharCode(96)}Convert markdown note to Excalidraw Drawing${String.fromCharCode(96)} now converts an existing markdown note (not just empty notes) into a drawing. The original markdown note will be on the "back side of the drawing".
+- Introducing ${String.fromCharCode(96)}Annotate image in Excalidraw${String.fromCharCode(96)}, which works very similarly to ${String.fromCharCode(96)}Crop and mask image${String.fromCharCode(96)}. You can replace an image in a markdown note or on the Obsidian Canvas with an Excalidraw drawing containing that image. You will be able to annotate the image in Excalidraw.
+- Now you can reference frames in images embedded in markdown and canvas with frame names e.g. ${String.fromCharCode(96)}![[drawing#^frame=Frame 01]]${String.fromCharCode(96)}
+- Excalidraw file format change:
+  - New frontmatter switch ${String.fromCharCode(96)}excalidraw-open-md${String.fromCharCode(96)}: If set to true, the file by default will open as a markdown file. You can switch to Excalidraw View Mode via the command palette action or by right-clicking the tab.
+  - Easter Egg: If you add a comment in front of ${String.fromCharCode(96)}# Text Elements${String.fromCharCode(96)}, then the entire Excalidraw data: markdown and JSON will be commented out, thus invisible when exporting to the web. If you remove the comment from before ${String.fromCharCode(96)}# Text Elements${String.fromCharCode(96)}, then only the JSON will be commented out.
+
+Before:
+${String.fromCharCode(96,96,96)}markdown
+#1657 
+%%
+# Text Elements
+...
+# Drawing
+${String.fromCharCode(96,96,96)}
+
+After:
+${String.fromCharCode(96,96,96)}markdown
+# Text Elements
+....
+%%
+# Drawing
+${String.fromCharCode(96,96,96)}
+`,
+"2.0.25":`
+# New - a small change that opens big opportunities
+- You can now set a folder as the Excalidraw Template in settings (See under Basic). If a folder is provided, Excalidraw will treat drawings in that folder as templates and will prompt you to select the template to use for new drawings.
+- I updated the <a href="https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Deconstruct%20selected%20elements%20into%20new%20drawing.md">Deconstruct Selected Elements into new Drawing</a> script to accommodate the new template setting.
+`,
+"2.0.24":`
+Quality of Life Fixes!
+
+## Fixed
+- Text editing issue on mobile devices with an on-screen keyboard is now fixed 🥳. Previously, Excalidraw's UI fell apart when the keyboard was activated, and often even after you stopped editing, the canvas positioning was off. I hope to have solved the issue (we'll see after your testing and feedback!). This is one of those cases that seems insignificant but took enormous effort. It took me 2.5 full days of net time to figure out the root cause and the solution (this is not an exaggeration).
+- Tool buttons did not get selected on the first click.
+- Images flicker on Forced Save.
+- Hover preview fixes:
+  - ${String.fromCharCode(96)}area=${String.fromCharCode(96)}, ${String.fromCharCode(96)}group=${String.fromCharCode(96)}, ${String.fromCharCode(96)}frame=${String.fromCharCode(96)} references now display the part of the image as expected in hover preview (showed an empty preview until now).
+  - Block and section references to notes on the "back side of the drawing" now correctly show up in hover preview (showed an empty preview until now).
+
+## New
+- Default height setting in Plugin Settings. Thanks @leoccyao! [#1612](https://github.com/zsviczian/obsidian-excalidraw-plugin/pull/1612)
+`,
+"2.0.23":`
+## New
+- Additional arrowheads (Circle, Circle Outline, Diamond, Diamond Outline, Triangle Outline) are now available via element properties.
+- Setting under "Links and Transclusions" to show/hide second-order links
+
+## Fixed
+- some styling issues with dynamic styles (e.g.: text color of context menu)
+
+## New in ExcalidrawAutomate
+- Excalidraw Publish Support: New hook to modify the link in the exported SVGs. This is useful when you want to export SVGs to your website. If set, this callback is triggered whenever a drawing is exported to SVG. The string returned by the hook will replace the link in the exported SVG. The hook is only executed if the link is to a file internal to Obsidian. [1605](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1605)
+${String.fromCharCode(96,96,96)}js
+onUpdateElementLinkForExportHook: (data: {
+*    originalLink: string,
+*    obsidianLink: string,
+*    linkedFile: TFile | null,
+*    hostFile: TFile,
+*  }) => string = null;
+${String.fromCharCode(96,96,96)}
+`,
+"2.0.22":`
+## Fixed
+- BUG: Unable to load obsidian excalidraw plugin on ipad 15.x or older [#1525](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1525)
+- BUG: ea.help does not display help if only function signature is available [#1601](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1601)
+`,
+"2.0.21":`
+## New/changed
+**"Focus on Existing Tab"**
+- New Setting: Disabled by default.
+  - Prevents multiple instances of the same drawing from opening when clicking on links within Excalidraw.
+  - Overrides the "Reuse Adjacent Pane" option when the file is already open.
+  - Accessible under "Links, Transclusions, and TODOs" in plugin settings.
+
+**Enhanced Context Menu Functions for Text Containers**
+- Two new context menu functions added for containers with a text element:
+  - Right-click to select the text element only, allowing independent color changes from the container.
+  - Remove orphaned element links when the text element has a link but no longer includes a link in the text.
+
+**Improved Laser Pointer Activation**
+- Laser pointer activation on double tap in view mode removed due to interference with link navigation and other features.
+- When the drawing is in "view" mode, laser pointer activation now available via long-press/right-click context menu.
+- Alternatively, activate the laser pointer with "k" if you have a keyboard.
+
+## Fixed
+- **Older iOS and Android webview support**: Rebuilt all packages and dependencies with Node 18, hoping to address (sorry I can't reproduce/test these issues myself) compatibility issues with older iPad OS versions, up to 15.7. [#1525](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1525), and Android [1598](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1598)
+- **Double-click navigation**: Fixed the issue where double-clicking an embedded image did not navigate to the link in view mode.
+- **ExcaliBrain new file creation**: Resolved the issue with new file creation from ExcaliBrain. [#201](https://github.com/zsviczian/excalibrain/issues/201)
+- **Canvas immersive style**: Removed Canvas immersive embedding style support from the Excalidraw stylesheet to address performance issues experienced by some users with various Obsidian themes. If you require this feature, you can add a CSS snippet with the provided code.
+
+${String.fromCharCode(96,96,96)}css
+.canvas-node:not(.is-editing):has(.excalidraw-canvas-immersive) {
+  ::-webkit-scrollbar,
+  ::-webkit-scrollbar-horizontal {
+    display: none;
+  }
+  background-color: transparent !important;
+}
+
+.canvas-node:not(.is-editing) .canvas-node-container:has(.excalidraw-canvas-immersive) {
+  border:       unset;
+  box-shadow:   unset;
+}
+${String.fromCharCode(96,96,96)}
+`,
+"2.0.20":`
+## Fixed in ExcalidrawAutomate
+- Regression: ${String.fromCharCode(96)}ea.getMaximumGroups(elements)${String.fromCharCode(96)} stopped working after the 2.0.19 update. [#1576](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1576)
+`,
+"2.0.19":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/4wp6vLiIdGM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## Fixed
+- When updating Excalidraw, some open drawings weren't automatically reopening. I hope I got this fixed (note this change will only have an effect when you receive the update after this).
+- In dark mode, the frame header is challenging to see when modified [#1568](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1568).
+
+## New
+- Crop PDF pages:
+  - Available in Excalidraw, Markdown Notes, and on the Canvas.
+  - Crop the active page from the embedded PDF viewer and insert the cropped image into the current view, both in Excalidraw and on Canvas.
+- New Command Palette Action: "Insert active PDF page as image." This action is functional in Excalidraw. If an embedded Obsidian-PDF-viewer is present, executing this command will insert the active page as an image into the Excalidraw scene.
+- Two new settings introduced:
+  - "Basic" section allows setting the folder for crop files.
+  - "Saving/filename" section enables setting the prefix for crop files.
+- PDF import now defaults to importing all pages.
+- Rounded corners now available for images.
+- Second-order links now encompass forward links from embedded Excalidraw Files.
+- Clicking a cropped file in a markdown note or on Canvas will prompt to open the original file, not just the cropper.
+`,
+"2.0.18":`
+## New
+
+<div style="text-align: center;">
+  <a data-tooltip-position="top" aria-label="https://youtube.com/shorts/ST6h4uaXmnY" rel="noopener" class="external-link" href="https://youtube.com/shorts/ST6h4uaXmnY" target="_blank">
+    <img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/vintage-mask.png" referrerpolicy="no-referrer" style="width: 150px; margin: 0 auto;">
+  </a>
+</div>
+
+- [Crop Vintage Mask Script](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Crop%20Vintage%20Mask.md) adds rounded corner mask to cropped images. Install it from the script library.
+- Advanced Setting: Modify image zoom memory limit for sharper zoom. See under "Non-Excalidraw.com Supported Features" in settings.
+- Laser Pointer will not activate on double-click in ExcaliBrain
+
+## Fixed
+- Resolved cropping issue with rotated images.
+
+## New in ExcalidrawAutomate
+- You can now specify elementId to add functions: addLine, addArrow, addRect, etc.
+- ea.help() now provides help on Script Engine utils functions as well
+- ea.isExcalidrawMask(file?:TFile) will return true if the currently open view or the supplied file is an Excalidraw Mask file.
+`,
+"2.0.17":`
+## Fixed
+- Image cropping now supports dark mode
+- Image cropping/carve out was not working reliably in some cases [#1546](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1546)
+- Masking a mirrored image resulted in an off-positioned mask
+
+## New
+- Context menu action to convert SVG to Excalidraw strokes
+- Updated Chinese translation (Thank you @tswwe)
+`,
+"2.0.16":`
+## Fixed
+- Image cropping did not work consistently with large image files on lower-powered devices [#1538](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1538). 
+- Mermaid editor was not working when Excalidraw was open in an Obsidian popout window [#1503](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1503)
+`,
+"2.0.15":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/uHFd0XoHRxE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New
+- Crop and Mask Images in Excalidraw, Canvas, and Markdown. (Inspired by @bonecast [#4566](https://github.com/excalidraw/excalidraw/issues/4566))
+- Draw metadata around images but hide it on the export.
+
+## Fixed
+- Freedraw closed circles (2nd attempt)
+- Interactive Markdown embeddable border-color (setting did not have an effect)
+`,
+"2.0.14":`
+## New
+- Stylus button now activates the eraser function. Note: This feature is supported for styluses that comply with industry-standard button events. Unfortunately, Samsung SPEN and Apple Pencil do not support this functionality.
+
+## Fixed
+- Improved handwriting quality. I have resolved the long-standing issue of closing the loop when ends of the line are close, making an "u" into an "o" ([#1529](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1529) and [#6303](https://github.com/excalidraw/excalidraw/issues/6303)).
+- Improved Excalidraw's full-screen mode behavior. Access it via the Obsidian Command Palette or the full-screen button on the Obsidian Tools Panel ([#1528](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1528)).
+- Fixed color picker overlapping with the Obsidian mobile toolbar on Obsidian-Mobile.
+- Corrected display issues with alternative font sizes (Fibonacci and Zoom relative) in the element properties panel when editing a text element (refer to [2.0.11 Release Notes](https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/2.0.11) for details about the font-size Easter Egg).
+- Resolved the issue where Excalidraw SVG exports containing LaTeX were not loading correctly into Inkscape ([#1519](https://github.com/zsviczian/obsidian-excalidraw-plugin/pull/1519)). Thanks to 🙏@HyunggyuJang for the contribution.
+`,
+"2.0.13":`
+## Fixed
+- Excalidraw crashes if you paste an image and right-click on canvas immediately after pasting.
+`,
+"2.0.12":`
+## Fixed
+- Stencil library not working [#1516](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1516), [#1517](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1517)
+- The new convert image from URL to Local File feature did not work in two situations:
+  - When the embedded image is downloaded from a very slow server (e.g. OpenAIs temp image server)
+  - On Android
+- The postToOpenAI function did not work in all situations on Android.
+- ExcaliAI wireframe to code did not display correctly on Android
+- Tooltips kept popping up on Android.
+
+## New
+- Added "Save image from URL to local file" to the right-click context menu
+- Further [ExcaliAI](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/ExcaliAI.md) improvements including support for image editing with image mask
+`,
+"2.0.11":`
+## Fixed
+- Resolved an Obsidian performance issue caused by simultaneous installations of Excalidraw and the Minimal theme. Optimized Excalidraw CSS loading into Obsidian since April 2021, resulting in noticeable performance improvements. ([#1456](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1456))
+- Removed default support for the [Sliding Panes Plugin](https://github.com/deathau/sliding-panes-obsidian) due to compatibility issues with Obsidian Workspaces. Obsidian's "Stack Tabs" feature now supersedes Sliding Panes. To re-enable sliding panes support, navigate to Compatibility Features in Plugin Settings.
+- Sometimes images referenced with URLs did not show in exported scenes and when embedding Excalidraw into a markdown note. I hope all that is now resolved.
+- ExcalidrawAutomate scripts sometimes were not able to save their settings.
+
+## New
+- Introduced an "Easter Egg" feature in font-size properties:
+  - Hold SHIFT while selecting font size to use scaled sizes (S, M, L, XL) based on the current canvas zoom, ensuring consistent sizes within zoom ranges.
+  - Hold ALT/OPT while selecting font size to use values based on the golden mean (s:16, m:26, l:42, xl:68). ALT+SHIFT scales font sizes based on canvas zoom.
+  - Scaled sizes are sticky; new text elements adjust font sizes relative to the canvas zoom. Deselect SHIFT to disable this feature.
+  - For more on the Golden Scale, watch [The Golden Opportunity](https://youtu.be/2SHn_ruax-s).
+- Added two new Command Palette Actions:
+  - "Decompress current Excalidraw File" in Markdown View mode helps repair corrupted, compressed Excalidraw files manually.
+  - "Save image from URL to local file" saves referenced URL images to your Vault, replacing images in the drawing.
+- Updated the ExcaliAI script to generate images using ExcaliAI.
+
+## New in ExcalidrawAutomate
+- Added additional documentation about functions to ea.suggester.
+- Added ea.help(). You can use this function from Developer Console to print help information about functions. Usage: ${String.fromCharCode(96)}ea.help(ea.functionName)${String.fromCharCode(96)} or ${String.fromCharCode(96)}ea.help('propertyName')${String.fromCharCode(96)} - notice property name is in quotes.
+`,
+"2.0.10":`
+One more minor tweak to support an updated ExcaliAI script - now available in the script store.
+`,
+"2.0.9":`
+This release is very minor, and I apologize for the frequent updates in a short span. I chose not to delay this fix for 1-2 weeks, waiting for my larger release. The WireframeToAI feature wasn't working in 2.0.8, but now it does.
+`,
+"2.0.8":`
+## New
+- Mermaid Class Diagrams [#7381](https://github.com/excalidraw/excalidraw/pull/7381)
+- New Scripts:
+  - Repeat Texts contributed by @soraliu [#1425](https://github.com/zsviczian/obsidian-excalidraw-plugin/pull/1425)
+  - Relative Font Size Cycle [#1474](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1474)
+- New setting to configure the URL used to reach the OpenAI API - for setting an OpenAI API compatible local LLM URL.
+
+## Fixed
+- web images with jpeg extension were not displayed. [#1486](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1486)
+- MathJax was causing errors on the file in the active editor when starting Obsidian or starting the Excalidraw Plugin. I reworked the MathJax implementation from the ground up. [#1484](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1484), [#1473](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1473)
+- Enhanced performance for resizing sticky notes (resize + ALT) on slower devices when centrally adjusting their size.
+
+## New in ExcalidrawAutomate:
+- New ArrowHead types. Currently only available programmatically and when converting Mermaid Class Diagrams into Excalidraw Objects:
+${String.fromCharCode(96,96,96)}ts
+  addArrow(
+    points: [x: number, y: number][],
+    formatting?: {
+      startArrowHead?: "arrow"|"bar"|"circle"|"circle_outline"|"triangle"|"triangle_outline"|"diamond"|"diamond_outline"|null;
+      endArrowHead?: "arrow"|"bar"|"circle"|"circle_outline"|"triangle"|"triangle_outline"|"diamond"|"diamond_outline"|null;
+      startObjectId?: string;
+      endObjectId?: string;
+    },
+  ): string;
+  
+  connectObjects(
+    objectA: string,
+    connectionA: ConnectionPoint | null,
+    objectB: string,
+    connectionB: ConnectionPoint | null,
+    formatting?: {
+      numberOfPoints?: number;
+      startArrowHead?: "arrow"|"bar"|"circle"|"circle_outline"|"triangle"|"triangle_outline"|"diamond"|"diamond_outline"|null;
+      endArrowHead?: "arrow"|"bar"|"circle"|"circle_outline"|"triangle"|"triangle_outline"|"diamond"|"diamond_outline"|null;
+      padding?: number;
+    },
+  ): string;
+
+  connectObjectWithViewSelectedElement(
+    objectA: string,
+    connectionA: ConnectionPoint | null,
+    connectionB: ConnectionPoint | null,
+    formatting?: {
+      numberOfPoints?: number;
+      startArrowHead?: "arrow"|"bar"|"circle"|"circle_outline"|"triangle"|"triangle_outline"|"diamond"|"diamond_outline"|null;
+      endArrowHead?: "arrow"|"bar"|"circle"|"circle_outline"|"triangle"|"triangle_outline"|"diamond"|"diamond_outline"|null;
+      padding?: number;
+    },
+  ): boolean;
+${String.fromCharCode(96,96,96)}
+`,
+"2.0.7":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/kp1K7GRrE6E" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+# Fixed
+- The Android and iOS crash with 2.0.5 😰. I can't apologize enough for releasing a version that I did not properly test on Android and iOS. That ought to teach me something about last-minute changes before hitting release.
+- Scaled-resizing a sticky note (SHIFT+resize) caused Excalidraw to choke on slower devices
+- Improved plugin performance focusing on minimizing Excalidraw's effect on Obsidian overall
+- Images embedded with a URL often did not show up in image exports, hopefully, the issue will less frequently occur in the future.
+- Local file URL now follows Obsidian standard - making it easier to navigate in Markdown view mode.
+
+# New
+- Bonus feature compared to 2.0.4: Second-order links when clicking embedded images. I use images to connect ideas. Clicking on an image and seeing all the connections immediately is very powerful.
+- In plugin settings, under "Startup Script", the button now opens the startup script if it already exists.
+- Partial support for animated GIFs (will not show up in image exports, but can be added as interactive embeddables)
+- Configurable modifier keys for link click action and drag&drop actions.
+- Improved support for drag&drop from your local drive and embedding of files external to Excalidraw.
+`,
+"2.0.5":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/kp1K7GRrE6E" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+# Fixed
+- Scaled-resizing a sticky note (SHIFT+resize) caused Excalidraw to choke on slower devices
+- Improved plugin performance focusing on minimizing Excalidraw's effect on Obsidian overall
+- Images embedded with a URL often did not show up in image exports, hopefully, the issue will less frequently occur in the future.
+- Local file URL now follows Obsidian standard - making it easier to navigate in Markdown view mode.
+
+# New
+- In plugin settings, under "Startup Script", the button now opens the startup script if it already exists.
+- Partial support for animated GIFs (will not show up in image exports, but can be added as interactive embeddables)
+- Configurable modifier keys for link click action and drag&drop actions.
+- Improved support for drag&drop from your local drive and embedding of files external to Excalidraw.
+`,
+"2.0.4":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/A1vrSGBbWgo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New
+- ExcaliAI
+- You can now add ${String.fromCharCode(96)}ex-md-font-hand-drawn${String.fromCharCode(96)} or ${String.fromCharCode(96)}ex-md-font-hand-drawn${String.fromCharCode(96)} to the ${String.fromCharCode(96)}cssclasses:${String.fromCharCode(96)} frontmatter property in embedded markdown nodes and their font face will match the respective Excalidraw fonts.
+
+## Fixed
+- Adding a script for the very first time (when the script folder did not yet exist) did not show up in the tools panel. Required an Obsidian restart. 
+- Performance improvements
+
+## New and updated In Excalidraw Automate
+- Added many new functions and some features to existing functions. See the [release notes](https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/2.0.3) for details
+`,
+"2.0.3":`
+## Fixed
+- Mermaid to Excalidraw stopped working after installing the Obsidian 1.5.0 insider build. [#1450](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1450)
+- CTRL+Click on a Mermaid diagram did not open the Mermaid editor.
+- Embed color settings were not honored when the embedded markdown was focused on a section or block.
+- Scrollbars were visible when the embeddable was set to transparent (set background color to match element background, and set element background color to "transparent").
+`,
+"2.0.2":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/502swdqvZ2A" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## Fixed
+- Resolved an issue where the Command Palette's "Toggle between Excalidraw and Markdown mode" failed to uncompress the Excalidraw JSON for editing.
+
+## New
+- Scaling feature for embedded objects (markdown documents, pdfs, YouTube, etc.): Hold down the SHIFT key while resizing elements to adjust their size.
+- Expanded support for Canvas Candy. Regardless of Canvas Candy, you can apply CSS classes to embedded markdown documents for transparency, shape adjustments, text orientation, and more.
+- Added new functionalities to the active embeddable top-left menu:
+  - Document Properties (cog icon)
+    - File renaming
+    - Basic styling options for embedded markdown documents
+    - Setting YouTube start time
+  - Zoom to full screen for PDFs
+- Improved immersive embedding of Excalidraw into Obsidian Canvas.
+- Introduced new Command Palette Actions:
+  - Embeddable Properties
+  - Scaling selected embeddable elements to 100% relative to the current canvas zoom.
+`,
+"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)
@@ -393,7 +1252,7 @@ ${String.fromCharCode(96,96,96)}`,
 ## 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.
+  - [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 support 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.

src/dialogs/ModifierKeySettings.ts

@@ -0,0 +1,97 @@
+import { Setting } from "obsidian";
+import { DEVICE } from "src/constants/constants";
+import { t } from "src/lang/helpers";
+import { ModifierKeySet, ModifierSetType, modifierKeyTooltipMessages } from "src/utils/ModifierkeyHelper";
+
+type ModifierKeyCategories = Partial<{
+  [modifierSetType in ModifierSetType]: string;
+}>;
+
+const CATEGORIES: ModifierKeyCategories = {
+  WebBrowserDragAction: t("WEB_BROWSER_DRAG_ACTION"),
+  LocalFileDragAction: t("LOCAL_FILE_DRAG_ACTION"),
+  InternalDragAction: t("INTERNAL_DRAG_ACTION"),
+  LinkClickAction: t("PANE_TARGET"),
+};
+
+export class ModifierKeySettingsComponent {
+  private isMacOS: boolean;
+
+  constructor(
+    private contentEl: HTMLElement,
+    private modifierKeyConfig: {
+      Mac: Record<string, ModifierKeySet>;
+      Win: Record<string, ModifierKeySet>;
+    },
+    private update?: Function,
+  ) {
+    this.isMacOS = (DEVICE.isMacOS || DEVICE.isIOS);
+  }
+
+  render() {
+    const platform = this.isMacOS ? "Mac" : "Win";
+    const modifierKeysConfig = this.modifierKeyConfig[platform];
+
+    Object.entries(CATEGORIES).forEach(([modifierSetType, label]) => {
+      const detailsEl = this.contentEl.createEl("details");
+      detailsEl.createEl("summary", { 
+        text: label,
+        cls: "excalidraw-setting-h4",
+      });
+      
+      const modifierKeys = modifierKeysConfig[modifierSetType];
+      detailsEl.createDiv({
+        //@ts-ignore
+        text: t("DEFAULT_ACTION_DESC") + modifierKeyTooltipMessages()[modifierSetType][modifierKeys.defaultAction],
+        cls: "setting-item-description"
+      });
+      Object.entries(modifierKeys.rules).forEach(([action, rule]) => {
+        const setting = new Setting(detailsEl)
+        //@ts-ignore
+          .setName(modifierKeyTooltipMessages()[modifierSetType][rule.result]);
+        
+        setting.addToggle((toggle) =>
+          toggle
+            .setValue(rule.shift)
+            .setTooltip("SHIFT")
+            .onChange((value) => {
+              rule.shift = value;
+              this.update();
+            })
+          );
+        setting.addToggle((toggle) => {
+          toggle
+            .setValue(rule.ctrl_cmd)
+            .setTooltip(this.isMacOS ? "CMD" : "CTRL")
+            .onChange((value) => {
+              rule.ctrl_cmd = value;
+              this.update();
+            })
+          if(this.isMacOS && modifierSetType !== "LinkClickAction") {
+            toggle.setDisabled(true);
+            toggle.toggleEl.style.opacity = "0.5";
+          }
+        });
+        
+        setting.addToggle((toggle) =>
+          toggle
+            .setValue(rule.alt_opt)
+            .setTooltip(this.isMacOS ? "OPT" : "ALT")
+            .onChange((value) => {
+              rule.alt_opt = value;
+              this.update();
+            })
+          );
+        setting.addToggle((toggle) =>
+          toggle
+            .setValue(rule.meta_ctrl)
+            .setTooltip(this.isMacOS ? "CTRL" : "META")
+            .onChange((value) => {
+              rule.meta_ctrl = value;
+              this.update();
+            })
+          );
+      });
+    });
+  }
+}

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/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 { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/excalidraw/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/constants";
 import ExcalidrawView from "src/ExcalidrawView";
 import ExcalidrawPlugin from "src/main";
 import { setPen } from "src/menu/ObsidianMenu";
@@ -393,7 +393,7 @@ export class PenSettingsModal extends Modal {
     let spSetting: Setting;
 
     new Setting(ce)
-      .setName("Pressure sensitve pen?")
+      .setName("Pressure sensitive pen?")
       .setDesc(fragWithHTML(`<b>toggle on</b>: pressure sensitive<br><b>toggle off</b>: constant pressure`))
       .addToggle(toggle =>
         toggle

src/dialogs/Prompt.ts

@@ -8,14 +8,21 @@ import {
   TFile,
   Notice,
   TextAreaComponent,
+  TFolder,
 } from "obsidian";
 import ExcalidrawView from "../ExcalidrawView";
 import ExcalidrawPlugin from "../main";
-import { sleep } from "../utils/Utils";
-import { getLeaf } from "../utils/ObsidianUtils";
+import { escapeRegExp, getLinkParts, sleep } from "../utils/Utils";
+import { getLeaf, openLeaf } from "../utils/ObsidianUtils";
 import { checkAndCreateFolder, splitFolderAndFilename } from "src/utils/FileUtils";
-import { KeyEvent, isCTRL } from "src/utils/ModifierkeyHelper";
+import { KeyEvent, isWinCTRLorMacCMD } from "src/utils/ModifierkeyHelper";
 import { t } from "src/lang/helpers";
+import { ExcalidrawElement, getEA } from "src";
+import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
+import { MAX_IMAGE_SIZE, REG_LINKINDEX_INVALIDCHARS } from "src/constants/constants";
+import { REGEX_LINK } from "src/ExcalidrawData";
+import { ScriptEngine } from "src/Scripts";
+import { openExternalLink, openTagSearch } from "src/utils/ExcalidrawViewUtils";
 
 export type ButtonDefinition = { caption: string; tooltip?:string; action: Function };
 
@@ -339,11 +346,11 @@ export class GenericInputPrompt extends Modal {
   private cancelClickCallback = () => this.cancel();
 
   private keyDownCallback = (evt: KeyboardEvent) => {
-    if ((evt.key === "Enter" && this.lines === 1) || (isCTRL(evt) && evt.key === "Enter")) {
+    if ((evt.key === "Enter" && this.lines === 1) || (isWinCTRLorMacCMD(evt) && evt.key === "Enter")) {
       evt.preventDefault();
       this.submit();
     }
-    if (this.displayEditorButtons && evt.key === "k" && isCTRL(evt)) {
+    if (this.displayEditorButtons && evt.key === "k" && isWinCTRLorMacCMD(evt)) {
       evt.preventDefault();
       this.linkBtnClickCallback();
     } 
@@ -461,22 +468,44 @@ export class NewFileActions extends Modal {
   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(
-    private plugin: ExcalidrawPlugin,
-    private path: string,
-    private keys: KeyEvent,
-    private view: ExcalidrawView,
-    private openNewFile: boolean = true,
-    private parentFile?: TFile,
-  ) {
+  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);
-    if(!parentFile) this.parentFile = view.file;
+    this.plugin = plugin;
+    this.path = path;
+    this.keys = keys;
+    this.view = view;
+    this.openNewFile = openNewFile;
+    this.sourceElement = sourceElement;
+    this.parentFile = parentFile ?? view.file;
     this.waitForClose = new Promise<TFile|null>((resolve, reject) => {
       this.resolvePromise = resolve;
       this.rejectPromise = reject;
     });
-  }
+  } 
 
   onOpen(): void {
     this.createForm();
@@ -487,8 +516,12 @@ export class NewFileActions extends Modal {
     if (!file || !this.openNewFile) {
       return;
     }
-    const leaf = getLeaf(this.plugin,this.view.leaf,this.keys)
-    leaf.openFile(file, {active:true});
+    openLeaf({
+      plugin: this.plugin,
+      fnGetLeaf: () => getLeaf(this.plugin,this.view.leaf,this.keys),
+      file,
+      openState: { active: true },
+    });
   }
 
   onClose() {
@@ -528,7 +561,7 @@ export class NewFileActions extends Modal {
 
       const createFile = async (data: string): Promise<TFile> => {
         if (!this.path.includes("/")) {
-          const re = new RegExp(`${this.parentFile.name}$`, "g");
+          const re = new RegExp(`${escapeRegExp(this.parentFile.name)}$`, "g");
           this.path = this.parentFile.path.replace(re, this.path);
         }
         if (!this.path.match(/\.md$/)) {
@@ -540,7 +573,31 @@ export class NewFileActions extends Modal {
         return f;
       };
 
-      const bMd = el.createEl("button", { text: t("PROMPT_BUTTON_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;
@@ -550,7 +607,10 @@ export class NewFileActions extends Modal {
         this.close();
       };
 
-      const bEx = el.createEl("button", { text: t("PROMPT_BUTTON_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;
@@ -641,3 +701,59 @@ export class ConfirmationPrompt extends Modal {
     }
   }
 }
+
+export const linkPrompt = async (linkText:string, app: App, view?: ExcalidrawView, message: string = "Select link to open"):Promise<[file:TFile, linkText:string, subpath: string]> => {
+  const partsArray = REGEX_LINK.getResList(linkText);
+  let subpath: string = null;
+  let file: TFile = null;
+  let parts = partsArray[0];
+  if (partsArray.length > 1) {
+    parts = await ScriptEngine.suggester(
+      app,
+      partsArray.filter(p=>Boolean(p.value)).map(p => {
+        const alias = REGEX_LINK.getAliasOrLink(p);
+        return alias === "100%" ? REGEX_LINK.getLink(p) : alias;
+      }),
+      partsArray.filter(p=>Boolean(p.value)),
+      message,
+    );
+    if(!parts) return;
+  }
+
+  if(!parts) {
+    return;
+  }
+  
+  if (!parts.value) {
+    openTagSearch(linkText, app);
+    return;
+  }
+
+  linkText = REGEX_LINK.getLink(parts);
+  if(openExternalLink(linkText, app)) return;
+
+  if (linkText.search("#") > -1) {
+    const linkParts = getLinkParts(linkText, view ? view.file : undefined);
+    subpath = `#${linkParts.isBlockRef ? "^" : ""}${linkParts.ref}`;
+    linkText = linkParts.path;
+  }
+  if (linkText.match(REG_LINKINDEX_INVALIDCHARS)) {
+    new Notice(t("FILENAME_INVALID_CHARS"), 4000);
+    return;
+  }
+  file = app.metadataCache.getFirstLinkpathDest(
+    linkText,
+    view ? view.file.path : "",
+  );
+  return [file, linkText, subpath];
+}
+
+export const templatePromt = async (files: TFile[], app: App): Promise<TFile> => {
+  if(files.length === 1) return files[0];
+  return ((await linkPrompt(
+    files.map(f=>`[[${f.path}|${f.name}]]`).join(" "),
+    app,
+    undefined,
+    t("PROMPT_SELECT_TEMPLATE")
+  ))??[null, null, null])[0];
+}

src/dialogs/PublishOutOfDateFiles.ts

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

src/dialogs/ScriptInstallPrompt.ts

@@ -1,6 +1,7 @@
 import { MarkdownRenderer, Modal, Notice, request } from "obsidian";
 import ExcalidrawPlugin from "../main";
-import { errorlog, log } from "../utils/Utils";
+import { errorlog, escapeRegExp } from "../utils/Utils";
+import { log } from "src/utils/DebugHelper";
 
 const URL =
   "https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/index-new.md";
@@ -88,7 +89,8 @@ export class ScriptInstallPrompt extends Modal {
         this.close();
         return;
       }
-      await MarkdownRenderer.renderMarkdown(
+      await MarkdownRenderer.render(
+        this.plugin.app,
         source,
         this.contentDiv,
         "",
@@ -134,7 +136,7 @@ export class ScriptInstallPrompt extends Modal {
 
       let lastIndex = 0;
       let match;
-      const regex = new RegExp(searchTerm, 'gi');
+      const regex = new RegExp(escapeRegExp(searchTerm), 'gi');
 
       // Iterate over all matches in the text node
       while ((match = regex.exec(nodeContent)) !== null) {

src/dialogs/SelectCard.ts

@@ -0,0 +1,66 @@
+import { App, FuzzySuggestModal, Notice, TFile } from "obsidian";
+import { t } from "../lang/helpers";
+import ExcalidrawView from "src/ExcalidrawView";
+import { getEA } from "src";
+import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
+import { MD_EX_SECTIONS } from "src/constants/constants";
+import { addBackOfTheNoteCard } from "src/utils/ExcalidrawViewUtils";
+
+export class SelectCard extends FuzzySuggestModal<string> {
+
+  constructor(
+    public app: App,
+    private view: ExcalidrawView,
+    private sections: string[]
+  ) {
+    super(app);
+    this.limit = 20;
+    this.setInstructions([
+      {
+        command: t("TYPE_SECTION"),
+        purpose: "",
+      },
+    ]);
+
+    this.inputEl.onkeyup = (e) => {
+      if (e.key == "Enter") {
+        if (this.containerEl.innerText.includes(t("EMPTY_SECTION_MESSAGE"))) {
+          const item = this.inputEl.value;
+          if(item === "" || MD_EX_SECTIONS.includes(item)) {
+            new Notice(t("INVALID_SECTION_NAME"));
+            this.close();
+            return;
+          }
+          addBackOfTheNoteCard(this.view, item);
+          this.close();
+        }
+      }
+    };
+  }
+
+  getItems(): string[] {
+    return this.sections;
+  }
+
+  getItemText(item: string): string {
+    return item;
+  }
+
+  onChooseItem(item: string): void {
+    const ea = getEA(this.view) as ExcalidrawAutomate;
+    const id = ea.addEmbeddable(
+      0,0,400,500,
+      `[[${this.view.file.path}#${item}]]`
+    );
+    (async () => {
+      await ea.addElementsToView(true, false, true);
+      ea.selectElementsInView([id]);
+    })();
+  }
+
+  public start(): void {
+    this.emptyStateText = t("EMPTY_SECTION_MESSAGE");
+    this.setPlaceholder(t("SELECT_SECTION_OR_TYPE_NEW"));
+    this.open();
+  }
+}

src/dialogs/SuggesterInfo.ts

@@ -5,7 +5,26 @@ type SuggesterInfo = {
   after: string;
 };
 
+const hyperlink = (url: string, text: string) => {
+  return `<a onclick='window.open("${url}")'>${text}</a>`;
+}
+
+const EMBEDDABLE_MDCUSTOMPROPS = `type EmbeddableMDCustomProps = {<br>useObsidianDefaults: boolean;<br>backgroundMatchCanvas: boolean;<br>backgroundMatchElement: boolean;<br>backgroundColor: string;<br>backgroundOpacity: number;<br>borderMatchElement: boolean;<br>borderColor: string;<br>borderOpacity: number;<br>filenameVisible: boolean;<br>};<br>`;
+
+
 export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
+  {
+    field: "help",
+    code: "help(target: Function | string)",
+    desc: "Utility function that provides help about ExcalidrawAutomate functions and properties. I recommend calling this function from Developer Console to print out help to the console.",
+    after: "",
+  },
+  {
+    field:"isExcalidrawMaskFile",
+    code:"isExcalidrawMaskFile(file?:TFile): boolean;",
+    desc:"Returns true if the file is an Excalidraw Mask file. If file is not provided, the function will use ea.targetView.file",
+    after:"",
+  },
   {
     field: "plugin",
     code: null,
@@ -27,13 +46,13 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   {
     field: "style.strokeColor",
     code: "[string]",
-    desc: "A valid css color. See <a onclick='window.open(\"https://www.w3schools.com/colors/default.asp\")'>W3 School Colors</a> for more.",
+    desc: `A valid css color. See ${hyperlink("https://www.w3schools.com/colors/default.asp", "W3 School Colors")} for more.`,
     after: "",
   },
   {
     field: "style.backgroundColor",
     code: "[string]",
-    desc: "A valid css color. See <a onclick='window.open(\"https://www.w3schools.com/colors/default.asp\")'>W3 School Colors</a> for more.",
+    desc: `A valid css color. See ${hyperlink("https://www.w3schools.com/colors/default.asp","W3 School Colors")} for more.`,
     after: "",
   },
   {
@@ -123,7 +142,7 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   {
     field: "canvas.viewBackgroundColor",
     code: "[string]",
-    desc: "A valid css color.\nSee <a onclick='window.open(\"https://www.w3schools.com/colors/default.asp\")'>W3 School Colors</a> for more.",
+    desc: `A valid css color.\nSee ${hyperlink("https://www.w3schools.com/colors/default.asp","W3 School Colors")} for more.`,
     after: "",
   },
   {
@@ -170,20 +189,42 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   },
   {
     field: "create",
-    code: '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,},}): Promise<string>;',
-    desc: "Create a drawing and save it to filename.\nIf filename is null: default filename as defined in Excalidraw settings.\nIf folder is null: default folder as defined in Excalidraw settings\n",
+    code: 'async create(params?: {filename?: string, foldername?: string, templatePath?: string, onNewPane?: boolean, silent?: boolean, frontmatterKeys?: {},}): Promise<string>;',
+    desc: "Create a drawing and save it to filename.\nIf filename is null: default filename as defined in Excalidraw settings.\nIf folder is null: default folder as defined in Excalidraw settings\nReturns the path to the created file.\n" +
+    'frontmatterKeys: {\n' +
+    '  "excalidraw-plugin"?: "raw" | "parsed";\n' +
+    '  "excalidraw-link-prefix"?: string;\n' +
+    '  "excalidraw-link-brackets"?: boolean;\n' +
+    '  "excalidraw-url-prefix"?: string;\n' +
+    '  "excalidraw-export-transparent"?: boolean;\n' +
+    '  "excalidraw-export-dark"?: boolean;\n' +
+    '  "excalidraw-export-padding"?: number;\n' +
+    '  "excalidraw-export-pngscale"?: number;\n' +
+    '  "excalidraw-export-embed-scene"?: boolean;\n' +
+    '  "excalidraw-default-mode"?: "view" | "zen";\n' +
+    '  "excalidraw-onload-script"?: string;\n' +
+    '  "excalidraw-linkbutton-opacity"?: number;\n' +
+    '  "excalidraw-autoexport"?: boolean;\n' +
+    '  "excalidraw-mask"?: boolean;\n' +
+    '  "cssclasses"?: string;\n}',
     after: "",
   },
   {
     field: "createSVG",
-    code: "createSVG(templatePath?: string, embedFont?: boolean, exportSettings?: ExportSettings, loader?: EmbeddedFilesLoader, theme?: string,): Promise<SVGSVGElement>;",
+    code: "async createSVG(templatePath?: string, embedFont?: boolean, exportSettings?: ExportSettings, loader?: EmbeddedFilesLoader, theme?: string,): Promise<SVGSVGElement>;",
     desc: "Use ExcalidrawAutomate.getExportSettings(boolean,boolean) to create an ExportSettings object.\nUse ExcalidrawAutomate.getEmbeddedFilesLoader(boolean?) to create an EmbeddedFilesLoader object.",
     after: "",
   },
   {
     field: "createPNG",
-    code: "createPNG(templatePath?: string, scale?: number, exportSettings?: ExportSettings, loader?: EmbeddedFilesLoader, theme?: string,): Promise<any>;",
-    desc: "Use ExcalidrawAutomate.getExportSettings(boolean,boolean) to create an ExportSettings object.\nUse ExcalidrawAutomate.getEmbeddedFilesLoader(boolean?) to create an EmbeddedFilesLoader object.",
+    code: "async createPNG(templatePath?: string, scale?: number, exportSettings?: ExportSettings, loader?: EmbeddedFilesLoader, theme?: string,padding?: number): Promise<any>;",
+    desc: "Create an image based on the objects in ea.getElements(). The elements in ea will be merged with the elements from the provided template file - if any. Use ExcalidrawAutomate.getExportSettings(boolean,boolean) to create an ExportSettings object.\nUse ExcalidrawAutomate.getEmbeddedFilesLoader(boolean?) to create an EmbeddedFilesLoader object.",
+    after: "",
+  },
+  {
+    field: "createPNGBase64",
+    code: "async craetePNGBase64(templatePath?: string, scale?: number, exportSettings?: ExportSettings, loader?: EmbeddedFilesLoader, theme?: string,padding?: number): Promise<string>;",
+    desc: "The same as createPNG but returns a base64 encoded string instead of a file.",
     after: "",
   },
   {
@@ -194,25 +235,25 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   },
   {
     field: "addRect",
-    code: "addRect(topX: number, topY: number, width: number, height: number): string;",
+    code: "addRect(topX: number, topY: number, width: number, height: number, id?:string): string;",
     desc: null,
     after: "",
   },
   {
     field: "addDiamond",
-    code: "addDiamond(topX: number, topY: number, width: number, height: number): string;",
+    code: "addDiamond(topX: number, topY: number, width: number, height: number, id?:string): string;",
     desc: null,
     after: "",
   },
   {
     field: "addEllipse",
-    code: "addEllipse(topX: number, topY: number, width: number, height: number): string;",
+    code: "addEllipse(topX: number, topY: number, width: number, height: number, id?:string): string;",
     desc: null,
     after: "",
   },
   {
     field: "addBlob",
-    code: "addBlob(topX: number, topY: number, width: number, height: number): string;",
+    code: "addBlob(topX: number, topY: number, width: number, height: number, id?: string): string;",
     desc: null,
     after: "",
   },
@@ -224,44 +265,56 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   },
   {
     field: "addText",
-    code: 'addText(topX: number, topY: number, text: string, formatting?: {wrapAt?: number; width?: number; height?: number; textAlign?: "left" | "center" | "right"; textVerticalAlign: "top" | "middle" | "bottom"; box?: boolean | "box" | "blob" | "ellipse" | "diamond"; boxPadding?: number; boxStrokeColor?: string;}, id?: string,): string;',
-    desc: "If box is !null, then text will be boxed\nThe function returns the id of the TextElement. If the text element is boxed i.e. it is a sticky note, then the id of the container object",
+    code: 'addText(topX: number, topY: number, text: string, formatting?: {autoResize?: boolean; wrapAt?: number; width?: number; height?: number; textAlign?: "left" | "center" | "right"; textVerticalAlign: "top" | "middle" | "bottom"; box?: boolean | "box" | "blob" | "ellipse" | "diamond"; boxPadding?: number; boxStrokeColor?: string;}, id?: string,): string;',
+    desc: "If box is !null, then text will be boxed\nThe function returns the id of the TextElement. If the text element is boxed i.e. it is a sticky note, then the id of the container object.\n"+
+      "Default value for autoResize is true. Setting autoResize to false will wrap the text in the text element without the need for the container. If set to false, you must provide a width value as well.\n" +
+      "wrapAt will be ignored if autoResize is set to false (and a width is also provided)",
     after: "",
   },
   {
     field: "addLine",
-    code: "addLine(points: [[x: number, y: number]]): string;",
+    code: "addLine(points: [[x: number, y: number]], id?:string): string;",
     desc: null,
     after: "",
   },
   {
     field: "addArrow",
-    code: "addArrow(points: [[x: number, y: number]], formatting?: { startArrowHead?: string; endArrowHead?: string; startObjectId?: string; endObjectId?: string;},): string;",
-    desc: null,
+    code: "addArrow(points: [[x: number, y: number]], formatting?: { startArrowHead?: string; endArrowHead?: string; startObjectId?: string; endObjectId?: string;}, id?:string): string;",
+    desc: `valid values for startArrowHead and endArrowHead are: "arrow"|"bar"|"circle"|"circle_outline"|"triangle"|"triangle_outline"|"diamond"|"diamond_outline"|null`,
     after: "",
   },
   {
     field: "addImage",
-    code: "addImage(topX: number, topY: number, imageFile: TFile, scale?: boolean, anchor?: boolean): Promise<string>;",
-    desc: "set scale to false if you want to embed the image at 100% of its original size. Default is true which will insert a scaled image. anchor will only be evaluated if scale is false. anchor true will add |100% to the end of the filename, resulting in an image that will always pop back to 100% when the source file is updated or when the Excalidraw file is reopened. ",
+    code: "async addImage(topX: number, topY: number, imageFile: TFile|string, scale?: boolean, anchor?: boolean): Promise<string>;",
+    desc: "imageFile may be a TFile or a string that contains a hyperlink. imageFile may also be an obsidian filepath including a reference eg.: 'path/my.pdf#page=3'\nSet scale to false if you want to embed the image at 100% of its original size. Default is true which will insert a scaled image.\nanchor will only be evaluated if scale is false. anchor true will add |100% to the end of the filename, resulting in an image that will always pop back to 100% when the source file is updated or when the Excalidraw file is reopened.",
     after: "",
   },
   {
     field: "addEmbeddable",
-    code: "addEmbeddable(topX: number, topY: number, width: number, height: number, url?: string, file?: TFile): string;",
-    desc: "Adds an iframe to the drawing. If url is not null then the iframe will be loaded from the url. The url maybe a markdown link to an note in the Vault or a weblink. If url is null then the iframe will be loaded from the file. Both the url and the file may not be null.",
+    code: "addEmbeddable(topX: number, topY: number, width: number, height: number, url?: string, file?: TFile, embeddableCustomData?: EmbeddableMDCustomProps): string;",
+    desc: "Adds an iframe/webview (depending on content and platform) to the drawing. If url is not null then the iframe/webview will be loaded from the url. The url maybe a markdown link to an note in the Vault or a weblink. " +
+      "If url is null then the iframe/webview will be loaded from the file. Both the url and the file may not be null.<br>" + EMBEDDABLE_MDCUSTOMPROPS,
+    after: "",
+  },
+  {
+    field: "addMermaid",
+    code: "async addMermaid(diagram: string, groupElements: boolean = true,): Promise<string[]|string>;",
+    desc: "Creates a mermaid diagram and returns the ids of the created elements as a string[]. " +
+      "The elements will be added to ea. To add them to the canvas you'll need to use addElementsToView. " +
+      "Depending on the diagram type the result will be either a single SVG image, or a number of excalidraw elements.<br>" +
+      "If there is an error, the function returns a string with the error message.",
     after: "",
   },
   {
     field: "addLaTex",
-    code: "addLaTex(topX: number, topY: number, tex: string): Promise<string>;",
-    desc: null,
+    code: "async addLaTex(topX: number, topY: number, tex: string): Promise<string>;",
+    desc: "This is an async function, you need to avait the results. Adds a LaTex element to the drawing. The tex string is the LaTex code. The function returns the id of the created element.",
     after: "",
   },
   {
     field: "connectObjects",
     code: "connectObjects(objectA: string, connectionA: ConnectionPoint, objectB: string, connectionB: ConnectionPoint, formatting?: {numberOfPoints?: number; startArrowHead?: string; endArrowHead?: string; padding?: number;},): string;",
-    desc: 'type ConnectionPoint = "top" | "bottom" | "left" | "right" | null\nWhen null is passed as ConnectionPoint then Excalidraw will automatically decide\nnumberOfPoints is the number of points on the line. Default is 0 i.e. line will only have a start and end point.\nArrowHead: "triangle"|"dot"|"arrow"|"bar"|null',
+    desc: 'type ConnectionPoint = "top" | "bottom" | "left" | "right" | null\nWhen null is passed as ConnectionPoint then Excalidraw will automatically decide\nnumberOfPoints is the number of points on the line. Default is 0 i.e. line will only have a start and end point.\nArrowHead: "arrow"|"bar"|"circle"|"circle_outline"|"triangle"|"triangle_outline"|"diamond"|"diamond_outline"|null',
     after: "",
   },
   {
@@ -303,7 +356,7 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   {
     field: "getExcalidrawAPI",
     code: "getExcalidrawAPI(): any;",
-    desc: "<a onclick='window.open(\"https://github.com/excalidraw/excalidraw/tree/master/src/packages/excalidraw#ref\")'>Excalidraw API</a>",
+    desc: `${hyperlink("https://github.com/excalidraw/excalidraw/tree/master/src/packages/excalidraw#ref","Excalidraw API")}`,
     after: "",
   },
   {
@@ -318,6 +371,14 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
     desc: null,
     after: "",
   },
+  {
+    field: "addBackOfTheCardNoteToView",
+    code: "async addBackOfTheCardNoteToView(sectionTitle: string, activate: boolean = false, sectionBody?: string, embeddableCustomData?: EmbeddableMDCustomProps): Promise<string>",
+    desc: "Adds a back of the note card to the current active view. If <b>body</b> is provided the note will be created with the body text, otherwise the note will be created with the title only.<br>Returns the id of the created element.<br>" +
+      "If <b>activate</b> is true, the embedded note will be activated for editing.<br>" +
+      "This is an async function, if you need the element ID of the created element, the function should be awaited.<br>" + EMBEDDABLE_MDCUSTOMPROPS,
+    after: "",
+  },
   {
     field: "getViewSelectedElement",
     code: "getViewSelectedElement(): ExcalidrawElement;",
@@ -338,8 +399,8 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   },
   {
     field: "copyViewElementsToEAforEditing",
-    code: "copyViewElementsToEAforEditing(elements: ExcalidrawElement[]): void;",
-    desc: "Copies elements from view to elementsDict for editing",
+    code: "copyViewElementsToEAforEditing(elements: ExcalidrawElement[], copyImages: boolean = false): void;",
+    desc: "Copies elements from view to elementsDict for editing. If copyImages is true, then relevant entries from scene.files will also be copied. This is required if you want to generate a PNG for a subset of the elements in the drawing (e.g. for AI generation)",
     after: "",
   },
   {
@@ -356,7 +417,7 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   },
   {
     field: "addElementsToView",
-    code: "addElementsToView(repositionToCursor?: boolean, save?: boolean, newElementsOnTop?: boolean,shouldRestoreElements?: boolean,): Promise<boolean>;",
+    code: "async addElementsToView(repositionToCursor?: boolean, save?: boolean, newElementsOnTop?: boolean,shouldRestoreElements?: boolean,): Promise<boolean>;",
     desc: "Adds elements from elementsDict to the current view\nrepositionToCursor: default is false\nsave: default is true\nnewElementsOnTop: default is false, i.e. the new elements get to the bottom of the stack\nnewElementsOnTop 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\nNote that elements copied to the view with copyViewElementsToEAforEditing retain their position in the stack of elements in the view even if modified using EA",
     after: "",
   },
@@ -423,19 +484,19 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   {
     field: "activeScript",
     code: "activeScript: string;",
-    desc: "Mandatory to set before calling the get and set ScriptSettings functions. Set automatically by the ScriptEngine\nSee for more details: <a onclick='window.open(\"https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html\")'>Script Engine Help</a>",
+    desc: `Mandatory to set before calling the get and set ScriptSettings functions. Set automatically by the ScriptEngine\nSee for more details: ${hyperlink("https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html","Script Engine Help")}`,
     after: "",
   },
   {
     field: "getScriptSettings",
     code: "getScriptSettings(): {};",
-    desc: "Returns script settings. Saves settings in plugin settings, under the activeScript key. See for more details: <a onclick='window.open(\"https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html\")'>Script Engine Help</a>",
+    desc: `Returns script settings. Saves settings in plugin settings, under the activeScript key. See for more details: ${hyperlink("https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html","Script Engine Help")}`,
     after: "",
   },
   {
     field: "setScriptSettings",
-    code: "setScriptSettings(settings: any): Promise<void>;",
-    desc: "Sets script settings.\nSee for more details: <a onclick='window.open(\"https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html\")'>Script Engine Help</a>",
+    code: "async setScriptSettings(settings: any): Promise<void>;",
+    desc: `Sets script settings.\nSee for more details: ${hyperlink("https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html","Script Engine Help")}`,
     after: "",
   },
   {
@@ -450,6 +511,12 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
     desc: "Measures text size based on current style settings",
     after: "",
   },
+  {
+    field: "getOriginalImageSize",
+    code: "async getOriginalImageSize(imageElement: ExcalidrawImageElement): Promise<{width: number; height: number}>",
+    desc: "Returns the size of the image element at 100% (i.e. the original size). This is an async function, you need to await the result.",
+    after: "",
+  },
   {
     field: "verifyMinimumPluginVersion",
     code: "verifyMinimumPluginVersion(requiredVersion: string): boolean;",
@@ -510,16 +577,133 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
     desc: "Converts a CSS color name to its HEX color equivalent. 'White' to #FFFFFF",
     after: "",
   },
+  {
+    field: "getCM",
+    code: "getCM(color:TInput): ColorMaster;",
+    desc: `Returns a ${hyperlink("https://github.com/lbragile/ColorMaster", "ColorMaster")} object. ` +
+      "The function also accepts css color names. Under the hood, before calling ColorMaster it uses " +
+      "colorNameToHex to convert the color name to a HEX color.",
+    after: "",
+  },
   {
     field: "obsidian",
     code: "obsidian",
-    desc: "Access functions and objects available on the <a onclick='window.open(\"https://github.com/obsidianmd/obsidian-api/blob/master/obsidian.d.ts\")'>Obsidian Module</a>",
+    desc: `Access functions and objects available on the ${hyperlink("https://github.com/obsidianmd/obsidian-api/blob/master/obsidian.d.ts","Obsidian Module")}`,
+    after: "",
+  },
+  {
+    field: "getListOfTemplateFiles",
+    code: "getListOfTemplateFiles(): TFile[] | null",
+    desc: "Returns a list of files in the template folder. " +
+      "If the Excalidraw Template is set as a single file, it returns a single element in the list. " +
+      "If no template is set, it returns null.",
+    after: "",
+  },
+  { 
+    field: "getEmbeddedImagesFiletree",
+    code: "getEmbeddedImagesFiletree(excalidrawFile?: TFile): TFile[]",
+    desc: "Retruns the embedded images in the scene recursively. If excalidrawFile is not provided, " +
+      "the function will use ea.targetView.file",
     after: "",
   },
   {
     field: "getAttachmentFilepath",
     code: "async getAttachmentFilepath(filename: string): Promise<string>",
-    desc: "This asynchronous function should be awaited. It retrieves the filepath to a new file, taking into account the attachments preference settings in Obsidian. If the attachment folder doesn't exist, it creates it. 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.",
+    desc: "This asynchronous function should be awaited. It retrieves the filepath to a new file, taking into account the attachments preference settings in Obsidian. If the attachment folder doesn't exist, it creates it. 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." +
+      "Prompts the user with a dialog to select new file action.<br>" +
+      " - create markdown file<br>" +
+      " - create excalidraw file<br>" +
+      " - cancel action<br>" +
+      "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 controls which leaf will be used for the new file.<br>" +
+      "Returns the TFile for the new file or null if the user cancelled the action.<br>" + 
+      '<code>type PaneTarget = "active-pane"|"new-pane"|"popout-window"|"new-tab"|"md-properties";</code>',
+    after: "",
+  },
+  {
+    field: "getActiveEmbeddableViewOrEditor",
+    code: "getActiveEmbeddableViewOrEditor(view?: ExcalidrawView);",
+    desc: "Returns the editor or leaf.view of the currently active embedded obsidian file.<br>" +
+    "If view is not provided, ea.targetView is used.<br>" +
+    "If the embedded file is a markdown document the function will return<br>" +
+    "<code>{file:TFile, editor:Editor}</code> otherwise it will return {view:any}. You can check view type with view.getViewType();",
+    after: "",
+  },
+  {
+    field: "getViewLastPointerPosition",
+    code: "getViewLastPointerPosition(): {x: number, y: number};",
+    desc: "@returns the last recorded pointer position on the Excalidraw canvas",
+    after: "",
+  },
+  {
+    field: "getleaf",
+    code: "getLeaf(origo: WorkspaceLeaf, targetPane?: PaneTarget): WorkspaceLeaf;",
+    desc: "Generates a new Obsidian Leaf following Excalidraw plugin settings such as open in Main Workspace or not, open in adjacent pane if available, etc.<br>" +
+      "@param origo: the currently active leaf, the origin of the new leaf<br>" + 
+      '@param targetPane: <code>type PaneTarget = "active-pane"|"new-pane"|"popout-window"|"new-tab"|"md-properties";',
+    after: "",
+  },
+  {
+    field: "newFilePrompt",
+    code: "async newFilePrompt(newFileNameOrPath: string, shouldOpenNewFile: boolean, targetPane?: PaneTarget, parentFile?: TFile): Promise<TFile | null>;",
+    desc: "",
+    after: "",
+  },
+  {
+    field: "DEVICE",
+    code: "get DEVICE(): DeviceType;",
+    desc: "Returns the current device type. Possible values are: <br>" +
+      "<code>type DeviceType = {<br>" +
+      "  isDesktop: boolean,<br>" +
+      "  isPhone: boolean,<br>" +
+      "  isTablet: boolean,<br>" +
+      "  isMobile: boolean,<br>" +
+      "  isLinux: boolean,<br>" +
+      "  isMacOS: boolean,<br>" +
+      "  isWindows: boolean,<br>" +
+      "  isIOS: boolean,<br>" +
+      "  isAndroid: boolean<br>" +
+      "};",
+    after: "",
+  },
+  {
+    field: "checkAndCreateFolder",
+    code: "async checkAndCreateFolder(folderpath: string): Promise<TFolder>",
+    desc: "Checks if the folder exists, if not, creates it.",
+    after: "",
+  },
+  {
+    field: "getNewUniqueFilepath",
+    code: "getNewUniqueFilepath(filename: string, folderpath: string): string",
+    desc: "Checks if the filepath already exists, if so, returns a new filepath with a number appended to the filename else returns the filepath as provided.",
+    after: "",
+  },
+  {
+    field: "extractCodeBlocks",
+    code: "extractCodeBlocks(markdown: string): { data: string, type: string }[]",
+    desc: "Grabs the codeblock content from the supplied markdown string. Returns an array of dictionaries with the codeblock content and type",
+    after: "",
+  },
+  {
+    field: "postOpenAI",
+    code: "async postOpenAI(request: AIRequest): Promise<RequestUrlResponse>",
+    desc:
+      "This asynchronous function should be awaited. It posts the supplied request to the OpenAI API and returns the response.<br>" +
+      "The response is a dictionary with the following keys:<br><code>{image, text, instruction, systemPrompt, responseType}</code><br>"+
+      "<b>image</b> should be a dataURL - use ea.createPNGBase64()<br>"+
+      "<b>systemPrompt</b>: if <code>undefined</code> the message to OpenAI will not include a system prompt<br>"+
+      "<b>text</b> is the actual user prompt, a request must have either an image or a text<br>"+
+      "<b>instruction</b> is a user prompt sent as a separate element in the message - I use it to reinforce the type of response I am seeing (e.g. mermaid in a codeblock)<br>"+
+      `<b>imageGenerationProperties</b> if provided then the dall-e model will be used. <code> imageGenerationProperties?: {size?: string, quality?: "standard" | "hd"; n?: number; mask?: string; }</code><br>` +
+      "Different openAI models accept different parameters fr size, quality, n and mask. Consult the API documenation for more information.<br>" +
+      `RequestUrlResponse is defined in the ${hyperlink("https://github.com/obsidianmd/obsidian-api/blob/master/obsidian.d.ts","Obsidian API")}`,
+    after: "",
+  },
+  {
+    field: "convertStringToDataURL",
+    code: 'async convertStringToDataURL (data:string, type: string = "text/html"):Promise<string>',
+    desc: "Converts a string to a DataURL.",
     after: "",
   },
   {
@@ -530,8 +714,9 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
   },
   {
     field: "viewUpdateScene",
-    code: "viewUpdateScene(scene:{elements?:ExcalidrawElement[],appState?: AppState,files?: BinaryFileData,commitToHistory?: boolean,},restore:boolean=false):void",
-    desc: "Calls the ExcalidrawAPI updateScene function for the targetView. When restore=true, excalidraw will try to correct errors in the scene such as setting default values to missing element properties.",
+    code: "viewUpdateScene(scene:{elements?:ExcalidrawElement[],appState?: AppState,files?: BinaryFileData,commitToHistory?: boolean,storeAction?: 'capture' | 'none' | 'update'},restore:boolean=false):void",
+    desc: "Calls the ExcalidrawAPI updateScene function for the targetView. When restore=true, excalidraw will try to correct errors in the scene such as setting default values to missing element properties. " +
+      `Note that commitToHistory has been deprecated in Excalidraw and is no longer used. You should use storeAction instead. See ${hyperlink("https://github.com/excalidraw/excalidraw/pull/7898", "ExcalidrawAPI")} documentation for more information.`,
     after: "",
   },
   {
@@ -540,6 +725,18 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
     desc: "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.",
     after: "",
   },
+  {
+    field: "compressToBase64",
+    code: "compressToBase64(str: string):string",
+    desc: "Compresses String to a Base64 string using LZString",
+    after: "",
+  },
+  {
+    field: "decompressFromBase64",
+    code: "decompressFromBase64(str: string):string",
+    desc: "Decompresses a base 64 compressed string using LZString",
+    after: "",
+  },
 ];
 
 export const EXCALIDRAW_SCRIPTENGINE_INFO: SuggesterInfo[] = [
@@ -661,6 +858,18 @@ export const FRONTMATTER_KEYS_INFO: SuggesterInfo[] = [
     desc: "If this key is present it will override the default excalidraw embed and export setting. This only affects export to PNG. Specify the export scale for the image. The typical range is between 0.5 and 5, but you can experiment with other values as well.",
     after: ": 1",
   },
+  {
+    field: "excalidraw-export-embed-scene",
+    code: null,
+    desc: "If this key is present it will override the default excalidraw embed and export setting.",
+    after: ": false",
+  },
+  {
+    field: "open-md",
+    code: null,
+    desc: "If this key is present the file will be opened as a markdown file in the editor",
+    after: ": true",
+  },
   {
     field: "autoexport",
     code: null,
@@ -668,11 +877,15 @@ export const FRONTMATTER_KEYS_INFO: SuggesterInfo[] = [
     after: ": png",
   },
   {
-    field: "iframe-theme",
+    field: "embeddable-theme",
     code: null,
-    desc: "Override iFrame theme plugin-settings for this file. 'match' will match the Excalidraw theme, 'default' will match the obsidian theme. Valid values are\ndark\nlight\nauto\ndefault",
+    desc: "Override embeddable's theme plugin-settings for this file. 'auto' will match the Excalidraw theme, 'default' will match the Obsidian theme. Valid values are\ndark\nlight\nauto\ndefault",
     after: ": auto",
   },
-
-  
+  {
+    field: "mask",
+    code: null,
+    desc: "If this key is present the drawing will be handled as a mask to crop an image.",
+    after: ": true",
+  },
 ];

src/dialogs/UniversalInsertFileModal.ts

@@ -3,11 +3,11 @@ import ExcalidrawView from "../ExcalidrawView";
 import ExcalidrawPlugin from "../main";
 import {  Modal, Setting, TextComponent } from "obsidian";
 import { FileSuggestionModal } from "./FolderSuggester";
-import { IMAGE_TYPES, sceneCoordsToViewportCoords, viewportCoordsToSceneCoords, MAX_IMAGE_SIZE } from "src/constants";
+import { IMAGE_TYPES, sceneCoordsToViewportCoords, viewportCoordsToSceneCoords, MAX_IMAGE_SIZE, ANIMATED_IMAGE_TYPES, MD_EX_SECTIONS } from "src/constants/constants";
 import { insertEmbeddableToView, insertImageToView } from "src/utils/ExcalidrawViewUtils";
 import { getEA } from "src";
 import { InsertPDFModal } from "./InsertPDFModal";
-import {  ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/types";
+import {  ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/excalidraw/types";
 import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
 import { cleanSectionHeading } from "src/utils/ObsidianUtils";
 
@@ -19,7 +19,7 @@ export class UniversalInsertFileModal extends Modal {
     private plugin: ExcalidrawPlugin,
     private view: ExcalidrawView,
   ) {
-    super(app);
+    super(plugin.app);
     const appState = (view.excalidrawAPI as ExcalidrawImperativeAPI).getAppState();
     const containerRect = view.containerEl.getBoundingClientRect();
     const viewportWidth = window.innerWidth || document.documentElement.clientWidth;
@@ -78,45 +78,51 @@ export class UniversalInsertFileModal extends Modal {
 
     const updateForm = async () => {
       const ea = this.plugin.ea;
+      const isSelf = file === this.view.file;
       const isMarkdown = file && file.extension === "md" && !ea.isExcalidrawFile(file);
       const isImage = file && (IMAGE_TYPES.contains(file.extension) || ea.isExcalidrawFile(file));
+      const isAnimatedImage = file && ANIMATED_IMAGE_TYPES.contains(file.extension);
       const isIFrame = file && !isImage;
       const isPDF = file && file.extension === "pdf";
       const isExcalidraw = file && ea.isExcalidrawFile(file);
 
-      if (isMarkdown) {
+      const sections = (file && file.extension === "md")
+      ? (await this.plugin.app.metadataCache.blockCache
+           .getForFile({ isCancelled: () => false },file))
+           .blocks.filter((b: any) => b.display && b.node?.type === "heading")
+           .filter((b: any) => !isExcalidraw || !MD_EX_SECTIONS.includes(b.display))
+      : null;
+
+      if (isMarkdown || (isExcalidraw && sections?.length > 0)) {
         sectionPickerSetting.settingEl.style.display = "";
         sectionPicker.selectEl.style.display = "block";
         while(sectionPicker.selectEl.options.length > 0) {
           sectionPicker.selectEl.remove(0);
         }
-        sectionPicker.addOption("","");
-        (await app.metadataCache.blockCache
-          .getForFile({ isCancelled: () => false },file))
-          .blocks.filter((b: any) => b.display && b.node?.type === "heading")
-          .forEach((b: any) => {
-            sectionPicker.addOption(
-              `#${cleanSectionHeading(b.display)}`,
-              b.display)
-          });
+        if(!isExcalidraw) sectionPicker.addOption("","");
+        sections.forEach((b: any) => {
+          sectionPicker.addOption(
+            `#${cleanSectionHeading(b.display)}`,
+            b.display)
+        });
       } else {
         sectionPickerSetting.settingEl.style.display = "none";
         sectionPicker.selectEl.style.display = "none";
       }
 
-      if (isExcalidraw) {
+      if (isExcalidraw && !isSelf) {
         sizeToggleSetting.settingEl.style.display = "";
       } else {
         sizeToggleSetting.settingEl.style.display = "none";
       }
 
-      if (isImage || (file?.extension === "md")) {
+      if (!isSelf && (isImage || (file?.extension === "md"))) {
         actionImage.buttonEl.style.display = "block";
       } else {
         actionImage.buttonEl.style.display = "none";
       }
 
-      if (isIFrame) {
+      if (isIFrame || isAnimatedImage || (isExcalidraw && sections?.length > 0)) {
         actionIFrame.buttonEl.style.display = "block";
       } else {
         actionIFrame.buttonEl.style.display = "none";
@@ -130,9 +136,17 @@ export class UniversalInsertFileModal extends Modal {
 
     }
 
+    const sections = (await this.plugin.app.metadataCache.blockCache
+      .getForFile({ isCancelled: () => false },this.view.file))
+      .blocks.filter((b: any) => b.display && b.node?.type === "heading")
+      .filter((b: any) => !MD_EX_SECTIONS.includes(b.display));
+
     const search = new TextComponent(ce);
     search.inputEl.style.width = "100%";
-    const suggester = new FileSuggestionModal(this.app, search,app.vault.getFiles().filter((f: TFile) => f!==this.view.file));
+    const suggester = new FileSuggestionModal(
+      this.app,
+      search,
+      this.app.vault.getFiles().filter((f: TFile) => sections?.length > 0 || f!==this.view.file));
     search.onChange(() => {
       file = suggester.getSelectedItem();
       updateForm();  
@@ -158,7 +172,7 @@ export class UniversalInsertFileModal extends Modal {
     new Setting(ce)
       .addButton(button => {
         button
-          .setButtonText("as iFrame")
+          .setButtonText("as Embeddable")
           .onClick(async () => {
             const path = app.metadataCache.fileToLinktext(
               file,

src/index.ts

@@ -2,8 +2,8 @@ import "obsidian";
 //import { ExcalidrawAutomate } from "./ExcalidrawAutomate";
 //export ExcalidrawAutomate from "./ExcalidrawAutomate";
 //export {ExcalidrawAutomate} from  "./ExcaildrawAutomate";
-export type { ExcalidrawBindableElement, ExcalidrawElement, FileId, FillStyle, StrokeRoundness, StrokeStyle } from "@zsviczian/excalidraw/types/element/types";
-export type { Point } from "@zsviczian/excalidraw/types/types";
+export type { ExcalidrawBindableElement, ExcalidrawElement, FileId, FillStyle, StrokeRoundness, StrokeStyle } from "@zsviczian/excalidraw/types/excalidraw/element/types";
+export type { Point } from "@zsviczian/excalidraw/types/excalidraw/types";
 export const getEA = (view?:any): any => {
   try {
     return window.ExcalidrawAutomate.getAPI(view);

src/lang/helpers.ts

@@ -25,6 +25,7 @@ import ru from "./locale/ru";
 import tr from "./locale/tr";
 import zhCN from "./locale/zh-cn";
 import zhTW from "./locale/zh-tw";
+import { LOCALE } from "src/constants/constants";
 
 const localeMap: { [k: string]: Partial<typeof en> } = {
   ar,
@@ -52,16 +53,9 @@ const localeMap: { [k: string]: Partial<typeof en> } = {
   "zh-tw": zhTW,
 };
 
-const locale = localeMap[moment.locale()];
+const locale = localeMap[LOCALE];
 
 export function t(str: keyof typeof en): string {
-  if (!locale) {
-    errorlog({
-      where: "helpers.t",
-      message: "Error: Excalidraw locale not found",
-      locale: moment.locale(),
-    });
-  }
 
   return (locale && locale[str]) || en[str];
 }

src/lang/locale/en.ts

@@ -1,14 +1,19 @@
 import {
   DEVICE,
-  FRONTMATTER_KEY_CUSTOM_LINK_BRACKETS,
-  FRONTMATTER_KEY_CUSTOM_PREFIX,
-  FRONTMATTER_KEY_CUSTOM_URL_PREFIX,
-} from "src/constants";
+  FRONTMATTER_KEYS,
+} from "src/constants/constants";
 import { labelALT, labelCTRL, labelMETA, labelSHIFT } from "src/utils/ModifierkeyHelper";
 
 // English
 export default {
   // main.ts
+  CONVERT_URL_TO_FILE: "Save image from URL to local file",
+  UNZIP_CURRENT_FILE: "Decompress current Excalidraw file",
+  ZIP_CURRENT_FILE: "Compress current Excalidraw file",
+  PUBLISH_SVG_CHECK: "Obsidian Publish: Find SVG and PNG exports that are out of date",
+  EMBEDDABLE_PROPERTIES: "Embeddable Properties",
+  EMBEDDABLE_RELATIVE_ZOOM: "Scale selected embeddable elements to 100% relative to the current canvas zoom",
+  OPEN_IMAGE_SOURCE: "Open Excalidraw drawing",
   INSTALL_SCRIPT: "Install the script",
   UPDATE_SCRIPT: "Update available - Click to install",
   CHECKING_SCRIPT:
@@ -19,7 +24,7 @@ export default {
     "Script is up to date - Click to reinstall",
   OPEN_AS_EXCALIDRAW: "Open as Excalidraw Drawing",
   TOGGLE_MODE: "Toggle between Excalidraw and Markdown mode",
-  CONVERT_NOTE_TO_EXCALIDRAW: "Convert empty note to Excalidraw Drawing",
+  CONVERT_NOTE_TO_EXCALIDRAW: "Convert markdown note to Excalidraw Drawing",
   CONVERT_EXCALIDRAW: "Convert *.excalidraw to *.md files",
   CREATE_NEW: "Create new drawing",
   CONVERT_FILE_KEEP_EXT: "*.excalidraw => *.excalidraw.md",
@@ -31,6 +36,7 @@ export default {
   TRANSCLUDE: "Embed a drawing",
   TRANSCLUDE_MOST_RECENT: "Embed the most recently edited drawing",
   TOGGLE_LEFTHANDED_MODE: "Toggle left-handed mode",
+  FLIP_IMAGE: "Open the back-of-the-note of the selected excalidraw image",
   NEW_IN_NEW_PANE: "Create new drawing - IN AN ADJACENT WINDOW",
   NEW_IN_NEW_TAB: "Create new drawing - IN A NEW TAB",
   NEW_IN_ACTIVE_PANE: "Create new drawing - IN THE CURRENT ACTIVE WINDOW",
@@ -44,6 +50,7 @@ export default {
   NEW_IN_POPOUT_WINDOW_EMBED: "Create new drawing - IN A POPOUT WINDOW - and embed into active document",
   TOGGLE_LOCK: "Toggle Text Element between edit RAW and PREVIEW",
   DELETE_FILE: "Delete selected image or Markdown file from Obsidian Vault",
+  COPY_ELEMENT_LINK: "Copy markdown link for selected element(s)",
   INSERT_LINK_TO_ELEMENT:
     `Copy markdown link for selected element to clipboard. ${labelCTRL()}+CLICK to copy 'group=' link. ${labelSHIFT()}+CLICK to copy an 'area=' link. ${labelALT()}+CLICK to watch a help video.`,
   INSERT_LINK_TO_ELEMENT_GROUP:
@@ -57,30 +64,60 @@ export default {
   INSERT_LINK_TO_ELEMENT_ERROR: "Select a single element in the scene",
   INSERT_LINK_TO_ELEMENT_READY: "Link is READY and available on the clipboard",
   INSERT_LINK: "Insert link to file",
+  INSERT_COMMAND: "Insert Obsidian Command as a link",
   INSERT_IMAGE: "Insert image or Excalidraw drawing from your vault",
   IMPORT_SVG: "Import an SVG file as Excalidraw strokes (limited SVG support, TEXT currently not supported)",
+  IMPORT_SVG_CONTEXTMENU: "Convert SVG to strokes - with limitations",
   INSERT_MD: "Insert markdown file from vault",
   INSERT_PDF: "Insert PDF file from vault",
-  UNIVERSAL_ADD_FILE: "Insert ANY file from your Vault to the active drawing",
+  UNIVERSAL_ADD_FILE: "Insert ANY file",
+  INSERT_CARD: "Add back-of-note card",
+  CONVERT_CARD_TO_FILE: "Move back-of-note card to File",
+  ERROR_TRY_AGAIN: "Please try again.",
+  PASTE_CODEBLOCK: "Paste code block",
   INSERT_LATEX:
     `Insert LaTeX formula (e.g. \\binom{n}{k} = \\frac{n!}{k!(n-k)!}). ${labelALT()}+CLICK to watch a help video.`,
   ENTER_LATEX: "Enter a valid LaTeX expression",
   READ_RELEASE_NOTES: "Read latest release notes",
-  RUN_OCR: "OCR: Grab text from freedraw scribble and pictures to clipboard",
+  RUN_OCR: "OCR full drawing: Grab text from freedraw + images to clipboard and doc.props",
+  RERUN_OCR: "OCR full drawing re-run: Grab text from freedraw + images to clipboard and doc.props",
+  RUN_OCR_ELEMENTS: "OCR selected elements: Grab text from freedraw + images to clipboard",
   TRAY_MODE: "Toggle property-panel tray-mode",
   SEARCH: "Search for text in drawing",
+  CROP_PAGE: "Crop and mask selected page",
+  CROP_IMAGE: "Crop and mask image",
+  ANNOTATE_IMAGE : "Annotate image in Excalidraw",
+  INSERT_ACTIVE_PDF_PAGE_AS_IMAGE: "Insert active PDF page as image",
   RESET_IMG_TO_100: "Set selected image element size to 100% of original",
   TEMPORARY_DISABLE_AUTOSAVE: "Disable autosave until next time Obsidian starts (only set this if you know what you are doing)",
   TEMPORARY_ENABLE_AUTOSAVE: "Enable autosave",
 
   //ExcalidrawView.ts
+  FORCE_SAVE_ABORTED: "Force Save aborted because saving is in progress",
+  LINKLIST_SECOND_ORDER_LINK: "Second Order Link",
+  MARKDOWN_EMBED_CUSTOMIZE_LINK_PROMPT_TITLE: "Customize the link",
+  MARKDOWN_EMBED_CUSTOMIZE_LINK_PROMPT: "Do not add [[square brackets]] around the filename!<br>Follow this format when editing your link:<br><mark>filename#^blockref|WIDTHxMAXHEIGHT</mark>",
+  FRAME_CLIPPING_ENABLED: "Frame Rendering: Enabled",
+  FRAME_CLIPPING_DISABLED: "Frame Rendering: Disabled",
+  ARROW_BINDING_INVERSE_MODE: "Inverted Mode: Default arrow binding is now disabled. Use CTRL/CMD to temporarily enable binding when needed.",
+  ARROW_BINDING_NORMAL_MODE: "Normal Mode: Arrow binding is now enabled. Use CTRL/CMD to temporarily disable binding when needed.",
+  EXPORT_FILENAME_PROMPT: "Please provide filename",
+  EXPORT_FILENAME_PROMPT_PLACEHOLDER: "filename, leave blank to cancel action",
+  WARNING_SERIOUS_ERROR: "WARNING: Excalidraw ran into an unknown problem!\n\n" +
+    "There is a risk that your most recent changes cannot be saved.\n\n" +
+    "To be on the safe side...\n" +
+    "1) Please select your drawing using CTRL/CMD+A and make a copy with CTRL/CMD+C.\n" +
+    "2) Then create an empty drawing in a new pane by CTRL/CMD+clicking the Excalidraw ribbon button,\n" +
+    "3) and paste your work to the new document with CTRL/CMD+V.",
+  ARIA_LABEL_TRAY_MODE: "Tray-mode offers an alternative, more spacious canvas",
+  MASK_FILE_NOTICE: "This is a mask file. It is used to crop images and mask out parts of the image. Press and hold notice to open the help video.",
   INSTALL_SCRIPT_BUTTON: "Install or update Excalidraw Scripts",
   OPEN_AS_MD: "Open as Markdown",
   EXPORT_IMAGE: `Export Image`,
   OPEN_LINK: "Open selected text as link\n(SHIFT+CLICK to open in a new pane)",
   EXPORT_EXCALIDRAW: "Export to an .Excalidraw file",
   LINK_BUTTON_CLICK_NO_TEXT:
-    "Select a ImageElement, or select a TextElement that contains an internal or external link.\n",
+    "Select an ImageElement, or select a TextElement that contains an internal or external link.\n",
   FILENAME_INVALID_CHARS:
     'File name cannot contain any of the following characters: * " \\ < > : | ? #',
   FORCE_SAVE:
@@ -96,9 +133,14 @@ export default {
   BACKUP_RESTORED: "Backup restored",
   CACHE_NOT_READY: "I apologize for the inconvenience, but an error occurred while loading your file.<br><br><mark>Having a little patience can save you a lot of time...</mark><br><br>The plugin has a backup cache, but it appears that you have just started Obsidian. Initializing the Backup Cache may take some time, usually up to a minute or more depending on your device's performance. You will receive a notification in the top right corner when the cache initialization is complete.<br><br>Please press OK to attempt loading the file again and check if the cache has finished initializing. If you see a completely empty file behind this message, I recommend waiting until the backup cache is ready before proceeding. Alternatively, you can choose Cancel to manually correct your file.<br>",
   OBSIDIAN_TOOLS_PANEL: "Obsidian Tools Panel",
-  ERROR_SAVING_IMAGE: "Unknown error occured while fetching the image. It could be that for some reason the image is not available or rejected the fetch request from Obsidian",
+  ERROR_SAVING_IMAGE: "Unknown error occurred while fetching the image. It could be that for some reason the image is not available or rejected the fetch request from Obsidian",
   WARNING_PASTING_ELEMENT_AS_TEXT: "PASTING EXCALIDRAW ELEMENTS AS A TEXT ELEMENT IS NOT ALLOWED",
   USE_INSERT_FILE_MODAL: "Use 'Insert Any File' to embed a markdown note",
+  CONVERT_TO_MARKDOWN: "Convert to file...",
+  SELECT_TEXTELEMENT_ONLY: "Select text element only (not container)",
+  REMOVE_LINK: "Remove text element link",
+  LASER_ON: "Enable laser pointer",
+  LASER_OFF: "Disable laser pointer",
 
   //settings.ts
   RELEASE_NOTES_NAME: "Display Release Notes after update",
@@ -110,29 +152,83 @@ export default {
       "<b><u>Toggle ON:</u></b> Show a notification when a new version of the plugin is available.<br>" +
       "<b><u>Toggle OFF:</u></b> Silent mode. You need to check for plugin updates in Community Plugins.",
   
+  BASIC_HEAD: "Basic",
+  BASIC_DESC: `In the "Basic" settings, you can configure options such as displaying release notes after updates, receiving plugin update notifications, setting the default location for new drawings, specifying the Excalidraw folder for embedding drawings into active documents, defining an Excalidraw template file, and designating an Excalidraw Automate script folder for managing automation scripts.`,
   FOLDER_NAME: "Excalidraw folder",
   FOLDER_DESC:
     "Default location for new drawings. If empty, drawings will be created in the Vault root.",
+  CROP_PREFIX_NAME: "Crop file prefix",
+  CROP_PREFIX_DESC:
+    "The first part of the filename for new drawings created when cropping an image. " +
+    "If empty the default 'cropped_' will be used.",  
+  ANNOTATE_PREFIX_NAME: "Annotation file prefix",
+  ANNOTATE_PREFIX_DESC:
+    "The first part of the filename for new drawings created when annotating an image. " +
+    "If empty the default 'annotated_' will be used.",
+  ANNOTATE_PRESERVE_SIZE_NAME: "Preserve image size when annotating",
+  ANNOTATE_PRESERVE_SIZE_DESC:
+    "When annotating an image in markdown the replacment image link will include the width of the original image.",
+  CROP_FOLDER_NAME: "Crop file folder",
+  CROP_FOLDER_DESC:
+    "Default location for new drawings created when cropping an image. If empty, drawings will be created following the Vault attachments settings.",
+  ANNOTATE_FOLDER_NAME: "Image annotation file folder",
+  ANNOTATE_FOLDER_DESC:
+    "Default location for new drawings created when annotating an image. If empty, drawings will be created following the Vault attachments settings.",
   FOLDER_EMBED_NAME:
     "Use Excalidraw folder when embedding a drawing into the active document",
   FOLDER_EMBED_DESC:
     "Define which folder to place the newly inserted drawing into " +
     "when using the command palette action: 'Create a new drawing and embed into active document'.<br>" +
     "<b><u>Toggle ON:</u></b> Use Excalidraw folder<br><b><u>Toggle OFF:</u></b> Use the attachments folder defined in Obsidian settings.",
-  TEMPLATE_NAME: "Excalidraw template file",
+  TEMPLATE_NAME: "Excalidraw template file or folder",
   TEMPLATE_DESC:
-    "Full filepath to the Excalidraw template. " +
-    "E.g.: If your template is in the default Excalidraw folder and its name is " +
+    "Full filepath or folderpath to the Excalidraw template.<br>" +
+    "<b>Template File:</b>E.g.: If your template is in the default Excalidraw folder and its name is " +
     "Template.md, the setting would be: Excalidraw/Template.md (or just Excalidraw/Template - you may omit the .md file extension). " +
     "If you are using Excalidraw in compatibility mode, then your template must be a legacy Excalidraw file as well " +
-    "such as Excalidraw/Template.excalidraw.",
+    "such as Excalidraw/Template.excalidraw. <br><b>Template Folder:</b> You can also set a folder as your template. " +
+    "In this case you will be prompted which tempalte to use when creating a new drawing.<br>" +
+    "<b>Pro Tip:</b> If you are using the Obsidian Templater plugin, you can add Templater code to your different Excalidraw " +
+    "templates to automate configuration of your drawings.",
   SCRIPT_FOLDER_NAME: "Excalidraw Automate script folder (CASE SeNSitiVE!)",
   SCRIPT_FOLDER_DESC:
     "The files you place in this folder will be treated as Excalidraw Automate scripts. " +
     "You can access your scripts from Excalidraw via the Obsidian Command Palette. Assign " +
     "hotkeys to your favorite scripts just like to any other Obsidian command. " +
     "The folder may not be the root folder of your Vault. ",
+  AI_HEAD: "AI Settings - Experimental",
+  AI_DESC: `In the "AI" settings, you can configure options for using OpenAI's GPT API. ` +
+    `While the OpenAI API is in beta, its use is strictly limited — as such we require you use your own API key. ` +
+    `You can create an OpenAI account, add a small credit (5 USD minimum), and generate your own API key. ` +
+    `Once API key is set, you can use the AI tools in Excalidraw.`,
+  AI_OPENAI_TOKEN_NAME: "OpenAI API key",
+  AI_OPENAI_TOKEN_DESC:
+    "You can get your OpenAI API key from your <a href='https://platform.openai.com/api-keys'>OpenAI account</a>.",
+  AI_OPENAI_TOKEN_PLACEHOLDER: "Enter your OpenAI API key here",
+  AI_OPENAI_DEFAULT_MODEL_NAME: "Default AI model",
+  AI_OPENAI_DEFAULT_MODEL_DESC:
+    "The default AI model to use when generating text. This is a freetext field, so you can enter any valid OpenAI model name. " +
+    "Find out more about the available models on the <a href='https://platform.openai.com/docs/models'>OpenAI website</a>.",
+  AI_OPENAI_DEFAULT_MODEL_PLACEHOLDER: "Enter your default AI model here. e.g.: gpt-3.5-turbo-1106",
+  AI_OPENAI_DEFAULT_IMAGE_MODEL_NAME: "Default Image Generation AI model",
+  AI_OPENAI_DEFAULT_IMAGE_MODEL_DESC:
+    "The default AI model to use when generating images. Image editing and variations are only supported by dall-e-2 at this time by OpenAI, " +
+    "for this reason dall-e-2 will automatically be used in such cases regardless of this setting.<br>" +
+    "This is a freetext field, so you can enter any valid OpenAI model name. " +
+    "Find out more about the available models on the <a href='https://platform.openai.com/docs/models'>OpenAI website</a>.",
+  AI_OPENAI_DEFAULT_IMAGE_MODEL_PLACEHOLDER: "Enter your default Image Generation AI model here e.g.: dall-e-3",
+  AI_OPENAI_DEFAULT_VISION_MODEL_NAME: "Default AI vision model",
+  AI_OPENAI_DEFAULT_VISION_MODEL_DESC:
+    "The default AI vision model to use when generating text from images. This is a freetext field, so you can enter any valid OpenAI model name. " +
+    "Find out more about the available models on the <a href='https://platform.openai.com/docs/models'>OpenAI website</a>.",
+  AI_OPENAI_DEFAULT_API_URL_NAME: "OpenAI API URL",
+  AI_OPENAI_DEFAULT_API_URL_DESC:
+    "The default OpenAI API URL. This is a freetext field, so you can enter any valid OpenAI API compatible URL. " +
+    "Excalidraw will use this URL when posting API requests to OpenAI. I am not doing any error handling on this field, so make sure you enter a valid URL and only change this if you know what you are doing. ",
+  AI_OPENAI_DEFAULT_IMAGE_API_URL_NAME: "OpenAI Image Generation API URL",
+  AI_OPENAI_DEFAULT_VISION_MODEL_PLACEHOLDER: "Enter your default AI vision model here. e.g.: gpt-4-vision-preview",
   SAVING_HEAD: "Saving",
+  SAVING_DESC: "In the 'Saving' section of Excalidraw Settings, you can configure how your drawings are saved. This includes options for compressing Excalidraw JSON in Markdown, setting autosave intervals for both desktop and mobile, defining filename formats, and choosing whether to use the .excalidraw.md or .md file extension. ",
   COMPRESS_NAME: "Compress Excalidraw JSON in Markdown",
   COMPRESS_DESC:
     "By enabling this feature Excalidraw will store the drawing JSON in a Base64 compressed " +
@@ -144,6 +240,14 @@ export default {
     "once you switch back to Excalidraw view. " +
     "The setting only has effect 'point forward', meaning, existing drawings will not be affected by the setting " +
     "until you open them and save them.<br><b><u>Toggle ON:</u></b> Compress drawing JSON<br><b><u>Toggle OFF:</u></b> Leave drawing JSON uncompressed",
+  DECOMPRESS_FOR_MD_NAME: "Decompress Excalidraw JSON in Markdown View",
+  DECOMPRESS_FOR_MD_DESC:
+    "By enabling this feature Excalidraw will automatically decompress the drawing JSON when you switch to Markdown view. " +
+    "This will allow you to easily read and edit the JSON string. The drawing will be compressed again " +
+    "once you switch back to Excalidraw view and save the drawing (CTRL+S).<br>" +
+    "I recommend switching this feature off as it will result in smaller file sizes and avoiding unnecessary results in Obsidian search. " +
+    "You can always use the 'Excalidraw: Decompress current Excalidraw file' command from the command palette "+
+    "to manually decompress the drawing JSON when you need to read or edit it.",
   AUTOSAVE_INTERVAL_DESKTOP_NAME: "Interval for autosave on Desktop",
   AUTOSAVE_INTERVAL_DESKTOP_DESC:
     "The time interval between saves. Autosave will skip if there are no changes in the drawing. " +
@@ -180,7 +284,8 @@ FILENAME_HEAD: "Filename",
   FILENAME_EXCALIDRAW_EXTENSION_DESC:
     "This setting does not apply if you use Excalidraw in compatibility mode, " +
     "i.e. you are not using Excalidraw markdown files.<br><b><u>Toggle ON:</u></b> filename ends with .excalidraw.md<br><b><u>Toggle OFF:</u></b> filename ends with .md",
-  DISPLAY_HEAD: "Display",
+  DISPLAY_HEAD: "Excalidraw appearance and behavior",
+  DISPLAY_DESC: "In the 'appearance and behavior' section of Excalidraw Settings, you can fine-tune how Excalidraw appears and behaves. This includes options for dynamic styling, left-handed mode, matching Excalidraw and Obsidian themes, default modes, and more.",
   DYNAMICSTYLE_NAME: "Dynamic styling",
   DYNAMICSTYLE_DESC:
     "Change Excalidraw UI colors to match the canvas color",
@@ -213,7 +318,26 @@ FILENAME_HEAD: "Filename",
   DEFAULT_PEN_MODE_NAME: "Pen mode",
   DEFAULT_PEN_MODE_DESC:
     "Should pen mode be automatically enabled when opening Excalidraw?",
-
+  SHOW_PEN_MODE_FREEDRAW_CROSSHAIR_NAME: "Show (+) crosshair in pen mode",
+  SHOW_PEN_MODE_FREEDRAW_CROSSHAIR_DESC:
+    "Show crosshair in pen mode when using the freedraw tool. <b><u>Toggle ON:</u></b> SHOW <b><u>Toggle OFF:</u></b> HIDE<br>"+
+    "The effect depends on the device. Crosshair is typically visible on drawing tablets, MS Surface, but not on iOS.",
+  SHOW_DRAWING_OR_MD_IN_HOVER_PREVIEW_NAME: "Render image in hover preview for MD files",
+  SHOW_DRAWING_OR_MD_IN_HOVER_PREVIEW_DESC:
+    "This setting effects files that have the <b>excalidraw-open-md: true</b> frontmatter key.",
+  SHOW_DRAWING_OR_MD_IN_READING_MODE_NAME: "Render image when in markdown reading mode",
+  SHOW_DRAWING_OR_MD_IN_READING_MODE_DESC:
+    "Must close the active excalidraw/markdown file and reopen it for this change to take effect.<br>When you are in markdown reading mode (aka. reading the back side of the drawing), should the Excalidraw drawing be rendered as an image? " +
+    "This setting will not affect the display of the drawing when you are in Excalidraw mode, when you embed the drawing into a markdown document or when rendering hover preview.<br><ul>" +
+    "<li>See other related setting for <b>PDF Export</b> under 'Embedding and Exporting' further below.</li>" +
+    "<li>Be sure to check out the <b>Fade Out setting</b> in the 'Miscellaneous fetures' section.</li></ul>",
+  SHOW_DRAWING_OR_MD_IN_EXPORTPDF_NAME: "Render image when EXPORT TO PDF in markdown mode",
+  SHOW_DRAWING_OR_MD_IN_EXPORTPDF_DESC:
+    "Must close the active excalidraw/markdown file and reopen for this change to take effect.<br>When you are printing the markdown side of the note to PDF (aka. the back side of the drawing), should the Excalidraw drawing be rendered as an image?<br><ul>" +
+    "<li>See other related setting for <b>Markdown Reading Mode</b> under 'Appearnace and Behavior' further above.</li>" +
+    "<li>Be sure to check out the <b>Fade Out setting</b> in the 'Miscellaneous fetures' section.</li></ul>",
+  THEME_HEAD: "Theme and styling",
+  ZOOM_HEAD: "Zoom",
   DEFAULT_PINCHZOOM_NAME: "Allow pinch zoom in pen mode",
   DEFAULT_PINCHZOOM_DESC:
     "Pinch zoom in pen mode when using the freedraw tool is disabled by default to prevent unwanted accidental zooming with your palm.<br>" +
@@ -232,7 +356,14 @@ FILENAME_HEAD: "Filename",
   ZOOM_TO_FIT_MAX_LEVEL_NAME: "Zoom to fit max ZOOM level",
   ZOOM_TO_FIT_MAX_LEVEL_DESC:
     "Set the maximum level to which zoom to fit will enlarge the drawing. Minimum is 0.5 (50%) and maximum is 10 (1000%).",
-  LINKS_HEAD: "Links and transclusion",
+  LASER_HEAD: "Laser pointer",
+  LASER_COLOR: "Laser pointer color",
+  LASER_DECAY_TIME_NAME: "Laser pointer decay time",
+  LASER_DECAY_TIME_DESC: "Laser pointer decay time in milliseconds. Default is 1000 (i.e. 1 second).",
+  LASER_DECAY_LENGTH_NAME: "Laser pointer decay length.",
+  LASER_DECAY_LENGTH_DESC: "Laser pointer decay length in line points. Default is 50.",
+  LINKS_HEAD: "Links, transclusion and TODOs",
+  LINKS_HEAD_DESC: "In the 'Links, transclusion and TODOs' section of Excalidraw Settings, you can configure how Excalidraw handles links, transclusions, and TODO items. This includes options for opening links, managing panes, displaying links with brackets, customizing link prefixes, handling TODO items, and more. ",
   LINKS_DESC:
     `${labelCTRL()}+CLICK on <code>[[Text Elements]]</code> to open them as links. ` +
     "If the selected text has more than one <code>[[valid Obsidian links]]</code>, only the first will be opened. " +
@@ -240,33 +371,51 @@ FILENAME_HEAD: "Filename",
     "the plugin will open it in a browser. " +
     "When Obsidian files change, the matching <code>[[link]]</code> in your drawings will also change. " +
     "If you don't want text accidentally changing in your drawings use <code>[[links|with aliases]]</code>.",
+  DRAG_MODIFIER_NAME: "Link Click and Drag&Drop Modifier Keys",
+  DRAG_MODIFIER_DESC: "Modifier key behavior when clicking links and dragging and dropping elements. " +
+    "Excalidraw will not validate your configuration... pay attention to avoid conflicting settings. " +
+    "These settings are different for Apple and non-Apple. If you use Obsidian on multiple platforms, you'll need to make the settings separately. "+
+    "The toggles follow the order of " +
+    (DEVICE.isIOS || DEVICE.isMacOS ? "SHIFT, CMD, OPT, CONTROL." : "SHIFT, CTRL, ALT, META (Windows key)."),
+  LONG_PRESS_DESKTOP_NAME: "Long press to open desktop",
+  LONG_PRESS_DESKTOP_DESC: "Long press delay in milliseconds to open an Excalidraw Drawing embedded in a Markdown file. ",
+  LONG_PRESS_MOBILE_NAME: "Long press to open mobile",
+  LONG_PRESS_MOBILE_DESC: "Long press delay in milliseconds to open an Excalidraw Drawing embedded in a Markdown file. ",
+
+  FOCUS_ON_EXISTING_TAB_NAME: "Focus on Existing Tab",
+  FOCUS_ON_EXISTING_TAB_DESC: "When opening a link, Excalidraw will focus on the existing tab if the file is already open. " +
+    "Enabling this setting overrides 'Reuse Adjacent Pane' when the file is already open.",
+  SECOND_ORDER_LINKS_NAME: "Show second-order links",
+  SECOND_ORDER_LINKS_DESC: "Show links when clicking on a link in Excalidraw. Second-order link are backlinks pointing to the link being clicked. " +
+    "When using image icons to connect similar notes, second order links allow you to get to related notes in one click instead of two. " +
+    "See <a href='https://youtube.com/shorts/O_1ls9c6wBY?feature=share'>YT Short</a> to understand.",
   ADJACENT_PANE_NAME: "Reuse adjacent pane",
   ADJACENT_PANE_DESC:
-    `When ${labelCTRL()}+${labelSHIFT()} clicking a link in Excalidraw, by default the plugin will open the link in a new pane. ` +
+    `When ${labelCTRL()}+${labelALT()} clicking a link in Excalidraw, by default the plugin will open the link in a new pane. ` +
     "Turning this setting on, Excalidraw will first look for an existing pane, and try to open the link there. " +
     "Excalidraw will look for the other workspace pane based on your focus/navigation history, i.e. the workpane that was active before you " +
     "activated Excalidraw.",
   MAINWORKSPACE_PANE_NAME: "Open in main workspace",
   MAINWORKSPACE_PANE_DESC:
-    `When ${labelCTRL()}+${labelSHIFT()} clicking a link in Excalidraw, by default the plugin will open the link in a new pane in the current active window. ` +
+    `When ${labelCTRL()}+${labelALT()} clicking a link in Excalidraw, by default the plugin will open the link in a new pane in the current active window. ` +
     "Turning this setting on, Excalidraw will open the link in an existing or new pane in the main workspace. ",  
   LINK_BRACKETS_NAME: "Show <code>[[brackets]]</code> around links",
   LINK_BRACKETS_DESC: `${
     "In PREVIEW mode, when parsing Text Elements, place brackets around links. " +
     "You can override this setting for a specific drawing by adding <code>"
-  }${FRONTMATTER_KEY_CUSTOM_LINK_BRACKETS}: true/false</code> to the file's frontmatter.`,
+  }${FRONTMATTER_KEYS["link-brackets"].name}: true/false</code> to the file's frontmatter.`,
   LINK_PREFIX_NAME: "Link prefix",
   LINK_PREFIX_DESC: `${
     "In PREVIEW mode, if the Text Element contains a link, precede the text with these characters. " +
     "You can override this setting for a specific drawing by adding <code>"
-  }${FRONTMATTER_KEY_CUSTOM_PREFIX}: "📍 "</code> to the file's frontmatter.`,
+  }${FRONTMATTER_KEYS["link-prefix"].name}: "📍 "</code> to the file's frontmatter.`,
   URL_PREFIX_NAME: "URL prefix",
   URL_PREFIX_DESC: `${
     "In PREVIEW mode, if the Text Element contains a URL link, precede the text with these characters. " +
     "You can override this setting for a specific drawing by adding <code>"
-  }${FRONTMATTER_KEY_CUSTOM_URL_PREFIX}: "🌐 "</code> to the file's frontmatter.`,
+  }${FRONTMATTER_KEYS["url-prefix"].name}: "🌐 "</code> to the file's frontmatter.`,
   PARSE_TODO_NAME: "Parse todo",
-  PARSE_TODO_DESC: "Convert '- [ ] ' and '- [x] ' to checkpox and tick in the box.",
+  PARSE_TODO_DESC: "Convert '- [ ] ' and '- [x] ' to checkbox and tick in the box.",
   TODO_NAME: "Open TODO icon",
   TODO_DESC: "Icon to use for open TODO items",
   DONE_NAME: "Completed TODO icon",
@@ -283,7 +432,7 @@ FILENAME_HEAD: "Filename",
     `${labelCTRL()}+CLICK on text with [[links]] or [](links) to open them`,
   LINK_CTRL_CLICK_DESC:
     "You can turn this feature off if it interferes with default Excalidraw features you want to use. If " +
-    "this is turned off, only the link button in the title bar of the drawing pane will open links.",
+    `this is turned off, you can either use ${labelCTRL()} + ${labelMETA()} or the link indicator in the top right of the element to open links.`,
   TRANSCLUSION_WRAP_NAME: "Overflow wrap behavior of transcluded text",
   TRANSCLUSION_WRAP_DESC:
     "Number specifies the character count where the text should be wrapped. " +
@@ -304,11 +453,15 @@ FILENAME_HEAD: "Filename",
   GET_URL_TITLE_NAME: "Use iframely to resolve page title",
   GET_URL_TITLE_DESC:
     "Use the <code>http://iframely.server.crestify.com/iframely?url=</code> to get title of page when dropping a link into Excalidraw",
-  MD_HEAD: "Markdown-embed settings",
-  MD_HEAD_DESC:
-    `You can transclude formatted markdown documents into drawings as images ${labelSHIFT()} drop from the file explorer or using ` +
-    "the command palette action.",
-  
+  PDF_TO_IMAGE: "PDF to Image",
+  PDF_TO_IMAGE_SCALE_NAME: "PDF to Image conversion scale",
+  PDF_TO_IMAGE_SCALE_DESC: "Sets the resolution of the image that is generated from the PDF page. Higher resolution will result in bigger images in memory and consequently a higher load on your system (slower performance), but sharper imagee. " +
+    "Additionally, if you want to copy PDF pages (as images) to Excalidraw.com, the bigger image size may result in exceeding the 2MB limit on Excalidraw.com.",
+  EMBED_TOEXCALIDRAW_HEAD: "Embed files into Excalidraw",
+  EMBED_TOEXCALIDRAW_DESC: "In the Embed Files section of Excalidraw Settings, you can configure how various files are embedded into Excalidraw. This includes options for embedding interactive markdown files, PDFs, and markdown files as images.",
+  MD_HEAD: "Embed markdown into Excalidraw as image",
+  MD_EMBED_CUSTOMDATA_HEAD_NAME: "Interactive Markdown Files",
+  MD_EMBED_CUSTOMDATA_HEAD_DESC: `These settings will only effect future embeds. Current embeds remain unchanged. The theme setting of embedded frames is under the "Excalidraw appearance and behavior" section.`,
   MD_TRANSCLUDE_WIDTH_NAME: "Default width of a transcluded markdown document",
   MD_TRANSCLUDE_WIDTH_DESC:
     "The width of the markdown page. This affects the word wrapping when transcluding longer paragraphs, and the width of " +
@@ -344,13 +497,25 @@ FILENAME_HEAD: "Filename",
     "Setting the font-family in the css is has limitations. By default only your operating system's standard fonts are available (see README for details). " +
     "You can add one custom font beyond that using the setting above. " +
     'You can override this css setting by adding the following frontmatter-key to the embedded markdown file: "excalidraw-css: css_file_in_vault|css-snippet".',
-  EMBED_HEAD: "Embed & Export",
+  EMBED_HEAD: "Embedding Excalidraw into your Notes and Exporting",
+  EMBED_DESC: `In the "Embed & Export" settings, you can configure how images and Excalidraw drawings are embedded and exported within your documents. Key settings include choosing the image type for markdown preview (such as Native SVG or PNG), specifying the type of file to insert into the document (original Excalidraw, PNG, or SVG), and managing image caching for embedding in markdown. You can also control image sizing, whether to embed drawings using wiki links or markdown links, and adjust settings related to image themes, background colors, and Obsidian integration. 
+    Additionally, there are settings for auto-export, which automatically generates SVG and/or PNG files to match the title of your Excalidraw drawings, keeping them in sync with file renames and deletions.`,
+  EMBED_CANVAS: "Obsidian Canvas support",
+  EMBED_CANVAS_NAME: "Immersive embedding",
+  EMBED_CANVAS_DESC: 
+    "Hide canvas node border and background when embedding an Excalidraw drawing to Canvas. " +
+    "Note that for a full transparent background for your image, you will still need to configure Excalidraw to export images with transparent background.",
   EMBED_CACHING: "Image caching",
+  EXPORT_SUBHEAD: "Export Settings",
   EMBED_SIZING: "Image sizing",
   EMBED_THEME_BACKGROUND: "Image theme and background color",
   EMBED_IMAGE_CACHE_NAME: "Cache images for embedding in markdown",
   EMBED_IMAGE_CACHE_DESC: "Cache images for embedding in markdown. This will speed up the embedding process, but in case you compose images of several sub-component drawings, " +
     "the embedded image in Markdown won't update until you open the drawing and save it to trigger an update of the cache.",
+  SCENE_IMAGE_CACHE_NAME: "Cache nested Excalidraws in Scene",
+  SCENE_IMAGE_CACHE_DESC: "Cache nested Excalidraws in the Scene for faster scene rendering. This will speed up the rendering process, especially if you have deeply nested Excalidraws in your scene. " + 
+    "Excalidraw will try to intelligently identify if any children of a nested Excalidraw have changed and will update the cache accordingly. " +
+    "You may want to turn this off, in case you are suspecting that the cache is not updating properly.",
   EMBED_IMAGE_CACHE_CLEAR: "Purge Cache",
   BACKUP_CACHE_CLEAR: "Purge Backups",
   BACKUP_CACHE_CLEAR_CONFIRMATION: "This action will delete all Excalidraw drawing backups. Backups are used as a safety measure in case your drawing file gets damaged. Each time you open Obsidian the plugin automatically deletes backups for files that no longer exist in your Vault. Are you sure you want to clear all backups?",
@@ -380,12 +545,22 @@ FILENAME_HEAD: "Filename",
     "The default width of an embedded drawing. This applies to live preview edit and reading mode, as well as to hover previews. You can specify a custom " +
     "width when embedding an image using the <code>![[drawing.excalidraw|100]]</code> or " +
     "<code>[[drawing.excalidraw|100x100]]</code> format.",
+  EMBED_HEIGHT_NAME: "Default height of embedded (transcluded) image",
+  EMBED_HEIGHT_DESC:
+    "The default height of an embedded drawing. This applies to live preview edit and reading mode, as well as to hover previews. You can specify a custom " +
+    "height when embedding an image using the <code>![[drawing.excalidraw|100]]</code> or " +
+    "<code>[[drawing.excalidraw|100x100]]</code> format.",
   EMBED_TYPE_NAME: "Type of file to insert into the document",
   EMBED_TYPE_DESC:
     "When you embed an image into a document using the command palette this setting will specify if Excalidraw should embed the original Excalidraw file " +
     "or a PNG or an SVG copy. You need to enable auto-export PNG / SVG (see below under Export Settings) for those image types to be available in the dropdown. For drawings that do not have a " +
     "a corresponding PNG or SVG readily available the command palette action will insert a broken link. You need to open the original drawing and initiate export manually. " +
     "This option will not autogenerate PNG/SVG files, but will simply reference the already existing files.",
+  EMBED_MARKDOWN_COMMENT_NAME: "Embed link to drawing as comment",
+  EMBED_MARKDOWN_COMMENT_DESC: 
+    "Embed the link to the original Excalidraw file as a markdown link under the image, e.g.:<code>%%[[drawing.excalidraw]]%%</code>.<br>" +
+    "Instead of adding a markdown comment you may also select the embedded SVG or PNG line and use the command palette action: " +
+    "'<code>Excalidraw: Open Excalidraw drawing</code>' to open the drawing.",
   EMBED_WIKILINK_NAME: "Embed Drawing using Wiki link",
   EMBED_WIKILINK_DESC:
     "<b><u>Toggle ON:</u></b> Excalidraw will embed a [[wiki link]].<br><b><u>Toggle OFF:</u></b> Excalidraw will embed a [markdown](link).",
@@ -403,6 +578,10 @@ FILENAME_HEAD: "Filename",
   EXPORT_THEME_DESC:
     "Export the image matching the dark/light theme of your drawing. If turned off, " +
     "drawings created in dark mode will appear as they would in light mode.",
+  EXPORT_EMBED_SCENE_NAME: "Embed scene in exported image",
+  EXPORT_EMBED_SCENE_DESC:
+    "Embed Excalidraw scene in exported image. Can be overridden at a file level by adding the <code>excalidraw-export-embed-scene: true/false<code> frontmatter key. " +
+    "The setting only takes effect the next time you (re)open drawings.",
   EXPORT_HEAD: "Auto-export Settings",
   EXPORT_SYNC_NAME:
     "Keep the .SVG and/or .PNG filenames in sync with the drawing file",
@@ -416,13 +595,33 @@ FILENAME_HEAD: "Filename",
     "Embed the .svg file into your documents instead of Excalidraw making you embeds platform independent. " +
     "While the auto-export switch is on, this file will get updated every time you edit the Excalidraw drawing with the matching name. " + 
     "You can override this setting on a file level by adding the <code>excalidraw-autoexport</code> frontmatter key. Valid values for this key are " +
-    "<code>none</code>,<code>both</code>,<code>svg</code>, and <code>png</code>",
+    "<code>none</code>,<code>both</code>,<code>svg</code>, and <code>png</code>.",
   EXPORT_PNG_NAME: "Auto-export PNG",
   EXPORT_PNG_DESC: "Same as the auto-export SVG, but for *.PNG",
   EXPORT_BOTH_DARK_AND_LIGHT_NAME: "Export both dark- and light-themed image",
   EXPORT_BOTH_DARK_AND_LIGHT_DESC:  "When enabled, Excalidraw will export two files instead of one: filename.dark.png, filename.light.png and/or filename.dark.svg and filename.light.svg<br>"+
     "Double files will be exported both if auto-export SVG or PNG (or both) are enabled, as well as when clicking export on a single image.",
   COMPATIBILITY_HEAD: "Compatibility features",
+  COMPATIBILITY_DESC: "You should only enable these features if you have a strong reason for wanting to work with excalidraw.com files instead of markdown files. Many of the plugin features are not supported on legacy files. Typical usecase would be if you use set your vault up on top of a Visual Studio Code project folder and you have .excalidraw drawings you want to access from Visual Studio Code as well. Another usecase might be using Excalidraw in Logseq and Obsidian in parallel.",
+  DUMMY_TEXT_ELEMENT_LINT_SUPPORT_NAME: "Linter compatibility",
+  DUMMY_TEXT_ELEMENT_LINT_SUPPORT_DESC: "Excalidraw is sensitive to the file structure below <code># Excalidraw Data</code>. Automatic linting of documents can create errors in Excalidraw Data. " +
+    "While I've made some effort to make the data loading resilient to " +
+    "lint changes, this solution is not foolproof.<br><mark>The best is to avoid liniting or otherwise automatically changing Excalidraw documents using different plugins.</mark><br>" +
+    "Use this setting if for good reasons you have decided to ignore my recommendation and configured linting of Excalidraw files.<br> " +
+    "The <code>## Text Elements</code> section is sensitive to empty lines. A common linting approach is to add an empty line after section headings. In case of Excalidraw this will break/change the first text element in your drawing. " +
+    "To overcome this, you can enable this setting. When enabled, Excalidraw will add a dummy element to the beginning of <code>## Text Elements</code> that the linter can safely modify." ,
+  PRESERVE_TEXT_AFTER_DRAWING_NAME: "Zotero compatibility",
+  PRESERVE_TEXT_AFTER_DRAWING_DESC: "Preserve text after the ## Drawing section of the markdown file. This may have a very slight performance impact when saving very large drawings.",
+  DEBUGMODE_NAME: "Enable debug messages",
+  DEBUGMODE_DESC: "I recommend restarting Obsidian after enabling/disabling this setting. This enable debug messages in the console. This is useful for troubleshooting issues. " +
+    "If you are experiencing problems with the plugin, please enable this setting, reproduce the issue, and include the console log in the issue you raise on <a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/issues'>GitHub</a>",
+  SLIDING_PANES_NAME: "Sliding panes plugin support",
+  SLIDING_PANES_DESC:
+    "Need to restart Obsidian for this change to take effect.<br>" +
+    "If you use the <a href='https://github.com/deathau/sliding-panes-obsidian' target='_blank'>Sliding Panes plugin</a> " +
+    "you can enable this setting to make Excalidraw drawings work with the Sliding Panes plugin.<br>" +
+    "Note, that Excalidraw Sliding Panes support causes compatibility issues with Obsidian Workspaces.<br>" +
+    "Note also, that the 'Stack Tabs' feature is now available in Obsidian, providing native support for most of the Sliding Panes functionality.",
   EXPORT_EXCALIDRAW_NAME: "Auto-export Excalidraw",
   EXPORT_EXCALIDRAW_DESC: "Same as the auto-export SVG, but for *.Excalidraw",
   SYNC_EXCALIDRAW_NAME:
@@ -432,26 +631,47 @@ FILENAME_HEAD: "Filename",
     "then update the drawing in the .md file based on the .excalidraw file",
   COMPATIBILITY_MODE_NAME: "New drawings as legacy files",
   COMPATIBILITY_MODE_DESC:
+    "⚠️ Enable this only if you know what you are doing. In 99.9% of the cases you DO NOT want this on. " +
     "By enabling this feature drawings you create with the ribbon icon, the command palette actions, " +
     "and the file explorer are going to be all legacy *.excalidraw files. This setting will also turn off the reminder message " +
     "when you open a legacy file for editing.",
   MATHJAX_NAME: "MathJax (LaTeX) javascript library host",
-  MATHJAX_DESC: "If you are using LaTeX equiations in Excalidraw then the plugin needs to load a javascript library for that. " + 
-    "Some users are unable to access certain host servers. If you are experiencing issues try changing the host here. You may need to "+
+  MATHJAX_DESC: "If you are using LaTeX equations in Excalidraw, then the plugin needs to load a javascript library for that. " + 
+    "Some users are unable to access certain host servers. If you are experiencing issues, try changing the host here. You may need to "+
     "restart Obsidian after closing settings, for this change to take effect.",
-  LATEX_DEFAULT_NAME: "Default LaTeX formual for new equations",
+  LATEX_DEFAULT_NAME: "Default LaTeX formula for new equations",
   LATEX_DEFAULT_DESC: "Leave empty if you don't want a default formula. You can add default formatting here such as <code>\\color{white}</code>.",
   NONSTANDARD_HEAD: "Non-Excalidraw.com supported features",
-  NONSTANDARD_DESC: "These features are not available on excalidraw.com. When exporting the drawing to Excalidraw.com these features will appear different.",
+  NONSTANDARD_DESC: `These settings in the "Non-Excalidraw.com Supported Features" section provide customization options beyond the default Excalidraw.com features. These features are not available on excalidraw.com. When exporting the drawing to Excalidraw.com these features will appear different.
+    You can configure the number of custom pens displayed next to the Obsidian Menu on the canvas, allowing you to choose from a range of options. Additionally, you can enable a fourth font option, which adds a fourth font button to the properties panel for text elements. `,
+  RENDER_TWEAK_HEAD: "Rendering tweaks",
+  MAX_IMAGE_ZOOM_IN_NAME: "Maximum image zoom in resolution",
+  MAX_IMAGE_ZOOM_IN_DESC: "To save on memory and because Apple Safari (Obsidian on iOS) has some hard-coded limitations, Excalidraw.com limits the max resolution of images and large objects when zooming in. You can override this limitation using a multiplicator. " +
+    "This means you are multiplying the limit set by default in Excalidraw, the larger the multiplier the better the image zoom in resolution will be, and the more memory it will consume. " +
+    "I recommend playing with multiple values for this setting. You know you've hit the wall, when zooming in to a larger PNG image suddenly the image disappears from view. The default value is 1. The setting has no effect on iOS.",
+  CUSTOM_PEN_HEAD: "Custom pens",
   CUSTOM_PEN_NAME: "Number of custom pens",
   CUSTOM_PEN_DESC: "You will see these pens next to the Obsidian Menu on the canvas. You can customize the pens on the canvas by long-pressing the pen button.",
-  EXPERIMENTAL_HEAD: "Experimental features",
-  EXPERIMENTAL_DESC:
-    "Some of these setting will not take effect immediately, only when the File Explorer is refreshed, or Obsidian restarted.",
+  EXPERIMENTAL_HEAD: "Miscellaneous features",
+  EXPERIMENTAL_DESC: `These miscellaneous features in Excalidraw include options for setting default LaTeX formulas for new equations, enabling a Field Suggester for autocompletion, displaying type indicators for Excalidraw files, enabling immersive image embedding in live preview editing mode, and experimenting with Taskbone Optical Character Recognition for text extraction from images and drawings. Users can also enter a Taskbone API key for extended usage of the OCR service.`,
+  EA_HEAD: "Excalidraw Automate",
+  EA_DESC: 
+    "ExcalidrawAutomate is a scripting and automation API for Excalidraw. Unfortunately, the documentation of the API is sparse. " +
+    "I recommend reading the <a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/docs/API/ExcalidrawAutomate.d.ts'>ExcalidrawAutomate.d.ts</a> file, " +
+    "visiting the <a href='https://zsviczian.github.io/obsidian-excalidraw-plugin/'>ExcalidrawAutomate How-to</a> page - though the information " +
+    "here has not been updated for a long while -, and finally to enable the field suggester below. The field suggester will show you the available " +
+    "functions, their parameters and short description as you type. The field suggester is the most up-to-date documentation of the API.",
   FIELD_SUGGESTER_NAME: "Enable Field Suggester",
   FIELD_SUGGESTER_DESC:
     "Field Suggester borrowed from Breadcrumbs and Templater plugins. The Field Suggester will show an autocomplete menu " +
     "when you type <code>excalidraw-</code> or <code>ea.</code> with function description as hints on the individual items in the list.",
+  STARTUP_SCRIPT_NAME: "Startup script",
+  STARTUP_SCRIPT_DESC:
+    "If set, excalidraw will execute the script at plugin startup. This is useful if you want to set any of the Excalidraw Automate hooks. The startup script is a markdown file " +
+    "that should contain the javascript code you want to execute when Excalidraw starts.",
+  STARTUP_SCRIPT_BUTTON_CREATE: "Create startup script",
+  STARTUP_SCRIPT_BUTTON_OPEN: "Open startup script",
+  STARTUP_SCRIPT_EXISTS: "Startup script file already exists",
   FILETYPE_NAME: "Display type (✏️) for excalidraw.md files in File Explorer",
   FILETYPE_DESC:
     "Excalidraw files will receive an indicator using the emoji or text defined in the next setting.",
@@ -463,6 +683,17 @@ FILENAME_HEAD: "Filename",
     "Turn this on to support image embedding styles such as ![[drawing|width|style]] in live preview editing mode. " +
     "The setting will not affect the currently open documents. You need close the open documents and re-open them for the change " +
     "to take effect.",
+  FADE_OUT_EXCALIDRAW_MARKUP_NAME: "Fade out Excalidraw markup",
+  FADE_OUT_EXCALIDRAW_MARKUP_DESC: "In Markdown view mode, the section after the markdown comment %% " +
+    "fades out. The text is still there, but the visual clutter is reduced. Note, you can place the %% in the line right above # Text Elements, " +
+    "in this case the entire drawing markdown will fade out including # Text Elements. The side effect is you won't be able to block reference text in other markdown notes, that is after the %% comment section. This is seldom an issue. " +
+    "Should you want to edit the Excalidraw markdown script, simply switch to markdown view mode and temporarily remove the %% comment.",
+  EXCALIDRAW_PROPERTIES_NAME: "Load Excalidraw Properties into Obsidian Suggester",
+  EXCALIDRAW_PROPERTIES_DESC: "Toggle this setting to load Excalidraw document properties into Obsidian's property suggester at plugin startup. "+
+   "Enabling this feature simplifies the use of Excalidraw front matter properties, allowing you to leverage many powerful settings. If you prefer not to load these properties automatically, " +
+   "you can disable this feature, but you will need to manually remove any unwanted properties from the suggester. " +
+   "Note that turning on this setting requires restarting the plugin as properties are loaded at startup.",  
+  CUSTOM_FONT_HEAD: "Fourth font",
   ENABLE_FOURTH_FONT_NAME: "Enable fourth font option",
   ENABLE_FOURTH_FONT_DESC:
     "By turning this on, you will see a fourth font button on the properties panel for text elements. " +
@@ -474,6 +705,7 @@ FILENAME_HEAD: "Filename",
     "Select a .ttf, .woff or .woff2 font file from your vault to use as the fourth font. " +
     "If no file is selected, Excalidraw will use the Virgil font by default.",
   SCRIPT_SETTINGS_HEAD: "Settings for installed Scripts",
+  SCRIPT_SETTINGS_DESC: "Some of the Excalidraw Automate Scripts include settings. Settings are organized by script. Settings will only become visible in this list after you have executed the newly downloaded script once.",
   TASKBONE_HEAD: "Taskbone Optical Character Recogntion",
   TASKBONE_DESC: "This is an experimental integration of optical character recognition into Excalidraw. Please note, that taskbone is an independent external service not provided by Excalidraw, nor the Excalidraw-Obsidian plugin project. " +
     "The OCR service will grab legible text from freedraw lines and embedded pictures on your canvas and place the recognized text in the frontmatter of your drawing as well as onto clipboard. " +
@@ -489,9 +721,12 @@ FILENAME_HEAD: "Filename",
 
   //openDrawings.ts
   SELECT_FILE: "Select a file then press enter.",
+  SELECT_COMMAND: "Select a command then press enter.",
   SELECT_FILE_WITH_OPTION_TO_SCALE: `Select a file then press ENTER, or ${labelSHIFT()}+${labelMETA()}+ENTER to insert at 100% scale.`,
   NO_MATCH: "No file matches your query.",
+  NO_MATCHING_COMMAND: "No command matches your query.",
   SELECT_FILE_TO_LINK: "Select the file you want to insert the link for.",
+  SELECT_COMMAND_PLACEHOLDER: "Select the command you want to insert the link for.",
   SELECT_DRAWING: "Select the image or drawing you want to insert",
   TYPE_FILENAME: "Type name of drawing to select.",
   SELECT_FILE_OR_TYPE_NEW:
@@ -502,6 +737,13 @@ FILENAME_HEAD: "Filename",
   PDF_PAGES_HEADER: "Pages to load?",
   PDF_PAGES_DESC: "Format: 1, 3-5, 7, 9-11",
 
+  //SelectCard.ts
+  TYPE_SECTION: "Type section name to select.",
+  SELECT_SECTION_OR_TYPE_NEW:
+    "Select existing section or type name of a new section then press Enter.",
+  INVALID_SECTION_NAME: "Invalid section name.",
+  EMPTY_SECTION_MESSAGE: "Type the Section Name and hit enter to create a new Section",
+
   //EmbeddedFileLoader.ts
   INFINITE_LOOP_WARNING:
     "EXCALIDRAW WARNING\nAborted loading embedded images due to infinite loop in file:\n",
@@ -520,7 +762,7 @@ FILENAME_HEAD: "Filename",
   TOGGLE_DISABLEBINDING: "Toggle to invert default binding behavior",
   TOGGLE_FRAME_RENDERING: "Toggle frame rendering",
   TOGGLE_FRAME_CLIPPING: "Toggle frame clipping",
-  OPEN_LINK_CLICK: "Navigate to selected element link",
+  OPEN_LINK_CLICK: "Open Link",
   OPEN_LINK_PROPS: "Open markdown-embed properties or open link in new window",
 
   //IFrameActionsMenu.tsx
@@ -530,6 +772,30 @@ FILENAME_HEAD: "Filename",
   ZOOM_TO_FIT: "Zoom to fit",
   RELOAD: "Reload original link",
   OPEN_IN_BROWSER: "Open current link in browser",
+  PROPERTIES: "Properties",
+  COPYCODE: "Copy source to clipboard",
+
+  //EmbeddableSettings.tsx
+  ES_TITLE: "Embeddable Element Settings",
+  ES_RENAME: "Rename File",
+  ES_ZOOM: "Embedded Content Scaling",
+  ES_YOUTUBE_START: "YouTube Start Time",
+  ES_YOUTUBE_START_DESC: "ss, mm:ss, hh:mm:ss",
+  ES_YOUTUBE_START_INVALID: "The YouTube Start Time is invalid. Please check the format and try again",
+  ES_FILENAME_VISIBLE: "Filename Visible",
+  ES_BACKGROUND_HEAD: "Embedded note background color",
+  ES_BACKGROUND_MATCH_ELEMENT: "Match Element Background Color",
+  ES_BACKGROUND_MATCH_CANVAS: "Match Canvas Background Color",
+  ES_BACKGROUND_COLOR: "Background Color",
+  ES_BORDER_HEAD: "Embedded note border color",
+  ES_BORDER_COLOR: "Border Color",
+  ES_BORDER_MATCH_ELEMENT: "Match Element Border Color",
+  ES_BACKGROUND_OPACITY: "Background Opacity",
+  ES_BORDER_OPACITY: "Border Opacity",
+  ES_EMBEDDABLE_SETTINGS: "Embeddable Markdown Settings",
+  ES_USE_OBSIDIAN_DEFAULTS: "Use Obsidian Defaults",
+  ES_ZOOM_100_RELATIVE_DESC: "The button will adjust the element scale so it will show the content at 100% relative to the current zoom level of your canvas",
+  ES_ZOOM_100: "Relative 100%",
 
   //Prompts.ts
   PROMPT_FILE_DOES_NOT_EXIST: "File does not exist. Do you want to create it?",
@@ -537,8 +803,12 @@ FILENAME_HEAD: "Filename",
   PROMPT_ERROR_DRAWING_CLOSED: "Unknown error. It seems as if your drawing was closed or the drawing file is missing",
   PROMPT_TITLE_NEW_FILE: "New File",
   PROMPT_TITLE_CONFIRMATION: "Confirmation",
-  PROMPT_BUTTON_CREATE_EXCALIDRAW: "Create Excalidraw",
-  PROMPT_BUTTON_CREATE_MARKDOWN: "Create Markdown",
+  PROMPT_BUTTON_CREATE_EXCALIDRAW: "Create EX",
+  PROMPT_BUTTON_CREATE_EXCALIDRAW_ARIA: "Create Excalidraw drawing and open in new tab",
+  PROMPT_BUTTON_CREATE_MARKDOWN: "Create MD",
+  PROMPT_BUTTON_CREATE_MARKDOWN_ARIA: "Create markdown document and open in new tab",
+  PROMPT_BUTTON_EMBED_MARKDOWN: "Embed MD",
+  PROMPT_BUTTON_EMBED_MARKDOWN_ARIA: "Replace selected element with embedded markdown document",
   PROMPT_BUTTON_NEVERMIND: "Nevermind",
   PROMPT_BUTTON_OK: "OK",
   PROMPT_BUTTON_CANCEL: "Cancel",
@@ -546,5 +816,12 @@ FILENAME_HEAD: "Filename",
   PROMPT_BUTTON_INSERT_SPACE: "Insert space",
   PROMPT_BUTTON_INSERT_LINK: "Insert markdown link to file",
   PROMPT_BUTTON_UPPERCASE: "Uppercase",
-  
+  PROMPT_SELECT_TEMPLATE: "Select a template",
+
+  //ModifierKeySettings
+  WEB_BROWSER_DRAG_ACTION: "Web Browser Drag Action",
+  LOCAL_FILE_DRAG_ACTION: "OS Local File Drag Action",
+  INTERNAL_DRAG_ACTION: "Obsidian Internal Drag Action",
+  PANE_TARGET: "Link click behavior",
+  DEFAULT_ACTION_DESC: "In case none of the combinations apply the default action for this group is: ",
 };

src/lang/locale/zh-cn.ts

@@ -1,14 +1,19 @@
 import {
   DEVICE,
-  FRONTMATTER_KEY_CUSTOM_LINK_BRACKETS,
-  FRONTMATTER_KEY_CUSTOM_PREFIX,
-  FRONTMATTER_KEY_CUSTOM_URL_PREFIX,
-} from "src/constants";
+  FRONTMATTER_KEYS,
+} from "src/constants/constants";
 import { labelALT, labelCTRL, labelMETA, labelSHIFT } from "src/utils/ModifierkeyHelper";
 
 // 简体中文
 export default {
   // main.ts
+  CONVERT_URL_TO_FILE: "从 URL 下载图像到本地",
+  UNZIP_CURRENT_FILE: "解压当前 Excalidraw 文件",
+  ZIP_CURRENT_FILE: "压缩当前 Excalidraw 文件",
+  PUBLISH_SVG_CHECK: "Obsidian Publish: 搜索过期的 SVG 和 PNG 导出文件",
+  EMBEDDABLE_PROPERTIES: "Embeddable 元素设置",
+  EMBEDDABLE_RELATIVE_ZOOM: "使元素的缩放等级等于当前画布的缩放等级",
+  OPEN_IMAGE_SOURCE: "打开 Excalidraw 绘图文件",
   INSTALL_SCRIPT: "安装此脚本",
   UPDATE_SCRIPT: "有可用更新 - 点击安装",
   CHECKING_SCRIPT:
@@ -19,80 +24,106 @@ export default {
     "脚本已是最新 - 点击重新安装",
   OPEN_AS_EXCALIDRAW: "打开为 Excalidraw 绘图",
   TOGGLE_MODE: "在 Excalidraw 和 Markdown 模式之间切换",
-  CONVERT_NOTE_TO_EXCALIDRAW: "转换空白笔记为 Excalidraw 绘图",
-  CONVERT_EXCALIDRAW: "转换 *.excalidraw 为 *.md 文件",
-  CREATE_NEW: "新建 Excalidraw 绘图",
-  CONVERT_FILE_KEEP_EXT: "*.excalidraw => *.excalidraw.md",
-  CONVERT_FILE_REPLACE_EXT: "*.excalidraw => *.md (兼容 Logseq)",
+  CONVERT_NOTE_TO_EXCALIDRAW: "转换：空白 Markdown 文档 => Excalidraw 绘图文件",
+  CONVERT_EXCALIDRAW: "转换： *.excalidraw => *.md",
+  CREATE_NEW: "新建绘图文件",
+  CONVERT_FILE_KEEP_EXT: "转换：*.excalidraw => *.excalidraw.md",
+  CONVERT_FILE_REPLACE_EXT: "转换：*.excalidraw => *.md (兼容 Logseq)",
   DOWNLOAD_LIBRARY: "导出 stencil 库为 *.excalidrawlib 文件",
   OPEN_EXISTING_NEW_PANE: "打开已有的绘图 - 于新面板",
   OPEN_EXISTING_ACTIVE_PANE:
     "打开已有的绘图 - 于当前面板",
-  TRANSCLUDE: "嵌入绘图（形如 ![[drawing]]）到当前文档",
-  TRANSCLUDE_MOST_RECENT: "嵌入最近编辑过的绘图（形如 ![[drawing]]）到当前文档",
+  TRANSCLUDE: "嵌入绘图（形如 ![[drawing]]）到当前 Markdown 文档中",
+  TRANSCLUDE_MOST_RECENT: "嵌入最近编辑过的绘图（形如 ![[drawing]]）到当前 Markdown 文档中",
   TOGGLE_LEFTHANDED_MODE: "切换为左手模式",
+  FLIP_IMAGE: "打开当前所选 excalidraw 图像的“背景笔记”",
   NEW_IN_NEW_PANE: "新建绘图 - 于新面板",
   NEW_IN_NEW_TAB: "新建绘图 - 于新页签",
   NEW_IN_ACTIVE_PANE: "新建绘图 - 于当前面板",
   NEW_IN_POPOUT_WINDOW: "新建绘图 - 于新窗口",
   NEW_IN_NEW_PANE_EMBED:
-    "新建绘图 - 于新面板 - 并将其嵌入（形如 ![[drawing]]）到当前文档",
+    "新建绘图 - 于新面板 - 并将其嵌入（形如 ![[drawing]]）到当前 Markdown 文档中",
   NEW_IN_NEW_TAB_EMBED:
-    "新建绘图 - 于新页签 - 并将其嵌入（形如 ![[drawing]]）到当前文档",
+    "新建绘图 - 于新页签 - 并将其嵌入（形如 ![[drawing]]）到当前 Markdown 文档中",
   NEW_IN_ACTIVE_PANE_EMBED:
-    "新建绘图 - 于当前面板 - 并将其嵌入（形如 ![[drawing]]）到当前文档",
-  NEW_IN_POPOUT_WINDOW_EMBED: "新建绘图 - 于新窗口 - 并将其嵌入（形如 ![[drawing]]）到当前文档",
-  EXPORT_SVG: "导出 SVG 文件到当前目录",
-  EXPORT_PNG: "导出 PNG 文件到当前目录",
-  EXPORT_SVG_WITH_SCENE: "导出 SVG 文件（包含 Scene）到当前目录",
-  EXPORT_PNG_WITH_SCENE: "导出 PNG 文件（包含 Scene）到当前目录",
+    "新建绘图 - 于当前面板 - 并将其嵌入（形如 ![[drawing]]）到当前 Markdown 文档中",
+  NEW_IN_POPOUT_WINDOW_EMBED: "新建绘图 - 于新窗口 - 并将其嵌入（形如 ![[drawing]]）到当前 Markdown 文档中",
   TOGGLE_LOCK: "文本元素：原文模式（RAW）⟺ 预览模式（PREVIEW）",
-  DELETE_FILE: "从库中删除所选图像（或 MD-Embed）的源文件",
+  DELETE_FILE: "从库中删除所选图像（或以图像形式嵌入绘图中的 Markdown）的源文件",
+  COPY_ELEMENT_LINK: "复制所选元素的 Markdown 链接",
   INSERT_LINK_TO_ELEMENT:
-    `复制所选元素的内部链接（形如 [[file#^elementID]]）。\n按住 ${labelCTRL()} 可复制元素所在分组的内部链接（形如 [[file#^group=elementID]]）。\n按住 ${labelSHIFT()} 可复制所选元素周围区域的内部链接（形如 [[file#^area=elementID]]）。\n按住 ${labelALT()} 可观看视频演示。`,
+    `复制所选元素为内部链接（形如 [[file#^id]] ）。\n按住 ${labelCTRL()} 可复制元素所在分组为内部链接（形如 [[file#^group=id]] ）。\n按住 ${labelSHIFT()} 可复制所选元素所在区域为内部链接（形如 [[file#^area=id]] ）。\n按住 ${labelALT()} 可观看视频演示。`,
   INSERT_LINK_TO_ELEMENT_GROUP:
-    "复制所选元素所在分组的内部链接（形如 [[file#^group=elementID]]）",
+    "复制所选元素所在分组为内部链接（形如 [[file#^group=id]] ）",
   INSERT_LINK_TO_ELEMENT_AREA:
-    "复制所选元素周围区域的内部链接（形如 [[file#^area=elementID]]）",
+    "复制所选元素所在区域为内部链接（形如 [[file#^area=id]] ）",
+  INSERT_LINK_TO_ELEMENT_FRAME:
+    "复制所选框架为内部链接（形如 [[file#^frame=id]] ）",
   INSERT_LINK_TO_ELEMENT_NORMAL:
-    "复制所选元素的内部链接（形如 [[file#^elementID]]）",
+    "复制所选元素为内部链接（形如 [[file#^id]] ）",
   INSERT_LINK_TO_ELEMENT_ERROR: "未选择画布里的单个元素",
   INSERT_LINK_TO_ELEMENT_READY: "链接已生成并复制到剪贴板",
-  INSERT_LINK: "插入文件的内部链接（形如 [[drawing]]）到当前绘图",
-  INSERT_IMAGE: "插入图像（以图像形式嵌入）到当前绘图",
-  IMPORT_SVG: "插入 SVG 矢量图形到当前绘图（支持有限，尚不支持文本）",
-  INSERT_MD: "插入 Markdown 文档（以图像形式嵌入）到当前绘图",
+  INSERT_LINK: "插入任意文件（以内部链接形式嵌入，形如 [[drawing]] ）到当前绘图中",
+  INSERT_COMMAND: "插入 Obsidian 命令（以内部链接形式嵌入）到当前绘图中",
+  INSERT_IMAGE: "插入图像或 Excalidraw 绘图（以图像形式嵌入）到当前绘图中",
+  IMPORT_SVG: "从 SVG 文件导入图形元素到当前绘图中（暂不支持文本元素）",
+  IMPORT_SVG_CONTEXTMENU: "转换 SVG 到线条 - 有限制",
+  INSERT_MD: "插入 Markdown 文档（以图像形式嵌入）到当前绘图中",
+  INSERT_PDF: "插入 PDF 文档（以图像形式嵌入）到当前绘图中",
+  UNIVERSAL_ADD_FILE: "插入任意文件（以交互形式嵌入，或者以图像形式嵌入）到当前绘图中",
+  INSERT_CARD: "插入“背景笔记”卡片",
+  CONVERT_CARD_TO_FILE: "将“背景笔记”卡片保存到文件",
+  ERROR_TRY_AGAIN: "请重试。",
+  PASTE_CODEBLOCK: "粘贴代码块",
   INSERT_LATEX:
-    `插入 LaTeX 公式到当前绘图。按住 ${labelALT()} 可观看视频演示。`,
+    `插入 LaTeX 公式到当前绘图`,
   ENTER_LATEX: "输入 LaTeX 表达式",
   READ_RELEASE_NOTES: "阅读本插件的更新说明",
-  RUN_OCR: "OCR 识别涂鸦和图片里的文本并复制到剪贴板",
+  RUN_OCR: "OCR 完整画布: 识别涂鸦和图片里的文本并复制到剪贴板和文档属性中",
+  RERUN_OCR: "重新运行 OCR 完整画笔: 识别涂鸦和图片里的文本并复制到剪贴板和文档属性中",
+  RUN_OCR_ELEMENTS: "OCR 选中的元素: 识别涂鸦和图片里的文本并复制到剪贴板",
   TRAY_MODE: "绘图工具属性页：面板模式 ⟺ 托盘模式",
   SEARCH: "搜索文本",
+  CROP_PAGE: "对所选页面裁剪并添加蒙版",
+  CROP_IMAGE: "对图片裁剪并添加蒙版",
+  ANNOTATE_IMAGE : "在 Excalidraw 中标注图像",
+  INSERT_ACTIVE_PDF_PAGE_AS_IMAGE: "将当前激活的的 PDF 页面作为图片插入",
   RESET_IMG_TO_100: "重设图像元素的尺寸为 100%",
-  TEMPORARY_DISABLE_AUTOSAVE: "临时禁用自动保存功能，直到 Obsidian 退出（勿点，除非你清楚自己在干什么）",
-  TEMPORARY_ENABLE_AUTOSAVE: "恢复启用自动保存功能",
+  TEMPORARY_DISABLE_AUTOSAVE: "临时禁用自动保存功能，直到本次 Obsidian 退出（小白慎用！）",
+  TEMPORARY_ENABLE_AUTOSAVE: "启用自动保存功能",
 
   //ExcalidrawView.ts
+  MASK_FILE_NOTICE: "这是一个蒙版图像。长按本提示来观看视频讲解。",
   INSTALL_SCRIPT_BUTTON: "安装或更新 Excalidraw 脚本",
-  OPEN_AS_MD: "打开为 Markdown 文件",
-  SAVE_AS_PNG: `导出 PNG 到当前目录（按住 ${labelCTRL()} 设定导出路径；按住 SHIFT 在导出时包含 Scene）`,
-  SAVE_AS_SVG: `导出 SVG 到当前目录（按住 ${labelCTRL()} 设定导出路径；按住 SHIFT 在导出时包含 Scene）`,
+  OPEN_AS_MD: "打开为 Markdown 文档",
+  EXPORT_IMAGE: `导出为图像`,
   OPEN_LINK: "打开所选元素里的链接 \n（按住 SHIFT 在新面板打开）",
-  EXPORT_EXCALIDRAW: "导出为 .Excalidraw 文件",
+  EXPORT_EXCALIDRAW: "导出为 .excalidraw 文件（旧版绘图文件格式）",
   LINK_BUTTON_CLICK_NO_TEXT:
     "请选择一个含有链接的图形或文本元素。",
   FILENAME_INVALID_CHARS:
     '文件名不能含有以下符号： * " \\  < > : | ? #',
   FORCE_SAVE:
-    "保存绘图（并更新嵌入了该绘图的面板）",
+    "保存（同时更新嵌入了该绘图的 Markdown 文档）",
   RAW: "文本元素正以原文（RAW）模式显示链接。\n点击切换到预览（PREVIEW）模式",
   PARSED:
     "文本元素正以预览（PREVIEW）模式显示链接。\n点击切换到原文（RAW）模式",
   NOFILE: "Excalidraw（没有文件）",
   COMPATIBILITY_MODE:
-    "*.excalidraw 文件正以兼容模式打开。需要转换为新格式才能使用插件的全部功能。",
+    "*.excalidraw 是兼容旧版的绘图文件格式。需要转换为新格式才能解锁本插件的全部功能。",
   CONVERT_FILE: "转换为新格式",
+  BACKUP_AVAILABLE: "加载绘图文件时出错，可能是由于 Obsidian 在上次保存时意外退出了（手机上更容易发生这种意外）。<br><br><b>好消息：</b>这台设备上存在备份。您是否想要恢复本设备上的备份？<br><br>（我建议您先尝试在最近使用过的其他设备上打开该绘图，以检查是否有更新的备份。）",
+  BACKUP_RESTORED: "已恢复备份",
+  CACHE_NOT_READY: "抱歉，加载绘图文件时出错。<br><br><mark>现在有耐心，将来更省心。</mark><br><br>该插件有备份机制，但您似乎刚刚打开 Obsidian，需要等待一分钟或更长的时间来读取缓存。缓存读取完毕时，您将会在右上角收到提示。<br><br>请点击 OK 并耐心等待缓存，或者选择点击取消后手动修复你的文件。<br>",
+  OBSIDIAN_TOOLS_PANEL: "Obsidian 工具面板",
+  ERROR_SAVING_IMAGE: "获取图像时发生未知错误。可能是由于某种原因，图像不可用或拒绝了 Obsidian 的获取请求。",
+  WARNING_PASTING_ELEMENT_AS_TEXT: "你不能将 Excalidraw 元素粘贴为文本元素！",
+  USE_INSERT_FILE_MODAL: "使用“插入任意文件”功能来嵌入 Markdown 文档",
+  CONVERT_TO_MARKDOWN: "转存为 Markdown 文档（并嵌入为 MD-Embeddable）",
+  SELECT_TEXTELEMENT_ONLY: "只选择文本元素（非容器）",
+  REMOVE_LINK: "移除文字元素链接",
+  LASER_ON: "启用激光笔",
+  LASER_OFF: "关闭激光笔",
 
   //settings.ts
   RELEASE_NOTES_NAME: "显示更新说明",
@@ -104,29 +135,83 @@ export default {
       "<b>开启：</b>当本插件存在可用更新时，显示通知。<br>" +
       "<b>关闭：</b>您需要手动检查本插件的更新（设置 - 第三方插件 - 检查更新）。",
   
+  BASIC_HEAD: "基本",
+  BASIC_DESC: `包括：更新说明，更新提示，新绘图文件、模板文件、脚本文件的存储路径等的设置。`,
   FOLDER_NAME: "Excalidraw 文件夹",
   FOLDER_DESC:
     "新绘图的默认存储路径。若为空，将在库的根目录中创建新绘图。",
+  CROP_PREFIX_NAME: "剪贴文件的前缀",
+  CROP_PREFIX_DESC:
+    "当剪贴图片进来时保存的文件名的前缀。 " +
+    "留空则使用 'cropped_'",
+  ANNOTATE_PREFIX_NAME: "标注文件的前缀",
+  ANNOTATE_PREFIX_DESC:
+    "在标注图像时创建新绘图的文件名的第一部分。" +
+    "留空则使用'annotated_'",
+  ANNOTATE_PRESERVE_SIZE_NAME: "在标注时保留图像尺寸",
+  ANNOTATE_PRESERVE_SIZE_DESC:
+    "当在 Markdown 中标注图像时，替换后的图像链接将包含原始图像的宽度。",
+  CROP_FOLDER_NAME: "剪贴文件文件夹",
+  CROP_FOLDER_DESC:
+    "剪贴图像时创建新绘图的默认存储路径。如果留空，将按照 Vault 附件设置创建。",
+  ANNOTATE_FOLDER_NAME: "图片标注文件文件夹",
+  ANNOTATE_FOLDER_DESC:
+    "创建图片标注是的默认存储路径. 如果留空, 将按照 Vault 附件设置创建。",
   FOLDER_EMBED_NAME:
-    "将 Excalidraw 文件夹用于“新建绘图”命令创建的绘图",
+    "将 Excalidraw 文件夹用于“新建绘图”系列命令",
   FOLDER_EMBED_DESC:
     "在命令面板中执行“新建绘图”系列命令时，" +
-    "新绘图的存储路径。<br>" +
-    "<b>开启：</b>使用 Excalidraw 文件夹。 <br><b>关闭：</b>使用 Obsidian 设置的新附件默认位置。",
+    "新建的绘图文件的存储路径。<br>" +
+    "<b>开启：</b>使用上面的 Excalidraw 文件夹。 <br><b>关闭：</b>使用 Obsidian 设置的新附件默认位置。",
   TEMPLATE_NAME: "Excalidraw 模板文件",
   TEMPLATE_DESC:
-    "Excalidraw 模板文件的完整路径。<br>" +
-    "如果您的模板在默认的 Excalidraw 文件夹中且文件名是 " +
-    "Template.md，则此项应设为 Excalidraw/Template.md（也可省略 .md 扩展名，即 Excalidraw/Template）。<br>" +
+    "Excalidraw 模板文件（文件夹）的存储路径。<br>" +
+    "<b>模板文件：</b>比如.: 如果您的模板在默认的 Excalidraw 文件夹中且文件名是 " +
+    "Template.md, 则此项应设为 Excalidraw/Template.md（也可省略 .md 扩展名，即 Excalidraw/Template）。" +
     "如果您在兼容模式下使用 Excalidraw，那么您的模板文件也必须是旧的 *.excalidraw 格式，" +
-    "例如 Excalidraw/Template.excalidraw。",
+    "例如 Excalidraw/Template.excalidraw. <br><b>模板文件夹：</b> 你还可以将文件夹设置为模板。 " +
+    "在这种情况下，创建新绘图时将提示您选择使用哪个模板。<br>" +
+    "<b>专业提示：</b> 如果您正在使用 Obsidian Templater 插件，您可以 将Templater 代码添加到不同的" +
+    "Excalidraw 模板中，以自动配置您的绘图",
   SCRIPT_FOLDER_NAME: "Excalidraw 自动化脚本的文件夹（大小写敏感！）",
   SCRIPT_FOLDER_DESC:
     "此文件夹用于存放 Excalidraw 自动化脚本。" +
     "您可以在 Obsidian 命令面板中执行这些脚本，" +
     "还可以为喜欢的脚本分配快捷键，就像为其他 Obsidian 命令分配快捷键一样。<br>" +
     "该项不能设为库的根目录。",
+  AI_HEAD: "AI（实验性）",
+  AI_DESC: `OpenAI GPT API 的设置。 ` +
+    `目前 OpenAI API 还处于测试中，您需要在自己的。` +
+    `OpenAI 账户中充值至少 5 美元后才能生成 API key，` +
+    `然后就可以在 Excalidraw 中配置并使用 AI。`,
+  AI_OPENAI_TOKEN_NAME: "OpenAI API key",
+  AI_OPENAI_TOKEN_DESC:
+    "您可以访问您的<a href='https://platform.openai.com/api-keys'> OpenAI 账户</a>来获取自己的 OpenAI API key。",
+  AI_OPENAI_TOKEN_PLACEHOLDER: "OpenAI API key",
+  AI_OPENAI_DEFAULT_MODEL_NAME: "默认的文本 AI 模型",
+  AI_OPENAI_DEFAULT_MODEL_DESC:
+    "使用哪个 AI 模型来生成文本。请填写有效的 OpenAI 模型名称。" +
+    "您可访问<a href='https://platform.openai.com/docs/models'> OpenAI 网站</a>了解更多模型信息。",
+  AI_OPENAI_DEFAULT_MODEL_PLACEHOLDER: "gpt-3.5-turbo-1106",
+  AI_OPENAI_DEFAULT_IMAGE_MODEL_NAME: "默认的图像 AI 模型",
+  AI_OPENAI_DEFAULT_IMAGE_MODEL_DESC:
+    "使用哪个 AI 模型来生成图像（在编辑和调整图像时会强制使用 dall-e-2 模型，" +
+    "因为目前只有该模型支持编辑和调整图像）。" +
+    "请填写有效的 OpenAI 模型名称。" +
+    "您可访问<a href='https://platform.openai.com/docs/models'>OpenAI 网站</a>了解更多模型信息。",
+  AI_OPENAI_DEFAULT_IMAGE_MODEL_PLACEHOLDER: "dall-e-3",
+  AI_OPENAI_DEFAULT_VISION_MODEL_NAME: "默认的 AI 视觉模型",
+  AI_OPENAI_DEFAULT_VISION_MODEL_DESC:
+    "根据文本生成图像时，使用哪个 AI 视觉模型。请填写有效的 OpenAI 模型名称。" +
+    "您可访问<a href='https://platform.openai.com/docs/models'> OpenAI 网站</a>了解更多模型信息。",
+  AI_OPENAI_DEFAULT_API_URL_NAME: "OpenAI API URL",
+  AI_OPENAI_DEFAULT_API_URL_DESC:
+    "默认的 OpenAI API URL。请填写有效的 OpenAI API URL。" +
+    "Excalidraw 会通过该 URL 发送 API 请求给 OpenAI。我没有对此选项做任何错误处理，请谨慎修改。",
+  AI_OPENAI_DEFAULT_IMAGE_API_URL_NAME: "OpenAI 图像生成 API URL",
+  AI_OPENAI_DEFAULT_VISION_MODEL_PLACEHOLDER: "gpt-4-vision-preview",
   SAVING_HEAD: "保存",
+  SAVING_DESC: "包括：压缩，自动保存的时间间隔，文件的命名格式和扩展名等的设置。",
   COMPRESS_NAME: "压缩 Excalidraw JSON",
   COMPRESS_DESC:
     "Excalidraw 绘图文件默认将元素记录为 JSON 格式。开启此项，可将元素的 JSON 数据以 BASE64 编码" +
@@ -136,37 +221,45 @@ export default {
     "当您通过功能区按钮或命令将绘图切换成 Markdown 模式时，" +
     "数据将被解码回 JSON 格式以便阅读和编辑；" +
     "而当您切换回 Excalidraw 模式时，数据就会被再次编码。<br>" +
-    "开启此项后，对于之前已存在的未压缩的绘图文件，" +
-    "需要重新打开并保存它们才能生效。",
-  AUTOSAVE_INTERVAL_DESKTOP_NAME: "桌面端定期保存时间间隔",
+    "开启此项后，对于之前已存在但未压缩的绘图文件，" +
+    "需要重新打开并保存才能生效。",
+  DECOMPRESS_FOR_MD_NAME: "在 Markdown 视图中解压缩 Excalidraw JSON",
+  DECOMPRESS_FOR_MD_DESC:
+    "通过启用此功能，Excalidraw 将在切换到 Markdown 视图时自动解压缩绘图 JSON。" +
+    "这将使您能够轻松阅读和编辑 JSON 字符串。" +
+    "一旦您切换回Excalidraw视图并保存绘图（CTRL+S），绘图将再次被压缩。<br>" +
+    "我建议关闭此功能，因为这可以获得更小的文件尺寸，并避免在 Obsidian 搜索中出现不必要的结果。 " +
+    "您始终可以使用命令面板中的“Excalidraw: 解压缩当前 Excalidraw 文件”命令"+
+    "在需要阅读或编辑时手动解压缩绘图 JSON。",
+  AUTOSAVE_INTERVAL_DESKTOP_NAME: "桌面端自动保存时间间隔",
   AUTOSAVE_INTERVAL_DESKTOP_DESC:
-    "每隔多长时间触发一次自动保存。但如果当前绘图没有发生改变，将不会触发自动保存。" +
-    "当 Obsidian 应用内的焦点离开活动文档（如关闭工作空间、点击菜单栏、切换到其他页签或面板等）的时候，会触发自动保存。" +
+    "每隔多长时间自动保存一次（如果绘图文件没有发生改变，将不会保存）。" +
+    "当 Obsidian 应用内的焦点离开活动文档（如关闭工作空间、点击菜单栏、切换到其他页签或面板等）的时候，也会触发自动保存。" +
     "直接退出 Obsidian 应用（不管是终结进程还是点关闭按钮）不会触发自动保存。",
-  AUTOSAVE_INTERVAL_MOBILE_NAME: "移动端定期保存时间间隔",
+  AUTOSAVE_INTERVAL_MOBILE_NAME: "移动端自动保存时间间隔",
   AUTOSAVE_INTERVAL_MOBILE_DESC:
-    "建议在移动端设置更短的自动保存时间间隔。" +
-    "当 Obsidian 应用内的焦点离开活动文档（如关闭工作空间、点击菜单栏、切换到其他页签或面板等）的时候，会触发自动保存。" +
+    "建议在移动端设置更短的时间间隔。" +
+    "当 Obsidian 应用内的焦点离开活动文档（如关闭工作空间、点击菜单栏、切换到其他页签或面板等）的时候，也会触发自动保存。" +
     "直接退出 Obsidian 应用（在应用切换器中划掉）不会触发自动保存。此外，当您切换到其他应用时，有时候" +
-    "系统会自动清理 Obsidian 后台以释放资源。这种情况下，Excalidraw 无法保存最新的变动。",
+    "系统会自动清理 Obsidian 后台以释放资源。这种情况下，自动保存会失效。",
 FILENAME_HEAD: "文件名",
   FILENAME_DESC:
     "<p>点击阅读" +
     "<a href='https://momentjs.com/docs/#/displaying/format/'>日期和时间格式参考</a>。</p>",
   FILENAME_SAMPLE: "“新建绘图”系列命令创建的文件名形如：",
-  FILENAME_EMBED_SAMPLE: "“新建绘图并嵌入到当前文档”系列命令创建的文件名形如：",
+  FILENAME_EMBED_SAMPLE: "“新建绘图并嵌入到当前 Markdown 文档中”系列命令创建的文件名形如：",
   FILENAME_PREFIX_NAME: "“新建绘图”系列命令创建的文件名前缀",
   FILENAME_PREFIX_DESC: "执行“新建绘图”系列命令时，创建的绘图文件名的第一部分",
   FILENAME_PREFIX_EMBED_NAME:
-    "“新建绘图并嵌入到当前文档”系列命令创建的文件名前缀",
+    "“新建绘图并嵌入到当前 Markdown 文档中”系列命令创建的文件名前缀",
   FILENAME_PREFIX_EMBED_DESC:
-    "执行“新建绘图并嵌入到当前文档”系列命令时，" +
+    "执行“新建绘图并嵌入到当前 Markdown 文档中”系列命令时，" +
     "创建的绘图文件名是否以当前文档名作为前缀？<br>" +
     "<b>开启：</b>是<br><b>关闭：</b>否",
   FILENAME_POSTFIX_NAME:
-    "“新建绘图并嵌入到当前文档”系列命令创建的文件名的中间部分",
+    "“新建绘图并嵌入到当前 Markdown 文档中”系列命令创建的文件名的中间部分",
   FILENAME_POSTFIX_DESC:
-    "介于文件名前缀和日期时间之间的文本。仅对“新建绘图并嵌入到当前文档”系列命令创建的绘图生效。",
+    "介于文件名前缀和日期时间之间的文本。仅对“新建绘图并嵌入到当前 Markdown 文档中”系列命令创建的绘图生效。",
   FILENAME_DATE_NAME: "文件名里的日期时间",
   FILENAME_DATE_DESC:
     "文件名的最后一部分。允许留空。",
@@ -174,11 +267,20 @@ FILENAME_HEAD: "文件名",
   FILENAME_EXCALIDRAW_EXTENSION_DESC:
     "该选项在兼容模式（即非 Excalidraw 专用 Markdown 文件）下不会生效。<br>" +
     "<b>开启：</b>使用 .excalidraw.md 作为扩展名。<br><b>关闭：</b>使用 .md 作为扩展名。",
-  DISPLAY_HEAD: "显示",
+  DISPLAY_HEAD: "界面 & 行为",
+  DISPLAY_DESC: "包括：左手模式，主题匹配，缩放，激光笔工具，修饰键等的设置。",
+  DYNAMICSTYLE_NAME: "动态样式",
+  DYNAMICSTYLE_DESC:
+    "根据画布颜色自动调节 Excalidraw 界面颜色",
   LEFTHANDED_MODE_NAME: "左手模式",
   LEFTHANDED_MODE_DESC:
     "目前只在托盘模式下生效。若开启此项，则托盘（绘图工具属性页）将位于右侧。" +
     "<br><b>开启：</b>左手模式。<br><b>关闭：</b>右手模式。",
+  IFRAME_MATCH_THEME_NAME: "使 Embeddable 匹配 Excalidraw 主题",
+  IFRAME_MATCH_THEME_DESC:
+    "<b>开启：</b>当 Obsidian 和 Excalidraw 一个使用黑暗主题、一个使用明亮主题时，" +
+    "开启此项后，以交互形式嵌入到绘图中的元素（Embeddable） 将会匹配 Excalidraw 主题。<br>" +
+    "<b>关闭：</b>如果您想要 Embeddable 匹配 Obsidian 主题，请关闭此项。",    
   MATCH_THEME_NAME: "使新建的绘图匹配 Obsidian 主题",
   MATCH_THEME_DESC:
     "如果 Obsidian 使用黑暗主题，新建的绘图文件也将使用黑暗主题。<br>" +
@@ -199,7 +301,26 @@ FILENAME_HEAD: "文件名",
   DEFAULT_PEN_MODE_NAME: "触控笔模式（Pen mode）",
   DEFAULT_PEN_MODE_DESC:
     "打开绘图时，是否自动开启触控笔模式？",
-
+  SHOW_PEN_MODE_FREEDRAW_CROSSHAIR_NAME: "在触控笔模式下显示十字准星（+）",
+  SHOW_PEN_MODE_FREEDRAW_CROSSHAIR_DESC:
+    "在触控笔模式下使用涂鸦功能会显示十字准星 <b><u>打开:</u></b> 显示 <b><u>关闭:</u></b> 隐藏<br>"+
+    "效果取决于设备。十字准星通常在绘图板、MS Surface 上可见，但在iOS上不可见。",
+  SHOW_DRAWING_OR_MD_IN_HOVER_PREVIEW_NAME: "在 Markdown 文件的悬停预览中渲染为图片",
+  SHOW_DRAWING_OR_MD_IN_HOVER_PREVIEW_DESC:
+    "这个设置影响 frontmatter 中具有 <b>excalidraw-open-md: true</b> 的文件.",
+  SHOW_DRAWING_OR_MD_IN_READING_MODE_NAME: "在 Markdown 文件阅读模式下渲染为图片",
+  SHOW_DRAWING_OR_MD_IN_READING_MODE_DESC:
+    "必须关闭活动的 Excalidraw/Markdown 文件，然后重新打开才能使此更改生效。<br>当您处于 Markdown 阅读模式（即阅读 Excalidraw 的背景笔记）时 Excalidraw 绘图是否应该呈现为图像? " +
+    "此设置不会影响您处于 Excalidraw 模式时的绘图显示，也不会影响将绘图嵌入到 Markdown 文档中或在渲染悬停预览时的显示。<br><ul>" +
+    "<li>看下面的“嵌入和导出”中的<b>PDF导出</b>的其他相关设置。</li>" +
+    "<li>请务必查看“其他功能”部分中的<b>淡化设置</b>。</li></ul>",
+  SHOW_DRAWING_OR_MD_IN_EXPORTPDF_NAME: "在 Markdown 模式下导出为 PDF 时渲染为图片",
+  SHOW_DRAWING_OR_MD_IN_EXPORTPDF_DESC:
+    "必须关闭活动的 Excalidraw/Markdown 文件，然后重新打开才能使此更改生效。<br>当您处于 Markdown 阅读模式（即阅读 Excalidraw 的背景笔记）时将笔记导出为 PDF, Excalidraw 绘图是否应该呈现为图像? <br><ul>" +
+    "<li>查看上面“外观和行为”下的 <b>Markdown 阅读模式</b>的其他相关设置。</li>" +
+    "<li>请务必查看“其他功能”部分中的<b>淡化设置</b>。</li></ul>",
+  THEME_HEAD: "主题和样式",
+  ZOOM_HEAD: "缩放",
   DEFAULT_PINCHZOOM_NAME: "允许在触控笔模式下进行双指缩放",
   DEFAULT_PINCHZOOM_DESC:
     "在触控笔模式下使用自由画笔工具时，双指缩放可能造成干扰。<br>" +
@@ -218,7 +339,14 @@ FILENAME_HEAD: "文件名",
   ZOOM_TO_FIT_MAX_LEVEL_NAME: "自动缩放的最高级别",
   ZOOM_TO_FIT_MAX_LEVEL_DESC:
     "自动缩放画布时，允许放大的最高级别。该值不能低于 0.5（50%）且不能超过 10（1000%）。",
-  LINKS_HEAD: "链接（Links） & 以文本形式嵌入到绘图中的文档（Transclusion）",
+  LASER_HEAD: "激光笔工具（More Tools > Laser pointer）",
+  LASER_COLOR: "激光笔颜色",
+  LASER_DECAY_TIME_NAME: "激光笔消失时间",
+  LASER_DECAY_TIME_DESC: "单位是毫秒，默认是 1000（即 1 秒）。",
+  LASER_DECAY_LENGTH_NAME: "激光笔轨迹长度",
+  LASER_DECAY_LENGTH_DESC: "默认是 50。",
+  LINKS_HEAD: "链接 & 以内部链接形式嵌入到绘图中的 Markdown 文档（MD-Transclusion）& 待办任务（Todo）",
+  LINKS_HEAD_DESC: "包括：链接的打开和显示，MD-Transclusion 的显示，Todo 的显示等设置。",
   LINKS_DESC:
     `按住 ${labelCTRL()} 并点击包含 <code>[[链接]]</code> 的文本元素可以打开其中的链接。` +
     "如果所选文本元素包含多个 <code>[[有效的内部链接]]</code> ，只会打开第一个链接；" +
@@ -226,6 +354,24 @@ FILENAME_HEAD: "文件名",
     "插件会在浏览器中打开链接。<br>" +
     "链接的源文件被重命名时，绘图中相应的 <code>[[内部链接]]</code> 也会同步更新。" +
     "若您不愿绘图中的链接外观因此而变化，可使用 <code>[[内部链接|别名]]</code>。",
+  DRAG_MODIFIER_NAME: "修饰键",
+  DRAG_MODIFIER_DESC: "在您按住点击链接或拖放元素时，可以触发某些行为。您可以为这些行为添加修饰键。" +
+    "Excalidraw 不会检查您的设置是否合理，因此请谨慎设置，避免冲突。" +
+    "以下选项在苹果和非苹果设备上区别很大，如果您在多个硬件平台上使用 Obsidian，需要分别进行设置。"+
+    "选项里的 4 个开关依次代表 " +
+    (DEVICE.isIOS || DEVICE.isMacOS ? "SHIFT, CMD, OPT, CONTROL." : "SHIFT, CTRL, ALT, META (Win 键)。"),
+  LONG_PRESS_DESKTOP_NAME: "长按打开（电脑端）",
+  LONG_PRESS_DESKTOP_DESC: "长按(以毫秒为单位)打开在 Markdown 文件中嵌入的 Excalidraw 绘图。",
+  LONG_PRESS_MOBILE_NAME: "长按打开（移动端）",
+  LONG_PRESS_MOBILE_DESC: "长按(以毫秒为单位)打开在 Markdown 文件中嵌入的 Excalidraw 绘图。",
+
+  FOCUS_ON_EXISTING_TAB_NAME: "聚焦于当前标签页",
+  FOCUS_ON_EXISTING_TAB_DESC: "当打开一个链接时，如果该文件已经打开，Excalidraw 将会聚焦到现有的标签页上 " +
+    "启用这个设置会在文件已经打开的情况下覆盖“重用相邻窗格”的设置。",
+  SECOND_ORDER_LINKS_NAME: "显示二级链接",
+  SECOND_ORDER_LINKS_DESC: "在 Excalidraw 中点击链接时显示链接。二级链接是指指向被点击链接的反向链接" +
+    "当使用图标连接相似的笔记时，二级链接可以让你直接到达相关笔记，而不需要两次点击。" +
+    "请观看 <a href='https://youtube.com/shorts/O_1ls9c6wBY?feature=share'>这个 YouTube Shorts 视频</a> 以了解更多信息。",
   ADJACENT_PANE_NAME: "在相邻面板中打开",
   ADJACENT_PANE_DESC:
     `按住 ${labelCTRL()}+${labelSHIFT()} 并点击绘图里的内部链接时，插件默认会在新面板中打开该链接。<br>` +
@@ -240,17 +386,17 @@ FILENAME_HEAD: "文件名",
   LINK_BRACKETS_DESC: `${
     "文本元素处于预览（PREVIEW）模式时，在内部链接的两侧显示中括号。<br>" +
     "您可为某个绘图单独设置此项，方法是在其 frontmatter 中添加形如 <code>"
-  }${FRONTMATTER_KEY_CUSTOM_LINK_BRACKETS}: true/false</code> 的键值对。`,
+  }${FRONTMATTER_KEYS["link-brackets"].name}: true/false</code> 的键值对。`,
   LINK_PREFIX_NAME: "内部链接的前缀",
   LINK_PREFIX_DESC: `${
     "文本元素处于预览（PREVIEW）模式时，如果其中包含链接，则添加此前缀。<br>" +
     "您可为某个绘图单独设置此项，方法是在其 frontmatter 中添加形如 <code>"
-  }${FRONTMATTER_KEY_CUSTOM_PREFIX}: "📍 "</code> 的键值对。`,
+  }${FRONTMATTER_KEYS["link-prefix"].name}: "📍 "</code> 的键值对。`,
   URL_PREFIX_NAME: "外部链接的前缀",
   URL_PREFIX_DESC: `${
     "文本元素处于预览（PREVIEW）模式时，如果其中包含外部链接，则添加此前缀。<br>" +
     "您可为某个绘图单独设置此项，方法是在其 frontmatter 中添加形如 <code>"
-  }${FRONTMATTER_KEY_CUSTOM_URL_PREFIX}: "🌐 "</code> 的键值对。`,
+  }${FRONTMATTER_KEYS["url-prefix"].name}: "🌐 "</code> 的键值对。`,
   PARSE_TODO_NAME: "待办任务（Todo）",
   PARSE_TODO_DESC: "将文本元素中的 <code>- [ ]</code> 和 <code>- [x]</code> 前缀显示为方框。",
   TODO_NAME: "未完成项目",
@@ -269,31 +415,36 @@ FILENAME_HEAD: "文件名",
     `按住 ${labelCTRL()} 并点击含有 [[链接]] 或 [别名](链接) 的文本来打开链接`,
   LINK_CTRL_CLICK_DESC:
     "如果此功能影响到您使用某些原版 Excalidraw 功能，可将其关闭。" +
-    "关闭后，您只能通过绘图面板标题栏中的链接按钮来打开链接。",
-  TRANSCLUSION_WRAP_NAME: "Transclusion 的折行方式",
+    "关闭后，您可以使用 ${labelCTRL()} + ${labelMETA()} 或者元素右上角的链接指示器来打开链接。",
+  TRANSCLUSION_WRAP_NAME: "MD-Transclusion 的折行方式",
   TRANSCLUSION_WRAP_DESC:
     "中的 number 表示嵌入的文本溢出时，在第几个字符处进行折行。<br>" +
     "此开关控制具体的折行方式。若开启，则严格在 number 处折行，禁止溢出；" +
     "若关闭，则允许在 number 位置后最近的空格处折行。",
-  TRANSCLUSION_DEFAULT_WRAP_NAME: "Transclusion 的默认折行位置",
+  TRANSCLUSION_DEFAULT_WRAP_NAME: "MD-Transclusion 的默认折行位置",
   TRANSCLUSION_DEFAULT_WRAP_DESC:
     "除了通过 <code>![[doc#^block]]{number}</code> 中的 number 来控制折行位置，您也可以在此设置 number 的默认值。<br>" +
     "一般设为 0 即可，表示不设置固定的默认值，这样当您需要嵌入文档到便签中时，" +
     "Excalidraw 能更好地帮您自动处理。",
-  PAGE_TRANSCLUSION_CHARCOUNT_NAME: "Transclusion 的最大显示字符数",
+  PAGE_TRANSCLUSION_CHARCOUNT_NAME: "MD-Transclusion 的最大显示字符数",
   PAGE_TRANSCLUSION_CHARCOUNT_DESC:
     "以 <code>![[内部链接]]</code> 或 <code>![](内部链接)</code> 的形式将文档以文本形式嵌入到绘图中时，" +
     "该文档在绘图中可显示的最大字符数量。",
-  QUOTE_TRANSCLUSION_REMOVE_NAME: "隐藏 Transclusion 行首的引用符号",
-  QUOTE_TRANSCLUSION_REMOVE_DESC: "不显示 Transclusion 中每一行行首的 > 符号，以提高纯文本 Transclusion 的可读性。<br>" +
+  QUOTE_TRANSCLUSION_REMOVE_NAME: "隐藏 MD-Transclusion 行首的引用符号",
+  QUOTE_TRANSCLUSION_REMOVE_DESC: "不显示 MD-Transclusion 中每一行行首的 > 符号，以提高纯文本 MD-Transclusion 的可读性。<br>" +
     "<b>开启：</b>隐藏 > 符号<br><b>关闭：</b>不隐藏 > 符号（注意，由于 Obsidian API 的原因，首行行首的 > 符号不会被隐藏）",
   GET_URL_TITLE_NAME: "使用 iframly 获取页面标题",
   GET_URL_TITLE_DESC:
     "拖放链接到 Excalidraw 时，使用 <code>http://iframely.server.crestify.com/iframely?url=</code> 来获取页面的标题。",
+  PDF_TO_IMAGE: "以图像形式嵌入到绘图中的 PDF 文档",
+  PDF_TO_IMAGE_SCALE_NAME: "分辨率",
+  PDF_TO_IMAGE_SCALE_DESC: "分辨率越高，图像越清晰，但内存占用也越大。" +
+    "此外，如果您想要复制这些图像到 Excalidraw.com，可能会超出其 2MB 大小的限制。",
+  EMBED_TOEXCALIDRAW_HEAD: "嵌入到绘图中的文件",
+  EMBED_TOEXCALIDRAW_DESC: "包括：以图像形式嵌入到绘图中的 PDF 文档、以交互形式嵌入到绘图中的 Markdown 文档（MD-Embeddable）、以图像形式嵌入的 Markdown 文档（MD-Embed）等。",
   MD_HEAD: "以图像形式嵌入到绘图中的 Markdown 文档（MD-Embed）",
-  MD_HEAD_DESC:
-    "您还可以将 Markdown 文档以图像形式（而非文本形式）嵌入到绘图中。" +
-    `方法是按住 ${labelCTRL()} 并从文件管理器中把文档拖入绘图，或者执行“以图像形式嵌入”系列命令。`,
+  MD_EMBED_CUSTOMDATA_HEAD_NAME: "以交互形式嵌入到绘图中的 Markdown 文档（MD-Embeddable）",
+  MD_EMBED_CUSTOMDATA_HEAD_DESC: `这些选项不会影响到已存在的 MD-Embeddable。MD-Embeddable 的主题风格在“显示 & 行为”小节设置。`,
   MD_TRANSCLUDE_WIDTH_NAME: "MD-Embed 的默认宽度",
   MD_TRANSCLUDE_WIDTH_DESC:
     "MD-Embed 的宽度。该选项会影响到折行，以及图像元素的宽度。<br>" +
@@ -329,35 +480,71 @@ FILENAME_HEAD: "文件名",
     "此外，在 CSS 中不能任意地设置字体，您一般只能使用系统默认的标准字体（详见 README），" +
     "但可以通过上面的设置来额外添加一个自定义字体。<br>" +
     "您可为某个 MD-Embed 单独设置此项，方法是在其源文件的 frontmatter 中添加形如 <code>excalidraw-css: 库中的CSS文件或CSS片段</code> 的键值对。",
-  EMBED_HEAD: "嵌入到文档中的绘图（Embed） & 导出",
+  EMBED_HEAD: "嵌入到 Markdown 文档中的绘图",
+  EMBED_DESC: `包括：嵌入到 Markdown 文档中的绘图的预览图类型（SVG、PNG）、源文件类型（Excalidraw 绘图文件、SVG、PNG）、缓存、图像大小、图像主题，以及嵌入的语法等。
+    此外，还有自动导出 SVG 或 PNG 文件并保持与绘图文件状态同步的设置。`,
+  EMBED_CANVAS: "Obsidian 白板支持",
+  EMBED_CANVAS_NAME: "沉浸式嵌入",
+  EMBED_CANVAS_DESC: 
+    "当嵌入绘图到 Obsidian 白板中时，隐藏元素的边界和背景。" +
+    "注意：如果想要背景完全透明，您依然需要在 Excalidraw 中设置“导出的图像不包含背景”。",
+  EMBED_CACHING: "预览图缓存",
+  EXPORT_SUBHEAD: "导出",
+  EMBED_SIZING: "图像尺寸",
+  EMBED_THEME_BACKGROUND: "图像的主题和背景色",
+  EMBED_IMAGE_CACHE_NAME: "为嵌入到 Markdown 文档中的绘图创建预览图缓存",
+  EMBED_IMAGE_CACHE_DESC: "可提高下次嵌入的速度。" +
+    "但如果绘图中又嵌入了子绘图，当子绘图改变时，您需要打开子绘图并手动保存，才能够更新父绘图的预览图。",
+  SCENE_IMAGE_CACHE_NAME: "缓存场景中嵌套的 Excalidraw",
+  SCENE_IMAGE_CACHE_DESC: "缓存场景中嵌套的 Excalidraw 以加快场景渲染速度。这将加快渲染过程，特别是在您的场景中有深度嵌套的 Excalidraw 时。" + 
+    "Excalidraw 将智能地尝试识别嵌套 Excalidraw 的子元素是否发生变化，并更新缓存。 " +
+    "如果您怀疑缓存未能正确更新，您可能需要关闭此功能。",
+  EMBED_IMAGE_CACHE_CLEAR: "清除缓存",
+  BACKUP_CACHE_CLEAR: "清除备份",
+  BACKUP_CACHE_CLEAR_CONFIRMATION: "该操作将删除所有绘图文件的备份。备份是绘图文件损坏时的一种补救手段。每次您打开 Obsidian 时，本插件会自动清理无用的备份。您确定要现在删除所有备份吗？",
   EMBED_REUSE_EXPORTED_IMAGE_NAME:
-    "将之前已导出的图像作为 Embed 的预览图（如果存在的话）",
+    "将之前已导出的图像作为预览图",
   EMBED_REUSE_EXPORTED_IMAGE_DESC:
-    "该选项与“自动导出 SVG/PNG 副本”选项配合使用。如果存在文件名相匹配的 SVG/PNG 副本，则将其作为 Embed 的预览图，而不再重新生成预览图。<br>" +
-    "该选项能够提高性能，尤其是当 Embed 中含有大量图像或 MD-Embed 时。" +
-    "但是，该选项也可能导致预览图无法立即响应你最新的修改，或者你对 Obsidian 主题风格的改变。<br>" +
-    "该选项仅作用于嵌入到文档中的绘图。" +
-    "由于种种原因，该技术无法用于加快绘图文件的打开速度。详见<a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/1.6.23' target='_blank'>此说明</a>。",
-  EMBED_PREVIEW_SVG_NAME: "生成 SVG 格式的 Embed 预览图",
+    "该选项与“自动导出 SVG/PNG 副本”选项配合使用。如果嵌入到 Markdown 文档中的绘图文件存在同名的 SVG/PNG 副本，则将其作为预览图，而不再重新生成。<br>" +
+    "该选项能够提高 Markdown 文档的打开速度，尤其是当嵌入到 Markdown 文档中的绘图文件中含有大量图像或 MD-Embed 时。" +
+    "但是，该选项也可能导致预览图无法立即响应你对绘图文件或者 Obsidian 主题风格的修改。<br>" +
+    "该选项仅作用于嵌入到 Markdown 文档中的绘图。" +
+    "该选项无法提升绘图文件的打开速度。详见<a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/1.6.23' target='_blank'>此说明</a>。",
+  /*EMBED_PREVIEW_SVG_NAME: "生成 SVG 格式的预览图",
   EMBED_PREVIEW_SVG_DESC:
-    "<b>开启：</b>在 Markdown 预览模式下，为 Embed 生成 <a href='https://en.wikipedia.org/wiki/Scalable_Vector_Graphics' target='_blank'>SVG</a> 格式的预览图。<br>" +
-    "<b>关闭：</b>为 Embed 生成 <a href='' target='_blank'>PNG</a> 格式的预览图。注意：PNG 格式预览图不支持某些 <a href='https://www.youtube.com/watch?v=yZQoJg2RCKI&t=633s' target='_blank'>绘图元素的块引用特性</a>。",
-  PREVIEW_MATCH_OBSIDIAN_NAME: "Embed 预览图匹配 Obsidian 主题",
+    "<b>开启：</b>为嵌入到 Markdown 文档中的绘图生成 <a href='https://en.wikipedia.org/wiki/Scalable_Vector_Graphics' target='_blank'>SVG</a> 格式的预览图。<br>" +
+    "<b>关闭：</b>为嵌入到 Markdown 文档中的绘图生成 <a href='' target='_blank'>PNG</a> 格式的预览图。注意：PNG 格式预览图不支持某些 <a href='https://www.youtube.com/watch?v=yZQoJg2RCKI&t=633s' target='_blank'>绘图元素的块引用特性</a>。",*/
+  EMBED_PREVIEW_IMAGETYPE_NAME: "预览图的格式",
+  EMBED_PREVIEW_IMAGETYPE_DESC:
+    "<b>Native SVG：</b>高品质、可交互。<br>" +
+    "<b>SVG：</b>高品质、不可交互。<br>" +
+    "<b>PNG：</b>高性能、<a href='https://www.youtube.com/watch?v=yZQoJg2RCKI&t=633s' target='_blank'>不可交互</a>。", 
+  PREVIEW_MATCH_OBSIDIAN_NAME: "预览图匹配 Obsidian 主题",
   PREVIEW_MATCH_OBSIDIAN_DESC:
-    "开启此项，则当 Obsidian 处于黑暗模式时，Embed 的预览图也会以黑暗模式渲染；当 Obsidian 处于明亮模式时，预览图也会以明亮模式渲染。<br>" +
+    "开启此项，则当 Obsidian 处于黑暗模式时，嵌入到 Markdown 文档中的绘图的预览图也会以黑暗模式渲染；当 Obsidian 处于明亮模式时，预览图也会以明亮模式渲染。<br>" +
     "您可能还需要关闭“导出的图像包含背景”开关，来获得与 Obsidian 更加协调的观感。",
-  EMBED_WIDTH_NAME: "Embed 预览图的默认宽度",
+  EMBED_WIDTH_NAME: "预览图的默认宽度",
   EMBED_WIDTH_DESC:
-    "该选项同时作用于 Obsidian 实时预览模式下的编辑视图和阅读视图，以及鼠标悬停时浮现的预览图。<br>" +
-    "您可为某个要嵌入到文档中的绘图（Embed）单独设置此项，" +
-    "方法是修改相应的链接格式为形如 <code>![[drawing.excalidraw|100]]</code> 或 <code>[[drawing.excalidraw|100x100]]</code> 的格式。",
-  EMBED_TYPE_NAME: "“嵌入绘图到当前文档”系列命令的源文件类型",
+    "嵌入到 Markdown 文档中的绘图的预览图的默认宽度。该选项也适用于鼠标悬停时浮现的预览图。<br>" +
+    "您可为某个要嵌入到 Markdown 文档中的绘图文件单独设置此项，" +
+    "方法是修改相应的内部链接格式为形如 <code>![[drawing.excalidraw|100]]</code> 或 <code>[[drawing.excalidraw|100x100]]</code>。",
+  EMBED_HEIGHT_NAME: "预览图的默认高度",
+  EMBED_HEIGHT_DESC:
+    "嵌入到 Markdown 文档中的绘图的预览图得默认高度。该选项也适用于实时预览编辑和阅读模式,以及悬停预览。" +
+    "您可以在使用 <code>![[drawing.excalidraw|100]]</code> 或者 <code>[[drawing.excalidraw|100x100]]</code>" +
+    "格式在嵌入图像时指定自定义高度。",
+  EMBED_TYPE_NAME: "“嵌入绘图到当前 Markdown 文档中”系列命令的源文件类型",
   EMBED_TYPE_DESC:
-    "在命令面板中执行“嵌入绘图到当前文档”系列命令时，要嵌入绘图文件本身，还是嵌入其 PNG 或 SVG 副本。<br>" +
-    "如果您想选择 PNG 或 SVG 副本，需要先开启下方的“自动导出 PNG 副本”或“自动导出 SVG 副本”开关。<br>" +
+    "在命令面板中执行“嵌入绘图到当前 Markdown 文档中”系列命令时，要嵌入绘图文件本身，还是嵌入其 PNG 或 SVG 副本。<br>" +
+    "如果您想选择 PNG 或 SVG 副本，需要先开启下方的“自动导出 PNG 副本”或“自动导出 SVG 副本”。<br>" +
     "如果您选择了 PNG 或 SVG 副本，当副本不存在时，该命令将会插入一条损坏的链接，您需要打开绘图文件并手动导出副本才能修复 —— " +
     "也就是说，该选项不会自动帮您生成 PNG/SVG 副本，而只会引用已有的 PNG/SVG 副本。",
-  EMBED_WIKILINK_NAME: "“嵌入绘图到当前文档”命令产生的内部链接类型",
+  EMBED_MARKDOWN_COMMENT_NAME: "将链接作为注释嵌入",
+  EMBED_MARKDOWN_COMMENT_DESC: 
+    "在图像下方以 Markdown 链接的形式嵌入原始 Excalidraw 文件的链接，例如：<code>%%[[drawing.excalidraw]]%%</code>。<br>" +
+    "除了添加 Markdown 注释之外，您还可以选择嵌入的 SVG 或 PNG，并使用命令面板: " +
+    "'<code>Excalidraw: 打开 Excalidraw 绘图</code>'来打开该绘图",
+  EMBED_WIKILINK_NAME: "“嵌入绘图到当前 Markdown 文档中”系列命令产生的内部链接类型",
   EMBED_WIKILINK_DESC:
     "<b>开启：</b>将产生 <code>![[Wiki 链接]]</code>。<b>关闭：</b>将产生 <code>![](Markdown 链接)</code>。",
   EXPORT_PNG_SCALE_NAME: "导出的 PNG 图像的比例",
@@ -370,10 +557,14 @@ FILENAME_HEAD: "文件名",
     "导出的 SVG/PNG 图像四周的空白边距（单位：像素）。<br>" +
     "增加该值，可以避免在导出图像时，靠近图像边缘的图形被裁掉。<br>" +
     "您可为某个绘图单独设置此项，方法是在其 frontmatter 中添加形如 <code>excalidraw-export-padding: 5<code> 的键值对。",
-  EXPORT_THEME_NAME: "导出的图像包含主题",
+  EXPORT_THEME_NAME: "导出的图像匹配主题",
   EXPORT_THEME_DESC:
     "导出与绘图的黑暗/明亮主题匹配的图像。" +
     "如果关闭，在黑暗主题下导出的图像将和明亮主题一样。",
+  EXPORT_EMBED_SCENE_NAME: "在导出的图片中嵌入场景",
+  EXPORT_EMBED_SCENE_DESC:
+    "在导出的图像中嵌入 Excalidraw 场景。可以通过在文件级别添加 <code>excalidraw-export-embed-scene: true/false</code> frontmatter 元数据键来覆盖此设置。" +
+    "此设置仅在您下次(重新)打开绘图时生效。",
   EXPORT_HEAD: "导出设置",
   EXPORT_SYNC_NAME:
     "保持 SVG/PNG 文件名与绘图文件同步",
@@ -390,10 +581,28 @@ FILENAME_HEAD: "文件名",
     "的键值对",
   EXPORT_PNG_NAME: "自动导出 PNG 副本",
   EXPORT_PNG_DESC: "和“自动导出 SVG 副本”类似，但是导出格式为 *.PNG。",
-  EXPORT_BOTH_DARK_AND_LIGHT_NAME: "同时导出黑暗和明亮风格的图像",
+  EXPORT_BOTH_DARK_AND_LIGHT_NAME: "同时导出黑暗和明亮主题风格的图像",
   EXPORT_BOTH_DARK_AND_LIGHT_DESC:  "若开启，Excalidraw 将导出两个文件：filename.dark.png（或 filename.dark.svg）和 filename.light.png（或 filename.light.svg）。<br>"+
     "该选项可作用于“自动导出 SVG 副本”、“自动导出 PNG 副本”，以及其他的手动的导出命令。",
   COMPATIBILITY_HEAD: "兼容性设置",
+  COMPATIBILITY_DESC: "如果没有特殊原因（例如您想同时在 VSCode / Logseq 和 Obsidian 中使用 Excalidraw），建议您使用 markdown 格式的绘图文件，而不是旧的 excalidraw.com 格式，因为本插件的很多功能在旧格式中无法使用。",
+  DUMMY_TEXT_ELEMENT_LINT_SUPPORT_NAME: "插入虚拟的第一个文本元素以支持代码格式化工具（Linting）",
+  DUMMY_TEXT_ELEMENT_LINT_SUPPORT_DESC: "Excalidraw 对 <code># Excalidraw Data</code> 下的文件结构非常敏感。文档的自动代码格式化（linting）可能会在 Excalidraw 数据中造成错误。" +
+    "虽然我已经努力使数据加载对自动代码格式化（linting）变更具有一定的抗性，但这种解决方案并非万无一失。<br>"+
+    "<mark>最好的方法是避免使用不同的插件对 Excalidraw 文档进行自动更改。</mark><br>" +
+    "如果出于某些合理的原因，您决定忽略我的建议并配置了 Excalidraw 文件的自动代码格式化，那么可以使用这个设置<br> " +
+    "<code>## Text Elements</code> 部分对空行很敏感。一种常见的代码格式化是在章节标题后添加一个空行。但对于 Excalidraw 来说，这将破坏/改变您绘图中的第一个文本元素。" +
+    "为了解决这个问题，您可以启用这个设置。启用后 Excalidraw 将在 <code>## Text Elements</code> 的开头添加一个虚拟元素，供自动代码格式化工具修改。" ,
+  DEBUGMODE_NAME: "开启 debug 信息",
+  DEBUGMODE_DESC: "我建议在启用/禁用此设置后重新启动 Obsidian。这将在控制台中启用调试消息。这对于排查问题很有帮助。" +
+    "如果您在使用插件时遇到问题，请启用此设置，重现问题，并在 <a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/issues'>GitHub</a> 上提出的问题中包含控制台日志。",
+  SLIDING_PANES_NAME: "Sliding panes 插件支持",
+  SLIDING_PANES_DESC:
+    "设置此项后需要重启 Obsidian 才能生效。<br>" +
+    "如果您使用 <a href='https://github.com/deathau/sliding-panes-obsidian' target='_blank'>Sliding Panes 插件</a>，" +
+    "您可以开启此项来使 Excalidraw 绘图兼容此插件。<br>" +
+    "注意，开启后会产生一些与 Obsidian 工作空间的兼容性问题。<br>" +
+    "另外，Obsidian 现在已经原生支持 Stack Tabs（堆叠标签），基本实现了 Sliding Panes 插件的功能。",
   EXPORT_EXCALIDRAW_NAME: "自动导出 Excalidraw 旧格式副本",
   EXPORT_EXCALIDRAW_DESC: "和“自动导出 SVG 副本”类似，但是导出格式为 *.excalidraw。",
   SYNC_EXCALIDRAW_NAME:
@@ -403,24 +612,47 @@ FILENAME_HEAD: "文件名",
     "则根据旧格式文件的内容来更新新格式文件。",
   COMPATIBILITY_MODE_NAME: "以旧格式创建新绘图",
   COMPATIBILITY_MODE_DESC:
+    "⚠️ 慎用！99.9% 的情况下您不需要开启此项。" +
     "开启此功能后，您通过功能区按钮、命令面板、" +
     "文件浏览器等创建的绘图都将是旧格式（*.excalidraw）。" +
-    "此外，您打开旧格式绘图文件时将不再收到提醒消息。",
+    "此外，您打开旧格式绘图文件时将不再收到警告消息。",
   MATHJAX_NAME: "MathJax (LaTeX) 的 javascript 库服务器",
   MATHJAX_DESC: "如果您在绘图中使用 LaTeX，插件需要从服务器获取并加载一个 javascript 库。" + 
     "如果您的网络无法访问某些库服务器，可以尝试通过此选项更换库服务器。"+
     "更改此选项后，您可能需要重启 Obsidian 来使其生效。",
+  LATEX_DEFAULT_NAME: "插入 LaTeX 时的默认表达式",
+  LATEX_DEFAULT_DESC: "允许留空。允许使用类似 <code>\\color{white}</code> 的格式化表达式。",
   NONSTANDARD_HEAD: "非 Excalidraw.com 官方支持的特性",
-  NONSTANDARD_DESC: "这些特性不受 Excalidraw.com 官方支持。当导出绘图到 Excalidraw.com 时，这些特性将会发生变化。",
-  CUSTOM_PEN_NAME: "自定义画笔的数量",
-  CUSTOM_PEN_DESC: "在画布上的 Obsidian 菜单旁边切换自定义画笔。长按画笔按钮可以修改其样式。",
-  EXPERIMENTAL_HEAD: "实验性功能",
-  EXPERIMENTAL_DESC:
-    "以下部分设置不会立即生效，需要刷新文件资源管理器或者重启 Obsidian 才会生效。",
+  NONSTANDARD_DESC: `这些特性不受 Excalidraw.com 官方支持。如果以 Excalidraw.com 格式导出绘图，这些特性将会发生不可预知的变化。
+    包括：自定义画笔工具的数量，自定义字体等。`,
+  RENDER_TWEAK_HEAD: "渲染优化",
+  MAX_IMAGE_ZOOM_IN_NAME: "最大图像放大倍数",
+  MAX_IMAGE_ZOOM_IN_DESC: "为了节省内存，并且因为 Apple Safari (Obsidian on iOS) 有一些硬编码的限制，Excalidraw.com 在放大时会限制图像和大型对象的最大分辨率。您可以使用乘数来覆盖这个限制。" +
+    "这意味着将乘以 Excalidraw 默认设置的限制，乘数越大，图像放大分辨率就越高，但也会消耗更多内存。" +
+    "我建议尝试多个值来设置这个参数。当您放大一个较大的 PNG 图像时,如果图像突然从视图中消失,那就说明您已经达到了极限。默认值为 1。此设置对 iOS 无效。",
+  CUSTOM_PEN_HEAD: "自定义画笔",
+  CUSTOM_PEN_NAME: "自定义画笔工具的数量",
+  CUSTOM_PEN_DESC: "在画布上的 Obsidian 菜单按钮旁边切换自定义画笔。长按画笔按钮可以修改其样式。",
+  EXPERIMENTAL_HEAD: "杂项",
+  EXPERIMENTAL_DESC: `包括：默认的 LaTeX 公式，字段建议，绘图文件的类型标识符，OCR 等设置。`,
+  EA_HEAD: "Excalidraw 自动化",
+  EA_DESC: 
+    "ExcalidrawAutomate 是用于 Excalidraw 自动化脚本的 API，但是目前说明文档还不够完善，" +
+    "建议阅读 <a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/docs/API/ExcalidrawAutomate.d.ts'>ExcalidrawAutomate.d.ts</a> 文件源码，" +
+    "参考 <a href='https://zsviczian.github.io/obsidian-excalidraw-plugin/'>ExcalidrawAutomate How-to</a> 网页（不过该网页" +
+    "有一段时间未更新了），并开启下方的字段建议。字段建议功能能够在您键入时提示可用的" +
+    "函数及相应的参数，而且附带描述，相当于最新的“文档”。",
   FIELD_SUGGESTER_NAME: "开启字段建议",
   FIELD_SUGGESTER_DESC:
     "开启后，当您在编辑器中输入 <code>excalidraw-</code> 或者 <code>ea.</code> 时，会弹出一个带有函数说明的自动补全提示菜单。<br>" +
     "该功能借鉴了 Breadcrumbs 和 Templater 插件。",
+  STARTUP_SCRIPT_NAME: "起动脚本",
+  STARTUP_SCRIPT_DESC:
+    "插件启动时将自动执行该脚本。可用于为您的 Excalidraw 自动化脚本设置钩子。" +
+    "起动脚本请用 javascript 代码编写，并保存为 Markdown 格式。",
+  STARTUP_SCRIPT_BUTTON_CREATE: "创建起动脚本",
+  STARTUP_SCRIPT_BUTTON_OPEN: "打开起动脚本",
+  STARTUP_SCRIPT_EXISTS: "起动脚本已存在",
   FILETYPE_NAME: "在文件浏览器中为 excalidraw.md 文件添加类型标识符（如 ✏️）",
   FILETYPE_DESC:
     "可通过下一项设置来自定义类型标识符。",
@@ -432,6 +664,12 @@ FILENAME_HEAD: "文件名",
     "开启此项，则可在 Obsidian 实时预览模式的编辑视图下，用形如 <code>![[绘图|宽度|样式]]</code> 的语法来嵌入绘图。<br>" +
     "该选项不会在已打开的文档中立刻生效 —— " +
     "你需要重新打开此文档来使其生效。",
+  FADE_OUT_EXCALIDRAW_MARKUP_NAME: "淡化 Excalidraw 标记",
+  FADE_OUT_EXCALIDRAW_MARKUP_DESC: "在 Markdown 视图模式下，在 Markdown 注释 %% " +
+    "之后的部分会淡化。文本仍然存在，但视觉杂乱感会减少。请注意，您可以将 %% 放在 # Text Elements 行的上一行，" +
+    "这样，整个 Excalidraw Markdown 都会淡化,包括 # Text Elements。 副作用是您将无法在其他 Markdown 笔记中引用文本块,即 %% 注释部分之后的内容。这应该不是大问题。" +
+    "如果您想编辑 Excalidraw Markdown 脚本，只需切换到 Markdown 视图模式并暂时删除 %% 注释。",
+  CUSTOM_FONT_HEAD: "自定义字体",
   ENABLE_FOURTH_FONT_NAME: "为文本元素启用本地字体",
   ENABLE_FOURTH_FONT_DESC:
     "开启此项后，文本元素的属性面板里会多出一个本地字体按钮。<br>" +
@@ -443,30 +681,44 @@ FILENAME_HEAD: "文件名",
     "选择库文件夹中的一个 .ttf, .woff 或 .woff2 字体文件作为本地字体文件。" +
     "若未选择文件，则使用默认的 Virgil 字体。",
   SCRIPT_SETTINGS_HEAD: "已安装脚本的设置",
+  SCRIPT_SETTINGS_DESC: "有些 Excalidraw 自动化脚本包含设置项，当执行这些脚本时，它们会在该列表下添加设置项。",
   TASKBONE_HEAD: "Taskbone OCR（光学符号识别）",
   TASKBONE_DESC: "这是一个将 OCR 融入 Excalidraw 的实验性功能。请注意，Taskbone 是一项独立的外部服务，而不是由 Excalidraw 或 Obsidian-excalidraw-plugin 项目提供的。" +
     "OCR 能够对画布上用自由画笔工具写下的涂鸦或者嵌入的图像进行文本识别，并将识别出来的文本写入绘图文件的 frontmatter，同时复制到剪贴板。" +
     "之所以要写入 frontmatter 是为了便于您在 Obsidian 中能够搜索到这些文本。" +
-    "注意，识别的过程不是在本地进行的，而是通过在线 API，图像会被上传到 taskbone 的服务器（仅用于识别目的）。如果您对此敏感，请不要使用这个功能。",
+    "注意，识别的过程不是在本地进行的，而是通过在线 API，图像会被上传到 taskbone 的服务器（仅用于识别目的）。如果您介意，请不要使用这个功能。",
   TASKBONE_ENABLE_NAME: "启用 Taskbone",
-  TASKBONE_ENABLE_DESC: "启用这个功能意味着你同意 Taskbone <a href='https://www.taskbone.com/legal/terms/' target='_blank'>条款及细则</a> 以及 " +
+  TASKBONE_ENABLE_DESC: "启用意味着您同意 Taskbone <a href='https://www.taskbone.com/legal/terms/' target='_blank'>条款及细则</a> 以及 " +
     "<a href='https://www.taskbone.com/legal/privacy/' target='_blank'>隐私政策</a>.",
   TASKBONE_APIKEY_NAME: "Taskbone API Key",
   TASKBONE_APIKEY_DESC: "Taskbone 的免费 API key 提供了一定数量的每月识别次数。如果您非常频繁地使用此功能，或者想要支持 " + 
-    "Taskbone 的开发者（您懂的，没有人能用爱发电，Taskbone 开发者也需要投入资金才能持续运行这项 OCR 服务）您可以" +
+    "Taskbone 的开发者（您懂的，没有人能用爱发电，Taskbone 开发者也需要投入资金来维持这项 OCR 服务）您可以" +
     "到 <a href='https://www.taskbone.com/' target='_blank'>taskbone.com</a> 购买一个商用 API key。购买后请将它填写到旁边这个文本框里，替换掉原本自动生成的免费 API key。",
 
   //openDrawings.ts
   SELECT_FILE: "选择一个文件后按回车。",
+  SELECT_COMMAND: "选择一个命令后按回车。",
   SELECT_FILE_WITH_OPTION_TO_SCALE: `选择一个文件后按回车，或者 ${labelSHIFT()}+${labelMETA()}+ENTER 以 100% 尺寸插入。`,
   NO_MATCH: "查询不到匹配的文件。",
-  SELECT_FILE_TO_LINK: "选择要插入（链接）到当前绘图中的文件。",
-  SELECT_DRAWING: "选择要插入（以图像形式嵌入）到当前绘图中的图像。",
+  NO_MATCHING_COMMAND: "查询不到匹配的命令。",
+  SELECT_FILE_TO_LINK: "选择要插入（以内部链接形式嵌入）到当前绘图中的文件。",
+  SELECT_COMMAND_PLACEHOLDER: "选择要插入到当前绘图中的命令。",
+  SELECT_DRAWING: "选择要插入（以图像形式嵌入）到当前绘图中的图像或绘图文件。",
   TYPE_FILENAME: "键入要选择的绘图名称。",
   SELECT_FILE_OR_TYPE_NEW:
-    "选择已有绘图，或者新绘图的类型，然后按回车。",
-  SELECT_TO_EMBED: "选择要插入（嵌入）到当前文档中的绘图。",
+    "选择已有绘图，或者键入新绘图文件的名称，然后按回车。",
+  SELECT_TO_EMBED: "选择要插入（嵌入）到当前 Markdown 文档中的绘图。",
   SELECT_MD: "选择要插入（以图像形式嵌入）到当前绘图中的 Markdown 文档。",
+  SELECT_PDF: "选择要插入（以图像形式嵌入）到当前绘图中的 PDF 文档。",
+  PDF_PAGES_HEADER: "页码范围",
+  PDF_PAGES_DESC: "示例：1, 3-5, 7, 9-11",
+
+  //SelectCard.ts
+  TYPE_SECTION: "输入章节名称（标题）进行选择",
+  SELECT_SECTION_OR_TYPE_NEW:
+    "选择现有章节（标题）或输入新章节（标题）的名称,然后按 Enter。",
+  INVALID_SECTION_NAME: "无效的章节名称（标题）",
+  EMPTY_SECTION_MESSAGE: "输入章节（标题）名称以创建",
 
   //EmbeddedFileLoader.ts
   INFINITE_LOOP_WARNING:
@@ -483,6 +735,69 @@ FILENAME_HEAD: "文件名",
   GOTO_FULLSCREEN: "进入全屏模式",
   EXIT_FULLSCREEN: "退出全屏模式",
   TOGGLE_FULLSCREEN: "切换全屏模式",
+  TOGGLE_DISABLEBINDING: "开启或关闭绑定",
+  TOGGLE_FRAME_RENDERING: "开启或关闭框架渲染",
+  TOGGLE_FRAME_CLIPPING: "开启或关闭框架裁剪",
   OPEN_LINK_CLICK: "打开所选的图形或文本元素里的链接",
-  OPEN_LINK_PROPS: "编辑所选 MD-Embed 的内部链接，或者打开所选的图形或文本元素里的链接"
+  OPEN_LINK_PROPS: "编辑所选 MD-Embed 的内部链接，或者打开所选的图形或文本元素里的链接",
+
+  //IFrameActionsMenu.tsx
+  NARROW_TO_HEADING: "缩放至标题",
+  NARROW_TO_BLOCK: "缩放至块",
+  SHOW_ENTIRE_FILE: "显示全部",
+  ZOOM_TO_FIT: "缩放至合适大小",
+  RELOAD: "重载链接",
+  OPEN_IN_BROWSER: "在浏览器中打开",
+  PROPERTIES: "属性",
+  COPYCODE: "复制源文件",
+
+  //EmbeddableSettings.tsx
+  ES_TITLE: "Embeddable 元素设置",
+  ES_RENAME: "重命名",
+  ES_ZOOM: "缩放",
+  ES_YOUTUBE_START: "YouTube 起始时间",
+  ES_YOUTUBE_START_DESC: "ss, mm:ss, hh:mm:ss",
+  ES_YOUTUBE_START_INVALID: "YouTube 起始时间无效。请检查格式并重试",
+  ES_FILENAME_VISIBLE: "显示文件名",
+  ES_BACKGROUND_HEAD: "背景色",
+  ES_BACKGROUND_MATCH_ELEMENT: "匹配元素背景色",
+  ES_BACKGROUND_MATCH_CANVAS: "匹配画布背景色",
+  ES_BACKGROUND_COLOR: "背景色",
+  ES_BORDER_HEAD: "边框颜色",
+  ES_BORDER_COLOR: "边框颜色",
+  ES_BORDER_MATCH_ELEMENT: "匹配元素边框颜色",
+  ES_BACKGROUND_OPACITY: "背景透明度",
+  ES_BORDER_OPACITY: "边框透明度",
+  ES_EMBEDDABLE_SETTINGS: "MD-Embeddable 设置",
+  ES_USE_OBSIDIAN_DEFAULTS: "使用 Obsidian 默认设置",
+  ES_ZOOM_100_RELATIVE_DESC: "使元素的缩放等级等于当前画布的缩放等级",
+  ES_ZOOM_100: "Relative 100%",
+
+  //Prompts.ts
+  PROMPT_FILE_DOES_NOT_EXIST: "文件不存在。要创建吗？",
+  PROMPT_ERROR_NO_FILENAME: "错误：文件名不能为空",
+  PROMPT_ERROR_DRAWING_CLOSED: "未知错误。绘图文件可能已关闭或丢失",
+  PROMPT_TITLE_NEW_FILE: "新建文件",
+  PROMPT_TITLE_CONFIRMATION: "确认",
+  PROMPT_BUTTON_CREATE_EXCALIDRAW: "创建 Excalidraw 绘图",
+  PROMPT_BUTTON_CREATE_EXCALIDRAW_ARIA: "创建 Excalidraw 绘图并在新页签中打开",
+  PROMPT_BUTTON_CREATE_MARKDOWN: "创建 Markdown 文档",
+  PROMPT_BUTTON_CREATE_MARKDOWN_ARIA: "创建 Markdown 文档并在新页签中打开",
+  PROMPT_BUTTON_EMBED_MARKDOWN: "嵌入",
+  PROMPT_BUTTON_EMBED_MARKDOWN_ARIA: "将所选元素替换为 MD-Embeddable",
+  PROMPT_BUTTON_NEVERMIND: "算了",
+  PROMPT_BUTTON_OK: "OK",
+  PROMPT_BUTTON_CANCEL: "取消",
+  PROMPT_BUTTON_INSERT_LINE: "插入一行",
+  PROMPT_BUTTON_INSERT_SPACE: "插入空格",
+  PROMPT_BUTTON_INSERT_LINK: "插入内部链接",
+  PROMPT_BUTTON_UPPERCASE: "大写",
+  PROMPT_SELECT_TEMPLATE: "选择一个模板",
+
+  //ModifierKeySettings
+  WEB_BROWSER_DRAG_ACTION: "从浏览器拖进来时",
+  LOCAL_FILE_DRAG_ACTION: "从本地文件系统拖进来时",
+  INTERNAL_DRAG_ACTION: "在 Obsidian 内部拖放时",
+  PANE_TARGET: "点击链接时",
+  DEFAULT_ACTION_DESC: "无修饰键时的行为：",
 };