diff --git a/README.md b/README.md index 419799d..c64bdad 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ npm run build ## Поддержка форматов - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, табуляцию, внешние гиперссылки, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, табуляция, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта. -- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений. +- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений. - QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, а также заметки докладчика через relationships слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка. - QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `multipart/related`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения и inline-вложения с `Content-ID`, `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:br`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены. +Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены. ## Сборка пакета diff --git a/src/io/excellOffice.test.ts b/src/io/excellOffice.test.ts index 5d7846f..28ed2b4 100644 --- a/src/io/excellOffice.test.ts +++ b/src/io/excellOffice.test.ts @@ -4,6 +4,7 @@ import { buildChartXml, buildCellXml, buildAutoFilterXml, + buildColumnWidthsXml, buildHyperlinksXml, buildMergeCellsXml, buildSheetPrXml, @@ -21,9 +22,11 @@ import { worksheetXmlToAutoFilter, worksheetXmlToCells, worksheetXmlToCellFormats, + worksheetXmlToColumnWidths, worksheetXmlToFrozenPane, worksheetXmlToHyperlinks, worksheetXmlToMergedCells, + worksheetXmlToRowHeights, worksheetXmlToTabColor, xlsxStylesXmlToCellFormatTable, xlsxThemeXmlToColors, @@ -728,6 +731,61 @@ describe("excellOffice OOXML helpers", () => { expect(imported.sheets[0].tabColor).toBe("0F766E"); }); + it("читает и записывает размеры колонок и строк XLSX", async () => { + expect( + worksheetXmlToColumnWidths({ + worksheet: { + cols: { + col: [ + { min: "1", max: "2", width: "18.5" }, + { min: "4", max: "4", width: "9.25" } + ] + } + } + }) + ).toEqual({ A: 18.5, B: 18.5, D: 9.25 }); + expect( + worksheetXmlToRowHeights({ + worksheet: { + sheetData: { + row: [{ r: "1", ht: "24" }, { r: "4", ht: "30.5" }] + } + } + }) + ).toEqual({ "1": 24, "4": 30.5 }); + expect(buildColumnWidthsXml({ C: 9.25, A: 18.5, "1bad": 1 })).toBe( + '' + ); + + const blob = await exportXlsxBlob({ + id: "book-1", + title: "Sheet sizes.xlsx", + updatedAt: "2026-06-01T00:00:00.000Z", + activeSheet: "sheet-1", + sheets: [ + { + id: "sheet-1", + name: "Sizes", + columnWidths: { A: 18.5, C: 9.25 }, + rowHeights: { "1": 24, "4": 30.5 }, + cells: { A1: "Header", C2: "Value" } + } + ] + }); + const zip = await JSZip.loadAsync(await blob.arrayBuffer()); + const sheetXml = (await zip.file("xl/worksheets/sheet1.xml")?.async("string")) ?? ""; + const imported = await importXlsxFile(new File([blob], "Sheet sizes.xlsx", { type: blob.type })); + + expect(sheetXml).toContain( + '' + ); + expect(sheetXml).toContain('Header'); + expect(sheetXml).toContain(''); + expect(sheetXml.indexOf("")).toBeLessThan(sheetXml.indexOf("")); + expect(imported.sheets[0].columnWidths).toEqual({ A: 18.5, C: 9.25 }); + expect(imported.sheets[0].rowHeights).toEqual({ "1": 24, "4": 30.5 }); + }); + it("создает OOXML chart part для диаграммы XLSX", () => { const xml = buildChartXml( { diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts index b1c6a74..01560bc 100644 --- a/src/io/excellOffice.ts +++ b/src/io/excellOffice.ts @@ -12,6 +12,8 @@ export interface ImportedExcellWorkbook { frozenPane?: SheetFrozenPane; autoFilter?: string; tabColor?: string; + columnWidths?: Record; + rowHeights?: Record; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record; @@ -62,6 +64,8 @@ interface ParsedSheet { frozenPane?: SheetFrozenPane; autoFilter?: string; tabColor?: string; + columnWidths?: Record; + rowHeights?: Record; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record; @@ -267,7 +271,9 @@ export async function exportXlsxBlob(workbook: Workbook): Promise { drawingRelationshipId, sheet.frozenPane, sheet.autoFilter, - sheet.tabColor + sheet.tabColor, + sheet.columnWidths, + sheet.rowHeights ) ); const relationshipsXml = buildWorksheetRelationshipsXml( @@ -303,6 +309,8 @@ export function parsedWorksheetToSheet( const frozenPane = worksheetXmlToFrozenPane(worksheetXml); const autoFilter = worksheetXmlToAutoFilter(worksheetXml); const tabColor = worksheetXmlToTabColor(worksheetXml, themeColors); + const columnWidths = worksheetXmlToColumnWidths(worksheetXml); + const rowHeights = worksheetXmlToRowHeights(worksheetXml); return { id: sheet.id || `sheet-${index + 1}`, @@ -311,6 +319,8 @@ export function parsedWorksheetToSheet( ...(frozenPane ? { frozenPane } : {}), ...(autoFilter ? { autoFilter } : {}), ...(tabColor ? { tabColor } : {}), + ...(Object.keys(columnWidths).length > 0 ? { columnWidths } : {}), + ...(Object.keys(rowHeights).length > 0 ? { rowHeights } : {}), cells: worksheetXmlToCells(worksheetXml, sharedStrings), mergedCells: worksheetXmlToMergedCells(worksheetXml), hyperlinks: worksheetXmlToHyperlinks(worksheetXml, relationshipsXml), @@ -441,6 +451,43 @@ export function worksheetXmlToTabColor(worksheetXml: unknown, themeColors: strin return colorRecordToHex(childRecord(sheetPr, "tabColor"), themeColors); } +export function worksheetXmlToColumnWidths(worksheetXml: unknown): Record { + const worksheet = childRecord(worksheetXml, "worksheet"); + const cols = childRecord(worksheet, "cols"); + + return toArray(cols.col).reduce>((widths, col) => { + const record = asRecord(col); + const min = positiveIntegerAttribute(record.min); + const max = positiveIntegerAttribute(record.max) || min; + const width = positiveNumberAttribute(record.width); + if (!min || !max || !width || max < min) { + return widths; + } + + for (let column = min; column <= max; column += 1) { + widths[columnName(column)] = width; + } + + return widths; + }, {}); +} + +export function worksheetXmlToRowHeights(worksheetXml: unknown): Record { + const worksheet = childRecord(worksheetXml, "worksheet"); + const sheetData = childRecord(worksheet, "sheetData"); + + return toArray(sheetData.row).reduce>((heights, row, index) => { + const record = asRecord(row); + const rowNumber = positiveIntegerAttribute(record.r) || index + 1; + const height = positiveNumberAttribute(record.ht); + if (height) { + heights[String(rowNumber)] = height; + } + + return heights; + }, {}); +} + async function worksheetXmlToCharts( zip: ZipInstance, parser: InstanceType, @@ -614,8 +661,11 @@ export function buildWorksheetXml( drawingRelationshipId = "", frozenPane?: SheetFrozenPane, autoFilter?: string, - tabColor?: string + tabColor?: string, + columnWidths: Record = {}, + rowHeights: Record = {} ) { + const normalizedRowHeights = normalizedSheetRowHeights(rowHeights); const rows = sortedWorksheetEntries(cells, cellFormats).reduce>>((grouped, entry) => { const rowNumber = cellRowNumber(entry[0]); if (!grouped[rowNumber]) { @@ -624,11 +674,18 @@ export function buildWorksheetXml( grouped[rowNumber].push(entry); return grouped; }, {}); + Object.keys(normalizedRowHeights).forEach((rowNumber) => { + const row = positiveIntegerAttribute(rowNumber); + if (row && !rows[row]) { + rows[row] = []; + } + }); const rowXml = Object.entries(rows) .map(([rowNumber, entries]) => { const cellXml = entries.map(([address, value]) => buildCellXml(address, value, cellStyleId(cellFormats[address], styleRegistry))).join(""); - return `${cellXml}`; + const rowAttributes = buildRowHeightAttributes(normalizedRowHeights[rowNumber]); + return cellXml ? `${cellXml}` : ``; }) .join(""); @@ -638,9 +695,10 @@ export function buildWorksheetXml( const drawingXml = drawingRelationshipId ? `` : ""; const sheetPrXml = buildSheetPrXml(tabColor); const sheetViewsXml = buildSheetViewsXml(frozenPane); + const colsXml = buildColumnWidthsXml(columnWidths); return xmlDeclaration( - `${sheetPrXml}${sheetViewsXml}${rowXml}${autoFilterXml}${mergeCellsXml}${hyperlinksXml}${drawingXml}` + `${sheetPrXml}${sheetViewsXml}${colsXml}${rowXml}${autoFilterXml}${mergeCellsXml}${hyperlinksXml}${drawingXml}` ); } @@ -721,6 +779,22 @@ export function buildSheetPrXml(tabColor?: string) { return color ? `` : ""; } +export function buildColumnWidthsXml(columnWidths: Record = {}) { + const columns = normalizedSheetColumnWidths(columnWidths); + if (columns.length === 0) { + return ""; + } + + const xml = columns + .map( + ({ column, width }) => + `` + ) + .join(""); + + return `${xml}`; +} + export function buildAutoFilterXml(autoFilter?: string) { const ref = normalizeCellRange(autoFilter ?? ""); return ref ? `` : ""; @@ -1410,6 +1484,47 @@ function numberAttribute(value: unknown) { return Number.isInteger(number) && number >= 0 ? number : 0; } +function positiveIntegerAttribute(value: unknown) { + const number = Number(value); + return Number.isInteger(number) && number > 0 ? number : 0; +} + +function positiveNumberAttribute(value: unknown) { + const number = Number(value); + return Number.isFinite(number) && number > 0 ? number : 0; +} + +function normalizedSheetColumnWidths(columnWidths: Record = {}) { + return Object.entries(columnWidths) + .map(([column, width]) => { + const columnNumber = columnAddressNumber(column); + const normalizedWidth = positiveNumberAttribute(width); + return columnNumber && normalizedWidth ? { column: columnNumber, width: normalizedWidth } : null; + }) + .filter((entry): entry is { column: number; width: number } => Boolean(entry)) + .sort((first, second) => first.column - second.column); +} + +function normalizedSheetRowHeights(rowHeights: Record = {}) { + return Object.entries(rowHeights).reduce>((heights, [row, height]) => { + const rowNumber = positiveIntegerAttribute(row); + const normalizedHeight = positiveNumberAttribute(height); + if (rowNumber && normalizedHeight) { + heights[String(rowNumber)] = normalizedHeight; + } + + return heights; + }, {}); +} + +function buildRowHeightAttributes(height?: number) { + return height ? ` ht="${formatSheetDimension(height)}" customHeight="1"` : ""; +} + +function formatSheetDimension(value: number) { + return Number(value.toFixed(4)).toString(); +} + function normalizedFrozenPane(pane?: SheetFrozenPane): NormalizedFrozenPane | null { const columns = paneSplitCount(pane?.columns); const rows = paneSplitCount(pane?.rows); @@ -1624,6 +1739,11 @@ function normalizeCellAddress(address: string) { return isCellAddress(trimmed) ? trimmed : ""; } +function columnAddressNumber(column: string) { + const normalized = column.trim().toUpperCase(); + return /^[A-Z]+$/.test(normalized) ? cellColumnNumber(`${normalized}1`) : 0; +} + function translateSharedFormula(formula: string, baseAddress: string, targetAddress: string) { const normalizedBase = normalizeCellAddress(baseAddress); const normalizedTarget = normalizeCellAddress(targetAddress); diff --git a/src/types.ts b/src/types.ts index e16a825..8e61261 100644 --- a/src/types.ts +++ b/src/types.ts @@ -22,6 +22,8 @@ export interface Sheet { frozenPane?: SheetFrozenPane; autoFilter?: string; tabColor?: string; + columnWidths?: Record; + rowHeights?: Record; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record;