@json-to-office/core-docx 7.5.1 → 7.6.0

package/dist/core/fontEmbedding.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The `embed` export mode's share of the DOCX pipeline: whether this render
+ * embeds at all, which faces it embeds, and the one summary warning.
+ *
+ * Face selection itself — slots, formats, licence bits — lives in
+ * `@json-to-office/shared/fonts/node` (`toEmbeddedFontFaces`), beside the
+ * other encoders of resolved fonts. What stays here is what only the DOCX
+ * pipeline knows: which renderer will write the package, and what the
+ * document references, which is what the summary has to answer for.
+ *
+ * Nothing here imports `docx`: the faces travel to the adapter as a render
+ * option (`DocxRenderOptions.embeddedFonts`), and only the docx.js adapter
+ * reads it.
+ */
+import type { EmbeddedFontFace, FontRuntimeOpts, GenerationWarning, ResolvedFont } from '@json-to-office/shared';
+import { type DocxRendererId } from '../renderers/types';
+/**
+ * Whether this render embeds fonts: `embed` was asked for, and the renderer
+ * that will write the package can do it.
+ *
+ * `office-open` cannot yet. Its published docx embedding names the part after
+ * the family, which is the defect docx.js fixed in 9.7.0, writes the regular
+ * face only and leaves `embedTrueTypeFonts` off, so a request for it falls
+ * back to `custom` — references kept, nothing embedded — and says so rather
+ * than shipping a package Word repairs or drops the fonts from on re-save.
+ */
+export declare function embedsFonts(fonts: FontRuntimeOpts | undefined, renderer: DocxRendererId | undefined, warnings: GenerationWarning[]): boolean;
+/**
+ * The faces to embed, with one `FONT_MODE_EMBED` summary for the document.
+ *
+ * The summary walks the resolved fonts rather than the report alone: the
+ * resolver hands back one entry per family the document and its theme
+ * reference — the same set `FONT_MODE_CUSTOM` is gated on — so a non-safe
+ * family that resolved to nothing still gets its line, instead of vanishing
+ * from a message that claims to account for the document's fonts. A document
+ * that references only safe fonts gets no summary, as in custom mode.
+ */
+export declare function selectEmbeddedFonts(resolved: readonly ResolvedFont[], warnings: GenerationWarning[]): EmbeddedFontFace[];
+//# sourceMappingURL=fontEmbedding.d.ts.map

package/dist/core/fontEmbedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontEmbedding.d.ts","sourceRoot":"","sources":["../../src/core/fontEmbedding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACb,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAY5B;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAaT;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,gBAAgB,EAAE,CAKpB"}

package/dist/core/fontResolution.d.ts

@@ -1,18 +1,20 @@
 /**
- * Shared font-resolution helper used by BOTH entry paths into renderDocument:
+ * Font resolution for a DOCX render: validation, SAFE_FONTS awareness, Google
+ * Fonts materialization, and the `onResolved` side-channel consumed by the
+ * LibreOffice preview font stager.
  *
- * - generator.ts → generateDocumentWithCustomThemes (non-plugin)
- * - plugin/createDocumentGenerator.ts → generate (plugin-aware)
- *
- * Keeping it in one place ensures the two paths behave identically around
- * validation, SAFE_FONTS awareness, Google Fonts materialization, and the
- * `onResolved` side-channel consumed by the LibreOffice preview font stager.
+ * One call site, `compileDocumentScoped` in `generateFromIr.ts`, which both
+ * public entry paths — `generator.ts` and the plugin-aware
+ * `plugin/createDocumentGenerator.ts` — reach, so they cannot disagree about
+ * any of the above.
  *
  * Materialization has two triggers: an `onResolved` listener, or the
  * caller's `forceMaterialize` flag (set when the document contains a
  * `visual`, whose PNG is produced by an out-of-process LibreOffice that
- * needs real font files). Both entry paths return the resolved fonts so the
- * caller can forward them to the rasterizer.
+ * needs real font files, a `highcharts`, whose export server needs them
+ * likewise, or when `embed` mode will write them into the package). The
+ * resolved fonts are returned so the caller can forward them to whichever
+ * of those needs them.
  */
 import type { FontRuntimeOpts, ResolvedFont, GenerationWarning } from '@json-to-office/shared';
 import type { ThemeConfig } from '../styles';
@@ -24,6 +26,8 @@ export declare function resolveDocumentFonts(document: ReportComponentDefinition
  * whose PNG is rendered by an out-of-process LibreOffice that needs the
  * actual font files — there is no listener on the plain CLI path, so
  * without this a visual-bearing build silently renders with fallbacks.
+ * `embed` mode sets it for the same reason: without it there would be
+ * nothing to embed.
  */
 forceMaterialize?: boolean): Promise<ResolvedFont[]>;
 //# sourceMappingURL=fontResolution.d.ts.map

package/dist/core/fontResolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fontResolution.d.ts","sourceRoot":"","sources":["../../src/core/fontResolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAchC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,iBAAiB,EAAE;AAC9B;;;;;;GAMG;AACH,gBAAgB,UAAQ,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC,CAkFzB"}
+{"version":3,"file":"fontResolution.d.ts","sourceRoot":"","sources":["../../src/core/fontResolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAchC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,iBAAiB,EAAE;AAC9B;;;;;;;;GAQG;AACH,gBAAgB,UAAQ,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC,CAmFzB"}

package/dist/core/generateFromIr.d.ts

@@ -15,7 +15,7 @@
 /// <reference types="node" />
 /// <reference types="node" />
 import type { GenerationWarning, ServicesConfig } from '@json-to-office/shared';
-import type { FontRuntimeOpts } from '@json-to-office/shared';
+import type { EmbeddedFontFace, FontRuntimeOpts } from '@json-to-office/shared';
 import { compileDocument, type UnsupportedComponent } from '../ir/compiler';
 import type { DocxIR } from '../ir/types';
 import type { DocxRendererId } from '../renderers/types';
@@ -76,6 +76,13 @@ export interface CompiledDocx {
     warnings: GenerationWarning[];
     required: ReturnType<typeof compileDocument>['required'];
     unsupported: UnsupportedComponent[];
+    /**
+     * The font faces `embed` mode writes into the package; empty in every other
+     * mode. Kept beside the IR rather than in it: they are a resource of this
+     * render, chosen for the renderer that will write it, not something the
+     * document says, and the IR stays the same in every mode.
+     */
+    embeddedFonts: EmbeddedFontFace[];
 }
 /**
  * Compile a report definition to DocxIR without rendering it.

package/dist/core/generateFromIr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateFromIr.d.ts","sourceRoot":"","sources":["../../src/core/generateFromIr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAKlE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,IAAI,0BAA0B;IAC9C,SAAgB,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;gBAEhD,UAAU,EAAE,SAAS,oBAAoB,EAAE;CAiBxD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC;IACzD,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,EACrC,SAAS,CAAC,EAAE,iBAAiB,EAAE,GAC9B,OAAO,CAAC,YAAY,CAAC,CAOvB;AA4GD,0EAA0E;AAC1E,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}
+{"version":3,"file":"generateFromIr.d.ts","sourceRoot":"","sources":["../../src/core/generateFromIr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAWhF,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAKlE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,IAAI,0BAA0B;IAC9C,SAAgB,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;gBAEhD,UAAU,EAAE,SAAS,oBAAoB,EAAE;CAiBxD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC;IACzD,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC;;;;;OAKG;IACH,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,EACrC,SAAS,CAAC,EAAE,iBAAiB,EAAE,GAC9B,OAAO,CAAC,YAAY,CAAC,CAOvB;AAsHD,0EAA0E;AAC1E,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}

package/dist/core/generationContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generationContext.d.ts","sourceRoot":"","sources":["../../src/core/generationContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAMhC,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC;IAC9C,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACzC,QAAQ,EAAE,OAAO,KACd,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,QAAQ,EAAE,yBAAyB,CAAC;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CACnB;AAoBD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,yBAAyB,EACrC,OAAO,GAAE,mBAAwB,GAChC,sBAAsB,CA+DxB"}
+{"version":3,"file":"generationContext.d.ts","sourceRoot":"","sources":["../../src/core/generationContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAMhC,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC;IAC9C,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACzC,QAAQ,EAAE,OAAO,KACd,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,QAAQ,EAAE,yBAAyB,CAAC;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CACnB;AAoBD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,yBAAyB,EACrC,OAAO,GAAE,mBAAwB,GAChC,sBAAsB,CAgExB"}

package/dist/index.js

@@ -4265,6 +4265,8 @@ var init_normalizeTextCase = __esm({
 
 // src/utils/packageDocument.ts
 import AdmZip from "adm-zip";
+import { createHash as createHash3 } from "crypto";
+import { posix } from "path";
 function resolveGenerationDate(options) {
   if (options?.generatedAt !== void 0) {
     const date = new Date(options.generatedAt);
@@ -4332,6 +4334,70 @@ function canonicalizeRelationshipIds(zip) {
     if (entry) zip.updateFile(entry, Buffer.from(update.xml, "utf8"));
   }
 }
+function xorFontKey(bytes, guid) {
+  const key = Buffer.from(guid.replace(/-/g, ""), "hex").reverse();
+  const out = Buffer.from(bytes);
+  for (let i = 0; i < Math.min(32, out.length); i++) out[i] ^= key[i % 16];
+  return out;
+}
+function canonicalizeEmbeddedFontKeys(zip) {
+  const table2 = zip.getEntry("word/fontTable.xml");
+  if (!table2) return;
+  const xml = table2.getData().toString("utf8");
+  const embeds = [...xml.matchAll(FONT_EMBED)].flatMap(([element]) => {
+    const id = /\br:id="([^"]+)"/.exec(element)?.[1];
+    const key = /\bw:fontKey="\{([0-9A-Fa-f-]{36})\}"/.exec(element)?.[1];
+    return id && key ? [{ id, key }] : [];
+  });
+  if (embeds.length === 0) return;
+  const rels = zip.getEntry("word/_rels/fontTable.xml.rels")?.getData().toString("utf8") ?? "";
+  const targets = /* @__PURE__ */ new Map();
+  for (const [relationship] of rels.matchAll(/<Relationship\b[^>]*>/g)) {
+    const id = /\bId="([^"]+)"/.exec(relationship)?.[1];
+    const target = /\bTarget="([^"]+)"/.exec(relationship)?.[1];
+    if (id && target) targets.set(id, target);
+  }
+  const rekey = /* @__PURE__ */ new Map();
+  const parts = [];
+  for (const { id, key } of embeds) {
+    const target = targets.get(id);
+    if (!target) continue;
+    const name = target.startsWith("/") ? target.slice(1) : posix.normalize(posix.join("word", target));
+    const part = zip.getEntry(name);
+    if (!part) continue;
+    const font = xorFontKey(part.getData(), key);
+    const hex = createHash3("sha256").update(font).digest("hex").slice(0, 32).toUpperCase();
+    const fresh = [
+      hex.slice(0, 8),
+      hex.slice(8, 12),
+      hex.slice(12, 16),
+      hex.slice(16, 20),
+      hex.slice(20)
+    ].join("-");
+    rekey.set(key.toUpperCase(), fresh);
+    parts.push({ name, data: xorFontKey(font, fresh) });
+  }
+  if (rekey.size === 0) return;
+  for (const { name, data } of parts) {
+    const entry = zip.getEntry(name);
+    if (entry) zip.updateFile(entry, data);
+  }
+  const fontTable = zip.getEntry("word/fontTable.xml");
+  if (!fontTable) return;
+  zip.updateFile(
+    fontTable,
+    Buffer.from(
+      xml.replace(
+        /\bw:fontKey="\{([0-9A-Fa-f-]{36})\}"/g,
+        (whole, key) => {
+          const fresh = rekey.get(key.toUpperCase());
+          return fresh ? `w:fontKey="{${fresh}}"` : whole;
+        }
+      ),
+      "utf8"
+    )
+  );
+}
 function canonicalizeEmbeddedPackages(zip, generatedAt, depth = 1) {
   const names = zip.getEntries().map((entry) => entry.entryName).filter((name) => EMBEDDED_OFFICE_PACKAGE.test(name));
   let changed = false;
@@ -4384,6 +4450,7 @@ function canonicalizeDocxBuffer(buffer, generatedAt = DEFAULT_GENERATION_DATE) {
   normalizeTextCase(zip);
   canonicalizeRelationshipIds(zip);
   canonicalizeEmbeddedPackages(zip, generatedAt);
+  canonicalizeEmbeddedFontKeys(zip);
   const isoTimestamp = generatedAt.toISOString();
   const coreProperties3 = zip.getEntry("docProps/core.xml");
   if (coreProperties3) {
@@ -4400,13 +4467,14 @@ function normalizeDocxCaseBuffer(buffer) {
   const zip = new AdmZip(buffer);
   return normalizeTextCase(zip) ? zip.toBuffer() : buffer;
 }
-var DEFAULT_GENERATION_DATE, STABLE_RELATIONSHIP_ID, CORE_TIMESTAMP, EMBEDDED_OFFICE_PACKAGE, MAX_EMBEDDED_DEPTH;
+var DEFAULT_GENERATION_DATE, STABLE_RELATIONSHIP_ID, FONT_EMBED, CORE_TIMESTAMP, EMBEDDED_OFFICE_PACKAGE, MAX_EMBEDDED_DEPTH;
 var init_packageDocument = __esm({
   "src/utils/packageDocument.ts"() {
     "use strict";
     init_normalizeTextCase();
     DEFAULT_GENERATION_DATE = /* @__PURE__ */ new Date("2000-01-01T00:00:00.000Z");
     STABLE_RELATIONSHIP_ID = /^rId\d+$/;
+    FONT_EMBED = /<w:embed(?:Regular|Bold|Italic|BoldItalic)\b[^>]*>/g;
     CORE_TIMESTAMP = /(<dcterms:(?:created|modified)\b[^>]*>)[^<]*(<\/dcterms:(?:created|modified)>)/g;
     EMBEDDED_OFFICE_PACKAGE = /\.(?:docx|pptx|xlsx|xlsm)$/i;
     MAX_EMBEDDED_DEPTH = 3;
@@ -5007,7 +5075,12 @@ function createDocxJsRenderer() {
         });
       }
       const pageNumbers = needsPageNumbers(ir) ? await createPageNumberEstimator(ir) : void 0;
-      const document = buildDocument(ir, resources, pageNumbers);
+      const document = buildDocument(
+        ir,
+        resources,
+        pageNumbers,
+        renderOptions?.embeddedFonts
+      );
       const packed = await Packer.toBuffer(document);
       const fixed = fixFloatingImageIdsInBuffer(packed);
       const repaired = markers ? repairDrawingGroupsInBuffer(fixed, markers) : fixed;
@@ -5025,10 +5098,17 @@ function createDocxJsRenderer() {
     }
   };
 }
-function buildDocument(ir, resources = /* @__PURE__ */ new Map(), pageNumbers) {
+function buildDocument(ir, resources = /* @__PURE__ */ new Map(), pageNumbers, embeddedFonts) {
   return new Document({
     ...pageNumbers ? { pageNumbers } : {},
     styles: emitStyles(ir.styles),
+    // word/fonts/font<N>.odttf, their `w:embed*` entries in the font table and
+    // `w:embedTrueTypeFonts` in the settings, all from this one key. Passed
+    // only when a face embeds, so a document in any other mode is built from
+    // exactly the options it always was. `docx/layout` measures the text of an
+    // embedded family from these files, so a contents field's page numbers
+    // need nothing more.
+    ...embeddedFonts && embeddedFonts.length > 0 ? { fonts: embeddedFonts.map(fontOptions) } : {},
     ...ir.theme ? { theme: themeOptions(ir.theme) } : {},
     sections: ir.sections.map((section2) => sectionOptions(section2, resources)),
     ...coreProperties(ir),
@@ -5059,6 +5139,15 @@ function buildDocument(ir, resources = /* @__PURE__ */ new Map(), pageNumbers) {
     } : {}
   });
 }
+function fontOptions(face) {
+  return {
+    name: face.family,
+    data: face.regular,
+    ...face.bold ? { bold: face.bold } : {},
+    ...face.italic ? { italic: face.italic } : {},
+    ...face.boldItalic ? { boldItalic: face.boldItalic } : {}
+  };
+}
 function themeOptions(theme) {
   const colors = {};
   for (const [slot, color] of Object.entries(theme.colors)) {
@@ -7054,6 +7143,67 @@ import {
   toRasterizeFontFaces
 } from "@json-to-office/shared/fonts/node";
 
+// src/core/fontEmbedding.ts
+import { isSafeFont } from "@json-to-office/shared";
+import {
+  toEmbeddedFontFaces
+} from "@json-to-office/shared/fonts/node";
+
+// src/renderers/types.ts
+import {
+  DEFAULT_DOCX_RENDERER_ID
+} from "@json-to-office/shared-docx";
+
+// src/core/fontEmbedding.ts
+var EMBEDDING_RENDERER = "docxjs";
+var warning = (code, message) => ({
+  component: "fontRegistry",
+  message,
+  severity: "warning",
+  context: { code }
+});
+function embedsFonts(fonts, renderer, warnings) {
+  if (fonts?.mode !== "embed") return false;
+  const id = renderer ?? DEFAULT_DOCX_RENDERER_ID;
+  if (id === EMBEDDING_RENDERER) return true;
+  warnings.push(
+    warning(
+      "FONT_EMBED_UNSUPPORTED_RENDERER",
+      `Export mode "embed" needs the ${EMBEDDING_RENDERER} renderer; the ${id} renderer does not embed fonts, so references are kept as in custom mode and nothing is embedded.`
+    )
+  );
+  return false;
+}
+function selectEmbeddedFonts(resolved, warnings) {
+  const { faces, report } = toEmbeddedFontFaces(resolved, warnings);
+  const summary = embedSummary(resolved, report);
+  if (summary) warnings.push(warning("FONT_MODE_EMBED", summary));
+  return faces;
+}
+function embedSummary(resolved, report) {
+  const byFamily = new Map(report.map((r) => [r.family.toLowerCase(), r]));
+  const seen = /* @__PURE__ */ new Set();
+  const lines = [];
+  for (const font of resolved) {
+    const key = font.family.toLowerCase();
+    if (isSafeFont(font.family.trim()) || seen.has(key)) continue;
+    seen.add(key);
+    const entry = byFamily.get(key);
+    if (!entry) {
+      lines.push(`${font.family}: not embedded (unresolved)`);
+    } else if (entry.slots.length === 0) {
+      lines.push(
+        `${font.family}: not embedded (${entry.reason === "no-regular-face" ? "no regular face" : "no TTF/OTF face it may embed"})`
+      );
+    } else {
+      const nearest = entry.nearest.length ? ` (${entry.nearest.map((n) => `${n.slot} \u2190 ${n.weight}`).join(", ")})` : "";
+      lines.push(`${font.family}: ${entry.slots.join(", ")}${nearest}`);
+    }
+  }
+  if (lines.length === 0) return void 0;
+  return `Export mode "embed": ${lines.join("; ")}. Readers without these fonts installed see the embedded faces; any face or family not embedded stays a reference, as in custom mode.`;
+}
+
 // src/core/prerasterizeVisuals.ts
 import {
   clampVisualDpi,
@@ -7540,7 +7690,7 @@ function assertExportServerAllowed(serverUrl, servicesConfig, warnings) {
   const notice = remoteExportNotice(serverUrl, servicesConfig?.allowRemote);
   if (!notice || !warnings) return;
   const alreadySaid = warnings.some(
-    (warning) => warning.context?.code === REMOTE_EXPORT_WARNING && warning.context?.serverUrl === serverUrl
+    (warning2) => warning2.context?.code === REMOTE_EXPORT_WARNING && warning2.context?.serverUrl === serverUrl
   );
   if (alreadySaid) return;
   warnings.push({
@@ -13586,13 +13736,6 @@ function warnOnce(ctx, component, message, code) {
 import {
   RendererRegistry
 } from "@json-to-office/shared/rendering";
-
-// src/renderers/types.ts
-import {
-  DEFAULT_DOCX_RENDERER_ID
-} from "@json-to-office/shared-docx";
-
-// src/renderers/registry.ts
 var registry = new RendererRegistry(
   "docx",
   DEFAULT_DOCX_RENDERER_ID
@@ -16240,13 +16383,15 @@ async function compileDocumentScoped(document, options, warnings) {
   const { context } = prepared.model;
   const hasVisual = collectVisualProps(context.document).length > 0;
   const hasHighcharts = containsComponent(context.document, "highcharts");
+  const embedding = embedsFonts(options.fonts, options.renderer, warnings);
   const resolvedFonts = await resolveDocumentFonts(
     context.document,
     context.theme,
     options.fonts,
     warnings,
-    hasVisual || hasHighcharts
+    hasVisual || hasHighcharts || embedding
   );
+  const embeddedFonts = embedding ? selectEmbeddedFonts(resolvedFonts, warnings) : [];
   const visualFonts = hasVisual ? toRasterizeFontFaces(resolvedFonts, warnings) : [];
   const chartFonts = hasHighcharts ? toChartFontFaces(resolvedFonts) : [];
   const desugared = await desugarExternals(context.document, {
@@ -16286,7 +16431,8 @@ async function compileDocumentScoped(document, options, warnings) {
     theme: context.theme,
     warnings: compiled.warnings,
     required: compiled.required,
-    unsupported: compiled.unsupported
+    unsupported: compiled.unsupported,
+    embeddedFonts
   };
 }
 async function generateBufferViaIr(document, options = {}) {
@@ -16310,6 +16456,7 @@ async function renderScoped(document, options, warnings) {
     ...options.deterministic !== void 0 ? { deterministic: options.deterministic } : {},
     ...options.generatedAt !== void 0 ? { generatedAt: toDate(options.generatedAt) } : {},
     ...options.svgRasterFallback !== void 0 ? { svgRasterFallback: options.svgRasterFallback } : {},
+    ...compiled.embeddedFonts.length > 0 ? { embeddedFonts: compiled.embeddedFonts } : {},
     warnings: compiled.warnings
   });
   return { buffer: Buffer.from(bytes), warnings: compiled.warnings };
@@ -17815,10 +17962,10 @@ function generateWarningsDocument(warnings) {
     }
   ];
   const warningsByComponent = /* @__PURE__ */ new Map();
-  for (const warning of warnings) {
-    const existing = warningsByComponent.get(warning.component) || [];
-    existing.push(warning);
-    warningsByComponent.set(warning.component, existing);
+  for (const warning2 of warnings) {
+    const existing = warningsByComponent.get(warning2.component) || [];
+    existing.push(warning2);
+    warningsByComponent.set(warning2.component, existing);
   }
   for (const [
     componentName,
@@ -17832,10 +17979,10 @@ function generateWarningsDocument(warnings) {
       }
     });
     const warningItems = [];
-    for (const warning of componentWarnings) {
-      let warningText = warning.message;
-      if (warning.context && Object.keys(warning.context).length > 0) {
-        const contextStr = Object.entries(warning.context).map(([key, value]) => `${key}: ${JSON.stringify(value)}`).join(", ");
+    for (const warning2 of componentWarnings) {
+      let warningText = warning2.message;
+      if (warning2.context && Object.keys(warning2.context).length > 0) {
+        const contextStr = Object.entries(warning2.context).map(([key, value]) => `${key}: ${JSON.stringify(value)}`).join(", ");
         warningText += ` (${contextStr})`;
       }
       warningItems.push(warningText);
@@ -17871,10 +18018,10 @@ function formatWarningsText(warnings) {
     ""
   ];
   const warningsByComponent = /* @__PURE__ */ new Map();
-  for (const warning of warnings) {
-    const existing = warningsByComponent.get(warning.component) || [];
-    existing.push(warning);
-    warningsByComponent.set(warning.component, existing);
+  for (const warning2 of warnings) {
+    const existing = warningsByComponent.get(warning2.component) || [];
+    existing.push(warning2);
+    warningsByComponent.set(warning2.component, existing);
   }
   for (const [
     componentName,
@@ -17883,10 +18030,10 @@ function formatWarningsText(warnings) {
     lines.push(`Component: ${componentName}`);
     lines.push("-".repeat(30));
     for (let i = 0; i < componentWarnings.length; i++) {
-      const warning = componentWarnings[i];
-      lines.push(`  ${i + 1}. ${warning.message}`);
-      if (warning.context && Object.keys(warning.context).length > 0) {
-        lines.push(`     Context: ${JSON.stringify(warning.context, null, 2)}`);
+      const warning2 = componentWarnings[i];
+      lines.push(`  ${i + 1}. ${warning2.message}`);
+      if (warning2.context && Object.keys(warning2.context).length > 0) {
+        lines.push(`     Context: ${JSON.stringify(warning2.context, null, 2)}`);
       }
     }
     lines.push("");