Preserve QExcell font families

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

@@ -82,6 +82,7 @@ const horizontalAlignOptions = [
   { value: "center", label: "По центру", icon: AlignCenter },
   { value: "right", label: "По правому краю", icon: AlignRight }
 ] as const;
+const fontFamilyOptions = ["Aptos", "Arial", "Courier New", "Times New Roman"];
 const fontSizeOptions = [10, 11, 12, 14, 16, 18, 20, 24];
 
 function normalizedLinkInput(value: string | null) {
@@ -111,12 +112,14 @@ function normalizedCellFormat(format: CellFormat): CellFormat | undefined {
   const horizontalAlign = normalizedHorizontalAlign(format.horizontalAlign);
   const numberFormat = format.numberFormat?.trim();
   const fontSize = normalizedFontSize(format.fontSize);
+  const fontFamily = normalizedFontFamily(format.fontFamily);
   const normalized: CellFormat = {
     ...(format.bold ? { bold: true } : {}),
     ...(format.italics ? { italics: true } : {}),
     ...(format.underline ? { underline: true } : {}),
     ...(format.strike ? { strike: true } : {}),
     ...(fontSize ? { fontSize } : {}),
+    ...(fontFamily ? { fontFamily } : {}),
     ...(textColor ? { textColor } : {}),
     ...(fillColor ? { fillColor } : {}),
     ...(horizontalAlign ? { horizontalAlign } : {}),
@@ -133,6 +136,7 @@ function cellInputStyle(format?: CellFormat): CSSProperties {
     ...(format?.italics ? { fontStyle: "italic" } : {}),
     ...(textDecoration ? { textDecoration } : {}),
     ...(format?.fontSize ? { fontSize: `${format.fontSize}pt` } : {}),
+    ...(format?.fontFamily ? { fontFamily: format.fontFamily } : {}),
     ...(format?.textColor ? { color: `#${format.textColor}` } : {}),
     ...(format?.fillColor ? { backgroundColor: `#${format.fillColor}` } : {}),
     ...(format?.horizontalAlign ? { textAlign: format.horizontalAlign } : {})
@@ -152,6 +156,11 @@ function normalizedFontSize(value?: number) {
   return normalized === 11 ? undefined : normalized;
 }
 
+function normalizedFontFamily(value?: string) {
+  const normalized = value?.trim().replace(/["<>]/g, "").slice(0, 80) ?? "";
+  return normalized && normalized.toLowerCase() !== "calibri" ? normalized : "";
+}
+
 function normalizedChartRange(value: string) {
   const raw = value.trim().replace(/\$/g, "").toUpperCase();
   const [start, end = start] = raw.split(":");
@@ -497,8 +506,8 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
               className={`icon-button format-toggle ${selectedCellFormat.strike ? "is-active" : ""}`.trim()}
               type="button"
               onClick={() => toggleSelectedFormat("strike")}
-              title="Зачеркнуть"
+              title="Зачеркнуть"
-              aria-label="Зачеркнуть"
+              aria-label="Зачеркнуть"
             >
               <Strikethrough size={16} />
             </button>
@@ -518,6 +527,19 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
                 </button>
               );
             })}
+            <select
+              value={selectedCellFormat.fontFamily ?? ""}
+              onChange={(event) => updateCellFormat(selectedCell, { fontFamily: event.target.value || undefined })}
+              aria-label="Семейство шрифта"
+              title="Семейство шрифта"
+            >
+              <option value="">Calibri</option>
+              {fontFamilyOptions.map((fontFamily) => (
+                <option key={fontFamily} value={fontFamily}>
+                  {fontFamily}
+                </option>
+              ))}
+            </select>
             <select
               value={selectedCellFormat.fontSize ?? ""}
               onChange={(event) =>

src/io/excellOffice.test.ts

@@ -77,7 +77,7 @@ describe("excellOffice OOXML helpers", () => {
 
   it("сохраняет базовое форматирование ячеек XLSX в XML листа", () => {
     const cellFormats = {
-      A1: { bold: true, fontSize: 14, textColor: "0f5fae", fillColor: "fff2cc", horizontalAlign: "center" as const },
+      A1: { bold: true, fontSize: 14, fontFamily: "Arial", textColor: "0f5fae", fillColor: "fff2cc", horizontalAlign: "center" as const },
       B2: { italics: true, underline: true, strike: true },
       C3: { fillColor: "bad-color" }
     };
@@ -112,6 +112,27 @@ describe("excellOffice OOXML helpers", () => {
     expect(stylesXml).toContain("<strike/>");
   });
 
+  it("записывает семейство шрифта ячейки XLSX в styles.xml", async () => {
+    const blob = await exportXlsxBlob({
+      id: "workbook",
+      title: "Font.xlsx",
+      updatedAt: "2026-06-01T00:00:00.000Z",
+      activeSheet: "sheet-1",
+      sheets: [
+        {
+          id: "sheet-1",
+          name: "Sheet 1",
+          cells: { A1: "Arial" },
+          cellFormats: { A1: { fontFamily: "Arial" } }
+        }
+      ]
+    });
+    const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+    const stylesXml = await zip.file("xl/styles.xml")?.async("string");
+
+    expect(stylesXml).toContain('<name val="Arial"/>');
+  });
+
   it("читает базовое форматирование ячеек XLSX из styles.xml и XML листа", () => {
     const styleTable = xlsxStylesXmlToCellFormatTable({
       styleSheet: {
@@ -119,7 +140,7 @@ describe("excellOffice OOXML helpers", () => {
           numFmt: { numFmtId: "164", formatCode: "dd.mm.yyyy" }
         },
         fonts: {
-          font: [{}, { b: {}, i: {}, u: {}, strike: {}, sz: { val: "14" }, color: { rgb: "FF0F5FAE" } }]
+          font: [{}, { b: {}, i: {}, u: {}, strike: {}, sz: { val: "14" }, name: { val: "Arial" }, color: { rgb: "FF0F5FAE" } }]
         },
         fills: {
           fill: [{}, {}, { patternFill: { fgColor: { rgb: "FFFFF2CC" } } }]
@@ -140,6 +161,7 @@ describe("excellOffice OOXML helpers", () => {
       underline: true,
       strike: true,
       fontSize: 14,
+      fontFamily: "Arial",
       textColor: "0F5FAE",
       fillColor: "FFF2CC",
       horizontalAlign: "center",
@@ -167,6 +189,7 @@ describe("excellOffice OOXML helpers", () => {
         underline: true,
         strike: true,
         fontSize: 14,
+        fontFamily: "Arial",
         textColor: "0F5FAE",
         fillColor: "FFF2CC",
         horizontalAlign: "center",
@@ -371,7 +394,7 @@ describe("excellOffice OOXML helpers", () => {
           mergedCells: [{ start: "A1", end: "C1" }],
           hyperlinks: { A1: "https://example.com/budget" },
           cellFormats: {
-            A1: { bold: true, strike: true, fontSize: 14, textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center" },
+            A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center" },
             AC20: { underline: true },
             D20: { numberFormat: "dd.mm.yyyy" },
             E20: { numberFormat: "0%" }
@@ -405,7 +428,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, textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center" },
+      A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center" },
       AC20: { underline: true },
       D20: { numberFormat: "dd.mm.yyyy" },
       E20: { numberFormat: "0%" }

src/io/excellOffice.ts

@@ -936,12 +936,12 @@ 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.textColor ?? ""}|${normalized.fillColor ?? ""}|${normalized.horizontalAlign ?? ""}|${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.numberFormat ?? ""}`;
 }
 
 function fontStyleKey(format: CellFormat) {
-  return format.bold || format.italics || format.underline || format.strike || format.fontSize || format.textColor
+  return format.bold || format.italics || format.underline || format.strike || format.fontSize || format.fontFamily || format.textColor
-    ? `${format.bold ? "1" : "0"}|${format.italics ? "1" : "0"}|${format.underline ? "1" : "0"}|${format.strike ? "1" : "0"}|${format.fontSize ?? ""}|${format.textColor ?? ""}`
+    ? `${format.bold ? "1" : "0"}|${format.italics ? "1" : "0"}|${format.underline ? "1" : "0"}|${format.strike ? "1" : "0"}|${format.fontSize ?? ""}|${format.fontFamily ?? ""}|${format.textColor ?? ""}`
     : "";
 }
 
@@ -951,12 +951,14 @@ function normalizedCellFormat(format: CellFormat | undefined): CellFormat | null
   const horizontalAlign = normalizedHorizontalAlign(format?.horizontalAlign);
   const numberFormat = normalizedNumberFormat(format?.numberFormat);
   const fontSize = normalizedFontSize(format?.fontSize);
+  const fontFamily = normalizedFontFamily(format?.fontFamily);
   const normalized: CellFormat = {
     ...(format?.bold ? { bold: true } : {}),
     ...(format?.italics ? { italics: true } : {}),
     ...(format?.underline ? { underline: true } : {}),
     ...(format?.strike ? { strike: true } : {}),
     ...(fontSize ? { fontSize } : {}),
+    ...(fontFamily ? { fontFamily } : {}),
     ...(textColor ? { textColor } : {}),
     ...(fillColor ? { fillColor } : {}),
     ...(horizontalAlign ? { horizontalAlign } : {}),
@@ -970,6 +972,7 @@ function fontXmlToCellFormat(font: unknown): CellFormat {
   const record = asRecord(font);
   const textColor = normalizeFillColor(String(childRecord(record, "color").rgb || ""));
   const fontSize = normalizedFontSize(numberAttribute(childRecord(record, "sz").val));
+  const fontFamily = normalizedFontFamily(String(childRecord(record, "name").val || ""));
   return (
     normalizedCellFormat({
       bold: hasXmlElement(record, "b"),
@@ -977,6 +980,7 @@ function fontXmlToCellFormat(font: unknown): CellFormat {
       underline: hasXmlElement(record, "u"),
       strike: hasXmlElement(record, "strike"),
       ...(fontSize ? { fontSize } : {}),
+      ...(fontFamily ? { fontFamily } : {}),
       ...(textColor ? { textColor } : {})
     }) ?? {}
   );
@@ -995,7 +999,7 @@ function baseFontXml() {
 function formatFontXml(format: CellFormat) {
   const flags = `${format.bold ? "<b/>" : ""}${format.italics ? "<i/>" : ""}${format.underline ? "<u/>" : ""}${format.strike ? "<strike/>" : ""}`;
   const color = format.textColor ? `<color rgb="FF${format.textColor}"/>` : '<color theme="1"/>';
-  return `<font>${flags}<sz val="${format.fontSize ?? 11}"/>${color}<name val="Calibri"/><family val="2"/></font>`;
+  return `<font>${flags}<sz val="${format.fontSize ?? 11}"/>${color}<name val="${escapeXmlAttribute(format.fontFamily ?? "Calibri")}"/><family val="2"/></font>`;
 }
 
 function formatFillXml(fillColor: string) {
@@ -1020,6 +1024,11 @@ function normalizedFontSize(value?: number) {
   return normalized === 11 ? undefined : normalized;
 }
 
+function normalizedFontFamily(value?: string) {
+  const normalized = value?.trim().replace(/["<>]/g, "").slice(0, 80) ?? "";
+  return normalized && normalized.toLowerCase() !== "calibri" ? normalized : "";
+}
+
 function normalizedHorizontalAlign(value?: string) {
   const normalized = value?.trim().toLowerCase() ?? "";
   return normalized === "left" || normalized === "center" || normalized === "right" ? normalized : "";

src/types.ts

@@ -31,6 +31,7 @@ export interface CellFormat {
   underline?: boolean;
   strike?: boolean;
   fontSize?: number;
+  fontFamily?: string;
   textColor?: string;
   fillColor?: string;
   horizontalAlign?: "left" | "center" | "right";