epub-codec 1.2.1 → 1.2.3

package/README.md

@@ -139,6 +139,7 @@ Every construct this package's XHTML mapping cannot represent losslessly is a do
 - **Image dimensions are derived from pixel size via the CSS reference-pixel ratio (1px = 1/96in)**, not read from any `<img width>`/`<img height>` attribute or CSS: an EPUB's own XHTML/CSS carries no reliable point-based sizing of its own, so the image's natural pixel size is the one dimension every manifest image reliably has.
 - **A GIF or SVG manifest image is not yet decoded** — `document-schema.js`'s `ContentImageBlockSchema` widened its `format` field to admit `"svg"`/`"gif"` alongside `"png"`/`"jpeg"` specifically for this package's own manifest image kinds, but this package's reader does not yet decode either one; it degrades to alt text with an `epub/image-format-unsupported` diagnostic until that decode work lands.
 - **A table cell's own construct-boundary marker (if a foreign producer's `ContentDocument` carries one) has no XHTML representation on write** and is dropped with a diagnostic — `document-schema.js`'s own `decompose` never descends into a table cell, so a cell's blocks are never grouped the way a section's are, and this package's own reader never emits one there either.
+- **A run-level anchor extent whose `anchorType` is `bookmark`, `endnote`, or `comment` (only `footnote` is recognised) has no representable EPUB spelling this package's own reader understands yet** and is reported through `epub/construct-unrepresented` on write rather than silently dropped — genuinely reachable via a cross-format bridge, since `ooxml.js`'s own docx reader emits exactly this shape for a bookmark or `w:commentRangeStart`/`End` pair whose two halves sit inside one paragraph. The run text the extent wraps is unaffected either way; only its own marker (and, for a comment, the definitions-table link a same-format write would need) goes unwritten.
 - **`dc:publisher`/`dc:contributor`/`dc:rights` have no `LayoutMetadata` field to land in** and are reported as `epub/metadata-field-unmapped` rather than silently dropped.
 
 ## Fidelity

package/dist/codec.d.cts

@@ -1425,10 +1425,10 @@ declare const epubContentCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffer>,
         endColumn: z.ZodNumber;
       }, z.core.$strip>>;
       type: z.ZodEnum<{
-        date: "date";
-        custom: "custom";
         decimal: "decimal";
         list: "list";
+        date: "date";
+        custom: "custom";
         time: "time";
         whole: "whole";
         textLength: "textLength";

package/dist/codec.d.ts

@@ -1425,10 +1425,10 @@ declare const epubContentCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffer>,
         endColumn: z.ZodNumber;
       }, z.core.$strip>>;
       type: z.ZodEnum<{
-        date: "date";
-        custom: "custom";
         decimal: "decimal";
         list: "list";
+        date: "date";
+        custom: "custom";
         time: "time";
         whole: "whole";
         textLength: "textLength";

package/dist/xhtml/write.cjs

@@ -142,11 +142,23 @@ function writeParagraphAsEmbeddedNodes(paragraph, context, wrapOrdinaryInParagra
 function isFootnoteExtent(construct) {
 	return construct.descriptor.kind === "anchor" && construct.descriptor.anchorType === "footnote";
 }
+function reportUnhandledAnchorExtents(constructs, context) {
+	for (const construct of constructs ?? []) {
+		if (construct.descriptor.kind !== "anchor" || construct.descriptor.anchorType === "footnote") continue;
+		context.sink({
+			code: require_diagnostics.EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
+			severity: "info",
+			message: `a run-level '${construct.descriptor.anchorType}' anchor ('${construct.descriptor.name}') has no representable EPUB spelling this writer states yet, so its own marker is dropped -- the run text it wraps is unaffected`,
+			href: context.sourceHref
+		});
+	}
+}
 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 writeRunRangeNodes(runs, constructs, renderRun, renderExtentRange, context) {
+	reportUnhandledAnchorExtents(constructs, context);
 	const footnoteExtents = (constructs ?? []).filter(isFootnoteExtent);
 	const emittedExtents = /* @__PURE__ */ new Set();
 	const out = [];

package/dist/xhtml/write.js

@@ -141,11 +141,23 @@ function writeParagraphAsEmbeddedNodes(paragraph, context, wrapOrdinaryInParagra
 function isFootnoteExtent(construct) {
 	return construct.descriptor.kind === "anchor" && construct.descriptor.anchorType === "footnote";
 }
+function reportUnhandledAnchorExtents(constructs, context) {
+	for (const construct of constructs ?? []) {
+		if (construct.descriptor.kind !== "anchor" || construct.descriptor.anchorType === "footnote") continue;
+		context.sink({
+			code: EpubDiagnosticCodes.CONSTRUCT_UNREPRESENTED,
+			severity: "info",
+			message: `a run-level '${construct.descriptor.anchorType}' anchor ('${construct.descriptor.name}') has no representable EPUB spelling this writer states yet, so its own marker is dropped -- the run text it wraps is unaffected`,
+			href: context.sourceHref
+		});
+	}
+}
 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 writeRunRangeNodes(runs, constructs, renderRun, renderExtentRange, context) {
+	reportUnhandledAnchorExtents(constructs, context);
 	const footnoteExtents = (constructs ?? []).filter(isFootnoteExtent);
 	const emittedExtents = /* @__PURE__ */ new Set();
 	const out = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epub-codec",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "EPUB 2/3 reading and deterministic EPUB 3 writing against the shared document-schema.js content pivot.",
   "type": "module",
   "repository": {
@@ -78,7 +78,7 @@
   "license": "MIT",
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "document-schema.js": "^6.2.0",
+    "document-schema.js": "^6.2.1",
     "entities": "^8.0.0",
     "fast-xml-parser": "^5.10.1",
     "fflate": "^0.8.3",