@formfeed/mcp 0.1.0 → 0.3.0

package/bin/formfeed-mcp.mjs

@@ -1155,16 +1155,16 @@ var require_numeric_data = __commonJS({
       return NumericData.getBitsLength(this.data.length);
     };
     NumericData.prototype.write = function write(bitBuffer) {
-      let i, group, value;
+      let i, group2, value;
       for (i = 0; i + 3 <= this.data.length; i += 3) {
-        group = this.data.substr(i, 3);
-        value = parseInt(group, 10);
+        group2 = this.data.substr(i, 3);
+        value = parseInt(group2, 10);
         bitBuffer.put(value, 10);
       }
       const remainingNum = this.data.length - i;
       if (remainingNum > 0) {
-        group = this.data.substr(i);
-        value = parseInt(group, 10);
+        group2 = this.data.substr(i);
+        value = parseInt(group2, 10);
         bitBuffer.put(value, remainingNum * 3 + 1);
       }
     };
@@ -17445,16 +17445,16 @@ var require_liquid_node = __commonJS({
         this.trimLeft = false;
         this.trimRight = false;
         const tl = input[contentBegin] === "-";
-        const tr = input[contentEnd - 1] === "-";
+        const tr2 = input[contentEnd - 1] === "-";
         let l3 = tl ? contentBegin + 1 : contentBegin;
-        let r = tr ? contentEnd - 1 : contentEnd;
+        let r = tr2 ? contentEnd - 1 : contentEnd;
         while (l3 < r && TYPES[input.charCodeAt(l3)] & BLANK)
           l3++;
         while (r > l3 && TYPES[input.charCodeAt(r - 1)] & BLANK)
           r--;
         this.contentRange = [l3, r];
         this.trimLeft = tl || trimLeft2;
-        this.trimRight = tr || trimRight2;
+        this.trimRight = tr2 || trimRight2;
       }
       get content() {
         return this.input.slice(this.contentRange[0], this.contentRange[1]);
@@ -20735,14 +20735,14 @@ var require_liquid_node = __commonJS({
       constructor(token, remainTokens, liquid) {
         super(token, remainTokens, liquid);
         this.candidates = [];
-        const group = this.tokenizer.readValue();
+        const group2 = this.tokenizer.readValue();
         this.tokenizer.skipBlank();
-        if (group) {
+        if (group2) {
           if (this.tokenizer.peek() === ":") {
-            this.group = group;
+            this.group = group2;
             this.tokenizer.advance();
           } else
-            this.candidates.push(group);
+            this.candidates.push(group2);
         }
         while (!this.tokenizer.end()) {
           const value = this.tokenizer.readValue();
@@ -20753,8 +20753,8 @@ var require_liquid_node = __commonJS({
         this.tokenizer.assert(this.candidates.length, () => `empty candidates: "${token.getText()}"`);
       }
       *render(ctx, emitter) {
-        const group = yield evalToken(this.group, ctx);
-        const fingerprint = `cycle:${group}:` + this.candidates.join(",");
+        const group2 = yield evalToken(this.group, ctx);
+        const fingerprint = `cycle:${group2}:` + this.candidates.join(",");
         const groups = ctx.getRegister("cycle", {});
         let idx = groups[fingerprint];
         if (idx === void 0) {
@@ -77456,6 +77456,11 @@ var currencyValues6 = { currency: (
   Object.keys(nl2)
 ) };
 
+// packages/engine/src/lib/helpers/office.ts
+function officeUnsupported(name) {
+  return `${name}() is not supported in office templates`;
+}
+
 // packages/engine/src/lib/helpers/format.ts
 var dateLocales = {
   de,
@@ -77738,7 +77743,8 @@ var formatHelpers = [
       example: "{{ address | nl2br }}",
       category: "text"
     },
-    fn: (_ctx, value) => escapeHtml(str(value)).replace(/\r?\n/g, "<br>\n")
+    // office templates turn line breaks into breaks themselves, and escape the text once
+    fn: (ctx, value) => ctx.mode === "office" ? str(value) : escapeHtml(str(value)).replace(/\r?\n/g, "<br>\n")
   },
   {
     name: "markdown",
@@ -77749,11 +77755,14 @@ var formatHelpers = [
       example: "{{ notes | markdown }}",
       category: "text"
     },
-    fn: (_ctx, value) => f.parse(str(value), {
-      async: false,
-      gfm: true,
-      breaks: false
-    })
+    fn: (ctx, value) => {
+      if (ctx.mode === "office") throw new Error(officeUnsupported("markdown"));
+      return f.parse(str(value), {
+        async: false,
+        gfm: true,
+        breaks: false
+      });
+    }
   },
   {
     name: "safe",
@@ -77815,7 +77824,7 @@ var formatHelpers = [
     name: "asset",
     doc: {
       signature: "asset(name)",
-      description: "URL of a workspace asset (logo, background) on the CDN.",
+      description: "URL of a file in the workspace library (logo, background) on the CDN. Upload it on the Files page or with `POST /files` and use the name it has there; relative image paths resolve against the same library.",
       example: `<img src="{{ asset('logo.png') }}">`,
       category: "document"
     },
@@ -77831,7 +77840,7 @@ var formatHelpers = [
       example: "{{ pageBreak() }}",
       category: "document"
     },
-    fn: () => '<div class="page-break" style="break-after:page"></div>'
+    fn: (ctx) => ctx.drawing ? ctx.drawing({ kind: "page-break" }) : '<div class="page-break" style="break-after:page"></div>'
   }
 ];
 
@@ -77888,7 +77897,12 @@ var codeHelpers = [
       example: '<img src="{{ qrcode(order.url, { size: 120 }) }}">',
       category: "code"
     },
-    fn: (_ctx, value, options) => svgDataUri(qrSvg(String(value ?? ""), options ?? {}))
+    fn: (ctx, value, options) => {
+      const o = options ?? {};
+      const svg = qrSvg(String(value ?? ""), o);
+      if (ctx.drawing) return ctx.drawing({ kind: "svg", svg, width: o.size, height: o.size, alt: "QR code" });
+      return svgDataUri(svg);
+    }
   },
   {
     name: "barcode",
@@ -77898,7 +77912,7 @@ var codeHelpers = [
       example: `<img src="{{ barcode(item.sku, { type: 'code128' }) }}">`,
       category: "code"
     },
-    fn: (_ctx, value, options) => {
+    fn: (ctx, value, options) => {
       const o = options ?? {};
       const bcid = barcodeTypes[String(o.type ?? "code128").toLowerCase()] ?? "code128";
       const svg = ToSVG({
@@ -77910,6 +77924,7 @@ var codeHelpers = [
         includetext: o.text !== false,
         textxalign: "center"
       });
+      if (ctx.drawing) return ctx.drawing({ kind: "svg", svg, alt: `Barcode ${String(value ?? "")}` });
       return svgDataUri(svg);
     }
   },
@@ -77926,7 +77941,7 @@ var codeHelpers = [
     // hash (`{{epcQr name=… iban=… size=200}}`), and Liquid, which cannot build an object literal,
     // keyword arguments (`{{ company.iban | epcQr: name: company.name, amount: invoice.total }}`,
     // where a string input is the IBAN). They are merged and split by field name.
-    fn: (_ctx, input, options) => {
+    fn: (ctx, input, options) => {
       const fields = {
         ...input && typeof input === "object" ? input : typeof input === "string" && input ? { iban: input } : {},
         ...options ?? {}
@@ -77935,12 +77950,10 @@ var codeHelpers = [
       const qr = {};
       for (const [key, value] of Object.entries(fields))
         (EPC_FIELDS.has(key) ? payment : qr)[key] = value;
-      return svgDataUri(
-        qrSvg(epcPayload(payment), {
-          ecc: "M",
-          ...qr
-        })
-      );
+      const o = { ecc: "M", ...qr };
+      const svg = qrSvg(epcPayload(payment), o);
+      if (ctx.drawing) return ctx.drawing({ kind: "svg", svg, width: o.size, height: o.size, alt: "GiroCode" });
+      return svgDataUri(svg);
     }
   }
 ];
@@ -78130,6 +78143,29 @@ var collectionHelpers = [
 ];
 
 // packages/engine/src/lib/helpers/document.ts
+var CHART_PALETTE = ["#3E63DD", "#12A594", "#E5484D", "#F76B15", "#8E4EC6", "#FFC53D", "#0090FF", "#978365"];
+var SLICED = /* @__PURE__ */ new Set(["pie", "doughnut", "polarArea"]);
+var colour = (value) => typeof value === "string" && value ? value : Array.isArray(value) && value.length ? value.map(String) : void 0;
+function chartDataFromPlain(spec) {
+  const type = spec.type ?? "bar";
+  const series = Array.isArray(spec.series) ? spec.series.map((s) => asObject(s)) : [{ label: spec.label, values: spec.values, color: spec.color }];
+  const labels = Array.isArray(spec.labels) ? spec.labels : [];
+  const datasets = series.map((s, index) => {
+    const data = (Array.isArray(s.values) ? s.values : []).map((v2) => {
+      const n = toNumber(v2);
+      return Number.isFinite(n) ? n : null;
+    });
+    const own = colour(s.color);
+    const fill = SLICED.has(type) ? own ?? labels.map((_2, i) => CHART_PALETTE[i % CHART_PALETTE.length]) : own ?? CHART_PALETTE[index % CHART_PALETTE.length];
+    const dataset = { data, backgroundColor: fill, borderColor: fill };
+    if (s.label !== void 0 && s.label !== null && s.label !== "") dataset["label"] = String(s.label);
+    if (type === "line") dataset["fill"] = false;
+    return dataset;
+  });
+  return { labels, datasets };
+}
+var isPlain = (spec) => spec.data === void 0 && (Array.isArray(spec.values) || Array.isArray(spec.series));
+var asObject = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
 var css = (value) => {
   if (value === void 0 || value === null || value === "") return void 0;
   const n = toNumber(value);
@@ -78139,7 +78175,13 @@ function chartPayload(spec) {
   const options = { ...spec.options ?? {} };
   options["animation"] = false;
   options["responsive"] = false;
-  return { type: spec.type ?? "bar", data: spec.data ?? {}, options };
+  if (!isPlain(spec)) return { type: spec.type ?? "bar", data: spec.data ?? {}, options };
+  const data = chartDataFromPlain(spec);
+  const unnamed = data.datasets.length === 1 && data.datasets[0]?.["label"] === void 0;
+  const plugins = asObject(options["plugins"]);
+  if (unnamed && !SLICED.has(spec.type ?? "bar") && plugins["legend"] === void 0)
+    options["plugins"] = { ...plugins, legend: { display: false } };
+  return { type: spec.type ?? "bar", data, options };
 }
 function chartMarkup(spec, id) {
   const width = toNumber(spec.width ?? 480) || 480;
@@ -78158,18 +78200,24 @@ function imageMarkup(url, options = {}) {
   const style = styles ? ` style="${styles}"` : "";
   return `<img src="${escapeHtml(url)}" alt="${escapeHtml(options.alt ?? "")}"${cls}${style}>`;
 }
-var asObject = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+function resolveAsset(base, url) {
+  if (!base || /^[a-z][a-z0-9+.-]*:/i.test(url)) return url;
+  return `${base.replace(/\/$/, "")}/${url.replace(/^\//, "")}`;
+}
 var documentHelpers = [
   {
     name: "chart",
     html: true,
     doc: {
-      signature: "chart({ type, data, options, width, height })",
-      description: "Draws a Chart.js chart (bar, line, pie, doughnut, radar, \u2026) from a chart configuration; animations are disabled so PDF and preview match.",
-      example: "{{ chart({ type: 'bar', data: sales, width: 480, height: 240 }) }}",
+      signature: "chart({ type, labels, values, label, color } | { type, labels, series } | { type, data, options }, { width, height })",
+      description: "Draws a Chart.js chart (bar, line, pie, doughnut, radar, \u2026) from plain data, `labels` with `values` or several `series` of `{ label, values, color }`, or from a full Chart.js `data` and `options`; animations are disabled so PDF and preview match.",
+      example: "{{ chart({ type: 'line', labels: ['Q1', 'Q2', 'Q3'], values: sales.quarters, width: 480 }) }}",
       category: "document"
     },
-    fn: (_ctx, spec, extra) => chartMarkup({ ...asObject(spec), ...asObject(extra) })
+    fn: (ctx, spec, extra) => {
+      if (ctx.mode === "office") throw new Error(officeUnsupported("chart"));
+      return chartMarkup({ ...asObject(spec), ...asObject(extra) });
+    }
   },
   {
     name: "image",
@@ -78180,7 +78228,12 @@ var documentHelpers = [
       example: "{{ image(product.photo, { width: 120, height: 80, fit: 'cover' }) }}",
       category: "document"
     },
-    fn: (_ctx, url, options) => imageMarkup(String(url ?? ""), asObject(options))
+    fn: (ctx, url, options) => {
+      const o = asObject(options);
+      if (ctx.drawing)
+        return ctx.drawing({ kind: "url", url: resolveAsset(ctx.assetBaseUrl, String(url ?? "")), width: o.width, height: o.height, alt: o.alt });
+      return imageMarkup(String(url ?? ""), o);
+    }
   }
 ];
 
@@ -78308,6 +78361,12 @@ function defaultHelpers() {
 // packages/engine/src/lib/engines/handlebars.ts
 var import_handlebars = __toESM(require_lib2());
 
+// packages/engine/src/lib/unavailable.ts
+var UNAVAILABLE = {};
+function unavailableHelper(name) {
+  return UNAVAILABLE[name];
+}
+
 // packages/engine/src/lib/analysis/tags.ts
 function rangeAt(line, column, length) {
   return {
@@ -78487,7 +78546,10 @@ function missingPathDiagnostics(variables, sampleData, loopSources, builtinRoots
     const root = v2.path[0];
     if (!root || builtinRoots4.has(root)) continue;
     let path = v2.path;
-    if (loopSources.has(root)) {
+    if (v2.source !== void 0) {
+      if (!v2.source) continue;
+      path = [...v2.source, ...v2.path.slice(1)];
+    } else if (loopSources.has(root)) {
       const source = loopSources.get(root);
       if (!source) continue;
       path = [...source, ...v2.path.slice(1)];
@@ -78519,6 +78581,8 @@ var builtinHelpers2 = /* @__PURE__ */ new Set([
   "helperMissing"
 ]);
 var builtinRoots = /* @__PURE__ */ new Set([
+  // the organisation's brand kit (spec 18), merged under the data
+  "brand",
   "this",
   "@index",
   "@key",
@@ -78527,6 +78591,11 @@ var builtinRoots = /* @__PURE__ */ new Set([
   "@root",
   "lookup"
 ]);
+function withBrand(data, ctx) {
+  const root = data ?? {};
+  if (!ctx.brand || typeof root !== "object" || Array.isArray(root)) return root;
+  return { brand: ctx.brand, ...root };
+}
 function createInstance(ctx) {
   const hb = import_handlebars.default.create();
   for (const [name, { fn, html }] of ctx.helpers.bind(ctx)) {
@@ -78746,6 +78815,13 @@ function analyzeHandlebars(source, opts = {}) {
         range: f2.range,
         fix: { title: `Rename to ${preferred}`, replacement: preferred }
       });
+    } else if (unavailableHelper(f2.name)) {
+      diagnostics.push({
+        severity: "warning",
+        code: "unavailable-helper",
+        message: unavailableHelper(f2.name),
+        range: f2.range
+      });
     } else if (!f2.known) {
       diagnostics.push({
         severity: "error",
@@ -78790,7 +78866,8 @@ var HandlebarsCompiled = class {
         hb,
         template: hb.compile(this.source, {
           strict: false,
-          noEscape: false,
+          // office text is escaped when its markup is restored (office/template-text.ts)
+          noEscape: ctx.mode === "office",
           preventIndent: true
         })
       };
@@ -78819,7 +78896,7 @@ var HandlebarsCompiled = class {
     };
     collect(this.source, 0);
     try {
-      const out = template(data ?? {}, {
+      const out = template(withBrand(data, ctx), {
         partials,
         allowProtoPropertiesByDefault: false,
         allowProtoMethodsByDefault: false
@@ -78854,6 +78931,151 @@ var handlebarsEngine = {
 
 // packages/engine/src/lib/engines/jinja2.ts
 var import_nunjucks = __toESM(require_nunjucks());
+
+// packages/engine/src/lib/engines/python-format.ts
+var SPEC = /^(?:([\s\S])?([<>=^]))?([+\- ])?(#)?(0)?(\d+)?([,_])?(?:\.(\d+))?([bcdeEfFgGnosxX%])?$/;
+function group(digits, separator) {
+  return digits.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+}
+function pythonExponent(text2) {
+  return text2.replace(/e([+-])(\d)$/i, (m2, sign, digit) => `${m2[0]}${sign}0${digit}`);
+}
+function formatNumber(value, type, precision, alternate) {
+  if (!Number.isFinite(value)) return Number.isNaN(value) ? "nan" : "inf";
+  const abs = Math.abs(value);
+  switch (type) {
+    case "f":
+    case "F":
+      return abs.toFixed(precision ?? 6);
+    case "%":
+      return `${(abs * 100).toFixed(precision ?? 6)}%`;
+    case "e":
+    case "E": {
+      const text2 = pythonExponent(abs.toExponential(precision ?? 6));
+      return type === "E" ? text2.toUpperCase() : text2;
+    }
+    case "g":
+    case "G": {
+      const p = precision === 0 ? 1 : precision ?? 6;
+      const exp = abs === 0 ? 0 : Math.floor(Math.log10(abs));
+      let text2 = exp < -4 || exp >= p ? pythonExponent(abs.toExponential(p - 1)) : abs.toFixed(Math.max(0, p - 1 - exp));
+      if (!alternate) {
+        const [mantissa = "", exponent] = text2.split("e");
+        const trimmed = mantissa.includes(".") ? mantissa.replace(/0+$/, "").replace(/\.$/, "") : mantissa;
+        text2 = exponent === void 0 ? trimmed : `${trimmed}e${exponent}`;
+      }
+      return type === "G" ? text2.toUpperCase() : text2;
+    }
+    case "d":
+    case "n":
+      return String(Math.trunc(abs));
+    case "b":
+      return (alternate ? "0b" : "") + Math.trunc(abs).toString(2);
+    case "o":
+      return (alternate ? "0o" : "") + Math.trunc(abs).toString(8);
+    case "x":
+      return (alternate ? "0x" : "") + Math.trunc(abs).toString(16);
+    case "X":
+      return (alternate ? "0X" : "") + Math.trunc(abs).toString(16).toUpperCase();
+    default:
+      return precision === void 0 ? String(abs) : formatNumber(abs, "g", precision, alternate);
+  }
+}
+function formatValue(value, spec) {
+  const m2 = SPEC.exec(spec);
+  if (!m2) return String(value ?? "");
+  const [, fillChar, alignChar, sign, alt, zero, widthText, grouping, precisionText, type = ""] = m2;
+  const precision = precisionText === void 0 ? void 0 : Number(precisionText);
+  const width = widthText === void 0 ? 0 : Number(widthText);
+  const numericType = /[bdeEfFgGnoxX%]/.test(type);
+  const asNumber = typeof value === "number" ? value : typeof value === "boolean" ? Number(value) : numericType && value !== null && value !== void 0 && String(value).trim() !== "" && Number.isFinite(Number(value)) ? Number(value) : void 0;
+  let body;
+  let prefix = "";
+  if (asNumber !== void 0 && type !== "s" && type !== "c") {
+    body = formatNumber(asNumber, type, precision, Boolean(alt));
+    if (grouping) {
+      const [int = "", ...rest] = body.split(".");
+      const radix = /^0[box]/i.exec(int)?.[0] ?? "";
+      body = radix + group(int.slice(radix.length), grouping) + (rest.length ? `.${rest.join(".")}` : "");
+    }
+    const negative = asNumber < 0 || Object.is(asNumber, -0);
+    prefix = negative ? "-" : sign === "+" ? "+" : sign === " " ? " " : "";
+  } else if (type === "c" && asNumber !== void 0) {
+    body = String.fromCodePoint(asNumber);
+  } else {
+    body = String(value ?? "None");
+    if (precision !== void 0 && !numericType) body = body.slice(0, precision);
+  }
+  const isNumber = asNumber !== void 0 && type !== "s";
+  const align = alignChar ?? (zero && isNumber ? "=" : isNumber ? ">" : "<");
+  const fill = fillChar ?? (zero && !alignChar ? "0" : " ");
+  const pad = Math.max(0, width - prefix.length - body.length);
+  switch (align) {
+    case "<":
+      return prefix + body + fill.repeat(pad);
+    case "^":
+      return fill.repeat(Math.floor(pad / 2)) + prefix + body + fill.repeat(Math.ceil(pad / 2));
+    case "=":
+      return prefix + fill.repeat(pad) + body;
+    default:
+      return fill.repeat(pad) + prefix + body;
+  }
+}
+function lookupField(name, positional, named, next) {
+  const [head = "", ...rest] = name.split(/(?=[.[])/);
+  let value = head === "" ? positional[next()] : /^\d+$/.test(head) ? positional[Number(head)] : named[head];
+  for (const part of rest) {
+    const key = part.startsWith("[") ? part.slice(1, -1) : part.slice(1);
+    value = value !== null && typeof value === "object" ? value[Array.isArray(value) && /^\d+$/.test(key) ? Number(key) : key] : void 0;
+  }
+  return value;
+}
+function pythonFormat(template, positional, named = {}) {
+  let auto = 0;
+  const next = () => auto++;
+  const render = (text2) => {
+    let out = "";
+    for (let i = 0; i < text2.length; i++) {
+      const ch = text2[i];
+      if (ch === "}") {
+        out += "}";
+        if (text2[i + 1] === "}") i++;
+        continue;
+      }
+      if (ch !== "{") {
+        out += ch;
+        continue;
+      }
+      if (text2[i + 1] === "{") {
+        out += "{";
+        i++;
+        continue;
+      }
+      let depth = 1;
+      let j2 = i + 1;
+      for (; j2 < text2.length && depth > 0; j2++) {
+        if (text2[j2] === "{") depth++;
+        else if (text2[j2] === "}") depth--;
+      }
+      if (depth > 0) {
+        out += text2.slice(i);
+        break;
+      }
+      const field = text2.slice(i + 1, j2 - 1);
+      const colon = field.indexOf(":");
+      const head = colon < 0 ? field : field.slice(0, colon);
+      const name = head.replace(/![rsa]$/, "");
+      const value = lookupField(name, positional, named, next);
+      const spec = colon < 0 ? "" : render(field.slice(colon + 1));
+      out += value === void 0 ? "" : formatValue(value, spec);
+      i = j2 - 1;
+    }
+    return out;
+  };
+  return render(template);
+}
+
+// packages/engine/src/lib/engines/jinja2.ts
 var nunjucksBuiltinFilters = /* @__PURE__ */ new Set([
   "abs",
   "batch",
@@ -78899,6 +79121,7 @@ var nunjucksBuiltinFilters = /* @__PURE__ */ new Set([
   "urlize",
   "wordcount"
 ]);
+var jinjaLiterals = /* @__PURE__ */ new Set(["True", "False", "None"]);
 var builtinRoots2 = /* @__PURE__ */ new Set([
   "loop",
   "caller",
@@ -78908,7 +79131,14 @@ var builtinRoots2 = /* @__PURE__ */ new Set([
   "joiner",
   "lipsum",
   "varargs",
-  "kwargs"
+  "kwargs",
+  "namespace",
+  // the organisation's brand kit (spec 18), a global beside the data
+  "brand",
+  // Jinja2's spelling of the literals, which the compat layer resolves at runtime
+  "True",
+  "False",
+  "None"
 ]);
 var stringMethods = {
   upper: (s) => s.toUpperCase(),
@@ -78937,12 +79167,8 @@ var stringMethods = {
   split: (s, sep, max) => sep === void 0 || sep === null ? s.trim().split(/\s+/) : s.split(String(sep), max === void 0 ? void 0 : Number(max) + 1),
   join: (s, list2) => Array.isArray(list2) ? list2.join(s) : String(list2),
   format: (s, ...args2) => {
-    let i = 0;
-    const named = args2.at(-1) && typeof args2.at(-1) === "object" ? args2.at(-1) : {};
-    return s.replace(
-      /\{(\w*)\}/g,
-      (_2, key) => String(key ? named[key] ?? "" : args2[i++] ?? "")
-    );
+    const named = keywordArgs(args2);
+    return pythonFormat(s, named ? args2.slice(0, -1) : args2, named ?? {});
   },
   zfill: (s, width) => s.padStart(Number(width), "0"),
   count: (s, sub) => s.split(String(sub)).length - 1,
@@ -78957,6 +79183,92 @@ var stringMethods = {
     return f2.repeat(left) + s + f2.repeat(total - left);
   }
 };
+function keywordArgs(args2) {
+  const last = args2.at(-1);
+  if (!last || typeof last !== "object" || !Object.prototype.hasOwnProperty.call(last, "__keywords")) return void 0;
+  const { __keywords: _marker, ...named } = last;
+  return named;
+}
+var JinjaNamespace = class {
+};
+function namespace(...args2) {
+  const ns = new JinjaNamespace();
+  const named = keywordArgs(args2);
+  for (const arg of named ? [...args2.slice(0, -1), named] : args2)
+    if (arg && typeof arg === "object") Object.assign(ns, arg);
+  return ns;
+}
+function setNamespaceAttribute(target, key, value) {
+  if (!(target instanceof JinjaNamespace)) throw new Error("Cannot assign attribute on non-namespace object");
+  target[String(key)] = value;
+}
+var toList = (v2) => Array.isArray(v2) ? v2 : v2 === void 0 || v2 === null ? [] : typeof v2 === "string" ? [...v2] : [v2];
+var attributeOf = (item, path) => String(path ?? "").split(".").reduce((acc, key) => acc !== null && typeof acc === "object" ? acc[key] : void 0, item);
+var jinjaTests = {
+  none: (v2) => v2 === null,
+  true: (v2) => v2 === true,
+  false: (v2) => v2 === false,
+  in: (v2, container) => typeof container === "string" ? container.includes(String(v2)) : Array.isArray(container) ? container.includes(v2) : !!container && typeof container === "object" && String(v2) in container,
+  "==": (v2, a) => v2 === a,
+  "!=": (v2, a) => v2 !== a,
+  ">": (v2, a) => v2 > a,
+  ">=": (v2, a) => v2 >= a,
+  "<": (v2, a) => v2 < a,
+  "<=": (v2, a) => v2 <= a
+};
+function runTest(self2, name, value, arg) {
+  const own = jinjaTests[name];
+  if (own) return own(value, arg);
+  return self2.env.getTest(name).call(self2, value, arg) === true;
+}
+function installJinjaFilters(env) {
+  const lookup = env;
+  const helperTruncate = lookup.getFilter("truncate");
+  lookup.addFilter("truncate", function(value, ...args2) {
+    const named = keywordArgs(args2);
+    const p = named ? args2.slice(0, -1) : args2;
+    if (!named && typeof p[1] !== "boolean" && p.length < 3) return helperTruncate.call(this, value, ...args2);
+    const s = String(value ?? "");
+    const length = Number(p[0] ?? named?.["length"] ?? 255);
+    const killwords = Boolean(p[1] ?? named?.["killwords"] ?? false);
+    const end = String(p[2] ?? named?.["end"] ?? "...");
+    const leeway = Number(p[3] ?? named?.["leeway"] ?? 5);
+    if (s.length <= length + leeway) return s;
+    const cut = s.slice(0, Math.max(0, length - end.length));
+    if (killwords) return cut + end;
+    const space = cut.lastIndexOf(" ");
+    return (space >= 0 ? cut.slice(0, space) : cut) + end;
+  });
+  const helperMap = lookup.getFilter("map");
+  lookup.addFilter("map", function(value, ...args2) {
+    const named = keywordArgs(args2);
+    const p = named ? args2.slice(0, -1) : args2;
+    if (named && "attribute" in named)
+      return toList(value).map((item) => {
+        const v2 = attributeOf(item, named["attribute"]);
+        return v2 === void 0 && "default" in named ? named["default"] : v2;
+      });
+    const items = toList(value);
+    if (typeof p[0] === "string" && !items.some((item) => item !== null && typeof item === "object")) {
+      let filter;
+      try {
+        filter = lookup.getFilter(p[0]);
+      } catch {
+        filter = void 0;
+      }
+      if (filter) return items.map((item) => filter.call(this, item, ...p.slice(1)));
+    }
+    return helperMap.call(this, value, ...args2);
+  });
+  const byAttribute = (keep) => function(value, attribute, test, arg) {
+    return toList(value).filter((item) => {
+      const v2 = attributeOf(item, attribute);
+      return (test === void 0 ? Boolean(v2) : runTest(this, String(test), v2, arg)) === keep;
+    });
+  };
+  lookup.addFilter("selectattr", byAttribute(true));
+  lookup.addFilter("rejectattr", byAttribute(false));
+}
 function trimChars(s, chars, side) {
   if (chars === void 0 || chars === null)
     return side === "both" ? s.trim() : side === "left" ? s.trimStart() : s.trimEnd();
@@ -78977,6 +79289,20 @@ function installCompat() {
     this.compile(node.target, frame);
     this._emit(")");
   };
+  const compileSet = import_nunjucks.default.compiler.Compiler.prototype.compileSet;
+  import_nunjucks.default.runtime["formfeedSetAttribute"] = setNamespaceAttribute;
+  import_nunjucks.default.compiler.Compiler.prototype.compileSet = function(node, frame) {
+    const [target, ...more] = node.targets;
+    if (!target || more.length || target.typename !== "LookupVal") return compileSet.call(this, node, frame);
+    this._emit("runtime.formfeedSetAttribute(");
+    this._compileExpression(target["target"], frame);
+    this._emit(", ");
+    this._compileExpression(target["val"], frame);
+    this._emit(", ");
+    if (node.value) this._compileExpression(node.value, frame);
+    else this.compile(node.body, frame);
+    this._emitLine(");");
+  };
   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)) {
@@ -79009,7 +79335,8 @@ function createEnvironment(ctx) {
   const env = new import_nunjucks.default.Environment(
     new PartialLoader(ctx.partials),
     {
-      autoescape: true,
+      // office text is escaped when its markup is restored, so escaping here would double it
+      autoescape: ctx.mode !== "office",
       throwOnUndefined: false,
       trimBlocks: false,
       lstripBlocks: false
@@ -79023,6 +79350,9 @@ function createEnvironment(ctx) {
     env.addFilter(name, wrapped);
     env.addGlobal(name, wrapped);
   }
+  env.addGlobal("namespace", namespace);
+  if (ctx.brand) env.addGlobal("brand", ctx.brand);
+  installJinjaFilters(env);
   return env;
 }
 var validationContext2 = {
@@ -79063,18 +79393,28 @@ function pathOf(node) {
 function inScope(w, name) {
   return w.scopes.some((s) => s.has(name));
 }
+function sourceOf(w, name) {
+  for (let i = w.scopes.length - 1; i >= 0; i--) {
+    const scope = w.scopes[i];
+    if (scope?.has(name)) return scope.get(name) ?? null;
+  }
+  return null;
+}
 function walk2(node, w) {
   if (!node || typeof node !== "object") return;
   switch (node.typename) {
     case "Symbol":
     case "LookupVal": {
       const p = pathOf(node);
+      if (node.typename === "Symbol" && jinjaLiterals.has(String(node.value))) return;
       if (p) {
         const root = p.path[0] ?? "";
+        const bound = inScope(w, root);
         w.variables.push({
           path: p.path,
           range: nodeRange(p.root, p.path.join(".").length),
-          kind: inScope(w, root) ? "loop-var" : "read"
+          kind: bound ? "loop-var" : "read",
+          ...bound ? { source: sourceOf(w, root) } : {}
         });
       }
       if (node.typename === "LookupVal" && !p) {
@@ -79120,18 +79460,18 @@ function walk2(node, w) {
       const source = pathOf(arr);
       const nameNode = node["name"];
       const names = nameNode.typename === "Array" ? nameNode.children ?? [] : [nameNode];
-      const scope = /* @__PURE__ */ new Set();
+      const root = source?.path[0] ?? "";
+      const items = !source ? null : inScope(w, root) ? ((s) => s ? [...s, ...source.path.slice(1)] : null)(sourceOf(w, root)) : source.path;
+      const scope = /* @__PURE__ */ new Map();
       for (const n of names) {
         const name = String(n.value);
-        scope.add(name);
-        w.loopSources.set(
-          name,
-          names.length === 1 && source && !inScope(w, source.path[0] ?? "") ? source.path : names.length === 1 && source ? resolveLoopSource(w, source.path) : null
-        );
+        const bound = names.length === 1 ? items : null;
+        scope.set(name, bound);
         w.variables.push({
           path: [name],
           range: nodeRange(n, name.length),
-          kind: "loop-var"
+          kind: "loop-var",
+          source: bound
         });
       }
       w.scopes.push(scope);
@@ -79149,8 +79489,7 @@ function walk2(node, w) {
             range: nodeRange(p.root, p.path.join(".").length),
             kind: "assigned"
           });
-          w.scopes[0]?.add(p.path[0] ?? "");
-          w.loopSources.set(p.path[0] ?? "", null);
+          if (p.path.length === 1 || !inScope(w, p.path[0] ?? "")) w.scopes[0]?.set(p.path[0] ?? "", null);
         }
       }
       walk2(node["value"], w);
@@ -79159,17 +79498,27 @@ function walk2(node, w) {
     }
     case "Macro": {
       const args2 = node["args"];
-      const scope = /* @__PURE__ */ new Set();
-      for (const child of args2.children ?? [])
-        if (child.typename === "Symbol") scope.add(String(child.value));
+      const scope = /* @__PURE__ */ new Map();
+      for (const child of args2.children ?? []) {
+        if (child.typename === "Symbol") scope.set(String(child.value), null);
+        if (child.typename === "KeywordArgs")
+          for (const pair of child.children ?? []) {
+            const key = pair["key"];
+            if (key) scope.set(String(key.value), null);
+            walk2(pair["value"], w);
+          }
+      }
       const nameNode = node["name"];
-      w.scopes[0]?.add(String(nameNode.value));
-      w.loopSources.set(String(nameNode.value), null);
+      w.scopes[0]?.set(String(nameNode.value), null);
       w.scopes.push(scope);
       walk2(node["body"], w);
       w.scopes.pop();
       return;
     }
+    case "Pair": {
+      walk2(node["value"], w);
+      return;
+    }
     case "Include":
     case "Extends":
     case "Import":
@@ -79182,15 +79531,17 @@ function walk2(node, w) {
         });
       else walk2(tpl, w);
       if (node.typename === "Import")
-        w.scopes[0]?.add(
-          String(node["target"]?.value ?? "")
+        w.scopes[0]?.set(
+          String(node["target"]?.value ?? ""),
+          null
         );
       if (node.typename === "FromImport")
         for (const n of node["names"].children ?? [])
-          w.scopes[0]?.add(
+          w.scopes[0]?.set(
             String(
               n.typename === "Pair" ? n["value"].value : n.value
-            )
+            ),
+            null
           );
       return;
     }
@@ -79208,12 +79559,6 @@ function walk2(node, w) {
       walk2(value, w);
   }
 }
-function resolveLoopSource(w, path) {
-  const root = path[0] ?? "";
-  if (!w.loopSources.has(root)) return path;
-  const source = w.loopSources.get(root);
-  return source ? [...source, ...path.slice(1)] : null;
-}
 function analyzeJinja2(source, opts = {}) {
   const helpers = opts.helpers ?? defaultHelpers();
   const { blocks, diagnostics } = scanBlocks(source, jinjaTags);
@@ -79221,8 +79566,7 @@ function analyzeJinja2(source, opts = {}) {
     variables: [],
     filters: [],
     includes: [],
-    loopSources: /* @__PURE__ */ new Map(),
-    scopes: [/* @__PURE__ */ new Set()],
+    scopes: [/* @__PURE__ */ new Map()],
     helpers
   };
   try {
@@ -79251,6 +79595,13 @@ function analyzeJinja2(source, opts = {}) {
         range: f2.range,
         fix: { title: `Rename to ${preferred}`, replacement: preferred }
       });
+    } else if (unavailableHelper(f2.name)) {
+      diagnostics.push({
+        severity: "warning",
+        code: "unavailable-helper",
+        message: unavailableHelper(f2.name),
+        range: f2.range
+      });
     } else if (!f2.known) {
       diagnostics.push({
         severity: "error",
@@ -79264,7 +79615,7 @@ function analyzeJinja2(source, opts = {}) {
   const dataDiagnostics = missingPathDiagnostics(
     w.variables,
     opts.sampleData,
-    w.loopSources,
+    /* @__PURE__ */ new Map(),
     builtin
   );
   return {
@@ -79397,6 +79748,10 @@ var liquidBuiltinFilters = /* @__PURE__ */ new Set([
   "url_decode",
   "url_encode",
   "where",
+  "where_exp",
+  "find_exp",
+  "reject_exp",
+  "group_by_exp",
   "raw",
   "sum",
   "group_by",
@@ -79418,6 +79773,8 @@ var liquidBuiltinFilters = /* @__PURE__ */ new Set([
   "time_zone"
 ]);
 var builtinRoots3 = /* @__PURE__ */ new Set([
+  // the organisation's brand kit (spec 18), a global beside the data
+  "brand",
   "forloop",
   "tablerowloop",
   "true",
@@ -79483,6 +79840,8 @@ function createLiquid(ctx) {
     extname: "",
     root: [""],
     fs: partialFs(ctx.partials),
+    // scope data shadows globals, so `data.brand` still wins
+    globals: ctx.brand ? { brand: ctx.brand } : {},
     renderLimit: ctx.limits.ms,
     memoryLimit: ctx.limits.outputBytes * 4,
     parseLimit: 2e6
@@ -79651,6 +80010,13 @@ function analyzeLiquid(source, opts = {}) {
         range: f2.range,
         fix: { title: `Rename to ${preferred}`, replacement: preferred }
       });
+    } else if (unavailableHelper(f2.name)) {
+      diagnostics.push({
+        severity: "warning",
+        code: "unavailable-helper",
+        message: unavailableHelper(f2.name),
+        range: f2.range
+      });
     } else if (!f2.known) {
       diagnostics.push({
         severity: "error",
@@ -79746,6 +80112,26 @@ function getEngine(id) {
   return engine;
 }
 
+// packages/engine/src/lib/schema-diff.ts
+var LOWER_BOUNDS = ["minimum", "exclusiveMinimum", "minLength", "minItems", "minProperties"];
+var UPPER_BOUNDS = ["maximum", "exclusiveMaximum", "maxLength", "maxItems", "maxProperties"];
+var ANALYSED = /* @__PURE__ */ new Set([
+  "type",
+  "properties",
+  "required",
+  "additionalProperties",
+  "items",
+  "enum",
+  "const",
+  "format",
+  "pattern",
+  "$ref",
+  "$defs",
+  "definitions",
+  ...LOWER_BOUNDS,
+  ...UPPER_BOUNDS
+]);
+
 // packages/engine/src/lib/schema.ts
 var isoDateTime = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/;
 var isoDate = /^\d{4}-\d{2}-\d{2}$/;
@@ -79836,9 +80222,12 @@ function inferSchema(sample) {
   };
 }
 
+// packages/engine/src/lib/output.ts
+var outputFormats = ["pdf", "png", "jpg", "webp", "docx", "pptx"];
+
 // packages/engine/src/lib/snippets.ts
 var loop = (engine, item, list2, body) => engine === "handlebars" ? `{{#each ${list2}}}
-${body.replace(/\{\{ item\./g, "{{ ")}
+${body.replace(new RegExp(`(?<![\\w.])${item}\\.`, "g"), "")}
 {{/each}}` : `{% for ${item} in ${list2} %}
 ${body}
 {% endfor %}`;
@@ -79848,6 +80237,15 @@ var val = (engine, expr, filter) => {
     return `{{${filter.split("(")[0]} ${expr}${filter.includes("(") ? " " + filter.slice(filter.indexOf("(") + 1, -1) : ""}}}`;
   return engine === "liquid" ? `{{ ${expr} | ${filter.replace("(", ": ").replace(")", "")} }}` : `{{ ${expr} | ${filter} }}`;
 };
+var ifElse = (engine, cond, then, otherwise) => engine === "handlebars" ? `{{#if ${cond}}}${then}{{else}}${otherwise}{{/if}}` : `{% if ${cond} %}${then}{% else %}${otherwise}{% endif %}`;
+var tr = (engine, key, params = {}) => {
+  const entries = Object.entries(params);
+  if (engine === "handlebars")
+    return `{{t '${key}'${entries.map(([k2, v2]) => ` ${k2}=${v2}`).join("")}}}`;
+  if (engine === "liquid")
+    return `{{ '${key}' | t${entries.length ? ": " + entries.map(([k2, v2]) => `${k2}: ${v2}`).join(", ") : ""} }}`;
+  return `{{ t('${key}'${entries.length ? `, { ${entries.map(([k2, v2]) => `${k2}: ${v2}`).join(", ")} }` : ""}) }}`;
+};
 function forAll(build) {
   return {
     jinja2: build("jinja2"),
@@ -79855,14 +80253,101 @@ function forAll(build) {
     handlebars: build("handlebars")
   };
 }
+var rule = "var(--brand-color-primary, #222)";
 var snippets = [
+  {
+    id: "letterhead",
+    group: "letter",
+    title: "Letterhead",
+    description: "Logo from the brand kit, or the organisation name when no logo is set.",
+    source: forAll(
+      (e) => `<header class="ff-letterhead">
+  ${ifElse(e, "brand.logo.primary", `<img class="logo" src="${val(e, "brand.logo.primary")}" alt="${val(e, "brand.name")}">`, `<strong class="name">${val(e, "brand.name")}</strong>`)}
+</header>$0`
+    ),
+    css: `.ff-letterhead { display: flex; justify-content: flex-end; align-items: center; min-height: 48px; margin-bottom: 24px; padding-bottom: 8px; border-bottom: 2px solid ${rule}; }
+.ff-letterhead .logo { max-height: 56px; max-width: 200px; }
+.ff-letterhead .name { font-family: var(--brand-font-heading, inherit); font-size: 18pt; color: var(--brand-color-primary, inherit); }`
+  },
+  {
+    id: "window-address",
+    group: "letter",
+    kinds: ["pdf"],
+    title: "Window envelope address",
+    description: "Return address and recipient in the 85 \xD7 45 mm field of a DIN 5008 window envelope.",
+    source: forAll(
+      (e) => `<div class="ff-window">
+  <div class="sender">${val(e, "company.name")} \xB7 ${val(e, "company.street")} \xB7 ${val(e, "company.zip")} ${val(e, "company.city")}</div>
+  <address>
+    <strong>${val(e, "customer.name")}</strong><br>
+    ${val(e, "customer.street")}<br>
+    ${val(e, "customer.zip")} ${val(e, "customer.city")}
+  </address>
+</div>$0`
+    ),
+    sampleData: {
+      company: { name: "Fennlor Studio GmbH", street: "Musterstra\xDFe 1", zip: "12345", city: "Musterstadt" },
+      customer: { name: "Olvarest GmbH", street: "Beispielweg 2", zip: "54321", city: "Beispielstadt" }
+    },
+    // Form B puts the field 45 mm below the top edge and 20 mm from the left; the page margins decide where it lands
+    css: `.ff-window { width: 85mm; height: 45mm; box-sizing: border-box; padding: 0 5mm; overflow: hidden; }
+.ff-window .sender { height: 5mm; line-height: 5mm; margin-bottom: 3mm; font-size: 7pt; color: #555; border-bottom: 0.5pt solid #999; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.ff-window address { font-style: normal; font-size: 10pt; line-height: 1.35; }`
+  },
+  {
+    id: "reference-block",
+    group: "letter",
+    title: "Reference block",
+    description: "Customer number, invoice number and date as a right-aligned table; put it in a two-column layout to sit beside the address.",
+    source: forAll(
+      (e) => `<table class="ff-reference">
+  <tr><th>${tr(e, "reference.customer")}</th><td>${val(e, "customer.number")}</td></tr>
+  <tr><th>${tr(e, "reference.invoice")}</th><td>${val(e, "invoice.number")}</td></tr>
+  <tr><th>${tr(e, "reference.date")}</th><td>${val(e, "invoice.date", "date('P')")}</td></tr>
+</table>$0`
+    ),
+    sampleData: {
+      customer: { number: "K-1042" },
+      invoice: { number: "2026-0042", date: "2026-09-13" }
+    },
+    css: `.ff-reference { margin-left: auto; border-collapse: collapse; font-size: 9pt; }
+.ff-reference th { text-align: left; font-weight: normal; color: #555; padding: 1px 12px 1px 0; }
+.ff-reference td { text-align: right; padding: 1px 0; }`,
+    i18n: {
+      en: { "reference.customer": "Customer no.", "reference.invoice": "Invoice no.", "reference.date": "Date" },
+      de: { "reference.customer": "Kundennummer", "reference.invoice": "Rechnungsnummer", "reference.date": "Datum" }
+    }
+  },
+  {
+    id: "invoice-heading",
+    group: "invoice",
+    title: "Invoice heading",
+    description: "Invoice number as the title and the service period below it.",
+    source: forAll(
+      (e) => `<div class="ff-heading">
+  <h1>${tr(e, "heading.title", { number: "invoice.number" })}</h1>
+  <p>${tr(e, "heading.period")} ${val(e, "invoice.period_start", "date('P')")} \u2013 ${val(e, "invoice.period_end", "date('P')")}</p>
+</div>$0`
+    ),
+    sampleData: {
+      invoice: { number: "2026-0042", period_start: "2026-09-01", period_end: "2026-09-30" }
+    },
+    css: `.ff-heading { margin: 24px 0 16px; }
+.ff-heading h1 { font-family: var(--brand-font-heading, inherit); font-size: 18pt; color: var(--brand-color-primary, inherit); margin: 0 0 4px; }
+.ff-heading p { margin: 0; color: #555; }`,
+    i18n: {
+      en: { "heading.title": "Invoice {number}", "heading.period": "Service period:" },
+      de: { "heading.title": "Rechnung {number}", "heading.period": "Leistungszeitraum:" }
+    }
+  },
   {
     id: "invoice-table",
+    group: "invoice",
     title: "Invoice table",
     description: "Line items with description, quantity, unit price and line total.",
     source: forAll(
       (e) => `<table class="ff-lines">
-  <thead><tr><th>Description</th><th class="num">Qty</th><th class="num">Unit price</th><th class="num">Total</th></tr></thead>
+  <thead><tr><th>${tr(e, "lines.description")}</th><th class="num">${tr(e, "lines.qty")}</th><th class="num">${tr(e, "lines.price")}</th><th class="num">${tr(e, "lines.total")}</th></tr></thead>
   <tbody>
 ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</td><td class="num">${val(e, "line.qty", "number(0)")}</td><td class="num">${val(e, "line.price", "money")}</td><td class="num">${val(e, "line.total", "money")}</td></tr>`)}
   </tbody>
@@ -79879,17 +80364,32 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
     css: `.ff-lines { width: 100%; border-collapse: collapse; font-size: 10pt; }
 .ff-lines th, .ff-lines td { padding: 6px 8px; border-bottom: 1px solid #ddd; text-align: left; }
 .ff-lines .num { text-align: right; white-space: nowrap; }
-.ff-lines thead th { border-bottom: 2px solid #222; }`
+.ff-lines thead th { border-bottom: 2px solid ${rule}; }`,
+    i18n: {
+      en: {
+        "lines.description": "Description",
+        "lines.qty": "Qty",
+        "lines.price": "Unit price",
+        "lines.total": "Total"
+      },
+      de: {
+        "lines.description": "Beschreibung",
+        "lines.qty": "Menge",
+        "lines.price": "Einzelpreis",
+        "lines.total": "Gesamt"
+      }
+    }
   },
   {
     id: "totals",
+    group: "invoice",
     title: "Totals block",
     description: "Net, VAT and gross totals right-aligned under a table.",
     source: forAll(
       (e) => `<table class="ff-totals">
-  <tr><td>Net</td><td class="num">${val(e, "invoice.net", "money")}</td></tr>
-  <tr><td>VAT ${val(e, "invoice.vat_rate")} %</td><td class="num">${val(e, "invoice.vat", "money")}</td></tr>
-  <tr class="grand"><td>Total</td><td class="num">${val(e, "invoice.total", "money")}</td></tr>
+  <tr><td>${tr(e, "totals.net")}</td><td class="num">${val(e, "invoice.net", "money")}</td></tr>
+  <tr><td>${tr(e, "totals.vat", { rate: "invoice.vat_rate" })}</td><td class="num">${val(e, "invoice.vat", "money")}</td></tr>
+  <tr class="grand"><td>${tr(e, "totals.total")}</td><td class="num">${val(e, "invoice.total", "money")}</td></tr>
 </table>$0`
     ),
     sampleData: {
@@ -79898,10 +80398,103 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
     css: `.ff-totals { margin-left: auto; margin-top: 12px; border-collapse: collapse; font-size: 10pt; }
 .ff-totals td { padding: 4px 8px; }
 .ff-totals .num { text-align: right; min-width: 90px; }
-.ff-totals .grand td { border-top: 2px solid #222; font-weight: 600; }`
+.ff-totals .grand td { border-top: 2px solid ${rule}; font-weight: 600; }`,
+    i18n: {
+      en: {
+        "totals.net": "Net",
+        "totals.vat": "VAT {rate} %",
+        "totals.total": "Total"
+      },
+      de: {
+        "totals.net": "Netto",
+        "totals.vat": "USt. {rate} %",
+        "totals.total": "Gesamtbetrag"
+      }
+    }
+  },
+  {
+    id: "payment-terms",
+    group: "invoice",
+    title: "Payment terms and bank details",
+    description: "Amount, due date and the account to transfer it to.",
+    source: forAll(
+      (e) => `<div class="ff-payment">
+  <p>${tr(e, "payment.transfer")} <strong>${val(e, "payment.amount", "money")}</strong> ${tr(e, "payment.until")} <strong>${val(e, "invoice.due_date", "date('P')")}</strong> ${tr(e, "payment.account")}</p>
+  <table>
+    <tr><th>${tr(e, "payment.holder")}</th><td>${val(e, "payment.name")}</td></tr>
+    <tr><th>IBAN</th><td>${val(e, "payment.iban")}</td></tr>
+    <tr><th>BIC</th><td>${val(e, "payment.bic")}</td></tr>
+    <tr><th>${tr(e, "payment.reference")}</th><td>${val(e, "payment.reference")}</td></tr>
+  </table>
+</div>$0`
+    ),
+    sampleData: {
+      invoice: { due_date: "2026-10-13" },
+      payment: {
+        name: "Fennlor Studio GmbH",
+        iban: "DE00000000000000000000",
+        bic: "XXXXDEXXXXX",
+        amount: 3760.4,
+        reference: "2026-0042"
+      }
+    },
+    css: `.ff-payment { margin-top: 16px; font-size: 9.5pt; break-inside: avoid; }
+.ff-payment p { margin: 0 0 6px; }
+.ff-payment table { border-collapse: collapse; }
+.ff-payment th { text-align: left; font-weight: normal; color: #555; padding: 1px 16px 1px 0; }`,
+    i18n: {
+      en: {
+        "payment.transfer": "Please transfer",
+        "payment.until": "by",
+        "payment.account": "to the following account:",
+        "payment.holder": "Account holder",
+        "payment.reference": "Reference"
+      },
+      de: {
+        "payment.transfer": "Bitte \xFCberweisen Sie",
+        "payment.until": "bis zum",
+        "payment.account": "auf folgendes Konto:",
+        "payment.holder": "Kontoinhaber",
+        "payment.reference": "Verwendungszweck"
+      }
+    }
+  },
+  {
+    id: "small-business-note",
+    group: "invoice",
+    title: "Small business VAT note",
+    description: "States that no VAT is charged under \xA7 19 UStG (Kleinunternehmerregelung).",
+    source: forAll((e) => `<p class="ff-note">${tr(e, "vat.small_business")}</p>$0`),
+    css: `.ff-note { margin-top: 12px; font-size: 9pt; color: #444; }`,
+    i18n: {
+      en: { "vat.small_business": "No VAT is charged under the small business scheme of \xA7 19 UStG." },
+      de: { "vat.small_business": "Gem\xE4\xDF \xA7 19 UStG wird keine Umsatzsteuer berechnet." }
+    }
+  },
+  {
+    id: "reverse-charge-note",
+    group: "invoice",
+    title: "Reverse charge note",
+    description: "EU business customers: the recipient owes the VAT, with their VAT ID.",
+    source: forAll(
+      (e) => `<p class="ff-note">${tr(e, "vat.reverse_charge")} ${tr(e, "vat.customer_id")} ${val(e, "customer.vat_id")}</p>$0`
+    ),
+    sampleData: { customer: { vat_id: "ATU00000000" } },
+    css: `.ff-note { margin-top: 12px; font-size: 9pt; color: #444; }`,
+    i18n: {
+      en: {
+        "vat.reverse_charge": "Reverse charge: the recipient of the service is liable for VAT.",
+        "vat.customer_id": "Customer VAT ID:"
+      },
+      de: {
+        "vat.reverse_charge": "Steuerschuldnerschaft des Leistungsempf\xE4ngers.",
+        "vat.customer_id": "USt-IdNr. des Leistungsempf\xE4ngers:"
+      }
+    }
   },
   {
     id: "address-block",
+    group: "letter",
     title: "Address block",
     description: "Recipient name and postal address lines.",
     source: forAll(
@@ -79914,10 +80507,10 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
     ),
     sampleData: {
       customer: {
-        name: "Muster GmbH",
-        street: "Musterstra\xDFe 1",
-        zip: "10115",
-        city: "Berlin",
+        name: "Olvarest GmbH",
+        street: "Beispielweg 2",
+        zip: "54321",
+        city: "Beispielstadt",
         country: "Deutschland"
       }
     },
@@ -79925,18 +80518,38 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
   },
   {
     id: "page-footer",
+    group: "page",
+    kinds: ["pdf"],
     title: "Footer with page numbers",
-    description: "Paste into the Footer tab: company line and \u201CPage x of y\u201D.",
+    description: "Company line and \u201CPage x of y\u201D in the page footer.",
+    target: "footer",
     source: forAll(
       (e) => `<div style="width:100%;display:flex;justify-content:space-between;font-size:9px;color:#666">
   <span>${val(e, "company.name")} \xB7 ${val(e, "company.email")}</span>
-  <span>Page <span class="pageNumber"></span> of <span class="totalPages"></span></span>
+  <span>${tr(e, "footer.page")} <span class="pageNumber"></span> ${tr(e, "footer.of")} <span class="totalPages"></span></span>
 </div>$0`
     ),
-    sampleData: { company: { name: "Acme GmbH", email: "hello@acme.example" } }
+    sampleData: { company: { name: "Fennlor Studio GmbH", email: "hello@fennlor.example" } },
+    i18n: {
+      en: { "footer.page": "Page", "footer.of": "of" },
+      de: { "footer.page": "Seite", "footer.of": "von" }
+    }
+  },
+  {
+    id: "legal-footer",
+    group: "page",
+    kinds: ["pdf"],
+    title: "Legal footer",
+    description: "The legal footer from the brand kit, centred in the page footer.",
+    target: "footer",
+    source: forAll(
+      (e) => `<div style="width:100%;text-align:center;font-size:8px;color:#666">${val(e, "brand.legal_footer")}</div>$0`
+    )
   },
   {
     id: "cover-page",
+    group: "report",
+    kinds: ["pdf"],
     title: "Cover page",
     description: "Title, subtitle and date on a page of its own.",
     source: forAll(
@@ -79955,12 +80568,13 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
       }
     },
     css: `.ff-cover { min-height: 60vh; display: flex; flex-direction: column; justify-content: center; }
-.ff-cover h1 { font-size: 32pt; margin: 0 0 8px; }
+.ff-cover h1 { font-family: var(--brand-font-heading, inherit); font-size: 32pt; color: var(--brand-color-primary, inherit); margin: 0 0 8px; }
 .ff-cover .subtitle { font-size: 16pt; color: #444; margin: 0; }
 .ff-cover .date { margin-top: 24px; color: #666; }`
   },
   {
     id: "signature",
+    group: "letter",
     title: "Signature line",
     description: "Place, date and a signature line.",
     source: forAll(
@@ -79973,7 +80587,7 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
       signature: {
         place: "Berlin",
         date: "2026-09-07",
-        name: "Philipp Staudt"
+        name: "Erika Mustermann"
       }
     },
     css: `.ff-signature { margin-top: 48px; width: 260px; font-size: 9pt; color: #444; }
@@ -79981,33 +80595,32 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
   },
   {
     id: "epc-qr",
+    group: "invoice",
     title: "SEPA payment QR code",
     description: "GiroCode that banking apps scan to prefill the transfer.",
     source: {
       jinja2: `<figure class="ff-qr">
-  <img src="{{ epcQr({ name: company.name, iban: company.iban, bic: company.bic, amount: invoice.total, reference: invoice.number }, { size: 120 }) }}" alt="Payment QR code">
-  <figcaption>Scan to pay</figcaption>
+  <img src="{{ epcQr(payment, { size: 120 }) }}" alt="${tr("jinja2", "qr.alt")}">
+  <figcaption>${tr("jinja2", "qr.caption")}</figcaption>
 </figure>$0`,
       liquid: `<figure class="ff-qr">
-  <img src="{{ payment | epcQr }}" alt="Payment QR code">
-  <figcaption>Scan to pay</figcaption>
+  <img src="{{ payment | epcQr: size: 120 }}" alt="${tr("liquid", "qr.alt")}">
+  <figcaption>${tr("liquid", "qr.caption")}</figcaption>
 </figure>$0`,
       handlebars: `<figure class="ff-qr">
-  <img src="{{epcQr payment size=120}}" alt="Payment QR code">
-  <figcaption>Scan to pay</figcaption>
+  <img src="{{epcQr payment size=120}}" alt="${tr("handlebars", "qr.alt")}">
+  <figcaption>${tr("handlebars", "qr.caption")}</figcaption>
 </figure>$0`
     },
+    i18n: {
+      en: { "qr.alt": "Payment QR code", "qr.caption": "Scan to pay" },
+      de: { "qr.alt": "QR-Code zur Zahlung", "qr.caption": "Zum Bezahlen scannen" }
+    },
     sampleData: {
-      company: {
-        name: "Acme GmbH",
-        iban: "DE02120300000000202051",
-        bic: "BYLADEM1001"
-      },
-      invoice: { number: "2026-0042", total: 3760.4 },
       payment: {
-        name: "Acme GmbH",
-        iban: "DE02120300000000202051",
-        bic: "BYLADEM1001",
+        name: "Fennlor Studio GmbH",
+        iban: "DE00000000000000000000",
+        bic: "XXXXDEXXXXX",
         amount: 3760.4,
         reference: "2026-0042"
       }
@@ -80017,38 +80630,29 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
   },
   {
     id: "chart",
+    group: "report",
     title: "Chart",
-    description: "Bar chart drawn with Chart.js from a chart configuration in the data.",
+    description: "Bar chart from labels and values in the data, in the brand colour.",
+    // the colour comes from the brand kit; without one the helper takes its palette
     source: {
       jinja2: `<figure class="ff-chart-box">
-  {{ chart(salesChart) }}
-  <figcaption>{{ salesChart.caption }}</figcaption>
+  {{ chart(sales, { type: '\${1:bar}', width: 480, height: 240, color: brand.colors.primary }) }}
+  <figcaption>{{ sales.caption }}</figcaption>
 </figure>$0`,
       liquid: `<figure class="ff-chart-box">
-  {{ salesChart | chart }}
-  <figcaption>{{ salesChart.caption }}</figcaption>
+  {{ sales | chart: type: '\${1:bar}', width: 480, height: 240, color: brand.colors.primary }}
+  <figcaption>{{ sales.caption }}</figcaption>
 </figure>$0`,
       handlebars: `<figure class="ff-chart-box">
-  {{chart salesChart}}
-  <figcaption>{{salesChart.caption}}</figcaption>
+  {{chart sales type='\${1:bar}' width=480 height=240 color=brand.colors.primary}}
+  <figcaption>{{sales.caption}}</figcaption>
 </figure>$0`
     },
     sampleData: {
-      salesChart: {
-        type: "bar",
+      sales: {
         caption: "Revenue per quarter",
-        width: 480,
-        height: 240,
-        data: {
-          labels: ["Q1", "Q2", "Q3", "Q4"],
-          datasets: [
-            {
-              label: "Revenue",
-              data: [12e3, 15500, 14200, 18900],
-              backgroundColor: "#3E63DD"
-            }
-          ]
-        }
+        labels: ["Q1", "Q2", "Q3", "Q4"],
+        values: [12e3, 15500, 14200, 18900]
       }
     },
     css: `.ff-chart-box { margin: 16px 0; break-inside: avoid; }
@@ -80056,6 +80660,7 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
   },
   {
     id: "two-columns",
+    group: "page",
     title: "Two-column layout",
     description: "Two equal columns that stay side by side in print.",
     source: forAll(
@@ -80066,10 +80671,102 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
     ),
     css: `.ff-columns { display: flex; gap: 24px; }
 .ff-columns > div { flex: 1 1 0; min-width: 0; }`
+  },
+  {
+    id: "keep-together",
+    group: "page",
+    kinds: ["pdf"],
+    title: "Keep together",
+    description: "Content that is never split across two pages.",
+    source: forAll(() => `<div class="avoid-break">
+  $0
+</div>`)
+  },
+  {
+    id: "page-break",
+    group: "page",
+    kinds: ["pdf"],
+    title: "Page break",
+    description: "Starts a new page in the PDF.",
+    source: forAll(() => `<div class="page-break"></div>
+$0`)
+  },
+  {
+    id: "kpi-cards",
+    group: "report",
+    title: "Key figures",
+    description: "A row of cards with label, value and change for each figure.",
+    source: forAll(
+      (e) => `<div class="ff-kpis">
+${loop(e, "kpi", "report.kpis", `  <div class="kpi"><span class="label">${val(e, "kpi.label")}</span><strong>${val(e, "kpi.value")}</strong><span class="change">${val(e, "kpi.change")}</span></div>`)}
+</div>$0`
+    ),
+    sampleData: {
+      report: {
+        kpis: [
+          { label: "Revenue", value: "\u20AC 61,600", change: "+12 % on Q2" },
+          { label: "New customers", value: "48", change: "+9 on Q2" },
+          { label: "Churn", value: "1.8 %", change: "\u22120.4 pt on Q2" }
+        ]
+      }
+    },
+    css: `.ff-kpis { display: flex; gap: 12px; margin: 16px 0; break-inside: avoid; }
+.ff-kpis .kpi { flex: 1 1 0; padding: 10px 12px; border: 1px solid #e5e5e5; border-top: 3px solid ${rule}; border-radius: 4px; }
+.ff-kpis .label { display: block; font-size: 8pt; color: #666; text-transform: uppercase; letter-spacing: 0.04em; }
+.ff-kpis strong { display: block; margin: 2px 0; font-size: 18pt; }
+.ff-kpis .change { font-size: 8pt; color: #555; }`
   }
 ];
 
+// packages/api-types/src/lib/assets.ts
+var SEGMENT = "[A-Za-z0-9][A-Za-z0-9._-]*";
+var ASSET_NAME_PATTERN = new RegExp(`^${SEGMENT}(?:/${SEGMENT})*$`);
+var ASSET_MAX_BYTES = 10 * 1024 * 1024;
+
+// packages/engine/src/lib/office/errors.ts
+var officeLimits = {
+  /** Entries in one container. */
+  maxEntries: 2e3,
+  /** Sum of the uncompressed sizes the central directory declares. */
+  maxDeclaredBytes: 200 * 1024 * 1024,
+  /** One part we inflate; enforced while inflating, because the declared size can lie. */
+  maxPartBytes: 20 * 1024 * 1024,
+  /** A conversion upload or a template file. */
+  maxFileBytes: 20 * 1024 * 1024
+};
+
+// packages/engine/src/lib/office/drawings.ts
+var OPEN = String.fromCharCode(57346);
+var CLOSE = String.fromCharCode(57347);
+var officeDrawingLimits = {
+  /** Drawings per render. */
+  maxDrawings: 50,
+  /** Image bytes placed per render. */
+  maxImageBytes: 20 * 1024 * 1024,
+  /** Largest raster edge in pixels. */
+  maxPixels: 2400
+};
+
+// packages/engine/src/lib/office/render.ts
+var OFFICE_FILLED_MAX_BYTES = 50 * 1024 * 1024;
+
 // packages/sdk-ts/src/lib/client.ts
+var isOfficeInput = (input) => "file" in input;
+function blobOf(file) {
+  const blob = file.data instanceof Blob ? file.data : new Blob([file.data]);
+  const own = typeof File !== "undefined" && file.data instanceof File ? file.data.name : void 0;
+  return { blob, name: file.name ?? own ?? "document" };
+}
+function multipart(fields, file) {
+  const form = new FormData();
+  const { blob, name } = blobOf(file);
+  form.set("file", blob, name);
+  for (const [key, value] of Object.entries(fields)) {
+    if (value === void 0) continue;
+    form.set(key, typeof value === "string" ? value : typeof value === "object" ? JSON.stringify(value) : String(value));
+  }
+  return form;
+}
 var FormfeedError = class extends Error {
   constructor(code, message2, status, problem = null, requestId = null) {
     super(message2);
@@ -80096,6 +80793,8 @@ function randomKey() {
   if (c?.randomUUID) return c.randomUUID();
   return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 }
+var withKey = (options) => ({ ...options, idempotencyKey: options.idempotencyKey ?? randomKey() });
+var idOf = (source) => typeof source === "string" ? source : source.id;
 var Formfeed = class {
   baseUrl;
   apiKey;
@@ -80159,11 +80858,96 @@ var Formfeed = class {
     },
     /** Removes the stored files of a render before they expire. Needs the `file:delete` scope. */
     deleteOutputs: (id, options = {}) => this.request("DELETE", `/renders/${encodeURIComponent(id)}/outputs`, void 0, options),
+    /**
+     * The stored request of a render, to render it again. Needs `render:input`; throws
+     * `render_input_expired` (410) when the workspace keeps no requests or the period ended.
+     */
+    input: (id, options = {}) => this.request("GET", `/renders/${encodeURIComponent(id)}/input`, void 0, options),
     batch: (request, options = {}) => this.request("POST", "/renders/batch", request, {
       ...options,
       idempotencyKey: options.idempotencyKey ?? randomKey()
     })
   };
+  /**
+   * PDF tools on the outputs of earlier renders (a `Render` or its id) and on PDFs of the file library
+   * (a `LibraryFile`, its id or its name). merge, protect and watermark return a new render and cost
+   * 0.5 units each on live keys; info is free.
+   */
+  pdf = {
+    merge: (sources, output = {}, options = {}) => this.request("POST", "/pdf/merge", { ...output, sources: sources.map(idOf) }, withKey(options)),
+    protect: (source, protect, options = {}) => this.request("POST", "/pdf/protect", { ...protect, source: idOf(source) }, withKey(options)),
+    watermark: (source, watermark, options = {}) => this.request("POST", "/pdf/watermark", { ...watermark, source: idOf(source) }, withKey(options)),
+    info: (source, options = {}) => this.request("POST", "/pdf/info", { source: idOf(source) }, options),
+    /**
+     * Converts an office document to a PDF render (Starter plan and above): an uploaded file (Word,
+     * Excel, PowerPoint, OpenDocument, RTF or HTML, up to 20 MB, not kept), or the output of a Word or
+     * PowerPoint template render. Costs follow the PDF rule. A busy converter answers 503, which is
+     * retried like any other.
+     */
+    convert: (source, convert = {}, options = {}) => {
+      if (typeof source === "object" && "file" in source)
+        return this.request("POST", "/pdf/convert", multipart({ ...convert }, source.file), withKey(options));
+      return this.request("POST", "/pdf/convert", { ...convert, source: idOf(source) }, withKey(options));
+    }
+  };
+  /**
+   * The workspace file library (`/files`): images and PDFs a template references by name with
+   * `asset('logo.png')`, and the sources of image watermarks and merges. Needs `file:read`,
+   * `file:write` or `file:delete`. Files are served without a signature, so keep confidential
+   * documents out of it.
+   */
+  files = {
+    /** Uploads a file; the same name replaces the existing file in place and keeps its URL. */
+    upload: (file, options = {}) => {
+      const blob = file.data instanceof Blob ? file.data : new Blob([file.data], file.contentType ? { type: file.contentType } : {});
+      const form = new FormData();
+      form.set("file", blob, file.name);
+      form.set("name", file.name);
+      return this.request("POST", "/files", form, options);
+    },
+    /** Page of files, newest first. */
+    list: (query = {}, options = {}) => {
+      const params = new URLSearchParams();
+      for (const [k2, v2] of Object.entries(query)) if (v2 !== void 0 && v2 !== null && v2 !== "") params.set(k2, String(v2));
+      const qs = params.toString();
+      return this.request("GET", `/files${qs ? `?${qs}` : ""}`, void 0, options);
+    },
+    /** Every file matching the query, following the cursor. */
+    all: async (query = {}, options = {}) => {
+      const out = [];
+      let cursor = null;
+      do {
+        const page = await this.files.list({ ...query, cursor }, options);
+        out.push(...page.data);
+        cursor = page.next_cursor;
+      } while (cursor);
+      return out;
+    },
+    get: (id, options = {}) => this.request("GET", `/files/${encodeURIComponent(id)}`, void 0, options),
+    /** Removes the file and its bytes; templates that name it render a missing image afterwards. */
+    delete: (file, options = {}) => this.request("DELETE", `/files/${encodeURIComponent(idOf(file))}`, void 0, options)
+  };
+  /** The organisation's brand kit, read-only through the API (it is edited in the app). Needs `template:read`. */
+  brand = {
+    get: (options = {}) => this.request("GET", "/brand", void 0, options)
+  };
+  /**
+   * Shared partials of the organisation. Renders use the current source, so a change reaches every
+   * template that includes the partial without a new version. Needs `template:read` or `template:write`.
+   */
+  partials = {
+    /** Every shared partial, without its source. */
+    list: async (options = {}) => (await this.request("GET", "/partials", void 0, options)).data,
+    /** One partial with its source. */
+    get: (name, options = {}) => this.request("GET", `/partials/${encodeURIComponent(name)}`, void 0, options),
+    /** Creates or replaces a partial; pass `base_version` to fail with 409 when it changed since you read it. */
+    put: async (name, input, options = {}) => {
+      const { status, body } = await this.send("PUT", `/partials/${encodeURIComponent(name)}`, input, options);
+      return { partial: body, created: status === 201 };
+    },
+    /** Removes a partial; templates that still include it fail to render afterwards. */
+    delete: (name, options = {}) => this.request("DELETE", `/partials/${encodeURIComponent(name)}`, void 0, options)
+  };
   jobs = {
     get: (id, options = {}) => this.request("GET", `/jobs/${encodeURIComponent(id)}`, void 0, options),
     waitFor: async (id, options = {}) => {
@@ -80183,7 +80967,20 @@ var Formfeed = class {
     create: (input, options = {}) => this.request("POST", "/webhooks", input, options),
     update: (id, patch, options = {}) => this.request("PUT", `/webhooks/${encodeURIComponent(id)}`, patch, options),
     delete: (id, options = {}) => this.request("DELETE", `/webhooks/${encodeURIComponent(id)}`, void 0, options),
-    test: (id, options = {}) => this.request("POST", `/webhooks/${encodeURIComponent(id)}/test`, void 0, options)
+    test: (id, options = {}) => this.request("POST", `/webhooks/${encodeURIComponent(id)}/test`, void 0, options),
+    /**
+     * Sends a stored event (`evt_…`) again as a new delivery to a registered endpoint (`webhook:manage`)
+     * or a running listen session (`webhook:listen`).
+     */
+    resend: (eventId, endpointId, options = {}) => this.request("POST", `/webhooks/events/${encodeURIComponent(eventId)}/resend`, { endpoint_id: endpointId }, options),
+    /**
+     * Listen sessions, what `formfeed listen` uses. Needs `webhook:listen`. Starting a session ends the
+     * previous one of the same key; the WebSocket itself is up to the caller.
+     */
+    listen: {
+      start: (input = {}, options = {}) => this.request("POST", "/webhooks/listen", input, options),
+      end: (id, options = {}) => this.request("DELETE", `/webhooks/listen/${encodeURIComponent(id)}`, void 0, options)
+    }
   };
   templates = {
     list: (query = {}, options = {}) => {
@@ -80204,32 +81001,127 @@ var Formfeed = class {
       return out;
     },
     get: (idOrSlug, options = {}) => this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}`, void 0, options),
-    create: (input, options = {}) => this.request("POST", "/templates", input, options),
+    /** A Word or PowerPoint template (`kind` `docx` or `pptx`) is created from its `file`, sent as multipart. */
+    create: (input, options = {}) => {
+      if (isOfficeInput(input) && input.file) {
+        const { file, ...fields } = input;
+        return this.request("POST", "/templates", multipart(fields, file), options);
+      }
+      return this.request("POST", "/templates", input, options);
+    },
     update: (idOrSlug, patch, options = {}) => this.request("PUT", `/templates/${encodeURIComponent(idOrSlug)}`, patch, options),
     archive: (idOrSlug, options = {}) => this.request("DELETE", `/templates/${encodeURIComponent(idOrSlug)}`, void 0, options),
     versions: {
       list: async (idOrSlug, options = {}) => (await this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}/versions`, void 0, options)).data,
-      /** `which`: 'published', 'latest' or a version number. Carries the files. */
-      get: (idOrSlug, which = "published", options = {}) => this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}/versions/${which}`, void 0, options),
-      create: (idOrSlug, input, options = {}) => this.request("POST", `/templates/${encodeURIComponent(idOrSlug)}/versions`, input, options),
-      publish: (idOrSlug, number, options = {}) => this.request("POST", `/templates/${encodeURIComponent(idOrSlug)}/versions/${number}/publish`, void 0, options)
+      /** `which`: 'published', 'latest', a version number or a channel name (its main version). Carries the files. */
+      get: (idOrSlug, which = "published", options = {}) => this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}/versions/${encodeURIComponent(String(which))}`, void 0, options),
+      /** For a Word or PowerPoint template, pass `file` to replace the document; without it the latest file is kept. */
+      create: (idOrSlug, input, options = {}) => {
+        const path = `/templates/${encodeURIComponent(idOrSlug)}/versions`;
+        if (isOfficeInput(input)) {
+          const { file, ...fields } = input;
+          if (file) return this.request("POST", path, multipart(fields, file), options);
+          return this.request("POST", path, fields, options);
+        }
+        return this.request("POST", path, input, options);
+      },
+      /** The Word or PowerPoint file of a version (`which` as for `get`); needs `template:read`. */
+      file: async (idOrSlug, which = "published", options = {}) => {
+        const path = `/templates/${encodeURIComponent(idOrSlug)}/versions/${encodeURIComponent(String(which))}/file`;
+        return (await this.send("GET", path, void 0, options, "bytes")).body;
+      },
+      /**
+       * Publishes a version. When both versions store a data schema and the new one breaks callers of the
+       * published one, the API refuses with `schema_breaking_change` unless `allowBreaking` is set.
+       */
+      publish: (idOrSlug, number, options = {}) => {
+        const { allowBreaking, ...rest } = options;
+        return this.request(
+          "POST",
+          `/templates/${encodeURIComponent(idOrSlug)}/versions/${number}/publish`,
+          allowBreaking ? { allow_breaking: true } : void 0,
+          rest
+        );
+      }
+    },
+    /**
+     * Release channels (`published` and named ones such as `staging`): a render with `version: 'staging'`
+     * uses the version the channel points at. Moves reach renders within a minute.
+     */
+    channels: {
+      list: (idOrSlug, options = {}) => this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}/channels`, void 0, options),
+      /** Creates or moves a channel; on `published` this publishes. */
+      set: (idOrSlug, name, move, options = {}) => {
+        const { allowBreaking, ...rest } = options;
+        return this.request(
+          "PUT",
+          `/templates/${encodeURIComponent(idOrSlug)}/channels/${encodeURIComponent(name)}`,
+          { ...move, ...allowBreaking ? { allow_breaking: true } : {} },
+          rest
+        );
+      },
+      /** The canary becomes the main version. */
+      promote: (idOrSlug, name, options = {}) => this.channelAction(idOrSlug, name, "promote", options),
+      /** Back to the version before the last move. */
+      rollback: (idOrSlug, name, options = {}) => this.channelAction(idOrSlug, name, "rollback", options),
+      /** Refused with `channel_in_use` while renders of the last hour used the channel, unless `force`. */
+      delete: (idOrSlug, name, options = {}) => {
+        const { force, ...rest } = options;
+        return this.request(
+          "DELETE",
+          `/templates/${encodeURIComponent(idOrSlug)}/channels/${encodeURIComponent(name)}${force ? "?force=true" : ""}`,
+          void 0,
+          rest
+        );
+      }
     },
-    schema: (idOrSlug, options = {}) => this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}/schema`, void 0, options)
+    schema: (idOrSlug, options = {}) => this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}/schema`, void 0, options),
+    /**
+     * Checks a version with data without rendering: syntax, header and footer, missing partials,
+     * runtime errors and the data against the stored schema. Free. Without `data`, the version's
+     * sample data is checked.
+     */
+    validate: (idOrSlug, input = {}, options = {}) => this.request("POST", `/templates/${encodeURIComponent(idOrSlug)}/validate`, input, options)
   };
   account = {
     get: (options = {}) => this.request("GET", "/account", void 0, options),
     /** Units of the current period, or of `YYYY-MM`, with a daily series and a breakdown per template. */
     usage: (period = "current", options = {}) => this.request("GET", `/usage?period=${encodeURIComponent(period)}`, void 0, options)
   };
+  /** Workspaces of the key's organisation. Needs `workspace:delete`, which no key has by default. */
+  workspaces = {
+    /**
+     * Deletes a workspace: it leaves the app and the API at once, its keys are revoked and its content
+     * is removed after 30 days. The organisation's last workspace is refused with `last_workspace`.
+     */
+    delete: (id, options = {}) => this.request("DELETE", `/workspaces/${encodeURIComponent(id)}`, void 0, options)
+  };
+  channelAction(idOrSlug, name, action, options) {
+    const { allowBreaking, ...rest } = options;
+    return this.request(
+      "POST",
+      `/templates/${encodeURIComponent(idOrSlug)}/channels/${encodeURIComponent(name)}/${action}`,
+      allowBreaking ? { allow_breaking: true } : void 0,
+      rest
+    );
+  }
   /** Raw request with auth, retries and problem mapping; use it for endpoints without a helper. */
   async request(method, path, body, options = {}) {
+    return (await this.send(method, path, body, options)).body;
+  }
+  /**
+   * `request` with the HTTP status, for endpoints whose answer depends on it (201 created, 200 updated).
+   * `bytes` returns a successful body as bytes (file downloads); problems are JSON either way.
+   */
+  async send(method, path, body, options = {}, as = "json") {
     const url = `${this.baseUrl}${path}`;
     const headers = {
       authorization: `Bearer ${this.apiKey}`,
-      accept: "application/json",
-      "user-agent": "formfeed-sdk-ts/0.1"
+      accept: as === "bytes" ? "*/*" : "application/json",
+      "user-agent": "formfeed-sdk-ts/0.3"
     };
-    if (body !== void 0) headers["content-type"] = "application/json";
+    const isForm = typeof FormData !== "undefined" && body instanceof FormData;
+    if (body !== void 0 && !isForm) headers["content-type"] = "application/json";
     if (options.idempotencyKey) headers["idempotency-key"] = options.idempotencyKey;
     let attempt = 0;
     for (; ; ) {
@@ -80241,7 +81133,7 @@ var Formfeed = class {
         res = await this.fetchImpl(url, {
           method,
           headers,
-          body: body === void 0 ? void 0 : JSON.stringify(body),
+          body: body === void 0 ? void 0 : isForm ? body : JSON.stringify(body),
           signal: controller.signal
         });
       } catch (e) {
@@ -80259,9 +81151,15 @@ var Formfeed = class {
         await sleep(this.backoff(attempt, res.headers.get("retry-after")), options.signal);
         continue;
       }
-      if (res.status === 204) return void 0;
+      if (res.status === 204) return { status: 204, body: void 0 };
+      if (as === "bytes" && res.ok) return { status: res.status, body: new Uint8Array(await res.arrayBuffer()) };
       const text2 = await res.text();
-      const json = text2 ? JSON.parse(text2) : null;
+      let json = null;
+      try {
+        json = text2 ? JSON.parse(text2) : null;
+      } catch {
+        if (res.ok) throw new FormfeedError("invalid_response", `the API answered HTTP ${res.status} with a body that is not JSON`, res.status);
+      }
       if (!res.ok) {
         const problem = json ?? {};
         throw new FormfeedError(
@@ -80272,7 +81170,7 @@ var Formfeed = class {
           res.headers.get("x-request-id")
         );
       }
-      return json;
+      return { status: res.status, body: json };
     }
   }
   backoff(attempt, retryAfter) {
@@ -80287,9 +81185,9 @@ var encoder2 = new TextEncoder();
 
 // packages/mcp/src/lib/server.ts
 import { z as z2 } from "zod";
-var SERVER_INFO = { name: "formfeed", version: "0.1.0" };
+var SERVER_INFO = { name: "formfeed", version: "0.3.0" };
 var engineSchema = z2.enum(["jinja2", "liquid", "handlebars"]);
-var outputSchema = z2.enum(["pdf", "png", "jpg"]);
+var outputSchema = z2.enum(outputFormats);
 var templateSummary = (t) => ({
   id: t.id,
   slug: t.slug,
@@ -80425,7 +81323,7 @@ function createFormfeedServer(options) {
         html: z2.string().optional().describe("Raw HTML instead of a template"),
         engine: engineSchema.optional().describe("Engine for html that contains template syntax"),
         data: z2.record(z2.string(), z2.unknown()).optional(),
-        output: outputSchema.default("pdf"),
+        output: outputSchema.optional().describe("Left out: PDF for PDF templates and html, the template's image format for image templates"),
         filename: z2.string().optional(),
         locale: z2.string().optional().describe("BCP 47 tag for helpers and translations, e.g. de-DE"),
         wait: z2.boolean().default(true).describe("Wait for the render to finish (sync renders finish immediately)")
@@ -80440,7 +81338,7 @@ function createFormfeedServer(options) {
           ...html ? { html } : {},
           ...engine ? { engine } : {},
           data: data ?? {},
-          output,
+          ...output ? { output } : {},
           ...filename ? { filename } : {},
           ...locale ? { locale } : {},
           meta: { source: "mcp" }