@openpresentation/opf-pptx 0.11.8 → 0.12.0

package/dist/document-provenance.js

@@ -1,6 +1,7 @@
 import {XMLParser} from 'fast-xml-parser';
 import {decodeTextTag, encodeTextTag} from './code-provenance.js';
-import {contentTopology, rebuildContent, validateTopology} from './content-topology.js';
+import {contentTopology, rebuildContent, validateTopology, listLineBreaks, validateListBreaks} from './content-topology.js';
+import {runColorRecord, validateRunColors} from './run-colors.js';
 // Namespace import: cores before FF-34 do not export resolveSocialProfile.
 import * as opfCore from '@openpresentation/opf';
 
@@ -45,6 +46,7 @@ const REL_TAGS = 'http://schemas.openxmlformats.org/officeDocument/2006/relation
 const NS = 'http://schemas.openxmlformats.org/presentationml/2006/main';
 const TAGS_TYPE = 'application/vnd.openxmlformats-officedocument.presentationml.tags+xml';
 const MAX_OMITTED = 256;
+const MAX_AUTHOR_LENGTH = 4096;
 const MAX_FIELD_BYTES = 256 * 1024, MAX_CATALOG_BYTES = 1024 * 1024, MAX_TAG_CHARS = 16 * 1024 * 1024;
 
 const enc = new TextEncoder(), dec = new TextDecoder('utf-8', {fatal: true});
@@ -73,7 +75,26 @@ function authoredSocials(stored, observed, records) {
 // native PowerPoint counterpart and round-trips from the stored value.
 export const DESIGN_REFERENCES = Object.freeze(['theme', 'colorScheme', 'fontScheme', 'dimensions', 'background']);
 export const COMPOSITION_HINTS = Object.freeze(['titleAlignment', 'contentAlignment', 'contentBox', 'contentDirection', 'chartPrimary', 'imageFill', 'listBullet']);
-export const METADATA = Object.freeze(['narrative', 'tone', 'audience', 'purpose', 'language', 'organization', 'speaker', 'takeaway', 'duration', 'tags', 'variables', 'filename', 'extensions']);
+// `references` (RR-34): the deck's cited sources. Like `author`, stored as a top-level key of OPF_DOCUMENT_V1 (importers up to
+// 0.11.9 drop a tag with an unknown `supplement` field but ignore an unknown top-level key) and read back into metadata.
+export const METADATA = Object.freeze(['narrative', 'tone', 'audience', 'purpose', 'language', 'organization', 'speaker', 'takeaway', 'duration', 'tags', 'variables', 'filename', 'extensions', 'author', 'references']);
+
+// `author` is native (docProps/core.xml dc:creator), where several authors share one field joined by "; " (the join the
+// schema documents). Import splits a creator on exactly that separator, and only when every part is a non-empty name
+// with no outer whitespace (so the split joins back to the identical text); a single name is never cut. The authored form (an array, or a string that itself holds a "; ") returns from the stored record
+// while the creator still equals it; plain PPTX has no record and gets the split. The record is the top-level `author`
+// of OPF_DOCUMENT_V1: importers up to 0.11.8 reject an unknown key inside `supplement` (dropping the whole tag) but ignore
+// an unknown top-level key.
+export const joinAuthors = author => Array.isArray(author) ? author.join('; ') : author;
+export function splitAuthors(creator) {
+  if (typeof creator !== 'string') return creator;
+  const parts = creator.split('; ');
+  return parts.length > 1 && parts.every(part => part && part === part.trim()) ? parts : creator;
+}
+// The creator the package gets when the document names no author. An imported default is not an authored value.
+export const DEFAULT_AUTHOR = 'OpenPresentation';
+// Stored only when the native creator cannot carry the authored form by itself (or would read as the default).
+const authorNeedsRecord = author => Array.isArray(author) || (typeof author === 'string' && (author === DEFAULT_AUTHOR || Array.isArray(splitAuthors(author))));
 // Brand images have no native gate: they return from the stored value once
 // their media and asset references resolve. The P2 logo picture (`OPF_LOGO_V1`)
 // consumes the drawn logo; `design.logo` itself always returns from here.
@@ -399,6 +420,7 @@ export function documentProvenance(presentation, {mode = 'full', isCatalogId = (
   for (const key of METADATA) {
     if (!own(presentation, key)) continue;
     const value = presentation[key];
+    if (key === 'author' && (referencesOnly || !authorNeedsRecord(value))) continue;
     if (referencesOnly) {
       const kind = METADATA_CATALOGS[key];
       const ids = typeof value === 'string' ? [value] : key === 'audience' && Array.isArray(value) && value.every(item => typeof item === 'string') ? value : null;
@@ -447,7 +469,16 @@ export function recordContentTopology(provenance, slide, index, items) {
   if (!provenance || provenance.mode !== 'full' || !provenance.slides[index]) return;
   // An unstorable structure is reported with the other omissions (storable) and recorded in the tag.
   const topology = contentTopology(slide, items, index, reason => { provenance.slides[index].omittedContent = reason; });
-  if (topology) provenance.slides[index].content = topology;
+  if (!topology) return;
+  provenance.slides[index].content = topology;
+  // Variable, scheme-slot and role names of text runs (the native colour holds only what they resolve to).
+  const colors = runColorRecord(slide);
+  if (colors) provenance.slides[index].colors = colors;
+  // Whitespace of the hard line breaks inside list items (their native lines carry no tag).
+  const omittedLists = [];
+  const lists = listLineBreaks(items, (path, reason) => omittedLists.push([path, reason]));
+  if (lists) provenance.slides[index].lists = lists;
+  if (omittedLists.length) provenance.slides[index].omittedLists = omittedLists;
 }
 
 function base64ToBytes(value) {
@@ -578,6 +609,11 @@ function storable(entries, provenance) {
     const fields = {};
     for (const [key, value] of Object.entries(source[section] ?? {})) {
       const path = section === 'design' ? `design.${key}` : key;
+      if (section === 'metadata' && (key === 'author' || key === 'references')) {
+        const prepared = prepare(path, value);
+        if (prepared !== undefined) document[key] = prepared;
+        continue;
+      }
       // A design reference is only restorable together with its asset.
       if (section === 'design' && unstoredAsset(value)) { omit(path, 'the asset it references could not be stored'); continue; }
       const prepared = prepare(path, value);
@@ -593,7 +629,8 @@ function storable(entries, provenance) {
   const slides = provenance.slides.map((record, index) => {
     const result = {v: 1, slide: index};
     if (record.omittedContent) omit(`slides.${index}.content`, record.omittedContent);
-    for (const key of ['id', 'beat', ...SLIDE_STRUCTURE, ...SLIDE_METADATA, 'content']) {
+    for (const [path, reason] of record.omittedLists ?? []) omit(path, reason);
+    for (const key of ['id', 'beat', ...SLIDE_STRUCTURE, ...SLIDE_METADATA, 'content', 'colors', 'lists']) {
       if (record[key] === undefined) continue;
       const value = prepare(`slides.${index}.${key}`, record[key]);
       if (value !== undefined) result[key] = value;
@@ -630,7 +667,7 @@ function storable(entries, provenance) {
   }
   for (const [index, record] of slides.entries()) {
     while (tagChars(record) > budget) {
-      const candidates = [...['id', 'beat', ...SLIDE_STRUCTURE, ...SLIDE_METADATA, 'content', 'layoutRecord'].filter(key => record[key] !== undefined).map(key => ({key, size: sizeOf(record[key])})),
+      const candidates = [...['id', 'beat', ...SLIDE_STRUCTURE, ...SLIDE_METADATA, 'content', 'colors', 'lists', 'layoutRecord'].filter(key => record[key] !== undefined).map(key => ({key, size: sizeOf(record[key])})),
         ...Object.keys(record.design ?? {}).map(key => ({key, design: true, size: sizeOf(record.design[key])}))];
       if (!candidates.length) break;
       const largest = candidates.sort((a, b) => b.size - a.size)[0];
@@ -738,7 +775,15 @@ function validateDocument(stored) {
   for (const key of Object.keys(value.metadata ?? {})) if (!METADATA.includes(key)) throw Error(`Unknown metadata field ${key}.`);
   if (value.metadata?.filename !== undefined && typeof value.metadata.filename !== 'string') throw Error('Invalid filename record.');
   if (value.metadata?.extensions !== undefined && !object(value.metadata.extensions)) throw Error('Invalid extensions record.');
+  const author = stored.author;
+  if (author !== undefined && !((typeof author === 'string' && author.length <= MAX_AUTHOR_LENGTH * 256) || (Array.isArray(author) && author.length > 0 && author.length <= 256 && author.every(name => typeof name === 'string' && name.length <= MAX_AUTHOR_LENGTH)))) throw Error('Invalid author record.');
+  const references = stored.references;
+  if (references !== undefined && (!Array.isArray(references) || references.length > 4096 || !references.every(object))) throw Error('Invalid references record.');
   validateOmitted(value.omitted);
+  if (author !== undefined || references !== undefined) {
+    const {author: _author, references: _references, ...rest} = value;
+    return {...rest, metadata: {...rest.metadata, ...(author !== undefined ? {author} : {}), ...(references !== undefined ? {references} : {})}};
+  }
   return value;
 }
 
@@ -753,6 +798,8 @@ function validateSlide(stored) {
   if (value.section !== undefined && typeof value.section !== 'string') throw Error('Invalid slide section record.');
   if (value.extensions !== undefined && !object(value.extensions)) throw Error('Invalid slide extensions record.');
   if (value.content !== undefined) validateTopology(value.content);
+  if (value.colors !== undefined) validateRunColors(value.colors);
+  if (value.lists !== undefined) validateListBreaks(value.lists);
   validateOmitted(value.omitted);
   return value;
 }
@@ -792,6 +839,23 @@ function pruneDangling(value, dangling, path, removed) {
   return Object.fromEntries(Object.entries(value).flatMap(([key, item]) => isDangling(item) ? (removed.push(`${path}.${key}`), []) : [[key, pruneDangling(item, dangling, `${path}.${key}`, removed)]]));
 }
 
+/**
+ * The hard line breaks stored for the lists of one slide: Map(list path -> Map(line number -> gap)), or null when the slide
+ * carries none, its record is unreadable, or its arrangement changed since export (the lines are then no longer the exported
+ * ones). Read before the slide's shapes are merged into list blocks; any damage is reported later by restoreDocumentProvenance.
+ */
+export function slideListBreaks(entries, path, root, rels) {
+  try {
+    const found = readTag(entries, root?.['p:cSld']?.['p:custDataLst'], rels, SLIDE_TAG);
+    if (found.missing) return null;
+    const record = validateSlide(found.value);
+    if (record.lists === undefined || record.native.structure !== nativeSlide(entries, path).structure) return null;
+    return new Map(record.lists.map(([list, lines]) => [list, new Map(lines)]));
+  } catch {
+    return null;
+  }
+}
+
 /**
  * Read OPF_DOCUMENT_V1 / OPF_SLIDE_V1 and decide what still matches the
  * package. Nothing is modified here: the result lists restore groups (one per
@@ -831,7 +895,7 @@ export function restoreDocumentProvenance(imported, {entries, presentationRoot,
     }
   });
   const groups = [];
-  const group = (field, ops) => groups.push({field, ops});
+  const group = (field, ops, contentPaths) => groups.push({field, ops, ...(contentPaths ? {contentPaths} : {})});
   const set = (path, value) => ({path, value});
   const remove = path => ({path, remove: true});
   const intent = layoutIntent(document ? layoutRecords(document.catalogs) : [], Boolean(document), slideRecords, entries, group, report, rejectedLayoutIds);
@@ -852,7 +916,8 @@ export function restoreDocumentProvenance(imported, {entries, presentationRoot,
       if (record.type !== undefined) report({code: 'slide-reference-changed', path: `slides.${index}.type`, message: `The slide's objects were moved, resized, added or removed since export, so slides.${index}.type ${JSON.stringify(record.type)} was not restored; the imported slide keeps its observed arrangement.`});
       return false;
     }
-    const result = rebuildContent(record.content, imported.slides[index]?.blocks ?? [], slides[index]?.contentBounds ?? []);
+    let placedPaths;
+    const result = rebuildContent(record.content, imported.slides[index]?.blocks ?? [], slides[index]?.contentBounds ?? [], paths => { placedPaths = paths; });
     if (result.reason) {
       report({code: 'content-structure-changed', path: `slides.${index}`, message: `The slide's content no longer matches its stored structure (${result.reason}), so the authored groups, regions and block ids of slides.${index} were not restored; the imported slide keeps its flat blocks.${typeNote}`});
       return false;
@@ -873,7 +938,7 @@ export function restoreDocumentProvenance(imported, {entries, presentationRoot,
       ops.push(set(['slides', index, key], value));
     }
     if (record.type !== undefined) ops.push(set(['slides', index, 'type'], clone(record.type)));
-    group(`slides.${index}.content`, ops);
+    group(`slides.${index}.content`, ops, {slide: index, paths: placedPaths});
     return true;
   };
 
@@ -1036,12 +1101,20 @@ export function restoreDocumentProvenance(imported, {entries, presentationRoot,
   // content (the furniture organization name, linked socials) win over their
   // stored values; stored-only fields (logo, role ...) return.
   const metadata = document.metadata ?? {};
+  // The exporter writes the default creator when no author was authored: with the document record present, that default is not the author.
+  if (metadata.author === undefined && imported.author === DEFAULT_AUTHOR) group('author', [remove(['author'])]);
   for (const key of METADATA) {
     if (metadata[key] === undefined) continue;
     if (key === 'organization' && organizationConflict) {
       report({code: 'metadata-reference-changed', path: 'organization', message: 'Slides now show different organization names in their furniture, so the stored organization was not restored; each slide keeps its visible text.'});
       continue;
     }
+    if (key === 'author') {
+      // Native evidence: the stored authored form only stands for the creator it was joined into.
+      if (joinAuthors(imported.author) === joinAuthors(metadata.author)) group('author', [set(['author'], clone(metadata.author))]);
+      else report({code: 'metadata-reference-changed', path: 'author', message: 'The PowerPoint author field no longer matches the stored author, so the stored author was not restored; the current field is kept.'});
+      continue;
+    }
     let value = restorable(key, metadata[key], {prune: true});
     if (value === undefined) continue;
     if (key === 'organization' && object(imported.organization)) {
@@ -1199,10 +1272,10 @@ export function applyDocumentProvenance(imported, {groups, finalize}, validate,
     return tidy(doc);
   };
   const all = finalize(build(groups));
-  if (validate(all).valid) return all;
+  if (validate(all).valid) { for (const item of groups) item.applied = true; return all; }
   const accepted = [];
   for (const item of groups) {
-    if (validate(build([...accepted, item])).valid) accepted.push(item);
+    if (validate(build([...accepted, item])).valid) { accepted.push(item); item.applied = true; }
     else report({code: 'invalid-document-provenance', path: item.field, message: `The stored ${item.field} does not form a valid document with the imported content, so it was not restored; the imported document keeps the values observed in the PPTX.`});
   }
   const result = finalize(build(accepted));

package/dist/furniture-provenance.js

@@ -4,6 +4,7 @@ import {sourceLineParagraphs} from './text-provenance.js';
 import {DEFAULT_DATE_FORMAT, NATIVE_DATE_FIELDS, formatSlideNumber, parseDate} from './furniture-fields.js';
 import {schemas} from '@openpresentation/opf';
 import {LOGO_TAG} from './logo-provenance.js';
+import {NATIVE_PLACEHOLDERS, footerValue, isNativePlaceholderType, readNativePlaceholders} from './native-furniture.js';
 
 const TAG = 'OPF_FURNITURE_V1';
 // A slide has one tag list; it also carries the document's OPF_SLIDE_V1 record.
@@ -26,7 +27,9 @@ const socialLines = part => part.links.map(link => ({platform: link.platform,
   scheme: link.href && !/^[a-z][a-z0-9+.-]*:/i.test(link.text) ? 'https://' : ''}));
 const object = value => value !== null && typeof value === 'object' && !Array.isArray(value);
 const key = part => `${part.kind}.${part.zone}.${part.field}`;
-const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+// Key order is not meaning: a value merged from native placeholders equals the same value read from a manifest.
+const canonical = value => JSON.stringify(value, (key, item) => object(item) ? Object.fromEntries(Object.entries(item).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) : item);
+const same = (a, b) => canonical(a) === canonical(b);
 const check = (condition, message) => { if (!condition) throw Error(message); };
 
 // Change detection, not authentication: editable tags store no cached date words.
@@ -73,7 +76,7 @@ function unchangedStaticDate(marker, format, ordered, paragraphs) {
 // settings only. Current native shapes supply all words, image bytes and alt
 // text, even after edits; a recorded format is kept only while the current text
 // still matches it exactly.
-export function furnitureManifest(presentation, slide, layout, slideIndex, staticDates = new Map()) {
+export function furnitureManifest(presentation, slide, layout, slideIndex, staticDates = new Map(), natives = new Map()) {
   const definitions = {}, formats = {};
   for (const kind of kinds) {
     const local = slide.design?.[kind] !== undefined;
@@ -109,7 +112,9 @@ export function furnitureManifest(presentation, slide, layout, slideIndex, stati
     parts: layout.parts.flatMap((part, index) => part.field === 'logo' ? [] : [{kind: part.kind, zone: part.zone, field: part.field,
       type: part.type, count: part.type === 'image' ? 1 : part.fit.lines.length,
       ...(part.field === 'socials' ? {socials: socialLines(part)} : {}),
-      ...(staticDates.has(index) ? {staticDate: staticDates.get(index)} : {})}]),
+      ...(staticDates.has(index) ? {staticDate: staticDates.get(index)} : {}),
+      // RR-11: this part is a native PowerPoint placeholder (dt, ftr or sldNum); deleting it in PowerPoint's dialog is then intent.
+      ...(natives.has(index) ? {ph: natives.get(index)} : {})}]),
     ...(logos.length ? {logos} : {})};
 }
 
@@ -197,6 +202,9 @@ function validateManifest(manifest) {
   for (const part of manifest.parts) {
     check(object(part) && expected.get(key(part)) === part.type, 'Ambiguous furniture part.');
     check(Number.isSafeInteger(part.count) && part.count >= 1 && part.count <= 10000 && (part.type !== 'image' || part.count === 1), 'Invalid furniture line count.');
+    // RR-11: a footer part that is a native PowerPoint placeholder (dt, ftr, sldNum), unique per slide.
+    if (part.ph !== undefined) check(isNativePlaceholderType(part.ph) && part.kind === 'footer' && part.type === 'text' && part.count === 1 &&
+      NATIVE_PLACEHOLDERS[part.ph].field === part.field && manifest.parts.filter(other => other.ph === part.ph).length === 1, 'Invalid native placeholder part.');
     if (part.field === 'socials') check(Array.isArray(part.socials) && part.socials.length >= 1 && part.socials.length <= 100
       && part.socials.every(line => object(line) && platformId.test(line.platform) && schemes.includes(line.scheme))
       && new Set(part.socials.map(line => line.platform)).size === part.socials.length, 'Invalid social profile lines.');
@@ -257,6 +265,7 @@ function readSlide(context, entries, slideIndex, slideCount, report, taggedText)
     if (!definition) continue;
     try {
       const value = definition.value === false ? false : {};
+      let removedNative = false;
       if (value !== false) for (const zone of zones) if (definition.value[zone] !== undefined) {
         value[zone] = Object.fromEntries(Object.entries(definition.value[zone]).filter(([, flag]) => flag === false));
       }
@@ -271,6 +280,8 @@ function readSlide(context, entries, slideIndex, slideCount, report, taggedText)
       for (const [partIndex, part] of manifest.parts.entries()) {
         if (part.kind !== kind) continue;
         const group = records.filter(record => record.data.part === partIndex);
+        // A native placeholder PowerPoint's Header & Footer dialog removed is a deliberate removal, not damage.
+        if (part.ph !== undefined && group.length === 0) { removedNative = true; continue; }
         check(group.length === part.count, 'Incomplete or duplicated furniture part.');
         if (part.type === 'image') {
           const current = readPicture(pictures[group[0].index]);
@@ -304,6 +315,15 @@ function readSlide(context, entries, slideIndex, slideCount, report, taggedText)
         }
       }
       check(new Set(candidate.text).size === candidate.text.length && new Set(candidate.pictures).size === candidate.pictures.length, 'Repeated furniture shape identity.');
+      if (removedNative) {
+        // The slide no longer follows the deck's definition: it is its own override, and the other slides can still agree.
+        candidate.scope = 'local';
+        candidate.derived = true;
+        if (value !== false) {
+          for (const zone of Object.keys(value)) if (!Object.keys(value[zone]).length) delete value[zone];
+          if (!Object.keys(value).length) candidate.value = false;
+        }
+      }
       candidates[kind] = candidate;
     } catch (error) { report(slideIndex, `${kind}: ${error.message}`); }
   }
@@ -363,6 +383,28 @@ export function importFurniture(contexts, entries, onDiagnostic) {
       delete slide[kind]; report(index, `${kind}: ${owner ? 'Current social profile metadata disagrees across repeated fields.' : 'Social profiles need a repeated organization name to rebuild organization metadata.'}`);
     }
   }
+  // RR-11: PowerPoint's own date, footer and slide-number placeholders that no OPF tag claims (a deck authored in
+  // PowerPoint, a placeholder the Header & Footer dialog added, a tag-stripped export) are footer furniture.
+  contexts.forEach((context, index) => {
+    const slide = candidates[index];
+    const claimed = new Set([...taggedText[index], ...Object.values(slide).flatMap(candidate => candidate.text)]);
+    const fields = readNativePlaceholders(context, claimed, context.relationshipsOf, context.readPart);
+    if (!fields.length) return;
+    const existing = slide.footer, accepted = [];
+    for (const item of fields) {
+      const current = existing && existing.value !== false ? existing.value[item.zone]?.[item.field] : undefined;
+      if (current !== undefined && current !== false) report(index, `footer.${item.zone}.${item.field}: A native PowerPoint placeholder duplicates a furniture part already read; it stays ordinary current text.`);
+      else accepted.push(item);
+    }
+    if (!accepted.length) return;
+    const merged = footerValue(accepted), indexes = accepted.map(item => item.index);
+    if (!existing) slide.footer = {scope: 'native', value: merged, text: indexes, pictures: [], organizations: [], socials: [], sections: []};
+    else {
+      if (existing.value === false) existing.value = {};
+      for (const zone of Object.keys(merged)) existing.value[zone] = {...existing.value[zone], ...merged[zone]};
+      existing.text.push(...indexes);
+    }
+  });
   const result = {design: {}, slides: candidates.map((slide, index) => {
     const values = Object.values(slide), sections = values.flatMap(candidate => candidate.sections);
     return {design: Object.fromEntries(Object.entries(slide).map(([kind, candidate]) => [kind, candidate.value])),
@@ -380,6 +422,28 @@ export function importFurniture(contexts, entries, onDiagnostic) {
     if (inherited.length && candidates.every(slide => slide[kind]) && inherited.every(candidate => same(candidate.value, inherited[0].value))) {
       result.design[kind] = inherited[0].value;
       candidates.forEach((slide, index) => { if (slide[kind].scope === 'global') delete result.slides[index].design[kind]; });
+    } else if (!inherited.length && candidates.every(slide => slide[kind]?.derived && same(slide[kind].value, candidates[0][kind].value))) {
+      // Every slide's inherited definition lost the same native placeholder (the dialog's Apply to All): the deck's footer changed.
+      result.design[kind] = candidates[0][kind].value;
+      candidates.forEach((slide, index) => delete result.slides[index].design[kind]);
+    }
+  }
+  // A deck with no OPF footer provenance (PowerPoint's Header & Footer dialog, another tool): the footer most slides share is the
+  // deck's footer, a slide without one hides it, and any other slide keeps its own. One slide alone stays that slide's footer.
+  const nativeFooters = candidates.map(slide => slide.footer);
+  if (nativeFooters.some(Boolean) && nativeFooters.every(candidate => !candidate || candidate.scope === 'native')) {
+    const counts = new Map();
+    for (const candidate of nativeFooters) if (candidate && candidate.value !== false) {
+      const found = counts.get(canonical(candidate.value)) ?? {value: candidate.value, count: 0};
+      counts.set(canonical(candidate.value), {...found, count: found.count + 1});
+    }
+    const best = [...counts.entries()].sort((a, b) => b[1].count - a[1].count)[0];
+    if (best && (best[1].count >= 2 || contexts.length === 1)) {
+      result.design.footer = best[1].value;
+      nativeFooters.forEach((candidate, index) => {
+        if (!candidate) result.slides[index].design.footer = false;
+        else if (canonical(candidate.value) === best[0]) delete result.slides[index].design.footer;
+      });
     }
   }
   candidates.forEach((slide, index) => { if (Object.keys(slide).length) onDiagnostic?.({code: 'furniture-import-reflow', path: `slides.${index}.design`, message: 'Complete furniture roles retain current text, source line boundaries, image content and unambiguous metadata. Native formatting, positioning, crop and other presentation metadata are not reconstructed; review the reflowed furniture.'}); });

package/dist/image-fallback-browser.js

@@ -31,3 +31,15 @@ export async function webpToPng(bytes) {
     if (objectUrl) URL.revokeObjectURL(objectUrl);
   }
 }
+
+// A browser has no deterministic SVG rasterizer here: pass options.svgRasterizer (for example one that draws the SVG
+// on a canvas) to export SVG pictures. Without it the SVG picture exports as the "Image unavailable" placeholder.
+export async function svgToPng() {
+  const unavailable = new Error('Browsers need options.svgRasterizer to export SVG pictures.');
+  unavailable.code = 'svg-rasterizer-unavailable';
+  throw unavailable;
+}
+
+export async function readLocalFile() {
+  throw new Error('A browser cannot read a local file: pass the SVG as a data URI or through imageResolver.');
+}

package/dist/image-fallback-node.js

@@ -6,3 +6,25 @@ export async function webpToPng(bytes) {
     .autoOrient().toColourspace('srgb').ensureAlpha()
     .png({compressionLevel: 9, adaptiveFiltering: false}).toBuffer());
 }
+
+// The default rasterizer for the PNG fallback of an SVG picture: opf-render's resvg renderer (an optional peer), which
+// is deterministic (no system fonts, no network or file access for the SVG's own references). `text` selects the
+// bundled fonts; an SVG with no text needs none. Rejects with code `svg-rasterizer-unavailable` when opf-render is
+// not installed.
+export async function svgToPng(svg, {scale, text}) {
+  let render;
+  try {
+    ({svgToPng: render} = await import('@openpresentation/opf-render'));
+  } catch (error) {
+    const unavailable = new Error('SVG pictures need the optional peer @openpresentation/opf-render (or an options.svgRasterizer).', {cause: error});
+    unavailable.code = 'svg-rasterizer-unavailable';
+    throw unavailable;
+  }
+  return new Uint8Array(await render(svg, {scale, background: 'rgba(0, 0, 0, 0)', useBundledFonts: text === true, loadSystemFonts: false}));
+}
+
+// A local SVG file (a path source), read as bytes; PptxGenJS reads raster paths itself.
+export async function readLocalFile(path) {
+  const { readFile } = await import('node:fs/promises');
+  return new Uint8Array(await readFile(path));
+}