easy-template-x 4.1.8 → 5.0.1

package/README.md

@@ -6,6 +6,21 @@ Generate docx documents from templates, in Node or in the browser.
 [![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)
 
+> ---
+>
+> 🚀 **Looking for a managed solution?**
+>
+> Check out [templatedocs.io](https://templatedocs.io) - a cloud platform for document generation with:
+>
+> ✓ PDF support  
+> ✓ REST API integration  
+> ✓ Live preview functionality  
+> ✓ Easy-to-use UI  
+>
+> And more...
+>
+> ---
+
 - [Node Example](#node-example)
 - [Browser Example](#browser-example)
 - [Live Demo](#live-demo)
@@ -376,7 +391,7 @@ make it easier to do the actual xml modification.
 
 _To better understand the internal structure of Word documents check out [this excellent source](http://officeopenxml.com/WPcontentOverview.php)._
 
-Example plugin implementation ([source](./src/plugins/rawXmlPlugin.ts)):
+Example plugin implementation ([source](./src/plugins/rawXml/rawXmlPlugin.ts)):
 
 ```typescript
 /**

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

@@ -2494,7 +2494,10 @@ class LoopListStrategy {
   setUtilities(utilities) {
     this.utilities = utilities;
   }
-  isApplicable(openTag, closeTag) {
+  isApplicable(openTag, closeTag, isCondition) {
+    if (isCondition) {
+      return false;
+    }
     const containingParagraph = this.utilities.docxParser.containingParagraphNode(openTag.xmlTextNode);
     return this.utilities.docxParser.isListParagraph(containingParagraph);
   }
@@ -2531,7 +2534,7 @@ class LoopParagraphStrategy {
   setUtilities(utilities) {
     this.utilities = utilities;
   }
-  isApplicable(openTag, closeTag) {
+  isApplicable(openTag, closeTag, isCondition) {
     return true;
   }
   splitBefore(openTag, closeTag) {
@@ -2606,7 +2609,7 @@ class LoopTableStrategy {
   setUtilities(utilities) {
     this.utilities = utilities;
   }
-  isApplicable(openTag, closeTag) {
+  isApplicable(openTag, closeTag, isCondition) {
     const openParagraph = this.utilities.docxParser.containingParagraphNode(openTag.xmlTextNode);
     if (!openParagraph.parentNode) return false;
     if (!this.utilities.docxParser.isTableCellNode(openParagraph.parentNode)) return false;
@@ -2676,7 +2679,7 @@ class LoopPlugin extends TemplatePlugin {
     const closeTag = last(tags);
 
     // select the suitable strategy
-    const loopStrategy = this.loopStrategies.find(strategy => strategy.isApplicable(openTag, closeTag));
+    const loopStrategy = this.loopStrategies.find(strategy => strategy.isApplicable(openTag, closeTag, isCondition));
     if (!loopStrategy) throw new Error(`No loop strategy found for tag '${openTag.rawText}'.`);
 
     // prepare to loop
@@ -3083,7 +3086,7 @@ class TemplateHandler {
   /**
    * Version number of the `easy-template-x` library.
    */
-  version = "4.1.8" ;
+  version = "5.0.1" ;
   xmlParser = new XmlParser();
   constructor(options) {
     this.options = new TemplateHandlerOptions(options);

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

@@ -2492,7 +2492,10 @@ class LoopListStrategy {
   setUtilities(utilities) {
     this.utilities = utilities;
   }
-  isApplicable(openTag, closeTag) {
+  isApplicable(openTag, closeTag, isCondition) {
+    if (isCondition) {
+      return false;
+    }
     const containingParagraph = this.utilities.docxParser.containingParagraphNode(openTag.xmlTextNode);
     return this.utilities.docxParser.isListParagraph(containingParagraph);
   }
@@ -2529,7 +2532,7 @@ class LoopParagraphStrategy {
   setUtilities(utilities) {
     this.utilities = utilities;
   }
-  isApplicable(openTag, closeTag) {
+  isApplicable(openTag, closeTag, isCondition) {
     return true;
   }
   splitBefore(openTag, closeTag) {
@@ -2604,7 +2607,7 @@ class LoopTableStrategy {
   setUtilities(utilities) {
     this.utilities = utilities;
   }
-  isApplicable(openTag, closeTag) {
+  isApplicable(openTag, closeTag, isCondition) {
     const openParagraph = this.utilities.docxParser.containingParagraphNode(openTag.xmlTextNode);
     if (!openParagraph.parentNode) return false;
     if (!this.utilities.docxParser.isTableCellNode(openParagraph.parentNode)) return false;
@@ -2674,7 +2677,7 @@ class LoopPlugin extends TemplatePlugin {
     const closeTag = last(tags);
 
     // select the suitable strategy
-    const loopStrategy = this.loopStrategies.find(strategy => strategy.isApplicable(openTag, closeTag));
+    const loopStrategy = this.loopStrategies.find(strategy => strategy.isApplicable(openTag, closeTag, isCondition));
     if (!loopStrategy) throw new Error(`No loop strategy found for tag '${openTag.rawText}'.`);
 
     // prepare to loop
@@ -3081,7 +3084,7 @@ class TemplateHandler {
   /**
    * Version number of the `easy-template-x` library.
    */
-  version = "4.1.8" ;
+  version = "5.0.1" ;
   xmlParser = new XmlParser();
   constructor(options) {
     this.options = new TemplateHandlerOptions(options);

package/dist/types/plugins/loop/strategy/iLoopStrategy.d.ts

@@ -3,7 +3,7 @@ import { XmlNode } from '../../../xml';
 import { PluginUtilities } from '../../templatePlugin';
 export interface ILoopStrategy {
     setUtilities(utilities: PluginUtilities): void;
-    isApplicable(openTag: Tag, closeTag: Tag): boolean;
+    isApplicable(openTag: Tag, closeTag: Tag, isCondition: boolean): boolean;
     splitBefore(openTag: Tag, closeTag: Tag): SplitBeforeResult;
     mergeBack(compiledNodes: XmlNode[][], firstNode: XmlNode, lastNode: XmlNode): void;
 }

package/dist/types/plugins/loop/strategy/loopListStrategy.d.ts

@@ -5,7 +5,7 @@ import { ILoopStrategy, SplitBeforeResult } from './iLoopStrategy';
 export declare class LoopListStrategy implements ILoopStrategy {
     private utilities;
     setUtilities(utilities: PluginUtilities): void;
-    isApplicable(openTag: Tag, closeTag: Tag): boolean;
+    isApplicable(openTag: Tag, closeTag: Tag, isCondition: boolean): boolean;
     splitBefore(openTag: Tag, closeTag: Tag): SplitBeforeResult;
     mergeBack(paragraphGroups: XmlNode[][], firstParagraph: XmlNode, lastParagraphs: XmlNode): void;
 }

package/dist/types/plugins/loop/strategy/loopParagraphStrategy.d.ts

@@ -5,7 +5,7 @@ import { ILoopStrategy, SplitBeforeResult } from './iLoopStrategy';
 export declare class LoopParagraphStrategy implements ILoopStrategy {
     private utilities;
     setUtilities(utilities: PluginUtilities): void;
-    isApplicable(openTag: Tag, closeTag: Tag): boolean;
+    isApplicable(openTag: Tag, closeTag: Tag, isCondition: boolean): boolean;
     splitBefore(openTag: Tag, closeTag: Tag): SplitBeforeResult;
     mergeBack(middleParagraphs: XmlNode[][], firstParagraph: XmlNode, lastParagraph: XmlNode): void;
 }

package/dist/types/plugins/loop/strategy/loopTableStrategy.d.ts

@@ -5,7 +5,7 @@ import { ILoopStrategy, SplitBeforeResult } from './iLoopStrategy';
 export declare class LoopTableStrategy implements ILoopStrategy {
     private utilities;
     setUtilities(utilities: PluginUtilities): void;
-    isApplicable(openTag: Tag, closeTag: Tag): boolean;
+    isApplicable(openTag: Tag, closeTag: Tag, isCondition: boolean): boolean;
     splitBefore(openTag: Tag, closeTag: Tag): SplitBeforeResult;
     mergeBack(rowGroups: XmlNode[][], firstRow: XmlNode, lastRow: XmlNode): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-template-x",
-  "version": "4.1.8",
+  "version": "5.0.1",
   "description": "Generate docx documents from templates, in Node or in the browser.",
   "keywords": [
     "docx",

package/src/plugins/loop/loopPlugin.ts

@@ -41,7 +41,7 @@ export class LoopPlugin extends TemplatePlugin {
         const closeTag = last(tags);
 
         // select the suitable strategy
-        const loopStrategy = this.loopStrategies.find(strategy => strategy.isApplicable(openTag, closeTag));
+        const loopStrategy = this.loopStrategies.find(strategy => strategy.isApplicable(openTag, closeTag, isCondition));
         if (!loopStrategy)
             throw new Error(`No loop strategy found for tag '${openTag.rawText}'.`);
 

package/src/plugins/loop/strategy/iLoopStrategy.ts

@@ -6,7 +6,7 @@ export interface ILoopStrategy {
 
     setUtilities(utilities: PluginUtilities): void;
 
-    isApplicable(openTag: Tag, closeTag: Tag): boolean;
+    isApplicable(openTag: Tag, closeTag: Tag, isCondition: boolean): boolean;
 
     splitBefore(openTag: Tag, closeTag: Tag): SplitBeforeResult;
 

package/src/plugins/loop/strategy/loopListStrategy.ts

@@ -11,7 +11,11 @@ export class LoopListStrategy implements ILoopStrategy {
         this.utilities = utilities;
     }
 
-    public isApplicable(openTag: Tag, closeTag: Tag): boolean {
+    public isApplicable(openTag: Tag, closeTag: Tag, isCondition: boolean): boolean {
+        if (isCondition) {
+            return false;
+        }
+
         const containingParagraph = this.utilities.docxParser.containingParagraphNode(openTag.xmlTextNode);
         return this.utilities.docxParser.isListParagraph(containingParagraph);
     }

package/src/plugins/loop/strategy/loopParagraphStrategy.ts

@@ -11,7 +11,7 @@ export class LoopParagraphStrategy implements ILoopStrategy {
         this.utilities = utilities;
     }
 
-    public isApplicable(openTag: Tag, closeTag: Tag): boolean {
+    public isApplicable(openTag: Tag, closeTag: Tag, isCondition: boolean): boolean {
         return true;
     }
 

package/src/plugins/loop/strategy/loopTableStrategy.ts

@@ -12,7 +12,7 @@ export class LoopTableStrategy implements ILoopStrategy {
         this.utilities = utilities;
     }
 
-    public isApplicable(openTag: Tag, closeTag: Tag): boolean {
+    public isApplicable(openTag: Tag, closeTag: Tag, isCondition: boolean): boolean {
         const openParagraph = this.utilities.docxParser.containingParagraphNode(openTag.xmlTextNode);
         if (!openParagraph.parentNode)
             return false;