@formfeed/devkit 0.3.10 → 0.3.12

package/index.js

@@ -95,7 +95,15 @@ function writeProjectConfig(root, config) {
 
 // packages/devkit/src/lib/project.ts
 import { createHash } from "node:crypto";
-import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, readdirSync, rmSync, statSync, writeFileSync as writeFileSync2 } from "node:fs";
+import {
+  existsSync as existsSync2,
+  mkdirSync,
+  readFileSync as readFileSync2,
+  readdirSync,
+  rmSync,
+  statSync,
+  writeFileSync as writeFileSync2
+} from "node:fs";
 import { basename, dirname as dirname2, extname, join as join2 } from "node:path";
 import {
   isOfficeKind,
@@ -149,16 +157,23 @@ function readJson(path, what) {
   try {
     return JSON.parse(text2);
   } catch (e) {
-    throw new DevkitError(`${what} is not valid JSON: ${path} (${e instanceof Error ? e.message : e})`, "validation");
+    throw new DevkitError(
+      `${what} is not valid JSON: ${path} (${e instanceof Error ? e.message : e})`,
+      "validation"
+    );
   }
 }
 var templateFileName = (kind) => isOfficeKind(kind) ? `template.${kind}` : "template.html";
 function sourceFilesIn(dir) {
-  return ["template.html", ...officeKinds.map((k) => `template.${k}`)].filter((name) => existsSync2(join2(dir, name)));
+  return ["template.html", ...officeKinds.map((k) => `template.${k}`)].filter(
+    (name) => existsSync2(join2(dir, name))
+  );
 }
 function listTemplateSlugs(project) {
   if (!existsSync2(project.templatesDir)) return [];
-  return readdirSync(project.templatesDir).filter((name) => sourceFilesIn(join2(project.templatesDir, name)).length > 0).sort();
+  return readdirSync(project.templatesDir).filter(
+    (name) => sourceFilesIn(join2(project.templatesDir, name)).length > 0
+  ).sort();
 }
 function templateDir(project, slug) {
   return join2(project.templatesDir, slug);
@@ -167,22 +182,41 @@ var sha256Of = (bytes) => createHash("sha256").update(bytes).digest("hex");
 function readOfficeFile(dir, name) {
   const path = join2(dir, name);
   const bytes = new Uint8Array(readFileSync2(path));
-  return { format: extname(name).slice(1), path, bytes, sha256: sha256Of(bytes) };
+  return {
+    format: extname(name).slice(1),
+    path,
+    bytes,
+    sha256: sha256Of(bytes)
+  };
 }
 function readTemplate(project, slug) {
   const dir = templateDir(project, slug);
   const sources = sourceFilesIn(dir);
   if (sources.length === 0)
-    throw new DevkitError(`No template "${slug}" in ${project.templatesDir} (template.html, template.docx or template.pptx missing)`);
+    throw new DevkitError(
+      `No template "${slug}" in ${project.templatesDir} (template.html, template.docx or template.pptx missing)`
+    );
   if (sources.length > 1)
-    throw new DevkitError(`${dir} holds ${sources.join(" and ")}; a template folder has one of them`, "validation");
+    throw new DevkitError(
+      `${dir} holds ${sources.join(" and ")}; a template folder has one of them`,
+      "validation"
+    );
   const file = sources[0] === "template.html" ? null : readOfficeFile(dir, sources[0]);
   const html = file ? "" : readText(join2(dir, "template.html")) ?? "";
-  const metaFile = readJson(join2(dir, "template.json"), "template.json") ?? {};
+  const metaFile = readJson(
+    join2(dir, "template.json"),
+    "template.json"
+  ) ?? {};
   if (file && metaFile.kind && metaFile.kind !== file.format)
-    throw new DevkitError(`${slug}: template.json says kind "${metaFile.kind}", but the folder holds ${basename(file.path)}`, "validation");
+    throw new DevkitError(
+      `${slug}: template.json says kind "${metaFile.kind}", but the folder holds ${basename(file.path)}`,
+      "validation"
+    );
   if (!file && isOfficeKind(metaFile.kind))
-    throw new DevkitError(`${slug}: template.json says kind "${metaFile.kind}", but the folder holds template.html instead of template.${metaFile.kind}`, "validation");
+    throw new DevkitError(
+      `${slug}: template.json says kind "${metaFile.kind}", but the folder holds template.html instead of template.${metaFile.kind}`,
+      "validation"
+    );
   const meta = {
     name: metaFile.name ?? titleFromSlug(slug),
     kind: file?.format ?? metaFile.kind ?? "pdf",
@@ -190,19 +224,38 @@ function readTemplate(project, slug) {
     description: metaFile.description ?? null,
     tags: metaFile.tags ?? []
   };
-  const settings = { ...readJson(join2(dir, "settings.json"), "settings.json") ?? {} };
+  const settings = {
+    ...readJson(
+      join2(dir, "settings.json"),
+      "settings.json"
+    ) ?? {}
+  };
   const header = file ? null : readText(join2(dir, "header.html"));
   const footer = file ? null : readText(join2(dir, "footer.html"));
-  if (header !== null && header.trim()) settings.header = { ...settings.header ?? {}, html: header };
-  if (footer !== null && footer.trim()) settings.footer = { ...settings.footer ?? {}, html: footer };
+  if (header !== null && header.trim())
+    settings.header = { ...settings.header ?? {}, html: header };
+  if (footer !== null && footer.trim())
+    settings.footer = { ...settings.footer ?? {}, html: footer };
+  const design = readJson(
+    join2(dir, "design.json"),
+    "design.json"
+  );
+  if (design) settings.design = design;
   const dataSets = {};
   const dataDir = join2(dir, "data");
   if (existsSync2(dataDir)) {
     for (const file2 of readdirSync(dataDir).filter((f) => f.endsWith(".json")).sort()) {
-      dataSets[basename(file2, ".json")] = readJson(join2(dataDir, file2), `data/${file2}`);
+      dataSets[basename(file2, ".json")] = readJson(
+        join2(dataDir, file2),
+        `data/${file2}`
+      );
     }
   }
-  const { partials, missing, shared } = file ? { partials: {}, missing: [], shared: [] } : collectPartials(project, meta.engine, [html, settings.header?.html, settings.footer?.html]);
+  const { partials, missing, shared } = file ? { partials: {}, missing: [], shared: [] } : collectPartials(project, meta.engine, [
+    html,
+    settings.header?.html,
+    settings.footer?.html
+  ]);
   return {
     slug,
     dir,
@@ -213,8 +266,14 @@ function readTemplate(project, slug) {
     head: file ? "" : readText(join2(dir, "head.html")) ?? "",
     settings,
     dataSets,
-    dataSchema: readJson(join2(dir, "schema.json"), "schema.json"),
-    i18n: readJson(join2(dir, "i18n.json"), "i18n.json"),
+    dataSchema: readJson(
+      join2(dir, "schema.json"),
+      "schema.json"
+    ),
+    i18n: readJson(
+      join2(dir, "i18n.json"),
+      "i18n.json"
+    ),
     partials,
     missingPartials: missing,
     sharedPartials: shared
@@ -224,35 +283,68 @@ function defaultData(tpl, name) {
   const names = Object.keys(tpl.dataSets);
   const chosen = name ?? (names.includes("default") ? "default" : names[0]);
   if (name && !(name in tpl.dataSets))
-    throw new DevkitError(`Data set "${name}" not found; available: ${names.join(", ") || "none"}`);
+    throw new DevkitError(
+      `Data set "${name}" not found; available: ${names.join(", ") || "none"}`
+    );
   return chosen ? { name: chosen, data: tpl.dataSets[chosen] } : { name: "empty", data: {} };
 }
 function writeTemplate(project, slug, meta, version, file) {
   const dir = templateDir(project, slug);
   const office = isOfficeKind(meta.kind);
-  if (office && !file) throw new DevkitError(`${slug} is a ${meta.kind} template; its document is needed to write the folder`);
+  if (office && !file)
+    throw new DevkitError(
+      `${slug} is a ${meta.kind} template; its document is needed to write the folder`
+    );
   mkdirSync(join2(dir, "data"), { recursive: true });
   const settings = { ...version.settings ?? {} };
   const header = office ? "" : settings.header?.html ?? "";
   const footer = office ? "" : settings.footer?.html ?? "";
   if (settings.header) settings.header = stripHtml(settings.header);
   if (settings.footer) settings.footer = stripHtml(settings.footer);
-  writeFileSync2(join2(dir, "template.json"), JSON.stringify(meta, null, 2) + "\n");
-  for (const name of ["template.html", ...officeKinds.map((k) => `template.${k}`)])
-    if (name !== templateFileName(meta.kind) && existsSync2(join2(dir, name))) rmSync(join2(dir, name));
+  const design = settings.design;
+  delete settings.design;
+  writeFileSync2(
+    join2(dir, "template.json"),
+    JSON.stringify(meta, null, 2) + "\n"
+  );
+  for (const name of [
+    "template.html",
+    ...officeKinds.map((k) => `template.${k}`)
+  ])
+    if (name !== templateFileName(meta.kind) && existsSync2(join2(dir, name)))
+      rmSync(join2(dir, name));
   if (office) writeFileSync2(join2(dir, templateFileName(meta.kind)), file);
   else writeFileSync2(join2(dir, "template.html"), version.html ?? "");
   writeOrRemove(join2(dir, "style.css"), office ? "" : version.css ?? "");
   writeOrRemove(join2(dir, "head.html"), office ? "" : version.head ?? "");
   writeOrRemove(join2(dir, "header.html"), header);
   writeOrRemove(join2(dir, "footer.html"), footer);
-  writeFileSync2(join2(dir, "settings.json"), JSON.stringify(settings, null, 2) + "\n");
-  writeFileSync2(join2(dir, "data", "default.json"), JSON.stringify(version.sample_data ?? {}, null, 2) + "\n");
+  writeFileSync2(
+    join2(dir, "settings.json"),
+    JSON.stringify(settings, null, 2) + "\n"
+  );
+  writeOrRemove(
+    join2(dir, "design.json"),
+    design && typeof design === "object" ? JSON.stringify(design, null, 2) + "\n" : ""
+  );
+  writeFileSync2(
+    join2(dir, "data", "default.json"),
+    JSON.stringify(version.sample_data ?? {}, null, 2) + "\n"
+  );
   for (const [name, data] of Object.entries(version.data_sets ?? {}))
     if (name !== "default" && /^[\w.-]+$/.test(name))
-      writeFileSync2(join2(dir, "data", `${name}.json`), JSON.stringify(data ?? {}, null, 2) + "\n");
-  writeOrRemove(join2(dir, "schema.json"), version.data_schema ? JSON.stringify(version.data_schema, null, 2) + "\n" : "");
-  writeOrRemove(join2(dir, "i18n.json"), version.i18n ? JSON.stringify(version.i18n, null, 2) + "\n" : "");
+      writeFileSync2(
+        join2(dir, "data", `${name}.json`),
+        JSON.stringify(data ?? {}, null, 2) + "\n"
+      );
+  writeOrRemove(
+    join2(dir, "schema.json"),
+    version.data_schema ? JSON.stringify(version.data_schema, null, 2) + "\n" : ""
+  );
+  writeOrRemove(
+    join2(dir, "i18n.json"),
+    version.i18n ? JSON.stringify(version.i18n, null, 2) + "\n" : ""
+  );
   writePartials(project, version.partials ?? null);
   return dir;
 }
@@ -261,7 +353,10 @@ function writePartials(project, partials) {
   const changed = [];
   for (const [name, source] of Object.entries(partials ?? {})) {
     if (!partialName.test(name)) continue;
-    const path = join2(project.partialsDir, name.includes(".") ? name : `${name}.html`);
+    const path = join2(
+      project.partialsDir,
+      name.includes(".") ? name : `${name}.html`
+    );
     if (readText(path) === source) continue;
     mkdirSync(dirname2(path), { recursive: true });
     writeFileSync2(path, source);
@@ -307,17 +402,36 @@ function versionPayload(tpl) {
 function contentHash(tpl) {
   if (tpl.file) {
     const payload2 = officeVersionPayload(tpl);
-    const parts2 = [tpl.file.format, tpl.file.sha256, payload2.settings, payload2.sample_data, payload2.data_sets, payload2.data_schema, payload2.i18n];
+    const parts2 = [
+      tpl.file.format,
+      tpl.file.sha256,
+      payload2.settings,
+      payload2.sample_data,
+      payload2.data_sets,
+      payload2.data_schema,
+      payload2.i18n
+    ];
     return createHash("sha256").update(JSON.stringify(parts2)).digest("hex");
   }
   const payload = versionPayload(tpl);
-  const parts = [payload.html, payload.css, payload.head, payload.settings, payload.sample_data, payload.data_sets, payload.data_schema, payload.i18n];
+  const parts = [
+    payload.html,
+    payload.css,
+    payload.head,
+    payload.settings,
+    payload.sample_data,
+    payload.data_sets,
+    payload.data_schema,
+    payload.i18n
+  ];
   if (payload.partials) parts.push(payload.partials);
   return createHash("sha256").update(JSON.stringify(parts)).digest("hex");
 }
 var statePath = (project) => join2(project.root, ".formfeed", "state.json");
 function readState(project) {
-  return readJson(statePath(project), ".formfeed/state.json") ?? { templates: {} };
+  return readJson(statePath(project), ".formfeed/state.json") ?? {
+    templates: {}
+  };
 }
 function writeState(project, state) {
   mkdirSync(join2(project.root, ".formfeed"), { recursive: true });
@@ -343,7 +457,8 @@ function partialResolver(project) {
   return (name) => {
     for (const candidate of [name, `${name}.html`]) {
       const path = join2(project.partialsDir, candidate);
-      if (existsSync2(path) && statSync(path).isFile()) return readFileSync2(path, "utf8");
+      if (existsSync2(path) && statSync(path).isFile())
+        return readFileSync2(path, "utf8");
     }
     shared ??= new Set(Object.keys(readState(project).sharedPartials ?? {}));
     const normalised = normalisePartialName2(name);
@@ -364,7 +479,12 @@ function recordSharedPartial(project, name, remote, source) {
   const state = readState(project);
   state.sharedPartials = {
     ...state.sharedPartials ?? {},
-    [name]: { version: remote.version, engine: remote.engine, contentHash: partialContentHash(source), syncedAt: (/* @__PURE__ */ new Date()).toISOString() }
+    [name]: {
+      version: remote.version,
+      engine: remote.engine,
+      contentHash: partialContentHash(source),
+      syncedAt: (/* @__PURE__ */ new Date()).toISOString()
+    }
   };
   writeState(project, state);
 }
@@ -414,12 +534,14 @@ import {
   analyzeOffice,
   defaultHelpers,
   defaultLimits,
+  designOutputHash,
   flowDocument,
   getEngine as getEngine2,
   isOfficeKind as isOfficeKind2,
   mergeSettings,
   officeTextParts,
   pagedDocument,
+  parseDesign,
   renderOffice,
   renderVersion
 } from "@formfeed/engine";
@@ -435,7 +557,10 @@ function diagnose(tpl, sampleData) {
         severity: "error",
         code: "syntax-error",
         message: e.message,
-        range: { start: { line: e.line ?? 1, column: e.column ?? 1 }, end: { line: e.line ?? 1, column: (e.column ?? 1) + 1 } }
+        range: {
+          start: { line: e.line ?? 1, column: e.column ?? 1 },
+          end: { line: e.line ?? 1, column: (e.column ?? 1) + 1 }
+        }
       });
     } else throw e;
   }
@@ -445,7 +570,8 @@ function diagnose(tpl, sampleData) {
     ["footer", tpl.settings.footer?.html]
   ]) {
     if (!source) continue;
-    for (const d of engine.analyze(source, { sampleData }).diagnostics) diagnostics.push({ ...d, message: `${part}: ${d.message}` });
+    for (const d of engine.analyze(source, { sampleData }).diagnostics)
+      diagnostics.push({ ...d, message: `${part}: ${d.message}` });
   }
   for (const name of tpl.missingPartials)
     diagnostics.push({
@@ -455,8 +581,28 @@ function diagnose(tpl, sampleData) {
       message: `No partial "${name}" in the project's partials folder; if it is shared by the organisation, formfeed partials pull brings it`,
       range: { start: { line: 1, column: 1 }, end: { line: 1, column: 1 } }
     });
+  const design = designDiagnostic(tpl);
+  if (design) diagnostics.push(design);
   return diagnostics;
 }
+function designDiagnostic(tpl) {
+  if (tpl.settings.design === void 0) return null;
+  const parsed = parseDesign(tpl.settings.design);
+  if (!parsed.design)
+    return {
+      severity: "warning",
+      code: "design-invalid",
+      message: `design.json is not a design the app can open (${parsed.problems.slice(0, 3).join("; ")}); the template opens as code`,
+      range: nowhere
+    };
+  if (parsed.design.output === designOutputHash(tpl.html, tpl.css)) return null;
+  return {
+    severity: "warning",
+    code: "design-stale",
+    message: "template.html or style.css was edited after design.json was written; the app opens the template as code until you choose to keep the code or apply the design again",
+    range: nowhere
+  };
+}
 var nowhere = { start: { line: 1, column: 1 }, end: { line: 1, column: 1 } };
 function diagnoseOffice(tpl, file, sampleData) {
   let analysis;
@@ -464,7 +610,14 @@ function diagnoseOffice(tpl, file, sampleData) {
     analysis = analyzeOffice(file, { engine: tpl.meta.engine, sampleData });
   } catch (e) {
     const code = e.code;
-    return [{ severity: "error", code: typeof code === "string" ? code : "office-document-invalid", message: e instanceof Error ? e.message : String(e), range: nowhere }];
+    return [
+      {
+        severity: "error",
+        code: typeof code === "string" ? code : "office-document-invalid",
+        message: e instanceof Error ? e.message : String(e),
+        range: nowhere
+      }
+    ];
   }
   return analysis.diagnostics.map((d) => ({
     severity: d.severity,
@@ -476,17 +629,34 @@ function diagnoseOffice(tpl, file, sampleData) {
   }));
 }
 async function renderOfficeLocal(project, tpl, data, options = {}) {
-  if (!tpl.file) throw new DevkitError(`${tpl.slug} is not a Word or PowerPoint template`, "validation");
-  const context = renderContext(project, tpl, options.assetBaseUrl, options.brand);
+  if (!tpl.file)
+    throw new DevkitError(
+      `${tpl.slug} is not a Word or PowerPoint template`,
+      "validation"
+    );
+  const context = renderContext(
+    project,
+    tpl,
+    options.assetBaseUrl,
+    options.brand
+  );
   if (options.locale) context.locale = options.locale;
-  return renderOffice(tpl.file.bytes, { engine: tpl.meta.engine, data, context, images: options.images, random: options.random });
+  return renderOffice(tpl.file.bytes, {
+    engine: tpl.meta.engine,
+    data,
+    context,
+    images: options.images,
+    random: options.random
+  });
 }
 function htmlSnapshot(rendered) {
   let snapshot = rendered.document;
-  if (rendered.headerHtml) snapshot += `
+  if (rendered.headerHtml)
+    snapshot += `
 <!-- formfeed:header -->
 ${rendered.headerHtml}`;
-  if (rendered.footerHtml) snapshot += `
+  if (rendered.footerHtml)
+    snapshot += `
 <!-- formfeed:footer -->
 ${rendered.footerHtml}`;
   return snapshot;
@@ -539,7 +709,14 @@ async function renderLocal(project, tpl, data, options) {
   const ctx = renderContext(project, tpl, options.assetBaseUrl, options.brand);
   if (options.locale) ctx.locale = options.locale;
   return renderVersion(
-    { engine: tpl.meta.engine, html: tpl.html, css: tpl.css, head: tpl.head, settings: mergeSettings(tpl.settings), kind },
+    {
+      engine: tpl.meta.engine,
+      html: tpl.html,
+      css: tpl.css,
+      head: tpl.head,
+      settings: mergeSettings(tpl.settings),
+      kind
+    },
     data,
     ctx,
     options.mode,
@@ -549,16 +726,26 @@ async function renderLocal(project, tpl, data, options) {
 function renderedSettings(rendered) {
   const style = rendered.inlineCss ? `<style>${rendered.inlineCss}</style>` : "";
   const part = (settings2, html) => settings2?.html ? { ...settings2, html: `${style}${html ?? ""}` } : settings2;
-  const { settings } = rendered;
+  const { design: _design, ...settings } = rendered.settings;
+  void _design;
   return {
     ...settings,
     ...settings.header ? { header: part(settings.header, rendered.headerHtml) } : {},
     ...settings.footer ? { footer: part(settings.footer, rendered.footerHtml) } : {},
-    ...settings.pdf?.metadata?.title !== void 0 ? { pdf: { ...settings.pdf, metadata: { ...settings.pdf.metadata, title: rendered.title ?? "" } } } : {}
+    ...settings.pdf?.metadata?.title !== void 0 ? {
+      pdf: {
+        ...settings.pdf,
+        metadata: { ...settings.pdf.metadata, title: rendered.title ?? "" }
+      }
+    } : {}
   };
 }
 function htmlKind(tpl) {
-  if (isOfficeKind2(tpl.meta.kind)) throw new DevkitError(`${tpl.slug} is a ${tpl.meta.kind} template; fill it with renderOfficeLocal`, "validation");
+  if (isOfficeKind2(tpl.meta.kind))
+    throw new DevkitError(
+      `${tpl.slug} is a ${tpl.meta.kind} template; fill it with renderOfficeLocal`,
+      "validation"
+    );
   return tpl.meta.kind;
 }
 function previewDocument(tpl, rendered, mode, pagedScriptUrl) {
@@ -573,10 +760,109 @@ function previewDocument(tpl, rendered, mode, pagedScriptUrl) {
   return mode === "paged" && kind === "pdf" ? pagedDocument(draft, { pagedScriptUrl }) : flowDocument(draft);
 }
 
+// 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/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._-]*";
@@ -608,11 +894,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;
@@ -626,7 +912,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 });
     }
   };
@@ -1210,10 +1496,12 @@ export {
   collectPartials,
   contentHash,
   contentTypeFor,
+  declaredEinvoice,
   defaultData,
   defaultProjectConfig,
   defaultTypesFile,
   diagnose,
+  diagnoseEinvoice,
   findProject,
   generateTypes,
   htmlSnapshot,
@@ -1221,6 +1509,7 @@ export {
   listLocalFiles,
   listTemplateSlugs,
   loadProject,
+  localEinvoiceXml,
   localFilePath,
   localTypeSource,
   officeSnapshot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formfeed/devkit",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "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.10",
-    "@formfeed/sdk": "0.3.10"
+    "@formfeed/engine": "0.3.12",
+    "@formfeed/sdk": "0.3.12"
   },
   "keywords": [
     "formfeed",

package/types/index.d.cts

@@ -1,16 +1,18 @@
 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 { 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';