@eztrak/shared 0.18.0 → 0.19.0

package/README.md

@@ -1074,6 +1074,36 @@ Opens on [http://localhost:6006](http://localhost:6006) with stories for `Breadc
 | `@eztrak/shared/components` | `EztrakTabs`, `CustomPagination`, `Breadcrumbs`, `CustomCellEditor`, `SearchInput`, `DropdownFilter`, `ResetFiltersButton`, `TooltipText`, `ToolTip`, `CardSkeleton`, `Modal`, `Loader`, `TableLayoutToolbarControls`, `ResetColumnsButton`, and related types |
 | `@eztrak/shared/components/tabs.css` | Default tab styles (CSS variables) |
 | `@eztrak/shared/components/loader.css` | Loader spinner styles |
+| `@eztrak/shared/excel` | Styled Excel export (`exportExcelReport`). Not on the main entry, so `xlsx-js-style` stays out of apps that do not import it |
+
+### Excel export
+
+Import `exportExcelReport` from `@eztrak/shared/excel`. It writes a styled workbook and returns `{ ok, fileName }` or `{ ok: false, code, error }`. It does not toast.
+
+```js
+import { exportExcelReport } from "@eztrak/shared/excel";
+
+exportExcelReport({
+  data: rows,
+  fileName: "Budget",
+  columns: [
+    {
+      field: "amount",
+      headerName: "Amount",
+      excel: {
+        headerFill: "1F4E79",
+        headerColor: "FFFFFF",
+        fill: "FFF2CC",
+        color: "7F6000",
+        align: "right",
+        numFmt: '"$"#,##0.00',
+      },
+    },
+  ],
+});
+```
+
+`columns` may nest `children` the way AG Grid column groups do. Merges follow that tree. Set `theme` to change the workbook defaults (header `2F75B6` on white text, body `1F2933` on white, border `8FA4BF`). A column `excel` block overrides header fill, header text, body fill, body text, bold, align, and `numFmt`. `valueFormatter` or `format` supplies the cell value. `formatDateFields` formats fields whose name contains `date` when no formatter is set.
 
 ### EztrakTabs props
 

package/dist/excel/index.d.mts

@@ -0,0 +1,146 @@
+type ExcelAlign = "left" | "center" | "right";
+/** Per-column Excel colors. Hex is RRGGBB; a leading # is accepted. */
+type ExcelColumnStyle = {
+    headerFill?: string;
+    headerColor?: string;
+    fill?: string;
+    color?: string;
+    bold?: boolean;
+    align?: ExcelAlign;
+    /** Excel number format, for example '"$"#,##0.00'. */
+    numFmt?: string;
+};
+type ExcelTheme = {
+    headerFill?: string;
+    headerColor?: string;
+    fill?: string;
+    color?: string;
+    borderColor?: string;
+    fontName?: string;
+    fontSize?: number;
+};
+type ExcelFormatParams = {
+    value: unknown;
+    data: Record<string, unknown>;
+};
+type ExcelExportColumn = {
+    field?: string;
+    headerName?: string;
+    children?: ExcelExportColumn[];
+    hide?: boolean;
+    checkboxSelection?: boolean;
+    headerCheckboxSelection?: boolean;
+    valueFormatter?: (params: ExcelFormatParams) => unknown;
+    format?: (params: ExcelFormatParams) => unknown;
+    excel?: ExcelColumnStyle;
+};
+type ExportExcelErrorCode = "empty" | "invalid" | "no-columns" | "filename" | "write";
+type ExportExcelFailure = {
+    ok: false;
+    code: ExportExcelErrorCode;
+    error: string;
+};
+type ExportExcelReportResult = {
+    ok: true;
+    fileName: string;
+} | ExportExcelFailure;
+type ExportExcelReportOptions = {
+    data?: unknown[] | null;
+    fileName?: string;
+    columns?: ExcelExportColumn[];
+    sheetName?: string;
+    theme?: ExcelTheme;
+    /** Drop columns with hide: true. Default false, matching vault grids. */
+    skipHidden?: boolean;
+    /**
+     * Format leaf fields whose name contains "date" when they have no formatter.
+     * Vault turns this on and passes its own date formatter.
+     */
+    formatDateFields?: boolean;
+    formatDate?: (value: unknown) => unknown;
+    /**
+     * Date suffix for the file name. Omit to use the local YYYY-MM-DD.
+     * Pass null when the caller could not produce a stamp.
+     */
+    dateStamp?: string | null;
+};
+type ResolvedTheme = {
+    headerFill: string;
+    headerColor: string;
+    fill: string;
+    color: string;
+    borderColor: string;
+    fontName: string;
+    fontSize: number;
+};
+type ExcelCellStyle = {
+    font: {
+        name: string;
+        sz: number;
+        bold?: boolean;
+        color: {
+            rgb: string;
+        };
+    };
+    fill: {
+        patternType: "solid";
+        fgColor: {
+            rgb: string;
+        };
+    };
+    alignment: {
+        vertical: "center";
+        horizontal: ExcelAlign;
+        wrapText: false;
+    };
+    border: {
+        top: {
+            style: "thin";
+            color: {
+                rgb: string;
+            };
+        };
+        bottom: {
+            style: "thin";
+            color: {
+                rgb: string;
+            };
+        };
+        left: {
+            style: "thin";
+            color: {
+                rgb: string;
+            };
+        };
+        right: {
+            style: "thin";
+            color: {
+                rgb: string;
+            };
+        };
+    };
+    numFmt?: string;
+};
+type WorkBook = {
+    SheetNames: string[];
+    Sheets: Record<string, WorkSheet>;
+};
+type WorkSheet = Record<string, unknown>;
+declare const DEFAULT_EXCEL_THEME: ResolvedTheme;
+declare const excelHeaderStyle: (theme?: ExcelTheme, column?: ExcelColumnStyle) => ExcelCellStyle;
+declare const excelDataStyle: (theme?: ExcelTheme, column?: ExcelColumnStyle) => ExcelCellStyle;
+type BuiltExcelWorkbook = {
+    ok: true;
+    workbook: WorkBook;
+    fileName: string;
+    sheetName: string;
+} | ExportExcelFailure;
+/**
+ * Build a styled workbook. Does not write a file.
+ * Header merges follow the column tree, so two groups with the same title stay separate.
+ */
+declare const buildExcelWorkbook: (options?: ExportExcelReportOptions) => BuiltExcelWorkbook;
+/** Write a styled .xlsx. Returns a result; it does not toast. */
+declare const exportExcelReport: (options?: ExportExcelReportOptions) => ExportExcelReportResult;
+
+export { type BuiltExcelWorkbook, DEFAULT_EXCEL_THEME, type ExcelAlign, type ExcelCellStyle, type ExcelColumnStyle, type ExcelExportColumn, type ExcelFormatParams, type ExcelTheme, type ExportExcelErrorCode, type ExportExcelFailure, type ExportExcelReportOptions, type ExportExcelReportResult, buildExcelWorkbook, excelDataStyle, excelHeaderStyle, exportExcelReport };

package/dist/excel/index.d.ts

@@ -0,0 +1,146 @@
+type ExcelAlign = "left" | "center" | "right";
+/** Per-column Excel colors. Hex is RRGGBB; a leading # is accepted. */
+type ExcelColumnStyle = {
+    headerFill?: string;
+    headerColor?: string;
+    fill?: string;
+    color?: string;
+    bold?: boolean;
+    align?: ExcelAlign;
+    /** Excel number format, for example '"$"#,##0.00'. */
+    numFmt?: string;
+};
+type ExcelTheme = {
+    headerFill?: string;
+    headerColor?: string;
+    fill?: string;
+    color?: string;
+    borderColor?: string;
+    fontName?: string;
+    fontSize?: number;
+};
+type ExcelFormatParams = {
+    value: unknown;
+    data: Record<string, unknown>;
+};
+type ExcelExportColumn = {
+    field?: string;
+    headerName?: string;
+    children?: ExcelExportColumn[];
+    hide?: boolean;
+    checkboxSelection?: boolean;
+    headerCheckboxSelection?: boolean;
+    valueFormatter?: (params: ExcelFormatParams) => unknown;
+    format?: (params: ExcelFormatParams) => unknown;
+    excel?: ExcelColumnStyle;
+};
+type ExportExcelErrorCode = "empty" | "invalid" | "no-columns" | "filename" | "write";
+type ExportExcelFailure = {
+    ok: false;
+    code: ExportExcelErrorCode;
+    error: string;
+};
+type ExportExcelReportResult = {
+    ok: true;
+    fileName: string;
+} | ExportExcelFailure;
+type ExportExcelReportOptions = {
+    data?: unknown[] | null;
+    fileName?: string;
+    columns?: ExcelExportColumn[];
+    sheetName?: string;
+    theme?: ExcelTheme;
+    /** Drop columns with hide: true. Default false, matching vault grids. */
+    skipHidden?: boolean;
+    /**
+     * Format leaf fields whose name contains "date" when they have no formatter.
+     * Vault turns this on and passes its own date formatter.
+     */
+    formatDateFields?: boolean;
+    formatDate?: (value: unknown) => unknown;
+    /**
+     * Date suffix for the file name. Omit to use the local YYYY-MM-DD.
+     * Pass null when the caller could not produce a stamp.
+     */
+    dateStamp?: string | null;
+};
+type ResolvedTheme = {
+    headerFill: string;
+    headerColor: string;
+    fill: string;
+    color: string;
+    borderColor: string;
+    fontName: string;
+    fontSize: number;
+};
+type ExcelCellStyle = {
+    font: {
+        name: string;
+        sz: number;
+        bold?: boolean;
+        color: {
+            rgb: string;
+        };
+    };
+    fill: {
+        patternType: "solid";
+        fgColor: {
+            rgb: string;
+        };
+    };
+    alignment: {
+        vertical: "center";
+        horizontal: ExcelAlign;
+        wrapText: false;
+    };
+    border: {
+        top: {
+            style: "thin";
+            color: {
+                rgb: string;
+            };
+        };
+        bottom: {
+            style: "thin";
+            color: {
+                rgb: string;
+            };
+        };
+        left: {
+            style: "thin";
+            color: {
+                rgb: string;
+            };
+        };
+        right: {
+            style: "thin";
+            color: {
+                rgb: string;
+            };
+        };
+    };
+    numFmt?: string;
+};
+type WorkBook = {
+    SheetNames: string[];
+    Sheets: Record<string, WorkSheet>;
+};
+type WorkSheet = Record<string, unknown>;
+declare const DEFAULT_EXCEL_THEME: ResolvedTheme;
+declare const excelHeaderStyle: (theme?: ExcelTheme, column?: ExcelColumnStyle) => ExcelCellStyle;
+declare const excelDataStyle: (theme?: ExcelTheme, column?: ExcelColumnStyle) => ExcelCellStyle;
+type BuiltExcelWorkbook = {
+    ok: true;
+    workbook: WorkBook;
+    fileName: string;
+    sheetName: string;
+} | ExportExcelFailure;
+/**
+ * Build a styled workbook. Does not write a file.
+ * Header merges follow the column tree, so two groups with the same title stay separate.
+ */
+declare const buildExcelWorkbook: (options?: ExportExcelReportOptions) => BuiltExcelWorkbook;
+/** Write a styled .xlsx. Returns a result; it does not toast. */
+declare const exportExcelReport: (options?: ExportExcelReportOptions) => ExportExcelReportResult;
+
+export { type BuiltExcelWorkbook, DEFAULT_EXCEL_THEME, type ExcelAlign, type ExcelCellStyle, type ExcelColumnStyle, type ExcelExportColumn, type ExcelFormatParams, type ExcelTheme, type ExportExcelErrorCode, type ExportExcelFailure, type ExportExcelReportOptions, type ExportExcelReportResult, buildExcelWorkbook, excelDataStyle, excelHeaderStyle, exportExcelReport };

package/dist/excel/index.js

@@ -0,0 +1,355 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/excel/index.ts
+var excel_exports = {};
+__export(excel_exports, {
+  DEFAULT_EXCEL_THEME: () => DEFAULT_EXCEL_THEME,
+  buildExcelWorkbook: () => buildExcelWorkbook,
+  excelDataStyle: () => excelDataStyle,
+  excelHeaderStyle: () => excelHeaderStyle,
+  exportExcelReport: () => exportExcelReport
+});
+module.exports = __toCommonJS(excel_exports);
+var XLSX = __toESM(require("xlsx-js-style"));
+var ERRORS = {
+  empty: "No valid data to download. Please ensure data is available.",
+  invalid: "Invalid data structure. Please ensure data is correctly formatted.",
+  "no-columns": "No data to export. Please check the data source.",
+  filename: "Failed to generate file name. Please try again."
+};
+var DEFAULT_EXCEL_THEME = {
+  headerFill: "2F75B6",
+  headerColor: "FFFFFF",
+  fill: "FFFFFF",
+  color: "1F2933",
+  borderColor: "8FA4BF",
+  fontName: "Calibri",
+  fontSize: 11
+};
+var fail = (code) => ({
+  ok: false,
+  code,
+  error: ERRORS[code]
+});
+var rgb = (input, fallback) => {
+  if (!input) return fallback;
+  const hex = input.trim().replace(/^#/, "").toUpperCase();
+  return /^[0-9A-F]{6}$/.test(hex) ? hex : fallback;
+};
+var resolveTheme = (theme) => ({
+  headerFill: rgb(theme?.headerFill, DEFAULT_EXCEL_THEME.headerFill),
+  headerColor: rgb(theme?.headerColor, DEFAULT_EXCEL_THEME.headerColor),
+  fill: rgb(theme?.fill, DEFAULT_EXCEL_THEME.fill),
+  color: rgb(theme?.color, DEFAULT_EXCEL_THEME.color),
+  borderColor: rgb(theme?.borderColor, DEFAULT_EXCEL_THEME.borderColor),
+  fontName: theme?.fontName?.trim() || DEFAULT_EXCEL_THEME.fontName,
+  fontSize: typeof theme?.fontSize === "number" && theme.fontSize > 0 ? theme.fontSize : DEFAULT_EXCEL_THEME.fontSize
+});
+var gridBorder = (color) => {
+  const edge = () => ({ style: "thin", color: { rgb: color } });
+  return { top: edge(), bottom: edge(), left: edge(), right: edge() };
+};
+var excelHeaderStyle = (theme, column) => {
+  const resolved = resolveTheme(theme);
+  return {
+    font: {
+      name: resolved.fontName,
+      sz: resolved.fontSize,
+      bold: true,
+      color: { rgb: rgb(column?.headerColor, resolved.headerColor) }
+    },
+    fill: {
+      patternType: "solid",
+      fgColor: { rgb: rgb(column?.headerFill, resolved.headerFill) }
+    },
+    alignment: {
+      vertical: "center",
+      horizontal: column?.align ?? "left",
+      wrapText: false
+    },
+    border: gridBorder(resolved.borderColor)
+  };
+};
+var excelDataStyle = (theme, column) => {
+  const resolved = resolveTheme(theme);
+  const font = {
+    name: resolved.fontName,
+    sz: resolved.fontSize,
+    color: { rgb: rgb(column?.color, resolved.color) }
+  };
+  if (column?.bold) font.bold = true;
+  const style = {
+    font,
+    fill: {
+      patternType: "solid",
+      fgColor: { rgb: rgb(column?.fill, resolved.fill) }
+    },
+    alignment: {
+      vertical: "center",
+      horizontal: column?.align ?? "left",
+      wrapText: false
+    },
+    border: gridBorder(resolved.borderColor)
+  };
+  if (column?.numFmt) style.numFmt = column.numFmt;
+  return style;
+};
+var getNestedValue = (obj, path) => {
+  if (!obj || typeof obj !== "object") return "";
+  try {
+    const value = path.split(".").reduce((acc, key) => {
+      if (acc == null || typeof acc !== "object") return void 0;
+      return acc[key];
+    }, obj);
+    return value ?? "";
+  } catch {
+    return "";
+  }
+};
+var isGroup = (col) => Array.isArray(col.children) && col.children.length > 0;
+var isSkippedLeaf = (col) => {
+  if (col.checkboxSelection || col.headerCheckboxSelection) return true;
+  const field = typeof col.field === "string" ? col.field.trim() : "";
+  return !field || field === "checkbox" || field === "checkboxSelection";
+};
+var collectLeaves = (cols, groups, skipHidden) => {
+  const leaves = [];
+  cols.forEach((col) => {
+    if (!col || typeof col !== "object") return;
+    if (skipHidden && col.hide) return;
+    if (isGroup(col)) {
+      const group = {
+        name: col.headerName || "",
+        excel: col.excel
+      };
+      leaves.push(...collectLeaves(col.children ?? [], [...groups, group], skipHidden));
+      return;
+    }
+    if (isSkippedLeaf(col)) return;
+    const field = col.field.trim();
+    leaves.push({
+      field,
+      headerName: (col.headerName || field).trim() || field,
+      column: col,
+      groups
+    });
+  });
+  return leaves;
+};
+var labelFromKey = (key) => key.replace(/([A-Z])/g, " $1").replace(/^\w/, (char) => char.toUpperCase()).trim();
+var columnsFromRows = (rows) => {
+  const first = rows[0];
+  if (!first || typeof first !== "object" || Array.isArray(first)) {
+    return fail("invalid");
+  }
+  return Object.keys(first).filter((key) => key !== "checkbox" && key !== "checkboxSelection" && key.trim()).map((key) => ({ field: key, headerName: labelFromKey(key) }));
+};
+var formatLeafValue = (row, leaf, options) => {
+  let value = getNestedValue(row, leaf.field);
+  const formatter = leaf.column.format || leaf.column.valueFormatter;
+  if (typeof formatter === "function") {
+    try {
+      return formatter({ value, data: row }) ?? "";
+    } catch {
+      return value ?? "";
+    }
+  }
+  const fieldLooksLikeDate = leaf.field.toLowerCase().includes("date");
+  if (options.formatDateFields && fieldLooksLikeDate && typeof options.formatDate === "function") {
+    try {
+      return options.formatDate(value) ?? "";
+    } catch {
+      return value ?? "";
+    }
+  }
+  if (value instanceof Date) return value;
+  if (value != null && typeof value === "object") return "";
+  const numFmt = leaf.column.excel?.numFmt;
+  if (numFmt) {
+    if (typeof value === "number" && Number.isFinite(value)) return value;
+    if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) {
+      return Number(value);
+    }
+  }
+  return value ?? "";
+};
+var localDateStamp = () => {
+  const date = /* @__PURE__ */ new Date();
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+};
+var resolveDateStamp = (dateStamp) => {
+  if (dateStamp === null) return null;
+  if (typeof dateStamp === "string" && dateStamp.trim()) return dateStamp.trim();
+  return localDateStamp();
+};
+var safeSheetName = (name) => {
+  const cleaned = (name || "Report").replace(/[:\\/?*[\]]/g, " ").trim() || "Report";
+  return cleaned.slice(0, 31);
+};
+var buildHeaderGrid = (leaves) => {
+  const totalHeaderRows = Math.max(...leaves.map((leaf) => leaf.groups.length + 1), 1);
+  const headerRows = Array.from(
+    { length: totalHeaderRows },
+    () => Array.from({ length: leaves.length }, () => "")
+  );
+  const merges = [];
+  for (let depth = 0; depth < totalHeaderRows - 1; depth += 1) {
+    let colIndex = 0;
+    while (colIndex < leaves.length) {
+      const group = leaves[colIndex].groups[depth];
+      if (!group) {
+        colIndex += 1;
+        continue;
+      }
+      let span = 1;
+      while (colIndex + span < leaves.length && leaves[colIndex + span].groups[depth] === group) {
+        span += 1;
+      }
+      headerRows[depth][colIndex] = group.name;
+      if (span > 1) {
+        merges.push({
+          s: { r: depth, c: colIndex },
+          e: { r: depth, c: colIndex + span - 1 }
+        });
+      }
+      colIndex += span;
+    }
+  }
+  leaves.forEach((leaf, colIndex) => {
+    const row = leaf.groups.length;
+    headerRows[row][colIndex] = leaf.headerName;
+    if (row < totalHeaderRows - 1) {
+      merges.push({
+        s: { r: row, c: colIndex },
+        e: { r: totalHeaderRows - 1, c: colIndex }
+      });
+    }
+  });
+  return { headerRows, merges, totalHeaderRows };
+};
+var headerStyleFor = (leaf, row, theme) => {
+  const source = row < leaf.groups.length ? leaf.groups[row].excel : leaf.column.excel;
+  return excelHeaderStyle(theme, source);
+};
+var columnWidth = (leaf, values) => {
+  const headerLength = Math.max(
+    leaf.headerName.length,
+    ...leaf.groups.map((group) => group.name.length),
+    0
+  );
+  const dataLength = values.reduce((max, value) => {
+    return Math.max(max, String(value ?? "").length);
+  }, 0);
+  return { wch: Math.min(Math.max(headerLength, dataLength, 12), 50) };
+};
+var buildExcelWorkbook = (options = {}) => {
+  const data = options.data;
+  if (!Array.isArray(data) || data.length === 0) return fail("empty");
+  const provided = Array.isArray(options.columns) ? options.columns : [];
+  const columns = provided.length ? provided : columnsFromRows(data);
+  if (!Array.isArray(columns)) return columns;
+  const leaves = collectLeaves(columns, [], options.skipHidden === true);
+  if (!leaves.length) return fail("no-columns");
+  const dateStamp = resolveDateStamp(options.dateStamp);
+  if (!dateStamp) return fail("filename");
+  const { headerRows, merges, totalHeaderRows } = buildHeaderGrid(leaves);
+  const records = data.map(
+    (row) => row && typeof row === "object" && !Array.isArray(row) ? row : {}
+  );
+  const dataRows = records.map(
+    (row) => leaves.map((leaf) => formatLeafValue(row, leaf, options))
+  );
+  const sheet = XLSX.utils.aoa_to_sheet([...headerRows, ...dataRows]);
+  const lastCell = XLSX.utils.encode_cell({
+    r: headerRows.length + dataRows.length - 1,
+    c: leaves.length - 1
+  });
+  sheet["!ref"] = `A1:${lastCell}`;
+  sheet["!merges"] = merges;
+  sheet["!cols"] = leaves.map(
+    (leaf, index) => columnWidth(
+      leaf,
+      dataRows.map((row) => row[index])
+    )
+  );
+  sheet["!rows"] = Array.from({ length: totalHeaderRows }, () => ({ hpt: 22 }));
+  const range = XLSX.utils.decode_range(sheet["!ref"]);
+  for (let row = range.s.r; row <= range.e.r; row += 1) {
+    for (let col = range.s.c; col <= range.e.c; col += 1) {
+      const address = XLSX.utils.encode_cell({ r: row, c: col });
+      const cell = sheet[address] ?? {
+        t: "s",
+        v: ""
+      };
+      const leaf = leaves[col];
+      if (row < totalHeaderRows) {
+        cell.s = headerStyleFor(leaf, row, options.theme);
+      } else {
+        const style = excelDataStyle(options.theme, leaf.column.excel);
+        if (leaf.column.excel?.numFmt) cell.z = leaf.column.excel.numFmt;
+        cell.s = style;
+      }
+      sheet[address] = cell;
+    }
+  }
+  const sheetName = safeSheetName(options.sheetName);
+  const workbook = XLSX.utils.book_new();
+  XLSX.utils.book_append_sheet(workbook, sheet, sheetName);
+  const baseName = options.fileName == null ? "" : String(options.fileName);
+  return {
+    ok: true,
+    workbook,
+    sheetName,
+    fileName: `${baseName ? `${baseName}_` : ""}${dateStamp}.xlsx`
+  };
+};
+var exportExcelReport = (options = {}) => {
+  const built = buildExcelWorkbook(options);
+  if (!built.ok) return built;
+  try {
+    XLSX.writeFile(built.workbook, built.fileName, { cellStyles: true });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return { ok: false, code: "write", error: message };
+  }
+  return { ok: true, fileName: built.fileName };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_EXCEL_THEME,
+  buildExcelWorkbook,
+  excelDataStyle,
+  excelHeaderStyle,
+  exportExcelReport
+});
+//# sourceMappingURL=index.js.map

package/dist/excel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/excel/index.ts"],"sourcesContent":["import * as XLSX from \"xlsx-js-style\";\r\n\r\nexport type ExcelAlign = \"left\" | \"center\" | \"right\";\r\n\r\n/** Per-column Excel colors. Hex is RRGGBB; a leading # is accepted. */\r\nexport type ExcelColumnStyle = {\r\n  headerFill?: string;\r\n  headerColor?: string;\r\n  fill?: string;\r\n  color?: string;\r\n  bold?: boolean;\r\n  align?: ExcelAlign;\r\n  /** Excel number format, for example '\"$\"#,##0.00'. */\r\n  numFmt?: string;\r\n};\r\n\r\nexport type ExcelTheme = {\r\n  headerFill?: string;\r\n  headerColor?: string;\r\n  fill?: string;\r\n  color?: string;\r\n  borderColor?: string;\r\n  fontName?: string;\r\n  fontSize?: number;\r\n};\r\n\r\nexport type ExcelFormatParams = {\r\n  value: unknown;\r\n  data: Record<string, unknown>;\r\n};\r\n\r\nexport type ExcelExportColumn = {\r\n  field?: string;\r\n  headerName?: string;\r\n  children?: ExcelExportColumn[];\r\n  hide?: boolean;\r\n  checkboxSelection?: boolean;\r\n  headerCheckboxSelection?: boolean;\r\n  valueFormatter?: (params: ExcelFormatParams) => unknown;\r\n  format?: (params: ExcelFormatParams) => unknown;\r\n  excel?: ExcelColumnStyle;\r\n};\r\n\r\nexport type ExportExcelErrorCode =\r\n  | \"empty\"\r\n  | \"invalid\"\r\n  | \"no-columns\"\r\n  | \"filename\"\r\n  | \"write\";\r\n\r\nexport type ExportExcelFailure = {\r\n  ok: false;\r\n  code: ExportExcelErrorCode;\r\n  error: string;\r\n};\r\n\r\nexport type ExportExcelReportResult =\r\n  | { ok: true; fileName: string }\r\n  | ExportExcelFailure;\r\n\r\nexport type ExportExcelReportOptions = {\r\n  data?: unknown[] | null;\r\n  fileName?: string;\r\n  columns?: ExcelExportColumn[];\r\n  sheetName?: string;\r\n  theme?: ExcelTheme;\r\n  /** Drop columns with hide: true. Default false, matching vault grids. */\r\n  skipHidden?: boolean;\r\n  /**\r\n   * Format leaf fields whose name contains \"date\" when they have no formatter.\r\n   * Vault turns this on and passes its own date formatter.\r\n   */\r\n  formatDateFields?: boolean;\r\n  formatDate?: (value: unknown) => unknown;\r\n  /**\r\n   * Date suffix for the file name. Omit to use the local YYYY-MM-DD.\r\n   * Pass null when the caller could not produce a stamp.\r\n   */\r\n  dateStamp?: string | null;\r\n};\r\n\r\ntype ResolvedTheme = {\r\n  headerFill: string;\r\n  headerColor: string;\r\n  fill: string;\r\n  color: string;\r\n  borderColor: string;\r\n  fontName: string;\r\n  fontSize: number;\r\n};\r\n\r\nexport type ExcelCellStyle = {\r\n  font: {\r\n    name: string;\r\n    sz: number;\r\n    bold?: boolean;\r\n    color: { rgb: string };\r\n  };\r\n  fill: { patternType: \"solid\"; fgColor: { rgb: string } };\r\n  alignment: {\r\n    vertical: \"center\";\r\n    horizontal: ExcelAlign;\r\n    wrapText: false;\r\n  };\r\n  border: {\r\n    top: { style: \"thin\"; color: { rgb: string } };\r\n    bottom: { style: \"thin\"; color: { rgb: string } };\r\n    left: { style: \"thin\"; color: { rgb: string } };\r\n    right: { style: \"thin\"; color: { rgb: string } };\r\n  };\r\n  numFmt?: string;\r\n};\r\n\r\ntype HeaderGroup = {\r\n  name: string;\r\n  excel?: ExcelColumnStyle;\r\n};\r\n\r\ntype LeafColumn = {\r\n  field: string;\r\n  headerName: string;\r\n  column: ExcelExportColumn;\r\n  groups: HeaderGroup[];\r\n};\r\n\r\ntype WorkBook = {\r\n  SheetNames: string[];\r\n  Sheets: Record<string, WorkSheet>;\r\n};\r\n\r\ntype WorkSheet = Record<string, unknown>;\r\n\r\nconst ERRORS: Record<Exclude<ExportExcelErrorCode, \"write\">, string> = {\r\n  empty: \"No valid data to download. Please ensure data is available.\",\r\n  invalid: \"Invalid data structure. Please ensure data is correctly formatted.\",\r\n  \"no-columns\": \"No data to export. Please check the data source.\",\r\n  filename: \"Failed to generate file name. Please try again.\",\r\n};\r\n\r\nexport const DEFAULT_EXCEL_THEME: ResolvedTheme = {\r\n  headerFill: \"2F75B6\",\r\n  headerColor: \"FFFFFF\",\r\n  fill: \"FFFFFF\",\r\n  color: \"1F2933\",\r\n  borderColor: \"8FA4BF\",\r\n  fontName: \"Calibri\",\r\n  fontSize: 11,\r\n};\r\n\r\nconst fail = (\r\n  code: Exclude<ExportExcelErrorCode, \"write\">,\r\n): ExportExcelFailure => ({\r\n  ok: false,\r\n  code,\r\n  error: ERRORS[code],\r\n});\r\n\r\nconst rgb = (input: string | undefined, fallback: string): string => {\r\n  if (!input) return fallback;\r\n  const hex = input.trim().replace(/^#/, \"\").toUpperCase();\r\n  return /^[0-9A-F]{6}$/.test(hex) ? hex : fallback;\r\n};\r\n\r\nconst resolveTheme = (theme?: ExcelTheme): ResolvedTheme => ({\r\n  headerFill: rgb(theme?.headerFill, DEFAULT_EXCEL_THEME.headerFill),\r\n  headerColor: rgb(theme?.headerColor, DEFAULT_EXCEL_THEME.headerColor),\r\n  fill: rgb(theme?.fill, DEFAULT_EXCEL_THEME.fill),\r\n  color: rgb(theme?.color, DEFAULT_EXCEL_THEME.color),\r\n  borderColor: rgb(theme?.borderColor, DEFAULT_EXCEL_THEME.borderColor),\r\n  fontName: theme?.fontName?.trim() || DEFAULT_EXCEL_THEME.fontName,\r\n  fontSize:\r\n    typeof theme?.fontSize === \"number\" && theme.fontSize > 0\r\n      ? theme.fontSize\r\n      : DEFAULT_EXCEL_THEME.fontSize,\r\n});\r\n\r\nconst gridBorder = (color: string): ExcelCellStyle[\"border\"] => {\r\n  const edge = () => ({ style: \"thin\" as const, color: { rgb: color } });\r\n  return { top: edge(), bottom: edge(), left: edge(), right: edge() };\r\n};\r\n\r\nexport const excelHeaderStyle = (\r\n  theme?: ExcelTheme,\r\n  column?: ExcelColumnStyle,\r\n): ExcelCellStyle => {\r\n  const resolved = resolveTheme(theme);\r\n  return {\r\n    font: {\r\n      name: resolved.fontName,\r\n      sz: resolved.fontSize,\r\n      bold: true,\r\n      color: { rgb: rgb(column?.headerColor, resolved.headerColor) },\r\n    },\r\n    fill: {\r\n      patternType: \"solid\",\r\n      fgColor: { rgb: rgb(column?.headerFill, resolved.headerFill) },\r\n    },\r\n    alignment: {\r\n      vertical: \"center\",\r\n      horizontal: column?.align ?? \"left\",\r\n      wrapText: false,\r\n    },\r\n    border: gridBorder(resolved.borderColor),\r\n  };\r\n};\r\n\r\nexport const excelDataStyle = (\r\n  theme?: ExcelTheme,\r\n  column?: ExcelColumnStyle,\r\n): ExcelCellStyle => {\r\n  const resolved = resolveTheme(theme);\r\n  const font: ExcelCellStyle[\"font\"] = {\r\n    name: resolved.fontName,\r\n    sz: resolved.fontSize,\r\n    color: { rgb: rgb(column?.color, resolved.color) },\r\n  };\r\n  if (column?.bold) font.bold = true;\r\n  const style: ExcelCellStyle = {\r\n    font,\r\n    fill: {\r\n      patternType: \"solid\",\r\n      fgColor: { rgb: rgb(column?.fill, resolved.fill) },\r\n    },\r\n    alignment: {\r\n      vertical: \"center\",\r\n      horizontal: column?.align ?? \"left\",\r\n      wrapText: false,\r\n    },\r\n    border: gridBorder(resolved.borderColor),\r\n  };\r\n  if (column?.numFmt) style.numFmt = column.numFmt;\r\n  return style;\r\n};\r\n\r\nconst getNestedValue = (obj: unknown, path: string): unknown => {\r\n  if (!obj || typeof obj !== \"object\") return \"\";\r\n  try {\r\n    const value = path.split(\".\").reduce<unknown>((acc, key) => {\r\n      if (acc == null || typeof acc !== \"object\") return undefined;\r\n      return (acc as Record<string, unknown>)[key];\r\n    }, obj);\r\n    return value ?? \"\";\r\n  } catch {\r\n    return \"\";\r\n  }\r\n};\r\n\r\nconst isGroup = (col: ExcelExportColumn): boolean =>\r\n  Array.isArray(col.children) && col.children.length > 0;\r\n\r\nconst isSkippedLeaf = (col: ExcelExportColumn): boolean => {\r\n  if (col.checkboxSelection || col.headerCheckboxSelection) return true;\r\n  const field = typeof col.field === \"string\" ? col.field.trim() : \"\";\r\n  return !field || field === \"checkbox\" || field === \"checkboxSelection\";\r\n};\r\n\r\nconst collectLeaves = (\r\n  cols: ExcelExportColumn[],\r\n  groups: HeaderGroup[],\r\n  skipHidden: boolean,\r\n): LeafColumn[] => {\r\n  const leaves: LeafColumn[] = [];\r\n  cols.forEach((col) => {\r\n    if (!col || typeof col !== \"object\") return;\r\n    if (skipHidden && col.hide) return;\r\n    if (isGroup(col)) {\r\n      const group: HeaderGroup = {\r\n        name: col.headerName || \"\",\r\n        excel: col.excel,\r\n      };\r\n      leaves.push(...collectLeaves(col.children ?? [], [...groups, group], skipHidden));\r\n      return;\r\n    }\r\n    if (isSkippedLeaf(col)) return;\r\n    const field = col.field!.trim();\r\n    leaves.push({\r\n      field,\r\n      headerName: (col.headerName || field).trim() || field,\r\n      column: col,\r\n      groups,\r\n    });\r\n  });\r\n  return leaves;\r\n};\r\n\r\nconst labelFromKey = (key: string): string =>\r\n  key\r\n    .replace(/([A-Z])/g, \" $1\")\r\n    .replace(/^\\w/, (char) => char.toUpperCase())\r\n    .trim();\r\n\r\nconst columnsFromRows = (rows: unknown[]): ExcelExportColumn[] | ExportExcelFailure => {\r\n  const first = rows[0];\r\n  if (!first || typeof first !== \"object\" || Array.isArray(first)) {\r\n    return fail(\"invalid\");\r\n  }\r\n  return Object.keys(first)\r\n    .filter((key) => key !== \"checkbox\" && key !== \"checkboxSelection\" && key.trim())\r\n    .map((key) => ({ field: key, headerName: labelFromKey(key) }));\r\n};\r\n\r\nconst formatLeafValue = (\r\n  row: Record<string, unknown>,\r\n  leaf: LeafColumn,\r\n  options: ExportExcelReportOptions,\r\n): unknown => {\r\n  let value = getNestedValue(row, leaf.field);\r\n  const formatter = leaf.column.format || leaf.column.valueFormatter;\r\n  if (typeof formatter === \"function\") {\r\n    try {\r\n      return formatter({ value, data: row }) ?? \"\";\r\n    } catch {\r\n      return value ?? \"\";\r\n    }\r\n  }\r\n\r\n  const fieldLooksLikeDate = leaf.field.toLowerCase().includes(\"date\");\r\n  if (options.formatDateFields && fieldLooksLikeDate && typeof options.formatDate === \"function\") {\r\n    try {\r\n      return options.formatDate(value) ?? \"\";\r\n    } catch {\r\n      return value ?? \"\";\r\n    }\r\n  }\r\n\r\n  if (value instanceof Date) return value;\r\n  if (value != null && typeof value === \"object\") return \"\";\r\n\r\n  const numFmt = leaf.column.excel?.numFmt;\r\n  if (numFmt) {\r\n    if (typeof value === \"number\" && Number.isFinite(value)) return value;\r\n    if (typeof value === \"string\" && value.trim() !== \"\" && Number.isFinite(Number(value))) {\r\n      return Number(value);\r\n    }\r\n  }\r\n\r\n  return value ?? \"\";\r\n};\r\n\r\nconst localDateStamp = (): string => {\r\n  const date = new Date();\r\n  const year = date.getFullYear();\r\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\r\n  const day = String(date.getDate()).padStart(2, \"0\");\r\n  return `${year}-${month}-${day}`;\r\n};\r\n\r\nconst resolveDateStamp = (dateStamp: string | null | undefined): string | null => {\r\n  if (dateStamp === null) return null;\r\n  if (typeof dateStamp === \"string\" && dateStamp.trim()) return dateStamp.trim();\r\n  return localDateStamp();\r\n};\r\n\r\nconst safeSheetName = (name: string | undefined): string => {\r\n  const cleaned = (name || \"Report\").replace(/[:\\\\/?*[\\]]/g, \" \").trim() || \"Report\";\r\n  return cleaned.slice(0, 31);\r\n};\r\n\r\nconst buildHeaderGrid = (leaves: LeafColumn[]) => {\r\n  const totalHeaderRows = Math.max(...leaves.map((leaf) => leaf.groups.length + 1), 1);\r\n  const headerRows = Array.from({ length: totalHeaderRows }, () =>\r\n    Array.from({ length: leaves.length }, () => \"\"),\r\n  );\r\n  const merges: { s: { r: number; c: number }; e: { r: number; c: number } }[] = [];\r\n\r\n  for (let depth = 0; depth < totalHeaderRows - 1; depth += 1) {\r\n    let colIndex = 0;\r\n    while (colIndex < leaves.length) {\r\n      const group = leaves[colIndex].groups[depth];\r\n      if (!group) {\r\n        colIndex += 1;\r\n        continue;\r\n      }\r\n      let span = 1;\r\n      while (colIndex + span < leaves.length && leaves[colIndex + span].groups[depth] === group) {\r\n        span += 1;\r\n      }\r\n      headerRows[depth][colIndex] = group.name;\r\n      if (span > 1) {\r\n        merges.push({\r\n          s: { r: depth, c: colIndex },\r\n          e: { r: depth, c: colIndex + span - 1 },\r\n        });\r\n      }\r\n      colIndex += span;\r\n    }\r\n  }\r\n\r\n  leaves.forEach((leaf, colIndex) => {\r\n    const row = leaf.groups.length;\r\n    headerRows[row][colIndex] = leaf.headerName;\r\n    if (row < totalHeaderRows - 1) {\r\n      merges.push({\r\n        s: { r: row, c: colIndex },\r\n        e: { r: totalHeaderRows - 1, c: colIndex },\r\n      });\r\n    }\r\n  });\r\n\r\n  return { headerRows, merges, totalHeaderRows };\r\n};\r\n\r\nconst headerStyleFor = (\r\n  leaf: LeafColumn,\r\n  row: number,\r\n  theme: ExcelTheme | undefined,\r\n): ExcelCellStyle => {\r\n  const source = row < leaf.groups.length ? leaf.groups[row].excel : leaf.column.excel;\r\n  return excelHeaderStyle(theme, source);\r\n};\r\n\r\nconst columnWidth = (leaf: LeafColumn, values: unknown[]): { wch: number } => {\r\n  const headerLength = Math.max(\r\n    leaf.headerName.length,\r\n    ...leaf.groups.map((group) => group.name.length),\r\n    0,\r\n  );\r\n  const dataLength = values.reduce<number>((max, value) => {\r\n    return Math.max(max, String(value ?? \"\").length);\r\n  }, 0);\r\n  return { wch: Math.min(Math.max(headerLength, dataLength, 12), 50) };\r\n};\r\n\r\nexport type BuiltExcelWorkbook =\r\n  | { ok: true; workbook: WorkBook; fileName: string; sheetName: string }\r\n  | ExportExcelFailure;\r\n\r\n/**\r\n * Build a styled workbook. Does not write a file.\r\n * Header merges follow the column tree, so two groups with the same title stay separate.\r\n */\r\nexport const buildExcelWorkbook = (\r\n  options: ExportExcelReportOptions = {},\r\n): BuiltExcelWorkbook => {\r\n  const data = options.data;\r\n  if (!Array.isArray(data) || data.length === 0) return fail(\"empty\");\r\n\r\n  const provided = Array.isArray(options.columns) ? options.columns : [];\r\n  const columns = provided.length\r\n    ? provided\r\n    : columnsFromRows(data);\r\n  if (!Array.isArray(columns)) return columns;\r\n\r\n  const leaves = collectLeaves(columns, [], options.skipHidden === true);\r\n  if (!leaves.length) return fail(\"no-columns\");\r\n\r\n  const dateStamp = resolveDateStamp(options.dateStamp);\r\n  if (!dateStamp) return fail(\"filename\");\r\n\r\n  const { headerRows, merges, totalHeaderRows } = buildHeaderGrid(leaves);\r\n  const records = data.map((row) =>\r\n    row && typeof row === \"object\" && !Array.isArray(row)\r\n      ? (row as Record<string, unknown>)\r\n      : {},\r\n  );\r\n  const dataRows = records.map((row) =>\r\n    leaves.map((leaf) => formatLeafValue(row, leaf, options)),\r\n  );\r\n\r\n  const sheet = XLSX.utils.aoa_to_sheet([...headerRows, ...dataRows]) as WorkSheet;\r\n  const lastCell = XLSX.utils.encode_cell({\r\n    r: headerRows.length + dataRows.length - 1,\r\n    c: leaves.length - 1,\r\n  });\r\n  sheet[\"!ref\"] = `A1:${lastCell}`;\r\n  sheet[\"!merges\"] = merges;\r\n  sheet[\"!cols\"] = leaves.map((leaf, index) =>\r\n    columnWidth(\r\n      leaf,\r\n      dataRows.map((row) => row[index]),\r\n    ),\r\n  );\r\n  sheet[\"!rows\"] = Array.from({ length: totalHeaderRows }, () => ({ hpt: 22 }));\r\n\r\n  const range = XLSX.utils.decode_range(sheet[\"!ref\"] as string);\r\n  for (let row = range.s.r; row <= range.e.r; row += 1) {\r\n    for (let col = range.s.c; col <= range.e.c; col += 1) {\r\n      const address = XLSX.utils.encode_cell({ r: row, c: col });\r\n      const cell = (sheet[address] as { t?: string; v?: unknown; z?: string; s?: ExcelCellStyle } | undefined) ?? {\r\n        t: \"s\",\r\n        v: \"\",\r\n      };\r\n      const leaf = leaves[col];\r\n      if (row < totalHeaderRows) {\r\n        cell.s = headerStyleFor(leaf, row, options.theme);\r\n      } else {\r\n        const style = excelDataStyle(options.theme, leaf.column.excel);\r\n        if (leaf.column.excel?.numFmt) cell.z = leaf.column.excel.numFmt;\r\n        cell.s = style;\r\n      }\r\n      sheet[address] = cell;\r\n    }\r\n  }\r\n\r\n  const sheetName = safeSheetName(options.sheetName);\r\n  const workbook = XLSX.utils.book_new() as WorkBook;\r\n  XLSX.utils.book_append_sheet(workbook, sheet, sheetName);\r\n\r\n  const baseName = options.fileName == null ? \"\" : String(options.fileName);\r\n  return {\r\n    ok: true,\r\n    workbook,\r\n    sheetName,\r\n    fileName: `${baseName ? `${baseName}_` : \"\"}${dateStamp}.xlsx`,\r\n  };\r\n};\r\n\r\n/** Write a styled .xlsx. Returns a result; it does not toast. */\r\nexport const exportExcelReport = (\r\n  options: ExportExcelReportOptions = {},\r\n): ExportExcelReportResult => {\r\n  const built = buildExcelWorkbook(options);\r\n  if (!built.ok) return built;\r\n  try {\r\n    XLSX.writeFile(built.workbook, built.fileName, { cellStyles: true });\r\n  } catch (error) {\r\n    const message = error instanceof Error ? error.message : \"Unknown error\";\r\n    return { ok: false, code: \"write\", error: message };\r\n  }\r\n  return { ok: true, fileName: built.fileName };\r\n};\r\n"],"mappings":"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","names":[]}

package/dist/excel/index.mjs

@@ -0,0 +1,316 @@
+// src/excel/index.ts
+import * as XLSX from "xlsx-js-style";
+var ERRORS = {
+  empty: "No valid data to download. Please ensure data is available.",
+  invalid: "Invalid data structure. Please ensure data is correctly formatted.",
+  "no-columns": "No data to export. Please check the data source.",
+  filename: "Failed to generate file name. Please try again."
+};
+var DEFAULT_EXCEL_THEME = {
+  headerFill: "2F75B6",
+  headerColor: "FFFFFF",
+  fill: "FFFFFF",
+  color: "1F2933",
+  borderColor: "8FA4BF",
+  fontName: "Calibri",
+  fontSize: 11
+};
+var fail = (code) => ({
+  ok: false,
+  code,
+  error: ERRORS[code]
+});
+var rgb = (input, fallback) => {
+  if (!input) return fallback;
+  const hex = input.trim().replace(/^#/, "").toUpperCase();
+  return /^[0-9A-F]{6}$/.test(hex) ? hex : fallback;
+};
+var resolveTheme = (theme) => ({
+  headerFill: rgb(theme?.headerFill, DEFAULT_EXCEL_THEME.headerFill),
+  headerColor: rgb(theme?.headerColor, DEFAULT_EXCEL_THEME.headerColor),
+  fill: rgb(theme?.fill, DEFAULT_EXCEL_THEME.fill),
+  color: rgb(theme?.color, DEFAULT_EXCEL_THEME.color),
+  borderColor: rgb(theme?.borderColor, DEFAULT_EXCEL_THEME.borderColor),
+  fontName: theme?.fontName?.trim() || DEFAULT_EXCEL_THEME.fontName,
+  fontSize: typeof theme?.fontSize === "number" && theme.fontSize > 0 ? theme.fontSize : DEFAULT_EXCEL_THEME.fontSize
+});
+var gridBorder = (color) => {
+  const edge = () => ({ style: "thin", color: { rgb: color } });
+  return { top: edge(), bottom: edge(), left: edge(), right: edge() };
+};
+var excelHeaderStyle = (theme, column) => {
+  const resolved = resolveTheme(theme);
+  return {
+    font: {
+      name: resolved.fontName,
+      sz: resolved.fontSize,
+      bold: true,
+      color: { rgb: rgb(column?.headerColor, resolved.headerColor) }
+    },
+    fill: {
+      patternType: "solid",
+      fgColor: { rgb: rgb(column?.headerFill, resolved.headerFill) }
+    },
+    alignment: {
+      vertical: "center",
+      horizontal: column?.align ?? "left",
+      wrapText: false
+    },
+    border: gridBorder(resolved.borderColor)
+  };
+};
+var excelDataStyle = (theme, column) => {
+  const resolved = resolveTheme(theme);
+  const font = {
+    name: resolved.fontName,
+    sz: resolved.fontSize,
+    color: { rgb: rgb(column?.color, resolved.color) }
+  };
+  if (column?.bold) font.bold = true;
+  const style = {
+    font,
+    fill: {
+      patternType: "solid",
+      fgColor: { rgb: rgb(column?.fill, resolved.fill) }
+    },
+    alignment: {
+      vertical: "center",
+      horizontal: column?.align ?? "left",
+      wrapText: false
+    },
+    border: gridBorder(resolved.borderColor)
+  };
+  if (column?.numFmt) style.numFmt = column.numFmt;
+  return style;
+};
+var getNestedValue = (obj, path) => {
+  if (!obj || typeof obj !== "object") return "";
+  try {
+    const value = path.split(".").reduce((acc, key) => {
+      if (acc == null || typeof acc !== "object") return void 0;
+      return acc[key];
+    }, obj);
+    return value ?? "";
+  } catch {
+    return "";
+  }
+};
+var isGroup = (col) => Array.isArray(col.children) && col.children.length > 0;
+var isSkippedLeaf = (col) => {
+  if (col.checkboxSelection || col.headerCheckboxSelection) return true;
+  const field = typeof col.field === "string" ? col.field.trim() : "";
+  return !field || field === "checkbox" || field === "checkboxSelection";
+};
+var collectLeaves = (cols, groups, skipHidden) => {
+  const leaves = [];
+  cols.forEach((col) => {
+    if (!col || typeof col !== "object") return;
+    if (skipHidden && col.hide) return;
+    if (isGroup(col)) {
+      const group = {
+        name: col.headerName || "",
+        excel: col.excel
+      };
+      leaves.push(...collectLeaves(col.children ?? [], [...groups, group], skipHidden));
+      return;
+    }
+    if (isSkippedLeaf(col)) return;
+    const field = col.field.trim();
+    leaves.push({
+      field,
+      headerName: (col.headerName || field).trim() || field,
+      column: col,
+      groups
+    });
+  });
+  return leaves;
+};
+var labelFromKey = (key) => key.replace(/([A-Z])/g, " $1").replace(/^\w/, (char) => char.toUpperCase()).trim();
+var columnsFromRows = (rows) => {
+  const first = rows[0];
+  if (!first || typeof first !== "object" || Array.isArray(first)) {
+    return fail("invalid");
+  }
+  return Object.keys(first).filter((key) => key !== "checkbox" && key !== "checkboxSelection" && key.trim()).map((key) => ({ field: key, headerName: labelFromKey(key) }));
+};
+var formatLeafValue = (row, leaf, options) => {
+  let value = getNestedValue(row, leaf.field);
+  const formatter = leaf.column.format || leaf.column.valueFormatter;
+  if (typeof formatter === "function") {
+    try {
+      return formatter({ value, data: row }) ?? "";
+    } catch {
+      return value ?? "";
+    }
+  }
+  const fieldLooksLikeDate = leaf.field.toLowerCase().includes("date");
+  if (options.formatDateFields && fieldLooksLikeDate && typeof options.formatDate === "function") {
+    try {
+      return options.formatDate(value) ?? "";
+    } catch {
+      return value ?? "";
+    }
+  }
+  if (value instanceof Date) return value;
+  if (value != null && typeof value === "object") return "";
+  const numFmt = leaf.column.excel?.numFmt;
+  if (numFmt) {
+    if (typeof value === "number" && Number.isFinite(value)) return value;
+    if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) {
+      return Number(value);
+    }
+  }
+  return value ?? "";
+};
+var localDateStamp = () => {
+  const date = /* @__PURE__ */ new Date();
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+};
+var resolveDateStamp = (dateStamp) => {
+  if (dateStamp === null) return null;
+  if (typeof dateStamp === "string" && dateStamp.trim()) return dateStamp.trim();
+  return localDateStamp();
+};
+var safeSheetName = (name) => {
+  const cleaned = (name || "Report").replace(/[:\\/?*[\]]/g, " ").trim() || "Report";
+  return cleaned.slice(0, 31);
+};
+var buildHeaderGrid = (leaves) => {
+  const totalHeaderRows = Math.max(...leaves.map((leaf) => leaf.groups.length + 1), 1);
+  const headerRows = Array.from(
+    { length: totalHeaderRows },
+    () => Array.from({ length: leaves.length }, () => "")
+  );
+  const merges = [];
+  for (let depth = 0; depth < totalHeaderRows - 1; depth += 1) {
+    let colIndex = 0;
+    while (colIndex < leaves.length) {
+      const group = leaves[colIndex].groups[depth];
+      if (!group) {
+        colIndex += 1;
+        continue;
+      }
+      let span = 1;
+      while (colIndex + span < leaves.length && leaves[colIndex + span].groups[depth] === group) {
+        span += 1;
+      }
+      headerRows[depth][colIndex] = group.name;
+      if (span > 1) {
+        merges.push({
+          s: { r: depth, c: colIndex },
+          e: { r: depth, c: colIndex + span - 1 }
+        });
+      }
+      colIndex += span;
+    }
+  }
+  leaves.forEach((leaf, colIndex) => {
+    const row = leaf.groups.length;
+    headerRows[row][colIndex] = leaf.headerName;
+    if (row < totalHeaderRows - 1) {
+      merges.push({
+        s: { r: row, c: colIndex },
+        e: { r: totalHeaderRows - 1, c: colIndex }
+      });
+    }
+  });
+  return { headerRows, merges, totalHeaderRows };
+};
+var headerStyleFor = (leaf, row, theme) => {
+  const source = row < leaf.groups.length ? leaf.groups[row].excel : leaf.column.excel;
+  return excelHeaderStyle(theme, source);
+};
+var columnWidth = (leaf, values) => {
+  const headerLength = Math.max(
+    leaf.headerName.length,
+    ...leaf.groups.map((group) => group.name.length),
+    0
+  );
+  const dataLength = values.reduce((max, value) => {
+    return Math.max(max, String(value ?? "").length);
+  }, 0);
+  return { wch: Math.min(Math.max(headerLength, dataLength, 12), 50) };
+};
+var buildExcelWorkbook = (options = {}) => {
+  const data = options.data;
+  if (!Array.isArray(data) || data.length === 0) return fail("empty");
+  const provided = Array.isArray(options.columns) ? options.columns : [];
+  const columns = provided.length ? provided : columnsFromRows(data);
+  if (!Array.isArray(columns)) return columns;
+  const leaves = collectLeaves(columns, [], options.skipHidden === true);
+  if (!leaves.length) return fail("no-columns");
+  const dateStamp = resolveDateStamp(options.dateStamp);
+  if (!dateStamp) return fail("filename");
+  const { headerRows, merges, totalHeaderRows } = buildHeaderGrid(leaves);
+  const records = data.map(
+    (row) => row && typeof row === "object" && !Array.isArray(row) ? row : {}
+  );
+  const dataRows = records.map(
+    (row) => leaves.map((leaf) => formatLeafValue(row, leaf, options))
+  );
+  const sheet = XLSX.utils.aoa_to_sheet([...headerRows, ...dataRows]);
+  const lastCell = XLSX.utils.encode_cell({
+    r: headerRows.length + dataRows.length - 1,
+    c: leaves.length - 1
+  });
+  sheet["!ref"] = `A1:${lastCell}`;
+  sheet["!merges"] = merges;
+  sheet["!cols"] = leaves.map(
+    (leaf, index) => columnWidth(
+      leaf,
+      dataRows.map((row) => row[index])
+    )
+  );
+  sheet["!rows"] = Array.from({ length: totalHeaderRows }, () => ({ hpt: 22 }));
+  const range = XLSX.utils.decode_range(sheet["!ref"]);
+  for (let row = range.s.r; row <= range.e.r; row += 1) {
+    for (let col = range.s.c; col <= range.e.c; col += 1) {
+      const address = XLSX.utils.encode_cell({ r: row, c: col });
+      const cell = sheet[address] ?? {
+        t: "s",
+        v: ""
+      };
+      const leaf = leaves[col];
+      if (row < totalHeaderRows) {
+        cell.s = headerStyleFor(leaf, row, options.theme);
+      } else {
+        const style = excelDataStyle(options.theme, leaf.column.excel);
+        if (leaf.column.excel?.numFmt) cell.z = leaf.column.excel.numFmt;
+        cell.s = style;
+      }
+      sheet[address] = cell;
+    }
+  }
+  const sheetName = safeSheetName(options.sheetName);
+  const workbook = XLSX.utils.book_new();
+  XLSX.utils.book_append_sheet(workbook, sheet, sheetName);
+  const baseName = options.fileName == null ? "" : String(options.fileName);
+  return {
+    ok: true,
+    workbook,
+    sheetName,
+    fileName: `${baseName ? `${baseName}_` : ""}${dateStamp}.xlsx`
+  };
+};
+var exportExcelReport = (options = {}) => {
+  const built = buildExcelWorkbook(options);
+  if (!built.ok) return built;
+  try {
+    XLSX.writeFile(built.workbook, built.fileName, { cellStyles: true });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return { ok: false, code: "write", error: message };
+  }
+  return { ok: true, fileName: built.fileName };
+};
+export {
+  DEFAULT_EXCEL_THEME,
+  buildExcelWorkbook,
+  excelDataStyle,
+  excelHeaderStyle,
+  exportExcelReport
+};
+//# sourceMappingURL=index.mjs.map

package/dist/excel/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/excel/index.ts"],"sourcesContent":["import * as XLSX from \"xlsx-js-style\";\r\n\r\nexport type ExcelAlign = \"left\" | \"center\" | \"right\";\r\n\r\n/** Per-column Excel colors. Hex is RRGGBB; a leading # is accepted. */\r\nexport type ExcelColumnStyle = {\r\n  headerFill?: string;\r\n  headerColor?: string;\r\n  fill?: string;\r\n  color?: string;\r\n  bold?: boolean;\r\n  align?: ExcelAlign;\r\n  /** Excel number format, for example '\"$\"#,##0.00'. */\r\n  numFmt?: string;\r\n};\r\n\r\nexport type ExcelTheme = {\r\n  headerFill?: string;\r\n  headerColor?: string;\r\n  fill?: string;\r\n  color?: string;\r\n  borderColor?: string;\r\n  fontName?: string;\r\n  fontSize?: number;\r\n};\r\n\r\nexport type ExcelFormatParams = {\r\n  value: unknown;\r\n  data: Record<string, unknown>;\r\n};\r\n\r\nexport type ExcelExportColumn = {\r\n  field?: string;\r\n  headerName?: string;\r\n  children?: ExcelExportColumn[];\r\n  hide?: boolean;\r\n  checkboxSelection?: boolean;\r\n  headerCheckboxSelection?: boolean;\r\n  valueFormatter?: (params: ExcelFormatParams) => unknown;\r\n  format?: (params: ExcelFormatParams) => unknown;\r\n  excel?: ExcelColumnStyle;\r\n};\r\n\r\nexport type ExportExcelErrorCode =\r\n  | \"empty\"\r\n  | \"invalid\"\r\n  | \"no-columns\"\r\n  | \"filename\"\r\n  | \"write\";\r\n\r\nexport type ExportExcelFailure = {\r\n  ok: false;\r\n  code: ExportExcelErrorCode;\r\n  error: string;\r\n};\r\n\r\nexport type ExportExcelReportResult =\r\n  | { ok: true; fileName: string }\r\n  | ExportExcelFailure;\r\n\r\nexport type ExportExcelReportOptions = {\r\n  data?: unknown[] | null;\r\n  fileName?: string;\r\n  columns?: ExcelExportColumn[];\r\n  sheetName?: string;\r\n  theme?: ExcelTheme;\r\n  /** Drop columns with hide: true. Default false, matching vault grids. */\r\n  skipHidden?: boolean;\r\n  /**\r\n   * Format leaf fields whose name contains \"date\" when they have no formatter.\r\n   * Vault turns this on and passes its own date formatter.\r\n   */\r\n  formatDateFields?: boolean;\r\n  formatDate?: (value: unknown) => unknown;\r\n  /**\r\n   * Date suffix for the file name. Omit to use the local YYYY-MM-DD.\r\n   * Pass null when the caller could not produce a stamp.\r\n   */\r\n  dateStamp?: string | null;\r\n};\r\n\r\ntype ResolvedTheme = {\r\n  headerFill: string;\r\n  headerColor: string;\r\n  fill: string;\r\n  color: string;\r\n  borderColor: string;\r\n  fontName: string;\r\n  fontSize: number;\r\n};\r\n\r\nexport type ExcelCellStyle = {\r\n  font: {\r\n    name: string;\r\n    sz: number;\r\n    bold?: boolean;\r\n    color: { rgb: string };\r\n  };\r\n  fill: { patternType: \"solid\"; fgColor: { rgb: string } };\r\n  alignment: {\r\n    vertical: \"center\";\r\n    horizontal: ExcelAlign;\r\n    wrapText: false;\r\n  };\r\n  border: {\r\n    top: { style: \"thin\"; color: { rgb: string } };\r\n    bottom: { style: \"thin\"; color: { rgb: string } };\r\n    left: { style: \"thin\"; color: { rgb: string } };\r\n    right: { style: \"thin\"; color: { rgb: string } };\r\n  };\r\n  numFmt?: string;\r\n};\r\n\r\ntype HeaderGroup = {\r\n  name: string;\r\n  excel?: ExcelColumnStyle;\r\n};\r\n\r\ntype LeafColumn = {\r\n  field: string;\r\n  headerName: string;\r\n  column: ExcelExportColumn;\r\n  groups: HeaderGroup[];\r\n};\r\n\r\ntype WorkBook = {\r\n  SheetNames: string[];\r\n  Sheets: Record<string, WorkSheet>;\r\n};\r\n\r\ntype WorkSheet = Record<string, unknown>;\r\n\r\nconst ERRORS: Record<Exclude<ExportExcelErrorCode, \"write\">, string> = {\r\n  empty: \"No valid data to download. Please ensure data is available.\",\r\n  invalid: \"Invalid data structure. Please ensure data is correctly formatted.\",\r\n  \"no-columns\": \"No data to export. Please check the data source.\",\r\n  filename: \"Failed to generate file name. Please try again.\",\r\n};\r\n\r\nexport const DEFAULT_EXCEL_THEME: ResolvedTheme = {\r\n  headerFill: \"2F75B6\",\r\n  headerColor: \"FFFFFF\",\r\n  fill: \"FFFFFF\",\r\n  color: \"1F2933\",\r\n  borderColor: \"8FA4BF\",\r\n  fontName: \"Calibri\",\r\n  fontSize: 11,\r\n};\r\n\r\nconst fail = (\r\n  code: Exclude<ExportExcelErrorCode, \"write\">,\r\n): ExportExcelFailure => ({\r\n  ok: false,\r\n  code,\r\n  error: ERRORS[code],\r\n});\r\n\r\nconst rgb = (input: string | undefined, fallback: string): string => {\r\n  if (!input) return fallback;\r\n  const hex = input.trim().replace(/^#/, \"\").toUpperCase();\r\n  return /^[0-9A-F]{6}$/.test(hex) ? hex : fallback;\r\n};\r\n\r\nconst resolveTheme = (theme?: ExcelTheme): ResolvedTheme => ({\r\n  headerFill: rgb(theme?.headerFill, DEFAULT_EXCEL_THEME.headerFill),\r\n  headerColor: rgb(theme?.headerColor, DEFAULT_EXCEL_THEME.headerColor),\r\n  fill: rgb(theme?.fill, DEFAULT_EXCEL_THEME.fill),\r\n  color: rgb(theme?.color, DEFAULT_EXCEL_THEME.color),\r\n  borderColor: rgb(theme?.borderColor, DEFAULT_EXCEL_THEME.borderColor),\r\n  fontName: theme?.fontName?.trim() || DEFAULT_EXCEL_THEME.fontName,\r\n  fontSize:\r\n    typeof theme?.fontSize === \"number\" && theme.fontSize > 0\r\n      ? theme.fontSize\r\n      : DEFAULT_EXCEL_THEME.fontSize,\r\n});\r\n\r\nconst gridBorder = (color: string): ExcelCellStyle[\"border\"] => {\r\n  const edge = () => ({ style: \"thin\" as const, color: { rgb: color } });\r\n  return { top: edge(), bottom: edge(), left: edge(), right: edge() };\r\n};\r\n\r\nexport const excelHeaderStyle = (\r\n  theme?: ExcelTheme,\r\n  column?: ExcelColumnStyle,\r\n): ExcelCellStyle => {\r\n  const resolved = resolveTheme(theme);\r\n  return {\r\n    font: {\r\n      name: resolved.fontName,\r\n      sz: resolved.fontSize,\r\n      bold: true,\r\n      color: { rgb: rgb(column?.headerColor, resolved.headerColor) },\r\n    },\r\n    fill: {\r\n      patternType: \"solid\",\r\n      fgColor: { rgb: rgb(column?.headerFill, resolved.headerFill) },\r\n    },\r\n    alignment: {\r\n      vertical: \"center\",\r\n      horizontal: column?.align ?? \"left\",\r\n      wrapText: false,\r\n    },\r\n    border: gridBorder(resolved.borderColor),\r\n  };\r\n};\r\n\r\nexport const excelDataStyle = (\r\n  theme?: ExcelTheme,\r\n  column?: ExcelColumnStyle,\r\n): ExcelCellStyle => {\r\n  const resolved = resolveTheme(theme);\r\n  const font: ExcelCellStyle[\"font\"] = {\r\n    name: resolved.fontName,\r\n    sz: resolved.fontSize,\r\n    color: { rgb: rgb(column?.color, resolved.color) },\r\n  };\r\n  if (column?.bold) font.bold = true;\r\n  const style: ExcelCellStyle = {\r\n    font,\r\n    fill: {\r\n      patternType: \"solid\",\r\n      fgColor: { rgb: rgb(column?.fill, resolved.fill) },\r\n    },\r\n    alignment: {\r\n      vertical: \"center\",\r\n      horizontal: column?.align ?? \"left\",\r\n      wrapText: false,\r\n    },\r\n    border: gridBorder(resolved.borderColor),\r\n  };\r\n  if (column?.numFmt) style.numFmt = column.numFmt;\r\n  return style;\r\n};\r\n\r\nconst getNestedValue = (obj: unknown, path: string): unknown => {\r\n  if (!obj || typeof obj !== \"object\") return \"\";\r\n  try {\r\n    const value = path.split(\".\").reduce<unknown>((acc, key) => {\r\n      if (acc == null || typeof acc !== \"object\") return undefined;\r\n      return (acc as Record<string, unknown>)[key];\r\n    }, obj);\r\n    return value ?? \"\";\r\n  } catch {\r\n    return \"\";\r\n  }\r\n};\r\n\r\nconst isGroup = (col: ExcelExportColumn): boolean =>\r\n  Array.isArray(col.children) && col.children.length > 0;\r\n\r\nconst isSkippedLeaf = (col: ExcelExportColumn): boolean => {\r\n  if (col.checkboxSelection || col.headerCheckboxSelection) return true;\r\n  const field = typeof col.field === \"string\" ? col.field.trim() : \"\";\r\n  return !field || field === \"checkbox\" || field === \"checkboxSelection\";\r\n};\r\n\r\nconst collectLeaves = (\r\n  cols: ExcelExportColumn[],\r\n  groups: HeaderGroup[],\r\n  skipHidden: boolean,\r\n): LeafColumn[] => {\r\n  const leaves: LeafColumn[] = [];\r\n  cols.forEach((col) => {\r\n    if (!col || typeof col !== \"object\") return;\r\n    if (skipHidden && col.hide) return;\r\n    if (isGroup(col)) {\r\n      const group: HeaderGroup = {\r\n        name: col.headerName || \"\",\r\n        excel: col.excel,\r\n      };\r\n      leaves.push(...collectLeaves(col.children ?? [], [...groups, group], skipHidden));\r\n      return;\r\n    }\r\n    if (isSkippedLeaf(col)) return;\r\n    const field = col.field!.trim();\r\n    leaves.push({\r\n      field,\r\n      headerName: (col.headerName || field).trim() || field,\r\n      column: col,\r\n      groups,\r\n    });\r\n  });\r\n  return leaves;\r\n};\r\n\r\nconst labelFromKey = (key: string): string =>\r\n  key\r\n    .replace(/([A-Z])/g, \" $1\")\r\n    .replace(/^\\w/, (char) => char.toUpperCase())\r\n    .trim();\r\n\r\nconst columnsFromRows = (rows: unknown[]): ExcelExportColumn[] | ExportExcelFailure => {\r\n  const first = rows[0];\r\n  if (!first || typeof first !== \"object\" || Array.isArray(first)) {\r\n    return fail(\"invalid\");\r\n  }\r\n  return Object.keys(first)\r\n    .filter((key) => key !== \"checkbox\" && key !== \"checkboxSelection\" && key.trim())\r\n    .map((key) => ({ field: key, headerName: labelFromKey(key) }));\r\n};\r\n\r\nconst formatLeafValue = (\r\n  row: Record<string, unknown>,\r\n  leaf: LeafColumn,\r\n  options: ExportExcelReportOptions,\r\n): unknown => {\r\n  let value = getNestedValue(row, leaf.field);\r\n  const formatter = leaf.column.format || leaf.column.valueFormatter;\r\n  if (typeof formatter === \"function\") {\r\n    try {\r\n      return formatter({ value, data: row }) ?? \"\";\r\n    } catch {\r\n      return value ?? \"\";\r\n    }\r\n  }\r\n\r\n  const fieldLooksLikeDate = leaf.field.toLowerCase().includes(\"date\");\r\n  if (options.formatDateFields && fieldLooksLikeDate && typeof options.formatDate === \"function\") {\r\n    try {\r\n      return options.formatDate(value) ?? \"\";\r\n    } catch {\r\n      return value ?? \"\";\r\n    }\r\n  }\r\n\r\n  if (value instanceof Date) return value;\r\n  if (value != null && typeof value === \"object\") return \"\";\r\n\r\n  const numFmt = leaf.column.excel?.numFmt;\r\n  if (numFmt) {\r\n    if (typeof value === \"number\" && Number.isFinite(value)) return value;\r\n    if (typeof value === \"string\" && value.trim() !== \"\" && Number.isFinite(Number(value))) {\r\n      return Number(value);\r\n    }\r\n  }\r\n\r\n  return value ?? \"\";\r\n};\r\n\r\nconst localDateStamp = (): string => {\r\n  const date = new Date();\r\n  const year = date.getFullYear();\r\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\r\n  const day = String(date.getDate()).padStart(2, \"0\");\r\n  return `${year}-${month}-${day}`;\r\n};\r\n\r\nconst resolveDateStamp = (dateStamp: string | null | undefined): string | null => {\r\n  if (dateStamp === null) return null;\r\n  if (typeof dateStamp === \"string\" && dateStamp.trim()) return dateStamp.trim();\r\n  return localDateStamp();\r\n};\r\n\r\nconst safeSheetName = (name: string | undefined): string => {\r\n  const cleaned = (name || \"Report\").replace(/[:\\\\/?*[\\]]/g, \" \").trim() || \"Report\";\r\n  return cleaned.slice(0, 31);\r\n};\r\n\r\nconst buildHeaderGrid = (leaves: LeafColumn[]) => {\r\n  const totalHeaderRows = Math.max(...leaves.map((leaf) => leaf.groups.length + 1), 1);\r\n  const headerRows = Array.from({ length: totalHeaderRows }, () =>\r\n    Array.from({ length: leaves.length }, () => \"\"),\r\n  );\r\n  const merges: { s: { r: number; c: number }; e: { r: number; c: number } }[] = [];\r\n\r\n  for (let depth = 0; depth < totalHeaderRows - 1; depth += 1) {\r\n    let colIndex = 0;\r\n    while (colIndex < leaves.length) {\r\n      const group = leaves[colIndex].groups[depth];\r\n      if (!group) {\r\n        colIndex += 1;\r\n        continue;\r\n      }\r\n      let span = 1;\r\n      while (colIndex + span < leaves.length && leaves[colIndex + span].groups[depth] === group) {\r\n        span += 1;\r\n      }\r\n      headerRows[depth][colIndex] = group.name;\r\n      if (span > 1) {\r\n        merges.push({\r\n          s: { r: depth, c: colIndex },\r\n          e: { r: depth, c: colIndex + span - 1 },\r\n        });\r\n      }\r\n      colIndex += span;\r\n    }\r\n  }\r\n\r\n  leaves.forEach((leaf, colIndex) => {\r\n    const row = leaf.groups.length;\r\n    headerRows[row][colIndex] = leaf.headerName;\r\n    if (row < totalHeaderRows - 1) {\r\n      merges.push({\r\n        s: { r: row, c: colIndex },\r\n        e: { r: totalHeaderRows - 1, c: colIndex },\r\n      });\r\n    }\r\n  });\r\n\r\n  return { headerRows, merges, totalHeaderRows };\r\n};\r\n\r\nconst headerStyleFor = (\r\n  leaf: LeafColumn,\r\n  row: number,\r\n  theme: ExcelTheme | undefined,\r\n): ExcelCellStyle => {\r\n  const source = row < leaf.groups.length ? leaf.groups[row].excel : leaf.column.excel;\r\n  return excelHeaderStyle(theme, source);\r\n};\r\n\r\nconst columnWidth = (leaf: LeafColumn, values: unknown[]): { wch: number } => {\r\n  const headerLength = Math.max(\r\n    leaf.headerName.length,\r\n    ...leaf.groups.map((group) => group.name.length),\r\n    0,\r\n  );\r\n  const dataLength = values.reduce<number>((max, value) => {\r\n    return Math.max(max, String(value ?? \"\").length);\r\n  }, 0);\r\n  return { wch: Math.min(Math.max(headerLength, dataLength, 12), 50) };\r\n};\r\n\r\nexport type BuiltExcelWorkbook =\r\n  | { ok: true; workbook: WorkBook; fileName: string; sheetName: string }\r\n  | ExportExcelFailure;\r\n\r\n/**\r\n * Build a styled workbook. Does not write a file.\r\n * Header merges follow the column tree, so two groups with the same title stay separate.\r\n */\r\nexport const buildExcelWorkbook = (\r\n  options: ExportExcelReportOptions = {},\r\n): BuiltExcelWorkbook => {\r\n  const data = options.data;\r\n  if (!Array.isArray(data) || data.length === 0) return fail(\"empty\");\r\n\r\n  const provided = Array.isArray(options.columns) ? options.columns : [];\r\n  const columns = provided.length\r\n    ? provided\r\n    : columnsFromRows(data);\r\n  if (!Array.isArray(columns)) return columns;\r\n\r\n  const leaves = collectLeaves(columns, [], options.skipHidden === true);\r\n  if (!leaves.length) return fail(\"no-columns\");\r\n\r\n  const dateStamp = resolveDateStamp(options.dateStamp);\r\n  if (!dateStamp) return fail(\"filename\");\r\n\r\n  const { headerRows, merges, totalHeaderRows } = buildHeaderGrid(leaves);\r\n  const records = data.map((row) =>\r\n    row && typeof row === \"object\" && !Array.isArray(row)\r\n      ? (row as Record<string, unknown>)\r\n      : {},\r\n  );\r\n  const dataRows = records.map((row) =>\r\n    leaves.map((leaf) => formatLeafValue(row, leaf, options)),\r\n  );\r\n\r\n  const sheet = XLSX.utils.aoa_to_sheet([...headerRows, ...dataRows]) as WorkSheet;\r\n  const lastCell = XLSX.utils.encode_cell({\r\n    r: headerRows.length + dataRows.length - 1,\r\n    c: leaves.length - 1,\r\n  });\r\n  sheet[\"!ref\"] = `A1:${lastCell}`;\r\n  sheet[\"!merges\"] = merges;\r\n  sheet[\"!cols\"] = leaves.map((leaf, index) =>\r\n    columnWidth(\r\n      leaf,\r\n      dataRows.map((row) => row[index]),\r\n    ),\r\n  );\r\n  sheet[\"!rows\"] = Array.from({ length: totalHeaderRows }, () => ({ hpt: 22 }));\r\n\r\n  const range = XLSX.utils.decode_range(sheet[\"!ref\"] as string);\r\n  for (let row = range.s.r; row <= range.e.r; row += 1) {\r\n    for (let col = range.s.c; col <= range.e.c; col += 1) {\r\n      const address = XLSX.utils.encode_cell({ r: row, c: col });\r\n      const cell = (sheet[address] as { t?: string; v?: unknown; z?: string; s?: ExcelCellStyle } | undefined) ?? {\r\n        t: \"s\",\r\n        v: \"\",\r\n      };\r\n      const leaf = leaves[col];\r\n      if (row < totalHeaderRows) {\r\n        cell.s = headerStyleFor(leaf, row, options.theme);\r\n      } else {\r\n        const style = excelDataStyle(options.theme, leaf.column.excel);\r\n        if (leaf.column.excel?.numFmt) cell.z = leaf.column.excel.numFmt;\r\n        cell.s = style;\r\n      }\r\n      sheet[address] = cell;\r\n    }\r\n  }\r\n\r\n  const sheetName = safeSheetName(options.sheetName);\r\n  const workbook = XLSX.utils.book_new() as WorkBook;\r\n  XLSX.utils.book_append_sheet(workbook, sheet, sheetName);\r\n\r\n  const baseName = options.fileName == null ? \"\" : String(options.fileName);\r\n  return {\r\n    ok: true,\r\n    workbook,\r\n    sheetName,\r\n    fileName: `${baseName ? `${baseName}_` : \"\"}${dateStamp}.xlsx`,\r\n  };\r\n};\r\n\r\n/** Write a styled .xlsx. Returns a result; it does not toast. */\r\nexport const exportExcelReport = (\r\n  options: ExportExcelReportOptions = {},\r\n): ExportExcelReportResult => {\r\n  const built = buildExcelWorkbook(options);\r\n  if (!built.ok) return built;\r\n  try {\r\n    XLSX.writeFile(built.workbook, built.fileName, { cellStyles: true });\r\n  } catch (error) {\r\n    const message = error instanceof Error ? error.message : \"Unknown error\";\r\n    return { ok: false, code: \"write\", error: message };\r\n  }\r\n  return { ok: true, fileName: built.fileName };\r\n};\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eztrak/shared",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "homepage": "https://github.com/mehrancentangle/eztrak-packages",
   "description": "Shared hooks, utils, and UI for Eztrak federation apps",
   "main": "./dist/index.js",
@@ -34,18 +34,25 @@
       "require": "./dist/components/index.js"
     },
     "./components/tabs.css": "./dist/components/tabs/styles.css",
-    "./components/loader.css": "./dist/components/Loader/Loader.css"
+    "./components/loader.css": "./dist/components/Loader/Loader.css",
+    "./excel": {
+      "types": "./dist/excel/index.d.ts",
+      "import": "./dist/excel/index.mjs",
+      "require": "./dist/excel/index.js"
+    }
   },
   "scripts": {
     "build": "tsup && node -e \"const fs=require('fs');const tabs='dist/components/tabs';fs.mkdirSync(tabs,{recursive:true});fs.copyFileSync('src/components/tabs/styles.css',tabs+'/styles.css');const loader='dist/components/Loader';fs.mkdirSync(loader,{recursive:true});fs.copyFileSync('src/components/Loader/Loader.css',loader+'/Loader.css')\"",
     "prepublishOnly": "npm run build",
     "test:format-date": "npm run build && node scripts/check-format-date.mjs",
+    "test:excel": "npm run build && node scripts/check-excel-export.mjs",
     "storybook": "storybook dev -p 6006",
     "build:storybook": "storybook build"
   },
   "dependencies": {
     "clsx": "^2.1.1",
-    "tailwind-merge": "^3.0.1"
+    "tailwind-merge": "^3.0.1",
+    "xlsx-js-style": "^1.2.0"
   },
   "peerDependencies": {
     "@reduxjs/toolkit": "^2.0.0",