@formfeed/devkit 0.3.10 → 0.3.12

package/index.cjs

@@ -26,10 +26,12 @@ __export(index_exports, {
   collectPartials: () => collectPartials,
   contentHash: () => contentHash,
   contentTypeFor: () => contentTypeFor,
+  declaredEinvoice: () => declaredEinvoice,
   defaultData: () => defaultData,
   defaultProjectConfig: () => defaultProjectConfig,
   defaultTypesFile: () => defaultTypesFile,
   diagnose: () => diagnose,
+  diagnoseEinvoice: () => diagnoseEinvoice,
   findProject: () => findProject,
   generateTypes: () => generateTypes,
   htmlSnapshot: () => htmlSnapshot,
@@ -37,6 +39,7 @@ __export(index_exports, {
   listLocalFiles: () => listLocalFiles,
   listTemplateSlugs: () => listTemplateSlugs,
   loadProject: () => loadProject,
+  localEinvoiceXml: () => localEinvoiceXml,
   localFilePath: () => localFilePath,
   localTypeSource: () => localTypeSource,
   officeSnapshot: () => officeSnapshot,
@@ -221,16 +224,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) => (0, import_engine2.isOfficeKind)(kind) ? `template.${kind}` : "template.html";
 function sourceFilesIn(dir) {
-  return ["template.html", ...import_engine2.officeKinds.map((k) => `template.${k}`)].filter((name) => (0, import_node_fs2.existsSync)((0, import_node_path2.join)(dir, name)));
+  return ["template.html", ...import_engine2.officeKinds.map((k) => `template.${k}`)].filter(
+    (name) => (0, import_node_fs2.existsSync)((0, import_node_path2.join)(dir, name))
+  );
 }
 function listTemplateSlugs(project) {
   if (!(0, import_node_fs2.existsSync)(project.templatesDir)) return [];
-  return (0, import_node_fs2.readdirSync)(project.templatesDir).filter((name) => sourceFilesIn((0, import_node_path2.join)(project.templatesDir, name)).length > 0).sort();
+  return (0, import_node_fs2.readdirSync)(project.templatesDir).filter(
+    (name) => sourceFilesIn((0, import_node_path2.join)(project.templatesDir, name)).length > 0
+  ).sort();
 }
 function templateDir(project, slug) {
   return (0, import_node_path2.join)(project.templatesDir, slug);
@@ -239,22 +249,41 @@ var sha256Of = (bytes) => (0, import_node_crypto.createHash)("sha256").update(by
 function readOfficeFile(dir, name) {
   const path = (0, import_node_path2.join)(dir, name);
   const bytes = new Uint8Array((0, import_node_fs2.readFileSync)(path));
-  return { format: (0, import_node_path2.extname)(name).slice(1), path, bytes, sha256: sha256Of(bytes) };
+  return {
+    format: (0, import_node_path2.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((0, import_node_path2.join)(dir, "template.html")) ?? "";
-  const metaFile = readJson((0, import_node_path2.join)(dir, "template.json"), "template.json") ?? {};
+  const metaFile = readJson(
+    (0, import_node_path2.join)(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 ${(0, import_node_path2.basename)(file.path)}`, "validation");
+    throw new DevkitError(
+      `${slug}: template.json says kind "${metaFile.kind}", but the folder holds ${(0, import_node_path2.basename)(file.path)}`,
+      "validation"
+    );
   if (!file && (0, import_engine2.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",
@@ -262,19 +291,38 @@ function readTemplate(project, slug) {
     description: metaFile.description ?? null,
     tags: metaFile.tags ?? []
   };
-  const settings = { ...readJson((0, import_node_path2.join)(dir, "settings.json"), "settings.json") ?? {} };
+  const settings = {
+    ...readJson(
+      (0, import_node_path2.join)(dir, "settings.json"),
+      "settings.json"
+    ) ?? {}
+  };
   const header = file ? null : readText((0, import_node_path2.join)(dir, "header.html"));
   const footer = file ? null : readText((0, import_node_path2.join)(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(
+    (0, import_node_path2.join)(dir, "design.json"),
+    "design.json"
+  );
+  if (design) settings.design = design;
   const dataSets = {};
   const dataDir = (0, import_node_path2.join)(dir, "data");
   if ((0, import_node_fs2.existsSync)(dataDir)) {
     for (const file2 of (0, import_node_fs2.readdirSync)(dataDir).filter((f) => f.endsWith(".json")).sort()) {
-      dataSets[(0, import_node_path2.basename)(file2, ".json")] = readJson((0, import_node_path2.join)(dataDir, file2), `data/${file2}`);
+      dataSets[(0, import_node_path2.basename)(file2, ".json")] = readJson(
+        (0, import_node_path2.join)(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,
@@ -285,8 +333,14 @@ function readTemplate(project, slug) {
     head: file ? "" : readText((0, import_node_path2.join)(dir, "head.html")) ?? "",
     settings,
     dataSets,
-    dataSchema: readJson((0, import_node_path2.join)(dir, "schema.json"), "schema.json"),
-    i18n: readJson((0, import_node_path2.join)(dir, "i18n.json"), "i18n.json"),
+    dataSchema: readJson(
+      (0, import_node_path2.join)(dir, "schema.json"),
+      "schema.json"
+    ),
+    i18n: readJson(
+      (0, import_node_path2.join)(dir, "i18n.json"),
+      "i18n.json"
+    ),
     partials,
     missingPartials: missing,
     sharedPartials: shared
@@ -296,35 +350,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 = (0, import_engine2.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`
+    );
   (0, import_node_fs2.mkdirSync)((0, import_node_path2.join)(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);
-  (0, import_node_fs2.writeFileSync)((0, import_node_path2.join)(dir, "template.json"), JSON.stringify(meta, null, 2) + "\n");
-  for (const name of ["template.html", ...import_engine2.officeKinds.map((k) => `template.${k}`)])
-    if (name !== templateFileName(meta.kind) && (0, import_node_fs2.existsSync)((0, import_node_path2.join)(dir, name))) (0, import_node_fs2.rmSync)((0, import_node_path2.join)(dir, name));
+  const design = settings.design;
+  delete settings.design;
+  (0, import_node_fs2.writeFileSync)(
+    (0, import_node_path2.join)(dir, "template.json"),
+    JSON.stringify(meta, null, 2) + "\n"
+  );
+  for (const name of [
+    "template.html",
+    ...import_engine2.officeKinds.map((k) => `template.${k}`)
+  ])
+    if (name !== templateFileName(meta.kind) && (0, import_node_fs2.existsSync)((0, import_node_path2.join)(dir, name)))
+      (0, import_node_fs2.rmSync)((0, import_node_path2.join)(dir, name));
   if (office) (0, import_node_fs2.writeFileSync)((0, import_node_path2.join)(dir, templateFileName(meta.kind)), file);
   else (0, import_node_fs2.writeFileSync)((0, import_node_path2.join)(dir, "template.html"), version.html ?? "");
   writeOrRemove((0, import_node_path2.join)(dir, "style.css"), office ? "" : version.css ?? "");
   writeOrRemove((0, import_node_path2.join)(dir, "head.html"), office ? "" : version.head ?? "");
   writeOrRemove((0, import_node_path2.join)(dir, "header.html"), header);
   writeOrRemove((0, import_node_path2.join)(dir, "footer.html"), footer);
-  (0, import_node_fs2.writeFileSync)((0, import_node_path2.join)(dir, "settings.json"), JSON.stringify(settings, null, 2) + "\n");
-  (0, import_node_fs2.writeFileSync)((0, import_node_path2.join)(dir, "data", "default.json"), JSON.stringify(version.sample_data ?? {}, null, 2) + "\n");
+  (0, import_node_fs2.writeFileSync)(
+    (0, import_node_path2.join)(dir, "settings.json"),
+    JSON.stringify(settings, null, 2) + "\n"
+  );
+  writeOrRemove(
+    (0, import_node_path2.join)(dir, "design.json"),
+    design && typeof design === "object" ? JSON.stringify(design, null, 2) + "\n" : ""
+  );
+  (0, import_node_fs2.writeFileSync)(
+    (0, import_node_path2.join)(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))
-      (0, import_node_fs2.writeFileSync)((0, import_node_path2.join)(dir, "data", `${name}.json`), JSON.stringify(data ?? {}, null, 2) + "\n");
-  writeOrRemove((0, import_node_path2.join)(dir, "schema.json"), version.data_schema ? JSON.stringify(version.data_schema, null, 2) + "\n" : "");
-  writeOrRemove((0, import_node_path2.join)(dir, "i18n.json"), version.i18n ? JSON.stringify(version.i18n, null, 2) + "\n" : "");
+      (0, import_node_fs2.writeFileSync)(
+        (0, import_node_path2.join)(dir, "data", `${name}.json`),
+        JSON.stringify(data ?? {}, null, 2) + "\n"
+      );
+  writeOrRemove(
+    (0, import_node_path2.join)(dir, "schema.json"),
+    version.data_schema ? JSON.stringify(version.data_schema, null, 2) + "\n" : ""
+  );
+  writeOrRemove(
+    (0, import_node_path2.join)(dir, "i18n.json"),
+    version.i18n ? JSON.stringify(version.i18n, null, 2) + "\n" : ""
+  );
   writePartials(project, version.partials ?? null);
   return dir;
 }
@@ -333,7 +420,10 @@ function writePartials(project, partials) {
   const changed = [];
   for (const [name, source] of Object.entries(partials ?? {})) {
     if (!partialName.test(name)) continue;
-    const path = (0, import_node_path2.join)(project.partialsDir, name.includes(".") ? name : `${name}.html`);
+    const path = (0, import_node_path2.join)(
+      project.partialsDir,
+      name.includes(".") ? name : `${name}.html`
+    );
     if (readText(path) === source) continue;
     (0, import_node_fs2.mkdirSync)((0, import_node_path2.dirname)(path), { recursive: true });
     (0, import_node_fs2.writeFileSync)(path, source);
@@ -379,17 +469,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 (0, import_node_crypto.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 (0, import_node_crypto.createHash)("sha256").update(JSON.stringify(parts)).digest("hex");
 }
 var statePath = (project) => (0, import_node_path2.join)(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) {
   (0, import_node_fs2.mkdirSync)((0, import_node_path2.join)(project.root, ".formfeed"), { recursive: true });
@@ -415,7 +524,8 @@ function partialResolver(project) {
   return (name) => {
     for (const candidate of [name, `${name}.html`]) {
       const path = (0, import_node_path2.join)(project.partialsDir, candidate);
-      if ((0, import_node_fs2.existsSync)(path) && (0, import_node_fs2.statSync)(path).isFile()) return (0, import_node_fs2.readFileSync)(path, "utf8");
+      if ((0, import_node_fs2.existsSync)(path) && (0, import_node_fs2.statSync)(path).isFile())
+        return (0, import_node_fs2.readFileSync)(path, "utf8");
     }
     shared ??= new Set(Object.keys(readState(project).sharedPartials ?? {}));
     const normalised = (0, import_engine2.normalisePartialName)(name);
@@ -436,7 +546,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);
 }
@@ -494,7 +609,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;
   }
@@ -504,7 +622,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({
@@ -514,8 +633,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 = (0, import_engine4.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 === (0, import_engine4.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;
@@ -523,7 +662,14 @@ function diagnoseOffice(tpl, file, sampleData) {
     analysis = (0, import_engine4.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,
@@ -535,17 +681,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 (0, import_engine4.renderOffice)(tpl.file.bytes, { engine: tpl.meta.engine, data, context, images: options.images, random: options.random });
+  return (0, import_engine4.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;
@@ -598,7 +761,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 (0, import_engine4.renderVersion)(
-    { engine: tpl.meta.engine, html: tpl.html, css: tpl.css, head: tpl.head, settings: (0, import_engine4.mergeSettings)(tpl.settings), kind },
+    {
+      engine: tpl.meta.engine,
+      html: tpl.html,
+      css: tpl.css,
+      head: tpl.head,
+      settings: (0, import_engine4.mergeSettings)(tpl.settings),
+      kind
+    },
     data,
     ctx,
     options.mode,
@@ -608,16 +778,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 ((0, import_engine4.isOfficeKind)(tpl.meta.kind)) throw new DevkitError(`${tpl.slug} is a ${tpl.meta.kind} template; fill it with renderOfficeLocal`, "validation");
+  if ((0, import_engine4.isOfficeKind)(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) {
@@ -632,10 +812,103 @@ function previewDocument(tpl, rendered, mode, pagedScriptUrl) {
   return mode === "paged" && kind === "pdf" ? (0, import_engine4.pagedDocument)(draft, { pagedScriptUrl }) : (0, import_engine4.flowDocument)(draft);
 }
 
-// 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/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._-]*";
@@ -667,25 +940,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 });
     }
   };
@@ -695,14 +968,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;
 }
 
@@ -770,7 +1043,7 @@ function isRecord(value) {
 }
 
 // packages/devkit/src/lib/types/index.ts
-var import_engine5 = require("@formfeed/engine");
+var import_engine6 = require("@formfeed/engine");
 
 // packages/devkit/src/lib/types/model.ts
 var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1258,7 +1531,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_engine6.inferSchemaFromDataSets)(sets.length ? sets : [{}]),
     origin: "inferred"
   };
 }
@@ -1270,10 +1543,12 @@ function localTypeSource(tpl) {
   collectPartials,
   contentHash,
   contentTypeFor,
+  declaredEinvoice,
   defaultData,
   defaultProjectConfig,
   defaultTypesFile,
   diagnose,
+  diagnoseEinvoice,
   findProject,
   generateTypes,
   htmlSnapshot,
@@ -1281,6 +1556,7 @@ function localTypeSource(tpl) {
   listLocalFiles,
   listTemplateSlugs,
   loadProject,
+  localEinvoiceXml,
   localFilePath,
   localTypeSource,
   officeSnapshot,