documents.js 1.63.0 → 1.65.0

package/dist/mathml/layout.cjs

@@ -37,7 +37,11 @@ function unsupported(ctx, element) {
 }
 function layoutToken(rawText, variant, ctx) {
 	const styled = require_mathml_variant.applyMathVariant(rawText, variant);
+	const nominalAscentPt = ctx.metrics.ascentPerEm * ctx.sizePt;
+	const nominalDescentPt = ctx.metrics.descentPerEm * ctx.sizePt;
 	let widthPt = 0;
+	let ascentPt = 0;
+	let descentPt = 0;
 	let text = "";
 	for (const ch of styled) {
 		const codePoint = ch.codePointAt(0);
@@ -52,10 +56,10 @@ function layoutToken(rawText, variant, ctx) {
 		}
 		text += ch;
 		widthPt += glyph.advanceWidthPt;
+		ascentPt = Math.max(ascentPt, glyph.inkAscentPt ?? nominalAscentPt);
+		descentPt = Math.max(descentPt, glyph.inkDescentPt ?? nominalDescentPt);
 	}
 	if (text.length === 0) return require_mathml_compose.EMPTY_BOX;
-	const ascentPt = ctx.metrics.ascentPerEm * ctx.sizePt;
-	const descentPt = ctx.metrics.descentPerEm * ctx.sizePt;
 	const items = [{
 		kind: "glyphs",
 		xPt: 0,
@@ -80,8 +84,63 @@ function tokenVariant(element, intrinsicDefault, ctx) {
 function miIntrinsicDefault(content) {
 	return [...content].length === 1 ? "italic" : "normal";
 }
+function isStretchyOperator(element) {
+	if (require_mathml_nodes.elementLocalName(element) !== "mo") return false;
+	if (require_mathml_nodes.attrValue(element, "stretchy") === "false") return false;
+	return require_mathml_operators.operatorProperties(require_mathml_nodes.textContent(element).trim()).stretchy;
+}
+function stretchedBox(result, text, ctx) {
+	const axisPt = ctx.metrics.axisHeightPt;
+	const inkHeightPt = result.inkAscentPt + result.inkDescentPt;
+	const originAboveBaselinePt = axisPt - (result.inkAscentPt - result.inkDescentPt) / 2;
+	const ascentPt = axisPt + inkHeightPt / 2;
+	const descentPt = inkHeightPt / 2 - axisPt;
+	const items = [{
+		kind: "assembled-glyphs",
+		placements: result.placements.map((placement) => ({
+			glyphId: placement.glyphId,
+			xPt: 0,
+			yPt: ascentPt - originAboveBaselinePt - placement.offsetPt
+		})),
+		text,
+		sizePt: ctx.sizePt,
+		color: ctx.color
+	}];
+	return {
+		widthPt: result.advanceWidthPt,
+		ascentPt,
+		descentPt,
+		heightPt: ascentPt + descentPt,
+		items
+	};
+}
+function stretchOperator(element, targetSizePt, ctx) {
+	const text = require_mathml_nodes.textContent(element).trim();
+	const codePoints = [...text];
+	if (codePoints.length !== 1) return;
+	const codePoint = codePoints[0]?.codePointAt(0);
+	if (codePoint === void 0) return;
+	const result = ctx.metrics.stretch(codePoint, "vertical", targetSizePt, ctx.sizePt);
+	if (result === void 0 || result.kind === "base") return;
+	return stretchedBox(result, text, ctx);
+}
+function stretchRowOperators(children, boxes, ctx) {
+	const stretchy = children.map(isStretchyOperator);
+	if (!stretchy.includes(true)) return boxes;
+	const others = boxes.filter((_, index) => stretchy[index] !== true);
+	if (others.length === 0) return boxes;
+	const axisPt = ctx.metrics.axisHeightPt;
+	const maxAscentPt = others.reduce((max, box) => Math.max(max, box.ascentPt), 0);
+	const maxDescentPt = others.reduce((max, box) => Math.max(max, box.descentPt), 0);
+	const targetSizePt = 2 * Math.max(maxAscentPt - axisPt, maxDescentPt + axisPt);
+	return boxes.map((box, index) => {
+		if (stretchy[index] !== true) return box;
+		const element = children[index];
+		return (element === void 0 ? void 0 : stretchOperator(element, targetSizePt, ctx)) ?? box;
+	});
+}
 function layoutRowChildren(children, ctx) {
-	const boxes = children.map((child) => layoutNode(child, ctx));
+	const boxes = stretchRowOperators(children, children.map((child) => layoutNode(child, ctx)), ctx);
 	const gapsPt = children.map((child, index) => {
 		if (index === 0) return 0;
 		const previous = children[index - 1];

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/layout.js

@@ -36,7 +36,11 @@ function unsupported(ctx, element) {
 }
 function layoutToken(rawText, variant, ctx) {
 	const styled = applyMathVariant(rawText, variant);
+	const nominalAscentPt = ctx.metrics.ascentPerEm * ctx.sizePt;
+	const nominalDescentPt = ctx.metrics.descentPerEm * ctx.sizePt;
 	let widthPt = 0;
+	let ascentPt = 0;
+	let descentPt = 0;
 	let text = "";
 	for (const ch of styled) {
 		const codePoint = ch.codePointAt(0);
@@ -51,10 +55,10 @@ function layoutToken(rawText, variant, ctx) {
 		}
 		text += ch;
 		widthPt += glyph.advanceWidthPt;
+		ascentPt = Math.max(ascentPt, glyph.inkAscentPt ?? nominalAscentPt);
+		descentPt = Math.max(descentPt, glyph.inkDescentPt ?? nominalDescentPt);
 	}
 	if (text.length === 0) return EMPTY_BOX;
-	const ascentPt = ctx.metrics.ascentPerEm * ctx.sizePt;
-	const descentPt = ctx.metrics.descentPerEm * ctx.sizePt;
 	const items = [{
 		kind: "glyphs",
 		xPt: 0,
@@ -79,8 +83,63 @@ function tokenVariant(element, intrinsicDefault, ctx) {
 function miIntrinsicDefault(content) {
 	return [...content].length === 1 ? "italic" : "normal";
 }
+function isStretchyOperator(element) {
+	if (elementLocalName(element) !== "mo") return false;
+	if (attrValue(element, "stretchy") === "false") return false;
+	return operatorProperties(textContent(element).trim()).stretchy;
+}
+function stretchedBox(result, text, ctx) {
+	const axisPt = ctx.metrics.axisHeightPt;
+	const inkHeightPt = result.inkAscentPt + result.inkDescentPt;
+	const originAboveBaselinePt = axisPt - (result.inkAscentPt - result.inkDescentPt) / 2;
+	const ascentPt = axisPt + inkHeightPt / 2;
+	const descentPt = inkHeightPt / 2 - axisPt;
+	const items = [{
+		kind: "assembled-glyphs",
+		placements: result.placements.map((placement) => ({
+			glyphId: placement.glyphId,
+			xPt: 0,
+			yPt: ascentPt - originAboveBaselinePt - placement.offsetPt
+		})),
+		text,
+		sizePt: ctx.sizePt,
+		color: ctx.color
+	}];
+	return {
+		widthPt: result.advanceWidthPt,
+		ascentPt,
+		descentPt,
+		heightPt: ascentPt + descentPt,
+		items
+	};
+}
+function stretchOperator(element, targetSizePt, ctx) {
+	const text = textContent(element).trim();
+	const codePoints = [...text];
+	if (codePoints.length !== 1) return;
+	const codePoint = codePoints[0]?.codePointAt(0);
+	if (codePoint === void 0) return;
+	const result = ctx.metrics.stretch(codePoint, "vertical", targetSizePt, ctx.sizePt);
+	if (result === void 0 || result.kind === "base") return;
+	return stretchedBox(result, text, ctx);
+}
+function stretchRowOperators(children, boxes, ctx) {
+	const stretchy = children.map(isStretchyOperator);
+	if (!stretchy.includes(true)) return boxes;
+	const others = boxes.filter((_, index) => stretchy[index] !== true);
+	if (others.length === 0) return boxes;
+	const axisPt = ctx.metrics.axisHeightPt;
+	const maxAscentPt = others.reduce((max, box) => Math.max(max, box.ascentPt), 0);
+	const maxDescentPt = others.reduce((max, box) => Math.max(max, box.descentPt), 0);
+	const targetSizePt = 2 * Math.max(maxAscentPt - axisPt, maxDescentPt + axisPt);
+	return boxes.map((box, index) => {
+		if (stretchy[index] !== true) return box;
+		const element = children[index];
+		return (element === void 0 ? void 0 : stretchOperator(element, targetSizePt, ctx)) ?? box;
+	});
+}
 function layoutRowChildren(children, ctx) {
-	const boxes = children.map((child) => layoutNode(child, ctx));
+	const boxes = stretchRowOperators(children, children.map((child) => layoutNode(child, ctx)), ctx);
 	const gapsPt = children.map((child, index) => {
 		if (index === 0) return 0;
 		const previous = children[index - 1];

package/dist/mathml/metrics.d.cts

@@ -3,6 +3,21 @@ interface MathGlyphMetrics {
   readonly advanceWidthPt: number;
   readonly italicCorrectionPt: number;
   readonly topAccentXPt?: number;
+  readonly inkAscentPt?: number;
+  readonly inkDescentPt?: number;
+}
+type MathStretchAxis = 'vertical' | 'horizontal';
+interface MathStretchGlyph {
+  readonly glyphId: number;
+  readonly offsetPt: number;
+}
+interface MathStretchResult {
+  readonly kind: 'base' | 'variant' | 'assembly';
+  readonly sizePt: number;
+  readonly advanceWidthPt: number;
+  readonly inkAscentPt: number;
+  readonly inkDescentPt: number;
+  readonly placements: readonly MathStretchGlyph[];
 }
 interface MathFontMetrics {
   readonly ascentPerEm: number;
@@ -39,6 +54,7 @@ interface MathFontMetrics {
   readonly scriptScriptPercentScaleDown: number;
   readonly defaultRuleThicknessPt: number;
   glyph(codePoint: number, sizePt: number): MathGlyphMetrics | undefined;
+  stretch(codePoint: number, axis: MathStretchAxis, targetSizePt: number, sizePt: number): MathStretchResult | undefined;
 }
 //#endregion
-export { MathFontMetrics, MathGlyphMetrics };
+export { MathFontMetrics, MathGlyphMetrics, MathStretchAxis, MathStretchGlyph, MathStretchResult };

package/dist/mathml/metrics.d.ts

@@ -3,6 +3,21 @@ interface MathGlyphMetrics {
   readonly advanceWidthPt: number;
   readonly italicCorrectionPt: number;
   readonly topAccentXPt?: number;
+  readonly inkAscentPt?: number;
+  readonly inkDescentPt?: number;
+}
+type MathStretchAxis = 'vertical' | 'horizontal';
+interface MathStretchGlyph {
+  readonly glyphId: number;
+  readonly offsetPt: number;
+}
+interface MathStretchResult {
+  readonly kind: 'base' | 'variant' | 'assembly';
+  readonly sizePt: number;
+  readonly advanceWidthPt: number;
+  readonly inkAscentPt: number;
+  readonly inkDescentPt: number;
+  readonly placements: readonly MathStretchGlyph[];
 }
 interface MathFontMetrics {
   readonly ascentPerEm: number;
@@ -39,6 +54,7 @@ interface MathFontMetrics {
   readonly scriptScriptPercentScaleDown: number;
   readonly defaultRuleThicknessPt: number;
   glyph(codePoint: number, sizePt: number): MathGlyphMetrics | undefined;
+  stretch(codePoint: number, axis: MathStretchAxis, targetSizePt: number, sizePt: number): MathStretchResult | undefined;
 }
 //#endregion
-export { MathFontMetrics, MathGlyphMetrics };
+export { MathFontMetrics, MathGlyphMetrics, MathStretchAxis, MathStretchGlyph, MathStretchResult };

package/dist/mathml/operators.cjs

@@ -51,7 +51,7 @@ function bigOperatorMovable() {
 		rspaceEm: THIN_SPACE,
 		largeop: true,
 		movablelimits: true,
-		stretchy: true
+		stretchy: false
 	};
 }
 function bigOperatorFixed() {

package/dist/mathml/operators.js

@@ -50,7 +50,7 @@ function bigOperatorMovable() {
 		rspaceEm: THIN_SPACE,
 		largeop: true,
 		movablelimits: true,
-		stretchy: true
+		stretchy: false
 	};
 }
 function bigOperatorFixed() {

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 };