odf.js 1.13.2 → 2.0.0

package/dist/typed/odb/read.d.cts

@@ -5,13 +5,24 @@ interface OdbConnectionInfo {
   driverClass?: string;
   url?: string;
 }
+interface OdbQueryInfo {
+  name: string;
+  command: string;
+  escapeProcessing?: boolean;
+}
+interface OdbComponentInfo {
+  name: string;
+  href: string;
+  asTemplate?: boolean;
+}
 interface OdbInventory {
   connection: OdbConnectionInfo | undefined;
   tables: string[];
-  queries: string[];
-  forms: string[];
-  reports: string[];
+  queries: OdbQueryInfo[];
+  forms: OdbComponentInfo[];
+  reports: OdbComponentInfo[];
 }
+declare function resolveOdbComponent(pkg: Package, kind: 'form' | 'report', name: string): OdbComponentInfo;
 declare function readOdbInventory(pkg: Package): OdbInventory;
 //#endregion
-export { OdbConnectionInfo, OdbInventory, readOdbInventory };
+export { OdbComponentInfo, OdbConnectionInfo, OdbInventory, OdbQueryInfo, readOdbInventory, resolveOdbComponent };

package/dist/typed/odb/read.d.ts

@@ -5,13 +5,24 @@ interface OdbConnectionInfo {
   driverClass?: string;
   url?: string;
 }
+interface OdbQueryInfo {
+  name: string;
+  command: string;
+  escapeProcessing?: boolean;
+}
+interface OdbComponentInfo {
+  name: string;
+  href: string;
+  asTemplate?: boolean;
+}
 interface OdbInventory {
   connection: OdbConnectionInfo | undefined;
   tables: string[];
-  queries: string[];
-  forms: string[];
-  reports: string[];
+  queries: OdbQueryInfo[];
+  forms: OdbComponentInfo[];
+  reports: OdbComponentInfo[];
 }
+declare function resolveOdbComponent(pkg: Package, kind: 'form' | 'report', name: string): OdbComponentInfo;
 declare function readOdbInventory(pkg: Package): OdbInventory;
 //#endregion
-export { OdbConnectionInfo, OdbInventory, readOdbInventory };
+export { OdbComponentInfo, OdbConnectionInfo, OdbInventory, OdbQueryInfo, readOdbInventory, resolveOdbComponent };

package/dist/typed/odb/read.js

@@ -1,12 +1,8 @@
-import { readManifest } from "../../manifest.js";
+import { decodeXmlText } from "../../xml/entities.js";
 import { attrValue, childrenWithTag, findChildElement, rootElement } from "../../xml/query.js";
 //#region src/typed/odb/read.ts
 const CONTENT_PART = "content.xml";
 const EMBEDDED_URL_PREFIX = "sdbc:embedded:";
-const SUBDOCUMENT_CONTENT_SUFFIX = "/content.xml";
-function isXmlMediaType(mediaType) {
-	return mediaType === "text/xml" || mediaType === "application/xml" || mediaType.endsWith("+xml");
-}
 function formatServerDatabaseUrl(serverDatabase) {
 	const dbType = attrValue(serverDatabase, "db:type");
 	if (dbType === void 0) return;
@@ -50,13 +46,24 @@ function readConnectionInfo(databaseElement) {
 		};
 	}
 }
-function collectQueryNames(container, names) {
+function collectQueryDefinitions(container, definitions) {
 	for (const child of container.children) {
 		if (child.type !== "element") continue;
 		if (child.tag === "db:query") {
 			const name = attrValue(child, "db:name");
-			if (name !== void 0) names.push(name);
-		} else if (child.tag === "db:query-collection") collectQueryNames(child, names);
+			const command = attrValue(child, "db:command");
+			if (name === void 0 || command === void 0) continue;
+			const decodedCommand = decodeXmlText(command);
+			const escapeProcessingRaw = attrValue(child, "db:escape-processing");
+			definitions.push(escapeProcessingRaw === void 0 ? {
+				name,
+				command: decodedCommand
+			} : {
+				name,
+				command: decodedCommand,
+				escapeProcessing: escapeProcessingRaw === "true"
+			});
+		} else if (child.tag === "db:query-collection") collectQueryDefinitions(child, definitions);
 	}
 }
 function collectTableNames(databaseElement) {
@@ -75,16 +82,47 @@ function collectTableNames(databaseElement) {
 	if (tableDefinitions !== void 0) for (const definition of childrenWithTag(tableDefinitions, "db:table-definition")) pushName(attrValue(definition, "db:name"));
 	return names;
 }
-function subdocumentNamesUnderPrefix(entries, prefix) {
-	const names = [];
-	for (const entry of entries) {
-		if (!entry.fullPath.startsWith(prefix) || !entry.fullPath.endsWith(SUBDOCUMENT_CONTENT_SUFFIX) || !isXmlMediaType(entry.mediaType)) continue;
-		const withoutSuffix = entry.fullPath.slice(0, entry.fullPath.length - 12);
-		const lastSlash = withoutSuffix.lastIndexOf("/");
-		const name = lastSlash === -1 ? withoutSuffix.slice(prefix.length) : withoutSuffix.slice(lastSlash + 1);
-		if (name.length > 0) names.push(name);
+function collectComponents(container, components) {
+	for (const child of container.children) {
+		if (child.type !== "element") continue;
+		if (child.tag === "db:component-collection") {
+			collectComponents(child, components);
+			continue;
+		}
+		if (child.tag !== "db:component") continue;
+		const name = attrValue(child, "db:name");
+		const rawHref = attrValue(child, "xlink:href");
+		if (name === void 0 || rawHref === void 0) continue;
+		const decodedHref = decodeXmlText(rawHref);
+		const href = decodedHref.endsWith("/") ? decodedHref.slice(0, -1) : decodedHref;
+		if (href.length === 0) continue;
+		const asTemplateRaw = attrValue(child, "db:as-template");
+		components.push(asTemplateRaw === void 0 ? {
+			name: decodeXmlText(name),
+			href
+		} : {
+			name: decodeXmlText(name),
+			href,
+			asTemplate: asTemplateRaw === "true"
+		});
 	}
-	return names;
+}
+function readComponents(databaseElement, tag) {
+	const container = findChildElement(databaseElement.children, tag);
+	if (container === void 0) return [];
+	const components = [];
+	collectComponents(container, components);
+	return components;
+}
+function resolveOdbComponent(pkg, kind, name) {
+	const inventory = readOdbInventory(pkg);
+	const components = kind === "form" ? inventory.forms : inventory.reports;
+	const match = components.find((component) => component.name === name);
+	if (match === void 0) {
+		const available = components.map((component) => component.name).join(", ");
+		throw new Error(`resolveOdbComponent: no ${kind} named "${name}" -- available: ${available === "" ? "(none)" : available}`);
+	}
+	return match;
 }
 function readOdbInventory(pkg) {
 	const contentPart = pkg.parts[CONTENT_PART];
@@ -96,16 +134,14 @@ function readOdbInventory(pkg) {
 	const connection = readConnectionInfo(databaseElement);
 	const queries = [];
 	const queriesElement = findChildElement(databaseElement.children, "db:queries");
-	if (queriesElement !== void 0) collectQueryNames(queriesElement, queries);
-	const tables = collectTableNames(databaseElement);
-	const manifest = readManifest(pkg);
+	if (queriesElement !== void 0) collectQueryDefinitions(queriesElement, queries);
 	return {
 		connection,
-		tables,
+		tables: collectTableNames(databaseElement),
 		queries,
-		forms: subdocumentNamesUnderPrefix(manifest.entries, "forms/"),
-		reports: subdocumentNamesUnderPrefix(manifest.entries, "reports/")
+		forms: readComponents(databaseElement, "db:forms"),
+		reports: readComponents(databaseElement, "db:reports")
 	};
 }
 //#endregion
-export { readOdbInventory };
+export { readOdbInventory, resolveOdbComponent };

package/dist/typed/odb/report.cjs

@@ -0,0 +1,161 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_entities = require("../../xml/entities.cjs");
+const require_xml_query = require("../../xml/query.cjs");
+const require_typed_odb_read = require("./read.cjs");
+const require_typed_odb_subdocument = require("./subdocument.cjs");
+//#region src/typed/odb/report.ts
+const CONTENT_PART = "content.xml";
+const GROUP_TAG = "rpt:group";
+const FUNCTION_TAG = "rpt:function";
+const REPORT_ELEMENT_TAG = "rpt:report-element";
+const REPORT_COMPONENT_TAG = "rpt:report-component";
+const RPT_TAG_PREFIX = "rpt:";
+const FIELD_FORMULA_PREFIX = "field:[";
+const FIELD_FORMULA_SUFFIX = "]";
+function reportAttr(element, name) {
+	const raw = require_xml_query.attrValue(element, name);
+	return raw === void 0 ? void 0 : require_xml_entities.decodeXmlText(raw);
+}
+function parseOptionalBoolean(raw) {
+	return raw === void 0 ? void 0 : raw === "true";
+}
+function boundFieldName(formula) {
+	if (formula === void 0 || !formula.startsWith(FIELD_FORMULA_PREFIX) || !formula.endsWith(FIELD_FORMULA_SUFFIX)) return;
+	const inner = formula.slice(7, formula.length - 1);
+	return inner.length === 0 ? void 0 : inner;
+}
+function elementText(element) {
+	let text = "";
+	for (const child of element.children) if (child.type === "text") text += require_xml_entities.decodeXmlText(child.value);
+	else if (child.type === "element") text += elementText(child);
+	return text;
+}
+function reportElementChild(element) {
+	return require_xml_query.findChildElement(element.children, REPORT_ELEMENT_TAG);
+}
+function readReportElement(element, reportElement) {
+	const control = { tag: element.tag };
+	const component = require_xml_query.findChildElement(reportElement.children, REPORT_COMPONENT_TAG);
+	const name = component === void 0 ? void 0 : reportAttr(component, "draw:name");
+	if (name !== void 0) control.name = name;
+	const formula = reportAttr(element, "rpt:formula");
+	if (formula !== void 0) control.formula = formula;
+	let text = "";
+	for (const child of element.children) if (child.type === "text") text += require_xml_entities.decodeXmlText(child.value);
+	else if (child.type === "element" && !child.tag.startsWith(RPT_TAG_PREFIX)) text += elementText(child);
+	if (text.length > 0) control.text = text;
+	const dataField = boundFieldName(formula);
+	if (dataField !== void 0) control.dataField = dataField;
+	return control;
+}
+function collectControls(nodes, controls) {
+	for (const node of nodes) {
+		if (node.type !== "element") continue;
+		if (node.tag.startsWith(RPT_TAG_PREFIX)) {
+			const reportElement = reportElementChild(node);
+			if (reportElement !== void 0) {
+				controls.push(readReportElement(node, reportElement));
+				continue;
+			}
+		}
+		collectControls(node.children, controls);
+	}
+}
+function readBand(element, kind) {
+	const elements = [];
+	collectControls(element.children, elements);
+	const band = {
+		kind,
+		elements
+	};
+	const table = require_xml_query.findChildElement(element.children, "table:table");
+	const name = table === void 0 ? void 0 : reportAttr(table, "table:name");
+	if (name !== void 0) band.name = name;
+	return band;
+}
+function readBandIfPresent(container, tag, kind) {
+	const element = require_xml_query.findChildElement(container.children, tag);
+	return element === void 0 ? void 0 : readBand(element, kind);
+}
+function readFunctions(container) {
+	const functions = [];
+	for (const child of container.children) {
+		if (child.type !== "element" || child.tag !== FUNCTION_TAG) continue;
+		const name = reportAttr(child, "rpt:name");
+		const formula = reportAttr(child, "rpt:formula");
+		if (name === void 0 || formula === void 0) continue;
+		functions.push({
+			name,
+			formula
+		});
+	}
+	return functions;
+}
+function readGroup(element) {
+	const group = {
+		functions: readFunctions(element),
+		groups: []
+	};
+	const groupExpression = reportAttr(element, "rpt:group-expression");
+	if (groupExpression !== void 0) group.groupExpression = groupExpression;
+	const sortExpression = reportAttr(element, "rpt:sort-expression");
+	if (sortExpression !== void 0) group.sortExpression = sortExpression;
+	const sortAscending = parseOptionalBoolean(require_xml_query.attrValue(element, "rpt:sort-ascending"));
+	if (sortAscending !== void 0) group.sortAscending = sortAscending;
+	const startNewColumn = parseOptionalBoolean(require_xml_query.attrValue(element, "rpt:start-new-column"));
+	if (startNewColumn !== void 0) group.startNewColumn = startNewColumn;
+	const resetPageNumber = parseOptionalBoolean(require_xml_query.attrValue(element, "rpt:reset-page-number"));
+	if (resetPageNumber !== void 0) group.resetPageNumber = resetPageNumber;
+	const keepTogether = reportAttr(element, "rpt:keep-together");
+	if (keepTogether !== void 0) group.keepTogether = keepTogether;
+	const header = readBandIfPresent(element, "rpt:group-header", "group-header");
+	if (header !== void 0) group.header = header;
+	const footer = readBandIfPresent(element, "rpt:group-footer", "group-footer");
+	if (footer !== void 0) group.footer = footer;
+	for (const child of element.children) if (child.type === "element" && child.tag === GROUP_TAG) group.groups.push(readGroup(child));
+	return group;
+}
+function findDetail(container) {
+	const detail = require_xml_query.findChildElement(container.children, "rpt:detail");
+	if (detail !== void 0) return readBand(detail, "detail");
+	const group = require_xml_query.findChildElement(container.children, GROUP_TAG);
+	return group === void 0 ? void 0 : findDetail(group);
+}
+function readOdbReport(pkg, reportName) {
+	const component = require_typed_odb_read.resolveOdbComponent(pkg, "report", reportName);
+	const contentPart = require_typed_odb_subdocument.subDocumentPackage(pkg, component.href).parts[CONTENT_PART];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdbReport: report "${reportName}" sub-document ${component.href}/${CONTENT_PART} is not an XML part`);
+	const contentRoot = require_xml_query.rootElement(contentPart.nodes);
+	const body = contentRoot === void 0 ? void 0 : require_xml_query.findChildElement(contentRoot.children, "office:body");
+	const reportElement = body === void 0 ? void 0 : require_xml_query.findChildElement(body.children, "office:report");
+	if (reportElement === void 0) throw new Error(`readOdbReport: report "${reportName}" sub-document ${component.href}/${CONTENT_PART} has no office:body/office:report element`);
+	const groups = [];
+	for (const child of reportElement.children) if (child.type === "element" && child.tag === GROUP_TAG) groups.push(readGroup(child));
+	const report = {
+		name: component.name,
+		href: component.href,
+		groups,
+		functions: readFunctions(reportElement)
+	};
+	const command = reportAttr(reportElement, "rpt:command");
+	if (command !== void 0) report.command = command;
+	const commandType = reportAttr(reportElement, "rpt:command-type");
+	if (commandType !== void 0) report.commandType = commandType;
+	const caption = reportAttr(reportElement, "office:caption");
+	if (caption !== void 0) report.caption = caption;
+	const mimeType = reportAttr(reportElement, "office:mimetype");
+	if (mimeType !== void 0) report.mimeType = mimeType;
+	const reportHeader = readBandIfPresent(reportElement, "rpt:report-header", "report-header");
+	if (reportHeader !== void 0) report.reportHeader = reportHeader;
+	const pageHeader = readBandIfPresent(reportElement, "rpt:page-header", "page-header");
+	if (pageHeader !== void 0) report.pageHeader = pageHeader;
+	const detail = findDetail(reportElement);
+	if (detail !== void 0) report.detail = detail;
+	const pageFooter = readBandIfPresent(reportElement, "rpt:page-footer", "page-footer");
+	if (pageFooter !== void 0) report.pageFooter = pageFooter;
+	const reportFooter = readBandIfPresent(reportElement, "rpt:report-footer", "report-footer");
+	if (reportFooter !== void 0) report.reportFooter = reportFooter;
+	return report;
+}
+//#endregion
+exports.readOdbReport = readOdbReport;

package/dist/typed/odb/report.d.cts

@@ -0,0 +1,48 @@
+import { Package } from "../../model/package.cjs";
+//#region src/typed/odb/report.d.ts
+interface OdbReportElement {
+  tag: string;
+  name?: string;
+  text?: string;
+  formula?: string;
+  dataField?: string;
+}
+interface OdbReportBand {
+  kind: 'report-header' | 'page-header' | 'group-header' | 'detail' | 'group-footer' | 'page-footer' | 'report-footer';
+  name?: string;
+  elements: OdbReportElement[];
+}
+interface OdbReportFunction {
+  name: string;
+  formula: string;
+}
+interface OdbReportGroup {
+  groupExpression?: string;
+  sortExpression?: string;
+  sortAscending?: boolean;
+  startNewColumn?: boolean;
+  resetPageNumber?: boolean;
+  keepTogether?: string;
+  header?: OdbReportBand;
+  footer?: OdbReportBand;
+  functions: OdbReportFunction[];
+  groups: OdbReportGroup[];
+}
+interface OdbReport {
+  name: string;
+  href: string;
+  command?: string;
+  commandType?: string;
+  caption?: string;
+  mimeType?: string;
+  reportHeader?: OdbReportBand;
+  pageHeader?: OdbReportBand;
+  groups: OdbReportGroup[];
+  detail?: OdbReportBand;
+  pageFooter?: OdbReportBand;
+  reportFooter?: OdbReportBand;
+  functions: OdbReportFunction[];
+}
+declare function readOdbReport(pkg: Package, reportName: string): OdbReport;
+//#endregion
+export { OdbReport, OdbReportBand, OdbReportElement, OdbReportFunction, OdbReportGroup, readOdbReport };

package/dist/typed/odb/report.d.ts

@@ -0,0 +1,48 @@
+import { Package } from "../../model/package.js";
+//#region src/typed/odb/report.d.ts
+interface OdbReportElement {
+  tag: string;
+  name?: string;
+  text?: string;
+  formula?: string;
+  dataField?: string;
+}
+interface OdbReportBand {
+  kind: 'report-header' | 'page-header' | 'group-header' | 'detail' | 'group-footer' | 'page-footer' | 'report-footer';
+  name?: string;
+  elements: OdbReportElement[];
+}
+interface OdbReportFunction {
+  name: string;
+  formula: string;
+}
+interface OdbReportGroup {
+  groupExpression?: string;
+  sortExpression?: string;
+  sortAscending?: boolean;
+  startNewColumn?: boolean;
+  resetPageNumber?: boolean;
+  keepTogether?: string;
+  header?: OdbReportBand;
+  footer?: OdbReportBand;
+  functions: OdbReportFunction[];
+  groups: OdbReportGroup[];
+}
+interface OdbReport {
+  name: string;
+  href: string;
+  command?: string;
+  commandType?: string;
+  caption?: string;
+  mimeType?: string;
+  reportHeader?: OdbReportBand;
+  pageHeader?: OdbReportBand;
+  groups: OdbReportGroup[];
+  detail?: OdbReportBand;
+  pageFooter?: OdbReportBand;
+  reportFooter?: OdbReportBand;
+  functions: OdbReportFunction[];
+}
+declare function readOdbReport(pkg: Package, reportName: string): OdbReport;
+//#endregion
+export { OdbReport, OdbReportBand, OdbReportElement, OdbReportFunction, OdbReportGroup, readOdbReport };

package/dist/typed/odb/report.js

@@ -0,0 +1,160 @@
+import { decodeXmlText } from "../../xml/entities.js";
+import { attrValue, findChildElement, rootElement } from "../../xml/query.js";
+import { resolveOdbComponent } from "./read.js";
+import { subDocumentPackage } from "./subdocument.js";
+//#region src/typed/odb/report.ts
+const CONTENT_PART = "content.xml";
+const GROUP_TAG = "rpt:group";
+const FUNCTION_TAG = "rpt:function";
+const REPORT_ELEMENT_TAG = "rpt:report-element";
+const REPORT_COMPONENT_TAG = "rpt:report-component";
+const RPT_TAG_PREFIX = "rpt:";
+const FIELD_FORMULA_PREFIX = "field:[";
+const FIELD_FORMULA_SUFFIX = "]";
+function reportAttr(element, name) {
+	const raw = attrValue(element, name);
+	return raw === void 0 ? void 0 : decodeXmlText(raw);
+}
+function parseOptionalBoolean(raw) {
+	return raw === void 0 ? void 0 : raw === "true";
+}
+function boundFieldName(formula) {
+	if (formula === void 0 || !formula.startsWith(FIELD_FORMULA_PREFIX) || !formula.endsWith(FIELD_FORMULA_SUFFIX)) return;
+	const inner = formula.slice(7, formula.length - 1);
+	return inner.length === 0 ? void 0 : inner;
+}
+function elementText(element) {
+	let text = "";
+	for (const child of element.children) if (child.type === "text") text += decodeXmlText(child.value);
+	else if (child.type === "element") text += elementText(child);
+	return text;
+}
+function reportElementChild(element) {
+	return findChildElement(element.children, REPORT_ELEMENT_TAG);
+}
+function readReportElement(element, reportElement) {
+	const control = { tag: element.tag };
+	const component = findChildElement(reportElement.children, REPORT_COMPONENT_TAG);
+	const name = component === void 0 ? void 0 : reportAttr(component, "draw:name");
+	if (name !== void 0) control.name = name;
+	const formula = reportAttr(element, "rpt:formula");
+	if (formula !== void 0) control.formula = formula;
+	let text = "";
+	for (const child of element.children) if (child.type === "text") text += decodeXmlText(child.value);
+	else if (child.type === "element" && !child.tag.startsWith(RPT_TAG_PREFIX)) text += elementText(child);
+	if (text.length > 0) control.text = text;
+	const dataField = boundFieldName(formula);
+	if (dataField !== void 0) control.dataField = dataField;
+	return control;
+}
+function collectControls(nodes, controls) {
+	for (const node of nodes) {
+		if (node.type !== "element") continue;
+		if (node.tag.startsWith(RPT_TAG_PREFIX)) {
+			const reportElement = reportElementChild(node);
+			if (reportElement !== void 0) {
+				controls.push(readReportElement(node, reportElement));
+				continue;
+			}
+		}
+		collectControls(node.children, controls);
+	}
+}
+function readBand(element, kind) {
+	const elements = [];
+	collectControls(element.children, elements);
+	const band = {
+		kind,
+		elements
+	};
+	const table = findChildElement(element.children, "table:table");
+	const name = table === void 0 ? void 0 : reportAttr(table, "table:name");
+	if (name !== void 0) band.name = name;
+	return band;
+}
+function readBandIfPresent(container, tag, kind) {
+	const element = findChildElement(container.children, tag);
+	return element === void 0 ? void 0 : readBand(element, kind);
+}
+function readFunctions(container) {
+	const functions = [];
+	for (const child of container.children) {
+		if (child.type !== "element" || child.tag !== FUNCTION_TAG) continue;
+		const name = reportAttr(child, "rpt:name");
+		const formula = reportAttr(child, "rpt:formula");
+		if (name === void 0 || formula === void 0) continue;
+		functions.push({
+			name,
+			formula
+		});
+	}
+	return functions;
+}
+function readGroup(element) {
+	const group = {
+		functions: readFunctions(element),
+		groups: []
+	};
+	const groupExpression = reportAttr(element, "rpt:group-expression");
+	if (groupExpression !== void 0) group.groupExpression = groupExpression;
+	const sortExpression = reportAttr(element, "rpt:sort-expression");
+	if (sortExpression !== void 0) group.sortExpression = sortExpression;
+	const sortAscending = parseOptionalBoolean(attrValue(element, "rpt:sort-ascending"));
+	if (sortAscending !== void 0) group.sortAscending = sortAscending;
+	const startNewColumn = parseOptionalBoolean(attrValue(element, "rpt:start-new-column"));
+	if (startNewColumn !== void 0) group.startNewColumn = startNewColumn;
+	const resetPageNumber = parseOptionalBoolean(attrValue(element, "rpt:reset-page-number"));
+	if (resetPageNumber !== void 0) group.resetPageNumber = resetPageNumber;
+	const keepTogether = reportAttr(element, "rpt:keep-together");
+	if (keepTogether !== void 0) group.keepTogether = keepTogether;
+	const header = readBandIfPresent(element, "rpt:group-header", "group-header");
+	if (header !== void 0) group.header = header;
+	const footer = readBandIfPresent(element, "rpt:group-footer", "group-footer");
+	if (footer !== void 0) group.footer = footer;
+	for (const child of element.children) if (child.type === "element" && child.tag === GROUP_TAG) group.groups.push(readGroup(child));
+	return group;
+}
+function findDetail(container) {
+	const detail = findChildElement(container.children, "rpt:detail");
+	if (detail !== void 0) return readBand(detail, "detail");
+	const group = findChildElement(container.children, GROUP_TAG);
+	return group === void 0 ? void 0 : findDetail(group);
+}
+function readOdbReport(pkg, reportName) {
+	const component = resolveOdbComponent(pkg, "report", reportName);
+	const contentPart = subDocumentPackage(pkg, component.href).parts[CONTENT_PART];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdbReport: report "${reportName}" sub-document ${component.href}/${CONTENT_PART} is not an XML part`);
+	const contentRoot = rootElement(contentPart.nodes);
+	const body = contentRoot === void 0 ? void 0 : findChildElement(contentRoot.children, "office:body");
+	const reportElement = body === void 0 ? void 0 : findChildElement(body.children, "office:report");
+	if (reportElement === void 0) throw new Error(`readOdbReport: report "${reportName}" sub-document ${component.href}/${CONTENT_PART} has no office:body/office:report element`);
+	const groups = [];
+	for (const child of reportElement.children) if (child.type === "element" && child.tag === GROUP_TAG) groups.push(readGroup(child));
+	const report = {
+		name: component.name,
+		href: component.href,
+		groups,
+		functions: readFunctions(reportElement)
+	};
+	const command = reportAttr(reportElement, "rpt:command");
+	if (command !== void 0) report.command = command;
+	const commandType = reportAttr(reportElement, "rpt:command-type");
+	if (commandType !== void 0) report.commandType = commandType;
+	const caption = reportAttr(reportElement, "office:caption");
+	if (caption !== void 0) report.caption = caption;
+	const mimeType = reportAttr(reportElement, "office:mimetype");
+	if (mimeType !== void 0) report.mimeType = mimeType;
+	const reportHeader = readBandIfPresent(reportElement, "rpt:report-header", "report-header");
+	if (reportHeader !== void 0) report.reportHeader = reportHeader;
+	const pageHeader = readBandIfPresent(reportElement, "rpt:page-header", "page-header");
+	if (pageHeader !== void 0) report.pageHeader = pageHeader;
+	const detail = findDetail(reportElement);
+	if (detail !== void 0) report.detail = detail;
+	const pageFooter = readBandIfPresent(reportElement, "rpt:page-footer", "page-footer");
+	if (pageFooter !== void 0) report.pageFooter = pageFooter;
+	const reportFooter = readBandIfPresent(reportElement, "rpt:report-footer", "report-footer");
+	if (reportFooter !== void 0) report.reportFooter = reportFooter;
+	return report;
+}
+//#endregion
+export { readOdbReport };

package/dist/typed/odb/subdocument.cjs

@@ -0,0 +1,16 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/typed/odb/subdocument.ts
+const CONTENT_PART = "content.xml";
+function subDocumentPackage(pkg, prefix, options = {}) {
+	const normalised = prefix.endsWith("/") ? prefix : `${prefix}/`;
+	const parts = {};
+	for (const [path, part] of Object.entries(pkg.parts)) {
+		if (!path.startsWith(normalised)) continue;
+		const relative = path.slice(normalised.length);
+		if (relative.length > 0) parts[relative] = part;
+	}
+	if (options.allowMissingContent !== true && parts[CONTENT_PART] === void 0) throw new Error(`subDocumentPackage: package has no ${normalised}${CONTENT_PART} part`);
+	return { parts };
+}
+//#endregion
+exports.subDocumentPackage = subDocumentPackage;

package/dist/typed/odb/subdocument.d.cts

@@ -0,0 +1,8 @@
+import { Package } from "../../model/package.cjs";
+//#region src/typed/odb/subdocument.d.ts
+interface SubDocumentPackageOptions {
+  allowMissingContent?: boolean;
+}
+declare function subDocumentPackage(pkg: Package, prefix: string, options?: SubDocumentPackageOptions): Package;
+//#endregion
+export { SubDocumentPackageOptions, subDocumentPackage };

package/dist/typed/odb/subdocument.d.ts

@@ -0,0 +1,8 @@
+import { Package } from "../../model/package.js";
+//#region src/typed/odb/subdocument.d.ts
+interface SubDocumentPackageOptions {
+  allowMissingContent?: boolean;
+}
+declare function subDocumentPackage(pkg: Package, prefix: string, options?: SubDocumentPackageOptions): Package;
+//#endregion
+export { SubDocumentPackageOptions, subDocumentPackage };

package/dist/typed/odb/subdocument.js

@@ -0,0 +1,15 @@
+//#region src/typed/odb/subdocument.ts
+const CONTENT_PART = "content.xml";
+function subDocumentPackage(pkg, prefix, options = {}) {
+	const normalised = prefix.endsWith("/") ? prefix : `${prefix}/`;
+	const parts = {};
+	for (const [path, part] of Object.entries(pkg.parts)) {
+		if (!path.startsWith(normalised)) continue;
+		const relative = path.slice(normalised.length);
+		if (relative.length > 0) parts[relative] = part;
+	}
+	if (options.allowMissingContent !== true && parts[CONTENT_PART] === void 0) throw new Error(`subDocumentPackage: package has no ${normalised}${CONTENT_PART} part`);
+	return { parts };
+}
+//#endregion
+export { subDocumentPackage };