@formfeed/engine 0.3.0 → 0.3.1

package/README.md

@@ -42,7 +42,8 @@ The supported surface is the `Engine` interface (`compile`, `analyze`, `render`)
 | `analysis/` | Block pairing and sample-data checks behind every `analyze()` |
 | `schema.ts` | `inferSchema(sample)` to JSON Schema 2020-12 |
 | `assemble.ts` | Template settings, print reset, `assembleDocument()` and `renderVersion()` (body, header, footer, title) |
-| `import/` | `importApitemplate()`: converts apitemplate.io templates |
+| `import/` | `importApitemplate()` and `importApitemplateFromApi()`, `importPdfmonkey()` and `importJsreport()`: convert templates of apitemplate.io, PDFMonkey and jsreport into Formfeed drafts |
+| `office/` | Word and PowerPoint templates: `renderOffice()` fills a `.docx` or `.pptx` file, `analyzeOffice()` lists its tags, variables and findings per part and paragraph, `OfficeTemplateError` carries the findings of a document that cannot be filled, and `starterDocument()` and `starterPresentation()` return example files with their sample data |
 
 ## Documentation
 

package/index.cjs

@@ -2013,6 +2013,14 @@ function installJinjaFilters(env) {
     const space = cut.lastIndexOf(" ");
     return (space >= 0 ? cut.slice(0, space) : cut) + end;
   });
+  const helperSum = lookup.getFilter("sum");
+  lookup.addFilter("sum", function(value, ...args) {
+    const named = keywordArgs(args);
+    if (!named) return helperSum.call(this, value, ...args);
+    const p = args.slice(0, -1);
+    const total = helperSum.call(this, value, p[0] ?? named["attribute"]);
+    return total + Number(p[1] ?? named["start"] ?? 0);
+  });
   const helperMap = lookup.getFilter("map");
   lookup.addFilter("map", function(value, ...args) {
     const named = keywordArgs(args);
@@ -2053,6 +2061,25 @@ function trimChars(s, chars, side) {
   if (side !== "left") while (end > start && set.has(s[end - 1] ?? "")) end--;
   return s.slice(start, end);
 }
+function isPlainObject(v) {
+  if (v === null || typeof v !== "object") return false;
+  const proto = Object.getPrototypeOf(v);
+  return proto === Object.prototype || proto === null;
+}
+function pythonRepr(v) {
+  if (v === null || v === void 0) return "None";
+  if (v === true) return "True";
+  if (v === false) return "False";
+  if (typeof v === "number") return Number.isNaN(v) ? "nan" : Number.isFinite(v) ? String(v) : v > 0 ? "inf" : "-inf";
+  if (typeof v === "string") {
+    const quote2 = v.includes("'") && !v.includes('"') ? '"' : "'";
+    const escaped = v.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+    return quote2 + (quote2 === "'" ? escaped.replace(/'/g, "\\'") : escaped) + quote2;
+  }
+  if (Array.isArray(v)) return `[${v.map(pythonRepr).join(", ")}]`;
+  if (isPlainObject(v)) return `{${Object.entries(v).map(([k, item]) => `${pythonRepr(k)}: ${pythonRepr(item)}`).join(", ")}}`;
+  return String(v);
+}
 var compatInstalled = false;
 function installCompat() {
   if (compatInstalled) return;
@@ -2077,6 +2104,8 @@ function installCompat() {
     else this.compile(node.body, frame);
     this._emitLine(");");
   };
+  const suppressValue = import_nunjucks.default.runtime.suppressValue;
+  import_nunjucks.default.runtime.suppressValue = (val2, autoescape) => suppressValue(Array.isArray(val2) || isPlainObject(val2) ? pythonRepr(val2) : val2, autoescape);
   const original = import_nunjucks.default.runtime.memberLookup;
   import_nunjucks.default.runtime.memberLookup = (obj, val2, ...rest) => {
     if (typeof obj === "string" && typeof val2 === "string" && Object.prototype.hasOwnProperty.call(stringMethods, val2)) {
@@ -4164,20 +4193,31 @@ function setInLoop(source) {
 }
 var STYLE_BLOCK = /<style\b[^>]*>([\s\S]*?)<\/style\s*>/gi;
 var HEAD_MARKUP = /<script\b[\s\S]*?<\/script\s*>|<!--[\s\S]*?-->|<(?:link|meta|base)\b[^>]*>/gi;
+var TEMPLATED = /\{\{|\{%/;
 function splitApitemplateCss(source) {
-  if (!/<\/?(style|link|script|meta|base)\b|<!--/i.test(source)) return { css: source, head: "" };
+  const styleElement = (rules) => `<style>
+${rules}
+</style>`;
+  if (!/<\/?(style|link|script|meta|base)\b|<!--/i.test(source))
+    return TEMPLATED.test(source) ? { css: "", head: "", body: styleElement(source.trim()) } : { css: source, head: "", body: "" };
   const styles = [];
   const head = [];
-  let rest = source.replace(STYLE_BLOCK, (_, body) => {
-    styles.push(body.replace(/^\n+|\s+$/g, ""));
+  const body = [];
+  let rest = source.replace(STYLE_BLOCK, (block, rules) => {
+    if (TEMPLATED.test(rules)) body.push(block.trim());
+    else styles.push(rules.replace(/^\n+|\s+$/g, ""));
     return "\n";
   });
   rest = rest.replace(HEAD_MARKUP, (tag) => {
-    head.push(tag.trim());
+    (TEMPLATED.test(tag) && !tag.startsWith("<!--") ? body : head).push(tag.trim());
     return "\n";
   });
-  const loose = rest.replace(/\n{3,}/g, "\n\n").trim();
-  return { css: [loose, ...styles].filter(Boolean).join("\n\n"), head: head.join("\n") };
+  let loose = rest.replace(/\n{3,}/g, "\n\n").trim();
+  if (TEMPLATED.test(loose)) {
+    body.unshift(styleElement(loose));
+    loose = "";
+  }
+  return { css: [loose, ...styles].filter(Boolean).join("\n\n"), head: head.join("\n"), body: body.join("\n") };
 }
 function importApitemplate(input) {
   const warnings = [];
@@ -4200,11 +4240,14 @@ function importApitemplate(input) {
   if (noSample) changes.push("no sample data: the preview stays empty and missing fields are not checked until you add some");
   const sample = parseSample(input.sample_data);
   if (sample.error) warnings.push({ code: "sample-json", message: `Sample data is not valid JSON (${sample.error}); the draft starts without sample data.`, docs: "/migrate/apitemplate-io#sample-data" });
-  const html = input.html ?? "";
   const split = splitApitemplateCss(input.css ?? "");
+  const html = split.body ? `${(input.html ?? "").trimEnd()}
+${split.body}
+` : input.html ?? "";
   let css2 = split.css;
   const head = split.head;
   if (head) changes.push("<link> and <script> tags of the CSS field moved to the Head tab, <style> contents kept as CSS");
+  if (split.body) changes.push("script and style blocks of the CSS field that use template syntax moved to the end of the template, where they are filled with the data");
   if (html.includes(HIDDEN_WRAPPER)) {
     css2 = `.${HIDDEN_WRAPPER} { display: none !important; }
 ${css2}`;
@@ -4923,7 +4966,7 @@ function mapChrome(template, kind, warnings, changes) {
   if (chrome["waitForJS"] === true || chrome["waitForJS"] === "true")
     warnings.push({
       code: "wait-for-js",
-      message: "The template sets window.JSREPORT_READY_TO_START; Formfeed waits for a CSS selector instead (Settings \u2192 Wait for).",
+      message: "The template sets window.JSREPORT_READY_TO_START; Formfeed waits for a CSS selector instead: set waitFor.selector in settings.json or in the settings of the API request.",
       docs: `${DOCS3}#settings`
     });
   if (str2("mediaType") === "screen") warnings.push({ code: "setting-ignored", message: 'mediaType "screen" is not supported; Formfeed prints with the print media type.', docs: `${DOCS3}#settings` });
@@ -5083,7 +5126,7 @@ function defaultSettings() {
     watermark: null
   };
 }
-function isPlainObject(v) {
+function isPlainObject2(v) {
   return !!v && typeof v === "object" && !Array.isArray(v);
 }
 function mergeSettings(...layers) {
@@ -5091,9 +5134,9 @@ function mergeSettings(...layers) {
   const apply = (target, source) => {
     for (const [key, value] of Object.entries(source)) {
       if (value === void 0) continue;
-      if (isPlainObject(value) && isPlainObject(target[key]))
+      if (isPlainObject2(value) && isPlainObject2(target[key]))
         apply(target[key], value);
-      else if (isPlainObject(value)) target[key] = apply({}, value);
+      else if (isPlainObject2(value)) target[key] = apply({}, value);
       else target[key] = value;
     }
     return target;
@@ -5258,7 +5301,13 @@ function paperOf(settings) {
   const h = size?.[1] ?? "297mm";
   return paper.landscape ? { width: h, height: w } : { width: w, height: h };
 }
-var pageNumberSpans = (html, page, total) => html.replace(/<span class="pageNumber"><\/span>/g, page).replace(/<span class="totalPages"><\/span>/g, total);
+var pageNumberSpans = (html, page, total) => {
+  const fill = (source, name, value) => source.replace(
+    new RegExp(`<([a-z][a-z0-9]*)(\\s[^>]*?\\bclass=(["'])(?:[^"']*\\s)?${name}(?:\\s[^"']*)?\\3[^>]*)>[^<]*</\\1>`, "gi"),
+    (_match, tag, attrs) => `<${tag}${attrs}>${value}</${tag}>`
+  );
+  return fill(fill(html, "pageNumber", page), "totalPages", total);
+};
 var inspectScript = `<script>
 document.addEventListener('click', function (event) {
   var el = event.target;
@@ -7644,8 +7693,35 @@ function normaliseTags(template, part) {
       });
     }
   }
+  const reported = /* @__PURE__ */ new Set();
+  for (const p of placeholders) {
+    const raw = template.markup[p.index]?.raw ?? "";
+    for (const m of raw.matchAll(/<w:instrText\b[^>]*>([^<]*)<\/w:instrText>/g)) {
+      const code = decodeEntities(m[1] ?? "");
+      if (!/\{\{|\{%|\{#/.test(code)) continue;
+      const paragraph2 = paragraphOf(template, placeholders, p.at);
+      if (reported.has(paragraph2)) continue;
+      reported.add(paragraph2);
+      diagnostics.push({
+        severity: "warning",
+        code: "office-tag-in-field",
+        message: `The field code ${short(code.trim())} contains a tag, which stays as typed: fields are not filled. Put the tag in the document text instead.`,
+        part,
+        paragraph: paragraph2,
+        text: short(code.trim())
+      });
+    }
+  }
   return { template: { ...template, source: applyEdits(template.source, edits) }, diagnostics };
 }
+var ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
+function decodeEntities(text) {
+  return text.replace(/&(#x[0-9a-f]+|#\d+|amp|lt|gt|quot|apos);/gi, (whole, name) => {
+    if (name[0] !== "#") return ENTITIES[name.toLowerCase()] ?? whole;
+    const code = name[1] === "x" || name[1] === "X" ? parseInt(name.slice(2), 16) : parseInt(name.slice(1), 10);
+    return Number.isFinite(code) ? String.fromCodePoint(code) : whole;
+  });
+}
 function stripPlaceholders(template) {
   const pattern = placeholderPattern(template.nonce);
   let text = "";

package/index.js

@@ -1883,6 +1883,14 @@ function installJinjaFilters(env) {
     const space = cut.lastIndexOf(" ");
     return (space >= 0 ? cut.slice(0, space) : cut) + end;
   });
+  const helperSum = lookup.getFilter("sum");
+  lookup.addFilter("sum", function(value, ...args) {
+    const named = keywordArgs(args);
+    if (!named) return helperSum.call(this, value, ...args);
+    const p = args.slice(0, -1);
+    const total = helperSum.call(this, value, p[0] ?? named["attribute"]);
+    return total + Number(p[1] ?? named["start"] ?? 0);
+  });
   const helperMap = lookup.getFilter("map");
   lookup.addFilter("map", function(value, ...args) {
     const named = keywordArgs(args);
@@ -1923,6 +1931,25 @@ function trimChars(s, chars, side) {
   if (side !== "left") while (end > start && set.has(s[end - 1] ?? "")) end--;
   return s.slice(start, end);
 }
+function isPlainObject(v) {
+  if (v === null || typeof v !== "object") return false;
+  const proto = Object.getPrototypeOf(v);
+  return proto === Object.prototype || proto === null;
+}
+function pythonRepr(v) {
+  if (v === null || v === void 0) return "None";
+  if (v === true) return "True";
+  if (v === false) return "False";
+  if (typeof v === "number") return Number.isNaN(v) ? "nan" : Number.isFinite(v) ? String(v) : v > 0 ? "inf" : "-inf";
+  if (typeof v === "string") {
+    const quote2 = v.includes("'") && !v.includes('"') ? '"' : "'";
+    const escaped = v.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+    return quote2 + (quote2 === "'" ? escaped.replace(/'/g, "\\'") : escaped) + quote2;
+  }
+  if (Array.isArray(v)) return `[${v.map(pythonRepr).join(", ")}]`;
+  if (isPlainObject(v)) return `{${Object.entries(v).map(([k, item]) => `${pythonRepr(k)}: ${pythonRepr(item)}`).join(", ")}}`;
+  return String(v);
+}
 var compatInstalled = false;
 function installCompat() {
   if (compatInstalled) return;
@@ -1947,6 +1974,8 @@ function installCompat() {
     else this.compile(node.body, frame);
     this._emitLine(");");
   };
+  const suppressValue = nunjucks.runtime.suppressValue;
+  nunjucks.runtime.suppressValue = (val2, autoescape) => suppressValue(Array.isArray(val2) || isPlainObject(val2) ? pythonRepr(val2) : val2, autoescape);
   const original = nunjucks.runtime.memberLookup;
   nunjucks.runtime.memberLookup = (obj, val2, ...rest) => {
     if (typeof obj === "string" && typeof val2 === "string" && Object.prototype.hasOwnProperty.call(stringMethods, val2)) {
@@ -4034,20 +4063,31 @@ function setInLoop(source) {
 }
 var STYLE_BLOCK = /<style\b[^>]*>([\s\S]*?)<\/style\s*>/gi;
 var HEAD_MARKUP = /<script\b[\s\S]*?<\/script\s*>|<!--[\s\S]*?-->|<(?:link|meta|base)\b[^>]*>/gi;
+var TEMPLATED = /\{\{|\{%/;
 function splitApitemplateCss(source) {
-  if (!/<\/?(style|link|script|meta|base)\b|<!--/i.test(source)) return { css: source, head: "" };
+  const styleElement = (rules) => `<style>
+${rules}
+</style>`;
+  if (!/<\/?(style|link|script|meta|base)\b|<!--/i.test(source))
+    return TEMPLATED.test(source) ? { css: "", head: "", body: styleElement(source.trim()) } : { css: source, head: "", body: "" };
   const styles = [];
   const head = [];
-  let rest = source.replace(STYLE_BLOCK, (_, body) => {
-    styles.push(body.replace(/^\n+|\s+$/g, ""));
+  const body = [];
+  let rest = source.replace(STYLE_BLOCK, (block, rules) => {
+    if (TEMPLATED.test(rules)) body.push(block.trim());
+    else styles.push(rules.replace(/^\n+|\s+$/g, ""));
     return "\n";
   });
   rest = rest.replace(HEAD_MARKUP, (tag) => {
-    head.push(tag.trim());
+    (TEMPLATED.test(tag) && !tag.startsWith("<!--") ? body : head).push(tag.trim());
     return "\n";
   });
-  const loose = rest.replace(/\n{3,}/g, "\n\n").trim();
-  return { css: [loose, ...styles].filter(Boolean).join("\n\n"), head: head.join("\n") };
+  let loose = rest.replace(/\n{3,}/g, "\n\n").trim();
+  if (TEMPLATED.test(loose)) {
+    body.unshift(styleElement(loose));
+    loose = "";
+  }
+  return { css: [loose, ...styles].filter(Boolean).join("\n\n"), head: head.join("\n"), body: body.join("\n") };
 }
 function importApitemplate(input) {
   const warnings = [];
@@ -4070,11 +4110,14 @@ function importApitemplate(input) {
   if (noSample) changes.push("no sample data: the preview stays empty and missing fields are not checked until you add some");
   const sample = parseSample(input.sample_data);
   if (sample.error) warnings.push({ code: "sample-json", message: `Sample data is not valid JSON (${sample.error}); the draft starts without sample data.`, docs: "/migrate/apitemplate-io#sample-data" });
-  const html = input.html ?? "";
   const split = splitApitemplateCss(input.css ?? "");
+  const html = split.body ? `${(input.html ?? "").trimEnd()}
+${split.body}
+` : input.html ?? "";
   let css2 = split.css;
   const head = split.head;
   if (head) changes.push("<link> and <script> tags of the CSS field moved to the Head tab, <style> contents kept as CSS");
+  if (split.body) changes.push("script and style blocks of the CSS field that use template syntax moved to the end of the template, where they are filled with the data");
   if (html.includes(HIDDEN_WRAPPER)) {
     css2 = `.${HIDDEN_WRAPPER} { display: none !important; }
 ${css2}`;
@@ -4793,7 +4836,7 @@ function mapChrome(template, kind, warnings, changes) {
   if (chrome["waitForJS"] === true || chrome["waitForJS"] === "true")
     warnings.push({
       code: "wait-for-js",
-      message: "The template sets window.JSREPORT_READY_TO_START; Formfeed waits for a CSS selector instead (Settings \u2192 Wait for).",
+      message: "The template sets window.JSREPORT_READY_TO_START; Formfeed waits for a CSS selector instead: set waitFor.selector in settings.json or in the settings of the API request.",
       docs: `${DOCS3}#settings`
     });
   if (str2("mediaType") === "screen") warnings.push({ code: "setting-ignored", message: 'mediaType "screen" is not supported; Formfeed prints with the print media type.', docs: `${DOCS3}#settings` });
@@ -4953,7 +4996,7 @@ function defaultSettings() {
     watermark: null
   };
 }
-function isPlainObject(v) {
+function isPlainObject2(v) {
   return !!v && typeof v === "object" && !Array.isArray(v);
 }
 function mergeSettings(...layers) {
@@ -4961,9 +5004,9 @@ function mergeSettings(...layers) {
   const apply = (target, source) => {
     for (const [key, value] of Object.entries(source)) {
       if (value === void 0) continue;
-      if (isPlainObject(value) && isPlainObject(target[key]))
+      if (isPlainObject2(value) && isPlainObject2(target[key]))
         apply(target[key], value);
-      else if (isPlainObject(value)) target[key] = apply({}, value);
+      else if (isPlainObject2(value)) target[key] = apply({}, value);
       else target[key] = value;
     }
     return target;
@@ -5128,7 +5171,13 @@ function paperOf(settings) {
   const h = size?.[1] ?? "297mm";
   return paper.landscape ? { width: h, height: w } : { width: w, height: h };
 }
-var pageNumberSpans = (html, page, total) => html.replace(/<span class="pageNumber"><\/span>/g, page).replace(/<span class="totalPages"><\/span>/g, total);
+var pageNumberSpans = (html, page, total) => {
+  const fill = (source, name, value) => source.replace(
+    new RegExp(`<([a-z][a-z0-9]*)(\\s[^>]*?\\bclass=(["'])(?:[^"']*\\s)?${name}(?:\\s[^"']*)?\\3[^>]*)>[^<]*</\\1>`, "gi"),
+    (_match, tag, attrs) => `<${tag}${attrs}>${value}</${tag}>`
+  );
+  return fill(fill(html, "pageNumber", page), "totalPages", total);
+};
 var inspectScript = `<script>
 document.addEventListener('click', function (event) {
   var el = event.target;
@@ -7514,8 +7563,35 @@ function normaliseTags(template, part) {
       });
     }
   }
+  const reported = /* @__PURE__ */ new Set();
+  for (const p of placeholders) {
+    const raw = template.markup[p.index]?.raw ?? "";
+    for (const m of raw.matchAll(/<w:instrText\b[^>]*>([^<]*)<\/w:instrText>/g)) {
+      const code = decodeEntities(m[1] ?? "");
+      if (!/\{\{|\{%|\{#/.test(code)) continue;
+      const paragraph2 = paragraphOf(template, placeholders, p.at);
+      if (reported.has(paragraph2)) continue;
+      reported.add(paragraph2);
+      diagnostics.push({
+        severity: "warning",
+        code: "office-tag-in-field",
+        message: `The field code ${short(code.trim())} contains a tag, which stays as typed: fields are not filled. Put the tag in the document text instead.`,
+        part,
+        paragraph: paragraph2,
+        text: short(code.trim())
+      });
+    }
+  }
   return { template: { ...template, source: applyEdits(template.source, edits) }, diagnostics };
 }
+var ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
+function decodeEntities(text) {
+  return text.replace(/&(#x[0-9a-f]+|#\d+|amp|lt|gt|quot|apos);/gi, (whole, name) => {
+    if (name[0] !== "#") return ENTITIES[name.toLowerCase()] ?? whole;
+    const code = name[1] === "x" || name[1] === "X" ? parseInt(name.slice(2), 16) : parseInt(name.slice(1), 10);
+    return Number.isFinite(code) ? String.fromCodePoint(code) : whole;
+  });
+}
 function stripPlaceholders(template) {
   const pattern = placeholderPattern(template.nonce);
   let text = "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formfeed/engine",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "The Formfeed template engine (Jinja2, Liquid, Handlebars) for the browser and Node.",
   "license": "MIT",
   "type": "module",

package/types/lib/import/apitemplate.d.cts

@@ -22,10 +22,13 @@ export interface ApitemplateExport {
  * apitemplate.io puts its CSS field into the document head as is, so it often carries `<link>`,
  * `<script>` and `<style>` tags. Formfeed wraps CSS in a `<style>` element, where such tags break
  * the stylesheet and never load: style blocks become CSS, the rest of the markup goes to the head.
+ * apitemplate.io also fills that field with the data, while Formfeed's CSS and head are static, so
+ * blocks that use template syntax (chart scripts with `{{ data }}`) go to the end of the body instead.
  */
 export declare function splitApitemplateCss(source: string): {
     css: string;
     head: string;
+    body: string;
 };
 export declare function importApitemplate(input: ApitemplateExport): ImportResult;
 /**

package/types/lib/import/apitemplate.d.ts

@@ -22,10 +22,13 @@ export interface ApitemplateExport {
  * apitemplate.io puts its CSS field into the document head as is, so it often carries `<link>`,
  * `<script>` and `<style>` tags. Formfeed wraps CSS in a `<style>` element, where such tags break
  * the stylesheet and never load: style blocks become CSS, the rest of the markup goes to the head.
+ * apitemplate.io also fills that field with the data, while Formfeed's CSS and head are static, so
+ * blocks that use template syntax (chart scripts with `{{ data }}`) go to the end of the body instead.
  */
 export declare function splitApitemplateCss(source: string): {
     css: string;
     head: string;
+    body: string;
 };
 export declare function importApitemplate(input: ApitemplateExport): ImportResult;
 /**

package/types/lib/preview.d.cts

@@ -16,7 +16,11 @@ export declare function paperOf(settings: TemplateSettings): {
     width: string;
     height: string;
 };
-/** Chromium's header/footer placeholders replaced for the screen. */
+/**
+ * Chromium's header/footer placeholders filled for the screen. Like Chromium, any element whose class
+ * list names the placeholder counts, whatever else it carries (the editor adds `data-ff-src`), and
+ * the element stays so its styling applies.
+ */
 export declare const pageNumberSpans: (html: string, page: string, total: string) => string;
 /**
  * Zoom gestures inside a preview frame: Ctrl+wheel (a touchpad pinch arrives as one too) and

package/types/lib/preview.d.ts

@@ -16,7 +16,11 @@ export declare function paperOf(settings: TemplateSettings): {
     width: string;
     height: string;
 };
-/** Chromium's header/footer placeholders replaced for the screen. */
+/**
+ * Chromium's header/footer placeholders filled for the screen. Like Chromium, any element whose class
+ * list names the placeholder counts, whatever else it carries (the editor adds `data-ff-src`), and
+ * the element stays so its styling applies.
+ */
 export declare const pageNumberSpans: (html: string, page: string, total: string) => string;
 /**
  * Zoom gestures inside a preview frame: Ctrl+wheel (a touchpad pinch arrives as one too) and

package/types/types/modules.d.cts

@@ -33,6 +33,7 @@ declare module 'nunjucks/browser/nunjucks.js' {
     Loader: typeof N.Loader;
     runtime: typeof N.runtime & {
       memberLookup: (obj: unknown, val: unknown, ...rest: unknown[]) => unknown;
+      suppressValue: (val: unknown, autoescape: boolean) => unknown;
     };
     /** The code generator; patched for `not` precedence and namespace attributes (engines/jinja2.ts). */
     compiler: {

package/types/types/modules.d.ts

@@ -33,6 +33,7 @@ declare module 'nunjucks/browser/nunjucks.js' {
     Loader: typeof N.Loader;
     runtime: typeof N.runtime & {
       memberLookup: (obj: unknown, val: unknown, ...rest: unknown[]) => unknown;
+      suppressValue: (val: unknown, autoescape: boolean) => unknown;
     };
     /** The code generator; patched for `not` precedence and namespace attributes (engines/jinja2.ts). */
     compiler: {