@harbortouch/skytab-analytics-report-utils 0.24.0 → 0.26.0

package/dist/{chunk-SZ4VPNAX.js → chunk-SUWIUPHT.js}

@@ -180,6 +180,7 @@ var salesSummaryConfig = {
   fields: FIELDS2,
   availableColumns: SALES_SUMMARY_AVAILABLE_COLUMNS,
   defaultVisibleColumns: SALES_SUMMARY_DEFAULT_VISIBLE_COLUMNS,
+  chartFields: SALES_SUMMARY_DEFAULT_VISIBLE_COLUMNS,
   columnGroups: COLUMN_GROUPS,
   hasFooter: true
 };
@@ -473,6 +474,7 @@ var MODIFIER_MIX_AVAILABLE_COLUMNS = [
 ];
 var modifierMixConfig = {
   fields: FIELDS6,
+  chartFields: MODIFIER_MIX_VISIBLE_COLUMNS,
   availableColumns: MODIFIER_MIX_AVAILABLE_COLUMNS,
   defaultVisibleColumns: MODIFIER_MIX_VISIBLE_COLUMNS,
   hasFooter: true

package/dist/exporters/exportBuilder.cjs

@@ -1814,6 +1814,7 @@ var salesSummaryConfig = {
   fields: FIELDS2,
   availableColumns: SALES_SUMMARY_AVAILABLE_COLUMNS,
   defaultVisibleColumns: SALES_SUMMARY_DEFAULT_VISIBLE_COLUMNS,
+  chartFields: SALES_SUMMARY_DEFAULT_VISIBLE_COLUMNS,
   columnGroups: COLUMN_GROUPS,
   hasFooter: true
 };
@@ -2107,6 +2108,7 @@ var MODIFIER_MIX_AVAILABLE_COLUMNS = [
 ];
 var modifierMixConfig = {
   fields: FIELDS6,
+  chartFields: MODIFIER_MIX_VISIBLE_COLUMNS,
   availableColumns: MODIFIER_MIX_AVAILABLE_COLUMNS,
   defaultVisibleColumns: MODIFIER_MIX_VISIBLE_COLUMNS,
   hasFooter: true
@@ -3535,10 +3537,13 @@ var ExportBuilder = class {
     }
     let sections;
     if (Array.isArray(rawConfig)) {
-      sections = rawConfig.map((config) => ({
-        sheetName: this.getConfigSectionName(config),
-        ...this.renderTableContent(config, reportData, parameters)
-      }));
+      const sectionParameters = { ...parameters, cols: void 0 };
+      sections = rawConfig.map((config) => {
+        return {
+          sheetName: this.getConfigSectionName(config),
+          ...this.renderTableContent(config, reportData, sectionParameters)
+        };
+      });
     } else {
       const metadata = this.buildMetadata(parameters);
       sections = [

package/dist/exporters/exportBuilder.js

@@ -6,7 +6,7 @@ import {
   getReportConfig,
   getReportFormattingLocaleOptions,
   resolveTranslate
-} from "../chunk-SZ4VPNAX.js";
+} from "../chunk-SUWIUPHT.js";
 
 // src/exporters/exportBuilder.ts
 import { format, isValid, parseISO } from "date-fns";
@@ -193,10 +193,13 @@ var ExportBuilder = class {
     }
     let sections;
     if (Array.isArray(rawConfig)) {
-      sections = rawConfig.map((config) => ({
-        sheetName: this.getConfigSectionName(config),
-        ...this.renderTableContent(config, reportData, parameters)
-      }));
+      const sectionParameters = { ...parameters, cols: void 0 };
+      sections = rawConfig.map((config) => {
+        return {
+          sheetName: this.getConfigSectionName(config),
+          ...this.renderTableContent(config, reportData, sectionParameters)
+        };
+      });
     } else {
       const metadata = this.buildMetadata(parameters);
       sections = [

package/dist/exporters/json/index.cjs

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/exporters/json/index.ts
+var json_exports = {};
+__export(json_exports, {
+  JsonRenderer: () => JsonRenderer
+});
+module.exports = __toCommonJS(json_exports);
+var JsonRenderer = class {
+  render(doc) {
+    const slug = doc.title.trim().replace(/[^\w-]/g, "_") || "report";
+    return {
+      buffer: Buffer.from(JSON.stringify(doc)),
+      contentType: "application/json",
+      fileName: `${slug}.json`
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  JsonRenderer
+});

package/dist/exporters/json/index.d.cts

@@ -0,0 +1,7 @@
+import { a as ReportDocument, R as RenderedReport } from '../../ir-CUi0Z9hv.cjs';
+
+declare class JsonRenderer {
+    render(doc: ReportDocument): RenderedReport;
+}
+
+export { JsonRenderer };

package/dist/exporters/json/index.d.ts

@@ -0,0 +1,7 @@
+import { a as ReportDocument, R as RenderedReport } from '../../ir-CUi0Z9hv.js';
+
+declare class JsonRenderer {
+    render(doc: ReportDocument): RenderedReport;
+}
+
+export { JsonRenderer };

package/dist/exporters/json/index.js

@@ -0,0 +1,14 @@
+// src/exporters/json/index.ts
+var JsonRenderer = class {
+  render(doc) {
+    const slug = doc.title.trim().replace(/[^\w-]/g, "_") || "report";
+    return {
+      buffer: Buffer.from(JSON.stringify(doc)),
+      contentType: "application/json",
+      fileName: `${slug}.json`
+    };
+  }
+};
+export {
+  JsonRenderer
+};

package/dist/index.cjs

@@ -252,6 +252,7 @@ var salesSummaryConfig = {
   fields: FIELDS2,
   availableColumns: SALES_SUMMARY_AVAILABLE_COLUMNS,
   defaultVisibleColumns: SALES_SUMMARY_DEFAULT_VISIBLE_COLUMNS,
+  chartFields: SALES_SUMMARY_DEFAULT_VISIBLE_COLUMNS,
   columnGroups: COLUMN_GROUPS,
   hasFooter: true
 };
@@ -545,6 +546,7 @@ var MODIFIER_MIX_AVAILABLE_COLUMNS = [
 ];
 var modifierMixConfig = {
   fields: FIELDS6,
+  chartFields: MODIFIER_MIX_VISIBLE_COLUMNS,
   availableColumns: MODIFIER_MIX_AVAILABLE_COLUMNS,
   defaultVisibleColumns: MODIFIER_MIX_VISIBLE_COLUMNS,
   hasFooter: true

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import { M as MessageKey, F as FieldType, C as ColumnAlignment, a as ColumnPresentationConfig, b as ColumnGroupConfig, R as ReportType, c as ReportConfig, d as ReportColumnKey } from './report-Bx5XpFQ0.cjs';
 export { e as COLUMN_REGISTRY, f as ColumnMessageKey, g as ColumnMetadata, h as FooterCalculation, i as FooterCalculationType, j as Report, k as getColumnExportHeaderLabel, l as getColumnMetadata, m as getReportConfig, n as getReportExportFileName } from './report-Bx5XpFQ0.cjs';
 import { LocaleCode } from '@harbortouch/locale-registry';
+export { R as RenderedReport, a as ReportDocument, b as ReportFormat, c as ReportSection, d as ResolvedColumn, S as SummaryRow } from './ir-CUi0Z9hv.cjs';
 
 type SupportedLocale = LocaleCode;
 declare function resolveTranslate(key: MessageKey, locale: string): string;
@@ -16,6 +17,7 @@ declare const salesSummaryConfig: {
     readonly fields: Record<SalesSummaryField, ColumnPresentationConfig<SalesSummaryField>>;
     readonly availableColumns: SalesSummaryField[];
     readonly defaultVisibleColumns: SalesSummaryField[];
+    readonly chartFields: SalesSummaryField[];
     readonly columnGroups: ColumnGroupConfig[];
     readonly hasFooter: true;
 };
@@ -48,6 +50,7 @@ declare const productMixConfig: {
 type ModifierMixField = 'groupById' | 'groupByName' | 'groupById2' | 'groupByName2' | 'modifiersSales' | 'modifiersQuantity' | 'itemsQuantity' | 'avgGross' | 'attachRate' | 'modifiersSalesComp' | 'modifiersQuantityComp' | 'itemsQuantityComp' | 'attachRateComp' | 'modifiersSalesVar' | 'modifiersSalesVarPct' | 'modifiersQuantityVar' | 'modifiersQuantityVarPct' | 'attachRateVar' | 'attachRateVarPct';
 declare const modifierMixConfig: {
     readonly fields: Record<ModifierMixField, ColumnPresentationConfig<ModifierMixField>>;
+    readonly chartFields: ModifierMixField[];
     readonly availableColumns: ModifierMixField[];
     readonly defaultVisibleColumns: ModifierMixField[];
     readonly hasFooter: true;

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { M as MessageKey, F as FieldType, C as ColumnAlignment, a as ColumnPresentationConfig, b as ColumnGroupConfig, R as ReportType, c as ReportConfig, d as ReportColumnKey } from './report-Bx5XpFQ0.js';
 export { e as COLUMN_REGISTRY, f as ColumnMessageKey, g as ColumnMetadata, h as FooterCalculation, i as FooterCalculationType, j as Report, k as getColumnExportHeaderLabel, l as getColumnMetadata, m as getReportConfig, n as getReportExportFileName } from './report-Bx5XpFQ0.js';
 import { LocaleCode } from '@harbortouch/locale-registry';
+export { R as RenderedReport, a as ReportDocument, b as ReportFormat, c as ReportSection, d as ResolvedColumn, S as SummaryRow } from './ir-CUi0Z9hv.js';
 
 type SupportedLocale = LocaleCode;
 declare function resolveTranslate(key: MessageKey, locale: string): string;
@@ -16,6 +17,7 @@ declare const salesSummaryConfig: {
     readonly fields: Record<SalesSummaryField, ColumnPresentationConfig<SalesSummaryField>>;
     readonly availableColumns: SalesSummaryField[];
     readonly defaultVisibleColumns: SalesSummaryField[];
+    readonly chartFields: SalesSummaryField[];
     readonly columnGroups: ColumnGroupConfig[];
     readonly hasFooter: true;
 };
@@ -48,6 +50,7 @@ declare const productMixConfig: {
 type ModifierMixField = 'groupById' | 'groupByName' | 'groupById2' | 'groupByName2' | 'modifiersSales' | 'modifiersQuantity' | 'itemsQuantity' | 'avgGross' | 'attachRate' | 'modifiersSalesComp' | 'modifiersQuantityComp' | 'itemsQuantityComp' | 'attachRateComp' | 'modifiersSalesVar' | 'modifiersSalesVarPct' | 'modifiersQuantityVar' | 'modifiersQuantityVarPct' | 'attachRateVar' | 'attachRateVarPct';
 declare const modifierMixConfig: {
     readonly fields: Record<ModifierMixField, ColumnPresentationConfig<ModifierMixField>>;
+    readonly chartFields: ModifierMixField[];
     readonly availableColumns: ModifierMixField[];
     readonly defaultVisibleColumns: ModifierMixField[];
     readonly hasFooter: true;

package/dist/index.js

@@ -37,7 +37,7 @@ import {
   salesSummaryConfig,
   ticketLiveConfig,
   ticketSummaryConfig
-} from "./chunk-SZ4VPNAX.js";
+} from "./chunk-SUWIUPHT.js";
 
 // src/utils/alignment.ts
 function getColumnAlignment(type) {

package/dist/ir-CUi0Z9hv.d.cts

@@ -0,0 +1,55 @@
+/** Output format a renderer produces. */
+type ReportFormat = 'csv' | 'xlsx' | 'pdf' | 'html' | 'json';
+/**
+ * A fully resolved column — header text already translated, alignment
+ * already derived. Renderers consume this directly without touching the
+ * column registry or i18n layer.
+ */
+interface ResolvedColumn {
+    key: string;
+    header: string;
+    shortHeader: string;
+    align: 'left' | 'right' | 'center';
+}
+/**
+ * A name + value pair for rows that do not conform to the section's column
+ * schema. Used for footer lines such as "Tax Total €7.00" or
+ * "Total Accountable €13.09" in the Daily Sales Revenue Class section.
+ */
+interface SummaryRow {
+    label: string;
+    value: string;
+    bold?: boolean;
+}
+/**
+ * A single section within a report (e.g. "Payments", "Taxes").
+ * Each section has its own column schema and optional footer / summary rows.
+ */
+interface ReportSection {
+    title?: string;
+    columns: ResolvedColumn[];
+    rows: Record<string, string | null>[];
+    footer?: Record<string, string | null>;
+    summary?: SummaryRow[];
+}
+/**
+ * Format-agnostic intermediate representation of a complete report.
+ * Built once by a document builder, then passed to any renderer
+ * (CSV, XLSX, PDF, HTML, JSON) without further data access.
+ */
+interface ReportDocument {
+    title: string;
+    locale: string;
+    filters: [string, string][];
+    sections: ReportSection[];
+}
+/**
+ * The output produced by a renderer after consuming a ReportDocument.
+ */
+interface RenderedReport {
+    buffer: Buffer;
+    contentType: string;
+    fileName: string;
+}
+
+export type { RenderedReport as R, SummaryRow as S, ReportDocument as a, ReportFormat as b, ReportSection as c, ResolvedColumn as d };

package/dist/ir-CUi0Z9hv.d.ts

@@ -0,0 +1,55 @@
+/** Output format a renderer produces. */
+type ReportFormat = 'csv' | 'xlsx' | 'pdf' | 'html' | 'json';
+/**
+ * A fully resolved column — header text already translated, alignment
+ * already derived. Renderers consume this directly without touching the
+ * column registry or i18n layer.
+ */
+interface ResolvedColumn {
+    key: string;
+    header: string;
+    shortHeader: string;
+    align: 'left' | 'right' | 'center';
+}
+/**
+ * A name + value pair for rows that do not conform to the section's column
+ * schema. Used for footer lines such as "Tax Total €7.00" or
+ * "Total Accountable €13.09" in the Daily Sales Revenue Class section.
+ */
+interface SummaryRow {
+    label: string;
+    value: string;
+    bold?: boolean;
+}
+/**
+ * A single section within a report (e.g. "Payments", "Taxes").
+ * Each section has its own column schema and optional footer / summary rows.
+ */
+interface ReportSection {
+    title?: string;
+    columns: ResolvedColumn[];
+    rows: Record<string, string | null>[];
+    footer?: Record<string, string | null>;
+    summary?: SummaryRow[];
+}
+/**
+ * Format-agnostic intermediate representation of a complete report.
+ * Built once by a document builder, then passed to any renderer
+ * (CSV, XLSX, PDF, HTML, JSON) without further data access.
+ */
+interface ReportDocument {
+    title: string;
+    locale: string;
+    filters: [string, string][];
+    sections: ReportSection[];
+}
+/**
+ * The output produced by a renderer after consuming a ReportDocument.
+ */
+interface RenderedReport {
+    buffer: Buffer;
+    contentType: string;
+    fileName: string;
+}
+
+export type { RenderedReport as R, SummaryRow as S, ReportDocument as a, ReportFormat as b, ReportSection as c, ResolvedColumn as d };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@harbortouch/skytab-analytics-report-utils",
-	"version": "0.24.0",
+	"version": "0.26.0",
 	"description": "Centralized report column presentation configuration for SkyTab Analytics",
 	"engines": {
 		"node": ">=22.6.0",
@@ -34,6 +34,11 @@
 			"types": "./dist/exporters/exportBuilder.d.ts",
 			"import": "./dist/exporters/exportBuilder.js",
 			"require": "./dist/exporters/exportBuilder.cjs"
+		},
+		"./json": {
+			"types": "./dist/exporters/json/index.d.ts",
+			"import": "./dist/exporters/json/index.js",
+			"require": "./dist/exporters/json/index.cjs"
 		}
 	},
 	"files": [