mikel 0.22.2 → 0.23.0

package/README.md

@@ -360,6 +360,16 @@ The `escape` helper allows to escape the provided block content.
 console.log(m("{{#escape}}<b>Hello World!</b>{{/escape}}")); // --> '&lt;b&gt;Hello World!&lt;/b&gt;
 ```
 
+#### raw
+
+> Added in `v0.23.0`.
+
+The `raw` helper allows to render the content of the block without evaluating it. All the stuff inside the block will be rendered as is, without processing any variables or helpers.
+
+```javascript
+console.log(m("{{#raw}}Hello {{name}}!{{/raw}}", {name: "Bob"})); // --> 'Hello {{name}}!'
+```
+
 ### Custom Helpers
 
 > Added in `v0.5.0`.

package/index.js

@@ -45,6 +45,22 @@ const parse = (v, data = {}, vars = {}) => {
     return (v || "").startsWith("@") ? get(vars, v.slice(1)) : get(data, v || ".");
 };
 
+// @description find the index of the closing token
+const findClosingToken = (tokens, i, token) => {
+    while(i < tokens.length) {
+        if (i % 2 > 0) {
+            if (tokens[i].startsWith("/") && tokens[i].slice(1).trim() === token) {
+                return i;
+            }
+            else if (tokens[i].startsWith("#") && tokens[i].slice(1).trim().split(" ")[0] === token) {
+                i = findClosingToken(tokens, i + 1, token);
+            }
+        }
+        i = i + 1;
+    }
+    throw new Error(`Unmatched section end: {{${token}}}`);
+};
+
 // @description default helpers
 const defaultHelpers = {
     "each": p => {
@@ -60,6 +76,7 @@ const defaultHelpers = {
     "ne": p => p.args[0] !== p.args[1] ? p.fn(p.data) : "",
     "with": p => p.fn(p.args[0]),
     "escape": p => escape(p.fn(p.data)),
+    "raw": p => untokenize(p.tokens),
 };
 
 // @description create a new instance of mikel
@@ -81,20 +98,18 @@ const create = (template = "", options = {}) => {
             else if (tokens[i].startsWith("#") && typeof ctx.helpers[tokens[i].slice(1).trim().split(" ")[0]] === "function") {
                 const [t, args, opt] = parseArgs(tokens[i].slice(1), data, vars);
                 const j = i + 1;
+                i = findClosingToken(tokens, j, t);
                 output.push(ctx.helpers[t]({
                     args: args,
                     opt: opt,
+                    tokens: tokens.slice(j, i),
                     data: data,
                     variables: vars,
                     fn: (blockData = {}, blockVars = {}, blockOutput = []) => {
-                        i = compile(tokens, blockOutput, blockData, {...vars, ...blockVars, parent: data, root: vars.root}, j, t);
+                        compile(tokens, blockOutput, blockData, {...vars, ...blockVars, parent: data, root: vars.root}, j, t);
                         return blockOutput.join("");
                     },
                 }));
-                // Make sure that this block is executed at least once
-                if (i + 1 === j) {
-                    i = compile(tokens, [], {}, {}, j, t);
-                }
             }
             else if (tokens[i].startsWith("#") || tokens[i].startsWith("^")) {
                 const t = tokens[i].slice(1).trim();

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mikel",
     "description": "Micro templating library with zero dependencies",
-    "version": "0.22.2",
+    "version": "0.23.0",
     "type": "module",
     "author": {
         "name": "Josemi Juanes",