mikel 0.6.0 → 0.7.0

package/README.md

@@ -234,11 +234,11 @@ Custom helper functions receive a single object parameter containing the followi
 
 The helper function must return a string, which will be injected into the result string.
 
-### Variables
+### Runtime Variables
 
 > Added in `v0.4.0`.
 
-Data Variables in Mikel provide convenient access to special values within your templates. These variables, denoted by the `@` symbol, allow users to interact with specific data contexts or values.
+Runtime Variables in Mikel provide convenient access to special values within your templates. These variables, denoted by the `@` symbol, allow users to interact with specific data contexts or values at runtime. Runtime variables are usually generated by helpers like `#each`.
 
 #### @root
 
@@ -266,7 +266,27 @@ The `@key` variable allows users to retrieve the current key of the object entry
 
 The `@value` variable allows users to retrieve the current value of the object entry when iterating over an object using the `#each` helper. It simplifies access to object values for dynamic rendering and data manipulation.
 
-### Custom variables
+#### @first
+
+> Added in `v0.7.0`.
+
+The `@first` variable allows to check if the current iteration using the `#each` helper is the first item in the array or object.
+
+```
+{{#each items}} {{.}}: {{#if @first}}first item!{{/if}}{{#unless @first}}not first{{/if}} {{/each}}
+```
+
+#### @last
+
+> Added in `v0.7.0`.
+
+The `@last` variable allows to check if the current iteration using the `#each` helper is the last item in the array or object.
+
+```
+{{#each items}}{{@index}}:{{.}} {{#unless @last}},{{/unless}}{{/each}}
+```
+
+### Custom runtime variables
 
 > Added in `v0.5.0`
 

package/index.js

@@ -13,8 +13,9 @@ const get = (c, p) => (p === "." ? c : p.split(".").reduce((x, k) => x?.[k], c))
 
 const defaultHelpers = {
     "each": ({value, fn}) => {
-        return (typeof value === "object" ? Object.entries(value || {}) : [])
-            .map((item, index) => fn(item[1], {index: index, key: item[0], value: item[1]}))
+        const items = (typeof value === "object" ? Object.entries(value || {}) : []);
+        return items
+            .map((item, index) => fn(item[1], {index: index, key: item[0], value: item[1], first: index === 0, last: index === items.length - 1}))
             .join("");
     },
     "if": ({value, fn, context}) => !!value ? fn(context) : "",
@@ -39,7 +40,7 @@ const compile = (tokens, output, context, partials, helpers, vars, index = 0, se
             output.push(helpers[t]({
                 context: context,
                 key: v || ".",
-                value: get(context, v || "."),
+                value: (v || "").startsWith("@") ? get(vars, v.slice(1)) : get(context, v || "."),
                 fn: (blockContext = {}, blockVars = {}, blockOutput = []) => {
                     i = compile(tokens, blockOutput, blockContext, partials, helpers, {...vars, ...blockVars, root: vars.root}, j, t);
                     return blockOutput.join("");

package/package.json

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