@topgrid/grid-export 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,138 @@
+import { Table } from '@tanstack/react-table';
+import { E as ExcelExportOptions, C as CSVExportOptions, P as PDFExportOptions, a as ClipboardOptions, b as PrintOptions, c as ExcelColumn, d as ExportRowsOptions } from './types-BCeqH-13.cjs';
+export { D as DownloadExcelOptions, e as EmptyBehavior, f as ExportScope } from './types-BCeqH-13.cjs';
+
+/**
+ * TanStack Table 인스턴스를 기반으로 Excel(.xlsx) 파일을 생성·다운로드한다.
+ *
+ * @param table - TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options - Excel export 옵션 (fileName, sheetName, scope, emptyBehavior)
+ * @returns void (동기 실행 — xlsx.writeFile 동기 API, D3)
+ *
+ * @remarks
+ * **대용량 데이터 경고**: scope='all' 또는 대용량 필터 결과(>10,000행) 시
+ * xlsx.writeFile 이 동기 실행되어 브라우저 메인 스레드를 블로킹할 수 있습니다.
+ * 대용량 사용 시 Web Worker 래핑 권장 (EC-05).
+ *
+ * @example
+ * // 기본 사용 (filtered 행)
+ * exportToExcel(table, { fileName: '데이터.xlsx' });
+ *
+ * @example
+ * // 선택 행 + 다중행 헤더
+ * exportToExcel(table, {
+ *   fileName: '선택데이터.xlsx',
+ *   sheetName: '선택목록',
+ *   scope: 'selected',
+ *   emptyBehavior: 'empty',
+ * });
+ */
+declare function exportToExcel<TData>(table: Table<TData>, options?: ExcelExportOptions): void;
+
+/**
+ * TanStack Table 인스턴스를 기반으로 CSV 파일을 생성·다운로드한다.
+ * UTF-8 BOM() 포함 — 한국어 Excel 정상 표시 (AC-004).
+ *
+ * @param table  TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options CSV export 옵션 (fileName, scope, delimiter, emptyBehavior)
+ * @returns void (순수 string 조작 + createObjectURL — 외부 라이브러리 0, D5)
+ *
+ * @remarks
+ * **브라우저 전용**: URL.createObjectURL / document.createElement — SSR 환경 불가.
+ *
+ * @example
+ * // 기본 사용 (filtered 행, 쉼표 구분자)
+ * exportToCSV(table, { fileName: '데이터.csv' });
+ *
+ * @example
+ * // TSV + 선택 행
+ * exportToCSV(table, { fileName: '선택.tsv', delimiter: '\t', scope: 'selected' });
+ */
+declare function exportToCSV<TData>(table: Table<TData>, options?: CSVExportOptions): void;
+
+/**
+ * TanStack Table 인스턴스를 기반으로 PDF 파일을 생성·다운로드한다.
+ * jspdf + jspdf-autotable을 optional peer로 dynamic import하여 사용.
+ *
+ * @param table   - TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options - PDF export 옵션 (fileName, title, scope, orientation, fontFamily, emptyBehavior)
+ * @returns Promise<void> — jspdf dynamic import 후 완료
+ * @throws Error jspdf 또는 jspdf-autotable이 설치되지 않은 경우
+ *
+ * @remarks
+ * **peer 설치 필요**: jspdf + jspdf-autotable은 optional peerDependency.
+ * 사용 전 `npm install jspdf jspdf-autotable` 실행 필요.
+ *
+ * **한국어 폰트**: `fontFamily: 'korean'` 옵션은 W1 리스크 (loadKoreanFont.ts stub 상태).
+ * 실 폰트 base64 데이터 확보 + 라이선스 확인 후 loadKoreanFont.ts 구현 완료 필요.
+ *
+ * @example
+ * // 기본 사용 (portrait, filtered, Helvetica)
+ * await exportToPdf(table, { fileName: '보고서.pdf' });
+ *
+ * @example
+ * // 가로 방향 + 전체 행 + 제목
+ * await exportToPdf(table, {
+ *   fileName: '전체데이터.pdf',
+ *   title: '2026년 데이터 목록',
+ *   scope: 'all',
+ *   orientation: 'l',
+ *   emptyBehavior: 'empty',
+ * });
+ */
+declare function exportToPdf<TData>(table: Table<TData>, options?: PDFExportOptions): Promise<void>;
+
+/**
+ * TanStack Table 데이터를 TSV 포맷으로 클립보드에 복사한다.
+ * TSV(탭 구분, 줄바꿈 행 구분) — Excel 붙여넣기 호환.
+ *
+ * navigator.clipboard 미지원 환경: document.execCommand('copy') fallback 시도.
+ * fallback도 실패 시 Error('[grid-export] copyToClipboard: Clipboard API not supported') throw.
+ *
+ * @param table  TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options 클립보드 복사 옵션 (scope, emptyBehavior)
+ * @returns Promise<void> — navigator.clipboard.writeText 는 async
+ *
+ * @example
+ * await copyToClipboard(table);
+ *
+ * @example
+ * await copyToClipboard(table, { scope: 'selected' });
+ */
+declare function copyToClipboard<TData>(table: Table<TData>, options?: ClipboardOptions): Promise<void>;
+
+/**
+ * TanStack Table 데이터를 새 팝업 창에 HTML 테이블로 렌더링하여 인쇄 대화상자를 연다.
+ * 순수 Web API 전용 (window.open + document.write + window.print).
+ *
+ * 팝업 차단 환경: console.warn 후 즉시 반환 (D7 — throw 하지 않음).
+ * printGrid 자체는 동기 반환 (void). 실제 print 발화는 popup.onload 내에서 비동기 실행 (D4).
+ *
+ * @param table  TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options 인쇄 옵션 (title, scope, orientation, emptyBehavior)
+ * @returns void
+ *
+ * @example
+ * printGrid(table);
+ *
+ * @example
+ * printGrid(table, { title: '계약 목록', scope: 'filtered', orientation: 'l' });
+ */
+declare function printGrid<TData>(table: Table<TData>, options?: PrintOptions): void;
+
+/**
+ * 행 배열을 Excel 파일(.xlsx)로 다운로드한다.
+ *
+ * TanStack `Table<TData>` 인스턴스 없이 사용 가능.
+ * `@topgrid/grid-export` 의 `exportToExcel(table, options)` 와 평행 지원 (ADR-005 옵션 A).
+ *
+ * @example
+ * exportRowsToExcel(rows, columns, { fileName: '보고서_2026.xlsx' });
+ *
+ * @param rows     내보낼 데이터 행 배열
+ * @param columns  컬럼 정의 배열 (key / header / width? / format?)
+ * @param options  파일명·시트명·emptyBehavior 옵션
+ */
+declare function exportRowsToExcel<TData extends Record<string, unknown>>(rows: TData[], columns: ExcelColumn[], options?: ExportRowsOptions): void;
+
+export { CSVExportOptions, ClipboardOptions, ExcelColumn, ExcelExportOptions, ExportRowsOptions, PDFExportOptions, PrintOptions, copyToClipboard, exportRowsToExcel, exportToCSV, exportToExcel, exportToPdf, printGrid };

package/dist/index.d.ts

@@ -0,0 +1,138 @@
+import { Table } from '@tanstack/react-table';
+import { E as ExcelExportOptions, C as CSVExportOptions, P as PDFExportOptions, a as ClipboardOptions, b as PrintOptions, c as ExcelColumn, d as ExportRowsOptions } from './types-BCeqH-13.js';
+export { D as DownloadExcelOptions, e as EmptyBehavior, f as ExportScope } from './types-BCeqH-13.js';
+
+/**
+ * TanStack Table 인스턴스를 기반으로 Excel(.xlsx) 파일을 생성·다운로드한다.
+ *
+ * @param table - TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options - Excel export 옵션 (fileName, sheetName, scope, emptyBehavior)
+ * @returns void (동기 실행 — xlsx.writeFile 동기 API, D3)
+ *
+ * @remarks
+ * **대용량 데이터 경고**: scope='all' 또는 대용량 필터 결과(>10,000행) 시
+ * xlsx.writeFile 이 동기 실행되어 브라우저 메인 스레드를 블로킹할 수 있습니다.
+ * 대용량 사용 시 Web Worker 래핑 권장 (EC-05).
+ *
+ * @example
+ * // 기본 사용 (filtered 행)
+ * exportToExcel(table, { fileName: '데이터.xlsx' });
+ *
+ * @example
+ * // 선택 행 + 다중행 헤더
+ * exportToExcel(table, {
+ *   fileName: '선택데이터.xlsx',
+ *   sheetName: '선택목록',
+ *   scope: 'selected',
+ *   emptyBehavior: 'empty',
+ * });
+ */
+declare function exportToExcel<TData>(table: Table<TData>, options?: ExcelExportOptions): void;
+
+/**
+ * TanStack Table 인스턴스를 기반으로 CSV 파일을 생성·다운로드한다.
+ * UTF-8 BOM() 포함 — 한국어 Excel 정상 표시 (AC-004).
+ *
+ * @param table  TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options CSV export 옵션 (fileName, scope, delimiter, emptyBehavior)
+ * @returns void (순수 string 조작 + createObjectURL — 외부 라이브러리 0, D5)
+ *
+ * @remarks
+ * **브라우저 전용**: URL.createObjectURL / document.createElement — SSR 환경 불가.
+ *
+ * @example
+ * // 기본 사용 (filtered 행, 쉼표 구분자)
+ * exportToCSV(table, { fileName: '데이터.csv' });
+ *
+ * @example
+ * // TSV + 선택 행
+ * exportToCSV(table, { fileName: '선택.tsv', delimiter: '\t', scope: 'selected' });
+ */
+declare function exportToCSV<TData>(table: Table<TData>, options?: CSVExportOptions): void;
+
+/**
+ * TanStack Table 인스턴스를 기반으로 PDF 파일을 생성·다운로드한다.
+ * jspdf + jspdf-autotable을 optional peer로 dynamic import하여 사용.
+ *
+ * @param table   - TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options - PDF export 옵션 (fileName, title, scope, orientation, fontFamily, emptyBehavior)
+ * @returns Promise<void> — jspdf dynamic import 후 완료
+ * @throws Error jspdf 또는 jspdf-autotable이 설치되지 않은 경우
+ *
+ * @remarks
+ * **peer 설치 필요**: jspdf + jspdf-autotable은 optional peerDependency.
+ * 사용 전 `npm install jspdf jspdf-autotable` 실행 필요.
+ *
+ * **한국어 폰트**: `fontFamily: 'korean'` 옵션은 W1 리스크 (loadKoreanFont.ts stub 상태).
+ * 실 폰트 base64 데이터 확보 + 라이선스 확인 후 loadKoreanFont.ts 구현 완료 필요.
+ *
+ * @example
+ * // 기본 사용 (portrait, filtered, Helvetica)
+ * await exportToPdf(table, { fileName: '보고서.pdf' });
+ *
+ * @example
+ * // 가로 방향 + 전체 행 + 제목
+ * await exportToPdf(table, {
+ *   fileName: '전체데이터.pdf',
+ *   title: '2026년 데이터 목록',
+ *   scope: 'all',
+ *   orientation: 'l',
+ *   emptyBehavior: 'empty',
+ * });
+ */
+declare function exportToPdf<TData>(table: Table<TData>, options?: PDFExportOptions): Promise<void>;
+
+/**
+ * TanStack Table 데이터를 TSV 포맷으로 클립보드에 복사한다.
+ * TSV(탭 구분, 줄바꿈 행 구분) — Excel 붙여넣기 호환.
+ *
+ * navigator.clipboard 미지원 환경: document.execCommand('copy') fallback 시도.
+ * fallback도 실패 시 Error('[grid-export] copyToClipboard: Clipboard API not supported') throw.
+ *
+ * @param table  TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options 클립보드 복사 옵션 (scope, emptyBehavior)
+ * @returns Promise<void> — navigator.clipboard.writeText 는 async
+ *
+ * @example
+ * await copyToClipboard(table);
+ *
+ * @example
+ * await copyToClipboard(table, { scope: 'selected' });
+ */
+declare function copyToClipboard<TData>(table: Table<TData>, options?: ClipboardOptions): Promise<void>;
+
+/**
+ * TanStack Table 데이터를 새 팝업 창에 HTML 테이블로 렌더링하여 인쇄 대화상자를 연다.
+ * 순수 Web API 전용 (window.open + document.write + window.print).
+ *
+ * 팝업 차단 환경: console.warn 후 즉시 반환 (D7 — throw 하지 않음).
+ * printGrid 자체는 동기 반환 (void). 실제 print 발화는 popup.onload 내에서 비동기 실행 (D4).
+ *
+ * @param table  TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
+ * @param options 인쇄 옵션 (title, scope, orientation, emptyBehavior)
+ * @returns void
+ *
+ * @example
+ * printGrid(table);
+ *
+ * @example
+ * printGrid(table, { title: '계약 목록', scope: 'filtered', orientation: 'l' });
+ */
+declare function printGrid<TData>(table: Table<TData>, options?: PrintOptions): void;
+
+/**
+ * 행 배열을 Excel 파일(.xlsx)로 다운로드한다.
+ *
+ * TanStack `Table<TData>` 인스턴스 없이 사용 가능.
+ * `@topgrid/grid-export` 의 `exportToExcel(table, options)` 와 평행 지원 (ADR-005 옵션 A).
+ *
+ * @example
+ * exportRowsToExcel(rows, columns, { fileName: '보고서_2026.xlsx' });
+ *
+ * @param rows     내보낼 데이터 행 배열
+ * @param columns  컬럼 정의 배열 (key / header / width? / format?)
+ * @param options  파일명·시트명·emptyBehavior 옵션
+ */
+declare function exportRowsToExcel<TData extends Record<string, unknown>>(rows: TData[], columns: ExcelColumn[], options?: ExportRowsOptions): void;
+
+export { CSVExportOptions, ClipboardOptions, ExcelColumn, ExcelExportOptions, ExportRowsOptions, PDFExportOptions, PrintOptions, copyToClipboard, exportRowsToExcel, exportToCSV, exportToExcel, exportToPdf, printGrid };

package/dist/index.mjs

@@ -0,0 +1,381 @@
+import * as XLSX2 from 'xlsx';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/internal/loadKoreanFont.ts
+var loadKoreanFont_exports = {};
+__export(loadKoreanFont_exports, {
+  loadKoreanFont: () => loadKoreanFont
+});
+async function loadKoreanFont(pdf) {
+  console.warn(
+    '[grid-export] exportToPdf: fontFamily: "korean" \uC635\uC158\uC740 stub \uC0C1\uD0DC\uC785\uB2C8\uB2E4. \uD55C\uAD6D\uC5B4 \uAE00\uC790\uAC00 \uAE68\uC9C8 \uC218 \uC788\uC2B5\uB2C8\uB2E4. loadKoreanFont.ts V1 \uAD6C\uD604 \uC644\uB8CC \uD6C4 \uC0AC\uC6A9\uD558\uC138\uC694. (spec Section 12 V1)'
+  );
+}
+var init_loadKoreanFont = __esm({
+  "src/internal/loadKoreanFont.ts"() {
+  }
+});
+
+// src/internal/getRowsByScope.ts
+function getRowsByScope(table, scope) {
+  if (scope === "all") {
+    return table.getCoreRowModel().rows;
+  }
+  if (scope === "selected") {
+    return table.getSelectedRowModel().rows;
+  }
+  return table.getFilteredRowModel().rows;
+}
+
+// src/exportToExcel.ts
+function resolveHeaderText(headerValue) {
+  if (typeof headerValue === "string") {
+    return headerValue;
+  }
+  return "";
+}
+function buildHeaderRows(table) {
+  const headerGroups = table.getHeaderGroups();
+  const merges = [];
+  const headerRows = [];
+  for (let rowIdx = 0; rowIdx < headerGroups.length; rowIdx++) {
+    const group = headerGroups[rowIdx];
+    const row = [];
+    let colIdx = 0;
+    for (const header of group.headers) {
+      if (header.isPlaceholder) {
+        row.push("");
+      } else {
+        const text = resolveHeaderText(
+          typeof header.column.columnDef.header === "string" ? header.column.columnDef.header : header.column.id
+        );
+        row.push(text);
+        if (header.colSpan > 1) {
+          merges.push({
+            s: { r: rowIdx, c: colIdx },
+            e: { r: rowIdx, c: colIdx + header.colSpan - 1 }
+          });
+        }
+      }
+      colIdx++;
+    }
+    headerRows.push(row);
+  }
+  if (headerGroups.length > 1) {
+    for (let rowIdx = 0; rowIdx < headerGroups.length - 1; rowIdx++) {
+      const group = headerGroups[rowIdx];
+      let colIdx = 0;
+      for (const header of group.headers) {
+        if (!header.isPlaceholder && header.colSpan === 1) {
+          if (rowIdx + 1 <= headerGroups.length - 1) {
+            merges.push({
+              s: { r: rowIdx, c: colIdx },
+              e: { r: headerGroups.length - 1, c: colIdx }
+            });
+          }
+        }
+        colIdx++;
+      }
+    }
+  }
+  return { headerRows, merges };
+}
+function exportToExcel(table, options) {
+  const {
+    fileName = "export.xlsx",
+    sheetName = "Sheet1",
+    scope = "filtered",
+    emptyBehavior = "skip"
+  } = options ?? {};
+  const rows = getRowsByScope(table, scope);
+  if (rows.length === 0 && emptyBehavior === "skip") {
+    console.warn("[grid-export] exportToExcel: \uB0B4\uBCF4\uB0BC \uB370\uC774\uD130\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  const { headerRows, merges } = buildHeaderRows(table);
+  const dataRows = rows.map(
+    (row) => row.getVisibleCells().map((cell) => {
+      const value = cell.getValue();
+      return value !== void 0 && value !== null ? value : "";
+    })
+  );
+  const aoa = [...headerRows, ...dataRows];
+  const ws = XLSX2.utils.aoa_to_sheet(aoa);
+  if (merges.length > 0) {
+    ws["!merges"] = merges;
+  }
+  const wb = XLSX2.utils.book_new();
+  XLSX2.utils.book_append_sheet(wb, ws, sheetName);
+  const finalFileName = fileName.endsWith(".xlsx") ? fileName : `${fileName}.xlsx`;
+  XLSX2.writeFile(wb, finalFileName);
+}
+
+// src/exportToCSV.ts
+function escapeCsvValue(value, delimiter) {
+  const needsQuoting = value.includes(delimiter) || value.includes('"') || value.includes("\n") || value.includes("\r");
+  if (!needsQuoting) return value;
+  return '"' + value.split('"').join('""') + '"';
+}
+function exportToCSV(table, options) {
+  const {
+    fileName = "export.csv",
+    scope = "filtered",
+    delimiter = ",",
+    emptyBehavior = "skip"
+  } = options ?? {};
+  const rows = getRowsByScope(table, scope);
+  if (rows.length === 0 && emptyBehavior === "skip") {
+    console.warn("[grid-export] exportToCSV: \uB0B4\uBCF4\uB0BC \uB370\uC774\uD130\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  const leafHeaders = table.getLeafHeaders();
+  const headerRow = leafHeaders.map((h) => {
+    const headerDef = h.column.columnDef.header;
+    const text = typeof headerDef === "string" ? headerDef : h.column.id;
+    return escapeCsvValue(text, delimiter);
+  }).join(delimiter);
+  const dataRows = rows.map(
+    (row) => row.getVisibleCells().map((cell) => {
+      const value = cell.getValue();
+      const str = value !== null && value !== void 0 ? String(value) : "";
+      return escapeCsvValue(str, delimiter);
+    }).join(delimiter)
+  );
+  const lines = [headerRow, ...dataRows];
+  const csvString = lines.join("\r\n");
+  const bom = "\uFEFF";
+  const blob = new Blob([bom + csvString], {
+    type: "text/csv;charset=utf-8;"
+  });
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  const finalFileName = fileName.endsWith(".csv") || fileName.endsWith(".tsv") ? fileName : `${fileName}.csv`;
+  link.download = finalFileName;
+  link.click();
+  URL.revokeObjectURL(url);
+}
+
+// src/exportToPdf.ts
+async function exportToPdf(table, options) {
+  const {
+    fileName = "export.pdf",
+    title,
+    scope = "filtered",
+    emptyBehavior = "skip",
+    orientation = "p",
+    fontFamily = "default"
+  } = options ?? {};
+  let jsPDF;
+  try {
+    const mod = await import('jspdf');
+    jsPDF = mod.default;
+  } catch {
+    throw new Error(
+      "[exportToPdf] jspdf is not installed. Run: npm install jspdf jspdf-autotable"
+    );
+  }
+  try {
+    await import('jspdf-autotable');
+  } catch {
+    throw new Error(
+      "[exportToPdf] jspdf-autotable is not installed. Run: npm install jspdf jspdf-autotable"
+    );
+  }
+  const rows = getRowsByScope(table, scope);
+  if (rows.length === 0 && emptyBehavior === "skip") {
+    console.warn("[grid-export] exportToPdf: \uB0B4\uBCF4\uB0BC \uB370\uC774\uD130\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  const headerGroups = table.getHeaderGroups();
+  const head = headerGroups.map(
+    (hg) => hg.headers.map((h) => {
+      if (h.isPlaceholder) return "";
+      return typeof h.column.columnDef.header === "string" ? h.column.columnDef.header : h.column.id;
+    })
+  );
+  const leafHeaders = table.getLeafHeaders();
+  const body = rows.map((row) => {
+    const cells = row.getVisibleCells();
+    return leafHeaders.map((lh) => {
+      const cell = cells.find((c) => c.column.id === lh.column.id);
+      return cell ? String(cell.getValue() ?? "") : "";
+    });
+  });
+  const doc = new jsPDF({ orientation, unit: "pt", format: "a4" });
+  if (fontFamily === "korean") {
+    const { loadKoreanFont: loadKoreanFont2 } = await Promise.resolve().then(() => (init_loadKoreanFont(), loadKoreanFont_exports));
+    await loadKoreanFont2(doc);
+  }
+  if (title) {
+    doc.text(title, 14, 20);
+  }
+  doc.autoTable({ head, body, startY: title ? 30 : 14 });
+  const normalized = fileName.endsWith(".pdf") ? fileName : `${fileName}.pdf`;
+  doc.save(normalized);
+}
+
+// src/copyToClipboard.ts
+function escapeTsvValue(value) {
+  return value.replace(/[\t\r\n]/g, " ");
+}
+async function copyToClipboard(table, options) {
+  const { scope = "filtered", emptyBehavior = "skip" } = options ?? {};
+  const rows = getRowsByScope(table, scope);
+  if (rows.length === 0 && emptyBehavior === "skip") {
+    console.warn("[grid-export] copyToClipboard: \uB0B4\uBCF4\uB0BC \uB370\uC774\uD130\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  const leafHeaders = table.getLeafHeaders();
+  const headerRow = leafHeaders.map((h) => {
+    const headerDef = h.column.columnDef.header;
+    const text = typeof headerDef === "string" ? headerDef : h.column.id;
+    return escapeTsvValue(text);
+  }).join("	");
+  const dataRows = rows.map(
+    (row) => row.getVisibleCells().map((cell) => {
+      const value = cell.getValue();
+      const str = value !== null && value !== void 0 ? String(value) : "";
+      return escapeTsvValue(str);
+    }).join("	")
+  );
+  const tsvString = [headerRow, ...dataRows].join("\n");
+  if (typeof navigator !== "undefined" && navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
+    await navigator.clipboard.writeText(tsvString);
+  } else {
+    const textarea = document.createElement("textarea");
+    textarea.value = tsvString;
+    textarea.style.position = "fixed";
+    textarea.style.opacity = "0";
+    document.body.appendChild(textarea);
+    textarea.select();
+    const success = document.execCommand("copy");
+    document.body.removeChild(textarea);
+    if (!success) {
+      throw new Error("[grid-export] copyToClipboard: Clipboard API not supported");
+    }
+  }
+}
+
+// src/printGrid.ts
+function printGrid(table, options) {
+  const {
+    title,
+    scope = "filtered",
+    orientation = "p",
+    emptyBehavior = "skip"
+  } = options ?? {};
+  const rows = getRowsByScope(table, scope);
+  if (rows.length === 0 && emptyBehavior === "skip") {
+    console.warn("[grid-export] printGrid: \uB0B4\uBCF4\uB0BC \uB370\uC774\uD130\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  const leafHeaders = table.getLeafHeaders();
+  const headerHtml = leafHeaders.map((h) => {
+    const headerDef = h.column.columnDef.header;
+    const text = typeof headerDef === "string" ? headerDef : h.column.id;
+    return `<th>${text}</th>`;
+  }).join("");
+  const bodyHtml = rows.map((row) => {
+    const cells = row.getVisibleCells().map((cell) => {
+      const value = cell.getValue();
+      const str = value !== null && value !== void 0 ? String(value) : "";
+      return `<td>${str}</td>`;
+    }).join("");
+    return `<tr>${cells}</tr>`;
+  }).join("");
+  const orientationCss = orientation === "l" ? "landscape" : "portrait";
+  const titleHtml = title ? `<h2>${title}</h2>` : "";
+  const html = `<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<title>${title ?? ""}</title>
+<style>
+  @page { size: ${orientationCss}; }
+  body { font-family: sans-serif; font-size: 12px; margin: 16px; }
+  h2 { font-size: 16px; margin-bottom: 12px; }
+  table { border-collapse: collapse; width: 100%; }
+  th, td { border: 1px solid #ccc; padding: 4px 8px; text-align: left; page-break-inside: avoid; }
+  th { background: #f0f0f0; }
+  @media print {
+    body { margin: 0; }
+  }
+</style>
+</head>
+<body>
+${titleHtml}
+<table>
+  <thead><tr>${headerHtml}</tr></thead>
+  <tbody>${bodyHtml}</tbody>
+</table>
+</body>
+</html>`;
+  const popup = window.open("", "_blank");
+  if (!popup) {
+    console.warn(
+      "[grid-export] printGrid: \uD31D\uC5C5\uC774 \uCC28\uB2E8\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uBE0C\uB77C\uC6B0\uC800 \uC124\uC815\uC5D0\uC11C \uD31D\uC5C5\uC744 \uD5C8\uC6A9 \uD6C4 \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694."
+    );
+    return;
+  }
+  popup.onload = () => {
+    popup.print();
+    popup.close();
+  };
+  popup.document.write(html);
+  popup.document.close();
+}
+function formatValue(value, format) {
+  if (value == null) return "";
+  if (format === "date" || format === "datetime") {
+    const d = new Date(value);
+    if (isNaN(d.getTime())) return String(value);
+    return format === "datetime" ? d.toLocaleString("ko-KR") : d.toLocaleDateString("ko-KR");
+  }
+  if (format === "number" || format === "currency") {
+    const n = Number(value);
+    return isNaN(n) ? value : n;
+  }
+  return value;
+}
+function exportRowsToExcel(rows, columns, options) {
+  const {
+    fileName = "export.xlsx",
+    sheetName = "Sheet1",
+    emptyBehavior = "skip"
+  } = options ?? {};
+  if (rows.length === 0 && emptyBehavior === "skip") {
+    console.warn('[exportRowsToExcel] rows is empty \u2014 skipping file creation (emptyBehavior: "skip")');
+    return;
+  }
+  const header = columns.map((c) => c.header);
+  const dataRows = rows.map(
+    (row) => columns.map((col) => formatValue(row[col.key], col.format))
+  );
+  const aoa = rows.length === 0 ? [header] : [header, ...dataRows];
+  const ws = XLSX2.utils.aoa_to_sheet(aoa);
+  ws["!cols"] = columns.map((c) => ({ wch: c.width ?? 15 }));
+  const headerRange = XLSX2.utils.decode_range(ws["!ref"] ?? "A1");
+  for (let c = headerRange.s.c; c <= headerRange.e.c; c++) {
+    const cellAddr = XLSX2.utils.encode_cell({ r: 0, c });
+    if (!ws[cellAddr]) continue;
+    ws[cellAddr].s = { font: { bold: true }, fill: { fgColor: { rgb: "F3F4F6" } } };
+  }
+  const wb = XLSX2.utils.book_new();
+  XLSX2.utils.book_append_sheet(wb, ws, sheetName);
+  const ext = fileName.endsWith(".xlsx") ? fileName : `${fileName}.xlsx`;
+  XLSX2.writeFile(wb, ext);
+}
+
+export { copyToClipboard, exportRowsToExcel, exportToCSV, exportToExcel, exportToPdf, printGrid };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map