@simplysm/excel 13.0.0-beta.5 → 13.0.0-beta.50

package/tests/image-insert.spec.ts

@@ -1,188 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { ExcelWorkbook } from "../src/excel-workbook";
-
-// globalThis.window가 없으면 Node.js 환경
-declare const window: unknown;
-// Node.js 전용 타입 (browser 환경에서도 타입체크가 통과되도록)
-declare const require: (id: string) => unknown;
-
-/**
- * PNG 파일 로드 (Node/브라우저 환경 분기)
- */
-async function loadPngFile(): Promise<Uint8Array> {
-  const url = new URL("./fixtures/logo.png", import.meta.url);
-
-  // Node 환경: fs 사용
-  if (typeof window === "undefined") {
-    const fs = require("fs") as { readFileSync: (path: string) => Uint8Array };
-    const { fileURLToPath } = require("url") as { fileURLToPath: (url: URL) => string };
-    const filePath = fileURLToPath(url);
-    return new Uint8Array(fs.readFileSync(filePath));
-  }
-
-  // 브라우저 환경: fetch 사용
-  const response = await fetch(url);
-  const arrayBuffer = await response.arrayBuffer();
-  return new Uint8Array(arrayBuffer);
-}
-
-/**
- * 통합 테스트: ExcelWorksheet.addImage 동작 검증
- */
-
-describe("ExcelWorksheet.addImage integration", () => {
-  it("should write media, drawing, drawing rels, worksheet rel and content types", async () => {
-    const wb = new ExcelWorkbook();
-    const ws = await wb.createWorksheet("Sheet1");
-
-    const bytes = await loadPngFile();
-
-    // call addImage (the single entry API)
-    await ws.addImage({
-      bytes,
-      ext: "png",
-      from: { r: 0, c: 0 },
-      to: { r: 2, c: 2 },
-    });
-
-    // --- 1) media 존재 및 내용 검사
-    const mediaPath = `xl/media/image1.png`;
-    const mediaObj = await (ws as any)._zipCache.get(mediaPath);
-    expect(mediaObj).toBeDefined();
-    expect(mediaObj instanceof Uint8Array).toBe(true);
-    expect(mediaObj).toEqual(bytes);
-
-    // --- 2) Content Types 에 media / drawing override 존재
-    const types = await (ws as any)._zipCache.get("[Content_Types].xml");
-    expect(types).toBeDefined();
-    // types는 ExcelXmlContentType 인스턴스일 가능성이 높음
-    const overrides = types.data?.Types?.Override ?? [];
-    expect(overrides.some((o: any) => o.$.PartName === "/xl/media/image1.png")).toBeTruthy();
-    expect(overrides.some((o: any) => o.$.PartName === "/xl/drawings/drawing1.xml")).toBeTruthy();
-
-    // --- 3) drawing xml(객체) 존재 및 a:blip r:embed가 rId로 설정되어 있는지 확인
-    const drawingPath = "xl/drawings/drawing1.xml";
-    const drawingObj = await (ws as any)._zipCache.get(drawingPath);
-    expect(drawingObj).toBeDefined();
-
-    // drawingObj는 객체(ExcelXmlDrawing)일 가능성이 높음 — 내부 구조 확인
-    const wsDr = drawingObj?.data?.wsDr;
-    expect(wsDr).toBeDefined();
-    const anchors = wsDr.twoCellAnchor ?? [];
-    expect(anchors.length).toBeGreaterThan(0);
-    const pic = anchors[0].pic?.[0];
-    expect(pic).toBeDefined();
-    const aBlip = pic?.blipFill?.[0]?.["a:blip"]?.[0];
-    expect(aBlip).toBeDefined();
-    const embedVal = aBlip?.$?.["r:embed"];
-    expect(typeof embedVal === "string" && /^rId\d+$/.test(embedVal)).toBeTruthy();
-
-    // --- 4) drawing rels 존재 및 media target 참조
-    const drawingRels = await (ws as any)._zipCache.get("xl/drawings/_rels/drawing1.xml.rels");
-    expect(drawingRels).toBeDefined();
-    const relsArr = drawingRels?.data?.Relationships?.Relationship ?? [];
-    expect(relsArr.some((r: any) => r.$.Target === "../media/image1.png")).toBeTruthy();
-
-    // --- 5) worksheet rels에 drawing rel 추가 및 worksheet xml에 <drawing r:id="..."/> 존재
-    const sheetFileName = (ws as any)._targetFileName; // e.g., "sheet1.xml"
-    const sheetRelsPath = `xl/worksheets/_rels/${sheetFileName}.rels`;
-    const sheetRels = await (ws as any)._zipCache.get(sheetRelsPath);
-    expect(sheetRels).toBeDefined();
-    const sheetRelsArr = sheetRels?.data?.Relationships?.Relationship ?? [];
-    expect(
-      sheetRelsArr.some((r: any) => r.$.Target != null && r.$.Target.indexOf("/drawings/drawing") !== -1),
-    ).toBeTruthy();
-
-    const wsXml = await (ws as any)._zipCache.get(`xl/worksheets/${sheetFileName}`);
-    expect(wsXml).toBeDefined();
-    expect(Array.isArray(wsXml.data?.worksheet?.drawing)).toBeTruthy();
-    const drawingElems = wsXml.data.worksheet.drawing;
-    expect(drawingElems.some((d: any) => d.$ != null && d.$["r:id"] != null)).toBeTruthy();
-
-    // Buffer 생성 검증
-    const resultBuffer = await wb.getBytes();
-    expect(resultBuffer).toBeDefined();
-    expect(resultBuffer.length).toBeGreaterThan(0);
-  });
-
-  it("같은 워크시트에 여러 이미지를 삽입할 수 있다", async () => {
-    const wb = new ExcelWorkbook();
-    const ws = await wb.createWorksheet("Sheet1");
-
-    const bytes = await loadPngFile();
-
-    // 첫 번째 이미지 삽입
-    await ws.addImage({
-      bytes,
-      ext: "png",
-      from: { r: 0, c: 0 },
-      to: { r: 2, c: 2 },
-    });
-
-    // 두 번째 이미지 삽입 (다른 위치)
-    await ws.addImage({
-      bytes,
-      ext: "png",
-      from: { r: 3, c: 0 },
-      to: { r: 5, c: 2 },
-    });
-
-    // --- 1) 두 개의 media 파일이 각각 생성되었는지 확인
-    const media1 = await (ws as any)._zipCache.get("xl/media/image1.png");
-    const media2 = await (ws as any)._zipCache.get("xl/media/image2.png");
-    expect(media1).toBeDefined();
-    expect(media2).toBeDefined();
-    expect(media1 instanceof Uint8Array).toBe(true);
-    expect(media2 instanceof Uint8Array).toBe(true);
-
-    // --- 2) Content Types에 두 이미지가 모두 등록되었는지 확인
-    const types = await (ws as any)._zipCache.get("[Content_Types].xml");
-    const overrides = types.data?.Types?.Override ?? [];
-    expect(overrides.some((o: any) => o.$.PartName === "/xl/media/image1.png")).toBeTruthy();
-    expect(overrides.some((o: any) => o.$.PartName === "/xl/media/image2.png")).toBeTruthy();
-
-    // --- 3) drawing xml에 두 개의 anchor가 있는지 확인
-    const drawingObj = await (ws as any)._zipCache.get("xl/drawings/drawing1.xml");
-    const anchors = drawingObj?.data?.wsDr?.twoCellAnchor ?? [];
-    expect(anchors.length).toBe(2);
-
-    // 첫 번째 이미지 anchor
-    const pic1 = anchors[0].pic?.[0];
-    expect(pic1).toBeDefined();
-    const embed1 = pic1?.blipFill?.[0]?.["a:blip"]?.[0]?.$?.["r:embed"];
-    expect(embed1).toBeDefined();
-
-    // 두 번째 이미지 anchor
-    const pic2 = anchors[1].pic?.[0];
-    expect(pic2).toBeDefined();
-    const embed2 = pic2?.blipFill?.[0]?.["a:blip"]?.[0]?.$?.["r:embed"];
-    expect(embed2).toBeDefined();
-
-    // 서로 다른 rId인지 확인
-    expect(embed1).not.toBe(embed2);
-
-    // --- 4) drawing rels에 두 이미지에 대한 관계가 있는지 확인
-    const drawingRels = await (ws as any)._zipCache.get("xl/drawings/_rels/drawing1.xml.rels");
-    const relsArr = drawingRels?.data?.Relationships?.Relationship ?? [];
-    expect(relsArr.some((r: any) => r.$.Target === "../media/image1.png")).toBeTruthy();
-    expect(relsArr.some((r: any) => r.$.Target === "../media/image2.png")).toBeTruthy();
-
-    // Buffer 생성 검증
-    const resultBuffer = await wb.getBytes();
-    expect(resultBuffer).toBeDefined();
-    expect(resultBuffer.length).toBeGreaterThan(0);
-  });
-
-  it("지원되지 않는 확장자는 에러 발생", async () => {
-    const wb = new ExcelWorkbook();
-    const ws = await wb.createWorksheet("Sheet1");
-
-    await expect(
-      ws.addImage({
-        bytes: new Uint8Array([0, 1, 2, 3]),
-        ext: "xyz123",
-        from: { r: 0, c: 0 },
-      }),
-    ).rejects.toThrow("MIME 타입을 확인할 수 없습니다");
-  });
-});

package/tests/utils/excel-utils.spec.ts

@@ -1,240 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { ExcelUtils } from "../../src/utils/excel-utils";
-
-describe("ExcelUtils", () => {
-  describe("stringifyColAddr / parseColAddrCode", () => {
-    it("0-25를 A-Z로 변환한다", () => {
-      expect(ExcelUtils.stringifyColAddr(0)).toBe("A");
-      expect(ExcelUtils.stringifyColAddr(1)).toBe("B");
-      expect(ExcelUtils.stringifyColAddr(25)).toBe("Z");
-    });
-
-    it("26 이상을 AA, AB 등으로 변환한다", () => {
-      expect(ExcelUtils.stringifyColAddr(26)).toBe("AA");
-      expect(ExcelUtils.stringifyColAddr(27)).toBe("AB");
-      expect(ExcelUtils.stringifyColAddr(51)).toBe("AZ");
-      expect(ExcelUtils.stringifyColAddr(52)).toBe("BA");
-    });
-
-    it("큰 열 인덱스도 처리한다", () => {
-      // 702 = AAA (26^2 + 26 = 702)
-      expect(ExcelUtils.stringifyColAddr(702)).toBe("AAA");
-    });
-
-    it("Excel 최대 열 인덱스(XFD, 16383)를 처리한다", () => {
-      // Excel 최대 열은 XFD (16383번 인덱스, 0-based)
-      expect(ExcelUtils.stringifyColAddr(16383)).toBe("XFD");
-      expect(ExcelUtils.parseColAddrCode("XFD")).toBe(16383);
-    });
-
-    it("A-Z를 0-25로 파싱한다", () => {
-      expect(ExcelUtils.parseColAddrCode("A")).toBe(0);
-      expect(ExcelUtils.parseColAddrCode("B")).toBe(1);
-      expect(ExcelUtils.parseColAddrCode("Z")).toBe(25);
-    });
-
-    it("AA, AB 등을 26 이상으로 파싱한다", () => {
-      expect(ExcelUtils.parseColAddrCode("AA")).toBe(26);
-      expect(ExcelUtils.parseColAddrCode("AB")).toBe(27);
-      expect(ExcelUtils.parseColAddrCode("AZ")).toBe(51);
-      expect(ExcelUtils.parseColAddrCode("BA")).toBe(52);
-    });
-
-    it("셀 주소에서 열 인덱스를 파싱한다", () => {
-      expect(ExcelUtils.parseColAddrCode("A1")).toBe(0);
-      expect(ExcelUtils.parseColAddrCode("B10")).toBe(1);
-      expect(ExcelUtils.parseColAddrCode("AA100")).toBe(26);
-    });
-
-    it("라운드트립: stringify → parse가 원래 값을 반환한다", () => {
-      for (let i = 0; i < 100; i++) {
-        const stringified = ExcelUtils.stringifyColAddr(i);
-        const parsed = ExcelUtils.parseColAddrCode(stringified);
-        expect(parsed).toBe(i);
-      }
-    });
-
-    it("음수 열 인덱스 입력 시 에러", () => {
-      expect(() => ExcelUtils.stringifyColAddr(-1)).toThrow();
-      expect(() => ExcelUtils.stringifyColAddr(-100)).toThrow();
-    });
-  });
-
-  describe("stringifyRowAddr / parseRowAddrCode", () => {
-    it("0-based 인덱스를 1-based 문자열로 변환한다", () => {
-      expect(ExcelUtils.stringifyRowAddr(0)).toBe("1");
-      expect(ExcelUtils.stringifyRowAddr(9)).toBe("10");
-      expect(ExcelUtils.stringifyRowAddr(99)).toBe("100");
-    });
-
-    it("1-based 문자열을 0-based 인덱스로 파싱한다", () => {
-      expect(ExcelUtils.parseRowAddrCode("A1")).toBe(0);
-      expect(ExcelUtils.parseRowAddrCode("B10")).toBe(9);
-      expect(ExcelUtils.parseRowAddrCode("AA100")).toBe(99);
-    });
-  });
-
-  describe("stringifyAddr / parseCellAddrCode", () => {
-    it("셀 주소를 올바르게 변환한다", () => {
-      expect(ExcelUtils.stringifyAddr({ r: 0, c: 0 })).toBe("A1");
-      expect(ExcelUtils.stringifyAddr({ r: 9, c: 1 })).toBe("B10");
-      expect(ExcelUtils.stringifyAddr({ r: 99, c: 26 })).toBe("AA100");
-    });
-
-    it("셀 주소를 올바르게 파싱한다", () => {
-      expect(ExcelUtils.parseCellAddrCode("A1")).toEqual({ r: 0, c: 0 });
-      expect(ExcelUtils.parseCellAddrCode("B10")).toEqual({ r: 9, c: 1 });
-      expect(ExcelUtils.parseCellAddrCode("AA100")).toEqual({ r: 99, c: 26 });
-    });
-  });
-
-  describe("parseRangeAddrCode / stringifyRangeAddr", () => {
-    it("단일 셀 범위를 파싱한다", () => {
-      const range = ExcelUtils.parseRangeAddrCode("A1");
-      expect(range.s).toEqual({ r: 0, c: 0 });
-      expect(range.e).toEqual({ r: 0, c: 0 });
-    });
-
-    it("다중 셀 범위를 파싱한다", () => {
-      const range = ExcelUtils.parseRangeAddrCode("A1:C3");
-      expect(range.s).toEqual({ r: 0, c: 0 });
-      expect(range.e).toEqual({ r: 2, c: 2 });
-    });
-
-    it("단일 셀 범위를 문자열로 변환한다", () => {
-      const addr = ExcelUtils.stringifyRangeAddr({
-        s: { r: 0, c: 0 },
-        e: { r: 0, c: 0 },
-      });
-      expect(addr).toBe("A1");
-    });
-
-    it("다중 셀 범위를 문자열로 변환한다", () => {
-      const addr = ExcelUtils.stringifyRangeAddr({
-        s: { r: 0, c: 0 },
-        e: { r: 2, c: 2 },
-      });
-      expect(addr).toBe("A1:C3");
-    });
-  });
-
-  describe("convertTimeTickToNumber / convertNumberToTimeTick", () => {
-    it("1970-01-01을 올바르게 변환한다", () => {
-      const date = new Date(Date.UTC(1970, 0, 1, 0, 0, 0));
-      const tick = date.getTime();
-      const excelNum = ExcelUtils.convertTimeTickToNumber(tick);
-      // 1970-01-01은 Excel 기준 25569일째
-      expect(excelNum).toBeCloseTo(25569, 0);
-    });
-
-    it("2024-06-15를 올바르게 변환한다", () => {
-      const date = new Date(Date.UTC(2024, 5, 15, 0, 0, 0));
-      const tick = date.getTime();
-      const excelNum = ExcelUtils.convertTimeTickToNumber(tick);
-      // 대략적인 값 확인
-      expect(excelNum).toBeGreaterThan(45000);
-    });
-
-    it("시간 포함 날짜를 올바르게 변환한다", () => {
-      const date = new Date(Date.UTC(2024, 5, 15, 12, 0, 0));
-      const tick = date.getTime();
-      const excelNum = ExcelUtils.convertTimeTickToNumber(tick);
-      // 12시 = 0.5일 추가
-      const baseNum = ExcelUtils.convertTimeTickToNumber(new Date(Date.UTC(2024, 5, 15, 0, 0, 0)).getTime());
-      expect(excelNum - baseNum).toBeCloseTo(0.5, 1);
-    });
-
-    it("라운드트립: tick → number → tick이 원래 값을 반환한다", () => {
-      const originalDate = new Date(Date.UTC(2024, 5, 15, 14, 30, 45));
-      const tick = originalDate.getTime();
-      const excelNum = ExcelUtils.convertTimeTickToNumber(tick);
-      const recoveredTick = ExcelUtils.convertNumberToTimeTick(excelNum);
-      // 밀리초 단위까지 정확히 일치하지 않을 수 있으므로 초 단위로 비교
-      expect(Math.floor(recoveredTick / 1000)).toBe(Math.floor(tick / 1000));
-    });
-  });
-
-  describe("convertNumFmtCodeToName", () => {
-    it("General을 number로 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtCodeToName("General")).toBe("number");
-    });
-
-    it("날짜 패턴을 DateOnly로 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtCodeToName("yyyy-mm-dd")).toBe("DateOnly");
-      expect(ExcelUtils.convertNumFmtCodeToName("yy/mm/dd")).toBe("DateOnly");
-      expect(ExcelUtils.convertNumFmtCodeToName("dd-mmm-yyyy")).toBe("DateOnly");
-    });
-
-    // NOTE: 현재 구현에서 'mm'은 날짜(month)와 시간(minute) 둘 다에서 사용됨
-    // 정규식: hasDate = /yy|dd|mm/i, hasTime = /hh|ss/i
-    // 따라서 "hh:mm:ss"는 hasDate(mm)=true, hasTime(hh,ss)=true → DateTime
-    // "h:mm"은 hasDate(mm)=true, hasTime=false (h는 hh가 아님) → DateOnly
-    it("시간 패턴을 처리한다 (mm 모호성 주의)", () => {
-      // "hh:mm:ss": hasDate(mm)=true, hasTime(hh,ss)=true → DateTime
-      expect(ExcelUtils.convertNumFmtCodeToName("hh:mm:ss")).toBe("DateTime");
-      // "h:mm": hasDate(mm)=true, hasTime=false (h≠hh) → DateOnly
-      expect(ExcelUtils.convertNumFmtCodeToName("h:mm")).toBe("DateOnly");
-      // 순수 시간 포맷 (ss만 있고 mm 없는 경우)
-      expect(ExcelUtils.convertNumFmtCodeToName("[h]:ss")).toBe("Time");
-    });
-
-    it("날짜+시간 패턴을 DateTime으로 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtCodeToName("yyyy-mm-dd hh:mm:ss")).toBe("DateTime");
-      // "yy/mm/dd h:mm"는 날짜만 감지됨 (h:mm에서 hh가 아니고 ss도 없으므로)
-      expect(ExcelUtils.convertNumFmtCodeToName("yy/mm/dd h:mm")).toBe("DateOnly");
-      // 명확한 DateTime 패턴
-      expect(ExcelUtils.convertNumFmtCodeToName("yyyy/mm/dd hh:mm:ss")).toBe("DateTime");
-    });
-
-    it("숫자 패턴을 number로 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtCodeToName("#,##0")).toBe("number");
-      expect(ExcelUtils.convertNumFmtCodeToName("0.00")).toBe("number");
-      expect(ExcelUtils.convertNumFmtCodeToName("#,0")).toBe("number");
-    });
-
-    it("알 수 없는 포맷 코드 입력 시 에러", () => {
-      expect(() => ExcelUtils.convertNumFmtCodeToName("unknown-format-xyz")).toThrow();
-    });
-  });
-
-  describe("convertNumFmtIdToName", () => {
-    it("일반적인 숫자 포맷을 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtIdToName(0)).toBe("number");
-      expect(ExcelUtils.convertNumFmtIdToName(1)).toBe("number");
-      expect(ExcelUtils.convertNumFmtIdToName(2)).toBe("number");
-    });
-
-    it("날짜 포맷을 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtIdToName(14)).toBe("DateOnly");
-      expect(ExcelUtils.convertNumFmtIdToName(15)).toBe("DateOnly");
-    });
-
-    it("날짜+시간 포맷을 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtIdToName(22)).toBe("DateTime");
-    });
-
-    it("시간 포맷을 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtIdToName(18)).toBe("Time");
-      expect(ExcelUtils.convertNumFmtIdToName(19)).toBe("Time");
-    });
-
-    it("텍스트 포맷을 인식한다", () => {
-      expect(ExcelUtils.convertNumFmtIdToName(49)).toBe("string");
-    });
-
-    it("알 수 없는 numFmtId 입력 시 에러", () => {
-      expect(() => ExcelUtils.convertNumFmtIdToName(23)).toThrow();
-      expect(() => ExcelUtils.convertNumFmtIdToName(100)).toThrow();
-    });
-  });
-
-  describe("convertNumFmtNameToId", () => {
-    it("포맷 이름을 ID로 변환한다", () => {
-      expect(ExcelUtils.convertNumFmtNameToId("number")).toBe(0);
-      expect(ExcelUtils.convertNumFmtNameToId("DateOnly")).toBe(14);
-      expect(ExcelUtils.convertNumFmtNameToId("DateTime")).toBe(22);
-      expect(ExcelUtils.convertNumFmtNameToId("Time")).toBe(18);
-      expect(ExcelUtils.convertNumFmtNameToId("string")).toBe(49);
-    });
-  });
-});