@openpresentation/opf-pptx 0.5.2 → 0.7.0

package/README.md

@@ -2,9 +2,11 @@
 
 Pure local PowerPoint conversion tooling for Open Presentation Format documents. This repo owns the Phase 3 and Phase 4 toolkit lanes: OPF to PPTX export and PPTX to OPF import.
 
+Version 0.7.0's [shared-code integration](docs/code-roundtrip.md) preserves exact source/metadata through guarded native tags and editable lines. XML-forbidden code characters reject export with `invalid-code-text`, the OPF field path and UTF-16 offset; schema validation alone does not establish XML representability. Native source recovery does not reconstruct formatting, geometry or font theme.
+
 ## Scope
 
-Version 0.5.2 improves native metrics, quotes, code panels, timelines and chart-label contrast, with renderer 0.5.1 compatibility and fitted quote footer separation. See [native content evidence and limitations](docs/native-content-candidate.md). Native chart geometry and general scalar-text wrapping remain different from preview; editability and valid reimport do not establish raster equivalence.
+Version 0.7.0 requires core 0.9.0 and uses renderer 0.7.0 for coordinated preview/font measurement. Quotes and code export their accepted internal lines and styles without another fitting pass. [Controlled Windows PowerPoint quote evidence](docs/evidence/shared-quote-integration/comparison.json) records glyph containment, separation, save/reopen and text reimport against its exact source/font hashes. Native quote import returns editable text blocks and does not restore the original OPF quote structure, typography or readability policy. Native chart geometry and general scalar-text wrapping also remain different from preview; editability and valid reimport do not establish raster equivalence.
 
 - Package: `@openpresentation/opf-pptx`
 - Repository: `OpenPresentation/opf-pptx`

package/dist/code-provenance.js

@@ -0,0 +1,171 @@
+import { XMLParser } from 'fast-xml-parser';
+
+// Native shape tags are standard PresentationML customer data. Uppercase hex
+// protects case-sensitive source from PowerPoint's case-insensitive Tags API.
+const TAG = 'OPF_CODE_V1';
+const REL = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/tags';
+const NS = 'http://schemas.openxmlformats.org/presentationml/2006/main';
+const enc = new TextEncoder(), dec = new TextDecoder('utf-8', {fatal:true});
+const parser = new XMLParser({ignoreAttributes:false, attributeNamePrefix:'', parseTagValue:false, trimValues:false});
+const ordered = new XMLParser({ignoreAttributes:false, attributeNamePrefix:'', parseTagValue:false, trimValues:false, preserveOrder:true});
+const array = value => value === undefined ? [] : Array.isArray(value) ? value : [value];
+const hex = value => [...enc.encode(JSON.stringify(value))].map(byte=>byte.toString(16).padStart(2,'0')).join('').toUpperCase();
+function unhex(value) {
+  if (typeof value !== 'string' || !/^(?:[0-9A-Fa-f]{2})+$/.test(value)) throw new Error('Invalid code tag encoding.');
+  return JSON.parse(dec.decode(Uint8Array.from(value.match(/../g),byte=>parseInt(byte,16))));
+}
+
+export function codeManifest(value, layout, group) {
+  return {v:1, group, role:'panel', value, parts:layout.parts.map(part=>({role:part.role, generated:part.generated === true,
+    lines:part.fit.sourceLines.map(({start,end,nextStart,boundary})=>({start,end,nextStart,boundary}))}))};
+}
+
+export function attachCodeTags(entries, records) {
+  if (!records.size) return;
+  let count = 0;
+  const seen = new Set(), types = [];
+  for (const path of Object.keys(entries).filter(path=>/^ppt\/slides\/slide\d+\.xml$/.test(path)).sort()) {
+    const relPath = path.replace('/slides/','/slides/_rels/') + '.rels';
+    let rels = dec.decode(entries[relPath]);
+    const ids = new Set([...rels.matchAll(/\bId="([^"]+)"/g)].map(match=>match[1]));
+    const xml = dec.decode(entries[path]).replace(/<p:sp>[\s\S]*?<\/p:sp>/g, shape=>{
+      const name = shape.match(/<p:cNvPr\b[^>]*\bname="([^"]+)"/)?.[1];
+      if (!records.has(name)) return shape;
+      if (seen.has(name)) throw new Error('Duplicate generated code shape.');
+      seen.add(name);
+      const part = `ppt/tags/opfCode${++count}.xml`;
+      let id = `rIdOpfCode${count}`;
+      while (ids.has(id)) id += '_';
+      ids.add(id);
+      entries[part] = enc.encode(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?><p:tagLst xmlns:p="${NS}"><p:tag name="${TAG}" val="${hex(records.get(name))}"/></p:tagLst>`);
+      types.push(`<Override PartName="/${part}" ContentType="application/vnd.openxmlformats-officedocument.presentationml.tags+xml"/>`);
+      rels = rels.replace('</Relationships>',`<Relationship Id="${id}" Type="${REL}" Target="../tags/opfCode${count}.xml"/></Relationships>`);
+      shape = shape.replace(/<p:nvPr\s*\/>/,'<p:nvPr></p:nvPr>');
+      if (!shape.includes('</p:nvPr>')) throw new Error('Generated code shape has no native application properties.');
+      return shape.replace('</p:nvPr>',`<p:custDataLst><p:tags r:id="${id}"/></p:custDataLst></p:nvPr>`);
+    });
+    entries[path] = enc.encode(xml);
+    entries[relPath] = enc.encode(rels);
+  }
+  if (seen.size !== records.size) throw new Error('Missing generated code shapes.');
+  entries['[Content_Types].xml'] = enc.encode(dec.decode(entries['[Content_Types].xml']).replace('</Types>',types.join('')+'</Types>'));
+}
+
+const children = (nodes, name) => array(nodes).flatMap(node=>node[name] === undefined ? [] : [node[name]]);
+const plainText = nodes => array(nodes).map(node=>node['#text'] ?? '').join('');
+export const nativeTextShapes = tree => [...array(tree?.['p:sp']),...array(tree?.['p:grpSp']).flatMap(nativeTextShapes)];
+const orderedShapes = tree => [...children(tree,'p:sp'),...children(tree,'p:grpSp').flatMap(orderedShapes)];
+// Preserve the order of runs, fields and explicit line breaks. A keyed XML
+// object groups all a:r before a:fld and cannot represent their original order.
+export function nativeShapeParagraphs(xml) {
+  const root = children(ordered.parse(xml),'p:sld')[0];
+  const tree = children(children(root,'p:cSld')[0],'p:spTree')[0];
+  return orderedShapes(tree).map(shape=>children(children(shape,'p:txBody')[0],'a:p').map(paragraph=>{
+    let text = '', maxFontSize = 0, bullet = false, level = 0;
+    for (const child of paragraph) {
+      if (child['a:br'] !== undefined) text += '\n';
+      for (const key of ['a:r','a:fld']) if (child[key] !== undefined) {
+        text += children(child[key],'a:t').map(plainText).join('');
+        for (const run of child[key]) {
+          const size = Number(run[':@']?.sz);
+          if (run['a:rPr'] !== undefined && Number.isFinite(size)) maxFontSize = Math.max(maxFontSize,size/100);
+        }
+      }
+      if (child['a:pPr'] !== undefined) {
+        level = Number(child[':@']?.lvl ?? 0);
+        bullet = child['a:pPr'].some(node=>node['a:buChar'] !== undefined || node['a:buAutoNum'] !== undefined);
+      }
+    }
+    return {text,maxFontSize,bullet,level};
+  }));
+}
+
+function sourceFor(value, role, generated) {
+  if (generated) return 'code';
+  if (role === 'body') return typeof value === 'string' ? value : value.source;
+  return value[role];
+}
+
+function validateManifest(manifest) {
+  const {value,parts} = manifest;
+  const object = value && typeof value === 'object' && !Array.isArray(value);
+  if (typeof value !== 'string' && (!object || typeof value.source !== 'string' || Object.keys(value).some(key=>!['source','filename','language'].includes(key)) || ['filename','language'].some(key=>value[key] !== undefined && typeof value[key] !== 'string'))) throw new Error('Invalid source value.');
+  // Empty metadata is preserved in the manifest but does not produce a label.
+  const roles = [...(object && value.filename ? ['filename'] : []), ...(object && value.language ? ['language'] : []), 'body'];
+  if (roles.length === 1) roles.unshift('language');
+  if (!Array.isArray(parts) || parts.length !== roles.length) throw new Error('Invalid code parts.');
+  parts.forEach((part,i)=>{
+    const generated = roles.length === 2 && roles[0] === 'language' && !(object && (value.filename || value.language)) && i === 0;
+    if (part.role !== roles[i] || part.generated !== generated || !Array.isArray(part.lines) || !part.lines.length) throw new Error('Invalid source part.');
+    const source = sourceFor(value,part.role,generated);
+    let cursor = 0;
+    part.lines.forEach((line,index)=>{
+      if (![line.start,line.end,line.nextStart].every(Number.isSafeInteger) || line.start !== cursor || line.end < line.start || line.nextStart < line.end || line.nextStart > source.length) throw new Error('Invalid source range.');
+      const separator = source.slice(line.end,line.nextStart);
+      const last = index === part.lines.length - 1;
+      if (/\r|\n/.test(source.slice(line.start,line.end)) || (line.boundary === 'hard' ? !/^(?:\r\n|\r|\n)$/.test(separator) || last : separator !== '' || line.boundary !== (last ? 'end' : 'soft'))) throw new Error('Invalid source boundary.');
+      cursor = line.nextStart;
+    });
+    if (cursor !== source.length) throw new Error('Incomplete source range.');
+  });
+}
+
+// Only complete, unambiguous sets are coalesced. Visible text always wins over
+// old source text; metadata supplies only source boundaries and payload roles.
+export function importCodeGroups(shapes, paragraphs, relationships, entries, report) {
+  const groups = new Map(), consumed = new Set(), items = [], tagCounts = new Map();
+  for (const [index,shape] of shapes.entries()) {
+    const links = array(shape['p:nvSpPr']?.['p:nvPr']?.['p:custDataLst']?.['p:tags']);
+    for (const link of links) {
+      const rel = relationships.get(link['r:id']);
+      if (rel?.type !== REL || rel.targetMode === 'External' || !rel.path || !entries[rel.path]) continue;
+      let tags;
+      try { tags = array(parser.parse(dec.decode(entries[rel.path]))['p:tagLst']?.['p:tag']).filter(tag=>tag.name?.toUpperCase() === TAG); }
+      catch { report({code:'invalid-code-provenance',message:'Unreadable code tags; visible native shapes were retained.'}); continue; }
+      for (const tag of tags) {
+        tagCounts.set(shape,(tagCounts.get(shape) ?? 0)+1);
+        try {
+          const data = unhex(tag.val);
+          if (data.v !== 1 || typeof data.group !== 'string' || !/^\d+$/.test(data.group)) throw new Error('Invalid code identity.');
+          const group = groups.get(data.group) ?? [];
+          group.push({data,shape,index,text:paragraphs[index].map(p=>p.text).join('\n')});groups.set(data.group,group);
+        } catch { report({code:'invalid-code-provenance',message:'Invalid code tags; visible native shapes were retained.'}); }
+      }
+    }
+  }
+  for (const group of groups.values()) {
+    try {
+      if (group.some(item=>tagCounts.get(item.shape)!==1)) throw new Error('Multiple source identities on one shape.');
+      const panels = group.filter(item=>item.data.role === 'panel');
+      if (panels.length !== 1 || panels[0].text !== '') throw new Error('Missing, duplicated or edited panel.');
+      const panel = panels[0], manifest = panel.data;
+      validateManifest(manifest);
+      const expectedCount = 1 + manifest.parts.reduce((sum,part)=>sum+part.lines.length,0);
+      if (group.length !== expectedCount || new Set(group.map(item=>item.shape)).size !== group.length) throw new Error('Incomplete or duplicated code shapes.');
+      const nativeLines = new Map();
+      for (const item of group) if (item !== panel) {
+        const {role,part,line} = item.data, key = `${part}:${line}`;
+        if (role !== 'line' || !Number.isSafeInteger(part) || !Number.isSafeInteger(line) || !manifest.parts[part]?.lines[line] || nativeLines.has(key)) throw new Error('Ambiguous source line.');
+        nativeLines.set(key,item.text);
+      }
+      const value = typeof manifest.value === 'string' ? {source:manifest.value} : {...manifest.value};
+      for (const [partIndex,part] of manifest.parts.entries()) {
+        const source = sourceFor(manifest.value,part.role,part.generated), newline = source.match(/\r\n|\r|\n/)?.[0] ?? '\n';
+        let rebuilt = '';
+        for (const [lineIndex,line] of part.lines.entries()) {
+          const actual = nativeLines.get(`${partIndex}:${lineIndex}`);
+          if (actual === undefined) throw new Error('Missing source line.');
+          if (part.generated && actual !== source.slice(line.start,line.end)) throw new Error('Generated label was edited.');
+          rebuilt += actual.replace(/\r\n|\r|\n/g,newline) + source.slice(line.end,line.nextStart);
+        }
+        if (!part.generated) value[part.role === 'body' ? 'source' : part.role] = rebuilt;
+      }
+      for (const item of group) consumed.add(item.shape);
+      items.push({shape:panel.shape,payload:{type:'code',code:typeof manifest.value === 'string' ? value.source : value}});
+      report({code:'code-import-reflow',message:'Code source boundaries and native text were recovered. Native positioning, formatting and font theme are not reconstructed; review the reflowed OPF.'});
+    } catch (error) {
+      report({code:'invalid-code-provenance',message:`${error.message} Visible native shapes were retained without restoring old source text.`});
+    }
+  }
+  return {consumed,items};
+}

package/dist/index.d.ts

@@ -48,7 +48,7 @@ export interface ToPptxOptions {
 }
 
 export interface FromPptxOptions {
-  /** Reports native background, picture and table details that OPF import cannot preserve. Table paths identify the native graphic-frame and row/cell indexes (including headers). */
+  /** Reports native details that import cannot preserve, including code provenance fallback/reflow and grouped text transforms. Table paths identify native frame and row/cell indexes (including headers). */
   onDiagnostic?: (diagnostic: {code: string; path: string; message: string}) => void;
   fallbackName?: string;
   schema?: string;

package/dist/index.js

@@ -1,4 +1,5 @@
 import {importTableFrames} from './table-import.js';
+import {attachCodeTags, codeManifest, importCodeGroups, nativeShapeParagraphs, nativeTextShapes} from './code-provenance.js';
 import {importImageOrientation} from './image-import.js';
 import {nativeBackgroundFill} from './background.js';
 import {importBackground} from './background-import.js';
@@ -170,6 +171,7 @@ export async function toPptx(input, options = {}) {
   context.tableCells = new Map();
   context.imagePlacements = new Map();
   context.backgroundFills = new Map();
+  context.codeTags = new Map();
   context.imageFormat = options.imageFormat ?? "compatible";
   const pptx = new PptxGenJS();
   configurePresentation(pptx, presentation, {...context,fonts:resolveSlideContext(presentation,presentation.slides[0],context,options).fonts});
@@ -383,9 +385,9 @@ function importSlide(entries, slidePath, slideIndex, presentationDimensions, opt
   const items = collectSlideItems(entries, slideRoot, slidePath, relationships, dimensions, options, slideIndex)
     .sort(comparePositionedItems);
   const titleItem = takeTitleItem(items, dimensions);
-  if (titleItem) slide.title = firstLine(titleItem.text);
+  if (titleItem) slide.title = titleItem.text;
   const subtitleItem = takeSubtitleItem(items, titleItem, dimensions);
-  if (subtitleItem) slide.subtitle = firstLine(subtitleItem.text);
+  if (subtitleItem) slide.subtitle = subtitleItem.text;
 
   const blocks = mergeAdjacentBulletShapes(items)
     .map((item) => payloadFromSlideItem(item))
@@ -401,9 +403,14 @@ function importSlide(entries, slidePath, slideIndex, presentationDimensions, opt
 function collectSlideItems(entries, slideRoot, slidePath, relationships, dimensions, options, slideIndex) {
   const tree = slideRoot["p:cSld"]?.["p:spTree"];
   const items = [];
-
-  for (const shape of asArray(tree?.["p:sp"])) {
-    const item = importShape(shape, dimensions);
+  const shapes = nativeTextShapes(tree);
+  if (tree?.['p:grpSp']) options.onDiagnostic?.({code:'grouped-text-reflow',path:`slides.${slideIndex}`,message:'Grouped native text is retained, but group transforms and non-text group members are not reconstructed; review the reflowed OPF.'});
+  const paragraphs = nativeShapeParagraphs(decodeText(entries[slidePath]));
+  const code = importCodeGroups(shapes, paragraphs, relationships, entries, diagnostic => options.onDiagnostic?.({...diagnostic,path:`slides.${slideIndex}.code`}));
+  for (const item of code.items) items.push({kind:'code',bounds:shapeBounds(item.shape['p:spPr']?.['a:xfrm']),payload:item.payload});
+  for (const [index,shape] of shapes.entries()) {
+    if (code.consumed.has(shape)) continue;
+    const item = importShape(shape, dimensions, paragraphs[index]);
     if (item) items.push(item);
   }
 
@@ -426,9 +433,8 @@ function collectSlideItems(entries, slideRoot, slidePath, relationships, dimensi
   return items;
 }
 
-function importShape(shape, dimensions) {
-  const paragraphs = readParagraphs(shape["p:txBody"]);
-  const text = paragraphs.map((paragraph) => paragraph.text).filter(Boolean).join("\n").trim();
+function importShape(shape, dimensions, paragraphs = readParagraphs(shape["p:txBody"])) {
+  const text = paragraphs.map((paragraph) => paragraph.text).join("\n");
   const placeholder = shapePlaceholderType(shape);
   const bounds = shapeBounds(shape["p:spPr"]?.["a:xfrm"]);
   const name = scalarText(shape["p:nvSpPr"]?.["p:cNvPr"]?.name).trim();
@@ -544,13 +550,12 @@ function readParagraphs(txBody) {
         if (Number.isFinite(size)) sizes.push(size / 100);
       }
       return {
-        text: texts.join("").trim(),
+        text: texts.join(""),
         bullet: asArray(paragraph?.["a:pPr"]).some(props => props?.["a:buChar"] !== undefined || props?.["a:buAutoNum"] !== undefined),
         level: Number(asArray(paragraph?.["a:pPr"])[0]?.lvl ?? 0),
         maxFontSize: sizes.length > 0 ? Math.max(...sizes) : 0
       };
-    })
-    .filter((paragraph) => paragraph.text);
+    });
 }
 
 function shapePlaceholderType(shape) {
@@ -624,7 +629,7 @@ function mergeAdjacentBulletShapes(items) {
 function payloadFromSlideItem(item) {
   if (item.payload) return item.payload;
   if (item.kind === "text") {
-    if (item.paragraphs.length > 1 || item.paragraphs.some(p=>p.bullet)) {
+    if (item.paragraphs.some(p=>p.bullet)) {
       return {
         type: "list",
         items: item.paragraphs.map((paragraph) => (
@@ -907,7 +912,7 @@ async function addSlide(pptx, presentation, opfSlide, slideIndex, context, optio
     } else if (item.field === "text" && typeof item.value === "string") {
       slide.addText(item.text.lines.join("\n"), {...textBoxOptions(region, slideContext, item.text.fontSize * 0.75),fontFace:item.textStyle.fontFamily,bold:item.textStyle.fontWeight>=600,italic:item.textStyle.italic});
     } else {
-      await addPayload(slide, presentation, item.payload, region, item.path, { ...slideContext, composition: item.composition, contentAlignment: opfSlide.design?.contentAlignment ?? presentation.design?.contentAlignment ?? "left" }, options);
+      await addPayload(slide, presentation, item.payload, region, item.path, { ...slideContext, composition: item.composition, contentAlignment: opfSlide.design?.contentAlignment ?? presentation.design?.contentAlignment ?? "left" }, options, item.quoteLayout, item.codeLayout);
     }
   }
 
@@ -928,7 +933,7 @@ function fieldToType(field) {
   return field === "items" || field === "bullets" ? "list" : field;
 }
 
-async function addPayload(slide, presentation, payload, region, path, context, options) {
+async function addPayload(slide, presentation, payload, region, path, context, options, quoteLayout, codeLayout) {
   const kind = inferPayloadKind(payload);
   switch (kind) {
     case "text":
@@ -950,13 +955,13 @@ async function addPayload(slide, presentation, payload, region, path, context, o
       addTablePayload(slide, payload.table, region, context, options, path);
       break;
     case "code":
-      addCodePayload(slide, payload.code, region, context, options, path);
+      addCodePayload(slide, payload.code, codeLayout, region, context, path);
       break;
     case "metric":
       addMetricPayload(slide, payload.metric, region, context, options, path);
       break;
     case "quote":
-      addQuotePayload(slide, payload.quote, region, context, options, path);
+      addQuotePayload(slide, quoteLayout, context, options, path);
       break;
     case "timeline":
       addTimelinePayload(slide, payload.timeline, region, context, options, path);
@@ -1195,9 +1200,9 @@ function pixelBox(region) {
 // Each fitted line remains native editable text, without PowerPoint rewrapping it.
 function addMeasuredPayloadText(slide, text, box, context, options, config) {
   const scale = Math.min(context.dimensions.widthInches, context.dimensions.heightInches) * 96 / 720;
-  const style = resolveTextStyle({fontFamily: config.fontFamily ?? context.fonts.body, fontWeight: config.fontWeight ?? 400, path: config.path}, options.textMeasurement);
-  const fit = fitText(String(text ?? ''), box, config.fontSize * scale, (context.composition?.minFontSize ?? 16) * scale, textWidthMeasurer(style, options.textMeasurement));
-  if (fit.overflow) {
+  const style = config.textStyle ?? resolveTextStyle({fontFamily: config.fontFamily ?? context.fonts.body, fontWeight: config.fontWeight ?? 400, path: config.path}, options.textMeasurement);
+  const fit = config.fit ?? fitText(String(text ?? ''), box, config.fontSize * scale, (context.composition?.minFontSize ?? 16) * scale, textWidthMeasurer(style, options.textMeasurement));
+  if (fit.overflow && !config.diagnosticsHandled) {
     const diagnostic = {code: 'text-overflow', path: config.path, message: 'Text exceeds its cell at the minimum font size; shorten it, increase its space, or split the slide.'};
     options.onDiagnostic?.(diagnostic);
     if (context.composition?.overflow === 'error') throw new OPFPptxError('layout-overflow', diagnostic.message, {path: config.path, issues: [diagnostic]});
@@ -1213,16 +1218,32 @@ function addMeasuredPayloadText(slide, text, box, context, options, config) {
   }
 }
 
-function addCodePayload(slide, value, region, context, options, path) {
-  const box = pixelBox(region), code = typeof value === 'string' ? value : value?.source ?? JSON.stringify(value);
-  const label = typeof value === 'object' && value?.language ? String(value.language) : 'code';
-  slide.addShape('rect', {...region, fill: {color: '111827'}, line: {color: '334155', pt: .75}});
-  // The label has a fixed baseline in the SVG renderer; it does not participate in fitting.
-  slide.addText(label.toUpperCase(), {
-    ...textBoxOptions({x: (box.x + 18) / 96, y: (box.y + 14) / 96, w: Math.max(1, box.width - 36) / 96, h: 20 / 96}, context, 14 * .75),
-    fontFace: context.fonts.code, bold: true, color: '93C5FD', fit: 'none', wrap: false,
-  });
-  addMeasuredPayloadText(slide, code, {x: box.x + 18, y: box.y + 46, width: box.width - 36, height: box.height - 64}, context, options, {path, fontSize: 18, fontFamily: context.fonts.code, color: 'E5E7EB'});
+function addCodePayload(slide, value, layout, region, context, path) {
+  if (!layout) throw new OPFPptxError('missing-code-layout', 'Code export requires a coordinated core build with shared code geometry.', {path});
+  for (const part of layout.parts) {
+    // XML 1.0 Char excludes controls and unpaired UTF-16 surrogates. The u flag
+    // keeps valid supplementary characters (surrogate pairs) accepted.
+    const invalid = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF]/u.exec(part.text);
+    if (invalid) throw new OPFPptxError('invalid-code-text', `Code text contains U+${invalid[0].codePointAt(0).toString(16).toUpperCase().padStart(4,'0')} at UTF-16 offset ${invalid.index}, which XML cannot represent; edit that character before exporting.`, {path:part.path});
+  }
+  const group = String(context.codeTags.size + 1), panelName = `OPF code ${group} panel`;
+  for (const part of layout.parts) if (!part.fit) throw new OPFPptxError('layout-overflow', 'Code content has no usable internal space; increase its cell size before exporting.', {path:part.path,issues:layout.diagnostics});
+  context.codeTags.set(panelName,codeManifest(value,layout,group));
+  slide.addShape('rect', {...region, fill: {color: '111827'}, line: {color: '334155', pt: .75}, objectName:panelName});
+  for (const [partIndex,part] of layout.parts.entries()) {
+    if (!part.fit) throw new OPFPptxError('layout-overflow', 'Code content has no usable internal space; increase its cell size before exporting.', {path:part.path,issues:layout.diagnostics});
+    for (const [index,line] of part.fit.sourceLines.entries()) {
+      const tabStops=line.segments.filter(segment=>segment.kind==='tab').map(segment=>({position:(segment.x+segment.width)/96,alignment:'l'}));
+      const objectName = `OPF code ${group} ${part.role} line ${index+1}`;
+      context.codeTags.set(objectName,{v:1,group,role:'line',part:partIndex,line:index});
+      slide.addText(part.text.slice(line.start,line.end),{
+        ...textBoxOptions({x:part.box.x/96,y:(part.box.y+index*part.fit.lineHeight)/96,w:part.box.width/96,h:part.fit.lineHeight/96},context,part.fit.fontSize*.75),
+        fontFace:part.style.fontFamily,bold:part.style.fontWeight>=600,italic:part.style.italic,
+        color:part.role==='body'?'E5E7EB':'93C5FD',align:'left',fit:'none',wrap:false,lineSpacingMultiple:1,
+        tabStops:tabStops.length?tabStops:undefined,objectName,
+      });
+    }
+  }
 }
 
 function addMetricPayload(slide, value, region, context, options, path) {
@@ -1231,12 +1252,15 @@ function addMetricPayload(slide, value, region, context, options, path) {
   addMeasuredPayloadText(slide, [metric.label, metric.description, metric.delta].filter(Boolean).join('\n'), {x: box.x, y: box.y + box.height * .45, width: box.width, height: box.height * .55}, context, options, {path, fontSize: 23, fontWeight: 500});
 }
 
-function addQuotePayload(slide, value, region, context, options, path) {
-  const quote = isPlainObject(value) ? value : {text: value}, box = pixelBox(region);
-  const attribution = [quote.attribution, quote.source].filter(Boolean).join(' - ');
-  // Keep the footer and an 18px gap outside the body's text fitting area.
-  addMeasuredPayloadText(slide, `"${quote.text ?? ''}"`, {x: box.x + 18, y: box.y + 18, width: Math.max(1, box.width - 36), height: Math.max(1, box.height - (attribution ? 94 : 36))}, context, options, {path: path + '.text', fontSize: 28, fontFamily: context.fonts.heading, fontWeight: 600});
-  addMeasuredPayloadText(slide, attribution, {x: box.x + 18, y: box.y + box.height - 58, width: box.width - 36, height: 40}, context, options, {path, fontSize: 17, fontWeight: 500, color: context.colors.mutedText});
+function addQuotePayload(slide, layout, context, options, path) {
+  if (!layout) throw new OPFPptxError('missing-quote-layout', 'Quote export requires a coordinated core build with shared quote geometry.', {path});
+  for (const part of layout.parts) {
+    if (!part.fit) throw new OPFPptxError('layout-overflow', 'Quote content has no usable internal space; increase its cell size before exporting.', {path:part.path,issues:layout.diagnostics});
+    addMeasuredPayloadText(slide,part.text,part.box,context,options,{
+      path:part.path,fit:part.fit,textStyle:part.style,diagnosticsHandled:true,
+      color:part.role==='footer'?context.colors.mutedText:context.colors.text,
+    });
+  }
 }
 
 function addTimelinePayload(slide, value, region, context, options, path) {
@@ -1550,6 +1574,7 @@ async function normalizePptxZip(raw, context) {
     });
   }
 
+  attachCodeTags(entries, context.codeTags);
   const imageSources = new Map();
   for (const [part, bytes] of Object.entries(entries)) {
     if (!/^ppt\/slides\/slide\d+\.xml$/.test(part)) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf-pptx",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "description": "Pure local OPF to PPTX export and PPTX to OPF import tooling.",
   "license": "MIT",
   "type": "module",
@@ -38,24 +38,25 @@
   "scripts": {
     "build": "node scripts/build.mjs",
     "typecheck": "node --check src/index.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",
-    "test": "npm run build && node test/dependency-boundary.mjs && npm run build:browser-check && npm run test:styled-table && node test/content-layout.mjs",
+    "test": "npm run build && 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",
     "validate": "node scripts/validate-package.mjs",
     "test:packed": "node test/packed-install.mjs",
     "test:compare-published": "node test/compare-published.mjs",
     "test:browser": "npm run build:browser-check && node test/browser-check.mjs",
     "prepack": "npm run build",
     "build:browser-check": "node scripts/build-browser-check.mjs",
-    "test:styled-table": "node test/styled-table.mjs && node test/styled-table-import.mjs"
+    "test:styled-table": "node test/styled-table.mjs && node test/styled-table-import.mjs",
+    "test:code": "node test/shared-code.mjs && node test/code-provenance.mjs"
   },
   "dependencies": {
-    "@openpresentation/opf": "^0.7.0",
+    "@openpresentation/opf": "^0.9.0",
     "fast-xml-parser": "^5.8.0",
     "fflate": "^0.8.3",
     "jszip": "3.10.1",
     "sharp": "0.35.4"
   },
   "peerDependencies": {
-    "@openpresentation/opf-render": "^0.5.1"
+    "@openpresentation/opf-render": "^0.7.0"
   },
   "peerDependenciesMeta": {
     "@openpresentation/opf-render": {
@@ -63,7 +64,7 @@
     }
   },
   "devDependencies": {
-    "@openpresentation/opf-render": "0.5.1",
+    "@openpresentation/opf-render": "0.7.0",
     "esbuild": "0.28.2",
     "playwright": "1.63.0"
   },