Preserve QPowerPoint text hyperlinks in PPTX

2026-06-02 06:08:47 +03:00
parent 2f1c70852d
commit 0a675236b3
6 changed files with 152 additions and 9 deletions
@@ -527,6 +527,66 @@ describe("powerPointOffice helpers", () => {
    expect(exportedSlideXml).toContain('typeface="Times New Roman"');
  });

+  it("импортирует внешние ссылки текста PPTX через hlinkClick relationships", async () => {
+    const zip = new JSZip();
+    zip.file(
+      "ppt/presentation.xml",
+      `<p:presentation xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><p:sldIdLst><p:sldId id="256" r:id="rId1"/></p:sldIdLst></p:presentation>`
+    );
+    zip.file(
+      "ppt/_rels/presentation.xml.rels",
+      `<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="slides/slide1.xml"/></Relationships>`
+    );
+    zip.file("ppt/slides/slide1.xml", slideXmlWithTextHyperlinks("Roadmap", "Open report"));
+    zip.file(
+      "ppt/slides/_rels/slide1.xml.rels",
+      `<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rIdTitleLink" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink" Target="https://example.com/title" TargetMode="External"/><Relationship Id="rIdSubtitleLink" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink" Target="mailto:team@example.com" TargetMode="External"/></Relationships>`
+    );
+
+    const blob = await zip.generateAsync({
+      type: "blob",
+      mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+    });
+    const imported = await importPptxFile(new File([blob], "Links.pptx", { type: blob.type }));
+
+    expect(imported.slides[0]).toMatchObject({
+      title: "Roadmap",
+      titleHyperlink: "https://example.com/title",
+      subtitle: "Open report",
+      subtitleHyperlink: "mailto:team@example.com"
+    });
+  });
+
+  it("экспортирует внешние ссылки заголовка и подзаголовка PPTX", async () => {
+    const blob = await exportPptxBlob({
+      title: "Links.pptx",
+      slides: [
+        {
+          id: "slide-1",
+          title: "Roadmap",
+          titleHyperlink: "https://example.com/title",
+          subtitle: "Open report",
+          subtitleHyperlink: "mailto:team@example.com",
+          notes: "",
+          theme: "classic"
+        }
+      ]
+    });
+    const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+    const slideXml = (await zip.file("ppt/slides/slide1.xml")?.async("string")) ?? "";
+    const relationshipsXml = (await zip.file("ppt/slides/_rels/slide1.xml.rels")?.async("string")) ?? "";
+    const reimported = await importPptxFile(new File([blob], "Links.pptx", { type: blob.type }));
+
+    expect(slideXml).toContain("hlinkClick");
+    expect(relationshipsXml).toContain('Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink"');
+    expect(relationshipsXml).toContain('Target="https://example.com/title"');
+    expect(relationshipsXml).toContain('Target="mailto:team@example.com"');
+    expect(reimported.slides[0]).toMatchObject({
+      titleHyperlink: "https://example.com/title",
+      subtitleHyperlink: "mailto:team@example.com"
+    });
+  });
+
  it("нормализует пробелы в импортированном тексте", () => {
    expect(normalizeWhitespace("  Строка\tс \n пробелами  ")).toBe("Строка с пробелами");
  });
@@ -554,6 +614,10 @@ function slideXmlWithTextStyles(title: string, subtitle: string) {
  return `<p:sld xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"><p:cSld><p:spTree><p:sp><p:txBody><a:p><a:r><a:rPr sz="3400"><a:solidFill><a:srgbClr val="C2410C"/></a:solidFill><a:latin typeface="Courier New"/></a:rPr><a:t>${title}</a:t></a:r></a:p></p:txBody></p:sp><p:sp><p:txBody><a:p><a:r><a:rPr sz="2200"><a:solidFill><a:srgbClr val="0F766E"/></a:solidFill><a:latin typeface="Times New Roman"/></a:rPr><a:t>${subtitle}</a:t></a:r></a:p></p:txBody></p:sp></p:spTree></p:cSld></p:sld>`;
 }

+function slideXmlWithTextHyperlinks(title: string, subtitle: string) {
+  return `<p:sld xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><p:cSld><p:spTree><p:sp><p:txBody><a:p><a:r><a:rPr><a:hlinkClick r:id="rIdTitleLink"/></a:rPr><a:t>${title}</a:t></a:r></a:p></p:txBody></p:sp><p:sp><p:txBody><a:p><a:r><a:rPr><a:hlinkClick r:id="rIdSubtitleLink"/></a:rPr><a:t>${subtitle}</a:t></a:r></a:p></p:txBody></p:sp></p:spTree></p:cSld></p:sld>`;
+}
+
 function slideXmlWithMultilineSubtitle(title: string, subtitleParagraphs: string[]) {
  return `<p:sld xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"><p:cSld><p:spTree><p:sp><p:txBody><a:p><a:r><a:t>${title}</a:t></a:r></a:p></p:txBody></p:sp><p:sp><p:txBody>${subtitleParagraphs
    .map((text) => `<a:p><a:r><a:t>${text}</a:t></a:r></a:p>`)
@@ -14,6 +14,7 @@ export interface ExportablePowerPointDeck {
 interface SlideTextBlock {
  text: string;
  listStyle?: SlideListStyle;
+  hyperlink?: string;
  color?: string;
  fontSize?: number;
  fontFamily?: string;
@@ -38,6 +39,7 @@ const slidePathPattern = /^ppt\/slides\/slide(\d+)\.xml$/;
 const slideRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
 const notesRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide";
 const imageRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
+const hyperlinkRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
 const emuPerInch = 914400;
 const slideTransitions = ["fade", "push", "wipe"] as const;
 const themeColors: Record<Slide["theme"], { background: string; title: string; subtitle: string }> = {
@@ -68,7 +70,10 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
      const slideXml = await readRequiredZipText(zip, path, "Не удалось прочитать слайд PowerPoint.");
      const parsedSlide = parser.parse(slideXml);
      const orderedSlide = orderedParser.parse(slideXml);
-      const slideTextBlocks = mergeOrderedSlideTextBlocks(extractSlideTextBlocks(parsedSlide), extractOrderedTextBodyTexts(orderedSlide));
+      const relationshipsPath = `${partDirectory(path)}/_rels/${partFileName(path)}.rels`;
+      const slideRelationshipsXml = await readOptionalParsedXml(zip, parser, relationshipsPath);
+      const hyperlinkTargets = relationshipTargetsById(slideRelationshipsXml, hyperlinkRelationshipType, path);
+      const slideTextBlocks = mergeOrderedSlideTextBlocks(extractSlideTextBlocks(parsedSlide, hyperlinkTargets), extractOrderedTextBodyTexts(orderedSlide));
      const images = await extractSlideImages(zip, parser, parsedSlide, path, index);
      const notesPath = await slideNotesPath(zip, parser, path);
      const notesXml = notesPath ? await readOptionalZipText(zip, notesPath) : await readOptionalZipText(zip, `ppt/notesSlides/notesSlide${index}.xml`);
@@ -86,7 +91,9 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
      return {
        id: `pptx-slide-${index}`,
        title: slideTextBlocks[0]?.text || `Слайд ${index}`,
+        ...(slideTextBlocks[0]?.hyperlink ? { titleHyperlink: slideTextBlocks[0].hyperlink } : {}),
        subtitle: slideTextBlocks.slice(1).map((block) => block.text).join("\n"),
+        ...(slideTextBlocks[1]?.hyperlink ? { subtitleHyperlink: slideTextBlocks[1].hyperlink } : {}),
        notes,
        theme: "classic" as const,
        ...(hidden ? { hidden } : {}),
@@ -140,6 +147,8 @@ export async function exportPptxBlob(deck: ExportablePowerPointDeck): Promise<Bl
    const subtitleFontSize = normalizeFontSize(sourceSlide.subtitleFontSize) || 18;
    const titleFontFamily = normalizeFontFamily(sourceSlide.titleFontFamily) || "Arial";
    const subtitleFontFamily = normalizeFontFamily(sourceSlide.subtitleFontFamily) || "Arial";
+    const titleHyperlink = normalizedExternalHyperlinkTarget(sourceSlide.titleHyperlink);
+    const subtitleHyperlink = normalizedExternalHyperlinkTarget(sourceSlide.subtitleHyperlink);
    const slide = pptx.addSlide();
    slide.background = { color: normalizeHexColor(sourceSlide.backgroundColor) || colors.background };
    sourceSlide.images?.forEach((image, index) => {
@@ -167,7 +176,8 @@ export async function exportPptxBlob(deck: ExportablePowerPointDeck): Promise<Bl
      bold: true,
      color: titleColor,
      margin: 0.04,
-      breakLine: false
+      breakLine: false,
+      ...(titleHyperlink ? { hyperlink: { url: titleHyperlink } } : {})
    });
    slide.addText(sourceSlide.subtitle || "", {
      x: 0.75,
@@ -179,7 +189,8 @@ export async function exportPptxBlob(deck: ExportablePowerPointDeck): Promise<Bl
      color: subtitleColor,
      valign: "top",
      fit: "shrink",
-      breakLine: false
+      breakLine: false,
+      ...(subtitleHyperlink ? { hyperlink: { url: subtitleHyperlink } } : {})
    });

    if (sourceSlide.notes.trim() && slide.addNotes) {
@@ -200,16 +211,17 @@ export function extractTextBlocks(xmlNode: unknown): string[] {
  return blocks.map(normalizeWhitespace).filter(Boolean);
 }

-function extractSlideTextBlocks(slideXml: unknown): SlideTextBlock[] {
-  const textBodies = recordsByKey(slideXml, "txBody");
+function extractSlideTextBlocks(slideXml: unknown, hyperlinkTargets: Record<string, string> = {}): SlideTextBlock[] {
+  const textBodies = slideTextBodyRecords(slideXml);
  const blocks = textBodies
-    .map((textBody) => {
+    .map(({ textBody, hyperlinkSource }) => {
      const text = extractTextBodyText(textBody);
      if (!text) {
        return null;
      }

      const runProperties = firstRecordByKey(textBody, "rPr");
+      const hyperlink = textBodyHyperlink(hyperlinkSource, hyperlinkTargets);
      const listStyle = textBodyListStyle(textBody);
      const color = runTextColor(runProperties);
      const fontSize = runTextFontSize(runProperties);
@@ -217,6 +229,7 @@ function extractSlideTextBlocks(slideXml: unknown): SlideTextBlock[] {
      return {
        text,
        ...(listStyle ? { listStyle } : {}),
+        ...(hyperlink ? { hyperlink } : {}),
        ...(color ? { color } : {}),
        ...(fontSize ? { fontSize } : {}),
        ...(fontFamily ? { fontFamily } : {})
@@ -227,6 +240,28 @@ function extractSlideTextBlocks(slideXml: unknown): SlideTextBlock[] {
  return blocks.length > 0 ? blocks : extractTextBlocks(slideXml).map((text) => ({ text }));
 }

+function slideTextBodyRecords(slideXml: unknown): Array<{ textBody: Record<string, unknown>; hyperlinkSource: Record<string, unknown> }> {
+  const shapeEntries = recordsByKey(slideXml, "sp")
+    .map((shape) => {
+      const textBody = childRecord(shape, "txBody");
+      return Object.keys(textBody).length > 0 ? { textBody, hyperlinkSource: shape } : null;
+    })
+    .filter((entry): entry is { textBody: Record<string, unknown>; hyperlinkSource: Record<string, unknown> } => Boolean(entry));
+
+  return shapeEntries.length > 0 ? shapeEntries : recordsByKey(slideXml, "txBody").map((textBody) => ({ textBody, hyperlinkSource: textBody }));
+}
+
+function textBodyHyperlink(textBody: Record<string, unknown>, hyperlinkTargets: Record<string, string>) {
+  const hyperlink = recordsByKey(textBody, "hlinkClick")
+    .map((record) => {
+      const id = relationshipId(record);
+      return id ? normalizedExternalHyperlinkTarget(hyperlinkTargets[id]) : "";
+    })
+    .find(Boolean);
+
+  return hyperlink ?? "";
+}
+
 function mergeOrderedSlideTextBlocks(styledBlocks: SlideTextBlock[], orderedTexts: string[]) {
  if (orderedTexts.length === 0) {
    return styledBlocks;
@@ -351,6 +386,9 @@ export function relationshipTargetByType(relationshipsXml: unknown, type: string
 export function resolvePptTarget(baseDirectory: string, target: string): string {
  const normalizedBase = baseDirectory.replace(/\\/g, "/").replace(/\/+$/, "");
  const normalizedTarget = target.replace(/\\/g, "/");
+  if (/^[a-z][a-z0-9+.-]*:/i.test(normalizedTarget)) {
+    return normalizedTarget;
+  }
  const rawPath = normalizedTarget.startsWith("/") ? normalizedTarget.replace(/^\/+/, "") : `${normalizedBase}/${normalizedTarget}`;
  const segments: string[] = [];

@@ -591,6 +629,20 @@ function normalizeHexColor(value?: string) {
  return /^[0-9A-F]{6}$/.test(raw) ? raw : "";
 }

+function normalizedExternalHyperlinkTarget(value?: string) {
+  const raw = value?.trim();
+  if (!raw) {
+    return "";
+  }
+
+  try {
+    const url = new URL(raw);
+    return ["http:", "https:", "mailto:", "tel:", "ftp:"].includes(url.protocol.toLowerCase()) ? url.href : "";
+  } catch {
+    return "";
+  }
+}
+
 function runTextColor(runProperties: Record<string, unknown>) {
  const solidFill = childRecord(runProperties, "solidFill");
  const srgbColor = childRecord(solidFill, "srgbClr");