tooltip edit

AutomateHowTo.md

@@ -0,0 +1,429 @@
+# Excalidraw Automate How To
+
+Excalidraw Automate allows you to create Excalidraw drawings using the [Templater](https://github.com/SilentVoid13/Templater) plugin.
+
+With a little work, using Excalidraw Automate you can generate simple mindmaps, fill out SVG forms, create customized charts, etc. based on documents in your vault.
+
+You can access Excalidraw Automate via the ExcalidrawAutomate object. I recommend staring your Automate scripts with the following code.
+
+```javascript
+const ea = ExcalidrawAutomate;
+ea.reset();
+```
+
+The first line creates a practical constant so you can avoid writing ExcalidrawAutomate 100x times.
+
+The second line resets ExcalidrawAutomate to defaults. This is important as you will not know which template you executed before, thus you won't know what state you left Excalidraw in.
+
+## Basic logic of using Excalidraw Automate
+1. Set the styling of the elements you want to draw
+2. Add elements. As you add elements, each new element is added one layer above the previous, thus in case of overlapping objects the later one will be on the top of the prior one.
+3. Call `await ea.create();` to instantiate the drawing
+
+You can change styling between adding different elements. My logic for separating element styling and creation is based on the assumption that you will probably set a stroke color, stroke style, stroke roughness, etc. and draw most of your elements using this. There would be no point in setting all these parameters each time you add an element.
+
+### Before we dive deeper, here's a simple example script
+```javascript
+<%*
+  const ea = ExcalidrawAutomate;
+  ea.reset();
+  ea.addRect(-150,-50,450,300);
+  ea.addText(-100,70,"Left to right");
+  ea.addArrow([[-100,100],[100,100]]);
+
+  ea.style.strokeColor = "red";
+  ea.addText(100,-30,"top to bottom",{width:200,textAligh:"center"});
+  ea.addArrow([[200,0],[200,200]]);
+  await ea.create();
+%>
+```
+The script will generate the following drawing:
+
+![FristDemo](https://user-images.githubusercontent.com/14358394/116825643-6e5a8b00-ab90-11eb-9e3a-37c524620d0d.png)
+
+## Attributes and functions at a glance
+Here's the interface implemented by ExcalidrawAutomate:
+
+```javascript
+ExcalidrawAutomate: {
+  style: {
+    strokeColor: string;
+    backgroundColor: string;
+    angle: number;
+    fillStyle: FillStyle;
+    strokeWidth: number;
+    storkeStyle: StrokeStyle;
+    roughness: number;
+    opacity: number;
+    strokeSharpness: StrokeSharpness;
+    fontFamily: FontFamily;
+    fontSize: number;
+    textAlign: string;
+    verticalAlign: string;
+    startArrowHead: string;
+    endArrowHead: string;
+  }
+  canvas: {theme: string, viewBackgroundColor: string};
+  setFillStyle: Function;
+  setStrokeStyle: Function;
+  setStrokeSharpness: Function;
+  setFontFamily: Function;
+  setTheme: Function;
+  addRect: Function;
+  addDiamond: Function;
+  addEllipse: Function;
+  addText: Function;
+  addLine: Function;
+  addArrow: Function;
+  connectObjects: Function;
+  addToGroup: Function;
+  toClipboard: Function;
+  create: Function;
+  createPNG: Function;
+  createSVG: Function;
+  clear: Function;
+  reset: Function;
+};
+```
+
+## Element Style
+As you will notice, some styles have setter functions. This is to help you navigate the allowed values for the property. You do not need to use the setter function however, you can use set the value directly as well.
+
+### strokeColor
+String. The color of the line. [CSS Legal Color Values](https://www.w3schools.com/cssref/css_colors_legal.asp)
+
+Allowed values are [HTML color names](https://www.w3schools.com/colors/colors_names.asp), hexadecimal RGB strings, or  e.g. `#FF0000` for red.
+
+### backgroundColor
+String. This is the fill color of an object. [CSS Legal Color Values](https://www.w3schools.com/cssref/css_colors_legal.asp)
+
+Allowed values are [HTML color names](https://www.w3schools.com/colors/colors_names.asp), hexadecimal RGB strings e.g. `#FF0000` for red, or `transparent`.
+
+### angle
+Number. Rotation in radian. 90° == `Math.PI/2`.
+
+### fillStyle, setFillStyle()
+```typescript
+type FillStyle = "hachure" | "cross-hatch" | "solid";
+setFillStyle (val:number);
+```
+fillStyle is a string.
+
+`setFillStyle()` accepts a number:
+- 0: "hachure"
+- 1: "cross-hatch"
+- any other number: "solid"
+
+### strokeWidth
+Number, sets the width of the stroke.
+
+### strokeStyle, setStrokeStyle()
+```typescript
+type StrokeStyle = "solid" | "dashed" | "dotted";
+setStrokeStyle (val:number);
+```
+strokeStyle is a string. 
+
+`setStrokeStyle()` accepts a number:
+- 0: "solid"
+- 1: "dashed"
+- any other number: "dotted"
+
+### roughness
+Number. Called sloppiness in Excalidraw. Three values are accepted:
+- 0: Architect
+- 1: Artist
+- 2: Cartoonist
+
+### opacity
+Number between 0 and 100. The opacity of an object, both stroke and fill.
+
+### strokeSharpness, setStrokeSharpness()
+```typescript
+type StrokeSharpness = "round" | "sharp";
+setStrokeSharpness(val:nmuber);
+```
+strokeSharpness is a string.
+
+"round" lines are curvey, "sharp" lines break at the turning point.
+
+`setStrokeSharpness()` accepts a number:
+- 0: "round"
+- any other number: "sharp"
+
+### fontFamily, setFontFamily()
+Number. Valid values are 1,2 and 3.
+
+`setFontFamily()` will also accept a number and return the name of the font.
+- 1: "Virgil, Segoe UI Emoji"
+- 2: "Helvetica, Segoe UI Emoji"
+- 3: "Cascadia, Segoe UI Emoji"
+
+### fontSize
+Number. Default value is 20 px
+
+### textAlign
+String. Alignment of the text horizontally. Valid values are "left", "center", "right".
+
+This is relevant when setting a fix width using the `addText()` function.
+
+### verticalAlign
+String. Alignment of the text vertically. Valid values are "top" and "middle".
+
+This is relevant when setting a fix height using the `addText()` function.
+
+### startArrowHead, endArrowHead
+String. Valid values are "arrow", "bar", "dot", and "none". Specifies the beginning and ending of an arrow.
+
+This is relavant when using the `addArrow()` and the `connectObjects()` functions.
+
+## canvas
+Sets the properties of the canvas. 
+
+### theme, setTheme()
+String. Valid values are "light" and "dark".
+
+`setTheme()` accepts a number:
+- 0: "light"
+- any other number: "dark"
+
+### viewBackgroundColor
+String. This is the fill color of an object. [CSS Legal Color Values](https://www.w3schools.com/cssref/css_colors_legal.asp)
+
+Allowed values are [HTML color names](https://www.w3schools.com/colors/colors_names.asp), hexadecimal RGB strings e.g. `#FF0000` for red, or `transparent`.
+
+## Adding objects
+These functions will add objects to your drawing. The canvas is infinite, and it accepts negative and positive X and Y values. X values increase left to right, Y values increase top to bottom.
+
+![coordinates](https://user-images.githubusercontent.com/14358394/116825632-6569b980-ab90-11eb-827b-ada598e91e46.png)
+
+### addRect(), addDiamond(), addEllipse()
+```typescript
+addRect(topX:number, topY:number, width:number, height:number):string
+addDiamond(topX:number, topY:number, width:number, height:number):string
+addEllipse(topX:number, topY:number, width:number, height:number):string
+```
+Returns the `id` of the object. The `id` is required when connecting objects with lines. See later.
+
+### addText
+```typescript
+addText(topX:number, topY:number, text:string, formatting?:{width:number, height:number,textAlign: string, verticalAlign:string, box: boolean, boxPadding: number}):string
+```
+
+Adds text to the drawing. 
+
+Formatting parameters are optional:
+- If `width` and `height` are not specified, the function will calculate the width and height based on the fontFamily, the fontSize and the text provided.
+- In case you want to position a text in the center compared to other elements on the drawing, you can provide a fixed height and width, and you can also specify `textAlign` and `verticalAlign` as described above. e.g.: `{width:500, textAlign:"center"}`
+- If you want to add a box around the text, set `{box:true}`
+
+Returns the `id` of the object. The `id` is required when connecting objects with lines. See later. If `{box:true}` then returns the id of the enclosing box.
+
+### addLine()
+```typescript
+addLine(points: [[x:number,y:number]]):void
+```
+Adds a line following the points provided. Must include at least two points `points.length >= 2`. If more than 2 points are provided the interim points will be added as breakpoints. The line will break with angles if `strokeSharpness` is set to "sharp" and will be curvey if it is set to "round".
+
+### addArrow()
+```typescript
+addArrow(points: [[x:number,y:number]],formatting?:{startArrowHead:string,endArrowHead:string,startObjectId:string,endObjectId:string}):void
+```
+
+Adds an arrow following the points provided. Must include at least two points `points.length >= 2`. If more than 2 points are provided the interim points will be added as breakpoints. The line will break with angles if element `style.strokeSharpness` is set to "sharp" and will be curvey if it is set to "round".
+
+`startArrowHead` and `endArrowHead` specify the type of arrow head to use, as described above. Valid values are "none", "arrow", "dot", and "bar". e.g. `{startArrowHead: "dot", endArrowHead: "arrow"}`
+
+`startObjectId` and `endObjectId` are the object id's of connected objects. I recommend using `connectObjects` instead calling addArrow() for the purpose of connecting objects.
+
+### connectObjects()
+```typescript
+declare type ConnectionPoint = "top"|"bottom"|"left"|"right";
+connectObjects(objectA: string, connectionA: ConnectionPoint, objectB: string, connectionB: ConnectionPoint, formatting?:{numberOfPoints: number,startArrowHead:string,endArrowHead:string, padding: number}):void
+```
+Connects two objects with an arrow.
+
+`objectA` and `objectB` are strings. These are the ids of the objects to connect. These IDs are returned by addRect(), addDiamond(), addEllipse() and addText() when creating those objects.
+
+`connectionA` and `connectionB` specify where to connect on the object. Valid values are: "top", "bottom", "left", and "right".
+
+`numberOfPoints` set the number of interim break points for the line. Default value is zero, meaning there will be no breakpoint in between the start and the end points of the arrow. When moving objects on the drawing, these breakpoints will influence how the line is rerouted by Excalidraw.
+
+`startArrowHead` and `endArrowHead` work as described for `addArrow()` above.
+
+### addToGroup()
+```typescript
+addToGroup(objectIds:[]):void
+```
+Groups objects listed in `objectIds`.
+
+## Utility functions
+### clear()
+`clear()` will clear objects from cache, but will retain element style settings.
+
+### reset()
+`reset()` will first call `clear()` and then reset element style to defaults.
+
+### toClipboard()
+```typescript
+async toClipboard(templatePath?:string)
+```
+Places the generated drawing to the clipboard. Useful when you don't want to create a new drawing, but want to paste additional items onto an exising drawing.
+
+### create()
+```typescript
+async create(params?:{filename: string, foldername:string, templatePath:string, onNewPane: boolean})
+```
+Creates the drawing and opens it.
+
+`filename` is the filename without extension of the drawing to be created. If `null`, then Excalidraw will generate a filename.
+
+`foldername` is the folder where the file should be created. If `null` then the default folder for new drawings will be used according to Excalidraw settings.
+
+`templatePath` the filename including full path and extension for a template file to use. This template file will be added as the base layer, all additional objects added via ExcalidrawAutomate will appear on top of elements in the template. If `null` then no template will be used, i.e. an empty white drawing will be the base for adding objects.
+
+`onNewPane` defines where the new drawing should be created. `false` will open the drawing on the current active leaf. `true` will open the drawing by vertically splitting the current leaf.
+
+Example:
+```javascript
+create({filename:"my drawing", foldername:"myfolder/subfolder/", templatePath: "Excalidraw/template.excalidraw", onNewPane: true});
+```
+### createSVG()
+```typescript
+async createSVG(templatePath?:string)
+```
+Returns an HTML SVGSVGElement containing the generated drawing.
+
+### createPNG()
+```typescript
+async createPNG(templatePath?:string)
+```
+Returns a blob containing a PNG image of the generated drawing.
+
+## Examples
+### Connect objects
+```javascript
+<%*
+  const ea = ExcalidrawAutomate;
+  ea.reset();
+  ea.addText(-130,-100,"Connecting two objects");
+  const a = ea.addRect(-100,-100,100,100);
+  const b = ea.addEllipse(200,200,100,100);
+  ea.connectObjects(a,"bottom",b,"left",{numberOfPoints: 2}); //see how the line breaks differently when moving objects around
+  ea.style.strokeColor = "red";
+  ea.connectObjects(a,"right",b,"top",1);
+  await ea.create();
+%>
+```
+### Using a template
+This example is similar to the first one, but rotated 90°, and using a template, plus specifying a filename and folder to save the drawing, and opening the new drawing in a new pane.
+```javascript
+<%*
+  const ea = ExcalidrawAutomate;
+  ea.reset();
+  ea.style.angle = Math.PI/2; 
+  ea.style.strokeWidth = 3.5;
+  ea.addRect(-150,-50,450,300);
+  ea.addText(-100,70,"Left to right");
+  ea.addArrow([[-100,100],[100,100]]);
+
+  ea.style.strokeColor = "red";
+  await ea.addText(100,-30,"top to bottom",{width:200,textAlign:"center"});
+  ea.addArrow([[200,0],[200,200]]);
+  await ea.create({filename:"My Drawing",foldername:"myfolder/fordemo/",templatePath:"Excalidraw/Template2.excalidraw",onNewPane:true});
+%>
+```
+
+### Generating a simple mindmap from a text outline
+This is a slightly more elaborate example. This will generate an a mindmap from a tabulated outline.
+
+![Drawing 2021-05-05 20 52 34](https://user-images.githubusercontent.com/14358394/117194124-00a69d00-ade4-11eb-8b75-5e18a9cbc3cd.png)
+
+Example input:
+```
+- Test 1
+	- Test 1.1
+- Test 2
+	- Test 2.1
+	- Test 2.2 
+		- Test 2.2.1
+		- Test 2.2.2
+		- Test 2.2.3
+			- Test 2.2.3.1
+- Test 3
+	- Test 3.1
+```
+
+The script:
+```javascript
+<%*
+const IDX = Object.freeze({"depth":0, "text":1, "parent":2, "size":3, "children": 4, "objectId":5});
+
+//check if an editor is the active view
+const editor = this.app.workspace.activeLeaf?.view?.editor;
+if(!editor) return;
+
+//initialize the tree with the title of the document as the first element
+let tree = [[0,this.app.workspace.activeLeaf?.view?.getDisplayText(),-1,0,[],0]];
+const linecount = editor.lineCount();
+
+//helper function, use regex to calculate indentation depth, and to get line text
+function getLineProps (i) {
+  props = editor.getLine(i).match(/^(\t*)-\s+(.*)/);
+  return [props[1].length+1, props[2]];
+}
+
+//a vector that will hold last valid parent for each depth
+let parents = [0];
+
+//load outline into tree
+for(i=0;i<linecount;i++) {
+  [depth,text] = getLineProps(i);
+  if(depth>parents.length) parents.push(i+1);
+  else parents[depth] = i+1;
+  tree.push([depth,text,parents[depth-1],1,[]]);
+  tree[parents[depth-1]][IDX.children].push(i+1);
+}
+
+//recursive function to crawl the tree and identify height aka. size of each node
+function crawlTree(i) {
+  if(i>linecount) return 0;
+  size = 0;
+  if((i+1<=linecount && tree[i+1][IDX.depth] <= tree[i][IDX.depth])|| i == linecount) { //I am a leaf
+    tree[i][IDX.size] = 1; 
+    return 1; 
+  }
+  tree[i][IDX.children].forEach((node)=>{ 
+    size += crawlTree(node);
+  });
+  tree[i][IDX.size] = size; 
+  return size;   
+}
+
+crawlTree(0);
+
+//Build the mindmap in Excalidraw
+const width = 300;
+const height = 100;
+const ea = ExcalidrawAutomate;
+ea.reset();
+
+//stores position offset of branch/leaf in height units
+offsets = [0];
+
+for(i=0;i<=linecount;i++) {
+  depth = tree[i][IDX.depth];
+  if (depth == 1) ea.style.strokeColor = '#'+(Math.random()*0xFFFFFF<<0).toString(16);
+  tree[i][IDX.objectId] = ea.addText(depth*width,((tree[i][IDX.size]/2)+offsets[depth])*height,tree[i][IDX.text],{box:true});  
+  //set child offset equal to parent offset
+  if((depth+1)>offsets.length) offsets.push(offsets[depth]);
+  else offsets[depth+1] = offsets[depth];
+  offsets[depth] += tree[i][IDX.size];
+  if(tree[i][IDX.parent]!=-1) {
+    ea.connectObjects(tree[tree[i][IDX.parent]][IDX.objectId],"right",tree[i][IDX.objectId],"left",{startArrowHead: 'dot'});
+  }
+}
+
+await ea.create({onNewPane: true});
+%>
+```

README.md

@@ -1,23 +1,23 @@
 # Obsidian Excalidraw Plugin
 The Obsidian-Excalidraw plugin integrates [Excalidraw](https://excalidraw.com/), a feature rich sketching tool, into Obsidian. You can store and edit Excalidraw files in your vault and you can transclude drawings into your documents. For a showcase of Excalidraw features, please read my blog post [here](https://www.zsolt.blog/2021/03/showcasing-excalidraw.html).
 
-**See details of the 1.0.6 release including a short video, futher below**
+**See details of the 1.0.6 and 1.0.7 release including a short video, further below**
 
 ![image](https://user-images.githubusercontent.com/14358394/115983515-d06c2c80-a5a1-11eb-8d12-c7df91d18107.png)
 
 ## Key features
-- The plugin adds the following actions to the command palette:
+- The plugin adds the following actions to the **command palette**:
   - To create a new drawing
   - To find and edit existing drawings in your vault, 
   - To embed (transclude) a drawing into a document, and
   - To export a drawing as PNG or SVG.
-- You can also use the file explorer in your vault to open Excalidraw files. 
-- Use the ribbon button to create a new drawing, do CTRL+Click to open on a new page.
-- Open settings to set up a default folder for new drawings. 
-- Set up a Template by creating a drawing, customizing it the way you like it, and specifying the file as the template in settings.
+- You can also use the **file explorer** in your vault to open Excalidraw files. 
+- Use the **ribbon button** to create a new drawing, do CTRL+Click to open on a new page.
+- Open settings to set up a **default folder** for new drawings. 
+- Set up a **Template** by creating a drawing, customizing it the way you like it, and specifying the file as the template in settings.
 - The plugin saves drawings to your vault as a file with the *.excalidraw* file extension.
-- You can customize the size and position of the embedded image using the [[image.excalidraw|100]], [[image.excalidraw|100x100]], [[image.excalidraw|100|left]] or [[image.excalidraw|right]], format.
-- You can setup Excalidraw to automatically export SVG and/or PNG files for your drawings, and to keep those in sync with your drawing.
+- You can customize the **size and position of the embedded image** 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 as style to the SVG element and the wrapper DIV element. Check below and styles.css for more insight.
+- You can setup Excalidraw to **automatically export SVG and/or PNG** files for your drawings, and to keep those in sync with your drawing.
 
 ## How to?
 Part 1: Intro to Obsidian-Excalidraw - Start a new drawing (3:12)
@@ -44,38 +44,60 @@ Part 6: Intro to Obsidian-Excalidraw: Embedding drawings (2:08)
 
 [![Part 6: Intro to Obsidian-Excalidraw: Embedding drawings](https://user-images.githubusercontent.com/14358394/115983954-bbdd6380-a5a4-11eb-9243-f0151451afcd.jpg)](https://youtu.be/JQeJ-Hh-xAI)
 
-## 1.0.6 update
+## 1.0.6 and 1.0.7 update
 [![1.0.6 Update](https://user-images.githubusercontent.com/14358394/116312909-58725200-a7ad-11eb-89b9-c67cb48ffebb.jpg)](https://youtu.be/ipZPbcP2B0M)
 
 ### SVG styling when embedding using a code block
+- 1.0.7 adds further flexibility to styling
 - new formatting option for the code block embedding
-- Valid values: left, right, center... but really anything after the last |.
+- Valid values: `left`, `right`, `left-wrap`, `right-wrap`... but anything after the last `|` character will be added to the class of the SVG element and the wrapper DIV element.
 Here is the corresponding CSS:
 ```
-.excalidraw-svg-left {
- float: left;
+svg.excalidraw-svg-right-wrap {
+  float: right;
+  margin: 0px 0px 20px 20px;
 }
 
-.excalidraw-svg-right {
- float: right;
+svg.excalidraw-svg-left-wrap {
+  float: left;
+  margin: 0px 35px 20px 0px;
 }
 
-.excalidraw-svg-center {
+div.excalidraw-svg-right {
+  text-align: right;
 }
 
-.excalidraw-svg {
+div.excalidraw-svg-left {
+  text-align: left;
 }
 ```
 
 
 ## Known issues
-- On mobile (iOS and Android): As you draw left to right it opens left sidebar. Draw right to left, opens right sidebar. Draw down, opens commands palette. So seems open is emulating the gestures, even when drawing towards the center. I understand that the issue will be resolved in the next release of Obsidian mobile. 
-- I have seen two cases when adding a stencil library did not work. In both cases the end solution was a reinstall of Obsidian. The root cause is not clear, but may be due to the incremental updates of Obsidian from an early version.
+- On mobile (iOS and Android): As you draw left to right it opens left sidebar. Draw right to left, opens right sidebar. Draw down, opens commands palette. So seems open is emulating the gestures, even when drawing towards the center. Obsidian mobile 0.18 has resolved this issue.
+- I have seen two cases when adding a stencil library did not work. In both cases, the end solution was a reinstall of Obsidian. The root cause is not clear, but maybe because of  the incremental updates of Obsidian from an early version.
+- Sync does not support .excalidraw files. This issue will be addressed in a later release of Obsidian sync. Until then, here are two hacks you can play with: 
+  - You have the option to use OneDrive, Google Drive, iCloud, DropBox, etc. to sync your vault between devices.
+  - You can also use Obsidian Sync in conjunction with "Obsidian Git" (find it in community plugins). Be sure to set up git to ignore all files except for .excalidraw by adding the following to `.gitignore`. Obsidian Git does not work on mobile, but on Android you can use an app like MGIT to sync your `.excalidraw` files from/to the git repository.
+  ```
+  #ignore all kind of files
+  *.*
+  #except excalidraw files
+  !*.excalidraw
+  ```
+## Tips and tricks
+- If you want to sketch in fullscreen, I recommend installing the [Fullscreen Focus Mode](https://github.com/razumihin/obsidian-fullscreen-plugin) plugin.
 
 ## Feedback, questions, ideas, problems
-By clicking [here](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues) you can create an issue to report a bug, suggest an improvement for this plugin, ask a question, etc.
+Join the conversation about the Excalidraw plugin on [forum.obsidian.md](https://forum.obsidian.md/t/excalidraw-full-featured-sketching-plugin-in-obsidian)
 
-## Support
-If you want to support me and my work, you can donate me a little something on [https://ko-fi/zsolt](https://ko-fi.com/zsolt).
+Please head over to [GitHub](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues) to report a bug or request an enhancement.
+
+## Say Thank You
+If you are enjoying Excalidraw then please support my work and enthusiasm by buying me a coffee on [https://ko-fi/zsolt](https://ko-fi.com/zsolt).
+
+Please also help spread the word by sharing about the Obsidian Excalidraw Plugin on Twitter, Reddit, or any other social media platform you regularly use. 
+
+You can find me on Twitter [@zsviczian](https://twitter.com/zsviczian), and on my blog [zsolt.blog](https://zsolt.blog).
 
 [<img style="float:left" src="https://user-images.githubusercontent.com/14358394/115450238-f39e8100-a21b-11eb-89d0-fa4b82cdbce8.png" width="200">](https://ko-fi.com/zsolt)

package.json

@@ -28,6 +28,7 @@
     "@types/node": "^14.14.2",
     "@types/react-dom": "^17.0.0",
     "cross-env": "7.0.3",
+    "nanoid": "3.1.22",
     "obsidian": "https://github.com/obsidianmd/obsidian-api/tarball/master",
     "postcss": "^8.2.6",
     "rollup": "2.45.2",

src/ExcalidrawTemplate.ts

@@ -0,0 +1,470 @@
+import ExcalidrawPlugin from "./main";
+import { 
+  ExcalidrawElement,
+  FillStyle,
+  StrokeStyle,
+  StrokeSharpness,
+  FontFamily,
+} from "@excalidraw/excalidraw/types/element/types";
+import {nanoid} from "nanoid";
+import {
+  normalizePath,
+  parseFrontMatterAliases,
+  TFile
+} from "obsidian"
+import ExcalidrawView from "./ExcalidrawView"
+
+declare type ConnectionPoint = "top"|"bottom"|"left"|"right";
+
+export interface ExcalidrawAutomate extends Window {
+  ExcalidrawAutomate: {
+    plugin: ExcalidrawPlugin;
+    elementIds: [];
+    elementsDict: {},
+    style: {
+      strokeColor: string;
+      backgroundColor: string;
+      angle: number;
+      fillStyle: FillStyle;
+      strokeWidth: number;
+      storkeStyle: StrokeStyle;
+      roughness: number;
+      opacity: number;
+      strokeSharpness: StrokeSharpness;
+      fontFamily: FontFamily;
+      fontSize: number;
+      textAlign: string;
+      verticalAlign: string;
+      startArrowHead: string;
+      endArrowHead: string;
+    }
+    canvas: {theme: string, viewBackgroundColor: string};
+    setFillStyle: Function;
+    setStrokeStyle: Function;
+    setStrokeSharpness: Function;
+    setFontFamily: Function;
+    setTheme: Function;
+    addRect: Function;
+    addDiamond: Function;
+    addEllipse: Function;
+    addText: Function;
+    addLine: Function;
+    addArrow: Function;
+    connectObjects: Function;
+    addToGroup: Function;
+    toClipboard: Function;
+    create: Function;
+    createPNG: Function;
+    createSVG: Function;
+    clear: Function;
+    reset: Function;
+  };
+}
+
+declare let window: ExcalidrawAutomate;
+
+export function initExcalidrawAutomate(plugin: ExcalidrawPlugin) {
+  window.ExcalidrawAutomate = {
+    plugin: plugin,
+    elementIds: [],
+    elementsDict: {},
+    style: {
+      strokeColor: "#000000",
+      backgroundColor: "transparent",
+      angle: 0,
+      fillStyle: "hachure",
+      strokeWidth:1,
+      storkeStyle: "solid",
+      roughness: 1,
+      opacity: 100,
+      strokeSharpness: "sharp",
+      fontFamily: 1,
+      fontSize: 20,
+      textAlign: "left",
+      verticalAlign: "top",
+      startArrowHead: null,
+      endArrowHead: "arrow"
+    },
+    canvas: {theme: "light", viewBackgroundColor: "#FFFFFF"},
+    setFillStyle (val:number) {
+      switch(val) {
+        case 0: 
+          this.style.fillStyle = "hachure";
+          return "hachure";
+        case 1:
+          this.style.fillStyle = "cross-hatch";
+          return "cross-hatch";
+        default:
+          this.style.fillStyle = "solid";
+          return "solid";
+      }
+    },
+    setStrokeStyle (val:number) {
+      switch(val) {
+        case 0: 
+          this.style.strokeStyle = "solid";
+          return "solid";
+        case 1:
+          this.style.strokeStyle = "dashed";
+          return "dashed";
+        default:
+          this.style.strokeStyle = "dotted";
+          return "dotted";
+      }      
+    },
+    setStrokeSharpness (val:number) {
+      switch(val) {
+        case 0: 
+          this.style.strokeSharpness = "round";
+          return "round";
+        default:
+          this.style.strokeSharpness = "sharp";
+          return "sharp";
+      }
+    },
+    setFontFamily (val:number) {
+      switch(val) {
+        case 1: 
+          this.style.fontFamily = 1;
+          return getFontFamily(1);
+        case 2:
+          this.style.fontFamily = 2;
+          return getFontFamily(2);
+        default:
+          this.style.strokeSharpness = 3;
+          return getFontFamily(3);
+      }
+    },
+    setTheme (val:number) {
+      switch(val) {
+        case 0: 
+          this.canvas.theme = "light";
+          return "light";
+        default:
+          this.canvas = "dark";
+          return "dark";
+      }      
+    },
+    addToGroup(objectIds:[]):void {
+      const id = nanoid();
+      objectIds.forEach((objectId)=>{
+        this.elementsDict[objectId]?.groupIds?.push(id);
+      });
+    },
+    async toClipboard(templatePath?:string) {
+      let elements = templatePath ? (await getTemplate(templatePath)).elements : [];
+      for (let i=0;i<this.elementIds.length;i++) {
+        elements.push(this.elementsDict[this.elementIds[i]]);
+      }
+      navigator.clipboard.writeText(
+        JSON.stringify({
+          "type":"excalidraw/clipboard",
+          "elements": elements,
+      }));
+    },
+    async create(params?:{filename: string, foldername:string, templatePath:string, onNewPane: boolean}) {
+      let elements = params?.templatePath ? (await getTemplate(params.templatePath)).elements : [];
+      for (let i=0;i<this.elementIds.length;i++) {
+        elements.push(this.elementsDict[this.elementIds[i]]);
+      }
+      plugin.createDrawing(
+        params?.filename ? params.filename + '.excalidraw' : this.plugin.getNextDefaultFilename(),
+        params?.onNewPane ? params.onNewPane : false,
+        params?.foldername ? params.foldername : this.plugin.settings.folder,
+        JSON.stringify({
+          "type": "excalidraw",
+          "version": 2,
+          "source": "https://excalidraw.com",
+          "elements": elements,
+          "appState": {
+            "theme": this.canvas.theme,
+            "viewBackgroundColor": this.canvas.viewBackgroundColor
+          }
+        })
+      );  
+    },
+    async createSVG(templatePath?:string) {
+      let elements = templatePath ? (await getTemplate(templatePath)).elements : [];
+      for (let i=0;i<this.elementIds.length;i++) {
+        elements.push(this.elementsDict[this.elementIds[i]]);
+      }
+      return ExcalidrawView.getSVG(
+        JSON.stringify({
+          "type": "excalidraw",
+          "version": 2,
+          "source": "https://excalidraw.com",
+          "elements": elements,
+          "appState": {
+            "theme": this.canvas.theme,
+            "viewBackgroundColor": this.canvas.viewBackgroundColor
+          }
+        }),
+        {
+          withBackground: plugin.settings.exportWithBackground, 
+          withTheme: plugin.settings.exportWithTheme
+        }
+      )     
+    },
+    async createPNG(templatePath?:string) {
+      let elements = templatePath ? (await getTemplate(templatePath)).elements : [];
+      for (let i=0;i<this.elementIds.length;i++) {
+        elements.push(this.elementsDict[this.elementIds[i]]);
+      }
+      return ExcalidrawView.getPNG(
+        JSON.stringify({
+          "type": "excalidraw",
+          "version": 2,
+          "source": "https://excalidraw.com",
+          "elements": elements,
+          "appState": {
+            "theme": this.canvas.theme,
+            "viewBackgroundColor": this.canvas.viewBackgroundColor
+          }
+        }),
+        {
+          withBackground: plugin.settings.exportWithBackground, 
+          withTheme: plugin.settings.exportWithTheme
+        }
+      )  
+    },
+    addRect(topX:number, topY:number, width:number, height:number):string {
+      const id = nanoid();
+      this.elementIds.push(id);
+      this.elementsDict[id] = boxedElement(id,"rectangle",topX,topY,width,height);
+      return id;
+    },
+    addDiamond(topX:number, topY:number, width:number, height:number):string {
+      const id = nanoid();
+      this.elementIds.push(id);
+      this.elementsDict[id] = boxedElement(id,"diamond",topX,topY,width,height);
+      return id;
+    },
+    addEllipse(topX:number, topY:number, width:number, height:number):string {
+      const id = nanoid();
+      this.elementIds.push(id);
+      this.elementsDict[id] = boxedElement(id,"ellipse",topX,topY,width,height);
+      return id;
+    },
+    addText(topX:number, topY:number, text:string, formatting?:{width:number, height:number,textAlign: string, verticalAlign:string, box: boolean, boxPadding: number}):string {
+      const id = nanoid();    
+      const {w, h, baseline} = measureText(text);
+      const width = formatting?.width ? formatting.width : w;
+      const height = formatting?.height ? formatting.height : h;
+      this.elementIds.push(id);
+      this.elementsDict[id] = {
+        text: text,
+        fontSize: window.ExcalidrawAutomate.style.fontSize,
+        fontFamily: window.ExcalidrawAutomate.style.fontFamily,
+        textAlign: formatting?.textAlign ? formatting.textAlign : window.ExcalidrawAutomate.style.textAlign,
+        verticalAlign: formatting?.verticalAlign ? formatting.verticalAlign : window.ExcalidrawAutomate.style.verticalAlign,
+        baseline: baseline,
+        ... boxedElement(id,"text",topX,topY,width,height)
+      };
+      if(formatting?.box) {
+        const boxPadding = formatting?.boxPadding ? formatting.boxPadding : 10;
+        const boxId = this.addRect(topX-boxPadding,topY-boxPadding,width+2*boxPadding,height+2*boxPadding);
+        this.addToGroup([id,boxId])
+        return boxId; 
+      }
+      return id;
+    },
+    addLine(points: [[x:number,y:number]]):void {
+      const box = getLineBox(points);
+      const id = nanoid();
+      this.elementIds.push(id);
+      this.elementsDict[id] = {
+        points: normalizeLinePoints(points),
+        lastCommittedPoint: null,
+        startBinding: null,
+        endBinding: null,
+        startArrowhead: null,
+        endArrowhead: null,
+        ... boxedElement(id,"line",box.x,box.y,box.w,box.h)
+      };
+    },
+    addArrow(points: [[x:number,y:number]],formatting?:{startArrowHead:string,endArrowHead:string,startObjectId:string,endObjectId:string}):void {
+      const box = getLineBox(points);
+      const id = nanoid();
+      this.elementIds.push(id);
+      this.elementsDict[id] = {
+        points: normalizeLinePoints(points),
+        lastCommittedPoint: null,
+        startBinding: {elementId:formatting?.startObjectId,focus:0.1,gap:4},
+        endBinding: {elementId:formatting?.endObjectId,focus:0.1,gap:4},
+        startArrowhead: formatting?.startArrowHead ? formatting.startArrowHead : this.style.startArrowHead,
+        endArrowhead: formatting?.endArrowHead ? formatting.endArrowHead : this.style.endArrowHead,
+        ... boxedElement(id,"arrow",box.x,box.y,box.w,box.h)
+      };
+      if(formatting?.startObjectId) this.elementsDict[formatting.startObjectId].boundElementIds.push(id);
+      if(formatting?.endObjectId) this.elementsDict[formatting.endObjectId].boundElementIds.push(id);
+    },
+    connectObjects(objectA: string, connectionA: ConnectionPoint, objectB: string, connectionB: ConnectionPoint, formatting?:{numberOfPoints: number,startArrowHead:string,endArrowHead:string, padding: number}):void {
+      if(!(this.elementsDict[objectA] && this.elementsDict[objectB])) {
+        return;
+      }
+      const padding = formatting?.padding ? formatting.padding : 10;
+      const numberOfPoints = formatting?.numberOfPoints ? formatting.numberOfPoints : 0;
+      const getSidePoints = (side:string, el:any) => {
+        switch(side) {
+          case "bottom": 
+            return [((el.x) + (el.x+el.width))/2, el.y+el.height+padding];
+          case "left": 
+            return [el.x-padding, ((el.y) + (el.y+el.height))/2];
+          case "right": 
+            return [el.x+el.width+padding, ((el.y) + (el.y+el.height))/2];
+          default: //"top"
+            return [((el.x) + (el.x+el.width))/2, el.y-padding];
+        }
+      }
+      const [aX, aY] = getSidePoints(connectionA,this.elementsDict[objectA]);
+      const [bX, bY] = getSidePoints(connectionB,this.elementsDict[objectB]);
+      const numAP = numberOfPoints+2; //number of break points plus the beginning and the end
+      let points = [];
+      for(let i=0;i<numAP;i++)
+        points.push([aX+i*(bX-aX)/(numAP-1), aY+i*(bY-aY)/(numAP-1)]);
+      this.addArrow(points,{ 
+        startArrowHead: formatting?.startArrowHead,
+        endArrowHead: formatting?.endArrowHead,
+        startObjectId: objectA, 
+        endObjectId: objectB
+      });
+    },
+    clear() {
+      this.elementIds = [];
+      this.elementsDict = {};
+    },
+    reset() {
+      this.clear();
+      this.style.strokeColor= "#000000";
+      this.style.backgroundColor= "transparent";
+      this.style.angle= 0;
+      this.style.fillStyle= "hachure";
+      this.style.strokeWidth= 1;
+      this.style.storkeStyle= "solid";
+      this.style.roughness= 1;
+      this.style.opacity= 100;
+      this.style.strokeSharpness= "sharp";
+      this.style.fontFamily= 1;
+      this.style.fontSize= 20;
+      this.style.textAlign= "left";
+      this.style.verticalAlign= "top";
+      this.style.startArrowHead= null;
+      this.style.endArrowHead= "arrow";
+      this.canvas.theme = "light";
+      this.canvas.viewBackgroundColor="#FFFFFF";
+    },
+  };
+  initFonts();
+}
+
+export function destroyExcalidrawAutomate() {
+  delete window.ExcalidrawAutomate;
+}
+
+function normalizeLinePoints(points:[[x:number,y:number]]) {
+  let p = [];
+  for(let i=0;i<points.length;i++) {
+    p.push([points[i][0]-points[0][0], points[i][1]-points[0][1]]);
+  }
+  return p;
+}
+
+function boxedElement(id:string,eltype:any,x:number,y:number,w:number,h:number) {
+  return {
+    id: id,
+    type: eltype,
+    x: x,
+    y: y,
+    width: w,
+    height: h, 
+    angle: window.ExcalidrawAutomate.style.angle,
+    strokeColor: window.ExcalidrawAutomate.style.strokeColor,
+    backgroundColor: window.ExcalidrawAutomate.style.backgroundColor,
+    fillStyle: window.ExcalidrawAutomate.style.fillStyle,
+    strokeWidth: window.ExcalidrawAutomate.style.strokeWidth,
+    storkeStyle: window.ExcalidrawAutomate.style.storkeStyle,
+    roughness: window.ExcalidrawAutomate.style.roughness,
+    opacity: window.ExcalidrawAutomate.style.opacity,
+    strokeSharpness: window.ExcalidrawAutomate.style.strokeSharpness,
+    seed: Math.floor(Math.random() * 100000),
+    version: 1,
+    versionNounce: 1,
+    isDeleted: false,
+    groupIds: [] as any,
+    boundElementIds: [] as any,
+  };
+}
+
+function getLineBox(points: [[x:number,y:number]]) {
+  return {
+    x: points[0][0],
+    y: points[0][1],
+    w: Math.abs(points[points.length-1][0]-points[0][0]),
+    h: Math.abs(points[points.length-1][1]-points[0][1])
+  }
+}
+
+function getFontFamily(id:number) {
+  switch (id) {
+    case 1: return "Virgil, Segoe UI Emoji";
+    case 2: return "Helvetica, Segoe UI Emoji";
+    case 3: return "Cascadia, Segoe UI Emoji"; 
+  }
+}
+
+async function initFonts () {
+  for (let i=0;i<3;i++) {
+    await (document as any).fonts.load(
+      window.ExcalidrawAutomate.style.fontSize.toString()+'px ' +
+      getFontFamily(window.ExcalidrawAutomate.style.fontFamily)
+    );
+  }
+}
+
+function measureText (newText:string) {
+  const line = document.createElement("div");
+  const body = document.body;
+  line.style.position = "absolute";
+  line.style.whiteSpace = "pre";
+  line.style.font = window.ExcalidrawAutomate.style.fontSize.toString()+'px ' +
+                    getFontFamily(window.ExcalidrawAutomate.style.fontFamily);
+//  await (document as any).fonts.load(line.style.font);
+  body.appendChild(line);
+  line.innerText = newText
+    .split("\n")
+    // replace empty lines with single space because leading/trailing empty
+    // lines would be stripped from computation
+    .map((x) => x || " ")
+    .join("\n");
+  const width = line.offsetWidth;
+  const height = line.offsetHeight;
+  // Now creating 1px sized item that will be aligned to baseline
+  // to calculate baseline shift
+  const span = document.createElement("span");
+  span.style.display = "inline-block";
+  span.style.overflow = "hidden";
+  span.style.width = "1px";
+  span.style.height = "1px";
+  line.appendChild(span);
+  // Baseline is important for positioning text on canvas
+  const baseline = span.offsetTop + span.offsetHeight;
+  document.body.removeChild(line);
+  return {w: width, h: height, baseline: baseline };
+};
+
+async function getTemplate(fileWithPath: string):Promise<{elements: any,appState: any}> {
+  const vault = window.ExcalidrawAutomate.plugin.app.vault;
+  const file = vault.getAbstractFileByPath(normalizePath(fileWithPath));
+  if(file && file instanceof TFile) {
+    const data = await vault.read(file);
+    const excalidrawData = JSON.parse(data);
+    return {
+      elements: excalidrawData.elements,
+      appState: excalidrawData.appState,  
+    };
+  };
+  return {
+    elements: [],
+    appState: {},
+  }
+}

src/ExcalidrawView.ts

@@ -3,7 +3,7 @@ import {
   WorkspaceLeaf, 
   normalizePath,
   TFile,
-  Menu,
+  WorkspaceItem
 } from "obsidian";
 import * as React from "react";
 import * as ReactDOM from "react-dom";
@@ -26,13 +26,18 @@ import {
 } from './constants';
 import ExcalidrawPlugin from './main';
 
+interface WorkspaceItemExt extends WorkspaceItem {
+  containerEl: HTMLElement;
+}
+
 export interface ExportSettings {
   withBackground: boolean,
   withTheme: boolean
 }
 
 export default class ExcalidrawView extends TextFileView {
-  private getScene: any;
+  private getScene: Function;
+  private refresh: Function;
   private excalidrawRef: React.MutableRefObject<any>;
   private justLoaded: boolean;
   private plugin: ExcalidrawPlugin;
@@ -40,6 +45,7 @@ export default class ExcalidrawView extends TextFileView {
   constructor(leaf: WorkspaceLeaf, plugin: ExcalidrawPlugin) {
     super(leaf);
     this.getScene = null;
+    this.refresh = null;
     this.excalidrawRef = null;
     this.plugin = plugin;
     this.justLoaded = false;
@@ -97,16 +103,22 @@ export default class ExcalidrawView extends TextFileView {
     }
     else return this.data;
   }
-
+  
   async onload() {
-    this.addAction(DISK_ICON_NAME,"Save drawing",async (ev)=> {
+    this.addAction(DISK_ICON_NAME,"Force-save now to update transclusion visible in adjacent workspace pane\n(Please note, that autosave is always on)",async (ev)=> {
       await this.save();
       this.plugin.triggerEmbedUpdates();
     });
     this.addAction(PNG_ICON_NAME,"Export as PNG",async (ev)=>this.savePNG());
     this.addAction(SVG_ICON_NAME,"Export as SVG",async (ev)=>this.saveSVG());
+    if (this.app.workspace.layoutReady) {
+      (this.app.workspace.rootSplit as WorkspaceItem as WorkspaceItemExt).containerEl.addEventListener('scroll',(e)=>{if(this.refresh) this.refresh();});
+    } else {
+      this.registerEvent(this.app.workspace.on('layout-ready', async () => (this.app.workspace.rootSplit as WorkspaceItem as WorkspaceItemExt).containerEl.addEventListener('scroll',(e)=>{if(this.refresh) this.refresh();})));
+    }
   }
 
+  //save current drawing when user closes workspace leaf
   async onunload() {
     if(this.excalidrawRef) await this.save();
   }
@@ -124,10 +136,11 @@ export default class ExcalidrawView extends TextFileView {
     if(this.excalidrawRef) {
       this.excalidrawRef = null;
       this.getScene = null;
+      this.refresh = null;
       ReactDOM.unmountComponentAtNode(this.contentEl);
     }
   }
-
+  
   private async loadDrawing (data:string, clear:boolean) {   
     if(clear) this.clear();
     this.justLoaded = true; //a flag to trigger zoom to fit after the drawing has been loaded
@@ -182,7 +195,7 @@ export default class ExcalidrawView extends TextFileView {
         width: undefined,
         height: undefined
       });
-
+      
       this.excalidrawRef = excalidrawRef;
       React.useEffect(() => {
         setDimensions({
@@ -196,6 +209,7 @@ export default class ExcalidrawView extends TextFileView {
               width: this.contentEl.clientWidth, 
               height: this.contentEl.clientHeight, 
             });
+            console.log("Excalidraw resize",this.contentEl.clientWidth,this.contentEl.clientHeight);
           } catch(err) {console.log ("Excalidraw React-Wrapper, onResize ",err)}
         };
         window.addEventListener("resize", onResize); 
@@ -219,6 +233,11 @@ export default class ExcalidrawView extends TextFileView {
           }
         });
       };
+
+      this.refresh = () => {
+        if(!excalidrawRef?.current) return;
+        excalidrawRef.current.refresh();
+      };
       
       return React.createElement(
         React.Fragment,
@@ -232,7 +251,6 @@ export default class ExcalidrawView extends TextFileView {
           },
           React.createElement(Excalidraw.default, {
             ref: excalidrawRef,
-            key: "xyz",
             width: dimensions.width,
             height: dimensions.height,
             UIOptions: {
@@ -244,6 +262,7 @@ export default class ExcalidrawView extends TextFileView {
               },
             },
             initialData: initdata,
+            detectScroll: true,
             onChange: (et:ExcalidrawElement[],st:AppState) => {
               if(this.justLoaded) {
                 this.justLoaded = false;             

src/TransclusionIndex.ts

@@ -0,0 +1,117 @@
+import {Vault,TFile,TAbstractFile} from 'obsidian';
+
+export default class TransclusionIndex {
+  private vault: Vault;
+  private doc2ex: Map<string, Set<string>>;
+  private ex2doc: Map<string, Set<string>>;
+
+  constructor(vault: Vault) {
+    this.vault = vault;
+    this.doc2ex = new Map<string,Set<string>>(); //markdown document includes these excalidraw drawings
+    this.ex2doc = new Map<string,Set<string>>(); //excalidraw drawings are referenced in these markdown documents
+  }
+
+  async reloadIndex() {
+    await this.initialize();
+  }
+
+  async initialize(): Promise<void> {
+    const doc2ex = new Map<string,Set<string>>(); 
+    const ex2doc = new Map<string,Set<string>>();
+
+    const markdownFiles = this.vault.getMarkdownFiles();
+    for (const file of markdownFiles) {     
+      const drawings = await this.parseTransclusionsInFile(file);
+      if (drawings.size > 0) {
+        doc2ex.set(file.path, drawings);
+        drawings.forEach((drawing)=>{
+          if(ex2doc.has(drawing)) ex2doc.set(drawing,ex2doc.get(drawing).add(file.path));
+          else ex2doc.set(drawing,(new Set<string>()).add(file.path));
+        });
+      }
+    }
+
+    this.doc2ex = doc2ex;
+    this.ex2doc = ex2doc;
+    this.registerEventHandlers();
+  }
+
+  private updateMarkdownFile(file:TFile,oldExPath:string,newExPath:string) {
+    const fileContents = this.vault.read(file);
+    fileContents.then((c: string) => this.vault.modify(file, c.split("[["+oldExPath).join("[["+newExPath)));
+    const exlist = this.doc2ex.get(file.path);
+    exlist.delete(oldExPath);
+    exlist.add(newExPath);
+    this.doc2ex.set(file.path,exlist);
+  }
+
+  public updateTransclusion(oldExPath: string, newExPath: string): void {
+    if(!this.ex2doc.has(oldExPath)) return; //drawing is not transcluded in any markdown document
+    for(const filePath of this.ex2doc.get(oldExPath)) {
+      this.updateMarkdownFile(this.vault.getAbstractFileByPath(filePath) as TFile,oldExPath,newExPath);
+    }
+    this.ex2doc.set(newExPath, this.ex2doc.get(oldExPath));
+    this.ex2doc.delete(oldExPath);
+  }
+
+  private indexAbstractFile(file: TAbstractFile) {
+    if (!(file instanceof TFile)) return;
+    if (file.extension.toLowerCase() != "md") return; //not a markdown document
+    this.indexFile(file as TFile);
+  }
+
+  private indexFile(file: TFile) {
+    this.clearIndex(file.path);
+    this.parseTransclusionsInFile(file).then((drawings) => {
+      if(drawings.size == 0) return;
+      this.doc2ex.set(file.path, drawings);
+      drawings.forEach((drawing)=>{
+        if(this.ex2doc.has(drawing)) {
+          this.ex2doc.set(drawing,this.ex2doc.get(drawing).add(file.path));
+        }
+        else this.ex2doc.set(drawing,(new Set<string>()).add(file.path));
+      });
+    });
+  }
+
+  private clearIndex(path: string) {
+    if(!this.doc2ex.get(path)) return;
+    this.doc2ex.get(path).forEach((ex)=> {
+      const files = this.ex2doc.get(ex);
+      files.delete(path);
+      if(files.size>0) this.ex2doc.set(ex,files);
+      else this.ex2doc.delete(ex);
+    });
+    this.doc2ex.delete(path);
+  }
+
+  private async parseTransclusionsInFile(file: TFile): Promise<Set<string>> {
+    const fileContents = await this.vault.cachedRead(file);
+    const pattern =  new RegExp('('+String.fromCharCode(96,96,96)+'excalidraw\\s+.*\\[{2})([^|\\]]*).*\\]{2}[\\s]+'+String.fromCharCode(96,96,96),'gm');
+    const transclusions = new Set<string>();
+    for(const transclusion of [...fileContents.matchAll(pattern)]) {
+      if(transclusion[2] && transclusion[2].endsWith('.excalidraw'))
+        transclusions.add(transclusion[2]);
+    }
+    return transclusions;
+  }
+
+  private registerEventHandlers() {
+    this.vault.on('create', (file: TAbstractFile) => {
+      this.indexAbstractFile(file);
+    });
+    this.vault.on('modify', (file: TAbstractFile) => {
+      this.indexAbstractFile(file);
+    });
+    this.vault.on('delete', (file: TAbstractFile) => {
+      this.clearIndex(file.path);
+    });
+    // We could simply change the references to the old path, but parsing again does the trick as well
+    this.vault.on('rename', (file: TAbstractFile, oldPath: string) => {
+      this.clearIndex(oldPath);
+      this.indexAbstractFile(file);
+    });
+  }
+}
+
+

src/main.ts

@@ -9,6 +9,8 @@ import {
   MarkdownView,
   normalizePath,
   MarkdownPostProcessorContext,
+  Menu,
+  MenuItem,
 } from 'obsidian';
 import { 
   BLANK_DRAWING,
@@ -23,7 +25,9 @@ import {
   PNG_ICON_NAME,
   SVG_ICON,
   SVG_ICON_NAME,
-  RERENDER_EVENT
+  RERENDER_EVENT,
+  VIRGIL_FONT,
+  CASCADIA_FONT
 } from './constants';
 import ExcalidrawView, {ExportSettings} from './ExcalidrawView';
 import {
@@ -35,12 +39,24 @@ import {
   openDialogAction, 
   OpenFileDialog
 } from './openDrawing';
+import {
+  initExcalidrawAutomate,
+  destroyExcalidrawAutomate
+} from './ExcalidrawTemplate';
+import TransclusionIndex from './TransclusionIndex';
 
+export interface ExcalidrawAutomate extends Window {
+  ExcalidrawAutomate: {
+    theme: string;
+    createNew: Function;
+  };
+}
 
 export default class ExcalidrawPlugin extends Plugin {
   public settings: ExcalidrawSettings;
   private openDialog: OpenFileDialog;
-  
+  private transclusionIndex: TransclusionIndex;
+
   constructor(app: App, manifest: PluginManifest) {
     super(app, manifest);
   }
@@ -51,6 +67,13 @@ export default class ExcalidrawPlugin extends Plugin {
     addIcon(PNG_ICON_NAME,PNG_ICON);
     addIcon(SVG_ICON_NAME,SVG_ICON);
 
+    const myFonts = document.createElement('style');
+    myFonts.appendChild(document.createTextNode(VIRGIL_FONT));
+    myFonts.appendChild(document.createTextNode(CASCADIA_FONT));
+    document.head.appendChild(myFonts);
+
+    initExcalidrawAutomate(this);
+
     this.registerView(
       VIEW_TYPE_EXCALIDRAW, 
       (leaf: WorkspaceLeaf) => new ExcalidrawView(leaf, this)
@@ -154,8 +177,24 @@ export default class ExcalidrawPlugin extends Plugin {
         }
       },
     });
+
+    this.registerEvent(
+      this.app.workspace.on("file-menu", (menu: Menu, file: TFile) => {
+        if (file instanceof TFolder) {
+          menu.addItem((item: MenuItem) => {
+            item.setTitle("Create Excalidraw drawing")
+              .setIcon(ICON_NAME)
+              .onClick(evt => {
+                this.createDrawing(this.getNextDefaultFilename(),false,file.path);
+              })
+          });
+        }
+      })
+    );
+
     //watch filename change to rename .svg
     this.app.vault.on('rename',async (file,oldPath) => {
+      this.transclusionIndex.updateTransclusion(oldPath,file.path);
       if (!(this.settings.keepInSync  && file instanceof TFile)) return;
       if (file.extension != EXCALIDRAW_FILE_EXTENSION) return;
       const oldSVGpath = oldPath.substring(0,oldPath.lastIndexOf('.'+EXCALIDRAW_FILE_EXTENSION)) + '.svg'; 
@@ -168,16 +207,45 @@ export default class ExcalidrawPlugin extends Plugin {
 
     //watch file delete and delete corresponding .svg
     this.app.vault.on('delete',async (file:TFile) => {
-      if (!(this.settings.keepInSync  && file instanceof TFile)) return;
+      if (!(file instanceof TFile)) return;
       if (file.extension != EXCALIDRAW_FILE_EXTENSION) return;
-      const svgPath = file.path.substring(0,file.path.lastIndexOf('.'+EXCALIDRAW_FILE_EXTENSION)) + '.svg'; 
-      const svgFile = this.app.vault.getAbstractFileByPath(normalizePath(svgPath));
-      if(svgFile && svgFile instanceof TFile) {
-        await this.app.vault.delete(svgFile); 
+      
+      const leaves = this.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
+      for (let i=0;i<leaves.length;i++) {
+        if((leaves[i].view as ExcalidrawView).file.path == file.path) {
+          //(leaves[i].view as ExcalidrawView).clear();
+          leaves[i].setViewState({
+            type: VIEW_TYPE_EXCALIDRAW,
+            state: {file: null}}
+          );
+        }
+      }      
+      
+      if (this.settings.keepInSync) {
+        const svgPath = file.path.substring(0,file.path.lastIndexOf('.'+EXCALIDRAW_FILE_EXTENSION)) + '.svg'; 
+        const svgFile = this.app.vault.getAbstractFileByPath(normalizePath(svgPath));
+        if(svgFile && svgFile instanceof TFile) {
+          await this.app.vault.delete(svgFile); 
+        }
       }
     });
+
+    //save open drawings when user quits the application
+    this.app.workspace.on('quit',(tasks) => {
+      const leaves = this.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);      
+      for (let i=0;i<leaves.length;i++) {
+        (leaves[i].view as ExcalidrawView).save(); 
+      }
+    });
+
+    this.transclusionIndex = new TransclusionIndex(this.app.vault);
+    this.transclusionIndex.initialize();
   }
   
+  onunload() {
+    destroyExcalidrawAutomate();
+  }
+
   private async codeblockProcessor(source: string, el: HTMLElement, ctx: MarkdownPostProcessorContext, plugin: ExcalidrawPlugin) {
     const parseError = (message: string) => {
       el.createDiv("excalidraw-error",(el)=> {
@@ -263,12 +331,12 @@ export default class ExcalidrawPlugin extends Plugin {
       .forEach((el) => el.dispatchEvent(e));
   }
 
-  public async openDrawing(drawingFile: TFile, onNewPane: boolean) {
-    const leafs = this.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
+  public openDrawing(drawingFile: TFile, onNewPane: boolean) {
+    const leaves = this.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
     let leaf:WorkspaceLeaf = null;
 
-    if (leafs?.length > 0) {
-      leaf = leafs[0];
+    if (leaves?.length > 0) {
+      leaf = leaves[0];
     }
     if(!leaf) {
       leaf = this.app.workspace.activeLeaf;
@@ -289,21 +357,27 @@ export default class ExcalidrawPlugin extends Plugin {
   }
 
   private getNextDefaultFilename():string {
-    return this.settings.folder+'/Drawing ' + window.moment().format('YYYY-MM-DD HH.mm.ss')+'.'+EXCALIDRAW_FILE_EXTENSION;
+    return 'Drawing ' + window.moment().format('YYYY-MM-DD HH.mm.ss')+'.'+EXCALIDRAW_FILE_EXTENSION;
   }
  
-  public async createDrawing(filename: string, onNewPane: boolean) {
-    const folder = this.app.vault.getAbstractFileByPath(normalizePath(this.settings.folder));
+  public async createDrawing(filename: string, onNewPane: boolean, foldername?: string, initData?:string) {
+    const fname = foldername ? normalizePath(foldername)+'/'+filename : normalizePath(this.settings.folder) + '/' + filename;
+    const folder = this.app.vault.getAbstractFileByPath(normalizePath(foldername ? foldername: this.settings.folder));
     if (!(folder && folder instanceof TFolder)) {
       await this.app.vault.createFolder(this.settings.folder);
     }
 
+    if(initData) {
+      this.openDrawing(await this.app.vault.create(fname,initData),onNewPane);
+      return;
+    }
+
     const file = this.app.vault.getAbstractFileByPath(normalizePath(this.settings.templateFilePath));
     if(file && file instanceof TFile) {
       const content = await this.app.vault.read(file);
-      this.openDrawing(await this.app.vault.create(filename,content==''?BLANK_DRAWING:content), onNewPane);
+      this.openDrawing(await this.app.vault.create(fname,content==''?BLANK_DRAWING:content), onNewPane);
     } else {
-      this.openDrawing(await this.app.vault.create(filename,BLANK_DRAWING), onNewPane);
+      this.openDrawing(await this.app.vault.create(fname,BLANK_DRAWING), onNewPane);
     }
   }
 }

styles.css

@@ -37,4 +37,8 @@ div.excalidraw-svg-right {
 
 div.excalidraw-svg-left {
   text-align: left;
+}
+
+button.ToolIcon_type_button[title="Export"] {
+  display:none;
 }

tsconfig.json

@@ -13,7 +13,7 @@
       "dom",
       "es5",
       "scripthost",
-      "es2015",
+      "es2020",
       "DOM.Iterable"
     ],
     "jsx": "react",

yarn.lock

@@ -7650,7 +7650,7 @@
     "dns-packet" "^1.3.1"
     "thunky" "^1.0.2"
 
-"nanoid@^3.1.20", "nanoid@^3.1.22":
+"nanoid@^3.1.20", "nanoid@^3.1.22", "nanoid@3.1.22":
   "integrity" "sha512-/2ZUaJX2ANuLtTvqTlgqBQNJoQO398KyJgZloL0PZkC0dpysjncRUPsFe3DUPzz/y3h+u7C46np8RMuvF3jsSQ=="
   "resolved" "https://registry.npmjs.org/nanoid/-/nanoid-3.1.22.tgz"
   "version" "3.1.22"