wpd-codec 1.0.2 → 1.1.0

package/README.md

@@ -4,7 +4,7 @@
 
 > Hand-written, read-only WordPerfect 6.x-X6 (`.wpd`) reading into `document-schema.js`'s `ContentDocument`, from Corel's own published File Format SDK — part of the [documents.js family](../../README.md). Worker-isomorphic: the same code runs under Node and inside a Cloudflare Workers isolate.
 
-**Status: under active development.** The read path below is tested against the specification's own worked examples and against hand-built fixtures derived from its field tables, but not yet against a corpus of real WordPerfect documents. See [Remaining scope](#remaining-scope) for what is deliberately not handled yet, and [What is not yet proven](#what-is-not-yet-proven) for the honest limits of the current evidence.
+**Status: under active development.** The read path below is tested against the specification's own worked examples, against hand-built fixtures derived from its field tables, and — since the corpus check described in [Evidence](#evidence) — against 93 real WordPerfect documents, 90 of which read and 3 of which are refused correctly. See [Remaining scope](#remaining-scope) for what is deliberately not handled yet.
 
 Created for [documents.js#819](https://github.com/ExaDev/documents.js/issues/819). The premise that made the issue worth acting on is that WordPerfect is not a reverse-engineered format: Corel shipped a File Format SDK as a supported developer product, and one specification covers the entire modern lineage — its own document-structure page states outright that "Files created in WordPerfect 6.x, through X6 are structured the same", so 1993 through 2012 is one format, not a family of them. There is also no JavaScript or TypeScript reader for it at all: [libwpd](https://libwpd.sourceforge.net/) is LGPL C++, WP_Reader is C#, and the SDK's own surviving mirror ships an Ada implementation.
 
@@ -12,16 +12,19 @@ Created for [documents.js#819](https://github.com/ExaDev/documents.js/issues/819
 
 Everything this package does is derived from the vendor's own documentation, and every non-obvious decision in the source cites the page it comes from.
 
-| Source                                                                                                                                                                                                                                                     | What it gives                                                                                                                                                                                                            |
-| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| [WordPerfect File Format SDK help](https://github.com/OneWingedShark/WordPerfect/tree/master/doc/SDK_Help/FileFormats)                                                                                                                                     | The specification itself, mirrored in full: document structure, the prefix packet catalogue, single-byte characters and functions, every variable-length function group, the fixed-length functions, and table formulas. |
-| [WPFF Document Structure](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_DocumentStructure.htm)                                                                                                                   | The file header, the index and packet data areas, the function-code stream's shape, the units glossary, and a complete annotated hex dump of a conforming generic prefix.                                                |
-| [WPFF Single-Byte Characters and Functions](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_SingleByte.htm)                                                                                                        | The character model and the eighty single-byte function codes.                                                                                                                                                           |
-| [WPFF D0 EOL Functions](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_D0-EOL.htm)                                                                                                                                | The End-of-Line group and, crucially, its "Conversion/Search mappings" column — the specification stating what a converting application should turn each break code into.                                                |
-| [WPFF Fixed-Length Multi-Byte Functions](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_xFixedLength.htm)                                                                                                         | Attribute On/Off, the Extended Character function, and the size of every fixed-length code.                                                                                                                              |
-| [WPFF D3 Paragraph](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_D3-Paragraph.htm) and [D4 Character](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_D4-Character.htm) | Justification, font face and size changes, colour, and the rest of the paragraph- and character-oriented functions.                                                                                                      |
-| [WPFF prefix packet catalogue](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_PrefixPkt0-32.htm)                                                                                                                  | The packet types, including the font typeface descriptor layout this package reads a run's font family out of.                                                                                                           |
-| [Corel's File Format SDK product page](https://web.archive.org/web/20120125025312/http://apps.corel.com/partners_developers/csp/wordperfect_fileformatsdk.htm)                                                                                             | The provenance: a supported Corel developer product documenting "the entire document format, document prefix and document codes".                                                                                        |
+| Source                                                                                                                                                                                                                                                      | What it gives                                                                                                                                                                                                            |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [WordPerfect File Format SDK help](https://github.com/OneWingedShark/WordPerfect/tree/master/doc/SDK_Help/FileFormats)                                                                                                                                      | The specification itself, mirrored in full: document structure, the prefix packet catalogue, single-byte characters and functions, every variable-length function group, the fixed-length functions, and table formulas. |
+| [WPFF Document Structure](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_DocumentStructure.htm)                                                                                                                    | The file header, the index and packet data areas, the function-code stream's shape, the units glossary, and a complete annotated hex dump of a conforming generic prefix.                                                |
+| [WPFF Single-Byte Characters and Functions](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_SingleByte.htm)                                                                                                         | The character model and the eighty single-byte function codes.                                                                                                                                                           |
+| [WPFF D0 EOL Functions](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_D0-EOL.htm)                                                                                                                                 | The End-of-Line group and, crucially, its "Conversion/Search mappings" column — the specification stating what a converting application should turn each break code into.                                                |
+| [WPFF Fixed-Length Multi-Byte Functions](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_xFixedLength.htm)                                                                                                          | Attribute On/Off, the Extended Character function, and the size of every fixed-length code.                                                                                                                              |
+| [WPFF D3 Paragraph](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_D3-Paragraph.htm) and [D4 Character](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_D4-Character.htm)  | Justification, font face and size changes, colour, and the rest of the paragraph- and character-oriented functions.                                                                                                      |
+| [WPFF D1 Page](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_D1-Page.htm) and [D2 Column](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_D2-Column.htm)                  | Page geometry: the Form function's own page size, and the four margin functions split across the two groups.                                                                                                             |
+| [WPFF DD Style](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_DD-Style.htm) and [DA Display Number](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_DA-DisplayNumber.htm) | The system style number enumeration this package's heading and outline-level recovery rests on, and the paragraph-number display pair.                                                                                   |
+| [WPFF E0 Tab](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_E0-Tab.htm)                                                                                                                                           | The tab definition bitfield, which this group carries in place of a subfunction number.                                                                                                                                  |
+| [WPFF prefix packet catalogue](https://github.com/OneWingedShark/WordPerfect/blob/master/doc/SDK_Help/FileFormats/WPFF_PrefixPkt0-32.htm)                                                                                                                   | The packet types, including the font typeface descriptor layout this package reads a run's font family out of, and the Extended Document Summary the document's own metadata comes from.                                 |
+| [Corel's File Format SDK product page](https://web.archive.org/web/20120125025312/http://apps.corel.com/partners_developers/csp/wordperfect_fileformatsdk.htm)                                                                                              | The provenance: a supported Corel developer product documenting "the entire document format, document prefix and document codes".                                                                                        |
 
 ## Getting started
 
@@ -49,7 +52,9 @@ import { readWpdContent } from "wpd-codec";
 // WordPerfect 6.x file, and a WP7-and-later OLE compound file whose
 // PerfectOffice_MAIN stream holds the identical byte stream.
 const document = readWpdContent(bytes);
-document.sections[0].blocks; // paragraphs, page breaks
+document.sections[0].pageSize; // the document's own form, not an assumed default
+document.sections[0].blocks; // paragraphs, tables, page breaks
+document.metadata; // from the document's own Extended Document Summary
 ```
 
 `readWpd` is the same read one level up, returning the tree-form `DocumentTree` every other codec in the family also offers. `wpdContentCodec` states the read half as `document-schema.js`'s own `ContentCodec` port, so a consumer dispatching over formats treats WordPerfect uniformly with the rest.
@@ -81,10 +86,16 @@ Every module is importable by package-relative path as well as through the barre
 | `container/container` | `openWpdDocument` (container, header, packets, and document-area bounds in one), `PERFECT_OFFICE_MAIN_STREAM`, `PERFECT_OFFICE_OBJECTS_STORAGE` |
 | `container/header`    | `readFileHeader`, `hasWordPerfectFileId`, `WPD_FILE_ID`, `WPD_PREFIX_HEADER_SIZE`                                                               |
 | `container/prefix`    | `readPrefixPackets`, `packetByPrefixId`, `readTypefaceName`, `WPD_INDEX_RECORD_SIZE`, `PACKET_TYPE_DESIRED_FONT_DESCRIPTOR`                     |
+| `container/summary`   | `readDocumentSummary` (the Extended Document Summary packet as a `LayoutMetadata`), `PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY`                     |
 | `stream/tokenise`     | `tokeniseDocumentArea` and the four token types                                                                                                 |
 | `stream/characters`   | `decodeWpCharacter`, `decodeSingleByteCharacter`, `decodeWordString`, `UNMAPPED_CHARACTER`                                                      |
 | `stream/eol`          | `eolMappingForSubfunction`, `subfunctionForSingleByteEol`, `isSingleByteEol`                                                                    |
 | `stream/attributes`   | `decodeAttributeByte`, `runAttributesFrom`, `WpdAttribute`                                                                                      |
+| `stream/units`        | `pointsFromWpu`, `WPU_PER_INCH`, `POINTS_PER_INCH`                                                                                              |
+| `stream/page`         | `readPageForm`, `readMarginPt`, the Page and Column group constants, and the WordPerfect default page                                           |
+| `stream/style`        | `styleSemanticsFor`, `readSystemStyleNumber`, the style scope predicates, and the Display Number group's paragraph-number pair                  |
+| `stream/table`        | `readEmbeddedSubfunctions`, `readTableColumnWidthPt`, `readRowInformation`, `readCellInformation`, `readCellSpanning`, `readCellFill`           |
+| `stream/tab`          | `tabEffectFor`, `TAB_GROUP`, `WpdTabEffect`                                                                                                     |
 
 The container and stream layers are public deliberately, not by accident: a consumer inspecting a WordPerfect file — a migration audit, a forensic tool, a reader for a construct this package does not yet lift into the shared schema — needs the parsed prefix and the raw function stream, not only the document they fold into.
 
@@ -96,7 +107,19 @@ A WordPerfect 6.x-X6 file is a **prefix** followed by a **document area**, optio
 
 **The tokeniser** (`src/stream/tokenise.ts`) walks the document area. Bytes at or below 0x7F are characters; above it, four ranges of function codes — single-byte (0x80-0xCF), variable-length multi-byte (0xD0-0xEF, self-describing through a size field), fixed-length multi-byte (0xF0-0xFE, sized by a table), and 0xFF, which cannot appear at all. Every multi-byte function is bracketed by matching begin and end gates, and the variable form repeats its size before the end gate; this package verifies all three redundancies, because they are the format's own integrity check — a stream that has gone out of step fails at the very next function rather than decoding rubbish for the rest of the file.
 
-**The fold** (`src/read.ts`) turns tokens into a `ContentDocument`. Characters accumulate into the current run, an attribute or font change closes that run and opens another, and an end-of-line function closes the paragraph. Nothing recurses and nothing looks ahead, which is what makes a hand-written reader for this format tractable at all.
+**The fold** (`src/read.ts`) turns tokens into a `ContentDocument`. Characters accumulate into the current run, an attribute or font change closes that run and opens another, and an end-of-line function closes the paragraph. Nothing recurses and nothing looks ahead, which is what makes a hand-written reader for this format tractable at all. It has exactly one nesting concept, and it is not recursion: while a table definition is open a closed paragraph joins the cell being built rather than the section's own block list, which is as deep as this format's own grid model goes.
+
+### A table is stated in two halves, in two different groups
+
+Neither half is nested inside the other, and knowing that is most of what reading one takes. The **definition** opens with Table Definition (`0xD42A`, "Table On"), is followed by one Table Column function (`0xD42C`) per column, and closes with Define Table End (`0xD42B`) — column widths and gutters, no content. The **content** follows as ordinary document text delimited by End-of-Line codes: subfunction 10 ends a cell, 11 through 16 end a cell and its row, 17 through 19 end the table. That is also why a reader with no table support recovers a table's text in reading order anyway: every boundary is a line break too.
+
+The per-cell facts are not functions of their own. Spanning, justification, background fill and fixed row height ride **inside** the End-of-Line function that ends the cell, as "embedded subfunctions" in its non-deletable data — a layout unique to this group ("This format is unique in that the non-deletable data area also contains deletable data"), so that region opens with a size word for the deletable half and the documented subfunctions sit after it. Each embedded subfunction is gated by its own code the way every multi-byte function is, and the SDK prints a size against each; `src/stream/table.ts` holds that column as a table, because a record whose size the specification does not state cannot be stepped over — the walk stops there and says so rather than guessing a length and decoding the rest as rubbish.
+
+### A heading is a heading because the file says which style it is
+
+WordPerfect states a style's identity twice: as a prefix ID naming the style's own packet, and — for a style the product defines rather than the user — as a **system style number** in the function's own data. The SDK enumerates that number, and its entries include "68 = heading level 1 style" through "75 = heading level 8 style", "52 = level 1 style (indented)" through "67 = level 8 style (not indented)", "31 = list" and "48 = bullets". Those are the whole basis for this package's heading and list recovery: nothing here infers a heading from a short line or a large font.
+
+One detail of the fold exists for this. A style region ends at its own closing code, which in a real document sits **before** the hard return that ends the paragraph — so a paragraph's heading level is captured when its first character arrives, not when it closes, which would find the scope already popped.
 
 ### Two containers, one document
 
@@ -131,28 +154,48 @@ The only mature reader for this format is [libwpd](https://libwpd.sourceforge.ne
 - Font family, from the Desired Font Descriptor packet a Font Face Change names; font size, from a Font Size Change; character colour.
 - Paragraph justification.
 - The Start/End of Text to Skip pair, whose contents the formatter does not display and this reader drops.
+- **Page geometry**: the page size from the Form function (0xD111) and all four margins from their own two groups — the vertical pair in the Page group (0xD100/0xD101), the horizontal pair in the Column group (0xD200/0xD201). Each dimension falls back to the WordPerfect default independently, so a document overriding only its top margin keeps US Letter and the other three inches rather than the whole default set.
+- **Tables**, as real `ContentTable` grids: column widths from the Table Column functions, cells and rows from the End-of-Line boundaries, and — from the embedded subfunctions riding inside those boundaries — merged cells as `colSpan`/`rowSpan` with the positions they cover dropped, cell background colour, per-cell justification applied to the paragraphs it holds, and fixed row heights.
+- **Heading levels and outline list levels**, from the Style group's system style numbers.
+- **Outline numbering**, from the Display Number group's Paragraph Number Display pair: the level becomes a list membership and the pair's rendered digits are dropped in favour of it, since a counter's display is generated content rather than typed text.
+- **Document metadata**, from the Extended Document Summary prefix packet (type 0x12): the Descriptive Name as the title, plus author, subject, keywords, and the creation and revision dates.
+- **Tabs and line-scoped alignment**, from the Tab group (0xE0), whose byte in the subfunction position is the tab definition itself rather than a subfunction number. A type that advances to a tab stop becomes a tab character; centre-on-margins, centre-on-current-position and flush-right instead begin the line-scoped alignment the single-byte End of Center Align functions already terminate.
 
 ### Remaining scope
 
-Everything below is recognised by the tokeniser and skipped by the fold, so a document containing it still reads — losing that construct's own structure, never the surrounding text.
-
-- **Tables.** Cell and row boundaries become paragraph breaks so a table's text survives in reading order; the grid, cell attributes, and the table's own formula language (`WPFF_TableFormulas`) are not reconstructed. Reported through `wpd/table-flattened`.
-- **Boxes and graphics** (the 0xDF group): figures, text boxes, and equations, and the WPG graphics they carry.
-- **Embedded OLE objects**, stored under the compound file's `PerfectOffice_OBJECTS` storage.
-- **Headers, footers, footnotes, and endnotes** (the 0xD6 and 0xD7 groups).
-- **Styles** (the 0xDD group) beyond the document's own Open Style: a run's directly-applied attributes are read, but a style packet's own definitions are not resolved onto the runs that reference them.
-- **Lists and outline numbering** (the 0xD8-0xDC groups).
-- **Merge codes** (the 0xDE group) and **cross-references** (0xD5).
-- **Page geometry** (the 0xD1 group): the section's page size and margins are the WordPerfect default (US Letter, one inch), not what a document that overrides them states.
-- **Document metadata**, which lives in prefix packets this reader does not yet interpret, so `metadata` is an empty envelope rather than fields invented from the file's structure.
-- **Character sets 2 and above**, and the part of set 1 the mirrored SDK pages do not tabulate. An unmapped character renders as U+FFFD and is reported through `wpd/unmapped-character` rather than dropped.
+Everything below is recognised by the tokeniser and skipped by the fold, so a document containing it still reads — losing that construct's own structure, never the surrounding text. Each is reported through the diagnostic sink rather than passed over in silence.
+
+- **Boxes and graphics** (the 0xDF group): figures, text boxes, equations, and the WPG graphics they carry. Reported through `wpd/box-dropped`. Two things make this genuinely larger than it looks rather than merely unfinished: which of a box's prefix IDs is its contents, its caption, its border or its fill is not stated positionally but decided by a nested tree of override flags, each of which is itself a mask-plus-data record whose presence depends on the flag above it — so the PID list cannot be read at all without walking that tree correctly, and there is no real file here to walk it against. And a box whose content type is image carries WPG vector graphics, which `ContentImageBlock`'s own `png`/`jpeg` pair cannot hold whatever the walk recovers.
+- **Embedded OLE objects**, stored under the compound file's `PerfectOffice_OBJECTS` storage. `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, so recovering one is a scoping question in its own right rather than a wiring job.
+- **Headers, footers, footnotes, and endnotes** (the 0xD6 and 0xD7 groups). Reported through `wpd/header-footer-dropped` and `wpd/note-dropped`. The text is genuinely recoverable — each function names a General WP Text packet (type 0x08) holding its own function-code stream, which this package's tokeniser and fold would read — but the flat `ContentDocument` has no page-furniture position for a header or footer and no note position for a footnote body. That body's real home is `document-schema.js`'s tree-only `definitions` table, which a codec producing the flat form cannot reach; it is the same gap `rtf-codec` documents for its own equivalent constructs, and it closes at the schema boundary rather than here.
+- **Styles** (the 0xDD group) beyond their system style numbers: a run's directly-applied attributes are read and a style region's own heading or outline level is recovered, but a style packet's own definitions (type 0x30) are not resolved onto the runs that reference them.
+- **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.
+- **Merge codes** (the 0xDE group) 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`.
+- **Table formulas** (`WPFF_TableFormulas`): the New Cell Formula embedded subfunction is walked past by its own length so the cells around it still read, but its tokenised formula is not decoded.
+- **Character sets 2 and above**, and the part of set 1 the mirrored SDK pages do not tabulate — the largest remaining fidelity gap, and the one the corpus check measured (see [Evidence](#evidence)): two thirds of the extended characters in real documents name **character set 4** alone, with set 1's untabulated part next, then sets 13, 6, 5, 8, 12 and 3. This is a missing source rather than unfinished work: the mirrored SDK Help states the mechanism — "The high byte is the number of the WordPerfect character set. The low byte contains an offset value into the character set" — and tabulates the thirty-two Default Extended International Characters, but carries no character-set table of its own for any set. It closes when one is transcribed against a citable source, not by inference. An unmapped character renders as U+FFFD and is reported through `wpd/unmapped-character` rather than dropped.
 - **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.
 
-### What is not yet proven
+## Evidence
+
+Two independent kinds, which answer different questions.
+
+**The specification's own worked examples and field tables** answer "does this match what Corel documented". Every unit test is built either from a worked example — the annotated generic-prefix hex dump, the `can't` extended-character example, the `com<0x83>ment` soft-hyphen example — or from a byte sequence assembled directly from a field table, so each expectation is checkable against the page it cites without a file to hand.
+
+**A real corpus** answers "does what Corel documented match what WordPerfect actually wrote", which the first kind cannot. The check ran against every WordPerfect 6.x-X6 file (file ID `FF 57 50 43`, major version 2) in [libwpd's own oss-fuzz seed corpus](https://sourceforge.net/projects/libwpd/files/corpus/) — 93 files: hand-authored feature tests, real bug-report attachments from the AbiWord, OpenOffice, LibreOffice and freedesktop trackers, and a batch of anonymised real-world documents — alongside the two WordPerfect 6 samples in the [Open Preservation Foundation's format corpus](https://github.com/openpreserve/format-corpus/tree/master/office/wordprocessing/WordPerfect6).
+
+Ninety read. Three are refused, and each refusal is the right answer rather than a failure: a WordPerfect 3 for Macintosh file is rejected on its major-version byte (a separate format that shares the file ID — see Scope), an encrypted document is rejected because nothing past its header is intelligible without the password, and one file's function gates genuinely do not match — an AbiWord bug-report attachment, in a corpus whose whole purpose is to collect files that broke something. That last one is the tokeniser's own design working: it fails at the first byte the format says cannot be there, naming the offset, rather than decoding rubbish for the rest of the file.
+
+What the corpus settles:
+
+- **The character model is right.** This was the assumption most likely to make every real document read back as nonsense — bytes 1 through 32 are accented-letter shorthands rather than ASCII, so byte `0x20` is the sharp s and a space is the Soft Space function. Real documents read back as correct prose, which they could not do if that were wrong.
+- **Page geometry, tables, metadata, and outline numbering are exercised by real files**, not only by fixtures: a quarter of the corpus states a page size other than US Letter, a third contains a table, and a sixth carries a document summary.
+- **The heading mapping is not.** No document in the corpus uses WordPerfect's own heading styles (system style numbers 68 through 75), so heading recovery is still evidenced by the specification's enumeration alone. The style group itself is heavily exercised — footnote-number, endnote-number, document and hypertext system styles all appear, and all correctly carry no structure.
+- **Character sets 2 and above are the largest remaining fidelity gap, and set 4 is most of it.** Two thirds of the extended characters in the corpus name character set 4, with the untabulated part of set 1 next, then sets 13, 6, 5, 8, 12 and 3. Each renders as U+FFFD today. That makes the missing character-set tables a concrete, measurable piece of work rather than a theoretical one.
 
-Stated plainly, because it is the difference between this package being correct and being consistent with its own tests:
+### What is still not proven
 
-- **No real-world corpus.** Every test here is built either from the specification's own worked examples — the annotated generic-prefix hex dump, the `can't` extended-character example, the `com<0x83>ment` soft-hyphen example — or from byte sequences assembled directly from its field tables. That is strong evidence for the container, prefix, tokeniser, and the specific constructs covered; it is not evidence about what real WordPerfect documents in the wild actually contain, particularly around deletable data and the constructs listed above.
+- **Two readings the specification does not settle, both chosen deliberately.** The Form function states its desired width and its desired length as two independent fields and its orientation as a third, and says nothing about whether the pair is written before or after the rotation — so a landscape form's dimensions go through exactly as written and the flag is reported through `wpd/landscape-orientation-unmapped` rather than rotated on this package's own inference. And a Table Column's `[width]` is the one horizontal dimension in the format the SDK does not tag `(WPU)`, so it is read as WordPerfect Units on the strength of the two gutter fields immediately after it, which are.
+- **Reading a document is not rendering one.** The corpus check confirms that each file reads, that its text is prose, and that the structures above are recovered; it does not compare the result against what WordPerfect itself would display, which would need a reference renderer this family does not have.
 - **The document-area's own file-size bound.** The header's file-size field is honoured only when self-consistent, because the SDK itself warns that a third-party writer failing to update it is a common real-world defect whose symptom is a document reading back blank.
 
 ## Conventions

package/dist/container/summary.cjs

@@ -0,0 +1,78 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_bytes_view = require("../bytes/view.cjs");
+const require_stream_characters = require("../stream/characters.cjs");
+//#region src/container/summary.ts
+const PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY = 18;
+const TAG_AUTHOR = 5;
+const TAG_CREATION_DATE = 14;
+const TAG_DESCRIPTIVE_NAME = 17;
+const TAG_KEYWORDS = 26;
+const TAG_REVISION_DATE = 39;
+const TAG_SUBJECT = 46;
+const TYPE_DATE = 4;
+const GROUP_HEADER_SIZE = 6;
+const DATE_FIELD_SIZE = 10;
+const MAX_SUMMARY_GROUPS = 100;
+function pad(value, width) {
+	return value.toString().padStart(width, "0");
+}
+function readDateField(bytes, offset) {
+	if (offset + DATE_FIELD_SIZE > bytes.length) return;
+	const year = require_bytes_view.uint16At(bytes, offset);
+	const month = bytes[offset + 2];
+	const day = bytes[offset + 3];
+	const hour = bytes[offset + 4];
+	const minute = bytes[offset + 5];
+	const second = bytes[offset + 6];
+	if (month === void 0 || day === void 0 || hour === void 0 || minute === void 0 || second === void 0) return;
+	if (year === 0 || month === 0 || day === 0) return;
+	return `${pad(year, 4)}-${pad(month, 2)}-${pad(day, 2)}T${pad(hour, 2)}:${pad(minute, 2)}:${pad(second, 2)}`;
+}
+function splitKeywords(value) {
+	return value.split(",").map((keyword) => keyword.trim()).filter((keyword) => keyword.length > 0);
+}
+function readDocumentSummary(packet) {
+	const metadata = {};
+	let cursor = 0;
+	for (let group = 0; group < MAX_SUMMARY_GROUPS; group += 1) {
+		if (cursor + GROUP_HEADER_SIZE > packet.length) break;
+		const size = require_bytes_view.uint16At(packet, cursor);
+		const tag = require_bytes_view.uint16At(packet, cursor + 2);
+		const type = require_bytes_view.uint16At(packet, cursor + 4);
+		if (size < GROUP_HEADER_SIZE || cursor + size > packet.length) break;
+		const availableWords = Math.floor((size - GROUP_HEADER_SIZE) / 2);
+		const name = require_stream_characters.decodeWordString(packet, cursor + GROUP_HEADER_SIZE, availableWords);
+		const dataOffset = cursor + GROUP_HEADER_SIZE + name.wordsRead * 2;
+		if ((type & TYPE_DATE) !== 0) {
+			const iso = readDateField(packet, dataOffset);
+			if (iso !== void 0) {
+				if (tag === TAG_CREATION_DATE) metadata.createdIso = iso;
+				else if (tag === TAG_REVISION_DATE) metadata.modifiedIso = iso;
+			}
+			cursor += size;
+			continue;
+		}
+		const { text } = require_stream_characters.decodeWordString(packet, dataOffset, availableWords - name.wordsRead);
+		if (text.length > 0) switch (tag) {
+			case TAG_DESCRIPTIVE_NAME:
+				metadata.title = text;
+				break;
+			case TAG_AUTHOR:
+				metadata.author = text;
+				break;
+			case TAG_SUBJECT:
+				metadata.subject = text;
+				break;
+			case TAG_KEYWORDS: {
+				const keywords = splitKeywords(text);
+				if (keywords.length > 0) metadata.keywords = keywords;
+				break;
+			}
+		}
+		cursor += size;
+	}
+	return metadata;
+}
+//#endregion
+exports.PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY = PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY;
+exports.readDocumentSummary = readDocumentSummary;

package/dist/container/summary.d.cts

@@ -0,0 +1,6 @@
+import { LayoutMetadata } from "document-schema.js";
+//#region src/container/summary.d.ts
+declare const PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY = 18;
+declare function readDocumentSummary(packet: Uint8Array): LayoutMetadata;
+//#endregion
+export { PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, readDocumentSummary };

package/dist/container/summary.d.ts

@@ -0,0 +1,6 @@
+import { LayoutMetadata } from "document-schema.js";
+//#region src/container/summary.d.ts
+declare const PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY = 18;
+declare function readDocumentSummary(packet: Uint8Array): LayoutMetadata;
+//#endregion
+export { PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, readDocumentSummary };

package/dist/container/summary.js

@@ -0,0 +1,76 @@
+import { uint16At } from "../bytes/view.js";
+import { decodeWordString } from "../stream/characters.js";
+//#region src/container/summary.ts
+const PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY = 18;
+const TAG_AUTHOR = 5;
+const TAG_CREATION_DATE = 14;
+const TAG_DESCRIPTIVE_NAME = 17;
+const TAG_KEYWORDS = 26;
+const TAG_REVISION_DATE = 39;
+const TAG_SUBJECT = 46;
+const TYPE_DATE = 4;
+const GROUP_HEADER_SIZE = 6;
+const DATE_FIELD_SIZE = 10;
+const MAX_SUMMARY_GROUPS = 100;
+function pad(value, width) {
+	return value.toString().padStart(width, "0");
+}
+function readDateField(bytes, offset) {
+	if (offset + DATE_FIELD_SIZE > bytes.length) return;
+	const year = uint16At(bytes, offset);
+	const month = bytes[offset + 2];
+	const day = bytes[offset + 3];
+	const hour = bytes[offset + 4];
+	const minute = bytes[offset + 5];
+	const second = bytes[offset + 6];
+	if (month === void 0 || day === void 0 || hour === void 0 || minute === void 0 || second === void 0) return;
+	if (year === 0 || month === 0 || day === 0) return;
+	return `${pad(year, 4)}-${pad(month, 2)}-${pad(day, 2)}T${pad(hour, 2)}:${pad(minute, 2)}:${pad(second, 2)}`;
+}
+function splitKeywords(value) {
+	return value.split(",").map((keyword) => keyword.trim()).filter((keyword) => keyword.length > 0);
+}
+function readDocumentSummary(packet) {
+	const metadata = {};
+	let cursor = 0;
+	for (let group = 0; group < MAX_SUMMARY_GROUPS; group += 1) {
+		if (cursor + GROUP_HEADER_SIZE > packet.length) break;
+		const size = uint16At(packet, cursor);
+		const tag = uint16At(packet, cursor + 2);
+		const type = uint16At(packet, cursor + 4);
+		if (size < GROUP_HEADER_SIZE || cursor + size > packet.length) break;
+		const availableWords = Math.floor((size - GROUP_HEADER_SIZE) / 2);
+		const name = decodeWordString(packet, cursor + GROUP_HEADER_SIZE, availableWords);
+		const dataOffset = cursor + GROUP_HEADER_SIZE + name.wordsRead * 2;
+		if ((type & TYPE_DATE) !== 0) {
+			const iso = readDateField(packet, dataOffset);
+			if (iso !== void 0) {
+				if (tag === TAG_CREATION_DATE) metadata.createdIso = iso;
+				else if (tag === TAG_REVISION_DATE) metadata.modifiedIso = iso;
+			}
+			cursor += size;
+			continue;
+		}
+		const { text } = decodeWordString(packet, dataOffset, availableWords - name.wordsRead);
+		if (text.length > 0) switch (tag) {
+			case TAG_DESCRIPTIVE_NAME:
+				metadata.title = text;
+				break;
+			case TAG_AUTHOR:
+				metadata.author = text;
+				break;
+			case TAG_SUBJECT:
+				metadata.subject = text;
+				break;
+			case TAG_KEYWORDS: {
+				const keywords = splitKeywords(text);
+				if (keywords.length > 0) metadata.keywords = keywords;
+				break;
+			}
+		}
+		cursor += size;
+	}
+	return metadata;
+}
+//#endregion
+export { PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY, readDocumentSummary };

package/dist/diagnostics-CR0pXOyb.d.cts

@@ -0,0 +1,25 @@
+//#region src/diagnostics.d.ts
+interface WpdDiagnostic {
+  readonly code: string;
+  readonly message: string;
+}
+type WpdDiagnosticSink = (diagnostic: WpdDiagnostic) => void;
+declare const WpdDiagnosticCodes: {
+  readonly UnmappedCharacter: "wpd/unmapped-character";
+  readonly MissingPrefixPacket: "wpd/missing-prefix-packet";
+  readonly TableFlattened: "wpd/table-flattened";
+  readonly ColumnBreakFlattened: "wpd/column-break-flattened";
+  readonly TableAttributesTruncated: "wpd/table-attributes-truncated";
+  readonly CellFillBlended: "wpd/cell-fill-blended";
+  readonly LandscapeOrientationUnmapped: "wpd/landscape-orientation-unmapped";
+  readonly PageGeometryChanged: "wpd/page-geometry-changed";
+  readonly OutlineNumberRegenerated: "wpd/outline-number-regenerated";
+  readonly BoxDropped: "wpd/box-dropped";
+  readonly NoteDropped: "wpd/note-dropped";
+  readonly HeaderFooterDropped: "wpd/header-footer-dropped";
+  readonly CrossReferenceFlattened: "wpd/cross-reference-flattened";
+  readonly MergeCodeDropped: "wpd/merge-code-dropped";
+};
+declare const NOOP_WPD_DIAGNOSTIC_SINK: WpdDiagnosticSink;
+//#endregion
+export { WpdDiagnosticSink as i, WpdDiagnostic as n, WpdDiagnosticCodes as r, NOOP_WPD_DIAGNOSTIC_SINK as t };

package/dist/diagnostics-CR0pXOyb.d.ts

@@ -0,0 +1,25 @@
+//#region src/diagnostics.d.ts
+interface WpdDiagnostic {
+  readonly code: string;
+  readonly message: string;
+}
+type WpdDiagnosticSink = (diagnostic: WpdDiagnostic) => void;
+declare const WpdDiagnosticCodes: {
+  readonly UnmappedCharacter: "wpd/unmapped-character";
+  readonly MissingPrefixPacket: "wpd/missing-prefix-packet";
+  readonly TableFlattened: "wpd/table-flattened";
+  readonly ColumnBreakFlattened: "wpd/column-break-flattened";
+  readonly TableAttributesTruncated: "wpd/table-attributes-truncated";
+  readonly CellFillBlended: "wpd/cell-fill-blended";
+  readonly LandscapeOrientationUnmapped: "wpd/landscape-orientation-unmapped";
+  readonly PageGeometryChanged: "wpd/page-geometry-changed";
+  readonly OutlineNumberRegenerated: "wpd/outline-number-regenerated";
+  readonly BoxDropped: "wpd/box-dropped";
+  readonly NoteDropped: "wpd/note-dropped";
+  readonly HeaderFooterDropped: "wpd/header-footer-dropped";
+  readonly CrossReferenceFlattened: "wpd/cross-reference-flattened";
+  readonly MergeCodeDropped: "wpd/merge-code-dropped";
+};
+declare const NOOP_WPD_DIAGNOSTIC_SINK: WpdDiagnosticSink;
+//#endregion
+export { WpdDiagnosticSink as i, WpdDiagnostic as n, WpdDiagnosticCodes as r, NOOP_WPD_DIAGNOSTIC_SINK as t };

package/dist/diagnostics.cjs

@@ -4,7 +4,17 @@ const WpdDiagnosticCodes = {
 	UnmappedCharacter: "wpd/unmapped-character",
 	MissingPrefixPacket: "wpd/missing-prefix-packet",
 	TableFlattened: "wpd/table-flattened",
-	ColumnBreakFlattened: "wpd/column-break-flattened"
+	ColumnBreakFlattened: "wpd/column-break-flattened",
+	TableAttributesTruncated: "wpd/table-attributes-truncated",
+	CellFillBlended: "wpd/cell-fill-blended",
+	LandscapeOrientationUnmapped: "wpd/landscape-orientation-unmapped",
+	PageGeometryChanged: "wpd/page-geometry-changed",
+	OutlineNumberRegenerated: "wpd/outline-number-regenerated",
+	BoxDropped: "wpd/box-dropped",
+	NoteDropped: "wpd/note-dropped",
+	HeaderFooterDropped: "wpd/header-footer-dropped",
+	CrossReferenceFlattened: "wpd/cross-reference-flattened",
+	MergeCodeDropped: "wpd/merge-code-dropped"
 };
 const NOOP_WPD_DIAGNOSTIC_SINK = () => {};
 //#endregion

package/dist/diagnostics.d.cts

@@ -1,2 +1,2 @@
-import { i as WpdDiagnosticSink, n as WpdDiagnostic, r as WpdDiagnosticCodes, t as NOOP_WPD_DIAGNOSTIC_SINK } from "./diagnostics-Cp0HKphg.cjs";
+import { i as WpdDiagnosticSink, n as WpdDiagnostic, r as WpdDiagnosticCodes, t as NOOP_WPD_DIAGNOSTIC_SINK } from "./diagnostics-CR0pXOyb.cjs";
 export { NOOP_WPD_DIAGNOSTIC_SINK, WpdDiagnostic, WpdDiagnosticCodes, WpdDiagnosticSink };

package/dist/diagnostics.d.ts

@@ -1,2 +1,2 @@
-import { i as WpdDiagnosticSink, n as WpdDiagnostic, r as WpdDiagnosticCodes, t as NOOP_WPD_DIAGNOSTIC_SINK } from "./diagnostics-Cp0HKphg.js";
+import { i as WpdDiagnosticSink, n as WpdDiagnostic, r as WpdDiagnosticCodes, t as NOOP_WPD_DIAGNOSTIC_SINK } from "./diagnostics-CR0pXOyb.js";
 export { NOOP_WPD_DIAGNOSTIC_SINK, WpdDiagnostic, WpdDiagnosticCodes, WpdDiagnosticSink };

package/dist/diagnostics.js

@@ -3,7 +3,17 @@ const WpdDiagnosticCodes = {
 	UnmappedCharacter: "wpd/unmapped-character",
 	MissingPrefixPacket: "wpd/missing-prefix-packet",
 	TableFlattened: "wpd/table-flattened",
-	ColumnBreakFlattened: "wpd/column-break-flattened"
+	ColumnBreakFlattened: "wpd/column-break-flattened",
+	TableAttributesTruncated: "wpd/table-attributes-truncated",
+	CellFillBlended: "wpd/cell-fill-blended",
+	LandscapeOrientationUnmapped: "wpd/landscape-orientation-unmapped",
+	PageGeometryChanged: "wpd/page-geometry-changed",
+	OutlineNumberRegenerated: "wpd/outline-number-regenerated",
+	BoxDropped: "wpd/box-dropped",
+	NoteDropped: "wpd/note-dropped",
+	HeaderFooterDropped: "wpd/header-footer-dropped",
+	CrossReferenceFlattened: "wpd/cross-reference-flattened",
+	MergeCodeDropped: "wpd/merge-code-dropped"
 };
 const NOOP_WPD_DIAGNOSTIC_SINK = () => {};
 //#endregion

package/dist/index.cjs

@@ -4,15 +4,34 @@ const require_container_header = require("./container/header.cjs");
 const require_stream_characters = require("./stream/characters.cjs");
 const require_container_prefix = require("./container/prefix.cjs");
 const require_container_container = require("./container/container.cjs");
+const require_container_summary = require("./container/summary.cjs");
 const require_diagnostics = require("./diagnostics.cjs");
 const require_stream_attributes = require("./stream/attributes.cjs");
 const require_stream_eol = require("./stream/eol.cjs");
+const require_stream_units = require("./stream/units.cjs");
+const require_stream_page = require("./stream/page.cjs");
+const require_stream_style = require("./stream/style.cjs");
+const require_stream_table = require("./stream/table.cjs");
+const require_stream_tab = require("./stream/tab.cjs");
 const require_stream_tokenise = require("./stream/tokenise.cjs");
 const require_read = require("./read.cjs");
 const require_codec = require("./codec.cjs");
 const require_format = require("./format.cjs");
 exports.ATTRIBUTE_OFF = require_stream_attributes.ATTRIBUTE_OFF;
 exports.ATTRIBUTE_ON = require_stream_attributes.ATTRIBUTE_ON;
+exports.CELL_FILL_COLORS_SUBFUNCTION = require_stream_table.CELL_FILL_COLORS_SUBFUNCTION;
+exports.CELL_INFORMATION_SUBFUNCTION = require_stream_table.CELL_INFORMATION_SUBFUNCTION;
+exports.CELL_SPANNING_SUBFUNCTION = require_stream_table.CELL_SPANNING_SUBFUNCTION;
+exports.CHARACTER_DEFINE_TABLE_END = require_stream_table.CHARACTER_DEFINE_TABLE_END;
+exports.CHARACTER_TABLE_COLUMN = require_stream_table.CHARACTER_TABLE_COLUMN;
+exports.CHARACTER_TABLE_DEFINITION = require_stream_table.CHARACTER_TABLE_DEFINITION;
+exports.COLUMN_GROUP = require_stream_page.COLUMN_GROUP;
+exports.COLUMN_LEFT_MARGIN_SET = require_stream_page.COLUMN_LEFT_MARGIN_SET;
+exports.COLUMN_RIGHT_MARGIN_SET = require_stream_page.COLUMN_RIGHT_MARGIN_SET;
+exports.DEFAULT_MARGIN_PT = require_stream_page.DEFAULT_MARGIN_PT;
+exports.DEFAULT_PAGE_HEIGHT_PT = require_stream_page.DEFAULT_PAGE_HEIGHT_PT;
+exports.DEFAULT_PAGE_WIDTH_PT = require_stream_page.DEFAULT_PAGE_WIDTH_PT;
+exports.DISPLAY_NUMBER_GROUP = require_stream_style.DISPLAY_NUMBER_GROUP;
 exports.EOL_GROUP = require_stream_eol.EOL_GROUP;
 exports.FIRST_ASCII_CHARACTER = require_stream_characters.FIRST_ASCII_CHARACTER;
 exports.FIRST_FIXED_FUNCTION = require_stream_tokenise.FIRST_FIXED_FUNCTION;
@@ -23,14 +42,24 @@ exports.LAST_CHARACTER = require_stream_characters.LAST_CHARACTER;
 exports.LAST_SINGLE_BYTE_EOL = require_stream_eol.LAST_SINGLE_BYTE_EOL;
 exports.NOOP_WPD_DIAGNOSTIC_SINK = require_diagnostics.NOOP_WPD_DIAGNOSTIC_SINK;
 exports.PACKET_TYPE_DESIRED_FONT_DESCRIPTOR = require_container_prefix.PACKET_TYPE_DESIRED_FONT_DESCRIPTOR;
+exports.PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY = require_container_summary.PACKET_TYPE_EXTENDED_DOCUMENT_SUMMARY;
+exports.PAGE_BOTTOM_MARGIN_SET = require_stream_page.PAGE_BOTTOM_MARGIN_SET;
+exports.PAGE_FORM = require_stream_page.PAGE_FORM;
+exports.PAGE_GROUP = require_stream_page.PAGE_GROUP;
+exports.PAGE_TOP_MARGIN_SET = require_stream_page.PAGE_TOP_MARGIN_SET;
 exports.PERFECT_OFFICE_MAIN_STREAM = require_container_container.PERFECT_OFFICE_MAIN_STREAM;
 exports.PERFECT_OFFICE_OBJECTS_STORAGE = require_container_container.PERFECT_OFFICE_OBJECTS_STORAGE;
+exports.POINTS_PER_INCH = require_stream_units.POINTS_PER_INCH;
+exports.ROW_INFORMATION_SUBFUNCTION = require_stream_table.ROW_INFORMATION_SUBFUNCTION;
+exports.STYLE_GROUP = require_stream_style.STYLE_GROUP;
+exports.TAB_GROUP = require_stream_tab.TAB_GROUP;
 exports.UNMAPPED_CHARACTER = require_stream_characters.UNMAPPED_CHARACTER;
 exports.WPD_FILE_EXTENSION = require_format.WPD_FILE_EXTENSION;
 exports.WPD_FILE_ID = require_container_header.WPD_FILE_ID;
 exports.WPD_INDEX_RECORD_SIZE = require_container_prefix.WPD_INDEX_RECORD_SIZE;
 exports.WPD_MEDIA_TYPE = require_format.WPD_MEDIA_TYPE;
 exports.WPD_PREFIX_HEADER_SIZE = require_container_header.WPD_PREFIX_HEADER_SIZE;
+exports.WPU_PER_INCH = require_stream_units.WPU_PER_INCH;
 exports.WpdAttribute = require_stream_attributes.WpdAttribute;
 exports.WpdBytesSchema = require_codec.WpdBytesSchema;
 exports.WpdDiagnosticCodes = require_diagnostics.WpdDiagnosticCodes;
@@ -43,16 +72,35 @@ exports.decodeSingleByteCharacter = require_stream_characters.decodeSingleByteCh
 exports.decodeWordString = require_stream_characters.decodeWordString;
 exports.decodeWpCharacter = require_stream_characters.decodeWpCharacter;
 exports.eolMappingForSubfunction = require_stream_eol.eolMappingForSubfunction;
+exports.findEmbeddedSubfunction = require_stream_table.findEmbeddedSubfunction;
 exports.hasWordPerfectFileId = require_container_header.hasWordPerfectFileId;
+exports.isParagraphNumberDisplayOff = require_stream_style.isParagraphNumberDisplayOff;
+exports.isParagraphNumberDisplayOn = require_stream_style.isParagraphNumberDisplayOn;
 exports.isSingleByteEol = require_stream_eol.isSingleByteEol;
+exports.isStyleScopeCloser = require_stream_style.isStyleScopeCloser;
+exports.isStyleScopeOpener = require_stream_style.isStyleScopeOpener;
 exports.openWpdDocument = require_container_container.openWpdDocument;
 exports.packetByPrefixId = require_container_prefix.packetByPrefixId;
+exports.pointsFromWpu = require_stream_units.pointsFromWpu;
+exports.readCellFill = require_stream_table.readCellFill;
+exports.readCellInformation = require_stream_table.readCellInformation;
+exports.readCellSpanning = require_stream_table.readCellSpanning;
+exports.readDisplayNumberLevel = require_stream_style.readDisplayNumberLevel;
+exports.readDocumentSummary = require_container_summary.readDocumentSummary;
+exports.readEmbeddedSubfunctions = require_stream_table.readEmbeddedSubfunctions;
 exports.readFileHeader = require_container_header.readFileHeader;
+exports.readMarginPt = require_stream_page.readMarginPt;
+exports.readPageForm = require_stream_page.readPageForm;
 exports.readPrefixPackets = require_container_prefix.readPrefixPackets;
+exports.readRowInformation = require_stream_table.readRowInformation;
+exports.readSystemStyleNumber = require_stream_style.readSystemStyleNumber;
+exports.readTableColumnWidthPt = require_stream_table.readTableColumnWidthPt;
 exports.readTypefaceName = require_container_prefix.readTypefaceName;
 exports.readWpd = require_read.readWpd;
 exports.readWpdContent = require_read.readWpdContent;
 exports.runAttributesFrom = require_stream_attributes.runAttributesFrom;
+exports.styleSemanticsFor = require_stream_style.styleSemanticsFor;
 exports.subfunctionForSingleByteEol = require_stream_eol.subfunctionForSingleByteEol;
+exports.tabEffectFor = require_stream_tab.tabEffectFor;
 exports.tokeniseDocumentArea = require_stream_tokenise.tokeniseDocumentArea;
 exports.wpdContentCodec = require_codec.wpdContentCodec;

package/dist/index.d.cts

@@ -1,13 +1,19 @@
-import { i as WpdDiagnosticSink, n as WpdDiagnostic, r as WpdDiagnosticCodes, t as NOOP_WPD_DIAGNOSTIC_SINK } from "./diagnostics-Cp0HKphg.cjs";
+import { i as WpdDiagnosticSink, n as WpdDiagnostic, r as WpdDiagnosticCodes, t as NOOP_WPD_DIAGNOSTIC_SINK } from "./diagnostics-CR0pXOyb.cjs";
 import { ReadWpdOptions, readWpd, readWpdContent } from "./read.cjs";
 import { WpdBytesSchema, wpdContentCodec } from "./codec.cjs";
 import { WPD_FILE_ID, WPD_PREFIX_HEADER_SIZE, WpdFileHeader, hasWordPerfectFileId, readFileHeader } from "./container/header.cjs";
 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 { 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";
 import { ATTRIBUTE_OFF, ATTRIBUTE_ON, WpdAttribute, WpdAttributeCode, WpdRunAttributes, decodeAttributeByte, runAttributesFrom } from "./stream/attributes.cjs";
 import { FIRST_ASCII_CHARACTER, LAST_CHARACTER, UNMAPPED_CHARACTER, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter } from "./stream/characters.cjs";
-export { ATTRIBUTE_OFF, ATTRIBUTE_ON, 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, PERFECT_OFFICE_MAIN_STREAM, PERFECT_OFFICE_OBJECTS_STORAGE, type ReadWpdOptions, UNMAPPED_CHARACTER, WPD_FILE_EXTENSION, WPD_FILE_ID, WPD_INDEX_RECORD_SIZE, WPD_MEDIA_TYPE, WPD_PREFIX_HEADER_SIZE, WpdAttribute, type WpdAttributeCode, WpdBytesSchema, type WpdCharacterToken, type WpdDiagnostic, WpdDiagnosticCodes, type WpdDiagnosticSink, type WpdDocumentContainer, WpdEncryptedDocumentError, type WpdEolMapping, type WpdFileHeader, type WpdFixedFunctionToken, WpdFormatError, WpdNotAWordPerfectFileError, type WpdPrefixPacket, type WpdRunAttributes, type WpdSingleByteFunctionToken, type WpdToken, WpdUnsupportedVersionError, type WpdVariableFunctionToken, decodeAttributeByte, decodeSingleByteCharacter, decodeWordString, decodeWpCharacter, eolMappingForSubfunction, hasWordPerfectFileId, isSingleByteEol, openWpdDocument, packetByPrefixId, readFileHeader, readPrefixPackets, readTypefaceName, readWpd, readWpdContent, runAttributesFrom, subfunctionForSingleByteEol, tokeniseDocumentArea, wpdContentCodec };
+import { POINTS_PER_INCH, WPU_PER_INCH, pointsFromWpu } from "./stream/units.cjs";
+import { COLUMN_GROUP, COLUMN_LEFT_MARGIN_SET, COLUMN_RIGHT_MARGIN_SET, DEFAULT_MARGIN_PT, DEFAULT_PAGE_HEIGHT_PT, DEFAULT_PAGE_WIDTH_PT, PAGE_BOTTOM_MARGIN_SET, PAGE_FORM, PAGE_GROUP, PAGE_TOP_MARGIN_SET, WpdPageForm, readMarginPt, readPageForm } from "./stream/page.cjs";
+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 };