Merge branch 'master' of https://github.com/zsviczian/obsidian-excalidraw-plugin

Add modify background color opacity scripts image

README.md

@@ -12,7 +12,7 @@ Please upgrade to Obsidian v0.12.19 or higher to get the latest release.
 |[![6  Links](https://user-images.githubusercontent.com/14358394/125160346-aa0b6580-e17c-11eb-930b-4024807040d1.jpg)](https://youtu.be/MXzeCOEExNo)|[![7  Markdown](https://user-images.githubusercontent.com/14358394/125160354-b2fc3700-e17c-11eb-81af-9e71e461f6dd.jpg)](https://youtu.be/R0IAg0s-wQE)|[![8  Templates](https://user-images.githubusercontent.com/14358394/125160360-b8f21800-e17c-11eb-8bd8-79d4e3f6e92d.jpg)](https://youtu.be/ibdS7ykwpW4)|
 |[![9  Excalidraw Automate](https://user-images.githubusercontent.com/14358394/125160367-bdb6cc00-e17c-11eb-92f1-6f59faea85fd.jpg)](https://youtu.be/VRZVujfVab0)|[![10  Miscellaneous](https://user-images.githubusercontent.com/14358394/125160374-c3141680-e17c-11eb-8cc2-dfaffd903d15.jpg)](https://youtu.be/D1iBYo1_jjc)|[![Image Elements](https://user-images.githubusercontent.com/14358394/138607067-ccb62f92-48a4-4880-ac6e-68c1bf86ac2c.png)](https://www.youtube.com/watch?v=_c_0zpBJ4Xc&)|
 |[![LaTex Demo](https://user-images.githubusercontent.com/14358394/143732412-1c65227e-4381-406d-847a-b001ab3506ca.jpg)](https://youtu.be/r08wk-58DPk)|[![markdown embeds](https://user-images.githubusercontent.com/14358394/143732440-90bfa029-8615-462e-ada3-c903d71a82c9.jpg)](https://youtu.be/tsecSfnTMow)|[![markdownAdvanced](https://user-images.githubusercontent.com/14358394/143783906-15cee494-c6d5-4495-a2ca-74634e4e7355.jpg)](https://youtu.be/K6qZkTz8GHs)|
-|[![Script Engine](https://user-images.githubusercontent.com/14358394/145684531-8d9c2992-59ac-4ebc-804a-4cce1777ded2.jpg)](https://youtu.be/hePJcObHIso)|[![sticky notes thumbnail](https://user-images.githubusercontent.com/14358394/147283367-e5689385-ea51-4983-81a3-04d810d39f62.jpg)](https://youtu.be/NOuddK6xrr8)||
+|[![Script Engine](https://user-images.githubusercontent.com/14358394/145684531-8d9c2992-59ac-4ebc-804a-4cce1777ded2.jpg)](https://youtu.be/hePJcObHIso)|[![sticky notes thumbnail](https://user-images.githubusercontent.com/14358394/147283367-e5689385-ea51-4983-81a3-04d810d39f62.jpg)](https://youtu.be/NOuddK6xrr8)|[![plugin store](https://user-images.githubusercontent.com/14358394/147889174-6c306d0d-2d29-46cc-a53f-3f0013cf14de.jpg)](https://youtu.be/lzYdOQ6z8F0)|
 
 
 # Key features
@@ -26,7 +26,7 @@ Please upgrade to Obsidian v0.12.19 or higher to get the latest release.
   - Compatibility features to auto-export and keep in sync markdown excalidraw files and legacy .excalidraw files.
   - Experimental feature to add custom TAG to file explorer to mark drawing files.
   - Enable / disable autosave.
-- You can customize the size and position of the embedded images using the `[[image.excalidraw|100]]`, `[[image.excalidraw|100x100]]`, `[[image.excalidraw|100|left]]`, `[[image.excalidraw|right-wrap]]`, formatting options. `[[<filename.excalidraw>|<width>x<height>|<alignment>]]`. You can add your custom alignment via CSS. Any text that appears in `<alignment>` will be added to the rendered SVG element style and to the wrapper DIV element. Check below and styles.css for more insight.
+- You can customize the size and position of the embedded images using the `![[image.excalidraw|100]]`, `![[image.excalidraw|100x100]]`, `![[image.excalidraw|100|left]]`, `![[image.excalidraw|right-wrap]]`, formatting options. `![[<filename.excalidraw>|<width>x<height>|<alignment>]]`. You can add your custom alignment via CSS. Any text that appears in `<alignment>` will be added to the rendered SVG element style and to the wrapper DIV element. Check below and styles.css for more insight.
 - Supports hyperlinks e.g. `https://zsolt.blog`, `[Obsidian](https://obsidian.md)`, and internal links e.g. `[[My file in vault|Alias]]` in drawing text. 
   - Links will update when files are moved or renamed, if you have the Obsidian setting Files & Links/Automatically Update Internal Links enabled.
   - Links in drawings will show up in backlinks of documents
@@ -73,6 +73,7 @@ Please upgrade to Obsidian v0.12.19 or higher to get the latest release.
     - `excalidraw-css: "css-filename|css snippet"`
   - Switch to markdown view or use CTRL/CMD+ALT/OPT click on the image to edit properties of the embed: `[[filename#^blockref|WIDTHxMAXHEIGHT]]`
 - Includes full [QuickAdd](https://github.com/chhoumann/quickadd), [Templater](https://silentvoid13.github.io/Templater/) and [Dataview](https://blacksmithgu.github.io/obsidian-dataview/docs/api/intro/) support through ExcalidrawAutomate. Check out the [detailed help + examples](https://zsviczian.github.io/obsidian-excalidraw-plugin/). I also have a [YouTube ExcalidrawAutomate Playlist](https://www.youtube.com/playlist?list=PL6mqgtMZ4NP1IR4nXxSlMA4PA5E-qpyHZ) with lots of examples.
+  - Since 1.5.0 you can easily execute ExcalidrawAutomate macros and assign command palette shortcuts to them, using the ScriptEngine. You will find an intro video and a growing library of ready to install scripts [here](https://github.com/zsviczian/obsidian-excalidraw-plugin/tree/master/ea-scripts).
 - REQUIRES AN OBSIDIAN SYNC SUBSCRIPTION: Full drawing file history and synchronization between devices
 - Multilanguage support: if you'd like to help out by translating the plugin, please get in contact with me.
 

docs/API/attributes_functions_overview.md

@@ -176,6 +176,11 @@ export interface ExcalidrawAutomate {
     b: readonly [number, number],
     gap?: number, //if given, element is inflated by this value
   ): Point[];
+  
+  //See OCR plugin for example on how to use scriptSettings
+  activeScript: string; //Set automatically by the ScriptEngine
+  getScriptSettings(): {}; //Returns script settings. Saves settings in plugin settings, under the activeScript key
+  setScriptSettings(settings:any):Promise<void>; //sets script settings.
 }
 ```
 

ea-scripts/Box Selected Elements.md

@@ -13,9 +13,13 @@ https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.h
 
 ```javascript
 */
-//uncomment if you want a prompt for custom padding
-//const padding = parseInt (await utils.inputPrompt("padding?","number","10"));
-const padding = 10
+//uncomment if you don't want a prompt for custom padding
+//const padding = 10
+const padding = parseInt (await utils.inputPrompt("padding?","number","10"));
+if(isNaN(padding)) {
+  new Notice("The padding value provided is not a number");
+  return;
+}
 elements = ea.getViewSelectedElements();
 const box = ea.getBoundingBox(elements);
 color = ea

ea-scripts/Dimensions.md

@@ -16,7 +16,12 @@ https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.h
 const elements = ea.getViewSelectedElements();
 if(elements.length === 0) return;
 const el = ea.getLargestElement(elements);
-const sizeIn = [el.x,el.y,el.width,el.height].join(",");
+const sizeIn = [
+  Math.round(el.x),
+  Math.round(el.y),
+  Math.round(el.width),
+  Math.round(el.height)
+].join(",");
 let res = await utils.inputPrompt("x,y,width,height?",null,sizeIn);
 res = res.split(",");
 if(res.length !== 4) return;

ea-scripts/Fixed spacing.md

@@ -3,6 +3,8 @@
 
 Download this file and save to your Obsidian Vault including the first line, or open it in "Raw" and copy the entire contents to Obsidian.
 
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fix-space-demo.png)
+
 The script arranges the selected elements horizontally with a fixed spacing.
 
 When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.
@@ -10,6 +12,9 @@ When we create an architecture diagram or mind map, we often need to arrange a l
 ```javascript
 */
 const spacing = parseInt (await utils.inputPrompt("spacing?","number","8"));
+if(isNaN(spacing)) {
+  return;
+}
 const elements=ea.getViewSelectedElements();
 const topGroups = ea.getMaximumGroups(elements);
 const groups = topGroups.sort((lha,rha) => lha[0].x - rha[0].x);

ea-scripts/Fixed vertical distance.md

@@ -3,6 +3,8 @@
 
 Download this file and save to your Obsidian Vault including the first line, or open it in "Raw" and copy the entire contents to Obsidian.
 
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fixed-vertical-distance.png)
+
 The script arranges the selected elements vertically with a fixed spacing.
 
 When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.
@@ -10,6 +12,9 @@ When we create an architecture diagram or mind map, we often need to arrange a l
 ```javascript
 */
 const spacing = parseInt (await utils.inputPrompt("spacing?","number","8"));
+if(isNaN(spacing)) {
+  return;
+}
 const elements=ea.getViewSelectedElements();
 const topGroups = ea.getMaximumGroups(elements);
 const groups = topGroups.sort((lha,rha) => lha[0].y - rha[0].y);

ea-scripts/Modify background color opacity.md

@@ -3,6 +3,8 @@
 
 Download this file and save to your Obsidian Vault including the first line, or open it in "Raw" and copy the entire contents to Obsidian.
 
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-modify-background-color-opacity.png)
+
 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.
@@ -12,6 +14,9 @@ Although excalidraw has the opacity option in its native property Settings, it a
 ```javascript
 */
 const alpha = parseFloat(await utils.inputPrompt("Background color opacity?","number","0.6"));
+if(isNaN(alpha)) {
+  return;
+}
 const elements=ea.getViewSelectedElements().filter((el)=>["rectangle","ellipse","diamond","line","image"].includes(el.type));
 ea.copyViewElementsToEAforEditing(elements);
 ea.getElements().forEach((el)=>{

ea-scripts/OCR - Optical Character Recognition.md

@@ -0,0 +1,121 @@
+/*
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-download-raw.jpg)
+
+Download this file and save to your Obsidian Vault including the first line, or open it in "Raw" and copy the entire contents to Obsidian.
+
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-ocr.jpg)
+
+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
+  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.
+
+The script is based on [@schlundd](https://github.com/schlundd)'s [Obsidian-OCR-Plugin](https://github.com/schlundd/obsidian-ocr-plugin)
+
+See ScriptEngine documentation for more details:
+https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html
+
+```javascript
+*/
+const curVersion = app.plugins.manifests["obsidian-excalidraw-plugin"].version;
+if(curVersion < "1.5.15") new Notice("please update Excalidraw plugin to the latest version");
+
+let token = ea.getScriptSettings()?.token; 
+const BASE_URL = "https://ocr.taskbone.com";
+
+//get new token if token was not provided
+if (!token) {
+  const tokenResponse = await fetch(
+	BASE_URL + "/get-new-token", {
+	  method: 'post'
+  });
+  if (tokenResponse.status === 200) {
+    jsonResponse = await tokenResponse.json();
+	token = jsonResponse.token;
+	ea.setScriptSettings({token});
+  } else {
+	notice(`Taskbone OCR Error: ${tokenResponse.status}\nPlease try again later.`);
+	return;
+  }
+}
+
+//get image element
+//if multiple image elements were selected prompt user to choose
+const imageElements = ea.getViewSelectedElements().filter((el)=>el.type==="image");
+
+//need to save the view to ensure recently pasted images are saved as files
+await ea.targetView.save(); 
+
+let selectedImageElement = null;
+switch (imageElements.length) {
+  case 0: 
+    return;
+  case 1: 
+    selectedImageElement = imageElements[0];
+    break;
+  default:
+	const files = imageElements.map((el)=>ea.getViewFileForImageElement(el));
+	selectedImageElement = await utils.suggester(files.map((f)=>f.name),imageElements);
+    break;
+}
+
+if(!selectedImageElement) {
+  notice("No image element was selected");
+  return;
+}
+const imageFile = ea.getViewFileForImageElement(selectedImageElement);
+if(!imageFile) {
+  notice("Can read image file");
+  return;
+}
+
+//Execute the OCR
+let text = null;
+const fileBuffer = await app.vault.readBinary(imageFile);
+const formData = new FormData();
+formData.append("image", new Blob([fileBuffer]))
+try {
+  const response = await fetch(
+	BASE_URL + "/get-text", { 
+	  headers: {
+		Authorization: "Bearer " + token
+	  },
+	  method: "post",
+	  body: formData
+	});
+  if (response.status == 200) {
+	jsonResponse = await response.json();
+	text = jsonResponse?.text;
+	} else {
+	  notice(`Could not read Text from ${file.path}:\n Error: ${response.status}`);
+	  return;
+	}
+} catch (error) {
+  notice(`The OCR service seems unavailable right now. Please try again later.`);
+  return;
+}
+
+if(!text) {
+  notice("No text found");
+  return;
+}
+console.log({text});
+
+//add text element to drawing
+const id = ea.addText(selectedImageElement.x,selectedImageElement.y+selectedImageElement.height,text);
+await ea.addElementsToView();
+const API = ea.getExcalidrawAPI();
+st = API.getAppState();
+st.selectedElementIds = {};
+st.selectedElementIds[id] = true;
+API.updateScene({appState: st});
+API.zoomToFit(ea.getViewSelectedElements(),1);
+
+//utility function
+function notice(message) {
+  new Notice(message,10000);
+  console.log(message);
+}

ea-scripts/README.md

@@ -1,7 +1,11 @@
 # Excalidraw Script Engine scripts library
+Click to watch the intro video:
+
+[![Script Engine](https://user-images.githubusercontent.com/14358394/145684531-8d9c2992-59ac-4ebc-804a-4cce1777ded2.jpg)](https://youtu.be/hePJcObHIso)
+
 See the [Excalidraw Script Engine](https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html) documentation for more details.
 
-## How to install
+## How to install scripts into your Obsidian Vault
 Open the script you are interested in and save it to your Obsidian Vault including the first line `/*`, or open it in "Raw" and copy the entire contents to Obsidian.
 
 ![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-download-raw.jpg)
@@ -22,14 +26,17 @@ Open the script you are interested in and save it to your Obsidian Vault includi
 |[Expand rectangles horizontally](Expand%20rectangles%20horizontally.md)|This script expands the width of the selected rectangles until they are all the same width.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-expand-rectangles.gif)|[@1-2-3](https://github.com/1-2-3)|
 |[Expand rectangles vertically keep text centered](Expand%20rectangles%20vertically%20keep%20text%20centered.md)|This script expands the height of the selected rectangles until they are all the same height and keep the text centered.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-expand-rectangles.gif)|[@1-2-3](https://github.com/1-2-3)|
 |[Expand rectangles vertically](Expand%20rectangles%20vertically.md)|This script expands the height of the selected rectangles until they are all the same height.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-expand-rectangles.gif)|[@1-2-3](https://github.com/1-2-3)|
-|[Fixed spacing](Fixed%20spacing.md)|The script arranges the selected elements horizontally with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.||[@1-2-3](https://github.com/1-2-3)|
-|[Fixed vertical distance](Fixed%20vertical%20distance.md)|The script arranges the selected elements vertically with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.||[@1-2-3](https://github.com/1-2-3)|
+|[Fixed spacing](Fixed%20spacing.md)|The script arranges the selected elements horizontally with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fix-space-demo.png)|[@1-2-3](https://github.com/1-2-3)|
+|[Fixed vertical distance](Fixed%20vertical%20distance.md)|The script arranges the selected elements vertically with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fixed-vertical-distance.png)|[@1-2-3](https://github.com/1-2-3)|
 |[Font Family](Font%20Family.md)|Sets font family of the text block (Virgil, Helvetica, Cascadia). Useful if you want to set a keyboard shortcut for selecting font family.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-font-family.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Grid](Grid.md)|The default grid size in Excalidraw is 20. Currently there is no way to change the grid size via the user interface. This script offers a way to bridge this gap.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-grid.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Lighten background color](Lighten%20background%20color.md)|This script lightens the background color of the selected element by 2% at a time. You can use this script several times until you are satisfied. It is recommended to set a shortcut key for this script so that you can quickly try to DARKEN and LIGHTEN the color effect.In contrast to the `Modify background color opacity` script, the advantage is that the background color of the element is not affected by the canvas color, and the color value does not appear in a strange rgba() form.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/darken-lighten-background-color.png)|[@1-2-3](https://github.com/1-2-3)|
-|[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.||[@1-2-3](https://github.com/1-2-3)|
+|[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)|
 |[Modify stroke width of selected elements](Modify%20stroke%20width%20of%20selected%20elements.md)|This script will set the stroke width of selected elements. This is helpful, for example, when you scale freedraw sketches and want to reduce or increase their line width.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-stroke-width.jpg)|[@zsviczian](https://github.com/zsviczian)|
+|[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)|
 |[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)|
+|[Set Link Alias](Set20%Link20%Alias.md)|Iterates all of the links in the selected TextElements and prompts the user to set or modify the alias for each link found.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-set-link-alias.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Split text by lines](Split%20text%20by%20lines.md)|Split lines of text into separate text elements for easier reorganization|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-split-lines.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Text Align](Text%20Align.md)|Sets text alignment of text block (cetner, right, left). Useful if you want to set a keyboard shortcut for selecting text alignment.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-align.jpg)|[@zsviczian](https://github.com/zsviczian)|
-|[Zoom to Fit Selected Elements](Zoom%20to%20Fit%20Selected%20Elements.md)|Similar to Excalidraw standard SHIFT+2 feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)||[@zsviczian](https://github.com/zsviczian)|
+|[Transfer TextElements to Excalidraw markdown metadata](Transfer%20TextElements%20to%20Excalidraw%20markdown%20metadata.md)|The script will delete the selected text elements from the canvas and will copy the text from these text elements into the Excalidraw markdown file as metadata. This means, that the text will no longer be visible in the drawing, however you will be able to search for the text in Obsidian and find the drawing containing this image.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-to-metadata.jpg)|[@zsviczian](https://github.com/zsviczian)|
+|[Zoom to Fit Selected Elements](Zoom%20to%20Fit%20Selected%20Elements.md)|Similar to Excalidraw standard SHIFT+2 feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)||[@zsviczian](https://github.com/zsviczian)|

ea-scripts/Set Link Alias.md

@@ -0,0 +1,53 @@
+/*
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-download-raw.jpg)
+
+Download this file and save to your Obsidian Vault including the first line, or open it in "Raw" and copy the entire contents to Obsidian.
+
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-set-link-alias.jpg)
+
+Iterates all of the links in the selected TextElements and prompts the user to set or modify the alias for each link found.
+
+See documentation for more details:
+https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html
+
+```javascript
+*/
+elements = ea.getViewSelectedElements().filter((el)=>el.type==="text");
+// `[[markdown links]]`
+for(el of elements) { //doing for instead of .forEach due to await inputPrompt
+  parts = el.rawText.split(/(\[\[[\w\W]*?]])/);
+  newText = "";
+  for(t of parts) { //doing for instead of .map due to await inputPrompt
+	if(!t.match(/(\[\[[\w\W]*?]])/)) {
+	  newText += t;
+    } else {
+      original = t.split(/\[\[|]]/)[1];
+	  cut = original.indexOf("|");
+	  alias = cut === -1 ? "" : original.substring(cut+1);
+	  link = cut === -1 ? original : original.substring(0,cut);
+      alias = await utils.inputPrompt(`Alias for [[${link}]]`,"type alias here",alias);
+	  newText += `[[${link}|${alias}]]`;
+    }
+  }
+  el.rawText = newText;
+};
+
+// `[wiki](links)`
+for(el of elements) { //doing for instead of .forEach due to await inputPrompt
+  parts = el.rawText.split(/(\[[\w\W]*?]\([\w\W]*?\))/);
+  newText = "";
+  for(t of parts) { //doing for instead of .map due to await inputPrompt
+	if(!t.match(/(\[[\w\W]*?]\([\w\W]*?\))/)) {
+	  newText += t;
+    } else {
+	  alias = t.match(/\[([\w\W]*?)]/)[1];
+	  link = t.match(/\(([\w\W]*?)\)/)[1];
+      alias = await utils.inputPrompt(`Alias for [[${link}]]`,"type alias here",alias);
+	  newText += `[[${link}|${alias}]]`;
+    }
+  }
+  el.rawText = newText;
+};
+
+ea.copyViewElementsToEAforEditing(elements);
+ea.addElementsToView();

ea-scripts/Transfer TextElements to Excalidraw markdown metadata.md

@@ -0,0 +1,44 @@
+/*
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-download-raw.jpg)
+
+Download this file and save to your Obsidian Vault including the first line, or open it in "Raw" and copy the entire contents to Obsidian.
+
+![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-to-metadata.jpg)
+
+The script will delete the selected text elements from the canvas and will copy the text from these text elements into the Excalidraw markdown file as metadata. This means, that the text will no longer be visible in the drawing, however you will be able to search for the text in Obsidian and find the drawing containing this image.
+
+See ScriptEngine documentation for more details:
+https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html
+
+```javascript
+*/
+//get text elements
+
+const textElements = ea.getViewSelectedElements().filter((el)=>el.type==="text");
+
+if(textElements.length===0) {
+  notice("No text elements were selected")
+  return;
+}
+
+metadata = "# Metadata\n" + textElements
+           .map((el)=>el.rawText.replaceAll(/%|\^/g,"_")) //cleaning these characters for safety, might not be needed
+           .join("/n") + "\n";
+
+ea.deleteViewElements(textElements);
+await ea.targetView.save();
+data = await app.vault.read(ea.targetView.file);
+splitAfterFrontmatter = data.split(/(^---[\w\W]*?---\n)/);
+if(splitAfterFrontmatter.length !== 3) {
+  notice("Error locating frontmatter in markdown file");
+  console.log({file:ea.targetView.file});
+  return;
+}
+newData = splitAfterFrontmatter[1]+metadata+splitAfterFrontmatter[2]
+await app.vault.modify(ea.targetView.file,newData);
+
+//utility function
+function notice(message) {
+  new Notice(message);
+  console.log(message);
+}

ea-scripts/index.md

@@ -0,0 +1,210 @@
+If you are enjoying the Excalidraw plugin then please support my work and enthusiasm by buying me a coffee on [https://ko-fi/zsolt](https://ko-fi.com/zsolt).
+
+[<img src="https://user-images.githubusercontent.com/14358394/115450238-f39e8100-a21b-11eb-89d0-fa4b82cdbce8.png" class="coffee">](https://ko-fi.com/zsolt) 
+
+---
+
+Jump ahead to the [[#List of available scripts]]
+
+# Intorducing Excalidraw Automate Script Engine
+<iframe width="560" height="315" src="https://www.youtube.com/embed/hePJcObHIso" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+Script Engine scripts are installed in the `Downloaded` subfolder of the `Excalidraw Automate script folder` specified in plugin settings.
+
+In the `Command Palette` installed scripts are prefixed with `Downloaded/`, thus you can always know if you are executing a local script of your own, or one that you have downloaded from GitHub.
+
+## 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).
+
+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.
+- An [image](https://github.com/zsviczian/obsidian-excalidraw-plugin/tree/master/images) explaining the scripts purpose. Remember a picture speaks thousand words!
+- An update to this file [ea-scripts/index.md](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/index.md)
+
+---
+
+# List of available scripts
+- [[#Box Selected Elements]]
+- [[#Bullet Point]]
+- [[#Connect elements]]
+- [[#Convert text to link with folder and alias]]
+- [[#Create new markdown file and embed into active drawing]]
+- [[#Darken background color]]
+- [[#Dimensions]]
+- [[#Elbow connectors]]
+- [[#Expand rectangles horizontally keep text centered]]
+- [[#Expand rectangles horizontally]]
+- [[#Expand rectangles vertically keep text centered]]
+- [[#Expand rectangles vertically]]
+- [[#Fixed spacing]]
+- [[#Fixed vertical distance]]
+- [[#Font Family]]
+- [[#Grid]]
+- [[#Lighten background color]]
+- [[#Modify background color opacity]]
+- [[#Modify stroke width of selected elements]]
+- [[#OCR - Optical Character Recognition]]
+- [[#Reverse arrows]]
+- [[#Set Link Alias]]
+- [[#Split text by lines]]
+- [[#Text Align]]
+- [[#Transfer TextElements to Excalidraw markdown metadata]]
+- [[#Zoom to Fit Selected Elements]]
+
+
+## Box Selected Elements
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Box%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/Box%20Selected%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will add an encapsulating box around the currently selected elements in Excalidraw.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-box-elements.jpg'></td></tr></table>
+
+## Bullet Point
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Bullet%20Point.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/Bullet%20Point.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will add a small circle to the top left of each text element in the selection and add the text and the "bullet point" into a group.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-bullet-point.jpg'></td></tr></table>
+
+## Connect elements
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Connect%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/Connect%20elements.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-connect-elements.jpg'></td></tr></table>
+
+## Convert text to link with folder and alias
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Convert%20text%20to%20link%20with%20folder%20and%20alias.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/Convert%20text%20to%20link%20with%20folder%20and%20alias.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Converts text elements to links pointing to a file in a selected folder and with the alias set as the original text. The script will prompt the user to select an existing folder from the vault.<br><code>original text</code> - <code>[[selected folder/original text|original text]]</code></td></tr></table>
+
+## Create new markdown file and embed into active drawing
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Create%20new%20markdown%20file%20and%20embed%20into%20active%20drawing.md
+```
+<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>
+
+## Darken background color
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Darken%20background%20color.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Darken%20background%20color.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script darkens the background color of the selected element by 2% at a time. You can use this script several times until you are satisfied. It is recommended to set a shortcut key for this script so that you can quickly try to DARKEN and LIGHTEN the color effect. In contrast to the `Modify background color opacity` script, the advantage is that the background color of the element is not affected by the canvas color, and the color value does not appear in a strange rgba() form.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/darken-lighten-background-color.png'></td></tr></table>
+
+## Dimensions
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Dimensions.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/Dimensions.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Currently there is no way to specify the exact location and size of objects in Excalidraw. You can bridge this gap with the following simple script.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-dimensions.jpg'></td></tr></table>
+
+## Elbow connectors
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Elbow%20connectors.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Elbow%20connectors.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script converts the selected connectors to elbows.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/elbow-connectors.png'></td></tr></table>
+
+## Expand rectangles horizontally keep text centered
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Expand%20rectangles%20horizontally%20keep%20text%20centered.md
+```
+<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/Expand%20rectangles%20horizontally%20keep%20text%20centered.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script expands the width of the selected rectangles until they are all the same width and keep the text centered.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-expand-rectangles.gif'></td></tr></table>
+
+## Expand rectangles horizontally
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Expand%20rectangles%20horizontally.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Expand%20rectangles%20horizontally.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script expands the width of the selected rectangles until they are all the same width.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-expand-rectangles.gif'></td></tr></table>
+
+## Expand rectangles vertically keep text centered
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Expand%20rectangles%20vertically%20keep%20text%20centered.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Expand%20rectangles%20vertically%20keep%20text%20centered.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script expands the height of the selected rectangles until they are all the same height and keep the text centered.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-expand-rectangles.gif'></td></tr></table>
+
+## Expand rectangles vertically
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Expand%20rectangles%20vertically.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Expand%20rectangles%20vertically.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script expands the height of the selected rectangles until they are all the same height.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-expand-rectangles.gif'></td></tr></table>
+
+## Fixed spacing
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Fixed%20spacing.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Fixed%20spacing.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script arranges the selected elements horizontally with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fix-space-demo.png'></td></tr></table>
+
+## Fixed vertical distance
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Fixed%20vertical%20distance.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Fixed%20vertical%20distance.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script arranges the selected elements vertically with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fixed-vertical-distance.png'></td></tr></table>
+
+## Font Family
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Font%20Family.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/Font%20Family.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Sets font family of the text block (Virgil, Helvetica, Cascadia). Useful if you want to set a keyboard shortcut for selecting font family.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-font-family.jpg'></td></tr></table>
+
+## Grid
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Grid.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/Grid.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The default grid size in Excalidraw is 20. Currently there is no way to change the grid size via the user interface. This script offers a way to bridge this gap.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-grid.jpg'></td></tr></table>
+
+## Lighten background color
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Lighten%20background%20color.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Lighten%20background%20color.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script lightens the background color of the selected element by 2% at a time. You can use this script several times until you are satisfied. It is recommended to set a shortcut key for this script so that you can quickly try to DARKEN and LIGHTEN the color effect.In contrast to the `Modify background color opacity` script, the advantage is that the background color of the element is not affected by the canvas color, and the color value does not appear in a strange rgba() form.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/darken-lighten-background-color.png'></td></tr></table>
+
+## Modify background color opacity
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Modify%20background%20color%20opacity.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Modify%20background%20color%20opacity.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">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.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-modify-background-color-opacity.png'></td></tr></table>
+
+## Modify stroke width of selected elements
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Modify%20stroke%20width%20of%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/Modify%20stroke%20width%20of%20selected%20elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script will set the stroke width of selected elements. This is helpful, for example, when you scale freedraw sketches and want to reduce or increase their line width.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-stroke-width.jpg'></td></tr></table>
+
+## OCR - Optical Character Recognition
+```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>
+
+## Reverse arrows
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Reverse%20arrows.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/Reverse%20arrows.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Reverse the direction of **arrows** within the scope of selected elements.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-reverse-arrow.jpg'></td></tr></table>
+
+## Set Link Alias
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Link%20Alias.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/Set%20Link%20Alias.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Iterates all of the links in the selected TextElements and prompts the user to set or modify the alias for each link found.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-set-link-alias.jpg'></td></tr></table>
+
+## Split text by lines
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Split%20text%20by%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/Split%20text%20by%20lines.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Split lines of text into separate text elements for easier reorganization<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-split-lines.jpg'></td></tr></table>
+
+## Text Align
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Text%20Align.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%20Align.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Sets text alignment of text block (cetner, right, left). Useful if you want to set a keyboard shortcut for selecting text alignment.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-align.jpg'></td></tr></table>
+
+## Transfer TextElements to Excalidraw markdown metadata
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Transfer%20TextElements%20to%20Excalidraw%20markdown%20metadata.md
+```
+<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/Transfer%20TextElements%20to%20Excalidraw%20markdown%20metadata.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">The script will delete the selected text elements from the canvas and will copy the text from these text elements into the Excalidraw markdown file as metadata. This means, that the text will no longer be visible in the drawing, however you will be able to search for the text in Obsidian and find the drawing containing this image.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-to-metadata.jpg'></td></tr></table>
+
+## Zoom to Fit Selected Elements
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/zsviczian'>@zsviczian</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Similar to Excalidraw standard SHIFT+2 feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)</td></tr></table>

manifest.json

@@ -1,7 +1,7 @@
 {
 	"id": "obsidian-excalidraw-plugin",
 	"name": "Excalidraw",
-	"version": "1.5.10",
+	"version": "1.5.15",
 	"minAppVersion": "0.12.16",
 	"description": "An Obsidian plugin to edit and view Excalidraw drawings",
 	"author": "Zsolt Viczian",

src/EmbeddedFileLoader.ts

@@ -370,8 +370,9 @@ const convertMarkdownToSVG = async (
   //1.
   //get the markdown text
   let text = (await getTransclusion(linkParts, plugin.app, file)).contents;
-  if(text==="") {
-    text = "# Empty markdown file\nCTRL+Click here to open the file for editing in the current active pane, or CTRL+SHIFT+Click to open it in an adjacent pane.";
+  if (text === "") {
+    text =
+      "# Empty markdown file\nCTRL+Click here to open the file for editing in the current active pane, or CTRL+SHIFT+Click to open it in an adjacent pane.";
   }
 
   //2.

src/ExcalidrawAutomate.ts

@@ -6,7 +6,7 @@ import {
   ExcalidrawElement,
   ExcalidrawBindableElement,
 } from "@zsviczian/excalidraw/types/element/types";
-import { normalizePath, TFile } from "obsidian";
+import { Component, MarkdownRenderer, normalizePath, TFile } from "obsidian";
 import ExcalidrawView, { ExportSettings, TextMode } from "./ExcalidrawView";
 import { ExcalidrawData } from "./ExcalidrawData";
 import {
@@ -211,6 +211,11 @@ export interface ExcalidrawAutomate {
     b: readonly [number, number],
     gap?: number, //if given, element is inflated by this value
   ): Point[];
+  
+  //See OCR plugin for example on how to use scriptSettings
+  activeScript: string; //Set automatically by the ScriptEngine
+  getScriptSettings(): {}; //Returns script settings. Saves settings in plugin settings, under the activeScript key
+  setScriptSettings(settings:any):Promise<void>; //sets script settings.
 }
 
 declare let window: any;
@@ -219,7 +224,7 @@ export async function initExcalidrawAutomate(
   plugin: ExcalidrawPlugin,
 ): Promise<ExcalidrawAutomate> {
   window.ExcalidrawAutomate = {
-    plugin,
+    plugin: plugin,
     elementsDict: {},
     imagesDict: {},
     style: {
@@ -969,6 +974,7 @@ export async function initExcalidrawAutomate(
     },
     reset() {
       this.clear();
+      this.activeScript = null;
       this.style.strokeColor = "#000000";
       this.style.backgroundColor = "transparent";
       this.style.angle = 0;
@@ -1237,6 +1243,16 @@ export async function initExcalidrawAutomate(
     ): Point[] {
       return intersectElementWithLine(element, a, b, gap);
     },
+    activeScript: null,
+    getScriptSettings(): {} {
+      if(!this.activeScript) return null;
+      return this.plugin.settings.scriptEngineSettings[this.activeScript];
+    },
+    async setScriptSettings(settings:any): Promise<void> {
+      if(!this.activeScript) return null;
+      this.plugin.settings.scriptEngineSettings[this.activeScript] = settings;
+      await this.plugin.saveSettings();
+    },
   };
   await initFonts();
   return window.ExcalidrawAutomate;

src/ExcalidrawData.ts

@@ -210,6 +210,9 @@ export class ExcalidrawData {
     file: TFile,
     textMode: TextMode,
   ): Promise<boolean> {
+    if (!file) {
+      return false;
+    }
     this.loaded = false;
     this.textElements = new Map<
       string,
@@ -340,6 +343,9 @@ export class ExcalidrawData {
   }
 
   public async loadLegacyData(data: string, file: TFile): Promise<boolean> {
+    if (!file) {
+      return false;
+    }
     this.compatibilityMode = true;
     this.file = file;
     this.textElements = new Map<
@@ -992,6 +998,10 @@ export class ExcalidrawData {
     }
     if (this.plugin.filesMaster.has(fileId)) {
       const fileMaster = this.plugin.filesMaster.get(fileId);
+      if (!this.app.vault.getAbstractFileByPath(fileMaster.path)) {
+        this.plugin.filesMaster.delete(fileId);
+        return true;
+      } // the file no longer exists
       const embeddedFile = new EmbeddedFile(
         this.plugin,
         this.file.path,

src/ExcalidrawView.ts

@@ -24,6 +24,7 @@ import {
   VIEW_TYPE_EXCALIDRAW,
   ICON_NAME,
   DISK_ICON_NAME,
+  SCRIPTENGINE_ICON_NAME,
   PNG_ICON_NAME,
   SVG_ICON_NAME,
   FRONTMATTER_KEY,
@@ -45,6 +46,7 @@ import {
 } from "./ExcalidrawData";
 import {
   checkAndCreateFolder,
+  checkExcalidrawVersion,
   //debug,
   download,
   embedFontsInSVG,
@@ -68,6 +70,7 @@ import {
   EmbeddedFilesLoader,
   FileData,
 } from "./EmbeddedFileLoader";
+import { ScriptInstallPrompt } from "./ScriptInstallPrompt";
 
 export enum TextMode {
   parsed,
@@ -556,7 +559,10 @@ export default class ExcalidrawView extends TextFileView {
   }
 
   onload() {
-    //console.log("ExcalidrawView.onload()");
+    this.addAction(SCRIPTENGINE_ICON_NAME, t("INSTALL_SCRIPT_BUTTON"), () => {
+      new ScriptInstallPrompt(this.plugin).open();
+    });
+
     this.addAction(DISK_ICON_NAME, t("FORCE_SAVE"), async () => {
       await this.save(false);
       this.plugin.triggerEmbedUpdates();
@@ -718,6 +724,7 @@ export default class ExcalidrawView extends TextFileView {
 
   private isLoaded: boolean = false;
   async setViewData(data: string, clear: boolean = false) {
+    checkExcalidrawVersion(this.app);
     this.isLoaded = false;
     if (clear) {
       this.clear();

src/MarkdownPostProcessor.ts

@@ -0,0 +1,481 @@
+import { settings } from "cluster";
+import { MarkdownPostProcessorContext, MetadataCache, TFile, Vault } from "obsidian";
+import { CTRL_OR_CMD, RERENDER_EVENT } from "./constants";
+import { EmbeddedFilesLoader } from "./EmbeddedFileLoader";
+import { createPNG, createSVG } from "./ExcalidrawAutomate";
+import { ExportSettings } from "./ExcalidrawView";
+import ExcalidrawPlugin from "./main";
+import { embedFontsInSVG, getIMGFilename, isObsidianThemeDark, splitFolderAndFilename, svgToBase64 } from "./Utils";
+
+interface imgElementAttributes {
+  file?: TFile;
+  fname: string; //Excalidraw filename
+  fwidth: string; //Display width of image
+  fheight: string; //Display height of image
+  style: string; //css style to apply to IMG element
+}
+
+let plugin: ExcalidrawPlugin;
+let vault: Vault;
+let metadataCache: MetadataCache;
+
+export const initializeMarkdownPostProcessor = (p:ExcalidrawPlugin) => {
+  plugin = p;
+  vault = p.app.vault;
+  metadataCache = p.app.metadataCache;
+}
+
+
+
+/**
+ * Generates an img element with the drawing encoded as a base64 SVG or a PNG (depending on settings)
+ * @param parts {imgElementAttributes} - display properties of the image
+ * @returns {Promise<HTMLElement>} - the IMG HTML element containing the image
+ */
+const getIMG = async (
+  imgAttributes: imgElementAttributes,
+): Promise<HTMLElement> => {
+  let file = imgAttributes.file;
+  if (!imgAttributes.file) {
+    const f = vault.getAbstractFileByPath(imgAttributes.fname);
+    if (!(f && f instanceof TFile)) {
+      return null;
+    }
+    file = f;
+  }
+
+  const exportSettings: ExportSettings = {
+    withBackground: plugin.settings.exportWithBackground,
+    withTheme: plugin.settings.exportWithTheme,
+  };
+  const img = createEl("img");
+  let style = `max-width:${imgAttributes.fwidth}px !important; width:100%;`;
+  if (imgAttributes.fheight) {
+    style += `height:${imgAttributes.fheight}px;`;
+  }
+  img.setAttribute("style", style);
+  img.addClass(imgAttributes.style);
+
+  const theme = plugin.settings.previewMatchObsidianTheme
+    ? isObsidianThemeDark()
+      ? "dark"
+      : "light"
+    : !plugin.settings.exportWithTheme
+    ? "light"
+    : undefined;
+  if (theme) {
+    exportSettings.withTheme = true;
+  }
+  const loader = new EmbeddedFilesLoader(
+    plugin,
+    theme ? theme === "dark" : undefined,
+  );
+
+  if (!plugin.settings.displaySVGInPreview) {
+    const width = parseInt(imgAttributes.fwidth);
+    let scale = 1;
+    if (width >= 600) {
+      scale = 2;
+    }
+    if (width >= 1200) {
+      scale = 3;
+    }
+    if (width >= 1800) {
+      scale = 4;
+    }
+    if (width >= 2400) {
+      scale = 5;
+    }
+    const png = await createPNG(
+      file.path,
+      scale,
+      exportSettings,
+      loader,
+      theme,
+      null,
+      null,
+      [],
+      plugin,
+    );
+    //const png = await getPNG(JSON_parse(scene),exportSettings, scale);
+    if (!png) {
+      return null;
+    }
+    img.src = URL.createObjectURL(png);
+    return img;
+  }
+  const svgSnapshot = (
+    await createSVG(
+      file.path,
+      true,
+      exportSettings,
+      loader,
+      theme,
+      null,
+      null,
+      [],
+      plugin,
+    )
+  ).outerHTML;
+  let svg: SVGSVGElement = null;
+  const el = document.createElement("div");
+  el.innerHTML = svgSnapshot;
+  const firstChild = el.firstChild;
+  if (firstChild instanceof SVGSVGElement) {
+    svg = firstChild;
+  }
+  if (!svg) {
+    return null;
+  }
+  svg = embedFontsInSVG(svg);
+  svg.removeAttribute("width");
+  svg.removeAttribute("height");
+  img.setAttribute("src", svgToBase64(svg.outerHTML));
+  return img;
+};
+
+const createImageDiv = async (
+  attr: imgElementAttributes,
+): Promise<HTMLDivElement> => {
+  const img = await getIMG(attr);
+  return createDiv(attr.style, (el) => {
+    el.append(img);
+    el.setAttribute("src", attr.file.path);
+    if (attr.fwidth) {
+      el.setAttribute("w", attr.fwidth);
+    }
+    if (attr.fheight) {
+      el.setAttribute("h", attr.fheight);
+    }
+    el.onClickEvent((ev) => {
+      if (
+        ev.target instanceof Element &&
+        ev.target.tagName.toLowerCase() != "img"
+      ) {
+        return;
+      }
+      const src = el.getAttribute("src");
+      if (src) {
+        plugin.openDrawing(
+          vault.getAbstractFileByPath(src) as TFile,
+          ev[CTRL_OR_CMD],
+        );
+      } //.ctrlKey||ev.metaKey);
+    });
+    el.addEventListener(RERENDER_EVENT, async (e) => {
+      e.stopPropagation();
+      el.empty();
+      const img = await getIMG({
+        fname: el.getAttribute("src"),
+        fwidth: el.getAttribute("w"),
+        fheight: el.getAttribute("h"),
+        style: el.getAttribute("class"),
+      });
+      el.append(img);
+    });
+  });
+};
+
+
+
+const processInternalEmbeds = async (
+  embeddedItems:NodeListOf<Element>|[HTMLElement],
+  ctx: MarkdownPostProcessorContext,
+) => {
+  //if not, then we are processing a non-excalidraw file in reading mode
+  //in that cases embedded files will be displayed in an .internal-embed container
+  const attr: imgElementAttributes = {
+    fname: "",
+    fheight: "",
+    fwidth: "",
+    style: "",
+  };
+  let alt: string;
+  let parts;
+  let file: TFile;
+
+  //Iterating through all the containers to check which one is an excalidraw drawing
+  //This is a for loop instead of embeddedItems.forEach() because createImageDiv at the end
+  //is awaited, otherwise excalidraw images would not display in the Kanban plugin
+  for (const maybeDrawing of embeddedItems) {
+    //check to see if the file in the src attribute exists
+    attr.fname = maybeDrawing.getAttribute("src");
+    file = metadataCache.getFirstLinkpathDest(
+      attr.fname?.split("#")[0],
+      ctx.sourcePath,
+    );
+
+    //if the embeddedFile exits and it is an Excalidraw file
+    //then lets replace the .internal-embed with the generated PNG or SVG image
+    if (file && file instanceof TFile && plugin.isExcalidrawFile(file)) {
+      attr.fwidth = maybeDrawing.getAttribute("width")
+        ? maybeDrawing.getAttribute("width")
+        : plugin.settings.width;
+      attr.fheight = maybeDrawing.getAttribute("height");
+      alt = maybeDrawing.getAttribute("alt");
+      if (alt == attr.fname) {
+        alt = "";
+      } //when the filename starts with numbers followed by a space Obsidian recognizes the filename as alt-text
+      attr.style = "excalidraw-svg";
+      if (alt) {
+        //for some reason Obsidian renders ![]() in a DIV and ![[]] in a SPAN
+        //also the alt-text of the DIV does not include the alt-text of the image
+        //thus need to add an additional "|" character when its a SPAN
+        if (maybeDrawing.tagName.toLowerCase() == "span") {
+          alt = `|${alt}`;
+        }
+        //1:width, 2:height, 3:style  1      2      3
+        parts = alt.match(/[^\|]*\|?(\d*%?)x?(\d*%?)\|?(.*)/);
+        attr.fwidth = parts[1] ? parts[1] : plugin.settings.width;
+        attr.fheight = parts[2];
+        if (parts[3] != attr.fname) {
+          attr.style = `excalidraw-svg${parts[3] ? `-${parts[3]}` : ""}`;
+        }
+      }
+
+      attr.fname = file?.path;
+      attr.file = file;
+      const div = await createImageDiv(attr);
+      maybeDrawing.parentElement.replaceChild(div, maybeDrawing);
+    }
+  }
+}    
+
+
+const tmpObsidianWYSIWYG = async (
+  el: HTMLElement,
+  ctx: MarkdownPostProcessorContext,
+) => {
+  if (!ctx.frontmatter) {
+    return;
+  }
+  if (!ctx.frontmatter.hasOwnProperty("excalidraw-plugin")) {
+    return;
+  }
+  //@ts-ignore
+  if (ctx.remainingNestLevel < 4) {
+    return;
+  }
+  if (!el.querySelector(".frontmatter")) {
+    el.style.display = "none";
+    return;
+  }
+  const attr: imgElementAttributes = {
+    fname: ctx.sourcePath,
+    fheight: "",
+    fwidth: plugin.settings.width,
+    style: "excalidraw-svg",
+  };
+
+  attr.file = metadataCache.getFirstLinkpathDest(
+    ctx.sourcePath,
+    "",
+  );
+
+  el.empty();
+
+  if(!plugin.settings.experimentalLivePreview) {
+    el.appendChild(await createImageDiv(attr));
+    return;
+  }
+
+  const div = createDiv();
+  el.appendChild(div);
+
+  //The timeout gives time for obsidian to attach el to the displayed document
+  //Once the element is attached, I can traverse up the dom tree to find .internal-embed 
+  //If internal embed is not found, it means the that the excalidraw.md file
+  //is being rendered in "reading" mode. In that case, the image with the default width
+  //specified in setting should be displayed
+  //if .internal-embed is found, then contents is replaced with the image using the
+  //alt, width, and height attributes of .internal-embed to size and style the image
+  setTimeout(async ()=>{
+    let internalEmbedDiv:HTMLElement = div;
+    while(!internalEmbedDiv.hasClass("internal-embed") && internalEmbedDiv.parentElement) {
+      internalEmbedDiv = internalEmbedDiv.parentElement;
+    }
+
+    if(!internalEmbedDiv.hasClass("internal-embed")) {
+      el.empty();
+      el.appendChild(await createImageDiv(attr));
+      return;
+    }
+
+    internalEmbedDiv.empty();
+    
+    const basename = splitFolderAndFilename(attr.fname).basename;
+    const setAttr = () => {
+      const hasWidth = internalEmbedDiv.getAttribute("width")!=="";
+      const hasHeight = internalEmbedDiv.getAttribute("height")!=="";          
+      if(hasWidth) 
+        attr.fwidth = internalEmbedDiv.getAttribute("width");
+      if(hasHeight) 
+        attr.fheight = internalEmbedDiv.getAttribute("height");
+      const alt = internalEmbedDiv.getAttribute("alt");
+      const hasAttr = alt && alt!=="" && alt!==basename;
+      if(hasAttr) {
+        //1:width, 2:height, 3:style  1      2      3
+        const parts = alt.match(/(\d*%?)x?(\d*%?)\|?(.*)/);
+        attr.fwidth = parts[1] ? parts[1] : plugin.settings.width;
+        attr.fheight = parts[2];
+        if (parts[3] != attr.fname) {
+          attr.style = `excalidraw-svg${parts[3] ? `-${parts[3]}` : ""}`;
+        }
+      }
+      if(!hasWidth && !hasHeight && !hasAttr) {
+        attr.fheight = "";
+        attr.fwidth = plugin.settings.width;
+        attr.style = "excalidraw-svg";
+      }
+    }
+
+    const createImgElement = async () => {
+      setAttr();
+      const imgDiv = await createImageDiv(attr);
+      internalEmbedDiv.appendChild(imgDiv);
+    }
+    await createImgElement();
+
+    //timer to avoid the image flickering when the user is typing
+    let timer:NodeJS.Timeout = null;
+    const observer = new MutationObserver((m) => {
+      if(!["alt","width","height"].contains(m[0]?.attributeName)) {
+        return;
+      }
+      if(timer) clearTimeout(timer);
+      timer = setTimeout(() => {
+        timer = null;
+        setAttr();
+        internalEmbedDiv.empty();
+        createImgElement();
+      },500);
+    });
+    observer.observe(internalEmbedDiv, {
+      attributes: true, //configure it to listen to attribute changes
+    });
+  },300);
+};
+
+
+/**
+ *
+ * @param el
+ * @param ctx
+ */
+export const markdownPostProcessor = async (
+  el: HTMLElement,
+  ctx: MarkdownPostProcessorContext,
+) => {
+  //check to see if we are rendering in editing mode of live preview
+  //if yes, then there should be no .internal-embed containers
+  const embeddedItems = el.querySelectorAll(".internal-embed");
+  if (embeddedItems.length === 0) {
+    tmpObsidianWYSIWYG(el, ctx);
+    return;
+  }
+
+  //If the file being processed is an excalidraw file,
+  //then I want to hide all embedded items as these will be
+  //transcluded text element or some other transcluded content inside the Excalidraw file
+  //in reading mode these elements should be hidden
+  if (ctx.frontmatter?.hasOwnProperty("excalidraw-plugin")) {
+    el.style.display = "none";
+    return;
+  }
+
+  await processInternalEmbeds( embeddedItems,ctx);
+
+};
+
+/**
+ * internal-link quick preview
+ * @param e
+ * @returns
+ */
+export const hoverEvent = (e: any) => {
+  if (!e.linktext) {
+    plugin.hover.linkText = null;
+    return;
+  }
+  plugin.hover.linkText = e.linktext;
+  plugin.hover.sourcePath = e.sourcePath;
+};
+
+//monitoring for div.popover.hover-popover.file-embed.is-loaded to be added to the DOM tree
+export const observer = new MutationObserver(async (m) => {
+  if (m.length == 0) {
+    return;
+  }
+  if (!plugin.hover.linkText) {
+    return;
+  }
+  const file = metadataCache.getFirstLinkpathDest(
+    plugin.hover.linkText,
+    plugin.hover.sourcePath ? plugin.hover.sourcePath : "",
+  );
+  if (!file) {
+    return;
+  }
+  if (!(file instanceof TFile)) {
+    return;
+  }
+  if (file.extension !== "excalidraw") {
+    return;
+  }
+
+  const svgFileName = getIMGFilename(file.path, "svg");
+  const svgFile = vault.getAbstractFileByPath(svgFileName);
+  if (svgFile && svgFile instanceof TFile) {
+    return;
+  } //If auto export SVG or PNG is enabled it will be inserted at the top of the excalidraw file. No need to manually insert hover preview
+
+  const pngFileName = getIMGFilename(file.path, "png");
+  const pngFile = vault.getAbstractFileByPath(pngFileName);
+  if (pngFile && pngFile instanceof TFile) {
+    return;
+  } //If auto export SVG or PNG is enabled it will be inserted at the top of the excalidraw file. No need to manually insert hover preview
+
+  if (!plugin.hover.linkText) {
+    return;
+  }
+  if (m.length != 1) {
+    return;
+  }
+  if (m[0].addedNodes.length != 1) {
+    return;
+  }
+  if (
+    //@ts-ignore
+    m[0].addedNodes[0].className !=
+    "popover hover-popover file-embed is-loaded"
+  ) {
+    return;
+  }
+  const node = m[0].addedNodes[0];
+  node.empty();
+
+  //this div will be on top of original DIV. By stopping the propagation of the click
+  //I prevent the default Obsidian feature of openning the link in the native app
+  const img = await getIMG({
+    file,
+    fname: file.path,
+    fwidth: "300",
+    fheight: null,
+    style: "excalidraw-svg",
+  });
+  const div = createDiv("", async (el) => {
+    el.appendChild(img);
+    el.setAttribute("src", file.path);
+    el.onClickEvent((ev) => {
+      ev.stopImmediatePropagation();
+      const src = el.getAttribute("src");
+      if (src) {
+        plugin.openDrawing(
+          vault.getAbstractFileByPath(src) as TFile,
+          ev[CTRL_OR_CMD],
+        );
+      } //.ctrlKey||ev.metaKey);
+    });
+  });
+  node.appendChild(div);
+});

src/ScriptInstallPrompt.ts

@@ -0,0 +1,43 @@
+import { App, MarkdownRenderer, Modal, Notice, request } from "obsidian";
+import { Url } from "url";
+import { t } from "./lang/helpers";
+import ExcalidrawPlugin from "./main";
+import { errorlog } from "./Utils";
+
+const URL =
+  "https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/index.md";
+
+export class ScriptInstallPrompt extends Modal {
+  constructor(private plugin: ExcalidrawPlugin) {
+    super(plugin.app);
+    //    this.titleEl.setText(t("INSTAL_MODAL_TITLE"));
+  }
+
+  async onOpen(): Promise<void> {
+    this.contentEl.classList.add("excalidraw-scriptengine-install");
+    this.containerEl.classList.add("excalidraw-scriptengine-install");
+    try {
+      const source = await request({ url: URL });
+      await MarkdownRenderer.renderMarkdown(
+        source,
+        this.contentEl,
+        "",
+        this.plugin,
+      );
+      this.contentEl.querySelectorAll("h1[data-heading],h2[data-heading],h3[data-heading]").forEach((el) => {
+        el.setAttribute("id", el.getAttribute("data-heading"));
+      });
+      this.contentEl.querySelectorAll("a.internal-link").forEach((el) => {
+        el.removeAttribute("target");
+      });
+    } catch (e) {
+      errorlog({ where: "ScriptInstallPrompt.onOpen", error: e });
+      new Notice("Could not open ScriptEngine repository");
+      this.close();
+    }
+  }
+
+  onClose(): void {
+    this.contentEl.empty();
+  }
+}

src/Scripts.ts

@@ -1,3 +1,4 @@
+import { sub } from "@zsviczian/excalidraw/types/ga";
 import { App, TAbstractFile, TFile } from "obsidian";
 import { VIEW_TYPE_EXCALIDRAW } from "./constants";
 import ExcalidrawView from "./ExcalidrawView";
@@ -23,7 +24,7 @@ export class ScriptEngine {
       if (!file.path.startsWith(this.scriptPath)) {
         return;
       }
-      this.unloadScript(file.basename);
+      this.unloadScript(this.getScriptName(file));
     };
     this.plugin.registerEvent(
       this.plugin.app.vault.on("delete", deleteEventHandler),
@@ -49,7 +50,7 @@ export class ScriptEngine {
       const oldFileIsScript = oldPath.startsWith(this.scriptPath);
       const newFileIsScript = file.path.startsWith(this.scriptPath);
       if (oldFileIsScript) {
-        this.unloadScript(splitFolderAndFilename(oldPath).basename);
+        this.unloadScript(this.getScriptName(oldPath));
       }
       if (newFileIsScript) {
         this.loadScript(file);
@@ -77,10 +78,32 @@ export class ScriptEngine {
     scripts.forEach((f) => this.loadScript(f));
   }
 
+  getScriptName(f:TFile|string):string {
+    let basename = "";
+    let path = "";
+    if(f instanceof TFile) {
+      basename = f.basename;
+      path = f.path;
+    } else {
+      basename = splitFolderAndFilename(f).basename;
+      path = f;
+    }
+
+    const subpath = path.split(
+      `${this.plugin.settings.scriptFolderPath}/`,
+    )[1];
+    const lastSlash = subpath.lastIndexOf("/");
+    if (lastSlash > -1) {
+      return subpath.substring(0, lastSlash + 1) + basename;
+    }
+    return basename;
+  }
+
   loadScript(f: TFile) {
+    const scriptName = this.getScriptName(f);
     this.plugin.addCommand({
-      id: f.basename,
-      name: `(Script) ${f.basename}`,
+      id: scriptName,
+      name: `(Script) ${scriptName}`,
       checkCallback: (checking: boolean) => {
         if (checking) {
           return (
@@ -103,7 +126,9 @@ export class ScriptEngine {
     const scripts = app.vault
       .getFiles()
       .filter((f: TFile) => f.path.startsWith(this.scriptPath));
-    scripts.forEach((f) => this.unloadScript(f.basename));
+    scripts.forEach((f) => {
+      this.unloadScript(this.getScriptName(f));
+    });
   }
 
   unloadScript(basename: string) {
@@ -128,16 +153,19 @@ export class ScriptEngine {
       return;
     }
 
+    this.plugin.ea.activeScript = this.getScriptName(f);
+
     //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;
-
-    return await new AsyncFunction("ea", "utils", script)(this.plugin.ea, {
+    const result = await new AsyncFunction("ea", "utils", script)(this.plugin.ea, {
       inputPrompt: (header: string, placeholder?: string, value?: string) =>
         ScriptEngine.inputPrompt(this.plugin.app, header, placeholder, value),
       suggester: (displayItems: string[], items: string[]) =>
         ScriptEngine.suggester(this.plugin.app, displayItems, items),
     });
+    this.plugin.ea.activeScript = null;
+    return result;
   }
 
   public static async inputPrompt(

src/Utils.ts

@@ -2,6 +2,7 @@ import { exportToSvg, exportToBlob } from "@zsviczian/excalidraw";
 import {
   App,
   normalizePath,
+  Notice,
   TAbstractFile,
   TFolder,
   Vault,
@@ -26,6 +27,21 @@ declare module "obsidian" {
   }
 }
 
+
+let versionUpdateChecked = false;
+export const checkExcalidrawVersion = async (app:App) => {
+  if(versionUpdateChecked) return;
+  versionUpdateChecked = true;
+  //@ts-ignore
+  const manifest = app.plugins.manifests["obsidian-excalidraw-plugin"];
+  //@ts-ignore
+  const latestVersion = await app.plugins.getLatestVersion("obsidian-excalidraw-plugin",manifest)
+  if(latestVersion>manifest.version) {
+    new Notice(`A newer version of Excalidraw is available in Community Plugins. You are using ${manifest.version}. The latest version is ${latestVersion}`);
+  }
+  setTimeout(()=>versionUpdateChecked=false,28800000);//reset after 8 hours
+}
+
 /**
  * Splits a full path including a folderpath and a filename into separate folderpath and filename components
  * @param filepath

src/constants.ts

@@ -13,6 +13,8 @@ export const nanoid = customAlphabet(
 export const KEYCODE = {
   ESC: 27,
 };
+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;
 export const REG_BLOCK_REF_CLEAN =
@@ -51,6 +53,8 @@ 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 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 = "disk";
 export const DISK_ICON = `<path fill="none" stroke="currentColor" fill="#fff" d="M0 0h100v100H0z"/><path fill="none" stroke="currentColor" d="M20.832 4.168c21.824.145 43.645.289 74.68.5m-74.68-.5c17.09.113 34.176.227 74.68.5m0 0c.094 27.3.191 54.602.32 91.164m-.32-91.164c.113 32.633.23 65.27.32 91.164m0 0H4.168m91.664 0H4.168m0 0v-75m0 75v-75m0 0L20.832 4.168M4.168 20.832L20.832 4.168M20.832 4.168h58.336m-58.336 0h58.336m0 0v25m0-25v25m0 0H20.832m58.336 0H20.832m0 0v-25m0 25v-25" stroke-width="1.66668" /><path fill="none" stroke="currentColor" d="M29.168 4.168h16.664v16.664H29.168"/><path fill="none" stroke="currentColor" d="M29.168 4.168h16.664m-16.664 0h16.664m0 0v16.664m0-16.664v16.664m0 0H29.168m16.664 0H29.168m0 0V4.168m0 16.664V4.168M12.5 54.168h75m-75 0h75m0 0v41.664m0-41.664v41.664m0 0h-75m75 0h-75m0 0V54.168m0 41.664V54.168M20.832 62.5c20.11-.18 40.219-.36 55.68-.5m-55.68.5c14.656-.133 29.313-.262 55.68-.5M20.832 71.332c13.098-.117 26.2-.234 55.68-.5m-55.68.5l55.68-.5M21.117 79.582c20.645-.184 41.285-.371 55.68-.5m-55.68.5c18.153-.16 36.301-.324 55.68-.5" stroke-width="1.66668"/>`;
 export const PNG_ICON_NAME = "save-png";

src/lang/locale/en.ts

@@ -7,6 +7,11 @@ import {
 // English
 export default {
   // main.ts
+  INSTALL_SCRIPT: "Install this script",
+  UPDATE_SCRIPT: "An update is available - Click to install",
+  CHECKING_SCRIPT: "Checking if a newer version is available - Click to reinstall now",
+  UNABLETOCHECK_SCRIPT: "Update check was unsuccessful - Click to reinstall now",
+  UPTODATE_SCRIPT: "Script is installed and up to date - Click to reinstall now",
   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",
@@ -38,6 +43,7 @@ export default {
   ENTER_LATEX: "Enter a valid LaTeX expression",
 
   //ExcalidrawView.ts
+  INSTALL_SCRIPT_BUTTON: "Install or update Excalidraw Scripts",
   OPEN_AS_MD: "Open as Markdown",
   SAVE_AS_PNG: "Save as PNG into Vault (CTRL/CMD+CLICK to export)",
   SAVE_AS_SVG: "Save as SVG into Vault (CTRL/CMD+CLICK to export)",
@@ -265,6 +271,10 @@ export default {
   FILETAG_NAME: "Set the type indicator for excalidraw.md files",
   FILETAG_DESC: "The text or emojii to display as type indicator.",
   INSERT_EMOJI: "Insert an emoji",
+  LIVEPREVIEW_NAME: "Immersive image embedding in live preview editing mode",
+  LIVEPREVIEW_DESC: "Turn this on to support image embedding styles such as ![[drawing|width|style]] in live preview editing mode. " +
+                    "The setting will not effect the currently open documents. You need close the open documents and re-open them for the change " +
+                    "to take effect.",
 
   //openDrawings.ts
   SELECT_FILE: "Select a file then press enter.",

src/main.ts

@@ -15,12 +15,15 @@ import {
   Notice,
   loadMathJax,
   Scope,
+  request,
 } from "obsidian";
 import {
   BLANK_DRAWING,
   VIEW_TYPE_EXCALIDRAW,
   EXCALIDRAW_ICON,
   ICON_NAME,
+  SCRIPTENGINE_ICON,
+  SCRIPTENGINE_ICON_NAME,
   DISK_ICON,
   DISK_ICON_NAME,
   PNG_ICON,
@@ -34,6 +37,8 @@ import {
   nanoid,
   DARK_BLANK_DRAWING,
   CTRL_OR_CMD,
+  SCRIPT_INSTALL_CODEBLOCK,
+  SCRIPT_INSTALL_FOLDER,
 } from "./constants";
 import ExcalidrawView, { ExportSettings, TextMode } from "./ExcalidrawView";
 import { getMarkdownDrawingSection } from "./ExcalidrawData";
@@ -60,18 +65,21 @@ import {
   checkAndCreateFolder,
   download,
   embedFontsInSVG,
+  errorlog,
   getAttachmentsFolderAndFilePath,
   getIMGFilename,
   getIMGPathFromExcalidrawFile,
   getNewUniqueFilepath,
   isObsidianThemeDark,
   log,
+  splitFolderAndFilename,
   svgToBase64,
 } from "./Utils";
 import { OneOffs } from "./OneOffs";
 import { FileId } from "@zsviczian/excalidraw/types/element/types";
 import { EmbeddedFilesLoader } from "./EmbeddedFileLoader";
 import { ScriptEngine } from "./Scripts";
+import { hoverEvent, initializeMarkdownPostProcessor, markdownPostProcessor, observer } from "./MarkdownPostProcessor";
 
 declare module "obsidian" {
   interface App {
@@ -124,6 +132,7 @@ export default class ExcalidrawPlugin extends Plugin {
 
   async onload() {
     addIcon(ICON_NAME, EXCALIDRAW_ICON);
+    addIcon(SCRIPTENGINE_ICON_NAME, SCRIPTENGINE_ICON);
     addIcon(DISK_ICON_NAME, DISK_ICON);
     addIcon(PNG_ICON_NAME, PNG_ICON);
     addIcon(SVG_ICON_NAME, SVG_ICON);
@@ -141,6 +150,7 @@ export default class ExcalidrawPlugin extends Plugin {
     this.registerExtensions(["excalidraw"], VIEW_TYPE_EXCALIDRAW);
 
     this.addMarkdownPostProcessor();
+    this.registerInstallCodeblockProcessor();
     this.addThemeObserver();
     this.experimentalFileTypeDisplayToggle(this.settings.experimentalFileType);
     this.registerCommands();
@@ -219,386 +229,155 @@ export default class ExcalidrawPlugin extends Plugin {
       }
     });
   }
+ 
+  private registerInstallCodeblockProcessor() {
+    const codeblockProcessor = async (
+      source: string,
+      el: HTMLElement,
+      ctx: MarkdownPostProcessorContext,
+      plugin: ExcalidrawPlugin,
+    ) => {
+
+      //Button next to the "List of available scripts" at the top
+      //In try/catch block because this approach is very error prone, depends on 
+      //MarkdownRenderer() and index.md structure, in case these are not as
+      //expected this code will break
+      let button2: HTMLButtonElement = null;
+      try {
+        const link:HTMLElement = el.parentElement.querySelector(`a[href="#${
+          el.previousElementSibling.getAttribute("data-heading")}"]`);
+        link.style.paddingRight = "10px";
+        button2 = link.parentElement.createEl("button",null,(b) => {
+          b.setText(t("UPDATE_SCRIPT"));
+          b.addClass("mod-cta");
+          b.style.backgroundColor = "var(--interactive-success)";
+          b.style.display = "none";
+        });
+      } catch(e) {
+        errorlog({where:"this.registerInstallCodeblockProcessor", source, error:e});
+      }
+
+      source = source.trim();
+      el.createEl("button", null, async (button) => {
+        const setButtonText = (text:"CHECKING" | "INSTALL" | "UPTODATE" | "UPDATE" | "ERROR") => {
+          if(button2) button2.style.display = "none";
+          switch(text) {
+            case "CHECKING": 
+              button.setText(t("CHECKING_SCRIPT"));
+              button.style.backgroundColor = "var(--interactive-normal)";
+              break;
+            case "INSTALL":
+              button.setText(t("INSTALL_SCRIPT"));
+              button.style.backgroundColor = "var(--interactive-accent)";
+              break;
+            case "UPTODATE":
+              button.setText(t("UPTODATE_SCRIPT"));
+              button.style.backgroundColor = "var(--interactive-normal)";
+              break;
+            case "UPDATE":
+              button.setText(t("UPDATE_SCRIPT"));
+              button.style.backgroundColor = "var(--interactive-success)";
+              if(button2) button2.style.display = null;
+              break;
+            case "ERROR":
+              button.setText(t("UNABLETOCHECK_SCRIPT"));
+              button.style.backgroundColor = "var(--interactive-normal)";
+              break;
+          }
+        }
+        button.addClass("mod-cta");
+        let decodedURI = source;
+        try{
+          decodedURI = decodeURI(source);
+        } catch(e) {
+          errorlog({
+            where:"ExcalidrawPlugin.registerInstallCodeblockProcessor.codeblockProcessor.onClick", 
+            source,
+            error:e,
+          });
+        }
+        const fname = decodedURI.substring(
+          decodedURI.lastIndexOf("/") + 1,
+        );
+        const folder = `${
+          this.settings.scriptFolderPath
+        }/${SCRIPT_INSTALL_FOLDER}`;
+        const path = `${folder}/${fname}`;
+        let f = this.app.vault.getAbstractFileByPath(path);
+        setButtonText(f?"CHECKING":"INSTALL");
+        button.onclick = async () => {
+          try {
+            const data = await request({url:source});
+            if(f) {
+              await this.app.vault.modify(f as TFile,data);
+            } else {
+              await checkAndCreateFolder(this.app.vault,folder);
+              f = await this.app.vault.create(path,data);
+            }       
+            setButtonText("UPTODATE");
+            new Notice(`Installed: ${(f as TFile).basename}`)
+          } catch (e) {
+            new Notice(`Error installing script: ${fname}`);
+            errorlog({
+              where:"ExcalidrawPlugin.registerInstallCodeblockProcessor.codeblockProcessor.onClick", 
+              error:e,
+            });
+          }
+        };
+        if(button2) button2.onclick = button.onclick;
+        
+        //check modified date on github
+        //https://superuser.com/questions/1406875/how-to-get-the-latest-commit-date-of-a-file-from-a-given-github-reposotiry
+        if(!f || !(f instanceof TFile)) return;
+        const msgHead = "https://api.github.com/repos/zsviczian/obsidian-excalidraw-plugin/commits?path=ea-scripts%2F";
+        const msgTail = "&page=1&per_page=1";
+        const data = await request({
+          url: msgHead+encodeURI(fname)+msgTail,
+        });
+        if(!data) {
+          setButtonText("ERROR");
+          return;
+        }
+        const result = JSON.parse(data);
+        if(result.length===0 || !result[0]?.commit?.committer?.date) {
+          setButtonText("ERROR");
+          return;
+        }
+        //@ts-ignore
+        const mtime = (new Date(result[0].commit.committer.date))/1;
+        if(mtime > f.stat.mtime) {
+          setButtonText("UPDATE");
+          return;
+        }
+        setButtonText("UPTODATE");
+      });
+    };
+
+    this.registerMarkdownCodeBlockProcessor(
+      SCRIPT_INSTALL_CODEBLOCK,
+      async (source, el, ctx) => {
+        el.addEventListener(RERENDER_EVENT, async (e) => {
+          e.stopPropagation();
+          el.empty();
+          codeblockProcessor(source, el, ctx, this);
+        });
+        codeblockProcessor(source, el, ctx, this);
+      },
+    );
+  }
 
   /**
    * Displays a transcluded .excalidraw image in markdown preview mode
    */
   private addMarkdownPostProcessor() {
-    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
-    }
-
-    /**
-     * Generates an img element with the drawing encoded as a base64 SVG or a PNG (depending on settings)
-     * @param parts {imgElementAttributes} - display properties of the image
-     * @returns {Promise<HTMLElement>} - the IMG HTML element containing the image
-     */
-    const getIMG = async (
-      imgAttributes: imgElementAttributes,
-    ): Promise<HTMLElement> => {
-      let file = imgAttributes.file;
-      if (!imgAttributes.file) {
-        const f = this.app.vault.getAbstractFileByPath(imgAttributes.fname);
-        if (!(f && f instanceof TFile)) {
-          return null;
-        }
-        file = f;
-      }
-
-      const exportSettings: ExportSettings = {
-        withBackground: this.settings.exportWithBackground,
-        withTheme: this.settings.exportWithTheme,
-      };
-      const img = createEl("img");
-      let style = `max-width:${imgAttributes.fwidth}px !important; width:100%;`;
-      if (imgAttributes.fheight) {
-        style += `height:${imgAttributes.fheight}px;`;
-      }
-      img.setAttribute("style", style);
-      img.addClass(imgAttributes.style);
-
-      const theme = this.settings.previewMatchObsidianTheme
-        ? isObsidianThemeDark()
-          ? "dark"
-          : "light"
-        : !this.settings.exportWithTheme
-        ? "light"
-        : undefined;
-      if (theme) {
-        exportSettings.withTheme = true;
-      }
-      const loader = new EmbeddedFilesLoader(
-        this,
-        theme ? theme === "dark" : undefined,
-      );
-
-      if (!this.settings.displaySVGInPreview) {
-        const width = parseInt(imgAttributes.fwidth);
-        let scale = 1;
-        if (width >= 600) {
-          scale = 2;
-        }
-        if (width >= 1200) {
-          scale = 3;
-        }
-        if (width >= 1800) {
-          scale = 4;
-        }
-        if (width >= 2400) {
-          scale = 5;
-        }
-        const png = await createPNG(
-          file.path,
-          scale,
-          exportSettings,
-          loader,
-          theme,
-          null,
-          null,
-          [],
-          this,
-        );
-        //const png = await getPNG(JSON_parse(scene),exportSettings, scale);
-        if (!png) {
-          return null;
-        }
-        img.src = URL.createObjectURL(png);
-        return img;
-      }
-      const svgSnapshot = (
-        await createSVG(
-          file.path,
-          true,
-          exportSettings,
-          loader,
-          theme,
-          null,
-          null,
-          [],
-          this,
-        )
-      ).outerHTML;
-      let svg: SVGSVGElement = null;
-      const el = document.createElement("div");
-      el.innerHTML = svgSnapshot;
-      const firstChild = el.firstChild;
-      if (firstChild instanceof SVGSVGElement) {
-        svg = firstChild;
-      }
-      if (!svg) {
-        return null;
-      }
-      svg = embedFontsInSVG(svg);
-      svg.removeAttribute("width");
-      svg.removeAttribute("height");
-      img.setAttribute("src", svgToBase64(svg.outerHTML));
-      return img;
-    };
-
-    const createImageDiv = async (
-      attr: imgElementAttributes,
-    ): Promise<HTMLDivElement> => {
-      const img = await getIMG(attr);
-      return createDiv(attr.style, (el) => {
-        el.append(img);
-        el.setAttribute("src", attr.file.path);
-        if (attr.fwidth) {
-          el.setAttribute("w", attr.fwidth);
-        }
-        if (attr.fheight) {
-          el.setAttribute("h", attr.fheight);
-        }
-        el.onClickEvent((ev) => {
-          if (
-            ev.target instanceof Element &&
-            ev.target.tagName.toLowerCase() != "img"
-          ) {
-            return;
-          }
-          const src = el.getAttribute("src");
-          if (src) {
-            this.openDrawing(
-              this.app.vault.getAbstractFileByPath(src) as TFile,
-              ev[CTRL_OR_CMD],
-            );
-          } //.ctrlKey||ev.metaKey);
-        });
-        el.addEventListener(RERENDER_EVENT, async (e) => {
-          e.stopPropagation();
-          el.empty();
-          const img = await getIMG({
-            fname: el.getAttribute("src"),
-            fwidth: el.getAttribute("w"),
-            fheight: el.getAttribute("h"),
-            style: el.getAttribute("class"),
-          });
-          el.append(img);
-        });
-      });
-    };
-
-    const tmpObsidianWYSIWYG = async (
-      el: HTMLElement,
-      ctx: MarkdownPostProcessorContext,
-    ) => {
-      if (!ctx.frontmatter) {
-        return;
-      }
-      if (!ctx.frontmatter.hasOwnProperty("excalidraw-plugin")) {
-        return;
-      }
-      //@ts-ignore
-      if (ctx.remainingNestLevel < 4) {
-        return;
-      }
-      if (!el.querySelector(".frontmatter")) {
-        el.style.display = "none";
-        return;
-      }
-      const attr: imgElementAttributes = {
-        fname: ctx.sourcePath,
-        fheight: "",
-        fwidth: this.settings.width,
-        style: "excalidraw-svg",
-      };
-
-      attr.file = this.app.metadataCache.getFirstLinkpathDest(
-        ctx.sourcePath,
-        "",
-      );
-      const div = await createImageDiv(attr);
-      el.childNodes.forEach(
-        (child: HTMLElement) => (child.style.display = "none"),
-      );
-      el.appendChild(div);
-    };
-
-    /**
-     *
-     * @param el
-     * @param ctx
-     */
-    const markdownPostProcessor = async (
-      el: HTMLElement,
-      ctx: MarkdownPostProcessorContext,
-    ) => {
-
-      //check to see if we are rendering in editing mode of live preview
-      //if yes, then there should be no .internal-embed containers
-      const embeddedItems = el.querySelectorAll(".internal-embed");
-      if (embeddedItems.length === 0) {
-        tmpObsidianWYSIWYG(el, ctx);
-        return;
-      }
-
-      //If the file being processed is an excalidraw file,
-      //then I want to hide all embedded items as these will be 
-      //transcluded text element or some other transcluded content inside the Excalidraw file
-      //in reading mode these elements should be hidden
-      if (ctx.frontmatter?.hasOwnProperty("excalidraw-plugin")) {
-        el.style.display = "none";
-        return;
-      }
-
-      //if not, then we are processing a non-excalidraw file in reading mode
-      //in that cases embedded files will be displayed in an .internal-embed container
-      const attr: imgElementAttributes = {
-        fname: "",
-        fheight: "",
-        fwidth: "",
-        style: "",
-      };
-      let alt: string;
-      let parts;
-      let file: TFile;
-
-      //Iterating through all the containers to check which one is an excalidraw drawing
-      //This is a for loop instead of embeddedItems.forEach() because createImageDiv at the end
-      //is awaited, otherwise excalidraw images would not display in the Kanban plugin
-      for (const maybeDrawing of embeddedItems) {
-        //check to see if the file in the src attribute exists
-        attr.fname = maybeDrawing.getAttribute("src");
-        file = this.app.metadataCache.getFirstLinkpathDest(
-          attr.fname?.split("#")[0],
-          ctx.sourcePath,
-        );
-
-        //if the embeddedFile exits and it is an Excalidraw file
-        //then lets replace the .internal-embed with the generated PNG or SVG image
-        if (file && file instanceof TFile && this.isExcalidrawFile(file)) {
-          attr.fwidth = maybeDrawing.getAttribute("width")
-            ? maybeDrawing.getAttribute("width")
-            : this.settings.width;
-          attr.fheight = maybeDrawing.getAttribute("height");
-          alt = maybeDrawing.getAttribute("alt");
-          if (alt == attr.fname) {
-            alt = "";
-          } //when the filename starts with numbers followed by a space Obsidian recognizes the filename as alt-text
-          attr.style = "excalidraw-svg";
-          if (alt) {
-            //for some reason Obsidian renders ![]() in a DIV and ![[]] in a SPAN
-            //also the alt-text of the DIV does not include the alt-text of the image
-            //thus need to add an additional "|" character when its a SPAN
-            if (maybeDrawing.tagName.toLowerCase() == "span") {
-              alt = `|${alt}`;
-            }
-            //1:width, 2:height, 3:style  1      2      3
-            parts = alt.match(/[^\|]*\|?(\d*%?)x?(\d*%?)\|?(.*)/);
-            attr.fwidth = parts[1] ? parts[1] : this.settings.width;
-            attr.fheight = parts[2];
-            if (parts[3] != attr.fname) {
-              attr.style = `excalidraw-svg${parts[3] ? `-${parts[3]}` : ""}`;
-            }
-          }
-
-          attr.fname = file?.path;
-          attr.file = file;
-          const div = await createImageDiv(attr);
-          maybeDrawing.parentElement.replaceChild(div, maybeDrawing);
-        }
-      }
-    };
-
+    initializeMarkdownPostProcessor(this);
     this.registerMarkdownPostProcessor(markdownPostProcessor);
 
-    /**
-     * internal-link quick preview
-     * @param e
-     * @returns
-     */
-    const hoverEvent = (e: any) => {
-      if (!e.linktext) {
-        this.hover.linkText = null;
-        return;
-      }
-      this.hover.linkText = e.linktext;
-      this.hover.sourcePath = e.sourcePath;
-    };
+    // internal-link quick preview
     this.registerEvent(this.app.workspace.on("hover-link", hoverEvent));
 
     //monitoring for div.popover.hover-popover.file-embed.is-loaded to be added to the DOM tree
-    this.observer = new MutationObserver(async (m) => {
-      if (m.length == 0) {
-        return;
-      }
-      if (!this.hover.linkText) {
-        return;
-      }
-      const file = this.app.metadataCache.getFirstLinkpathDest(
-        this.hover.linkText,
-        this.hover.sourcePath ? this.hover.sourcePath : "",
-      );
-      if (!file) {
-        return;
-      }
-      if (!(file instanceof TFile)) {
-        return;
-      }
-      if (file.extension !== "excalidraw") {
-        return;
-      }
-
-      const svgFileName = getIMGFilename(file.path, "svg");
-      const svgFile = this.app.vault.getAbstractFileByPath(svgFileName);
-      if (svgFile && svgFile instanceof TFile) {
-        return;
-      } //If auto export SVG or PNG is enabled it will be inserted at the top of the excalidraw file. No need to manually insert hover preview
-
-      const pngFileName = getIMGFilename(file.path, "png");
-      const pngFile = this.app.vault.getAbstractFileByPath(pngFileName);
-      if (pngFile && pngFile instanceof TFile) {
-        return;
-      } //If auto export SVG or PNG is enabled it will be inserted at the top of the excalidraw file. No need to manually insert hover preview
-
-      if (!this.hover.linkText) {
-        return;
-      }
-      if (m.length != 1) {
-        return;
-      }
-      if (m[0].addedNodes.length != 1) {
-        return;
-      }
-      if (
-        //@ts-ignore
-        m[0].addedNodes[0].className !=
-        "popover hover-popover file-embed is-loaded"
-      ) {
-        return;
-      }
-      const node = m[0].addedNodes[0];
-      node.empty();
-
-      //this div will be on top of original DIV. By stopping the propagation of the click
-      //I prevent the default Obsidian feature of openning the link in the native app
-      const img = await getIMG({
-        file,
-        fname: file.path,
-        fwidth: "300",
-        fheight: null,
-        style: "excalidraw-svg",
-      });
-      const div = createDiv("", async (el) => {
-        el.appendChild(img);
-        el.setAttribute("src", file.path);
-        el.onClickEvent((ev) => {
-          ev.stopImmediatePropagation();
-          const src = el.getAttribute("src");
-          if (src) {
-            this.openDrawing(
-              this.app.vault.getAbstractFileByPath(src) as TFile,
-              ev[CTRL_OR_CMD],
-            );
-          } //.ctrlKey||ev.metaKey);
-        });
-      });
-      node.appendChild(div);
-    });
-
+    this.observer = observer;
     this.observer.observe(document, { childList: true, subtree: true });
   }
 
@@ -1723,7 +1502,7 @@ export default class ExcalidrawPlugin extends Plugin {
     if (f.extension == "excalidraw") {
       return true;
     }
-    const fileCache = this.app.metadataCache.getFileCache(f);
+    const fileCache = f ? this.app.metadataCache.getFileCache(f) : null;
     return !!fileCache?.frontmatter && !!fileCache.frontmatter[FRONTMATTER_KEY];
   }
 }

src/settings.ts

@@ -45,6 +45,7 @@ export interface ExcalidrawSettings {
   compatibilityMode: boolean;
   experimentalFileType: boolean;
   experimentalFileTag: string;
+  experimentalLivePreview: boolean;
   loadCount: number; //version 1.2 migration counter
   drawingOpenCount: number;
   library: string;
@@ -58,6 +59,7 @@ export interface ExcalidrawSettings {
   mdFont: string;
   mdFontColor: string;
   mdCSS: string;
+  scriptEngineSettings: {};
 }
 
 export const DEFAULT_SETTINGS: ExcalidrawSettings = {
@@ -94,6 +96,7 @@ export const DEFAULT_SETTINGS: ExcalidrawSettings = {
   syncExcalidraw: false,
   experimentalFileType: false,
   experimentalFileTag: "✏️",
+  experimentalLivePreview: true,
   compatibilityMode: false,
   loadCount: 0,
   drawingOpenCount: 0,
@@ -113,6 +116,7 @@ export const DEFAULT_SETTINGS: ExcalidrawSettings = {
   mdFont: "Virgil",
   mdFontColor: "Black",
   mdCSS: "",
+  scriptEngineSettings: {},
 };
 
 export class ExcalidrawSettingTab extends PluginSettingTab {
@@ -153,6 +157,13 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
     if (this.requestEmbedUpdate) {
       this.plugin.triggerEmbedUpdates();
     }
+    if (
+      this.plugin.settings.scriptFolderPath === "/" ||
+      this.plugin.settings.scriptFolderPath === ""
+    ) {
+      this.plugin.settings.scriptFolderPath = "Excalidraw/Scripts";
+      this.plugin.saveSettings();
+    }
     this.plugin.scriptEngine.updateScriptPath();
   }
 
@@ -819,5 +830,18 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
             this.applySettingsUpdate();
           }),
       );
+
+    new Setting(containerEl)
+      .setName(t("LIVEPREVIEW_NAME"))
+      .setDesc(t("LIVEPREVIEW_DESC"))
+      .addToggle((toggle) =>
+        toggle
+          .setValue(this.plugin.settings.experimentalLivePreview)
+          .onChange(async (value) => {
+            this.plugin.settings.experimentalLivePreview = value;
+            this.applySettingsUpdate();
+          }),
+      );
+
   }
 }

styles.css

@@ -35,6 +35,10 @@ img.excalidraw-svg-right {
   float: right;
 }
 
+.excalidraw-svg-center {
+  text-align: center;
+}
+
 img.excalidraw-svg-left {
   float: left;
 }
@@ -95,3 +99,38 @@ li[data-testid] {
 	margin-bottom: 20px;
   
 }
+
+.excalidraw-scriptengine-install td>img {
+  width: 100%;
+  max-width:800px;
+}
+
+.excalidraw-scriptengine-install img.coffee {
+  width: 130px;
+}
+
+.excalidraw-scriptengine-install tr {
+  vertical-align: top;
+}
+
+.excalidraw-scriptengine-install table {
+  max-width: 130ch;
+}
+
+.excalidraw-scriptengine-install td.label {
+  width: 11ch;
+  font-weight: bold;
+  padding-right: 5px;
+}
+
+.excalidraw-scriptengine-install td.data {
+  width: 100%;
+}
+
+.modal-content.excalidraw-scriptengine-install {
+  max-width: 130ch;
+}
+
+.excalidraw-scriptengine-install .modal {
+  max-height:90%;
+}

versions.json

@@ -1,4 +1,4 @@
 {
-  "1.5.10": "0.12.16",
+  "1.5.15": "0.12.16",
   "1.4.2": "0.11.13"
 }