@json-to-office/core-docx 1.9.0 → 1.11.0

package/dist/ir/inline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../src/ir/inline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMjE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAY7E;AAmDD,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK1E;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,GAAG,SAAS,CAAC;IACzE;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CACZ,EAAE,EAAE,MAAM,KACP;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IAClE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,CACtB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,MAAM,KACV,YAAY,GAAG,SAAS,CAAC;CAC/B;AAED,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,YAAY,GACZ,cAAc,GACd,MAAM,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,YAAY,EAAE,CAehB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA8FnC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,YAAY,EAAE,CAShB"}
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../src/ir/inline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMjE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAY7E;AA8HD,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK1E;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,GAAG,SAAS,CAAC;IACzE;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CACZ,EAAE,EAAE,MAAM,KACP;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IAClE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,CACtB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,MAAM,KACV,YAAY,GAAG,SAAS,CAAC;CAC/B;AAED,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,YAAY,GACZ,cAAc,GACd,MAAM,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,YAAY,EAAE,CAehB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA8FnC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,YAAY,EAAE,CAShB"}

package/dist/plugin/createDocumentGenerator.d.ts

@@ -40,6 +40,14 @@ export interface DocumentGeneratorOptions {
      * and fails before rendering on anything outside it.
      */
     renderer?: DocxRendererId;
+    /**
+     * Rasterize a PNG fallback for each inline SVG. Defaults to true.
+     *
+     * Only readers older than Word 2016 draw that raster; everything current
+     * draws the vector. Producing it dominates the render of a document whose
+     * artwork is many small SVGs, so it can be turned off.
+     */
+    svgRasterFallback?: boolean;
 }
 /**
  * Create a document generator with chainable component registration.

package/dist/plugin/createDocumentGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createDocumentGenerator.d.ts","sourceRoot":"","sources":["../../src/plugin/createDocumentGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAEV,wBAAwB,EAOxB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAajB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,oFAAoF;IACpF,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAmsBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAiBvC"}
+{"version":3,"file":"createDocumentGenerator.d.ts","sourceRoot":"","sources":["../../src/plugin/createDocumentGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAEV,wBAAwB,EAOxB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAajB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,oFAAoF;IACpF,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AA4sBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAkBvC"}

package/dist/plugin/example/index.js

@@ -1834,6 +1834,7 @@ var init_widthUtils = __esm({
 
 // src/utils/imageUtils.ts
 import { readFileSync } from "fs";
+import { availableParallelism } from "os";
 import probe from "probe-image-size";
 function loadResvg() {
   resvgModule ??= import("@resvg/resvg-js");
@@ -1852,10 +1853,36 @@ function capToPixelBudget(edge, aspect) {
   const scaled = Math.floor(edge * Math.sqrt(SVG_MAX_TOTAL_PX / total));
   return scaled >= SVG_MIN_EDGE_PX ? scaled : void 0;
 }
+function fallbackConcurrency() {
+  const cpus = availableParallelism?.() ?? 4;
+  return Math.max(1, Math.min(8, cpus));
+}
+async function rasterizeSvgFallbacks(jobs, enabled = true) {
+  const out = /* @__PURE__ */ new Map();
+  if (!enabled || jobs.length === 0) return out;
+  let next = 0;
+  const worker = async () => {
+    for (let i = next++; i < jobs.length; i = next++) {
+      const job = jobs[i];
+      out.set(
+        job.key,
+        await rasterizeSvgFallback(job.svg, {
+          width: job.width,
+          height: job.height
+        })
+      );
+    }
+  };
+  await Promise.all(
+    Array.from({ length: Math.min(fallbackConcurrency(), jobs.length) }, worker)
+  );
+  return out;
+}
 async function rasterizeSvgFallback(svg, transformation) {
   let Resvg;
+  let renderAsync;
   try {
-    ({ Resvg } = await loadResvg());
+    ({ Resvg, renderAsync } = await loadResvg());
   } catch (error) {
     reportWarning(
       "image",
@@ -1890,7 +1917,7 @@ async function rasterizeSvgFallback(svg, transformation) {
       return void 0;
     }
     return Buffer.from(
-      new Resvg(markup, { fitTo: { mode, value } }).render().asPng()
+      (await renderAsync(markup, { fitTo: { mode, value } })).asPng()
     );
   } catch (error) {
     reportWarning(
@@ -2179,10 +2206,10 @@ import {
   EndnoteReferenceRun,
   ExternalHyperlink,
   FootnoteReferenceRun,
+  ImportedXmlComponent,
   InsertedTextRun,
   InternalHyperlink,
   OverlapType,
-  PageNumber,
   Paragraph,
   RelativeHorizontalPosition,
   RelativeVerticalPosition,
@@ -2202,6 +2229,28 @@ import {
   WpsShapeRun
 } from "docx";
 import { assertNever } from "@json-to-office/shared/rendering";
+function complexField(instruction, formatting, leading) {
+  const options = runOptions(formatting);
+  const fieldChar = (type, extra = {}) => new TextRun({
+    children: [
+      new ImportedXmlComponent("w:fldChar", { "w:fldCharType": type })
+    ],
+    ...options,
+    ...extra
+  });
+  const instrText = new ImportedXmlComponent("w:instrText", {
+    "xml:space": "preserve"
+  });
+  instrText.push(instruction);
+  return [
+    // A pending line break rides on the first run of the field, the same way
+    // it rides on the single run every other inline node emits.
+    fieldChar("begin", leading),
+    new TextRun({ children: [instrText], ...options }),
+    fieldChar("separate"),
+    fieldChar("end")
+  ];
+}
 function runOptions(formatting) {
   if (!formatting) return {};
   const options = {};
@@ -2306,18 +2355,13 @@ function inlineChildren(children, resources = /* @__PURE__ */ new Map()) {
           out.push(new SimpleField(child.instruction, child.cachedText));
           break;
         }
-        const page = PAGE_FIELD[child.instruction];
-        if (!page) {
+        if (!PAGE_FIELDS.has(child.instruction)) {
           throw new Error(
             `the docxjs renderer has no emitter for the field "${child.instruction}"`
           );
         }
         out.push(
-          new TextRun({
-            children: [page],
-            ...runOptions(child.formatting),
-            ...breakOption()
-          })
+          ...complexField(child.instruction, child.formatting, breakOption())
         );
         break;
       }
@@ -2691,7 +2735,7 @@ function emitBorder(border3) {
     ...border3.spacePoints !== void 0 ? { space: border3.spacePoints } : {}
   };
 }
-var ALIGNMENT2, PAGE_FIELD, WRAP_TYPE, VERTICAL_ALIGN, TABLE_ANCHOR, HORIZONTAL_POSITION, VERTICAL_POSITION, BORDER_STYLE;
+var ALIGNMENT2, PAGE_FIELDS, WRAP_TYPE, VERTICAL_ALIGN, TABLE_ANCHOR, HORIZONTAL_POSITION, VERTICAL_POSITION, BORDER_STYLE;
 var init_emit = __esm({
   "src/renderers/docxjs/emit.ts"() {
     "use strict";
@@ -2703,10 +2747,7 @@ var init_emit = __esm({
       start: AlignmentType.START,
       end: AlignmentType.END
     };
-    PAGE_FIELD = {
-      PAGE: PageNumber.CURRENT,
-      NUMPAGES: PageNumber.TOTAL_PAGES
-    };
+    PAGE_FIELDS = /* @__PURE__ */ new Set(["PAGE", "NUMPAGES"]);
     WRAP_TYPE = {
       none: TextWrappingType.NONE,
       square: TextWrappingType.SQUARE,
@@ -3053,7 +3094,10 @@ function createDocxJsRenderer() {
     format: "docx",
     capabilities: DOCXJS_CAPABILITIES,
     async render(ir, renderOptions) {
-      const resources = await prepareImages(ir);
+      const resources = await prepareImages(
+        ir,
+        renderOptions?.svgRasterFallback
+      );
       const document = buildDocument(ir, resources);
       const packed = await Packer.toBuffer(document);
       const fixed = fixFloatingImageIdsInBuffer(packed);
@@ -3138,22 +3182,22 @@ function numberingConfig(numbering) {
     }))
   };
 }
-async function prepareImages(ir) {
+async function prepareImages(ir, svgRasterFallback) {
   const placements = collectImagePlacements(ir);
-  const rasters = /* @__PURE__ */ new Map();
+  const jobs = [];
   for (const resource of ir.resources) {
     if (resource.kind !== "image" || resource.mediaType !== "svg") continue;
     for (const size of placements.get(resource.id) ?? []) {
       const [width, height] = size.split("x").map(Number);
-      rasters.set(
-        `${resource.id}:${size}`,
-        await rasterizeSvgFallback(Buffer.from(resource.bytes), {
-          width,
-          height
-        })
-      );
+      jobs.push({
+        key: `${resource.id}:${size}`,
+        svg: Buffer.from(resource.bytes),
+        width,
+        height
+      });
     }
   }
+  const rasters = await rasterizeSvgFallbacks(jobs, svgRasterFallback);
   const resources = /* @__PURE__ */ new Map();
   for (const resource of ir.resources) {
     if (resource.kind !== "image") continue;
@@ -4320,7 +4364,11 @@ async function createOfficeOpenDocxRenderer() {
     capabilities: OFFICE_OPEN_CAPABILITIES,
     async render(ir, options) {
       const charts = [];
-      const document = await buildDocumentOptions(ir, charts);
+      const document = await buildDocumentOptions(
+        ir,
+        charts,
+        options?.svgRasterFallback
+      );
       const bytes = await backend.generateDocument(document, {
         type: "uint8array"
       });
@@ -4345,10 +4393,10 @@ async function createOfficeOpenDocxRenderer() {
     }
   };
 }
-async function buildDocumentOptions(ir, charts = []) {
+async function buildDocumentOptions(ir, charts = [], svgRasterFallback) {
   let nextDrawingId = 1;
   const ctx = {
-    pictures: await prepareImages2(ir),
+    pictures: await prepareImages2(ir, svgRasterFallback),
     nextDrawingId: () => nextDrawingId++,
     charts
   };
@@ -4397,22 +4445,22 @@ function noteBodies2(notes, ctx) {
   }
   return bodies;
 }
-async function prepareImages2(ir) {
+async function prepareImages2(ir, svgRasterFallback) {
   const placements = collectImagePlacements2(ir);
-  const rasters = /* @__PURE__ */ new Map();
+  const jobs = [];
   for (const resource of ir.resources) {
     if (resource.kind !== "image" || resource.mediaType !== "svg") continue;
     for (const size of placements.get(resource.id) ?? []) {
       const [width, height] = size.split("x").map(Number);
-      rasters.set(
-        `${resource.id}:${size}`,
-        await rasterizeSvgFallback(Buffer.from(resource.bytes), {
-          width,
-          height
-        })
-      );
+      jobs.push({
+        key: `${resource.id}:${size}`,
+        svg: Buffer.from(resource.bytes),
+        width,
+        height
+      });
     }
   }
+  const rasters = await rasterizeSvgFallbacks(jobs, svgRasterFallback);
   const resources = /* @__PURE__ */ new Map();
   for (const resource of ir.resources) {
     if (resource.kind !== "image") continue;
@@ -7988,6 +8036,44 @@ function buildNoProofWordsRegex(noProofWords2) {
   );
 }
 var DECORATOR = /(\*\*\*|___)([\s\S]*?)\1|(\*\*|__)([\s\S]*?)\3|(\*|_)([\s\S]*?)\5/g;
+var ESCAPABLE = "*_[]{}\\";
+var ESCAPE = /\\([*_[\]{}\\])/g;
+var SENTINEL = "\uE000";
+var SENTINEL_SELF = "x";
+var SENTINEL_DIGIT_BASE = 48;
+function encodeEscapes(text) {
+  const authored = text.includes(SENTINEL);
+  if (!authored && !text.includes("\\")) return text;
+  const guarded = authored ? text.split(SENTINEL).join(SENTINEL + SENTINEL_SELF) : text;
+  return guarded.replace(
+    ESCAPE,
+    (_whole, char) => SENTINEL + String.fromCharCode(SENTINEL_DIGIT_BASE + ESCAPABLE.indexOf(char))
+  );
+}
+function decodeEscapes(text) {
+  if (!text.includes(SENTINEL)) return text;
+  let out = "";
+  for (let i = 0; i < text.length; i += 1) {
+    if (text[i] !== SENTINEL) {
+      out += text[i];
+      continue;
+    }
+    const marker = text[i + 1];
+    if (marker === SENTINEL_SELF) {
+      out += SENTINEL;
+      i += 1;
+      continue;
+    }
+    const index = marker === void 0 ? -1 : marker.charCodeAt(0) - SENTINEL_DIGIT_BASE;
+    if (index >= 0 && index < ESCAPABLE.length) {
+      out += ESCAPABLE[index];
+      i += 1;
+      continue;
+    }
+    out += text[i];
+  }
+  return out;
+}
 var LINK = /\[([^\]]+)\]\(([^)]+)\)/g;
 var DECORATOR_OR_PLACEHOLDER = /(\*\*\*|___)([\s\S]*?)\1|(\*\*|__)([\s\S]*?)\3|(\*|_)([\s\S]*?)\5|\{([^}]+)\}/g;
 var PLACEHOLDER = /\{([^}]+)\}/;
@@ -8014,7 +8100,7 @@ function containsUnsupportedSyntax(text) {
   return void 0;
 }
 function parseInline(text, options) {
-  const normalized = normalizeUnicodeText(text);
+  const normalized = encodeEscapes(normalizeUnicodeText(text));
   if (!normalized) {
     return [
       { kind: "text", text: "", formatting: emptyToUndefined(options.base) }
@@ -8112,7 +8198,7 @@ function parseLinks(normalized, options) {
     lastIndex = match.index + match[0].length;
     if (match[1] === void 0) {
       const resolved = options.resolveCrossReference?.(
-        match[3],
+        decodeEscapes(match[3]),
         match[4] ?? "relative",
         match[0]
       );
@@ -8120,7 +8206,8 @@ function parseLinks(normalized, options) {
       else out.push(...parseDecorated(match[0], options));
       continue;
     }
-    const [, linkText, target] = match;
+    const [, linkText] = match;
+    const target = decodeEscapes(match[2]);
     out.push({
       kind: "hyperlink",
       // A `#anchor` target names a bookmark in this document and needs no
@@ -8176,7 +8263,7 @@ function pushSegment(out, text, options, override = {}) {
   const bold = override.bold ?? options.base.bold;
   const italic = override.italic ?? options.base.italic;
   const formatting = runFormatting2(options, { bold, italic });
-  const lines = text.split("\n");
+  const lines = decodeEscapes(text).split("\n");
   for (const [lineIndex, line] of lines.entries()) {
     if (!line && lineIndex === 0) continue;
     if (lineIndex > 0) out.push({ kind: "lineBreak" });
@@ -8647,8 +8734,8 @@ function compileComponent(component, scope) {
       return compileStatistic(component, scope);
     case "toc":
       return compileToc(component, scope);
-    case "rule":
-      return compileRule(component, scope);
+    case "divider":
+      return compileDivider(component, scope);
     case "text-box":
       return compileTextBox(component, scope);
     case "columns":
@@ -9225,16 +9312,16 @@ function compileToc(component, scope) {
   });
   return blocks;
 }
-var DEFAULT_RULE_SPACING_PT = 6;
-var DEFAULT_RULE_THICKNESS_PT = 1;
-var RULE_LINE_TWIPS = 20;
-var RULE_BORDER_STYLE = {
+var DEFAULT_DIVIDER_SPACING_PT = 6;
+var DEFAULT_DIVIDER_THICKNESS_PT = 1;
+var DIVIDER_LINE_TWIPS = 20;
+var DIVIDER_BORDER_STYLE = {
   solid: "single",
   dashed: "dashed",
   dotted: "dotted",
   double: "double"
 };
-function compileRule(component, scope) {
+function compileDivider(component, scope) {
   const { ctx, path: path3 } = scope;
   const props = component.props ?? {};
   ctx.features.require("borders", path3);
@@ -9242,12 +9329,12 @@ function compileRule(component, scope) {
     12,
     Math.max(
       0.25,
-      typeof props.thickness === "number" && Number.isFinite(props.thickness) ? props.thickness : DEFAULT_RULE_THICKNESS_PT
+      typeof props.thickness === "number" && Number.isFinite(props.thickness) ? props.thickness : DEFAULT_DIVIDER_THICKNESS_PT
     )
   );
   const spacing = props.spacing ?? {};
-  const beforePt = typeof spacing.before === "number" && Number.isFinite(spacing.before) ? spacing.before : DEFAULT_RULE_SPACING_PT;
-  const afterPt = typeof spacing.after === "number" && Number.isFinite(spacing.after) ? spacing.after : DEFAULT_RULE_SPACING_PT;
+  const beforePt = typeof spacing.before === "number" && Number.isFinite(spacing.before) ? spacing.before : DEFAULT_DIVIDER_SPACING_PT;
+  const afterPt = typeof spacing.after === "number" && Number.isFinite(spacing.after) ? spacing.after : DEFAULT_DIVIDER_SPACING_PT;
   return [
     {
       kind: "paragraph",
@@ -9259,13 +9346,13 @@ function compileRule(component, scope) {
         spacing: {
           beforeTwips: pointsToTwips2(beforePt),
           afterTwips: pointsToTwips2(afterPt),
-          lineTwips: RULE_LINE_TWIPS,
+          lineTwips: DIVIDER_LINE_TWIPS,
           lineRule: "exact"
         },
-        ...ruleIndent(props, ctx, path3),
+        ...dividerIndent(props, ctx, path3),
         borders: {
           bottom: {
-            style: RULE_BORDER_STYLE[String(props.style)] ?? "single",
+            style: DIVIDER_BORDER_STYLE[String(props.style)] ?? "single",
             sizeEighthPoints: pointsToEighthPoints(thicknessPt),
             color: irColor(
               resolveColor(String(props.color ?? "border"), ctx.theme)
@@ -9279,7 +9366,7 @@ function compileRule(component, scope) {
     }
   ];
 }
-function ruleIndent(props, ctx, path3) {
+function dividerIndent(props, ctx, path3) {
   const width = props.width;
   if (width === void 0) return {};
   const page = getPageSetup(ctx.theme);
@@ -9302,8 +9389,8 @@ function ruleIndent(props, ctx, path3) {
     if (remainder < 0) {
       warnOnce(
         ctx,
-        "rule",
-        `Rule width ${JSON.stringify(width)} at ${path3} is wider than the ${Math.round(measureTwips / 20)}pt text measure; it runs the full measure instead.`
+        "divider",
+        `Divider width ${JSON.stringify(width)} at ${path3} is wider than the ${Math.round(measureTwips / 20)}pt text measure; it runs the full measure instead.`
       );
     }
     return {};
@@ -12113,6 +12200,7 @@ async function renderScoped(document, options, warnings) {
   const bytes = await renderer.render(compiled.ir, {
     ...options.deterministic !== void 0 ? { deterministic: options.deterministic } : {},
     ...options.generatedAt !== void 0 ? { generatedAt: toDate(options.generatedAt) } : {},
+    ...options.svgRasterFallback !== void 0 ? { svgRasterFallback: options.svgRasterFallback } : {},
     warnings: compiled.warnings
   });
   return { buffer: Buffer.from(bytes), warnings: compiled.warnings };
@@ -12289,7 +12377,8 @@ function createBuilderImpl(state) {
       deterministic: state.deterministic,
       generatedAt: state.generatedAt,
       baseDir: state.baseDir,
-      renderer: state.renderer
+      renderer: state.renderer,
+      svgRasterFallback: state.svgRasterFallback
     };
     return createBuilderImpl(
       newState
@@ -12546,7 +12635,8 @@ function createDocumentGenerator(options) {
     deterministic: options.deterministic ?? true,
     generatedAt: options.generatedAt,
     baseDir: options.baseDir,
-    renderer: options.renderer
+    renderer: options.renderer,
+    svgRasterFallback: options.svgRasterFallback
   };
   return createBuilderImpl(initialState);
 }