@openpresentation/opf-pptx 0.9.1 → 0.11.0

package/dist/theme-colors.js

@@ -0,0 +1,204 @@
+// FF-24: write the deck's OPF color scheme into the exported theme and refer to
+// it with a:schemeClr where the document names a scheme slot or role.
+//
+// OPF color schemes use the twelve OOXML theme slots (opf color-scheme.schema.json,
+// docs/design-resolution.md). The theme clrScheme is deck-wide; PowerPoint has
+// no per-slide theme. A content color becomes a scheme reference only when the
+// document names a slot or role AND the deck theme slot holds exactly the color
+// the slide resolved, so slide-level scheme overrides, variables, literals and
+// engine-derived chrome colors stay literal sRGB.
+
+import {readBackgroundColor} from './background.js';
+
+/** OPF slot -> clrScheme child element, in CT_ColorScheme order. */
+export const THEME_SLOTS = Object.freeze([
+  ['dark1', 'dk1'], ['light1', 'lt1'], ['dark2', 'dk2'], ['light2', 'lt2'],
+  ['accent1', 'accent1'], ['accent2', 'accent2'], ['accent3', 'accent3'],
+  ['accent4', 'accent4'], ['accent5', 'accent5'], ['accent6', 'accent6'],
+  ['hyperlink', 'hlink'], ['followedHyperlink', 'folHlink'],
+]);
+
+// Slide content reaches the theme through the master clrMap. The vendored
+// master maps bg1=lt1, tx1=dk1, bg2=lt2, tx2=dk2 and every other slot to itself.
+const CONTENT_VALUES = Object.freeze({
+  dark1: 'tx1', light1: 'bg1', dark2: 'tx2', light2: 'bg2',
+  accent1: 'accent1', accent2: 'accent2', accent3: 'accent3',
+  accent4: 'accent4', accent5: 'accent5', accent6: 'accent6',
+  hyperlink: 'hlink', followedHyperlink: 'folHlink',
+});
+// PptxGenJS 4.0.1 createColorElement accepts only these scheme values.
+const VENDOR_VALUES = new Set(['tx1', 'tx2', 'bg1', 'bg2', 'accent1', 'accent2', 'accent3', 'accent4', 'accent5', 'accent6']);
+
+// Role names resolve through core resolveColorRef with the exporter's resolved
+// chrome colors (color-ref.js coreRoles). These are the slots each role can land
+// on; a slot is used only when its deck theme value equals the resolved color.
+const ROLE_SLOTS = Object.freeze({
+  primary: ['accent1'],
+  secondary: ['accent2'],
+  accent: ['accent1', 'accent3'],
+  text: ['dark1', 'light1'],
+  textSecondary: ['dark2', 'light2'],
+  surface: ['light2', 'dark2'],
+});
+// Abstract roles supply a slot only when the scheme leaves that slot unset.
+const ROLE_FOR_SLOT = Object.freeze({accent1: 'primary', accent2: 'secondary', accent3: 'accent', light1: 'background', light2: 'surface', dark1: 'text', dark2: 'textSecondary'});
+
+const SLOT_NAMES = new Set(THEME_SLOTS.map(([slot]) => slot));
+
+export function sixDigitHex(value) {
+  if (typeof value !== 'string') return undefined;
+  let raw = value.trim().replace(/^#/, '');
+  if (/^[\da-f]{3}$/i.test(raw)) raw = [...raw].map(char => char + char).join('');
+  if (/^[\da-f]{8}$/i.test(raw) && /ff$/i.test(raw)) raw = raw.slice(0, 6);
+  return /^[\da-f]{6}$/i.test(raw) ? raw.toUpperCase() : undefined;
+}
+
+/** Twelve-slot map (OPF slot -> RRGGBB) for a resolved color scheme. Unset slots are omitted. */
+export function themeSlotColors(colorScheme = {}) {
+  const colors = {};
+  for (const [slot] of THEME_SLOTS) {
+    const value = sixDigitHex(colorScheme[slot]) ?? sixDigitHex(colorScheme[ROLE_FOR_SLOT[slot]]);
+    if (value) colors[slot] = value;
+  }
+  return colors;
+}
+
+const escapeXml = value => String(value).replace(/[&<>"']/g, char => ({'&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&apos;'}[char]));
+
+/**
+ * Replace the vendored Office clrScheme with the deck scheme. Slots the scheme
+ * leaves unset keep the vendored value. With a theme name, rename the theme and
+ * its thm15 theme family so an OPF catalog theme can be recognized on import.
+ */
+export function writeThemeColors(xml, {colors, schemeName, themeName}) {
+  let result = xml.replace(/<a:clrScheme\b[^>]*>([\s\S]*?)<\/a:clrScheme>/, (scheme, body) => {
+    for (const [slot, element] of THEME_SLOTS) {
+      if (!colors[slot]) continue;
+      body = body.replace(new RegExp(`<a:${element}>[\\s\\S]*?</a:${element}>`), `<a:${element}><a:srgbClr val="${colors[slot]}"/></a:${element}>`);
+    }
+    return `<a:clrScheme name="${escapeXml(schemeName)}">${body}</a:clrScheme>`;
+  });
+  if (themeName) {
+    const name = escapeXml(themeName);
+    result = result.replace(/(<a:theme\b[^>]*\bname=")[^"]*(")/, `$1${name}$2`)
+      .replace(/(<thm15:themeFamily\b[^>]*\bname=")[^"]*(")/, `$1${name}$2`);
+  }
+  return result;
+}
+
+function backgroundSlot(definition) {
+  if (typeof definition === 'string' && !definition.startsWith('#')) return definition;
+  if (definition && typeof definition === 'object' && definition.type === 'theme') return definition.slot;
+  return undefined;
+}
+
+/**
+ * The slide-content scheme value (tx1, bg2, accent3, hlink, ...) for a document
+ * color reference, or undefined when it must stay a literal color.
+ *
+ * `hex` is the color the exporter already resolved for this slide. The reference
+ * qualifies only when it names a slot or role and the deck theme slot, which the
+ * schemeClr will actually resolve to, holds that exact opaque color.
+ * `vendor` limits the result to scheme values PptxGenJS 4.0.1 can emit.
+ */
+export function schemeColorValue(reference, hex, context, {vendor = false} = {}) {
+  if (typeof reference !== 'string') return undefined;
+  const name = reference.trim();
+  const resolved = sixDigitHex(hex);
+  const deck = context.themeColors;
+  if (!resolved || !deck) return undefined;
+  let slots;
+  if (SLOT_NAMES.has(name)) slots = [name];
+  else if (name === 'background') slots = [backgroundSlot(context.backgroundDefinition)].filter(slot => SLOT_NAMES.has(slot));
+  else slots = ROLE_SLOTS[name] ?? [];
+  const effective = themeSlotColors(context.colorScheme);
+  for (const slot of slots) {
+    if (deck[slot] !== resolved || effective[slot] !== resolved) continue;
+    const value = CONTENT_VALUES[slot];
+    if (!vendor || VENDOR_VALUES.has(value)) return value;
+  }
+  return undefined;
+}
+
+/** Native slide background fill for a theme-slot background, or null when it must stay literal. */
+export function schemeBackgroundFill(definition, context) {
+  const slot = backgroundSlot(definition);
+  if (!slot) return null;
+  const value = schemeColorValue(slot, context.colors?.background, context);
+  if (!value) return null;
+  const opacity = typeof definition === 'object' && Number.isFinite(definition.opacity) ? definition.opacity : 1;
+  const alpha = Math.round(Math.max(0, Math.min(1, opacity)) * 100000);
+  return `<a:solidFill>${alpha === 100000 ? `<a:schemeClr val="${value}"/>` : `<a:schemeClr val="${value}"><a:alpha val="${alpha}"/></a:schemeClr>`}</a:solidFill>`;
+}
+
+// ---------------------------------------------------------------------------
+// Import
+
+const asArray = value => value === undefined ? [] : Array.isArray(value) ? value : [value];
+
+/** Read the twelve clrScheme slots as RRGGBB; unreadable slots are listed separately. */
+export function readThemeSlotColors(clrScheme) {
+  const colors = {}, unreadable = [];
+  for (const [slot, element] of THEME_SLOTS) {
+    const node = clrScheme?.[`a:${element}`];
+    const color = node && !Array.isArray(node) ? readBackgroundColor(node) : null;
+    if (color && color.alpha === 1) colors[slot] = color.hex.slice(1);
+    else unreadable.push(slot);
+  }
+  return {colors, unreadable};
+}
+
+function recordColors(record) {
+  return Object.fromEntries(THEME_SLOTS.map(([slot]) => [slot, sixDigitHex(record[slot])]));
+}
+
+/**
+ * Recover design.colorScheme from theme clrScheme colors.
+ * An exact twelve-slot match with a catalog record yields its id (the clrScheme
+ * name breaks ties). Otherwise the colors are inline: relative to the record
+ * whose name the clrScheme carries, or as all readable slots.
+ */
+export function recoverColorScheme({colors, unreadable, name}, records) {
+  const complete = unreadable.length === 0;
+  const exact = complete ? records.filter(record => THEME_SLOTS.every(([slot]) => recordColors(record)[slot] === colors[slot])) : [];
+  const named = record => record.name === name || record.id === name;
+  if (exact.length) return {value: (exact.find(named) ?? exact[0]).id, exact: true};
+  const base = records.find(named);
+  const inline = {};
+  if (base) {
+    inline.id = base.id;
+    const baseColors = recordColors(base);
+    for (const [slot] of THEME_SLOTS) if (colors[slot] && colors[slot] !== baseColors[slot]) inline[slot] = `#${colors[slot]}`;
+  } else {
+    for (const [slot] of THEME_SLOTS) if (colors[slot]) inline[slot] = `#${colors[slot]}`;
+  }
+  return {value: inline, exact: false};
+}
+
+/** First slide master's theme part, else the presentation's theme relationship. */
+export function presentationThemePath(presentationRoot, presentationRels, relationshipsFor, entries) {
+  const byId = presentationRels;
+  const masterIds = asArray(presentationRoot?.['p:sldMasterIdLst']?.['p:sldMasterId']).map(node => node?.['r:id']);
+  const masterPath = masterIds.map(id => byId.get(id)).find(rel => rel?.type?.endsWith('/slideMaster') && entries[rel.path])?.path
+    ?? [...byId.values()].find(rel => rel.type?.endsWith('/slideMaster') && entries[rel.path])?.path;
+  const fromMaster = masterPath && [...relationshipsFor(masterPath).values()].find(rel => rel.type?.endsWith('/theme') && entries[rel.path])?.path;
+  return fromMaster ?? [...byId.values()].find(rel => rel.type?.endsWith('/theme') && entries[rel.path])?.path;
+}
+
+/**
+ * Identify a catalog theme from the native theme name. The name must equal a
+ * catalog theme name, and the package must corroborate it with that theme's
+ * color scheme or its heading/body font pair, so a foreign deck that happens to
+ * use a theme called "Bold" is not bound to the OPF theme.
+ */
+export function recoverTheme({themeName, colors, majorFont, minorFont}, {themes, colorSchemes, fontFamilies}) {
+  if (!themeName) return {};
+  const theme = themes.find(record => record.name === themeName);
+  if (!theme) return {};
+  const scheme = colorSchemes.find(record => record.id === theme.colorScheme);
+  const schemeColors = scheme ? recordColors(scheme) : null;
+  const colorMatch = !!schemeColors && THEME_SLOTS.every(([slot]) => schemeColors[slot] === colors[slot]);
+  const fonts = fontFamilies(theme.fontScheme);
+  const fontMatch = !!fonts && fonts.heading === majorFont && fonts.body === minorFont;
+  return colorMatch || fontMatch ? {id: theme.id} : {unverified: theme.id};
+}

package/dist/typeface-inventory.js

@@ -0,0 +1,227 @@
+import {unzipSync} from 'fflate';
+
+// Typeface inventory for a PPTX package (FF-08, font-fidelity-everywhere).
+//
+// Walks every XML part, including parts of nested OOXML packages such as the
+// embedded chart workbooks, and records each font name the package carries:
+// DrawingML `typeface` attributes (latin, ea, cs, sym, buFont, theme script
+// supplements, embedded-font lists), SpreadsheetML font names (styles `name`,
+// rich-text `rFont`) and the docProps/app.xml "Fonts Used" list.
+// checkPptxTypefaces() then applies the owner font policy: a package names only
+// the fonts its author chose, plus theme references that resolve to them, empty
+// theme script slots (FF-05) and the documented theme script supplements.
+
+const decoder = new TextDecoder();
+const NESTED_PACKAGE = /\.(?:xlsx|xlsm|docx|pptx)$/i;
+const XML_PART = /\.(?:xml|rels)$/i;
+const THEME_PART = /(?:^|\/)theme\/theme\d+\.xml$/;
+const THEME_REFERENCE = /^\+(mj|mn)-(lt|ea|cs)$/;
+const THEME_SLOT = {lt: 'latin', ea: 'ea', cs: 'cs'};
+const FIXED_PITCH = 1;
+
+// Per-script theme fonts (`<a:font script="…">`) written by the vendored
+// PptxGenJS 4.0.1 theme. They are Office's defaults for scripts the deck
+// declares no font for. PowerPoint uses one only for text in that script, and
+// it does not list them in "Fonts Used". The check allows exactly these
+// script/typeface pairs in the presentation theme; any other supplement fails
+// unless it names a chosen font. test/typeface-inventory.mjs pins this list to
+// the vendored theme.
+const supplement = entries => Object.freeze(Object.fromEntries(entries.split('|').map(pair => pair.split('='))));
+const SHARED_SCRIPTS = 'Hang=맑은 고딕|Hant=新細明體|Ethi=Nyala|Beng=Vrinda|Gujr=Shruti|Knda=Tunga|Guru=Raavi|Cans=Euphemia|Cher=Plantagenet Cherokee|Yiii=Microsoft Yi Baiti|Tibt=Microsoft Himalaya|Thaa=MV Boli|Deva=Mangal|Telu=Gautami|Taml=Latha|Syrc=Estrangelo Edessa|Orya=Kalinga|Mlym=Kartika|Laoo=DokChampa|Sinh=Iskoola Pota|Mong=Mongolian Baiti|Uigh=Microsoft Uighur|Geor=Sylfaen|Armn=Arial|Bugi=Leelawadee UI|Bopo=Microsoft JhengHei|Java=Javanese Text|Lisu=Segoe UI|Mymr=Myanmar Text|Nkoo=Ebrima|Olck=Nirmala UI|Osma=Ebrima|Phag=Phagspa|Syrn=Estrangelo Edessa|Syrj=Estrangelo Edessa|Syre=Estrangelo Edessa|Sora=Nirmala UI|Tale=Microsoft Tai Le|Talu=Microsoft New Tai Lue|Tfng=Ebrima';
+export const THEME_SCRIPT_SUPPLEMENTS = Object.freeze({
+  major: supplement(`Jpan=游ゴシック Light|Hans=等线 Light|Arab=Times New Roman|Hebr=Times New Roman|Thai=Angsana New|Khmr=MoolBoran|Viet=Times New Roman|${SHARED_SCRIPTS}`),
+  minor: supplement(`Jpan=游ゴシック|Hans=等线|Arab=Arial|Hebr=Arial|Thai=Cordia New|Khmr=DaunPenh|Viet=Arial|${SHARED_SCRIPTS}`)
+});
+
+export function inventoryPptxTypefaces(input, options = {}) {
+  const typefaces = [];
+  const themes = {};
+  let fontsUsed = null;
+  const visit = (entries, prefix) => {
+    const packageThemes = [];
+    for (const path of Object.keys(entries).sort()) {
+      const bytes = entries[path];
+      if (NESTED_PACKAGE.test(path)) {
+        if (options.nested !== false) visit(unzipSync(bytes), `${prefix}${path}!/`);
+        continue;
+      }
+      if (!XML_PART.test(path)) continue;
+      const xml = decoder.decode(bytes);
+      const part = prefix + path;
+      if (THEME_PART.test(path)) packageThemes.push(part);
+      readTypefaces(xml, part, THEME_PART.test(path), typefaces);
+      if (/^xl\/.*\.xml$/.test(path)) readSpreadsheetFonts(xml, part, typefaces);
+      if (!prefix && path === 'docProps/app.xml') fontsUsed = readFontsUsed(xml);
+    }
+    // Theme references resolve against the package theme. The exporter writes
+    // one theme per package; with several, the first (theme1) is used.
+    const theme = packageThemes[0];
+    if (theme) themes[prefix] = themeFonts(typefaces, theme);
+  };
+  visit(toEntries(input), '');
+  for (const entry of typefaces) {
+    const reference = THEME_REFERENCE.exec(entry.typeface);
+    if (!reference) continue;
+    const prefix = entry.part.includes('!/') ? entry.part.slice(0, entry.part.lastIndexOf('!/') + 2) : '';
+    const resolved = themes[prefix]?.[reference[1] === 'mj' ? 'major' : 'minor']?.[THEME_SLOT[reference[2]]];
+    entry.resolved = resolved ?? null;
+  }
+  return {typefaces, themes, fontsUsed};
+}
+
+// Fonts a package uses, as PowerPoint lists them under "Fonts Used": the
+// presentation theme's major/minor fonts and every explicit font in the
+// presentation's own parts (slides, layouts, masters, notes, charts), with
+// theme references resolved. Script supplements, empty slots and nested
+// packages are not fonts in use. Sorted by a locale-independent order.
+export function packageFontsUsed(inventory) {
+  const used = new Set();
+  for (const entry of inventory.typefaces) {
+    if (entry.part.includes('!/') || !entry.part.startsWith('ppt/') || entry.script !== undefined || entry.kind !== 'drawingml') continue;
+    const value = THEME_REFERENCE.test(entry.typeface) ? entry.resolved : entry.typeface;
+    if (value) used.add(value);
+  }
+  return [...used].sort(compareFontNames);
+}
+
+export function checkPptxTypefaces(input, options = {}) {
+  if (!Array.isArray(options.fonts) || options.fonts.some(font => typeof font !== 'string' || !font)) {
+    throw new TypeError('checkPptxTypefaces requires options.fonts, the non-empty family names the author chose.');
+  }
+  const chosen = new Set(options.fonts);
+  const monospace = new Set(options.monospace ?? []);
+  const allowEmpty = options.allowEmptyThemeScripts ?? true;
+  const supplements = options.scriptSupplements ?? THEME_SCRIPT_SUPPLEMENTS;
+  const inventory = inventoryPptxTypefaces(input);
+  const violations = [];
+  const fail = (entry, reason, details = {}) => violations.push({reason, part: entry.part, element: entry.element, typeface: entry.typeface, ...details});
+  const emptyAllowed = entry => allowEmpty && entry.theme && (entry.element === 'ea' || entry.element === 'cs');
+  const pitches = new Map();
+  for (const entry of inventory.typefaces) {
+    const reference = THEME_REFERENCE.exec(entry.typeface);
+    if (reference) {
+      if (entry.resolved === null) fail(entry, 'unresolved-theme-reference');
+      else if (entry.resolved === '') { if (!allowEmpty || reference[2] === 'lt') fail(entry, 'empty-theme-reference'); }
+      else if (!chosen.has(entry.resolved)) fail(entry, 'foreign-theme-reference', {resolved: entry.resolved});
+      continue;
+    }
+    if (entry.typeface === '') {
+      if (!emptyAllowed(entry)) fail(entry, 'empty-typeface');
+      continue;
+    }
+    if (entry.script !== undefined) {
+      const documented = !entry.part.includes('!/') && Boolean(entry.theme) && supplements[entry.theme]?.[entry.script] === entry.typeface;
+      if (!documented && !chosen.has(entry.typeface)) fail(entry, 'foreign-script-supplement', {script: entry.script, theme: entry.theme});
+      continue;
+    }
+    if (!chosen.has(entry.typeface)) fail(entry, 'foreign-typeface');
+    if (entry.pitchFamily !== undefined) {
+      const fixed = (entry.pitchFamily & 0x03) === FIXED_PITCH;
+      if (monospace.has(entry.typeface) && !fixed) fail(entry, 'monospace-not-fixed-pitch', {pitchFamily: entry.pitchFamily});
+      if (!monospace.has(entry.typeface) && fixed) fail(entry, 'fixed-pitch-not-monospace', {pitchFamily: entry.pitchFamily});
+      const seen = pitches.get(entry.typeface);
+      if (seen === undefined) pitches.set(entry.typeface, entry.pitchFamily);
+      else if (seen !== entry.pitchFamily) fail(entry, 'inconsistent-pitch-family', {pitchFamily: entry.pitchFamily, first: seen});
+    }
+  }
+  const expected = packageFontsUsed(inventory);
+  if (inventory.fontsUsed === null) {
+    violations.push({reason: 'missing-fonts-used', part: 'docProps/app.xml'});
+  } else {
+    for (const font of inventory.fontsUsed) {
+      if (!chosen.has(font)) violations.push({reason: 'foreign-fonts-used', part: 'docProps/app.xml', typeface: font});
+    }
+    if (inventory.fontsUsed.join('\n') !== expected.join('\n')) {
+      violations.push({reason: 'fonts-used-mismatch', part: 'docProps/app.xml', listed: inventory.fontsUsed, expected});
+    }
+  }
+  return {ok: violations.length === 0, violations, inventory, fontsUsed: expected};
+}
+
+export function compareFontNames(left, right) {
+  const a = left.toLowerCase(), b = right.toLowerCase();
+  if (a !== b) return a < b ? -1 : 1;
+  return left < right ? -1 : left > right ? 1 : 0;
+}
+
+function toEntries(input) {
+  if (input instanceof Uint8Array) return unzipSync(input);
+  if (input instanceof ArrayBuffer) return unzipSync(new Uint8Array(input));
+  if (input && typeof input === 'object') return input;
+  throw new TypeError('Expected PPTX bytes or a map of package parts.');
+}
+
+function readTypefaces(xml, part, isTheme, output) {
+  const major = sectionRange(xml, 'majorFont'), minor = sectionRange(xml, 'minorFont');
+  for (const match of xml.matchAll(/<(?:[\w.-]+:)?([\w.-]+)\b([^<>]*?\btypeface="([^"]*)"[^<>]*)>/g)) {
+    const [, element, attributes, raw] = match;
+    const entry = {part, kind: 'drawingml', element, typeface: unescapeXml(raw)};
+    const pitch = /\bpitchFamily="([^"]*)"/.exec(attributes)?.[1];
+    if (pitch !== undefined) entry.pitchFamily = Number(pitch);
+    const script = /\bscript="([^"]*)"/.exec(attributes)?.[1];
+    if (script !== undefined) entry.script = script;
+    if (isTheme) {
+      const at = match.index;
+      if (at > major[0] && at < major[1]) entry.theme = 'major';
+      else if (at > minor[0] && at < minor[1]) entry.theme = 'minor';
+    }
+    output.push(entry);
+  }
+}
+
+function readSpreadsheetFonts(xml, part, output) {
+  for (const match of xml.matchAll(/<(?:[\w.-]+:)?(name|rFont)\b[^<>]*?\bval="([^"]*)"[^<>]*>/g)) {
+    output.push({part, kind: 'spreadsheetml', element: match[1], typeface: unescapeXml(match[2])});
+  }
+}
+
+function themeFonts(typefaces, part) {
+  const fonts = {major: {}, minor: {}};
+  for (const entry of typefaces) {
+    if (entry.part !== part || !entry.theme || !['latin', 'ea', 'cs'].includes(entry.element)) continue;
+    fonts[entry.theme][entry.element] ??= entry.typeface;
+  }
+  return fonts;
+}
+
+function readFontsUsed(xml) {
+  const pairs = headingPairs(xml);
+  const titles = titlesOfParts(xml);
+  if (!pairs || !titles) return null;
+  let offset = 0;
+  for (const [name, count] of pairs) {
+    if (name === 'Fonts Used') return titles.slice(offset, offset + count);
+    offset += count;
+  }
+  return [];
+}
+
+export function headingPairs(xml) {
+  const block = /<HeadingPairs>([\s\S]*?)<\/HeadingPairs>/.exec(xml)?.[1];
+  if (block === undefined) return null;
+  const values = [...block.matchAll(/<vt:variant>\s*<vt:(lpstr|i4)>([^<]*)<\/vt:\1>\s*<\/vt:variant>/g)].map(match => match[1] === 'i4' ? Number(match[2]) : unescapeXml(match[2]));
+  const pairs = [];
+  for (let index = 0; index + 1 < values.length; index += 2) pairs.push([values[index], values[index + 1]]);
+  return pairs;
+}
+
+export function titlesOfParts(xml) {
+  const block = /<TitlesOfParts>([\s\S]*?)<\/TitlesOfParts>/.exec(xml)?.[1];
+  if (block === undefined) return null;
+  return [...block.matchAll(/<vt:lpstr>([^<]*)<\/vt:lpstr>/g)].map(match => unescapeXml(match[1]));
+}
+
+function sectionRange(xml, name) {
+  const start = xml.indexOf(`<a:${name}>`);
+  if (start < 0) return [-1, -1];
+  const end = xml.indexOf(`</a:${name}>`, start);
+  return [start, end < 0 ? xml.length : end];
+}
+
+function unescapeXml(value) {
+  return value.replace(/&(?:amp|lt|gt|quot|apos|#(\d+)|#x([0-9a-fA-F]+));/g, (entity, decimal, hex) => {
+    if (decimal) return String.fromCodePoint(Number(decimal));
+    if (hex) return String.fromCodePoint(Number.parseInt(hex, 16));
+    return {'&amp;': '&', '&lt;': '<', '&gt;': '>', '&quot;': '"', '&apos;': "'"}[entity];
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf-pptx",
-  "version": "0.9.1",
+  "version": "0.11.0",
   "description": "Pure local OPF to PPTX export and PPTX to OPF import tooling.",
   "license": "MIT",
   "type": "module",
@@ -37,8 +37,8 @@
   "sideEffects": false,
   "scripts": {
     "build": "node scripts/build.mjs",
-    "typecheck": "node --check src/index.js && node --check src/color-ref.js && node --check scripts/build.mjs && node --check scripts/validate-package.mjs && node --check test/smoke.mjs && node --check src/image-geometry.js && 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/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 test/shared-timeline.mjs && node --check test/shared-furniture.mjs && node --check src/furniture-provenance.js && node --check test/furniture-provenance.mjs",
-    "test": "npm run build && npm run test:furniture && node test/color-ref-export.mjs && node test/plain-whitespace.mjs && node test/accepted-text.mjs && node test/heading-provenance.mjs && node test/chart-colors.mjs && node test/content-cards.mjs && node test/chart-workbook.mjs && node test/dependency-boundary.mjs && npm run build:browser-check && npm run test:styled-table && node test/content-layout.mjs && node test/shared-quote.mjs && npm run test:timeline",
+    "typecheck": "node --check src/index.js && 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 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 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 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/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",
+    "test": "npm run build && 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/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/export-chosen-fonts.mjs && node test/typeface-inventory.mjs && node test/color-ref-export.mjs && node test/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/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 && npm run test:timeline && npm run test:determinism",
     "validate": "node scripts/validate-package.mjs",
     "test:packed": "node test/packed-install.mjs",
     "test:compare-published": "node test/compare-published.mjs",
@@ -50,17 +50,24 @@
     "test:metric": "node test/shared-metric.mjs && node test/metric-provenance.mjs",
     "test:font-variants": "node test/font-variants.mjs",
     "test:timeline": "node test/shared-timeline.mjs",
-    "test:furniture": "node test/shared-furniture.mjs && node test/furniture-provenance.mjs"
+    "test:furniture": "node test/shared-furniture.mjs && node test/furniture-provenance.mjs && node test/furniture-fields.mjs && node test/furniture-wrapped-date.mjs && node test/socials-furniture.mjs",
+    "test:native-picture-edit-controls": "node test/compare-native-picture-edit-controls.mjs",
+    "test:native-font-embed-controls": "node test/native-font-embed-controls.mjs",
+    "test:native-mixed-edit-controls": "node test/native-mixed-edit-controls.mjs",
+    "test:native-font-inventory-controls": "node test/native-font-inventory-controls.mjs",
+    "test:zip-date": "node test/zip-date.mjs",
+    "test:native-text": "node test/native-text-whitespace.mjs",
+    "test:determinism": "node test/determinism.mjs"
   },
   "dependencies": {
-    "@openpresentation/opf": "^0.11.0",
+    "@openpresentation/opf": "^0.11.2",
     "fast-xml-parser": "^5.8.0",
     "fflate": "^0.8.3",
     "jszip": "3.10.2",
     "sharp": "0.35.4"
   },
   "peerDependencies": {
-    "@openpresentation/opf-render": "^0.9.0"
+    "@openpresentation/opf-render": "^0.11.0"
   },
   "peerDependenciesMeta": {
     "@openpresentation/opf-render": {
@@ -68,7 +75,8 @@
     }
   },
   "devDependencies": {
-    "@openpresentation/opf-render": "0.9.0",
+    "@expo-google-fonts/carlito": "0.4.1",
+    "@openpresentation/opf-render": "0.11.0",
     "esbuild": "0.28.2",
     "playwright": "1.63.0"
   },