@harbortouch/skytab-analytics-report-utils 0.7.2 → 0.8.0

package/dist/formatting.d.ts

@@ -19,6 +19,10 @@ export interface FormatMoneyOptions {
     currency?: string;
     decimals?: number;
 }
+export interface FormatNumberOptions {
+    locale?: string;
+    decimals?: number;
+}
 export declare const formatDate: (date: Date, options?: FormatDateOptions) => string;
 export declare const formatTime: (date: Date | string | number, options: FormatTimeOptions) => string;
 export declare const formatMoney: (amount: number, options?: FormatMoneyOptions) => string;
@@ -28,7 +32,7 @@ export declare const formatFixedNumber: (value: number, decimals?: number) => st
 export declare const formatString: (value: unknown) => string;
 export declare const getNumberToFormat: (value: unknown) => number;
 export declare const getDateToFormat: (value?: unknown) => Date | null;
-export declare const formatMoneyWithoutSymbol: (amount: number, options?: FormatMoneyOptions) => string;
+export declare const formatMoneyWithoutSymbol: (amount: number, options?: FormatNumberOptions) => string;
 export declare const getReportFormattingLocaleOptions: (locations: {
     currency: string;
     countryCode: string;

package/dist/index.cjs

@@ -1525,8 +1525,12 @@ function calculateReportTotals(data, fieldConfig, opts) {
       }
     } else {
       derivedFields.push({ field, calc });
-      if (calc.numeratorField) fieldsToSum.add(calc.numeratorField);
-      if (calc.denominatorField) fieldsToSum.add(calc.denominatorField);
+      if (calc.numeratorField) {
+        fieldsToSum.add(calc.numeratorField);
+      }
+      if (calc.denominatorField) {
+        fieldsToSum.add(calc.denominatorField);
+      }
     }
   }
   const sums = {};
@@ -1605,48 +1609,75 @@ var dailySalesTaxesConfig = {
 };
 
 // src/formatting.ts
+var dateFormatterCache = /* @__PURE__ */ new Map();
+var timeFormatterCache = /* @__PURE__ */ new Map();
+var moneyFormatterCache = /* @__PURE__ */ new Map();
+var numberFormatterCache = /* @__PURE__ */ new Map();
+var getDateFormatter = (locale, timeZone) => {
+  const key = `${locale}-${timeZone}`;
+  let fmt = dateFormatterCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.DateTimeFormat(locale, { dateStyle: "short", timeZone });
+    dateFormatterCache.set(key, fmt);
+  }
+  return fmt;
+};
+var getTimeFormatter = (locale, timeZone, format) => {
+  const key = `${locale}-${timeZone}-${format}`;
+  let fmt = timeFormatterCache.get(key);
+  if (!fmt) {
+    if (format === "00:00") {
+      fmt = new Intl.DateTimeFormat(locale, { hour: "2-digit", minute: "2-digit", timeZone });
+    } else if (format === "00:00-24H") {
+      fmt = new Intl.DateTimeFormat(locale, {
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+        hourCycle: "h23",
+        timeZone
+      });
+    } else {
+      fmt = new Intl.DateTimeFormat(locale, { hour: "2-digit", minute: "2-digit", second: "2-digit", timeZone });
+    }
+    timeFormatterCache.set(key, fmt);
+  }
+  return fmt;
+};
+var getMoneyFormatter = (locale, currency, decimals) => {
+  const key = `${locale}-${currency}-${decimals}`;
+  let fmt = moneyFormatterCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency,
+      minimumFractionDigits: decimals,
+      maximumFractionDigits: decimals
+    });
+    moneyFormatterCache.set(key, fmt);
+  }
+  return fmt;
+};
+var getNumberFormatter = (locale, decimals) => {
+  const key = `${locale}-${decimals}`;
+  let fmt = numberFormatterCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.NumberFormat(locale, { minimumFractionDigits: decimals, maximumFractionDigits: decimals });
+    numberFormatterCache.set(key, fmt);
+  }
+  return fmt;
+};
 var formatDate = (date, options = {}) => {
   const { locale = "en-US", timeZone = "UTC" } = options;
-  const d = new Date(date);
-  return new Intl.DateTimeFormat(locale, {
-    dateStyle: "short",
-    timeZone
-  }).format(d);
+  return getDateFormatter(locale, timeZone).format(date);
 };
 var formatTime = (date, options) => {
   const { locale = "en-US", timeZone = "UTC", format } = options;
   const d = new Date(date);
-  if (format === "00:00") {
-    return new Intl.DateTimeFormat(locale, {
-      hour: "2-digit",
-      minute: "2-digit",
-      timeZone
-    }).format(d);
-  }
-  if (format === "00:00-24H") {
-    return new Intl.DateTimeFormat(locale, {
-      hour: "2-digit",
-      minute: "2-digit",
-      hour12: false,
-      hourCycle: "h23",
-      timeZone
-    }).format(d);
-  }
-  return new Intl.DateTimeFormat(locale, {
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-    timeZone
-  }).format(d);
+  return getTimeFormatter(locale, timeZone, format).format(d);
 };
 var formatMoney = (amount, options = {}) => {
   const { locale = "en-US", currency = "USD", decimals = 2 } = options;
-  return new Intl.NumberFormat(locale, {
-    style: "currency",
-    currency,
-    minimumFractionDigits: decimals,
-    maximumFractionDigits: decimals
-  }).format(amount);
+  return getMoneyFormatter(locale, currency, decimals).format(amount);
 };
 var formatPercent = (value, decimals = 2) => `${value.toFixed(decimals)}%`;
 var formatInteger = (value) => Math.round(value).toString();
@@ -1667,10 +1698,7 @@ var getDateToFormat = (value) => {
 };
 var formatMoneyWithoutSymbol = (amount, options = {}) => {
   const { locale = "en-US", decimals = 2 } = options;
-  return new Intl.NumberFormat(locale, {
-    minimumFractionDigits: decimals,
-    maximumFractionDigits: decimals
-  }).format(amount);
+  return getNumberFormatter(locale, decimals).format(amount);
 };
 var getReportFormattingLocaleOptions = (locations) => {
   if (locations.length === 0) {

package/dist/index.d.ts

@@ -17,5 +17,5 @@ export { dailySalesRefundsVoidsConfig, DAILY_SALES_REFUNDS_VOIDS_AVAILABLE_COLUM
 export { dailySalesTaxesConfig, DAILY_SALES_TAXES_AVAILABLE_COLUMNS, DAILY_SALES_TAXES_DEFAULT_VISIBLE_COLUMNS, } from './reports/dailySalesTaxes';
 export { employeeTimecardConfig, EMPLOYEE_TIMECARD_AVAILABLE_COLUMNS, EMPLOYEE_TIMECARD_DEFAULT_VISIBLE_COLUMNS, } from './reports/employeeTimecard';
 export { salesByItemDetailConfig, SALES_BY_ITEM_DETAIL_AVAILABLE_COLUMNS, SALES_BY_ITEM_DETAIL_DEFAULT_VISIBLE_COLUMNS, } from './reports/salesByItemDetail';
-export type { FormatDateOptions, FormatTimeOptions, FormatMoneyOptions, LocaleOption, TimeFormat } from './formatting';
+export type { FormatNumberOptions, FormatDateOptions, FormatTimeOptions, FormatMoneyOptions, LocaleOption, TimeFormat, } from './formatting';
 export { formatDate, formatTime, formatMoney, formatPercent, formatInteger, formatFixedNumber, formatString, getNumberToFormat, getDateToFormat, getReportFormattingLocaleOptions, formatMoneyWithoutSymbol, formatFieldValue, } from './formatting';

package/dist/index.js

@@ -1437,8 +1437,12 @@ function calculateReportTotals(data, fieldConfig, opts) {
       }
     } else {
       derivedFields.push({ field, calc });
-      if (calc.numeratorField) fieldsToSum.add(calc.numeratorField);
-      if (calc.denominatorField) fieldsToSum.add(calc.denominatorField);
+      if (calc.numeratorField) {
+        fieldsToSum.add(calc.numeratorField);
+      }
+      if (calc.denominatorField) {
+        fieldsToSum.add(calc.denominatorField);
+      }
     }
   }
   const sums = {};
@@ -1517,48 +1521,75 @@ var dailySalesTaxesConfig = {
 };
 
 // src/formatting.ts
+var dateFormatterCache = /* @__PURE__ */ new Map();
+var timeFormatterCache = /* @__PURE__ */ new Map();
+var moneyFormatterCache = /* @__PURE__ */ new Map();
+var numberFormatterCache = /* @__PURE__ */ new Map();
+var getDateFormatter = (locale, timeZone) => {
+  const key = `${locale}-${timeZone}`;
+  let fmt = dateFormatterCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.DateTimeFormat(locale, { dateStyle: "short", timeZone });
+    dateFormatterCache.set(key, fmt);
+  }
+  return fmt;
+};
+var getTimeFormatter = (locale, timeZone, format) => {
+  const key = `${locale}-${timeZone}-${format}`;
+  let fmt = timeFormatterCache.get(key);
+  if (!fmt) {
+    if (format === "00:00") {
+      fmt = new Intl.DateTimeFormat(locale, { hour: "2-digit", minute: "2-digit", timeZone });
+    } else if (format === "00:00-24H") {
+      fmt = new Intl.DateTimeFormat(locale, {
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+        hourCycle: "h23",
+        timeZone
+      });
+    } else {
+      fmt = new Intl.DateTimeFormat(locale, { hour: "2-digit", minute: "2-digit", second: "2-digit", timeZone });
+    }
+    timeFormatterCache.set(key, fmt);
+  }
+  return fmt;
+};
+var getMoneyFormatter = (locale, currency, decimals) => {
+  const key = `${locale}-${currency}-${decimals}`;
+  let fmt = moneyFormatterCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency,
+      minimumFractionDigits: decimals,
+      maximumFractionDigits: decimals
+    });
+    moneyFormatterCache.set(key, fmt);
+  }
+  return fmt;
+};
+var getNumberFormatter = (locale, decimals) => {
+  const key = `${locale}-${decimals}`;
+  let fmt = numberFormatterCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.NumberFormat(locale, { minimumFractionDigits: decimals, maximumFractionDigits: decimals });
+    numberFormatterCache.set(key, fmt);
+  }
+  return fmt;
+};
 var formatDate = (date, options = {}) => {
   const { locale = "en-US", timeZone = "UTC" } = options;
-  const d = new Date(date);
-  return new Intl.DateTimeFormat(locale, {
-    dateStyle: "short",
-    timeZone
-  }).format(d);
+  return getDateFormatter(locale, timeZone).format(date);
 };
 var formatTime = (date, options) => {
   const { locale = "en-US", timeZone = "UTC", format } = options;
   const d = new Date(date);
-  if (format === "00:00") {
-    return new Intl.DateTimeFormat(locale, {
-      hour: "2-digit",
-      minute: "2-digit",
-      timeZone
-    }).format(d);
-  }
-  if (format === "00:00-24H") {
-    return new Intl.DateTimeFormat(locale, {
-      hour: "2-digit",
-      minute: "2-digit",
-      hour12: false,
-      hourCycle: "h23",
-      timeZone
-    }).format(d);
-  }
-  return new Intl.DateTimeFormat(locale, {
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-    timeZone
-  }).format(d);
+  return getTimeFormatter(locale, timeZone, format).format(d);
 };
 var formatMoney = (amount, options = {}) => {
   const { locale = "en-US", currency = "USD", decimals = 2 } = options;
-  return new Intl.NumberFormat(locale, {
-    style: "currency",
-    currency,
-    minimumFractionDigits: decimals,
-    maximumFractionDigits: decimals
-  }).format(amount);
+  return getMoneyFormatter(locale, currency, decimals).format(amount);
 };
 var formatPercent = (value, decimals = 2) => `${value.toFixed(decimals)}%`;
 var formatInteger = (value) => Math.round(value).toString();
@@ -1579,10 +1610,7 @@ var getDateToFormat = (value) => {
 };
 var formatMoneyWithoutSymbol = (amount, options = {}) => {
   const { locale = "en-US", decimals = 2 } = options;
-  return new Intl.NumberFormat(locale, {
-    minimumFractionDigits: decimals,
-    maximumFractionDigits: decimals
-  }).format(amount);
+  return getNumberFormatter(locale, decimals).format(amount);
 };
 var getReportFormattingLocaleOptions = (locations) => {
   if (locations.length === 0) {

package/dist/reports/employeeTimecard.d.ts

@@ -1,4 +1,6 @@
 import { type ReportConfig } from '../types';
-export declare const EMPLOYEE_TIMECARD_AVAILABLE_COLUMNS: string[];
-export declare const EMPLOYEE_TIMECARD_DEFAULT_VISIBLE_COLUMNS: string[];
-export declare const employeeTimecardConfig: ReportConfig;
+type EmployeeTimecardField = 'locationId' | 'locationName' | 'businessDate' | 'employeeName' | 'isActive' | 'lookup' | 'payrollCode' | 'jobName' | 'isBreak' | 'startTime' | 'endTime' | 'shiftHours';
+export declare const EMPLOYEE_TIMECARD_AVAILABLE_COLUMNS: EmployeeTimecardField[];
+export declare const EMPLOYEE_TIMECARD_DEFAULT_VISIBLE_COLUMNS: EmployeeTimecardField[];
+export declare const employeeTimecardConfig: ReportConfig<EmployeeTimecardField>;
+export {};

package/dist/types.d.ts

@@ -2,18 +2,18 @@ import { type ReportColumnKey } from './columns';
 export type FieldType = 'string' | 'money' | 'percent' | 'number' | 'fixedNumber' | 'date' | 'time' | 'boolean';
 export type ColumnAlignment = 'left' | 'right';
 export type FooterCalculationType = 'sum' | 'percentChange' | 'average' | 'none';
-export interface FooterCalculation {
+export interface FooterCalculation<TField = string> {
     type: FooterCalculationType;
-    numeratorField?: string;
-    denominatorField?: string;
+    numeratorField?: TField;
+    denominatorField?: TField;
 }
-export interface ColumnPresentationConfig {
+export interface ColumnPresentationConfig<TField = string> {
     columnKey?: ReportColumnKey;
-    type?: FieldType;
+    type: FieldType;
     size?: number;
     enableSorting?: boolean;
     filteringAvailable?: boolean;
-    footerCalculation?: FooterCalculation;
+    footerCalculation?: FooterCalculation<TField>;
 }
 export interface ColumnGroupConfig {
     id: string;
@@ -23,7 +23,7 @@ export interface ColumnGroupConfig {
     lastYearFields?: string[];
 }
 export interface ReportConfig<TField extends string = string> {
-    fields: Record<TField, ColumnPresentationConfig>;
+    fields: Record<TField, ColumnPresentationConfig<TField>>;
     availableColumns: TField[];
     defaultVisibleColumns: TField[];
     columnGroups?: ColumnGroupConfig[];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@harbortouch/skytab-analytics-report-utils",
-	"version": "0.7.2",
+	"version": "0.8.0",
 	"description": "Centralized report column presentation configuration for SkyTab Analytics",
 	"engines": {
 		"node": ">=22.6.0",