epub-codec 0.0.0 → 1.0.1

package/dist/codec.js

@@ -0,0 +1,25 @@
+import { readEpub, readEpubContent } from "./read.js";
+import { writeEpub, writeEpubContent } from "./write.js";
+import { z } from "zod";
+import { ContentDocumentSchema, DocumentTreeSchema } from "document-schema.js";
+//#region src/codec.ts
+const ZIP_LOCAL_FILE_HEADER = [
+	80,
+	75,
+	3,
+	4
+];
+function hasZipHeader(bytes) {
+	return ZIP_LOCAL_FILE_HEADER.every((byte, index) => bytes[index] === byte);
+}
+const EpubBytesSchema = z.instanceof(Uint8Array).refine(hasZipHeader, { message: "not a zip archive (no PK\\x03\\x04 header)" });
+const epubCodec = z.codec(EpubBytesSchema, DocumentTreeSchema, {
+	decode: (bytes) => readEpub(bytes),
+	encode: (tree) => writeEpub(tree)
+});
+const epubContentCodec = z.codec(EpubBytesSchema, ContentDocumentSchema, {
+	decode: (bytes) => readEpubContent(bytes),
+	encode: (document) => writeEpubContent(document)
+});
+//#endregion
+export { EpubBytesSchema, epubCodec, epubContentCodec };

package/dist/diagnostics-Ee4kG7mw.d.cts

@@ -0,0 +1,60 @@
+//#region src/diagnostics.d.ts
+type EpubDiagnosticSeverity = "info" | "warning";
+interface EpubDiagnostic {
+  readonly code: string;
+  readonly severity: EpubDiagnosticSeverity;
+  readonly message: string;
+  readonly href?: string;
+}
+type EpubDiagnosticSink = (diagnostic: EpubDiagnostic) => void;
+declare const NOOP_EPUB_DIAGNOSTIC_SINK: EpubDiagnosticSink;
+declare const EpubDiagnosticCodes: {
+  readonly NAV_SPINE_ORDER_MISMATCH: "epub/nav-spine-order-mismatch";
+  readonly NCX_MISSING: "epub/ncx-missing";
+  readonly NAV_DOCUMENT_MISSING: "epub/nav-document-missing";
+  readonly MANIFEST_ITEM_MISSING: "epub/manifest-item-missing";
+  readonly SPINE_ITEMREF_UNRESOLVED: "epub/spine-itemref-unresolved";
+  readonly METADATA_FIELD_UNMAPPED: "epub/metadata-field-unmapped";
+  readonly IMAGE_FORMAT_UNSUPPORTED: "epub/image-format-unsupported";
+  readonly IMAGE_UNRESOLVED: "epub/image-unresolved";
+  readonly ELEMENT_UNMAPPED: "epub/element-unmapped";
+  readonly STYLE_RESIDUE: "epub/style-residue";
+  readonly FOOTNOTE_TARGET_UNRESOLVED: "epub/footnote-target-unresolved";
+  readonly LINK_TARGET_EXTERNAL_ONLY: "epub/link-target-external-only";
+  readonly CONSTRUCT_UNREPRESENTED: "epub/construct-unrepresented";
+  readonly INVENTED_PAGE_GEOMETRY: "epub/invented-page-geometry";
+};
+declare class EpubParseError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class EpubInvalidMimetypeError extends EpubParseError {
+  constructor(message?: string);
+}
+declare class EpubInvalidContainerError extends EpubParseError {
+  constructor(message?: string);
+}
+declare class EpubInvalidOpfError extends EpubParseError {
+  constructor(message: string);
+}
+declare class EpubEmptySpineError extends EpubParseError {
+  constructor(message?: string);
+}
+declare class EpubWriteError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class EpubUnsupportedDocumentKindError extends EpubWriteError {
+  readonly kind: string;
+  constructor(kind: string);
+}
+declare class EpubUnbalancedConstructMarkersError extends EpubWriteError {
+  readonly imbalanceKind: "unmatchedEnd" | "unclosedStart";
+  readonly blockIndex: number;
+  constructor(imbalanceKind: "unmatchedEnd" | "unclosedStart", blockIndex: number);
+}
+declare class EpubPackageFlattenError extends EpubWriteError {
+  constructor(cause: unknown);
+}
+//#endregion
+export { EpubEmptySpineError as a, EpubInvalidOpfError as c, EpubUnbalancedConstructMarkersError as d, EpubUnsupportedDocumentKindError as f, EpubDiagnosticSink as i, EpubPackageFlattenError as l, NOOP_EPUB_DIAGNOSTIC_SINK as m, EpubDiagnosticCodes as n, EpubInvalidContainerError as o, EpubWriteError as p, EpubDiagnosticSeverity as r, EpubInvalidMimetypeError as s, EpubDiagnostic as t, EpubParseError as u };

package/dist/diagnostics-Ee4kG7mw.d.ts

@@ -0,0 +1,60 @@
+//#region src/diagnostics.d.ts
+type EpubDiagnosticSeverity = "info" | "warning";
+interface EpubDiagnostic {
+  readonly code: string;
+  readonly severity: EpubDiagnosticSeverity;
+  readonly message: string;
+  readonly href?: string;
+}
+type EpubDiagnosticSink = (diagnostic: EpubDiagnostic) => void;
+declare const NOOP_EPUB_DIAGNOSTIC_SINK: EpubDiagnosticSink;
+declare const EpubDiagnosticCodes: {
+  readonly NAV_SPINE_ORDER_MISMATCH: "epub/nav-spine-order-mismatch";
+  readonly NCX_MISSING: "epub/ncx-missing";
+  readonly NAV_DOCUMENT_MISSING: "epub/nav-document-missing";
+  readonly MANIFEST_ITEM_MISSING: "epub/manifest-item-missing";
+  readonly SPINE_ITEMREF_UNRESOLVED: "epub/spine-itemref-unresolved";
+  readonly METADATA_FIELD_UNMAPPED: "epub/metadata-field-unmapped";
+  readonly IMAGE_FORMAT_UNSUPPORTED: "epub/image-format-unsupported";
+  readonly IMAGE_UNRESOLVED: "epub/image-unresolved";
+  readonly ELEMENT_UNMAPPED: "epub/element-unmapped";
+  readonly STYLE_RESIDUE: "epub/style-residue";
+  readonly FOOTNOTE_TARGET_UNRESOLVED: "epub/footnote-target-unresolved";
+  readonly LINK_TARGET_EXTERNAL_ONLY: "epub/link-target-external-only";
+  readonly CONSTRUCT_UNREPRESENTED: "epub/construct-unrepresented";
+  readonly INVENTED_PAGE_GEOMETRY: "epub/invented-page-geometry";
+};
+declare class EpubParseError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class EpubInvalidMimetypeError extends EpubParseError {
+  constructor(message?: string);
+}
+declare class EpubInvalidContainerError extends EpubParseError {
+  constructor(message?: string);
+}
+declare class EpubInvalidOpfError extends EpubParseError {
+  constructor(message: string);
+}
+declare class EpubEmptySpineError extends EpubParseError {
+  constructor(message?: string);
+}
+declare class EpubWriteError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class EpubUnsupportedDocumentKindError extends EpubWriteError {
+  readonly kind: string;
+  constructor(kind: string);
+}
+declare class EpubUnbalancedConstructMarkersError extends EpubWriteError {
+  readonly imbalanceKind: "unmatchedEnd" | "unclosedStart";
+  readonly blockIndex: number;
+  constructor(imbalanceKind: "unmatchedEnd" | "unclosedStart", blockIndex: number);
+}
+declare class EpubPackageFlattenError extends EpubWriteError {
+  constructor(cause: unknown);
+}
+//#endregion
+export { EpubEmptySpineError as a, EpubInvalidOpfError as c, EpubUnbalancedConstructMarkersError as d, EpubUnsupportedDocumentKindError as f, EpubDiagnosticSink as i, EpubPackageFlattenError as l, NOOP_EPUB_DIAGNOSTIC_SINK as m, EpubDiagnosticCodes as n, EpubInvalidContainerError as o, EpubWriteError as p, EpubDiagnosticSeverity as r, EpubInvalidMimetypeError as s, EpubDiagnostic as t, EpubParseError as u };

package/dist/diagnostics.cjs

@@ -0,0 +1,96 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/diagnostics.ts
+const NOOP_EPUB_DIAGNOSTIC_SINK = () => {};
+const EpubDiagnosticCodes = {
+	NAV_SPINE_ORDER_MISMATCH: "epub/nav-spine-order-mismatch",
+	NCX_MISSING: "epub/ncx-missing",
+	NAV_DOCUMENT_MISSING: "epub/nav-document-missing",
+	MANIFEST_ITEM_MISSING: "epub/manifest-item-missing",
+	SPINE_ITEMREF_UNRESOLVED: "epub/spine-itemref-unresolved",
+	METADATA_FIELD_UNMAPPED: "epub/metadata-field-unmapped",
+	IMAGE_FORMAT_UNSUPPORTED: "epub/image-format-unsupported",
+	IMAGE_UNRESOLVED: "epub/image-unresolved",
+	ELEMENT_UNMAPPED: "epub/element-unmapped",
+	STYLE_RESIDUE: "epub/style-residue",
+	FOOTNOTE_TARGET_UNRESOLVED: "epub/footnote-target-unresolved",
+	LINK_TARGET_EXTERNAL_ONLY: "epub/link-target-external-only",
+	CONSTRUCT_UNREPRESENTED: "epub/construct-unrepresented",
+	INVENTED_PAGE_GEOMETRY: "epub/invented-page-geometry"
+};
+var EpubParseError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "EpubParseError";
+		this.code = code;
+	}
+};
+var EpubInvalidMimetypeError = class extends EpubParseError {
+	constructor(message = "the zip's first entry is not a stored \"mimetype\" entry containing exactly \"application/epub+zip\"") {
+		super("epub/invalid-mimetype", message);
+		this.name = "EpubInvalidMimetypeError";
+	}
+};
+var EpubInvalidContainerError = class extends EpubParseError {
+	constructor(message = "META-INF/container.xml is missing or names no OPF rootfile") {
+		super("epub/invalid-container", message);
+		this.name = "EpubInvalidContainerError";
+	}
+};
+var EpubInvalidOpfError = class extends EpubParseError {
+	constructor(message) {
+		super("epub/invalid-opf", message);
+		this.name = "EpubInvalidOpfError";
+	}
+};
+var EpubEmptySpineError = class extends EpubParseError {
+	constructor(message = "the spine names no resolvable, readable content") {
+		super("epub/empty-spine", message);
+		this.name = "EpubEmptySpineError";
+	}
+};
+var EpubWriteError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "EpubWriteError";
+		this.code = code;
+	}
+};
+var EpubUnsupportedDocumentKindError = class extends EpubWriteError {
+	kind;
+	constructor(kind) {
+		super("epub/write-side-not-wordprocessing", `writeEpubContent only supports a 'wordprocessing' ContentDocument, got '${kind}'`);
+		this.name = "EpubUnsupportedDocumentKindError";
+		this.kind = kind;
+	}
+};
+var EpubUnbalancedConstructMarkersError = class extends EpubWriteError {
+	imbalanceKind;
+	blockIndex;
+	constructor(imbalanceKind, blockIndex) {
+		super("epub/unbalanced-construct-markers", `${imbalanceKind === "unmatchedEnd" ? "a constructEnd marker closes no open construct" : "a constructStart marker is never closed"} at block index ${String(blockIndex)}; a block list's construct boundary markers must pair as balanced brackets`);
+		this.name = "EpubUnbalancedConstructMarkersError";
+		this.imbalanceKind = imbalanceKind;
+		this.blockIndex = blockIndex;
+	}
+};
+var EpubPackageFlattenError = class extends EpubWriteError {
+	constructor(cause) {
+		const detail = cause instanceof Error ? cause.message : String(cause);
+		super("epub/package-flatten-failed", `flattening the package for write failed: ${detail}`);
+		this.name = "EpubPackageFlattenError";
+	}
+};
+//#endregion
+exports.EpubDiagnosticCodes = EpubDiagnosticCodes;
+exports.EpubEmptySpineError = EpubEmptySpineError;
+exports.EpubInvalidContainerError = EpubInvalidContainerError;
+exports.EpubInvalidMimetypeError = EpubInvalidMimetypeError;
+exports.EpubInvalidOpfError = EpubInvalidOpfError;
+exports.EpubPackageFlattenError = EpubPackageFlattenError;
+exports.EpubParseError = EpubParseError;
+exports.EpubUnbalancedConstructMarkersError = EpubUnbalancedConstructMarkersError;
+exports.EpubUnsupportedDocumentKindError = EpubUnsupportedDocumentKindError;
+exports.EpubWriteError = EpubWriteError;
+exports.NOOP_EPUB_DIAGNOSTIC_SINK = NOOP_EPUB_DIAGNOSTIC_SINK;

package/dist/diagnostics.d.cts

@@ -0,0 +1,2 @@
+import { a as EpubEmptySpineError, c as EpubInvalidOpfError, d as EpubUnbalancedConstructMarkersError, f as EpubUnsupportedDocumentKindError, i as EpubDiagnosticSink, l as EpubPackageFlattenError, m as NOOP_EPUB_DIAGNOSTIC_SINK, n as EpubDiagnosticCodes, o as EpubInvalidContainerError, p as EpubWriteError, r as EpubDiagnosticSeverity, s as EpubInvalidMimetypeError, t as EpubDiagnostic, u as EpubParseError } from "./diagnostics-Ee4kG7mw.cjs";
+export { EpubDiagnostic, EpubDiagnosticCodes, EpubDiagnosticSeverity, EpubDiagnosticSink, EpubEmptySpineError, EpubInvalidContainerError, EpubInvalidMimetypeError, EpubInvalidOpfError, EpubPackageFlattenError, EpubParseError, EpubUnbalancedConstructMarkersError, EpubUnsupportedDocumentKindError, EpubWriteError, NOOP_EPUB_DIAGNOSTIC_SINK };

package/dist/diagnostics.d.ts

@@ -0,0 +1,2 @@
+import { a as EpubEmptySpineError, c as EpubInvalidOpfError, d as EpubUnbalancedConstructMarkersError, f as EpubUnsupportedDocumentKindError, i as EpubDiagnosticSink, l as EpubPackageFlattenError, m as NOOP_EPUB_DIAGNOSTIC_SINK, n as EpubDiagnosticCodes, o as EpubInvalidContainerError, p as EpubWriteError, r as EpubDiagnosticSeverity, s as EpubInvalidMimetypeError, t as EpubDiagnostic, u as EpubParseError } from "./diagnostics-Ee4kG7mw.js";
+export { EpubDiagnostic, EpubDiagnosticCodes, EpubDiagnosticSeverity, EpubDiagnosticSink, EpubEmptySpineError, EpubInvalidContainerError, EpubInvalidMimetypeError, EpubInvalidOpfError, EpubPackageFlattenError, EpubParseError, EpubUnbalancedConstructMarkersError, EpubUnsupportedDocumentKindError, EpubWriteError, NOOP_EPUB_DIAGNOSTIC_SINK };

package/dist/diagnostics.js

@@ -0,0 +1,85 @@
+//#region src/diagnostics.ts
+const NOOP_EPUB_DIAGNOSTIC_SINK = () => {};
+const EpubDiagnosticCodes = {
+	NAV_SPINE_ORDER_MISMATCH: "epub/nav-spine-order-mismatch",
+	NCX_MISSING: "epub/ncx-missing",
+	NAV_DOCUMENT_MISSING: "epub/nav-document-missing",
+	MANIFEST_ITEM_MISSING: "epub/manifest-item-missing",
+	SPINE_ITEMREF_UNRESOLVED: "epub/spine-itemref-unresolved",
+	METADATA_FIELD_UNMAPPED: "epub/metadata-field-unmapped",
+	IMAGE_FORMAT_UNSUPPORTED: "epub/image-format-unsupported",
+	IMAGE_UNRESOLVED: "epub/image-unresolved",
+	ELEMENT_UNMAPPED: "epub/element-unmapped",
+	STYLE_RESIDUE: "epub/style-residue",
+	FOOTNOTE_TARGET_UNRESOLVED: "epub/footnote-target-unresolved",
+	LINK_TARGET_EXTERNAL_ONLY: "epub/link-target-external-only",
+	CONSTRUCT_UNREPRESENTED: "epub/construct-unrepresented",
+	INVENTED_PAGE_GEOMETRY: "epub/invented-page-geometry"
+};
+var EpubParseError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "EpubParseError";
+		this.code = code;
+	}
+};
+var EpubInvalidMimetypeError = class extends EpubParseError {
+	constructor(message = "the zip's first entry is not a stored \"mimetype\" entry containing exactly \"application/epub+zip\"") {
+		super("epub/invalid-mimetype", message);
+		this.name = "EpubInvalidMimetypeError";
+	}
+};
+var EpubInvalidContainerError = class extends EpubParseError {
+	constructor(message = "META-INF/container.xml is missing or names no OPF rootfile") {
+		super("epub/invalid-container", message);
+		this.name = "EpubInvalidContainerError";
+	}
+};
+var EpubInvalidOpfError = class extends EpubParseError {
+	constructor(message) {
+		super("epub/invalid-opf", message);
+		this.name = "EpubInvalidOpfError";
+	}
+};
+var EpubEmptySpineError = class extends EpubParseError {
+	constructor(message = "the spine names no resolvable, readable content") {
+		super("epub/empty-spine", message);
+		this.name = "EpubEmptySpineError";
+	}
+};
+var EpubWriteError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "EpubWriteError";
+		this.code = code;
+	}
+};
+var EpubUnsupportedDocumentKindError = class extends EpubWriteError {
+	kind;
+	constructor(kind) {
+		super("epub/write-side-not-wordprocessing", `writeEpubContent only supports a 'wordprocessing' ContentDocument, got '${kind}'`);
+		this.name = "EpubUnsupportedDocumentKindError";
+		this.kind = kind;
+	}
+};
+var EpubUnbalancedConstructMarkersError = class extends EpubWriteError {
+	imbalanceKind;
+	blockIndex;
+	constructor(imbalanceKind, blockIndex) {
+		super("epub/unbalanced-construct-markers", `${imbalanceKind === "unmatchedEnd" ? "a constructEnd marker closes no open construct" : "a constructStart marker is never closed"} at block index ${String(blockIndex)}; a block list's construct boundary markers must pair as balanced brackets`);
+		this.name = "EpubUnbalancedConstructMarkersError";
+		this.imbalanceKind = imbalanceKind;
+		this.blockIndex = blockIndex;
+	}
+};
+var EpubPackageFlattenError = class extends EpubWriteError {
+	constructor(cause) {
+		const detail = cause instanceof Error ? cause.message : String(cause);
+		super("epub/package-flatten-failed", `flattening the package for write failed: ${detail}`);
+		this.name = "EpubPackageFlattenError";
+	}
+};
+//#endregion
+export { EpubDiagnosticCodes, EpubEmptySpineError, EpubInvalidContainerError, EpubInvalidMimetypeError, EpubInvalidOpfError, EpubPackageFlattenError, EpubParseError, EpubUnbalancedConstructMarkersError, EpubUnsupportedDocumentKindError, EpubWriteError, NOOP_EPUB_DIAGNOSTIC_SINK };

package/dist/format.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/format.ts
+const EPUB_MIME_TYPE = "application/epub+zip";
+const OCF_CONTAINER_PATH = "META-INF/container.xml";
+const OCF_MIMETYPE_PATH = "mimetype";
+//#endregion
+exports.EPUB_MIME_TYPE = EPUB_MIME_TYPE;
+exports.OCF_CONTAINER_PATH = OCF_CONTAINER_PATH;
+exports.OCF_MIMETYPE_PATH = OCF_MIMETYPE_PATH;

package/dist/format.d.cts

@@ -0,0 +1,6 @@
+//#region src/format.d.ts
+declare const EPUB_MIME_TYPE = "application/epub+zip";
+declare const OCF_CONTAINER_PATH = "META-INF/container.xml";
+declare const OCF_MIMETYPE_PATH = "mimetype";
+//#endregion
+export { EPUB_MIME_TYPE, OCF_CONTAINER_PATH, OCF_MIMETYPE_PATH };

package/dist/format.d.ts

@@ -0,0 +1,6 @@
+//#region src/format.d.ts
+declare const EPUB_MIME_TYPE = "application/epub+zip";
+declare const OCF_CONTAINER_PATH = "META-INF/container.xml";
+declare const OCF_MIMETYPE_PATH = "mimetype";
+//#endregion
+export { EPUB_MIME_TYPE, OCF_CONTAINER_PATH, OCF_MIMETYPE_PATH };

package/dist/format.js

@@ -0,0 +1,6 @@
+//#region src/format.ts
+const EPUB_MIME_TYPE = "application/epub+zip";
+const OCF_CONTAINER_PATH = "META-INF/container.xml";
+const OCF_MIMETYPE_PATH = "mimetype";
+//#endregion
+export { EPUB_MIME_TYPE, OCF_CONTAINER_PATH, OCF_MIMETYPE_PATH };

package/dist/image/dimensions.cjs

@@ -0,0 +1,82 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/image/dimensions.ts
+function readUint16BE(bytes, offset) {
+	return ((bytes[offset] ?? 0) << 8 | (bytes[offset + 1] ?? 0)) & 65535;
+}
+function readUint32BE(bytes, offset) {
+	return ((bytes[offset] ?? 0) << 24 | (bytes[offset + 1] ?? 0) << 16 | (bytes[offset + 2] ?? 0) << 8 | (bytes[offset + 3] ?? 0)) >>> 0;
+}
+const PNG_SIGNATURE = [
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+];
+const PNG_HEADER_BYTES = 24;
+function isPng(bytes) {
+	if (bytes.length < PNG_SIGNATURE.length) return false;
+	return PNG_SIGNATURE.every((byte, index) => bytes[index] === byte);
+}
+function readPngDimensions(bytes) {
+	if (bytes.length < PNG_HEADER_BYTES) return;
+	if (bytes[12] !== 73 || bytes[13] !== 72 || bytes[14] !== 68 || bytes[15] !== 82) return;
+	return {
+		widthPx: readUint32BE(bytes, 16),
+		heightPx: readUint32BE(bytes, 20)
+	};
+}
+function isStartOfFrameMarker(marker) {
+	if (marker < 192 || marker > 207) return false;
+	return marker !== 196 && marker !== 200 && marker !== 204;
+}
+function hasNoLengthField(marker) {
+	return marker === 216 || marker === 217 || marker === 1 || marker >= 208 && marker <= 215;
+}
+function readJpegDimensions(bytes) {
+	if (bytes.length < 4 || bytes[0] !== 255 || bytes[1] !== 216) return;
+	let offset = 2;
+	while (offset < bytes.length) {
+		if (bytes[offset] !== 255) {
+			offset += 1;
+			continue;
+		}
+		let markerOffset = offset + 1;
+		while (bytes[markerOffset] === 255) markerOffset += 1;
+		const marker = bytes[markerOffset];
+		if (marker === void 0) return;
+		offset = markerOffset + 1;
+		if (hasNoLengthField(marker)) continue;
+		if (offset + 2 > bytes.length) return;
+		const length = readUint16BE(bytes, offset);
+		if (isStartOfFrameMarker(marker)) {
+			if (offset + 7 > bytes.length) return;
+			const heightPx = readUint16BE(bytes, offset + 3);
+			return {
+				widthPx: readUint16BE(bytes, offset + 5),
+				heightPx
+			};
+		}
+		if (marker === 218) return;
+		offset += length;
+	}
+}
+function isJpeg(bytes) {
+	return bytes.length >= 2 && bytes[0] === 255 && bytes[1] === 216;
+}
+function detectImageFormat(bytes) {
+	if (isPng(bytes)) return "png";
+	return isJpeg(bytes) ? "jpeg" : void 0;
+}
+function readImageDimensions(bytes) {
+	if (isPng(bytes)) return readPngDimensions(bytes);
+	return readJpegDimensions(bytes);
+}
+const POINTS_PER_PIXEL = 72 / 96;
+//#endregion
+exports.POINTS_PER_PIXEL = POINTS_PER_PIXEL;
+exports.detectImageFormat = detectImageFormat;
+exports.readImageDimensions = readImageDimensions;

package/dist/image/dimensions.d.cts

@@ -0,0 +1,11 @@
+//#region src/image/dimensions.d.ts
+interface ImageDimensions {
+  readonly widthPx: number;
+  readonly heightPx: number;
+}
+type EpubImageFormat = "png" | "jpeg";
+declare function detectImageFormat(bytes: Uint8Array): EpubImageFormat | undefined;
+declare function readImageDimensions(bytes: Uint8Array): ImageDimensions | undefined;
+declare const POINTS_PER_PIXEL: number;
+//#endregion
+export { EpubImageFormat, ImageDimensions, POINTS_PER_PIXEL, detectImageFormat, readImageDimensions };

package/dist/image/dimensions.d.ts

@@ -0,0 +1,11 @@
+//#region src/image/dimensions.d.ts
+interface ImageDimensions {
+  readonly widthPx: number;
+  readonly heightPx: number;
+}
+type EpubImageFormat = "png" | "jpeg";
+declare function detectImageFormat(bytes: Uint8Array): EpubImageFormat | undefined;
+declare function readImageDimensions(bytes: Uint8Array): ImageDimensions | undefined;
+declare const POINTS_PER_PIXEL: number;
+//#endregion
+export { EpubImageFormat, ImageDimensions, POINTS_PER_PIXEL, detectImageFormat, readImageDimensions };

package/dist/image/dimensions.js

@@ -0,0 +1,79 @@
+//#region src/image/dimensions.ts
+function readUint16BE(bytes, offset) {
+	return ((bytes[offset] ?? 0) << 8 | (bytes[offset + 1] ?? 0)) & 65535;
+}
+function readUint32BE(bytes, offset) {
+	return ((bytes[offset] ?? 0) << 24 | (bytes[offset + 1] ?? 0) << 16 | (bytes[offset + 2] ?? 0) << 8 | (bytes[offset + 3] ?? 0)) >>> 0;
+}
+const PNG_SIGNATURE = [
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+];
+const PNG_HEADER_BYTES = 24;
+function isPng(bytes) {
+	if (bytes.length < PNG_SIGNATURE.length) return false;
+	return PNG_SIGNATURE.every((byte, index) => bytes[index] === byte);
+}
+function readPngDimensions(bytes) {
+	if (bytes.length < PNG_HEADER_BYTES) return;
+	if (bytes[12] !== 73 || bytes[13] !== 72 || bytes[14] !== 68 || bytes[15] !== 82) return;
+	return {
+		widthPx: readUint32BE(bytes, 16),
+		heightPx: readUint32BE(bytes, 20)
+	};
+}
+function isStartOfFrameMarker(marker) {
+	if (marker < 192 || marker > 207) return false;
+	return marker !== 196 && marker !== 200 && marker !== 204;
+}
+function hasNoLengthField(marker) {
+	return marker === 216 || marker === 217 || marker === 1 || marker >= 208 && marker <= 215;
+}
+function readJpegDimensions(bytes) {
+	if (bytes.length < 4 || bytes[0] !== 255 || bytes[1] !== 216) return;
+	let offset = 2;
+	while (offset < bytes.length) {
+		if (bytes[offset] !== 255) {
+			offset += 1;
+			continue;
+		}
+		let markerOffset = offset + 1;
+		while (bytes[markerOffset] === 255) markerOffset += 1;
+		const marker = bytes[markerOffset];
+		if (marker === void 0) return;
+		offset = markerOffset + 1;
+		if (hasNoLengthField(marker)) continue;
+		if (offset + 2 > bytes.length) return;
+		const length = readUint16BE(bytes, offset);
+		if (isStartOfFrameMarker(marker)) {
+			if (offset + 7 > bytes.length) return;
+			const heightPx = readUint16BE(bytes, offset + 3);
+			return {
+				widthPx: readUint16BE(bytes, offset + 5),
+				heightPx
+			};
+		}
+		if (marker === 218) return;
+		offset += length;
+	}
+}
+function isJpeg(bytes) {
+	return bytes.length >= 2 && bytes[0] === 255 && bytes[1] === 216;
+}
+function detectImageFormat(bytes) {
+	if (isPng(bytes)) return "png";
+	return isJpeg(bytes) ? "jpeg" : void 0;
+}
+function readImageDimensions(bytes) {
+	if (isPng(bytes)) return readPngDimensions(bytes);
+	return readJpegDimensions(bytes);
+}
+const POINTS_PER_PIXEL = 72 / 96;
+//#endregion
+export { POINTS_PER_PIXEL, detectImageFormat, readImageDimensions };

package/dist/index.cjs

@@ -0,0 +1,105 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_diagnostics = require("./diagnostics.cjs");
+const require_xml_query = require("./xml/query.cjs");
+const require_xml_parse = require("./xml/parse.cjs");
+const require_ocf_container = require("./ocf/container.cjs");
+const require_format = require("./format.cjs");
+const require_nav_nav3 = require("./nav/nav3.cjs");
+const require_nav_ncx = require("./nav/ncx.cjs");
+const require_nav_reconcile = require("./nav/reconcile.cjs");
+const require_xml_entities = require("./xml/entities.cjs");
+const require_opf_metadata = require("./opf/metadata.cjs");
+const require_opf_parse = require("./opf/parse.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_footnote = require("./xhtml/footnote.cjs");
+const require_xhtml_style_constants = require("./xhtml/style-constants.cjs");
+const require_xhtml_inline = require("./xhtml/inline.cjs");
+const require_xhtml_list_id = require("./xhtml/list-id.cjs");
+const require_xhtml_read = require("./xhtml/read.cjs");
+const require_path = require("./path.cjs");
+const require_zip = require("./zip.cjs");
+const require_read = require("./read.cjs");
+const require_ocf_write = require("./ocf/write.cjs");
+const require_nav_write = require("./nav/write.cjs");
+const require_opf_write = require("./opf/write.cjs");
+const require_xhtml_write = require("./xhtml/write.cjs");
+const require_write = require("./write.cjs");
+const require_codec = require("./codec.cjs");
+require("./opf/types.cjs");
+require("./xhtml/context.cjs");
+const require_xml_node = require("./xml/node.cjs");
+exports.AttributeSchema = require_xml_node.AttributeSchema;
+exports.DEFINITION_BODY_INDENT_PT = require_xhtml_style_constants.DEFINITION_BODY_INDENT_PT;
+exports.EPUB_MIME_TYPE = require_format.EPUB_MIME_TYPE;
+exports.EpubBytesSchema = require_codec.EpubBytesSchema;
+exports.EpubDiagnosticCodes = require_diagnostics.EpubDiagnosticCodes;
+exports.EpubEmptySpineError = require_diagnostics.EpubEmptySpineError;
+exports.EpubInvalidContainerError = require_diagnostics.EpubInvalidContainerError;
+exports.EpubInvalidMimetypeError = require_diagnostics.EpubInvalidMimetypeError;
+exports.EpubInvalidOpfError = require_diagnostics.EpubInvalidOpfError;
+exports.EpubPackageFlattenError = require_diagnostics.EpubPackageFlattenError;
+exports.EpubParseError = require_diagnostics.EpubParseError;
+exports.EpubUnbalancedConstructMarkersError = require_diagnostics.EpubUnbalancedConstructMarkersError;
+exports.EpubUnsupportedDocumentKindError = require_diagnostics.EpubUnsupportedDocumentKindError;
+exports.EpubWriteError = require_diagnostics.EpubWriteError;
+exports.HORIZONTAL_RULE_STYLE_ID = require_xhtml_style_constants.HORIZONTAL_RULE_STYLE_ID;
+exports.MONOSPACE_FONT_FAMILY = require_xhtml_style_constants.MONOSPACE_FONT_FAMILY;
+exports.NOOP_EPUB_DIAGNOSTIC_SINK = require_diagnostics.NOOP_EPUB_DIAGNOSTIC_SINK;
+exports.OCF_CONTAINER_PATH = require_format.OCF_CONTAINER_PATH;
+exports.OCF_MIMETYPE_PATH = require_format.OCF_MIMETYPE_PATH;
+exports.POINTS_PER_PIXEL = require_image_dimensions.POINTS_PER_PIXEL;
+exports.QUOTE_INDENT_PT = require_xhtml_style_constants.QUOTE_INDENT_PT;
+exports.QUOTE_STYLE_ID = require_xhtml_style_constants.QUOTE_STYLE_ID;
+exports.XmlCdataSchema = require_xml_node.XmlCdataSchema;
+exports.XmlCommentSchema = require_xml_node.XmlCommentSchema;
+exports.XmlDeclarationSchema = require_xml_node.XmlDeclarationSchema;
+exports.XmlElementSchema = require_xml_node.XmlElementSchema;
+exports.XmlNodeSchema = require_xml_node.XmlNodeSchema;
+exports.XmlPiSchema = require_xml_node.XmlPiSchema;
+exports.XmlTextSchema = require_xml_node.XmlTextSchema;
+exports.attrValue = require_xml_query.attrValue;
+exports.base64ToBytes = require_util_base64.base64ToBytes;
+exports.buildInlineRuns = require_xhtml_inline.buildInlineRuns;
+exports.buildXml = require_xml_build.buildXml;
+exports.bytesToBase64 = require_util_base64.bytesToBase64;
+exports.childrenWithTag = require_xml_query.childrenWithTag;
+exports.decodeEntities = require_xml_entities.decodeEntities;
+exports.detectImageFormat = require_image_dimensions.detectImageFormat;
+exports.dirname = require_path.dirname;
+exports.elementsWithTag = require_xml_query.elementsWithTag;
+exports.encodeEntities = require_xml_entities.encodeEntities;
+exports.epubCodec = require_codec.epubCodec;
+exports.epubContentCodec = require_codec.epubContentCodec;
+exports.findChildElement = require_xml_query.findChildElement;
+exports.findElement = require_xml_query.findElement;
+exports.isFootnoteAside = require_xhtml_footnote.isFootnoteAside;
+exports.isFootnoteReferenceAnchor = require_xhtml_footnote.isFootnoteReferenceAnchor;
+exports.isXmlNode = require_xml_node.isXmlNode;
+exports.mintListNumId = require_xhtml_list_id.mintListNumId;
+exports.navMatchesSpine = require_nav_reconcile.navMatchesSpine;
+exports.parseListNumId = require_xhtml_list_id.parseListNumId;
+exports.parseOpf = require_opf_parse.parseOpf;
+exports.parseXml = require_xml_parse.parseXml;
+exports.readEpub = require_read.readEpub;
+exports.readEpubContent = require_read.readEpubContent;
+exports.readImageDimensions = require_image_dimensions.readImageDimensions;
+exports.readNav3TocHrefs = require_nav_nav3.readNav3TocHrefs;
+exports.readNcxHrefs = require_nav_ncx.readNcxHrefs;
+exports.readOpfMetadata = require_opf_metadata.readOpfMetadata;
+exports.readXhtmlBody = require_xhtml_read.readXhtmlBody;
+exports.resolveOpfPath = require_ocf_container.resolveOpfPath;
+exports.resolvePackagePath = require_path.resolvePackagePath;
+exports.rootElement = require_xml_query.rootElement;
+exports.sameDocumentFragment = require_xhtml_footnote.sameDocumentFragment;
+exports.sectionTitle = require_nav_write.sectionTitle;
+exports.textContent = require_xml_query.textContent;
+exports.unzipPackage = require_zip.unzipPackage;
+exports.writeContainerXml = require_ocf_write.writeContainerXml;
+exports.writeEpub = require_write.writeEpub;
+exports.writeEpubContent = require_write.writeEpubContent;
+exports.writeNav3Document = require_nav_write.writeNav3Document;
+exports.writeOpf = require_opf_write.writeOpf;
+exports.writeXhtmlBody = require_xhtml_write.writeXhtmlBody;
+exports.zipPackage = require_zip.zipPackage;