@openpresentation/opf-pptx 0.11.0 → 0.11.2

package/dist/media-dedupe.js

@@ -0,0 +1,44 @@
+// PptxGenJS embeds one media part per picture, so a picture repeated on many
+// slides repeats its bytes. Identical media parts collapse into the first one
+// (in path order); every relationship that pointed at a removed part is
+// re-targeted, so each slide still owns its own relationship and picture.
+const hashBytes = bytes => {
+  // Bucket key only (cyrb53); equal buckets are confirmed byte for byte.
+  let h1 = 0xdeadbeef, h2 = 0x41c6ce57;
+  for (let index = 0; index < bytes.byteLength; index += 1) {
+    h1 = Math.imul(h1 ^ bytes[index], 2654435761);
+    h2 = Math.imul(h2 ^ bytes[index], 1597334677);
+  }
+  h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909);
+  h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909);
+  return (h2 >>> 0).toString(16) + (h1 >>> 0).toString(16);
+};
+const sameBytes = (a, b) => a.byteLength === b.byteLength && a.every((value, index) => value === b[index]);
+const decoder = new TextDecoder(), encoder = new TextEncoder();
+
+/**
+ * Remove duplicate ppt/media parts from entries (and their metadata), and
+ * re-target relationships. resolve(sourcePart, target) gives a package path.
+ * Returns the Map of removed path to the part that replaced it.
+ */
+export function dedupeMedia(entries, metadata, resolve) {
+  const canonical = new Map(), buckets = new Map();
+  for (const path of Object.keys(entries).filter(path => /^ppt\/media\/[^/]+$/.test(path)).sort()) {
+    const bytes = entries[path], key = `${bytes.byteLength}:${hashBytes(bytes)}`;
+    const match = (buckets.get(key) ?? []).find(candidate => sameBytes(entries[candidate], bytes));
+    if (match) canonical.set(path, match);
+    else buckets.set(key, [...(buckets.get(key) ?? []), path]);
+  }
+  if (!canonical.size) return canonical;
+  for (const part of Object.keys(entries).filter(path => path.endsWith('.rels'))) {
+    const source = part.replace(/(^|\/)_rels\/([^/]*)\.rels$/, '$1$2');
+    const xml = decoder.decode(entries[part]);
+    const next = xml.replace(/\bTarget="([^"]+)"/g, (attribute, target) => {
+      const replacement = canonical.get(resolve(source, target));
+      return replacement ? `Target="${target.slice(0, target.lastIndexOf('/') + 1)}${replacement.slice(replacement.lastIndexOf('/') + 1)}"` : attribute;
+    });
+    if (next !== xml) entries[part] = encoder.encode(next);
+  }
+  for (const path of canonical.keys()) { delete entries[path]; metadata?.delete(path); }
+  return canonical;
+}

package/dist/theme-colors.js

@@ -102,7 +102,9 @@ function backgroundSlot(definition) {
  * `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;
+  // A slide with its own color scheme is pinned to literal colors: a theme edit
+  // in PowerPoint must not partially recolor it, even where a value coincides.
+  if (typeof reference !== 'string' || context.schemeOverride) return undefined;
   const name = reference.trim();
   const resolved = sixDigitHex(hex);
   const deck = context.themeColors;
@@ -120,17 +122,73 @@ export function schemeColorValue(reference, hex, context, {vendor = false} = {})
   return undefined;
 }
 
+function backgroundOpacity(definition) {
+  const opacity = typeof definition === 'object' && Number.isFinite(definition?.opacity) ? definition.opacity : 1;
+  return Math.max(0, Math.min(1, opacity));
+}
+
+/** Scheme value of a theme-slot slide background, or undefined when the background stays literal. */
+export function schemeBackgroundValue(definition, context) {
+  const slot = backgroundSlot(definition);
+  return slot ? schemeColorValue(slot, context.colors?.background, context) : 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);
+  const value = schemeBackgroundValue(definition, 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);
+  const alpha = Math.round(backgroundOpacity(definition) * 100000);
   return `<a:solidFill>${alpha === 100000 ? `<a:schemeClr val="${value}"/>` : `<a:schemeClr val="${value}"><a:alpha val="${alpha}"/></a:schemeClr>`}</a:solidFill>`;
 }
 
+// The exporter picks default text for contrast with the slide background:
+// light1 on a dark background, else the scheme text (dark1); muted text is
+// dark2/light2. When the background itself is a theme reference, the matching
+// text slot is the semantic pair, so a PowerPoint theme switch moves both.
+const TEXT_PAIRS = Object.freeze({
+  light1: {text: 'dark1', muted: 'dark2'}, light2: {text: 'dark1', muted: 'dark2'},
+  dark1: {text: 'light1', muted: 'light2'}, dark2: {text: 'light1', muted: 'light2'},
+});
+
+/**
+ * Scheme values for the exporter's default text and muted text on this slide.
+ * A role gets a scheme value only when the slide background is an opaque theme
+ * reference to a light or dark slot, the slide has no scheme override, and the
+ * resolved default color is exactly the paired slot in the deck theme.
+ */
+export function defaultTextSchemeValues(context) {
+  const background = schemeBackgroundValue(context.backgroundDefinition, context);
+  if (!background || backgroundOpacity(context.backgroundDefinition) !== 1) return {};
+  const pair = TEXT_PAIRS[backgroundSlot(context.backgroundDefinition)];
+  if (!pair) return {};
+  const values = {};
+  for (const role of ['text', 'muted']) {
+    const hex = role === 'text' ? context.colors?.text : context.colors?.mutedText;
+    const value = schemeColorValue(pair[role], hex, context);
+    if (value) values[role] = value;
+  }
+  return values;
+}
+
+/**
+ * Scheme value for the exporter's default text in a table cell whose fill is a
+ * theme reference (`fillValue`, from schemeColorValue). A light or dark fill (bg1,
+ * bg2, tx1, tx2) pairs with the opposite text slot (dark1 on bg, light1 on tx).
+ * An accent fill has contrast-selected text, which stays a theme reference only
+ * when the selection is exactly the deck light1 or dark1. Anything else, and any
+ * fill that is not a theme reference, keeps literal text.
+ */
+export function tableTextSchemeValue(fillValue, hex, context) {
+  if (!fillValue) return undefined;
+  const light = /^bg[12]$/.test(fillValue), dark = /^tx[12]$/.test(fillValue);
+  const candidates = light ? ['dark1'] : dark ? ['light1'] : /^accent[1-6]$/.test(fillValue) ? ['light1', 'dark1'] : [];
+  for (const slot of candidates) {
+    const value = schemeColorValue(slot, hex, context, {vendor: true});
+    if (value) return value;
+  }
+  return undefined;
+}
+
 // ---------------------------------------------------------------------------
 // Import
 
@@ -202,3 +260,31 @@ export function recoverTheme({themeName, colors, majorFont, minorFont}, {themes,
   const fontMatch = !!fonts && fonts.heading === majorFont && fonts.body === minorFont;
   return colorMatch || fontMatch ? {id: theme.id} : {unverified: theme.id};
 }
+
+// ---------------------------------------------------------------------------
+// Slide master
+
+/** a:solidFill child for a pptx color value: a scheme value or RRGGBB. */
+export function solidColorXml(value) {
+  return /^(?:tx[12]|bg[12]|accent[1-6]|hlink|folHlink)$/.test(value) ? `<a:schemeClr val="${value}"/>` : `<a:srgbClr val="${value}"/>`;
+}
+
+/**
+ * Give the slide master the deck's theme background and matching default text
+ * so slides added in PowerPoint follow the chosen theme. The vendored master
+ * has no background (its layout uses the bg1 background style) and tx1 text.
+ */
+export function writeMasterBackground(xml, {fill, text}) {
+  let result = xml.replace(/<p:bg>[\s\S]*?<\/p:bg>/, '');
+  result = result.replace(/<p:cSld\b([^>]*)>/, `<p:cSld$1><p:bg><p:bgPr>${fill}<a:effectLst/></p:bgPr></p:bg>`);
+  if (text && text !== 'tx1') {
+    result = result.replace(/<p:txStyles>[\s\S]*?<\/p:txStyles>/, styles =>
+      styles.split('<a:solidFill><a:schemeClr val="tx1"/></a:solidFill>').join(`<a:solidFill>${solidColorXml(text)}</a:solidFill>`));
+  }
+  return result;
+}
+
+/** The vendored layout's own bg1 background would hide the master background. */
+export function inheritLayoutBackground(xml) {
+  return xml.replace(/<p:bg>[\s\S]*?<\/p:bg>/, '');
+}

package/dist/watermark-provenance.js

@@ -0,0 +1,146 @@
+import {XMLParser} from 'fast-xml-parser';
+import {decodeTextTag, encodeTextTag} from './code-provenance.js';
+import {pictureTransform} from './image-geometry.js';
+
+// design.watermark exports as one native picture per slide, placed first in the
+// shape tree (beneath content) at the preview's frame: the centered 40% of the
+// slide, fitted without cropping. Opacity is a native a:alphaModFix on the
+// picture's blip. The tag records the exact native picture, so an unchanged
+// picture imports back as design.watermark while an edited one stays ordinary.
+const TAG = 'OPF_WATERMARK_V1', REL = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/tags';
+const EMUS_PER_INCH = 914400;
+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];
+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);
+
+export const watermarkName = () => 'OPF watermark';
+
+// The preview's frame: x/y at 30% and a 40% by 40% box, in the slide's units.
+export const watermarkBox = (width, height) => ({x: width * .3, y: height * .3, w: width * .4, h: height * .4});
+
+// The preview reads opacity from an object form only; a string form is 0.08.
+export function watermarkOpacity(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return WATERMARK_DEFAULT_OPACITY;
+  const opacity = value.opacity ?? WATERMARK_DEFAULT_OPACITY;
+  return typeof opacity === 'number' && Number.isFinite(opacity) ? Math.min(1, Math.max(0, opacity)) : WATERMARK_DEFAULT_OPACITY;
+}
+
+function blipFillIdentity(blipFill) {
+  const {['a:blip']: blip, ...rest} = blipFill ?? {};
+  const {['r:embed']: _embed, ...blipRest} = blip ?? {};
+  return {...rest, 'a:blip': blipRest};
+}
+
+/**
+ * Place each generated watermark picture at its frame, apply opacity, and bind
+ * the picture to its manifest with a native tag.
+ * marks: Map<slidePart, {slide, box (inches), opacity, path}>.
+ */
+export function placeWatermarks(entries, marks, metadataFor, fail) {
+  if (!marks.size) return;
+  const manifests = new Map();
+  for (const part of Object.keys(entries).filter(path => /^ppt\/slides\/slide\d+\.xml$/.test(path))) {
+    const mark = marks.get(part);
+    if (!mark) 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] !== watermarkName()) return picture;
+      found++;
+      const embed = picture.match(/<a:blip\b[^>]*r:embed="([^"]+)"/)?.[1];
+      const metadata = metadataFor(part, embed);
+      if (!metadata) fail(mark.path);
+      const placed = pictureTransform(metadata, mark.box, 'fit');
+      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[^>]*\/>/, '');
+      if (mark.opacity < 1) {
+        const effect = `<a:alphaModFix amt="${Math.round(mark.opacity * 100000)}"/>`;
+        picture = picture.replace(/<a:blip\b([^>]*?)(?:\/>|>([\s\S]*?)<\/a:blip>)/, (_, blipAttributes, inner = '') => `<a:blip${blipAttributes}>${effect}${inner}</a:blip>`);
+      }
+      const node = parser.parse(picture)['p:pic'];
+      manifests.set(part, {v: 1, slide: mark.slide, opacity: mark.opacity, properties: node['p:spPr'], blipFill: blipFillIdentity(node['p:blipFill'])});
+      return picture;
+    });
+    if (found !== 1) throw new Error('Missing generated watermark picture.');
+    entries[part] = encoder.encode(next);
+  }
+  attachTags(entries, manifests);
+}
+
+// One tag part per slide, related from the picture's application properties.
+// (attachTextTags is keyed by shape name, and every slide's watermark shares one.)
+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/opfWatermark${++count}.xml`;
+    let id = `rIdOpfWatermark${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/opfWatermark${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] !== watermarkName()) return picture;
+      attached = true;
+      picture = picture.replace(/<p:nvPr\s*\/>/, '<p:nvPr></p:nvPr>');
+      if (!picture.includes('</p:nvPr>')) throw new Error('Generated watermark 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};
+}
+
+/**
+ * Recover design.watermark from an unchanged tagged picture. Returns the
+ * consumed picture indexes and the slide design fields to restore.
+ * readPicture(picture) returns the ordinary imported image payload.
+ */
+export function importWatermark(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);
+    if (!own.length) 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-watermark-provenance', message: 'An edited, ambiguous or invalid tagged OPF watermark was imported as an ordinary picture. It is not reconstructed as design.watermark.'});
+  if (found.length > 1) { invalid(); return {consumed}; }
+  const [{index, picture, own, unreadable, others}] = found;
+  try {
+    if (unreadable || others || own.length !== 1) throw Error('Ambiguous watermark identity.');
+    const manifest = decodeTextTag(own[0].val);
+    if (manifest?.v !== 1 || manifest.slide !== `slides.${slideIndex}` || typeof manifest.opacity !== 'number' || !(manifest.opacity >= 0 && manifest.opacity <= 1)) throw Error('Invalid watermark manifest.');
+    if (picture['p:nvPicPr']?.['p:cNvPr']?.name !== watermarkName()) throw Error('Watermark identity changed.');
+    if (canonical(picture['p:spPr']) !== canonical(manifest.properties) || canonical(blipFillIdentity(picture['p:blipFill'])) !== canonical(manifest.blipFill)) throw Error('Watermark geometry or opacity changed.');
+    const item = readPicture(picture);
+    const src = item?.payload?.image?.src;
+    if (typeof src !== 'string') throw Error('Watermark bytes are unavailable.');
+    consumed.add(index);
+    return {consumed, design: {watermark: {src, opacity: manifest.opacity}}};
+  } catch {
+    invalid();
+    return {consumed};
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf-pptx",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "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 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",
+    "typecheck": "node --check src/index.js && node --check src/chart-types.js && 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/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 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/chart-types.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/export-chosen-fonts.mjs && node test/typeface-inventory.mjs && node test/color-ref-export.mjs && node test/theme-colors.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/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",