@eztrak/shared 0.17.1 → 0.19.0

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/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { CreateBaseQueryWithRetryOptions, PermissionRecord, TransformedPermissions, USER_STATE_STORAGE_KEY, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, createBaseQueryWithRetry, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatNumber, get, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, getItem, getItemFromLocalStorage, isEmpty, loadUserState, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, removeItem, resetPageParam, saveItemLocalStorage, saveUserState, set, setItem, storeItemInLocalStorage, toDateInputValue, toLowerCaseText, transformPermissions, truncateFileName, truncateText } from './utils/index.mjs';
+export { CreateBaseQueryWithRetryOptions, CurrencyFormatterOptions, DateUtcMode, FormatDateOptions, PermissionRecord, TransformedPermissions, USER_STATE_STORAGE_KEY, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, createBaseQueryWithRetry, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatNumber, get, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, getItem, getItemFromLocalStorage, isEmpty, loadUserState, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, removeItem, resetPageParam, saveItemLocalStorage, saveUserState, set, setItem, storeItemInLocalStorage, toDateInputValue, toLowerCaseText, transformPermissions, truncateFileName, truncateText } from './utils/index.mjs';
 export { C as ConfirmationAlertOptions, a as ConfirmationAlertVariant, D as DEFAULT_CONFIRM_ICONS, E as ErrorClassification, b as ErrorSuggestedAction, H as HandleApiErrorOptions, R as RtkQueryError, c as classifyError, d as confirmationAlert, f as formatValidationErrorsHtml, h as handleApiError, i as isRetryableError } from './handleApiError-BIAaN76q.mjs';
 export { UseGridHeightOptions, useGridHeight, usePaginationUrlSync } from './hooks/index.mjs';
 export { ActionMenuItem, ActionMenuItemProps, BreadcrumbRoute, Breadcrumbs, BreadcrumbsProps, Button, ButtonProps, Card, CardProps, CardSkeleton, CardSkeletonProps, CardSkeletonVariant, CellEditPayload, CellEditorInputType, CustomCellEditor, CustomCellEditorProps, CustomCellEditorRef, CustomPagination, CustomPaginationClassNames, CustomPaginationProps, DropdownFilter, DropdownFilterProps, DropdownOption, EztrakTab, EztrakTabs, EztrakTabsClassNames, EztrakTabsProps, Header, HeaderProps, LayoutStatus, Loader, LoaderProps, Modal, ModalProps, PaginationData, PopupActionHandler, PopupCellRenderer, PopupCellRendererParams, PopupCellRendererProps, PopupDropDownContent, ROW_ACTION_DEFAULT_ICON_SIZE, ROW_ACTION_DEFAULT_MENU_TOOLTIP_STYLE, ROW_ACTION_ITEM_HOVER_CLASS, ROW_ACTION_ITEM_TEXT_CLASS, ROW_ACTION_PRESETS, ResetColumnsButton, ResetColumnsButtonProps, ResetFiltersButton, ResetFiltersButtonProps, ResetFiltersButtonVariant, ResolvedRowAction, RowAction, RowActionConfirmFn, RowActionFlag, RowActionItemRenderContext, RowActionItemType, RowActionPreset, RowActionPresetName, RowActions, RowActionsList, RowActionsMode, RowActionsProps, RowActionsRenderContext, SearchInput, SearchInputProps, Sidebar, SidebarItem, SidebarProps, TableErrorBoundary, TableErrorBoundaryProps, TableLayoutToolbarControls, TableLayoutToolbarControlsProps, ToolTip, ToolTipProps, TooltipText, TooltipTextProps, dropdownStyles, resolveActions } from './components/index.mjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { CreateBaseQueryWithRetryOptions, PermissionRecord, TransformedPermissions, USER_STATE_STORAGE_KEY, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, createBaseQueryWithRetry, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatNumber, get, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, getItem, getItemFromLocalStorage, isEmpty, loadUserState, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, removeItem, resetPageParam, saveItemLocalStorage, saveUserState, set, setItem, storeItemInLocalStorage, toDateInputValue, toLowerCaseText, transformPermissions, truncateFileName, truncateText } from './utils/index.js';
+export { CreateBaseQueryWithRetryOptions, CurrencyFormatterOptions, DateUtcMode, FormatDateOptions, PermissionRecord, TransformedPermissions, USER_STATE_STORAGE_KEY, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, createBaseQueryWithRetry, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatNumber, get, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, getItem, getItemFromLocalStorage, isEmpty, loadUserState, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, removeItem, resetPageParam, saveItemLocalStorage, saveUserState, set, setItem, storeItemInLocalStorage, toDateInputValue, toLowerCaseText, transformPermissions, truncateFileName, truncateText } from './utils/index.js';
 export { C as ConfirmationAlertOptions, a as ConfirmationAlertVariant, D as DEFAULT_CONFIRM_ICONS, E as ErrorClassification, b as ErrorSuggestedAction, H as HandleApiErrorOptions, R as RtkQueryError, c as classifyError, d as confirmationAlert, f as formatValidationErrorsHtml, h as handleApiError, i as isRetryableError } from './handleApiError-BIAaN76q.js';
 export { UseGridHeightOptions, useGridHeight, usePaginationUrlSync } from './hooks/index.js';
 export { ActionMenuItem, ActionMenuItemProps, BreadcrumbRoute, Breadcrumbs, BreadcrumbsProps, Button, ButtonProps, Card, CardProps, CardSkeleton, CardSkeletonProps, CardSkeletonVariant, CellEditPayload, CellEditorInputType, CustomCellEditor, CustomCellEditorProps, CustomCellEditorRef, CustomPagination, CustomPaginationClassNames, CustomPaginationProps, DropdownFilter, DropdownFilterProps, DropdownOption, EztrakTab, EztrakTabs, EztrakTabsClassNames, EztrakTabsProps, Header, HeaderProps, LayoutStatus, Loader, LoaderProps, Modal, ModalProps, PaginationData, PopupActionHandler, PopupCellRenderer, PopupCellRendererParams, PopupCellRendererProps, PopupDropDownContent, ROW_ACTION_DEFAULT_ICON_SIZE, ROW_ACTION_DEFAULT_MENU_TOOLTIP_STYLE, ROW_ACTION_ITEM_HOVER_CLASS, ROW_ACTION_ITEM_TEXT_CLASS, ROW_ACTION_PRESETS, ResetColumnsButton, ResetColumnsButtonProps, ResetFiltersButton, ResetFiltersButtonProps, ResetFiltersButtonVariant, ResolvedRowAction, RowAction, RowActionConfirmFn, RowActionFlag, RowActionItemRenderContext, RowActionItemType, RowActionPreset, RowActionPresetName, RowActions, RowActionsList, RowActionsMode, RowActionsProps, RowActionsRenderContext, SearchInput, SearchInputProps, Sidebar, SidebarItem, SidebarProps, TableErrorBoundary, TableErrorBoundaryProps, TableLayoutToolbarControls, TableLayoutToolbarControlsProps, ToolTip, ToolTipProps, TooltipText, TooltipTextProps, dropdownStyles, resolveActions } from './components/index.js';

package/dist/index.js

@@ -122,6 +122,118 @@ function resetPageParam(params, pageKey = "page", defaultPage = "1") {
   return params;
 }
 
+// src/utils/format-date.ts
+var DEFAULT_DATE_FALLBACK = "-";
+var DEFAULT_DATETIME_FALLBACK = "Invalid Date";
+var pad2 = (n) => n.toString().padStart(2, "0");
+var getParts = (date, utc) => {
+  if (utc === "preserve") {
+    return {
+      year: date.getUTCFullYear(),
+      month: date.getUTCMonth() + 1,
+      day: date.getUTCDate(),
+      hours: date.getUTCHours(),
+      minutes: date.getUTCMinutes(),
+      seconds: date.getUTCSeconds()
+    };
+  }
+  return {
+    year: date.getFullYear(),
+    month: date.getMonth() + 1,
+    day: date.getDate(),
+    hours: date.getHours(),
+    minutes: date.getMinutes(),
+    seconds: date.getSeconds()
+  };
+};
+var formatAmPmTime = (parts) => {
+  const hour12 = parts.hours % 12 || 12;
+  const ampm = parts.hours >= 12 ? "PM" : "AM";
+  return `${hour12}:${pad2(parts.minutes)} ${ampm}`;
+};
+var formatMmDdYy = (parts) => `${pad2(parts.month)}/${pad2(parts.day)}/${String(parts.year).slice(-2)}`;
+var applyPattern = (pattern, parts) => {
+  const hour12 = parts.hours % 12 || 12;
+  const ampm = parts.hours >= 12 ? "PM" : "AM";
+  const replacements = [
+    ["yyyy", String(parts.year)],
+    ["yy", String(parts.year).slice(-2)],
+    ["MM", pad2(parts.month)],
+    ["dd", pad2(parts.day)],
+    ["HH", pad2(parts.hours)],
+    ["hh", pad2(hour12)],
+    ["mm", pad2(parts.minutes)],
+    ["ss", pad2(parts.seconds)],
+    ["a", ampm]
+  ];
+  let result = "";
+  let i = 0;
+  while (i < pattern.length) {
+    let matched = false;
+    for (const [token, value] of replacements) {
+      if (pattern.startsWith(token, i)) {
+        result += value;
+        i += token.length;
+        matched = true;
+        break;
+      }
+    }
+    if (!matched) {
+      result += pattern[i];
+      i += 1;
+    }
+  }
+  return result;
+};
+var parseDate = (dateString) => {
+  if (dateString === null || dateString === void 0) return null;
+  const date = new Date(dateString);
+  if (isNaN(date.getTime())) return null;
+  return date;
+};
+var formatDate = (dateString, options = {}) => {
+  const {
+    pattern,
+    utc = "local",
+    includeTime = false,
+    fallback = DEFAULT_DATE_FALLBACK
+  } = options;
+  const date = parseDate(dateString);
+  if (!date) return fallback;
+  const parts = getParts(date, utc);
+  if (pattern) {
+    return applyPattern(pattern, parts);
+  }
+  const datePart = formatMmDdYy(parts);
+  if (!includeTime) return datePart;
+  return `${datePart}, ${formatAmPmTime(parts)}`;
+};
+var formatDateTime = (dateString, options = {}) => {
+  const {
+    pattern,
+    utc = "local",
+    includeTime = true,
+    fallback = DEFAULT_DATETIME_FALLBACK
+  } = options;
+  const date = parseDate(dateString);
+  if (!date) return fallback;
+  if (pattern) {
+    return applyPattern(pattern, getParts(date, utc));
+  }
+  const localeOptions = {
+    year: "numeric",
+    month: "numeric",
+    day: "numeric",
+    ...includeTime ? {
+      hour: "numeric",
+      minute: "numeric",
+      hour12: true
+    } : {},
+    ...utc === "preserve" ? { timeZone: "UTC" } : {}
+  };
+  return date.toLocaleString("en-US", localeOptions);
+};
+
 // src/utils/helpers.ts
 var truncateText = (text, maxLength = 20) => {
   if (text === null || text === void 0) return "";
@@ -196,17 +308,6 @@ function toLowerCaseText(text) {
   if (!text) return "";
   return text.toLowerCase();
 }
-var formatDate = (dateString) => {
-  if (dateString === null || dateString === void 0) return "-";
-  const date = new Date(dateString);
-  if (isNaN(date.getTime())) {
-    return dateString;
-  }
-  const month = (date.getMonth() + 1).toString().padStart(2, "0");
-  const day = date.getDate().toString().padStart(2, "0");
-  const year = date.getFullYear().toString().slice(-2);
-  return `${month}/${day}/${year}`;
-};
 var isEmpty = (obj) => {
   return Object.keys(obj).length === 0;
 };
@@ -237,11 +338,30 @@ function convertCommaDataToArray(data) {
 function checkIfExistsInArray(array, searchValue) {
   return array.includes(searchValue);
 }
-var currencyFormatter = (value) => {
-  return value?.toLocaleString("en-US", {
+var currencyFormatter = (value, options) => {
+  if (value == null) return "";
+  const {
+    currency = "USD",
+    locale = "en-US",
+    hideSymbol = false,
+    minimumFractionDigits,
+    maximumFractionDigits
+  } = options ?? {};
+  const fractionDigits = {
+    ...minimumFractionDigits != null && { minimumFractionDigits },
+    ...maximumFractionDigits != null && { maximumFractionDigits }
+  };
+  if (hideSymbol) {
+    return value.toLocaleString(locale, {
+      minimumFractionDigits: minimumFractionDigits ?? 2,
+      maximumFractionDigits: maximumFractionDigits ?? 2
+    });
+  }
+  return value.toLocaleString(locale, {
     style: "currency",
-    currency: "USD"
-  }) ?? "";
+    currency,
+    ...fractionDigits
+  });
 };
 var formatNumber = (number) => {
   if (isNaN(Number(number)) || number === null || number === void 0) {
@@ -295,20 +415,6 @@ var deserializeJson = (jsonString) => {
     return null;
   }
 };
-var formatDateTime = (dateString) => {
-  if (!dateString) return "Invalid Date";
-  const date = new Date(dateString);
-  if (isNaN(date.getTime())) return "Invalid Date";
-  const options = {
-    year: "numeric",
-    month: "numeric",
-    day: "numeric",
-    hour: "numeric",
-    minute: "numeric",
-    hour12: true
-  };
-  return date.toLocaleString("en-US", options);
-};
 var removeByPropertyValues = (items = [], property, values = [], { caseInsensitive = false } = {}) => {
   if (!Array.isArray(items) || !property) return Array.isArray(items) ? items : [];
   const normalize = (v) => caseInsensitive && typeof v === "string" ? v.toLowerCase() : v;