modern-pdf-lib 0.30.0 → 0.32.0

package/dist/{src-Tb7wHOKz.cjs → src-CeKIKI1W.cjs}

@@ -546,7 +546,7 @@ const NS_PDFAID = "http://www.aiim.org/pdfa/ns/id/";
 * Escape special characters for XML text content.
 * @internal
 */
-function escapeXml$4(str) {
+function escapeXml$5(str) {
 	const parts = [];
 	for (let i = 0; i < str.length; i++) {
 		const c = str.charCodeAt(i);
@@ -594,14 +594,14 @@ function buildXmpMetadata(meta) {
 	if (meta.title !== void 0) {
 		lines.push("  <dc:title>");
 		lines.push("    <rdf:Alt>");
-		lines.push(`      <rdf:li xml:lang="x-default">${escapeXml$4(meta.title)}</rdf:li>`);
+		lines.push(`      <rdf:li xml:lang="x-default">${escapeXml$5(meta.title)}</rdf:li>`);
 		lines.push("    </rdf:Alt>");
 		lines.push("  </dc:title>");
 	}
 	if (meta.author !== void 0) {
 		lines.push("  <dc:creator>");
 		lines.push("    <rdf:Seq>");
-		lines.push(`      <rdf:li>${escapeXml$4(meta.author)}</rdf:li>`);
+		lines.push(`      <rdf:li>${escapeXml$5(meta.author)}</rdf:li>`);
 		lines.push("    </rdf:Seq>");
 		lines.push("  </dc:creator>");
 	}
@@ -611,7 +611,7 @@ function buildXmpMetadata(meta) {
 		lines.push("    <rdf:Bag>");
 		for (const kw of keywords) {
 			const trimmed = kw.trim();
-			if (trimmed.length > 0) lines.push(`      <rdf:li>${escapeXml$4(trimmed)}</rdf:li>`);
+			if (trimmed.length > 0) lines.push(`      <rdf:li>${escapeXml$5(trimmed)}</rdf:li>`);
 		}
 		lines.push("    </rdf:Bag>");
 		lines.push("  </dc:subject>");
@@ -619,15 +619,15 @@ function buildXmpMetadata(meta) {
 	if (meta.subject !== void 0) {
 		lines.push("  <dc:description>");
 		lines.push("    <rdf:Alt>");
-		lines.push(`      <rdf:li xml:lang="x-default">${escapeXml$4(meta.subject)}</rdf:li>`);
+		lines.push(`      <rdf:li xml:lang="x-default">${escapeXml$5(meta.subject)}</rdf:li>`);
 		lines.push("    </rdf:Alt>");
 		lines.push("  </dc:description>");
 	}
-	if (meta.creator !== void 0) lines.push(`  <xmp:CreatorTool>${escapeXml$4(meta.creator)}</xmp:CreatorTool>`);
+	if (meta.creator !== void 0) lines.push(`  <xmp:CreatorTool>${escapeXml$5(meta.creator)}</xmp:CreatorTool>`);
 	if (meta.creationDate !== void 0) lines.push(`  <xmp:CreateDate>${formatXmpDate(meta.creationDate)}</xmp:CreateDate>`);
 	if (meta.modDate !== void 0) lines.push(`  <xmp:ModifyDate>${formatXmpDate(meta.modDate)}</xmp:ModifyDate>`);
-	if (meta.producer !== void 0) lines.push(`  <pdf:Producer>${escapeXml$4(meta.producer)}</pdf:Producer>`);
-	if (meta.keywords !== void 0) lines.push(`  <pdf:Keywords>${escapeXml$4(meta.keywords)}</pdf:Keywords>`);
+	if (meta.producer !== void 0) lines.push(`  <pdf:Producer>${escapeXml$5(meta.producer)}</pdf:Producer>`);
+	if (meta.keywords !== void 0) lines.push(`  <pdf:Keywords>${escapeXml$5(meta.keywords)}</pdf:Keywords>`);
 	lines.push("</rdf:Description>");
 	lines.push("</rdf:RDF>");
 	lines.push("</x:xmpmeta>");
@@ -7019,7 +7019,7 @@ function countMatches(text, regex) {
 //#region src/compliance/xmpGenerator.ts
 const encoder$2 = new TextEncoder();
 /** Escape XML special characters in a string. */
-function escapeXml$3(str) {
+function escapeXml$4(str) {
 	return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
 }
 /**
@@ -7053,35 +7053,35 @@ function generatePdfAXmp(options) {
 	if (options.title) {
 		xmp += "      <dc:title>\n";
 		xmp += "        <rdf:Alt>\n";
-		xmp += `          <rdf:li xml:lang="${lang}">${escapeXml$3(options.title)}</rdf:li>\n`;
+		xmp += `          <rdf:li xml:lang="${lang}">${escapeXml$4(options.title)}</rdf:li>\n`;
 		xmp += "        </rdf:Alt>\n";
 		xmp += "      </dc:title>\n";
 	}
 	if (options.author) {
 		xmp += "      <dc:creator>\n";
 		xmp += "        <rdf:Seq>\n";
-		xmp += `          <rdf:li>${escapeXml$3(options.author)}</rdf:li>\n`;
+		xmp += `          <rdf:li>${escapeXml$4(options.author)}</rdf:li>\n`;
 		xmp += "        </rdf:Seq>\n";
 		xmp += "      </dc:creator>\n";
 	}
 	if (options.subject) {
 		xmp += "      <dc:description>\n";
 		xmp += "        <rdf:Alt>\n";
-		xmp += `          <rdf:li xml:lang="${lang}">${escapeXml$3(options.subject)}</rdf:li>\n`;
+		xmp += `          <rdf:li xml:lang="${lang}">${escapeXml$4(options.subject)}</rdf:li>\n`;
 		xmp += "        </rdf:Alt>\n";
 		xmp += "      </dc:description>\n";
 	}
 	xmp += "    </rdf:Description>\n";
 	xmp += "    <rdf:Description rdf:about=\"\"\n";
 	xmp += "      xmlns:xmp=\"http://ns.adobe.com/xap/1.0/\">\n";
-	xmp += `      <xmp:CreatorTool>${escapeXml$3(creatorTool)}</xmp:CreatorTool>\n`;
+	xmp += `      <xmp:CreatorTool>${escapeXml$4(creatorTool)}</xmp:CreatorTool>\n`;
 	xmp += `      <xmp:CreateDate>${createDate}</xmp:CreateDate>\n`;
 	xmp += `      <xmp:ModifyDate>${modifyDate}</xmp:ModifyDate>\n`;
 	xmp += "    </rdf:Description>\n";
 	xmp += "    <rdf:Description rdf:about=\"\"\n";
 	xmp += "      xmlns:pdf=\"http://ns.adobe.com/pdf/1.3/\">\n";
-	xmp += `      <pdf:Producer>${escapeXml$3(producer)}</pdf:Producer>\n`;
-	if (options.keywords) xmp += `      <pdf:Keywords>${escapeXml$3(options.keywords)}</pdf:Keywords>\n`;
+	xmp += `      <pdf:Producer>${escapeXml$4(producer)}</pdf:Producer>\n`;
+	if (options.keywords) xmp += `      <pdf:Keywords>${escapeXml$4(options.keywords)}</pdf:Keywords>\n`;
 	xmp += "    </rdf:Description>\n";
 	xmp += "  </rdf:RDF>\n";
 	xmp += "</x:xmpmeta>\n";
@@ -17060,7 +17060,7 @@ const SECTION_TYPES = /* @__PURE__ */ new Set([
 	"BlockQuote"
 ]);
 /** Illustration types that require alt text per PDF/UA. */
-const ILLUSTRATION_TYPES = /* @__PURE__ */ new Set([
+const ILLUSTRATION_TYPES$1 = /* @__PURE__ */ new Set([
 	"Figure",
 	"Formula",
 	"Form"
@@ -17403,7 +17403,7 @@ function findPreviousHeadingInSection(current, sectionHeadings) {
 */
 function checkAltText(elements, errors) {
 	for (const elem of elements) {
-		if (!ILLUSTRATION_TYPES.has(elem.type)) continue;
+		if (!ILLUSTRATION_TYPES$1.has(elem.type)) continue;
 		if (elem.options.artifact) continue;
 		if (elem.options.altText === void 0 && elem.options.actualText === void 0) errors.push({
 			code: "UA-STRUCT-005",
@@ -20875,7 +20875,7 @@ const VAT_CATEGORY_STANDARD$1 = "S";
 /** Unit code C62 = "one" (unitless piece, UN/ECE Rec 20). */
 const UNIT_CODE_ONE$1 = "C62";
 /** Escape XML special characters in a text value. */
-function escapeXml$2(str) {
+function escapeXml$3(str) {
 	return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
 }
 /** Format a numeric monetary/quantity value with two decimal places. */
@@ -20933,13 +20933,13 @@ function computeTotals$1(lines) {
 /** Render a single trade party block (Seller or Buyer). */
 function renderParty$1(party, indent) {
 	const lines = [];
-	lines.push(`${indent}<ram:Name>${escapeXml$2(party.name)}</ram:Name>`);
+	lines.push(`${indent}<ram:Name>${escapeXml$3(party.name)}</ram:Name>`);
 	lines.push(`${indent}<ram:PostalTradeAddress>`);
-	lines.push(`${indent}  <ram:CountryID>${escapeXml$2(party.countryCode)}</ram:CountryID>`);
+	lines.push(`${indent}  <ram:CountryID>${escapeXml$3(party.countryCode)}</ram:CountryID>`);
 	lines.push(`${indent}</ram:PostalTradeAddress>`);
 	if (party.vatId !== void 0 && party.vatId !== "") {
 		lines.push(`${indent}<ram:SpecifiedTaxRegistration>`);
-		lines.push(`${indent}  <ram:ID schemeID="VA">${escapeXml$2(party.vatId)}</ram:ID>`);
+		lines.push(`${indent}  <ram:ID schemeID="VA">${escapeXml$3(party.vatId)}</ram:ID>`);
 		lines.push(`${indent}</ram:SpecifiedTaxRegistration>`);
 	}
 	return lines.join("\n");
@@ -20953,7 +20953,7 @@ function renderLine$2(line, index, currency) {
 	out.push(`        <ram:LineID>${index}</ram:LineID>`);
 	out.push("      </ram:AssociatedDocumentLineDocument>");
 	out.push("      <ram:SpecifiedTradeProduct>");
-	out.push(`        <ram:Name>${escapeXml$2(line.description)}</ram:Name>`);
+	out.push(`        <ram:Name>${escapeXml$3(line.description)}</ram:Name>`);
 	out.push("      </ram:SpecifiedTradeProduct>");
 	out.push("      <ram:SpecifiedLineTradeAgreement>");
 	out.push("        <ram:NetPriceProductTradePrice>");
@@ -20970,7 +20970,7 @@ function renderLine$2(line, index, currency) {
 	out.push(`          <ram:RateApplicablePercent>${formatPercent$1(line.taxPercent)}</ram:RateApplicablePercent>`);
 	out.push("        </ram:ApplicableTradeTax>");
 	out.push("        <ram:SpecifiedTradeSettlementLineMonetarySummation>");
-	out.push(`          <ram:LineTotalAmount currencyID="${escapeXml$2(currency)}">${formatAmount$1(net)}</ram:LineTotalAmount>`);
+	out.push(`          <ram:LineTotalAmount currencyID="${escapeXml$3(currency)}">${formatAmount$1(net)}</ram:LineTotalAmount>`);
 	out.push("        </ram:SpecifiedTradeSettlementLineMonetarySummation>");
 	out.push("      </ram:SpecifiedLineTradeSettlement>");
 	out.push("    </ram:IncludedSupplyChainTradeLineItem>");
@@ -20980,9 +20980,9 @@ function renderLine$2(line, index, currency) {
 function renderTaxGroup$1(group, currency) {
 	const out = [];
 	out.push("      <ram:ApplicableTradeTax>");
-	out.push(`        <ram:CalculatedAmount currencyID="${escapeXml$2(currency)}">${formatAmount$1(group.taxAmount)}</ram:CalculatedAmount>`);
+	out.push(`        <ram:CalculatedAmount currencyID="${escapeXml$3(currency)}">${formatAmount$1(group.taxAmount)}</ram:CalculatedAmount>`);
 	out.push("        <ram:TypeCode>VAT</ram:TypeCode>");
-	out.push(`        <ram:BasisAmount currencyID="${escapeXml$2(currency)}">${formatAmount$1(group.basisAmount)}</ram:BasisAmount>`);
+	out.push(`        <ram:BasisAmount currencyID="${escapeXml$3(currency)}">${formatAmount$1(group.basisAmount)}</ram:BasisAmount>`);
 	out.push(`        <ram:CategoryCode>${VAT_CATEGORY_STANDARD$1}</ram:CategoryCode>`);
 	out.push(`        <ram:RateApplicablePercent>${formatPercent$1(group.taxPercent)}</ram:RateApplicablePercent>`);
 	out.push("      </ram:ApplicableTradeTax>");
@@ -21010,11 +21010,11 @@ function generateCiiXml(invoice, profile = "EN16931") {
 	out.push("<rsm:CrossIndustryInvoice xmlns:rsm=\"urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100\" xmlns:ram=\"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100\" xmlns:udt=\"urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100\">");
 	out.push("  <rsm:ExchangedDocumentContext>");
 	out.push("    <ram:GuidelineSpecifiedDocumentContextParameter>");
-	out.push(`      <ram:ID>${escapeXml$2(guidelineUrn)}</ram:ID>`);
+	out.push(`      <ram:ID>${escapeXml$3(guidelineUrn)}</ram:ID>`);
 	out.push("    </ram:GuidelineSpecifiedDocumentContextParameter>");
 	out.push("  </rsm:ExchangedDocumentContext>");
 	out.push("  <rsm:ExchangedDocument>");
-	out.push(`    <ram:ID>${escapeXml$2(invoice.invoiceNumber)}</ram:ID>`);
+	out.push(`    <ram:ID>${escapeXml$3(invoice.invoiceNumber)}</ram:ID>`);
 	out.push(`    <ram:TypeCode>${COMMERCIAL_INVOICE_TYPE_CODE$1}</ram:TypeCode>`);
 	out.push("    <ram:IssueDateTime>");
 	out.push(`      <udt:DateTimeString format="102">${toDateString102$1(invoice.issueDate)}</udt:DateTimeString>`);
@@ -21032,14 +21032,14 @@ function generateCiiXml(invoice, profile = "EN16931") {
 	out.push("    </ram:ApplicableHeaderTradeAgreement>");
 	out.push("    <ram:ApplicableHeaderTradeDelivery/>");
 	out.push("    <ram:ApplicableHeaderTradeSettlement>");
-	out.push(`      <ram:InvoiceCurrencyCode>${escapeXml$2(currency)}</ram:InvoiceCurrencyCode>`);
+	out.push(`      <ram:InvoiceCurrencyCode>${escapeXml$3(currency)}</ram:InvoiceCurrencyCode>`);
 	for (const group of totals.taxGroups) out.push(renderTaxGroup$1(group, currency));
 	out.push("      <ram:SpecifiedTradeSettlementHeaderMonetarySummation>");
-	out.push(`        <ram:LineTotalAmount currencyID="${escapeXml$2(currency)}">${formatAmount$1(totals.lineTotal)}</ram:LineTotalAmount>`);
-	out.push(`        <ram:TaxBasisTotalAmount currencyID="${escapeXml$2(currency)}">${formatAmount$1(totals.lineTotal)}</ram:TaxBasisTotalAmount>`);
-	out.push(`        <ram:TaxTotalAmount currencyID="${escapeXml$2(currency)}">${formatAmount$1(totals.taxTotal)}</ram:TaxTotalAmount>`);
-	out.push(`        <ram:GrandTotalAmount currencyID="${escapeXml$2(currency)}">${formatAmount$1(totals.grandTotal)}</ram:GrandTotalAmount>`);
-	out.push(`        <ram:DuePayableAmount currencyID="${escapeXml$2(currency)}">${formatAmount$1(totals.duePayable)}</ram:DuePayableAmount>`);
+	out.push(`        <ram:LineTotalAmount currencyID="${escapeXml$3(currency)}">${formatAmount$1(totals.lineTotal)}</ram:LineTotalAmount>`);
+	out.push(`        <ram:TaxBasisTotalAmount currencyID="${escapeXml$3(currency)}">${formatAmount$1(totals.lineTotal)}</ram:TaxBasisTotalAmount>`);
+	out.push(`        <ram:TaxTotalAmount currencyID="${escapeXml$3(currency)}">${formatAmount$1(totals.taxTotal)}</ram:TaxTotalAmount>`);
+	out.push(`        <ram:GrandTotalAmount currencyID="${escapeXml$3(currency)}">${formatAmount$1(totals.grandTotal)}</ram:GrandTotalAmount>`);
+	out.push(`        <ram:DuePayableAmount currencyID="${escapeXml$3(currency)}">${formatAmount$1(totals.duePayable)}</ram:DuePayableAmount>`);
 	out.push("      </ram:SpecifiedTradeSettlementHeaderMonetarySummation>");
 	out.push("    </ram:ApplicableHeaderTradeSettlement>");
 	out.push("  </rsm:SupplyChainTradeTransaction>");
@@ -21261,7 +21261,7 @@ const PDFA4_PART = 4;
 /** PDF/A-4 revision year (`pdfaid:rev`). */
 const PDFA4_REV = "2020";
 /** Escape XML special characters in a string. */
-function escapeXml$1(str) {
+function escapeXml$2(str) {
 	return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
 }
 /**
@@ -21279,17 +21279,17 @@ function conformanceFor(level) {
 function renderExtensionSchema(s) {
 	let out = "";
 	out += "          <rdf:li rdf:parseType=\"Resource\">\n";
-	out += `            <pdfaSchema:schema>${escapeXml$1(s.schema)}</pdfaSchema:schema>\n`;
-	out += `            <pdfaSchema:namespaceURI>${escapeXml$1(s.namespaceUri)}</pdfaSchema:namespaceURI>\n`;
-	out += `            <pdfaSchema:prefix>${escapeXml$1(s.prefix)}</pdfaSchema:prefix>\n`;
+	out += `            <pdfaSchema:schema>${escapeXml$2(s.schema)}</pdfaSchema:schema>\n`;
+	out += `            <pdfaSchema:namespaceURI>${escapeXml$2(s.namespaceUri)}</pdfaSchema:namespaceURI>\n`;
+	out += `            <pdfaSchema:prefix>${escapeXml$2(s.prefix)}</pdfaSchema:prefix>\n`;
 	out += "            <pdfaSchema:property>\n";
 	out += "              <rdf:Seq>\n";
 	for (const p of s.properties) {
 		out += "                <rdf:li rdf:parseType=\"Resource\">\n";
-		out += `                  <pdfaProperty:name>${escapeXml$1(p.name)}</pdfaProperty:name>\n`;
-		out += `                  <pdfaProperty:valueType>${escapeXml$1(p.valueType)}</pdfaProperty:valueType>\n`;
+		out += `                  <pdfaProperty:name>${escapeXml$2(p.name)}</pdfaProperty:name>\n`;
+		out += `                  <pdfaProperty:valueType>${escapeXml$2(p.valueType)}</pdfaProperty:valueType>\n`;
 		out += `                  <pdfaProperty:category>${p.category}</pdfaProperty:category>\n`;
-		out += `                  <pdfaProperty:description>${escapeXml$1(p.description)}</pdfaProperty:description>\n`;
+		out += `                  <pdfaProperty:description>${escapeXml$2(p.description)}</pdfaProperty:description>\n`;
 		out += "                </rdf:li>\n";
 	}
 	out += "              </rdf:Seq>\n";
@@ -21326,7 +21326,7 @@ function buildPdfA4Xmp(options) {
 		xmp += "      xmlns:dc=\"http://purl.org/dc/elements/1.1/\">\n";
 		xmp += "      <dc:title>\n";
 		xmp += "        <rdf:Alt>\n";
-		xmp += `          <rdf:li xml:lang="x-default">${escapeXml$1(title)}</rdf:li>\n`;
+		xmp += `          <rdf:li xml:lang="x-default">${escapeXml$2(title)}</rdf:li>\n`;
 		xmp += "        </rdf:Alt>\n";
 		xmp += "      </dc:title>\n";
 		xmp += "    </rdf:Description>\n";
@@ -21400,7 +21400,7 @@ const ORDER_X_TYPE_CODES = {
 	OrderResponse: ORDER_RESPONSE_TYPE_CODE
 };
 /** Escape XML special characters in a text value. */
-function escapeXml(str) {
+function escapeXml$1(str) {
 	return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
 }
 /** Format a numeric monetary/quantity value with two decimal places. */
@@ -21457,13 +21457,13 @@ function computeTotals(lines) {
 /** Render a single trade party block (Seller or Buyer). */
 function renderParty(party, indent) {
 	const out = [];
-	out.push(`${indent}<ram:Name>${escapeXml(party.name)}</ram:Name>`);
+	out.push(`${indent}<ram:Name>${escapeXml$1(party.name)}</ram:Name>`);
 	out.push(`${indent}<ram:PostalTradeAddress>`);
-	out.push(`${indent}  <ram:CountryID>${escapeXml(party.countryCode)}</ram:CountryID>`);
+	out.push(`${indent}  <ram:CountryID>${escapeXml$1(party.countryCode)}</ram:CountryID>`);
 	out.push(`${indent}</ram:PostalTradeAddress>`);
 	if (party.vatId !== void 0 && party.vatId !== "") {
 		out.push(`${indent}<ram:SpecifiedTaxRegistration>`);
-		out.push(`${indent}  <ram:ID schemeID="VA">${escapeXml(party.vatId)}</ram:ID>`);
+		out.push(`${indent}  <ram:ID schemeID="VA">${escapeXml$1(party.vatId)}</ram:ID>`);
 		out.push(`${indent}</ram:SpecifiedTaxRegistration>`);
 	}
 	return out.join("\n");
@@ -21477,7 +21477,7 @@ function renderLine$1(line, index, currency) {
 	out.push(`        <ram:LineID>${index}</ram:LineID>`);
 	out.push("      </ram:AssociatedDocumentLineDocument>");
 	out.push("      <ram:SpecifiedTradeProduct>");
-	out.push(`        <ram:Name>${escapeXml(line.description)}</ram:Name>`);
+	out.push(`        <ram:Name>${escapeXml$1(line.description)}</ram:Name>`);
 	out.push("      </ram:SpecifiedTradeProduct>");
 	out.push("      <ram:SpecifiedLineTradeAgreement>");
 	out.push("        <ram:NetPriceProductTradePrice>");
@@ -21494,7 +21494,7 @@ function renderLine$1(line, index, currency) {
 	out.push(`          <ram:RateApplicablePercent>${formatPercent(line.taxPercent)}</ram:RateApplicablePercent>`);
 	out.push("        </ram:ApplicableTradeTax>");
 	out.push("        <ram:SpecifiedTradeSettlementLineMonetarySummation>");
-	out.push(`          <ram:LineTotalAmount currencyID="${escapeXml(currency)}">${formatAmount(net)}</ram:LineTotalAmount>`);
+	out.push(`          <ram:LineTotalAmount currencyID="${escapeXml$1(currency)}">${formatAmount(net)}</ram:LineTotalAmount>`);
 	out.push("        </ram:SpecifiedTradeSettlementLineMonetarySummation>");
 	out.push("      </ram:SpecifiedLineTradeSettlement>");
 	out.push("    </ram:IncludedSupplyChainTradeLineItem>");
@@ -21504,9 +21504,9 @@ function renderLine$1(line, index, currency) {
 function renderTaxGroup(group, currency) {
 	const out = [];
 	out.push("      <ram:ApplicableTradeTax>");
-	out.push(`        <ram:CalculatedAmount currencyID="${escapeXml(currency)}">${formatAmount(group.taxAmount)}</ram:CalculatedAmount>`);
+	out.push(`        <ram:CalculatedAmount currencyID="${escapeXml$1(currency)}">${formatAmount(group.taxAmount)}</ram:CalculatedAmount>`);
 	out.push("        <ram:TypeCode>VAT</ram:TypeCode>");
-	out.push(`        <ram:BasisAmount currencyID="${escapeXml(currency)}">${formatAmount(group.basisAmount)}</ram:BasisAmount>`);
+	out.push(`        <ram:BasisAmount currencyID="${escapeXml$1(currency)}">${formatAmount(group.basisAmount)}</ram:BasisAmount>`);
 	out.push(`        <ram:CategoryCode>${VAT_CATEGORY_STANDARD}</ram:CategoryCode>`);
 	out.push(`        <ram:RateApplicablePercent>${formatPercent(group.taxPercent)}</ram:RateApplicablePercent>`);
 	out.push("      </ram:ApplicableTradeTax>");
@@ -21516,11 +21516,11 @@ function renderTaxGroup(group, currency) {
 function renderMonetarySummation(totals, currency) {
 	const out = [];
 	out.push("      <ram:SpecifiedTradeSettlementHeaderMonetarySummation>");
-	out.push(`        <ram:LineTotalAmount currencyID="${escapeXml(currency)}">${formatAmount(totals.lineTotal)}</ram:LineTotalAmount>`);
-	out.push(`        <ram:TaxBasisTotalAmount currencyID="${escapeXml(currency)}">${formatAmount(totals.lineTotal)}</ram:TaxBasisTotalAmount>`);
-	out.push(`        <ram:TaxTotalAmount currencyID="${escapeXml(currency)}">${formatAmount(totals.taxTotal)}</ram:TaxTotalAmount>`);
-	out.push(`        <ram:GrandTotalAmount currencyID="${escapeXml(currency)}">${formatAmount(totals.grandTotal)}</ram:GrandTotalAmount>`);
-	out.push(`        <ram:DuePayableAmount currencyID="${escapeXml(currency)}">${formatAmount(totals.duePayable)}</ram:DuePayableAmount>`);
+	out.push(`        <ram:LineTotalAmount currencyID="${escapeXml$1(currency)}">${formatAmount(totals.lineTotal)}</ram:LineTotalAmount>`);
+	out.push(`        <ram:TaxBasisTotalAmount currencyID="${escapeXml$1(currency)}">${formatAmount(totals.lineTotal)}</ram:TaxBasisTotalAmount>`);
+	out.push(`        <ram:TaxTotalAmount currencyID="${escapeXml$1(currency)}">${formatAmount(totals.taxTotal)}</ram:TaxTotalAmount>`);
+	out.push(`        <ram:GrandTotalAmount currencyID="${escapeXml$1(currency)}">${formatAmount(totals.grandTotal)}</ram:GrandTotalAmount>`);
+	out.push(`        <ram:DuePayableAmount currencyID="${escapeXml$1(currency)}">${formatAmount(totals.duePayable)}</ram:DuePayableAmount>`);
 	out.push("      </ram:SpecifiedTradeSettlementHeaderMonetarySummation>");
 	return out.join("\n");
 }
@@ -21544,11 +21544,11 @@ function generateXRechnungCii(invoice, options = {}) {
 	out.push("<rsm:CrossIndustryInvoice xmlns:rsm=\"urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100\" xmlns:ram=\"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100\" xmlns:udt=\"urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100\">");
 	out.push("  <rsm:ExchangedDocumentContext>");
 	out.push("    <ram:GuidelineSpecifiedDocumentContextParameter>");
-	out.push(`      <ram:ID>${escapeXml(XRECHNUNG_GUIDELINE_URN)}</ram:ID>`);
+	out.push(`      <ram:ID>${escapeXml$1(XRECHNUNG_GUIDELINE_URN)}</ram:ID>`);
 	out.push("    </ram:GuidelineSpecifiedDocumentContextParameter>");
 	out.push("  </rsm:ExchangedDocumentContext>");
 	out.push("  <rsm:ExchangedDocument>");
-	out.push(`    <ram:ID>${escapeXml(invoice.invoiceNumber)}</ram:ID>`);
+	out.push(`    <ram:ID>${escapeXml$1(invoice.invoiceNumber)}</ram:ID>`);
 	out.push(`    <ram:TypeCode>${COMMERCIAL_INVOICE_TYPE_CODE}</ram:TypeCode>`);
 	out.push("    <ram:IssueDateTime>");
 	out.push(`      <udt:DateTimeString format="102">${toDateString102(invoice.issueDate)}</udt:DateTimeString>`);
@@ -21557,7 +21557,7 @@ function generateXRechnungCii(invoice, options = {}) {
 	out.push("  <rsm:SupplyChainTradeTransaction>");
 	for (const [i, line] of invoice.lines.entries()) out.push(renderLine$1(line, i + 1, currency));
 	out.push("    <ram:ApplicableHeaderTradeAgreement>");
-	if (buyerReference !== void 0 && buyerReference !== "") out.push(`      <ram:BuyerReference>${escapeXml(buyerReference)}</ram:BuyerReference>`);
+	if (buyerReference !== void 0 && buyerReference !== "") out.push(`      <ram:BuyerReference>${escapeXml$1(buyerReference)}</ram:BuyerReference>`);
 	out.push("      <ram:SellerTradeParty>");
 	out.push(renderParty(invoice.seller, "        "));
 	out.push("      </ram:SellerTradeParty>");
@@ -21567,7 +21567,7 @@ function generateXRechnungCii(invoice, options = {}) {
 	out.push("    </ram:ApplicableHeaderTradeAgreement>");
 	out.push("    <ram:ApplicableHeaderTradeDelivery/>");
 	out.push("    <ram:ApplicableHeaderTradeSettlement>");
-	out.push(`      <ram:InvoiceCurrencyCode>${escapeXml(currency)}</ram:InvoiceCurrencyCode>`);
+	out.push(`      <ram:InvoiceCurrencyCode>${escapeXml$1(currency)}</ram:InvoiceCurrencyCode>`);
 	for (const group of totals.taxGroups) out.push(renderTaxGroup(group, currency));
 	out.push(renderMonetarySummation(totals, currency));
 	out.push("    </ram:ApplicableHeaderTradeSettlement>");
@@ -21598,11 +21598,11 @@ function generateOrderX(invoice, orderType) {
 	out.push("<rsm:SCRDMCCBDACIOMessageStructure xmlns:rsm=\"urn:un:unece:uncefact:data:standard:SCRDMCCBDACIOMessageStructure:100\" xmlns:ram=\"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:128\" xmlns:udt=\"urn:un:unece:uncefact:data:standard:UnqualifiedDataType:128\">");
 	out.push("  <rsm:ExchangedDocumentContext>");
 	out.push("    <ram:GuidelineSpecifiedDocumentContextParameter>");
-	out.push(`      <ram:ID>${escapeXml(ORDER_X_GUIDELINE_URN)}</ram:ID>`);
+	out.push(`      <ram:ID>${escapeXml$1(ORDER_X_GUIDELINE_URN)}</ram:ID>`);
 	out.push("    </ram:GuidelineSpecifiedDocumentContextParameter>");
 	out.push("  </rsm:ExchangedDocumentContext>");
 	out.push("  <rsm:ExchangedDocument>");
-	out.push(`    <ram:ID>${escapeXml(invoice.invoiceNumber)}</ram:ID>`);
+	out.push(`    <ram:ID>${escapeXml$1(invoice.invoiceNumber)}</ram:ID>`);
 	out.push(`    <ram:TypeCode>${typeCode}</ram:TypeCode>`);
 	out.push("    <ram:IssueDateTime>");
 	out.push(`      <udt:DateTimeString format="102">${toDateString102(invoice.issueDate)}</udt:DateTimeString>`);
@@ -21620,7 +21620,7 @@ function generateOrderX(invoice, orderType) {
 	out.push("    </ram:ApplicableHeaderTradeAgreement>");
 	out.push("    <ram:ApplicableHeaderTradeDelivery/>");
 	out.push("    <ram:ApplicableHeaderTradeSettlement>");
-	out.push(`      <ram:OrderCurrencyCode>${escapeXml(currency)}</ram:OrderCurrencyCode>`);
+	out.push(`      <ram:OrderCurrencyCode>${escapeXml$1(currency)}</ram:OrderCurrencyCode>`);
 	for (const group of totals.taxGroups) out.push(renderTaxGroup(group, currency));
 	out.push(renderMonetarySummation(totals, currency));
 	out.push("    </ram:ApplicableHeaderTradeSettlement>");
@@ -30416,6 +30416,823 @@ function buildBlackPointCompensationExtGState(mode) {
 	return gs;
 }
 //#endregion
+//#region src/accessibility/taggingHelpers.ts
+/**
+* The property key under which {@link tagList} records the chosen
+* {@link ListNumbering} on a list element's `options` object.
+*
+* `StructureElementOptions` has no dedicated `listNumbering` field, so
+* the value is stored as an extra (string-keyed) property on the same
+* options object.  When the structure tree is serialized this is the
+* value an attribute writer should emit as the list's `/ListNumbering`
+* entry inside an `/A` attribute dictionary whose owner is `/List`
+* (ISO 32000, Table 384):
+*
+* ```
+* /A << /O /List /ListNumbering /Decimal >>
+* ```
+*
+* Using a well-known string key (rather than a `Symbol`) keeps the
+* value plain-serializable and inspectable from tests.
+*/
+const LIST_NUMBERING_KEY = "__listNumbering";
+/**
+* Heading level → structure-type mapping for {@link tagHeading}.
+*
+* Indexed by the numeric heading level (`1`..`6`); the result is the
+* corresponding standard heading structure type (`'H1'`..`'H6'`).
+*/
+const HEADING_TYPE = {
+	1: "H1",
+	2: "H2",
+	3: "H3",
+	4: "H4",
+	5: "H5",
+	6: "H6"
+};
+/**
+* Tag a heading element of the given level.
+*
+* @param tree    The structure tree to add the element to.
+* @param parent  The parent element, or `null` to add under the root
+*                `Document` element.
+* @param level   The heading level (`1`..`6`); maps to `H1`..`H6`.
+* @param options Optional attributes (title, language, id, …).
+* @returns       The newly created heading element (type `H1`..`H6`).
+*
+* @example
+* ```ts
+* const tree = doc.createStructureTree();
+* const h2 = tagHeading(tree, null, 2, { title: 'Background' });
+* // h2.type === 'H2'
+* ```
+*/
+function tagHeading(tree, parent, level, options) {
+	return tree.addElement(parent, HEADING_TYPE[level], options);
+}
+/**
+* Tag a paragraph (`P`) element.
+*
+* @param tree    The structure tree to add the element to.
+* @param parent  The parent element, or `null` for the root.
+* @param options Optional attributes.
+* @returns       The newly created `P` element.
+*/
+function tagParagraph(tree, parent, options) {
+	return tree.addElement(parent, "P", options);
+}
+/**
+* Tag a figure (`Figure`) element with alternative text.
+*
+* The `altText` argument is required because PDF/UA mandates
+* alternative text for illustration elements.  If the caller also
+* supplies `altText` in `options`, that explicit value takes
+* precedence over the positional argument.
+*
+* @param tree    The structure tree to add the element to.
+* @param parent  The parent element, or `null` for the root.
+* @param altText Alternative text describing the figure.
+* @param options Optional additional attributes.
+* @returns       The newly created `Figure` element with `/Alt` set.
+*/
+function tagFigure(tree, parent, altText, options) {
+	const merged = {
+		altText,
+		...options
+	};
+	return tree.addElement(parent, "Figure", merged);
+}
+/**
+* Tag a link (`Link`) element.
+*
+* @param tree    The structure tree to add the element to.
+* @param parent  The parent element, or `null` for the root.
+* @param options Optional attributes.
+* @returns       The newly created `Link` element.
+*/
+function tagLink(tree, parent, options) {
+	return tree.addElement(parent, "Link", options);
+}
+/**
+* Tag a list (`L`) element and record its numbering style.
+*
+* The chosen {@link ListNumbering} is stored on the returned element's
+* `options` object under {@link LIST_NUMBERING_KEY} (since
+* `StructureElementOptions` has no dedicated field).  A serializer can
+* emit it as the list's `/ListNumbering` attribute (ISO 32000,
+* Table 384) inside an `/A` dictionary owned by `/List`.
+*
+* @param tree      The structure tree to add the element to.
+* @param parent    The parent element, or `null` for the root.
+* @param numbering The list numbering style (default `'None'`).
+* @param options   Optional additional attributes.
+* @returns         The newly created `L` element.
+*/
+function tagList(tree, parent, numbering = "None", options) {
+	const list = tree.addElement(parent, "L", options);
+	list.options[LIST_NUMBERING_KEY] = numbering;
+	return list;
+}
+/**
+* Tag a list item under a list, building the conventional
+* `LI` → (`Lbl`, `LBody`) substructure.
+*
+* @param tree    The structure tree to add the elements to.
+* @param list    The parent `L` (list) element.
+* @param options Optional attributes for the `LI` element.
+* @returns       The created `item` (`LI`), `label` (`Lbl`) and
+*                `body` (`LBody`) elements.
+*
+* @example
+* ```ts
+* const list = tagList(tree, null, 'Decimal');
+* const { item, label, body } = tagListItem(tree, list);
+* // item.type === 'LI', label.type === 'Lbl', body.type === 'LBody'
+* ```
+*/
+function tagListItem(tree, list, options) {
+	const item = tree.addElement(list, "LI", options);
+	return {
+		item,
+		label: tree.addElement(item, "Lbl"),
+		body: tree.addElement(item, "LBody")
+	};
+}
+/**
+* Tag a table (`Table`) element.
+*
+* @param tree    The structure tree to add the element to.
+* @param parent  The parent element, or `null` for the root.
+* @param options Optional attributes.
+* @returns       The newly created `Table` element.
+*/
+function tagTable(tree, parent, options) {
+	return tree.addElement(parent, "Table", options);
+}
+/**
+* Tag a table row (`TR`) under a table.
+*
+* @param tree   The structure tree to add the element to.
+* @param table  The parent `Table` element.
+* @returns      The newly created `TR` element.
+*/
+function tagTableRow(tree, table) {
+	return tree.addElement(table, "TR");
+}
+/**
+* Tag a table header cell (`TH`) under a row, recording its scope.
+*
+* The `scope` is stored in the element's options (`/Scope` attribute,
+* one of `Row`, `Column`, or `Both`) and is used by table-header
+* validation to associate header cells with the cells they describe.
+*
+* @param tree    The structure tree to add the element to.
+* @param row     The parent `TR` element.
+* @param scope   The header scope (default `'Column'`).
+* @param options Optional additional attributes (e.g. colSpan/rowSpan).
+* @returns       The newly created `TH` element with `scope` set.
+*/
+function tagTableHeaderCell(tree, row, scope = "Column", options) {
+	const merged = {
+		...options,
+		scope
+	};
+	return tree.addElement(row, "TH", merged);
+}
+/**
+* Tag a table data cell (`TD`) under a row.
+*
+* @param tree    The structure tree to add the element to.
+* @param row     The parent `TR` element.
+* @param options Optional attributes (e.g. colSpan/rowSpan).
+* @returns       The newly created `TD` element.
+*/
+function tagTableDataCell(tree, row, options) {
+	return tree.addElement(row, "TD", options);
+}
+//#endregion
+//#region src/accessibility/pdfUa2.ts
+/** The AIIM PDF/UA identification namespace URI (used in the XMP packet). */
+const PDFUA_ID_NS = "http://www.aiim.org/pdfua/ns/id/";
+/** The PDF/UA part identified by this module's XMP. */
+const PDFUA2_PART = 2;
+/**
+* The PDF/UA-2 revision year.  ISO 14289-2 was published in 2024, which the
+* AIIM `pdfuaid:rev` field records as a four-digit year.
+*/
+const PDFUA2_REV = 2024;
+/** Illustration types that require alternative text under PDF/UA-2. */
+const ILLUSTRATION_TYPES = /* @__PURE__ */ new Set([
+	"Figure",
+	"Formula",
+	"Form"
+]);
+/**
+* Validate a PDF document against PDF/UA-2 (ISO 14289-2) requirements.
+*
+* The check reuses {@link validatePdfUa} for the shared tagging, language,
+* MarkInfo, and metadata requirements, then layers the PDF 2.0 / UA-2
+* specific requirements on top:
+*
+* - **UA2-STRUCT-001** — a structure tree must exist (tagged PDF).
+* - **UA2-NS-001** — the structure tree must declare structure
+*   `/Namespaces` (PDF/UA-2 builds on PDF 2.0 namespaces).
+* - **UA2-LANG-001** — the document must declare a natural language
+*   (`/Lang`).
+* - **UA2-FIG-001** — every figure must carry alternative text.
+*
+* Each failure is mapped to an ISO 14289-2 clause string.  The returned
+* result is `conformant` only when there are no issues.
+*
+* @param doc  The PDF document to validate.
+* @returns    A {@link PdfUa2Result} describing conformance and issues.
+*
+* @example
+* ```ts
+* import { createPdf } from 'modern-pdf-lib';
+* import { validatePdfUa2 } from 'modern-pdf-lib/accessibility';
+*
+* const doc = createPdf();
+* const result = validatePdfUa2(doc);
+* if (!result.conformant) {
+*   for (const issue of result.issues) {
+*     console.error(`[${issue.code}] ${issue.message} (§${issue.clause})`);
+*   }
+* }
+* ```
+*/
+function validatePdfUa2(doc) {
+	const issues = [];
+	const tree = doc.getStructureTree();
+	if (!tree) issues.push({
+		code: "UA2-STRUCT-001",
+		message: "Document has no structure tree (/StructTreeRoot). PDF/UA-2 requires a fully tagged PDF 2.0 document with logical structure.",
+		clause: "8.2"
+	});
+	if (!hasDeclaredNamespaces(tree)) issues.push({
+		code: "UA2-NS-001",
+		message: "Structure tree does not declare structure /Namespaces. PDF/UA-2 builds on PDF 2.0 structure namespaces (ISO 32000-2 §14.7.4); the StructTreeRoot must declare its namespaces.",
+		clause: "8.2.2"
+	});
+	const lang = doc.getLanguage();
+	if (lang === void 0 || lang.trim().length === 0) issues.push({
+		code: "UA2-LANG-001",
+		message: "Document has no natural language (/Lang). PDF/UA-2 requires the document catalog to specify a default natural language.",
+		clause: "7.2"
+	});
+	if (tree) for (const elem of tree.getAllElements()) {
+		if (!ILLUSTRATION_TYPES.has(elem.type)) continue;
+		if (elem.options.artifact) continue;
+		const alt = elem.options.altText;
+		const actual = elem.options.actualText;
+		const hasAlt = alt !== void 0 && alt.trim().length > 0;
+		const hasActual = actual !== void 0 && actual.trim().length > 0;
+		if (!hasAlt && !hasActual) issues.push({
+			code: "UA2-FIG-001",
+			message: `${elem.type} element has no /Alt or /ActualText. PDF/UA-2 requires alternative text for all non-decorative illustration elements.`,
+			clause: "7.3"
+		});
+	}
+	const ua1 = validatePdfUa(doc);
+	for (const err of ua1.errors) {
+		if (isCoveredByUa2(err.code)) continue;
+		issues.push({
+			code: `UA2-${err.code}`,
+			message: err.message,
+			clause: mapUa1Clause(err.clause)
+		});
+	}
+	return {
+		conformant: issues.length === 0,
+		issues
+	};
+}
+/**
+* Build an XMP packet (RDF/XML) that identifies a document as PDF/UA-2.
+*
+* The packet declares the AIIM PDF/UA identification schema
+* (`pdfuaid`, namespace `http://www.aiim.org/pdfua/ns/id/`) with:
+*
+* - `pdfuaid:part` = `2` — the PDF/UA part (ISO 14289-2);
+* - `pdfuaid:rev`  = the revision year of the standard.
+*
+* The result is a serialized, packet-wrapped XMP string suitable for
+* embedding as the document's `/Metadata` stream.
+*
+* @returns  The serialized PDF/UA-2 identification XMP packet.
+*
+* @example
+* ```ts
+* import { buildPdfUa2Xmp } from 'modern-pdf-lib/accessibility';
+*
+* doc.setXmpMetadata(buildPdfUa2Xmp());
+* ```
+*/
+function buildPdfUa2Xmp() {
+	return [
+		"<?xpacket begin=\"\" id=\"W5M0MpCehiHzreSzNTczkc9d\"?>",
+		"<x:xmpmeta xmlns:x=\"adobe:ns:meta/\">",
+		"  <rdf:RDF xmlns:rdf=\"http://www.w3.org/1999/02/22-rdf-syntax-ns#\">",
+		`    <rdf:Description rdf:about=""`,
+		`        xmlns:pdfuaid="${PDFUA_ID_NS}">`,
+		`      <pdfuaid:part>${PDFUA2_PART}</pdfuaid:part>`,
+		`      <pdfuaid:rev>${PDFUA2_REV}</pdfuaid:rev>`,
+		"    </rdf:Description>",
+		"  </rdf:RDF>",
+		"</x:xmpmeta>",
+		"<?xpacket end=\"w\"?>"
+	].join("\n");
+}
+/**
+* Determine whether a structure tree declares one or more structure
+* namespaces.
+*
+* The in-memory {@link PdfStructureTree} model does not yet carry a
+* first-class namespaces field, so callers declare namespaces by attaching
+* a `namespaces` array (of namespace URI strings, or namespace descriptor
+* objects) to the tree.  This helper reads that field defensively and also
+* recognizes a per-element `namespace` option as evidence of namespace use.
+*
+* @internal
+*/
+function hasDeclaredNamespaces(tree) {
+	if (!tree) return false;
+	const declared = tree.namespaces;
+	if (Array.isArray(declared) && declared.length > 0) return true;
+	for (const elem of tree.getAllElements()) {
+		const ns = elem.options.namespace;
+		if (typeof ns === "string" && ns.length > 0) return true;
+	}
+	return false;
+}
+/**
+* Whether a PDF/UA-1 error code is already represented by a dedicated
+* UA-2 issue produced above (to avoid duplicate structure-tree / language
+* findings).
+*
+* @internal
+*/
+function isCoveredByUa2(ua1Code) {
+	return ua1Code === "UA-STRUCT-001" || ua1Code === "UA-STRUCT-002" || ua1Code === "UA-META-001" || ua1Code === "UA-META-002" || ua1Code === "UA-META-003";
+}
+/**
+* Map a PDF/UA-1 (ISO 14289-1) clause reference onto the corresponding
+* PDF/UA-2 (ISO 14289-2) clause.  The two standards share most clause
+* numbering; when a UA-1 clause is absent we fall back to the general
+* UA-2 conformance clause.
+*
+* @internal
+*/
+function mapUa1Clause(ua1Clause) {
+	if (ua1Clause === void 0 || ua1Clause.length === 0) return "5";
+	return ua1Clause;
+}
+//#endregion
+//#region src/accessibility/autoTag.ts
+/** Default heading-detection scale relative to body text size. */
+const DEFAULT_HEADING_SCALE = 1.2;
+/**
+* Maximum vertical gap (in page-space units, as a fraction of the run's
+* font size) within which two text runs are considered to belong to the
+* same visual line.  Runs whose baselines are within this fraction of an
+* em are merged onto one line.
+*/
+const SAME_LINE_FRACTION = .5;
+/** Highest heading level tag supported. */
+const MAX_HEADING_LEVEL = 6;
+/**
+* Infer a coarse logical structure for a single untagged page and add the
+* inferred `H1`..`H6` and `P` elements to the document's structure tree.
+*
+* The procedure:
+* 1. Interpret the page into positioned text runs.
+* 2. Group runs into visual lines by their baseline y-position.
+* 3. Determine the body font size as the median run font size.
+* 4. Order lines top-to-bottom (reading order on a y-up page).
+* 5. Classify each line as a heading (font size `>= headingScale × body`)
+*    or body text; map distinct heading sizes to `H1`..`H6`
+*    (largest → `H1`).
+* 6. Emit one heading element per heading line and one `P` element per
+*    contiguous block of body lines.
+*
+* Never throws on an empty (or text-free) page — it returns all-zero
+* counts and leaves the structure tree untouched.
+*
+* @param doc        The document containing the page.
+* @param pageIndex  Zero-based index of the page to tag.
+* @param options    Optional heuristic tuning ({@link AutoTagOptions}).
+* @returns          Counts of the elements that were added.
+*/
+function autoTagPage(doc, pageIndex, options) {
+	const headingScale = options?.headingScale ?? DEFAULT_HEADING_SCALE;
+	const textItems = collectTextItems(doc, pageIndex);
+	if (textItems.length === 0) return {
+		headings: 0,
+		paragraphs: 0,
+		elements: 0
+	};
+	const lines = groupIntoLines(textItems);
+	if (lines.length === 0) return {
+		headings: 0,
+		paragraphs: 0,
+		elements: 0
+	};
+	const bodySize = medianFontSize(textItems);
+	const ordered = [...lines].sort((a, b) => b.y - a.y);
+	const headingThreshold = bodySize * headingScale;
+	const headingLevelForSize = buildHeadingLevelMap(ordered, headingThreshold);
+	const tree = doc.createStructureTree();
+	let headings = 0;
+	let paragraphs = 0;
+	let paragraphOpen = false;
+	for (const line of ordered) if (line.fontSize >= headingThreshold) {
+		paragraphOpen = false;
+		const type = `H${headingLevelForSize.get(line.fontSize) ?? 1}`;
+		tree.addElement(null, type, { title: line.text });
+		headings++;
+	} else if (!paragraphOpen) {
+		tree.addElement(null, "P");
+		paragraphs++;
+		paragraphOpen = true;
+	}
+	return {
+		headings,
+		paragraphs,
+		elements: headings + paragraphs
+	};
+}
+/**
+* Interpret the page and return only its text runs.  Returns an empty
+* array (never throws) if the page cannot be interpreted.
+*
+* @internal
+*/
+function collectTextItems(doc, pageIndex) {
+	const pageCount = doc.getPageCount();
+	if (pageIndex < 0 || pageIndex >= pageCount) return [];
+	let items = [];
+	try {
+		items = interpretPage(doc.getPage(pageIndex)).items.filter((it) => it.type === "text" && it.text.trim().length > 0);
+	} catch {
+		return [];
+	}
+	return [...items];
+}
+/**
+* Group text runs into visual lines by their baseline y-position.
+*
+* The baseline is taken from the run's text-space → page-space transform
+* (`transform[5]`, the `f` translation component).  Runs whose baselines
+* fall within {@link SAME_LINE_FRACTION} of an em of an existing line are
+* merged onto that line; the line's font size is the maximum run size.
+*
+* @internal
+*/
+function groupIntoLines(items) {
+	const sorted = [...items].sort((a, b) => b.transform[5] - a.transform[5]);
+	const lines = [];
+	for (const item of sorted) {
+		const y = item.transform[5];
+		const size = item.fontSize > 0 ? item.fontSize : Math.abs(item.transform[3]) || 1;
+		const last = lines[lines.length - 1];
+		const tolerance = size * SAME_LINE_FRACTION;
+		if (last && Math.abs(last.y - y) <= tolerance) {
+			last.text = `${last.text} ${item.text}`.trim();
+			if (size > last.fontSize) last.fontSize = size;
+		} else lines.push({
+			y,
+			fontSize: size,
+			text: item.text.trim()
+		});
+	}
+	return lines.map((l) => ({
+		y: l.y,
+		fontSize: l.fontSize,
+		text: l.text
+	}));
+}
+/**
+* Compute the median font size across all text runs.  The median is more
+* robust than the mean against a handful of oversized heading runs, so it
+* gives a reliable estimate of the body text size.
+*
+* @internal
+*/
+function medianFontSize(items) {
+	const sizes = items.map((it) => it.fontSize > 0 ? it.fontSize : Math.abs(it.transform[3])).filter((s) => s > 0).sort((a, b) => a - b);
+	if (sizes.length === 0) return 1;
+	const mid = sizes.length >> 1;
+	if (sizes.length % 2 === 1) return sizes[mid];
+	return (sizes[mid - 1] + sizes[mid]) / 2;
+}
+/**
+* Build a map from each distinct heading font size to a heading level.
+* The largest heading size becomes `H1`, the next-largest `H2`, and so on,
+* capped at {@link MAX_HEADING_LEVEL} (`H6`).
+*
+* @internal
+*/
+function buildHeadingLevelMap(lines, headingThreshold) {
+	const distinct = [...new Set(lines.filter((l) => l.fontSize >= headingThreshold).map((l) => l.fontSize))].sort((a, b) => b - a);
+	const map = /* @__PURE__ */ new Map();
+	distinct.forEach((size, index) => {
+		map.set(size, Math.min(index + 1, MAX_HEADING_LEVEL));
+	});
+	return map;
+}
+//#endregion
+//#region src/compliance/profileConvert.ts
+/** Canonical PDF/A identification namespace URI (`pdfaid`). */
+const PDFAID_NS = "http://www.aiim.org/pdfa/ns/id/";
+/**
+* Run a synchronous, pre-save PDF/A preflight over an in-memory document.
+*
+* See the module documentation for the (intentional) scope and limitations of
+* this check relative to the byte-level `validatePdfA` validator.
+*
+* @param doc   - The in-memory document to inspect. Never mutated.
+* @param level - Optional target level (e.g. `'2b'`, `'3u'`, `'PDF/A-4'`).
+*                Only used to refine messages; all checks here are
+*                level-agnostic prerequisites common to every PDF/A part.
+* @returns A (possibly empty) list of preflight issues. Never throws.
+*/
+function preflightPdfA(doc, level) {
+	const issues = [];
+	const target = level !== void 0 && level.length > 0 ? ` (${level})` : "";
+	let xmp;
+	try {
+		xmp = doc.getXmpMetadata();
+	} catch {
+		xmp = void 0;
+	}
+	if (xmp === void 0 || xmp.length === 0) issues.push({
+		code: "PDFA-001",
+		message: `XMP metadata stream is required but not set on the document${target}.`,
+		severity: "error",
+		fixable: true,
+		clause: "ISO 19005 (XMP metadata)"
+	});
+	else if (!xmp.includes("pdfaid:part")) issues.push({
+		code: "PDFA-002",
+		message: "XMP metadata does not declare PDF/A identification (pdfaid:part).",
+		severity: "error",
+		fixable: true,
+		clause: "ISO 19005 (PDF/A identification schema)"
+	});
+	if (!documentHasOutputIntent(doc)) issues.push({
+		code: "PDFA-012",
+		message: "A PDF/A output intent (/OutputIntents) with an ICC destination profile is required (none detected on the in-memory document).",
+		severity: "error",
+		fixable: true,
+		clause: "ISO 19005 (OutputIntents)"
+	});
+	let lang;
+	try {
+		lang = doc.getLanguage();
+	} catch {
+		lang = void 0;
+	}
+	if (lang === void 0 || lang.length === 0) issues.push({
+		code: "PDFA-011",
+		message: "The document language (/Lang) is not set; PDF/A recommends a BCP 47 language tag.",
+		severity: "warning",
+		fixable: true,
+		clause: "ISO 19005 (document language)"
+	});
+	let title;
+	try {
+		title = doc.getTitle();
+	} catch {
+		title = void 0;
+	}
+	if (title === void 0 || title.length === 0) issues.push({
+		code: "PDFA-014",
+		message: "The document title is not set; PDF/A requires a dc:title.",
+		severity: "warning",
+		fixable: true,
+		clause: "ISO 19005 (descriptive metadata)"
+	});
+	let pageCount = 0;
+	try {
+		pageCount = doc.getPageCount();
+	} catch {
+		pageCount = 0;
+	}
+	if (pageCount === 0) issues.push({
+		code: "PDFA-015",
+		message: "The document has no pages; a PDF/A file must contain at least one page.",
+		severity: "error",
+		fixable: false,
+		clause: "ISO 32000 (page tree)"
+	});
+	return issues;
+}
+/**
+* Best-effort, pre-save detection of an output intent on a document.
+*
+* The public {@link PdfDocument} surface exposes no output-intent accessor, so
+* this currently always returns `false` for an in-memory document. It is
+* factored out so a future output-intent API can be wired in without touching
+* the issue-mapping logic.
+*/
+function documentHasOutputIntent(_doc) {
+	return false;
+}
+/** Map a numeric part to its decimal string. */
+function partString(part) {
+	return String(part);
+}
+/** Map a conformance letter to the upper-case form stored in XMP. */
+function conformanceString(conformance) {
+	return conformance.toUpperCase();
+}
+/**
+* Remap the PDF/A identification (`pdfaid:part`, and optionally
+* `pdfaid:conformance`) inside an existing XMP packet.
+*
+* Both the **attribute** form (`pdfaid:part="3"`) and the **element** form
+* (`<pdfaid:part>3</pdfaid:part>`) are handled. When no `pdfaid:part` is
+* present, identification is injected into the first `rdf:Description` element
+* (declaring the `pdfaid` namespace on it if necessary). All other content of
+* the packet is preserved verbatim.
+*
+* This is a pure string transform; it does not parse or re-serialize the XML.
+*
+* @param xmp           - The source XMP packet string.
+* @param toPart        - Target PDF/A part (1, 2, 3 or 4).
+* @param toConformance - Optional target conformance level (`a`/`b`/`u`). When
+*                        omitted, any existing conformance is left untouched.
+* @returns The transformed XMP packet string.
+*/
+function convertPdfAConformanceXmp(xmp, toPart, toConformance) {
+	const partVal = partString(toPart);
+	let result = xmp;
+	const partAttr = /pdfaid:part\s*=\s*"[^"]*"/;
+	const partElem = /<pdfaid:part>[^<]*<\/pdfaid:part>/;
+	if (partAttr.test(result)) result = result.replace(partAttr, `pdfaid:part="${partVal}"`);
+	else if (partElem.test(result)) result = result.replace(partElem, `<pdfaid:part>${partVal}</pdfaid:part>`);
+	else {
+		result = injectIdentification(result, partVal, toConformance);
+		return result;
+	}
+	if (toConformance !== void 0) {
+		const confVal = conformanceString(toConformance);
+		const confAttr = /pdfaid:conformance\s*=\s*"[^"]*"/;
+		const confElem = /<pdfaid:conformance>[^<]*<\/pdfaid:conformance>/;
+		if (confAttr.test(result)) result = result.replace(confAttr, `pdfaid:conformance="${confVal}"`);
+		else if (confElem.test(result)) result = result.replace(confElem, `<pdfaid:conformance>${confVal}</pdfaid:conformance>`);
+		else result = addConformanceBesidePart(result, confVal);
+	}
+	return result;
+}
+/**
+* Inject a fresh `pdfaid` identification block into the first `rdf:Description`
+* element. Used when the source packet has no `pdfaid:part` at all.
+*/
+function injectIdentification(xmp, partVal, toConformance) {
+	const nsDecl = `xmlns:pdfaid="${PDFAID_NS}"`;
+	const hasNs = xmp.includes(PDFAID_NS);
+	let frag = `<pdfaid:part>${partVal}</pdfaid:part>`;
+	if (toConformance !== void 0) frag += `<pdfaid:conformance>${conformanceString(toConformance)}</pdfaid:conformance>`;
+	const selfClosing = /<rdf:Description\b([^>]*?)\/>/;
+	const scMatch = selfClosing.exec(xmp);
+	if (scMatch) {
+		const replacement = `<rdf:Description${scMatch[1] ?? ""}${hasNs ? "" : ` ${nsDecl}`}>${frag}</rdf:Description>`;
+		return xmp.replace(selfClosing, replacement);
+	}
+	const open = /<rdf:Description\b([^>]*)>/;
+	const openMatch = open.exec(xmp);
+	if (openMatch) {
+		const replacement = `<rdf:Description${openMatch[1] ?? ""}${hasNs ? "" : ` ${nsDecl}`}>${frag}`;
+		return xmp.replace(open, replacement);
+	}
+	return xmp;
+}
+/**
+* Add a `pdfaid:conformance` next to an already-present `pdfaid:part`,
+* mirroring the part's representation (attribute vs element form).
+*/
+function addConformanceBesidePart(xmp, confVal) {
+	const partElem = /(<pdfaid:part>[^<]*<\/pdfaid:part>)/;
+	if (partElem.test(xmp)) return xmp.replace(partElem, `$1<pdfaid:conformance>${confVal}</pdfaid:conformance>`);
+	const partAttr = /(pdfaid:part\s*=\s*"[^"]*")/;
+	if (partAttr.test(xmp)) return xmp.replace(partAttr, `$1 pdfaid:conformance="${confVal}"`);
+	return xmp;
+}
+//#endregion
+//#region src/compliance/rasterProfile.ts
+/**
+* VERIFIED: PDF Association "PDF Declarations" namespace URI / prefix.
+* (Some published examples use the `https://` scheme; the `http://` form
+* is the one most commonly cited and is used here for stability.)
+*/
+const PDFD_NS = "http://pdfa.org/declarations/";
+/**
+* PROVISIONAL: WTPDF declaration target URIs, keyed by conformance level.
+* The fragment form follows the PDF Association's corrected pattern
+* (`…/declarations/wtpdf#<level>1.0`) but is acknowledged as unsettled
+* (pdf-issues #395). Treat as identification hint, not normative match.
+*/
+const WTPDF_CONFORMS_TO_BASE = "http://pdfa.org/declarations/wtpdf#";
+/**
+* PROVISIONAL: PDF/R declaration target URI. ISO 23504 / PDF/Raster has
+* no published PDF Declarations URI; this follows the same pattern and is
+* non-normative.
+*/
+const PDFR_CONFORMS_TO = "http://pdfa.org/declarations/pdfr#1.0";
+/** Escape XML special characters in a string. */
+function escapeXml(str) {
+	return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+}
+/**
+* Build an XMP packet carrying a single PDF Declaration plus a plain
+* `part`/`conformance` identification block.
+*
+* The packet is intentionally minimal: it declares the verified `pdfd`
+* PDF Declarations namespace and structure, embeds the (provisional)
+* `conformsTo` target, and additionally renders the supplied `part` and
+* `conformance` values under a clearly-named, profile-local namespace so
+* that the identification facts are machine-readable even though no ISO
+* identification namespace exists for these profiles.
+*/
+function buildIdentificationXmp(identity) {
+	const { profileName, conformsTo, part, conformance } = identity;
+	let xmp = "<?xpacket begin=\"\" id=\"W5M0MpCehiHzreSzNTczkc9d\"?>\n";
+	xmp += "<x:xmpmeta xmlns:x=\"adobe:ns:meta/\">\n";
+	xmp += `  <!-- ${escapeXml(profileName)} identification marker (non-normative). -->\n`;
+	xmp += "  <rdf:RDF xmlns:rdf=\"http://www.w3.org/1999/02/22-rdf-syntax-ns#\">\n";
+	xmp += "    <rdf:Description rdf:about=\"\"\n";
+	xmp += `      xmlns:pdfd="${PDFD_NS}">\n`;
+	xmp += "      <pdfd:declarations>\n";
+	xmp += "        <rdf:Bag>\n";
+	xmp += "          <rdf:li rdf:parseType=\"Resource\">\n";
+	xmp += `            <pdfd:conformsTo>${escapeXml(conformsTo)}</pdfd:conformsTo>\n`;
+	xmp += "          </rdf:li>\n";
+	xmp += "        </rdf:Bag>\n";
+	xmp += "      </pdfd:declarations>\n";
+	xmp += "    </rdf:Description>\n";
+	xmp += "    <rdf:Description rdf:about=\"\"\n";
+	xmp += "      xmlns:pid=\"http://modern-pdf-lib/ns/profile-id/\">\n";
+	xmp += `      <pid:part>${part}</pid:part>\n`;
+	if (conformance !== void 0) xmp += `      <pid:conformance>${escapeXml(conformance)}</pid:conformance>\n`;
+	xmp += "    </rdf:Description>\n";
+	xmp += "  </rdf:RDF>\n";
+	xmp += "</x:xmpmeta>\n";
+	xmp += "<?xpacket end=\"w\"?>";
+	return xmp;
+}
+/**
+* Build a WTPDF ("Well-Tagged PDF") identification XMP packet.
+*
+* WTPDF conformance is asserted through the PDF Association's PDF
+* Declarations mechanism (VERIFIED). The `conformsTo` target URI is
+* PROVISIONAL — see the module doc comment and pdf-issues #395 for the
+* acknowledged inconsistency in its exact form. This builder produces an
+* identification marker only and does not assert or validate WTPDF
+* conformance.
+*
+* @param options - Optional part (default `1`, i.e. WTPDF 1.0) and a
+*   conformance level (WTPDF defines `'reuse'` and `'accessibility'`).
+* @returns A serialized XMP/RDF identification packet.
+*/
+function buildWtpdfIdentificationXmp(options) {
+	const part = options?.part ?? 1;
+	const conformance = options?.conformance;
+	let conformsTo = `${WTPDF_CONFORMS_TO_BASE}1.0`;
+	if (conformance === "reuse" || conformance === "accessibility") conformsTo = `${WTPDF_CONFORMS_TO_BASE}${conformance}1.0`;
+	return buildIdentificationXmp({
+		profileName: "WTPDF (Well-Tagged PDF) 1.0",
+		conformsTo,
+		part,
+		conformance
+	});
+}
+/**
+* Build a PDF/R (ISO 23504 / PDF/Raster) identification XMP packet.
+*
+* IMPORTANT: PDF/R is normatively identified by a comment marker before
+* the final `startxref` in the file trailer, NOT by XMP. There is no
+* ISO-defined XMP identification namespace for PDF/R, so this XMP marker
+* is non-normative: the `pdfd:conformsTo` target is PROVISIONAL. Use this
+* only as a supplementary, machine-readable hint alongside the required
+* trailer comment marker; it does not assert or validate PDF/R
+* conformance.
+*
+* @param options - Optional part (default `1`, i.e. ISO 23504-1 / PDF/R-1)
+*   and a conformance token.
+* @returns A serialized XMP/RDF identification packet.
+*/
+function buildPdfRIdentificationXmp(options) {
+	const part = options?.part ?? 1;
+	const conformance = options?.conformance;
+	return buildIdentificationXmp({
+		profileName: "PDF/R (ISO 23504, raster image transport and storage)",
+		conformsTo: PDFR_CONFORMS_TO,
+		part,
+		conformance
+	});
+}
+//#endregion
 //#region src/index.ts
 /** Whether initWasm has already completed successfully. */
 let wasmInitialized = false;
@@ -30569,6 +31386,12 @@ Object.defineProperty(exports, "InvalidPageSizeError", {
 		return InvalidPageSizeError;
 	}
 });
+Object.defineProperty(exports, "LIST_NUMBERING_KEY", {
+	enumerable: true,
+	get: function() {
+		return LIST_NUMBERING_KEY;
+	}
+});
 Object.defineProperty(exports, "MATHML_NAMESPACE", {
 	enumerable: true,
 	get: function() {
@@ -30893,6 +31716,12 @@ Object.defineProperty(exports, "attachOutputIntents", {
 		return attachOutputIntents;
 	}
 });
+Object.defineProperty(exports, "autoTagPage", {
+	enumerable: true,
+	get: function() {
+		return autoTagPage;
+	}
+});
 Object.defineProperty(exports, "batchFlatten", {
 	enumerable: true,
 	get: function() {
@@ -31055,6 +31884,18 @@ Object.defineProperty(exports, "buildPdfA4Xmp", {
 		return buildPdfA4Xmp;
 	}
 });
+Object.defineProperty(exports, "buildPdfRIdentificationXmp", {
+	enumerable: true,
+	get: function() {
+		return buildPdfRIdentificationXmp;
+	}
+});
+Object.defineProperty(exports, "buildPdfUa2Xmp", {
+	enumerable: true,
+	get: function() {
+		return buildPdfUa2Xmp;
+	}
+});
 Object.defineProperty(exports, "buildPdfVtDParts", {
 	enumerable: true,
 	get: function() {
@@ -31157,6 +31998,12 @@ Object.defineProperty(exports, "buildVtDpm", {
 		return buildVtDpm;
 	}
 });
+Object.defineProperty(exports, "buildWtpdfIdentificationXmp", {
+	enumerable: true,
+	get: function() {
+		return buildWtpdfIdentificationXmp;
+	}
+});
 Object.defineProperty(exports, "buildXmpMetadata", {
 	enumerable: true,
 	get: function() {
@@ -31235,6 +32082,12 @@ Object.defineProperty(exports, "computeTileGrid", {
 		return computeTileGrid;
 	}
 });
+Object.defineProperty(exports, "convertPdfAConformanceXmp", {
+	enumerable: true,
+	get: function() {
+		return convertPdfAConformanceXmp;
+	}
+});
 Object.defineProperty(exports, "convertTiffCmykToRgb", {
 	enumerable: true,
 	get: function() {
@@ -31991,6 +32844,12 @@ Object.defineProperty(exports, "pdfA4Rules", {
 		return pdfA4Rules;
 	}
 });
+Object.defineProperty(exports, "preflightPdfA", {
+	enumerable: true,
+	get: function() {
+		return preflightPdfA;
+	}
+});
 Object.defineProperty(exports, "processBatch", {
 	enumerable: true,
 	get: function() {
@@ -32255,6 +33114,66 @@ Object.defineProperty(exports, "tableToJson", {
 		return tableToJson;
 	}
 });
+Object.defineProperty(exports, "tagFigure", {
+	enumerable: true,
+	get: function() {
+		return tagFigure;
+	}
+});
+Object.defineProperty(exports, "tagHeading", {
+	enumerable: true,
+	get: function() {
+		return tagHeading;
+	}
+});
+Object.defineProperty(exports, "tagLink", {
+	enumerable: true,
+	get: function() {
+		return tagLink;
+	}
+});
+Object.defineProperty(exports, "tagList", {
+	enumerable: true,
+	get: function() {
+		return tagList;
+	}
+});
+Object.defineProperty(exports, "tagListItem", {
+	enumerable: true,
+	get: function() {
+		return tagListItem;
+	}
+});
+Object.defineProperty(exports, "tagParagraph", {
+	enumerable: true,
+	get: function() {
+		return tagParagraph;
+	}
+});
+Object.defineProperty(exports, "tagTable", {
+	enumerable: true,
+	get: function() {
+		return tagTable;
+	}
+});
+Object.defineProperty(exports, "tagTableDataCell", {
+	enumerable: true,
+	get: function() {
+		return tagTableDataCell;
+	}
+});
+Object.defineProperty(exports, "tagTableHeaderCell", {
+	enumerable: true,
+	get: function() {
+		return tagTableHeaderCell;
+	}
+});
+Object.defineProperty(exports, "tagTableRow", {
+	enumerable: true,
+	get: function() {
+		return tagTableRow;
+	}
+});
 Object.defineProperty(exports, "timestampPlugin", {
 	enumerable: true,
 	get: function() {
@@ -32357,6 +33276,12 @@ Object.defineProperty(exports, "validatePdfUa", {
 		return validatePdfUa;
 	}
 });
+Object.defineProperty(exports, "validatePdfUa2", {
+	enumerable: true,
+	get: function() {
+		return validatePdfUa2;
+	}
+});
 Object.defineProperty(exports, "validatePdfX", {
 	enumerable: true,
 	get: function() {
@@ -32412,4 +33337,4 @@ Object.defineProperty(exports, "wrapText", {
 	}
 });
 
-//# sourceMappingURL=src-Tb7wHOKz.cjs.map
+//# sourceMappingURL=src-CeKIKI1W.cjs.map