@formfeed/mcp 0.3.12 → 0.3.13

package/bin/formfeed-mcp.mjs

@@ -70689,7 +70689,10 @@ var barcodeTypes = {
 var ownTextLayout = /* @__PURE__ */ new Set(["ean13", "ean8", "upca"]);
 function codeText(helper, value) {
   const text4 = value === void 0 || value === null ? "" : String(value);
-  if (text4 === "") throw new Error(`${helper}: nothing to encode, the value is empty or missing from the data`);
+  if (text4 === "")
+    throw new Error(
+      `${helper}: nothing to encode, the value is empty or missing from the data`
+    );
   return text4;
 }
 var codeHelpers = [
@@ -70698,18 +70701,25 @@ var codeHelpers = [
     aliases: ["qr"],
     doc: {
       signature: "qrcode(value, { size = 160, ecc = 'M', margin = 1, color, background })",
-      description: "QR code as an SVG data URI for an <img> src.",
+      description: "QR code as an SVG data URI for an <img> src. Give the image an `alt` that says where the code leads: a screen reader cannot scan it.",
       examples: {
-        jinja2: '<img src="{{ qrcode(order.url, { size: 120 }) }}">',
-        liquid: '<img src="{{ order.url | qrcode: size: 120 }}">',
-        handlebars: '<img src="{{qrcode order.url size=120}}">'
+        jinja2: '<img src="{{ qrcode(order.url, { size: 120 }) }}" alt="QR code: {{ order.url }}">',
+        liquid: '<img src="{{ order.url | qrcode: size: 120 }}" alt="QR code: {{ order.url }}">',
+        handlebars: '<img src="{{qrcode order.url size=120}}" alt="QR code: {{order.url}}">'
       },
       category: "code"
     },
     fn: (ctx, value, options) => {
       const o = options ?? {};
       const svg = qrSvg(codeText("qrcode", value), o);
-      if (ctx.drawing) return ctx.drawing({ kind: "svg", svg, width: o.size, height: o.size, alt: "QR code" });
+      if (ctx.drawing)
+        return ctx.drawing({
+          kind: "svg",
+          svg,
+          width: o.size,
+          height: o.size,
+          alt: "QR code"
+        });
       return svgDataUri(svg);
     }
   },
@@ -70717,11 +70727,11 @@ var codeHelpers = [
     name: "barcode",
     doc: {
       signature: "barcode(value, { type = 'code128', height = 12, width, text = true, scale = 2 })",
-      description: "Barcode (code128, ean13, ean8, upc, itf14, code39, datamatrix, pdf417) as an SVG data URI.",
+      description: "Barcode (code128, ean13, ean8, upc, itf14, code39, datamatrix, pdf417) as an SVG data URI. Give the image an `alt` with the value it encodes.",
       examples: {
-        jinja2: `<img src="{{ barcode(item.sku, { type: 'code128' }) }}">`,
-        liquid: `<img src="{{ item.sku | barcode: type: 'code128' }}">`,
-        handlebars: `<img src="{{barcode item.sku type='code128'}}">`
+        jinja2: `<img src="{{ barcode(item.sku, { type: 'code128' }) }}" alt="Barcode {{ item.sku }}">`,
+        liquid: `<img src="{{ item.sku | barcode: type: 'code128' }}" alt="Barcode {{ item.sku }}">`,
+        handlebars: `<img src="{{barcode item.sku type='code128'}}" alt="Barcode {{item.sku}}">`
       },
       category: "code"
     },
@@ -70738,7 +70748,8 @@ var codeHelpers = [
         includetext: o.text !== false,
         ...ownTextLayout.has(bcid) ? {} : { textxalign: "center" }
       });
-      if (ctx.drawing) return ctx.drawing({ kind: "svg", svg, alt: `Barcode ${text4}` });
+      if (ctx.drawing)
+        return ctx.drawing({ kind: "svg", svg, alt: `Barcode ${text4}` });
       return svgDataUri(svg);
     }
   },
@@ -70747,11 +70758,11 @@ var codeHelpers = [
     aliases: ["epc_qr", "girocode"],
     doc: {
       signature: "epcQr({ name, iban, bic?, amount?, reference?, text? }, { size })",
-      description: "SEPA credit transfer QR code (EPC069-12 / GiroCode) that banking apps scan to prefill a payment.",
+      description: "SEPA credit transfer QR code (EPC069-12 / GiroCode) that banking apps scan to prefill a payment. Give the image an `alt`, and print the bank details as text as well: the code is a picture.",
       examples: {
-        jinja2: '<img src="{{ epcQr({ name: company.name, iban: company.iban, amount: invoice.total, reference: invoice.number }) }}">',
-        liquid: '<img src="{{ company.iban | epcQr: name: company.name, amount: invoice.total, reference: invoice.number }}">',
-        handlebars: '<img src="{{epcQr name=company.name iban=company.iban amount=invoice.total reference=invoice.number}}">'
+        jinja2: '<img src="{{ epcQr({ name: company.name, iban: company.iban, amount: invoice.total, reference: invoice.number }) }}" alt="QR code to pay invoice {{ invoice.number }}">',
+        liquid: '<img src="{{ company.iban | epcQr: name: company.name, amount: invoice.total, reference: invoice.number }}" alt="QR code to pay invoice {{ invoice.number }}">',
+        handlebars: '<img src="{{epcQr name=company.name iban=company.iban amount=invoice.total reference=invoice.number}}" alt="QR code to pay invoice {{invoice.number}}">'
       },
       category: "code"
     },
@@ -70770,12 +70781,27 @@ var codeHelpers = [
         (EPC_FIELDS.has(key) ? payment2 : qr)[key] = value;
       const o = { ecc: "M", ...qr };
       const svg = qrSvg(epcPayload(payment2), o);
-      if (ctx.drawing) return ctx.drawing({ kind: "svg", svg, width: o.size, height: o.size, alt: "GiroCode" });
+      if (ctx.drawing)
+        return ctx.drawing({
+          kind: "svg",
+          svg,
+          width: o.size,
+          height: o.size,
+          alt: "GiroCode"
+        });
       return svgDataUri(svg);
     }
   }
 ];
-var EPC_FIELDS = /* @__PURE__ */ new Set(["name", "iban", "bic", "amount", "reference", "text", "purpose"]);
+var EPC_FIELDS = /* @__PURE__ */ new Set([
+  "name",
+  "iban",
+  "bic",
+  "amount",
+  "reference",
+  "text",
+  "purpose"
+]);
 
 // node_modules/.pnpm/@date-fns+tz@1.5.0/node_modules/@date-fns/tz/constants/index.js
 var constructFromSymbol = Symbol.for("constructDateFrom");
@@ -78352,7 +78378,16 @@ var collectionHelpers = [
 ];
 
 // packages/engine/src/lib/helpers/document.ts
-var CHART_PALETTE = ["#3E63DD", "#12A594", "#E5484D", "#F76B15", "#8E4EC6", "#FFC53D", "#0090FF", "#978365"];
+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) {
@@ -78366,8 +78401,13 @@ function chartDataFromPlain(spec) {
     });
     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);
+    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;
   });
@@ -78384,7 +78424,8 @@ function chartPayload(spec) {
   const options = { ...spec.options ?? {} };
   options["animation"] = false;
   options["responsive"] = false;
-  if (!isPlain(spec)) 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"]);
@@ -78397,7 +78438,8 @@ function chartMarkup(spec, id) {
   const height = toNumber(spec.height ?? 240) || 240;
   const payload = escapeHtml(JSON.stringify(chartPayload(spec)));
   const idAttr = id ? ` id="${escapeHtml(id)}"` : "";
-  return `<canvas class="ff-chart"${idAttr} width="${width}" height="${height}" style="width:${width}px;height:${height}px" data-ff-chart="${payload}"></canvas>`;
+  const alt = typeof spec.alt === "string" && spec.alt.trim() ? ` role="img" aria-label="${escapeHtml(spec.alt.trim())}"` : "";
+  return `<canvas class="ff-chart"${idAttr}${alt} width="${width}" height="${height}" style="width:${width}px;height:${height}px" data-ff-chart="${payload}"></canvas>`;
 }
 function imageMarkup(url, options = {}) {
   const styles = [
@@ -78418,18 +78460,21 @@ var documentHelpers = [
     name: "chart",
     html: true,
     doc: {
-      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.",
+      signature: "chart({ type, labels, values, label, color } | { type, labels, series } | { type, data, options }, { width, height, alt })",
+      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. `alt` says in words what the chart shows: a screen reader reads it in place of the picture, and a tagged PDF needs it.",
       examples: {
-        jinja2: "{{ chart({ type: 'line', labels: sales.labels, values: sales.quarters, width: 480 }) }}",
-        liquid: "{{ '' | chart: type: 'line', labels: sales.labels, values: sales.quarters, width: 480 }}",
-        handlebars: "{{chart type='line' labels=sales.labels values=sales.quarters width=480}}"
+        jinja2: "{{ chart({ type: 'line', labels: sales.labels, values: sales.quarters, width: 480, alt: 'Sales by quarter' }) }}",
+        liquid: "{{ '' | chart: type: 'line', labels: sales.labels, values: sales.quarters, width: 480, alt: 'Sales by quarter' }}",
+        handlebars: "{{chart type='line' labels=sales.labels values=sales.quarters width=480 alt='Sales by quarter'}}"
       },
       category: "document"
     },
     fn: (ctx, spec, extra) => {
       if (ctx.mode === "office") throw new Error(officeUnsupported("chart"));
-      return chartMarkup({ ...asObject(spec), ...asObject(extra) });
+      return chartMarkup({
+        ...asObject(spec),
+        ...asObject(extra)
+      });
     }
   },
   {
@@ -78437,18 +78482,24 @@ var documentHelpers = [
     html: true,
     doc: {
       signature: "image(url, { width, height, fit, alt })",
-      description: "Places an image with fixed size and crop mode (`cover`, `contain`, `fill`); the render-worker fetches it through its cache and blocks private hosts.",
+      description: "Places an image with fixed size and crop mode (`cover`, `contain`, `fill`); the render-worker fetches it through its cache and blocks private hosts. `alt` says what it shows; without one the image counts as decoration and a screen reader passes over it.",
       examples: {
-        jinja2: "{{ image(product.photo, { width: 120, height: 80, fit: 'cover' }) }}",
-        liquid: "{{ product.photo | image: width: 120, height: 80, fit: 'cover' }}",
-        handlebars: "{{image product.photo width=120 height=80 fit='cover'}}"
+        jinja2: "{{ image(product.photo, { width: 120, height: 80, fit: 'cover', alt: product.name }) }}",
+        liquid: "{{ product.photo | image: width: 120, height: 80, fit: 'cover', alt: product.name }}",
+        handlebars: "{{image product.photo width=120 height=80 fit='cover' alt=product.name}}"
       },
       category: "document"
     },
     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 ctx.drawing({
+          kind: "url",
+          url: resolveAsset(ctx.assetBaseUrl, String(url ?? "")),
+          width: o.width,
+          height: o.height,
+          alt: o.alt
+        });
       return imageMarkup(String(url ?? ""), o);
     }
   }
@@ -82514,7 +82565,7 @@ var encoder2 = new TextEncoder();
 // packages/mcp/src/lib/server.ts
 import { z as z3 } from "zod";
 var CONVERT_LIMIT_BYTES = 20 * 1024 * 1024;
-var SERVER_INFO = { name: "formfeed", version: "0.3.12" };
+var SERVER_INFO = { name: "formfeed", version: "0.3.13" };
 var READS = {
   readOnlyHint: true,
   destructiveHint: false,
@@ -82549,7 +82600,10 @@ var renderSummary = (r) => ({
   units: r.units,
   environment: r.environment,
   template: r.template,
-  error: r.error
+  error: r.error,
+  // the validator's verdict of a render whose template declares PDF/UA-1 (plan 21): whether the
+  // file passed, and for each failed rule what to change and in which elements
+  ...r.accessibility ? { accessibility: r.accessibility } : {}
 });
 function text3(data) {
   return {
@@ -82559,8 +82613,15 @@ function text3(data) {
 }
 function failure(e) {
   const message2 = e instanceof FormfeedError ? `${e.code}: ${e.message}` : e instanceof Error ? e.message : String(e);
+  const verdict = e instanceof FormfeedError && e.code === "pdfua_validation_failed" ? e.problem?.["accessibility"] : void 0;
   return {
-    content: [{ type: "text", text: message2 }],
+    content: [
+      {
+        type: "text",
+        text: verdict ? `${message2}
+${JSON.stringify({ accessibility: verdict }, null, 2)}` : message2
+      }
+    ],
     isError: true
   };
 }

package/package.json

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