@formfeed/mcp 0.2.0 → 0.3.0

package/bin/formfeed-mcp.mjs

@@ -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]);
@@ -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",
@@ -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);
+    }
   }
 ];
 
@@ -78528,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",
@@ -78536,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)) {
@@ -78806,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
         })
       };
@@ -78835,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
@@ -79060,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",
@@ -79071,6 +79133,8 @@ var builtinRoots2 = /* @__PURE__ */ new Set([
   "varargs",
   "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",
@@ -79271,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
@@ -79286,6 +79351,7 @@ function createEnvironment(ctx) {
     env.addGlobal(name, wrapped);
   }
   env.addGlobal("namespace", namespace);
+  if (ctx.brand) env.addGlobal("brand", ctx.brand);
   installJinjaFilters(env);
   return env;
 }
@@ -79340,6 +79406,7 @@ function walk2(node, w) {
     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);
@@ -79706,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",
@@ -79771,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
@@ -80041,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}$/;
@@ -80131,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 %}`;
@@ -80143,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"),
@@ -80150,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>
@@ -80174,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: {
@@ -80193,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(
@@ -80209,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"
       }
     },
@@ -80220,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(
@@ -80250,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(
@@ -80268,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; }
@@ -80276,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"
       }
@@ -80312,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; }
@@ -80351,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(
@@ -80361,6 +80671,50 @@ ${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; }`
   }
 ];
 
@@ -80369,7 +80723,50 @@ 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);
@@ -80461,6 +80858,11 @@ 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()
@@ -80475,7 +80877,18 @@ var Formfeed = class {
     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)
+    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
@@ -80514,6 +80927,27 @@ var Formfeed = class {
     /** 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 = {}) => {
@@ -80533,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 = {}) => {
@@ -80554,15 +81001,79 @@ 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),
     /**
@@ -80577,13 +81088,37 @@ var Formfeed = class {
     /** 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.2"
+      accept: as === "bytes" ? "*/*" : "application/json",
+      "user-agent": "formfeed-sdk-ts/0.3"
     };
     const isForm = typeof FormData !== "undefined" && body instanceof FormData;
     if (body !== void 0 && !isForm) headers["content-type"] = "application/json";
@@ -80616,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(
@@ -80629,7 +81170,7 @@ var Formfeed = class {
           res.headers.get("x-request-id")
         );
       }
-      return json;
+      return { status: res.status, body: json };
     }
   }
   backoff(attempt, retryAfter) {
@@ -80644,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.2.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,
@@ -80782,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)")
@@ -80797,7 +81338,7 @@ function createFormfeedServer(options) {
           ...html ? { html } : {},
           ...engine ? { engine } : {},
           data: data ?? {},
-          output,
+          ...output ? { output } : {},
           ...filename ? { filename } : {},
           ...locale ? { locale } : {},
           meta: { source: "mcp" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formfeed/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Model Context Protocol server for Formfeed: list templates, read data schemas, validate and render documents from AI agents.",
   "license": "MIT",
   "author": {