Preserve QExcell cell borders

README.md

@@ -32,7 +32,7 @@ npm run build
 ## Поддержка форматов
 
 - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, внешние гиперссылки, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
-- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, цвет текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста и числовые форматы XLSX для дат, процентов, денежных и дробных значений.
+- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые 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, ячейки, формулы, базовые 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, ячейки, формулы, базовые merged cells, базовые стили, цвета текста, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста и границы ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
 
 ## Сборка пакета
 

src/features/qexcell/QExcell.tsx

@@ -22,6 +22,7 @@ import {
   Plus,
   Save,
   Sigma,
+  SquareDashed,
   Strikethrough,
   Trash2,
   Type,
@@ -135,6 +136,7 @@ function normalizedCellFormat(format: CellFormat): CellFormat | undefined {
     ...(horizontalAlign ? { horizontalAlign } : {}),
     ...(verticalAlign ? { verticalAlign } : {}),
     ...(format.wrapText ? { wrapText: true } : {}),
+    ...(format.border ? { border: true } : {}),
     ...(numberFormat ? { numberFormat } : {})
   };
 
@@ -286,7 +288,7 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
     });
   }
 
-  function toggleSelectedFormat(key: "bold" | "italics" | "underline" | "strike" | "wrapText") {
+  function toggleSelectedFormat(key: "bold" | "italics" | "underline" | "strike" | "wrapText" | "border") {
     updateCellFormat(selectedCell, { [key]: !selectedCellFormat[key] });
   }
 
@@ -536,6 +538,15 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
             >
               <Strikethrough size={16} />
             </button>
+            <button
+              className={`icon-button format-toggle ${selectedCellFormat.border ? "is-active" : ""}`.trim()}
+              type="button"
+              onClick={() => toggleSelectedFormat("border")}
+              title="Границы ячейки"
+              aria-label="Границы ячейки"
+            >
+              <SquareDashed size={16} />
+            </button>
             {horizontalAlignOptions.map((option) => {
               const Icon = option.icon;
               const isActive = selectedCellFormat.horizontalAlign === option.value;
@@ -691,7 +702,7 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
                     return (
                       <td
                         key={id}
-                        className={`${selectedCell === id ? "is-selected" : ""} ${merge ? "is-merged" : ""} ${hyperlink ? "is-linked" : ""} ${cellFormat ? "is-formatted" : ""} ${cellFormat?.wrapText ? "is-wrapped" : ""} ${cellFormat?.verticalAlign ? `is-valign-${cellFormat.verticalAlign}` : ""}`.trim()}
+                        className={`${selectedCell === id ? "is-selected" : ""} ${merge ? "is-merged" : ""} ${hyperlink ? "is-linked" : ""} ${cellFormat ? "is-formatted" : ""} ${cellFormat?.wrapText ? "is-wrapped" : ""} ${cellFormat?.border ? "is-bordered" : ""} ${cellFormat?.verticalAlign ? `is-valign-${cellFormat.verticalAlign}` : ""}`.trim()}
                         style={cellBoxStyle(cellFormat)}
                         colSpan={merge?.columnSpan}
                         rowSpan={merge?.rowSpan}

src/io/excellOffice.test.ts

@@ -177,6 +177,32 @@ describe("excellOffice OOXML helpers", () => {
     expect(stylesXml).toContain('vertical="center"');
   });
 
+  it("записывает границы ячейки XLSX в styles.xml", async () => {
+    const blob = await exportXlsxBlob({
+      id: "workbook",
+      title: "Borders.xlsx",
+      updatedAt: "2026-06-01T00:00:00.000Z",
+      activeSheet: "sheet-1",
+      sheets: [
+        {
+          id: "sheet-1",
+          name: "Sheet 1",
+          cells: { A1: "Bordered" },
+          cellFormats: { A1: { border: true } }
+        }
+      ]
+    });
+    const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+    const stylesXml = await zip.file("xl/styles.xml")?.async("string");
+
+    expect(stylesXml).toContain('<borders count="2">');
+    expect(stylesXml).toContain('applyBorder="1"');
+    expect(stylesXml).toContain('<left style="thin">');
+    expect(stylesXml).toContain('<right style="thin">');
+    expect(stylesXml).toContain('<top style="thin">');
+    expect(stylesXml).toContain('<bottom style="thin">');
+  });
+
   it("читает базовое форматирование ячеек XLSX из styles.xml и XML листа", () => {
     const styleTable = xlsxStylesXmlToCellFormatTable({
       styleSheet: {
@@ -189,10 +215,13 @@ describe("excellOffice OOXML helpers", () => {
         fills: {
           fill: [{}, {}, { patternFill: { fgColor: { rgb: "FFFFF2CC" } } }]
         },
+        borders: {
+          border: [{}, { left: { style: "thin" }, right: { style: "thin" }, top: { style: "thin" }, bottom: { style: "thin" } }]
+        },
         cellXfs: {
           xf: [
             { fontId: "0", fillId: "0" },
-            { fontId: "1", fillId: "2", numFmtId: "164", alignment: { horizontal: "center", vertical: "center", wrapText: "1" } },
+            { fontId: "1", fillId: "2", borderId: "1", numFmtId: "164", alignment: { horizontal: "center", vertical: "center", wrapText: "1" } },
             { fontId: "0", fillId: "0", numFmtId: "14" }
           ]
         }
@@ -211,6 +240,7 @@ describe("excellOffice OOXML helpers", () => {
       horizontalAlign: "center",
       verticalAlign: "middle",
       wrapText: true,
+      border: true,
       numberFormat: "dd.mm.yyyy"
     });
     expect(styleTable[2]).toEqual({ numberFormat: "m/d/yy" });
@@ -241,6 +271,7 @@ describe("excellOffice OOXML helpers", () => {
         horizontalAlign: "center",
         verticalAlign: "middle",
         wrapText: true,
+        border: true,
         numberFormat: "dd.mm.yyyy"
       }
     });
@@ -442,7 +473,7 @@ describe("excellOffice OOXML helpers", () => {
           mergedCells: [{ start: "A1", end: "C1" }],
           hyperlinks: { A1: "https://example.com/budget" },
           cellFormats: {
-            A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true },
+            A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true, border: true },
             AC20: { underline: true },
             D20: { numberFormat: "dd.mm.yyyy" },
             E20: { numberFormat: "0%" }
@@ -476,7 +507,7 @@ describe("excellOffice OOXML helpers", () => {
     expect(imported.sheets[0].mergedCells).toEqual([{ start: "A1", end: "C1" }]);
     expect(imported.sheets[0].hyperlinks).toEqual({ A1: "https://example.com/budget" });
     expect(imported.sheets[0].cellFormats).toEqual({
-      A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true },
+      A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true, border: true },
       AC20: { underline: true },
       D20: { numberFormat: "dd.mm.yyyy" },
       E20: { numberFormat: "0%" }

src/io/excellOffice.ts

@@ -844,11 +844,13 @@ export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array<CellF
   const numberFormats = xlsxNumberFormats(styleSheet);
   const fonts = toArray(childRecord(styleSheet, "fonts").font).map(fontXmlToCellFormat);
   const fills = toArray(childRecord(styleSheet, "fills").fill).map(fillXmlToCellFormat);
+  const borders = toArray(childRecord(styleSheet, "borders").border).map(borderXmlToCellFormat);
 
   return toArray(childRecord(styleSheet, "cellXfs").xf).map((xf) => {
     const record = asRecord(xf);
     const fontFormat = fonts[numberAttribute(record.fontId)];
     const fillFormat = fills[numberAttribute(record.fillId)];
+    const borderFormat = borders[numberAttribute(record.borderId)];
     const numberFormat = normalizedNumberFormat(numberFormats[numberAttribute(record.numFmtId)]);
     const alignment = childRecord(record, "alignment");
     const horizontalAlign = normalizedHorizontalAlign(String(alignment.horizontal || ""));
@@ -857,6 +859,7 @@ export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array<CellF
     return normalizedCellFormat({
       ...fontFormat,
       ...fillFormat,
+      ...borderFormat,
       ...(horizontalAlign ? { horizontalAlign } : {}),
       ...(verticalAlign ? { verticalAlign } : {}),
       ...(wrapText ? { wrapText: true } : {}),
@@ -868,6 +871,7 @@ export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array<CellF
 function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
   const fonts = [baseFontXml()];
   const fills = ['<fill><patternFill patternType="none"/></fill>', '<fill><patternFill patternType="gray125"/></fill>'];
+  const borders = [baseBorderXml()];
   const fontIdsByKey: Record<string, number> = {};
   const fillIdsByColor: Record<string, number> = {};
   const numberFormatIdsByCode: Record<string, number> = {};
@@ -893,6 +897,14 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
       }
     }
 
+    let borderId = 0;
+    if (format.border) {
+      borderId = 1;
+      if (borders.length === 1) {
+        borders.push(formatBorderXml());
+      }
+    }
+
     let numFmtId = 0;
     if (format.numberFormat) {
       numFmtId = numberFormatIdsByCode[format.numberFormat] ?? customNumberFormatStartId + customNumberFormats.length;
@@ -904,6 +916,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
 
     const applyFont = fontId > 0 ? ' applyFont="1"' : "";
     const applyFill = fillId > 0 ? ' applyFill="1"' : "";
+    const applyBorder = borderId > 0 ? ' applyBorder="1"' : "";
     const applyAlignment = format.horizontalAlign || format.verticalAlign || format.wrapText ? ' applyAlignment="1"' : "";
     const applyNumberFormat = numFmtId > 0 ? ' applyNumberFormat="1"' : "";
     const alignmentAttributes = [
@@ -914,7 +927,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
       .filter(Boolean)
       .join(" ");
     const alignmentXml = alignmentAttributes ? `<alignment ${alignmentAttributes}/>` : "";
-    return `<xf numFmtId="${numFmtId}" fontId="${fontId}" fillId="${fillId}" borderId="0" xfId="0"${applyFont}${applyFill}${applyAlignment}${applyNumberFormat}>${alignmentXml}</xf>`;
+    return `<xf numFmtId="${numFmtId}" fontId="${fontId}" fillId="${fillId}" borderId="${borderId}" xfId="0"${applyFont}${applyFill}${applyBorder}${applyAlignment}${applyNumberFormat}>${alignmentXml}</xf>`;
   });
 
   const numFmtsXml =
@@ -925,7 +938,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
       : "";
 
   return xmlDeclaration(
-    `<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">${numFmtsXml}<fonts count="${fonts.length}">${fonts.join("")}</fonts><fills count="${fills.length}">${fills.join("")}</fills><borders count="1"><border><left/><right/><top/><bottom/><diagonal/></border></borders><cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs><cellXfs count="${cellXfs.length + 1}"><xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>${cellXfs.join("")}</cellXfs><cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles></styleSheet>`
+    `<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">${numFmtsXml}<fonts count="${fonts.length}">${fonts.join("")}</fonts><fills count="${fills.length}">${fills.join("")}</fills><borders count="${borders.length}">${borders.join("")}</borders><cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs><cellXfs count="${cellXfs.length + 1}"><xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>${cellXfs.join("")}</cellXfs><cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles></styleSheet>`
   );
 }
 
@@ -953,7 +966,7 @@ function cellFormatKey(format: CellFormat | undefined) {
     return "";
   }
 
-  return `${normalized.bold ? "1" : "0"}|${normalized.italics ? "1" : "0"}|${normalized.underline ? "1" : "0"}|${normalized.strike ? "1" : "0"}|${normalized.fontSize ?? ""}|${normalized.fontFamily ?? ""}|${normalized.textColor ?? ""}|${normalized.fillColor ?? ""}|${normalized.horizontalAlign ?? ""}|${normalized.verticalAlign ?? ""}|${normalized.wrapText ? "1" : "0"}|${normalized.numberFormat ?? ""}`;
+  return `${normalized.bold ? "1" : "0"}|${normalized.italics ? "1" : "0"}|${normalized.underline ? "1" : "0"}|${normalized.strike ? "1" : "0"}|${normalized.fontSize ?? ""}|${normalized.fontFamily ?? ""}|${normalized.textColor ?? ""}|${normalized.fillColor ?? ""}|${normalized.horizontalAlign ?? ""}|${normalized.verticalAlign ?? ""}|${normalized.wrapText ? "1" : "0"}|${normalized.border ? "1" : "0"}|${normalized.numberFormat ?? ""}`;
 }
 
 function fontStyleKey(format: CellFormat) {
@@ -982,6 +995,7 @@ function normalizedCellFormat(format: CellFormat | undefined): CellFormat | null
     ...(horizontalAlign ? { horizontalAlign } : {}),
     ...(verticalAlign ? { verticalAlign } : {}),
     ...(format?.wrapText ? { wrapText: true } : {}),
+    ...(format?.border ? { border: true } : {}),
     ...(numberFormat ? { numberFormat } : {})
   };
 
@@ -1012,6 +1026,16 @@ function fillXmlToCellFormat(fill: unknown): CellFormat {
   return fillColor ? { fillColor } : {};
 }
 
+function borderXmlToCellFormat(border: unknown): CellFormat {
+  const record = asRecord(border);
+  const hasBorder = ["left", "right", "top", "bottom"].some((side) => {
+    const style = String(childRecord(record, side).style || childRecord(record, side)["@_style"] || "").trim().toLowerCase();
+    return style && style !== "none";
+  });
+
+  return hasBorder ? { border: true } : {};
+}
+
 function baseFontXml() {
   return '<font><sz val="11"/><color theme="1"/><name val="Calibri"/><family val="2"/></font>';
 }
@@ -1026,6 +1050,14 @@ function formatFillXml(fillColor: string) {
   return `<fill><patternFill patternType="solid"><fgColor rgb="FF${fillColor}"/><bgColor indexed="64"/></patternFill></fill>`;
 }
 
+function baseBorderXml() {
+  return "<border><left/><right/><top/><bottom/><diagonal/></border>";
+}
+
+function formatBorderXml() {
+  return '<border><left style="thin"><color auto="1"/></left><right style="thin"><color auto="1"/></right><top style="thin"><color auto="1"/></top><bottom style="thin"><color auto="1"/></bottom><diagonal/></border>';
+}
+
 function normalizeFillColor(value?: string) {
   const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? "";
   if (/^[0-9A-F]{8}$/.test(raw)) {

src/styles.css

@@ -732,6 +732,11 @@ button {
   height: 58px;
 }
 
+.sheet-grid td.is-bordered {
+  border-color: #334155;
+  box-shadow: inset 0 0 0 1px #334155;
+}
+
 .sheet-grid td.is-valign-top input {
   padding-top: 0;
   padding-bottom: 8px;

src/types.ts

@@ -37,6 +37,7 @@ export interface CellFormat {
   horizontalAlign?: "left" | "center" | "right";
   verticalAlign?: "top" | "middle" | "bottom";
   wrapText?: boolean;
+  border?: boolean;
   numberFormat?: string;
 }