jtlt 0.25.1 → 0.26.0

package/CHANGES.md

@@ -1,5 +1,10 @@
 # CHANGES for jtlt
 
+## 0.26.0
+
+- feat: `{$renderDefault: {...}}` passes its argument object to the
+  `renderDefault` extension (`{$renderDefault: true}` is unchanged)
+
 ## 0.25.1
 
 - fix: JSONPath (preventEval -> eval: false; returnType->resultType; add customTypes; avoid any type)

package/dist/jsonTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonTemplate.d.ts","sourceRoot":"","sources":["../src/jsonTemplate.js"],"names":[],"mappings":"AAyEG,YAAwC,QAAQ,GAAtC,MAAM,GAAC,SAAS,GAAC,WAAW,CAAU;AAoEhD,YAAgD,2BAA2B,GAAjE;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,GAAG;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAC,CAA6B;AA8Q3E,YAAuC,UAAU,GAAvC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAY;AA6EpD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAE,KAAK,EAHxB,OAAO,EAGiB,GAFtB;IAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAC,CA+BnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EARI,OAAO,EAQX,EAAE,EAAC,MAAe,EAAE,qBAAqB,EAAC,AAP9C,CAIA,EAJQ;IACN,MAAM,CAAC,EAAE,MAAM,GAAC,YAAY,CAAC;IAC7B,qBAAqB,CAAC,EAAE,2BAA2B,CAAA;CAKF,GAHzC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAC,CAiB9C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAE,CAAC,EAH/B,OAG+B,GAF7B,CAAC,IAAI,OAAO,EAAE,CAI1B;AAqKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAVI,OAAO,EAUX,EAAE,EAAC,MAAe,EAAE,qBAAqB,EAAC,AAT9C,CAIA,EAJQ;IACN,MAAM,CAAC,EAAE,MAAM,GAAC,YAAY,CAAC;IAC7B,qBAAqB,CAAC,EAAE,2BAA2B,CAAA;CAOF,GALzC,CACR,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,KAC7C,OAAO,CAAC,IAAI,CAAC,CAoBpB"}
+{"version":3,"file":"jsonTemplate.d.ts","sourceRoot":"","sources":["../src/jsonTemplate.js"],"names":[],"mappings":"AAyEG,YAAwC,QAAQ,GAAtC,MAAM,GAAC,SAAS,GAAC,WAAW,CAAU;AAoEhD,YAAgD,2BAA2B,GAAjE;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,GAAG;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAC,CAA6B;AA8Q3E,YAAuC,UAAU,GAAvC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAY;AA6EpD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAE,KAAK,EAHxB,OAAO,EAGiB,GAFtB;IAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAC,CA+BnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EARI,OAAO,EAQX,EAAE,EAAC,MAAe,EAAE,qBAAqB,EAAC,AAP9C,CAIA,EAJQ;IACN,MAAM,CAAC,EAAE,MAAM,GAAC,YAAY,CAAC;IAC7B,qBAAqB,CAAC,EAAE,2BAA2B,CAAA;CAKF,GAHzC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAC,CAiB9C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAE,CAAC,EAH/B,OAG+B,GAF7B,CAAC,IAAI,OAAO,EAAE,CAI1B;AA0KD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAVI,OAAO,EAUX,EAAE,EAAC,MAAe,EAAE,qBAAqB,EAAC,AAT9C,CAIA,EAJQ;IACN,MAAM,CAAC,EAAE,MAAM,GAAC,YAAY,CAAC;IAC7B,qBAAqB,CAAC,EAAE,2BAA2B,CAAA;CAOF,GALzC,CACR,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,KAC7C,OAAO,CAAC,IAAI,CAAC,CAoBpB"}

package/docs/API.expanded.md

@@ -138,7 +138,7 @@ A node is one of:
 | `[{$forEach: sel, $sort?: sort, $key?: name}, childNodes]` | `this.forEach(sel, cb, sort, name)` — with `$key`, binds each iteration's key (array index, or object property name for an object-wildcard `sel` like `$.*`) to `name`, readable via a bare `$name` reference |
 | `[{$variable: name, $select: sel}]` or `[{$variable: name, $value: literal}]` | `this.variable(name, sel)` / `this.variable(name, {value: literal})`, readable back later via a bare `$name` reference — `$value` embeds a literal directly in the template (e.g. a fixed collection list) rather than selecting from `data`/`params` |
 | `[{$indexedDB: {db, store, options?}, $as?: name}, childNodes?]` | fetches rows; with `$as`, binds them via `this.variable(name, {value: rows})`; without it, swaps the data context (`$`) to the rows for `childNodes` |
-| `[{$renderDefault: true}]` | `this.appendOutput(await this.renderDefault())` (an `extensions.renderDefault` your config supplies) |
+| `[{$renderDefault: true}]` or `[{$renderDefault: {...}}]` | `this.appendOutput(await this.renderDefault())` / `await this.renderDefault(argObject)` (an `extensions.renderDefault` your config supplies; the argument object, if any, is passed through unresolved, like any other extension call's) |
 | `[{$name: {...}}]` (any key not otherwise recognized above) | an extension call: `await this[name](argObject)` — the argument object is passed through entirely unresolved (no key, e.g. a conventional `select`, is interpreted by jtlt itself; the extension resolves whatever it needs via `this.get(...)`, `this.valueOf(...)`, etc.). `name` must be a key actually present in `config.extensions`; any other name throws |
 
 **Dynamic attribute values**: an element's attribute value stays a plain

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jtlt",
-  "version": "0.25.1",
+  "version": "0.26.0",
   "type": "module",
   "author": "Brett Zamir",
   "contributors": [],

package/src/jsonTemplate.js

@@ -691,7 +691,12 @@ async function runOperation (head, rest, ctx) {
     return;
   }
   if (Object.hasOwn(head, '$renderDefault')) {
-    await ctx.renderDefault();
+    // `true` (the original, argument-less form) or an argument object, handed
+    //   to the `renderDefault` extension as-is (like any extension call's
+    //   argument object, its contents are entirely up to the extension)
+    await (head.$renderDefault === true
+      ? ctx.renderDefault()
+      : ctx.renderDefault(head.$renderDefault));
     return;
   }
   if (Object.hasOwn(head, '$indexedDB')) {