epub-codec 1.2.11 → 1.3.0

package/dist/xhtml/read.cjs

@@ -1,14 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_node = require("../xml/node.cjs");
+const require_util_base64 = require("../util/base64.cjs");
+const require_xml_parse = require("../xml/parse.cjs");
+const require_xml_build = require("../xml/build.cjs");
 const require_diagnostics = require("../diagnostics.cjs");
 const require_xml_entities = require("../xml/entities.cjs");
-const require_xml_node = require("../xml/node.cjs");
 const require_xml_query = require("../xml/query.cjs");
-const require_xml_parse = require("../xml/parse.cjs");
+const require_xhtml_footnote = require("./footnote.cjs");
 const require_image_dimensions = require("../image/dimensions.cjs");
-const require_util_base64 = require("../util/base64.cjs");
-const require_xml_build = require("../xml/build.cjs");
 const require_xhtml_context = require("./context.cjs");
-const require_xhtml_footnote = require("./footnote.cjs");
 const require_xhtml_style_constants = require("./style-constants.cjs");
 const require_xhtml_inline = require("./inline.cjs");
 const require_xhtml_list_id = require("./list-id.cjs");
@@ -100,6 +100,19 @@ function elementsWithTagSkippingInert(nodes, tag) {
 	}
 	return out;
 }
+function scanXhtmlAnchors(xml) {
+	const nodes = require_xml_parse.parseXml(xml);
+	const html = require_xml_query.rootElement(nodes);
+	const body = html === void 0 ? void 0 : require_xml_query.findChildElement(html.children, "body");
+	if (body === void 0) return {
+		idElements: /* @__PURE__ */ new Map(),
+		anchors: []
+	};
+	return {
+		idElements: buildIdElementMap(body.children),
+		anchors: elementsWithTagSkippingInert(body.children, "a").filter((anchor) => require_xml_query.attrValue(anchor, "href") !== void 0)
+	};
+}
 function readStyleResidue(html, context) {
 	const head = require_xml_query.findChildElement(html.children, "head");
 	if (head === void 0) return;
@@ -125,17 +138,27 @@ function readXhtmlBody(xml, options) {
 		source: void 0
 	};
 	const idElements = buildIdElementMap(body.children);
-	const footnoteTargetIds = /* @__PURE__ */ new Set();
+	const anchorTargets = new Map(options.extraAnchorTargets);
 	for (const anchor of elementsWithTagSkippingInert(body.children, "a")) {
-		const name = require_xhtml_footnote.isFootnoteReferenceAnchor(anchor, idElements);
-		if (name !== void 0) footnoteTargetIds.add(name);
+		const fragment = require_xhtml_footnote.sameDocumentFragment(require_xml_query.attrValue(anchor, "href"));
+		const target = fragment === void 0 ? void 0 : idElements.get(fragment);
+		if (fragment === void 0 || target === void 0 || !BLOCK_LEVEL_TAGS.has(target.tag) || anchorTargets.has(fragment)) continue;
+		anchorTargets.set(fragment, {
+			anchorType: require_xhtml_footnote.isFootnoteReference(anchor, target) ? "footnote" : "bookmark",
+			name: fragment
+		});
 	}
 	const context = {
 		resolveImage: options.resolveImage,
 		sink: options.sink,
 		sourceHref: options.sourceHref,
 		idElements,
-		footnoteTargetIds,
+		anchorTargets,
+		resolveAnchorHref: (href) => {
+			const fragment = require_xhtml_footnote.sameDocumentFragment(href);
+			if (fragment !== void 0) return anchorTargets.get(fragment);
+			return options.resolveCrossDocumentAnchorHref?.(href);
+		},
 		quoteDepth: 0
 	};
 	const state = {
@@ -208,16 +231,17 @@ function headingLevelOf(tag) {
 }
 function readBlockElement(element, state) {
 	const id = require_xml_query.attrValue(element, "id");
-	const isFootnoteTarget = id !== void 0 && state.context.footnoteTargetIds.has(id) && !require_xhtml_footnote.isFootnoteAside(element);
 	const blocks = readBlockElementInner(element, state);
-	if (!isFootnoteTarget) return blocks;
+	if (id === void 0) return blocks;
+	const target = state.context.anchorTargets.get(id);
+	if (target === void 0 || require_xhtml_footnote.isFootnoteAside(element)) return blocks;
 	return [
 		{
 			kind: "constructStart",
 			descriptor: {
 				kind: "anchor",
-				anchorType: "footnote",
-				name: id
+				anchorType: target.anchorType,
+				name: target.name
 			}
 		},
 		...blocks,
@@ -280,10 +304,16 @@ function readPreFlatRuns(nodes, context) {
 		fontFamily: require_xhtml_style_constants.MONOSPACE_FONT_FAMILY
 	}] : [];
 }
+function preFootnoteReferenceName(anchor, context) {
+	const href = require_xml_query.attrValue(anchor, "href");
+	if (href === void 0) return;
+	const target = context.resolveAnchorHref(href);
+	return target?.anchorType === "footnote" ? target.name : void 0;
+}
 function containsFootnoteReference(nodes, context) {
 	for (const node of nodes) {
 		if (node.type !== "element" || require_xhtml_context.isInertElement(node.tag)) continue;
-		if (node.tag === "a" && require_xhtml_footnote.isFootnoteReferenceAnchor(node, context.idElements) !== void 0) return true;
+		if (node.tag === "a" && preFootnoteReferenceName(node, context) !== void 0) return true;
 		if (containsFootnoteReference(node.children, context)) return true;
 	}
 	return false;
@@ -318,7 +348,7 @@ function readPreRuns(nodes, context) {
 			buffer += "\n";
 			continue;
 		}
-		const footnoteName = node.tag === "a" ? require_xhtml_footnote.isFootnoteReferenceAnchor(node, context.idElements) : void 0;
+		const footnoteName = node.tag === "a" ? preFootnoteReferenceName(node, context) : void 0;
 		if (footnoteName === void 0 && !containsFootnoteReference([node], context)) {
 			buffer += readPreText(node.children, context);
 			continue;
@@ -659,8 +689,8 @@ function readImage(element, state) {
 }
 function readAside(element, state) {
 	if (!require_xhtml_footnote.isFootnoteAside(element)) return readContainerChildren(element.children, state);
-	const name = require_xml_query.attrValue(element, "id");
-	if (name === void 0) {
+	const id = require_xml_query.attrValue(element, "id");
+	if (id === void 0) {
 		state.context.sink({
 			code: require_diagnostics.EpubDiagnosticCodes.FOOTNOTE_TARGET_UNRESOLVED,
 			severity: "warning",
@@ -675,7 +705,7 @@ function readAside(element, state) {
 			descriptor: {
 				kind: "anchor",
 				anchorType: "footnote",
-				name
+				name: state.context.anchorTargets.get(id)?.name ?? id
 			}
 		},
 		...readContainerChildren(element.children, state),
@@ -683,4 +713,6 @@ function readAside(element, state) {
 	];
 }
 //#endregion
+exports.BLOCK_LEVEL_TAGS = BLOCK_LEVEL_TAGS;
 exports.readXhtmlBody = readXhtmlBody;
+exports.scanXhtmlAnchors = scanXhtmlAnchors;

package/dist/xhtml/read.d.cts

@@ -1,20 +1,2 @@
-import { ContentBlock, SourceResidue } from "document-schema.js";
-//#region src/xhtml/read.d.ts
-interface ReadXhtmlBodyOptions {
-  readonly resolveImage: (href: string) => Uint8Array<ArrayBuffer> | undefined;
-  readonly sink: (diagnostic: {
-    code: string;
-    severity: "info" | "warning";
-    message: string;
-    href?: string;
-  }) => void;
-  readonly sourceHref: string;
-  readonly contentWidthPt: number;
-}
-interface ReadXhtmlBodyResult {
-  readonly blocks: ContentBlock[];
-  readonly source: SourceResidue | undefined;
-}
-declare function readXhtmlBody(xml: string, options: ReadXhtmlBodyOptions): ReadXhtmlBodyResult;
-//#endregion
-export { ReadXhtmlBodyOptions, ReadXhtmlBodyResult, readXhtmlBody };
+import { a as readXhtmlBody, i as XhtmlAnchorScan, n as ReadXhtmlBodyOptions, o as scanXhtmlAnchors, r as ReadXhtmlBodyResult, t as BLOCK_LEVEL_TAGS } from "../read-BMGq_D9y.cjs";
+export { BLOCK_LEVEL_TAGS, ReadXhtmlBodyOptions, ReadXhtmlBodyResult, XhtmlAnchorScan, readXhtmlBody, scanXhtmlAnchors };

package/dist/xhtml/read.d.ts

@@ -1,20 +1,2 @@
-import { ContentBlock, SourceResidue } from "document-schema.js";
-//#region src/xhtml/read.d.ts
-interface ReadXhtmlBodyOptions {
-  readonly resolveImage: (href: string) => Uint8Array<ArrayBuffer> | undefined;
-  readonly sink: (diagnostic: {
-    code: string;
-    severity: "info" | "warning";
-    message: string;
-    href?: string;
-  }) => void;
-  readonly sourceHref: string;
-  readonly contentWidthPt: number;
-}
-interface ReadXhtmlBodyResult {
-  readonly blocks: ContentBlock[];
-  readonly source: SourceResidue | undefined;
-}
-declare function readXhtmlBody(xml: string, options: ReadXhtmlBodyOptions): ReadXhtmlBodyResult;
-//#endregion
-export { ReadXhtmlBodyOptions, ReadXhtmlBodyResult, readXhtmlBody };
+import { a as readXhtmlBody, i as XhtmlAnchorScan, n as ReadXhtmlBodyOptions, o as scanXhtmlAnchors, r as ReadXhtmlBodyResult, t as BLOCK_LEVEL_TAGS } from "../read-Czqr3aop.js";
+export { BLOCK_LEVEL_TAGS, ReadXhtmlBodyOptions, ReadXhtmlBodyResult, XhtmlAnchorScan, readXhtmlBody, scanXhtmlAnchors };

package/dist/xhtml/read.js

@@ -1,13 +1,13 @@
+import { isTextLikeNode } from "../xml/node.js";
+import { bytesToBase64 } from "../util/base64.js";
+import { parseXml } from "../xml/parse.js";
+import { buildXml } from "../xml/build.js";
 import { EpubDiagnosticCodes } from "../diagnostics.js";
 import { decodeEntities, decodeTextLikeNode } from "../xml/entities.js";
-import { isTextLikeNode } from "../xml/node.js";
 import { attrValue, findChildElement, rootElement } from "../xml/query.js";
-import { parseXml } from "../xml/parse.js";
+import { isFootnoteAside, isFootnoteReference, sameDocumentFragment } from "./footnote.js";
 import { POINTS_PER_PIXEL, detectImageFormat, readImageDimensions } from "../image/dimensions.js";
-import { bytesToBase64 } from "../util/base64.js";
-import { buildXml } from "../xml/build.js";
 import { isInertElement, reportInertElementSkip } from "./context.js";
-import { isFootnoteAside, isFootnoteReferenceAnchor } from "./footnote.js";
 import { HORIZONTAL_RULE_STYLE_ID, MONOSPACE_FONT_FAMILY } from "./style-constants.js";
 import { buildInlineRuns, rebaseConstructs } from "./inline.js";
 import { mintListNumId } from "./list-id.js";
@@ -99,6 +99,19 @@ function elementsWithTagSkippingInert(nodes, tag) {
 	}
 	return out;
 }
+function scanXhtmlAnchors(xml) {
+	const nodes = parseXml(xml);
+	const html = rootElement(nodes);
+	const body = html === void 0 ? void 0 : findChildElement(html.children, "body");
+	if (body === void 0) return {
+		idElements: /* @__PURE__ */ new Map(),
+		anchors: []
+	};
+	return {
+		idElements: buildIdElementMap(body.children),
+		anchors: elementsWithTagSkippingInert(body.children, "a").filter((anchor) => attrValue(anchor, "href") !== void 0)
+	};
+}
 function readStyleResidue(html, context) {
 	const head = findChildElement(html.children, "head");
 	if (head === void 0) return;
@@ -124,17 +137,27 @@ function readXhtmlBody(xml, options) {
 		source: void 0
 	};
 	const idElements = buildIdElementMap(body.children);
-	const footnoteTargetIds = /* @__PURE__ */ new Set();
+	const anchorTargets = new Map(options.extraAnchorTargets);
 	for (const anchor of elementsWithTagSkippingInert(body.children, "a")) {
-		const name = isFootnoteReferenceAnchor(anchor, idElements);
-		if (name !== void 0) footnoteTargetIds.add(name);
+		const fragment = sameDocumentFragment(attrValue(anchor, "href"));
+		const target = fragment === void 0 ? void 0 : idElements.get(fragment);
+		if (fragment === void 0 || target === void 0 || !BLOCK_LEVEL_TAGS.has(target.tag) || anchorTargets.has(fragment)) continue;
+		anchorTargets.set(fragment, {
+			anchorType: isFootnoteReference(anchor, target) ? "footnote" : "bookmark",
+			name: fragment
+		});
 	}
 	const context = {
 		resolveImage: options.resolveImage,
 		sink: options.sink,
 		sourceHref: options.sourceHref,
 		idElements,
-		footnoteTargetIds,
+		anchorTargets,
+		resolveAnchorHref: (href) => {
+			const fragment = sameDocumentFragment(href);
+			if (fragment !== void 0) return anchorTargets.get(fragment);
+			return options.resolveCrossDocumentAnchorHref?.(href);
+		},
 		quoteDepth: 0
 	};
 	const state = {
@@ -207,16 +230,17 @@ function headingLevelOf(tag) {
 }
 function readBlockElement(element, state) {
 	const id = attrValue(element, "id");
-	const isFootnoteTarget = id !== void 0 && state.context.footnoteTargetIds.has(id) && !isFootnoteAside(element);
 	const blocks = readBlockElementInner(element, state);
-	if (!isFootnoteTarget) return blocks;
+	if (id === void 0) return blocks;
+	const target = state.context.anchorTargets.get(id);
+	if (target === void 0 || isFootnoteAside(element)) return blocks;
 	return [
 		{
 			kind: "constructStart",
 			descriptor: {
 				kind: "anchor",
-				anchorType: "footnote",
-				name: id
+				anchorType: target.anchorType,
+				name: target.name
 			}
 		},
 		...blocks,
@@ -279,10 +303,16 @@ function readPreFlatRuns(nodes, context) {
 		fontFamily: MONOSPACE_FONT_FAMILY
 	}] : [];
 }
+function preFootnoteReferenceName(anchor, context) {
+	const href = attrValue(anchor, "href");
+	if (href === void 0) return;
+	const target = context.resolveAnchorHref(href);
+	return target?.anchorType === "footnote" ? target.name : void 0;
+}
 function containsFootnoteReference(nodes, context) {
 	for (const node of nodes) {
 		if (node.type !== "element" || isInertElement(node.tag)) continue;
-		if (node.tag === "a" && isFootnoteReferenceAnchor(node, context.idElements) !== void 0) return true;
+		if (node.tag === "a" && preFootnoteReferenceName(node, context) !== void 0) return true;
 		if (containsFootnoteReference(node.children, context)) return true;
 	}
 	return false;
@@ -317,7 +347,7 @@ function readPreRuns(nodes, context) {
 			buffer += "\n";
 			continue;
 		}
-		const footnoteName = node.tag === "a" ? isFootnoteReferenceAnchor(node, context.idElements) : void 0;
+		const footnoteName = node.tag === "a" ? preFootnoteReferenceName(node, context) : void 0;
 		if (footnoteName === void 0 && !containsFootnoteReference([node], context)) {
 			buffer += readPreText(node.children, context);
 			continue;
@@ -658,8 +688,8 @@ function readImage(element, state) {
 }
 function readAside(element, state) {
 	if (!isFootnoteAside(element)) return readContainerChildren(element.children, state);
-	const name = attrValue(element, "id");
-	if (name === void 0) {
+	const id = attrValue(element, "id");
+	if (id === void 0) {
 		state.context.sink({
 			code: EpubDiagnosticCodes.FOOTNOTE_TARGET_UNRESOLVED,
 			severity: "warning",
@@ -674,7 +704,7 @@ function readAside(element, state) {
 			descriptor: {
 				kind: "anchor",
 				anchorType: "footnote",
-				name
+				name: state.context.anchorTargets.get(id)?.name ?? id
 			}
 		},
 		...readContainerChildren(element.children, state),
@@ -682,4 +712,4 @@ function readAside(element, state) {
 	];
 }
 //#endregion
-export { readXhtmlBody };
+export { BLOCK_LEVEL_TAGS, readXhtmlBody, scanXhtmlAnchors };

package/dist/xhtml/style-constants.d.cts

@@ -1,8 +1,2 @@
-//#region src/xhtml/style-constants.d.ts
-declare const HORIZONTAL_RULE_STYLE_ID = "HorizontalRule";
-declare const QUOTE_STYLE_ID = "Quote";
-declare const QUOTE_INDENT_PT = 36;
-declare const MONOSPACE_FONT_FAMILY = "Courier New";
-declare const DEFINITION_BODY_INDENT_PT = 36;
-//#endregion
+import { a as QUOTE_STYLE_ID, i as QUOTE_INDENT_PT, n as HORIZONTAL_RULE_STYLE_ID, r as MONOSPACE_FONT_FAMILY, t as DEFINITION_BODY_INDENT_PT } from "../style-constants-RVoHdmju.cjs";
 export { DEFINITION_BODY_INDENT_PT, HORIZONTAL_RULE_STYLE_ID, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID };

package/dist/xhtml/style-constants.d.ts

@@ -1,8 +1,2 @@
-//#region src/xhtml/style-constants.d.ts
-declare const HORIZONTAL_RULE_STYLE_ID = "HorizontalRule";
-declare const QUOTE_STYLE_ID = "Quote";
-declare const QUOTE_INDENT_PT = 36;
-declare const MONOSPACE_FONT_FAMILY = "Courier New";
-declare const DEFINITION_BODY_INDENT_PT = 36;
-//#endregion
+import { a as QUOTE_STYLE_ID, i as QUOTE_INDENT_PT, n as HORIZONTAL_RULE_STYLE_ID, r as MONOSPACE_FONT_FAMILY, t as DEFINITION_BODY_INDENT_PT } from "../style-constants-RVoHdmju.js";
 export { DEFINITION_BODY_INDENT_PT, HORIZONTAL_RULE_STYLE_ID, MONOSPACE_FONT_FAMILY, QUOTE_INDENT_PT, QUOTE_STYLE_ID };

package/dist/xhtml/write.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_util_base64 = require("../util/base64.cjs");
 const require_diagnostics = require("../diagnostics.cjs");
 const require_xml_entities = require("../xml/entities.cjs");
-const require_util_base64 = require("../util/base64.cjs");
 require("./style-constants.cjs");
 const require_xhtml_list_id = require("./list-id.cjs");
 let document_schema_js = require("document-schema.js");
@@ -93,6 +93,7 @@ function writeSectionConstructGroup(group, context) {
 		"epub:type": "footnote",
 		id: descriptor.name
 	}, writeSectionChildren(group.children, context))];
+	if (descriptor.kind === "anchor" && descriptor.anchorType === "bookmark") return writeBookmarkConstructGroup(descriptor.name, group, context);
 	context.sink({
 		code: require_diagnostics.EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
 		severity: "info",
@@ -101,6 +102,24 @@ function writeSectionConstructGroup(group, context) {
 	});
 	return writeSectionChildren(group.children, context);
 }
+function writeBookmarkConstructGroup(name, group, context) {
+	const written = writeSectionChildren(group.children, context);
+	const [only] = written;
+	if (written.length === 1 && only?.type === "element") return [{
+		...only,
+		attributes: [...only.attributes.filter((attribute) => attribute.name !== "id"), {
+			name: "id",
+			value: name
+		}]
+	}];
+	context.sink({
+		code: require_diagnostics.EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
+		severity: "info",
+		message: `a bookmark target ('${name}') wraps more than one written element (or none); this package's writer only restores an id attribute onto a single wrapped element, so the target's own addressability is dropped`,
+		href: context.sourceHref
+	});
+	return written;
+}
 function writeLeafBlock(block, context) {
 	switch (block.kind) {
 		case "paragraph": return [writeParagraph(block, context)];
@@ -139,12 +158,19 @@ function writeParagraphAsEmbeddedNodes(paragraph, context, wrapOrdinaryInParagra
 	const runNodes = writeRunsToNodes(paragraph.runs, paragraph.constructs, context);
 	return wrapOrdinaryInParagraph ? [element("p", {}, runNodes)] : runNodes;
 }
-function isFootnoteExtent(construct) {
-	return construct.descriptor.kind === "anchor" && construct.descriptor.anchorType === "footnote";
+function isReferenceExtent(construct) {
+	return construct.descriptor.kind === "anchor" && construct.descriptor.anchorType === "footnote" || construct.descriptor.kind === "link" && construct.descriptor.target.kind === "internal";
+}
+function referenceExtentAttrs(descriptor, context) {
+	if (descriptor.kind === "anchor") return {
+		"epub:type": "noteref",
+		href: context.resolveAnchorHref(descriptor.name)
+	};
+	return { href: context.resolveAnchorHref(descriptor.target.anchor) };
 }
 function reportUnhandledAnchorExtents(constructs, context) {
 	for (const construct of constructs ?? []) {
-		if (construct.descriptor.kind !== "anchor" || construct.descriptor.anchorType === "footnote") continue;
+		if (isReferenceExtent(construct) || construct.descriptor.kind !== "anchor") continue;
 		context.sink({
 			code: require_diagnostics.EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
 			severity: "info",
@@ -153,33 +179,32 @@ function reportUnhandledAnchorExtents(constructs, context) {
 		});
 	}
 }
-function describeUnrepresentedFootnoteExtent(extent) {
-	if (extent.endRun === extent.startRun) return `a footnote reference ('${extent.descriptor.name}') marking the boundary before run ${extent.startRun} is never reached by the write walk -- either because it sits inside another footnote reference's own winning run range, or because its own run range falls outside this paragraph's actual runs; a point anchor wraps no run text of its own, so nothing besides this reference's own <a> link is missing from the output`;
-	return `a footnote reference ('${extent.descriptor.name}') is never reached by the write walk and cannot be represented as its own <a> element -- either because it overlaps another footnote reference's own winning run range, or because its own run range falls outside this paragraph's actual runs; wherever an overlap is the cause, the run text underneath it is not lost, since it is still written, wrapped by whichever extent's range actually claims it, or written unwrapped past it, but this reference's own anchor link is not emitted regardless of cause`;
+function referenceExtentName(descriptor) {
+	return descriptor.kind === "anchor" ? descriptor.name : descriptor.target.anchor;
+}
+function describeUnrepresentedReferenceExtent(extent) {
+	const kind = extent.descriptor.kind === "anchor" ? "footnote reference" : "internal link";
+	const name = referenceExtentName(extent.descriptor);
+	if (extent.endRun === extent.startRun) return `a ${kind} ('${name}') marking the boundary before run ${extent.startRun} is never reached by the write walk -- either because it sits inside another reference's own winning run range, or because its own run range falls outside this paragraph's actual runs; a point anchor wraps no run text of its own, so nothing besides this reference's own <a> link is missing from the output`;
+	return `a ${kind} ('${name}') is never reached by the write walk and cannot be represented as its own <a> element -- either because it overlaps another reference's own winning run range, or because its own run range falls outside this paragraph's actual runs; wherever an overlap is the cause, the run text underneath it is not lost, since it is still written, wrapped by whichever extent's range actually claims it, or written unwrapped past it, but this reference's own anchor link is not emitted regardless of cause`;
 }
 function writeRunRangeNodes(runs, constructs, renderRun, renderExtentRange, context) {
 	reportUnhandledAnchorExtents(constructs, context);
-	const footnoteExtents = (constructs ?? []).filter(isFootnoteExtent);
+	const referenceExtents = (constructs ?? []).filter(isReferenceExtent);
 	const emittedExtents = /* @__PURE__ */ new Set();
 	const out = [];
 	let index = 0;
 	while (index <= runs.length) {
-		const extentsHere = footnoteExtents.filter((e) => e.startRun === index);
+		const extentsHere = referenceExtents.filter((e) => e.startRun === index);
 		for (const point of extentsHere.filter((e) => e.endRun === e.startRun)) {
 			emittedExtents.add(point);
-			out.push(element("a", {
-				"epub:type": "noteref",
-				href: `#${point.descriptor.name}`
-			}, renderExtentRange([])));
+			out.push(element("a", referenceExtentAttrs(point.descriptor, context), renderExtentRange([])));
 		}
 		const [primaryRange] = index < runs.length ? extentsHere.filter((e) => e.endRun > e.startRun) : [];
 		if (primaryRange !== void 0) {
 			emittedExtents.add(primaryRange);
 			const rangeRuns = runs.slice(primaryRange.startRun, primaryRange.endRun);
-			out.push(element("a", {
-				"epub:type": "noteref",
-				href: `#${primaryRange.descriptor.name}`
-			}, renderExtentRange(rangeRuns)));
+			out.push(element("a", referenceExtentAttrs(primaryRange.descriptor, context), renderExtentRange(rangeRuns)));
 			index = primaryRange.endRun;
 			continue;
 		}
@@ -187,12 +212,12 @@ function writeRunRangeNodes(runs, constructs, renderRun, renderExtentRange, cont
 		if (run !== void 0) out.push(...renderRun(run));
 		index += 1;
 	}
-	for (const extent of footnoteExtents) {
+	for (const extent of referenceExtents) {
 		if (emittedExtents.has(extent)) continue;
 		context.sink({
 			code: require_diagnostics.EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
 			severity: "info",
-			message: describeUnrepresentedFootnoteExtent(extent),
+			message: describeUnrepresentedReferenceExtent(extent),
 			href: context.sourceHref
 		});
 	}

package/dist/xhtml/write.d.cts

@@ -1,12 +1,2 @@
-import { i as EpubDiagnosticSink } from "../diagnostics-C0CRdoda.cjs";
-import { XmlElement } from "../xml/node.cjs";
-import { ContentBlock, ContentImageBlock } from "document-schema.js";
-//#region src/xhtml/write.d.ts
-interface XhtmlWriteContext {
-  readonly registerImage: (bytes: Uint8Array<ArrayBuffer>, format: ContentImageBlock["format"]) => string;
-  readonly sink: EpubDiagnosticSink;
-  readonly sourceHref: string;
-}
-declare function writeXhtmlBody(blocks: readonly ContentBlock[], context: XhtmlWriteContext): XmlElement;
-//#endregion
+import { n as writeXhtmlBody, t as XhtmlWriteContext } from "../write-WSIgARHT.cjs";
 export { XhtmlWriteContext, writeXhtmlBody };

package/dist/xhtml/write.d.ts

@@ -1,12 +1,2 @@
-import { i as EpubDiagnosticSink } from "../diagnostics-C0CRdoda.js";
-import { XmlElement } from "../xml/node.js";
-import { ContentBlock, ContentImageBlock } from "document-schema.js";
-//#region src/xhtml/write.d.ts
-interface XhtmlWriteContext {
-  readonly registerImage: (bytes: Uint8Array<ArrayBuffer>, format: ContentImageBlock["format"]) => string;
-  readonly sink: EpubDiagnosticSink;
-  readonly sourceHref: string;
-}
-declare function writeXhtmlBody(blocks: readonly ContentBlock[], context: XhtmlWriteContext): XmlElement;
-//#endregion
+import { n as writeXhtmlBody, t as XhtmlWriteContext } from "../write-Klo0WDhT.js";
 export { XhtmlWriteContext, writeXhtmlBody };

package/dist/xhtml/write.js

@@ -1,6 +1,6 @@
+import { base64ToBytes } from "../util/base64.js";
 import { EpubDiagnosticCodes } from "../diagnostics.js";
 import { encodeEntities } from "../xml/entities.js";
-import { base64ToBytes } from "../util/base64.js";
 import "./style-constants.js";
 import { parseListNumId } from "./list-id.js";
 import { isHeadingGroupNode, isListGroupNode, isSectionConstructGroupNode, isTreeBlockLeaf } from "document-schema.js";
@@ -92,6 +92,7 @@ function writeSectionConstructGroup(group, context) {
 		"epub:type": "footnote",
 		id: descriptor.name
 	}, writeSectionChildren(group.children, context))];
+	if (descriptor.kind === "anchor" && descriptor.anchorType === "bookmark") return writeBookmarkConstructGroup(descriptor.name, group, context);
 	context.sink({
 		code: EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
 		severity: "info",
@@ -100,6 +101,24 @@ function writeSectionConstructGroup(group, context) {
 	});
 	return writeSectionChildren(group.children, context);
 }
+function writeBookmarkConstructGroup(name, group, context) {
+	const written = writeSectionChildren(group.children, context);
+	const [only] = written;
+	if (written.length === 1 && only?.type === "element") return [{
+		...only,
+		attributes: [...only.attributes.filter((attribute) => attribute.name !== "id"), {
+			name: "id",
+			value: name
+		}]
+	}];
+	context.sink({
+		code: EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
+		severity: "info",
+		message: `a bookmark target ('${name}') wraps more than one written element (or none); this package's writer only restores an id attribute onto a single wrapped element, so the target's own addressability is dropped`,
+		href: context.sourceHref
+	});
+	return written;
+}
 function writeLeafBlock(block, context) {
 	switch (block.kind) {
 		case "paragraph": return [writeParagraph(block, context)];
@@ -138,12 +157,19 @@ function writeParagraphAsEmbeddedNodes(paragraph, context, wrapOrdinaryInParagra
 	const runNodes = writeRunsToNodes(paragraph.runs, paragraph.constructs, context);
 	return wrapOrdinaryInParagraph ? [element("p", {}, runNodes)] : runNodes;
 }
-function isFootnoteExtent(construct) {
-	return construct.descriptor.kind === "anchor" && construct.descriptor.anchorType === "footnote";
+function isReferenceExtent(construct) {
+	return construct.descriptor.kind === "anchor" && construct.descriptor.anchorType === "footnote" || construct.descriptor.kind === "link" && construct.descriptor.target.kind === "internal";
+}
+function referenceExtentAttrs(descriptor, context) {
+	if (descriptor.kind === "anchor") return {
+		"epub:type": "noteref",
+		href: context.resolveAnchorHref(descriptor.name)
+	};
+	return { href: context.resolveAnchorHref(descriptor.target.anchor) };
 }
 function reportUnhandledAnchorExtents(constructs, context) {
 	for (const construct of constructs ?? []) {
-		if (construct.descriptor.kind !== "anchor" || construct.descriptor.anchorType === "footnote") continue;
+		if (isReferenceExtent(construct) || construct.descriptor.kind !== "anchor") continue;
 		context.sink({
 			code: EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
 			severity: "info",
@@ -152,33 +178,32 @@ function reportUnhandledAnchorExtents(constructs, context) {
 		});
 	}
 }
-function describeUnrepresentedFootnoteExtent(extent) {
-	if (extent.endRun === extent.startRun) return `a footnote reference ('${extent.descriptor.name}') marking the boundary before run ${extent.startRun} is never reached by the write walk -- either because it sits inside another footnote reference's own winning run range, or because its own run range falls outside this paragraph's actual runs; a point anchor wraps no run text of its own, so nothing besides this reference's own <a> link is missing from the output`;
-	return `a footnote reference ('${extent.descriptor.name}') is never reached by the write walk and cannot be represented as its own <a> element -- either because it overlaps another footnote reference's own winning run range, or because its own run range falls outside this paragraph's actual runs; wherever an overlap is the cause, the run text underneath it is not lost, since it is still written, wrapped by whichever extent's range actually claims it, or written unwrapped past it, but this reference's own anchor link is not emitted regardless of cause`;
+function referenceExtentName(descriptor) {
+	return descriptor.kind === "anchor" ? descriptor.name : descriptor.target.anchor;
+}
+function describeUnrepresentedReferenceExtent(extent) {
+	const kind = extent.descriptor.kind === "anchor" ? "footnote reference" : "internal link";
+	const name = referenceExtentName(extent.descriptor);
+	if (extent.endRun === extent.startRun) return `a ${kind} ('${name}') marking the boundary before run ${extent.startRun} is never reached by the write walk -- either because it sits inside another reference's own winning run range, or because its own run range falls outside this paragraph's actual runs; a point anchor wraps no run text of its own, so nothing besides this reference's own <a> link is missing from the output`;
+	return `a ${kind} ('${name}') is never reached by the write walk and cannot be represented as its own <a> element -- either because it overlaps another reference's own winning run range, or because its own run range falls outside this paragraph's actual runs; wherever an overlap is the cause, the run text underneath it is not lost, since it is still written, wrapped by whichever extent's range actually claims it, or written unwrapped past it, but this reference's own anchor link is not emitted regardless of cause`;
 }
 function writeRunRangeNodes(runs, constructs, renderRun, renderExtentRange, context) {
 	reportUnhandledAnchorExtents(constructs, context);
-	const footnoteExtents = (constructs ?? []).filter(isFootnoteExtent);
+	const referenceExtents = (constructs ?? []).filter(isReferenceExtent);
 	const emittedExtents = /* @__PURE__ */ new Set();
 	const out = [];
 	let index = 0;
 	while (index <= runs.length) {
-		const extentsHere = footnoteExtents.filter((e) => e.startRun === index);
+		const extentsHere = referenceExtents.filter((e) => e.startRun === index);
 		for (const point of extentsHere.filter((e) => e.endRun === e.startRun)) {
 			emittedExtents.add(point);
-			out.push(element("a", {
-				"epub:type": "noteref",
-				href: `#${point.descriptor.name}`
-			}, renderExtentRange([])));
+			out.push(element("a", referenceExtentAttrs(point.descriptor, context), renderExtentRange([])));
 		}
 		const [primaryRange] = index < runs.length ? extentsHere.filter((e) => e.endRun > e.startRun) : [];
 		if (primaryRange !== void 0) {
 			emittedExtents.add(primaryRange);
 			const rangeRuns = runs.slice(primaryRange.startRun, primaryRange.endRun);
-			out.push(element("a", {
-				"epub:type": "noteref",
-				href: `#${primaryRange.descriptor.name}`
-			}, renderExtentRange(rangeRuns)));
+			out.push(element("a", referenceExtentAttrs(primaryRange.descriptor, context), renderExtentRange(rangeRuns)));
 			index = primaryRange.endRun;
 			continue;
 		}
@@ -186,12 +211,12 @@ function writeRunRangeNodes(runs, constructs, renderRun, renderExtentRange, cont
 		if (run !== void 0) out.push(...renderRun(run));
 		index += 1;
 	}
-	for (const extent of footnoteExtents) {
+	for (const extent of referenceExtents) {
 		if (emittedExtents.has(extent)) continue;
 		context.sink({
 			code: EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
 			severity: "info",
-			message: describeUnrepresentedFootnoteExtent(extent),
+			message: describeUnrepresentedReferenceExtent(extent),
 			href: context.sourceHref
 		});
 	}

package/dist/xml/build.d.cts

@@ -1,5 +1,2 @@
-import { XmlNode } from "./node.cjs";
-//#region src/xml/build.d.ts
-declare function buildXml(nodes: XmlNode[]): string;
-//#endregion
+import { t as buildXml } from "../build-B1UxbO20.cjs";
 export { buildXml };

package/dist/xml/build.d.ts

@@ -1,5 +1,2 @@
-import { XmlNode } from "./node.js";
-//#region src/xml/build.d.ts
-declare function buildXml(nodes: XmlNode[]): string;
-//#endregion
+import { t as buildXml } from "../build-BCUsHLYw.js";
 export { buildXml };