@expcat/tigercat-core 2.1.2 → 2.1.3

package/dist/utils/data-export.d.ts

@@ -1,7 +1,7 @@
-import { T as TableColumn } from '../table-CHeBgM_2.js';
-import { D as DataExportFormat, a as DataExportOptions } from '../data-export-CLWdsrRn.js';
-import '../locale-KMGxL6bT.js';
-import '../datepicker-Digy7Stt.js';
+import { T as TableColumn } from '../table-R9Yp1aVa.js';
+import { D as DataExportOptions, a as DataExportFormat } from '../data-export-D01yjggE.js';
+import '../locale-qoiGEqe_.js';
+import '@floating-ui/dom';
 
 /**
  * DataExport serialization utilities (real .xlsx workbook / GitHub-flavored Markdown table)
@@ -30,6 +30,10 @@ declare function exportDataToXlsx<T>(columns: TableColumn<T>[], data: T[], optio
  * Serialize columns + records into a GitHub-flavored Markdown table
  */
 declare function exportDataToMarkdown<T>(columns: TableColumn<T>[], data: T[], options?: DataExportOptions<T>): string;
+/**
+ * Serialize columns + records into UTF-8 BOM + CRLF CSV.
+ */
+declare function exportDataToCsv<T>(columns: TableColumn<T>[], data: T[], options?: DataExportOptions<T>): string;
 /**
  * Serialize columns + records into the given format
  */
@@ -38,5 +42,15 @@ declare function exportData<T>(columns: TableColumn<T>[], data: T[], format: Dat
  * Trigger a browser download for serialized export content
  */
 declare function downloadDataExport(content: Uint8Array | string, filename?: string, format?: DataExportFormat): void;
+interface RunDataExportInput<T = Record<string, unknown>> extends DataExportOptions<T> {
+    columns: TableColumn<T>[];
+    dataSource: T[];
+    format: string;
+    fileName?: string;
+}
+/**
+ * Serialize and download one format. Unknown formats warn and throw.
+ */
+declare function runDataExport<T>(input: RunDataExportInput<T>): DataExportFormat;
 
-export { type ZipEntrySource, buildStoredZip, crc32, downloadDataExport, exportData, exportDataToMarkdown, exportDataToXlsx };
+export { type RunDataExportInput, type ZipEntrySource, buildStoredZip, crc32, downloadDataExport, exportData, exportDataToCsv, exportDataToMarkdown, exportDataToXlsx, runDataExport };

package/dist/utils/data-export.js

@@ -3,11 +3,95 @@ function isBrowser() {
   return typeof window !== "undefined" && typeof document !== "undefined";
 }
 
+// src/utils/dev-warn.ts
+function isDevEnvironment() {
+  const proc = globalThis.process;
+  return !proc?.env || proc.env.NODE_ENV !== "production";
+}
+var warnedKeys = /* @__PURE__ */ new Set();
+function devWarn(key, message) {
+  if (!isDevEnvironment() || warnedKeys.has(key)) return;
+  warnedKeys.add(key);
+  console.warn(message);
+}
+
+// src/utils/data-export-value.ts
+function columnField(column) {
+  return column.dataKey || column.key;
+}
+var DATA_EXPORT_SOFT_CELL_LIMIT = 1e5;
+var DATA_EXPORT_MAX_CELL_CHARS = 32767;
+var DATA_EXPORT_FORMULA_PREFIX = /^[=+\-@]/;
+function isDataExportFormat(value) {
+  return value === "xlsx" || value === "markdown" || value === "csv";
+}
+function formatDataExportCellValue(value) {
+  if (value === null || value === void 0) return "";
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? "" : value.toISOString();
+  }
+  if (typeof value === "object") {
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return "";
+    }
+  }
+  return value;
+}
+function sanitizeDataExportText(value) {
+  let str = value === null || value === void 0 ? "" : String(value);
+  if (DATA_EXPORT_FORMULA_PREFIX.test(str)) {
+    str = `'${str}`;
+  }
+  if (str.length > DATA_EXPORT_MAX_CELL_CHARS) {
+    return str.slice(0, DATA_EXPORT_MAX_CELL_CHARS);
+  }
+  return str;
+}
+function isRenderOnlyExportColumn(column, data) {
+  if (!column.render) return false;
+  const field = columnField(column);
+  if (!field) return true;
+  return data.every((record) => record[field] === void 0);
+}
+function resolveDataExportColumns(columns, data, hiddenColumnKeys) {
+  const hidden = hiddenColumnKeys ? new Set(hiddenColumnKeys) : null;
+  return columns.filter((column) => {
+    if (hidden?.has(column.key)) return false;
+    return !isRenderOnlyExportColumn(column, data);
+  });
+}
+function getDataExportCellValue(record, column, cellFormatter) {
+  const field = columnField(column);
+  const raw = field ? record[field] : void 0;
+  const next = cellFormatter ? cellFormatter(raw, column, record) : raw;
+  return formatDataExportCellValue(next);
+}
+function resolveDataExportFilename(fileName, extension) {
+  const trimmed = (fileName ?? "").trim();
+  const cleaned = (trimmed || "export").replace(/[\\/:*?"<>|]+/g, "-");
+  const suffix = `.${extension}`;
+  if (cleaned.toLowerCase().endsWith(suffix.toLowerCase())) return cleaned;
+  return `${cleaned}${suffix}`;
+}
+
 // src/utils/data-export-utils.ts
+function needsCsvQuotes(value) {
+  return /[",\n\r]/.test(value);
+}
+function escapeExportCsvValue(value) {
+  const str = sanitizeDataExportText(formatDataExportCellValue(value));
+  if (needsCsvQuotes(str)) {
+    return `"${str.replace(/"/g, '""')}"`;
+  }
+  return str;
+}
 function getCellValue(record, column, options) {
-  const key = column.dataKey || column.key;
-  const raw = record[key];
-  return options?.cellFormatter ? options.cellFormatter(raw, column, record) : raw;
+  return getDataExportCellValue(record, column, options?.cellFormatter);
+}
+function resolveExportColumns(columns, data, options) {
+  return resolveDataExportColumns(columns, data, options?.hiddenColumnKeys);
 }
 var crc32Table = null;
 function getCrc32Table() {
@@ -124,16 +208,17 @@ function buildSheetCell(value, columnIndex, rowNumber) {
   if (typeof value === "number" && Number.isFinite(value)) {
     return `<c r="${ref}"><v>${value}</v></c>`;
   }
-  const str = value === null || value === void 0 ? "" : String(value);
+  const str = sanitizeDataExportText(value);
   if (str === "") return "";
   return `<c r="${ref}" t="inlineStr"><is><t xml:space="preserve">${escapeXml(str)}</t></is></c>`;
 }
 function exportDataToXlsx(columns, data, options) {
-  const headerCells = columns.map((column, index) => buildSheetCell(column.title, index, 1)).join("");
+  const exportColumns = resolveExportColumns(columns, data, options);
+  const headerCells = exportColumns.map((column, index) => buildSheetCell(column.title, index, 1)).join("");
   const rows = [`<row r="1">${headerCells}</row>`];
   data.forEach((record, rowIndex) => {
     const rowNumber = rowIndex + 2;
-    const cells = columns.map(
+    const cells = exportColumns.map(
       (column, columnIndex) => buildSheetCell(getCellValue(record, column, options), columnIndex, rowNumber)
     ).join("");
     rows.push(`<row r="${rowNumber}">${cells}</row>`);
@@ -162,42 +247,82 @@ function markdownSeparator(align) {
   return "---";
 }
 function exportDataToMarkdown(columns, data, options) {
-  const header = `| ${columns.map((column) => escapeMarkdownCell(column.title)).join(" | ")} |`;
-  const separator = `| ${columns.map((column) => markdownSeparator(column.align)).join(" | ")} |`;
+  const exportColumns = resolveExportColumns(columns, data, options);
+  const header = `| ${exportColumns.map((column) => escapeMarkdownCell(column.title)).join(" | ")} |`;
+  const separator = `| ${exportColumns.map((column) => markdownSeparator(column.align)).join(" | ")} |`;
   const rows = data.map(
-    (record) => `| ${columns.map((column) => escapeMarkdownCell(getCellValue(record, column, options))).join(" | ")} |`
+    (record) => `| ${exportColumns.map((column) => escapeMarkdownCell(getCellValue(record, column, options))).join(" | ")} |`
   );
   return [header, separator, ...rows].join("\n");
 }
+function exportDataToCsv(columns, data, options) {
+  const exportColumns = resolveExportColumns(columns, data, options);
+  const headers = exportColumns.map((column) => escapeExportCsvValue(column.title));
+  const rows = data.map(
+    (record) => exportColumns.map((column) => escapeExportCsvValue(getCellValue(record, column, options))).join(",")
+  );
+  return `\uFEFF${[headers.join(","), ...rows].join("\r\n")}`;
+}
 function exportData(columns, data, format, options) {
-  return format === "xlsx" ? exportDataToXlsx(columns, data, options) : exportDataToMarkdown(columns, data, options);
+  if (format === "xlsx") return exportDataToXlsx(columns, data, options);
+  if (format === "csv") return exportDataToCsv(columns, data, options);
+  if (format === "markdown") return exportDataToMarkdown(columns, data, options);
+  devWarn("DataExport.format", `Unknown export format "${String(format)}"`);
+  throw new Error(`Unknown export format: ${String(format)}`);
 }
 var DATA_EXPORT_FILE_META = {
   xlsx: {
     extension: "xlsx",
     mime: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
   },
-  markdown: { extension: "md", mime: "text/markdown;charset=utf-8;" }
+  markdown: { extension: "md", mime: "text/markdown;charset=utf-8;" },
+  csv: { extension: "csv", mime: "text/csv;charset=utf-8;" }
 };
 function downloadDataExport(content, filename = "export", format = "xlsx") {
   if (!isBrowser()) return;
+  if (!isDataExportFormat(format)) {
+    devWarn("DataExport.format", `Unknown export format "${String(format)}"`);
+    return;
+  }
   const meta = DATA_EXPORT_FILE_META[format];
   const blob = new Blob([content], { type: meta.mime });
   const url = URL.createObjectURL(blob);
   const link = document.createElement("a");
   link.href = url;
-  link.download = `${filename}.${meta.extension}`;
+  link.download = resolveDataExportFilename(filename, meta.extension);
   link.style.display = "none";
   document.body.appendChild(link);
   link.click();
   document.body.removeChild(link);
   URL.revokeObjectURL(url);
 }
+function runDataExport(input) {
+  if (!isDataExportFormat(input.format)) {
+    devWarn("DataExport.format", `Unknown export format "${String(input.format)}"`);
+    throw new Error(`Unknown export format: ${String(input.format)}`);
+  }
+  const columns = resolveDataExportColumns(input.columns, input.dataSource, input.hiddenColumnKeys);
+  const cellCount = columns.length * (input.dataSource.length + 1);
+  if (cellCount > DATA_EXPORT_SOFT_CELL_LIMIT) {
+    devWarn(
+      "DataExport.size",
+      `Export has ${cellCount} cells; files above ${DATA_EXPORT_SOFT_CELL_LIMIT} may be slow or fail to open`
+    );
+  }
+  const content = exportData(columns, input.dataSource, input.format, {
+    sheetName: input.sheetName,
+    cellFormatter: input.cellFormatter
+  });
+  downloadDataExport(content, input.fileName, input.format);
+  return input.format;
+}
 export {
   buildStoredZip,
   crc32,
   downloadDataExport,
   exportData,
+  exportDataToCsv,
   exportDataToMarkdown,
-  exportDataToXlsx
+  exportDataToXlsx,
+  runDataExport
 };

package/dist/utils/table-export.d.ts

@@ -1,26 +1,35 @@
-import { x as TableExportFormat, T as TableColumn } from '../table-CHeBgM_2.js';
-import '../locale-KMGxL6bT.js';
-import '../datepicker-Digy7Stt.js';
+import { T as TableColumn } from '../table-R9Yp1aVa.js';
+import '../locale-qoiGEqe_.js';
+import '@floating-ui/dom';
 
 /**
- * Table export utilities (CSV / Excel-compatible HTML worksheet)
+ * Table CSV export.
+ *
+ * Excel / xlsx is DataExport (`@expcat/tigercat-core/utils/data-export`), not
+ * an HTML worksheet pretending to be `.xls`.
  */
 
 /**
- * Export table data to CSV string
+ * Escape a value for RFC 4180 CSV output.
  */
-declare function exportTableToCsv<T>(columns: TableColumn<T>[], data: T[], _filename?: string): string;
-declare function exportTableToExcel<T>(columns: TableColumn<T>[], data: T[]): string;
+declare function escapeCsvValue(value: unknown): string;
 /**
- * Trigger a CSV file download in the browser
+ * Export table data to a CSV string (UTF-8 BOM + CRLF).
+ *
+ * Cell values use `dataKey || key`. `filename` is ignored — pass it to
+ * {@link downloadCsv}.
+ */
+declare function exportTableToCsv<T>(columns: TableColumn<T>[], data: T[]): string;
+declare function exportTableData<T>(columns: TableColumn<T>[], data: T[]): string;
+/**
+ * Trigger a CSV file download in the browser.
+ * Existing `.csv` suffixes are not duplicated.
  */
 declare function downloadCsv(csvContent: string, filename?: string): void;
-declare function downloadExcel(excelContent: string, filename?: string): void;
-declare function exportTableData<T>(columns: TableColumn<T>[], data: T[], format?: TableExportFormat): string;
-declare function downloadTableExport(content: string, filename?: string, format?: TableExportFormat): void;
+declare function downloadTableExport(content: string, filename?: string): void;
 /**
  * Get export button classes
  */
 declare const tableExportButtonClasses = "inline-flex items-center gap-1.5 px-3 py-1.5 text-sm font-medium rounded-[var(--tiger-radius-md,0.5rem)] border border-[var(--tiger-border,#e5e7eb)] text-[var(--tiger-text,#111827)] bg-[var(--tiger-surface,#ffffff)] hover:bg-[var(--tiger-surface-muted,#f9fafb)] transition-colors";
 
-export { downloadCsv, downloadExcel, downloadTableExport, exportTableData, exportTableToCsv, exportTableToExcel, tableExportButtonClasses };
+export { downloadCsv, downloadTableExport, escapeCsvValue, exportTableData, exportTableToCsv, tableExportButtonClasses };

package/dist/utils/table-export.js

@@ -3,84 +3,113 @@ function isBrowser() {
   return typeof window !== "undefined" && typeof document !== "undefined";
 }
 
+// src/utils/class-names.ts
+function classNames(...classes) {
+  let result = "";
+  for (const cls of classes) {
+    if (cls && cls !== "") {
+      result += (result ? " " : "") + String(cls);
+    }
+  }
+  return result;
+}
+
+// src/utils/table-utils.ts
+var tableLoadingOverlayClasses = classNames(
+  "absolute inset-0 bg-[var(--tiger-surface,#ffffff)]/80 flex items-center justify-center z-20"
+);
+function getTableColumnDataKey(column) {
+  return column.dataKey || column.key;
+}
+
+// src/utils/data-export-value.ts
+var DATA_EXPORT_MAX_CELL_CHARS = 32767;
+var DATA_EXPORT_FORMULA_PREFIX = /^[=+\-@]/;
+function formatDataExportCellValue(value) {
+  if (value === null || value === void 0) return "";
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? "" : value.toISOString();
+  }
+  if (typeof value === "object") {
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return "";
+    }
+  }
+  return value;
+}
+function sanitizeDataExportText(value) {
+  let str = value === null || value === void 0 ? "" : String(value);
+  if (DATA_EXPORT_FORMULA_PREFIX.test(str)) {
+    str = `'${str}`;
+  }
+  if (str.length > DATA_EXPORT_MAX_CELL_CHARS) {
+    return str.slice(0, DATA_EXPORT_MAX_CELL_CHARS);
+  }
+  return str;
+}
+function resolveDataExportFilename(fileName, extension) {
+  const trimmed = (fileName ?? "").trim();
+  const cleaned = (trimmed || "export").replace(/[\\/:*?"<>|]+/g, "-");
+  const suffix = `.${extension}`;
+  if (cleaned.toLowerCase().endsWith(suffix.toLowerCase())) return cleaned;
+  return `${cleaned}${suffix}`;
+}
+
 // src/utils/table-export-utils.ts
+var CSV_BOM = "\uFEFF";
+function needsCsvQuotes(value) {
+  return /[",\n\r]/.test(value);
+}
 function escapeCsvValue(value) {
-  const str = value === null || value === void 0 ? "" : String(value);
-  if (str.includes(",") || str.includes('"') || str.includes("\n")) {
+  const str = sanitizeDataExportText(formatDataExportCellValue(value));
+  if (needsCsvQuotes(str)) {
     return `"${str.replace(/"/g, '""')}"`;
   }
   return str;
 }
-function exportTableToCsv(columns, data, _filename) {
+function withCsvExtension(filename) {
+  return resolveDataExportFilename(filename, "csv");
+}
+function exportTableToCsv(columns, data) {
   const headers = columns.map((col) => escapeCsvValue(col.title));
   const rows = data.map(
     (record) => columns.map((col) => {
-      const key = col.dataKey || col.key;
-      const value = record[key];
+      const value = record[getTableColumnDataKey(col)];
       return escapeCsvValue(value);
     }).join(",")
   );
-  return [headers.join(","), ...rows].join("\n");
-}
-function escapeHtmlValue(value) {
-  const str = value === null || value === void 0 ? "" : String(value);
-  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+  return `${CSV_BOM}${[headers.join(","), ...rows].join("\r\n")}`;
 }
-function exportTableToExcel(columns, data) {
-  const headerCells = columns.map((column) => `<th>${escapeHtmlValue(column.title)}</th>`).join("");
-  const bodyRows = data.map((record) => {
-    const cells = columns.map((column) => {
-      const key = column.dataKey || column.key;
-      const value = record[key];
-      return `<td>${escapeHtmlValue(value)}</td>`;
-    }).join("");
-    return `<tr>${cells}</tr>`;
-  }).join("");
-  return `<!doctype html><html><head><meta charset="utf-8"></head><body><table><thead><tr>${headerCells}</tr></thead><tbody>${bodyRows}</tbody></table></body></html>`;
+function exportTableData(columns, data) {
+  return exportTableToCsv(columns, data);
 }
-function downloadCsv(csvContent, filename = "export") {
+function downloadBlob(content, filename, mime) {
   if (!isBrowser()) return;
-  const blob = new Blob([csvContent], { type: "text/csv;charset=utf-8;" });
+  const blob = new Blob([content], { type: mime });
   const url = URL.createObjectURL(blob);
   const link = document.createElement("a");
   link.href = url;
-  link.download = `${filename}.csv`;
+  link.download = filename;
   link.style.display = "none";
   document.body.appendChild(link);
   link.click();
   document.body.removeChild(link);
   URL.revokeObjectURL(url);
 }
-function downloadExcel(excelContent, filename = "export") {
-  if (!isBrowser()) return;
-  const blob = new Blob([excelContent], { type: "application/vnd.ms-excel;charset=utf-8;" });
-  const url = URL.createObjectURL(blob);
-  const link = document.createElement("a");
-  link.href = url;
-  link.download = `${filename}.xls`;
-  link.style.display = "none";
-  document.body.appendChild(link);
-  link.click();
-  document.body.removeChild(link);
-  URL.revokeObjectURL(url);
-}
-function exportTableData(columns, data, format = "csv") {
-  return format === "excel" ? exportTableToExcel(columns, data) : exportTableToCsv(columns, data);
+function downloadCsv(csvContent, filename = "export") {
+  downloadBlob(csvContent, withCsvExtension(filename), "text/csv;charset=utf-8;");
 }
-function downloadTableExport(content, filename = "export", format = "csv") {
-  if (format === "excel") {
-    downloadExcel(content, filename);
-    return;
-  }
+function downloadTableExport(content, filename = "export") {
   downloadCsv(content, filename);
 }
 var tableExportButtonClasses = "inline-flex items-center gap-1.5 px-3 py-1.5 text-sm font-medium rounded-[var(--tiger-radius-md,0.5rem)] border border-[var(--tiger-border,#e5e7eb)] text-[var(--tiger-text,#111827)] bg-[var(--tiger-surface,#ffffff)] hover:bg-[var(--tiger-surface-muted,#f9fafb)] transition-colors";
 export {
   downloadCsv,
-  downloadExcel,
   downloadTableExport,
+  escapeCsvValue,
   exportTableData,
   exportTableToCsv,
-  exportTableToExcel,
   tableExportButtonClasses
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expcat/tigercat-core",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "type": "module",
   "description": "Core utilities for Tigercat UI library",
   "license": "MIT",