wpd-codec 3.2.2 → 3.3.0

package/README.md

@@ -71,7 +71,7 @@ readWpdContent(bytes, {
 });
 ```
 
-Structural nonconformance is not a diagnostic — it throws. `WpdNotAWordPerfectFileError`, `WpdEncryptedDocumentError`, `WpdUnsupportedVersionError`, and the general `WpdFormatError` are all exported, and all extend the last.
+Structural nonconformance is not a diagnostic — it throws. `WpdNotAWordPerfectFileError`, `WpdEncryptedDocumentError`, `WpdWrongPasswordError`, `WpdUnsupportedVersionError`, and the general `WpdFormatError` are all exported, and all extend the last.
 
 ## What it provides
 
@@ -179,7 +179,7 @@ Everything below is recognised by the tokeniser and skipped by the fold, so a do
 - **Embedded OLE objects**, stored under the compound file's `PerfectOffice_OBJECTS` storage and named by an image box's Graphics Filename packet's own `0x70`/`0x71` (OLE Object Descriptor / OLE Object Data) children. `archive-codec`'s compound-file reader already reaches that storage, which is how `ooxml.js` recovers a ZIP-payload embedded object — but a WordPerfect OLE object's payload is a native OLE server's own stream rather than a nested document package (`ooxml.js`'s own equivalent case, a classic OLE1 `.bin` payload with no `Package` stream, stays opaque by the identical scope boundary), so recovering one generically is a project in its own right, not a wiring job.
 - **The counter groups** (0xD8, 0xD9, 0xDB, 0xDC): setting, numbering-method, increment and decrement carry no text and change no structure this reader models, so only the Display Number group's own paragraph-number pair is read.
 - **Every merge subfunction other than FIELD** (ASSIGN, CALL, IF, FOR, CASE, and the rest of WordPerfect's own merge scripting language) and **cross-references** (0xD5). A cross-reference's displayed text survives as ordinary text; its target binding does not. Reported through `wpd/merge-code-dropped` and `wpd/cross-reference-flattened`. Unlike FIELD, these can legitimately wrap whole paragraphs of body text as control flow, which the run-scoped field construct's own one-paragraph extent cannot express regardless — a schema gap for a scripting language's control flow, not a parsing gap.
-- **Encrypted documents**, which throw: the specification states that nothing beyond the file header is intelligible without the password, so there is no partial read to offer.
+- **WordPerfect 9-and-later "enhanced encryption"**, which throws: a different, unpublished cipher whose header word is not the standard mode's password checksum, so a `password` read option either verifies against that checksum and decrypts the standard ("original") mode or throws `WpdWrongPasswordError` naming both possible readings of the mismatch. The standard mode itself is decrypted for real (see `src/container/encryption.ts` for the cipher's two independent sources, and for the honest limit that no open-source reference implementation of the 6.x wiring exists to cross-check against a WordPerfect-produced encrypted file).
 
 ## Evidence
 

package/dist/container/container.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_errors = require("../errors.cjs");
 const require_container_header = require("./header.cjs");
+const require_container_encryption = require("./encryption.cjs");
 const require_container_prefix = require("./prefix.cjs");
 let archive_codec = require("archive-codec");
 //#region src/container/container.ts
@@ -35,9 +36,11 @@ function documentAreaEnd(bytes, header) {
 	if (fileSize > documentAreaOffset && fileSize <= bytes.length) return fileSize;
 	return bytes.length;
 }
-function openWpdDocument(input) {
-	const { bytes, compound } = unwrapContainer(toArrayBufferBacked(input));
-	const header = require_container_header.readFileHeader(bytes);
+function openWpdDocument(input, options = {}) {
+	const { bytes: wrapped, compound } = unwrapContainer(toArrayBufferBacked(input));
+	const header = require_container_header.readFileHeader(wrapped, options);
+	const suppliedPassword = options.password === "" ? void 0 : options.password;
+	const bytes = header.encryption !== 0 && suppliedPassword !== void 0 ? require_container_encryption.decryptWpdDocument(wrapped, header, suppliedPassword) : wrapped;
 	return {
 		header,
 		packets: require_container_prefix.readPrefixPackets(bytes, header),

package/dist/container/container.d.cts

@@ -1,4 +1,4 @@
-import { WpdFileHeader } from "./header.cjs";
+import { ReadWpdHeaderOptions, WpdFileHeader } from "./header.cjs";
 import { WpdPrefixPacket } from "./prefix.cjs";
 //#region src/container/container.d.ts
 declare const PERFECT_OFFICE_MAIN_STREAM = "PerfectOffice_MAIN";
@@ -11,6 +11,6 @@ interface WpdDocumentContainer {
   readonly documentAreaEnd: number;
   readonly compound: boolean;
 }
-declare function openWpdDocument(input: Uint8Array): WpdDocumentContainer;
+declare function openWpdDocument(input: Uint8Array, options?: ReadWpdHeaderOptions): WpdDocumentContainer;
 //#endregion
 export { PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, WpdDocumentContainer, openWpdDocument };

package/dist/container/container.d.ts

@@ -1,4 +1,4 @@
-import { WpdFileHeader } from "./header.js";
+import { ReadWpdHeaderOptions, WpdFileHeader } from "./header.js";
 import { WpdPrefixPacket } from "./prefix.js";
 //#region src/container/container.d.ts
 declare const PERFECT_OFFICE_MAIN_STREAM = "PerfectOffice_MAIN";
@@ -11,6 +11,6 @@ interface WpdDocumentContainer {
   readonly documentAreaEnd: number;
   readonly compound: boolean;
 }
-declare function openWpdDocument(input: Uint8Array): WpdDocumentContainer;
+declare function openWpdDocument(input: Uint8Array, options?: ReadWpdHeaderOptions): WpdDocumentContainer;
 //#endregion
 export { PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, WpdDocumentContainer, openWpdDocument };

package/dist/container/container.js

@@ -1,5 +1,6 @@
 import { WpdNotAWordPerfectFileError } from "../errors.js";
 import { hasWordPerfectFileId, readFileHeader } from "./header.js";
+import { decryptWpdDocument } from "./encryption.js";
 import { readPrefixPackets } from "./prefix.js";
 import { isCompoundFile, readCompoundFile } from "archive-codec";
 //#region src/container/container.ts
@@ -34,9 +35,11 @@ function documentAreaEnd(bytes, header) {
 	if (fileSize > documentAreaOffset && fileSize <= bytes.length) return fileSize;
 	return bytes.length;
 }
-function openWpdDocument(input) {
-	const { bytes, compound } = unwrapContainer(toArrayBufferBacked(input));
-	const header = readFileHeader(bytes);
+function openWpdDocument(input, options = {}) {
+	const { bytes: wrapped, compound } = unwrapContainer(toArrayBufferBacked(input));
+	const header = readFileHeader(wrapped, options);
+	const suppliedPassword = options.password === "" ? void 0 : options.password;
+	const bytes = header.encryption !== 0 && suppliedPassword !== void 0 ? decryptWpdDocument(wrapped, header, suppliedPassword) : wrapped;
 	return {
 		header,
 		packets: readPrefixPackets(bytes, header),

package/dist/container/encryption.cjs

@@ -0,0 +1,59 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+const require_bytes_view = require("../bytes/view.cjs");
+require("./header.cjs");
+//#region src/container/encryption.ts
+function normaliseWpdPassword(password) {
+	const normalised = [];
+	for (let i = 0; i < password.length; i++) {
+		const unit = password.charCodeAt(i);
+		if (unit > 255) throw new require_errors.WpdFormatError(`A password with characters outside Latin-1 cannot be encoded into the byte-keyed WordPerfect cipher (code unit U+${unit.toString(16).toUpperCase().padStart(4, "0")} at position ${i}).`);
+		normalised.push(unit >= 97 && unit <= 122 ? unit - 97 + 65 : unit);
+	}
+	return normalised;
+}
+function wpdPasswordChecksum16(normalised) {
+	let checksum = 0;
+	for (const unit of normalised) {
+		checksum = (checksum >>> 1 | checksum << 15) ^ unit << 8;
+		checksum &= 65535;
+	}
+	return checksum;
+}
+function applyWpdStandardEncryption(bytes, normalised, startOffset) {
+	if (normalised.length === 0) throw new require_errors.WpdFormatError("The WordPerfect cipher is keyed by the password's own bytes, so an empty password decrypts nothing.");
+	const maskBase = normalised.length + 1 & 255;
+	const output = new Uint8Array(bytes.length);
+	output.set(bytes.subarray(0, startOffset));
+	for (let pos = startOffset; pos < bytes.length; pos++) {
+		const relative = pos - startOffset;
+		const passwordByte = normalised[relative % normalised.length];
+		if (passwordByte === void 0) throw new require_errors.WpdFormatError("The password normalised to no bytes, which the cipher cannot key with.");
+		const mask = maskBase + relative & 255;
+		output[pos] = require_bytes_view.byteAt(bytes, pos) ^ passwordByte ^ mask;
+	}
+	return output;
+}
+function decryptWpdDocument(bytes, header, password) {
+	const normalised = normaliseWpdPassword(password);
+	if (normalised.length === 0) throw new require_errors.WpdWrongPasswordError(header.encryption, 0);
+	const checksum = wpdPasswordChecksum16(normalised);
+	if (checksum !== header.encryption) throw new require_errors.WpdWrongPasswordError(header.encryption, checksum);
+	return applyWpdStandardEncryption(bytes, normalised, 512);
+}
+function encryptWpdDocumentForTests(bytes, password) {
+	const normalised = normaliseWpdPassword(password);
+	const checksum = wpdPasswordChecksum16(normalised);
+	const encrypted = applyWpdStandardEncryption(bytes, normalised, 512);
+	const output = new Uint8Array(encrypted.length);
+	output.set(encrypted);
+	output[12] = checksum & 255;
+	output[13] = checksum >>> 8 & 255;
+	return output;
+}
+//#endregion
+exports.applyWpdStandardEncryption = applyWpdStandardEncryption;
+exports.decryptWpdDocument = decryptWpdDocument;
+exports.encryptWpdDocumentForTests = encryptWpdDocumentForTests;
+exports.normaliseWpdPassword = normaliseWpdPassword;
+exports.wpdPasswordChecksum16 = wpdPasswordChecksum16;

package/dist/container/encryption.d.cts

@@ -0,0 +1,9 @@
+import { WpdFileHeader } from "./header.cjs";
+//#region src/container/encryption.d.ts
+declare function normaliseWpdPassword(password: string): number[];
+declare function wpdPasswordChecksum16(normalised: readonly number[]): number;
+declare function applyWpdStandardEncryption(bytes: Uint8Array, normalised: readonly number[], startOffset: number): Uint8Array<ArrayBuffer>;
+declare function decryptWpdDocument(bytes: Uint8Array<ArrayBuffer>, header: WpdFileHeader, password: string): Uint8Array<ArrayBuffer>;
+declare function encryptWpdDocumentForTests(bytes: Uint8Array, password: string): Uint8Array<ArrayBuffer>;
+//#endregion
+export { applyWpdStandardEncryption, decryptWpdDocument, encryptWpdDocumentForTests, normaliseWpdPassword, wpdPasswordChecksum16 };

package/dist/container/encryption.d.ts

@@ -0,0 +1,9 @@
+import { WpdFileHeader } from "./header.js";
+//#region src/container/encryption.d.ts
+declare function normaliseWpdPassword(password: string): number[];
+declare function wpdPasswordChecksum16(normalised: readonly number[]): number;
+declare function applyWpdStandardEncryption(bytes: Uint8Array, normalised: readonly number[], startOffset: number): Uint8Array<ArrayBuffer>;
+declare function decryptWpdDocument(bytes: Uint8Array<ArrayBuffer>, header: WpdFileHeader, password: string): Uint8Array<ArrayBuffer>;
+declare function encryptWpdDocumentForTests(bytes: Uint8Array, password: string): Uint8Array<ArrayBuffer>;
+//#endregion
+export { applyWpdStandardEncryption, decryptWpdDocument, encryptWpdDocumentForTests, normaliseWpdPassword, wpdPasswordChecksum16 };

package/dist/container/encryption.js

@@ -0,0 +1,54 @@
+import { WpdFormatError, WpdWrongPasswordError } from "../errors.js";
+import { byteAt } from "../bytes/view.js";
+import "./header.js";
+//#region src/container/encryption.ts
+function normaliseWpdPassword(password) {
+	const normalised = [];
+	for (let i = 0; i < password.length; i++) {
+		const unit = password.charCodeAt(i);
+		if (unit > 255) throw new WpdFormatError(`A password with characters outside Latin-1 cannot be encoded into the byte-keyed WordPerfect cipher (code unit U+${unit.toString(16).toUpperCase().padStart(4, "0")} at position ${i}).`);
+		normalised.push(unit >= 97 && unit <= 122 ? unit - 97 + 65 : unit);
+	}
+	return normalised;
+}
+function wpdPasswordChecksum16(normalised) {
+	let checksum = 0;
+	for (const unit of normalised) {
+		checksum = (checksum >>> 1 | checksum << 15) ^ unit << 8;
+		checksum &= 65535;
+	}
+	return checksum;
+}
+function applyWpdStandardEncryption(bytes, normalised, startOffset) {
+	if (normalised.length === 0) throw new WpdFormatError("The WordPerfect cipher is keyed by the password's own bytes, so an empty password decrypts nothing.");
+	const maskBase = normalised.length + 1 & 255;
+	const output = new Uint8Array(bytes.length);
+	output.set(bytes.subarray(0, startOffset));
+	for (let pos = startOffset; pos < bytes.length; pos++) {
+		const relative = pos - startOffset;
+		const passwordByte = normalised[relative % normalised.length];
+		if (passwordByte === void 0) throw new WpdFormatError("The password normalised to no bytes, which the cipher cannot key with.");
+		const mask = maskBase + relative & 255;
+		output[pos] = byteAt(bytes, pos) ^ passwordByte ^ mask;
+	}
+	return output;
+}
+function decryptWpdDocument(bytes, header, password) {
+	const normalised = normaliseWpdPassword(password);
+	if (normalised.length === 0) throw new WpdWrongPasswordError(header.encryption, 0);
+	const checksum = wpdPasswordChecksum16(normalised);
+	if (checksum !== header.encryption) throw new WpdWrongPasswordError(header.encryption, checksum);
+	return applyWpdStandardEncryption(bytes, normalised, 512);
+}
+function encryptWpdDocumentForTests(bytes, password) {
+	const normalised = normaliseWpdPassword(password);
+	const checksum = wpdPasswordChecksum16(normalised);
+	const encrypted = applyWpdStandardEncryption(bytes, normalised, 512);
+	const output = new Uint8Array(encrypted.length);
+	output.set(encrypted);
+	output[12] = checksum & 255;
+	output[13] = checksum >>> 8 & 255;
+	return output;
+}
+//#endregion
+export { applyWpdStandardEncryption, decryptWpdDocument, encryptWpdDocumentForTests, normaliseWpdPassword, wpdPasswordChecksum16 };

package/dist/container/header.cjs

@@ -16,7 +16,7 @@ function hasWordPerfectFileId(bytes) {
 	if (bytes.length < WPD_FILE_ID.length) return false;
 	return WPD_FILE_ID.every((expected, index) => bytes[index] === expected);
 }
-function readFileHeader(bytes) {
+function readFileHeader(bytes, options = {}) {
 	if (!hasWordPerfectFileId(bytes)) {
 		const actual = Array.from(require_bytes_view.sliceAt(bytes, 0, Math.min(4, bytes.length))).map((byte) => byte.toString(16).padStart(2, "0")).join(" ");
 		throw new require_errors.WpdNotAWordPerfectFileError(`Expected the WordPerfect file ID FF 57 50 43 (-1,"WPC") at offset 0, found ${actual}.`);
@@ -28,7 +28,8 @@ function readFileHeader(bytes) {
 	const minorVersion = require_bytes_view.byteAt(bytes, 11);
 	const encryption = require_bytes_view.uint16At(bytes, 12);
 	const indexAreaOffset = require_bytes_view.uint16At(bytes, 14);
-	if (encryption !== 0) throw new require_errors.WpdEncryptedDocumentError(`This document is encrypted (encryption word ${encryption}); nothing beyond the file header is intelligible without the password, which this reader does not support.`);
+	const suppliedPassword = options.password === "" ? void 0 : options.password;
+	if (encryption !== 0 && suppliedPassword === void 0) throw new require_errors.WpdEncryptedDocumentError(`This document is encrypted (encryption word ${encryption}); nothing beyond the file header is intelligible without the password. Pass { password } to read it -- the standard ("original") encryption mode is supported, and a non-matching password throws WpdWrongPasswordError.`);
 	if (productType !== PRODUCT_TYPE_WORDPERFECT) throw new require_errors.WpdUnsupportedVersionError(`Product type ${productType} is not WordPerfect (${PRODUCT_TYPE_WORDPERFECT}); this file was produced by a different Corel product.`);
 	if (!DOCUMENT_FILE_TYPES.includes(fileType)) throw new require_errors.WpdUnsupportedVersionError(`File type ${fileType} is not a WordPerfect document (expected ${DOCUMENT_FILE_TYPES.join(" or ")}).`);
 	if (majorVersion !== MAJOR_VERSION_WP6_THROUGH_X6) throw new require_errors.WpdUnsupportedVersionError(`Major version ${majorVersion} is outside the WordPerfect 6.x-X6 lineage (major version ${MAJOR_VERSION_WP6_THROUGH_X6}), the one generation this reader covers.`);
@@ -39,7 +40,8 @@ function readFileHeader(bytes) {
 		majorVersion,
 		minorVersion,
 		indexAreaOffset,
-		fileSize: require_bytes_view.uint32At(bytes, 20)
+		fileSize: require_bytes_view.uint32At(bytes, 20),
+		encryption
 	};
 }
 //#endregion

package/dist/container/header.d.cts

@@ -1,6 +1,9 @@
 //#region src/container/header.d.ts
 declare const WPD_FILE_ID: readonly number[];
 declare const WPD_PREFIX_HEADER_SIZE = 512;
+interface ReadWpdHeaderOptions {
+  readonly password?: string;
+}
 interface WpdFileHeader {
   readonly documentAreaOffset: number;
   readonly productType: number;
@@ -9,8 +12,9 @@ interface WpdFileHeader {
   readonly minorVersion: number;
   readonly indexAreaOffset: number;
   readonly fileSize: number;
+  readonly encryption: number;
 }
 declare function hasWordPerfectFileId(bytes: Uint8Array): boolean;
-declare function readFileHeader(bytes: Uint8Array): WpdFileHeader;
+declare function readFileHeader(bytes: Uint8Array, options?: ReadWpdHeaderOptions): WpdFileHeader;
 //#endregion
-export { WPD_FILE_ID, WPD_PREFIX_HEADER_SIZE, WpdFileHeader, hasWordPerfectFileId, readFileHeader };
+export { ReadWpdHeaderOptions, WPD_FILE_ID, WPD_PREFIX_HEADER_SIZE, WpdFileHeader, hasWordPerfectFileId, readFileHeader };

package/dist/container/header.d.ts

@@ -1,6 +1,9 @@
 //#region src/container/header.d.ts
 declare const WPD_FILE_ID: readonly number[];
 declare const WPD_PREFIX_HEADER_SIZE = 512;
+interface ReadWpdHeaderOptions {
+  readonly password?: string;
+}
 interface WpdFileHeader {
   readonly documentAreaOffset: number;
   readonly productType: number;
@@ -9,8 +12,9 @@ interface WpdFileHeader {
   readonly minorVersion: number;
   readonly indexAreaOffset: number;
   readonly fileSize: number;
+  readonly encryption: number;
 }
 declare function hasWordPerfectFileId(bytes: Uint8Array): boolean;
-declare function readFileHeader(bytes: Uint8Array): WpdFileHeader;
+declare function readFileHeader(bytes: Uint8Array, options?: ReadWpdHeaderOptions): WpdFileHeader;
 //#endregion
-export { WPD_FILE_ID, WPD_PREFIX_HEADER_SIZE, WpdFileHeader, hasWordPerfectFileId, readFileHeader };
+export { ReadWpdHeaderOptions, WPD_FILE_ID, WPD_PREFIX_HEADER_SIZE, WpdFileHeader, hasWordPerfectFileId, readFileHeader };

package/dist/container/header.js

@@ -15,7 +15,7 @@ function hasWordPerfectFileId(bytes) {
 	if (bytes.length < WPD_FILE_ID.length) return false;
 	return WPD_FILE_ID.every((expected, index) => bytes[index] === expected);
 }
-function readFileHeader(bytes) {
+function readFileHeader(bytes, options = {}) {
 	if (!hasWordPerfectFileId(bytes)) {
 		const actual = Array.from(sliceAt(bytes, 0, Math.min(4, bytes.length))).map((byte) => byte.toString(16).padStart(2, "0")).join(" ");
 		throw new WpdNotAWordPerfectFileError(`Expected the WordPerfect file ID FF 57 50 43 (-1,"WPC") at offset 0, found ${actual}.`);
@@ -27,7 +27,8 @@ function readFileHeader(bytes) {
 	const minorVersion = byteAt(bytes, 11);
 	const encryption = uint16At(bytes, 12);
 	const indexAreaOffset = uint16At(bytes, 14);
-	if (encryption !== 0) throw new WpdEncryptedDocumentError(`This document is encrypted (encryption word ${encryption}); nothing beyond the file header is intelligible without the password, which this reader does not support.`);
+	const suppliedPassword = options.password === "" ? void 0 : options.password;
+	if (encryption !== 0 && suppliedPassword === void 0) throw new WpdEncryptedDocumentError(`This document is encrypted (encryption word ${encryption}); nothing beyond the file header is intelligible without the password. Pass { password } to read it -- the standard ("original") encryption mode is supported, and a non-matching password throws WpdWrongPasswordError.`);
 	if (productType !== PRODUCT_TYPE_WORDPERFECT) throw new WpdUnsupportedVersionError(`Product type ${productType} is not WordPerfect (${PRODUCT_TYPE_WORDPERFECT}); this file was produced by a different Corel product.`);
 	if (!DOCUMENT_FILE_TYPES.includes(fileType)) throw new WpdUnsupportedVersionError(`File type ${fileType} is not a WordPerfect document (expected ${DOCUMENT_FILE_TYPES.join(" or ")}).`);
 	if (majorVersion !== MAJOR_VERSION_WP6_THROUGH_X6) throw new WpdUnsupportedVersionError(`Major version ${majorVersion} is outside the WordPerfect 6.x-X6 lineage (major version ${MAJOR_VERSION_WP6_THROUGH_X6}), the one generation this reader covers.`);
@@ -38,7 +39,8 @@ function readFileHeader(bytes) {
 		majorVersion,
 		minorVersion,
 		indexAreaOffset,
-		fileSize: uint32At(bytes, 20)
+		fileSize: uint32At(bytes, 20),
+		encryption
 	};
 }
 //#endregion

package/dist/errors.cjs

@@ -18,6 +18,16 @@ var WpdEncryptedDocumentError = class extends WpdFormatError {
 		this.name = "WpdEncryptedDocumentError";
 	}
 };
+var WpdWrongPasswordError = class extends WpdFormatError {
+	headerEncryptionWord;
+	passwordChecksum;
+	constructor(headerEncryptionWord, passwordChecksum) {
+		super(`The header's encryption word (0x${headerEncryptionWord.toString(16)}) does not match this password's checksum (0x${passwordChecksum.toString(16)}): either the password is wrong, or the file uses the enhanced encryption mode (WordPerfect 9 and later), which this reader does not support.`);
+		this.headerEncryptionWord = headerEncryptionWord;
+		this.passwordChecksum = passwordChecksum;
+		this.name = "WpdWrongPasswordError";
+	}
+};
 var WpdUnsupportedVersionError = class extends WpdFormatError {
 	constructor(message) {
 		super(message);
@@ -29,3 +39,4 @@ exports.WpdEncryptedDocumentError = WpdEncryptedDocumentError;
 exports.WpdFormatError = WpdFormatError;
 exports.WpdNotAWordPerfectFileError = WpdNotAWordPerfectFileError;
 exports.WpdUnsupportedVersionError = WpdUnsupportedVersionError;
+exports.WpdWrongPasswordError = WpdWrongPasswordError;

package/dist/errors.d.cts

@@ -8,8 +8,13 @@ declare class WpdNotAWordPerfectFileError extends WpdFormatError {
 declare class WpdEncryptedDocumentError extends WpdFormatError {
   constructor(message: string);
 }
+declare class WpdWrongPasswordError extends WpdFormatError {
+  readonly headerEncryptionWord: number;
+  readonly passwordChecksum: number;
+  constructor(headerEncryptionWord: number, passwordChecksum: number);
+}
 declare class WpdUnsupportedVersionError extends WpdFormatError {
   constructor(message: string);
 }
 //#endregion
-export { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError };
+export { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError, WpdWrongPasswordError };

package/dist/errors.d.ts

@@ -8,8 +8,13 @@ declare class WpdNotAWordPerfectFileError extends WpdFormatError {
 declare class WpdEncryptedDocumentError extends WpdFormatError {
   constructor(message: string);
 }
+declare class WpdWrongPasswordError extends WpdFormatError {
+  readonly headerEncryptionWord: number;
+  readonly passwordChecksum: number;
+  constructor(headerEncryptionWord: number, passwordChecksum: number);
+}
 declare class WpdUnsupportedVersionError extends WpdFormatError {
   constructor(message: string);
 }
 //#endregion
-export { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError };
+export { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError, WpdWrongPasswordError };

package/dist/errors.js

@@ -17,6 +17,16 @@ var WpdEncryptedDocumentError = class extends WpdFormatError {
 		this.name = "WpdEncryptedDocumentError";
 	}
 };
+var WpdWrongPasswordError = class extends WpdFormatError {
+	headerEncryptionWord;
+	passwordChecksum;
+	constructor(headerEncryptionWord, passwordChecksum) {
+		super(`The header's encryption word (0x${headerEncryptionWord.toString(16)}) does not match this password's checksum (0x${passwordChecksum.toString(16)}): either the password is wrong, or the file uses the enhanced encryption mode (WordPerfect 9 and later), which this reader does not support.`);
+		this.headerEncryptionWord = headerEncryptionWord;
+		this.passwordChecksum = passwordChecksum;
+		this.name = "WpdWrongPasswordError";
+	}
+};
 var WpdUnsupportedVersionError = class extends WpdFormatError {
 	constructor(message) {
 		super(message);
@@ -24,4 +34,4 @@ var WpdUnsupportedVersionError = class extends WpdFormatError {
 	}
 };
 //#endregion
-export { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError };
+export { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError, WpdWrongPasswordError };

package/dist/index.cjs

@@ -67,6 +67,7 @@ exports.WpdEncryptedDocumentError = require_errors.WpdEncryptedDocumentError;
 exports.WpdFormatError = require_errors.WpdFormatError;
 exports.WpdNotAWordPerfectFileError = require_errors.WpdNotAWordPerfectFileError;
 exports.WpdUnsupportedVersionError = require_errors.WpdUnsupportedVersionError;
+exports.WpdWrongPasswordError = require_errors.WpdWrongPasswordError;
 exports.decodeAttributeByte = require_stream_attributes.decodeAttributeByte;
 exports.decodeSingleByteCharacter = require_stream_characters.decodeSingleByteCharacter;
 exports.decodeWordString = require_stream_characters.decodeWordString;

package/dist/index.d.cts

@@ -5,7 +5,7 @@ import { WPD_FILE_ID, WPD_PREFIX_HEADER_SIZE, WpdFileHeader, hasWordPerfectFileI
 import { PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, WPD_INDEX_RECORD_SIZE, WpdPrefixPacket, packetByPrefixId, readPrefixPackets, readTypefaceName } from "./container/prefix.cjs";
 import { PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, WpdDocumentContainer, openWpdDocument } from "./container/container.cjs";
 import { PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, readDocumentSummary } from "./container/summary.cjs";
-import { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError } from "./errors.cjs";
+import { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError, WpdWrongPasswordError } from "./errors.cjs";
 import { WPD_FILE_EXTENSION, WPD_MEDIA_TYPE } from "./format.cjs";
 import { FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTION, WpdCharacterToken, WpdFixedFunctionToken, WpdSingleByteFunctionToken, WpdToken, WpdVariableFunctionToken, tokeniseDocumentArea } from "./stream/tokenise.cjs";
 import { EOL_GROUP, FIRST_SINGLE_BYTE_EOL, LAST_SINGLE_BYTE_EOL, WpdEolMapping, eolMappingForSubfunction, isSingleByteEol, subfunctionForSingleByteEol } from "./stream/eol.cjs";
@@ -16,4 +16,4 @@ import { COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_
 import { TAB_GROUP, WpdTabEffect, tabEffectFor } from "./stream/tab.cjs";
 import { DISPLAY_NUMBER_GROUP, STYLE_GROUP, WpdStyleSemantics, isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isStyleScopeCloser, isStyleScopeOpener, readDisplayNumberLevel, readSystemStyleNumber, styleSemanticsFor } from "./stream/style.cjs";
 import { CELL_FILL_COLORS_SUBFUNCTION, CELL_INFORMATION_SUBFUNCTION, CELL_SPANNING_SUBFUNCTION, CHARACTER_DEFINE_TABLE_END, CHARACTER_TABLE_COLUMN, CHARACTER_TABLE_DEFINITION, ROW_INFORMATION_SUBFUNCTION, WpdCellFill, WpdCellInformation, WpdCellSpanning, WpdEmbeddedSubfunction, WpdEmbeddedSubfunctions, WpdRowInformation, findEmbeddedSubfunction, readCellFill, readCellInformation, readCellSpanning, readEmbeddedSubfunctions, readRowInformation, readTableColumnWidthPt } from "./stream/table.cjs";
-export { ATTRIBUTE_OFF, ATTRIBUTE_ON, CELL_FILL_COLORS_SUBFUNCTION, CELL_INFORMATION_SUBFUNCTION, CELL_SPANNING_SUBFUNCTION, CHARACTER_DEFINE_TABLE_END, CHARACTER_TABLE_COLUMN, CHARACTER_TABLE_DEFINITION, COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_MARGIN_PT, DEFAULT_PAGE_HEIGHT_PT, DEFAULT_PAGE_WIDTH_PT, DISPLAY_NUMBER_GROUP, EOL_GROUP, FIRST_ASCII_CHARACTER, FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_EOL, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTION, LAST_CHARACTER, LAST_SINGLE_BYTE_EOL, NOOP_WPD_DIAGNOSTIC_SINK, PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, PAGE_BOTTOM_MARGIN_SET, PAGE_FORM, PAGE_GROUP, PAGE_TOP_MARGIN_SET, PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, POINTS_PER_INCH, ROW_INFORMATION_SUBFUNCTION, type ReadWpdOptions, STYLE_GROUP, TAB_GROUP, UNMAPPED_CHARACTER, WPD_FILE_EXTENSION, WPD_FILE_ID, WPD_INDEX_RECORD_SIZE, WPD_MEDIA_TYPE, WPD_PREFIX_HEADER_SIZE, WPU_PER_INCH, WpdAttribute, type WpdAttributeCode, WpdBytesSchema, type WpdCellFill, type WpdCellInformation, type WpdCellSpanning, type WpdCharacterToken, type WpdDiagnostic, WpdDiagnosticCodes, type WpdDiagnosticSink, type WpdDocumentContainer, type WpdEmbeddedSubfunction, type WpdEmbeddedSubfunctions, WpdEncryptedDocumentError, type WpdEolMapping, type WpdFileHeader, type WpdFixedFunctionToken, WpdFormatError, WpdNotAWordPerfectFileError, type WpdPageForm, type WpdPrefixPacket, type WpdRowInformation, type WpdRunAttributes, type WpdSingleByteFunctionToken, type WpdStyleSemantics, type WpdTabEffect, type WpdToken, WpdUnsupportedVersionError, type WpdVariableFunctionToken, decodeAttributeByte, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter, eolMappingForSubfunction, findEmbeddedSubfunction, hasWordPerfectFileId, isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isSingleByteEol, isStyleScopeCloser, isStyleScopeOpener, openWpdDocument, packetByPrefixId, pointsFromWpu, readCellFill, readCellInformation, readCellSpanning, readDisplayNumberLevel, readDocumentSummary, readEmbeddedSubfunctions, readFileHeader, readMarginPt, readPageForm, readPrefixPackets, readRowInformation, readSystemStyleNumber, readTableColumnWidthPt, readTypefaceName, readWpd, readWpdContent, runAttributesFrom, styleSemanticsFor, subfunctionForSingleByteEol, tabEffectFor, tokeniseDocumentArea, wpdContentCodec };
+export { ATTRIBUTE_OFF, ATTRIBUTE_ON, CELL_FILL_COLORS_SUBFUNCTION, CELL_INFORMATION_SUBFUNCTION, CELL_SPANNING_SUBFUNCTION, CHARACTER_DEFINE_TABLE_END, CHARACTER_TABLE_COLUMN, CHARACTER_TABLE_DEFINITION, COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_MARGIN_PT, DEFAULT_PAGE_HEIGHT_PT, DEFAULT_PAGE_WIDTH_PT, DISPLAY_NUMBER_GROUP, EOL_GROUP, FIRST_ASCII_CHARACTER, FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_EOL, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTION, LAST_CHARACTER, LAST_SINGLE_BYTE_EOL, NOOP_WPD_DIAGNOSTIC_SINK, PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, PAGE_BOTTOM_MARGIN_SET, PAGE_FORM, PAGE_GROUP, PAGE_TOP_MARGIN_SET, PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, POINTS_PER_INCH, ROW_INFORMATION_SUBFUNCTION, type ReadWpdOptions, STYLE_GROUP, TAB_GROUP, UNMAPPED_CHARACTER, WPD_FILE_EXTENSION, WPD_FILE_ID, WPD_INDEX_RECORD_SIZE, WPD_MEDIA_TYPE, WPD_PREFIX_HEADER_SIZE, WPU_PER_INCH, WpdAttribute, type WpdAttributeCode, WpdBytesSchema, type WpdCellFill, type WpdCellInformation, type WpdCellSpanning, type WpdCharacterToken, type WpdDiagnostic, WpdDiagnosticCodes, type WpdDiagnosticSink, type WpdDocumentContainer, type WpdEmbeddedSubfunction, type WpdEmbeddedSubfunctions, WpdEncryptedDocumentError, type WpdEolMapping, type WpdFileHeader, type WpdFixedFunctionToken, WpdFormatError, WpdNotAWordPerfectFileError, type WpdPageForm, type WpdPrefixPacket, type WpdRowInformation, type WpdRunAttributes, type WpdSingleByteFunctionToken, type WpdStyleSemantics, type WpdTabEffect, type WpdToken, WpdUnsupportedVersionError, type WpdVariableFunctionToken, WpdWrongPasswordError, decodeAttributeByte, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter, eolMappingForSubfunction, findEmbeddedSubfunction, hasWordPerfectFileId, isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isSingleByteEol, isStyleScopeCloser, isStyleScopeOpener, openWpdDocument, packetByPrefixId, pointsFromWpu, readCellFill, readCellInformation, readCellSpanning, readDisplayNumberLevel, readDocumentSummary, readEmbeddedSubfunctions, readFileHeader, readMarginPt, readPageForm, readPrefixPackets, readRowInformation, readSystemStyleNumber, readTableColumnWidthPt, readTypefaceName, readWpd, readWpdContent, runAttributesFrom, styleSemanticsFor, subfunctionForSingleByteEol, tabEffectFor, tokeniseDocumentArea, wpdContentCodec };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { WPD_FILE_ID, WPD_PREFIX_HEADER_SIZE, WpdFileHeader, hasWordPerfectFileI
 import { PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, WPD_INDEX_RECORD_SIZE, WpdPrefixPacket, packetByPrefixId, readPrefixPackets, readTypefaceName } from "./container/prefix.js";
 import { PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, WpdDocumentContainer, openWpdDocument } from "./container/container.js";
 import { PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, readDocumentSummary } from "./container/summary.js";
-import { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError } from "./errors.js";
+import { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError, WpdWrongPasswordError } from "./errors.js";
 import { WPD_FILE_EXTENSION, WPD_MEDIA_TYPE } from "./format.js";
 import { FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTION, WpdCharacterToken, WpdFixedFunctionToken, WpdSingleByteFunctionToken, WpdToken, WpdVariableFunctionToken, tokeniseDocumentArea } from "./stream/tokenise.js";
 import { EOL_GROUP, FIRST_SINGLE_BYTE_EOL, LAST_SINGLE_BYTE_EOL, WpdEolMapping, eolMappingForSubfunction, isSingleByteEol, subfunctionForSingleByteEol } from "./stream/eol.js";
@@ -16,4 +16,4 @@ import { COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_
 import { TAB_GROUP, WpdTabEffect, tabEffectFor } from "./stream/tab.js";
 import { DISPLAY_NUMBER_GROUP, STYLE_GROUP, WpdStyleSemantics, isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isStyleScopeCloser, isStyleScopeOpener, readDisplayNumberLevel, readSystemStyleNumber, styleSemanticsFor } from "./stream/style.js";
 import { CELL_FILL_COLORS_SUBFUNCTION, CELL_INFORMATION_SUBFUNCTION, CELL_SPANNING_SUBFUNCTION, CHARACTER_DEFINE_TABLE_END, CHARACTER_TABLE_COLUMN, CHARACTER_TABLE_DEFINITION, ROW_INFORMATION_SUBFUNCTION, WpdCellFill, WpdCellInformation, WpdCellSpanning, WpdEmbeddedSubfunction, WpdEmbeddedSubfunctions, WpdRowInformation, findEmbeddedSubfunction, readCellFill, readCellInformation, readCellSpanning, readEmbeddedSubfunctions, readRowInformation, readTableColumnWidthPt } from "./stream/table.js";
-export { ATTRIBUTE_OFF, ATTRIBUTE_ON, CELL_FILL_COLORS_SUBFUNCTION, CELL_INFORMATION_SUBFUNCTION, CELL_SPANNING_SUBFUNCTION, CHARACTER_DEFINE_TABLE_END, CHARACTER_TABLE_COLUMN, CHARACTER_TABLE_DEFINITION, COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_MARGIN_PT, DEFAULT_PAGE_HEIGHT_PT, DEFAULT_PAGE_WIDTH_PT, DISPLAY_NUMBER_GROUP, EOL_GROUP, FIRST_ASCII_CHARACTER, FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_EOL, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTION, LAST_CHARACTER, LAST_SINGLE_BYTE_EOL, NOOP_WPD_DIAGNOSTIC_SINK, PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, PAGE_BOTTOM_MARGIN_SET, PAGE_FORM, PAGE_GROUP, PAGE_TOP_MARGIN_SET, PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, POINTS_PER_INCH, ROW_INFORMATION_SUBFUNCTION, type ReadWpdOptions, STYLE_GROUP, TAB_GROUP, UNMAPPED_CHARACTER, WPD_FILE_EXTENSION, WPD_FILE_ID, WPD_INDEX_RECORD_SIZE, WPD_MEDIA_TYPE, WPD_PREFIX_HEADER_SIZE, WPU_PER_INCH, WpdAttribute, type WpdAttributeCode, WpdBytesSchema, type WpdCellFill, type WpdCellInformation, type WpdCellSpanning, type WpdCharacterToken, type WpdDiagnostic, WpdDiagnosticCodes, type WpdDiagnosticSink, type WpdDocumentContainer, type WpdEmbeddedSubfunction, type WpdEmbeddedSubfunctions, WpdEncryptedDocumentError, type WpdEolMapping, type WpdFileHeader, type WpdFixedFunctionToken, WpdFormatError, WpdNotAWordPerfectFileError, type WpdPageForm, type WpdPrefixPacket, type WpdRowInformation, type WpdRunAttributes, type WpdSingleByteFunctionToken, type WpdStyleSemantics, type WpdTabEffect, type WpdToken, WpdUnsupportedVersionError, type WpdVariableFunctionToken, decodeAttributeByte, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter, eolMappingForSubfunction, findEmbeddedSubfunction, hasWordPerfectFileId, isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isSingleByteEol, isStyleScopeCloser, isStyleScopeOpener, openWpdDocument, packetByPrefixId, pointsFromWpu, readCellFill, readCellInformation, readCellSpanning, readDisplayNumberLevel, readDocumentSummary, readEmbeddedSubfunctions, readFileHeader, readMarginPt, readPageForm, readPrefixPackets, readRowInformation, readSystemStyleNumber, readTableColumnWidthPt, readTypefaceName, readWpd, readWpdContent, runAttributesFrom, styleSemanticsFor, subfunctionForSingleByteEol, tabEffectFor, tokeniseDocumentArea, wpdContentCodec };
+export { ATTRIBUTE_OFF, ATTRIBUTE_ON, CELL_FILL_COLORS_SUBFUNCTION, CELL_INFORMATION_SUBFUNCTION, CELL_SPANNING_SUBFUNCTION, CHARACTER_DEFINE_TABLE_END, CHARACTER_TABLE_COLUMN, CHARACTER_TABLE_DEFINITION, COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_MARGIN_PT, DEFAULT_PAGE_HEIGHT_PT, DEFAULT_PAGE_WIDTH_PT, DISPLAY_NUMBER_GROUP, EOL_GROUP, FIRST_ASCII_CHARACTER, FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_EOL, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTION, LAST_CHARACTER, LAST_SINGLE_BYTE_EOL, NOOP_WPD_DIAGNOSTIC_SINK, PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, PAGE_BOTTOM_MARGIN_SET, PAGE_FORM, PAGE_GROUP, PAGE_TOP_MARGIN_SET, PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, POINTS_PER_INCH, ROW_INFORMATION_SUBFUNCTION, type ReadWpdOptions, STYLE_GROUP, TAB_GROUP, UNMAPPED_CHARACTER, WPD_FILE_EXTENSION, WPD_FILE_ID, WPD_INDEX_RECORD_SIZE, WPD_MEDIA_TYPE, WPD_PREFIX_HEADER_SIZE, WPU_PER_INCH, WpdAttribute, type WpdAttributeCode, WpdBytesSchema, type WpdCellFill, type WpdCellInformation, type WpdCellSpanning, type WpdCharacterToken, type WpdDiagnostic, WpdDiagnosticCodes, type WpdDiagnosticSink, type WpdDocumentContainer, type WpdEmbeddedSubfunction, type WpdEmbeddedSubfunctions, WpdEncryptedDocumentError, type WpdEolMapping, type WpdFileHeader, type WpdFixedFunctionToken, WpdFormatError, WpdNotAWordPerfectFileError, type WpdPageForm, type WpdPrefixPacket, type WpdRowInformation, type WpdRunAttributes, type WpdSingleByteFunctionToken, type WpdStyleSemantics, type WpdTabEffect, type WpdToken, WpdUnsupportedVersionError, type WpdVariableFunctionToken, WpdWrongPasswordError, decodeAttributeByte, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter, eolMappingForSubfunction, findEmbeddedSubfunction, hasWordPerfectFileId, isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isSingleByteEol, isStyleScopeCloser, isStyleScopeOpener, openWpdDocument, packetByPrefixId, pointsFromWpu, readCellFill, readCellInformation, readCellSpanning, readDisplayNumberLevel, readDocumentSummary, readEmbeddedSubfunctions, readFileHeader, readMarginPt, readPageForm, readPrefixPackets, readRowInformation, readSystemStyleNumber, readTableColumnWidthPt, readTypefaceName, readWpd, readWpdContent, runAttributesFrom, styleSemanticsFor, subfunctionForSingleByteEol, tabEffectFor, tokeniseDocumentArea, wpdContentCodec };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError } from "./errors.js";
+import { WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError, WpdWrongPasswordError } from "./errors.js";
 import { WPD_FILE_ID, WPD_PREFIX_HEADER_SIZE, hasWordPerfectFileId, readFileHeader } from "./container/header.js";
 import { FIRST_ASCII_CHARACTER, LAST_CHARACTER, UNMAPPED_CHARACTER, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter } from "./stream/characters.js";
 import { PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, WPD_INDEX_RECORD_SIZE, packetByPrefixId, readPrefixPackets, readTypefaceName } from "./container/prefix.js";
@@ -16,4 +16,4 @@ import { FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTI
 import { readWpd, readWpdContent } from "./read.js";
 import { WpdBytesSchema, wpdContentCodec } from "./codec.js";
 import { WPD_FILE_EXTENSION, WPD_MEDIA_TYPE } from "./format.js";
-export { ATTRIBUTE_OFF, ATTRIBUTE_ON, CELL_FILL_COLORS_SUBFUNCTION, CELL_INFORMATION_SUBFUNCTION, CELL_SPANNING_SUBFUNCTION, CHARACTER_DEFINE_TABLE_END, CHARACTER_TABLE_COLUMN, CHARACTER_TABLE_DEFINITION, COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_MARGIN_PT, DEFAULT_PAGE_HEIGHT_PT, DEFAULT_PAGE_WIDTH_PT, DISPLAY_NUMBER_GROUP, EOL_GROUP, FIRST_ASCII_CHARACTER, FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_EOL, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTION, LAST_CHARACTER, LAST_SINGLE_BYTE_EOL, NOOP_WPD_DIAGNOSTIC_SINK, PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, PAGE_BOTTOM_MARGIN_SET, PAGE_FORM, PAGE_GROUP, PAGE_TOP_MARGIN_SET, PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, POINTS_PER_INCH, ROW_INFORMATION_SUBFUNCTION, STYLE_GROUP, TAB_GROUP, UNMAPPED_CHARACTER, WPD_FILE_EXTENSION, WPD_FILE_ID, WPD_INDEX_RECORD_SIZE, WPD_MEDIA_TYPE, WPD_PREFIX_HEADER_SIZE, WPU_PER_INCH, WpdAttribute, WpdBytesSchema, WpdDiagnosticCodes, WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError, decodeAttributeByte, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter, eolMappingForSubfunction, findEmbeddedSubfunction, hasWordPerfectFileId, isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isSingleByteEol, isStyleScopeCloser, isStyleScopeOpener, openWpdDocument, packetByPrefixId, pointsFromWpu, readCellFill, readCellInformation, readCellSpanning, readDisplayNumberLevel, readDocumentSummary, readEmbeddedSubfunctions, readFileHeader, readMarginPt, readPageForm, readPrefixPackets, readRowInformation, readSystemStyleNumber, readTableColumnWidthPt, readTypefaceName, readWpd, readWpdContent, runAttributesFrom, styleSemanticsFor, subfunctionForSingleByteEol, tabEffectFor, tokeniseDocumentArea, wpdContentCodec };
+export { ATTRIBUTE_OFF, ATTRIBUTE_ON, CELL_FILL_COLORS_SUBFUNCTION, CELL_INFORMATION_SUBFUNCTION, CELL_SPANNING_SUBFUNCTION, CHARACTER_DEFINE_TABLE_END, CHARACTER_TABLE_COLUMN, CHARACTER_TABLE_DEFINITION, COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_MARGIN_PT, DEFAULT_PAGE_HEIGHT_PT, DEFAULT_PAGE_WIDTH_PT, DISPLAY_NUMBER_GROUP, EOL_GROUP, FIRST_ASCII_CHARACTER, FIRST_FIXED_FUNCTION, FIRST_SINGLE_BYTE_EOL, FIRST_SINGLE_BYTE_FUNCTION, FIRST_VARIABLE_FUNCTION, LAST_CHARACTER, LAST_SINGLE_BYTE_EOL, NOOP_WPD_DIAGNOSTIC_SINK, PACKET_TYPE_DESIRED_FONT_DESCRIPTOR, PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, PAGE_BOTTOM_MARGIN_SET, PAGE_FORM, PAGE_GROUP, PAGE_TOP_MARGIN_SET, PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, POINTS_PER_INCH, ROW_INFORMATION_SUBFUNCTION, STYLE_GROUP, TAB_GROUP, UNMAPPED_CHARACTER, WPD_FILE_EXTENSION, WPD_FILE_ID, WPD_INDEX_RECORD_SIZE, WPD_MEDIA_TYPE, WPD_PREFIX_HEADER_SIZE, WPU_PER_INCH, WpdAttribute, WpdBytesSchema, WpdDiagnosticCodes, WpdEncryptedDocumentError, WpdFormatError, WpdNotAWordPerfectFileError, WpdUnsupportedVersionError, WpdWrongPasswordError, decodeAttributeByte, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter, eolMappingForSubfunction, findEmbeddedSubfunction, hasWordPerfectFileId, isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isSingleByteEol, isStyleScopeCloser, isStyleScopeOpener, openWpdDocument, packetByPrefixId, pointsFromWpu, readCellFill, readCellInformation, readCellSpanning, readDisplayNumberLevel, readDocumentSummary, readEmbeddedSubfunctions, readFileHeader, readMarginPt, readPageForm, readPrefixPackets, readRowInformation, readSystemStyleNumber, readTableColumnWidthPt, readTypefaceName, readWpd, readWpdContent, runAttributesFrom, styleSemanticsFor, subfunctionForSingleByteEol, tabEffectFor, tokeniseDocumentArea, wpdContentCodec };

package/dist/read.cjs

@@ -683,7 +683,7 @@ function readMetadata(container) {
 }
 function readWpdContent(bytes, options = {}) {
 	const sink = options.sink ?? require_diagnostics.NOOP_WPD_DIAGNOSTIC_SINK;
-	const container = require_container_container.openWpdDocument(bytes);
+	const container = require_container_container.openWpdDocument(bytes, { password: options.password });
 	const { blocks, page } = foldTokens(require_stream_tokenise.tokeniseDocumentArea(container.bytes, container.documentAreaOffset, container.documentAreaEnd), container, sink);
 	return {
 		kind: "wordprocessing",

package/dist/read.d.cts

@@ -3,6 +3,7 @@ import { ContentDocument, DocumentTree } from "document-schema.js";
 //#region src/read.d.ts
 interface ReadWpdOptions {
   readonly sink?: WpdDiagnosticSink;
+  readonly password?: string;
 }
 declare function readWpdContent(bytes: Uint8Array, options?: ReadWpdOptions): ContentDocument;
 declare function readWpd(bytes: Uint8Array, options?: ReadWpdOptions): DocumentTree;

package/dist/read.d.ts

@@ -3,6 +3,7 @@ import { ContentDocument, DocumentTree } from "document-schema.js";
 //#region src/read.d.ts
 interface ReadWpdOptions {
   readonly sink?: WpdDiagnosticSink;
+  readonly password?: string;
 }
 declare function readWpdContent(bytes: Uint8Array, options?: ReadWpdOptions): ContentDocument;
 declare function readWpd(bytes: Uint8Array, options?: ReadWpdOptions): DocumentTree;

package/dist/read.js

@@ -682,7 +682,7 @@ function readMetadata(container) {
 }
 function readWpdContent(bytes, options = {}) {
 	const sink = options.sink ?? NOOP_WPD_DIAGNOSTIC_SINK;
-	const container = openWpdDocument(bytes);
+	const container = openWpdDocument(bytes, { password: options.password });
 	const { blocks, page } = foldTokens(tokeniseDocumentArea(container.bytes, container.documentAreaOffset, container.documentAreaEnd), container, sink);
 	return {
 		kind: "wordprocessing",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wpd-codec",
-  "version": "3.2.2",
+  "version": "3.3.0",
   "description": "Hand-written read-only WordPerfect 6.x-X6 (.wpd) reader over document-schema.js's ContentDocument",
   "type": "module",
   "repository": {