js.documents 14.0.3 → 14.1.1

package/dist/firebird/data.js

@@ -21,7 +21,7 @@ var FirebirdDataParseError = class extends Error {
 var FirebirdCompositeRecordUnsupportedError = class extends Error {
 	recordType;
 	constructor(recordType, context) {
-		super(`Firebird backup: encountered record type ${recordType} while ${context}, which this reader's own bounded implementation does not know how to skip safely (its own attribute/sub-record shape has not been verified against a real fixture) -- refusing to guess rather than risk silently desynchronising the rest of the stream`);
+		super(`Firebird backup: encountered record type ${recordType} while ${context}, which this reader's own bounded implementation does not know how to skip safely (its own attribute/sub-record shape has not been verified against a real fixture) — refusing to guess rather than risk silently desynchronising the rest of the stream`);
 		this.name = "FirebirdCompositeRecordUnsupportedError";
 		this.recordType = recordType;
 	}
@@ -197,7 +197,7 @@ function decodeRowValues(fields, payload) {
 		case "int128":
 		case "dec64":
 		case "dec128":
-		case "unsupported-tz": throw new FirebirdDataParseError(`column "${field.name}" has physical type "${field.physicalType}", which this reader's own bounded implementation does not decode (FB4+-only types not exercised by this reader's Firebird 3.0-era real fixture) -- see the README's .odb Tier 3 Fidelity note`);
+		case "unsupported-tz": throw new FirebirdDataParseError(`column "${field.name}" has physical type "${field.physicalType}", which this reader's own bounded implementation does not decode (FB4+-only types not exercised by this reader's Firebird 3.0-era real fixture) — see the README's .odb Tier 3 Fidelity note`);
 	}
 	for (let i = 0; i < storedFields.length; i++) if (xdr.readInt16() !== 0) rawValues[i] = { kind: "empty" };
 	return rawValues.map((value) => value ?? { kind: "empty" });

package/dist/hsqldb/binary-script.cjs

@@ -72,14 +72,14 @@ function readResultMetaData(reader) {
 function readDdlStatements(reader) {
 	const recordStart = reader.position;
 	const recordLength = reader.readInt32("the leading DDL result record's own length");
-	if (recordLength <= 4) throw new HsqldbBinaryScriptParseError(`the leading DDL result record declares an implausible length ${recordLength} -- not a recognisable HSQLDB binary script`, recordStart);
+	if (recordLength <= 4) throw new HsqldbBinaryScriptParseError(`the leading DDL result record declares an implausible length ${recordLength} — not a recognisable HSQLDB binary script`, recordStart);
 	const mode = reader.readInt32("the DDL result's own mode");
-	if (mode !== RESULT_MODE_DATA) throw new HsqldbBinaryScriptParseError(`the leading record has Result mode ${mode}, not the DATA mode (${RESULT_MODE_DATA}) a script's own DDL result always carries -- not a recognisable HSQLDB binary script`, recordStart);
+	if (mode !== RESULT_MODE_DATA) throw new HsqldbBinaryScriptParseError(`the leading record has Result mode ${mode}, not the DATA mode (${RESULT_MODE_DATA}) a script's own DDL result always carries — not a recognisable HSQLDB binary script`, recordStart);
 	reader.readInt32("the DDL result's own database id");
 	reader.readInt32("the DDL result's own session id");
 	const columnTypes = readResultMetaData(reader);
 	const firstColumnType = columnTypes[0];
-	if (columnTypes.length !== 1 || firstColumnType !== SQL_TYPE_VARCHAR) throw new HsqldbBinaryScriptParseError(`the DDL result has ${columnTypes.length} column(s) of type [${columnTypes.join(", ")}] -- a script's own DDL result is always the single VARCHAR "COMMAND" column DatabaseScript.getScript builds`, recordStart);
+	if (columnTypes.length !== 1 || firstColumnType !== SQL_TYPE_VARCHAR) throw new HsqldbBinaryScriptParseError(`the DDL result has ${columnTypes.length} column(s) of type [${columnTypes.join(", ")}] — a script's own DDL result is always the single VARCHAR "COMMAND" column DatabaseScript.getScript builds`, recordStart);
 	const rowCount = reader.readInt32("the DDL result's own row count");
 	if (rowCount < 0) throw new HsqldbBinaryScriptParseError(`the DDL result declares a negative row count ${rowCount}`, reader.position);
 	const statements = [];

package/dist/hsqldb/binary-script.js

@@ -71,14 +71,14 @@ function readResultMetaData(reader) {
 function readDdlStatements(reader) {
 	const recordStart = reader.position;
 	const recordLength = reader.readInt32("the leading DDL result record's own length");
-	if (recordLength <= 4) throw new HsqldbBinaryScriptParseError(`the leading DDL result record declares an implausible length ${recordLength} -- not a recognisable HSQLDB binary script`, recordStart);
+	if (recordLength <= 4) throw new HsqldbBinaryScriptParseError(`the leading DDL result record declares an implausible length ${recordLength} — not a recognisable HSQLDB binary script`, recordStart);
 	const mode = reader.readInt32("the DDL result's own mode");
-	if (mode !== RESULT_MODE_DATA) throw new HsqldbBinaryScriptParseError(`the leading record has Result mode ${mode}, not the DATA mode (${RESULT_MODE_DATA}) a script's own DDL result always carries -- not a recognisable HSQLDB binary script`, recordStart);
+	if (mode !== RESULT_MODE_DATA) throw new HsqldbBinaryScriptParseError(`the leading record has Result mode ${mode}, not the DATA mode (${RESULT_MODE_DATA}) a script's own DDL result always carries — not a recognisable HSQLDB binary script`, recordStart);
 	reader.readInt32("the DDL result's own database id");
 	reader.readInt32("the DDL result's own session id");
 	const columnTypes = readResultMetaData(reader);
 	const firstColumnType = columnTypes[0];
-	if (columnTypes.length !== 1 || firstColumnType !== SQL_TYPE_VARCHAR) throw new HsqldbBinaryScriptParseError(`the DDL result has ${columnTypes.length} column(s) of type [${columnTypes.join(", ")}] -- a script's own DDL result is always the single VARCHAR "COMMAND" column DatabaseScript.getScript builds`, recordStart);
+	if (columnTypes.length !== 1 || firstColumnType !== SQL_TYPE_VARCHAR) throw new HsqldbBinaryScriptParseError(`the DDL result has ${columnTypes.length} column(s) of type [${columnTypes.join(", ")}] — a script's own DDL result is always the single VARCHAR "COMMAND" column DatabaseScript.getScript builds`, recordStart);
 	const rowCount = reader.readInt32("the DDL result's own row count");
 	if (rowCount < 0) throw new HsqldbBinaryScriptParseError(`the DDL result declares a negative row count ${rowCount}`, reader.position);
 	const statements = [];

package/dist/hsqldb/cache.cjs

@@ -13,7 +13,7 @@ function parseHsqldbProperties(text) {
 		props.set(line.slice(0, eq).trim(), line.slice(eq + 1).trim());
 	}
 	const compatibleVersion = props.get("hsqldb.compatible_version");
-	if (compatibleVersion !== void 0 && !SUPPORTED_COMPATIBLE_VERSION_PREFIXES.some((prefix) => compatibleVersion.startsWith(prefix))) throw new require_hsqldb_rowformat.HsqldbRowFormatError(`database/properties declares hsqldb.compatible_version "${compatibleVersion}" -- this decoder is scoped to the HSQLDB 1.7.x/1.8.x CACHED-table row-store format (the version LibreOffice's own embedded driver ships) and does not know this version's own on-disk row-store layout`);
+	if (compatibleVersion !== void 0 && !SUPPORTED_COMPATIBLE_VERSION_PREFIXES.some((prefix) => compatibleVersion.startsWith(prefix))) throw new require_hsqldb_rowformat.HsqldbRowFormatError(`database/properties declares hsqldb.compatible_version "${compatibleVersion}" — this decoder is scoped to the HSQLDB 1.7.x/1.8.x CACHED-table row-store format (the version LibreOffice's own embedded driver ships) and does not know this version's own on-disk row-store layout`);
 	return {
 		cacheFileScale: Number(props.get("hsqldb.cache_file_scale") ?? "1") === 1 ? 1 : 8,
 		compatibleVersion
@@ -33,7 +33,7 @@ function parseHsqldbIndexRoots(scriptText) {
 		const tokensText = match[2] ?? "";
 		const tableName = unquoteIdentifier(rawName).toUpperCase();
 		const tokens = tokensText.trim().length === 0 ? [] : tokensText.trim().split(/\s+/);
-		if (tokens.length < 2) throw new require_hsqldb_rowformat.HsqldbRowFormatError(`table "${tableName}"'s SET TABLE...INDEX line has ${tokens.length} token(s) -- every such line carries at least one index root position followed by the table's own identity-sequence value`);
+		if (tokens.length < 2) throw new require_hsqldb_rowformat.HsqldbRowFormatError(`table "${tableName}"'s SET TABLE...INDEX line has ${tokens.length} token(s) — every such line carries at least one index root position followed by the table's own identity-sequence value`);
 		const indexCount = tokens.length - 1;
 		const rootToken = tokens[0] ?? "";
 		const rootPosition = Number(rootToken);

package/dist/hsqldb/cache.js

@@ -12,7 +12,7 @@ function parseHsqldbProperties(text) {
 		props.set(line.slice(0, eq).trim(), line.slice(eq + 1).trim());
 	}
 	const compatibleVersion = props.get("hsqldb.compatible_version");
-	if (compatibleVersion !== void 0 && !SUPPORTED_COMPATIBLE_VERSION_PREFIXES.some((prefix) => compatibleVersion.startsWith(prefix))) throw new HsqldbRowFormatError(`database/properties declares hsqldb.compatible_version "${compatibleVersion}" -- this decoder is scoped to the HSQLDB 1.7.x/1.8.x CACHED-table row-store format (the version LibreOffice's own embedded driver ships) and does not know this version's own on-disk row-store layout`);
+	if (compatibleVersion !== void 0 && !SUPPORTED_COMPATIBLE_VERSION_PREFIXES.some((prefix) => compatibleVersion.startsWith(prefix))) throw new HsqldbRowFormatError(`database/properties declares hsqldb.compatible_version "${compatibleVersion}" — this decoder is scoped to the HSQLDB 1.7.x/1.8.x CACHED-table row-store format (the version LibreOffice's own embedded driver ships) and does not know this version's own on-disk row-store layout`);
 	return {
 		cacheFileScale: Number(props.get("hsqldb.cache_file_scale") ?? "1") === 1 ? 1 : 8,
 		compatibleVersion
@@ -32,7 +32,7 @@ function parseHsqldbIndexRoots(scriptText) {
 		const tokensText = match[2] ?? "";
 		const tableName = unquoteIdentifier(rawName).toUpperCase();
 		const tokens = tokensText.trim().length === 0 ? [] : tokensText.trim().split(/\s+/);
-		if (tokens.length < 2) throw new HsqldbRowFormatError(`table "${tableName}"'s SET TABLE...INDEX line has ${tokens.length} token(s) -- every such line carries at least one index root position followed by the table's own identity-sequence value`);
+		if (tokens.length < 2) throw new HsqldbRowFormatError(`table "${tableName}"'s SET TABLE...INDEX line has ${tokens.length} token(s) — every such line carries at least one index root position followed by the table's own identity-sequence value`);
 		const indexCount = tokens.length - 1;
 		const rootToken = tokens[0] ?? "";
 		const rootPosition = Number(rootToken);

package/dist/hsqldb/rowformat.cjs

@@ -41,9 +41,9 @@ const LEADING_WORD_RE = /^([A-Za-z_][A-Za-z0-9_]*)/;
 function resolveHsqldbTypeCode(declaredType) {
 	const word = LEADING_WORD_RE.exec(declaredType.trim())?.[1]?.toUpperCase();
 	if (word === void 0) throw new HsqldbRowFormatError(`cannot resolve a SQL type name from column type clause "${declaredType}"`);
-	if (UNSUPPORTED_SQL_TYPE_NAMES.has(word)) throw new HsqldbRowFormatError(`column type "${word}" has no document-schema.js ContentCellValue equivalent (binary/object column types are not representable) -- from declared type "${declaredType}"`);
+	if (UNSUPPORTED_SQL_TYPE_NAMES.has(word)) throw new HsqldbRowFormatError(`column type "${word}" has no document-schema.js ContentCellValue equivalent (binary/object column types are not representable) — from declared type "${declaredType}"`);
 	const code = SQL_TYPE_NAME_TO_CODE[word];
-	if (code === void 0) throw new HsqldbRowFormatError(`unrecognised HSQLDB column type "${word}" -- from declared type "${declaredType}"`);
+	if (code === void 0) throw new HsqldbRowFormatError(`unrecognised HSQLDB column type "${word}" — from declared type "${declaredType}"`);
 	return code;
 }
 var HsqldbDataCursor = class {

package/dist/hsqldb/rowformat.js

@@ -40,9 +40,9 @@ const LEADING_WORD_RE = /^([A-Za-z_][A-Za-z0-9_]*)/;
 function resolveHsqldbTypeCode(declaredType) {
 	const word = LEADING_WORD_RE.exec(declaredType.trim())?.[1]?.toUpperCase();
 	if (word === void 0) throw new HsqldbRowFormatError(`cannot resolve a SQL type name from column type clause "${declaredType}"`);
-	if (UNSUPPORTED_SQL_TYPE_NAMES.has(word)) throw new HsqldbRowFormatError(`column type "${word}" has no document-schema.js ContentCellValue equivalent (binary/object column types are not representable) -- from declared type "${declaredType}"`);
+	if (UNSUPPORTED_SQL_TYPE_NAMES.has(word)) throw new HsqldbRowFormatError(`column type "${word}" has no document-schema.js ContentCellValue equivalent (binary/object column types are not representable) — from declared type "${declaredType}"`);
 	const code = SQL_TYPE_NAME_TO_CODE[word];
-	if (code === void 0) throw new HsqldbRowFormatError(`unrecognised HSQLDB column type "${word}" -- from declared type "${declaredType}"`);
+	if (code === void 0) throw new HsqldbRowFormatError(`unrecognised HSQLDB column type "${word}" — from declared type "${declaredType}"`);
 	return code;
 }
 var HsqldbDataCursor = class {

package/dist/hsqldb/script.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 var HsqldbScriptParseError = class extends Error {
 	statement;
 	constructor(message, statement) {
-		super(`HSQLDB script parse error: ${message} -- in statement: ${truncateForMessage(statement)}`);
+		super(`HSQLDB script parse error: ${message} — in statement: ${truncateForMessage(statement)}`);
 		this.name = "HsqldbScriptParseError";
 		this.statement = statement;
 	}
@@ -391,7 +391,7 @@ function parseInsertInto(statement) {
 	if (statement.charAt(i) !== "(") throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": expected "(" to start the VALUES tuple`, statement);
 	const { inner, next: afterTuple } = readBalancedParens(statement, i);
 	const trailing = statement.slice(afterTuple).trim();
-	if (trailing.length > 0) throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": unexpected trailing content after the VALUES tuple ("${trailing}") -- multiple tuples per INSERT are outside this bounded parser's scope`, statement);
+	if (trailing.length > 0) throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": unexpected trailing content after the VALUES tuple ("${trailing}") — multiple tuples per INSERT are outside this bounded parser's scope`, statement);
 	return {
 		tableName,
 		explicitColumns,

package/dist/hsqldb/script.js

@@ -2,7 +2,7 @@
 var HsqldbScriptParseError = class extends Error {
 	statement;
 	constructor(message, statement) {
-		super(`HSQLDB script parse error: ${message} -- in statement: ${truncateForMessage(statement)}`);
+		super(`HSQLDB script parse error: ${message} — in statement: ${truncateForMessage(statement)}`);
 		this.name = "HsqldbScriptParseError";
 		this.statement = statement;
 	}
@@ -390,7 +390,7 @@ function parseInsertInto(statement) {
 	if (statement.charAt(i) !== "(") throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": expected "(" to start the VALUES tuple`, statement);
 	const { inner, next: afterTuple } = readBalancedParens(statement, i);
 	const trailing = statement.slice(afterTuple).trim();
-	if (trailing.length > 0) throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": unexpected trailing content after the VALUES tuple ("${trailing}") -- multiple tuples per INSERT are outside this bounded parser's scope`, statement);
+	if (trailing.length > 0) throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": unexpected trailing content after the VALUES tuple ("${trailing}") — multiple tuples per INSERT are outside this bounded parser's scope`, statement);
 	return {
 		tableName,
 		explicitColumns,

package/dist/layout/shared.cjs

@@ -198,7 +198,7 @@ function decodeImageDimensions(format, bytes) {
 	};
 }
 function registerImage(block, images) {
-	if (block.format === "svg" || block.format === "gif") throw new Error(`registerImage: an image block in ${block.format} format cannot be laid out to PDF -- pdf-codec's own LayoutImageAsset registry (and its writer, byte-codec's image encoders) supports png and jpeg only`);
+	if (block.format === "svg" || block.format === "gif") throw new Error(`registerImage: an image block in ${block.format} format cannot be laid out to PDF — pdf-codec's own LayoutImageAsset registry (and its writer, byte-codec's image encoders) supports png and jpeg only`);
 	const bytes = (0, ooxml_js.base64ToBytes)(block.base64);
 	const imageId = `img${(0, byte_codec.crc32)(bytes).toString(16)}`;
 	if (!(imageId in images)) {

package/dist/layout/shared.js

@@ -197,7 +197,7 @@ function decodeImageDimensions(format, bytes) {
 	};
 }
 function registerImage(block, images) {
-	if (block.format === "svg" || block.format === "gif") throw new Error(`registerImage: an image block in ${block.format} format cannot be laid out to PDF -- pdf-codec's own LayoutImageAsset registry (and its writer, byte-codec's image encoders) supports png and jpeg only`);
+	if (block.format === "svg" || block.format === "gif") throw new Error(`registerImage: an image block in ${block.format} format cannot be laid out to PDF — pdf-codec's own LayoutImageAsset registry (and its writer, byte-codec's image encoders) supports png and jpeg only`);
 	const bytes = base64ToBytes(block.base64);
 	const imageId = `img${crc32(bytes).toString(16)}`;
 	if (!(imageId in images)) {

package/dist/metadata/write.cjs

@@ -21,12 +21,12 @@ function isRebuildFormat(format) {
 }
 function readContentForFormat(format, bytes, options) {
 	const content = require_codecs_registry.DOCUMENT_FORMAT_CODECS[format].content;
-	if (!content) throw new Error(`RebuildFormat '${format}' has no content codec in DOCUMENT_FORMAT_CODECS -- this is an internal invariant violation, not a caller error`);
+	if (!content) throw new Error(`RebuildFormat '${format}' has no content codec in DOCUMENT_FORMAT_CODECS — this is an internal invariant violation, not a caller error`);
 	return content.read(bytes, options);
 }
 function buildBytesForRebuildFormat(format, content) {
 	const codec = require_codecs_registry.DOCUMENT_FORMAT_CODECS[format].content;
-	if (!codec?.write) throw new Error(`RebuildFormat '${format}' has no content.write codec in DOCUMENT_FORMAT_CODECS -- this is an internal invariant violation, not a caller error`);
+	if (!codec?.write) throw new Error(`RebuildFormat '${format}' has no content.write codec in DOCUMENT_FORMAT_CODECS — this is an internal invariant violation, not a caller error`);
 	return require_model_bytes.requireArrayBufferBytes(codec.write(content));
 }
 function patchDocxMetadata(bytes, overrides, options) {
@@ -38,18 +38,18 @@ function patchDocxMetadata(bytes, overrides, options) {
 function classifyWritePath(source, target) {
 	if (source === "pdf" && target === "pdf") return { kind: "pdf" };
 	if (source === "docx" && target === "docx") return { kind: "docx-patch" };
-	if (target === "odf" || source === "odf") return { errorMessage: "'odf' (a standalone formula document) is not a supported setDocumentMetadata source or target -- it has no write path back out at all" };
-	if (target === "csv" || source === "csv") return { errorMessage: "'csv' is not a supported setDocumentMetadata source or target -- RFC 4180 text has no metadata container, so a rebuild would silently drop the override. Convert to or from csv first, then patch metadata on the package format." };
-	if (target === "svg" || source === "svg") return { errorMessage: "'svg' is not a supported setDocumentMetadata source or target -- this package's SVG metadata surface is the root <title> element alone, so an author/subject/keywords override would be silently dropped by the rebuild. Convert to or from svg first, then patch metadata on the package format." };
-	if (target === "doc" || source === "doc") return { errorMessage: "'doc' is not a supported setDocumentMetadata source or target -- doc-codec's reader always returns empty metadata and its writer never references document.metadata at all, so a rebuild would silently drop the override. Convert to or from doc first, then patch metadata on the package format." };
-	if (target === "xls" || source === "xls") return { errorMessage: "'xls' is not a supported setDocumentMetadata source or target -- xls-codec's reader always returns empty metadata and its writer never references document.metadata at all, so a rebuild would silently drop the override. Convert to or from xls first, then patch metadata on the package format." };
-	if (target === "ppt" || source === "ppt") return { errorMessage: "'ppt' is not a supported setDocumentMetadata source or target -- ppt-codec's reader always returns empty metadata (document properties live in the compound file's own SummaryInformation stream, which it does not read) and its writer never references it either, so a rebuild would silently drop the override. Convert to or from ppt first, then patch metadata on the package format." };
-	if (target === "epub" || source === "epub") return { errorMessage: "'epub' is not a supported setDocumentMetadata source or target -- epub-codec round-trips title/author/keywords/language through OPF Dublin Core elements, but 'subject' has no dc:description-equivalent mapping in either direction, so a rebuild would silently drop that one override. Convert to or from epub first, then patch metadata on the package format." };
+	if (target === "odf" || source === "odf") return { errorMessage: "'odf' (a standalone formula document) is not a supported setDocumentMetadata source or target — it has no write path back out at all" };
+	if (target === "csv" || source === "csv") return { errorMessage: "'csv' is not a supported setDocumentMetadata source or target — RFC 4180 text has no metadata container, so a rebuild would silently drop the override. Convert to or from csv first, then patch metadata on the package format." };
+	if (target === "svg" || source === "svg") return { errorMessage: "'svg' is not a supported setDocumentMetadata source or target — this package's SVG metadata surface is the root <title> element alone, so an author/subject/keywords override would be silently dropped by the rebuild. Convert to or from svg first, then patch metadata on the package format." };
+	if (target === "doc" || source === "doc") return { errorMessage: "'doc' is not a supported setDocumentMetadata source or target — doc-codec's reader always returns empty metadata and its writer never references document.metadata at all, so a rebuild would silently drop the override. Convert to or from doc first, then patch metadata on the package format." };
+	if (target === "xls" || source === "xls") return { errorMessage: "'xls' is not a supported setDocumentMetadata source or target — xls-codec's reader always returns empty metadata and its writer never references document.metadata at all, so a rebuild would silently drop the override. Convert to or from xls first, then patch metadata on the package format." };
+	if (target === "ppt" || source === "ppt") return { errorMessage: "'ppt' is not a supported setDocumentMetadata source or target — ppt-codec's reader always returns empty metadata (document properties live in the compound file's own SummaryInformation stream, which it does not read) and its writer never references it either, so a rebuild would silently drop the override. Convert to or from ppt first, then patch metadata on the package format." };
+	if (target === "epub" || source === "epub") return { errorMessage: "'epub' is not a supported setDocumentMetadata source or target — epub-codec round-trips title/author/keywords/language through OPF Dublin Core elements, but 'subject' has no dc:description-equivalent mapping in either direction, so a rebuild would silently drop that one override. Convert to or from epub first, then patch metadata on the package format." };
 	const sourcePatchable = source === "docx" || isRebuildFormat(source);
 	const targetPatchable = target === "docx" || isRebuildFormat(target);
-	if (!sourcePatchable || !targetPatchable) return { errorMessage: `setDocumentMetadata only patches metadata in place; it does not convert format -- source ('${source}') and target ('${target}') must be the same format (or both 'pdf'). Convert first if you need a different target format.` };
-	if (source !== target) return { errorMessage: `setDocumentMetadata only patches metadata in place; it does not convert format -- source ('${source}') and target ('${target}') must be the same format. Convert first if you need a different target format.` };
-	if (!isRebuildFormat(source)) throw new Error(`classifyWritePath: unreachable -- '${source}' is patchable and matches its target but is neither 'docx' nor a RebuildFormat`);
+	if (!sourcePatchable || !targetPatchable) return { errorMessage: `setDocumentMetadata only patches metadata in place; it does not convert format — source ('${source}') and target ('${target}') must be the same format (or both 'pdf'). Convert first if you need a different target format.` };
+	if (source !== target) return { errorMessage: `setDocumentMetadata only patches metadata in place; it does not convert format — source ('${source}') and target ('${target}') must be the same format. Convert first if you need a different target format.` };
+	if (!isRebuildFormat(source)) throw new Error(`classifyWritePath: unreachable — '${source}' is patchable and matches its target but is neither 'docx' nor a RebuildFormat`);
 	return {
 		kind: "rebuild",
 		format: source

package/dist/metadata/write.js

@@ -20,12 +20,12 @@ function isRebuildFormat(format) {
 }
 function readContentForFormat(format, bytes, options) {
 	const content = DOCUMENT_FORMAT_CODECS[format].content;
-	if (!content) throw new Error(`RebuildFormat '${format}' has no content codec in DOCUMENT_FORMAT_CODECS -- this is an internal invariant violation, not a caller error`);
+	if (!content) throw new Error(`RebuildFormat '${format}' has no content codec in DOCUMENT_FORMAT_CODECS — this is an internal invariant violation, not a caller error`);
 	return content.read(bytes, options);
 }
 function buildBytesForRebuildFormat(format, content) {
 	const codec = DOCUMENT_FORMAT_CODECS[format].content;
-	if (!codec?.write) throw new Error(`RebuildFormat '${format}' has no content.write codec in DOCUMENT_FORMAT_CODECS -- this is an internal invariant violation, not a caller error`);
+	if (!codec?.write) throw new Error(`RebuildFormat '${format}' has no content.write codec in DOCUMENT_FORMAT_CODECS — this is an internal invariant violation, not a caller error`);
 	return requireArrayBufferBytes(codec.write(content));
 }
 function patchDocxMetadata(bytes, overrides, options) {
@@ -37,18 +37,18 @@ function patchDocxMetadata(bytes, overrides, options) {
 function classifyWritePath(source, target) {
 	if (source === "pdf" && target === "pdf") return { kind: "pdf" };
 	if (source === "docx" && target === "docx") return { kind: "docx-patch" };
-	if (target === "odf" || source === "odf") return { errorMessage: "'odf' (a standalone formula document) is not a supported setDocumentMetadata source or target -- it has no write path back out at all" };
-	if (target === "csv" || source === "csv") return { errorMessage: "'csv' is not a supported setDocumentMetadata source or target -- RFC 4180 text has no metadata container, so a rebuild would silently drop the override. Convert to or from csv first, then patch metadata on the package format." };
-	if (target === "svg" || source === "svg") return { errorMessage: "'svg' is not a supported setDocumentMetadata source or target -- this package's SVG metadata surface is the root <title> element alone, so an author/subject/keywords override would be silently dropped by the rebuild. Convert to or from svg first, then patch metadata on the package format." };
-	if (target === "doc" || source === "doc") return { errorMessage: "'doc' is not a supported setDocumentMetadata source or target -- doc-codec's reader always returns empty metadata and its writer never references document.metadata at all, so a rebuild would silently drop the override. Convert to or from doc first, then patch metadata on the package format." };
-	if (target === "xls" || source === "xls") return { errorMessage: "'xls' is not a supported setDocumentMetadata source or target -- xls-codec's reader always returns empty metadata and its writer never references document.metadata at all, so a rebuild would silently drop the override. Convert to or from xls first, then patch metadata on the package format." };
-	if (target === "ppt" || source === "ppt") return { errorMessage: "'ppt' is not a supported setDocumentMetadata source or target -- ppt-codec's reader always returns empty metadata (document properties live in the compound file's own SummaryInformation stream, which it does not read) and its writer never references it either, so a rebuild would silently drop the override. Convert to or from ppt first, then patch metadata on the package format." };
-	if (target === "epub" || source === "epub") return { errorMessage: "'epub' is not a supported setDocumentMetadata source or target -- epub-codec round-trips title/author/keywords/language through OPF Dublin Core elements, but 'subject' has no dc:description-equivalent mapping in either direction, so a rebuild would silently drop that one override. Convert to or from epub first, then patch metadata on the package format." };
+	if (target === "odf" || source === "odf") return { errorMessage: "'odf' (a standalone formula document) is not a supported setDocumentMetadata source or target — it has no write path back out at all" };
+	if (target === "csv" || source === "csv") return { errorMessage: "'csv' is not a supported setDocumentMetadata source or target — RFC 4180 text has no metadata container, so a rebuild would silently drop the override. Convert to or from csv first, then patch metadata on the package format." };
+	if (target === "svg" || source === "svg") return { errorMessage: "'svg' is not a supported setDocumentMetadata source or target — this package's SVG metadata surface is the root <title> element alone, so an author/subject/keywords override would be silently dropped by the rebuild. Convert to or from svg first, then patch metadata on the package format." };
+	if (target === "doc" || source === "doc") return { errorMessage: "'doc' is not a supported setDocumentMetadata source or target — doc-codec's reader always returns empty metadata and its writer never references document.metadata at all, so a rebuild would silently drop the override. Convert to or from doc first, then patch metadata on the package format." };
+	if (target === "xls" || source === "xls") return { errorMessage: "'xls' is not a supported setDocumentMetadata source or target — xls-codec's reader always returns empty metadata and its writer never references document.metadata at all, so a rebuild would silently drop the override. Convert to or from xls first, then patch metadata on the package format." };
+	if (target === "ppt" || source === "ppt") return { errorMessage: "'ppt' is not a supported setDocumentMetadata source or target — ppt-codec's reader always returns empty metadata (document properties live in the compound file's own SummaryInformation stream, which it does not read) and its writer never references it either, so a rebuild would silently drop the override. Convert to or from ppt first, then patch metadata on the package format." };
+	if (target === "epub" || source === "epub") return { errorMessage: "'epub' is not a supported setDocumentMetadata source or target — epub-codec round-trips title/author/keywords/language through OPF Dublin Core elements, but 'subject' has no dc:description-equivalent mapping in either direction, so a rebuild would silently drop that one override. Convert to or from epub first, then patch metadata on the package format." };
 	const sourcePatchable = source === "docx" || isRebuildFormat(source);
 	const targetPatchable = target === "docx" || isRebuildFormat(target);
-	if (!sourcePatchable || !targetPatchable) return { errorMessage: `setDocumentMetadata only patches metadata in place; it does not convert format -- source ('${source}') and target ('${target}') must be the same format (or both 'pdf'). Convert first if you need a different target format.` };
-	if (source !== target) return { errorMessage: `setDocumentMetadata only patches metadata in place; it does not convert format -- source ('${source}') and target ('${target}') must be the same format. Convert first if you need a different target format.` };
-	if (!isRebuildFormat(source)) throw new Error(`classifyWritePath: unreachable -- '${source}' is patchable and matches its target but is neither 'docx' nor a RebuildFormat`);
+	if (!sourcePatchable || !targetPatchable) return { errorMessage: `setDocumentMetadata only patches metadata in place; it does not convert format — source ('${source}') and target ('${target}') must be the same format (or both 'pdf'). Convert first if you need a different target format.` };
+	if (source !== target) return { errorMessage: `setDocumentMetadata only patches metadata in place; it does not convert format — source ('${source}') and target ('${target}') must be the same format. Convert first if you need a different target format.` };
+	if (!isRebuildFormat(source)) throw new Error(`classifyWritePath: unreachable — '${source}' is patchable and matches its target but is neither 'docx' nor a RebuildFormat`);
 	return {
 		kind: "rebuild",
 		format: source

package/dist/odb/csv.cjs

@@ -5,7 +5,7 @@ const require_hsqldb_script = require("../hsqldb/script.cjs");
 var OdbTableNotSpecifiedError = class extends Error {
 	availableTables;
 	constructor(availableTables) {
-		super(`odbToCsv: this .odb has more than one table (${availableTables.join(", ")}) -- pass { table: '<name>' } to select one`);
+		super(`odbToCsv: this .odb has more than one table (${availableTables.join(", ")}) — pass { table: '<name>' } to select one`);
 		this.name = "OdbTableNotSpecifiedError";
 		this.availableTables = availableTables;
 	}
@@ -14,7 +14,7 @@ var OdbTableNotFoundError = class extends Error {
 	table;
 	availableTables;
 	constructor(table, availableTables) {
-		super(`odbToCsv: table "${table}" not found -- available table(s): ${availableTables.length === 0 ? "(none)" : availableTables.join(", ")}`);
+		super(`odbToCsv: table "${table}" not found — available table(s): ${availableTables.length === 0 ? "(none)" : availableTables.join(", ")}`);
 		this.name = "OdbTableNotFoundError";
 		this.table = table;
 		this.availableTables = availableTables;

package/dist/odb/csv.js

@@ -4,7 +4,7 @@ import { displayTextFor } from "../hsqldb/script.js";
 var OdbTableNotSpecifiedError = class extends Error {
 	availableTables;
 	constructor(availableTables) {
-		super(`odbToCsv: this .odb has more than one table (${availableTables.join(", ")}) -- pass { table: '<name>' } to select one`);
+		super(`odbToCsv: this .odb has more than one table (${availableTables.join(", ")}) — pass { table: '<name>' } to select one`);
 		this.name = "OdbTableNotSpecifiedError";
 		this.availableTables = availableTables;
 	}
@@ -13,7 +13,7 @@ var OdbTableNotFoundError = class extends Error {
 	table;
 	availableTables;
 	constructor(table, availableTables) {
-		super(`odbToCsv: table "${table}" not found -- available table(s): ${availableTables.length === 0 ? "(none)" : availableTables.join(", ")}`);
+		super(`odbToCsv: table "${table}" not found — available table(s): ${availableTables.length === 0 ? "(none)" : availableTables.join(", ")}`);
 		this.name = "OdbTableNotFoundError";
 		this.table = table;
 		this.availableTables = availableTables;

package/dist/odb/formula/errors.cjs

@@ -8,7 +8,7 @@ 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)}`);
+		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;
@@ -18,7 +18,7 @@ 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)}`);
+		super(`Report Builder formula parse error at offset ${String(offset)}: ${message} — in formula: ${truncateForMessage(formula)}`);
 		this.name = "RptFormulaParseError";
 		this.formula = formula;
 		this.offset = offset;
@@ -27,7 +27,7 @@ var RptFormulaParseError = class extends Error {
 var RptFormulaEvaluationError = class extends Error {
 	formula;
 	constructor(message, formula) {
-		super(`Report Builder formula evaluation error: ${message} -- in formula: ${truncateForMessage(formula)}`);
+		super(`Report Builder formula evaluation error: ${message} — in formula: ${truncateForMessage(formula)}`);
 		this.name = "RptFormulaEvaluationError";
 		this.formula = formula;
 	}

package/dist/odb/formula/errors.js

@@ -7,7 +7,7 @@ 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)}`);
+		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;
@@ -17,7 +17,7 @@ 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)}`);
+		super(`Report Builder formula parse error at offset ${String(offset)}: ${message} — in formula: ${truncateForMessage(formula)}`);
 		this.name = "RptFormulaParseError";
 		this.formula = formula;
 		this.offset = offset;
@@ -26,7 +26,7 @@ var RptFormulaParseError = class extends Error {
 var RptFormulaEvaluationError = class extends Error {
 	formula;
 	constructor(message, formula) {
-		super(`Report Builder formula evaluation error: ${message} -- in formula: ${truncateForMessage(formula)}`);
+		super(`Report Builder formula evaluation error: ${message} — in formula: ${truncateForMessage(formula)}`);
 		this.name = "RptFormulaEvaluationError";
 		this.formula = formula;
 	}

package/dist/odb/formula/evaluate.cjs

@@ -59,7 +59,7 @@ var PreparedReport = class {
 		for (const expression of this.groupExpressions) this.rejectAggregateDependency(expression, expression, /* @__PURE__ */ new Set());
 	}
 	rejectAggregateDependency(formula, expression, visiting) {
-		if (formula.kind === "aggregate") fail(`a group expression cannot depend on the aggregate rpt:${formula.aggregate}(${formula.reference.name}) -- an aggregate's own rows are defined by the very group boundaries this expression decides`, expression.text);
+		if (formula.kind === "aggregate") fail(`a group expression cannot depend on the aggregate rpt:${formula.aggregate}(${formula.reference.name}) — an aggregate's own rows are defined by the very group boundaries this expression decides`, expression.text);
 		const resolved = matchNamed([...this.namedFunctions.values()], (candidate) => candidate.name, formula.reference.name)[0];
 		if (resolved === void 0) return;
 		if (visiting.has(resolved.name)) fail(`rpt:function "${resolved.name}" refers to itself, directly or through another function`, expression.text);
@@ -70,7 +70,7 @@ var PreparedReport = class {
 		if (cached !== void 0) return cached;
 		const functionMatches = matchNamed([...this.namedFunctions.values()], (candidate) => candidate.name, reference.name);
 		const columnMatches = matchNamed(this.columnNames, identity, reference.name);
-		if (functionMatches.length + columnMatches.length > 1) fail(`reference "${reference.name}" is ambiguous -- it matches ${[...functionMatches.map((match) => `rpt:function ${match.name}`), ...columnMatches.map((match) => `column ${match}`)].join(", ")}`, formula);
+		if (functionMatches.length + columnMatches.length > 1) fail(`reference "${reference.name}" is ambiguous — it matches ${[...functionMatches.map((match) => `rpt:function ${match.name}`), ...columnMatches.map((match) => `column ${match}`)].join(", ")}`, formula);
 		const resolved = this.resolveSingleMatch(reference, functionMatches[0], columnMatches[0], formula);
 		this.resolutions.set(reference, resolved);
 		return resolved;
@@ -80,7 +80,7 @@ var PreparedReport = class {
 			kind: "function",
 			resolved: named
 		};
-		if (columnName === void 0) fail(`reference "${reference.name}" names neither a declared rpt:function nor a column of the report's own data -- functions: ${this.namedFunctions.size === 0 ? "(none)" : [...this.namedFunctions.keys()].join(", ")}; columns: ${this.columnNames.length === 0 ? "(none)" : this.columnNames.join(", ")}`, formula);
+		if (columnName === void 0) fail(`reference "${reference.name}" names neither a declared rpt:function nor a column of the report's own data — functions: ${this.namedFunctions.size === 0 ? "(none)" : [...this.namedFunctions.keys()].join(", ")}; columns: ${this.columnNames.length === 0 ? "(none)" : this.columnNames.join(", ")}`, formula);
 		return {
 			kind: "column",
 			index: this.columnNames.indexOf(columnName)
@@ -121,7 +121,7 @@ var RunState = class {
 function textOf(value, formula, what) {
 	if (value.kind === "empty") return;
 	const key = require_odb_values.cellComparisonKey(value);
-	if (key?.valueClass !== "text") fail(`${what} requires a text value, but found a ${value.kind} value -- this engine does not format a number or a boolean into text, since a report's own number format lives in its band styles rather than in the formula`, formula);
+	if (key?.valueClass !== "text") fail(`${what} requires a text value, but found a ${value.kind} value — this engine does not format a number or a boolean into text, since a report's own number format lives in its band styles rather than in the formula`, formula);
 	return key.text;
 }
 var FormulaEvaluator = class {

package/dist/odb/formula/evaluate.js

@@ -58,7 +58,7 @@ var PreparedReport = class {
 		for (const expression of this.groupExpressions) this.rejectAggregateDependency(expression, expression, /* @__PURE__ */ new Set());
 	}
 	rejectAggregateDependency(formula, expression, visiting) {
-		if (formula.kind === "aggregate") fail(`a group expression cannot depend on the aggregate rpt:${formula.aggregate}(${formula.reference.name}) -- an aggregate's own rows are defined by the very group boundaries this expression decides`, expression.text);
+		if (formula.kind === "aggregate") fail(`a group expression cannot depend on the aggregate rpt:${formula.aggregate}(${formula.reference.name}) — an aggregate's own rows are defined by the very group boundaries this expression decides`, expression.text);
 		const resolved = matchNamed([...this.namedFunctions.values()], (candidate) => candidate.name, formula.reference.name)[0];
 		if (resolved === void 0) return;
 		if (visiting.has(resolved.name)) fail(`rpt:function "${resolved.name}" refers to itself, directly or through another function`, expression.text);
@@ -69,7 +69,7 @@ var PreparedReport = class {
 		if (cached !== void 0) return cached;
 		const functionMatches = matchNamed([...this.namedFunctions.values()], (candidate) => candidate.name, reference.name);
 		const columnMatches = matchNamed(this.columnNames, identity, reference.name);
-		if (functionMatches.length + columnMatches.length > 1) fail(`reference "${reference.name}" is ambiguous -- it matches ${[...functionMatches.map((match) => `rpt:function ${match.name}`), ...columnMatches.map((match) => `column ${match}`)].join(", ")}`, formula);
+		if (functionMatches.length + columnMatches.length > 1) fail(`reference "${reference.name}" is ambiguous — it matches ${[...functionMatches.map((match) => `rpt:function ${match.name}`), ...columnMatches.map((match) => `column ${match}`)].join(", ")}`, formula);
 		const resolved = this.resolveSingleMatch(reference, functionMatches[0], columnMatches[0], formula);
 		this.resolutions.set(reference, resolved);
 		return resolved;
@@ -79,7 +79,7 @@ var PreparedReport = class {
 			kind: "function",
 			resolved: named
 		};
-		if (columnName === void 0) fail(`reference "${reference.name}" names neither a declared rpt:function nor a column of the report's own data -- functions: ${this.namedFunctions.size === 0 ? "(none)" : [...this.namedFunctions.keys()].join(", ")}; columns: ${this.columnNames.length === 0 ? "(none)" : this.columnNames.join(", ")}`, formula);
+		if (columnName === void 0) fail(`reference "${reference.name}" names neither a declared rpt:function nor a column of the report's own data — functions: ${this.namedFunctions.size === 0 ? "(none)" : [...this.namedFunctions.keys()].join(", ")}; columns: ${this.columnNames.length === 0 ? "(none)" : this.columnNames.join(", ")}`, formula);
 		return {
 			kind: "column",
 			index: this.columnNames.indexOf(columnName)
@@ -120,7 +120,7 @@ var RunState = class {
 function textOf(value, formula, what) {
 	if (value.kind === "empty") return;
 	const key = cellComparisonKey(value);
-	if (key?.valueClass !== "text") fail(`${what} requires a text value, but found a ${value.kind} value -- this engine does not format a number or a boolean into text, since a report's own number format lives in its band styles rather than in the formula`, formula);
+	if (key?.valueClass !== "text") fail(`${what} requires a text value, but found a ${value.kind} value — this engine does not format a number or a boolean into text, since a report's own number format lives in its band styles rather than in the formula`, formula);
 	return key.text;
 }
 var FormulaEvaluator = class {

package/dist/odb/formula/parser.cjs

@@ -63,7 +63,7 @@ var FormulaScanner = class {
 		const close = this.formula.indexOf("]", this.offset);
 		if (close < 0) {
 			this.offset = this.formula.length;
-			this.fail("unterminated column reference -- no closing \"]\"");
+			this.fail("unterminated column reference — no closing \"]\"");
 		}
 		this.offset = close + 1;
 		return {
@@ -75,7 +75,7 @@ var FormulaScanner = class {
 		this.expect("\"", "the opening quote of a name reference");
 		let name = "";
 		for (;;) {
-			if (this.offset >= this.formula.length) this.fail("unterminated name reference -- no closing double quote");
+			if (this.offset >= this.formula.length) this.fail("unterminated name reference — no closing double quote");
 			const character = this.formula.charAt(this.offset);
 			this.offset += 1;
 			if (character !== "\"") {

package/dist/odb/formula/parser.js

@@ -62,7 +62,7 @@ var FormulaScanner = class {
 		const close = this.formula.indexOf("]", this.offset);
 		if (close < 0) {
 			this.offset = this.formula.length;
-			this.fail("unterminated column reference -- no closing \"]\"");
+			this.fail("unterminated column reference — no closing \"]\"");
 		}
 		this.offset = close + 1;
 		return {
@@ -74,7 +74,7 @@ var FormulaScanner = class {
 		this.expect("\"", "the opening quote of a name reference");
 		let name = "";
 		for (;;) {
-			if (this.offset >= this.formula.length) this.fail("unterminated name reference -- no closing double quote");
+			if (this.offset >= this.formula.length) this.fail("unterminated name reference — no closing double quote");
 			const character = this.formula.charAt(this.offset);
 			this.offset += 1;
 			if (character !== "\"") {

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