js.documents 14.1.0 → 14.2.0

package/dist/odb/read.cjs

@@ -8,7 +8,7 @@ let odf_js = require("odf.js");
 var OdbNoEmbeddedDataSourceError = class extends Error {
 	url;
 	constructor(url) {
-		super(url === void 0 ? "readOdbTables: this .odb package has no embedded data source -- its office:database has no db:data-source/db:connection-data at all, so embedded vs external cannot be determined" : `readOdbTables: this .odb package has no embedded data source -- its connection ("${url}") points at an external datasource (MySQL/PostgreSQL/JDBC/ODBC or similar), which is permanently out of scope for readOdbTables`);
+		super(url === void 0 ? "readOdbTables: this .odb package has no embedded data source — its office:database has no db:data-source/db:connection-data at all, so embedded vs external cannot be determined" : `readOdbTables: this .odb package has no embedded data source — its connection ("${url}") points at an external datasource (MySQL/PostgreSQL/JDBC/ODBC or similar), which is permanently out of scope for readOdbTables`);
 		this.name = "OdbNoEmbeddedDataSourceError";
 		this.url = url;
 	}
@@ -53,17 +53,17 @@ function readOdbTables(pkg, options) {
 	const engine = url.slice(14);
 	if (engine === "firebird") {
 		const firebirdPart = pkg.parts[DATABASE_FIREBIRD_PART];
-		if (firebirdPart === void 0) throw new OdbUnsupportedFormatError("unrecognised-engine", `an embedded Firebird engine with no ${DATABASE_FIREBIRD_PART} part -- an unrecognised embedded storage shape`);
-		if (firebirdPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_FIREBIRD_PART} is not a binary part (found kind "${firebirdPart.kind}") -- malformed .odb package`);
+		if (firebirdPart === void 0) throw new OdbUnsupportedFormatError("unrecognised-engine", `an embedded Firebird engine with no ${DATABASE_FIREBIRD_PART} part — an unrecognised embedded storage shape`);
+		if (firebirdPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_FIREBIRD_PART} is not a binary part (found kind "${firebirdPart.kind}") — malformed .odb package`);
 		const backupBytes = (0, odf_js.base64ToBytes)(firebirdPart.base64);
 		return require_firebird_backup.readFirebirdBackup(backupBytes).tables;
 	}
 	if (engine !== "hsqldb") throw new OdbUnsupportedFormatError("unrecognised-engine", `the embedded "${engine}" database engine`);
 	const manifestEntry = (0, odf_js.readManifest)(pkg).entries.find((entry) => entry.fullPath === DATABASE_SCRIPT_PART);
-	if (manifestEntry !== void 0 && isXmlMediaType(manifestEntry.mediaType)) throw new Error(`readOdbTables: ${DATABASE_SCRIPT_PART} is declared as an XML sub-document in the manifest (media type "${manifestEntry.mediaType}") -- not a recognised HSQLDB script part`);
+	if (manifestEntry !== void 0 && isXmlMediaType(manifestEntry.mediaType)) throw new Error(`readOdbTables: ${DATABASE_SCRIPT_PART} is declared as an XML sub-document in the manifest (media type "${manifestEntry.mediaType}") — not a recognised HSQLDB script part`);
 	const scriptPart = pkg.parts[DATABASE_SCRIPT_PART];
-	if (scriptPart === void 0) throw new OdbUnsupportedFormatError("unrecognised-engine", `an embedded HSQLDB engine with no ${DATABASE_SCRIPT_PART} part -- an unrecognised embedded storage shape`);
-	if (scriptPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_SCRIPT_PART} is not a binary part (found kind "${scriptPart.kind}") -- malformed .odb package`);
+	if (scriptPart === void 0) throw new OdbUnsupportedFormatError("unrecognised-engine", `an embedded HSQLDB engine with no ${DATABASE_SCRIPT_PART} part — an unrecognised embedded storage shape`);
+	if (scriptPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_SCRIPT_PART} is not a binary part (found kind "${scriptPart.kind}") — malformed .odb package`);
 	const scriptBytes = (0, odf_js.base64ToBytes)(scriptPart.base64);
 	const classification = classifyScriptBytes(scriptBytes);
 	if (classification !== "text") {
@@ -77,10 +77,10 @@ function readOdbTables(pkg, options) {
 function withCachedTableRows(pkg, tables, scriptText, options) {
 	const dataPart = pkg.parts[DATABASE_DATA_PART];
 	if (dataPart === void 0) return tables;
-	if (dataPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_DATA_PART} is not a binary part (found kind "${dataPart.kind}") -- malformed .odb package`);
+	if (dataPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_DATA_PART} is not a binary part (found kind "${dataPart.kind}") — malformed .odb package`);
 	const propertiesPart = pkg.parts[DATABASE_PROPERTIES_PART];
-	if (propertiesPart === void 0) throw new Error(`readOdbTables: ${DATABASE_DATA_PART} is present but ${DATABASE_PROPERTIES_PART} is not -- malformed .odb package (a CACHED-table row store always ships alongside its own properties file, which this decoder needs for the cache file's own scale)`);
-	if (propertiesPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_PROPERTIES_PART} is not a binary part (found kind "${propertiesPart.kind}") -- malformed .odb package`);
+	if (propertiesPart === void 0) throw new Error(`readOdbTables: ${DATABASE_DATA_PART} is present but ${DATABASE_PROPERTIES_PART} is not — malformed .odb package (a CACHED-table row store always ships alongside its own properties file, which this decoder needs for the cache file's own scale)`);
+	if (propertiesPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_PROPERTIES_PART} is not a binary part (found kind "${propertiesPart.kind}") — malformed .odb package`);
 	const dataBytes = (0, odf_js.base64ToBytes)(dataPart.base64);
 	const propertiesText = new TextDecoder("utf-8", { fatal: true }).decode((0, odf_js.base64ToBytes)(propertiesPart.base64));
 	return require_hsqldb_cache.decodeHsqldbCachedTables(tables, scriptText, dataBytes, propertiesText, options);

package/dist/odb/read.js

@@ -7,7 +7,7 @@ import { base64ToBytes, readManifest, readOdbInventory } from "odf.js";
 var OdbNoEmbeddedDataSourceError = class extends Error {
 	url;
 	constructor(url) {
-		super(url === void 0 ? "readOdbTables: this .odb package has no embedded data source -- its office:database has no db:data-source/db:connection-data at all, so embedded vs external cannot be determined" : `readOdbTables: this .odb package has no embedded data source -- its connection ("${url}") points at an external datasource (MySQL/PostgreSQL/JDBC/ODBC or similar), which is permanently out of scope for readOdbTables`);
+		super(url === void 0 ? "readOdbTables: this .odb package has no embedded data source — its office:database has no db:data-source/db:connection-data at all, so embedded vs external cannot be determined" : `readOdbTables: this .odb package has no embedded data source — its connection ("${url}") points at an external datasource (MySQL/PostgreSQL/JDBC/ODBC or similar), which is permanently out of scope for readOdbTables`);
 		this.name = "OdbNoEmbeddedDataSourceError";
 		this.url = url;
 	}
@@ -52,17 +52,17 @@ function readOdbTables(pkg, options) {
 	const engine = url.slice(14);
 	if (engine === "firebird") {
 		const firebirdPart = pkg.parts[DATABASE_FIREBIRD_PART];
-		if (firebirdPart === void 0) throw new OdbUnsupportedFormatError("unrecognised-engine", `an embedded Firebird engine with no ${DATABASE_FIREBIRD_PART} part -- an unrecognised embedded storage shape`);
-		if (firebirdPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_FIREBIRD_PART} is not a binary part (found kind "${firebirdPart.kind}") -- malformed .odb package`);
+		if (firebirdPart === void 0) throw new OdbUnsupportedFormatError("unrecognised-engine", `an embedded Firebird engine with no ${DATABASE_FIREBIRD_PART} part — an unrecognised embedded storage shape`);
+		if (firebirdPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_FIREBIRD_PART} is not a binary part (found kind "${firebirdPart.kind}") — malformed .odb package`);
 		const backupBytes = base64ToBytes(firebirdPart.base64);
 		return readFirebirdBackup(backupBytes).tables;
 	}
 	if (engine !== "hsqldb") throw new OdbUnsupportedFormatError("unrecognised-engine", `the embedded "${engine}" database engine`);
 	const manifestEntry = readManifest(pkg).entries.find((entry) => entry.fullPath === DATABASE_SCRIPT_PART);
-	if (manifestEntry !== void 0 && isXmlMediaType(manifestEntry.mediaType)) throw new Error(`readOdbTables: ${DATABASE_SCRIPT_PART} is declared as an XML sub-document in the manifest (media type "${manifestEntry.mediaType}") -- not a recognised HSQLDB script part`);
+	if (manifestEntry !== void 0 && isXmlMediaType(manifestEntry.mediaType)) throw new Error(`readOdbTables: ${DATABASE_SCRIPT_PART} is declared as an XML sub-document in the manifest (media type "${manifestEntry.mediaType}") — not a recognised HSQLDB script part`);
 	const scriptPart = pkg.parts[DATABASE_SCRIPT_PART];
-	if (scriptPart === void 0) throw new OdbUnsupportedFormatError("unrecognised-engine", `an embedded HSQLDB engine with no ${DATABASE_SCRIPT_PART} part -- an unrecognised embedded storage shape`);
-	if (scriptPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_SCRIPT_PART} is not a binary part (found kind "${scriptPart.kind}") -- malformed .odb package`);
+	if (scriptPart === void 0) throw new OdbUnsupportedFormatError("unrecognised-engine", `an embedded HSQLDB engine with no ${DATABASE_SCRIPT_PART} part — an unrecognised embedded storage shape`);
+	if (scriptPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_SCRIPT_PART} is not a binary part (found kind "${scriptPart.kind}") — malformed .odb package`);
 	const scriptBytes = base64ToBytes(scriptPart.base64);
 	const classification = classifyScriptBytes(scriptBytes);
 	if (classification !== "text") {
@@ -76,10 +76,10 @@ function readOdbTables(pkg, options) {
 function withCachedTableRows(pkg, tables, scriptText, options) {
 	const dataPart = pkg.parts[DATABASE_DATA_PART];
 	if (dataPart === void 0) return tables;
-	if (dataPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_DATA_PART} is not a binary part (found kind "${dataPart.kind}") -- malformed .odb package`);
+	if (dataPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_DATA_PART} is not a binary part (found kind "${dataPart.kind}") — malformed .odb package`);
 	const propertiesPart = pkg.parts[DATABASE_PROPERTIES_PART];
-	if (propertiesPart === void 0) throw new Error(`readOdbTables: ${DATABASE_DATA_PART} is present but ${DATABASE_PROPERTIES_PART} is not -- malformed .odb package (a CACHED-table row store always ships alongside its own properties file, which this decoder needs for the cache file's own scale)`);
-	if (propertiesPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_PROPERTIES_PART} is not a binary part (found kind "${propertiesPart.kind}") -- malformed .odb package`);
+	if (propertiesPart === void 0) throw new Error(`readOdbTables: ${DATABASE_DATA_PART} is present but ${DATABASE_PROPERTIES_PART} is not — malformed .odb package (a CACHED-table row store always ships alongside its own properties file, which this decoder needs for the cache file's own scale)`);
+	if (propertiesPart.kind !== "binary") throw new Error(`readOdbTables: ${DATABASE_PROPERTIES_PART} is not a binary part (found kind "${propertiesPart.kind}") — malformed .odb package`);
 	const dataBytes = base64ToBytes(dataPart.base64);
 	const propertiesText = new TextDecoder("utf-8", { fatal: true }).decode(base64ToBytes(propertiesPart.base64));
 	return decodeHsqldbCachedTables(tables, scriptText, dataBytes, propertiesText, options);

package/dist/odb/report/content.cjs

@@ -6,7 +6,7 @@ let odf_js = require("odf.js");
 var OdbReportNotSpecifiedError = class extends Error {
 	availableReports;
 	constructor(availableReports) {
-		super(availableReports.length === 0 ? "readOdbReportContent: this .odb declares no reports at all" : `readOdbReportContent: this .odb declares more than one report (${availableReports.join(", ")}) -- pass { report: '<name>' } to select one`);
+		super(availableReports.length === 0 ? "readOdbReportContent: this .odb declares no reports at all" : `readOdbReportContent: this .odb declares more than one report (${availableReports.join(", ")}) — pass { report: '<name>' } to select one`);
 		this.name = "OdbReportNotSpecifiedError";
 		this.availableReports = availableReports;
 	}

package/dist/odb/report/content.js

@@ -5,7 +5,7 @@ import { readOdbInventory, readOdbReport } from "odf.js";
 var OdbReportNotSpecifiedError = class extends Error {
 	availableReports;
 	constructor(availableReports) {
-		super(availableReports.length === 0 ? "readOdbReportContent: this .odb declares no reports at all" : `readOdbReportContent: this .odb declares more than one report (${availableReports.join(", ")}) -- pass { report: '<name>' } to select one`);
+		super(availableReports.length === 0 ? "readOdbReportContent: this .odb declares no reports at all" : `readOdbReportContent: this .odb declares more than one report (${availableReports.join(", ")}) — pass { report: '<name>' } to select one`);
 		this.name = "OdbReportNotSpecifiedError";
 		this.availableReports = availableReports;
 	}

package/dist/odb/report/render.cjs

@@ -56,7 +56,7 @@ function bandTable(band) {
 	const columnWidthPt = CONTENT_WIDTH_PT / band.elements.length;
 	return {
 		kind: "table",
-		columnWidthsPt: band.elements.map(() => columnWidthPt),
+		columns: band.elements.map(() => ({ widthPt: columnWidthPt })),
 		rows: [{ cells: band.elements.map((element, index) => ({ blocks: [cellParagraph(element, band.values[index], band.styleId)] })) }]
 	};
 }

package/dist/odb/report/render.js

@@ -55,7 +55,7 @@ function bandTable(band) {
 	const columnWidthPt = CONTENT_WIDTH_PT / band.elements.length;
 	return {
 		kind: "table",
-		columnWidthsPt: band.elements.map(() => columnWidthPt),
+		columns: band.elements.map(() => ({ widthPt: columnWidthPt })),
 		rows: [{ cells: band.elements.map((element, index) => ({ blocks: [cellParagraph(element, band.values[index], band.styleId)] })) }]
 	};
 }

package/dist/odb/report/source.cjs

@@ -21,7 +21,7 @@ function quotedIdentifier(name) {
 }
 function savedQueryCommand(report, commandName, queries) {
 	const query = queries.find((candidate) => candidate.name === commandName);
-	if (query === void 0) throw new OdbReportDataSourceError(`rpt:command-type is "query" and rpt:command names "${commandName}", but this .odb declares no such saved query -- available quer${queries.length === 1 ? "y" : "ies"}: ${queries.length === 0 ? "(none)" : queries.map((candidate) => candidate.name).join(", ")}`, report);
+	if (query === void 0) throw new OdbReportDataSourceError(`rpt:command-type is "query" and rpt:command names "${commandName}", but this .odb declares no such saved query — available quer${queries.length === 1 ? "y" : "ies"}: ${queries.length === 0 ? "(none)" : queries.map((candidate) => candidate.name).join(", ")}`, report);
 	return query.command;
 }
 function odbReportCommandSql(report, queries) {

package/dist/odb/report/source.js

@@ -20,7 +20,7 @@ function quotedIdentifier(name) {
 }
 function savedQueryCommand(report, commandName, queries) {
 	const query = queries.find((candidate) => candidate.name === commandName);
-	if (query === void 0) throw new OdbReportDataSourceError(`rpt:command-type is "query" and rpt:command names "${commandName}", but this .odb declares no such saved query -- available quer${queries.length === 1 ? "y" : "ies"}: ${queries.length === 0 ? "(none)" : queries.map((candidate) => candidate.name).join(", ")}`, report);
+	if (query === void 0) throw new OdbReportDataSourceError(`rpt:command-type is "query" and rpt:command names "${commandName}", but this .odb declares no such saved query — available quer${queries.length === 1 ? "y" : "ies"}: ${queries.length === 0 ? "(none)" : queries.map((candidate) => candidate.name).join(", ")}`, report);
 	return query.command;
 }
 function odbReportCommandSql(report, queries) {

package/dist/odb/sql/errors.cjs

@@ -8,7 +8,7 @@ var HsqldbSqlUnsupportedError = class extends Error {
 	construct;
 	sql;
 	constructor(construct, sql) {
-		super(`HSQLDB SQL: ${construct} is not supported by this bounded query engine -- in statement: ${truncateForMessage(sql)}`);
+		super(`HSQLDB SQL: ${construct} is not supported by this bounded query engine — in statement: ${truncateForMessage(sql)}`);
 		this.name = "HsqldbSqlUnsupportedError";
 		this.construct = construct;
 		this.sql = sql;
@@ -18,7 +18,7 @@ var HsqldbSqlParseError = class extends Error {
 	sql;
 	offset;
 	constructor(message, sql, offset) {
-		super(`HSQLDB SQL parse error at offset ${String(offset)}: ${message} -- in statement: ${truncateForMessage(sql)}`);
+		super(`HSQLDB SQL parse error at offset ${String(offset)}: ${message} — in statement: ${truncateForMessage(sql)}`);
 		this.name = "HsqldbSqlParseError";
 		this.sql = sql;
 		this.offset = offset;
@@ -27,7 +27,7 @@ var HsqldbSqlParseError = class extends Error {
 var HsqldbSqlEvaluationError = class extends Error {
 	sql;
 	constructor(message, sql) {
-		super(`HSQLDB SQL evaluation error: ${message} -- in statement: ${truncateForMessage(sql)}`);
+		super(`HSQLDB SQL evaluation error: ${message} — in statement: ${truncateForMessage(sql)}`);
 		this.name = "HsqldbSqlEvaluationError";
 		this.sql = sql;
 	}

package/dist/odb/sql/errors.js

@@ -7,7 +7,7 @@ var HsqldbSqlUnsupportedError = class extends Error {
 	construct;
 	sql;
 	constructor(construct, sql) {
-		super(`HSQLDB SQL: ${construct} is not supported by this bounded query engine -- in statement: ${truncateForMessage(sql)}`);
+		super(`HSQLDB SQL: ${construct} is not supported by this bounded query engine — in statement: ${truncateForMessage(sql)}`);
 		this.name = "HsqldbSqlUnsupportedError";
 		this.construct = construct;
 		this.sql = sql;
@@ -17,7 +17,7 @@ var HsqldbSqlParseError = class extends Error {
 	sql;
 	offset;
 	constructor(message, sql, offset) {
-		super(`HSQLDB SQL parse error at offset ${String(offset)}: ${message} -- in statement: ${truncateForMessage(sql)}`);
+		super(`HSQLDB SQL parse error at offset ${String(offset)}: ${message} — in statement: ${truncateForMessage(sql)}`);
 		this.name = "HsqldbSqlParseError";
 		this.sql = sql;
 		this.offset = offset;
@@ -26,7 +26,7 @@ var HsqldbSqlParseError = class extends Error {
 var HsqldbSqlEvaluationError = class extends Error {
 	sql;
 	constructor(message, sql) {
-		super(`HSQLDB SQL evaluation error: ${message} -- in statement: ${truncateForMessage(sql)}`);
+		super(`HSQLDB SQL evaluation error: ${message} — in statement: ${truncateForMessage(sql)}`);
 		this.name = "HsqldbSqlEvaluationError";
 		this.sql = sql;
 	}

package/dist/odb/sql/evaluate.cjs

@@ -59,7 +59,7 @@ function tryResolveName(candidates, ref, what, sql) {
 	if (exact !== void 0) return exact;
 	if (!ref.quoted) {
 		const folded = candidates.filter((candidate) => candidate.toUpperCase() === ref.name);
-		if (folded.length > 1) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`${what} "${ref.name}" is ambiguous -- it matches ${folded.join(", ")} case-insensitively`, sql);
+		if (folded.length > 1) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`${what} "${ref.name}" is ambiguous—it matches ${folded.join(", ")} case-insensitively`, sql);
 		const only = folded[0];
 		if (only !== void 0) return only;
 	}
@@ -67,7 +67,7 @@ function tryResolveName(candidates, ref, what, sql) {
 function resolveName(candidates, ref, what, sql) {
 	const found = tryResolveName(candidates, ref, what, sql);
 	if (found !== void 0) return found;
-	throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`${what} "${ref.name}" not found -- available: ${candidates.length === 0 ? "(none)" : candidates.join(", ")}`, sql);
+	throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`${what} "${ref.name}" not found—available: ${candidates.length === 0 ? "(none)" : candidates.join(", ")}`, sql);
 }
 function resolveTable(tables, ref, sql) {
 	const resolvedName = resolveName(tables.map((table) => table.tableName), ref, "table", sql);
@@ -92,7 +92,7 @@ function tryResolveColumnIndex(columns, candidateIndices, ref, sql) {
 		exactCount += 1;
 		firstExact ??= index;
 	}
-	if (exactCount > 1) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`column "${ref.name}" is ambiguous -- it matches more than one joined column named "${ref.name}"`, sql);
+	if (exactCount > 1) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`column "${ref.name}" is ambiguous—it matches more than one joined column named "${ref.name}"`, sql);
 	if (firstExact !== void 0) return firstExact;
 	if (!ref.quoted) {
 		let firstFolded;
@@ -103,14 +103,14 @@ function tryResolveColumnIndex(columns, candidateIndices, ref, sql) {
 			foldedNames.push(name);
 			firstFolded ??= index;
 		}
-		if (foldedNames.length > 1) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`column "${ref.name}" is ambiguous -- it matches ${foldedNames.join(", ")} case-insensitively`, sql);
+		if (foldedNames.length > 1) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`column "${ref.name}" is ambiguous—it matches ${foldedNames.join(", ")} case-insensitively`, sql);
 		if (firstFolded !== void 0) return firstFolded;
 	}
 }
 function resolveColumnIndex(columns, candidateIndices, ref, sql) {
 	const index = tryResolveColumnIndex(columns, candidateIndices, ref, sql);
 	if (index !== void 0) return index;
-	throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`column "${ref.name}" not found -- available: ${candidateIndices.length === 0 ? "(none)" : candidateIndices.map((index) => columns[index]?.columnName ?? "?").join(", ")}`, sql);
+	throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`column "${ref.name}" not found—available: ${candidateIndices.length === 0 ? "(none)" : candidateIndices.map((index) => columns[index]?.columnName ?? "?").join(", ")}`, sql);
 }
 var ColumnResolver = class {
 	sql;
@@ -351,14 +351,14 @@ function partitionIntoGroups(rows, groupIndices, resolver) {
 }
 function evaluateGrouped(statement, plan, matching, resolver) {
 	const groupIndices = statement.groupBy.map((ref) => resolver.indexOf(ref));
-	for (const item of plan) if (item.kind === "column" && !groupIndices.includes(item.index)) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`column "${item.text}" is neither grouped nor aggregated -- add it to GROUP BY or wrap it in an aggregate`, statement.sql);
+	for (const item of plan) if (item.kind === "column" && !groupIndices.includes(item.index)) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`column "${item.text}" is neither grouped nor aggregated—add it to GROUP BY or wrap it in an aggregate`, statement.sql);
 	const groups = groupIndices.length === 0 ? [{
 		keyValues: [],
 		rows: [...matching]
 	}] : partitionIntoGroups(matching, groupIndices, resolver);
 	const orderPositions = statement.orderBy.map((term) => {
 		const position = groupIndices.indexOf(resolver.indexOf(term.column));
-		if (position < 0) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`ORDER BY column "${term.column.text}" is not a GROUP BY column -- a grouped result has no single value for it`, statement.sql);
+		if (position < 0) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`ORDER BY column "${term.column.text}" is not a GROUP BY column—a grouped result has no single value for it`, statement.sql);
 		return position;
 	});
 	const sortable = groups.map((group) => ({
@@ -407,7 +407,7 @@ function computeNaturalSharedPairs(leftColumns, rightColumns, sql) {
 	leftColumns.forEach((leftColumn, leftIndex) => {
 		const rightIndex = rightIndexByName.get(leftColumn.columnName);
 		if (rightIndex === void 0) return;
-		if (ambiguousRightNames.has(leftColumn.columnName) || seenNames.has(leftColumn.columnName)) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`NATURAL JOIN cannot determine a unique match for column "${leftColumn.columnName}" -- more than one column shares that name on one side of the join`, sql);
+		if (ambiguousRightNames.has(leftColumn.columnName) || seenNames.has(leftColumn.columnName)) throw new require_odb_sql_errors.HsqldbSqlEvaluationError(`NATURAL JOIN cannot determine a unique match for column "${leftColumn.columnName}"—more than one column shares that name on one side of the join`, sql);
 		seenNames.add(leftColumn.columnName);
 		pairs.push({
 			leftIndex,
@@ -530,7 +530,7 @@ function evaluateSelectInScope(statement, tables, outer) {
 	const matching = where === void 0 ? rows : rows.filter((row) => evaluatePredicate(where, row, resolver, tables, statement.sql) === "true");
 	const hasAggregate = plan.some((item) => item.kind === "aggregate");
 	if (statement.groupBy.length > 0 || hasAggregate) {
-		if (statement.groupBy.length > 0 && statement.items.some((item) => item.kind === "star")) throw new require_odb_sql_errors.HsqldbSqlEvaluationError("SELECT * is not valid with GROUP BY -- name the grouped columns and the aggregates explicitly", statement.sql);
+		if (statement.groupBy.length > 0 && statement.items.some((item) => item.kind === "star")) throw new require_odb_sql_errors.HsqldbSqlEvaluationError("SELECT * is not valid with GROUP BY—name the grouped columns and the aggregates explicitly", statement.sql);
 		return evaluateGrouped(statement, plan, matching, resolver);
 	}
 	return evaluateUngrouped(statement, plan, matching, resolver);

package/dist/odb/sql/evaluate.js

@@ -58,7 +58,7 @@ function tryResolveName(candidates, ref, what, sql) {
 	if (exact !== void 0) return exact;
 	if (!ref.quoted) {
 		const folded = candidates.filter((candidate) => candidate.toUpperCase() === ref.name);
-		if (folded.length > 1) throw new HsqldbSqlEvaluationError(`${what} "${ref.name}" is ambiguous -- it matches ${folded.join(", ")} case-insensitively`, sql);
+		if (folded.length > 1) throw new HsqldbSqlEvaluationError(`${what} "${ref.name}" is ambiguous—it matches ${folded.join(", ")} case-insensitively`, sql);
 		const only = folded[0];
 		if (only !== void 0) return only;
 	}
@@ -66,7 +66,7 @@ function tryResolveName(candidates, ref, what, sql) {
 function resolveName(candidates, ref, what, sql) {
 	const found = tryResolveName(candidates, ref, what, sql);
 	if (found !== void 0) return found;
-	throw new HsqldbSqlEvaluationError(`${what} "${ref.name}" not found -- available: ${candidates.length === 0 ? "(none)" : candidates.join(", ")}`, sql);
+	throw new HsqldbSqlEvaluationError(`${what} "${ref.name}" not found—available: ${candidates.length === 0 ? "(none)" : candidates.join(", ")}`, sql);
 }
 function resolveTable(tables, ref, sql) {
 	const resolvedName = resolveName(tables.map((table) => table.tableName), ref, "table", sql);
@@ -91,7 +91,7 @@ function tryResolveColumnIndex(columns, candidateIndices, ref, sql) {
 		exactCount += 1;
 		firstExact ??= index;
 	}
-	if (exactCount > 1) throw new HsqldbSqlEvaluationError(`column "${ref.name}" is ambiguous -- it matches more than one joined column named "${ref.name}"`, sql);
+	if (exactCount > 1) throw new HsqldbSqlEvaluationError(`column "${ref.name}" is ambiguous—it matches more than one joined column named "${ref.name}"`, sql);
 	if (firstExact !== void 0) return firstExact;
 	if (!ref.quoted) {
 		let firstFolded;
@@ -102,14 +102,14 @@ function tryResolveColumnIndex(columns, candidateIndices, ref, sql) {
 			foldedNames.push(name);
 			firstFolded ??= index;
 		}
-		if (foldedNames.length > 1) throw new HsqldbSqlEvaluationError(`column "${ref.name}" is ambiguous -- it matches ${foldedNames.join(", ")} case-insensitively`, sql);
+		if (foldedNames.length > 1) throw new HsqldbSqlEvaluationError(`column "${ref.name}" is ambiguous—it matches ${foldedNames.join(", ")} case-insensitively`, sql);
 		if (firstFolded !== void 0) return firstFolded;
 	}
 }
 function resolveColumnIndex(columns, candidateIndices, ref, sql) {
 	const index = tryResolveColumnIndex(columns, candidateIndices, ref, sql);
 	if (index !== void 0) return index;
-	throw new HsqldbSqlEvaluationError(`column "${ref.name}" not found -- available: ${candidateIndices.length === 0 ? "(none)" : candidateIndices.map((index) => columns[index]?.columnName ?? "?").join(", ")}`, sql);
+	throw new HsqldbSqlEvaluationError(`column "${ref.name}" not found—available: ${candidateIndices.length === 0 ? "(none)" : candidateIndices.map((index) => columns[index]?.columnName ?? "?").join(", ")}`, sql);
 }
 var ColumnResolver = class {
 	sql;
@@ -350,14 +350,14 @@ function partitionIntoGroups(rows, groupIndices, resolver) {
 }
 function evaluateGrouped(statement, plan, matching, resolver) {
 	const groupIndices = statement.groupBy.map((ref) => resolver.indexOf(ref));
-	for (const item of plan) if (item.kind === "column" && !groupIndices.includes(item.index)) throw new HsqldbSqlEvaluationError(`column "${item.text}" is neither grouped nor aggregated -- add it to GROUP BY or wrap it in an aggregate`, statement.sql);
+	for (const item of plan) if (item.kind === "column" && !groupIndices.includes(item.index)) throw new HsqldbSqlEvaluationError(`column "${item.text}" is neither grouped nor aggregated—add it to GROUP BY or wrap it in an aggregate`, statement.sql);
 	const groups = groupIndices.length === 0 ? [{
 		keyValues: [],
 		rows: [...matching]
 	}] : partitionIntoGroups(matching, groupIndices, resolver);
 	const orderPositions = statement.orderBy.map((term) => {
 		const position = groupIndices.indexOf(resolver.indexOf(term.column));
-		if (position < 0) throw new HsqldbSqlEvaluationError(`ORDER BY column "${term.column.text}" is not a GROUP BY column -- a grouped result has no single value for it`, statement.sql);
+		if (position < 0) throw new HsqldbSqlEvaluationError(`ORDER BY column "${term.column.text}" is not a GROUP BY column—a grouped result has no single value for it`, statement.sql);
 		return position;
 	});
 	const sortable = groups.map((group) => ({
@@ -406,7 +406,7 @@ function computeNaturalSharedPairs(leftColumns, rightColumns, sql) {
 	leftColumns.forEach((leftColumn, leftIndex) => {
 		const rightIndex = rightIndexByName.get(leftColumn.columnName);
 		if (rightIndex === void 0) return;
-		if (ambiguousRightNames.has(leftColumn.columnName) || seenNames.has(leftColumn.columnName)) throw new HsqldbSqlEvaluationError(`NATURAL JOIN cannot determine a unique match for column "${leftColumn.columnName}" -- more than one column shares that name on one side of the join`, sql);
+		if (ambiguousRightNames.has(leftColumn.columnName) || seenNames.has(leftColumn.columnName)) throw new HsqldbSqlEvaluationError(`NATURAL JOIN cannot determine a unique match for column "${leftColumn.columnName}"—more than one column shares that name on one side of the join`, sql);
 		seenNames.add(leftColumn.columnName);
 		pairs.push({
 			leftIndex,
@@ -529,7 +529,7 @@ function evaluateSelectInScope(statement, tables, outer) {
 	const matching = where === void 0 ? rows : rows.filter((row) => evaluatePredicate(where, row, resolver, tables, statement.sql) === "true");
 	const hasAggregate = plan.some((item) => item.kind === "aggregate");
 	if (statement.groupBy.length > 0 || hasAggregate) {
-		if (statement.groupBy.length > 0 && statement.items.some((item) => item.kind === "star")) throw new HsqldbSqlEvaluationError("SELECT * is not valid with GROUP BY -- name the grouped columns and the aggregates explicitly", statement.sql);
+		if (statement.groupBy.length > 0 && statement.items.some((item) => item.kind === "star")) throw new HsqldbSqlEvaluationError("SELECT * is not valid with GROUP BY—name the grouped columns and the aggregates explicitly", statement.sql);
 		return evaluateGrouped(statement, plan, matching, resolver);
 	}
 	return evaluateUngrouped(statement, plan, matching, resolver);

package/dist/odb/sql/parser.cjs

@@ -141,7 +141,7 @@ var SqlParser = class {
 		this.advance();
 		this.takePunctuation("(");
 		if (this.atPunctuation("*")) {
-			if (aggregate !== "COUNT") this.fail(`a column name -- ${aggregate}(*) is not valid SQL, only COUNT(*) is`);
+			if (aggregate !== "COUNT") this.fail(`a column name — ${aggregate}(*) is not valid SQL, only COUNT(*) is`);
 			this.advance();
 			this.takePunctuation(")");
 			return {
@@ -413,7 +413,7 @@ var SqlParser = class {
 	}
 	parseGroupByColumn() {
 		const token = this.peek();
-		if (token.kind === "keyword" && isAggregateFunction(token.keyword)) this.fail("a column name -- an aggregate function is not valid in GROUP BY");
+		if (token.kind === "keyword" && isAggregateFunction(token.keyword)) this.fail("a column name — an aggregate function is not valid in GROUP BY");
 		return this.parseColumnRef();
 	}
 	parseOrderBy() {

package/dist/odb/sql/parser.js

@@ -140,7 +140,7 @@ var SqlParser = class {
 		this.advance();
 		this.takePunctuation("(");
 		if (this.atPunctuation("*")) {
-			if (aggregate !== "COUNT") this.fail(`a column name -- ${aggregate}(*) is not valid SQL, only COUNT(*) is`);
+			if (aggregate !== "COUNT") this.fail(`a column name — ${aggregate}(*) is not valid SQL, only COUNT(*) is`);
 			this.advance();
 			this.takePunctuation(")");
 			return {
@@ -412,7 +412,7 @@ var SqlParser = class {
 	}
 	parseGroupByColumn() {
 		const token = this.peek();
-		if (token.kind === "keyword" && isAggregateFunction(token.keyword)) this.fail("a column name -- an aggregate function is not valid in GROUP BY");
+		if (token.kind === "keyword" && isAggregateFunction(token.keyword)) this.fail("a column name — an aggregate function is not valid in GROUP BY");
 		return this.parseColumnRef();
 	}
 	parseOrderBy() {

package/dist/package-codec.cjs

@@ -23,7 +23,7 @@ function isOdfPackageFormat(format) {
 var UnsupportedPackageFormatError = class extends Error {
 	format;
 	constructor(format) {
-		super(`'${format}' documents carry no raw package concept to decode/encode -- expected one of docx, pptx, xlsx, odt, odp, ods, odg, odf`);
+		super(`'${format}' documents carry no raw package concept to decode/encode — expected one of docx, pptx, xlsx, odt, odp, ods, odg, odf`);
 		this.name = "UnsupportedPackageFormatError";
 		this.format = format;
 	}

package/dist/package-codec.js

@@ -22,7 +22,7 @@ function isOdfPackageFormat(format) {
 var UnsupportedPackageFormatError = class extends Error {
 	format;
 	constructor(format) {
-		super(`'${format}' documents carry no raw package concept to decode/encode -- expected one of docx, pptx, xlsx, odt, odp, ods, odg, odf`);
+		super(`'${format}' documents carry no raw package concept to decode/encode — expected one of docx, pptx, xlsx, odt, odp, ods, odg, odf`);
 		this.name = "UnsupportedPackageFormatError";
 		this.format = format;
 	}

package/dist/svg/write.cjs

@@ -15,7 +15,7 @@ var SvgUnsupportedDocumentKindError = class extends Error {
 var SvgMultiPageNotSpecifiedError = class extends Error {
 	pageCount;
 	constructor(pageCount) {
-		super(`buildSvgText: this document has more than one page (${pageCount}) -- pass { page: <index> } to select one`);
+		super(`buildSvgText: this document has more than one page (${pageCount}) — pass { page: <index> } to select one`);
 		this.name = "SvgMultiPageNotSpecifiedError";
 		this.pageCount = pageCount;
 	}
@@ -24,7 +24,7 @@ var SvgPageNotFoundError = class extends Error {
 	page;
 	pageCount;
 	constructor(page, pageCount) {
-		super(`buildSvgText: page index ${page} not found -- the document has ${pageCount} page(s)`);
+		super(`buildSvgText: page index ${page} not found — the document has ${pageCount} page(s)`);
 		this.name = "SvgPageNotFoundError";
 		this.page = page;
 		this.pageCount = pageCount;

package/dist/svg/write.js

@@ -14,7 +14,7 @@ var SvgUnsupportedDocumentKindError = class extends Error {
 var SvgMultiPageNotSpecifiedError = class extends Error {
 	pageCount;
 	constructor(pageCount) {
-		super(`buildSvgText: this document has more than one page (${pageCount}) -- pass { page: <index> } to select one`);
+		super(`buildSvgText: this document has more than one page (${pageCount}) — pass { page: <index> } to select one`);
 		this.name = "SvgMultiPageNotSpecifiedError";
 		this.pageCount = pageCount;
 	}
@@ -23,7 +23,7 @@ var SvgPageNotFoundError = class extends Error {
 	page;
 	pageCount;
 	constructor(page, pageCount) {
-		super(`buildSvgText: page index ${page} not found -- the document has ${pageCount} page(s)`);
+		super(`buildSvgText: page index ${page} not found — the document has ${pageCount} page(s)`);
 		this.name = "SvgPageNotFoundError";
 		this.page = page;
 		this.pageCount = pageCount;

package/dist/{table-Cou5rKOo.d.ts → table-B5htMG3g.d.ts}

@@ -62,6 +62,8 @@ declare class OdtTable {
   rows(): OdtTableRow[];
   headerRows(): boolean[];
   setHeaderRows(flags: readonly boolean[]): void;
+  headerColumns(): boolean[];
+  setHeaderColumns(flags: readonly boolean[]): void;
   gridRows(): TableGridRows<OdtTableCell>;
   gridColumnCount(): number;
   private grid;

package/dist/{table-Bt9ahRyh.d.cts → table-DrE6jEWv.d.cts}

@@ -62,6 +62,8 @@ declare class OdtTable {
   rows(): OdtTableRow[];
   headerRows(): boolean[];
   setHeaderRows(flags: readonly boolean[]): void;
+  headerColumns(): boolean[];
+  setHeaderColumns(flags: readonly boolean[]): void;
   gridRows(): TableGridRows<OdtTableCell>;
   gridColumnCount(): number;
   private grid;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "14.1.0",
+  "version": "14.2.0",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -77,21 +77,21 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "archive-codec": "1.11.10",
-    "byte-codec": "1.8.0",
-    "doc-codec": "6.0.1",
-    "document-schema.js": "7.14.0",
-    "epub-codec": "5.0.1",
+    "archive-codec": "1.11.12",
+    "byte-codec": "1.8.1",
+    "doc-codec": "6.0.3",
+    "document-schema.js": "7.15.0",
+    "epub-codec": "5.1.0",
     "fflate": "0.8.3",
-    "markdown-codec": "11.0.1",
-    "odf.js": "11.0.0",
-    "ooxml.js": "12.0.0",
-    "pdf-codec": "5.2.4",
-    "ppt-codec": "2.1.0",
-    "rtf-codec": "8.0.1",
+    "markdown-codec": "11.1.0",
+    "odf.js": "11.1.0",
+    "ooxml.js": "12.0.2",
+    "pdf-codec": "5.2.6",
+    "ppt-codec": "2.2.0",
+    "rtf-codec": "8.1.0",
     "temml": "0.13.4",
-    "wpd-codec": "5.1.0",
-    "xls-codec": "4.15.16",
+    "wpd-codec": "5.1.2",
+    "xls-codec": "4.15.18",
     "zod": "4.4.3"
   },
   "devDependencies": {