@openpresentation/opf-pptx 0.11.9 → 0.12.0

package/dist/logo-provenance.js

@@ -36,10 +36,11 @@ function blipFillIdentity(blipFill) {
  * 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) {
+export function logoFrame(metadata, box, anchor = 'left') {
   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};
+  // Right to left (RR-05): a cover logo sits at the top right, anchored to the box's right edge.
+  return {...placed, x: placed.x + (anchor === 'right' ? 1 : -1) * (box.w - visualWidth) / 2};
 }
 
 /**
@@ -61,7 +62,7 @@ export function placeLogos(entries, logos, metadataFor, fail) {
       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 placed = logoFrame(metadata, logo.box, logo.anchor);
       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[^>]*\/>/, '');

package/dist/metric-provenance.js

@@ -14,7 +14,7 @@ export function metricManifest(value,layout,group) {
   return {v:1,group,role:'anchor',part:0,line:0,value,parts:layout.parts.map(part=>({role:part.role,visible:part.visible,
     lines:part.fit?.sourceLines.map(({start,end,nextStart,boundary})=>({start,end,nextStart,boundary}))??[]}))};
 }
-export function attachMetricTags(entries,records) {return attachTextTags(entries,records,TAG,'opfMetric','metric');}
+export function attachMetricTags(entries,records,descriptions) {return attachTextTags(entries,records,TAG,'opfMetric','metric',{descriptions});}
 
 function validateManifest(manifest) {
   if (!validatePresentation({slides:[{metric:manifest.value}]}).valid) throw new Error('Invalid metric source.');
@@ -59,10 +59,13 @@ export function importMetricGroups(shapes,paragraphs,relationships,entries,repor
     const anchors=group.filter(item=>item.data.role==='anchor');
     if (anchors.length!==1) throw new Error('Missing or duplicated metric anchor.');
     const anchor=anchors[0],manifest=anchor.data;validateManifest(manifest);
+    // RR-07: the trend arrow (role 'mark') is generated decoration: at most one, consumed with the group, never source text.
+    const marks=group.filter(item=>item.data.role==='mark'),members=group.filter(item=>item.data.role!=='mark');
+    if (marks.length>1) throw new Error('Duplicated metric trend mark.');
     const expected=manifest.parts.reduce((sum,part)=>sum+part.lines.length,0);
-    if (group.length!==expected||new Set(group.map(item=>item.shape)).size!==expected) throw new Error('Incomplete or duplicated metric shapes.');
+    if (members.length!==expected||new Set(members.map(item=>item.shape)).size!==expected) throw new Error('Incomplete or duplicated metric shapes.');
     const nativeLines=new Map();
-    for (const item of group) {
+    for (const item of members) {
       const {role,part,line}=item.data,key=`${part}:${line}`;
       if ((item!==anchor&&role!=='line')||!Number.isSafeInteger(part)||!Number.isSafeInteger(line)||!manifest.parts[part]?.lines[line]||nativeLines.has(key)) throw new Error('Ambiguous metric source line.');
       nativeLines.set(key,item.text);

package/dist/native-text-style.js

@@ -5,6 +5,18 @@ const boolean = value => ['1','true','on'].includes(value) ? true : ['0','false'
 
 const themeFamilies = context => ['a:majorFont', 'a:minorFont'].map(key => context.fonts?.[key]?.['a:latin']?.typeface?.trim().toLowerCase()).filter(Boolean);
 
+// A run painted with a bare theme slot (a:schemeClr, no color transform) remembers the slot as the OPF color name: the
+// transient `_opfScheme` marker is read, and always removed, by restoreRunColors (run-colors.js) once the document's own
+// colour scheme can confirm the slot holds that colour.
+const OPF_SLOTS = {dk1: 'dark1', lt1: 'light1', dk2: 'dark2', lt2: 'light2', hlink: 'hyperlink', folHlink: 'followedHyperlink', accent1: 'accent1', accent2: 'accent2', accent3: 'accent3', accent4: 'accent4', accent5: 'accent5', accent6: 'accent6'};
+function nativeSchemeSlot(fill, context) {
+  const node = fill?.['a:schemeClr'];
+  if (!node || Array.isArray(node) || Object.keys(fill).length !== 1 || Object.keys(node).some(key => key !== 'val') || typeof node.val !== 'string') return undefined;
+  // Own keys only: a slot name from the package (`__proto__`, `constructor`) must never reach an inherited property.
+  const mapping = context?.mapping, slot = mapping && Object.hasOwn(mapping, node.val) ? mapping[node.val] : node.val;
+  return typeof slot === 'string' && Object.hasOwn(OPF_SLOTS, slot) ? OPF_SLOTS[slot] : undefined;
+}
+
 export function nativeRunStyle(properties, context, relationships, report, kind = 'table') {
   const result = {};
   for (const [native, opf] of [['b','bold'], ['i','italic']]) {
@@ -42,7 +54,11 @@ export function nativeRunStyle(properties, context, relationships, report, kind
   }
   if (properties['a:solidFill']) {
     const color = readBackgroundColor(properties['a:solidFill'], context);
-    if (color) result.color = color.hex + (color.alpha < 1 ? Math.round(color.alpha * 255).toString(16).padStart(2, '0').toUpperCase() : '');
+    if (color) {
+      result.color = color.hex + (color.alpha < 1 ? Math.round(color.alpha * 255).toString(16).padStart(2, '0').toUpperCase() : '');
+      const slot = color.alpha === 1 ? nativeSchemeSlot(properties['a:solidFill'], context) : undefined;
+      if (slot) result._opfScheme = slot;
+    }
     else report(`unsupported-${kind}-text-color`, 'The native text color or its transforms could not be resolved.');
   } else if (properties['a:noFill']) {
     result.color = '#00000000';

package/dist/numbered-list.js

@@ -0,0 +1,114 @@
+// RR-33: numbered lists. OPF `numbering` (a style, a start and a suffix per list level) is written as native
+// `a:buAutoNum` and read back from it.
+//
+// Export: every marker line of a measured list is its own text box (see addMeasuredList), so each carries the number
+// core counted as `startAt`; there is nothing for PowerPoint to count across boxes.
+// Import: `a:buAutoNum` of a native paragraph is read with PowerPoint's own counting (consecutive paragraphs of one
+// level and one scheme count up from `startAt`; a paragraph of another scheme or start begins a new sequence; a
+// shallower or unnumbered paragraph ends the deeper sequences), then the numbers of the whole list are expressed as the
+// shortest `numbering` plus per-entry `start` values that reproduce them.
+
+const STYLES = ['arabic', 'roman-upper', 'roman-lower', 'alpha-upper', 'alpha-lower'];
+const STYLE_STEMS = {arabic: 'arabic', 'roman-upper': 'romanUc', 'roman-lower': 'romanLc', 'alpha-upper': 'alphaUc', 'alpha-lower': 'alphaLc'};
+const SUFFIX_TAILS = {period: 'Period', paren: 'ParenR', 'paren-both': 'ParenBoth'};
+
+/** The `a:buAutoNum@type` scheme of an OPF style and suffix. */
+export const autoNumScheme = (style, suffix = 'period') => `${STYLE_STEMS[style]}${SUFFIX_TAILS[suffix]}`;
+
+const SCHEMES = new Map(STYLES.flatMap(style => Object.keys(SUFFIX_TAILS).map(suffix => [autoNumScheme(style, suffix), {style, suffix}])));
+/** OPF style and suffix of a native scheme, or `undefined` for a scheme OPF has no equivalent for. */
+export const schemeNumbering = type => SCHEMES.get(type);
+
+/** `startAt` of a native auto-number: an integer from 1 to 32767, default 1. */
+export function autoNumStart(value) {
+  if (value === undefined || value === '') return 1;
+  const number = Number(value);
+  return Number.isInteger(number) && number >= 1 && number <= 32767 ? number : undefined;
+}
+
+/**
+ * The number each paragraph of one native shape displays, by PowerPoint's counting. `paragraphs` are
+ * `{level, autoNum?: {type, startAt}}`; returns the displayed numbers (`undefined` for an unnumbered paragraph).
+ */
+export function displayedNumbers(paragraphs) {
+  const sequences = [];
+  return paragraphs.map(paragraph => {
+    const level = Number.isInteger(paragraph.level) && paragraph.level >= 0 ? paragraph.level : 0;
+    if (!paragraph.autoNum) { sequences.length = Math.min(sequences.length, level); return undefined; }
+    const start = autoNumStart(paragraph.autoNum.startAt) ?? 1, type = paragraph.autoNum.type ?? 'arabicPeriod';
+    const current = sequences[level];
+    const value = current && current.type === type && current.start === start ? current.value + 1 : start;
+    sequences[level] = {type, start, value};
+    sequences.length = level + 1;
+    return value;
+  });
+}
+
+const entryOf = ({style, start, suffix}) => {
+  const fields = {...(style !== 'arabic' ? {style} : {}), ...(start !== 1 ? {start} : {}), ...(suffix !== 'period' ? {suffix} : {})};
+  const names = Object.keys(fields);
+  if (!names.length) return 'arabic';
+  return names.length === 1 && names[0] === 'style' ? style : fields;
+};
+
+/**
+ * The OPF numbering of a native list: `paragraphs` are `{level, number?: {type, value}}` in reading order (`number` is the
+ * displayed number and its scheme). Returns `{numbering, starts, diagnostics}`: `numbering` is the shortest authored form
+ * (`undefined` when the list is not numbered), `starts` maps a paragraph index to the entry `start` that restores its
+ * number, and `diagnostics` lists what could not be represented.
+ */
+export function deriveListNumbering(paragraphs) {
+  const diagnostics = [];
+  const numbered = paragraphs.filter(paragraph => paragraph.number);
+  if (!numbered.length) return {numbering: undefined, starts: new Map(), diagnostics};
+  if (numbered.length !== paragraphs.length) {
+    diagnostics.push({code: 'numbering-mixed', message: 'A list that mixes numbered and bulleted or plain paragraphs has no OPF equivalent (numbering applies to the whole list); it imports as bullets.'});
+    return {numbering: undefined, starts: new Map(), diagnostics};
+  }
+  const levels = [];
+  let unknown = false, mixedStyles = false;
+  for (const paragraph of numbered) {
+    const level = paragraph.level ?? 0;
+    const known = schemeNumbering(paragraph.number.type);
+    if (!known) { unknown = true; }
+    const resolved = known ?? {style: 'arabic', suffix: 'period'};
+    if (!levels[level]) levels[level] = {...resolved, start: paragraph.number.value};
+    else if (levels[level].style !== resolved.style || levels[level].suffix !== resolved.suffix) mixedStyles = true;
+  }
+  if (unknown) diagnostics.push({code: 'numbering-scheme-adapted', message: 'A native numbering scheme OPF has no equivalent for (an East Asian, Hebrew or Arabic scheme, or a bullet-only scheme) imports as arabic with a period.'});
+  if (mixedStyles) diagnostics.push({code: 'numbering-style-adapted', message: 'Entries of one list level use different native numbering schemes; OPF numbers a level in one style, so the first entry\'s style is used for the level.'});
+  const filled = [];
+  for (let level = 0; level < levels.length; level++) filled[level] = levels[level] ?? {...(filled[level - 1] ?? {style: 'arabic', suffix: 'period'}), start: 1};
+  // Per-entry starts: restart wherever the displayed number is not what counting gives.
+  const counters = [], starts = new Map();
+  paragraphs.forEach((paragraph, index) => {
+    const level = paragraph.level ?? 0, value = paragraph.number.value;
+    const natural = counters[level] === undefined ? filled[level].start : counters[level] + 1;
+    if (natural !== value) starts.set(index, value);
+    counters[level] = value;
+    counters.length = level + 1;
+  });
+  // The last entry repeats for deeper levels, so trailing equal entries are redundant.
+  const same = (a, b) => a.style === b.style && a.suffix === b.suffix && a.start === b.start;
+  while (filled.length > 1 && same(filled.at(-1), filled.at(-2))) filled.pop();
+  const entries = filled.map(entryOf);
+  return {numbering: entries.length === 1 ? entries[0] : entries, starts, diagnostics};
+}
+
+/** A canonical form of an authored `numbering`, for comparing two spellings of the same numbering. */
+export function canonicalNumbering(numbering) {
+  const list = Array.isArray(numbering) ? numbering : [numbering];
+  const resolved = list.map(entry => typeof entry === 'string' ? {style: entry, start: 1, suffix: 'period'} : {style: entry?.style ?? 'arabic', start: entry?.start ?? 1, suffix: entry?.suffix ?? 'period'});
+  while (resolved.length > 1 && JSON.stringify(resolved.at(-1)) === JSON.stringify(resolved.at(-2))) resolved.pop();
+  return JSON.stringify(resolved);
+}
+
+/**
+ * Add `autoNum` (the paragraph's `a:buAutoNum` attributes) and the displayed `number` ({type, value}) to the numbered
+ * paragraphs of one native shape. Paragraphs without a native auto-number are returned unchanged.
+ */
+export function withDisplayedNumbers(paragraphs) {
+  if (!paragraphs.some(paragraph => paragraph.autoNum)) return paragraphs;
+  const numbers = displayedNumbers(paragraphs);
+  return paragraphs.map((paragraph, index) => numbers[index] === undefined ? paragraph : {...paragraph, number: {type: paragraph.autoNum.type ?? 'arabicPeriod', value: numbers[index]}});
+}

package/dist/run-colors.js

@@ -0,0 +1,118 @@
+// Run colours named by a reference (RR-08).
+//
+// A TextRun colour may be a ColorRef: a `var:` variable, a colour-scheme slot ('accent2') or a role ('primary'). The
+// export resolves it (or writes the theme slot that holds the same colour) and PowerPoint has no field for the name, so
+// import used to return only the resolved hex. Two sources can name the reference again, and both are gated by the
+// imported document's own colour resolution: a name is restored only while it still resolves to the run's current colour,
+// so a colour edited in PowerPoint keeps its edited value and nothing is invented.
+//
+// 1. Provenance (full mode): OPF_SLIDE_V1 `colors` = {n, at: [[slot, reference], ...]}. The slots are the text runs of the
+//    slide's content in a fixed order (slideRunSlots: text runs, list item and description runs; regions by name, then
+//    blocks and groups in order, or the root payload). `n` is how many slots the authored slide had; the record is used only
+//    when the imported slide has exactly that many, so a run can never be matched to another. It holds reference names
+//    only, never words.
+// 2. A slide with no OPF record (plain PPTX): a run painted with a bare a:schemeClr (no colour transform) names that
+//    theme slot ('accent2', 'dark1', 'hyperlink'), restored when the document's colour scheme holds that exact colour for
+//    the slot. The exporter writes schemeClr only where the theme holds the colour, so this is the same convention.
+
+import {ROOT_PAYLOAD_FIELDS, REGION_KEYS} from './content-topology.js';
+
+const object = value => value !== null && typeof value === 'object' && !Array.isArray(value);
+const REGION_KEY_SET = new Set(REGION_KEYS);
+const isGroup = block => object(block) && (block.type === 'group' || (block.type === undefined && Array.isArray(block.blocks)));
+export const MAX_COLOR_SLOTS = 100000;
+
+// A reference name: the schema's ColorRef forms other than a hex literal.
+const REFERENCE = /^(?:var:[a-z][a-z0-9-]*|accent[1-6]|dark[12]|light[12]|hyperlink|followedHyperlink|primary|secondary|accent|background|surface|text|textSecondary)$/;
+export const isColorReference = value => typeof value === 'string' && REFERENCE.test(value);
+
+/** The payload objects of a slide in the fixed traversal order: regions (by name), else blocks (groups depth first), else the slide's root payload. */
+function* leaves(slide) {
+  const walk = function* (block) {
+    if (!object(block)) return;
+    if (isGroup(block)) { for (const child of Array.isArray(block.blocks) ? block.blocks : []) yield* walk(child); return; }
+    yield block;
+  };
+  const regions = Object.keys(slide).filter(key => REGION_KEY_SET.has(key) && object(slide[key])).sort();
+  if (regions.length) { for (const key of regions) yield* walk(slide[key]); return; }
+  if (Array.isArray(slide.blocks)) { for (const block of slide.blocks) yield* walk(block); return; }
+  yield slide;
+}
+
+/** The text runs of the slide's text and list payloads, in order: an object (a run) or null (a plain string). */
+export function slideRunSlots(slide) {
+  const slots = [];
+  const runs = value => {
+    if (Array.isArray(value)) for (const run of value) slots.push(object(run) ? run : null);
+    else if (typeof value === 'string') slots.push(null);
+  };
+  for (const leaf of leaves(slide)) {
+    for (const field of ROOT_PAYLOAD_FIELDS) {
+      const value = leaf[field];
+      if (field === 'text') { if (Array.isArray(value)) runs(value); }
+      else if ((field === 'items' || field === 'bullets') && Array.isArray(value)) {
+        for (const item of value) {
+          if (Array.isArray(item) || typeof item === 'string') runs(item);
+          else if (object(item)) { runs(item.text); runs(item.description); }
+        }
+      }
+    }
+  }
+  return slots;
+}
+
+/** The record stored for an authored slide, or undefined when no run names a reference. */
+export function runColorRecord(slide) {
+  const slots = slideRunSlots(slide);
+  if (slots.length > MAX_COLOR_SLOTS) return undefined;
+  const at = [];
+  slots.forEach((run, index) => { if (run && isColorReference(run.color)) at.push([index, run.color]); });
+  return at.length ? {n: slots.length, at} : undefined;
+}
+
+/** Throws when `value` is not a well-formed colours record. */
+export function validateRunColors(value) {
+  if (!object(value) || !Number.isSafeInteger(value.n) || value.n < 1 || value.n > MAX_COLOR_SLOTS || !Array.isArray(value.at) || !value.at.length || value.at.length > value.n) throw Error('Invalid run colours record.');
+  let previous = -1;
+  for (const entry of value.at) {
+    if (!Array.isArray(entry) || entry.length !== 2 || !Number.isSafeInteger(entry[0]) || entry[0] <= previous || entry[0] >= value.n || !isColorReference(entry[1])) throw Error('Invalid run colour entry.');
+    previous = entry[0];
+  }
+  return value;
+}
+
+function* markedRuns(value) {
+  if (Array.isArray(value)) { for (const item of value) yield* markedRuns(item); return; }
+  if (!object(value)) return;
+  if (Object.hasOwn(value, '_opfScheme')) yield value;
+  for (const item of Object.values(value)) if (item !== null && typeof item === 'object') yield* markedRuns(item);
+}
+
+/**
+ * Restore run colour references on `slides` (the imported document's slides). `info[i]` is
+ * {record, structure, content}: the stored OPF_SLIDE_V1 value, whether the slide's arrangement matches it and whether its
+ * content structure was restored from it, or undefined for an untagged slide. `resolve(slide, name)` returns the '#RRGGBB'
+ * the name resolves to in the document (or undefined). Every transient `_opfScheme` marker is removed.
+ */
+export function restoreRunColors(slides, info, resolve, report) {
+  slides.forEach((slide, index) => {
+    const tag = info[index];
+    const marked = [...markedRuns(slide)];
+    const restoreName = (run, name) => {
+      const hex = typeof run.color === 'string' && /^#[0-9a-f]{6}$/i.test(run.color) ? run.color.toUpperCase() : undefined;
+      if (hex && resolve(slide, name)?.toUpperCase() === hex) run.color = name;
+    };
+    if (tag?.record?.colors) {
+      const {n, at} = tag.record.colors;
+      // When the content form was not restored its own diagnostic says why, and the slots cannot be aligned.
+      if (tag.structure && tag.content) {
+        const slots = slideRunSlots(slide);
+        if (slots.length !== n) report({code: 'color-reference-changed', path: `slides.${index}`, message: `The slide's text runs no longer match the stored colour references (${slots.length} runs now, ${n} at export), so the named run colours of slides.${index} (variables, scheme slots and roles) were not restored; the runs keep their resolved colours.`});
+        else for (const [slot, name] of at) if (slots[slot]) restoreName(slots[slot], name);
+      }
+    } else if (!tag?.record) {
+      for (const run of marked) if (typeof run._opfScheme === 'string') restoreName(run, run._opfScheme);
+    }
+    for (const run of marked) delete run._opfScheme;
+  });
+}

package/dist/script-fonts.js

@@ -13,6 +13,9 @@
 import * as opfCore from "@openpresentation/opf";
 
 const resolver = typeof opfCore.resolveScriptFonts === "function" ? opfCore.resolveScriptFonts : null;
+// RR-05: authored alignment is logical for right-to-left text (`left` is the start edge). Core owns the rule; a core without it
+// reports no line directions either, so the fallback never has anything to flip.
+export const physicalAlignment = typeof opfCore.physicalAlignment === "function" ? opfCore.physicalAlignment : alignment => alignment;
 // The one paragraph-direction rule shared with the renderer (core FF-07).
 const paragraphDirection = typeof opfCore.paragraphDirection === "function" ? opfCore.paragraphDirection : null;
 
@@ -126,24 +129,89 @@ const decodeText = value => value.replace(/&(?:#(\d+)|#x([0-9a-f]+)|(amp|lt|gt|q
   decimal ? String.fromCodePoint(Number(decimal)) : hex ? String.fromCodePoint(parseInt(hex, 16)) : {amp: "&", lt: "<", gt: ">", quot: "\"", apos: "'"}[name.toLowerCase()]);
 
 /**
- * In a right-to-left deck every paragraph states its direction from core's
- * paragraphDirection() over its own text: rtl="1" when it is right-to-left,
- * else an explicit rtl="0", because the master default levels start
- * right-to-left. Alignment is left as composed.
+ * RR-05 bidi runs. PowerPoint treats the digits of a run tagged with a right-to-left language as numbers of that language and
+ * orders them as their own item, so "v2.0" or "PowerPoint 365" inside an Arabic or Hebrew run reads "2.0v" or "365PowerPoint".
+ * Splitting each left-to-right Latin phrase into its own run tagged en-US keeps it one item that PowerPoint orders left to right.
  */
-function paragraphRtl(xml, deckDirection) {
+const LATIN_WORD = /[0-9\p{Script=Latin}]/u, LATIN_LETTER = /\p{Script=Latin}/u, PHRASE_JOINER = /[ \u00a0.,:;&'\u2019/+*_@#=-]/;
+
+/** Ranges [start, end) of the Latin phrases of a decoded string: a Latin letter through the last Latin letter or digit joined by spaces and word punctuation. */
+export function latinPhrases(text) {
+  const ranges = [];
+  for (let index = 0; index < text.length;) {
+    const char = String.fromCodePoint(text.codePointAt(index));
+    if (!LATIN_LETTER.test(char)) { index += char.length; continue; }
+    let end = index + char.length;
+    for (let cursor = end; cursor < text.length;) {
+      const next = String.fromCodePoint(text.codePointAt(cursor));
+      if (LATIN_WORD.test(next)) { cursor += next.length; end = cursor; continue; }
+      if (!PHRASE_JOINER.test(next)) break;
+      // Joiners count only when a Latin letter or digit follows them directly.
+      let after = cursor + next.length;
+      while (after < text.length && PHRASE_JOINER.test(text[after])) after += 1;
+      if (after < text.length && LATIN_WORD.test(String.fromCodePoint(text.codePointAt(after)))) cursor = after; else break;
+    }
+    ranges.push([index, end]);
+    index = end;
+  }
+  return ranges;
+}
+
+const encodeText = value => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+const RUN = /<a:r>(<a:rPr\b[^>]*\/>|<a:rPr\b[^>]*[^/]>[\s\S]*?<\/a:rPr>)<a:t>([^<]*)<\/a:t><\/a:r>/g;
+
+/** Split the runs of a right-to-left paragraph so each Latin phrase is its own en-US run. */
+function splitLatinRuns(body) {
+  return body.replace(RUN, (run, properties, escaped) => {
+    const text = decodeText(escaped), phrases = latinPhrases(text);
+    if (!phrases.length) return run;
+    const make = (value, lang) => `<a:r>${lang ? properties.replace(/\slang="[^"]*"/, ` lang="${lang}"`) : properties}<a:t>${encodeText(value)}</a:t></a:r>`;
+    const pieces = [];
+    let cursor = 0;
+    for (const [from, to] of phrases) {
+      if (from > cursor) pieces.push(make(text.slice(cursor, from)));
+      pieces.push(make(text.slice(from, to), "en-US"));
+      cursor = to;
+    }
+    if (cursor < text.length) pieces.push(make(text.slice(cursor)));
+    return pieces.join("");
+  });
+}
+
+/**
+ * In a right-to-left deck every paragraph states its direction. The writers mark the lines of a paragraph they laid out
+ * (rtl="1", the direction core computed once for the whole paragraph, so wrapped lines never differ); any other paragraph takes
+ * core's paragraphDirection() over its own text: rtl="1" when it is right-to-left, else an explicit rtl="0", because the master
+ * default levels start right-to-left. A right-to-left paragraph with no explicit alignment starts at the right edge (logical
+ * alignment: the master default is left), and its Latin phrases become en-US runs (see splitLatinRuns). With `notes` the
+ * alignment is also set on an explicit left paragraph, because the notes writers pass no alignment of their own.
+ */
+function paragraphRtl(xml, deckDirection, {notes = false} = {}) {
   return xml.replace(/<a:p>([\s\S]*?)<\/a:p>/g, (paragraph, body) => {
     const text = [...body.matchAll(/<a:t>([^<]*)<\/a:t>|<a:br\b/g)].map(match => match[1] === undefined ? "\n" : decodeText(match[1])).join("");
-    const value = paragraphDirection(text, deckDirection) === "rtl" ? "1" : "0";
     const properties = /^(\s*)<a:pPr\b([^>]*?)(\/?)>/.exec(body);
-    if (!properties) return `<a:p><a:pPr rtl="${value}"/>${body}</a:p>`;
-    const attributes = / rtl="[^"]*"/.test(properties[2]) ? properties[2].replace(/ rtl="[^"]*"/, ` rtl="${value}"`) : `${properties[2]} rtl="${value}"`;
+    const marked = properties && / rtl="([01])"/.exec(properties[2]);
+    const rtl = marked ? marked[1] === "1" : paragraphDirection(text, deckDirection) === "rtl";
+    const value = rtl ? "1" : "0";
+    if (rtl) body = splitLatinRuns(body);
+    if (!properties) return `<a:p><a:pPr rtl="${value}"${rtl ? " algn=\"r\"" : ""}/>${body}</a:p>`;
+    let attributes = / rtl="[^"]*"/.test(properties[2]) ? properties[2].replace(/ rtl="[^"]*"/, ` rtl="${value}"`) : `${properties[2]} rtl="${value}"`;
+    if (rtl) {
+      if (!/\salgn="/.test(attributes)) attributes += " algn=\"r\"";
+      else if (notes) attributes = attributes.replace(/ algn="l"/, " algn=\"r\"");
+    }
     return `<a:p>${properties[1]}<a:pPr${attributes}${properties[3]}>${body.slice(properties[0].length)}</a:p>`;
   });
 }
 
-/** Master, layout and presentation default paragraph levels start right-to-left. */
-const levelRtl = xml => xml.replace(/(<a:(?:lvl\dpPr|defPPr)\b[^>]*?\srtl=")0(")/g, "$11$2");
+/** Tables of a right-to-left deck run right to left: the first column is the rightmost, as core's layout draws it. */
+const tableRtl = xml => xml.replace(/<a:tblPr\b([^>]*?)(\/?)>/g, (match, attributes, close) => / rtl="/.test(attributes) ? match : `<a:tblPr rtl="1"${attributes}${close}>`);
+
+/**
+ * Master, layout and presentation default paragraph levels start right-to-left, and a left-aligned level starts at the right edge
+ * (logical alignment): text typed later in an Arabic or Hebrew deck then reads and aligns as the exported slides do.
+ */
+const levelRtl = xml => xml.replace(/<a:(?:lvl\dpPr|defPPr)\b[^>]*?\srtl="0"[^>]*>/g, level => level.replace(/\srtl="0"/, " rtl=\"1\"").replace(/\salgn="l"/, " algn=\"r\""));
 
 /**
  * Apply the plan to one generated XML part. `slideIndex` names the slide a
@@ -157,10 +225,10 @@ export function partScriptFonts(path, xml, plan, slideIndex) {
   if (/^ppt\/slides\/slide\d+\.xml$/.test(path)) {
     xml = xml.replace(/<p:(sp|graphicFrame)>[\s\S]*?<\/p:\1>/g, shape =>
       runScriptFonts(shape, resolved, /<p:cNvPr\b[^>]*\bname="OPF heading /.test(shape)));
-    if (plan.rtl) xml = paragraphRtl(xml, plan.deck.direction);
+    if (plan.rtl) xml = tableRtl(paragraphRtl(xml, plan.deck.direction));
   } else if (/^ppt\/(?:charts\/chart(?:Ex)?|notesSlides\/notesSlide)\d+\.xml$/.test(path)) {
     xml = runScriptFonts(xml, resolved, false);
-    if (plan.rtl && path.startsWith("ppt/notesSlides/")) xml = paragraphRtl(xml, plan.deck.direction);
+    if (plan.rtl && path.startsWith("ppt/notesSlides/")) xml = paragraphRtl(xml, plan.deck.direction, {notes: true});
   } else if (plan.rtl && /^ppt\/(?:slideMasters\/slideMaster\d+|slideLayouts\/slideLayout\d+|notesMasters\/notesMaster\d+|presentation)\.xml$/.test(path)) {
     xml = levelRtl(xml);
   }
@@ -252,6 +320,12 @@ export function reconcileLanguage(groups, observed, report) {
  * language, and theme East Asian/complex-script fonts the document does not
  * reproduce.
  */
+/** Whether the language observed in the runs is written right to left. */
+export function observedRtl(observed) {
+  if (observed.lang === undefined) return false;
+  try { return resolver ? resolver({language: observed.language}).rtl === true : observed.match?.record.direction === "rtl"; } catch { return false; }
+}
+
 export function languageDiagnostics(imported, observed, report) {
   if (!report) return;
   const {lang, match, ranked, rtlParagraphs, theme} = observed;
@@ -259,9 +333,11 @@ export function languageDiagnostics(imported, observed, report) {
     if (rtlParagraphs) report({code: "rtl-language-mismatch", path: "language", message: `${rtlParagraphs} right-to-left paragraph(s) carry no run language, so no presentation language was imported.`});
     return;
   }
-  if (ranked.length > 1) {
+  // RR-05: a right-to-left deck's Latin phrases are their own en-US runs; they are not a second presentation language.
+  const languages = observedRtl(observed) ? ranked.filter(([tag]) => tag === lang || tag !== "en-US") : ranked;
+  if (languages.length > 1) {
     report({code: "mixed-run-languages", path: "language",
-      message: `Runs use ${ranked.length} languages (${ranked.map(([tag, count]) => `${tag} x${count}`).join(", ")}). OPF has one presentation language, so ${lang} was imported.`});
+      message: `Runs use ${languages.length} languages (${languages.map(([tag, count]) => `${tag} x${count}`).join(", ")}). OPF has one presentation language, so ${lang} was imported.`});
   }
   const kept = imported.language === observed.language;
   if (kept && !match) report({code: "language-uncatalogued", path: "language", message: `Run language ${lang} matches no languages catalog record; it was imported as a BCP-47 tag.`});

package/dist/table-cell-import.js

@@ -63,7 +63,9 @@ export function nativeCellStyle(properties, body, context, scale, report) {
   const listStyle = drawingObject(child(body,'a:lstStyle'));
   const alignments = nodes(body,'a:p').map(paragraph => {
     const p = drawingObject(paragraph['a:p'])['a:pPr'] ?? {};
-    return p.algn ?? listStyle[`a:lvl${Number(p.lvl ?? 0)+1}pPr`]?.algn ?? listStyle['a:defPPr']?.algn ?? 'l';
+    const algn = p.algn ?? listStyle[`a:lvl${Number(p.lvl ?? 0)+1}pPr`]?.algn ?? listStyle['a:defPPr']?.algn ?? 'l';
+    // Alignment is logical for right-to-left text (RR-05): an rtl paragraph aligned right starts at the start edge.
+    return p.rtl === '1' || p.rtl === 1 ? ({l:'r',r:'l'}[algn] ?? algn) : algn;
   });
   const alignment = {l:'left',ctr:'center',r:'right'}[alignments[0] ?? 'l'];
   if (alignment) style.align = alignment;

package/dist/table-import.js

@@ -121,7 +121,7 @@ function conditionalProperties(style, properties, row, column, rowCount, columnC
 
 // Use the same direct graphic-frame ordering as the slide collector. The ordered
 // reader retains interleaved runs, fields, breaks, empty paragraphs and spaces.
-export function importTableFrames(slidePath, archive, relationships, report, dimensions) {
+export function importTableFrames(slidePath, archive, relationships, report, dimensions, {rtlDeck = false} = {}) {
   const context = readSlideTheme(slidePath, archive);
   const scale = Math.min(dimensions.widthInches,dimensions.heightInches) * 96 / 720;
   const root = child(context.parsedPart(slidePath)?.tree, 'p:sld');
@@ -133,7 +133,8 @@ export function importTableFrames(slidePath, archive, relationships, report, dim
     const style = tableStyle(props, archive, context, (code, message) => report(frameIndex, '', code, message));
     if (style?.['a:tblBg']) report(frameIndex, '', 'unsupported-table-cell-style', 'The native table style background is not represented; supported character styles are retained.');
     const properties = attrs(table, 'a:tblPr');
-    if (boolean(properties.rtl) === true) report(frameIndex, '', 'unsupported-table-direction', 'Right-to-left table geometry is not represented; cells retain native source order.');
+    // A right-to-left table of a right-to-left deck keeps its logical column order (RR-05); the deck language carries the direction.
+    if (boolean(properties.rtl) === true && !rtlDeck) report(frameIndex, '', 'unsupported-table-direction', 'Right-to-left table geometry is not represented; cells retain native source order.');
     const headers = boolean(properties.firstRow) === true;
     const nativeRows = nodes(table, 'a:tr');
     const columnCount = nodes(child(table, 'a:tblGrid'), 'a:gridCol').length;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf-pptx",
-  "version": "0.11.9",
+  "version": "0.12.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/svg-image.js && node --check test/svg-image.mjs && node --check test/native-svg-decks.mjs && 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 src/native-furniture.js && node --check test/native-furniture.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 && node --check src/import-signals.js && node --check test/import-signals.mjs && node --check test/signals-deck.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/svg-image.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 && node test/import-signals.mjs && npm run test:timeline && npm run test:determinism",
+    "typecheck": "node --check src/index.js && node --check src/annotation-export.js && node --check src/annotation-provenance.js && node --check test/annotations.mjs && node --check test/region-reading-order.mjs && node --check test/symbol-fonts.mjs && node --check test/math-emoji.mjs && node --check src/svg-image.js && node --check test/svg-image.mjs && node --check test/native-svg-decks.mjs && node --check src/chart-types.js && node --check src/chartex.js && node --check src/chart-options.js && node --check test/chart-options.mjs && 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/single-series-colour.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 src/native-furniture.js && node --check test/native-furniture.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/rtl-layout.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 src/run-colors.js && node --check test/hard-line-breaks.mjs && node --check test/import-details.mjs && node --check test/list-shape-names.mjs && node --check src/numbered-list.js && node --check test/numbered-lists.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 && node --check src/import-signals.js && node --check test/import-signals.mjs && node --check test/signals-deck.mjs && node --check test/rr-07-preview-polish.mjs && node --check scripts/rr07-native-set.mjs",
+    "test": "npm run build && node test/annotations.mjs && node test/region-reading-order.mjs && node test/symbol-fonts.mjs && node test/math-emoji.mjs && node test/chart-types.mjs && node test/chartex.mjs && node test/chart-options.mjs && node test/chart-text-size.mjs && node test/zip-date.mjs && node test/background-fills.mjs && node test/rr-07-preview-polish.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/rtl-layout.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/single-series-colour.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/svg-image.mjs && node test/background-colorref.mjs && node test/import-fabrications.mjs && node test/hard-line-breaks.mjs && node test/import-details.mjs && node test/list-shape-names.mjs && node test/numbered-lists.mjs && node test/shared-quote.mjs && node test/quote-provenance.mjs && node test/import-signals.mjs && npm run test:timeline && npm run test:determinism && node test/template-variables.mjs",
     "validate": "node scripts/validate-package.mjs",
     "test:packed": "node test/packed-install.mjs && node test/provenance-interop.mjs",
     "test:compare-published": "node test/compare-published.mjs",
@@ -61,14 +61,14 @@
     "test:determinism": "node test/determinism.mjs"
   },
   "dependencies": {
-    "@openpresentation/opf": "^0.11.4",
+    "@openpresentation/opf": "^0.12.0",
     "fast-xml-parser": "^5.8.0",
     "fflate": "^0.8.3",
     "jszip": "3.10.2",
     "sharp": "0.35.4"
   },
   "peerDependencies": {
-    "@openpresentation/opf-render": "^0.11.0"
+    "@openpresentation/opf-render": "^0.12.0"
   },
   "peerDependenciesMeta": {
     "@openpresentation/opf-render": {
@@ -77,7 +77,7 @@
   },
   "devDependencies": {
     "@expo-google-fonts/carlito": "0.4.1",
-    "@openpresentation/opf-render": "0.11.9",
+    "@openpresentation/opf-render": "0.12.0",
     "esbuild": "0.28.2",
     "playwright": "1.63.0"
   },