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

package/dist/core/generateFromIr.d.ts

@@ -33,6 +33,14 @@ export interface IrDocxGenerationOptions {
     generatedAt?: string | Date;
     /** Backend to render with. Defaults to `docxjs`. */
     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 is the dominant cost of a document whose
+     * artwork is many small SVGs, so it can be turned off.
+     */
+    svgRasterFallback?: boolean;
     /**
      * A prologue already run by the caller.
      *

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;AAM9D,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;;;;;;;;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;AAkGD,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,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,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;AAkGD,0EAA0E;AAC1E,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}

package/dist/core/generator.d.ts

@@ -65,6 +65,14 @@ export interface JsonGenerationOptions {
      * produced; anything else is opt-in and may not.
      */
     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;
     /** Canonical prepared model; internal hosts use it to avoid a second prologue. */
     prepared?: PreparedDocument<DocxQualityModel, DocxQualityFact>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1862,6 +1862,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");
@@ -1880,10 +1881,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",
@@ -1918,7 +1945,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(
@@ -2207,10 +2234,10 @@ import {
   EndnoteReferenceRun,
   ExternalHyperlink,
   FootnoteReferenceRun,
+  ImportedXmlComponent,
   InsertedTextRun,
   InternalHyperlink,
   OverlapType,
-  PageNumber,
   Paragraph,
   RelativeHorizontalPosition,
   RelativeVerticalPosition,
@@ -2230,6 +2257,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 = {};
@@ -2334,18 +2383,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;
       }
@@ -2719,7 +2763,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";
@@ -2731,10 +2775,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,
@@ -3081,7 +3122,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);
@@ -3166,22 +3210,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;
@@ -4348,7 +4392,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"
       });
@@ -4373,10 +4421,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
   };
@@ -4425,22 +4473,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;
@@ -7819,6 +7867,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 = /\{([^}]+)\}/;
@@ -7845,7 +7931,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) }
@@ -7943,7 +8029,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]
       );
@@ -7951,7 +8037,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
@@ -8007,7 +8094,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" });
@@ -8478,8 +8565,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":
@@ -9056,16 +9143,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: path4 } = scope;
   const props = component.props ?? {};
   ctx.features.require("borders", path4);
@@ -9073,12 +9160,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",
@@ -9090,13 +9177,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, path4),
+        ...dividerIndent(props, ctx, path4),
         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)
@@ -9110,7 +9197,7 @@ function compileRule(component, scope) {
     }
   ];
 }
-function ruleIndent(props, ctx, path4) {
+function dividerIndent(props, ctx, path4) {
   const width = props.width;
   if (width === void 0) return {};
   const page = getPageSetup(ctx.theme);
@@ -9133,8 +9220,8 @@ function ruleIndent(props, ctx, path4) {
     if (remainder < 0) {
       warnOnce(
         ctx,
-        "rule",
-        `Rule width ${JSON.stringify(width)} at ${path4} is wider than the ${Math.round(measureTwips / 20)}pt text measure; it runs the full measure instead.`
+        "divider",
+        `Divider width ${JSON.stringify(width)} at ${path4} is wider than the ${Math.round(measureTwips / 20)}pt text measure; it runs the full measure instead.`
       );
     }
     return {};
@@ -12029,6 +12116,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 };
@@ -12146,6 +12234,7 @@ async function generateBufferWithWarnings(jsonConfig, options) {
     ...options?.deterministic !== void 0 ? { deterministic: options.deterministic } : {},
     ...options?.generatedAt !== void 0 ? { generatedAt: options.generatedAt } : {},
     ...renderer ? { renderer } : {},
+    ...options?.svgRasterFallback !== void 0 ? { svgRasterFallback: options.svgRasterFallback } : {},
     ...options?.prepared ? { prepared: options.prepared } : {}
   });
 }
@@ -12734,9 +12823,9 @@ var docxLineBoxRule = {
           message: `An exact ${tenths(fact.lineBoxPt)}pt line box holds ${tenths(fact.fontSizePt)}pt text${inherited} \u2014 shorter than the capitals it contains, so the lines overlap or lose their tops.`,
           path: fact.path,
           // The second sentence is the exit from the incentive that
-          // produced this geometry: the reported route to a 3pt rule was a
+          // produced this geometry: the reported route to a 3pt line was a
           // collapsed line box on 8pt type, because nothing else drew one.
-          suggestion: `Set the box to at least ${repairPt}pt \u2014 as tall as the type it holds \u2014 or use "atLeast" so the line grows to fit the text. To draw a line rather than set leading, use the "rule" component.${fact.patchable ? "" : " This box is not stated on the component: it arrives through `componentDefaults` and has to be repaired there."}`,
+          suggestion: `Set the box to at least ${repairPt}pt \u2014 as tall as the type it holds \u2014 or use "atLeast" so the line grows to fit the text. To draw a line rather than set leading, use the "divider" component.${fact.patchable ? "" : " This box is not stated on the component: it arrives through `componentDefaults` and has to be repaired there."}`,
           context: {
             lineBoxPt: tenths(fact.lineBoxPt),
             fontSizePt: tenths(fact.fontSizePt),
@@ -13504,7 +13593,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
@@ -13761,7 +13851,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);
 }