documents.js 1.62.0 → 1.64.0

package/dist/layout/sheets.cjs

@@ -218,39 +218,45 @@ function renderCellText(cell, frameYDown, rowCells, columnAxis, pageHeightPt, me
 	const alignment = cell.alignment ?? defaultAlignmentForValue(cell.value.kind);
 	const numericLike = isNumericLikeValue(cell.value.kind);
 	const styledRuns = cellStyledRuns(cell);
-	const naturalLine = (0, pdf_codec.wrapRunsToWidth)(styledRuns, measurer, Number.POSITIVE_INFINITY)[0];
+	const lines = (0, pdf_codec.wrapRunsToWidth)(styledRuns, measurer, Number.POSITIVE_INFINITY);
+	const naturalLine = lines[0];
 	let availableWidthPt = Math.max(0, ownWidthPt - 4);
 	let fragments = naturalLine.fragments;
 	let lineWidthPt = naturalLine.widthPt;
-	if (lineWidthPt > availableWidthPt) if (numericLike) {
-		const overflowRuns = [{
-			text: NUMERIC_OVERFLOW_TEXT,
-			font: styledRuns[0].font,
-			sizePt: styledRuns[0].sizePt,
-			color: styledRuns[0].color
-		}];
-		const overflowLine = (0, pdf_codec.wrapRunsToWidth)(overflowRuns, measurer, Number.POSITIVE_INFINITY)[0];
-		fragments = overflowLine.fragments;
-		lineWidthPt = overflowLine.widthPt;
-	} else if (cell.value.kind === "string") {
-		let spillColumn = cell.column + (cell.colSpan ?? 1);
-		while (lineWidthPt > availableWidthPt) {
-			const neighborPosition = columnAxis.positionByIndex.get(spillColumn);
-			if (neighborPosition === void 0 || !isCellVisuallyEmpty(rowCells?.get(spillColumn))) break;
-			availableWidthPt += columnAxis.sizesPt[neighborPosition];
-			spillColumn++;
-		}
-		if (lineWidthPt > availableWidthPt) fragments = truncateFragmentsToWidth(fragments, measurer, availableWidthPt);
-	} else fragments = truncateFragmentsToWidth(fragments, measurer, availableWidthPt);
+	let overflowed = false;
+	if (lineWidthPt > availableWidthPt) {
+		overflowed = true;
+		if (numericLike) {
+			const overflowRuns = [{
+				text: NUMERIC_OVERFLOW_TEXT,
+				font: styledRuns[0].font,
+				sizePt: styledRuns[0].sizePt,
+				color: styledRuns[0].color
+			}];
+			const overflowLine = (0, pdf_codec.wrapRunsToWidth)(overflowRuns, measurer, Number.POSITIVE_INFINITY)[0];
+			fragments = overflowLine.fragments;
+			lineWidthPt = overflowLine.widthPt;
+		} else if (cell.value.kind === "string") {
+			let spillColumn = cell.column + (cell.colSpan ?? 1);
+			while (lineWidthPt > availableWidthPt) {
+				const neighborPosition = columnAxis.positionByIndex.get(spillColumn);
+				if (neighborPosition === void 0 || !isCellVisuallyEmpty(rowCells?.get(spillColumn))) break;
+				availableWidthPt += columnAxis.sizesPt[neighborPosition];
+				spillColumn++;
+			}
+			if (lineWidthPt > availableWidthPt) fragments = truncateFragmentsToWidth(fragments, measurer, availableWidthPt);
+		} else fragments = truncateFragmentsToWidth(fragments, measurer, availableWidthPt);
+	}
 	const alignOffsetPt = require_layout_shared.alignmentOffsetPt(alignment, availableWidthPt, lineWidthPt);
 	const textStartXPt = xLeftPt + CELL_TEXT_PADDING_PT + alignOffsetPt;
 	const lineHeightPt = require_layout_shared.lineNaturalHeightPt(naturalLine, measurer, styledRuns[0]);
 	const baselineYDownPt = verticalLineTopYDownPt(cell.verticalAlignment ?? DEFAULT_CELL_VERTICAL_ALIGNMENT, yTopDownPt, heightPt, lineHeightPt) + naturalLine.ascentPt;
-	for (const fragment of fragments) {
+	const justifyGapsPt = alignment === "justify" && !overflowed && lines.length > 1 ? require_layout_shared.justifyLineGapsPt(naturalLine, availableWidthPt, measurer) : void 0;
+	fragments.forEach((fragment, fragmentIndex) => {
 		const textItem = {
 			kind: "text",
 			text: fragment.text,
-			xPt: textStartXPt + fragment.xOffsetPt,
+			xPt: textStartXPt + fragment.xOffsetPt + (justifyGapsPt?.[fragmentIndex] ?? 0),
 			yPt: pageHeightPt - baselineYDownPt,
 			font: fragment.font,
 			sizePt: fragment.sizePt,
@@ -259,7 +265,7 @@ function renderCellText(cell, frameYDown, rowCells, columnAxis, pageHeightPt, me
 			sourcePath: fragment.sourcePath
 		};
 		out.push(textItem);
-	}
+	});
 }
 function renderHeaderLabels(gutter, columnAxis, rowAxis, gridLeftXPt, gridTopYDownPt, pageHeightPt, measurer, out) {
 	const lineHeightPt = measurer.lineHeightAtSize(document_schema_js.DEFAULT_LAYOUT_FONT, HEADER_LABEL_SIZE_PT);

package/dist/layout/sheets.js

@@ -1,7 +1,7 @@
 import { flipY } from "../model/geometry.js";
 import { COLOR_BLACK as COLOR_BLACK$1, rgbHexToColor } from "../model/color.js";
 import { DEFAULT_LAYOUT_FONT } from "../model/style.js";
-import { alignmentOffsetPt, lineNaturalHeightPt, pushCellBorderLines, sumColumnWidthsPt, toStyledRuns } from "./shared.js";
+import { alignmentOffsetPt, justifyLineGapsPt, lineNaturalHeightPt, pushCellBorderLines, sumColumnWidthsPt, toStyledRuns } from "./shared.js";
 import { throwIfAborted } from "../ports/abort.js";
 import { LAYOUT_FORMAT_VERSION } from "document-schema.js";
 import { wrapRunsToWidth } from "pdf-codec";
@@ -219,39 +219,45 @@ function renderCellText(cell, frameYDown, rowCells, columnAxis, pageHeightPt, me
 	const alignment = cell.alignment ?? defaultAlignmentForValue(cell.value.kind);
 	const numericLike = isNumericLikeValue(cell.value.kind);
 	const styledRuns = cellStyledRuns(cell);
-	const naturalLine = wrapRunsToWidth(styledRuns, measurer, Number.POSITIVE_INFINITY)[0];
+	const lines = wrapRunsToWidth(styledRuns, measurer, Number.POSITIVE_INFINITY);
+	const naturalLine = lines[0];
 	let availableWidthPt = Math.max(0, ownWidthPt - 4);
 	let fragments = naturalLine.fragments;
 	let lineWidthPt = naturalLine.widthPt;
-	if (lineWidthPt > availableWidthPt) if (numericLike) {
-		const overflowRuns = [{
-			text: NUMERIC_OVERFLOW_TEXT,
-			font: styledRuns[0].font,
-			sizePt: styledRuns[0].sizePt,
-			color: styledRuns[0].color
-		}];
-		const overflowLine = wrapRunsToWidth(overflowRuns, measurer, Number.POSITIVE_INFINITY)[0];
-		fragments = overflowLine.fragments;
-		lineWidthPt = overflowLine.widthPt;
-	} else if (cell.value.kind === "string") {
-		let spillColumn = cell.column + (cell.colSpan ?? 1);
-		while (lineWidthPt > availableWidthPt) {
-			const neighborPosition = columnAxis.positionByIndex.get(spillColumn);
-			if (neighborPosition === void 0 || !isCellVisuallyEmpty(rowCells?.get(spillColumn))) break;
-			availableWidthPt += columnAxis.sizesPt[neighborPosition];
-			spillColumn++;
-		}
-		if (lineWidthPt > availableWidthPt) fragments = truncateFragmentsToWidth(fragments, measurer, availableWidthPt);
-	} else fragments = truncateFragmentsToWidth(fragments, measurer, availableWidthPt);
+	let overflowed = false;
+	if (lineWidthPt > availableWidthPt) {
+		overflowed = true;
+		if (numericLike) {
+			const overflowRuns = [{
+				text: NUMERIC_OVERFLOW_TEXT,
+				font: styledRuns[0].font,
+				sizePt: styledRuns[0].sizePt,
+				color: styledRuns[0].color
+			}];
+			const overflowLine = wrapRunsToWidth(overflowRuns, measurer, Number.POSITIVE_INFINITY)[0];
+			fragments = overflowLine.fragments;
+			lineWidthPt = overflowLine.widthPt;
+		} else if (cell.value.kind === "string") {
+			let spillColumn = cell.column + (cell.colSpan ?? 1);
+			while (lineWidthPt > availableWidthPt) {
+				const neighborPosition = columnAxis.positionByIndex.get(spillColumn);
+				if (neighborPosition === void 0 || !isCellVisuallyEmpty(rowCells?.get(spillColumn))) break;
+				availableWidthPt += columnAxis.sizesPt[neighborPosition];
+				spillColumn++;
+			}
+			if (lineWidthPt > availableWidthPt) fragments = truncateFragmentsToWidth(fragments, measurer, availableWidthPt);
+		} else fragments = truncateFragmentsToWidth(fragments, measurer, availableWidthPt);
+	}
 	const alignOffsetPt = alignmentOffsetPt(alignment, availableWidthPt, lineWidthPt);
 	const textStartXPt = xLeftPt + CELL_TEXT_PADDING_PT + alignOffsetPt;
 	const lineHeightPt = lineNaturalHeightPt(naturalLine, measurer, styledRuns[0]);
 	const baselineYDownPt = verticalLineTopYDownPt(cell.verticalAlignment ?? DEFAULT_CELL_VERTICAL_ALIGNMENT, yTopDownPt, heightPt, lineHeightPt) + naturalLine.ascentPt;
-	for (const fragment of fragments) {
+	const justifyGapsPt = alignment === "justify" && !overflowed && lines.length > 1 ? justifyLineGapsPt(naturalLine, availableWidthPt, measurer) : void 0;
+	fragments.forEach((fragment, fragmentIndex) => {
 		const textItem = {
 			kind: "text",
 			text: fragment.text,
-			xPt: textStartXPt + fragment.xOffsetPt,
+			xPt: textStartXPt + fragment.xOffsetPt + (justifyGapsPt?.[fragmentIndex] ?? 0),
 			yPt: pageHeightPt - baselineYDownPt,
 			font: fragment.font,
 			sizePt: fragment.sizePt,
@@ -260,7 +266,7 @@ function renderCellText(cell, frameYDown, rowCells, columnAxis, pageHeightPt, me
 			sourcePath: fragment.sourcePath
 		};
 		out.push(textItem);
-	}
+	});
 }
 function renderHeaderLabels(gutter, columnAxis, rowAxis, gridLeftXPt, gridTopYDownPt, pageHeightPt, measurer, out) {
 	const lineHeightPt = measurer.lineHeightAtSize(DEFAULT_LAYOUT_FONT, HEADER_LABEL_SIZE_PT);

package/dist/layout/slides.cjs

@@ -31,14 +31,16 @@ function layoutParagraph(paragraph, contentLeftXDown, contentWidthPt, startYDown
 	const fallbackRun = effectiveRuns[0];
 	const paragraphLeftXDown = contentLeftXDown + (paragraph.indentLeftPt ?? 0);
 	const paragraphWidthPt = Math.max(0, contentWidthPt - (paragraph.indentLeftPt ?? 0));
-	(0, pdf_codec.wrapRunsToWidth)(effectiveRuns, measurer, paragraphWidthPt).forEach((line, lineIndex) => {
+	const lines = (0, pdf_codec.wrapRunsToWidth)(effectiveRuns, measurer, paragraphWidthPt);
+	lines.forEach((line, lineIndex) => {
 		const scaledLineHeightPt = require_layout_shared.lineNaturalHeightPt(line, measurer, fallbackRun) * (paragraph.lineSpacing ?? 1) * spacingScale;
 		const baselineYDown = cursorYDown + line.ascentPt;
 		const firstLineIndentPt = lineIndex === 0 ? paragraph.indentFirstLinePt ?? 0 : 0;
 		const alignOffsetPt = require_layout_shared.alignmentOffsetPt(paragraph.alignment, paragraphWidthPt, line.widthPt);
-		for (const fragment of line.fragments) {
+		const justifyGapsPt = paragraph.alignment === "justify" && lineIndex < lines.length - 1 ? require_layout_shared.justifyLineGapsPt(line, paragraphWidthPt, measurer) : void 0;
+		line.fragments.forEach((fragment, fragmentIndex) => {
 			const unrotated = {
-				x: paragraphLeftXDown + firstLineIndentPt + alignOffsetPt + fragment.xOffsetPt,
+				x: paragraphLeftXDown + firstLineIndentPt + alignOffsetPt + fragment.xOffsetPt + (justifyGapsPt?.[fragmentIndex] ?? 0),
 				y: slideHeightPt - baselineYDown
 			};
 			const placed = placement.place(unrotated);
@@ -72,7 +74,7 @@ function layoutParagraph(paragraph, contentLeftXDown, contentWidthPt, startYDown
 				};
 				out.push(link);
 			}
-		}
+		});
 		cursorYDown += scaledLineHeightPt;
 	});
 	cursorYDown += paragraph.spacingAfterPt ?? 0;

package/dist/layout/slides.js

@@ -1,7 +1,7 @@
 import { flipY } from "../model/geometry.js";
 import { formulaOfBlock } from "../model/formula.js";
 import { layoutFormula } from "../mathml/layout.js";
-import { alignmentOffsetPt, effectiveStyledRuns, estimateRowHeightPt, lineNaturalHeightPt, registerImage, sumColumnWidthsPt } from "./shared.js";
+import { alignmentOffsetPt, effectiveStyledRuns, estimateRowHeightPt, justifyLineGapsPt, lineNaturalHeightPt, registerImage, sumColumnWidthsPt } from "./shared.js";
 import { COLOR_BLACK, LAYOUT_FORMAT_VERSION } from "document-schema.js";
 import { loadMathFont, rotatePointAboutCenter, wrapRunsToWidth } from "pdf-codec";
 //#region src/layout/slides.ts
@@ -30,14 +30,16 @@ function layoutParagraph(paragraph, contentLeftXDown, contentWidthPt, startYDown
 	const fallbackRun = effectiveRuns[0];
 	const paragraphLeftXDown = contentLeftXDown + (paragraph.indentLeftPt ?? 0);
 	const paragraphWidthPt = Math.max(0, contentWidthPt - (paragraph.indentLeftPt ?? 0));
-	wrapRunsToWidth(effectiveRuns, measurer, paragraphWidthPt).forEach((line, lineIndex) => {
+	const lines = wrapRunsToWidth(effectiveRuns, measurer, paragraphWidthPt);
+	lines.forEach((line, lineIndex) => {
 		const scaledLineHeightPt = lineNaturalHeightPt(line, measurer, fallbackRun) * (paragraph.lineSpacing ?? 1) * spacingScale;
 		const baselineYDown = cursorYDown + line.ascentPt;
 		const firstLineIndentPt = lineIndex === 0 ? paragraph.indentFirstLinePt ?? 0 : 0;
 		const alignOffsetPt = alignmentOffsetPt(paragraph.alignment, paragraphWidthPt, line.widthPt);
-		for (const fragment of line.fragments) {
+		const justifyGapsPt = paragraph.alignment === "justify" && lineIndex < lines.length - 1 ? justifyLineGapsPt(line, paragraphWidthPt, measurer) : void 0;
+		line.fragments.forEach((fragment, fragmentIndex) => {
 			const unrotated = {
-				x: paragraphLeftXDown + firstLineIndentPt + alignOffsetPt + fragment.xOffsetPt,
+				x: paragraphLeftXDown + firstLineIndentPt + alignOffsetPt + fragment.xOffsetPt + (justifyGapsPt?.[fragmentIndex] ?? 0),
 				y: slideHeightPt - baselineYDown
 			};
 			const placed = placement.place(unrotated);
@@ -71,7 +73,7 @@ function layoutParagraph(paragraph, contentLeftXDown, contentWidthPt, startYDown
 				};
 				out.push(link);
 			}
-		}
+		});
 		cursorYDown += scaledLineHeightPt;
 	});
 	cursorYDown += paragraph.spacingAfterPt ?? 0;

package/dist/lexer-DGPWx_f2.d.cts

@@ -0,0 +1,42 @@
+//#region src/odb/sql/lexer.d.ts
+type SqlComparisonOperator = '=' | '<>' | '<' | '>' | '<=' | '>=';
+type SqlPunctuation = '(' | ')' | ',' | '.' | '*' | ';' | '-';
+type SqlToken = {
+  readonly kind: 'keyword';
+  readonly keyword: string;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'identifier';
+  readonly name: string;
+  readonly quoted: boolean;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'string';
+  readonly value: string;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'number';
+  readonly value: number;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'operator';
+  readonly operator: SqlComparisonOperator;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'punctuation';
+  readonly punctuation: SqlPunctuation;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'end';
+  readonly text: string;
+  readonly start: number;
+};
+declare function tokenizeSql(sql: string): readonly SqlToken[];
+//#endregion
+export { tokenizeSql as i, SqlPunctuation as n, SqlToken as r, SqlComparisonOperator as t };

package/dist/lexer-DGPWx_f2.d.ts

@@ -0,0 +1,42 @@
+//#region src/odb/sql/lexer.d.ts
+type SqlComparisonOperator = '=' | '<>' | '<' | '>' | '<=' | '>=';
+type SqlPunctuation = '(' | ')' | ',' | '.' | '*' | ';' | '-';
+type SqlToken = {
+  readonly kind: 'keyword';
+  readonly keyword: string;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'identifier';
+  readonly name: string;
+  readonly quoted: boolean;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'string';
+  readonly value: string;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'number';
+  readonly value: number;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'operator';
+  readonly operator: SqlComparisonOperator;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'punctuation';
+  readonly punctuation: SqlPunctuation;
+  readonly text: string;
+  readonly start: number;
+} | {
+  readonly kind: 'end';
+  readonly text: string;
+  readonly start: number;
+};
+declare function tokenizeSql(sql: string): readonly SqlToken[];
+//#endregion
+export { tokenizeSql as i, SqlPunctuation as n, SqlToken as r, SqlComparisonOperator as t };

package/dist/mathml/layout.d.cts

@@ -1,7 +1,7 @@
+import { t as MathVariant } from "../variant-BMrebjMw.cjs";
 import { r as MathMlNode } from "../nodes-pArN9ilm.cjs";
 import { MathBox, MathColor, MathDiagnostic, MathLayoutResult } from "./layout-types.cjs";
 import { MathFontMetrics } from "./metrics.cjs";
-import { MathVariant } from "./variant.cjs";
 //#region src/mathml/layout.d.ts
 interface LayoutFormulaOptions {
   readonly metrics: MathFontMetrics;

package/dist/mathml/layout.d.ts

@@ -1,7 +1,7 @@
+import { t as MathVariant } from "../variant-BMrebjMw.js";
 import { r as MathMlNode } from "../nodes-pArN9ilm.js";
 import { MathBox, MathColor, MathDiagnostic, MathLayoutResult } from "./layout-types.js";
 import { MathFontMetrics } from "./metrics.js";
-import { MathVariant } from "./variant.js";
 //#region src/mathml/layout.d.ts
 interface LayoutFormulaOptions {
   readonly metrics: MathFontMetrics;

package/dist/mathml/variant.d.cts

@@ -1,7 +1,2 @@
-//#region src/mathml/variant.d.ts
-type MathVariant = 'normal' | 'bold' | 'italic' | 'bold-italic' | 'double-struck' | 'bold-fraktur' | 'script' | 'bold-script' | 'fraktur' | 'sans-serif' | 'bold-sans-serif' | 'sans-serif-italic' | 'sans-serif-bold-italic' | 'monospace';
-declare function mapMathVariant(codePoint: number, variant: MathVariant): number;
-declare function applyMathVariant(text: string, variant: MathVariant): string;
-declare function isMathVariant(value: string): value is MathVariant;
-//#endregion
+import { i as mapMathVariant, n as applyMathVariant, r as isMathVariant, t as MathVariant } from "../variant-BMrebjMw.cjs";
 export { MathVariant, applyMathVariant, isMathVariant, mapMathVariant };

package/dist/mathml/variant.d.ts

@@ -1,7 +1,2 @@
-//#region src/mathml/variant.d.ts
-type MathVariant = 'normal' | 'bold' | 'italic' | 'bold-italic' | 'double-struck' | 'bold-fraktur' | 'script' | 'bold-script' | 'fraktur' | 'sans-serif' | 'bold-sans-serif' | 'sans-serif-italic' | 'sans-serif-bold-italic' | 'monospace';
-declare function mapMathVariant(codePoint: number, variant: MathVariant): number;
-declare function applyMathVariant(text: string, variant: MathVariant): string;
-declare function isMathVariant(value: string): value is MathVariant;
-//#endregion
+import { i as mapMathVariant, n as applyMathVariant, r as isMathVariant, t as MathVariant } from "../variant-BMrebjMw.js";
 export { MathVariant, applyMathVariant, isMathVariant, mapMathVariant };

package/dist/odb/csv.d.cts

@@ -1,4 +1,4 @@
-import { HsqldbTable } from "../hsqldb/script.cjs";
+import { r as HsqldbTable } from "../script-DsGGIzGU.cjs";
 //#region src/odb/csv.d.ts
 declare class OdbTableNotSpecifiedError extends Error {
   readonly availableTables: readonly string[];

package/dist/odb/csv.d.ts

@@ -1,4 +1,4 @@
-import { HsqldbTable } from "../hsqldb/script.js";
+import { r as HsqldbTable } from "../script-DsGGIzGU.js";
 //#region src/odb/csv.d.ts
 declare class OdbTableNotSpecifiedError extends Error {
   readonly availableTables: readonly string[];

package/dist/odb/formula/definition.cjs

@@ -0,0 +1,49 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_odb_formula_errors = require("./errors.cjs");
+//#region src/odb/formula/definition.ts
+function rptBandDefinition(band) {
+	return { formulas: band.elements.map((element) => element.formula) };
+}
+function bandDefinition(band) {
+	return band === void 0 ? void 0 : rptBandDefinition(band);
+}
+function odbReportGroupChain(report) {
+	const chain = [];
+	let level = report.groups;
+	while (level.length > 0) {
+		if (level.length > 1) throw new require_odb_formula_errors.RptReportStructureError(`${String(level.length)} sibling groups are declared at one nesting level, but Report Builder nests groups strictly and this engine's scoping is defined only for a chain`, report.name);
+		const group = level[0];
+		if (group === void 0) throw new require_odb_formula_errors.RptReportStructureError("a group nesting level reported a non-zero length but held no group", report.name);
+		chain.push(group);
+		level = group.groups;
+	}
+	return chain;
+}
+function groupDefinition(group, level, reportName) {
+	if (group.groupExpression === void 0) throw new require_odb_formula_errors.RptReportStructureError(`the group at nesting level ${String(level)} declares no rpt:group-expression, so there is no break test to evaluate`, reportName);
+	return {
+		groupExpression: group.groupExpression,
+		functions: group.functions.map((declaration) => ({
+			name: declaration.name,
+			formula: declaration.formula
+		})),
+		header: bandDefinition(group.header),
+		footer: bandDefinition(group.footer)
+	};
+}
+function rptDefinitionFromReport(report) {
+	return {
+		functions: report.functions.map((declaration) => ({
+			name: declaration.name,
+			formula: declaration.formula
+		})),
+		reportHeader: bandDefinition(report.reportHeader),
+		groups: odbReportGroupChain(report).map((group, level) => groupDefinition(group, level, report.name)),
+		detail: bandDefinition(report.detail),
+		reportFooter: bandDefinition(report.reportFooter)
+	};
+}
+//#endregion
+exports.odbReportGroupChain = odbReportGroupChain;
+exports.rptBandDefinition = rptBandDefinition;
+exports.rptDefinitionFromReport = rptDefinitionFromReport;

package/dist/odb/formula/definition.d.cts

@@ -0,0 +1,8 @@
+import { RptBandDefinition, RptReportDefinition } from "./evaluate.cjs";
+import { OdbReport, OdbReportBand, OdbReportGroup } from "odf.js";
+//#region src/odb/formula/definition.d.ts
+declare function rptBandDefinition(band: OdbReportBand): RptBandDefinition;
+declare function odbReportGroupChain(report: OdbReport): readonly OdbReportGroup[];
+declare function rptDefinitionFromReport(report: OdbReport): RptReportDefinition;
+//#endregion
+export { odbReportGroupChain, rptBandDefinition, rptDefinitionFromReport };

package/dist/odb/formula/definition.d.ts

@@ -0,0 +1,8 @@
+import { RptBandDefinition, RptReportDefinition } from "./evaluate.js";
+import { OdbReport, OdbReportBand, OdbReportGroup } from "odf.js";
+//#region src/odb/formula/definition.d.ts
+declare function rptBandDefinition(band: OdbReportBand): RptBandDefinition;
+declare function odbReportGroupChain(report: OdbReport): readonly OdbReportGroup[];
+declare function rptDefinitionFromReport(report: OdbReport): RptReportDefinition;
+//#endregion
+export { odbReportGroupChain, rptBandDefinition, rptDefinitionFromReport };

package/dist/odb/formula/definition.js

@@ -0,0 +1,46 @@
+import { RptReportStructureError } from "./errors.js";
+//#region src/odb/formula/definition.ts
+function rptBandDefinition(band) {
+	return { formulas: band.elements.map((element) => element.formula) };
+}
+function bandDefinition(band) {
+	return band === void 0 ? void 0 : rptBandDefinition(band);
+}
+function odbReportGroupChain(report) {
+	const chain = [];
+	let level = report.groups;
+	while (level.length > 0) {
+		if (level.length > 1) throw new RptReportStructureError(`${String(level.length)} sibling groups are declared at one nesting level, but Report Builder nests groups strictly and this engine's scoping is defined only for a chain`, report.name);
+		const group = level[0];
+		if (group === void 0) throw new RptReportStructureError("a group nesting level reported a non-zero length but held no group", report.name);
+		chain.push(group);
+		level = group.groups;
+	}
+	return chain;
+}
+function groupDefinition(group, level, reportName) {
+	if (group.groupExpression === void 0) throw new RptReportStructureError(`the group at nesting level ${String(level)} declares no rpt:group-expression, so there is no break test to evaluate`, reportName);
+	return {
+		groupExpression: group.groupExpression,
+		functions: group.functions.map((declaration) => ({
+			name: declaration.name,
+			formula: declaration.formula
+		})),
+		header: bandDefinition(group.header),
+		footer: bandDefinition(group.footer)
+	};
+}
+function rptDefinitionFromReport(report) {
+	return {
+		functions: report.functions.map((declaration) => ({
+			name: declaration.name,
+			formula: declaration.formula
+		})),
+		reportHeader: bandDefinition(report.reportHeader),
+		groups: odbReportGroupChain(report).map((group, level) => groupDefinition(group, level, report.name)),
+		detail: bandDefinition(report.detail),
+		reportFooter: bandDefinition(report.reportFooter)
+	};
+}
+//#endregion
+export { odbReportGroupChain, rptBandDefinition, rptDefinitionFromReport };

package/dist/odb/formula/errors.cjs

@@ -0,0 +1,47 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/odb/formula/errors.ts
+const MESSAGE_FORMULA_PREVIEW_LENGTH = 200;
+function truncateForMessage(formula) {
+	return formula.length > MESSAGE_FORMULA_PREVIEW_LENGTH ? `${formula.slice(0, MESSAGE_FORMULA_PREVIEW_LENGTH)}...` : formula;
+}
+var RptFormulaUnsupportedError = class extends Error {
+	functionName;
+	formula;
+	constructor(functionName, formula) {
+		super(`Report Builder formula: rpt:${functionName} is not supported by this bounded formula engine -- supported functions are HASCHANGED, LEFT, SUM, COUNT, AVG, MIN, MAX -- in formula: ${truncateForMessage(formula)}`);
+		this.name = "RptFormulaUnsupportedError";
+		this.functionName = functionName;
+		this.formula = formula;
+	}
+};
+var RptFormulaParseError = class extends Error {
+	formula;
+	offset;
+	constructor(message, formula, offset) {
+		super(`Report Builder formula parse error at offset ${String(offset)}: ${message} -- in formula: ${truncateForMessage(formula)}`);
+		this.name = "RptFormulaParseError";
+		this.formula = formula;
+		this.offset = offset;
+	}
+};
+var RptFormulaEvaluationError = class extends Error {
+	formula;
+	constructor(message, formula) {
+		super(`Report Builder formula evaluation error: ${message} -- in formula: ${truncateForMessage(formula)}`);
+		this.name = "RptFormulaEvaluationError";
+		this.formula = formula;
+	}
+};
+var RptReportStructureError = class extends Error {
+	reportName;
+	constructor(message, reportName) {
+		super(`Report Builder report structure error in report "${reportName}": ${message}`);
+		this.name = "RptReportStructureError";
+		this.reportName = reportName;
+	}
+};
+//#endregion
+exports.RptFormulaEvaluationError = RptFormulaEvaluationError;
+exports.RptFormulaParseError = RptFormulaParseError;
+exports.RptFormulaUnsupportedError = RptFormulaUnsupportedError;
+exports.RptReportStructureError = RptReportStructureError;

package/dist/odb/formula/errors.d.cts

@@ -0,0 +1,21 @@
+//#region src/odb/formula/errors.d.ts
+declare class RptFormulaUnsupportedError extends Error {
+  readonly functionName: string;
+  readonly formula: string;
+  constructor(functionName: string, formula: string);
+}
+declare class RptFormulaParseError extends Error {
+  readonly formula: string;
+  readonly offset: number;
+  constructor(message: string, formula: string, offset: number);
+}
+declare class RptFormulaEvaluationError extends Error {
+  readonly formula: string;
+  constructor(message: string, formula: string);
+}
+declare class RptReportStructureError extends Error {
+  readonly reportName: string;
+  constructor(message: string, reportName: string);
+}
+//#endregion
+export { RptFormulaEvaluationError, RptFormulaParseError, RptFormulaUnsupportedError, RptReportStructureError };

package/dist/odb/formula/errors.d.ts

@@ -0,0 +1,21 @@
+//#region src/odb/formula/errors.d.ts
+declare class RptFormulaUnsupportedError extends Error {
+  readonly functionName: string;
+  readonly formula: string;
+  constructor(functionName: string, formula: string);
+}
+declare class RptFormulaParseError extends Error {
+  readonly formula: string;
+  readonly offset: number;
+  constructor(message: string, formula: string, offset: number);
+}
+declare class RptFormulaEvaluationError extends Error {
+  readonly formula: string;
+  constructor(message: string, formula: string);
+}
+declare class RptReportStructureError extends Error {
+  readonly reportName: string;
+  constructor(message: string, reportName: string);
+}
+//#endregion
+export { RptFormulaEvaluationError, RptFormulaParseError, RptFormulaUnsupportedError, RptReportStructureError };

package/dist/odb/formula/errors.js

@@ -0,0 +1,43 @@
+//#region src/odb/formula/errors.ts
+const MESSAGE_FORMULA_PREVIEW_LENGTH = 200;
+function truncateForMessage(formula) {
+	return formula.length > MESSAGE_FORMULA_PREVIEW_LENGTH ? `${formula.slice(0, MESSAGE_FORMULA_PREVIEW_LENGTH)}...` : formula;
+}
+var RptFormulaUnsupportedError = class extends Error {
+	functionName;
+	formula;
+	constructor(functionName, formula) {
+		super(`Report Builder formula: rpt:${functionName} is not supported by this bounded formula engine -- supported functions are HASCHANGED, LEFT, SUM, COUNT, AVG, MIN, MAX -- in formula: ${truncateForMessage(formula)}`);
+		this.name = "RptFormulaUnsupportedError";
+		this.functionName = functionName;
+		this.formula = formula;
+	}
+};
+var RptFormulaParseError = class extends Error {
+	formula;
+	offset;
+	constructor(message, formula, offset) {
+		super(`Report Builder formula parse error at offset ${String(offset)}: ${message} -- in formula: ${truncateForMessage(formula)}`);
+		this.name = "RptFormulaParseError";
+		this.formula = formula;
+		this.offset = offset;
+	}
+};
+var RptFormulaEvaluationError = class extends Error {
+	formula;
+	constructor(message, formula) {
+		super(`Report Builder formula evaluation error: ${message} -- in formula: ${truncateForMessage(formula)}`);
+		this.name = "RptFormulaEvaluationError";
+		this.formula = formula;
+	}
+};
+var RptReportStructureError = class extends Error {
+	reportName;
+	constructor(message, reportName) {
+		super(`Report Builder report structure error in report "${reportName}": ${message}`);
+		this.name = "RptReportStructureError";
+		this.reportName = reportName;
+	}
+};
+//#endregion
+export { RptFormulaEvaluationError, RptFormulaParseError, RptFormulaUnsupportedError, RptReportStructureError };