@harbortouch/skytab-analytics-report-utils 0.7.0 → 0.7.1

package/dist/formatting.d.ts

@@ -1,5 +1,6 @@
+import type { FieldType } from './types';
 export type TimeFormat = '00:00' | '00:00:00' | '00:00-24H';
-export interface LocaleOptions {
+export interface LocaleOption {
     currency: string;
     locale: string;
 }
@@ -27,8 +28,10 @@ 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 getReportFormattingLocaleOptions: (locations: {
     currency: string;
     countryCode: string;
     language: string;
-}[]) => LocaleOptions[];
+}[]) => LocaleOption[];
+export declare const formatFieldValue: (value: unknown, type: FieldType, localeOptions: LocaleOption) => string;

package/dist/index.cjs

@@ -60,9 +60,11 @@ __export(index_exports, {
   dailySalesTrendsConfig: () => dailySalesTrendsConfig,
   employeeTimecardConfig: () => employeeTimecardConfig,
   formatDate: () => formatDate,
+  formatFieldValue: () => formatFieldValue,
   formatFixedNumber: () => formatFixedNumber,
   formatInteger: () => formatInteger,
   formatMoney: () => formatMoney,
+  formatMoneyWithoutSymbol: () => formatMoneyWithoutSymbol,
   formatPercent: () => formatPercent,
   formatString: () => formatString,
   formatTime: () => formatTime,
@@ -1659,6 +1661,13 @@ var getDateToFormat = (value) => {
   }
   return null;
 };
+var formatMoneyWithoutSymbol = (amount, options = {}) => {
+  const { locale = "en-US", decimals = 2 } = options;
+  return new Intl.NumberFormat(locale, {
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals
+  }).format(amount);
+};
 var getReportFormattingLocaleOptions = (locations) => {
   if (locations.length === 0) {
     return [{ currency: "USD", locale: "en-US" }];
@@ -1672,6 +1681,30 @@ var getReportFormattingLocaleOptions = (locations) => {
     ).values()
   );
 };
+var formatFieldValue = (value, type, localeOptions) => {
+  const { currency, locale } = localeOptions;
+  switch (type) {
+    case "string":
+      return formatString(value);
+    case "money":
+      return formatMoney(getNumberToFormat(value), { currency, locale });
+    case "percent":
+      return formatPercent(getNumberToFormat(value) * 100);
+    case "fixedNumber":
+      return formatFixedNumber(getNumberToFormat(value));
+    case "date": {
+      const d = getDateToFormat(value);
+      return d ? formatDate(d, { locale }) : "";
+    }
+    case "time": {
+      const d = getDateToFormat(value);
+      return d ? formatTime(d, { locale, format: "00:00:00" }) : "";
+    }
+    case "number":
+    default:
+      return String(getNumberToFormat(value));
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COLUMN_REGISTRY,
@@ -1714,9 +1747,11 @@ var getReportFormattingLocaleOptions = (locations) => {
   dailySalesTrendsConfig,
   employeeTimecardConfig,
   formatDate,
+  formatFieldValue,
   formatFixedNumber,
   formatInteger,
   formatMoney,
+  formatMoneyWithoutSymbol,
   formatPercent,
   formatString,
   formatTime,

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, LocaleOptions } from './formatting';
-export { formatDate, formatTime, formatMoney, formatPercent, formatInteger, formatFixedNumber, formatString, getNumberToFormat, getDateToFormat, getReportFormattingLocaleOptions, } from './formatting';
+export type { 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

@@ -1573,6 +1573,13 @@ var getDateToFormat = (value) => {
   }
   return null;
 };
+var formatMoneyWithoutSymbol = (amount, options = {}) => {
+  const { locale = "en-US", decimals = 2 } = options;
+  return new Intl.NumberFormat(locale, {
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals
+  }).format(amount);
+};
 var getReportFormattingLocaleOptions = (locations) => {
   if (locations.length === 0) {
     return [{ currency: "USD", locale: "en-US" }];
@@ -1586,6 +1593,30 @@ var getReportFormattingLocaleOptions = (locations) => {
     ).values()
   );
 };
+var formatFieldValue = (value, type, localeOptions) => {
+  const { currency, locale } = localeOptions;
+  switch (type) {
+    case "string":
+      return formatString(value);
+    case "money":
+      return formatMoney(getNumberToFormat(value), { currency, locale });
+    case "percent":
+      return formatPercent(getNumberToFormat(value) * 100);
+    case "fixedNumber":
+      return formatFixedNumber(getNumberToFormat(value));
+    case "date": {
+      const d = getDateToFormat(value);
+      return d ? formatDate(d, { locale }) : "";
+    }
+    case "time": {
+      const d = getDateToFormat(value);
+      return d ? formatTime(d, { locale, format: "00:00:00" }) : "";
+    }
+    case "number":
+    default:
+      return String(getNumberToFormat(value));
+  }
+};
 export {
   COLUMN_REGISTRY,
   DAILY_SALES_AVAILABLE_COLUMNS,
@@ -1627,9 +1658,11 @@ export {
   dailySalesTrendsConfig,
   employeeTimecardConfig,
   formatDate,
+  formatFieldValue,
   formatFixedNumber,
   formatInteger,
   formatMoney,
+  formatMoneyWithoutSymbol,
   formatPercent,
   formatString,
   formatTime,

package/package.json

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