@simplysm/excel 14.0.65 → 14.0.69

package/src/types.ts

@@ -128,10 +128,45 @@ export interface ExcelXmlWorksheetData {
         }[];
       },
     ];
+    conditionalFormatting?: ExcelXmlConditionalFormattingData[];
     drawing?: { $: { "r:id": string } }[];
   };
 }
 
+export interface ExcelXmlConditionalFormattingData {
+  $: { sqref: string };
+  cfRule: ExcelXmlCfRuleData[];
+}
+
+export interface ExcelXmlCfRuleData {
+  $: {
+    type:
+      | "cellIs"
+      | "containsText"
+      | "notContainsText"
+      | "beginsWith"
+      | "endsWith"
+      | "expression";
+    operator?:
+      | "lessThan"
+      | "lessThanOrEqual"
+      | "equal"
+      | "notEqual"
+      | "greaterThanOrEqual"
+      | "greaterThan"
+      | "between"
+      | "notBetween"
+      | "containsText"
+      | "notContains"
+      | "beginsWith"
+      | "endsWith";
+    priority: string;
+    dxfId: string;
+    text?: string;
+  };
+  formula: string[];
+}
+
 export interface ExcelRowData {
   $: {
     r: string; // 주소 (1~)
@@ -236,7 +271,7 @@ export interface ExcelXmlStyleData {
     fonts: [
       {
         $: { count: string };
-        font: {}[];
+        font: ExcelXmlStyleDataFont[];
       },
     ];
     fills: [
@@ -257,9 +292,44 @@ export interface ExcelXmlStyleData {
         xf: ExcelXmlStyleDataXf[];
       },
     ];
+    dxfs?: [
+      {
+        $: { count: string };
+        dxf: ExcelXmlStyleDataDxf[];
+      },
+    ];
   };
 }
 
+export interface ExcelXmlStyleDataFont {
+  sz?: [{ $: { val: string } }];
+  name?: [{ $: { val: string } }];
+  b?: [{}];
+  i?: [{}];
+  u?: [{ $?: { val?: ExcelFontUnderline } }];
+  strike?: [{}];
+  color?: [{ $: { rgb: string } }];
+}
+
+export interface ExcelXmlStyleDataDxf {
+  font?: [
+    {
+      b?: [{ $: { val: "0" | "1" } }];
+      color?: [{ $: { rgb: string } }];
+    },
+  ];
+  fill?: [
+    {
+      patternFill: [
+        {
+          $: { patternType?: "solid" };
+          bgColor?: [{ $: { rgb: string } }];
+        },
+      ];
+    },
+  ];
+}
+
 export interface ExcelXmlStyleDataXf {
   $: {
     numFmtId?: string;
@@ -364,6 +434,30 @@ export interface ExcelXml {
 export type ExcelBorderPosition = "left" | "right" | "top" | "bottom";
 export type ExcelHorizontalAlign = "center" | "left" | "right";
 export type ExcelVerticalAlign = "center" | "top" | "bottom";
+export type ExcelFontUnderline = "single" | "double" | "singleAccounting" | "doubleAccounting";
+
+/**
+ * 폰트 속성. cell 단위 override (`ExcelStyleOptions.font`) 와
+ * workbook default (`wb.setDefaultStyle({ font })`) 양쪽이 공유한다.
+ *
+ * 미지정 속성은 OOXML `<font>` 자식 엘리먼트로 emit 되지 않으며, Excel 자체 기본값으로 표시된다.
+ */
+export interface ExcelFont {
+  /** 폰트 크기 (pt) */
+  size?: number;
+  /** 폰트명 (예: "맑은 고딕", "Calibri") */
+  family?: string;
+  /** 굵게 */
+  bold?: boolean;
+  /** 기울임 */
+  italic?: boolean;
+  /** 밑줄 — `<u val="..."/>` 의 val 에 그대로 매핑 */
+  underline?: ExcelFontUnderline;
+  /** 글자색 (ARGB 8자리, 예: "00FF0000") */
+  color?: string;
+  /** 취소선 */
+  strike?: boolean;
+}
 
 /**
  * 셀 스타일 옵션
@@ -397,6 +491,58 @@ export interface ExcelStyleOptions {
    * `numberFormat`과 동시 지정 시 이 필드가 우선 적용된다.
    */
   numberFormatCode?: string;
+  /** 폰트 (size/family/bold/italic/underline/color/strike) */
+  font?: ExcelFont;
+}
+
+//#endregion
+
+//#region Conditional Format Types
+
+/**
+ * 조건부 서식 강조 스타일.
+ * 미지정 필드는 base 셀 스타일을 그대로 두고, 지정 필드만 OOXML dxf 로 emit 되어 native CF 오버레이로 합성된다.
+ */
+export interface ExcelConditionalRuleStyle {
+  /** 배경색 (ARGB 8자리, 예: "00FFFF00") */
+  background?: string;
+  /** 글자색 (ARGB 8자리) */
+  fontColor?: string;
+  /** 글자 굵기. "normal" 은 base 가 bold 라도 강제 normal. */
+  fontWeight?: "bold" | "normal";
 }
 
+/**
+ * 조건부 서식 규칙.
+ * - `cellIs` 단일 비교(`<`, `>`, `<=`, `>=`, `=`, `<>`): `value` 는 number 또는 string.
+ * - `cellIs` 구간(`between`, `notBetween`): `value` 는 [a, b] 튜플(양 끝 inclusive).
+ * - `text` 매칭(`contains`, `notContains`, `beginsWith`, `endsWith`): `value` 는 string. SEARCH 기반(대소문자 무시) 고정.
+ *
+ * `value: number` 는 raw formula(`<formula>4999</formula>`), `value: string` 은 따옴표 둘러싼 리터럴 formula(`<formula>"OK"</formula>`) 로 emit.
+ */
+export type ExcelConditionalRule =
+  | {
+      type: "cellIs";
+      op: "<" | ">" | "<=" | ">=" | "=" | "<>";
+      value: number | string;
+      style: ExcelConditionalRuleStyle;
+    }
+  | {
+      type: "cellIs";
+      op: "between" | "notBetween";
+      value: [number, number] | [string, string];
+      style: ExcelConditionalRuleStyle;
+    }
+  | {
+      type: "text";
+      op: "contains" | "notContains" | "beginsWith" | "endsWith";
+      value: string;
+      style: ExcelConditionalRuleStyle;
+    }
+  | {
+      type: "expression";
+      formula: string;
+      style: ExcelConditionalRuleStyle;
+    };
+
 //#endregion

package/src/utils/excel-style-data.ts

@@ -0,0 +1,31 @@
+import type { ZipCache } from "./zip-cache";
+import { ExcelXmlContentType } from "../xml/excel-xml-content-type";
+import { ExcelXmlRelationship } from "../xml/excel-xml-relationship";
+import { ExcelXmlStyle } from "../xml/excel-xml-style";
+
+/**
+ * `xl/styles.xml` 을 가져오거나, 없으면 새로 만들어 ZipCache 에 등록한다.
+ * Content_Types / workbook.xml.rels 에도 styles.xml 항목을 추가한다.
+ *
+ * `ExcelCell.setStyle` 과 `ExcelWorkbook.setDefaultStyle` 양쪽이 공유한다.
+ */
+export async function getOrCreateStyleData(zipCache: ZipCache): Promise<ExcelXmlStyle> {
+  let styleData = (await zipCache.get("xl/styles.xml")) as ExcelXmlStyle | undefined;
+  if (styleData == null) {
+    styleData = new ExcelXmlStyle();
+    zipCache.set("xl/styles.xml", styleData);
+
+    const typeData = (await zipCache.get("[Content_Types].xml")) as ExcelXmlContentType;
+    typeData.add(
+      "/xl/styles.xml",
+      "application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml",
+    );
+
+    const wbRelData = (await zipCache.get("xl/_rels/workbook.xml.rels")) as ExcelXmlRelationship;
+    wbRelData.add(
+      "styles.xml",
+      "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles",
+    );
+  }
+  return styleData;
+}

package/src/xml/excel-xml-style.ts

@@ -1,15 +1,21 @@
 import type {
   ExcelBorderPosition,
+  ExcelConditionalRuleStyle,
+  ExcelFont,
   ExcelHorizontalAlign,
+  ExcelStyleOptions,
   ExcelVerticalAlign,
   ExcelXml,
   ExcelXmlStyleData,
   ExcelXmlStyleDataBorder,
+  ExcelXmlStyleDataDxf,
   ExcelXmlStyleDataFill,
+  ExcelXmlStyleDataFont,
   ExcelXmlStyleDataXf,
 } from "../types";
 import "@simplysm/core-common";
 import { num, obj } from "@simplysm/core-common";
+import { ExcelUtils } from "../utils/excel-utils";
 
 export interface ExcelStyle {
   numFmtId?: string;
@@ -18,6 +24,50 @@ export interface ExcelStyle {
   background?: string;
   verticalAlign?: ExcelVerticalAlign;
   horizontalAlign?: ExcelHorizontalAlign;
+  font?: ExcelFont;
+}
+
+/**
+ * `ExcelStyleOptions` (사용자 표면) → 내부 `ExcelStyle` 변환.
+ * cell.setStyle 과 wb.setDefaultStyle 이 공유한다.
+ *
+ * - background ARGB 8자리 형식 검증
+ * - numberFormatCode 가 numberFormat 보다 우선
+ * - font 는 그대로 전달 (구체 검증은 ExcelXmlStyle 내부에서 수행)
+ */
+export function convertExcelStyleOptions(opts: ExcelStyleOptions): ExcelStyle {
+  const style: ExcelStyle = {};
+
+  if (opts.background != null) {
+    if (!/^[0-9A-F]{8}$/i.test(opts.background)) {
+      throw new Error("잘못된 색상 형식입니다. (형식: 00000000: alpha(반전)+rgb)");
+    }
+    style.background = opts.background;
+  }
+
+  if (opts.border != null) {
+    style.border = opts.border;
+  }
+
+  if (opts.horizontalAlign != null) {
+    style.horizontalAlign = opts.horizontalAlign;
+  }
+
+  if (opts.verticalAlign != null) {
+    style.verticalAlign = opts.verticalAlign;
+  }
+
+  if (opts.numberFormatCode != null) {
+    style.numFmtCode = opts.numberFormatCode;
+  } else if (opts.numberFormat != null) {
+    style.numFmtId = ExcelUtils.convertNumFmtNameToId(opts.numberFormat).toString();
+  }
+
+  if (opts.font != null) {
+    style.font = opts.font;
+  }
+
+  return style;
 }
 
 /**
@@ -70,41 +120,21 @@ export class ExcelXmlStyle implements ExcelXml {
 
   add(style: ExcelStyle): string {
     const newXf: ExcelXmlStyleDataXf = { $: {} };
-
-    if (style.numFmtId != null) {
-      newXf.$.numFmtId = style.numFmtId;
-    }
-
-    if (style.numFmtCode != null) {
-      newXf.$.numFmtId = this._setNumFmtCode(style.numFmtCode);
-      newXf.$.applyNumberFormat = "1";
-    }
-
-    if (style.background != null) {
-      const newFill: ExcelXmlStyleDataFill = {
-        patternFill: [
-          {
-            $: { patternType: "solid" },
-            fgColor: [{ $: { rgb: style.background.toUpperCase() } }],
-          },
-        ],
-      };
-
-      newXf.$.applyFill = "1";
-      newXf.$.fillId = this._getSameOrCreateFill(newFill);
-    }
-
-    if (style.border != null) {
-      const newBorder = this._createBorderFromPositions(style.border);
-      newXf.$.applyBorder = "1";
-      newXf.$.borderId = this._getSameOrCreateBorder(newBorder);
-    }
-
-    this._applyAlignment(newXf, style);
-
+    this._applyStyleToXf(newXf, style);
     return this._getSameOrCreateXf(newXf);
   }
 
+  /**
+   * 워크북 default cell style 설정. `cellXfs[0].xf[0]` (OOXML default cell style 자리) 을 새로 빌드해 덮어쓴다.
+   * fonts/fills/borders/numFmts 자원은 `_getSameOrCreate*` 로 누적·dedup 되고 인덱스가 cellXfs[0] 에 박힌다.
+   * 미호출 시 기존 cellXfs[0] 그대로 보존된다.
+   */
+  setDefaultStyle(style: ExcelStyle): void {
+    const newXf: ExcelXmlStyleDataXf = { $: { numFmtId: "0" } };
+    this._applyStyleToXf(newXf, style);
+    this.data.styleSheet.cellXfs[0].xf[0] = newXf;
+  }
+
   addWithClone(id: string, style: ExcelStyle): string {
     const idNum = num.parseInt(id);
     if (idNum == null) {
@@ -179,6 +209,12 @@ export class ExcelXmlStyle implements ExcelXml {
       }
     }
 
+    if (style.font != null) {
+      this._validateFont(style.font);
+      cloneXf.$.applyFont = "1";
+      cloneXf.$.fontId = this._getSameOrCreateFont(this._buildFontXml(style.font));
+    }
+
     this._applyAlignment(cloneXf, style);
 
     return this._getSameOrCreateXf(cloneXf);
@@ -248,11 +284,67 @@ export class ExcelXmlStyle implements ExcelXml {
 
       result.verticalAlign = xf.alignment?.[0].$.vertical;
       result.horizontalAlign = xf.alignment?.[0].$.horizontal;
+
+      if (xf.$.fontId != null) {
+        const fontIdNum = num.parseInt(xf.$.fontId);
+        if (fontIdNum != null) {
+          const font = this.data.styleSheet.fonts[0].font[fontIdNum] as
+            | ExcelXmlStyleDataFont
+            | undefined;
+          if (font != null) {
+            const parsed = this._parseFontXml(font);
+            if (Object.keys(parsed).length > 0) {
+              result.font = parsed;
+            }
+          }
+        }
+      }
     }
 
     return result;
   }
 
+  addDxf(style: ExcelConditionalRuleStyle): string {
+    const dxfItem: ExcelXmlStyleDataDxf = {};
+
+    if (style.fontColor != null || style.fontWeight != null) {
+      const font: NonNullable<ExcelXmlStyleDataDxf["font"]>[number] = {};
+      if (style.fontWeight != null) {
+        font.b = [{ $: { val: style.fontWeight === "bold" ? "1" : "0" } }];
+      }
+      if (style.fontColor != null) {
+        font.color = [{ $: { rgb: style.fontColor.toUpperCase() } }];
+      }
+      dxfItem.font = [font];
+    }
+
+    if (style.background != null) {
+      dxfItem.fill = [
+        {
+          patternFill: [
+            {
+              $: { patternType: "solid" },
+              bgColor: [{ $: { rgb: style.background.toUpperCase() } }],
+            },
+          ],
+        },
+      ];
+    }
+
+    const dxfs = (this.data.styleSheet.dxfs = this.data.styleSheet.dxfs ?? [
+      { $: { count: "0" }, dxf: [] },
+    ]);
+
+    const prevSameDxf = dxfs[0].dxf.single((item) => obj.equal(item, dxfItem));
+    if (prevSameDxf != null) {
+      return dxfs[0].dxf.indexOf(prevSameDxf).toString();
+    }
+
+    dxfs[0].dxf.push(dxfItem);
+    dxfs[0].$.count = dxfs[0].dxf.length.toString();
+    return (dxfs[0].dxf.length - 1).toString();
+  }
+
   getNumFmtCode(numFmtId: string): string | undefined {
     return (this.data.styleSheet.numFmts?.[0].numFmt ?? []).single(
       (item) => item.$.numFmtId === numFmtId,
@@ -320,6 +412,108 @@ export class ExcelXmlStyle implements ExcelXml {
     return nextNumFmtId;
   }
 
+  private _applyStyleToXf(xf: ExcelXmlStyleDataXf, style: ExcelStyle): void {
+    if (style.numFmtId != null) {
+      xf.$.numFmtId = style.numFmtId;
+    }
+
+    if (style.numFmtCode != null) {
+      xf.$.numFmtId = this._setNumFmtCode(style.numFmtCode);
+      xf.$.applyNumberFormat = "1";
+    }
+
+    if (style.background != null) {
+      const newFill: ExcelXmlStyleDataFill = {
+        patternFill: [
+          {
+            $: { patternType: "solid" },
+            fgColor: [{ $: { rgb: style.background.toUpperCase() } }],
+          },
+        ],
+      };
+      xf.$.applyFill = "1";
+      xf.$.fillId = this._getSameOrCreateFill(newFill);
+    }
+
+    if (style.border != null) {
+      const newBorder = this._createBorderFromPositions(style.border);
+      xf.$.applyBorder = "1";
+      xf.$.borderId = this._getSameOrCreateBorder(newBorder);
+    }
+
+    if (style.font != null) {
+      this._validateFont(style.font);
+      xf.$.applyFont = "1";
+      xf.$.fontId = this._getSameOrCreateFont(this._buildFontXml(style.font));
+    }
+
+    this._applyAlignment(xf, style);
+  }
+
+  private _validateFont(font: ExcelFont): void {
+    if (font.color != null && !/^[0-9A-F]{8}$/i.test(font.color)) {
+      throw new Error("잘못된 폰트 색상 형식입니다. (형식: 00000000: alpha(반전)+rgb)");
+    }
+  }
+
+  private _buildFontXml(font: ExcelFont): ExcelXmlStyleDataFont {
+    const result: ExcelXmlStyleDataFont = {};
+    if (font.size != null) {
+      result.sz = [{ $: { val: font.size.toString() } }];
+    }
+    if (font.family != null) {
+      result.name = [{ $: { val: font.family } }];
+    }
+    if (font.bold === true) {
+      result.b = [{}];
+    }
+    if (font.italic === true) {
+      result.i = [{}];
+    }
+    if (font.underline != null) {
+      result.u = [{ $: { val: font.underline } }];
+    }
+    if (font.strike === true) {
+      result.strike = [{}];
+    }
+    if (font.color != null) {
+      result.color = [{ $: { rgb: font.color.toUpperCase() } }];
+    }
+    return result;
+  }
+
+  private _parseFontXml(item: ExcelXmlStyleDataFont): ExcelFont {
+    const result: ExcelFont = {};
+    if (item.sz?.[0].$.val != null) {
+      const sz = num.parseFloat(item.sz[0].$.val);
+      if (sz != null) result.size = sz;
+    }
+    if (item.name?.[0].$.val != null) {
+      result.family = item.name[0].$.val;
+    }
+    if (item.b != null) result.bold = true;
+    if (item.i != null) result.italic = true;
+    if (item.u != null) {
+      result.underline = item.u[0].$?.val ?? "single";
+    }
+    if (item.strike != null) result.strike = true;
+    if (item.color?.[0].$.rgb != null) {
+      result.color = item.color[0].$.rgb;
+    }
+    return result;
+  }
+
+  private _getSameOrCreateFont(item: ExcelXmlStyleDataFont): string {
+    const prevSameFont = this.data.styleSheet.fonts[0].font.single((f) => obj.equal(f, item));
+    if (prevSameFont != null) {
+      return this.data.styleSheet.fonts[0].font.indexOf(prevSameFont).toString();
+    } else {
+      this.data.styleSheet.fonts[0].font.push(item);
+      this.data.styleSheet.fonts[0].$.count = this.data.styleSheet.fonts[0].font.length.toString();
+      return (this.data.styleSheet.fonts[0].font.length - 1).toString();
+    }
+  }
+
   private _applyAlignment(xf: ExcelXmlStyleDataXf, style: ExcelStyle): void {
     if (style.verticalAlign != null) {
       xf.$.applyAlignment = "1";

package/src/xml/excel-xml-worksheet.ts

@@ -4,6 +4,7 @@ import type {
   ExcelCellType,
   ExcelRowData,
   ExcelXml,
+  ExcelXmlCfRuleData,
   ExcelXmlWorksheetData,
 } from "../types";
 import { ExcelUtils } from "../utils/excel-utils";
@@ -221,6 +222,41 @@ export class ExcelXmlWorksheet implements ExcelXml {
     }
   }
 
+  /**
+   * `<conditionalFormatting>` 블록을 시트에 push.
+   * priority 는 시트 전역 카운터(기존 cfRule 의 최대 priority + 1)부터 호출 내 rules 순서대로 부여.
+   */
+  addConditionalFormatting(sqref: string, rules: { dxfId: string; cfRule: Omit<ExcelXmlCfRuleData["$"], "priority" | "dxfId"> & { formula: string[] } }[]): void {
+    const cfList = (this.data.worksheet.conditionalFormatting =
+      this.data.worksheet.conditionalFormatting ?? []);
+
+    let nextPriority = 1;
+    for (const block of cfList) {
+      for (const rule of block.cfRule) {
+        const p = num.parseInt(rule.$.priority);
+        if (p != null && p >= nextPriority) {
+          nextPriority = p + 1;
+        }
+      }
+    }
+
+    const cfRuleData: ExcelXmlCfRuleData[] = rules.map((r) => ({
+      $: {
+        type: r.cfRule.type,
+        priority: (nextPriority++).toString(),
+        dxfId: r.dxfId,
+        ...(r.cfRule.operator != null ? { operator: r.cfRule.operator } : {}),
+        ...(r.cfRule.text != null ? { text: r.cfRule.text } : {}),
+      },
+      formula: r.cfRule.formula,
+    }));
+
+    cfList.push({
+      $: { sqref },
+      cfRule: cfRuleData,
+    });
+  }
+
   shiftMergeCells(fromRow: number, delta: number): void {
     const mergeCells = this.data.worksheet.mergeCells;
     if (mergeCells == null) return;
@@ -445,6 +481,7 @@ export class ExcelXmlWorksheet implements ExcelXml {
       if (key === "cols") continue;
       if (key === "sheetViews") continue;
       if (key === "sheetFormatPr") continue;
+      if (key === "conditionalFormatting") continue;
 
       if (key === "sheetData") {
         if (this.data.worksheet.sheetViews != null) {
@@ -461,6 +498,9 @@ export class ExcelXmlWorksheet implements ExcelXml {
         if (this.data.worksheet.mergeCells != null) {
           result.mergeCells = this.data.worksheet.mergeCells;
         }
+        if (this.data.worksheet.conditionalFormatting != null) {
+          result.conditionalFormatting = this.data.worksheet.conditionalFormatting;
+        }
       } else {
         const worksheetRec = this.data.worksheet as Record<string, unknown>;
         const resultRec = result as Record<string, unknown>;