@zentto/report-core 0.1.0

package/dist/engine/band-engine.d.ts

@@ -0,0 +1,32 @@
+import type { ReportLayout, Band, DataSet, RenderOptions } from '../types.js';
+import type { BindingContext } from './data-binding.js';
+/** Intermediate representation of a rendered band positioned on a page */
+export interface RenderedBand {
+    band: Band;
+    y: number;
+    context: BindingContext;
+    /** For detail bands: the current row data */
+    rowData?: Record<string, unknown>;
+    rowIndex?: number;
+    /** For group bands: the group key and rows */
+    groupKey?: string;
+    groupRows?: Record<string, unknown>[];
+}
+export interface PageContent {
+    pageNumber: number;
+    bands: RenderedBand[];
+}
+/** Convert mm to px (96 DPI) */
+export declare function mmToPx(mm: number): number;
+/** Convert inches to px (96 DPI) */
+export declare function inToPx(inches: number): number;
+/** Convert pt to px */
+export declare function ptToPx(pt: number): number;
+/** Convert any unit to px */
+export declare function toPx(value: number, unit: string): number;
+/**
+ * Process a report layout + datasets into paginated content.
+ * This is the core algorithm that handles band placement and page breaks.
+ */
+export declare function processLayout(layout: ReportLayout, dataSets: DataSet, options?: RenderOptions): PageContent[];
+//# sourceMappingURL=band-engine.d.ts.map

package/dist/engine/band-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"band-engine.d.ts","sourceRoot":"","sources":["../../src/engine/band-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,IAAI,EACJ,OAAO,EAIP,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,EAAE,cAAc,CAAC;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,gCAAgC;AAChC,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,uBAAuB;AACvB,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,6BAA6B;AAC7B,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQxD;AAqED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,WAAW,EAAE,CA8Nf"}

package/dist/engine/band-engine.js

@@ -0,0 +1,255 @@
+// @zentto/report-core — Band layout engine
+// Processes bands + data into paginated content
+/** Convert mm to px (96 DPI) */
+export function mmToPx(mm) {
+    return mm * 96 / 25.4;
+}
+/** Convert inches to px (96 DPI) */
+export function inToPx(inches) {
+    return inches * 96;
+}
+/** Convert pt to px */
+export function ptToPx(pt) {
+    return pt * 96 / 72;
+}
+/** Convert any unit to px */
+export function toPx(value, unit) {
+    switch (unit) {
+        case 'mm': return mmToPx(value);
+        case 'in': return inToPx(value);
+        case 'pt': return ptToPx(value);
+        case 'px': return value;
+        default: return value;
+    }
+}
+/** Get usable page height (total - margins) */
+function getUsableHeight(layout) {
+    const unit = layout.pageSize.unit;
+    const total = toPx(layout.pageSize.height, unit);
+    const marginTop = toPx(layout.margins.top, unit);
+    const marginBottom = toPx(layout.margins.bottom, unit);
+    return total - marginTop - marginBottom;
+}
+/** Get usable page width */
+function getUsableWidth(layout) {
+    const unit = layout.pageSize.unit;
+    const total = layout.orientation === 'landscape'
+        ? toPx(layout.pageSize.height, unit)
+        : toPx(layout.pageSize.width, unit);
+    const marginLeft = toPx(layout.margins.left, unit);
+    const marginRight = toPx(layout.margins.right, unit);
+    return total - marginLeft - marginRight;
+}
+/** Get bands by type */
+function getBandsByType(layout, type) {
+    return layout.bands.filter(b => b.type === type && b.visible !== false);
+}
+/** Sort and group array data */
+function prepareData(data, layout) {
+    let result = [...data];
+    // Apply sorting
+    if (layout.sorting && layout.sorting.length > 0) {
+        result.sort((a, b) => {
+            for (const sort of layout.sorting) {
+                const aVal = a[sort.field];
+                const bVal = b[sort.field];
+                if (aVal === bVal)
+                    continue;
+                const cmp = aVal < bVal ? -1 : 1;
+                return sort.direction === 'desc' ? -cmp : cmp;
+            }
+            return 0;
+        });
+    }
+    return result;
+}
+/** Group rows by a field */
+function groupByField(rows, field) {
+    const groups = new Map();
+    for (const row of rows) {
+        const key = String(row[field] ?? '');
+        const group = groups.get(key);
+        if (group) {
+            group.push(row);
+        }
+        else {
+            groups.set(key, [row]);
+        }
+    }
+    return groups;
+}
+/**
+ * Process a report layout + datasets into paginated content.
+ * This is the core algorithm that handles band placement and page breaks.
+ */
+export function processLayout(layout, dataSets, options) {
+    const usableHeight = getUsableHeight(layout);
+    const unit = layout.pageSize.unit;
+    const reportHeaders = getBandsByType(layout, 'reportHeader');
+    const pageHeaders = getBandsByType(layout, 'pageHeader');
+    const columnHeaders = getBandsByType(layout, 'columnHeader');
+    const detailBands = getBandsByType(layout, 'detail');
+    const pageFooters = getBandsByType(layout, 'pageFooter');
+    const reportFooters = getBandsByType(layout, 'reportFooter');
+    const groupHeaders = getBandsByType(layout, 'groupHeader');
+    const groupFooters = getBandsByType(layout, 'groupFooter');
+    // Calculate fixed heights
+    const pageHeaderHeight = pageHeaders.reduce((s, b) => s + toPx(b.height, unit), 0);
+    const pageFooterHeight = pageFooters.reduce((s, b) => s + toPx(b.height, unit), 0);
+    const columnHeaderHeight = columnHeaders.reduce((s, b) => s + toPx(b.height, unit), 0);
+    const pages = [];
+    let currentPageBands = [];
+    let currentY = 0;
+    let pageNumber = 1;
+    const baseCtx = {
+        dataSets,
+        parameters: options?.parameters,
+    };
+    function availableHeight() {
+        return usableHeight - currentY - pageFooterHeight;
+    }
+    function startNewPage() {
+        // Add page footer to current page
+        if (currentPageBands.length > 0) {
+            for (const band of pageFooters) {
+                currentPageBands.push({
+                    band,
+                    y: usableHeight - pageFooterHeight,
+                    context: { ...baseCtx, pageNumber },
+                });
+            }
+            pages.push({ pageNumber, bands: currentPageBands });
+        }
+        pageNumber++;
+        currentPageBands = [];
+        currentY = 0;
+        // Add page header
+        for (const band of pageHeaders) {
+            currentPageBands.push({
+                band,
+                y: currentY,
+                context: { ...baseCtx, pageNumber },
+            });
+            currentY += toPx(band.height, unit);
+        }
+        // Add column headers if they repeat
+        for (const band of columnHeaders) {
+            if (band.repeatOnEveryPage !== false) {
+                currentPageBands.push({
+                    band,
+                    y: currentY,
+                    context: { ...baseCtx, pageNumber },
+                });
+                currentY += toPx(band.height, unit);
+            }
+        }
+    }
+    function addBand(band, ctx, rowData, rowIndex, groupKey, groupRows) {
+        const bandHeight = toPx(band.height, unit);
+        if (bandHeight > availableHeight()) {
+            startNewPage();
+        }
+        currentPageBands.push({
+            band,
+            y: currentY,
+            context: ctx,
+            rowData,
+            rowIndex,
+            groupKey,
+            groupRows,
+        });
+        currentY += bandHeight;
+    }
+    // ─── Start rendering ───────────────────────────────────────────
+    // Page header (first page)
+    for (const band of pageHeaders) {
+        currentPageBands.push({
+            band,
+            y: currentY,
+            context: { ...baseCtx, pageNumber },
+        });
+        currentY += toPx(band.height, unit);
+    }
+    // Report header (first page only)
+    for (const band of reportHeaders) {
+        addBand(band, { ...baseCtx, pageNumber });
+    }
+    // Column headers
+    for (const band of columnHeaders) {
+        addBand(band, { ...baseCtx, pageNumber });
+    }
+    // Detail bands — iterate over data
+    for (const detailBand of detailBands) {
+        const dsId = detailBand.dataSource;
+        if (!dsId)
+            continue;
+        const rawData = dataSets[dsId];
+        if (!Array.isArray(rawData))
+            continue;
+        const rows = prepareData(rawData, layout);
+        // Check if we have groups
+        if (layout.groups && layout.groups.length > 0) {
+            for (const groupDef of layout.groups) {
+                const grouped = groupByField(rows, groupDef.field);
+                for (const [key, groupRows] of grouped) {
+                    // Group header
+                    const ghBand = layout.bands.find(b => b.id === groupDef.headerBandId);
+                    if (ghBand && ghBand.visible !== false) {
+                        if (groupDef.pageBreakBefore && pages.length > 0) {
+                            startNewPage();
+                        }
+                        addBand(ghBand, { ...baseCtx, pageNumber, groupRows, allRows: rows }, groupRows[0], undefined, key, groupRows);
+                    }
+                    // Detail rows within group
+                    for (let i = 0; i < groupRows.length; i++) {
+                        addBand(detailBand, {
+                            ...baseCtx,
+                            pageNumber,
+                            currentRow: groupRows[i],
+                            currentIndex: i,
+                            groupRows,
+                            allRows: rows,
+                        }, groupRows[i], i);
+                    }
+                    // Group footer
+                    if (groupDef.footerBandId) {
+                        const gfBand = layout.bands.find(b => b.id === groupDef.footerBandId);
+                        if (gfBand && gfBand.visible !== false) {
+                            addBand(gfBand, { ...baseCtx, pageNumber, groupRows, allRows: rows }, undefined, undefined, key, groupRows);
+                        }
+                    }
+                }
+            }
+        }
+        else {
+            // No groups — simple detail iteration
+            for (let i = 0; i < rows.length; i++) {
+                addBand(detailBand, {
+                    ...baseCtx,
+                    pageNumber,
+                    currentRow: rows[i],
+                    currentIndex: i,
+                    allRows: rows,
+                }, rows[i], i);
+            }
+        }
+    }
+    // Report footer
+    for (const band of reportFooters) {
+        const allRows = Object.values(dataSets).find(Array.isArray);
+        addBand(band, { ...baseCtx, pageNumber, allRows: allRows || [] });
+    }
+    // Close last page
+    for (const band of pageFooters) {
+        currentPageBands.push({
+            band,
+            y: usableHeight - pageFooterHeight,
+            context: { ...baseCtx, pageNumber },
+        });
+    }
+    if (currentPageBands.length > 0) {
+        pages.push({ pageNumber, bands: currentPageBands });
+    }
+    return pages;
+}
+//# sourceMappingURL=band-engine.js.map

package/dist/engine/band-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"band-engine.js","sourceRoot":"","sources":["../../src/engine/band-engine.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,gDAAgD;AA+BhD,gCAAgC;AAChC,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,OAAO,MAAM,GAAG,EAAE,CAAC;AACrB,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtB,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,IAAY;IAC9C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC;QACxB,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;IACxB,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,SAAS,eAAe,CAAC,MAAoB;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvD,OAAO,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;AAC1C,CAAC;AAED,4BAA4B;AAC5B,SAAS,cAAc,CAAC,MAAoB;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,KAAK,WAAW;QAC9C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC;AAC1C,CAAC;AAED,wBAAwB;AACxB,SAAS,cAAc,CAAC,MAAoB,EAAE,IAAkB;IAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,gCAAgC;AAChC,SAAS,WAAW,CAClB,IAA+B,EAC/B,MAAoB;IAEpB,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvB,gBAAgB;IAChB,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAQ,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3B,IAAI,IAAI,KAAK,IAAI;oBAAE,SAAS;gBAC5B,MAAM,GAAG,GAAG,IAAK,GAAG,IAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,OAAO,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAChD,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4BAA4B;AAC5B,SAAS,YAAY,CACnB,IAA+B,EAC/B,KAAa;IAEb,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,QAAiB,EACjB,OAAuB;IAEvB,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;IAElC,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAE3D,0BAA0B;IAC1B,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAEvF,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,gBAAgB,GAAmB,EAAE,CAAC;IAC1C,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,OAAO,GAAmB;QAC9B,QAAQ;QACR,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC;IAEF,SAAS,eAAe;QACtB,OAAO,YAAY,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IACpD,CAAC;IAED,SAAS,YAAY;QACnB,kCAAkC;QAClC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,gBAAgB,CAAC,IAAI,CAAC;oBACpB,IAAI;oBACJ,CAAC,EAAE,YAAY,GAAG,gBAAgB;oBAClC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE;iBACpC,CAAC,CAAC;YACL,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,UAAU,EAAE,CAAC;QACb,gBAAgB,GAAG,EAAE,CAAC;QACtB,QAAQ,GAAG,CAAC,CAAC;QAEb,kBAAkB;QAClB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,gBAAgB,CAAC,IAAI,CAAC;gBACpB,IAAI;gBACJ,CAAC,EAAE,QAAQ;gBACX,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE;aACpC,CAAC,CAAC;YACH,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,oCAAoC;QACpC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,iBAAiB,KAAK,KAAK,EAAE,CAAC;gBACrC,gBAAgB,CAAC,IAAI,CAAC;oBACpB,IAAI;oBACJ,CAAC,EAAE,QAAQ;oBACX,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE;iBACpC,CAAC,CAAC;gBACH,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,OAAO,CACd,IAAU,EACV,GAAmB,EACnB,OAAiC,EACjC,QAAiB,EACjB,QAAiB,EACjB,SAAqC;QAErC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE3C,IAAI,UAAU,GAAG,eAAe,EAAE,EAAE,CAAC;YACnC,YAAY,EAAE,CAAC;QACjB,CAAC;QAED,gBAAgB,CAAC,IAAI,CAAC;YACpB,IAAI;YACJ,CAAC,EAAE,QAAQ;YACX,OAAO,EAAE,GAAG;YACZ,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,SAAS;SACV,CAAC,CAAC;QACH,QAAQ,IAAI,UAAU,CAAC;IACzB,CAAC;IAED,kEAAkE;IAElE,2BAA2B;IAC3B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,gBAAgB,CAAC,IAAI,CAAC;YACpB,IAAI;YACJ,CAAC,EAAE,QAAQ;YACX,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE;SACpC,CAAC,CAAC;QACH,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,kCAAkC;IAClC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,iBAAiB;IACjB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,mCAAmC;IACnC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QAEtC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE1C,0BAA0B;QAC1B,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACrC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAEnD,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC;oBACvC,eAAe;oBACf,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,YAAY,CAAC,CAAC;oBACtE,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;wBACvC,IAAI,QAAQ,CAAC,eAAe,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACjD,YAAY,EAAE,CAAC;wBACjB,CAAC;wBACD,OAAO,CACL,MAAM,EACN,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EACpD,SAAS,CAAC,CAAC,CAAC,EACZ,SAAS,EACT,GAAG,EACH,SAAS,CACV,CAAC;oBACJ,CAAC;oBAED,2BAA2B;oBAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC1C,OAAO,CACL,UAAU,EACV;4BACE,GAAG,OAAO;4BACV,UAAU;4BACV,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;4BACxB,YAAY,EAAE,CAAC;4BACf,SAAS;4BACT,OAAO,EAAE,IAAI;yBACd,EACD,SAAS,CAAC,CAAC,CAAC,EACZ,CAAC,CACF,CAAC;oBACJ,CAAC;oBAED,eAAe;oBACf,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;wBAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,YAAY,CAAC,CAAC;wBACtE,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;4BACvC,OAAO,CACL,MAAM,EACN,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EACpD,SAAS,EACT,SAAS,EACT,GAAG,EACH,SAAS,CACV,CAAC;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,OAAO,CACL,UAAU,EACV;oBACE,GAAG,OAAO;oBACV,UAAU;oBACV,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;oBACnB,YAAY,EAAE,CAAC;oBACf,OAAO,EAAE,IAAI;iBACd,EACD,IAAI,CAAC,CAAC,CAAC,EACP,CAAC,CACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAA0C,CAAC;QACrG,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,kBAAkB;IAClB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,gBAAgB,CAAC,IAAI,CAAC;YACpB,IAAI;YACJ,CAAC,EAAE,YAAY,GAAG,gBAAgB;YAClC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/engine/data-binding.d.ts

@@ -0,0 +1,26 @@
+import type { DataSet, ReportElement, AggregateFunction } from '../types.js';
+/** Context passed during rendering — current row, aggregates, page info */
+export interface BindingContext {
+    dataSets: DataSet;
+    currentRow?: Record<string, unknown>;
+    currentIndex?: number;
+    groupRows?: Record<string, unknown>[];
+    allRows?: Record<string, unknown>[];
+    pageNumber?: number;
+    totalPages?: number;
+    parameters?: Record<string, unknown>;
+    aggregates?: Map<string, number>;
+}
+/** Resolve a field value from the binding context */
+export declare function resolveField(dataSourceId: string, fieldName: string, ctx: BindingContext): unknown;
+/** Resolve template expressions like {{ds1.clientName}} in strings */
+export declare function resolveTemplate(template: string, ctx: BindingContext): string;
+/** Compute an aggregate over a set of rows */
+export declare function computeAggregate(rows: Record<string, unknown>[], field: string, fn: AggregateFunction): number;
+/** Format a value for display */
+export declare function formatValue(value: unknown, format?: string): string;
+/** Resolve the display value for any element */
+export declare function resolveElementValue(element: ReportElement, ctx: BindingContext): string;
+/** Evaluate simple arithmetic expressions like =qty*price */
+export declare function evaluateSimpleExpression(expr: string, ctx: BindingContext): unknown;
+//# sourceMappingURL=data-binding.d.ts.map

package/dist/engine/data-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-binding.d.ts","sourceRoot":"","sources":["../../src/engine/data-binding.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EAKb,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAoBT;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAK7E;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,iBAAiB,GACpB,MAAM,CAqBR;AAED,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA4CnE;AAoBD,gDAAgD;AAChD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,cAAc,GAClB,MAAM,CAoDR;AAED,6DAA6D;AAC7D,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,cAAc,GAClB,OAAO,CAqBT"}

package/dist/engine/data-binding.js

@@ -0,0 +1,184 @@
+// @zentto/report-core — Data binding engine
+// Resolves field references and expressions against datasets
+/** Resolve a field value from the binding context */
+export function resolveField(dataSourceId, fieldName, ctx) {
+    // If we have a current row (inside detail/group iteration), use it
+    if (ctx.currentRow && fieldName in ctx.currentRow) {
+        return ctx.currentRow[fieldName];
+    }
+    const ds = ctx.dataSets[dataSourceId];
+    if (!ds)
+        return undefined;
+    // Object data source — direct field access
+    if (!Array.isArray(ds)) {
+        return ds[fieldName];
+    }
+    // Array data source with current index
+    if (ctx.currentIndex !== undefined && ds[ctx.currentIndex]) {
+        return ds[ctx.currentIndex][fieldName];
+    }
+    return undefined;
+}
+/** Resolve template expressions like {{ds1.clientName}} in strings */
+export function resolveTemplate(template, ctx) {
+    return template.replace(/\{\{(\w+)\.(\w+)\}\}/g, (_match, dsId, field) => {
+        const value = resolveField(dsId, field, ctx);
+        return value != null ? String(value) : '';
+    });
+}
+/** Compute an aggregate over a set of rows */
+export function computeAggregate(rows, field, fn) {
+    const values = rows
+        .map(r => r[field])
+        .filter((v) => typeof v === 'number');
+    if (values.length === 0)
+        return 0;
+    switch (fn) {
+        case 'sum':
+            return values.reduce((a, b) => a + b, 0);
+        case 'avg':
+            return values.reduce((a, b) => a + b, 0) / values.length;
+        case 'count':
+            return rows.length;
+        case 'min':
+            return Math.min(...values);
+        case 'max':
+            return Math.max(...values);
+        default:
+            return 0;
+    }
+}
+/** Format a value for display */
+export function formatValue(value, format) {
+    if (value == null)
+        return '';
+    if (!format)
+        return String(value);
+    // Number formats
+    if (typeof value === 'number') {
+        if (format.startsWith('$')) {
+            const decimals = (format.match(/\.(\d+)/)?.[1] || '2').length;
+            const prefix = format.charAt(0);
+            return prefix + value.toLocaleString(undefined, {
+                minimumFractionDigits: decimals,
+                maximumFractionDigits: decimals,
+            });
+        }
+        if (format.includes('#') || format.includes('0')) {
+            const decimals = (format.split('.')[1] || '').length;
+            return value.toLocaleString(undefined, {
+                minimumFractionDigits: decimals,
+                maximumFractionDigits: decimals,
+            });
+        }
+        if (format === 'percent') {
+            return (value * 100).toFixed(1) + '%';
+        }
+    }
+    // Date formats
+    if (value instanceof Date || (typeof value === 'string' && !isNaN(Date.parse(value)))) {
+        const date = value instanceof Date ? value : new Date(value);
+        return formatDate(date, format);
+    }
+    // Boolean
+    if (typeof value === 'boolean') {
+        if (format === 'yesno')
+            return value ? 'Yes' : 'No';
+        if (format === 'sino')
+            return value ? 'Si' : 'No';
+        return String(value);
+    }
+    // Uppercase / lowercase
+    if (format === 'uppercase')
+        return String(value).toUpperCase();
+    if (format === 'lowercase')
+        return String(value).toLowerCase();
+    return String(value);
+}
+function formatDate(date, format) {
+    const pad = (n) => String(n).padStart(2, '0');
+    const yyyy = date.getFullYear();
+    const MM = pad(date.getMonth() + 1);
+    const dd = pad(date.getDate());
+    const HH = pad(date.getHours());
+    const mm = pad(date.getMinutes());
+    const ss = pad(date.getSeconds());
+    return format
+        .replace('yyyy', String(yyyy))
+        .replace('MM', MM)
+        .replace('dd', dd)
+        .replace('HH', HH)
+        .replace('mm', mm)
+        .replace('ss', ss);
+}
+/** Resolve the display value for any element */
+export function resolveElementValue(element, ctx) {
+    switch (element.type) {
+        case 'text':
+            return resolveTemplate(element.content, ctx);
+        case 'field': {
+            const fe = element;
+            // Aggregate field (used in footers)
+            if (fe.aggregate) {
+                const rows = ctx.groupRows || ctx.allRows || [];
+                const val = computeAggregate(rows, fe.field, fe.aggregate);
+                return formatValue(val, fe.format);
+            }
+            // Expression field
+            if (fe.expression) {
+                const val = evaluateSimpleExpression(fe.expression, ctx);
+                return formatValue(val, fe.format);
+            }
+            // Regular field
+            const val = resolveField(fe.dataSource, fe.field, ctx);
+            return formatValue(val, fe.format);
+        }
+        case 'image': {
+            const ie = element;
+            return resolveTemplate(ie.src, ctx);
+        }
+        case 'barcode': {
+            const be = element;
+            return resolveTemplate(be.value, ctx);
+        }
+        case 'pageNumber':
+            if (element.format) {
+                return element.format
+                    .replace('{page}', String(ctx.pageNumber || 1))
+                    .replace('{pages}', String(ctx.totalPages || 1));
+            }
+            return String(ctx.pageNumber || 1);
+        case 'totalPages':
+            return String(ctx.totalPages || 1);
+        case 'currentDate': {
+            const now = new Date();
+            return element.format ? formatDate(now, element.format) : now.toLocaleDateString();
+        }
+        default:
+            return '';
+    }
+}
+/** Evaluate simple arithmetic expressions like =qty*price */
+export function evaluateSimpleExpression(expr, ctx) {
+    let expression = expr.startsWith('=') ? expr.slice(1) : expr;
+    // Replace field references with actual values
+    expression = expression.replace(/(\w+)/g, (match) => {
+        if (ctx.currentRow && match in ctx.currentRow) {
+            const val = ctx.currentRow[match];
+            return typeof val === 'number' ? String(val) : `"${val}"`;
+        }
+        // Check if it's a number literal
+        if (!isNaN(Number(match)))
+            return match;
+        return `"${match}"`;
+    });
+    try {
+        // Safe evaluation using Function constructor (no access to global scope)
+        const fn = new Function(`"use strict"; return (${expression});`);
+        return fn();
+    }
+    catch {
+        return expr;
+    }
+}
+//# sourceMappingURL=data-binding.js.map

package/dist/engine/data-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-binding.js","sourceRoot":"","sources":["../../src/engine/data-binding.ts"],"names":[],"mappings":"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"}

package/dist/engine/expression.d.ts

@@ -0,0 +1,12 @@
+import type { BindingContext } from './data-binding.js';
+/**
+ * Evaluate an expression string with context.
+ *
+ * Supports:
+ * - Field references: {fieldName} or {dataSource.field}
+ * - Function calls: =SUM({qty}), =IF({status}=="paid","PAID","PENDING")
+ * - Arithmetic: =qty*price
+ * - Aggregate over group: =SUM_GROUP(detail, total)
+ */
+export declare function evaluateExpression(expr: string, ctx: BindingContext): unknown;
+//# sourceMappingURL=expression.d.ts.map

package/dist/engine/expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../src/engine/expression.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA6DxD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,cAAc,GAClB,OAAO,CAoDT"}

package/dist/engine/expression.js

@@ -0,0 +1,112 @@
+// @zentto/report-core — Expression engine
+// Evaluates formulas and expressions in report fields
+import { computeAggregate } from './data-binding.js';
+/** Built-in functions available in expressions */
+const FUNCTIONS = {
+    // Aggregates
+    SUM: (...args) => args.reduce((a, b) => a + b, 0),
+    AVG: (...args) => {
+        const nums = args;
+        return nums.reduce((a, b) => a + b, 0) / nums.length;
+    },
+    COUNT: (...args) => args.length,
+    MIN: (...args) => Math.min(...args),
+    MAX: (...args) => Math.max(...args),
+    // Math
+    ROUND: (val, decimals) => Math.round(val * 10 ** decimals) / 10 ** decimals,
+    ABS: (val) => Math.abs(val),
+    CEIL: (val) => Math.ceil(val),
+    FLOOR: (val) => Math.floor(val),
+    // String
+    UPPER: (val) => String(val).toUpperCase(),
+    LOWER: (val) => String(val).toLowerCase(),
+    TRIM: (val) => String(val).trim(),
+    LEFT: (val, n) => String(val).slice(0, n),
+    RIGHT: (val, n) => String(val).slice(-n),
+    LEN: (val) => String(val).length,
+    CONCAT: (...args) => args.map(String).join(''),
+    // Logic
+    IF: (cond, trueVal, falseVal) => cond ? trueVal : falseVal,
+    IIF: (cond, trueVal, falseVal) => cond ? trueVal : falseVal,
+    // Date
+    NOW: () => new Date().toISOString(),
+    TODAY: () => new Date().toISOString().split('T')[0],
+    YEAR: (val) => new Date(val).getFullYear(),
+    MONTH: (val) => new Date(val).getMonth() + 1,
+    DAY: (val) => new Date(val).getDate(),
+    // Format
+    FORMAT: (val, fmt) => {
+        if (typeof val === 'number' && typeof fmt === 'string') {
+            if (fmt.startsWith('$')) {
+                return '$' + val.toFixed(2);
+            }
+            const decimals = (fmt.split('.')[1] || '').length;
+            return val.toFixed(decimals);
+        }
+        return String(val);
+    },
+    // Null handling
+    ISNULL: (val, fallback) => val ?? fallback,
+    COALESCE: (...args) => args.find(a => a != null) ?? null,
+};
+/**
+ * Evaluate an expression string with context.
+ *
+ * Supports:
+ * - Field references: {fieldName} or {dataSource.field}
+ * - Function calls: =SUM({qty}), =IF({status}=="paid","PAID","PENDING")
+ * - Arithmetic: =qty*price
+ * - Aggregate over group: =SUM_GROUP(detail, total)
+ */
+export function evaluateExpression(expr, ctx) {
+    if (!expr)
+        return '';
+    // Non-expression strings are returned as-is
+    if (!expr.startsWith('='))
+        return expr;
+    const formula = expr.slice(1).trim();
+    // Check for aggregate function over dataset: SUM_GROUP(dsId, field)
+    const aggGroupMatch = formula.match(/^(SUM|AVG|COUNT|MIN|MAX)_GROUP\((\w+),\s*(\w+)\)$/);
+    if (aggGroupMatch) {
+        const [, fn, _dsId, field] = aggGroupMatch;
+        const rows = ctx.groupRows || ctx.allRows || [];
+        return computeAggregate(rows, field, fn.toLowerCase());
+    }
+    // Check for aggregate function over all: SUM_ALL(field)
+    const aggAllMatch = formula.match(/^(SUM|AVG|COUNT|MIN|MAX)_ALL\((\w+)\)$/);
+    if (aggAllMatch) {
+        const [, fn, field] = aggAllMatch;
+        const rows = ctx.allRows || [];
+        return computeAggregate(rows, field, fn.toLowerCase());
+    }
+    // Replace {fieldName} with actual values
+    let resolved = formula.replace(/\{(\w+)(?:\.(\w+))?\}/g, (_m, ref1, ref2) => {
+        if (ref2) {
+            // {dataSource.field}
+            const ds = ctx.dataSets[ref1];
+            if (ds && !Array.isArray(ds))
+                return JSON.stringify(ds[ref2] ?? null);
+            if (ctx.currentRow && ref1 in ctx.currentRow)
+                return JSON.stringify(ctx.currentRow[ref1]);
+        }
+        // {field} — look in current row
+        if (ctx.currentRow && ref1 in ctx.currentRow) {
+            const val = ctx.currentRow[ref1];
+            return typeof val === 'string' ? JSON.stringify(val) : String(val ?? 'null');
+        }
+        return 'null';
+    });
+    // Replace function calls with JS equivalents
+    for (const [name, fn] of Object.entries(FUNCTIONS)) {
+        const regex = new RegExp(`\\b${name}\\(`, 'g');
+        resolved = resolved.replace(regex, `__fn.${name}(`);
+    }
+    try {
+        const fn = new Function('__fn', `"use strict"; return (${resolved});`);
+        return fn(FUNCTIONS);
+    }
+    catch {
+        return `#ERR: ${expr}`;
+    }
+}
+//# sourceMappingURL=expression.js.map