@json-to-office/core-pptx 6.8.0 → 7.0.1

package/dist/index.js

@@ -121,6 +121,9 @@ var init_units = __esm({
 });
 
 // src/renderers/pptxgenjs/fills.ts
+function buildImageFillXml() {
+  return `<a:blipFill rotWithShape="1"><a:blip r:embed="${IMAGE_FILL_RID}"/><a:stretch><a:fillRect/></a:stretch></a:blipFill>`;
+}
 function colorXml(color2) {
   const alpha = color2.transparency !== void 0 ? `<a:alpha val="${Math.round((100 - color2.transparency) * PCT_UNIT)}"/>` : "";
   return `<a:srgbClr val="${color2.hex.toUpperCase()}">${alpha}</a:srgbClr>`;
@@ -142,18 +145,27 @@ function radialShadeXml(focus) {
 function buildPatternFillXml(preset, foreground, background2) {
   return `<a:pattFill prst="${preset}"><a:fgClr>${opaqueColorXml(foreground)}</a:fgClr><a:bgClr>${opaqueColorXml(background2)}</a:bgClr></a:pattFill>`;
 }
-function registerAdvancedFill(opts, fill2, elementPath, sink) {
+function registerAdvancedFill(opts, fill2, elementPath, sink, raster) {
   const sentinel = fill2.kind === "gradient" ? fill2.gradient.stops[0].color : fill2.foreground;
   if (sink) {
-    const xml = fill2.kind === "gradient" ? buildGradientFillXml(fill2.gradient) : buildPatternFillXml(fill2.preset, fill2.foreground, fill2.background);
     const objectName = `__jto_fill_${sink.length}__`;
-    sink.push({ objectName, xml });
+    if (fill2.kind === "gradient" && fill2.gradient.type === "radial" && raster) {
+      const image = raster.rasterize(
+        fill2.gradient,
+        raster.widthEmu,
+        raster.heightEmu
+      );
+      sink.push({ objectName, xml: buildImageFillXml(), image });
+    } else {
+      const xml = fill2.kind === "gradient" ? buildGradientFillXml(fill2.gradient) : buildPatternFillXml(fill2.preset, fill2.foreground, fill2.background);
+      sink.push({ objectName, xml });
+    }
     opts.objectName = objectName;
   }
   void elementPath;
   opts.fill = { color: sentinel.hex };
 }
-var ANGLE_UNIT, PCT_UNIT, RADIAL_FOCUS_RECTS;
+var ANGLE_UNIT, PCT_UNIT, RADIAL_FOCUS_RECTS, IMAGE_FILL_RID;
 var init_fills = __esm({
   "src/renderers/pptxgenjs/fills.ts"() {
     "use strict";
@@ -166,6 +178,7 @@ var init_fills = __esm({
       bottomLeft: { l: 0, t: 1e5, r: 1e5, b: 0 },
       bottomRight: { l: 1e5, t: 1e5, r: 0, b: 0 }
     };
+    IMAGE_FILL_RID = "__jto_fill_rid__";
   }
 });
 
@@ -243,7 +256,13 @@ function chartOpts(element) {
     face: "catAxisLabelFontFace",
     bold: "catAxisLabelFontBold",
     size: "catAxisLabelFontSize",
-    color: "catAxisLabelColor"
+    color: "catAxisLabelColor",
+    titleFont: {
+      face: "catAxisTitleFontFace",
+      size: "catAxisTitleFontSize",
+      color: "catAxisTitleColor"
+    },
+    titleRotate: "catAxisTitleRotate"
   });
   applyValueAxis(opts, o.valueAxis);
   if (o.dataBorder) {
@@ -264,6 +283,10 @@ function applyAxis(opts, axis, keys) {
   if (axis.title !== void 0) {
     opts[keys.title] = axis.title;
     opts[keys.showTitle] = true;
+    applyLabelFont(opts, axis.titleFont, keys.titleFont);
+    if (axis.titleRotate !== void 0) {
+      opts[keys.titleRotate] = axis.titleRotate;
+    }
   }
   if (axis.hidden !== void 0) opts[keys.hidden] = axis.hidden;
   if (axis.labelRotate !== void 0) opts[keys.labelRotate] = axis.labelRotate;
@@ -282,7 +305,13 @@ function applyValueAxis(opts, axis) {
     face: "valAxisLabelFontFace",
     bold: "valAxisLabelFontBold",
     size: "valAxisLabelFontSize",
-    color: "valAxisLabelColor"
+    color: "valAxisLabelColor",
+    titleFont: {
+      face: "valAxisTitleFontFace",
+      size: "valAxisTitleFontSize",
+      color: "valAxisTitleColor"
+    },
+    titleRotate: "valAxisTitleRotate"
   });
   assignDefined(opts, {
     valAxisMinVal: axis.minValue,
@@ -546,7 +575,7 @@ function shadowOpts(shadow) {
 function hyperlinkOpts(link) {
   return link.kind === "external" ? { url: link.url, tooltip: link.tooltip } : { slide: link.slideIndex, tooltip: link.tooltip };
 }
-function applyFill(opts, fill2, elementPath, ctx) {
+function applyFill(opts, fill2, elementPath, ctx, transform) {
   switch (fill2.kind) {
     case "none":
       opts.fill = { type: "none" };
@@ -561,7 +590,17 @@ function applyFill(opts, fill2, elementPath, ctx) {
     }
     case "gradient":
     case "pattern":
-      registerAdvancedFill(opts, fill2, elementPath, ctx.pendingFills);
+      registerAdvancedFill(
+        opts,
+        fill2,
+        elementPath,
+        ctx.pendingFills,
+        ctx.rasterizeRadial && transform ? {
+          rasterize: ctx.rasterizeRadial,
+          widthEmu: transform.widthEmu,
+          heightEmu: transform.heightEmu
+        } : void 0
+      );
       return;
     case "image":
       throw new Error(
@@ -668,7 +707,9 @@ function emitTextBox(slide, element, ctx) {
     ...bodyDefaultOpts(element.style),
     ...textBodyOpts(element.style)
   };
-  if (element.fill) applyFill(opts, element.fill, element.path, ctx);
+  if (element.fill) {
+    applyFill(opts, element.fill, element.path, ctx, element.transform);
+  }
   if (element.shadow) opts.shadow = shadowOpts(element.shadow);
   if (element.hyperlink) opts.hyperlink = hyperlinkOpts(element.hyperlink);
   if (element.altText) opts.altText = element.altText;
@@ -703,7 +744,9 @@ function emitShape(slide, element, ctx) {
     return;
   }
   const opts = { ...transformOpts(element.transform) };
-  if (element.fill) applyFill(opts, element.fill, element.path, ctx);
+  if (element.fill) {
+    applyFill(opts, element.fill, element.path, ctx, element.transform);
+  }
   if (element.line) opts.line = lineOpts(element.line);
   if (element.shadow) opts.shadow = shadowOpts(element.shadow);
   if (element.cornerRadius !== void 0)
@@ -1059,7 +1102,7 @@ var init_svgRasterFallback = __esm({
 });
 
 // src/renderers/pptxgenjs/packaging.ts
-function applyPendingFills(xml, pendingFills) {
+function applyPendingFills(xml, pendingFills, spliced = []) {
   let out = xml;
   for (const [index, fill2] of pendingFills.entries()) {
     const marker = `name="${fill2.objectName}"`;
@@ -1070,15 +1113,52 @@ function applyPendingFills(xml, pendingFills) {
     const solidEndTag = "</a:solidFill>";
     const solidEnd = out.indexOf(solidEndTag, solidStart);
     if (solidStart !== -1 && solidEnd !== -1 && spEnd !== -1 && solidStart < spEnd) {
-      out = out.slice(0, solidStart) + fill2.xml + out.slice(solidEnd + solidEndTag.length);
+      let fillXml = fill2.xml;
+      if (fill2.image) {
+        const token = `${IMAGE_FILL_RID}${index}`;
+        fillXml = fillXml.replace(IMAGE_FILL_RID, token);
+        spliced.push({ token, image: fill2.image });
+      }
+      out = out.slice(0, solidStart) + fillXml + out.slice(solidEnd + solidEndTag.length);
     }
     out = out.slice(0, markerIdx) + `name="Fill ${index + 1}"` + out.slice(markerIdx + marker.length);
   }
   return out;
 }
+async function linkImageFills(zip, slidePath, xml, images, media) {
+  if (images.length === 0) return xml;
+  const relsPath = slidePath.replace(
+    /^ppt\/slides\/(slide\d+\.xml)$/,
+    "ppt/slides/_rels/$1.rels"
+  );
+  let rels = await zip.file(relsPath)?.async("string") ?? '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>';
+  let nextId = Math.max(
+    0,
+    ...[...rels.matchAll(/\bId="rId(\d+)"/g)].map((match) => Number(match[1]))
+  ) + 1;
+  let out = xml;
+  for (const { token, image } of images) {
+    let part = media.get(image);
+    if (!part) {
+      part = `ppt/media/jto-gradient-${media.size + 1}.png`;
+      media.set(image, part);
+      zip.file(part, image);
+    }
+    const rId = `rId${nextId}`;
+    nextId += 1;
+    rels = rels.replace(
+      "</Relationships>",
+      `<Relationship Id="${rId}" Type="${IMAGE_REL_TYPE}" Target="../media/${part.slice("ppt/media/".length)}"/></Relationships>`
+    );
+    out = out.replace(`r:embed="${token}"`, `r:embed="${rId}"`);
+  }
+  zip.file(relsPath, rels);
+  return out;
+}
 async function packagePptxGenJsBuffer(buffer, options = {}) {
   const zip = await readPackage(buffer);
   let changed = false;
+  const media = /* @__PURE__ */ new Map();
   for (const [path4, entry] of Object.entries(zip.files)) {
     if (!SLIDE_PART.test(path4)) continue;
     let xml = await entry.async("string");
@@ -1088,7 +1168,9 @@ async function packagePptxGenJsBuffer(buffer, options = {}) {
       fileChanged = true;
     }
     if (options.pendingFills?.length) {
-      const withFills = applyPendingFills(xml, options.pendingFills);
+      const spliced = [];
+      let withFills = applyPendingFills(xml, options.pendingFills, spliced);
+      withFills = await linkImageFills(zip, path4, withFills, spliced, media);
       if (withFills !== xml) {
         xml = withFills;
         fileChanged = true;
@@ -1107,15 +1189,190 @@ async function packagePptxGenJsBuffer(buffer, options = {}) {
   if (!changed) return buffer;
   return writePackage(zip);
 }
-var MEDIUM_STYLE_2_ACCENT_1, NO_STYLE_NO_GRID, SLIDE_PART;
+var MEDIUM_STYLE_2_ACCENT_1, NO_STYLE_NO_GRID, SLIDE_PART, IMAGE_REL_TYPE;
 var init_packaging = __esm({
   "src/renderers/pptxgenjs/packaging.ts"() {
     "use strict";
     init_finalizePackage();
     init_svgRasterFallback();
+    init_fills();
     MEDIUM_STYLE_2_ACCENT_1 = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
     NO_STYLE_NO_GRID = "{2D5ABB26-0587-4C30-8999-92F81FD0307C}";
     SLIDE_PART = /^ppt\/slides\/slide\d+\.xml$/;
+    IMAGE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
+  }
+});
+
+// src/renderers/pptxgenjs/radialRaster.ts
+import pako from "pako";
+function radialRasterSize(widthEmu, heightEmu) {
+  const w = Math.max(widthEmu, 1);
+  const h = Math.max(heightEmu, 1);
+  const longInches = Math.max(w, h) / EMU_PER_INCH3;
+  const longPx = Math.min(
+    MAX_EDGE_PX2,
+    Math.max(MIN_EDGE_PX2, Math.round(longInches * PX_PER_INCH))
+  );
+  const scale = longPx / Math.max(w, h);
+  return {
+    width: Math.max(1, Math.round(w * scale)),
+    height: Math.max(1, Math.round(h * scale))
+  };
+}
+function parseStops(gradient) {
+  return gradient.stops.map((stop, index) => ({ stop, index })).sort((a, b) => a.stop.position - b.stop.position || a.index - b.index).map(({ stop }) => {
+    const hex = parseInt(stop.color.hex, 16);
+    const alpha = stop.color.transparency !== void 0 ? 255 * (1 - Math.min(100, Math.max(0, stop.color.transparency)) / 100) : 255;
+    return {
+      at: Math.min(100, Math.max(0, stop.position)) / 100,
+      rgba: [hex >> 16 & 255, hex >> 8 & 255, hex & 255, alpha]
+    };
+  });
+}
+function paintRadialGradient(gradient, width, height) {
+  const stops = parseStops(gradient);
+  const channels = stops.every((stop) => stop.rgba[3] === 255) ? 3 : 4;
+  const [fx, fy] = FOCUS_POINTS[gradient.focus] ?? FOCUS_POINTS.center;
+  const cx = fx * width;
+  const cy = fy * height;
+  const radius = Math.sqrt(width * width + height * height) / 2;
+  const pixels = new Uint8Array(width * height * channels);
+  for (let y = 0; y < height; y += 1) {
+    const dy = y + 0.5 - cy;
+    for (let x = 0; x < width; x += 1) {
+      const dx = x + 0.5 - cx;
+      const t = Math.min(1, Math.sqrt(dx * dx + dy * dy) / radius);
+      let next = 0;
+      while (next < stops.length && stops[next].at < t) next += 1;
+      const offset = (y * width + x) * channels;
+      if (next === 0 || next === stops.length) {
+        const only = stops[next === 0 ? 0 : stops.length - 1].rgba;
+        for (let c = 0; c < channels; c += 1) pixels[offset + c] = only[c];
+        continue;
+      }
+      const from = stops[next - 1];
+      const to = stops[next];
+      const u = (t - from.at) / (to.at - from.at);
+      for (let c = 0; c < channels; c += 1) {
+        pixels[offset + c] = Math.round(
+          from.rgba[c] + (to.rgba[c] - from.rgba[c]) * u
+        );
+      }
+    }
+  }
+  return { pixels, channels };
+}
+function crc32(bytes) {
+  let c = 4294967295;
+  for (let i = 0; i < bytes.length; i += 1) {
+    c = CRC_TABLE[(c ^ bytes[i]) & 255] ^ c >>> 8;
+  }
+  return (c ^ 4294967295) >>> 0;
+}
+function chunk(type, data) {
+  const out = new Uint8Array(12 + data.length);
+  const view = new DataView(out.buffer);
+  view.setUint32(0, data.length);
+  for (let i = 0; i < 4; i += 1) out[4 + i] = type.charCodeAt(i);
+  out.set(data, 8);
+  view.setUint32(8 + data.length, crc32(out.subarray(4, 8 + data.length)));
+  return out;
+}
+function paethFiltered(pixels, width, height, channels) {
+  const stride = width * channels;
+  const out = new Uint8Array(height * (stride + 1));
+  for (let y = 0; y < height; y += 1) {
+    const row = y * stride;
+    const up = row - stride;
+    const at = y * (stride + 1);
+    out[at] = 4;
+    for (let i = 0; i < stride; i += 1) {
+      const a = i >= channels ? pixels[row + i - channels] : 0;
+      const b = y > 0 ? pixels[up + i] : 0;
+      const c = y > 0 && i >= channels ? pixels[up + i - channels] : 0;
+      const pa = Math.abs(b - c);
+      const pb = Math.abs(a - c);
+      const pc = Math.abs(a + b - 2 * c);
+      const predictor = pa <= pb && pa <= pc ? a : pb <= pc ? b : c;
+      out[at + 1 + i] = pixels[row + i] - predictor & 255;
+    }
+  }
+  return out;
+}
+function encodePng(pixels, width, height, channels) {
+  const header = new Uint8Array(13);
+  const view = new DataView(header.buffer);
+  view.setUint32(0, width);
+  view.setUint32(4, height);
+  header[8] = 8;
+  header[9] = channels === 4 ? 6 : 2;
+  const parts = [
+    new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]),
+    chunk("IHDR", header),
+    chunk(
+      "IDAT",
+      pako.deflate(paethFiltered(pixels, width, height, channels), {
+        level: 6
+      })
+    ),
+    chunk("IEND", new Uint8Array(0))
+  ];
+  const png = new Uint8Array(parts.reduce((sum, p) => sum + p.length, 0));
+  let offset = 0;
+  for (const part of parts) {
+    png.set(part, offset);
+    offset += part.length;
+  }
+  return png;
+}
+function pngDataUri(png) {
+  return `data:image/png;base64,${Buffer.from(png).toString("base64")}`;
+}
+var MAX_EDGE_PX2, PX_PER_INCH, MIN_EDGE_PX2, EMU_PER_INCH3, CACHE_LIMIT, FOCUS_POINTS, CRC_TABLE, cache, rasterizeRadialGradient;
+var init_radialRaster = __esm({
+  "src/renderers/pptxgenjs/radialRaster.ts"() {
+    "use strict";
+    MAX_EDGE_PX2 = 1600;
+    PX_PER_INCH = 160;
+    MIN_EDGE_PX2 = 32;
+    EMU_PER_INCH3 = 914400;
+    CACHE_LIMIT = 32;
+    FOCUS_POINTS = {
+      center: [0.5, 0.5],
+      topLeft: [0, 0],
+      topRight: [1, 0],
+      bottomLeft: [0, 1],
+      bottomRight: [1, 1]
+    };
+    CRC_TABLE = (() => {
+      const table = new Uint32Array(256);
+      for (let n = 0; n < 256; n += 1) {
+        let c = n;
+        for (let k = 0; k < 8; k += 1) {
+          c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+        }
+        table[n] = c >>> 0;
+      }
+      return table;
+    })();
+    cache = /* @__PURE__ */ new Map();
+    rasterizeRadialGradient = (gradient, widthEmu, heightEmu) => {
+      const { width, height } = radialRasterSize(widthEmu, heightEmu);
+      const key = JSON.stringify([gradient.focus, gradient.stops, width, height]);
+      const hit = cache.get(key);
+      if (hit) {
+        cache.delete(key);
+        cache.set(key, hit);
+        return hit;
+      }
+      const { pixels, channels } = paintRadialGradient(gradient, width, height);
+      const png = encodePng(pixels, width, height, channels);
+      cache.set(key, png);
+      if (cache.size > CACHE_LIMIT) {
+        cache.delete(cache.keys().next().value);
+      }
+      return png;
+    };
   }
 });
 
@@ -1126,6 +1383,9 @@ __export(pptxgenjs_exports, {
   buildPresentation: () => buildPresentation,
   createPptxGenJsRenderer: () => createPptxGenJsRenderer
 });
+import { readFile } from "fs/promises";
+import { imageIntegrityDefect as imageIntegrityDefect2 } from "@json-to-office/shared/images/node";
+import { assetUnreadableError as assetUnreadableError2 } from "@json-to-office/shared/rendering";
 import PptxGenJS from "pptxgenjs";
 function createPptxGenJsRenderer() {
   return {
@@ -1133,6 +1393,7 @@ function createPptxGenJsRenderer() {
     format: "pptx",
     capabilities: PPTXGENJS_CAPABILITIES,
     async render(ir, options) {
+      await assertFileImagesDecode(ir.resources);
       const pendingFills = [];
       const pptx = buildPresentation(ir, pendingFills, options?.warnings);
       const raw = await pptx.write({
@@ -1148,7 +1409,21 @@ function createPptxGenJsRenderer() {
     }
   };
 }
-function buildPresentation(ir, pendingFills, warnings) {
+async function assertFileImagesDecode(resources) {
+  await Promise.all(
+    resources.map(async ({ origin }) => {
+      if (origin.kind !== "file") return;
+      let defect;
+      try {
+        defect = imageIntegrityDefect2(await readFile(origin.path));
+      } catch (error) {
+        throw assetUnreadableError2(origin.path, error);
+      }
+      if (defect) throw assetUnreadableError2(origin.path, new Error(defect));
+    })
+  );
+}
+function buildPresentation(ir, pendingFills, warnings, rasterizeRadial = rasterizeRadialGradient) {
   const pptx = new PptxGenJS();
   if (ir.metadata.title) pptx.title = ir.metadata.title;
   if (ir.metadata.author) pptx.author = ir.metadata.author;
@@ -1168,9 +1443,15 @@ function buildPresentation(ir, pendingFills, warnings) {
   const resources = new Map(
     ir.resources.map((resource) => [resource.id, resource])
   );
-  const ctx = { pptx, resources, pendingFills, warnings };
+  const ctx = {
+    pptx,
+    resources,
+    pendingFills,
+    warnings,
+    rasterizeRadial
+  };
   for (const slide of ir.slides) {
-    emitSlide(pptx, slide, ctx);
+    emitSlide(pptx, slide, ir.size, ctx);
   }
   return pptx;
 }
@@ -1181,12 +1462,36 @@ function backgroundProps(background2, resources) {
   if (!resource) return void 0;
   return imageSourceOpts(resource);
 }
-function emitSlide(pptx, slideIr, ctx) {
+function radialBackdrop(element, size) {
+  if (element?.kind !== "shape") return void 0;
+  const { transform, fill: fill2 } = element;
+  if (fill2?.kind !== "gradient" || fill2.gradient.type !== "radial") {
+    return void 0;
+  }
+  const bare = element.geometry === "rect" && !element.line && !element.shadow && !element.hyperlink && !element.altText && !(element.runs && element.runs.length > 0) && !transform.rotationDegrees && !transform.flipHorizontal && !transform.flipVertical;
+  const fullBleed = transform.xEmu === 0 && transform.yEmu === 0 && transform.widthEmu === size.widthEmu && transform.heightEmu === size.heightEmu;
+  return bare && fullBleed ? fill2.gradient : void 0;
+}
+function emitSlide(pptx, slideIr, size, ctx) {
   const slide = pptx.addSlide();
+  let elements = slideIr.elements;
   const background2 = backgroundProps(slideIr.background, ctx.resources);
-  if (background2) slide.background = background2;
+  if (background2) {
+    slide.background = background2;
+  } else if (ctx.rasterizeRadial) {
+    const gradient = radialBackdrop(elements[0], size);
+    if (gradient) {
+      const png = ctx.rasterizeRadial(
+        gradient,
+        elements[0].transform.widthEmu,
+        elements[0].transform.heightEmu
+      );
+      slide.background = { data: pngDataUri(png) };
+      elements = elements.slice(1);
+    }
+  }
   if (slideIr.hidden) slide.hidden = true;
-  for (const element of slideIr.elements) {
+  for (const element of elements) {
     emitElement(slide, element, ctx);
   }
   if (slideIr.notes) slide.addNotes(slideIr.notes);
@@ -1198,6 +1503,7 @@ var init_pptxgenjs = __esm({
     init_units();
     init_emit();
     init_packaging();
+    init_radialRaster();
     PPTXGENJS_RENDERER_ID = "pptxgenjs";
     PPTXGENJS_CAPABILITIES = /* @__PURE__ */ new Set([
       "rich-text",
@@ -1300,6 +1606,8 @@ function axisEdits(axis) {
   const value = axis;
   return {
     ...axis.title !== void 0 ? { title: axis.title } : {},
+    ...axis.title !== void 0 && textStyle(axis.titleFont) ? { titleFont: textStyle(axis.titleFont) } : {},
+    ...axis.title !== void 0 && axis.titleRotate !== void 0 ? { titleRotation: axis.titleRotate } : {},
     ...axis.hidden !== void 0 ? { hidden: axis.hidden } : {},
     ...axis.showLine !== void 0 ? { lineVisible: axis.showLine } : {},
     ...axis.labelRotate !== void 0 ? { labelRotation: axis.labelRotate } : {},
@@ -1894,8 +2202,9 @@ __export(office_open_exports, {
   buildPresentationOptions: () => buildPresentationOptions,
   createOfficeOpenPptxRenderer: () => createOfficeOpenPptxRenderer
 });
-import { readFile } from "fs/promises";
-import { assetUnreadableError } from "@json-to-office/shared/rendering";
+import { readFile as readFile2 } from "fs/promises";
+import { imageIntegrityDefect as imageIntegrityDefect3 } from "@json-to-office/shared/images/node";
+import { assetUnreadableError as assetUnreadableError3 } from "@json-to-office/shared/rendering";
 async function createOfficeOpenPptxRenderer() {
   const backend = await import(
     /* @vite-ignore */
@@ -2004,16 +2313,21 @@ async function resourceBytes(origin) {
   if (origin.kind === "inline") return origin.bytes;
   const location = origin.kind === "file" ? origin.path : origin.url;
   try {
+    let bytes;
     if (origin.kind === "file") {
-      return new Uint8Array(await readFile(origin.path));
-    }
-    const response = await fetch(origin.url);
-    if (!response.ok) {
-      throw new Error(`HTTP ${response.status} ${response.statusText}`);
+      bytes = new Uint8Array(await readFile2(origin.path));
+    } else {
+      const response = await fetch(origin.url);
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status} ${response.statusText}`);
+      }
+      bytes = new Uint8Array(await response.arrayBuffer());
     }
-    return new Uint8Array(await response.arrayBuffer());
+    const defect = imageIntegrityDefect3(bytes);
+    if (defect) throw new Error(defect);
+    return bytes;
   } catch (error) {
-    throw assetUnreadableError(location, error);
+    throw assetUnreadableError3(location, error);
   }
 }
 var OFFICE_OPEN_PPTX_RENDERER_ID, OFFICE_OPEN_PPTX, OFFICE_OPEN_CAPABILITIES, SCHEME_SLOTS;
@@ -2101,7 +2415,9 @@ function resolveFromBaseDir(filePath) {
 }
 
 // src/ir/compiler.ts
+import { imageIntegrityDefect } from "@json-to-office/shared/images/node";
 import {
+  assetUnreadableError,
   FeatureRequirementCollector
 } from "@json-to-office/shared/rendering";
 import { PATTERN_FILL_PRESETS } from "@json-to-office/shared-pptx";
@@ -3097,6 +3413,8 @@ function compileImage(component, scope) {
 function internImageSource(source, path4, ctx) {
   const inline = parseDataUri(source);
   if (inline) {
+    const defect = imageIntegrityDefect(inline.bytes);
+    if (defect) throw assetUnreadableError(source, new Error(defect));
     return ctx.resources.intern({
       kind: "inline",
       bytes: inline.bytes,
@@ -3456,6 +3774,16 @@ function compileChartLabelFont(ctx, slot, face, weight, hasBoldToggle, extra = {
   }
   return font;
 }
+var DEFAULT_AXIS_TITLE_POINTS = 12;
+function axisTitleFont(ctx, labelFont, resolved, authored) {
+  const fontFamily = authored.face ?? labelFont.fontFamily ?? ctx.theme.fonts?.body;
+  return {
+    ...fontFamily !== void 0 ? { fontFamily } : {},
+    fontSize: authored.size ?? labelFont.fontSize ?? DEFAULT_AXIS_TITLE_POINTS,
+    bold: false,
+    color: authored.color !== void 0 ? resolved(authored.color) : labelFont.color ?? resolved(void 0)
+  };
+}
 function compileChartOptions(props, ctx) {
   const colorSources = props.chartColors ?? definedChartColorTokens(ctx.theme);
   const colors = colorSources.map(
@@ -3463,6 +3791,28 @@ function compileChartOptions(props, ctx) {
   );
   const themeTextColor = irColor(resolveColor("text", ctx.theme, ctx.warnings));
   const resolved = (value) => value ? irColor(resolveColor(value, ctx.theme, ctx.warnings)) : themeTextColor;
+  const catLabelFont = compileChartLabelFont(
+    ctx,
+    "catAxisLabelFontFace",
+    props.catAxisLabelFontFace,
+    props.catAxisLabelFontWeight,
+    true,
+    {
+      ...props.catAxisLabelFontSize !== void 0 ? { fontSize: props.catAxisLabelFontSize } : {},
+      color: resolved(props.catAxisLabelColor)
+    }
+  );
+  const valLabelFont = compileChartLabelFont(
+    ctx,
+    "valAxisLabelFontFace",
+    props.valAxisLabelFontFace,
+    props.valAxisLabelFontWeight,
+    true,
+    {
+      ...props.valAxisLabelFontSize !== void 0 ? { fontSize: props.valAxisLabelFontSize } : {},
+      color: resolved(props.valAxisLabelColor)
+    }
+  );
   return {
     colors,
     ...pick(props, {
@@ -3499,24 +3849,26 @@ function compileChartOptions(props, ctx) {
     ),
     categoryAxis: {
       ...props.catAxisTitle !== void 0 ? { title: props.catAxisTitle } : {},
+      titleFont: axisTitleFont(ctx, catLabelFont, resolved, {
+        face: props.catAxisTitleFontFace,
+        size: props.catAxisTitleFontSize,
+        color: props.catAxisTitleColor
+      }),
+      ...props.catAxisTitleRotate !== void 0 ? { titleRotate: props.catAxisTitleRotate } : {},
       ...props.catAxisHidden !== void 0 ? { hidden: props.catAxisHidden } : {},
       ...props.catAxisLabelRotate !== void 0 ? { labelRotate: props.catAxisLabelRotate } : {},
       ...props.catAxisLineShow !== void 0 ? { showLine: props.catAxisLineShow } : {},
       ...props.catGridLine !== void 0 ? { gridLine: compileGridLine(props.catGridLine, ctx) } : {},
-      labelFont: compileChartLabelFont(
-        ctx,
-        "catAxisLabelFontFace",
-        props.catAxisLabelFontFace,
-        props.catAxisLabelFontWeight,
-        true,
-        {
-          ...props.catAxisLabelFontSize !== void 0 ? { fontSize: props.catAxisLabelFontSize } : {},
-          color: resolved(props.catAxisLabelColor)
-        }
-      )
+      labelFont: catLabelFont
     },
     valueAxis: {
       ...props.valAxisTitle !== void 0 ? { title: props.valAxisTitle } : {},
+      titleFont: axisTitleFont(ctx, valLabelFont, resolved, {
+        face: props.valAxisTitleFontFace,
+        size: props.valAxisTitleFontSize,
+        color: props.valAxisTitleColor
+      }),
+      ...props.valAxisTitleRotate !== void 0 ? { titleRotate: props.valAxisTitleRotate } : {},
       ...props.valAxisHidden !== void 0 ? { hidden: props.valAxisHidden } : {},
       ...props.valAxisMinVal !== void 0 ? { minValue: props.valAxisMinVal } : {},
       ...props.valAxisMaxVal !== void 0 ? { maxValue: props.valAxisMaxVal } : {},
@@ -3524,17 +3876,7 @@ function compileChartOptions(props, ctx) {
       ...props.valAxisLabelFormatCode !== void 0 ? { labelFormatCode: props.valAxisLabelFormatCode } : {},
       ...props.valAxisLineShow !== void 0 ? { showLine: props.valAxisLineShow } : {},
       ...props.valGridLine !== void 0 ? { gridLine: compileGridLine(props.valGridLine, ctx) } : {},
-      labelFont: compileChartLabelFont(
-        ctx,
-        "valAxisLabelFontFace",
-        props.valAxisLabelFontFace,
-        props.valAxisLabelFontWeight,
-        true,
-        {
-          ...props.valAxisLabelFontSize !== void 0 ? { fontSize: props.valAxisLabelFontSize } : {},
-          color: resolved(props.valAxisLabelColor)
-        }
-      )
+      labelFont: valLabelFont
     },
     ...props.dataBorder !== void 0 ? {
       dataBorder: {
@@ -3949,7 +4291,7 @@ function isNodeEnvironment() {
 }
 
 // src/core/expandHighcharts.ts
-var PX_PER_INCH = 96;
+var PX_PER_INCH2 = 96;
 var DEFAULT_CHART_WIDTH_PX = 960;
 var DEFAULT_EXPORT_SERVER_URL = "http://localhost:7801";
 async function expandHighchartsComponents(presentation, services, warnings, chartFonts) {
@@ -4021,8 +4363,8 @@ async function expandOne(component, path4, scope) {
       base64: chart.dataUri,
       x: props.x ?? 0,
       y: props.y ?? 0,
-      w: props.w ?? chart.widthPx / PX_PER_INCH,
-      h: props.h ?? chart.heightPx / PX_PER_INCH
+      w: props.w ?? chart.widthPx / PX_PER_INCH2,
+      h: props.h ?? chart.heightPx / PX_PER_INCH2
     }
   };
 }
@@ -4039,7 +4381,7 @@ function assertExportServerAllowed(serverUrl, services, warnings) {
     message: notice
   });
 }
-async function renderChart(config, services, warnings, cache) {
+async function renderChart(config, services, warnings, cache2) {
   if (!isNodeEnvironment()) {
     throw new Error(
       "Highcharts export server requires a Node.js environment. Chart generation is not available in browser environments."
@@ -4057,7 +4399,7 @@ async function renderChart(config, services, warnings, cache) {
     ...config.resources ? { resources: config.resources } : {}
   };
   return sendChartRequest({
-    cache,
+    cache: cache2,
     serverUrl,
     concurrency: services?.concurrency,
     requestBody,
@@ -4104,7 +4446,7 @@ function placedWidthPt(props, slideWidth) {
     return parseFloat(w) / 100 * slideWidth * 72;
   }
   if (w === void 0 && props.grid === void 0) {
-    return (props.options.chart?.width ?? DEFAULT_CHART_WIDTH_PX) / PX_PER_INCH * 72;
+    return (props.options.chart?.width ?? DEFAULT_CHART_WIDTH_PX) / PX_PER_INCH2 * 72;
   }
   return void 0;
 }
@@ -5163,36 +5505,8 @@ var DEFAULT_STYLES = {
   body: { fontSize: 14 },
   caption: { fontSize: 10, italic: true, fontColor: "text2" }
 };
-var DEFAULT_PPTX_THEME = {
-  name: "default",
-  displayName: "Office Default",
-  description: "The stock Office look: blue primary, orange and green accents, Arial throughout, centred titles",
-  whenToUse: "A deck that has to match a plain PowerPoint look; pick a designed theme for anything a client will see.",
-  colors: {
-    primary: "#4472C4",
-    secondary: "#ED7D31",
-    accent: "#70AD47",
-    background: "#FFFFFF",
-    text: "#333333",
-    text2: "#44546A",
-    background2: "#E7E6E6",
-    accent4: "#FFC000",
-    accent5: "#5B9BD5",
-    accent6: "#70AD47"
-  },
-  fonts: {
-    heading: "Arial",
-    body: "Arial"
-  },
-  defaults: {
-    fontSize: 18,
-    fontColor: "#333333"
-  },
-  styles: DEFAULT_STYLES,
-  componentDefaults: { table: DEFAULT_TABLE }
-};
+var DEFAULT_PPTX_THEME = CONSULTING_PPTX_THEME;
 var PPTX_THEMES = {
-  default: DEFAULT_PPTX_THEME,
   consulting: CONSULTING_PPTX_THEME,
   vermilion: VERMILION_PPTX_THEME,
   devportal: DEVPORTAL_PPTX_THEME,
@@ -5332,7 +5646,7 @@ function resolveThemeContext(documentIn, options = {}) {
     inlineTheme = document.props.theme;
   }
   const authoredThemeName = typeof document.props.theme === "string" ? document.props.theme : void 0;
-  const baseThemeName = inlineTheme ? inlineTheme.name || "inline-theme" : authoredThemeName ?? defaultThemeName ?? "default";
+  const baseThemeName = inlineTheme ? inlineTheme.name || "inline-theme" : authoredThemeName ?? defaultThemeName ?? "consulting";
   let theme = inlineTheme ?? (resolveNamedTheme ? resolveNamedTheme(baseThemeName, authoredThemeName !== void 0) : customThemes?.[baseThemeName] ?? getPptxTheme(baseThemeName));
   theme = resolvePptxDesignSystem(
     theme,
@@ -5913,10 +6227,22 @@ async function expandPptxBlocksWithPlugins(document, theme, plugins, render, pre
     preserve
   });
   const finished = finishPptxBlocks(composed.standard, evaluator, effects2);
-  return { ...finished, preserved: composed.preserved };
+  return {
+    ...finished,
+    preserved: composed.preserved,
+    pluginOutputs: evaluator.pluginOutputs
+  };
 }
 
 // src/quality/facts.ts
+function textInsetsPt(props, componentName) {
+  const margin = props.margin;
+  if (typeof margin === "number" && Number.isFinite(margin))
+    return [margin, margin, margin, margin];
+  if (Array.isArray(margin) && margin.length === 4 && margin.every((side) => typeof side === "number" && Number.isFinite(side)))
+    return margin;
+  return componentName === "shape" ? [3.6, 7.2, 3.6, 7.2] : [0, 0, 0, 0];
+}
 function asRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 }
@@ -6054,6 +6380,7 @@ function fillColorHexes(fill2, theme) {
   return [...new Set(found)];
 }
 var FOCUS_CORNERS = {
+  center: [0.5, 0.5],
   topLeft: [0, 0],
   topRight: [1, 0],
   bottomLeft: [0, 1],
@@ -6069,7 +6396,7 @@ function lerpHex(a, b, t) {
 }
 function gradientPosition(gradient, fx, fy, widthUnits, heightUnits) {
   if (gradient.type === "radial") {
-    const focus = FOCUS_CORNERS[typeof gradient.focus === "string" ? gradient.focus : "topLeft"] ?? FOCUS_CORNERS.topLeft;
+    const focus = FOCUS_CORNERS[typeof gradient.focus === "string" ? gradient.focus : "center"] ?? FOCUS_CORNERS.center;
     const radius = Math.hypot(widthUnits, heightUnits) / 2;
     if (radius === 0) return 0;
     const distance = Math.hypot(
@@ -6174,7 +6501,13 @@ function collectSlideNodes(component, path4, text, richText, surfaces, boxes, co
   const content = typeof props.text === "string" ? props.text : void 0;
   if (content !== void 0 && content.trim() !== "" && props.runs === void 0) {
     if (rec.name === "text" || rec.name === "shape") {
-      text.push({ props, path: path4, text: content, order });
+      text.push({
+        props,
+        path: path4,
+        componentName: rec.name,
+        text: content,
+        order
+      });
     }
   }
   if (Array.isArray(props.runs) && (rec.name === "text" || rec.name === "shape")) {
@@ -6182,7 +6515,13 @@ function collectSlideNodes(component, path4, text, richText, surfaces, boxes, co
       (run) => run && typeof run.text === "string" ? `${run.text}${run.breakLine === true ? "\n" : ""}` : ""
     ).join("");
     if (joined.trim() !== "")
-      richText.push({ props, path: path4, text: joined, order });
+      richText.push({
+        props,
+        path: path4,
+        componentName: String(rec.name),
+        text: joined,
+        order
+      });
   }
   const componentName = typeof rec.name === "string" ? rec.name : "";
   if (componentName === "chart" || componentName === "highcharts" || componentName === "table") {
@@ -6357,6 +6696,16 @@ function tableFact(node, slidePath, authoredProps) {
   }
   return { ...base, columns };
 }
+function authoredNameAtPointer(root, pointer) {
+  let node = root;
+  for (const token of pointer.split("/").slice(1)) {
+    const key = token.replace(/~1/g, "/").replace(/~0/g, "~");
+    node = Array.isArray(node) ? node[Number(key)] : asRecord(node)?.[key];
+    if (node === void 0) return void 0;
+  }
+  const name = asRecord(node)?.name;
+  return typeof name === "string" ? name : void 0;
+}
 function authoredPropsAtPointer(root, pointer) {
   let node = root;
   for (const token of pointer.split("/").slice(1)) {
@@ -6374,7 +6723,7 @@ function authoredPropsAtPointer(root, pointer) {
   }
   return asRecord(asRecord(node)?.props);
 }
-function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn, slideHeightIn, ctx, theme, slideBackground, analyzedTextPaths, analyzedContentPaths, paletteTokens, authoredPropsAt, statedPropsAt, authoredPath, addFact) {
+function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn, slideHeightIn, ctx, theme, slideBackground, analyzedTextPaths, analyzedContentPaths, paletteTokens, authoredPropsAt, statedPropsAt, authoredPath, addFact, ownsProps = () => true) {
   const nodes = [];
   const richNodes = [];
   const surfaces = [];
@@ -6406,6 +6755,8 @@ function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn
       statedPropsAt
     );
     if (!isCompleteBox(box)) return;
+    const onSlide = /^\/children\/\d+\/children\/\d+$/.test(node.path) && authoredPath(node.path) === node.path;
+    const authored = onSlide ? authoredPropsAt(node.path) : void 0;
     addFact({
       id: `pptx:box:${renderedIndex}:${boxIndex}:${node.path}`,
       kind: "pptx/box",
@@ -6418,7 +6769,10 @@ function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn
       xPt: box.xPt,
       yPt: box.yPt,
       widthPt: box.widthPt,
-      heightPt: box.heightPt
+      heightPt: box.heightPt,
+      ...typeof authored?.x === "number" && typeof authored?.y === "number" && authored.grid === void 0 && {
+        authoredPositionIn: { x: authored.x, y: authored.y }
+      }
     });
   });
   const surfaceBoxes = surfaces.flatMap((surface) => {
@@ -6522,6 +6876,8 @@ function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn
       }
     }
     const colorHex = typeof node.props.color === "string" ? resolveColor(node.props.color, theme)?.toUpperCase() : void 0;
+    const stated = statedPropsAt(node.path);
+    const setSize = stated && node.props.fit !== void 0 ? resolveTypography(stated, ctx).fontSize : void 0;
     addFact({
       id: `pptx:text:${renderedIndex}:${nodeIndex}:${node.path}`,
       kind: "pptx/text",
@@ -6531,6 +6887,7 @@ function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn
       nodePath: node.path,
       text: node.text,
       fontSizePt: typography.fontSize,
+      ...setSize !== void 0 && setSize !== typography.fontSize && { fitFromPt: setSize },
       lineSpacingPt: typography.lineSpacing,
       paraSpaceBeforePt: typography.paraSpaceBefore,
       paraSpaceAfterPt: typography.paraSpaceAfter,
@@ -6539,6 +6896,7 @@ function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn
       ...boxYPt !== void 0 && { boxYPt },
       ...boxWidthPt !== void 0 && boxWidthPt > 0 && { boxWidthPt },
       ...boxHeightPt !== void 0 && boxHeightPt > 0 && { boxHeightPt },
+      insetsPt: textInsetsPt(node.props, node.componentName),
       verticalAlign: node.props.valign === "middle" || node.props.valign === "bottom" ? node.props.valign : "top",
       align: horizontalAlign(node.props, ctx),
       rotationDeg: asNumber(node.props.rotate) ?? 0,
@@ -6550,6 +6908,7 @@ function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn
         sizePath: `${node.path}/props/fontSize`
       },
       generated: authoredPath(node.path) !== node.path,
+      ownsProps: ownsProps(node.path),
       autoFit: node.props.h === void 0 && gridPos === void 0,
       ...colorHex !== void 0 && { colorHex },
       ...!backgroundUnknown && backgroundHexes.length > 0 && { backgroundHexes }
@@ -6630,7 +6989,10 @@ function addSlideFacts(roots, slidePath, renderedIndex, page, grid, slideWidthIn
         ...stretched && isCompleteBox(resolved) && resolved.heightPt > 0 && {
           drawnRatio: resolved.widthPt / resolved.heightPt
         },
-        ...natural !== void 0 && { naturalRatio: natural }
+        ...natural !== void 0 && { naturalRatio: natural },
+        ...stretched && typeof authored.w === "number" && typeof authored.h === "number" && {
+          authoredSizeIn: { w: authored.w, h: authored.h }
+        }
       });
     }
     const bullets = bulletItems(box.props);
@@ -6651,7 +7013,7 @@ function preparePptxQualityDocument(document, options = {}) {
   const facts = [];
   const provenance = {};
   let sourceMap = {};
-  const authoredPath = (path4) => toAuthoredPointer(sourceMap, path4);
+  const authoredPath = (path4) => toAuthoredPointer(sourceMap, path4, options.expanded?.pluginOutputs);
   const addFact = (raw) => {
     const fact = {
       ...raw,
@@ -6698,12 +7060,12 @@ function preparePptxQualityDocument(document, options = {}) {
     });
   });
   const warnings = options.warnings ?? [];
-  const context = resolveThemeContext(document, {
+  const context = options.context ?? resolveThemeContext(document, {
     customThemes: options.customThemes,
     fonts: options.fonts,
     warnings
   });
-  const expanded = expandPptxBlocks(context.document, context.theme);
+  const expanded = options.expanded ?? expandPptxBlocks(context.document, context.theme);
   sourceMap = expanded.sourceMap;
   const processed = processPresentation(expanded.document, {
     theme: context.theme,
@@ -6797,6 +7159,10 @@ function preparePptxQualityDocument(document, options = {}) {
     (value) => `#${resolveColor(value, processed.theme)}`
   ) ?? SERIES_COLOR_TOKENS.filter((token) => paletteHexes[token] !== void 0);
   const authoredPropsAt = (pointer) => authoredPropsAtPointer(document, authoredPath(pointer));
+  const pluginOutputs = options.expanded?.pluginOutputs ?? [];
+  const ownsProps = (pointer) => !pluginOutputs.some(
+    (prefix) => pointer === prefix || pointer.startsWith(`${prefix}/`)
+  ) && authoredNameAtPointer(document, authoredPath(pointer)) !== "block";
   const statedPropsAt = (pointer) => authoredPropsAtPointer(expanded.document, pointer);
   let exportedPages = 0;
   processed.slides.forEach((slide, renderedIndex) => {
@@ -6834,7 +7200,8 @@ function preparePptxQualityDocument(document, options = {}) {
       authoredPropsAt,
       statedPropsAt,
       authoredPath,
-      addFact
+      addFact,
+      ownsProps
     );
   });
   for (const budget of blockSlotBudgets(context.document, expanded.blocks)) {
@@ -6844,10 +7211,10 @@ function preparePptxQualityDocument(document, options = {}) {
       ...budget
     });
   }
-  const slotTextNodes = textNodesBySlot(processed, slideIndexes, sourceMap);
+  const slotNodes = nodesBySlot(processed, slideIndexes, sourceMap);
   for (const role of blockSlotRoles(context.document, expanded.blocks)) {
     const present = role.value !== void 0 && role.value !== null && role.value !== false && (typeof role.value !== "string" || role.value.trim() !== "") && (!Array.isArray(role.value) || role.value.length > 0);
-    const bound = slotTextNodes.get(role.path);
+    const bound = slotNodes.get(role.path);
     let measured;
     if (bound && typeof bound.props.text === "string") {
       const typography = resolveTypography(bound.props, ctx);
@@ -6885,6 +7252,30 @@ function preparePptxQualityDocument(document, options = {}) {
       ...measured
     });
   }
+  const footerType = typeof processed.theme.chrome?.confidentialFooter?.type === "string" ? processed.theme.chrome.confidentialFooter.type : "footer";
+  processed.slides.forEach((slide, renderedIndex) => {
+    const authoredIndex = slideIndexes[renderedIndex];
+    if (authoredIndex === void 0) return;
+    const slidePath = `/children/${authoredIndex}`;
+    const onSlide = (fact) => "slidePath" in fact && fact.slidePath === slidePath;
+    const texts = facts.filter(
+      (fact) => (fact.kind === "pptx/text" || fact.kind === "pptx/rich-text") && onSlide(fact)
+    );
+    addFact({
+      id: `pptx:slide-chrome:${slidePath}`,
+      kind: "pptx/slide-chrome",
+      path: slidePath,
+      index: renderedIndex,
+      ...slide.hidden === true && { hidden: true },
+      blocks: expanded.blocks.filter(
+        (pointer) => pointer.startsWith(`${slidePath}/children/`)
+      ).length,
+      pageNumber: texts.some((fact) => fact.text.includes("{PAGE_NUMBER}")),
+      footer: texts.some((fact) => fact.styleName === footerType) || facts.some(
+        (fact) => fact.kind === "pptx/chrome-slot" && fact.role === "footer" && fact.present && onSlide(fact)
+      )
+    });
+  });
   return {
     format: "pptx",
     model: {
@@ -6907,7 +7298,7 @@ function preparePptxQualityDocument(document, options = {}) {
     }
   };
 }
-function textNodesBySlot(processed, slideIndexes, sourceMap) {
+function nodesBySlot(processed, slideIndexes, sourceMap) {
   const found = /* @__PURE__ */ new Map();
   const visit = (component, path4) => {
     if (component.enabled === false) return;
@@ -6915,6 +7306,10 @@ function textNodesBySlot(processed, slideIndexes, sourceMap) {
       const origin = toAuthoredPointer(sourceMap, `${path4}/props/text`);
       if (origin !== `${path4}/props/text` && !found.has(origin))
         found.set(origin, { props: asRecord(component.props) ?? {}, path: path4 });
+    } else {
+      const origin = toAuthoredPointer(sourceMap, path4);
+      if (origin !== path4 && origin.includes("/props/slots/") && !found.has(origin))
+        found.set(origin, { props: asRecord(component.props) ?? {}, path: path4 });
     }
     (component.children ?? []).forEach(
       (child, index) => visit(child, `${path4}/children/${index}`)
@@ -7673,6 +8068,8 @@ import {
 // src/quality/rules.ts
 import {
   chartInfoDesignFindings,
+  configurationLabel,
+  configurationSource,
   DEFAULT_MAXIMUM_CHART_SERIES,
   DEFAULT_MAXIMUM_PIE_SLICES,
   fontCountFinding,
@@ -7813,19 +8210,24 @@ var pptxMinimumFontRule = {
     );
     return textFacts(facts).filter((fact) => fact.fontSizePt < minimum).map((fact) => ({
       message: `Effective font size is ${fact.fontSizePt}pt \u2014 unreadable on a projected slide.`,
-      path: `${fact.path}/props`,
+      // Text a definition or a plugin generated reports at the invocation
+      // the author wrote, whose props are the block's or the plugin's: no
+      // fontSize of theirs to lift, so no patch.
+      path: fact.ownsProps ? `${fact.path}/props` : fact.path,
       suggestion: `Use at least ${minimum}pt; captions rarely work below 10pt.`,
       context: { fontSize: fact.fontSizePt, threshold: minimum },
       evidence: { actual: fact.fontSizePt, expected: minimum, unit: "pt" },
       // `add` replaces an existing member, so this lifts an explicit
       // fontSize and overrides an inherited style value alike.
-      fixes: [
-        {
-          op: "add",
-          path: `${fact.path}/props/fontSize`,
-          value: minimum
-        }
-      ]
+      ...fact.ownsProps && {
+        fixes: [
+          {
+            op: "add",
+            path: `${fact.path}/props/fontSize`,
+            value: minimum
+          }
+        ]
+      }
     }));
   }
 };
@@ -8429,18 +8831,67 @@ var pptxRequiredChromeRule = {
     if (required.length === 0) return [];
     return facts.filter(
       (fact) => fact.kind === "pptx/chrome-slot"
-    ).filter((fact) => required.includes(fact.role) && !fact.present).map((fact) => ({
-      path: fact.path,
-      relatedPaths: [fact.invocation],
-      message: `${fact.block} states no ${fact.role} in its "${fact.slot}" slot; the ${profile?.id ?? "selected"} profile expects one on every ${fact.block}.`,
-      suggestion: `Fill the "${fact.slot}" slot. The theme already styles it.`,
-      context: { block: fact.block, slot: fact.slot, role: fact.role },
-      evidence: {
-        actual: "empty",
-        expected: fact.role,
-        values: { source: "profile", required }
-      }
-    }));
+    ).filter((fact) => required.includes(fact.role) && !fact.present).map((fact) => {
+      const source = configurationSource(configuration, "required");
+      return {
+        path: fact.path,
+        relatedPaths: [fact.invocation],
+        message: `${fact.block} states no ${fact.role} in its "${fact.slot}" slot; ${configurationLabel(source, profile)} expects one on every ${fact.block}.`,
+        suggestion: `Fill the "${fact.slot}" slot. The theme already styles it.`,
+        context: { block: fact.block, slot: fact.slot, role: fact.role },
+        evidence: {
+          actual: "empty",
+          expected: fact.role,
+          values: { source, required }
+        }
+      };
+    });
+  }
+};
+var SLIDE_CHROME_PARTS = ["pageNumber", "footer"];
+var pptxSlideFooterRule = {
+  id: "pptx/slide-footer",
+  description: "A block-built slide without the running chrome a profile or policy expects: a page number, a footer line. Off until one names parts.",
+  code: QUALITY_CODES.CHROME_MISSING,
+  category: "consistency",
+  defaultSeverity: "warning",
+  defaultCertainty: "deterministic",
+  formats: ["pptx"],
+  defaultParameters: { required: [], fromSlide: 1 },
+  evaluate: ({ facts, configuration, profile }) => {
+    const required = stringListParameter(
+      configuration.parameters,
+      "required"
+    ).filter(
+      (part) => SLIDE_CHROME_PARTS.includes(part)
+    );
+    if (required.length === 0) return [];
+    const from = numberParameter(configuration.parameters, "fromSlide", 1);
+    return facts.filter(
+      (fact) => fact.kind === "pptx/slide-chrome" && fact.blocks > 0 && fact.hidden !== true && fact.index >= from
+    ).flatMap((fact) => {
+      const missing = required.filter((part) => !fact[part]);
+      if (missing.length === 0) return [];
+      const parts = missing.map((part) => part === "pageNumber" ? "page number" : "footer").join(" or ");
+      const source = configurationSource(
+        configuration,
+        "required",
+        "fromSlide"
+      );
+      return [
+        {
+          path: fact.path,
+          message: `Slide ${fact.index + 1} carries no ${parts}; ${configurationLabel(source, profile)} expects one on every slide a block builds from slide ${from + 1} on.`,
+          suggestion: "Build the slide with a block that draws the running footer \u2014 the house blocks set {PAGE_NUMBER} / {PAGE_COUNT} in the footer role \u2014 or add that text to the definition the slide invokes.",
+          context: { slide: fact.index, missing },
+          evidence: {
+            actual: required.filter((part) => fact[part]),
+            expected: required,
+            values: { source, fromSlide: from }
+          }
+        }
+      ];
+    });
   }
 };
 var pptxActionTitleRule = {
@@ -8473,6 +8924,8 @@ var pptxActionTitleRule = {
   }
 };
 var TITLE_DRIFT_TOLERANCE_PT = 2;
+var FIRST_BASELINE_EM = 0.8;
+var TITLE_PLACEMENT_LINES = 2;
 var PPTX_TYPE_VOCABULARY = {
   subject: "deck",
   keepTo: "Keep to the theme styles \u2014 title, heading, body, label, statistic \u2014 and drop the ad-hoc sizes."
@@ -8549,11 +9002,15 @@ var pptxSizeCountRule = {
   defaultParameters: { maximumSizes: 8, maximumSizesPerSlide: 0 },
   evaluate: ({ facts, configuration, profile }) => {
     const sizes = paintedSizes(facts);
+    const setBy = (parameter) => {
+      const source = configurationSource(configuration, parameter);
+      return { source, label: configurationLabel(source, profile) };
+    };
     const findings = sizeCountFinding(
       sizes,
       numberParameter(configuration.parameters, "maximumSizes", 8),
       pptxThemeFact(facts)?.path ?? "/props",
-      profile?.id,
+      setBy("maximumSizes"),
       PPTX_TYPE_VOCABULARY
     ).map((finding) => ({
       ...finding,
@@ -8576,7 +9033,7 @@ var pptxSizeCountRule = {
         onSlide,
         perSlide,
         slidePath,
-        profile?.id,
+        setBy("maximumSizesPerSlide"),
         PPTX_SLIDE_TYPE_VOCABULARY
       ))
         findings.push({
@@ -8600,53 +9057,107 @@ var pptxRoleDriftRule = {
     return theme ? roleDriftFindings(paintedSizes(facts), theme.roleSizesPt) : [];
   }
 };
-function titleGroups(facts, styles) {
-  const texts = textFacts(facts).filter(
-    (fact) => fact.boxXPt !== void 0 && fact.boxYPt !== void 0
+var EDGE_NAMES = {
+  left: "left edge",
+  center: "centre line",
+  right: "right edge"
+};
+function laidOutTitle(fact, path4, order) {
+  if (fact.boxXPt === void 0 || fact.boxYPt === void 0 || fact.boxWidthPt === void 0 || fact.rotationDeg % 360 !== 0)
+    return void 0;
+  const [top, right, bottom, left] = fact.insetsPt;
+  const innerWidth = Math.max(1, fact.boxWidthPt - left - right);
+  const { heightPt, lines } = estimateTextHeightPt(
+    fact.text,
+    innerWidth,
+    fact.fontSizePt,
+    fact.lineSpacingPt,
+    fact.paraSpaceBeforePt,
+    fact.paraSpaceAfterPt
   );
-  const groups = /* @__PURE__ */ new Map();
+  let textTop = fact.boxYPt + top;
+  if (fact.boxHeightPt !== void 0 && !fact.autoFit) {
+    const room = fact.boxHeightPt - top - bottom - heightPt;
+    if (fact.verticalAlign === "middle") textTop += room / 2;
+    else if (fact.verticalAlign === "bottom") textTop += room;
+  }
+  const align = fact.align === "justify" ? "left" : fact.align;
+  const edgePt = align === "center" ? fact.boxXPt + left + innerWidth / 2 : align === "right" ? fact.boxXPt + fact.boxWidthPt - right : fact.boxXPt + left;
+  const style = fact.styleName ?? "unstyled";
+  const setSizePt = fact.fitFromPt ?? fact.fontSizePt;
+  return {
+    fact,
+    path: path4,
+    kind: `${style}|${setSizePt}|${align}`,
+    style,
+    setSizePt,
+    align,
+    lines,
+    baselinePt: textTop + FIRST_BASELINE_EM * fact.fontSizePt,
+    edgePt,
+    order
+  };
+}
+function deckTitles(facts, styles) {
+  const texts = textFacts(facts).filter((fact) => !fact.slideHidden);
+  const slideIndex = (fact) => Number(/^\/children\/(\d+)/.exec(fact.slidePath)?.[1] ?? 0);
+  const order = new Map(
+    texts.map((fact, index) => [fact, slideIndex(fact) * 1e4 + index])
+  );
+  const byNode = new Map(texts.map((fact) => [fact.nodePath, fact]));
+  const titles = [];
   const claimed = /* @__PURE__ */ new Set();
-  const push = (key, fact) => {
+  const add = (fact, path4) => {
     if (claimed.has(fact)) return;
     claimed.add(fact);
-    groups.set(key, [...groups.get(key) ?? [], fact]);
+    const title = laidOutTitle(fact, path4, order.get(fact));
+    if (title) titles.push(title);
   };
-  for (const slot of facts) {
-    if (slot.kind !== "pptx/chrome-slot" || slot.role !== "actionTitle")
-      continue;
-    const chrome = slot;
-    if (chrome.text === void 0) continue;
-    const painted = texts.find(
-      (fact) => fact.slidePath === chrome.slidePath && fact.text === chrome.text
-    );
-    if (painted) push(chrome.block, painted);
-  }
+  for (const slot of facts)
+    if (slot.kind === "pptx/chrome-slot" && slot.role === "actionTitle" && slot.nodePath !== void 0) {
+      const painted = byNode.get(slot.nodePath);
+      if (painted) add(painted, slot.path);
+    }
   for (const fact of texts)
     if (fact.styleName !== void 0 && styles.includes(fact.styleName))
-      push(`style:${fact.styleName}`, fact);
-  return groups;
-}
-function prevailing(values) {
-  const counts = /* @__PURE__ */ new Map();
-  for (const value of values) counts.set(value, (counts.get(value) ?? 0) + 1);
-  let best;
-  let bestCount = 0;
-  for (const value of values) {
-    const count = counts.get(value);
-    if (count > bestCount) {
-      best = value;
-      bestCount = count;
+      add(fact, fact.path);
+  return titles.sort((a, b) => a.order - b.order);
+}
+function titlePlacements(titles, tolerance) {
+  const lands = (a, b) => Math.abs(a.baselinePt - b.baselinePt) <= tolerance && Math.abs(a.edgePt - b.edgePt) <= tolerance;
+  const byKind = /* @__PURE__ */ new Map();
+  for (const title of titles)
+    byKind.set(title.kind, [...byKind.get(title.kind) ?? [], title]);
+  const placements = [];
+  for (const kind of byKind.values()) {
+    let pending = kind;
+    while (pending.length > 0) {
+      let reference = pending[0];
+      let most = 0;
+      for (const candidate of pending) {
+        const count = pending.filter((other) => lands(other, candidate)).length;
+        if (count > most) {
+          reference = candidate;
+          most = count;
+        }
+      }
+      const reach = TITLE_PLACEMENT_LINES * reference.fact.lineSpacingPt;
+      const members = pending.filter(
+        (title) => Math.abs(title.baselinePt - reference.baselinePt) <= reach && Math.abs(title.edgePt - reference.edgePt) <= reach
+      );
+      placements.push({ reference, members });
+      pending = pending.filter((title) => !members.includes(title));
     }
   }
-  return best;
+  return placements;
 }
 var pptxTitleDriftRule = {
   id: "pptx/title-drift",
-  description: "A slide title away from the left edge or baseline the deck\u2019s other titles of that kind share. Off until a profile or policy enables it.",
+  description: "A slide title whose laid-out first baseline or aligned edge is away from where the deck\u2019s other titles of that kind land. Off until a profile or policy enables it.",
   code: QUALITY_CODES.TITLE_DRIFT,
   category: "consistency",
   defaultSeverity: "warning",
-  defaultCertainty: "deterministic",
+  defaultCertainty: "estimated",
   formats: ["pptx"],
   defaultEnabled: false,
   defaultParameters: {
@@ -8661,40 +9172,53 @@ var pptxTitleDriftRule = {
       TITLE_DRIFT_TOLERANCE_PT
     );
     const findings = [];
-    for (const [kind, titles] of titleGroups(facts, styles)) {
-      if (titles.length < 2) continue;
-      const axes = [
-        {
-          key: "left edge",
-          prop: "boxXPt",
-          value: prevailing(titles.map((fact) => fact.boxXPt))
-        },
-        {
-          key: "baseline",
-          prop: "boxYPt",
-          value: prevailing(titles.map((fact) => fact.boxYPt))
-        }
-      ];
-      for (const fact of titles) {
-        const off = axes.filter(
-          (axis) => axis.value !== void 0 && Math.abs(fact[axis.prop] - axis.value) > tolerance
+    for (const { reference, members } of titlePlacements(
+      deckTitles(facts, styles),
+      tolerance
+    )) {
+      if (members.length < 2) continue;
+      const agreeing = members.filter(
+        (title) => Math.abs(title.baselinePt - reference.baselinePt) <= tolerance && Math.abs(title.edgePt - reference.edgePt) <= tolerance
+      );
+      for (const title of members) {
+        if (agreeing.includes(title)) continue;
+        const edge = EDGE_NAMES[title.align];
+        const off = [
+          {
+            axis: "first baseline",
+            actual: title.baselinePt,
+            expected: reference.baselinePt
+          },
+          { axis: edge, actual: title.edgePt, expected: reference.edgePt }
+        ].filter(
+          (entry) => Math.abs(entry.actual - entry.expected) > tolerance
         );
-        if (off.length === 0) continue;
         const [first] = off;
+        const size = title.fact.fontSizePt !== reference.fact.fontSizePt ? ` The fit pass sets it at ${title.fact.fontSizePt}pt, where they set at ${reference.fact.fontSizePt}pt.` : "";
         findings.push({
-          path: fact.path,
-          message: `This ${kind.startsWith("style:") ? kind.slice(6) : kind} title sits at ${off.map((axis) => `${axis.key} ${round(fact[axis.prop])}pt`).join(", ")}; the deck's others share ${off.map((axis) => `${axis.key} ${round(axis.value)}pt`).join(", ")}.`,
-          suggestion: "Place every title of one kind with the same block or the same coordinates, so the deck holds one line down the page.",
+          path: title.path,
+          relatedPaths: agreeing.map((other) => other.path),
+          message: `This ${title.style} title lays out at ${off.map((entry) => `${entry.axis} ${round(entry.actual)}pt`).join(", ")}; the deck's other titles of that kind land at ${off.map((entry) => `${entry.axis} ${round(entry.expected)}pt`).join(", ")}.${size}`,
+          suggestion: "Place every title of one kind with the same block or the same coordinates, anchor them alike, and keep each short enough to set at the size the others keep.",
           context: {
-            kind,
-            axes: off.map((axis) => axis.key),
-            slide: fact.slidePath
+            style: title.style,
+            setSizePt: title.setSizePt,
+            align: title.align,
+            axes: off.map((entry) => entry.axis),
+            slide: title.fact.slidePath
           },
           evidence: {
-            actual: round(fact[first.prop]),
-            expected: round(first.value),
+            summary: "estimated first baseline and aligned edge",
+            actual: round(first.actual),
+            expected: round(first.expected),
             unit: "pt",
-            values: { axis: first.key, source: "profile" }
+            values: {
+              axis: first.axis,
+              lines: title.lines,
+              fontSizePt: title.fact.fontSizePt,
+              verticalAlign: title.fact.verticalAlign,
+              source: configurationSource(configuration, "tolerancePt")
+            }
           }
         });
       }
@@ -8747,7 +9271,9 @@ var pptxBulletRule = {
             actual: bullets.items,
             expected: maximumBullets,
             unit: "bullets",
-            values: { source: "profile" }
+            values: {
+              source: configurationSource(configuration, "maximumBullets")
+            }
           }
         });
       if (maximumWords > 0 && bullets.longestWords > maximumWords)
@@ -8761,16 +9287,39 @@ var pptxBulletRule = {
             actual: bullets.longestWords,
             expected: maximumWords,
             unit: "words",
-            values: { source: "profile" }
+            values: {
+              source: configurationSource(
+                configuration,
+                "maximumWordsPerBullet"
+              )
+            }
           }
         });
     }
     return findings;
   }
 };
+function safeAreaFixes(fact, canvas, safe) {
+  const position = fact.authoredPositionIn;
+  if (position === void 0 || fact.widthPt > canvas.widthPt - 2 * safe || fact.heightPt > canvas.heightPt - 2 * safe)
+    return [];
+  const clamp = (valuePt, sizePt, extentPt) => {
+    const low = Math.ceil(safe / 72 * 1e3) / 1e3;
+    const high = Math.floor((extentPt - safe - sizePt) / 72 * 1e3) / 1e3;
+    return Math.min(Math.max(valuePt / 72, low), high);
+  };
+  const fixes = [];
+  const x = clamp(fact.xPt, fact.widthPt, canvas.widthPt);
+  const y = clamp(fact.yPt, fact.heightPt, canvas.heightPt);
+  if (Math.abs(x - position.x) > 5e-4)
+    fixes.push({ op: "replace", path: `${fact.path}/props/x`, value: x });
+  if (Math.abs(y - position.y) > 5e-4)
+    fixes.push({ op: "replace", path: `${fact.path}/props/y`, value: y });
+  return fixes;
+}
 var pptxSafeAreaRule = {
   id: "pptx/safe-area",
-  description: "Content outside the theme\u2019s safe area that is neither chrome nor a full bleed. Off until a profile or policy enables it.",
+  description: "Content outside the theme\u2019s safe area that is neither chrome (a tracker, footer, source or logo) nor a full bleed. Off until a profile or policy enables it.",
   code: QUALITY_CODES.SAFE_AREA,
   category: "composition",
   defaultSeverity: "warning",
@@ -8791,7 +9340,7 @@ var pptxSafeAreaRule = {
     if (canvas === void 0 || safe === void 0 || safe <= 0) return [];
     const chromeNodes = new Set(
       facts.filter(
-        (fact) => fact.kind === "pptx/chrome-slot" && (fact.role === "tracker" || fact.role === "footer" || fact.role === "source")
+        (fact) => fact.kind === "pptx/chrome-slot" && (fact.role === "tracker" || fact.role === "footer" || fact.role === "source" || fact.role === "logo")
       ).flatMap((fact) => fact.nodePath ? [fact.nodePath] : [])
     );
     const chromeStyles = /* @__PURE__ */ new Set(["footer", "tracker", "source"]);
@@ -8817,6 +9366,7 @@ var pptxSafeAreaRule = {
         right - (canvas.widthPt - safe),
         bottom - (canvas.heightPt - safe)
       );
+      const fixes = safeAreaFixes(fact, canvas, safe);
       return [
         {
           path: fact.path,
@@ -8828,7 +9378,8 @@ var pptxSafeAreaRule = {
             expected: 0,
             unit: "pt",
             values: { source: "theme" }
-          }
+          },
+          ...fixes.length > 0 && { fixes }
         }
       ];
     });
@@ -8864,7 +9415,7 @@ var pptxSlideTitleRule = {
         actual: 0,
         expected: 1,
         unit: "titles",
-        values: { source: "profile" }
+        values: { source: configurationSource(configuration) }
       }
     }));
   }
@@ -8913,7 +9464,20 @@ var pptxImageAspectRule = {
         {
           path: fact.path,
           drawn: fact.drawnRatio,
-          natural: fact.naturalRatio
+          natural: fact.naturalRatio,
+          ...fact.authoredSizeIn && {
+            sides: {
+              width: {
+                path: `${fact.path}/props/w`,
+                value: fact.authoredSizeIn.w
+              },
+              height: {
+                path: `${fact.path}/props/h`,
+                value: fact.authoredSizeIn.h
+              },
+              decimals: 3
+            }
+          }
         },
         "slide",
         tolerance
@@ -8939,6 +9503,7 @@ var PPTX_QUALITY_RULES = {
     pptxOffCanvasRule,
     pptxSlotBudgetRule,
     pptxRequiredChromeRule,
+    pptxSlideFooterRule,
     pptxActionTitleRule,
     pptxTypeScaleRule,
     pptxSizeCountRule,
@@ -8973,11 +9538,12 @@ var PPTX_QUALITY_PROFILES = {
   "consulting-deck": {
     id: "consulting-deck",
     formats: ["pptx"],
-    description: "Consulting readout: every content slide leads with a two-line action title, every chart carries a takeaway and a source, content stays inside the theme\u2019s safe area, a box holds at most five bullets of at most twelve words, every figure carries alt text, every size is on the theme scale with at most nine in the deck and six on a slide, and titles of one kind hold one line.",
+    description: "Consulting readout: every content slide leads with a two-line action title, every chart carries a takeaway and a source, every slide a block builds after the cover carries its page number, content stays inside the theme\u2019s safe area, a box holds at most five bullets of at most twelve words, every figure carries alt text, every size is on the theme scale with at most nine in the deck and six on a slide, and titles of one kind hold one line.",
     rules: {
       "pptx/required-chrome": {
         parameters: { required: ["takeaway", "source"] }
       },
+      "pptx/slide-footer": { parameters: { required: ["pageNumber"] } },
       "pptx/action-title": { parameters: { maxLines: 2 } },
       "pptx/slide-density": { parameters: { maximumBodyWords: 90 } },
       "pptx/type-scale": { enabled: true },
@@ -9270,97 +9836,152 @@ function createBuilderImpl(state) {
       newState
     );
   }
-  async function generate(document, options) {
-    try {
-      let internalDocument = document;
-      const renderer = options?.renderer ?? state.renderer ?? internalDocument.renderer;
-      const validationDocument = renderer === void 0 ? internalDocument : { ...internalDocument, renderer };
-      const validationOptions = {
-        ...state.validation,
-        ...options?.validation
-      };
-      if (validationOptions.enabled !== false) {
-        const result = validatePresentation(
-          validationDocument,
-          state.components,
-          { allowUnknownFields: validationOptions.allowUnknownFields }
+  async function expandPresentation(document, options) {
+    let internalDocument = document;
+    const renderer = options?.renderer ?? state.renderer ?? internalDocument.renderer;
+    const validationDocument = renderer === void 0 ? internalDocument : { ...internalDocument, renderer };
+    const validationOptions = {
+      ...state.validation,
+      ...options?.validation
+    };
+    if (validationOptions.enabled !== false) {
+      const result = validatePresentation(
+        validationDocument,
+        state.components,
+        { allowUnknownFields: validationOptions.allowUnknownFields }
+      );
+      if (!result.valid) {
+        throw new ComponentValidationError3(result.errors, internalDocument);
+      }
+    } else if (!internalDocument || internalDocument.name !== "pptx") {
+      throw new Error("Top-level component must be a pptx component");
+    }
+    const warnings = [];
+    const context = resolveThemeContext(internalDocument, {
+      customThemes: state.customThemes,
+      fonts: state.fonts,
+      warnings,
+      defaultThemeName: typeof state.theme === "string" ? state.theme : void 0,
+      resolveNamedTheme: (name, authored) => state.customThemes?.[name] ?? (authored && hasPptxTheme(name) ? getPptxTheme(name) : void 0) ?? (typeof state.theme === "object" && state.theme !== null ? state.theme : getPptxTheme(name))
+    });
+    const modedRoot = context.document;
+    const resolvedTheme = context.theme;
+    const validateEmitted = validationOptions.enabled === false ? void 0 : (emitted, componentLabel, parentName) => {
+      let validationDocument2;
+      if (parentName === "pptx") {
+        validationDocument2 = {
+          ...modedRoot,
+          ...renderer !== void 0 ? { renderer } : {},
+          children: emitted
+        };
+      } else if (parentName === "slide") {
+        validationDocument2 = {
+          ...modedRoot,
+          ...renderer !== void 0 ? { renderer } : {},
+          children: [{ name: "slide", props: {}, children: emitted }]
+        };
+      } else {
+        return;
+      }
+      const result = validatePresentation(
+        validationDocument2,
+        state.components,
+        { allowUnknownFields: validationOptions.allowUnknownFields }
+      );
+      if (!result.valid) {
+        throw new ComponentValidationError3(
+          result.errors.map((error) => ({
+            ...error,
+            message: `custom component '${componentLabel}' emitted invalid output \u2014 ${error.message}`
+          })),
+          emitted
         );
-        if (!result.valid) {
-          throw new ComponentValidationError3(result.errors, internalDocument);
+      }
+    };
+    const expanded = await expandPptxBlocksWithPlugins(
+      modedRoot,
+      resolvedTheme,
+      new Set(componentMap.keys()),
+      pluginRenderer(warnings, resolvedTheme, validateEmitted)
+    );
+    const processedDocument = expanded.document;
+    if (validationOptions.enabled !== false) {
+      const result = validatePresentation(
+        {
+          ...processedDocument,
+          ...renderer !== void 0 ? { renderer } : {}
+        },
+        [],
+        {
+          allowUnknownFields: validationOptions.allowUnknownFields
         }
-      } else if (!internalDocument || internalDocument.name !== "pptx") {
-        throw new Error("Top-level component must be a pptx component");
+      );
+      if (!result.valid) {
+        throw new ComponentValidationError3(
+          result.errors.map((error) => ({
+            ...error,
+            message: `expanded plugin output failed validation \u2014 ${error.message}`
+          })),
+          processedDocument
+        );
       }
-      const warnings = [];
-      const context = resolveThemeContext(internalDocument, {
+    }
+    return { context, expanded, warnings, renderer };
+  }
+  async function prepareQuality(document, options) {
+    const { context, expanded, warnings, renderer } = await expandPresentation(
+      document,
+      options
+    );
+    const prepared = preparePptxQualityDocument(
+      document,
+      {
+        context,
+        expanded,
         customThemes: state.customThemes,
         fonts: state.fonts,
-        warnings,
-        defaultThemeName: typeof state.theme === "string" ? state.theme : void 0,
-        resolveNamedTheme: (name, authored) => state.customThemes?.[name] ?? (authored && hasPptxTheme(name) ? getPptxTheme(name) : void 0) ?? (typeof state.theme === "object" && state.theme !== null ? state.theme : getPptxTheme(name))
-      });
-      const modedRoot = context.document;
-      const resolvedTheme = context.theme;
-      const validateEmitted = validationOptions.enabled === false ? void 0 : (emitted, componentLabel, parentName) => {
-        let validationDocument2;
-        if (parentName === "pptx") {
-          validationDocument2 = {
-            ...modedRoot,
-            ...renderer !== void 0 ? { renderer } : {},
-            children: emitted
-          };
-        } else if (parentName === "slide") {
-          validationDocument2 = {
-            ...modedRoot,
-            ...renderer !== void 0 ? { renderer } : {},
-            children: [{ name: "slide", props: {}, children: emitted }]
-          };
-        } else {
-          return;
-        }
-        const result = validatePresentation(
-          validationDocument2,
-          state.components,
-          { allowUnknownFields: validationOptions.allowUnknownFields }
+        services: state.services,
+        ...renderer !== void 0 && { renderer },
+        warnings
+      }
+    );
+    return { prepared, warnings };
+  }
+  async function generateFromPrepared(options) {
+    const { prepared } = options;
+    const { document: processedDocument, theme, processed } = prepared.model;
+    const warnings = [];
+    const renderer = options.renderer ?? state.renderer ?? prepared.renderer;
+    const hasHighcharts = containsHighcharts(processed);
+    const resolvedFonts = await resolveDocumentFonts(
+      processedDocument,
+      theme,
+      warnings,
+      state.fonts,
+      hasHighcharts
+    );
+    const chartFonts = hasHighcharts ? toChartFontFaces2(resolvedFonts) : [];
+    const buffer = await runWithBaseDir(
+      options.baseDir ?? state.baseDir,
+      () => renderProcessedViaIr(processed, warnings, {
+        renderer,
+        services: state.services,
+        deterministic: options.deterministic ?? state.packaging.deterministic,
+        generatedAt: options.generatedAt ?? state.packaging.generatedAt,
+        ...chartFonts.length > 0 ? { chartFonts } : {}
+      })
+    );
+    return { buffer, warnings };
+  }
+  async function generate(document, options) {
+    try {
+      if (options?.prepared)
+        return await generateFromPrepared(
+          options
         );
-        if (!result.valid) {
-          throw new ComponentValidationError3(
-            result.errors.map((error) => ({
-              ...error,
-              message: `custom component '${componentLabel}' emitted invalid output \u2014 ${error.message}`
-            })),
-            emitted
-          );
-        }
-      };
-      const expanded = await expandPptxBlocksWithPlugins(
-        modedRoot,
-        resolvedTheme,
-        new Set(componentMap.keys()),
-        pluginRenderer(warnings, resolvedTheme, validateEmitted)
-      );
+      const { context, expanded, warnings, renderer } = await expandPresentation(document, options);
+      const resolvedTheme = context.theme;
       const processedDocument = expanded.document;
-      if (validationOptions.enabled !== false) {
-        const result = validatePresentation(
-          {
-            ...processedDocument,
-            ...renderer !== void 0 ? { renderer } : {}
-          },
-          [],
-          {
-            allowUnknownFields: validationOptions.allowUnknownFields
-          }
-        );
-        if (!result.valid) {
-          throw new ComponentValidationError3(
-            result.errors.map((error) => ({
-              ...error,
-              message: `expanded plugin output failed validation \u2014 ${error.message}`
-            })),
-            processedDocument
-          );
-        }
-      }
       const processed = processPresentation(processedDocument, {
         theme: resolvedTheme,
         services: state.services,
@@ -9459,6 +10080,7 @@ function createBuilderImpl(state) {
     generate,
     generateBuffer: generate,
     generateFile,
+    prepareQuality,
     getComponentNames,
     validate,
     generateSchema,