@formfeed/devkit 0.3.11 → 0.3.13

package/index.cjs

@@ -26,10 +26,13 @@ __export(index_exports, {
   collectPartials: () => collectPartials,
   contentHash: () => contentHash,
   contentTypeFor: () => contentTypeFor,
+  declaredEinvoice: () => declaredEinvoice,
   defaultData: () => defaultData,
   defaultProjectConfig: () => defaultProjectConfig,
   defaultTypesFile: () => defaultTypesFile,
   diagnose: () => diagnose,
+  diagnoseAccessibility: () => diagnoseAccessibility,
+  diagnoseEinvoice: () => diagnoseEinvoice,
   findProject: () => findProject,
   generateTypes: () => generateTypes,
   htmlSnapshot: () => htmlSnapshot,
@@ -37,6 +40,7 @@ __export(index_exports, {
   listLocalFiles: () => listLocalFiles,
   listTemplateSlugs: () => listTemplateSlugs,
   loadProject: () => loadProject,
+  localEinvoiceXml: () => localEinvoiceXml,
   localFilePath: () => localFilePath,
   localTypeSource: () => localTypeSource,
   officeSnapshot: () => officeSnapshot,
@@ -806,13 +810,163 @@ function previewDocument(tpl, rendered, mode, pagedScriptUrl) {
     settings: rendered.settings,
     kind
   };
-  return mode === "paged" && kind === "pdf" ? (0, import_engine4.pagedDocument)(draft, { pagedScriptUrl }) : (0, import_engine4.flowDocument)(draft);
+  const audit = kind === "pdf" && (0, import_engine4.resolveUa)(rendered.settings.pdf?.ua) !== null;
+  return mode === "paged" && kind === "pdf" ? (0, import_engine4.pagedDocument)(draft, { pagedScriptUrl, audit }) : (0, import_engine4.flowDocument)(draft, { audit });
 }
 
-// packages/devkit/src/lib/files.ts
-var import_node_crypto2 = require("node:crypto");
+// packages/devkit/src/lib/einvoice.ts
 var import_node_fs4 = require("node:fs");
 var import_node_path4 = require("node:path");
+var import_engine5 = require("@formfeed/engine");
+function declaredEinvoice(tpl, override) {
+  const resolved = (0, import_engine5.resolveEinvoiceOptions)(tpl.settings.einvoice, override);
+  if (!resolved.ok)
+    throw new DevkitError(
+      `${tpl.slug}: e-invoice ${resolved.field} "${resolved.value}": ${resolved.reason}`,
+      "validation"
+    );
+  return resolved.options;
+}
+var nowhere2 = { start: { line: 1, column: 1 }, end: { line: 1, column: 1 } };
+function diagnoseEinvoice(tpl) {
+  let options;
+  try {
+    options = declaredEinvoice(tpl);
+  } catch (e) {
+    return [
+      {
+        dataSet: "",
+        file: "settings.json",
+        diagnostics: [
+          {
+            severity: "error",
+            code: "einvoice-profile",
+            message: e instanceof Error ? e.message : String(e),
+            range: nowhere2
+          }
+        ]
+      }
+    ];
+  }
+  if (!options) return [];
+  if (tpl.meta.kind === "image")
+    return [
+      {
+        dataSet: "",
+        file: "settings.json",
+        diagnostics: [
+          {
+            severity: "warning",
+            code: "einvoice-image",
+            message: "settings.json declares an e-invoice, which an image template never produces: an e-invoice is a PDF",
+            range: nowhere2
+          }
+        ]
+      }
+    ];
+  const out = [];
+  for (const [name, data] of Object.entries(tpl.dataSets)) {
+    const result = (0, import_engine5.einvoiceXml)(data, options);
+    if (result.ok) continue;
+    const file = `data/${name}.json`;
+    const path = (0, import_node_path4.join)(tpl.dir, "data", `${name}.json`);
+    const text2 = (0, import_node_fs4.existsSync)(path) ? (0, import_node_fs4.readFileSync)(path, "utf8") : null;
+    out.push({
+      dataSet: name,
+      file,
+      diagnostics: result.problems.map((problem) => {
+        const at = text2 ? (0, import_engine5.locateJsonPath)(text2, [
+          import_engine5.INVOICE_DATA_KEY,
+          ...(0, import_engine5.invoicePathSegments)(problem.path)
+        ]) : null;
+        const start = at ? { line: at.line, column: at.column } : nowhere2.start;
+        return {
+          severity: "error",
+          code: `einvoice-${problem.code.replace(/_/g, "-")}`,
+          message: problem.message,
+          range: { start, end: start }
+        };
+      })
+    });
+  }
+  return out;
+}
+function localEinvoiceXml(tpl, data, override) {
+  const options = declaredEinvoice(tpl, override ?? {});
+  if (!options)
+    throw new DevkitError(`${tpl.slug} declares no e-invoice`, "validation");
+  const result = (0, import_engine5.einvoiceXml)(data, options);
+  if (!result.ok)
+    throw new DevkitError(
+      [
+        `${tpl.slug}: the _invoice block does not make an e-invoice`,
+        ...result.problems.map((problem) => `  ${problem.message}`)
+      ].join("\n"),
+      "validation"
+    );
+  return { xml: result.xml, invoice: result.invoice, options };
+}
+
+// packages/devkit/src/lib/accessibility.ts
+var import_engine6 = require("@formfeed/engine");
+var nowhere3 = { start: { line: 1, column: 1 }, end: { line: 1, column: 1 } };
+var about = (severity, code, message) => ({
+  file: "settings.json",
+  diagnostics: [{ severity, code, message, range: nowhere3 }]
+});
+function diagnoseAccessibility(tpl) {
+  const declared = tpl.settings.pdf?.ua;
+  if (declared !== void 0 && !(0, import_engine6.isUaSetting)(declared))
+    return [
+      about(
+        "error",
+        "accessibility-setting",
+        'pdf.ua is true, false or { "check": "strict" | "report" }'
+      )
+    ];
+  const ua = (0, import_engine6.resolveUa)(declared);
+  if (!ua) return [];
+  if (tpl.meta.kind === "image")
+    return [
+      about(
+        "warning",
+        "accessibility-image",
+        "settings.json declares pdf.ua, which an image template never produces: PDF/UA is a format of PDF"
+      )
+    ];
+  if ((0, import_engine6.isOfficeKind)(tpl.meta.kind))
+    return [about("error", "accessibility-office", import_engine6.UA_REFUSALS.office)];
+  const out = [];
+  const body = [];
+  for (const found of (0, import_engine6.staticAuditDiagnostics)(
+    {
+      engine: tpl.meta.engine,
+      html: tpl.html,
+      head: tpl.head,
+      title: tpl.settings.pdf?.metadata?.title
+    },
+    ua
+  )) {
+    if (!found.location) {
+      out.push(about(found.severity, found.code, found.message));
+      continue;
+    }
+    body.push({
+      severity: found.severity,
+      code: found.code,
+      message: found.message,
+      range: { start: found.location, end: found.location }
+    });
+  }
+  if (body.length)
+    out.push({ file: templateFileName(tpl.meta.kind), diagnostics: body });
+  return out;
+}
+
+// packages/devkit/src/lib/files.ts
+var import_node_crypto2 = require("node:crypto");
+var import_node_fs5 = require("node:fs");
+var import_node_path5 = require("node:path");
 
 // packages/api-types/src/lib/assets.ts
 var SEGMENT = "[A-Za-z0-9][A-Za-z0-9._-]*";
@@ -844,25 +998,25 @@ function sha256File(bytes) {
 }
 function listLocalFiles(project) {
   const listing = { files: [], skipped: [] };
-  if (!(0, import_node_fs4.existsSync)(project.filesDir)) return listing;
+  if (!(0, import_node_fs5.existsSync)(project.filesDir)) return listing;
   const walk2 = (dir) => {
-    for (const entry of (0, import_node_fs4.readdirSync)(dir, { withFileTypes: true })) {
+    for (const entry of (0, import_node_fs5.readdirSync)(dir, { withFileTypes: true })) {
       if (entry.name.startsWith(".")) continue;
-      const path = (0, import_node_path4.join)(dir, entry.name);
+      const path = (0, import_node_path5.join)(dir, entry.name);
       if (entry.isDirectory()) {
         walk2(path);
         continue;
       }
       if (!entry.isFile()) continue;
-      const name = (0, import_node_path4.relative)(project.filesDir, path).split(import_node_path4.sep).join("/");
-      const size = (0, import_node_fs4.statSync)(path).size;
+      const name = (0, import_node_path5.relative)(project.filesDir, path).split(import_node_path5.sep).join("/");
+      const size = (0, import_node_fs5.statSync)(path).size;
       const contentType = contentTypeFor(name);
       const reason = !isAssetName(name) ? "the name has characters a library name cannot have (letters, digits, dot, dash, underscore)" : !contentType ? "not an image or a PDF" : size === 0 ? "empty" : size > ASSET_MAX_BYTES ? `larger than ${ASSET_MAX_BYTES / 1024 / 1024} MB` : null;
       if (reason) {
         listing.skipped.push({ path, reason });
         continue;
       }
-      const bytes = (0, import_node_fs4.readFileSync)(path);
+      const bytes = (0, import_node_fs5.readFileSync)(path);
       listing.files.push({ name, path, bytes: size, sha256: sha256File(bytes), contentType });
     }
   };
@@ -872,14 +1026,14 @@ function listLocalFiles(project) {
 }
 function localFilePath(project, name) {
   if (!isAssetName(name)) throw new DevkitError(`"${name}" is not a library file name`);
-  const path = (0, import_node_path4.resolve)(project.filesDir, ...name.split("/"));
-  if (!path.startsWith((0, import_node_path4.resolve)(project.filesDir) + import_node_path4.sep)) throw new DevkitError(`"${name}" is not inside the files folder`);
+  const path = (0, import_node_path5.resolve)(project.filesDir, ...name.split("/"));
+  if (!path.startsWith((0, import_node_path5.resolve)(project.filesDir) + import_node_path5.sep)) throw new DevkitError(`"${name}" is not inside the files folder`);
   return path;
 }
 function writeLocalFile(project, name, bytes) {
   const path = localFilePath(project, name);
-  (0, import_node_fs4.mkdirSync)((0, import_node_path4.dirname)(path), { recursive: true });
-  (0, import_node_fs4.writeFileSync)(path, bytes);
+  (0, import_node_fs5.mkdirSync)((0, import_node_path5.dirname)(path), { recursive: true });
+  (0, import_node_fs5.writeFileSync)(path, bytes);
   return path;
 }
 
@@ -947,7 +1101,7 @@ function isRecord(value) {
 }
 
 // packages/devkit/src/lib/types/index.ts
-var import_engine5 = require("@formfeed/engine");
+var import_engine7 = require("@formfeed/engine");
 
 // packages/devkit/src/lib/types/model.ts
 var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1435,7 +1589,7 @@ function localTypeSource(tpl) {
   const sets = Object.values(tpl.dataSets);
   return {
     slug: tpl.slug,
-    schema: (0, import_engine5.inferSchemaFromDataSets)(sets.length ? sets : [{}]),
+    schema: (0, import_engine7.inferSchemaFromDataSets)(sets.length ? sets : [{}]),
     origin: "inferred"
   };
 }
@@ -1447,10 +1601,13 @@ function localTypeSource(tpl) {
   collectPartials,
   contentHash,
   contentTypeFor,
+  declaredEinvoice,
   defaultData,
   defaultProjectConfig,
   defaultTypesFile,
   diagnose,
+  diagnoseAccessibility,
+  diagnoseEinvoice,
   findProject,
   generateTypes,
   htmlSnapshot,
@@ -1458,6 +1615,7 @@ function localTypeSource(tpl) {
   listLocalFiles,
   listTemplateSlugs,
   loadProject,
+  localEinvoiceXml,
   localFilePath,
   localTypeSource,
   officeSnapshot,

package/index.js

@@ -543,7 +543,8 @@ import {
   pagedDocument,
   parseDesign,
   renderOffice,
-  renderVersion
+  renderVersion,
+  resolveUa
 } from "@formfeed/engine";
 function diagnose(tpl, sampleData) {
   if (tpl.file) return diagnoseOffice(tpl, tpl.file.bytes, sampleData);
@@ -757,13 +758,175 @@ function previewDocument(tpl, rendered, mode, pagedScriptUrl) {
     settings: rendered.settings,
     kind
   };
-  return mode === "paged" && kind === "pdf" ? pagedDocument(draft, { pagedScriptUrl }) : flowDocument(draft);
+  const audit = kind === "pdf" && resolveUa(rendered.settings.pdf?.ua) !== null;
+  return mode === "paged" && kind === "pdf" ? pagedDocument(draft, { pagedScriptUrl, audit }) : flowDocument(draft, { audit });
+}
+
+// packages/devkit/src/lib/einvoice.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
+import { join as join4 } from "node:path";
+import {
+  INVOICE_DATA_KEY,
+  einvoiceXml,
+  invoicePathSegments,
+  locateJsonPath,
+  resolveEinvoiceOptions
+} from "@formfeed/engine";
+function declaredEinvoice(tpl, override) {
+  const resolved = resolveEinvoiceOptions(tpl.settings.einvoice, override);
+  if (!resolved.ok)
+    throw new DevkitError(
+      `${tpl.slug}: e-invoice ${resolved.field} "${resolved.value}": ${resolved.reason}`,
+      "validation"
+    );
+  return resolved.options;
+}
+var nowhere2 = { start: { line: 1, column: 1 }, end: { line: 1, column: 1 } };
+function diagnoseEinvoice(tpl) {
+  let options;
+  try {
+    options = declaredEinvoice(tpl);
+  } catch (e) {
+    return [
+      {
+        dataSet: "",
+        file: "settings.json",
+        diagnostics: [
+          {
+            severity: "error",
+            code: "einvoice-profile",
+            message: e instanceof Error ? e.message : String(e),
+            range: nowhere2
+          }
+        ]
+      }
+    ];
+  }
+  if (!options) return [];
+  if (tpl.meta.kind === "image")
+    return [
+      {
+        dataSet: "",
+        file: "settings.json",
+        diagnostics: [
+          {
+            severity: "warning",
+            code: "einvoice-image",
+            message: "settings.json declares an e-invoice, which an image template never produces: an e-invoice is a PDF",
+            range: nowhere2
+          }
+        ]
+      }
+    ];
+  const out = [];
+  for (const [name, data] of Object.entries(tpl.dataSets)) {
+    const result = einvoiceXml(data, options);
+    if (result.ok) continue;
+    const file = `data/${name}.json`;
+    const path = join4(tpl.dir, "data", `${name}.json`);
+    const text2 = existsSync4(path) ? readFileSync4(path, "utf8") : null;
+    out.push({
+      dataSet: name,
+      file,
+      diagnostics: result.problems.map((problem) => {
+        const at = text2 ? locateJsonPath(text2, [
+          INVOICE_DATA_KEY,
+          ...invoicePathSegments(problem.path)
+        ]) : null;
+        const start = at ? { line: at.line, column: at.column } : nowhere2.start;
+        return {
+          severity: "error",
+          code: `einvoice-${problem.code.replace(/_/g, "-")}`,
+          message: problem.message,
+          range: { start, end: start }
+        };
+      })
+    });
+  }
+  return out;
+}
+function localEinvoiceXml(tpl, data, override) {
+  const options = declaredEinvoice(tpl, override ?? {});
+  if (!options)
+    throw new DevkitError(`${tpl.slug} declares no e-invoice`, "validation");
+  const result = einvoiceXml(data, options);
+  if (!result.ok)
+    throw new DevkitError(
+      [
+        `${tpl.slug}: the _invoice block does not make an e-invoice`,
+        ...result.problems.map((problem) => `  ${problem.message}`)
+      ].join("\n"),
+      "validation"
+    );
+  return { xml: result.xml, invoice: result.invoice, options };
+}
+
+// packages/devkit/src/lib/accessibility.ts
+import {
+  UA_REFUSALS,
+  isOfficeKind as isOfficeKind3,
+  isUaSetting,
+  resolveUa as resolveUa2,
+  staticAuditDiagnostics
+} from "@formfeed/engine";
+var nowhere3 = { start: { line: 1, column: 1 }, end: { line: 1, column: 1 } };
+var about = (severity, code, message) => ({
+  file: "settings.json",
+  diagnostics: [{ severity, code, message, range: nowhere3 }]
+});
+function diagnoseAccessibility(tpl) {
+  const declared = tpl.settings.pdf?.ua;
+  if (declared !== void 0 && !isUaSetting(declared))
+    return [
+      about(
+        "error",
+        "accessibility-setting",
+        'pdf.ua is true, false or { "check": "strict" | "report" }'
+      )
+    ];
+  const ua = resolveUa2(declared);
+  if (!ua) return [];
+  if (tpl.meta.kind === "image")
+    return [
+      about(
+        "warning",
+        "accessibility-image",
+        "settings.json declares pdf.ua, which an image template never produces: PDF/UA is a format of PDF"
+      )
+    ];
+  if (isOfficeKind3(tpl.meta.kind))
+    return [about("error", "accessibility-office", UA_REFUSALS.office)];
+  const out = [];
+  const body = [];
+  for (const found of staticAuditDiagnostics(
+    {
+      engine: tpl.meta.engine,
+      html: tpl.html,
+      head: tpl.head,
+      title: tpl.settings.pdf?.metadata?.title
+    },
+    ua
+  )) {
+    if (!found.location) {
+      out.push(about(found.severity, found.code, found.message));
+      continue;
+    }
+    body.push({
+      severity: found.severity,
+      code: found.code,
+      message: found.message,
+      range: { start: found.location, end: found.location }
+    });
+  }
+  if (body.length)
+    out.push({ file: templateFileName(tpl.meta.kind), diagnostics: body });
+  return out;
 }
 
 // packages/devkit/src/lib/files.ts
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync2, writeFileSync as writeFileSync4 } from "node:fs";
-import { dirname as dirname3, join as join4, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync5, statSync as statSync2, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname3, join as join5, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
 
 // packages/api-types/src/lib/assets.ts
 var SEGMENT = "[A-Za-z0-9][A-Za-z0-9._-]*";
@@ -795,11 +958,11 @@ function sha256File(bytes) {
 }
 function listLocalFiles(project) {
   const listing = { files: [], skipped: [] };
-  if (!existsSync4(project.filesDir)) return listing;
+  if (!existsSync5(project.filesDir)) return listing;
   const walk2 = (dir) => {
     for (const entry of readdirSync2(dir, { withFileTypes: true })) {
       if (entry.name.startsWith(".")) continue;
-      const path = join4(dir, entry.name);
+      const path = join5(dir, entry.name);
       if (entry.isDirectory()) {
         walk2(path);
         continue;
@@ -813,7 +976,7 @@ function listLocalFiles(project) {
         listing.skipped.push({ path, reason });
         continue;
       }
-      const bytes = readFileSync4(path);
+      const bytes = readFileSync5(path);
       listing.files.push({ name, path, bytes: size, sha256: sha256File(bytes), contentType });
     }
   };
@@ -1397,10 +1560,13 @@ export {
   collectPartials,
   contentHash,
   contentTypeFor,
+  declaredEinvoice,
   defaultData,
   defaultProjectConfig,
   defaultTypesFile,
   diagnose,
+  diagnoseAccessibility,
+  diagnoseEinvoice,
   findProject,
   generateTypes,
   htmlSnapshot,
@@ -1408,6 +1574,7 @@ export {
   listLocalFiles,
   listTemplateSlugs,
   loadProject,
+  localEinvoiceXml,
   localFilePath,
   localTypeSource,
   officeSnapshot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formfeed/devkit",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "Formfeed template folders, project config and local rendering, shared by the CLI and @formfeed/testing.",
   "license": "MIT",
   "type": "module",
@@ -30,8 +30,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@formfeed/engine": "0.3.11",
-    "@formfeed/sdk": "0.3.11"
+    "@formfeed/engine": "0.3.13",
+    "@formfeed/sdk": "0.3.13"
   },
   "keywords": [
     "formfeed",

package/types/index.d.cts

@@ -1,16 +1,20 @@
 export { DevkitError } from './lib/errors.cjs';
-export { defaultProjectConfig, findProject, isIgnored, loadProject, projectAround, writeProjectConfig } from './lib/project-config.cjs';
+export { defaultProjectConfig, findProject, isIgnored, loadProject, projectAround, writeProjectConfig, } from './lib/project-config.cjs';
 export type { Project, ProjectConfig } from './lib/project-config.cjs';
 export { contentHash, defaultData, listTemplateSlugs, officeVersionPayload, partialContentHash, partialResolver, readState, readTemplate, recordSharedPartial, recordSync, sharedPartialNames, sharedPartialPath, templateDir, templateFileName, titleFromSlug, versionPayload, writePartials, writeState, writeTemplate, } from './lib/project.cjs';
-export type { LocalOfficeFile, LocalTemplate, ProjectState, SharedPartialState, TemplateMeta, TemplateState } from './lib/project.cjs';
+export type { LocalOfficeFile, LocalTemplate, ProjectState, SharedPartialState, TemplateMeta, TemplateState, } from './lib/project.cjs';
 export { brandFromJson, brandPath, readBrand, writeBrand } from './lib/brand.cjs';
 export { collectPartials } from './lib/partials.cjs';
 export type { CollectedPartials } from './lib/partials.cjs';
-export { diagnose, htmlSnapshot, officeSnapshot, prettyXml, previewDocument, renderContext, renderLocal, renderOfficeLocal, renderedSettings } from './lib/local-render.cjs';
+export { diagnose, htmlSnapshot, officeSnapshot, prettyXml, previewDocument, renderContext, renderLocal, renderOfficeLocal, renderedSettings, } from './lib/local-render.cjs';
 export type { LocalDiagnostic, OfficeLocalOptions } from './lib/local-render.cjs';
-export { contentTypeFor, listLocalFiles, localFilePath, sha256File, writeLocalFile } from './lib/files.cjs';
+export { declaredEinvoice, diagnoseEinvoice, localEinvoiceXml, } from './lib/einvoice.cjs';
+export type { DataSetDiagnostics } from './lib/einvoice.cjs';
+export { diagnoseAccessibility } from './lib/accessibility.cjs';
+export type { FileDiagnostics } from './lib/accessibility.cjs';
+export { contentTypeFor, listLocalFiles, localFilePath, sha256File, writeLocalFile, } from './lib/files.cjs';
 export type { LocalFile, LocalFileListing } from './lib/files.cjs';
 export type { LocalRenderOptions } from './lib/local-render.cjs';
 export { parseRedactPath, redactData, redactString } from './lib/redact.cjs';
 export { defaultTypesFile, generateTypes, localTypeSource } from './lib/types/index.cjs';
-export type { SchemaOrigin, TypeScriptOptions, TypeSource, TypesLanguage } from './lib/types/index.cjs';
+export type { SchemaOrigin, TypeScriptOptions, TypeSource, TypesLanguage, } from './lib/types/index.cjs';

package/types/index.d.ts

@@ -1,16 +1,20 @@
 export { DevkitError } from './lib/errors.js';
-export { defaultProjectConfig, findProject, isIgnored, loadProject, projectAround, writeProjectConfig } from './lib/project-config.js';
+export { defaultProjectConfig, findProject, isIgnored, loadProject, projectAround, writeProjectConfig, } from './lib/project-config.js';
 export type { Project, ProjectConfig } from './lib/project-config.js';
 export { contentHash, defaultData, listTemplateSlugs, officeVersionPayload, partialContentHash, partialResolver, readState, readTemplate, recordSharedPartial, recordSync, sharedPartialNames, sharedPartialPath, templateDir, templateFileName, titleFromSlug, versionPayload, writePartials, writeState, writeTemplate, } from './lib/project.js';
-export type { LocalOfficeFile, LocalTemplate, ProjectState, SharedPartialState, TemplateMeta, TemplateState } from './lib/project.js';
+export type { LocalOfficeFile, LocalTemplate, ProjectState, SharedPartialState, TemplateMeta, TemplateState, } from './lib/project.js';
 export { brandFromJson, brandPath, readBrand, writeBrand } from './lib/brand.js';
 export { collectPartials } from './lib/partials.js';
 export type { CollectedPartials } from './lib/partials.js';
-export { diagnose, htmlSnapshot, officeSnapshot, prettyXml, previewDocument, renderContext, renderLocal, renderOfficeLocal, renderedSettings } from './lib/local-render.js';
+export { diagnose, htmlSnapshot, officeSnapshot, prettyXml, previewDocument, renderContext, renderLocal, renderOfficeLocal, renderedSettings, } from './lib/local-render.js';
 export type { LocalDiagnostic, OfficeLocalOptions } from './lib/local-render.js';
-export { contentTypeFor, listLocalFiles, localFilePath, sha256File, writeLocalFile } from './lib/files.js';
+export { declaredEinvoice, diagnoseEinvoice, localEinvoiceXml, } from './lib/einvoice.js';
+export type { DataSetDiagnostics } from './lib/einvoice.js';
+export { diagnoseAccessibility } from './lib/accessibility.js';
+export type { FileDiagnostics } from './lib/accessibility.js';
+export { contentTypeFor, listLocalFiles, localFilePath, sha256File, writeLocalFile, } from './lib/files.js';
 export type { LocalFile, LocalFileListing } from './lib/files.js';
 export type { LocalRenderOptions } from './lib/local-render.js';
 export { parseRedactPath, redactData, redactString } from './lib/redact.js';
 export { defaultTypesFile, generateTypes, localTypeSource } from './lib/types/index.js';
-export type { SchemaOrigin, TypeScriptOptions, TypeSource, TypesLanguage } from './lib/types/index.js';
+export type { SchemaOrigin, TypeScriptOptions, TypeSource, TypesLanguage, } from './lib/types/index.js';

package/types/lib/accessibility.d.cts

@@ -0,0 +1,21 @@
+import type { LocalDiagnostic } from './local-render.cjs';
+import { type LocalTemplate } from './project.cjs';
+/**
+ * `pdf.ua` of a template folder (plan 21 §6): what can be said about a template that declares
+ * PDF/UA-1 without rendering it. `formfeed validate` and the MCP server's validation report it. It
+ * is the static half of the template check: a document without a title, an image written without
+ * `alt`, and a declaration the API will refuse. What depends on the data (heading levels, table
+ * rows, a chart's name) is found in the rendered page, by the editor's preview and by the render.
+ */
+/** The findings of one file of a template folder. */
+export interface FileDiagnostics {
+    /** Relative to the template folder: `template.html`, `settings.json`. */
+    file: string;
+    diagnostics: LocalDiagnostic[];
+}
+/**
+ * Empty for a template that does not declare `pdf.ua`. A fault the validator fails the file for is
+ * an error where the template is strict, since every render of it then fails, and a warning where
+ * it only reports; what a reader stumbles over without a rule failing is a warning either way.
+ */
+export declare function diagnoseAccessibility(tpl: LocalTemplate): FileDiagnostics[];

package/types/lib/accessibility.d.ts

@@ -0,0 +1,21 @@
+import type { LocalDiagnostic } from './local-render.js';
+import { type LocalTemplate } from './project.js';
+/**
+ * `pdf.ua` of a template folder (plan 21 §6): what can be said about a template that declares
+ * PDF/UA-1 without rendering it. `formfeed validate` and the MCP server's validation report it. It
+ * is the static half of the template check: a document without a title, an image written without
+ * `alt`, and a declaration the API will refuse. What depends on the data (heading levels, table
+ * rows, a chart's name) is found in the rendered page, by the editor's preview and by the render.
+ */
+/** The findings of one file of a template folder. */
+export interface FileDiagnostics {
+    /** Relative to the template folder: `template.html`, `settings.json`. */
+    file: string;
+    diagnostics: LocalDiagnostic[];
+}
+/**
+ * Empty for a template that does not declare `pdf.ua`. A fault the validator fails the file for is
+ * an error where the template is strict, since every render of it then fails, and a warning where
+ * it only reports; what a reader stumbles over without a rule failing is a warning either way.
+ */
+export declare function diagnoseAccessibility(tpl: LocalTemplate): FileDiagnostics[];

package/types/lib/einvoice.d.cts

@@ -0,0 +1,37 @@
+import { type EinvoiceOptions, type EinvoiceOptionsInput, type Invoice } from '@formfeed/engine';
+import type { LocalDiagnostic } from './local-render.cjs';
+import type { LocalTemplate } from './project.cjs';
+/**
+ * The e-invoice of a template folder (spec 17): what `settings.json` declares, the check of every
+ * data set against it, and the XML itself. All of it runs offline, with the code the API runs, so
+ * what `formfeed validate` accepts the API accepts too.
+ */
+/**
+ * The e-invoice a template declares in `settings.json`, with every default filled in; `null` when
+ * it declares none. `override` is merged over it like a request's `post.einvoice`; `{}` asks for an
+ * e-invoice with the defaults from a template that declares nothing.
+ */
+export declare function declaredEinvoice(tpl: LocalTemplate, override?: EinvoiceOptionsInput | false): EinvoiceOptions | null;
+/** The findings of one data set, with the file they are in. */
+export interface DataSetDiagnostics {
+    dataSet: string;
+    /** Relative to the template folder: `data/default.json`. */
+    file: string;
+    diagnostics: LocalDiagnostic[];
+}
+/**
+ * Every data set of an invoice template against the `_invoice` schema and the rules of EN 16931
+ * (spec 17 §8). Each is an error: a render with that data fails with `einvoice_data_invalid`, and a
+ * template that declares an e-invoice renders nothing else. Empty for a template that declares
+ * none; one warning for an image template, where the declaration has no effect.
+ */
+export declare function diagnoseEinvoice(tpl: LocalTemplate): DataSetDiagnostics[];
+/**
+ * The XML of one data set, as a render of the template would embed it. Throws a validation error
+ * that lists what is wrong with the block when it does not pass.
+ */
+export declare function localEinvoiceXml(tpl: LocalTemplate, data: unknown, override?: EinvoiceOptionsInput): {
+    xml: string;
+    invoice: Invoice;
+    options: EinvoiceOptions;
+};

package/types/lib/einvoice.d.ts

@@ -0,0 +1,37 @@
+import { type EinvoiceOptions, type EinvoiceOptionsInput, type Invoice } from '@formfeed/engine';
+import type { LocalDiagnostic } from './local-render.js';
+import type { LocalTemplate } from './project.js';
+/**
+ * The e-invoice of a template folder (spec 17): what `settings.json` declares, the check of every
+ * data set against it, and the XML itself. All of it runs offline, with the code the API runs, so
+ * what `formfeed validate` accepts the API accepts too.
+ */
+/**
+ * The e-invoice a template declares in `settings.json`, with every default filled in; `null` when
+ * it declares none. `override` is merged over it like a request's `post.einvoice`; `{}` asks for an
+ * e-invoice with the defaults from a template that declares nothing.
+ */
+export declare function declaredEinvoice(tpl: LocalTemplate, override?: EinvoiceOptionsInput | false): EinvoiceOptions | null;
+/** The findings of one data set, with the file they are in. */
+export interface DataSetDiagnostics {
+    dataSet: string;
+    /** Relative to the template folder: `data/default.json`. */
+    file: string;
+    diagnostics: LocalDiagnostic[];
+}
+/**
+ * Every data set of an invoice template against the `_invoice` schema and the rules of EN 16931
+ * (spec 17 §8). Each is an error: a render with that data fails with `einvoice_data_invalid`, and a
+ * template that declares an e-invoice renders nothing else. Empty for a template that declares
+ * none; one warning for an image template, where the declaration has no effect.
+ */
+export declare function diagnoseEinvoice(tpl: LocalTemplate): DataSetDiagnostics[];
+/**
+ * The XML of one data set, as a render of the template would embed it. Throws a validation error
+ * that lists what is wrong with the block when it does not pass.
+ */
+export declare function localEinvoiceXml(tpl: LocalTemplate, data: unknown, override?: EinvoiceOptionsInput): {
+    xml: string;
+    invoice: Invoice;
+    options: EinvoiceOptions;
+};