easy-template-x 2.1.0 → 3.0.2

package/README.md

@@ -2,10 +2,9 @@
 
 Generate docx documents from templates, in Node or in the browser.
 
-[![CircleCI](https://circleci.com/gh/alonrbar/easy-template-x.svg?style=shield)](https://circleci.com/gh/alonrbar/easy-template-x)
+[![ci](https://github.com/alonrbar/easy-template-x/actions/workflows/ci.yaml/badge.svg)](https://github.com/alonrbar/easy-template-x/actions/workflows/ci.yaml)
 [![npm version](https://img.shields.io/npm/v/easy-template-x.svg)](https://www.npmjs.com/package/easy-template-x)
 [![npm license](https://img.shields.io/npm/l/easy-template-x.svg)](https://www.npmjs.com/package/easy-template-x)
-[![dependencies](https://david-dm.org/alonrbar/easy-template-x.svg)](https://github.com/alonrbar/easy-template-x)
 
 - [Node Example](#node-example)
 - [Browser Example](#browser-example)
@@ -14,10 +13,12 @@ Generate docx documents from templates, in Node or in the browser.
   - [Text plugin](#text-plugin)
   - [Loop plugin](#loop-plugin)
     - [Conditions](#conditions)
+    - [Nested Conditions](#nested-conditions)
   - [Image plugin](#image-plugin)
   - [Link plugin](#link-plugin)
   - [Raw xml plugin](#raw-xml-plugin)
   - [Writing custom plugins](#writing-your-own-plugins)
+- [Listing tags](#listing-tags)
 - [Scope resolution](#scope-resolution)
 - [Extensions](#extensions)
   - [Community Extensions](#community-extensions)
@@ -186,7 +187,7 @@ Output document:
 
 You can render content conditionally depending on a boolean value using the same syntax used for loops.
 
-The example below shows two lines being rendered, each with different content depeneding on the truthy value.
+The example below shows two lines being rendered, each with different content depending on the truthy value.
 
 Input template:
 
@@ -207,7 +208,50 @@ Output document:
 
 ![output document](./docs/assets/simple-condition-out.png?raw=true)
 
-_For a more powerful conditional syntax see the [alternative syntax](#advanced-syntax-and-custom-resolvers) section._
+#### Nested Conditions
+
+Nested conditions are also supported, so you can nest other tags including loop tags and even other conditions in them. When doing so remember to format your data accordingly. See the example below for clarification:
+
+Input template:
+
+![input template](./docs/assets/nested-conditions-in.png?raw=true)
+
+Input data:
+
+Notice how even though `name` and `members` are nested in the template under the `show` condition their values are adjacent to it in the input data.
+
+```javascript
+{
+    "teams": [
+        {
+            show: true,
+            name: "A-Team",
+            members: [
+                { name: "Hannibal" },
+                { name: "Face" },
+                { name: "Murdock" },
+                { name: "Baracus" },
+            ]
+        },
+        {
+            show: false,
+            name: "B-Team",
+            members: [
+                { name: "Alice" },
+                { name: "Bob" },
+                { name: "Charlie" },
+                { name: "Dave" },
+            ]
+        }
+    ],
+}
+```
+
+Output document:
+
+![output document](./docs/assets/nested-conditions-out.png?raw=true)
+
+_If you are looking for a yet more powerful conditional syntax see the [alternative syntax](#advanced-syntax-and-custom-resolvers) section._
 
 ### Image plugin
 
@@ -340,6 +384,19 @@ export interface RawXmlContent extends PluginContent {
 }
 ```
 
+## Listing tags
+
+You can get the list of [tags](https://github.com/alonrbar/easy-template-x/blob/8a88535ef090fc357cf3523411bef0d0729d10c8/src/compilation/tag.ts) in a template by calling the `parseTags` method as follows:
+
+```typescript
+import { TemplateHandler } from 'easy-template-x';
+
+const templateFile = fs.readFileSync('myTemplate.docx');
+
+const handler = new TemplateHandler();
+const tags = await handler.parseTags(templateFile);
+```
+
 ## Scope resolution
 
 `easy-template-x` supports tag data scoping. That is, you can reference

package/dist/cjs/easy-template-x.js

@@ -3,8 +3,11 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var xmldom = require('xmldom');
+var getProp = require('lodash.get');
 var JSZip = require('jszip');
 
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   var n = Object.create(null);
@@ -14,18 +17,17 @@ function _interopNamespace(e) {
         var d = Object.getOwnPropertyDescriptor(e, k);
         Object.defineProperty(n, k, d.get ? d : {
           enumerable: true,
-          get: function () {
-            return e[k];
-          }
+          get: function () { return e[k]; }
         });
       }
     });
   }
-  n['default'] = e;
+  n["default"] = e;
   return Object.freeze(n);
 }
 
 var xmldom__namespace = /*#__PURE__*/_interopNamespace(xmldom);
+var getProp__default = /*#__PURE__*/_interopDefaultLegacy(getProp);
 var JSZip__namespace = /*#__PURE__*/_interopNamespace(JSZip);
 
 function _defineProperty(obj, key, value) {
@@ -1118,26 +1120,26 @@ class DelimiterSearcher {
           }
         } // no match
         else {
-            //
-            // go back to first open node
-            //
-            // Required for cases where the text has repeating
-            // characters that are the same as a delimiter prefix.  
-            // For instance:  
-            // Delimiter is '{!' and template text contains the string '{{!'
-            //
-            if (match.firstMatchIndex !== -1) {
-              node = first(match.openNodes);
-              textIndex = match.firstMatchIndex;
-            } // update state
-
-
-            match.reset();
-
-            if (textIndex < node.textContent.length - 1) {
-              match.openNodes.push(node);
-            }
+          //
+          // go back to first open node
+          //
+          // Required for cases where the text has repeating
+          // characters that are the same as a delimiter prefix.  
+          // For instance:  
+          // Delimiter is '{!' and template text contains the string '{{!'
+          //
+          if (match.firstMatchIndex !== -1) {
+            node = first(match.openNodes);
+            textIndex = match.firstMatchIndex;
+          } // update state
+
+
+          match.reset();
+
+          if (textIndex < node.textContent.length - 1) {
+            match.openNodes.push(node);
           }
+        }
 
         textIndex++;
       }
@@ -1190,8 +1192,6 @@ class DelimiterSearcher {
 
 }
 
-const getProp = require("lodash.get");
-
 class ScopeData {
   static defaultResolver(args) {
     let result;
@@ -1200,7 +1200,7 @@ class ScopeData {
 
     while (result === undefined && curPath.length) {
       curPath.pop();
-      result = getProp(args.data, curPath.concat(lastKey));
+      result = getProp__default["default"](args.data, curPath.concat(lastKey));
     }
 
     return result;
@@ -2619,9 +2619,9 @@ class LinkPlugin extends TemplatePlugin {
       }
     } // already isolated
     else {
-        XmlNode.insertAfter(linkMarkup, tagRunNode);
-        XmlNode.remove(tagRunNode);
-      }
+      XmlNode.insertAfter(linkMarkup, tagRunNode);
+      XmlNode.remove(tagRunNode);
+    }
   }
 
 }
@@ -2807,7 +2807,9 @@ class LoopPlugin extends TemplatePlugin {
   async containerTagReplacements(tags, data, context) {
     let value = data.getScopeData(); // Non array value - treat as a boolean condition.
 
-    if (!Array.isArray(value)) {
+    const isCondition = !Array.isArray(value);
+
+    if (isCondition) {
       if (!!value) {
         value = [{}];
       } else {
@@ -2833,7 +2835,7 @@ class LoopPlugin extends TemplatePlugin {
     // path to each token and use that to create new tokens instead of
     // search through the text again)
 
-    const compiledNodes = await this.compile(repeatedNodes, data, context); // merge back to the document
+    const compiledNodes = await this.compile(isCondition, repeatedNodes, data, context); // merge back to the document
 
     loopStrategy.mergeBack(compiledNodes, firstNode, lastNode);
   }
@@ -2850,7 +2852,7 @@ class LoopPlugin extends TemplatePlugin {
     return allResults;
   }
 
-  async compile(nodeGroups, data, context) {
+  async compile(isCondition, nodeGroups, data, context) {
     const compiledNodeGroups = []; // compile each node group with it's relevant data
 
     for (let i = 0; i < nodeGroups.length; i++) {
@@ -2859,9 +2861,9 @@ class LoopPlugin extends TemplatePlugin {
       const dummyRootNode = XmlNode.createGeneralNode('dummyRootNode');
       curNodes.forEach(node => XmlNode.appendChild(dummyRootNode, node)); // compile the new root
 
-      data.pathPush(i);
+      const conditionTag = this.updatePathBefore(isCondition, data, i);
       await this.utilities.compiler.compile(dummyRootNode, data, context);
-      data.pathPop(); // disconnect from dummy root
+      this.updatePathAfter(isCondition, data, conditionTag); // disconnect from dummy root
 
       const curResult = [];
 
@@ -2876,6 +2878,32 @@ class LoopPlugin extends TemplatePlugin {
     return compiledNodeGroups;
   }
 
+  updatePathBefore(isCondition, data, groupIndex) {
+    // if it's a condition - don't go deeper in the path
+    // (so we need to extract the already pushed condition tag)
+    if (isCondition) {
+      if (groupIndex > 0) {
+        // should never happen - conditions should have at most one (synthetic) child...
+        throw new Error(`Internal error: Unexpected group index ${groupIndex} for boolean condition at path "${data.pathString()}".`);
+      }
+
+      return data.pathPop();
+    } // else, it's an array - push the current index
+
+
+    data.pathPush(groupIndex);
+    return null;
+  }
+
+  updatePathAfter(isCondition, data, conditionTag) {
+    // reverse the "before" path operation
+    if (isCondition) {
+      data.pathPush(conditionTag);
+    } else {
+      data.pathPop();
+    }
+  }
+
 }
 
 class RawXmlPlugin extends TemplatePlugin {
@@ -3280,7 +3308,7 @@ class TemplateHandler {
   constructor(options) {
     var _this$options$extensi, _this$options$extensi2, _this$options$extensi3, _this$options$extensi4;
 
-    _defineProperty(this, "version", "2.1.0" );
+    _defineProperty(this, "version", "3.0.2" );
 
     _defineProperty(this, "xmlParser", new XmlParser());
 

package/dist/es/easy-template-x.js

@@ -1,4 +1,5 @@
 import * as xmldom from 'xmldom';
+import getProp from 'lodash.get';
 import * as JSZip from 'jszip';
 
 function _defineProperty(obj, key, value) {
@@ -1091,26 +1092,26 @@ class DelimiterSearcher {
           }
         } // no match
         else {
-            //
-            // go back to first open node
-            //
-            // Required for cases where the text has repeating
-            // characters that are the same as a delimiter prefix.  
-            // For instance:  
-            // Delimiter is '{!' and template text contains the string '{{!'
-            //
-            if (match.firstMatchIndex !== -1) {
-              node = first(match.openNodes);
-              textIndex = match.firstMatchIndex;
-            } // update state
-
-
-            match.reset();
-
-            if (textIndex < node.textContent.length - 1) {
-              match.openNodes.push(node);
-            }
+          //
+          // go back to first open node
+          //
+          // Required for cases where the text has repeating
+          // characters that are the same as a delimiter prefix.  
+          // For instance:  
+          // Delimiter is '{!' and template text contains the string '{{!'
+          //
+          if (match.firstMatchIndex !== -1) {
+            node = first(match.openNodes);
+            textIndex = match.firstMatchIndex;
+          } // update state
+
+
+          match.reset();
+
+          if (textIndex < node.textContent.length - 1) {
+            match.openNodes.push(node);
           }
+        }
 
         textIndex++;
       }
@@ -1163,8 +1164,6 @@ class DelimiterSearcher {
 
 }
 
-const getProp = require("lodash.get");
-
 class ScopeData {
   static defaultResolver(args) {
     let result;
@@ -2592,9 +2591,9 @@ class LinkPlugin extends TemplatePlugin {
       }
     } // already isolated
     else {
-        XmlNode.insertAfter(linkMarkup, tagRunNode);
-        XmlNode.remove(tagRunNode);
-      }
+      XmlNode.insertAfter(linkMarkup, tagRunNode);
+      XmlNode.remove(tagRunNode);
+    }
   }
 
 }
@@ -2780,7 +2779,9 @@ class LoopPlugin extends TemplatePlugin {
   async containerTagReplacements(tags, data, context) {
     let value = data.getScopeData(); // Non array value - treat as a boolean condition.
 
-    if (!Array.isArray(value)) {
+    const isCondition = !Array.isArray(value);
+
+    if (isCondition) {
       if (!!value) {
         value = [{}];
       } else {
@@ -2806,7 +2807,7 @@ class LoopPlugin extends TemplatePlugin {
     // path to each token and use that to create new tokens instead of
     // search through the text again)
 
-    const compiledNodes = await this.compile(repeatedNodes, data, context); // merge back to the document
+    const compiledNodes = await this.compile(isCondition, repeatedNodes, data, context); // merge back to the document
 
     loopStrategy.mergeBack(compiledNodes, firstNode, lastNode);
   }
@@ -2823,7 +2824,7 @@ class LoopPlugin extends TemplatePlugin {
     return allResults;
   }
 
-  async compile(nodeGroups, data, context) {
+  async compile(isCondition, nodeGroups, data, context) {
     const compiledNodeGroups = []; // compile each node group with it's relevant data
 
     for (let i = 0; i < nodeGroups.length; i++) {
@@ -2832,9 +2833,9 @@ class LoopPlugin extends TemplatePlugin {
       const dummyRootNode = XmlNode.createGeneralNode('dummyRootNode');
       curNodes.forEach(node => XmlNode.appendChild(dummyRootNode, node)); // compile the new root
 
-      data.pathPush(i);
+      const conditionTag = this.updatePathBefore(isCondition, data, i);
       await this.utilities.compiler.compile(dummyRootNode, data, context);
-      data.pathPop(); // disconnect from dummy root
+      this.updatePathAfter(isCondition, data, conditionTag); // disconnect from dummy root
 
       const curResult = [];
 
@@ -2849,6 +2850,32 @@ class LoopPlugin extends TemplatePlugin {
     return compiledNodeGroups;
   }
 
+  updatePathBefore(isCondition, data, groupIndex) {
+    // if it's a condition - don't go deeper in the path
+    // (so we need to extract the already pushed condition tag)
+    if (isCondition) {
+      if (groupIndex > 0) {
+        // should never happen - conditions should have at most one (synthetic) child...
+        throw new Error(`Internal error: Unexpected group index ${groupIndex} for boolean condition at path "${data.pathString()}".`);
+      }
+
+      return data.pathPop();
+    } // else, it's an array - push the current index
+
+
+    data.pathPush(groupIndex);
+    return null;
+  }
+
+  updatePathAfter(isCondition, data, conditionTag) {
+    // reverse the "before" path operation
+    if (isCondition) {
+      data.pathPush(conditionTag);
+    } else {
+      data.pathPop();
+    }
+  }
+
 }
 
 class RawXmlPlugin extends TemplatePlugin {
@@ -3253,7 +3280,7 @@ class TemplateHandler {
   constructor(options) {
     var _this$options$extensi, _this$options$extensi2, _this$options$extensi3, _this$options$extensi4;
 
-    _defineProperty(this, "version", "2.1.0" );
+    _defineProperty(this, "version", "3.0.2" );
 
     _defineProperty(this, "xmlParser", new XmlParser());
 

package/dist/types/plugins/loop/loopPlugin.d.ts

@@ -8,4 +8,6 @@ export declare class LoopPlugin extends TemplatePlugin {
     containerTagReplacements(tags: Tag[], data: ScopeData, context: TemplateContext): Promise<void>;
     private repeat;
     private compile;
+    private updatePathBefore;
+    private updatePathAfter;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-template-x",
-  "version": "2.1.0",
+  "version": "3.0.2",
   "description": "Generate docx documents from templates, in Node or in the browser.",
   "keywords": [
     "docx",
@@ -39,39 +39,39 @@
     "release": "yarn clean && yarn quality && yarn build"
   },
   "dependencies": {
-    "jszip": "3.6.0",
+    "jszip": "3.10.0",
     "lodash.get": "4.4.2",
-    "xmldom": "0.5.0"
+    "xmldom": "0.6.0"
   },
   "devDependencies": {
-    "@babel/core": "7.13.10",
-    "@babel/plugin-proposal-class-properties": "7.13.0",
-    "@babel/plugin-proposal-nullish-coalescing-operator": "7.13.8",
-    "@babel/plugin-proposal-object-rest-spread": "7.13.8",
-    "@babel/plugin-proposal-optional-catch-binding": "7.13.8",
-    "@babel/plugin-proposal-optional-chaining": "7.13.8",
-    "@babel/plugin-transform-modules-commonjs": "7.13.8",
-    "@babel/preset-typescript": "7.13.0",
-    "@rollup/plugin-replace": "2.4.1",
-    "@types/jest": "26.0.20",
-    "@types/jszip": "3.4.0",
-    "@types/node": "14.14.35",
+    "@babel/core": "7.18.6",
+    "@babel/plugin-proposal-class-properties": "7.18.6",
+    "@babel/plugin-proposal-nullish-coalescing-operator": "7.18.6",
+    "@babel/plugin-proposal-object-rest-spread": "7.18.6",
+    "@babel/plugin-proposal-optional-catch-binding": "7.18.6",
+    "@babel/plugin-proposal-optional-chaining": "7.18.6",
+    "@babel/plugin-transform-modules-commonjs": "7.18.6",
+    "@babel/preset-typescript": "7.18.6",
+    "@rollup/plugin-replace": "4.0.0",
+    "@types/jest": "28.1.4",
+    "@types/jszip": "3.4.1",
+    "@types/node": "18.0.1",
     "@types/ts-nameof": "4.2.1",
-    "@types/xmldom": "0.1.30",
-    "@typescript-eslint/eslint-plugin": "4.18.0",
-    "@typescript-eslint/parser": "4.18.0",
-    "babel-jest": "26.6.3",
-    "babel-loader": "8.2.2",
+    "@types/xmldom": "0.1.31",
+    "@typescript-eslint/eslint-plugin": "5.30.4",
+    "@typescript-eslint/parser": "5.30.4",
+    "babel-jest": "28.1.2",
+    "babel-loader": "8.2.5",
     "babel-plugin-ts-nameof": "4.2.1",
-    "eslint": "7.22.0",
-    "jest": "26.6.3",
-    "jest-junit": "12.0.0",
-    "lorem-ipsum": "2.0.3",
+    "eslint": "8.19.0",
+    "jest": "28.1.2",
+    "jest-junit": "14.0.0",
+    "lorem-ipsum": "2.0.8",
     "rimraf": "3.0.2",
-    "rollup": "2.41.4",
+    "rollup": "2.75.7",
     "rollup-plugin-auto-external": "2.0.0",
-    "rollup-plugin-babel": "4.3.3",
+    "rollup-plugin-babel": "4.4.0",
     "rollup-plugin-node-resolve": "5.2.0",
-    "typescript": "4.2.3"
+    "typescript": "4.7.4"
   }
 }

package/src/@types/lodash.d.ts

@@ -0,0 +1,12 @@
+// https://lodash.com/docs/4.17.15#get
+module "lodash.get" {
+
+    /**
+     * Gets the value at path of object. If the resolved value is undefined, the
+     * defaultValue is returned in its place.
+     */
+    function get(object: any, path: string | string[]): any;
+    function get(object: any, path: string | string[], defaultValue: any): any;
+
+    export default get;
+}

package/src/compilation/scopeData.ts

@@ -1,9 +1,8 @@
+import getProp from 'lodash.get';
 import { TemplateContent, TemplateData } from '../templateData';
 import { isNumber, last } from '../utils';
 import { Tag } from './tag';
 
-const getProp = require("lodash.get");
-
 export type PathPart = Tag | number;
 
 export interface ScopeDataArgs {

package/src/plugins/loop/loopPlugin.ts

@@ -1,4 +1,4 @@
-import { ScopeData, Tag, TemplateContext } from '../../compilation';
+import { PathPart, ScopeData, Tag, TemplateContext } from '../../compilation';
 import { TemplateData } from '../../templateData';
 import { last } from '../../utils';
 import { XmlNode } from '../../xml';
@@ -27,7 +27,8 @@ export class LoopPlugin extends TemplatePlugin {
         let value = data.getScopeData<TemplateData[]>();
 
         // Non array value - treat as a boolean condition.
-        if (!Array.isArray(value)) {
+        const isCondition = !Array.isArray(value);
+        if (isCondition) {
             if (!!value) {
                 value = [{}];
             } else {
@@ -54,7 +55,7 @@ export class LoopPlugin extends TemplatePlugin {
         // (this step can be optimized in the future if we'll keep track of the
         // path to each token and use that to create new tokens instead of
         // search through the text again)
-        const compiledNodes = await this.compile(repeatedNodes, data, context);
+        const compiledNodes = await this.compile(isCondition, repeatedNodes, data, context);
 
         // merge back to the document
         loopStrategy.mergeBack(compiledNodes, firstNode, lastNode);
@@ -74,7 +75,7 @@ export class LoopPlugin extends TemplatePlugin {
         return allResults;
     }
 
-    private async compile(nodeGroups: XmlNode[][], data: ScopeData, context: TemplateContext): Promise<XmlNode[][]> {
+    private async compile(isCondition: boolean, nodeGroups: XmlNode[][], data: ScopeData, context: TemplateContext): Promise<XmlNode[][]> {
         const compiledNodeGroups: XmlNode[][] = [];
 
         // compile each node group with it's relevant data
@@ -86,9 +87,9 @@ export class LoopPlugin extends TemplatePlugin {
             curNodes.forEach(node => XmlNode.appendChild(dummyRootNode, node));
 
             // compile the new root
-            data.pathPush(i);
+            const conditionTag = this.updatePathBefore(isCondition, data, i);
             await this.utilities.compiler.compile(dummyRootNode, data, context);
-            data.pathPop();
+            this.updatePathAfter(isCondition, data, conditionTag);
 
             // disconnect from dummy root
             const curResult: XmlNode[] = [];
@@ -101,4 +102,32 @@ export class LoopPlugin extends TemplatePlugin {
 
         return compiledNodeGroups;
     }
+
+    private updatePathBefore(isCondition: boolean, data: ScopeData, groupIndex: number): PathPart {
+
+        // if it's a condition - don't go deeper in the path
+        // (so we need to extract the already pushed condition tag)
+        if (isCondition) {
+            if (groupIndex > 0) {
+                // should never happen - conditions should have at most one (synthetic) child...
+                throw new Error(`Internal error: Unexpected group index ${groupIndex} for boolean condition at path "${data.pathString()}".`);
+            }
+            return data.pathPop();
+        }
+
+        // else, it's an array - push the current index
+        data.pathPush(groupIndex);
+        return null;
+    }
+
+    private updatePathAfter(isCondition: boolean, data: ScopeData, conditionTag: PathPart): void {
+
+        // reverse the "before" path operation
+        if (isCondition) {
+            data.pathPush(conditionTag);
+        } else {
+            data.pathPop();
+        }
+    }
 }
+

package/CHANGELOG.md

@@ -1,292 +0,0 @@
-# Change Log
-
-## [2.1.0 - 2021-07-29](https://github.com/alonrbar/easy-template-x/tree/v2.1.0)
-
-### Added
-
-- Add skipEmptyTag option ([#45](https://github.com/alonrbar/easy-template-x/issues/45)).
-
-## [2.0.0 - 2021-03-19](https://github.com/alonrbar/easy-template-x/tree/v2.0.0)
-
-### Added
-
-- Support for simple conditions ([docs](https://github.com/alonrbar/easy-template-x#conditions)).
-- Support for custom data resolvers - enables advanced syntax support ([docs](https://github.com/alonrbar/easy-template-x#advanced-syntax-and-custom-resolvers)).
-
-### Changed
-
-- **BREAKING** - Container closing tag name is ignored and no longer throws when
-  the closing tag has different name than the opening one ([docs](https://github.com/alonrbar/easy-template-x#loop-plugin)).
-
-## [1.0.1 - 2020-09-25](https://github.com/alonrbar/easy-template-x/tree/v1.0.1)
-
-### Changed
-
-- Update dependencies (jszip, xmldom).
-
-## [1.0.0 - 2020-08-09](https://github.com/alonrbar/easy-template-x/tree/v1.0.0)
-
-**Stable release** - from now on breaking changes to the public API (the public
-interface of `TemplateHandler`) will introduce a new major release.
-
-### Fixed
-
-- Initial content types parsing.
-- Bug in paragraph loops (#36).
-
-## [0.12.0 - 2020-08-01](https://github.com/alonrbar/easy-template-x/tree/v0.12.0)
-
-### Added
-
-- Headers and footers support.
-
-## [0.11.1 - 2020-03-29](https://github.com/alonrbar/easy-template-x/tree/v0.11.1)
-
-### Fixed
-
-- Consistent handling of `RawXmlContent` when the `xml` prop is null.
-
-## [0.11.0 - 2020-03-29](https://github.com/alonrbar/easy-template-x/tree/v0.11.0)
-
-### Added
-
-- Support for `RawXmlContent.replaceParagraph`.
-
-## [0.10.4 - 2020-03-02](https://github.com/alonrbar/easy-template-x/tree/v0.10.4)
-
-### Added
-
-- Expose "Community Extensions" on npm (readme changes).
-
-## [0.10.3 - 2020-02-16](https://github.com/alonrbar/easy-template-x/tree/v0.10.3)
-
-### Fixed
-
-- Parsing of tags with custom delimiters.
-
-## [0.10.2 - 2020-02-16](https://github.com/alonrbar/easy-template-x/tree/v0.10.2)
-
-### Fixed
-
-- Parsing of tags with custom delimiters.
-
-## [0.10.1 - 2020-02-12](https://github.com/alonrbar/easy-template-x/tree/v0.10.1)
-
-### Fixed
-
-- Export extensions types.
-
-## [0.10.0 - 2020-02-10](https://github.com/alonrbar/easy-template-x/tree/v0.10.0)
-
-### Added
-
-- Expose `Docx.rawZipFile` property.
-
-## [0.9.0 - 2020-02-10](https://github.com/alonrbar/easy-template-x/tree/v0.9.0)
-
-### Added
-
-- Extensions API (#24).
-
-## [0.8.3 - 2019-12-27](https://github.com/alonrbar/easy-template-x/tree/v0.8.3)
-
-### Added
-
-- Allow overriding container tag logic using explicit content type.
-
-## [0.8.2 - 2019-11-30](https://github.com/alonrbar/easy-template-x/tree/v0.8.2)
-
-### Changed
-
-- `ScopeData.getScopeData` is now generic (#17).
-- The `data` argument of `TemplateHandler.process` is now strongly typed.
-- Bundle with Rollup instead of Webpack.
-- Auto generate typings.
-
-## [0.8.1 - 2019-11-02](https://github.com/alonrbar/easy-template-x/tree/v0.8.1)
-
-### Fixed
-
-- Fix typings.
-
-## [0.8.0 - 2019-10-20](https://github.com/alonrbar/easy-template-x/tree/v0.8.0)
-
-### Changed
-
-- **BREAKING**: Delimiters can not contain leading or trailing whitespace.
-- Loosen up `TemplateHandlerOptions` typings.
-
-### Fixed
-
-- Loop tag names trimming.
-- Custom loop delimiters support.
-- Zip export and typings.
-
-## [0.7.3 - 2019-10-11](https://github.com/alonrbar/easy-template-x/tree/v0.7.3)
-
-### Added
-
-- Link to [live demo](https://codesandbox.io/s/easy-template-x-demo-x4ppu?fontsize=14&module=%2Findex.ts) on CodeSandbox.
-
-## [0.7.2 - 2019-10-10](https://github.com/alonrbar/easy-template-x/tree/v0.7.2)
-
-### Fixed
-
-- Re-fix "Binary type 'Buffer' is not supported" on Node.
-
-## [0.7.1 - 2019-10-03](https://github.com/alonrbar/easy-template-x/tree/v0.7.1)
-
-### Fixed
-
-- Link plugin in cases where the link tag is not the only node in it's run.
-
-## [0.7.0 - 2019-10-02](https://github.com/alonrbar/easy-template-x/tree/v0.7.0)
-
-### Added
-
-- Link plugin.
-- `TemplateHandler.version` property.
-
-## [0.6.0 - 2019-09-29](https://github.com/alonrbar/easy-template-x/tree/v0.6.0)
-
-This version removes the notion of a "tag type" and uses instead the notion of "content type". Instead of inferring the type from the tag _prefix_ the type is now explicitly declared in the supplied JSON _data_.
-
-**Example:**
-
-_Before:_
-
-```text
-tag: "{@newPage}"  
-data: {  
-    newPage: "<w:br w:type="page"/>"
-}
-```
-
-_After:_
-
-```text
-tag: "{newPage}"
-data: {
-    newPage: {
-        _type: "rawXml",
-        xml: "<w:br w:type="page"/>"
-    }
-}
-```
-
-The only exceptions are the "loop" content type which still uses the "#" opening prefix and "/" closing prefix, and the "text" content type which is the default and does not requires explicitly stating it.
-
-### Added
-
-- Image plugin.
-- Support multi-character delimiters.
-- Template plugins can be async.
-- Improved the docs (readme).
-
-### Changed
-
-- **BREAKING**: `RawXmlPlugin` requires data of the form `{ _type: 'rawXml', xml: string }`.
-
-### Removed
-
-- **BREAKING**: Remove the `Tag.type` property.
-
-### Fixed
-
-- Parsing error in some cases where multiple tags are declared in the same run.
-
-## [0.5.2 - 2019-09-11](https://github.com/alonrbar/easy-template-x/tree/v0.5.2)
-
-### Fixed
-
-- "Binary type 'Buffer' is not supported." on Node 12.
-
-## [0.5.1 - 2019-06-05](https://github.com/alonrbar/easy-template-x/tree/v0.5.1)
-
-### Fixed
-
-- Handle non-textual values (numbers, booleans...) in TextPlugin.
-
-## [0.5.0 - 2019-05-07](https://github.com/alonrbar/easy-template-x/tree/v0.5.0)
-
-### Added
-
-- Loop over lists and table rows.  
-  **Notice**:
-    The loop logic for tables is a bit different than the logic of the existing
-    paragraph loop. Instead of repeating the content in between the opening and
-    closing tags it repeats entire rows (including content in the row that
-    appears before the opening or after the closing tag). The same goes for
-    lists - the entire bullet is repeated.
-- Throw MalformedFileError when fails to open template file as zip.
-- Continuous integration with CircleCI.
-
-### Changed
-
-- Change dev stack to Babel, Jest and ESLint.
-
-## [0.4.0 - 2018-12-13](https://github.com/alonrbar/easy-template-x/tree/v0.4.0)
-
-### Added
-
-- Easily find out what tags are present in a given template (TemplateHandler.parseTags).
-
-## [0.3.4 - 2018-12-09](https://github.com/alonrbar/easy-template-x/tree/v0.3.4)
-
-### Added
-
-- Full browser example in readme file.
-
-## [0.3.3 - 2018-07-17](https://github.com/alonrbar/easy-template-x/tree/v0.3.3)
-
-### Added
-
-- Package keywords for npm visibility.
-
-## [0.3.2 - 2018-06-22](https://github.com/alonrbar/easy-template-x/tree/v0.3.2)
-
-### Fixed
-
-- Fix serialization of text nodes with empty values.
-
-## [0.3.1 - 2018-06-13](https://github.com/alonrbar/easy-template-x/tree/v0.3.1)
-
-### Added
-
-- Add readme badges
-
-## [0.3.0 - 2018-06-13](https://github.com/alonrbar/easy-template-x/tree/v0.3.0)
-
-### Added
-
-- Preserve leading and trailing whitespace
-- More info on missing delimiter errors
-
-## [0.2.1 - 2018-06-12](https://github.com/alonrbar/easy-template-x/tree/v0.2.1)
-
-### Fixed
-
-- Various bug fixes
-
-## [0.2.0 - 2018-06-12](https://github.com/alonrbar/easy-template-x/tree/v0.2.0)
-
-### Added
-
-- Typings file
-
-## [0.1.0 - 2018-06-12](https://github.com/alonrbar/easy-template-x/tree/v0.1.0)
-
-- First version
-
----
-
-The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
-
-#### [Types of changes](http://keepachangelog.com)
-
-- **Added** for new features.
-- **Changed** for changes in existing functionality.
-- **Deprecated** for soon-to-be removed features.
-- **Removed** for now removed features.
-- **Fixed** for any bug fixes.
-- **Security** in case of vulnerabilities.