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) : "";
}