Preserve QExcell internal hyperlinks

2026-06-01 08:14:47 +03:00
parent 51dac642e7
commit 46e04cb9ab
3 changed files with 113 additions and 15 deletions
@@ -32,7 +32,7 @@ npm run build
 ## Поддержка форматов

 - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, внешние гиперссылки, простые таблицы, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, цвет текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
+- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, цвет текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
 - QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев внутри текстовых блоков и заметки докладчика через relationships слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
 - QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable, MIME-вложения, `To`, `Cc` и `Bcc`. Импорт MSG читает тему, отправителя, получателей `To/Cc/Bcc`, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно адресовать через `To/Cc/Bcc` и сохранять в EML вместе с добавленными файлами. `.pst` и экспорт в `.msg` пока не реализованы.

@@ -46,7 +46,7 @@ Desktop-меню поддерживает системные команды дл
 - `Ctrl/Cmd+Shift+E`: экспортировать текущую рабочую область в PDF.
 - `Ctrl/Cmd+P`: печать текущей рабочей области.

-Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, цвета текста, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев при импорте, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
+Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, цвета текста, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев при импорте, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.

 ## Сборка пакета

@@ -106,6 +106,29 @@ describe("excellOffice OOXML helpers", () => {
    expect(relationshipsXml).not.toContain("javascript:alert");
  });

+  it("сохраняет внутренние гиперссылки XLSX как location без external relationship", () => {
+    const hyperlinks = {
+      A1: "#Справочник!B2",
+      B2: "https://example.com/report"
+    };
+    const xml = buildWorksheetXml({ A1: "Справочник", B2: "Отчет" }, [], hyperlinks);
+    const relationshipsXml = buildWorksheetRelationshipsXml(hyperlinks);
+
+    expect(buildHyperlinksXml(hyperlinks)).toBe(
+      '<hyperlinks><hyperlink ref="A1" location="Справочник!B2"/><hyperlink ref="B2" r:id="rId1"/></hyperlinks>'
+    );
+    expect(xml).toContain('<hyperlink ref="A1" location="Справочник!B2"/>');
+    expect(relationshipsXml).toContain('Target="https://example.com/report"');
+    expect(relationshipsXml).not.toContain("Справочник!B2");
+  });
+
+  it("назначает drawing relationship после внешних ссылок, игнорируя внутренние ссылки XLSX", () => {
+    const relationshipsXml = buildWorksheetRelationshipsXml({ A1: "#Справочник!B2" }, "../drawings/drawing1.xml");
+
+    expect(relationshipsXml).toContain('Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing"');
+    expect(relationshipsXml).not.toContain('TargetMode="External"');
+  });
+
  it("сохраняет базовое форматирование ячеек XLSX в XML листа", () => {
    const cellFormats = {
      A1: { bold: true, fontSize: 14, fontFamily: "Arial", textColor: "0f5fae", fillColor: "fff2cc", horizontalAlign: "center" as const },
@@ -393,6 +416,25 @@ describe("excellOffice OOXML helpers", () => {
    ).toEqual({ A1: "https://example.com/report" });
  });

+  it("читает внутренние гиперссылки XLSX из location", () => {
+    expect(
+      worksheetXmlToHyperlinks(
+        {
+          worksheet: {
+            hyperlinks: {
+              hyperlink: [
+                { ref: "A1", location: "Справочник!B2" },
+                { ref: "B2", location: "" },
+                { ref: "bad", location: "Справочник!B2" }
+              ]
+            }
+          }
+        },
+        undefined
+      )
+    ).toEqual({ A1: "#Справочник!B2" });
+  });
+
  it("читает ссылки листов и relationships из workbook XML", () => {
    expect(
      workbookSheetRefs({
@@ -64,6 +64,13 @@ interface WorksheetCellRecord {
  cell: XmlRecord;
 }

+interface HyperlinkEntry {
+  address: string;
+  target: string;
+  external: boolean;
+  location?: string;
+}
+
 interface SharedFormulaDefinition {
  formula: string;
  baseAddress: string;
@@ -183,7 +190,7 @@ export async function exportXlsxBlob(workbook: Workbook): Promise<Blob> {

  sheets.forEach((sheet, index) => {
    const sheetChartParts = chartParts.filter((part) => part.sheetIndex === index);
-    const drawingRelationshipId = sheetChartParts.length > 0 ? `rId${sortedHyperlinkEntries(sheet.hyperlinks).length + 1}` : "";
+    const drawingRelationshipId = sheetChartParts.length > 0 ? `rId${sortedExternalHyperlinkEntries(sheet.hyperlinks).length + 1}` : "";
    zip.file(
      `xl/worksheets/sheet${index + 1}.xml`,
      buildWorksheetXml(sheet.cells, sheet.mergedCells, sheet.hyperlinks, sheet.cellFormats, styleRegistry, drawingRelationshipId)
@@ -302,7 +309,7 @@ export function worksheetXmlToHyperlinks(worksheetXml: unknown, relationshipsXml
    const ref = normalizeCellAddress(String(record.ref || ""));
    const relationshipId = String(record["r:id"] || "");
    const location = String(record.location || "");
-    const target = normalizedHyperlinkTarget(relationshipTargets[relationshipId] || (location ? `#${location}` : ""));
+    const target = normalizedHyperlinkTarget(relationshipTargets[relationshipId] || "") || normalizedInternalHyperlinkTarget(location, true);
    if (ref && target) {
      links[ref] = target;
    }
@@ -547,22 +554,30 @@ export function buildHyperlinksXml(hyperlinks: Record<string, string> = {}) {
    return "";
  }

+  let relationshipIndex = 0;
  const hyperlinkXml = refs
-    .map(([address], index) => `<hyperlink ref="${escapeXmlAttribute(address)}" r:id="rId${index + 1}"/>`)
+    .map((entry) => {
+      if (!entry.external) {
+        return `<hyperlink ref="${escapeXmlAttribute(entry.address)}" location="${escapeXmlAttribute(entry.location ?? "")}"/>`;
+      }
+
+      relationshipIndex += 1;
+      return `<hyperlink ref="${escapeXmlAttribute(entry.address)}" r:id="rId${relationshipIndex}"/>`;
+    })
    .join("");
  return `<hyperlinks>${hyperlinkXml}</hyperlinks>`;
 }

 export function buildWorksheetRelationshipsXml(hyperlinks: Record<string, string> = {}, drawingTarget = "") {
-  const refs = sortedHyperlinkEntries(hyperlinks);
+  const refs = sortedExternalHyperlinkEntries(hyperlinks);
  if (refs.length === 0 && !drawingTarget) {
    return "";
  }

  const relationships = refs
    .map(
-      ([, target], index) =>
-        `<Relationship Id="rId${index + 1}" Type="${hyperlinkRelationshipType}" Target="${escapeXmlAttribute(target)}" TargetMode="External"/>`
+      (entry, index) =>
+        `<Relationship Id="rId${index + 1}" Type="${hyperlinkRelationshipType}" Target="${escapeXmlAttribute(entry.target)}" TargetMode="External"/>`
    )
    .join("");
  const drawingRelationship = drawingTarget
@@ -1264,20 +1279,46 @@ function partDirectory(path: string) {

 function sortedHyperlinkEntries(hyperlinks: Record<string, string> = {}) {
  return Object.entries(hyperlinks)
-    .map(([address, target]) => [normalizeCellAddress(address), normalizedHyperlinkTarget(target)] as const)
-    .filter((entry): entry is readonly [string, string] => Boolean(entry[0] && entry[1]))
-    .filter(([address], index, entries) => entries.findIndex(([candidate]) => candidate === address) === index)
-    .sort(([firstAddress], [secondAddress]) => {
-      const firstRow = cellRowNumber(firstAddress);
-      const secondRow = cellRowNumber(secondAddress);
+    .map(([address, target]) => normalizedHyperlinkEntry(address, target))
+    .filter((entry): entry is HyperlinkEntry => Boolean(entry))
+    .filter((entry, index, entries) => entries.findIndex((candidate) => candidate.address === entry.address) === index)
+    .sort((first, second) => {
+      const firstRow = cellRowNumber(first.address);
+      const secondRow = cellRowNumber(second.address);
      if (firstRow !== secondRow) {
        return firstRow - secondRow;
      }

-      return cellColumnNumber(firstAddress) - cellColumnNumber(secondAddress);
+      return cellColumnNumber(first.address) - cellColumnNumber(second.address);
    });
 }

+function sortedExternalHyperlinkEntries(hyperlinks: Record<string, string> = {}) {
+  return sortedHyperlinkEntries(hyperlinks).filter((entry) => entry.external);
+}
+
+function normalizedHyperlinkEntry(address: string, target: string): HyperlinkEntry | null {
+  const normalizedAddress = normalizeCellAddress(address);
+  const externalTarget = normalizedHyperlinkTarget(target);
+  if (normalizedAddress && externalTarget) {
+    return {
+      address: normalizedAddress,
+      target: externalTarget,
+      external: true
+    };
+  }
+
+  const location = normalizedInternalHyperlinkLocation(target);
+  return normalizedAddress && location
+    ? {
+        address: normalizedAddress,
+        target: `#${location}`,
+        external: false,
+        location
+      }
+    : null;
+}
+
 function normalizeCellAddress(address: string) {
  const trimmed = address.trim().toUpperCase();
  return isCellAddress(trimmed) ? trimmed : "";
@@ -1608,6 +1649,21 @@ function normalizedHyperlinkTarget(value?: string | null) {
  }
 }

+function normalizedInternalHyperlinkTarget(value?: string | null, allowWithoutHash = false) {
+  const location = normalizedInternalHyperlinkLocation(value, allowWithoutHash);
+  return location ? `#${location}` : "";
+}
+
+function normalizedInternalHyperlinkLocation(value?: string | null, allowWithoutHash = false) {
+  const raw = value?.trim() ?? "";
+  const location = raw.startsWith("#") ? raw.slice(1).trim() : allowWithoutHash ? raw : "";
+  if (!location || /[\u0000-\u001F]/.test(location)) {
+    return "";
+  }
+
+  return location.slice(0, 2048);
+}
+
 function sharedFormulaKey(formulaRecord: XmlRecord) {
  return formulaRecord.t === "shared" && formulaRecord.si !== undefined ? String(formulaRecord.si) : "";
 }