@openpresentation/opf-pptx 0.11.5 → 0.11.7

package/dist/logo-provenance.js

@@ -0,0 +1,173 @@
+import {XMLParser} from 'fast-xml-parser';
+import {decodeTextTag, encodeTextTag} from './code-provenance.js';
+import {pictureTransform} from './image-geometry.js';
+
+// The deck logo (core's `geometry.logo`: design.logo, a slide's own logo or the
+// primary organization's logo on a cover or section slide) exports as one native
+// picture per slide named `OPF logo`, after the watermark and before content. It
+// is fitted into core's box without cropping, anchored left and vertically
+// centered (the preview's `xMinYMid meet`). The native tag records the exact
+// picture, so an unchanged picture is consumed on import (the logo itself returns
+// from the document and slide design records) while an edited one stays an
+// ordinary picture and reports `invalid-logo-provenance`.
+const TAG = 'OPF_LOGO_V1', REL = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/tags';
+const EMUS_PER_INCH = 914400;
+const parser = new XMLParser({ignoreAttributes:false, attributeNamePrefix:'', parseTagValue:false, trimValues:false});
+const decoder = new TextDecoder('utf-8', {fatal:true}), encoder = new TextEncoder();
+const array = value => value === undefined ? [] : Array.isArray(value) ? value : [value];
+// Whitespace-only text between elements is not identity: the vendored writer indents, PowerPoint drops it on save.
+const canonical = value => JSON.stringify(value, (_key, item) => item && typeof item === 'object' && !Array.isArray(item)
+  ? Object.fromEntries(Object.keys(item).sort().filter(key => !(key === '#text' && typeof item[key] === 'string' && !item[key].trim())).map(key => [key, item[key]])) : item);
+// The OPF paths core reports for a logo source.
+const LOGO_PATH = /^(?:slides\.\d{1,9}\.design\.logo|design\.logo|organization(?:\.\d{1,9})?\.logo)(?:\.[A-Za-z]{1,16})?$/;
+
+export const LOGO_TAG = TAG;
+export const logoName = () => 'OPF logo';
+
+function blipFillIdentity(blipFill) {
+  const {['a:blip']: blip, ...rest} = blipFill ?? {};
+  const {['r:embed']: _embed, ...blipRest} = blip ?? {};
+  return {...rest, 'a:blip': blipRest};
+}
+
+/**
+ * The picture frame inside core's logo box: contained, anchored at the box's
+ * left edge and vertically centered. A 90 degree EXIF orientation swaps the
+ * frame's axes, so its visual width is the stored height.
+ */
+export function logoFrame(metadata, box) {
+  const placed = pictureTransform(metadata, box, 'fit');
+  const visualWidth = (metadata.orientation ?? 1) >= 5 ? placed.h : placed.w;
+  return {...placed, x: placed.x - (box.w - visualWidth) / 2};
+}
+
+/**
+ * Place each generated logo picture at its frame and bind it to its manifest
+ * with a native tag. logos: Map<slidePart, {slide, box (inches), path, variant}>.
+ */
+export function placeLogos(entries, logos, metadataFor, fail) {
+  if (!logos.size) return;
+  const manifests = new Map();
+  for (const part of Object.keys(entries).filter(path => /^ppt\/slides\/slide\d+\.xml$/.test(path))) {
+    const logo = logos.get(part);
+    if (!logo) continue;
+    const xml = decoder.decode(entries[part]);
+    const emu = value => Math.round(value * EMUS_PER_INCH);
+    let found = 0;
+    const next = xml.replace(/<p:pic>[\s\S]*?<\/p:pic>/g, picture => {
+      if (picture.match(/<p:cNvPr\b[^>]*\bname="([^"]+)"/)?.[1] !== logoName()) return picture;
+      found++;
+      const embed = picture.match(/<a:blip\b[^>]*r:embed="([^"]+)"/)?.[1];
+      const metadata = metadataFor(part, embed);
+      if (!metadata) fail(logo.path);
+      const placed = logoFrame(metadata, logo.box);
+      const attributes = `${placed.rotation ? ` rot="${placed.rotation * 60000}"` : ''}${placed.flipH ? ' flipH="1"' : ''}${placed.flipV ? ' flipV="1"' : ''}`;
+      picture = picture.replace(/<a:xfrm\b[^>]*>[\s\S]*?<\/a:xfrm>/, `<a:xfrm${attributes}><a:off x="${emu(placed.x)}" y="${emu(placed.y)}"/><a:ext cx="${emu(placed.w)}" cy="${emu(placed.h)}"/></a:xfrm>`);
+      picture = picture.replace(/<a:srcRect\b[^>]*\/>/, '');
+      const node = parser.parse(picture)['p:pic'];
+      manifests.set(part, {v: 1, slide: logo.slide, path: logo.path, variant: logo.variant, properties: node['p:spPr'], blipFill: blipFillIdentity(node['p:blipFill'])});
+      return picture;
+    });
+    if (found !== 1) throw new Error('Missing generated logo picture.');
+    entries[part] = encoder.encode(next);
+  }
+  attachTags(entries, manifests);
+}
+
+// One tag part per slide, related from the picture's application properties.
+function attachTags(entries, manifests) {
+  const NS = 'http://schemas.openxmlformats.org/presentationml/2006/main', types = [];
+  let count = 0;
+  for (const [part, manifest] of manifests) {
+    const relPath = part.replace('/slides/', '/slides/_rels/') + '.rels';
+    const rels = decoder.decode(entries[relPath]);
+    const ids = new Set([...rels.matchAll(/\bId="([^"]+)"/g)].map(match => match[1]));
+    const tagPart = `ppt/tags/opfLogo${++count}.xml`;
+    let id = `rIdOpfLogo${count}`;
+    while (ids.has(id)) id += '_';
+    entries[tagPart] = encoder.encode(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?><p:tagLst xmlns:p="${NS}"><p:tag name="${TAG}" val="${encodeTextTag(manifest)}"/></p:tagLst>`);
+    types.push(`<Override PartName="/${tagPart}" ContentType="application/vnd.openxmlformats-officedocument.presentationml.tags+xml"/>`);
+    entries[relPath] = encoder.encode(rels.replace('</Relationships>', `<Relationship Id="${id}" Type="${REL}" Target="../tags/opfLogo${count}.xml"/></Relationships>`));
+    let attached = false;
+    const xml = decoder.decode(entries[part]).replace(/<p:pic>[\s\S]*?<\/p:pic>/g, picture => {
+      if (attached || picture.match(/<p:cNvPr\b[^>]*\bname="([^"]+)"/)?.[1] !== logoName()) return picture;
+      attached = true;
+      picture = picture.replace(/<p:nvPr\s*\/>/, '<p:nvPr></p:nvPr>');
+      if (!picture.includes('</p:nvPr>')) throw new Error('Generated logo picture has no native application properties.');
+      return picture.replace('</p:nvPr>', `<p:custDataLst><p:tags r:id="${id}"/></p:custDataLst></p:nvPr>`);
+    });
+    entries[part] = encoder.encode(xml);
+  }
+  entries['[Content_Types].xml'] = encoder.encode(decoder.decode(entries['[Content_Types].xml']).replace('</Types>', types.join('') + '</Types>'));
+}
+
+function readTags(container, relationships, entries) {
+  const tags = [];
+  let unreadable = false;
+  for (const link of array(container?.['p:tags'])) {
+    const rel = relationships.get(link['r:id']);
+    if (rel?.type !== REL || rel.targetMode === 'External' || !entries[rel.path]) { unreadable = true; continue; }
+    try { tags.push(...array(parser.parse(decoder.decode(entries[rel.path]))['p:tagLst']?.['p:tag'])); } catch { unreadable = true; }
+  }
+  return {tags, unreadable};
+}
+
+/**
+ * The panel an unresolved logo draws is a rectangle named "OPF image placeholder N" carrying a role "placeholder" logo
+ * tag for this slide, plus its text lines and icon strokes named after it. A valid tag consumes all of them: they are
+ * a status indicator, not content. Without a valid tag they stay ordinary shapes. Returns the consumed shape indexes.
+ */
+export function importLogoPlaceholders(shapes, relationships, entries, slideIndex) {
+  const consumed = new Set(), names = shapes.map(shape => shape['p:nvSpPr']?.['p:cNvPr']?.name);
+  for (const [index, shape] of shapes.entries()) {
+    const name = names[index];
+    if (typeof name !== 'string' || !/^OPF image placeholder \d+$/.test(name)) continue;
+    const {tags} = readTags(shape['p:nvSpPr']?.['p:nvPr']?.['p:custDataLst'], relationships, entries);
+    const own = tags.filter(tag => tag.name?.toUpperCase() === TAG);
+    try {
+      if (own.length !== 1) continue;
+      const manifest = decodeTextTag(own[0].val);
+      if (manifest?.v !== 1 || manifest.role !== 'placeholder' || manifest.slide !== `slides.${slideIndex}` || typeof manifest.path !== 'string' || !LOGO_PATH.test(manifest.path)) continue;
+    } catch { continue; }
+    consumed.add(index);
+    for (const [other, otherName] of names.entries()) if (typeof otherName === 'string' && otherName.startsWith(`${name} text line `) || otherName?.startsWith(`${name} icon `)) consumed.add(other);
+  }
+  return consumed;
+}
+
+/**
+ * Consume an unchanged tagged logo picture: it is generated from design.logo (or
+ * the organization's logo), never content. Returns the consumed picture indexes
+ * and `fallback`, the picture's own `{path, image}`: the caller uses it for the
+ * logo only when the stored document and slide design did not restore one (an
+ * export without provenance, or one that omitted the field), so the logo is never
+ * lost. An edited, ambiguous or damaged tagged picture stays an ordinary picture
+ * and is reported. readPicture(picture) returns the ordinary imported payload.
+ */
+export function importLogo(pictures, relationships, entries, slideIndex, readPicture, report) {
+  const consumed = new Set(), found = [];
+  for (const [index, picture] of pictures.entries()) {
+    const {tags, unreadable} = readTags(picture['p:nvPicPr']?.['p:nvPr']?.['p:custDataLst'], relationships, entries);
+    const own = tags.filter(tag => tag.name?.toUpperCase() === TAG);
+    // A header/footer logo picture carries the same tag with role "furniture"; furniture import owns it.
+    if (!own.length || own.every(tag => { try { return decodeTextTag(tag.val)?.role === 'furniture'; } catch { return false; } })) continue;
+    found.push({index, picture, own, unreadable, others: tags.some(tag => /^OPF_/i.test(tag.name) && tag.name.toUpperCase() !== TAG)});
+  }
+  if (!found.length) return {consumed};
+  const invalid = () => report({code: 'invalid-logo-provenance', message: 'An edited, ambiguous or invalid tagged OPF logo was imported as an ordinary picture. design.logo returns only from the stored document design.'});
+  if (found.length > 1) { invalid(); return {consumed}; }
+  const [{index, picture, own, unreadable, others}] = found;
+  try {
+    if (unreadable || others || own.length !== 1) throw Error('Ambiguous logo identity.');
+    const manifest = decodeTextTag(own[0].val);
+    if (manifest?.v !== 1 || manifest.slide !== `slides.${slideIndex}` || typeof manifest.path !== 'string' || !LOGO_PATH.test(manifest.path) || typeof manifest.variant !== 'string' || manifest.variant.length > 32) throw Error('Invalid logo manifest.');
+    if (picture['p:nvPicPr']?.['p:cNvPr']?.name !== logoName()) throw Error('Logo identity changed.');
+    if (canonical(picture['p:spPr']) !== canonical(manifest.properties) || canonical(blipFillIdentity(picture['p:blipFill'])) !== canonical(manifest.blipFill)) throw Error('Logo geometry changed.');
+    const image = readPicture(picture)?.payload?.image;
+    consumed.add(index);
+    return {consumed, ...(typeof image?.src === 'string' ? {fallback: {path: manifest.path, image: {src: image.src, ...(typeof image.alt === 'string' ? {alt: image.alt} : {})}}} : {})};
+  } catch {
+    invalid();
+    return {consumed};
+  }
+}

package/dist/sections.js

@@ -0,0 +1,111 @@
+// Native PowerPoint sections (spec-gap closure P1).
+//
+// A slide's `section` is PowerPoint's own section label. It is written as the
+// PowerPoint 2010 section list, `p14:sectionLst` inside `p:presentation/
+// p:extLst`, the structure PowerPoint shows in its sections pane and keeps
+// through saves. Each maximal run of consecutive slides with the same `section`
+// is one section; runs of slides without a section become `Default Section`,
+// PowerPoint's own name for the section it creates when a deck first gets one,
+// so every slide is covered (the list is only valid when it is complete).
+// Section ids are deterministic GUIDs derived from the run index and name.
+//
+// Import reads the list back: a slide in a section named exactly `Default
+// Section` has no `section`; any other name is the slide's `section`. The
+// native list wins over the stored OPF_SLIDE_V1 value and over the section
+// text a footer shows, since PowerPoint edits the list, not the hidden tags.
+
+import {hashText} from './document-provenance.js';
+
+export const DEFAULT_SECTION = 'Default Section';
+const SECTION_EXT_URI = '{521415D9-36F7-43E2-AB2F-B90AF26B5E84}';
+const P14 = 'http://schemas.microsoft.com/office/powerpoint/2010/main';
+
+const array = value => value === undefined ? [] : Array.isArray(value) ? value : [value];
+const object = value => value !== null && typeof value === 'object' && !Array.isArray(value);
+const escape = text => String(text).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+// Characters XML 1.0 cannot carry; the same guard the text runs use (invalid-text).
+export const INVALID_XML_CHARACTER = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF￾￿]/u;
+// An attribute value is normalized by every XML reader (tab, LF and CR become
+// spaces), so a re-saved list would differ from the authored label. Write the
+// normalized form, and compare labels the same way (`sameSectionName`).
+export const normalizeSectionName = value => String(value).replace(/[\t\n\r]/g, ' ');
+export const sameSectionName = (a, b) => normalizeSectionName(a) === normalizeSectionName(b);
+
+// A blank label names no section.
+const named = value => typeof value === 'string' && value.trim() !== '';
+
+/** Maximal runs of consecutive slides with the same section: [{name, slides: [index]}]. */
+export function sectionRuns(sections) {
+  const runs = [];
+  for (const [index, value] of sections.entries()) {
+    const name = named(value) ? value : DEFAULT_SECTION;
+    const last = runs.at(-1);
+    if (last && last.name === name) last.slides.push(index);
+    else runs.push({name, slides: [index]});
+  }
+  return runs;
+}
+
+// Change detection hashes (cyrb53) formatted as a version-4-shaped GUID: stable
+// for the same run index and name, which keeps the package deterministic.
+export function sectionId(index, name) {
+  const first = hashText(`${index}\u0000${name}`), second = hashText(`${name}\u0000${index}\u0000section`);
+  const hex = (first + second + hashText(first + second)).toUpperCase();
+  return `{${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(12, 15)}-8${hex.slice(15, 18)}-${hex.slice(18, 30)}}`;
+}
+
+/**
+ * Insert the section list into `presentationXml` for the per-slide `sections`
+ * (string or undefined, in slide order). Returns the XML unchanged when no
+ * slide has a section. The `p:sldId` ids are read from the presentation part,
+ * which must list exactly one id per slide.
+ */
+export function writeSectionList(presentationXml, sections) {
+  if (!sections.some(named)) return presentationXml;
+  const ids = [...presentationXml.matchAll(/<p:sldId\b[^>]*\bid="(\d+)"/g)].map(match => match[1]);
+  if (ids.length !== sections.length) throw Error('Generated slide id count differs from the document.');
+  if (/<p14:sectionLst\b/.test(presentationXml)) throw Error('Generated presentation already has a section list.');
+  for (const [index, name] of sections.entries()) {
+    const invalid = named(name) ? INVALID_XML_CHARACTER.exec(name) : null;
+    if (invalid) throw Error(`slides.${index}.section contains U+${invalid[0].codePointAt(0).toString(16).toUpperCase().padStart(4, '0')} at UTF-16 offset ${invalid.index}, which PresentationML XML cannot represent.`);
+  }
+  const list = sectionRuns(sections.map(name => named(name) ? normalizeSectionName(name) : name)).map((run, index) =>
+    `<p14:section name="${escape(run.name)}" id="${sectionId(index, run.name)}"><p14:sldIdLst>${run.slides.map(slide => `<p14:sldId id="${ids[slide]}"/>`).join('')}</p14:sldIdLst></p14:section>`).join('');
+  const ext = `<p:ext uri="${SECTION_EXT_URI}"><p14:sectionLst xmlns:p14="${P14}">${list}</p14:sectionLst></p:ext>`;
+  // CT_Presentation: extLst is the last child. Join an existing list, else add one.
+  if (presentationXml.includes('</p:extLst>')) return presentationXml.replace('</p:extLst>', `${ext}</p:extLst>`);
+  const close = presentationXml.lastIndexOf('</p:presentation>');
+  if (close < 0) throw Error('Generated presentation part has no closing element.');
+  return `${presentationXml.slice(0, close)}<p:extLst>${ext}</p:extLst>${presentationXml.slice(close)}`;
+}
+
+/**
+ * The native section list of a parsed `p:presentation` root: a Map from
+ * `p:sldId` id to section name, or null when the package has no section list.
+ * Names are untrusted strings; a malformed list counts as none.
+ */
+export function readSectionList(presentationRoot) {
+  const ext = array(presentationRoot?.['p:extLst']?.['p:ext']).find(item => object(item) && item['p14:sectionLst'] !== undefined);
+  if (!ext) return null;
+  const list = ext['p14:sectionLst'];
+  if (!object(list)) return null;
+  const map = new Map();
+  for (const section of array(list['p14:section'])) {
+    if (!object(section) || typeof section.name !== 'string') continue;
+    for (const slide of array(section['p14:sldIdLst']?.['p14:sldId'])) {
+      const id = object(slide) ? slide.id : undefined;
+      if (typeof id === 'string' && /^\d+$/.test(id) && !map.has(id)) map.set(id, section.name);
+    }
+  }
+  return map;
+}
+
+/** Per-slide section names from the native list, aligned with `slideIds` (the `p:sldId` ids in slide order); null without a list. */
+export function nativeSections(presentationRoot, slideIds) {
+  const map = readSectionList(presentationRoot);
+  if (!map) return null;
+  return slideIds.map(id => {
+    const name = map.get(String(id));
+    return name === undefined || name === DEFAULT_SECTION ? undefined : name;
+  });
+}

package/dist/watermark-provenance.js

@@ -13,8 +13,9 @@ export const WATERMARK_DEFAULT_OPACITY = 0.08;
 const parser = new XMLParser({ignoreAttributes:false, attributeNamePrefix:'', parseTagValue:false, trimValues:false});
 const decoder = new TextDecoder('utf-8', {fatal:true}), encoder = new TextEncoder();
 const array = value => value === undefined ? [] : Array.isArray(value) ? value : [value];
+// Whitespace-only text between elements is not identity: the vendored writer indents, PowerPoint drops it on save.
 const canonical = value => JSON.stringify(value, (_key, item) => item && typeof item === 'object' && !Array.isArray(item)
-  ? Object.fromEntries(Object.keys(item).sort().map(key => [key, item[key]])) : item);
+  ? Object.fromEntries(Object.keys(item).sort().filter(key => !(key === '#text' && typeof item[key] === 'string' && !item[key].trim())).map(key => [key, item[key]])) : item);
 
 export const watermarkName = () => 'OPF watermark';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf-pptx",
-  "version": "0.11.5",
+  "version": "0.11.7",
   "description": "Pure local OPF to PPTX export and PPTX to OPF import tooling.",
   "license": "MIT",
   "type": "module",
@@ -37,11 +37,12 @@
   "sideEffects": false,
   "scripts": {
     "build": "node scripts/build.mjs",
-    "typecheck": "node --check src/index.js && node --check src/chart-types.js && node --check src/chartex.js && node --check test/chartex.mjs && node --check test/chart-types.mjs && node --check test/design-alignment.mjs && node --check src/color-ref.js && node --check src/theme-colors.js && node --check test/theme-colors.mjs && node --check test/tag-colour.mjs && node --check test/table-theme-colors.mjs && node --check scripts/build.mjs && node --check scripts/validate-package.mjs && node --check test/smoke.mjs && node --check src/image-geometry.js && node --check src/slide-image-provenance.js && node --check test/slide-image.mjs && node --check test/slide-image-treatments.mjs && node --check src/watermark-provenance.js && node --check src/media-dedupe.js && node --check test/media-dedupe.mjs && node --check test/watermark.mjs && node --check test/image-fit.mjs && node --check test/image-orientation.mjs && node --check test/table-layout.mjs && node --check test/table-import.mjs && node --check test/object-ids.mjs && node --check test/export-corpus.mjs && node --check test/image-media-type.mjs && node --check src/image-fallback-node.js && node --check src/image-fallback-browser.js && node --check test/webp-fallback.mjs && node --check scripts/build-browser-check.mjs && node --check test/webp-fallback-browser.js && node --check test/image-fallback-boundary.mjs && node --check src/background.js && node --check test/background.mjs && node --check src/image-import.js && node --check test/image-import.mjs && node --check test/native-background.mjs && node --check src/background-import.js && node --check test/background-inheritance.mjs && node --check test/rich-table.mjs && node --check src/table-import.js && node --check test/rich-table-import.mjs && node --check test/rich-table-import-browser.js && node --check test/table-row-sizing.mjs && node --check test/table-styles.mjs && node --check test/table-styles-browser.js && node --check test/styled-table.mjs && node --check src/table-cell-import.js && node --check test/styled-table-import.mjs && node --check test/styled-table-import-browser.js && node --check src/table-border-import.js && node --check test/table-border-styles.mjs && node --check src/card-provenance.js && node --check test/content-cards.mjs && node --check src/chart-workbook.js && node --check test/chart-colors.mjs && node --check test/chart-workbook.mjs && node --check test/single-column-chart.mjs && node --check test/native-chart-colors.mjs && node --check src/heading-provenance.js && node --check test/accepted-text.mjs && node --check test/heading-provenance.mjs && node --check src/text-provenance.js && node --check test/plain-whitespace.mjs && node --check src/timeline-provenance.js && node --check src/quote-provenance.js && node --check test/quote-provenance.mjs && node --check test/shared-timeline.mjs && node --check test/shared-furniture.mjs && node --check src/furniture-provenance.js && node --check src/document-provenance.js && node --check test/document-provenance.mjs && node --check test/furniture-provenance.mjs && node --check src/furniture-fields.js && node --check test/furniture-fields.mjs && node --check test/furniture-wrapped-date.mjs && node --check test/native-picture.mjs && node --check test/compare-native-picture.mjs && node --check test/compare-native-picture-edit.mjs && node --check test/compare-native-picture-edit-controls.mjs && node --check test/native-font-embed-audit.mjs && node --check test/native-font-embed-controls.mjs && node --check test/native-font-embed-fixture-source.mjs && node --check test/native-font-edit-fixture.mjs && node --check test/native-mixed-edit-audit.mjs && node --check test/native-mixed-edit-controls.mjs && node --check test/master-bullet-font.mjs && node --check test/native-font-inventory-audit.mjs && node --check test/native-font-inventory-controls.mjs && node --check test/default-font-scheme.mjs && node --check test/export-chosen-fonts.mjs && node --check test/background-fills.mjs && node --check src/typeface-inventory.js && node --check src/package-fonts.js && node --check test/typeface-inventory.mjs && node --check src/script-fonts.js && node --check test/script-fonts.mjs && node --check test/theme-script-slots.mjs && node --check test/powershell-scan.mjs && node --check test/powershell-scan-probes.mjs && node --check test/socials-furniture.mjs && node --check src/media-provenance.js && node --check test/layout-parity.mjs && node --check test/cover-centering.mjs && node --check test/media-placeholder.mjs && node --check test/image-placeholder.mjs && node --check test/list-shape-names.mjs && node --check test/layout-intent.mjs && node --check test/chart-cache-import.mjs && node --check test/zip-date.mjs && node --check test/native-text-whitespace.mjs && node --check test/native-underline.mjs && node --check src/native-text-style.js && node --check src/font-weights.js && node --check test/font-weight-import.mjs && node --check src/body-text-import.js && node --check test/native-body-rich-text.mjs && node --check test/native-body-rich-text-browser.js && node --check test/native-quote-import-contract.mjs && node --check test/native-quote-import-controls.mjs && node --check test/native-quote.mjs && node --check test/determinism.mjs && node --check test/determinism-fixtures.mjs && node --check test/table-frame-furniture-order.mjs && node --check test/shape-border-widths.mjs && node --check test/gallery-layout-alignment.mjs",
-    "test": "npm run build && node test/chart-types.mjs && node test/chartex.mjs && node test/zip-date.mjs && node test/background-fills.mjs && npm run test:furniture && node test/slide-image.mjs && node test/slide-image-treatments.mjs && node test/watermark.mjs && node test/media-dedupe.mjs && node test/document-provenance.mjs && node test/layout-intent.mjs && node test/master-bullet-font.mjs && node test/default-font-scheme.mjs && node test/script-fonts.mjs && node test/theme-script-slots.mjs && node test/export-chosen-fonts.mjs && node test/typeface-inventory.mjs && node test/color-ref-export.mjs && node test/theme-colors.mjs && node test/tag-colour.mjs && node test/table-theme-colors.mjs && node test/plain-whitespace.mjs && node test/native-text-whitespace.mjs && node test/native-body-rich-text.mjs && node test/native-underline.mjs && node test/font-weight-import.mjs && node test/design-alignment.mjs && node test/accepted-text.mjs && node test/heading-provenance.mjs && node test/native-quote-import-controls.mjs && node test/chart-colors.mjs && node test/content-cards.mjs && node test/chart-workbook.mjs && node test/single-column-chart.mjs && node --test test/chart-cache-import.mjs && node test/dependency-boundary.mjs && npm run build:browser-check && npm run test:styled-table && node test/content-layout.mjs && node test/layout-parity.mjs && node test/gallery-layout-alignment.mjs && node test/cover-centering.mjs && node test/table-frame-furniture-order.mjs && node test/media-placeholder.mjs && node test/shape-border-widths.mjs && node test/image-placeholder.mjs && node test/list-shape-names.mjs && node test/shared-quote.mjs && node test/quote-provenance.mjs && npm run test:timeline && npm run test:determinism",
+    "typecheck": "node --check src/index.js && node --check src/chart-types.js && node --check src/chartex.js && node --check test/chartex.mjs && node --check test/chart-text-size.mjs && node --check test/chart-types.mjs && node --check test/design-alignment.mjs && node --check src/color-ref.js && node --check src/theme-colors.js && node --check test/theme-colors.mjs && node --check test/tag-colour.mjs && node --check test/table-theme-colors.mjs && node --check scripts/build.mjs && node --check scripts/validate-package.mjs && node --check test/smoke.mjs && node --check src/image-geometry.js && node --check src/slide-image-provenance.js && node --check test/slide-image.mjs && node --check test/slide-image-treatments.mjs && node --check src/watermark-provenance.js && node --check src/logo-provenance.js && node --check test/design-fields.mjs && node --check src/media-dedupe.js && node --check test/media-dedupe.mjs && node --check test/watermark.mjs && node --check test/image-fit.mjs && node --check test/image-orientation.mjs && node --check test/table-layout.mjs && node --check test/table-import.mjs && node --check test/object-ids.mjs && node --check test/export-corpus.mjs && node --check test/image-media-type.mjs && node --check src/image-fallback-node.js && node --check src/image-fallback-browser.js && node --check test/webp-fallback.mjs && node --check scripts/build-browser-check.mjs && node --check test/webp-fallback-browser.js && node --check test/image-fallback-boundary.mjs && node --check src/background.js && node --check test/background.mjs && node --check src/image-import.js && node --check test/image-import.mjs && node --check test/native-background.mjs && node --check src/background-import.js && node --check test/background-inheritance.mjs && node --check test/rich-table.mjs && node --check src/table-import.js && node --check test/rich-table-import.mjs && node --check test/rich-table-import-browser.js && node --check test/table-row-sizing.mjs && node --check test/table-styles.mjs && node --check test/table-styles-browser.js && node --check test/styled-table.mjs && node --check src/table-cell-import.js && node --check test/styled-table-import.mjs && node --check test/styled-table-import-browser.js && node --check src/table-border-import.js && node --check test/table-border-styles.mjs && node --check src/card-provenance.js && node --check test/content-cards.mjs && node --check src/chart-workbook.js && node --check test/chart-colors.mjs && node --check test/chart-workbook.mjs && node --check test/single-column-chart.mjs && node --check test/native-chart-colors.mjs && node --check src/heading-provenance.js && node --check test/accepted-text.mjs && node --check test/heading-provenance.mjs && node --check src/text-provenance.js && node --check test/plain-whitespace.mjs && node --check src/timeline-provenance.js && node --check src/quote-provenance.js && node --check test/quote-provenance.mjs && node --check test/shared-timeline.mjs && node --check test/shared-furniture.mjs && node --check src/furniture-provenance.js && node --check src/document-provenance.js && node --check src/content-topology.js && node --check src/sections.js && node --check test/document-provenance.mjs && node --check test/content-topology.mjs && node --check test/sections.mjs && node --check test/provenance-interop.mjs && node --check test/furniture-provenance.mjs && node --check src/furniture-fields.js && node --check test/furniture-fields.mjs && node --check test/furniture-wrapped-date.mjs && node --check test/native-picture.mjs && node --check test/compare-native-picture.mjs && node --check test/compare-native-picture-edit.mjs && node --check test/compare-native-picture-edit-controls.mjs && node --check test/native-font-embed-audit.mjs && node --check test/native-font-embed-controls.mjs && node --check test/native-font-embed-fixture-source.mjs && node --check test/native-font-edit-fixture.mjs && node --check test/native-mixed-edit-audit.mjs && node --check test/native-mixed-edit-controls.mjs && node --check test/master-bullet-font.mjs && node --check test/native-font-inventory-audit.mjs && node --check test/native-font-inventory-controls.mjs && node --check test/default-font-scheme.mjs && node --check test/export-chosen-fonts.mjs && node --check test/background-fills.mjs && node --check src/typeface-inventory.js && node --check src/package-fonts.js && node --check test/typeface-inventory.mjs && node --check src/script-fonts.js && node --check test/script-fonts.mjs && node --check test/theme-script-slots.mjs && node --check test/powershell-scan.mjs && node --check test/powershell-scan-probes.mjs && node --check test/socials-furniture.mjs && node --check src/media-provenance.js && node --check test/layout-parity.mjs && node --check test/cover-centering.mjs && node --check test/media-placeholder.mjs && node --check test/image-placeholder.mjs && node --check test/svg-image-degrade.mjs && node --check test/background-colorref.mjs && node --check test/import-fabrications.mjs && node --check test/list-shape-names.mjs && node --check test/layout-intent.mjs && node --check test/chart-cache-import.mjs && node --check test/zip-date.mjs && node --check test/native-text-whitespace.mjs && node --check test/native-underline.mjs && node --check src/native-text-style.js && node --check src/font-weights.js && node --check test/font-weight-import.mjs && node --check src/body-text-import.js && node --check test/native-body-rich-text.mjs && node --check test/native-body-rich-text-browser.js && node --check test/native-quote-import-contract.mjs && node --check test/native-quote-import-controls.mjs && node --check test/native-quote.mjs && node --check test/determinism.mjs && node --check test/determinism-fixtures.mjs && node --check test/table-frame-furniture-order.mjs && node --check test/shape-border-widths.mjs && node --check test/gallery-layout-alignment.mjs",
+    "test": "npm run build && node test/chart-types.mjs && node test/chartex.mjs && node test/chart-text-size.mjs && node test/zip-date.mjs && node test/background-fills.mjs && npm run test:furniture && node test/slide-image.mjs && node test/slide-image-treatments.mjs && node test/watermark.mjs && node test/design-fields.mjs && node test/media-dedupe.mjs && node test/document-provenance.mjs && node test/content-topology.mjs && node test/sections.mjs && node test/layout-intent.mjs && node test/master-bullet-font.mjs && node test/default-font-scheme.mjs && node test/script-fonts.mjs && node test/theme-script-slots.mjs && node test/export-chosen-fonts.mjs && node test/typeface-inventory.mjs && node test/color-ref-export.mjs && node test/theme-colors.mjs && node test/tag-colour.mjs && node test/table-theme-colors.mjs && node test/plain-whitespace.mjs && node test/native-text-whitespace.mjs && node test/native-body-rich-text.mjs && node test/native-underline.mjs && node test/font-weight-import.mjs && node test/design-alignment.mjs && node test/accepted-text.mjs && node test/heading-provenance.mjs && node test/native-quote-import-controls.mjs && node test/chart-colors.mjs && node test/content-cards.mjs && node test/chart-workbook.mjs && node test/single-column-chart.mjs && node --test test/chart-cache-import.mjs && node test/dependency-boundary.mjs && npm run build:browser-check && npm run test:styled-table && node test/content-layout.mjs && node test/layout-parity.mjs && node test/gallery-layout-alignment.mjs && node test/cover-centering.mjs && node test/table-frame-furniture-order.mjs && node test/media-placeholder.mjs && node test/shape-border-widths.mjs && node test/image-placeholder.mjs && node test/svg-image-degrade.mjs && node test/background-colorref.mjs && node test/import-fabrications.mjs && node test/list-shape-names.mjs && node test/shared-quote.mjs && node test/quote-provenance.mjs && npm run test:timeline && npm run test:determinism",
     "validate": "node scripts/validate-package.mjs",
-    "test:packed": "node test/packed-install.mjs",
+    "test:packed": "node test/packed-install.mjs && node test/provenance-interop.mjs",
     "test:compare-published": "node test/compare-published.mjs",
+    "test:published-import": "node test/provenance-interop.mjs",
     "test:browser": "npm run build:browser-check && node test/browser-check.mjs",
     "prepack": "npm run build",
     "build:browser-check": "node scripts/build-browser-check.mjs",
@@ -60,7 +61,7 @@
     "test:determinism": "node test/determinism.mjs"
   },
   "dependencies": {
-    "@openpresentation/opf": "^0.11.3",
+    "@openpresentation/opf": "^0.11.4",
     "fast-xml-parser": "^5.8.0",
     "fflate": "^0.8.3",
     "jszip": "3.10.2",
@@ -76,7 +77,7 @@
   },
   "devDependencies": {
     "@expo-google-fonts/carlito": "0.4.1",
-    "@openpresentation/opf-render": "0.11.0",
+    "@openpresentation/opf-render": "0.11.9",
     "esbuild": "0.28.2",
     "playwright": "1.63.0"
   },