From 46e04cb9abb9343faac1d4d50d133327c764acd5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=9A=D1=83=D1=80=D0=BD=D0=B0=D1=82=20=D0=90=D0=BD=D0=B4?= =?UTF-8?q?=D1=80=D0=B5=D0=B9?= Date: Mon, 1 Jun 2026 08:14:47 +0300 Subject: [PATCH] Preserve QExcell internal hyperlinks --- README.md | 4 +- src/io/excellOffice.test.ts | 42 +++++++++++++++++++ src/io/excellOffice.ts | 82 +++++++++++++++++++++++++++++++------ 3 files changed, 113 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 5a4a80c..bdacdaf 100644 --- a/README.md +++ b/README.md @@ -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 в текущем инкременте не заявлены. ## Сборка пакета diff --git a/src/io/excellOffice.test.ts b/src/io/excellOffice.test.ts index b5aee66..d7aaa0c 100644 --- a/src/io/excellOffice.test.ts +++ b/src/io/excellOffice.test.ts @@ -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( + '' + ); + expect(xml).toContain(''); + 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({ diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts index 38af7c0..4ef5a18 100644 --- a/src/io/excellOffice.ts +++ b/src/io/excellOffice.ts @@ -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 { 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 = {}) { return ""; } + let relationshipIndex = 0; const hyperlinkXml = refs - .map(([address], index) => ``) + .map((entry) => { + if (!entry.external) { + return ``; + } + + relationshipIndex += 1; + return ``; + }) .join(""); return `${hyperlinkXml}`; } export function buildWorksheetRelationshipsXml(hyperlinks: Record = {}, drawingTarget = "") { - const refs = sortedHyperlinkEntries(hyperlinks); + const refs = sortedExternalHyperlinkEntries(hyperlinks); if (refs.length === 0 && !drawingTarget) { return ""; } const relationships = refs .map( - ([, target], index) => - `` + (entry, index) => + `` ) .join(""); const drawingRelationship = drawingTarget @@ -1264,20 +1279,46 @@ function partDirectory(path: string) { function sortedHyperlinkEntries(hyperlinks: Record = {}) { 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 = {}) { + 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) : ""; }