archive-codec 1.3.0 → 1.4.1

package/README.md

@@ -2,7 +2,7 @@
 
 [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/documents.js/tree/main/packages/archive-codec) [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/archive-codec) [![npm version](https://img.shields.io/npm/v/archive-codec)](https://www.npmjs.com/package/archive-codec) [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/documents.js/ci.yml?branch=main)](https://github.com/ExaDev/documents.js/actions)
 
-> ZIP-in-ZIP recursive walking under depth and cumulative decompressed-size guards, and classic OLE compound-file ([MS-CFB]) reading and writing — zero document-format knowledge, the archive and container utility package for the [documents.js family](../../README.md). Worker-isomorphic: the same code runs under Node and inside a Cloudflare Workers isolate.
+> ZIP-in-ZIP recursive walking under depth and cumulative decompressed-size guards, classic OLE compound-file ([MS-CFB]) reading and writing, and [MS-OLEPS] Property Set Stream reading and writing — zero document-format knowledge, the archive and container utility package for the [documents.js family](../../README.md). Worker-isomorphic: the same code runs under Node and inside a Cloudflare Workers isolate.
 
 Created for [documents.js#564](https://github.com/ExaDev/documents.js/issues/564): nothing in the ecosystem recursed into a nested archive. Most concretely, OOXML's embedded-object model — a docx/pptx carrying a genuinely separate ZIP blob at `word/embeddings/oleObject1.xlsx` — had no safe handling anywhere, and no package guarded against recursive-archive inputs at all (`byte-codec`'s 512 MiB per-stream inflate cap does not compose across recursion). A new sibling was chosen over extending `byte-codec` (whose charter is byte/image primitives, zero container-format knowledge) or doing it inline in `documents.js` (which would repeat the duplication `byte-codec`'s own extraction was meant to avoid). Its first family consumer is `ooxml.js`'s OLE embedded-object recovery — [documents.js#733](https://github.com/ExaDev/documents.js/issues/733) (pptx, `p:oleObj`) and [documents.js#734](https://github.com/ExaDev/documents.js/issues/734) (docx, `o:OLEObject`): an OLE payload part's bytes are checked through `isZipArchive` and, when they are a ZIP, decoded as a nested OOXML package behind this package's guarded walk — the bounded inflate that populates `document-schema.js`'s `ContentEmbeddedObject`/`ContentEmbeddedObjectBlock` (the same vocabulary odf.js embeds formula sub-documents through) with a genuinely recovered sub-document.
 
@@ -10,7 +10,9 @@ Created for [documents.js#564](https://github.com/ExaDev/documents.js/issues/564
 
 [documents.js#815](https://github.com/ExaDev/documents.js/issues/815), [#816](https://github.com/ExaDev/documents.js/issues/816), and [#817](https://github.com/ExaDev/documents.js/issues/817) then needed the other direction. `xls-codec`, `doc-codec`, `ppt-codec`, and `wpd-codec` each read a legacy Office binary format out of an [MS-CFB] container, and none of them can write one back, because there was no container to put their streams into: a `.xls` writer producing a `Workbook` stream, or a `.doc` writer producing `WordDocument` and `1Table`, needs a conformant compound file to hold them. That container is structural knowledge exactly as the reader's is, so `writeCompoundFile` is the mirror of `readCompoundFile` here rather than four hand-rolled emitters in four codecs.
 
-Scope: **ZIP containers** (read and write over [`fflate`](https://github.com/101arrowz/fflate), recursive walking of ZIP-in-ZIP entries) and **classic OLE compound files** (bounded [MS-CFB] reading and conformant [MS-CFB] writing, plus the OLE Package stream unwrapping). **tar and gzip are explicitly out of scope.**
+[documents.js#815](https://github.com/ExaDev/documents.js/issues/815), [#816](https://github.com/ExaDev/documents.js/issues/816), and [#817](https://github.com/ExaDev/documents.js/issues/817) also each named the same remaining gap: `doc-codec`, `xls-codec`, and `ppt-codec` all hard-coded document metadata (title, author, dates) to an empty object, because that metadata lives in a genuinely different structure from the one each format's own reader already parses -- a [MS-OLEPS] Property Set Stream, conventionally stored as a "\x05SummaryInformation" stream beside `WordDocument`/`Workbook`/`PowerPoint Document` in the identical [MS-CFB] container all three already read through this package. `oleps/read` and `oleps/write` are the generic property-set codec (the stream header, the PropertySet packet's dictionary, and VT_I2/VT_I4/VT_LPSTR/VT_LPWSTR/VT_FILETIME typed values), and `oleps/summary-information` is the SummaryInformation-specific mapping on top of it -- the same two-layer split `cfb/read.ts` and `cfb/ole-package.ts` already establish for the OLE Package stream, container structure below, one named stream's own field layout above.
+
+Scope: **ZIP containers** (read and write over [`fflate`](https://github.com/101arrowz/fflate), recursive walking of ZIP-in-ZIP entries), **classic OLE compound files** (bounded [MS-CFB] reading and conformant [MS-CFB] writing, plus the OLE Package stream unwrapping), and **[MS-OLEPS] Property Set Streams** (generic read/write of a single-property-set stream, plus SummaryInformation's own title/subject/author/keywords/comments/created/last-saved/last-printed fields). **tar and gzip, DocumentSummaryInformation's extended and user-defined property sets, and writing VT_LPSTR (ANSI-codepage) string properties are explicitly out of scope.**
 
 ## Getting started
 
@@ -40,15 +42,19 @@ import { walkArchive } from "archive-codec/zip/walk";
 
 The smoke suite (`test/smoke.test.mjs`) is the guard on that advertisement: it loads each module below from the built `dist/` in both module systems, so a build config that stops serving an advertised subpath fails the suite — neither publint nor `attw` catches a wildcard whose targets are missing.
 
-| Module            | Exports                                                                                                                                                             |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `zip/container`   | `zipPackage` (ordered-entries ZIP write with stored-uncompressed support), `unzipPackage`, `ZipEntry`                                                               |
-| `zip/detect`      | `detectArchiveFormat` (`'zip' \| 'cfb' \| 'unknown'`), `isZipArchive`, `ArchiveFormat`                                                                              |
-| `zip/walk`        | `walkArchive` (recursive ZIP-in-ZIP walking), `ArchiveWalkEntry`, `ArchiveWalkLimitError`, `MAX_WALK_DEPTH`, `MAX_WALK_TOTAL_BYTES`, `WalkArchiveOptions`           |
-| `cfb/detect`      | `isCompoundFile` (the `D0 CF 11 E0 …` magic-byte check)                                                                                                             |
-| `cfb/read`        | `readCompoundFile` (bounded [MS-CFB] stream extraction), `CompoundFileStream`, `CompoundFileFormatError`, `MAX_CFB_TOTAL_STREAM_BYTES`, `ReadCompoundFileOptions`   |
-| `cfb/write`       | `writeCompoundFile` ([MS-CFB] container generation), `CompoundFileWriteError`, `WriteCompoundFileOptions` — takes the `CompoundFileStream` array `cfb/read` returns |
-| `cfb/ole-package` | `readOlePackage` (OLE Package stream unwrapping), `OlePackage`, `OlePackageFormatError`                                                                             |
+| Module                      | Exports                                                                                                                                                                                                                                                                                 |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `zip/container`             | `zipPackage` (ordered-entries ZIP write with stored-uncompressed support), `unzipPackage`, `ZipEntry`                                                                                                                                                                                   |
+| `zip/detect`                | `detectArchiveFormat` (`'zip' \| 'cfb' \| 'unknown'`), `isZipArchive`, `ArchiveFormat`                                                                                                                                                                                                  |
+| `zip/walk`                  | `walkArchive` (recursive ZIP-in-ZIP walking), `ArchiveWalkEntry`, `ArchiveWalkLimitError`, `MAX_WALK_DEPTH`, `MAX_WALK_TOTAL_BYTES`, `WalkArchiveOptions`                                                                                                                               |
+| `cfb/detect`                | `isCompoundFile` (the `D0 CF 11 E0 …` magic-byte check)                                                                                                                                                                                                                                 |
+| `cfb/read`                  | `readCompoundFile` (bounded [MS-CFB] stream extraction), `CompoundFileStream`, `CompoundFileFormatError`, `MAX_CFB_TOTAL_STREAM_BYTES`, `ReadCompoundFileOptions`                                                                                                                       |
+| `cfb/write`                 | `writeCompoundFile` ([MS-CFB] container generation), `CompoundFileWriteError`, `WriteCompoundFileOptions` — takes the `CompoundFileStream` array `cfb/read` returns                                                                                                                     |
+| `cfb/ole-package`           | `readOlePackage` (OLE Package stream unwrapping), `OlePackage`, `OlePackageFormatError`                                                                                                                                                                                                 |
+| `oleps/read`                | `readPropertySetStream` (generic [MS-OLEPS] property-set decoding), `PropertySetFormatError`                                                                                                                                                                                            |
+| `oleps/write`               | `writePropertySetStream` (generic [MS-OLEPS] property-set encoding), `PropertySetWriteError` — takes the `PropertySet` shape `oleps/read` returns                                                                                                                                       |
+| `oleps/summary-information` | `readSummaryInformation`, `writeSummaryInformationStream`, `SummaryInformationProperties`, `FMTID_SUMMARY_INFORMATION`                                                                                                                                                                  |
+| `oleps/layout-metadata`     | `summaryInformationToLayoutMetadata`, `layoutMetadataToSummaryInformation`, `hasSummaryInformationFields` — the `SummaryInformationProperties` <-> `document-schema.js`'s `LayoutMetadata` mapping, shared by `doc-codec`/`xls-codec`/`ppt-codec` (see [Property sets](#property-sets)) |
 
 ### Recursive walking
 
@@ -113,6 +119,35 @@ Two details are deliberate rather than incidental. The directory's sibling trees
 
 Correctness is checked against independent parsers, not only against this package's own reader: the written files are accepted by [`olefile`](https://github.com/decalage2/olefile) in its strict `DEFECT_INCORRECT` mode and by 7-Zip's Compound handler, both of which return byte-identical stream content, and a real LibreOffice-authored `.doc` read through `readCompoundFile` and re-emitted through `writeCompoundFile` still opens in LibreOffice Writer.
 
+### Property sets
+
+```ts
+import {
+  readCompoundFile,
+  readSummaryInformation,
+  writeSummaryInformationStream,
+} from "archive-codec";
+
+const stream = readCompoundFile(docBytes).find(
+  (s) => s.path === "\x05SummaryInformation",
+);
+if (stream !== undefined) {
+  const metadata = readSummaryInformation(stream.bytes);
+  metadata.title; // string | undefined
+  metadata.createdIso; // string | undefined, ISO-8601
+}
+
+// The mirror image: builds a "\x05SummaryInformation" stream's bytes from the
+// same shape, to hand to writeCompoundFile alongside the format's own streams.
+const summaryStream = writeSummaryInformationStream({ title: "Q3 report" });
+```
+
+`readSummaryInformation`/`writeSummaryInformationStream` cover the seven SummaryInformation fields a caller actually needs (title, subject, author, keywords, comments, and the created/last-saved/last-printed FILETIME timestamps, as ISO-8601 strings); everything else the property set can carry (template, last author, revision number, application name, edit time, page/word/character counts, document security) is read into the stream but not projected into `SummaryInformationProperties`, and the separate `"\x05DocumentSummaryInformation"` stream (company, manager, and custom user-defined properties) is not read or written at all. `readPropertySetStream`/`writePropertySetStream` are the generic layer beneath it — a `PropertySet`'s `formatId` and its `properties` map, keyed by `PropertyIdentifier`, valued by a `{ type, value }` pair over `VT_I2`/`VT_I4`/`VT_LPSTR`/`VT_LPWSTR`/`VT_FILETIME` — for a caller working with a different, non-SummaryInformation property set built on the identical [MS-OLEPS] wire format. The writer only emits `VT_LPWSTR` (Unicode) strings, never `VT_LPSTR`: a `CodePageString`'s ANSI encoding depends on the property set's own CodePage property, and writing an arbitrary codepage's bytes would need a full codepage table this package does not carry, so `VT_LPWSTR`'s codepage-independent UTF-16LE sidesteps the question entirely. The reader still decodes `VT_LPSTR` on the way in — `CP_WINUNICODE` (1200) and windows-1252 (1252, the value the [MS-OLEPS] SummaryInformation worked example itself declares, and the same ANSI convention `cfb/ole-package.ts` already uses) — since a real Office-authored file almost always writes ANSI strings, not Unicode ones.
+
+A property whose type this reader does not decode — an unsupported `PropertyType` (e.g. `VT_CF`, the clipboard-format type `PIDSI_THUMBNAIL` uses), or a `VT_LPSTR` under a `CodePage` other than `CP_WINUNICODE`/windows-1252 — is skipped rather than aborting the whole read: a real SummaryInformation stream routinely carries a thumbnail or a non-Western codepage, and one undecodable property must not fail a read that also carries properties this reader can decode. Genuine structural nonconformance (a bad `ByteOrder`, a truncated stream, a `Dictionary` property, non-zero `TypedPropertyValue` padding) still throws `PropertySetFormatError`.
+
+`oleps/layout-metadata`'s `summaryInformationToLayoutMetadata`/`layoutMetadataToSummaryInformation`/`hasSummaryInformationFields` map `SummaryInformationProperties` to and from `document-schema.js`'s own `LayoutMetadata` — the shared metadata shape every codec's `ContentDocument` carries, format-agnostic rather than specific to any one legacy binary format. `doc-codec`, `xls-codec`, and `ppt-codec` each import these directly rather than maintaining their own copy, wrapping `layoutMetadataToSummaryInformation` with their own `createdIso`/`modifiedIso` date validation so a malformed date is reported through that package's own error vocabulary rather than an opaque `RangeError` out of the FILETIME conversion.
+
 ### ZIP container
 
 `zipPackage` takes an _ordered_ array of `[path, entry]` tuples, not a `Record`, so the caller controls the exact emission order deterministically (the property formats with a fixed-offset first entry — ODF's `mimetype` — depend on), and any entry can be written stored-uncompressed via `stored: true`. `unzipPackage` is the read side; the returned `Record` makes no ordering promise and collapses duplicate paths.
@@ -121,7 +156,7 @@ Correctness is checked against independent parsers, not only against this packag
 
 - Worker-isomorphic (see the [family-wide convention](../../README.md#conventions)): runtime `src/` must not import `node:*`, a bare Node builtin, or use the `Buffer` global — enforced by a `no-restricted-imports`/`no-restricted-globals` ESLint rule and exercised in CI by running the test suite inside an actual `workerd` isolate (`pnpm test:workers`). Test files under `src/**/*.test.ts` and `src/test-support/` are exempt and may use Node APIs for fixtures.
 - Only `src/index.ts` may be named `index.*` — a custom ESLint rule (`local/no-non-barrel-index`) rejects any other module using an `index` basename, since that would be a hidden entry point the `exports` map in `package.json` doesn't advertise.
-- Zero document-format knowledge: this package knows bytes and container structure — ZIP entries, compound-file sectors and directory entries, the OLE packaging wrapper — never that any entry or stream is a document. It depends only on `fflate` — not on `byte-codec`, `ooxml.js`, or `odf.js` (whose ZIP wrappers it deliberately mirrors rather than imports, keeping their branding and release cadences decoupled).
+- Zero document-format knowledge: this package knows bytes and container structure — ZIP entries, compound-file sectors and directory entries, the OLE packaging wrapper, [MS-OLEPS] property identifiers and typed values — never that any entry or stream is a document, or that PID 2 means a title. It depends only on `fflate` — not on `byte-codec`, `ooxml.js`, or `odf.js` (whose ZIP wrappers it deliberately mirrors rather than imports, keeping their branding and release cadences decoupled).
 
 ## Install
 

package/dist/index.cjs

@@ -3,22 +3,36 @@ const require_cfb_detect = require("./cfb/detect.cjs");
 const require_cfb_ole_package = require("./cfb/ole-package.cjs");
 const require_cfb_read = require("./cfb/read.cjs");
 const require_cfb_write = require("./cfb/write.cjs");
+const require_oleps_layout_metadata = require("./oleps/layout-metadata.cjs");
+const require_oleps_read = require("./oleps/read.cjs");
+const require_oleps_write = require("./oleps/write.cjs");
+const require_oleps_summary_information = require("./oleps/summary-information.cjs");
 const require_zip_container = require("./zip/container.cjs");
 const require_zip_detect = require("./zip/detect.cjs");
 const require_zip_walk = require("./zip/walk.cjs");
 exports.ArchiveWalkLimitError = require_zip_walk.ArchiveWalkLimitError;
 exports.CompoundFileFormatError = require_cfb_read.CompoundFileFormatError;
 exports.CompoundFileWriteError = require_cfb_write.CompoundFileWriteError;
+exports.FMTID_SUMMARY_INFORMATION = require_oleps_summary_information.FMTID_SUMMARY_INFORMATION;
 exports.MAX_CFB_TOTAL_STREAM_BYTES = require_cfb_read.MAX_CFB_TOTAL_STREAM_BYTES;
 exports.MAX_WALK_DEPTH = require_zip_walk.MAX_WALK_DEPTH;
 exports.MAX_WALK_TOTAL_BYTES = require_zip_walk.MAX_WALK_TOTAL_BYTES;
 exports.OlePackageFormatError = require_cfb_ole_package.OlePackageFormatError;
+exports.PropertySetFormatError = require_oleps_read.PropertySetFormatError;
+exports.PropertySetWriteError = require_oleps_write.PropertySetWriteError;
 exports.detectArchiveFormat = require_zip_detect.detectArchiveFormat;
+exports.hasSummaryInformationFields = require_oleps_layout_metadata.hasSummaryInformationFields;
 exports.isCompoundFile = require_cfb_detect.isCompoundFile;
 exports.isZipArchive = require_zip_detect.isZipArchive;
+exports.layoutMetadataToSummaryInformation = require_oleps_layout_metadata.layoutMetadataToSummaryInformation;
 exports.readCompoundFile = require_cfb_read.readCompoundFile;
 exports.readOlePackage = require_cfb_ole_package.readOlePackage;
+exports.readPropertySetStream = require_oleps_read.readPropertySetStream;
+exports.readSummaryInformation = require_oleps_summary_information.readSummaryInformation;
+exports.summaryInformationToLayoutMetadata = require_oleps_layout_metadata.summaryInformationToLayoutMetadata;
 exports.unzipPackage = require_zip_container.unzipPackage;
 exports.walkArchive = require_zip_walk.walkArchive;
 exports.writeCompoundFile = require_cfb_write.writeCompoundFile;
+exports.writePropertySetStream = require_oleps_write.writePropertySetStream;
+exports.writeSummaryInformationStream = require_oleps_summary_information.writeSummaryInformationStream;
 exports.zipPackage = require_zip_container.zipPackage;

package/dist/index.d.cts

@@ -2,7 +2,12 @@ import { isCompoundFile } from "./cfb/detect.cjs";
 import { OlePackage, OlePackageFormatError, readOlePackage } from "./cfb/ole-package.cjs";
 import { CompoundFileFormatError, CompoundFileStream, MAX_CFB_TOTAL_STREAM_BYTES, ReadCompoundFileOptions, readCompoundFile } from "./cfb/read.cjs";
 import { CompoundFileWriteError, WriteCompoundFileOptions, writeCompoundFile } from "./cfb/write.cjs";
+import { FMTID_SUMMARY_INFORMATION, SummaryInformationProperties, readSummaryInformation, writeSummaryInformationStream } from "./oleps/summary-information.cjs";
+import { hasSummaryInformationFields, layoutMetadataToSummaryInformation, summaryInformationToLayoutMetadata } from "./oleps/layout-metadata.cjs";
+import { PropertySet, PropertyValue } from "./oleps/wire.cjs";
+import { PropertySetFormatError, readPropertySetStream } from "./oleps/read.cjs";
+import { PropertySetWriteError, writePropertySetStream } from "./oleps/write.cjs";
 import { ZipEntry, unzipPackage, zipPackage } from "./zip/container.cjs";
 import { ArchiveFormat, detectArchiveFormat, isZipArchive } from "./zip/detect.cjs";
 import { ArchiveWalkEntry, ArchiveWalkLimit, ArchiveWalkLimitError, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, WalkArchiveOptions, walkArchive } from "./zip/walk.cjs";
-export { ArchiveFormat, ArchiveWalkEntry, ArchiveWalkLimit, ArchiveWalkLimitError, CompoundFileFormatError, CompoundFileStream, CompoundFileWriteError, MAX_CFB_TOTAL_STREAM_BYTES, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, OlePackage, OlePackageFormatError, ReadCompoundFileOptions, WalkArchiveOptions, WriteCompoundFileOptions, ZipEntry, detectArchiveFormat, isCompoundFile, isZipArchive, readCompoundFile, readOlePackage, unzipPackage, walkArchive, writeCompoundFile, zipPackage };
+export { ArchiveFormat, ArchiveWalkEntry, ArchiveWalkLimit, ArchiveWalkLimitError, CompoundFileFormatError, CompoundFileStream, CompoundFileWriteError, FMTID_SUMMARY_INFORMATION, MAX_CFB_TOTAL_STREAM_BYTES, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, OlePackage, OlePackageFormatError, type PropertySet, PropertySetFormatError, PropertySetWriteError, type PropertyValue, ReadCompoundFileOptions, SummaryInformationProperties, WalkArchiveOptions, WriteCompoundFileOptions, ZipEntry, detectArchiveFormat, hasSummaryInformationFields, isCompoundFile, isZipArchive, layoutMetadataToSummaryInformation, readCompoundFile, readOlePackage, readPropertySetStream, readSummaryInformation, summaryInformationToLayoutMetadata, unzipPackage, walkArchive, writeCompoundFile, writePropertySetStream, writeSummaryInformationStream, zipPackage };

package/dist/index.d.ts

@@ -2,7 +2,12 @@ import { isCompoundFile } from "./cfb/detect.js";
 import { OlePackage, OlePackageFormatError, readOlePackage } from "./cfb/ole-package.js";
 import { CompoundFileFormatError, CompoundFileStream, MAX_CFB_TOTAL_STREAM_BYTES, ReadCompoundFileOptions, readCompoundFile } from "./cfb/read.js";
 import { CompoundFileWriteError, WriteCompoundFileOptions, writeCompoundFile } from "./cfb/write.js";
+import { FMTID_SUMMARY_INFORMATION, SummaryInformationProperties, readSummaryInformation, writeSummaryInformationStream } from "./oleps/summary-information.js";
+import { hasSummaryInformationFields, layoutMetadataToSummaryInformation, summaryInformationToLayoutMetadata } from "./oleps/layout-metadata.js";
+import { PropertySet, PropertyValue } from "./oleps/wire.js";
+import { PropertySetFormatError, readPropertySetStream } from "./oleps/read.js";
+import { PropertySetWriteError, writePropertySetStream } from "./oleps/write.js";
 import { ZipEntry, unzipPackage, zipPackage } from "./zip/container.js";
 import { ArchiveFormat, detectArchiveFormat, isZipArchive } from "./zip/detect.js";
 import { ArchiveWalkEntry, ArchiveWalkLimit, ArchiveWalkLimitError, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, WalkArchiveOptions, walkArchive } from "./zip/walk.js";
-export { ArchiveFormat, ArchiveWalkEntry, ArchiveWalkLimit, ArchiveWalkLimitError, CompoundFileFormatError, CompoundFileStream, CompoundFileWriteError, MAX_CFB_TOTAL_STREAM_BYTES, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, OlePackage, OlePackageFormatError, ReadCompoundFileOptions, WalkArchiveOptions, WriteCompoundFileOptions, ZipEntry, detectArchiveFormat, isCompoundFile, isZipArchive, readCompoundFile, readOlePackage, unzipPackage, walkArchive, writeCompoundFile, zipPackage };
+export { ArchiveFormat, ArchiveWalkEntry, ArchiveWalkLimit, ArchiveWalkLimitError, CompoundFileFormatError, CompoundFileStream, CompoundFileWriteError, FMTID_SUMMARY_INFORMATION, MAX_CFB_TOTAL_STREAM_BYTES, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, OlePackage, OlePackageFormatError, type PropertySet, PropertySetFormatError, PropertySetWriteError, type PropertyValue, ReadCompoundFileOptions, SummaryInformationProperties, WalkArchiveOptions, WriteCompoundFileOptions, ZipEntry, detectArchiveFormat, hasSummaryInformationFields, isCompoundFile, isZipArchive, layoutMetadataToSummaryInformation, readCompoundFile, readOlePackage, readPropertySetStream, readSummaryInformation, summaryInformationToLayoutMetadata, unzipPackage, walkArchive, writeCompoundFile, writePropertySetStream, writeSummaryInformationStream, zipPackage };

package/dist/index.js

@@ -2,7 +2,11 @@ import { isCompoundFile } from "./cfb/detect.js";
 import { OlePackageFormatError, readOlePackage } from "./cfb/ole-package.js";
 import { CompoundFileFormatError, MAX_CFB_TOTAL_STREAM_BYTES, readCompoundFile } from "./cfb/read.js";
 import { CompoundFileWriteError, writeCompoundFile } from "./cfb/write.js";
+import { hasSummaryInformationFields, layoutMetadataToSummaryInformation, summaryInformationToLayoutMetadata } from "./oleps/layout-metadata.js";
+import { PropertySetFormatError, readPropertySetStream } from "./oleps/read.js";
+import { PropertySetWriteError, writePropertySetStream } from "./oleps/write.js";
+import { FMTID_SUMMARY_INFORMATION, readSummaryInformation, writeSummaryInformationStream } from "./oleps/summary-information.js";
 import { unzipPackage, zipPackage } from "./zip/container.js";
 import { detectArchiveFormat, isZipArchive } from "./zip/detect.js";
 import { ArchiveWalkLimitError, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, walkArchive } from "./zip/walk.js";
-export { ArchiveWalkLimitError, CompoundFileFormatError, CompoundFileWriteError, MAX_CFB_TOTAL_STREAM_BYTES, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, OlePackageFormatError, detectArchiveFormat, isCompoundFile, isZipArchive, readCompoundFile, readOlePackage, unzipPackage, walkArchive, writeCompoundFile, zipPackage };
+export { ArchiveWalkLimitError, CompoundFileFormatError, CompoundFileWriteError, FMTID_SUMMARY_INFORMATION, MAX_CFB_TOTAL_STREAM_BYTES, MAX_WALK_DEPTH, MAX_WALK_TOTAL_BYTES, OlePackageFormatError, PropertySetFormatError, PropertySetWriteError, detectArchiveFormat, hasSummaryInformationFields, isCompoundFile, isZipArchive, layoutMetadataToSummaryInformation, readCompoundFile, readOlePackage, readPropertySetStream, readSummaryInformation, summaryInformationToLayoutMetadata, unzipPackage, walkArchive, writeCompoundFile, writePropertySetStream, writeSummaryInformationStream, zipPackage };

package/dist/oleps/layout-metadata.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/oleps/layout-metadata.ts
+function summaryInformationToLayoutMetadata(info) {
+	return {
+		title: info.title,
+		subject: info.subject,
+		author: info.author,
+		keywords: info.keywords === void 0 ? void 0 : [...info.keywords],
+		createdIso: info.createdIso,
+		modifiedIso: info.lastSavedIso
+	};
+}
+function layoutMetadataToSummaryInformation(metadata) {
+	return {
+		title: metadata.title,
+		subject: metadata.subject,
+		author: metadata.author,
+		keywords: metadata.keywords,
+		createdIso: metadata.createdIso,
+		lastSavedIso: metadata.modifiedIso
+	};
+}
+/** Whether a LayoutMetadata carries anything SummaryInformation can actually represent -- `creator`/`producer`/`language` alone should not force a stream carrying nothing but the CodePage property into existence, since a reader would see that back as `{}` regardless (see each caller's own write-side entry point). */
+function hasSummaryInformationFields(metadata) {
+	return metadata.title !== void 0 || metadata.subject !== void 0 || metadata.author !== void 0 || metadata.keywords !== void 0 && metadata.keywords.length > 0 || metadata.createdIso !== void 0 || metadata.modifiedIso !== void 0;
+}
+//#endregion
+exports.hasSummaryInformationFields = hasSummaryInformationFields;
+exports.layoutMetadataToSummaryInformation = layoutMetadataToSummaryInformation;
+exports.summaryInformationToLayoutMetadata = summaryInformationToLayoutMetadata;

package/dist/oleps/layout-metadata.d.cts

@@ -0,0 +1,9 @@
+import { SummaryInformationProperties } from "./summary-information.cjs";
+import { LayoutMetadata } from "document-schema.js";
+//#region src/oleps/layout-metadata.d.ts
+declare function summaryInformationToLayoutMetadata(info: SummaryInformationProperties): LayoutMetadata;
+declare function layoutMetadataToSummaryInformation(metadata: LayoutMetadata): SummaryInformationProperties;
+/** Whether a LayoutMetadata carries anything SummaryInformation can actually represent -- `creator`/`producer`/`language` alone should not force a stream carrying nothing but the CodePage property into existence, since a reader would see that back as `{}` regardless (see each caller's own write-side entry point). */
+declare function hasSummaryInformationFields(metadata: LayoutMetadata): boolean;
+//#endregion
+export { hasSummaryInformationFields, layoutMetadataToSummaryInformation, summaryInformationToLayoutMetadata };

package/dist/oleps/layout-metadata.d.ts

@@ -0,0 +1,9 @@
+import { SummaryInformationProperties } from "./summary-information.js";
+import { LayoutMetadata } from "document-schema.js";
+//#region src/oleps/layout-metadata.d.ts
+declare function summaryInformationToLayoutMetadata(info: SummaryInformationProperties): LayoutMetadata;
+declare function layoutMetadataToSummaryInformation(metadata: LayoutMetadata): SummaryInformationProperties;
+/** Whether a LayoutMetadata carries anything SummaryInformation can actually represent -- `creator`/`producer`/`language` alone should not force a stream carrying nothing but the CodePage property into existence, since a reader would see that back as `{}` regardless (see each caller's own write-side entry point). */
+declare function hasSummaryInformationFields(metadata: LayoutMetadata): boolean;
+//#endregion
+export { hasSummaryInformationFields, layoutMetadataToSummaryInformation, summaryInformationToLayoutMetadata };

package/dist/oleps/layout-metadata.js

@@ -0,0 +1,27 @@
+//#region src/oleps/layout-metadata.ts
+function summaryInformationToLayoutMetadata(info) {
+	return {
+		title: info.title,
+		subject: info.subject,
+		author: info.author,
+		keywords: info.keywords === void 0 ? void 0 : [...info.keywords],
+		createdIso: info.createdIso,
+		modifiedIso: info.lastSavedIso
+	};
+}
+function layoutMetadataToSummaryInformation(metadata) {
+	return {
+		title: metadata.title,
+		subject: metadata.subject,
+		author: metadata.author,
+		keywords: metadata.keywords,
+		createdIso: metadata.createdIso,
+		lastSavedIso: metadata.modifiedIso
+	};
+}
+/** Whether a LayoutMetadata carries anything SummaryInformation can actually represent -- `creator`/`producer`/`language` alone should not force a stream carrying nothing but the CodePage property into existence, since a reader would see that back as `{}` regardless (see each caller's own write-side entry point). */
+function hasSummaryInformationFields(metadata) {
+	return metadata.title !== void 0 || metadata.subject !== void 0 || metadata.author !== void 0 || metadata.keywords !== void 0 && metadata.keywords.length > 0 || metadata.createdIso !== void 0 || metadata.modifiedIso !== void 0;
+}
+//#endregion
+export { hasSummaryInformationFields, layoutMetadataToSummaryInformation, summaryInformationToLayoutMetadata };

package/dist/oleps/read.cjs

@@ -0,0 +1,132 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_oleps_wire = require("./wire.cjs");
+//#region src/oleps/read.ts
+var PropertySetFormatError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "PropertySetFormatError";
+	}
+};
+function requireBytes(byteLength, offset, length, what) {
+	if (offset < 0 || length < 0 || offset + length > byteLength) throw new PropertySetFormatError(`property set stream ends before ${what} (needs ${length} bytes at offset ${offset}, stream is ${byteLength} bytes)`);
+}
+const ANSI_DECODER = new TextDecoder("windows-1252");
+const UTF16_DECODER = new TextDecoder("utf-16le");
+function decodeAnsi(bytes, codepage) {
+	if (codepage !== 1252) return;
+	return ANSI_DECODER.decode(bytes);
+}
+function truncateAtNull(value) {
+	const index = value.indexOf("\0");
+	return index === -1 ? value : value.slice(0, index);
+}
+function readCodePageString(bytes, view, offset, codepage) {
+	requireBytes(bytes.length, offset, 4, "a CodePageString's Size field");
+	const size = view.getUint32(offset, true);
+	requireBytes(bytes.length, offset + 4, size, "a CodePageString's Characters field");
+	const raw = bytes.subarray(offset + 4, offset + 4 + size);
+	if (codepage === 1200) return truncateAtNull(UTF16_DECODER.decode(raw));
+	const decoded = decodeAnsi(raw, codepage);
+	return decoded === void 0 ? void 0 : truncateAtNull(decoded);
+}
+function readUnicodeString(bytes, view, offset) {
+	requireBytes(bytes.length, offset, 4, "a UnicodeString's Length field");
+	const byteLength = view.getUint32(offset, true) * 2;
+	requireBytes(bytes.length, offset + 4, byteLength, "a UnicodeString's Characters field");
+	const raw = bytes.subarray(offset + 4, offset + 4 + byteLength);
+	return truncateAtNull(UTF16_DECODER.decode(raw));
+}
+function readPropertySetStream(bytes) {
+	requireBytes(bytes.length, 0, 48, "the PropertySetStream header");
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	const byteOrder = view.getUint16(0, true);
+	if (byteOrder !== 65534) throw new PropertySetFormatError(`property set stream's ByteOrder field is 0x${byteOrder.toString(16)}, not the mandated 0xFFFE`);
+	const numPropertySets = view.getUint32(24, true);
+	if (numPropertySets !== 1) throw new PropertySetFormatError(`property set stream declares ${numPropertySets} property sets; this reader only handles the single-property-set form every "\\x05SummaryInformation" stream uses (the two-property-set DocumentSummaryInformation/UserDefinedProperties spelling is out of scope, see the package README)`);
+	const formatId = require_oleps_wire.readGuid(view, 28);
+	const offset0 = view.getUint32(44, true);
+	requireBytes(bytes.length, offset0, 8, "the PropertySet packet header");
+	const size = view.getUint32(offset0, true);
+	requireBytes(bytes.length, offset0, size, "the PropertySet packet's own declared Size");
+	const numProperties = view.getUint32(offset0 + 4, true);
+	const tableStart = offset0 + 8;
+	requireBytes(bytes.length, tableStart, numProperties * 8, "the PropertyIdentifierAndOffset dictionary");
+	const entries = [];
+	for (let i = 0; i < numProperties; i++) {
+		const entryOffset = tableStart + i * 8;
+		const pid = view.getUint32(entryOffset, true);
+		if (pid === 0) throw new PropertySetFormatError("property set carries a Dictionary property (PID 0), which names string-keyed properties this reader does not support -- no \"\\x05SummaryInformation\" stream should carry one");
+		entries.push({
+			pid,
+			relativeOffset: view.getUint32(entryOffset + 4, true)
+		});
+	}
+	let codepage = require_oleps_wire.WINDOWS_1252_CODEPAGE;
+	for (const entry of entries) {
+		if (entry.pid !== 1) continue;
+		const abs = offset0 + entry.relativeOffset;
+		requireBytes(bytes.length, abs, 8, "the CodePage property's TypedPropertyValue");
+		const type = view.getUint16(abs, true);
+		if (type !== 2) throw new PropertySetFormatError(`CodePage property (PID 1) has type 0x${type.toString(16)}, not VT_I2 as [MS-OLEPS] requires`);
+		const raw = view.getInt16(abs + 4, true);
+		codepage = raw < 0 ? raw + 65536 : raw;
+	}
+	const properties = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		const abs = offset0 + entry.relativeOffset;
+		requireBytes(bytes.length, abs, 4, "a property's TypedPropertyValue header");
+		const type = view.getUint16(abs, true);
+		const padding = view.getUint16(abs + 2, true);
+		if (padding !== 0) throw new PropertySetFormatError(`property ${entry.pid}'s TypedPropertyValue padding is 0x${padding.toString(16)}, not zero as [MS-OLEPS] requires`);
+		const valueOffset = abs + 4;
+		switch (type) {
+			case 2:
+				requireBytes(bytes.length, valueOffset, 4, `property ${entry.pid}'s VT_I2 value`);
+				properties.set(entry.pid, {
+					type: "VT_I2",
+					value: view.getInt16(valueOffset, true)
+				});
+				break;
+			case 3:
+				requireBytes(bytes.length, valueOffset, 4, `property ${entry.pid}'s VT_I4 value`);
+				properties.set(entry.pid, {
+					type: "VT_I4",
+					value: view.getInt32(valueOffset, true)
+				});
+				break;
+			case 30: {
+				const value = readCodePageString(bytes, view, valueOffset, codepage);
+				if (value !== void 0) properties.set(entry.pid, {
+					type: "VT_LPSTR",
+					value
+				});
+				break;
+			}
+			case 31: {
+				const value = readUnicodeString(bytes, view, valueOffset);
+				properties.set(entry.pid, {
+					type: "VT_LPWSTR",
+					value
+				});
+				break;
+			}
+			case 64: {
+				requireBytes(bytes.length, valueOffset, 8, `property ${entry.pid}'s VT_FILETIME value`);
+				const low = view.getUint32(valueOffset, true);
+				const high = view.getUint32(valueOffset + 4, true);
+				properties.set(entry.pid, {
+					type: "VT_FILETIME",
+					value: require_oleps_wire.filetimeToDate(low, high)
+				});
+				break;
+			}
+		}
+	}
+	return {
+		formatId,
+		properties
+	};
+}
+//#endregion
+exports.PropertySetFormatError = PropertySetFormatError;
+exports.readPropertySetStream = readPropertySetStream;

package/dist/oleps/read.d.cts

@@ -0,0 +1,8 @@
+import { PropertySet } from "./wire.cjs";
+//#region src/oleps/read.d.ts
+declare class PropertySetFormatError extends Error {
+  constructor(message: string);
+}
+declare function readPropertySetStream(bytes: Uint8Array<ArrayBuffer>): PropertySet;
+//#endregion
+export { PropertySetFormatError, readPropertySetStream };

package/dist/oleps/read.d.ts

@@ -0,0 +1,8 @@
+import { PropertySet } from "./wire.js";
+//#region src/oleps/read.d.ts
+declare class PropertySetFormatError extends Error {
+  constructor(message: string);
+}
+declare function readPropertySetStream(bytes: Uint8Array<ArrayBuffer>): PropertySet;
+//#endregion
+export { PropertySetFormatError, readPropertySetStream };

package/dist/oleps/read.js

@@ -0,0 +1,130 @@
+import { WINDOWS_1252_CODEPAGE, filetimeToDate, readGuid } from "./wire.js";
+//#region src/oleps/read.ts
+var PropertySetFormatError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "PropertySetFormatError";
+	}
+};
+function requireBytes(byteLength, offset, length, what) {
+	if (offset < 0 || length < 0 || offset + length > byteLength) throw new PropertySetFormatError(`property set stream ends before ${what} (needs ${length} bytes at offset ${offset}, stream is ${byteLength} bytes)`);
+}
+const ANSI_DECODER = new TextDecoder("windows-1252");
+const UTF16_DECODER = new TextDecoder("utf-16le");
+function decodeAnsi(bytes, codepage) {
+	if (codepage !== 1252) return;
+	return ANSI_DECODER.decode(bytes);
+}
+function truncateAtNull(value) {
+	const index = value.indexOf("\0");
+	return index === -1 ? value : value.slice(0, index);
+}
+function readCodePageString(bytes, view, offset, codepage) {
+	requireBytes(bytes.length, offset, 4, "a CodePageString's Size field");
+	const size = view.getUint32(offset, true);
+	requireBytes(bytes.length, offset + 4, size, "a CodePageString's Characters field");
+	const raw = bytes.subarray(offset + 4, offset + 4 + size);
+	if (codepage === 1200) return truncateAtNull(UTF16_DECODER.decode(raw));
+	const decoded = decodeAnsi(raw, codepage);
+	return decoded === void 0 ? void 0 : truncateAtNull(decoded);
+}
+function readUnicodeString(bytes, view, offset) {
+	requireBytes(bytes.length, offset, 4, "a UnicodeString's Length field");
+	const byteLength = view.getUint32(offset, true) * 2;
+	requireBytes(bytes.length, offset + 4, byteLength, "a UnicodeString's Characters field");
+	const raw = bytes.subarray(offset + 4, offset + 4 + byteLength);
+	return truncateAtNull(UTF16_DECODER.decode(raw));
+}
+function readPropertySetStream(bytes) {
+	requireBytes(bytes.length, 0, 48, "the PropertySetStream header");
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	const byteOrder = view.getUint16(0, true);
+	if (byteOrder !== 65534) throw new PropertySetFormatError(`property set stream's ByteOrder field is 0x${byteOrder.toString(16)}, not the mandated 0xFFFE`);
+	const numPropertySets = view.getUint32(24, true);
+	if (numPropertySets !== 1) throw new PropertySetFormatError(`property set stream declares ${numPropertySets} property sets; this reader only handles the single-property-set form every "\\x05SummaryInformation" stream uses (the two-property-set DocumentSummaryInformation/UserDefinedProperties spelling is out of scope, see the package README)`);
+	const formatId = readGuid(view, 28);
+	const offset0 = view.getUint32(44, true);
+	requireBytes(bytes.length, offset0, 8, "the PropertySet packet header");
+	const size = view.getUint32(offset0, true);
+	requireBytes(bytes.length, offset0, size, "the PropertySet packet's own declared Size");
+	const numProperties = view.getUint32(offset0 + 4, true);
+	const tableStart = offset0 + 8;
+	requireBytes(bytes.length, tableStart, numProperties * 8, "the PropertyIdentifierAndOffset dictionary");
+	const entries = [];
+	for (let i = 0; i < numProperties; i++) {
+		const entryOffset = tableStart + i * 8;
+		const pid = view.getUint32(entryOffset, true);
+		if (pid === 0) throw new PropertySetFormatError("property set carries a Dictionary property (PID 0), which names string-keyed properties this reader does not support -- no \"\\x05SummaryInformation\" stream should carry one");
+		entries.push({
+			pid,
+			relativeOffset: view.getUint32(entryOffset + 4, true)
+		});
+	}
+	let codepage = WINDOWS_1252_CODEPAGE;
+	for (const entry of entries) {
+		if (entry.pid !== 1) continue;
+		const abs = offset0 + entry.relativeOffset;
+		requireBytes(bytes.length, abs, 8, "the CodePage property's TypedPropertyValue");
+		const type = view.getUint16(abs, true);
+		if (type !== 2) throw new PropertySetFormatError(`CodePage property (PID 1) has type 0x${type.toString(16)}, not VT_I2 as [MS-OLEPS] requires`);
+		const raw = view.getInt16(abs + 4, true);
+		codepage = raw < 0 ? raw + 65536 : raw;
+	}
+	const properties = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		const abs = offset0 + entry.relativeOffset;
+		requireBytes(bytes.length, abs, 4, "a property's TypedPropertyValue header");
+		const type = view.getUint16(abs, true);
+		const padding = view.getUint16(abs + 2, true);
+		if (padding !== 0) throw new PropertySetFormatError(`property ${entry.pid}'s TypedPropertyValue padding is 0x${padding.toString(16)}, not zero as [MS-OLEPS] requires`);
+		const valueOffset = abs + 4;
+		switch (type) {
+			case 2:
+				requireBytes(bytes.length, valueOffset, 4, `property ${entry.pid}'s VT_I2 value`);
+				properties.set(entry.pid, {
+					type: "VT_I2",
+					value: view.getInt16(valueOffset, true)
+				});
+				break;
+			case 3:
+				requireBytes(bytes.length, valueOffset, 4, `property ${entry.pid}'s VT_I4 value`);
+				properties.set(entry.pid, {
+					type: "VT_I4",
+					value: view.getInt32(valueOffset, true)
+				});
+				break;
+			case 30: {
+				const value = readCodePageString(bytes, view, valueOffset, codepage);
+				if (value !== void 0) properties.set(entry.pid, {
+					type: "VT_LPSTR",
+					value
+				});
+				break;
+			}
+			case 31: {
+				const value = readUnicodeString(bytes, view, valueOffset);
+				properties.set(entry.pid, {
+					type: "VT_LPWSTR",
+					value
+				});
+				break;
+			}
+			case 64: {
+				requireBytes(bytes.length, valueOffset, 8, `property ${entry.pid}'s VT_FILETIME value`);
+				const low = view.getUint32(valueOffset, true);
+				const high = view.getUint32(valueOffset + 4, true);
+				properties.set(entry.pid, {
+					type: "VT_FILETIME",
+					value: filetimeToDate(low, high)
+				});
+				break;
+			}
+		}
+	}
+	return {
+		formatId,
+		properties
+	};
+}
+//#endregion
+export { PropertySetFormatError, readPropertySetStream };

package/dist/oleps/summary-information.cjs

@@ -0,0 +1,94 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_oleps_wire = require("./wire.cjs");
+const require_oleps_read = require("./read.cjs");
+const require_oleps_write = require("./write.cjs");
+//#region src/oleps/summary-information.ts
+const FMTID_SUMMARY_INFORMATION = "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}";
+const PID_TITLE = 2;
+const PID_SUBJECT = 3;
+const PID_AUTHOR = 4;
+const PID_KEYWORDS = 5;
+const PID_COMMENTS = 6;
+const PID_LASTPRINTED = 11;
+const PID_CREATE_DTM = 12;
+const PID_LASTSAVE_DTM = 13;
+const KEYWORDS_DELIMITER = ", ";
+function splitKeywords(value) {
+	const parts = value.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
+	return parts.length > 0 ? parts : void 0;
+}
+function stringValue(value, pid) {
+	if (value === void 0) return void 0;
+	if (value.type !== "VT_LPSTR" && value.type !== "VT_LPWSTR") throw new require_oleps_read.PropertySetFormatError(`SummaryInformation property ${pid} has type ${value.type}, not a string type as [MS-OLEPS]'s SummaryInformation Property Set defines`);
+	return value.value.length > 0 ? value.value : void 0;
+}
+const FILETIME_UNSET_ISO = "1601-01-01T00:00:00.000Z";
+function dateIsoValue(value, pid) {
+	if (value === void 0) return void 0;
+	if (value.type !== "VT_FILETIME") throw new require_oleps_read.PropertySetFormatError(`SummaryInformation property ${pid} has type ${value.type}, not VT_FILETIME as [MS-OLEPS]'s SummaryInformation Property Set defines`);
+	const iso = value.value.toISOString();
+	return iso === FILETIME_UNSET_ISO ? void 0 : iso;
+}
+function readSummaryInformation(bytes) {
+	const propertySet = require_oleps_read.readPropertySetStream(bytes);
+	if (propertySet.formatId !== "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}") throw new require_oleps_read.PropertySetFormatError(`property set stream declares FMTID ${propertySet.formatId}, not FMTID_SummaryInformation (${FMTID_SUMMARY_INFORMATION}); this is not a "\\x05SummaryInformation" stream`);
+	const { properties } = propertySet;
+	const keywords = stringValue(properties.get(PID_KEYWORDS), PID_KEYWORDS);
+	return {
+		title: stringValue(properties.get(PID_TITLE), PID_TITLE),
+		subject: stringValue(properties.get(PID_SUBJECT), PID_SUBJECT),
+		author: stringValue(properties.get(PID_AUTHOR), PID_AUTHOR),
+		keywords: keywords === void 0 ? void 0 : splitKeywords(keywords),
+		comments: stringValue(properties.get(PID_COMMENTS), PID_COMMENTS),
+		createdIso: dateIsoValue(properties.get(PID_CREATE_DTM), PID_CREATE_DTM),
+		lastSavedIso: dateIsoValue(properties.get(PID_LASTSAVE_DTM), PID_LASTSAVE_DTM),
+		lastPrintedIso: dateIsoValue(properties.get(PID_LASTPRINTED), PID_LASTPRINTED)
+	};
+}
+function writeSummaryInformationStream(properties) {
+	const entries = /* @__PURE__ */ new Map();
+	entries.set(1, {
+		type: "VT_I2",
+		value: require_oleps_wire.CP_WINUNICODE
+	});
+	if (properties.title !== void 0) entries.set(PID_TITLE, {
+		type: "VT_LPWSTR",
+		value: properties.title
+	});
+	if (properties.subject !== void 0) entries.set(PID_SUBJECT, {
+		type: "VT_LPWSTR",
+		value: properties.subject
+	});
+	if (properties.author !== void 0) entries.set(PID_AUTHOR, {
+		type: "VT_LPWSTR",
+		value: properties.author
+	});
+	if (properties.keywords !== void 0 && properties.keywords.length > 0) entries.set(PID_KEYWORDS, {
+		type: "VT_LPWSTR",
+		value: properties.keywords.join(KEYWORDS_DELIMITER)
+	});
+	if (properties.comments !== void 0) entries.set(PID_COMMENTS, {
+		type: "VT_LPWSTR",
+		value: properties.comments
+	});
+	if (properties.createdIso !== void 0) entries.set(PID_CREATE_DTM, {
+		type: "VT_FILETIME",
+		value: new Date(properties.createdIso)
+	});
+	if (properties.lastSavedIso !== void 0) entries.set(PID_LASTSAVE_DTM, {
+		type: "VT_FILETIME",
+		value: new Date(properties.lastSavedIso)
+	});
+	if (properties.lastPrintedIso !== void 0) entries.set(PID_LASTPRINTED, {
+		type: "VT_FILETIME",
+		value: new Date(properties.lastPrintedIso)
+	});
+	return require_oleps_write.writePropertySetStream({
+		formatId: FMTID_SUMMARY_INFORMATION,
+		properties: entries
+	});
+}
+//#endregion
+exports.FMTID_SUMMARY_INFORMATION = FMTID_SUMMARY_INFORMATION;
+exports.readSummaryInformation = readSummaryInformation;
+exports.writeSummaryInformationStream = writeSummaryInformationStream;

package/dist/oleps/summary-information.d.cts

@@ -0,0 +1,16 @@
+//#region src/oleps/summary-information.d.ts
+declare const FMTID_SUMMARY_INFORMATION = "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}";
+interface SummaryInformationProperties {
+  readonly title?: string;
+  readonly subject?: string;
+  readonly author?: string;
+  readonly keywords?: readonly string[];
+  readonly comments?: string;
+  readonly createdIso?: string;
+  readonly lastSavedIso?: string;
+  readonly lastPrintedIso?: string;
+}
+declare function readSummaryInformation(bytes: Uint8Array<ArrayBuffer>): SummaryInformationProperties;
+declare function writeSummaryInformationStream(properties: SummaryInformationProperties): Uint8Array<ArrayBuffer>;
+//#endregion
+export { FMTID_SUMMARY_INFORMATION, SummaryInformationProperties, readSummaryInformation, writeSummaryInformationStream };

package/dist/oleps/summary-information.d.ts

@@ -0,0 +1,16 @@
+//#region src/oleps/summary-information.d.ts
+declare const FMTID_SUMMARY_INFORMATION = "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}";
+interface SummaryInformationProperties {
+  readonly title?: string;
+  readonly subject?: string;
+  readonly author?: string;
+  readonly keywords?: readonly string[];
+  readonly comments?: string;
+  readonly createdIso?: string;
+  readonly lastSavedIso?: string;
+  readonly lastPrintedIso?: string;
+}
+declare function readSummaryInformation(bytes: Uint8Array<ArrayBuffer>): SummaryInformationProperties;
+declare function writeSummaryInformationStream(properties: SummaryInformationProperties): Uint8Array<ArrayBuffer>;
+//#endregion
+export { FMTID_SUMMARY_INFORMATION, SummaryInformationProperties, readSummaryInformation, writeSummaryInformationStream };

package/dist/oleps/summary-information.js

@@ -0,0 +1,91 @@
+import { CP_WINUNICODE } from "./wire.js";
+import { PropertySetFormatError, readPropertySetStream } from "./read.js";
+import { writePropertySetStream } from "./write.js";
+//#region src/oleps/summary-information.ts
+const FMTID_SUMMARY_INFORMATION = "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}";
+const PID_TITLE = 2;
+const PID_SUBJECT = 3;
+const PID_AUTHOR = 4;
+const PID_KEYWORDS = 5;
+const PID_COMMENTS = 6;
+const PID_LASTPRINTED = 11;
+const PID_CREATE_DTM = 12;
+const PID_LASTSAVE_DTM = 13;
+const KEYWORDS_DELIMITER = ", ";
+function splitKeywords(value) {
+	const parts = value.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
+	return parts.length > 0 ? parts : void 0;
+}
+function stringValue(value, pid) {
+	if (value === void 0) return void 0;
+	if (value.type !== "VT_LPSTR" && value.type !== "VT_LPWSTR") throw new PropertySetFormatError(`SummaryInformation property ${pid} has type ${value.type}, not a string type as [MS-OLEPS]'s SummaryInformation Property Set defines`);
+	return value.value.length > 0 ? value.value : void 0;
+}
+const FILETIME_UNSET_ISO = "1601-01-01T00:00:00.000Z";
+function dateIsoValue(value, pid) {
+	if (value === void 0) return void 0;
+	if (value.type !== "VT_FILETIME") throw new PropertySetFormatError(`SummaryInformation property ${pid} has type ${value.type}, not VT_FILETIME as [MS-OLEPS]'s SummaryInformation Property Set defines`);
+	const iso = value.value.toISOString();
+	return iso === FILETIME_UNSET_ISO ? void 0 : iso;
+}
+function readSummaryInformation(bytes) {
+	const propertySet = readPropertySetStream(bytes);
+	if (propertySet.formatId !== "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}") throw new PropertySetFormatError(`property set stream declares FMTID ${propertySet.formatId}, not FMTID_SummaryInformation (${FMTID_SUMMARY_INFORMATION}); this is not a "\\x05SummaryInformation" stream`);
+	const { properties } = propertySet;
+	const keywords = stringValue(properties.get(PID_KEYWORDS), PID_KEYWORDS);
+	return {
+		title: stringValue(properties.get(PID_TITLE), PID_TITLE),
+		subject: stringValue(properties.get(PID_SUBJECT), PID_SUBJECT),
+		author: stringValue(properties.get(PID_AUTHOR), PID_AUTHOR),
+		keywords: keywords === void 0 ? void 0 : splitKeywords(keywords),
+		comments: stringValue(properties.get(PID_COMMENTS), PID_COMMENTS),
+		createdIso: dateIsoValue(properties.get(PID_CREATE_DTM), PID_CREATE_DTM),
+		lastSavedIso: dateIsoValue(properties.get(PID_LASTSAVE_DTM), PID_LASTSAVE_DTM),
+		lastPrintedIso: dateIsoValue(properties.get(PID_LASTPRINTED), PID_LASTPRINTED)
+	};
+}
+function writeSummaryInformationStream(properties) {
+	const entries = /* @__PURE__ */ new Map();
+	entries.set(1, {
+		type: "VT_I2",
+		value: CP_WINUNICODE
+	});
+	if (properties.title !== void 0) entries.set(PID_TITLE, {
+		type: "VT_LPWSTR",
+		value: properties.title
+	});
+	if (properties.subject !== void 0) entries.set(PID_SUBJECT, {
+		type: "VT_LPWSTR",
+		value: properties.subject
+	});
+	if (properties.author !== void 0) entries.set(PID_AUTHOR, {
+		type: "VT_LPWSTR",
+		value: properties.author
+	});
+	if (properties.keywords !== void 0 && properties.keywords.length > 0) entries.set(PID_KEYWORDS, {
+		type: "VT_LPWSTR",
+		value: properties.keywords.join(KEYWORDS_DELIMITER)
+	});
+	if (properties.comments !== void 0) entries.set(PID_COMMENTS, {
+		type: "VT_LPWSTR",
+		value: properties.comments
+	});
+	if (properties.createdIso !== void 0) entries.set(PID_CREATE_DTM, {
+		type: "VT_FILETIME",
+		value: new Date(properties.createdIso)
+	});
+	if (properties.lastSavedIso !== void 0) entries.set(PID_LASTSAVE_DTM, {
+		type: "VT_FILETIME",
+		value: new Date(properties.lastSavedIso)
+	});
+	if (properties.lastPrintedIso !== void 0) entries.set(PID_LASTPRINTED, {
+		type: "VT_FILETIME",
+		value: new Date(properties.lastPrintedIso)
+	});
+	return writePropertySetStream({
+		formatId: FMTID_SUMMARY_INFORMATION,
+		properties: entries
+	});
+}
+//#endregion
+export { FMTID_SUMMARY_INFORMATION, readSummaryInformation, writeSummaryInformationStream };

package/dist/oleps/wire.cjs

@@ -0,0 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/oleps/wire.ts
+const BYTE_ORDER_MARK = 65534;
+const HEADER_SIZE = 48;
+const PROPERTY_SET_HEADER_SIZE = 8;
+const IDENTIFIER_AND_OFFSET_SIZE = 8;
+const TYPED_VALUE_HEADER_SIZE = 4;
+const VT_I2 = 2;
+const VT_I4 = 3;
+const VT_LPSTR = 30;
+const VT_LPWSTR = 31;
+const VT_FILETIME = 64;
+const PID_DICTIONARY = 0;
+const PID_CODEPAGE = 1;
+const CP_WINUNICODE = 1200;
+const WINDOWS_1252_CODEPAGE = 1252;
+const GUID_NULL = "{00000000-0000-0000-0000-000000000000}";
+function hex(n, width) {
+	return n.toString(16).padStart(width, "0");
+}
+function readGuid(view, offset) {
+	const data1 = hex(view.getUint32(offset, true), 8);
+	const data2 = hex(view.getUint16(offset + 4, true), 4);
+	const data3 = hex(view.getUint16(offset + 6, true), 4);
+	let data4a = "";
+	for (let i = 0; i < 2; i++) data4a += hex(view.getUint8(offset + 8 + i), 2);
+	let data4b = "";
+	for (let i = 2; i < 8; i++) data4b += hex(view.getUint8(offset + 8 + i), 2);
+	return `{${data1}-${data2}-${data3}-${data4a}-${data4b}}`.toUpperCase();
+}
+function writeGuid(view, offset, guid) {
+	const digits = guid.replace(/[{}-]/g, "");
+	view.setUint32(offset, Number.parseInt(digits.slice(0, 8), 16), true);
+	view.setUint16(offset + 4, Number.parseInt(digits.slice(8, 12), 16), true);
+	view.setUint16(offset + 6, Number.parseInt(digits.slice(12, 16), 16), true);
+	for (let i = 0; i < 8; i++) view.setUint8(offset + 8 + i, Number.parseInt(digits.slice(16 + i * 2, 18 + i * 2), 16));
+}
+const FILETIME_EPOCH_OFFSET_100NS = 116444736000000000n;
+const HUNDRED_NS_PER_MS = 10000n;
+function filetimeToDate(low, high) {
+	const ms = ((BigInt(high) << 32n | BigInt(low)) - FILETIME_EPOCH_OFFSET_100NS) / HUNDRED_NS_PER_MS;
+	return new Date(Number(ms));
+}
+function dateToFiletime(date) {
+	const ticks = BigInt(date.getTime()) * HUNDRED_NS_PER_MS + FILETIME_EPOCH_OFFSET_100NS;
+	return {
+		low: Number(ticks & 4294967295n),
+		high: Number(ticks >> 32n & 4294967295n)
+	};
+}
+//#endregion
+exports.BYTE_ORDER_MARK = BYTE_ORDER_MARK;
+exports.CP_WINUNICODE = CP_WINUNICODE;
+exports.GUID_NULL = GUID_NULL;
+exports.HEADER_SIZE = HEADER_SIZE;
+exports.IDENTIFIER_AND_OFFSET_SIZE = IDENTIFIER_AND_OFFSET_SIZE;
+exports.PID_CODEPAGE = PID_CODEPAGE;
+exports.PID_DICTIONARY = PID_DICTIONARY;
+exports.PROPERTY_SET_HEADER_SIZE = PROPERTY_SET_HEADER_SIZE;
+exports.TYPED_VALUE_HEADER_SIZE = TYPED_VALUE_HEADER_SIZE;
+exports.VT_FILETIME = VT_FILETIME;
+exports.VT_I2 = VT_I2;
+exports.VT_I4 = VT_I4;
+exports.VT_LPSTR = VT_LPSTR;
+exports.VT_LPWSTR = VT_LPWSTR;
+exports.WINDOWS_1252_CODEPAGE = WINDOWS_1252_CODEPAGE;
+exports.dateToFiletime = dateToFiletime;
+exports.filetimeToDate = filetimeToDate;
+exports.readGuid = readGuid;
+exports.writeGuid = writeGuid;

package/dist/oleps/wire.d.cts

@@ -0,0 +1,45 @@
+//#region src/oleps/wire.d.ts
+declare const BYTE_ORDER_MARK = 65534;
+declare const HEADER_SIZE = 48;
+declare const PROPERTY_SET_HEADER_SIZE = 8;
+declare const IDENTIFIER_AND_OFFSET_SIZE = 8;
+declare const TYPED_VALUE_HEADER_SIZE = 4;
+declare const VT_I2 = 2;
+declare const VT_I4 = 3;
+declare const VT_LPSTR = 30;
+declare const VT_LPWSTR = 31;
+declare const VT_FILETIME = 64;
+declare const PID_DICTIONARY = 0;
+declare const PID_CODEPAGE = 1;
+declare const CP_WINUNICODE = 1200;
+declare const WINDOWS_1252_CODEPAGE = 1252;
+declare const GUID_NULL = "{00000000-0000-0000-0000-000000000000}";
+declare function readGuid(view: DataView, offset: number): string;
+declare function writeGuid(view: DataView, offset: number, guid: string): void;
+declare function filetimeToDate(low: number, high: number): Date;
+declare function dateToFiletime(date: Date): {
+  readonly low: number;
+  readonly high: number;
+};
+type PropertyValue = {
+  readonly type: "VT_I2";
+  readonly value: number;
+} | {
+  readonly type: "VT_I4";
+  readonly value: number;
+} | {
+  readonly type: "VT_LPSTR";
+  readonly value: string;
+} | {
+  readonly type: "VT_LPWSTR";
+  readonly value: string;
+} | {
+  readonly type: "VT_FILETIME";
+  readonly value: Date;
+};
+interface PropertySet {
+  readonly formatId: string;
+  readonly properties: ReadonlyMap<number, PropertyValue>;
+}
+//#endregion
+export { BYTE_ORDER_MARK, CP_WINUNICODE, GUID_NULL, HEADER_SIZE, IDENTIFIER_AND_OFFSET_SIZE, PID_CODEPAGE, PID_DICTIONARY, PROPERTY_SET_HEADER_SIZE, PropertySet, PropertyValue, TYPED_VALUE_HEADER_SIZE, VT_FILETIME, VT_I2, VT_I4, VT_LPSTR, VT_LPWSTR, WINDOWS_1252_CODEPAGE, dateToFiletime, filetimeToDate, readGuid, writeGuid };

package/dist/oleps/wire.d.ts

@@ -0,0 +1,45 @@
+//#region src/oleps/wire.d.ts
+declare const BYTE_ORDER_MARK = 65534;
+declare const HEADER_SIZE = 48;
+declare const PROPERTY_SET_HEADER_SIZE = 8;
+declare const IDENTIFIER_AND_OFFSET_SIZE = 8;
+declare const TYPED_VALUE_HEADER_SIZE = 4;
+declare const VT_I2 = 2;
+declare const VT_I4 = 3;
+declare const VT_LPSTR = 30;
+declare const VT_LPWSTR = 31;
+declare const VT_FILETIME = 64;
+declare const PID_DICTIONARY = 0;
+declare const PID_CODEPAGE = 1;
+declare const CP_WINUNICODE = 1200;
+declare const WINDOWS_1252_CODEPAGE = 1252;
+declare const GUID_NULL = "{00000000-0000-0000-0000-000000000000}";
+declare function readGuid(view: DataView, offset: number): string;
+declare function writeGuid(view: DataView, offset: number, guid: string): void;
+declare function filetimeToDate(low: number, high: number): Date;
+declare function dateToFiletime(date: Date): {
+  readonly low: number;
+  readonly high: number;
+};
+type PropertyValue = {
+  readonly type: "VT_I2";
+  readonly value: number;
+} | {
+  readonly type: "VT_I4";
+  readonly value: number;
+} | {
+  readonly type: "VT_LPSTR";
+  readonly value: string;
+} | {
+  readonly type: "VT_LPWSTR";
+  readonly value: string;
+} | {
+  readonly type: "VT_FILETIME";
+  readonly value: Date;
+};
+interface PropertySet {
+  readonly formatId: string;
+  readonly properties: ReadonlyMap<number, PropertyValue>;
+}
+//#endregion
+export { BYTE_ORDER_MARK, CP_WINUNICODE, GUID_NULL, HEADER_SIZE, IDENTIFIER_AND_OFFSET_SIZE, PID_CODEPAGE, PID_DICTIONARY, PROPERTY_SET_HEADER_SIZE, PropertySet, PropertyValue, TYPED_VALUE_HEADER_SIZE, VT_FILETIME, VT_I2, VT_I4, VT_LPSTR, VT_LPWSTR, WINDOWS_1252_CODEPAGE, dateToFiletime, filetimeToDate, readGuid, writeGuid };

package/dist/oleps/wire.js

@@ -0,0 +1,51 @@
+//#region src/oleps/wire.ts
+const BYTE_ORDER_MARK = 65534;
+const HEADER_SIZE = 48;
+const PROPERTY_SET_HEADER_SIZE = 8;
+const IDENTIFIER_AND_OFFSET_SIZE = 8;
+const TYPED_VALUE_HEADER_SIZE = 4;
+const VT_I2 = 2;
+const VT_I4 = 3;
+const VT_LPSTR = 30;
+const VT_LPWSTR = 31;
+const VT_FILETIME = 64;
+const PID_DICTIONARY = 0;
+const PID_CODEPAGE = 1;
+const CP_WINUNICODE = 1200;
+const WINDOWS_1252_CODEPAGE = 1252;
+const GUID_NULL = "{00000000-0000-0000-0000-000000000000}";
+function hex(n, width) {
+	return n.toString(16).padStart(width, "0");
+}
+function readGuid(view, offset) {
+	const data1 = hex(view.getUint32(offset, true), 8);
+	const data2 = hex(view.getUint16(offset + 4, true), 4);
+	const data3 = hex(view.getUint16(offset + 6, true), 4);
+	let data4a = "";
+	for (let i = 0; i < 2; i++) data4a += hex(view.getUint8(offset + 8 + i), 2);
+	let data4b = "";
+	for (let i = 2; i < 8; i++) data4b += hex(view.getUint8(offset + 8 + i), 2);
+	return `{${data1}-${data2}-${data3}-${data4a}-${data4b}}`.toUpperCase();
+}
+function writeGuid(view, offset, guid) {
+	const digits = guid.replace(/[{}-]/g, "");
+	view.setUint32(offset, Number.parseInt(digits.slice(0, 8), 16), true);
+	view.setUint16(offset + 4, Number.parseInt(digits.slice(8, 12), 16), true);
+	view.setUint16(offset + 6, Number.parseInt(digits.slice(12, 16), 16), true);
+	for (let i = 0; i < 8; i++) view.setUint8(offset + 8 + i, Number.parseInt(digits.slice(16 + i * 2, 18 + i * 2), 16));
+}
+const FILETIME_EPOCH_OFFSET_100NS = 116444736000000000n;
+const HUNDRED_NS_PER_MS = 10000n;
+function filetimeToDate(low, high) {
+	const ms = ((BigInt(high) << 32n | BigInt(low)) - FILETIME_EPOCH_OFFSET_100NS) / HUNDRED_NS_PER_MS;
+	return new Date(Number(ms));
+}
+function dateToFiletime(date) {
+	const ticks = BigInt(date.getTime()) * HUNDRED_NS_PER_MS + FILETIME_EPOCH_OFFSET_100NS;
+	return {
+		low: Number(ticks & 4294967295n),
+		high: Number(ticks >> 32n & 4294967295n)
+	};
+}
+//#endregion
+export { BYTE_ORDER_MARK, CP_WINUNICODE, GUID_NULL, HEADER_SIZE, IDENTIFIER_AND_OFFSET_SIZE, PID_CODEPAGE, PID_DICTIONARY, PROPERTY_SET_HEADER_SIZE, TYPED_VALUE_HEADER_SIZE, VT_FILETIME, VT_I2, VT_I4, VT_LPSTR, VT_LPWSTR, WINDOWS_1252_CODEPAGE, dateToFiletime, filetimeToDate, readGuid, writeGuid };

package/dist/oleps/write.cjs

@@ -0,0 +1,103 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_oleps_wire = require("./wire.cjs");
+//#region src/oleps/write.ts
+var PropertySetWriteError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "PropertySetWriteError";
+	}
+};
+function encodeUnicodeStringValue(value) {
+	const characterBytes = new Uint8Array((value.length + 1) * 2);
+	const charView = new DataView(characterBytes.buffer);
+	for (let i = 0; i < value.length; i++) charView.setUint16(i * 2, value.charCodeAt(i), true);
+	charView.setUint16(value.length * 2, 0, true);
+	return characterBytes;
+}
+function padTo4(length) {
+	return Math.ceil(length / 4) * 4;
+}
+function encodeTypedPropertyValue(value) {
+	switch (value.type) {
+		case "VT_I2": {
+			const bytes = /* @__PURE__ */ new Uint8Array(8);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 2, true);
+			view.setUint16(2, 0, true);
+			view.setInt16(4, value.value, true);
+			view.setUint16(6, 0, true);
+			return bytes;
+		}
+		case "VT_I4": {
+			const bytes = /* @__PURE__ */ new Uint8Array(8);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 3, true);
+			view.setUint16(2, 0, true);
+			view.setInt32(4, value.value, true);
+			return bytes;
+		}
+		case "VT_FILETIME": {
+			const { low, high } = require_oleps_wire.dateToFiletime(value.value);
+			const bytes = /* @__PURE__ */ new Uint8Array(12);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 64, true);
+			view.setUint16(2, 0, true);
+			view.setUint32(4, low, true);
+			view.setUint32(8, high, true);
+			return bytes;
+		}
+		case "VT_LPWSTR": {
+			const characters = encodeUnicodeStringValue(value.value);
+			const paddedLength = padTo4(characters.length);
+			const bytes = new Uint8Array(8 + paddedLength);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 31, true);
+			view.setUint16(2, 0, true);
+			view.setUint32(4, characters.length / 2, true);
+			bytes.set(characters, 8);
+			return bytes;
+		}
+		case "VT_LPSTR": throw new PropertySetWriteError("writePropertySetStream cannot write a VT_LPSTR property: this writer emits Unicode (VT_LPWSTR) strings only, since encoding to an arbitrary ANSI codepage is out of scope -- see the package README's OLEPS scope note");
+	}
+}
+function writePropertySetStream(propertySet) {
+	const entries = [...propertySet.properties.entries()].sort(([a], [b]) => a - b);
+	const dictionaryBytes = new Uint8Array(entries.length * 8);
+	const dictionaryView = new DataView(dictionaryBytes.buffer);
+	const valueChunks = [];
+	let valueOffset = 8 + dictionaryBytes.length;
+	let index = 0;
+	for (const [pid, value] of entries) {
+		const encoded = encodeTypedPropertyValue(value);
+		dictionaryView.setUint32(index * 8, pid, true);
+		dictionaryView.setUint32(index * 8 + 4, valueOffset, true);
+		valueChunks.push(encoded);
+		valueOffset += encoded.length;
+		index += 1;
+	}
+	const propertySetSize = valueOffset;
+	const propertySetBytes = new Uint8Array(propertySetSize);
+	const propertySetView = new DataView(propertySetBytes.buffer);
+	propertySetView.setUint32(0, propertySetSize, true);
+	propertySetView.setUint32(4, entries.length, true);
+	propertySetBytes.set(dictionaryBytes, 8);
+	let cursor = 8 + dictionaryBytes.length;
+	for (const chunk of valueChunks) {
+		propertySetBytes.set(chunk, cursor);
+		cursor += chunk.length;
+	}
+	const streamBytes = new Uint8Array(48 + propertySetBytes.length);
+	const view = new DataView(streamBytes.buffer);
+	view.setUint16(0, require_oleps_wire.BYTE_ORDER_MARK, true);
+	view.setUint16(2, 0, true);
+	view.setUint32(4, 0, true);
+	require_oleps_wire.writeGuid(view, 8, require_oleps_wire.GUID_NULL);
+	view.setUint32(24, 1, true);
+	require_oleps_wire.writeGuid(view, 28, propertySet.formatId);
+	view.setUint32(44, 48, true);
+	streamBytes.set(propertySetBytes, 48);
+	return streamBytes;
+}
+//#endregion
+exports.PropertySetWriteError = PropertySetWriteError;
+exports.writePropertySetStream = writePropertySetStream;

package/dist/oleps/write.d.cts

@@ -0,0 +1,8 @@
+import { PropertySet } from "./wire.cjs";
+//#region src/oleps/write.d.ts
+declare class PropertySetWriteError extends Error {
+  constructor(message: string);
+}
+declare function writePropertySetStream(propertySet: PropertySet): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PropertySetWriteError, writePropertySetStream };

package/dist/oleps/write.d.ts

@@ -0,0 +1,8 @@
+import { PropertySet } from "./wire.js";
+//#region src/oleps/write.d.ts
+declare class PropertySetWriteError extends Error {
+  constructor(message: string);
+}
+declare function writePropertySetStream(propertySet: PropertySet): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PropertySetWriteError, writePropertySetStream };

package/dist/oleps/write.js

@@ -0,0 +1,101 @@
+import { BYTE_ORDER_MARK, GUID_NULL, dateToFiletime, writeGuid } from "./wire.js";
+//#region src/oleps/write.ts
+var PropertySetWriteError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "PropertySetWriteError";
+	}
+};
+function encodeUnicodeStringValue(value) {
+	const characterBytes = new Uint8Array((value.length + 1) * 2);
+	const charView = new DataView(characterBytes.buffer);
+	for (let i = 0; i < value.length; i++) charView.setUint16(i * 2, value.charCodeAt(i), true);
+	charView.setUint16(value.length * 2, 0, true);
+	return characterBytes;
+}
+function padTo4(length) {
+	return Math.ceil(length / 4) * 4;
+}
+function encodeTypedPropertyValue(value) {
+	switch (value.type) {
+		case "VT_I2": {
+			const bytes = /* @__PURE__ */ new Uint8Array(8);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 2, true);
+			view.setUint16(2, 0, true);
+			view.setInt16(4, value.value, true);
+			view.setUint16(6, 0, true);
+			return bytes;
+		}
+		case "VT_I4": {
+			const bytes = /* @__PURE__ */ new Uint8Array(8);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 3, true);
+			view.setUint16(2, 0, true);
+			view.setInt32(4, value.value, true);
+			return bytes;
+		}
+		case "VT_FILETIME": {
+			const { low, high } = dateToFiletime(value.value);
+			const bytes = /* @__PURE__ */ new Uint8Array(12);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 64, true);
+			view.setUint16(2, 0, true);
+			view.setUint32(4, low, true);
+			view.setUint32(8, high, true);
+			return bytes;
+		}
+		case "VT_LPWSTR": {
+			const characters = encodeUnicodeStringValue(value.value);
+			const paddedLength = padTo4(characters.length);
+			const bytes = new Uint8Array(8 + paddedLength);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 31, true);
+			view.setUint16(2, 0, true);
+			view.setUint32(4, characters.length / 2, true);
+			bytes.set(characters, 8);
+			return bytes;
+		}
+		case "VT_LPSTR": throw new PropertySetWriteError("writePropertySetStream cannot write a VT_LPSTR property: this writer emits Unicode (VT_LPWSTR) strings only, since encoding to an arbitrary ANSI codepage is out of scope -- see the package README's OLEPS scope note");
+	}
+}
+function writePropertySetStream(propertySet) {
+	const entries = [...propertySet.properties.entries()].sort(([a], [b]) => a - b);
+	const dictionaryBytes = new Uint8Array(entries.length * 8);
+	const dictionaryView = new DataView(dictionaryBytes.buffer);
+	const valueChunks = [];
+	let valueOffset = 8 + dictionaryBytes.length;
+	let index = 0;
+	for (const [pid, value] of entries) {
+		const encoded = encodeTypedPropertyValue(value);
+		dictionaryView.setUint32(index * 8, pid, true);
+		dictionaryView.setUint32(index * 8 + 4, valueOffset, true);
+		valueChunks.push(encoded);
+		valueOffset += encoded.length;
+		index += 1;
+	}
+	const propertySetSize = valueOffset;
+	const propertySetBytes = new Uint8Array(propertySetSize);
+	const propertySetView = new DataView(propertySetBytes.buffer);
+	propertySetView.setUint32(0, propertySetSize, true);
+	propertySetView.setUint32(4, entries.length, true);
+	propertySetBytes.set(dictionaryBytes, 8);
+	let cursor = 8 + dictionaryBytes.length;
+	for (const chunk of valueChunks) {
+		propertySetBytes.set(chunk, cursor);
+		cursor += chunk.length;
+	}
+	const streamBytes = new Uint8Array(48 + propertySetBytes.length);
+	const view = new DataView(streamBytes.buffer);
+	view.setUint16(0, BYTE_ORDER_MARK, true);
+	view.setUint16(2, 0, true);
+	view.setUint32(4, 0, true);
+	writeGuid(view, 8, GUID_NULL);
+	view.setUint32(24, 1, true);
+	writeGuid(view, 28, propertySet.formatId);
+	view.setUint32(44, 48, true);
+	streamBytes.set(propertySetBytes, 48);
+	return streamBytes;
+}
+//#endregion
+export { PropertySetWriteError, writePropertySetStream };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "archive-codec",
-  "version": "1.3.0",
-  "description": "ZIP-in-ZIP recursive walking with depth and cumulative decompressed-size guards, plus bounded classic OLE compound-file ([MS-CFB]) reading - zero document-format knowledge, the archive and container utility package for the documents.js family.",
+  "version": "1.4.1",
+  "description": "ZIP-in-ZIP recursive walking with depth and cumulative decompressed-size guards, bounded classic OLE compound-file ([MS-CFB]) reading and writing, and [MS-OLEPS] Property Set Stream reading and writing - zero document-format knowledge, the archive and container utility package for the documents.js family.",
   "type": "module",
   "repository": {
     "type": "git",
@@ -67,6 +67,7 @@
   },
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
+    "document-schema.js": "^5.6.0",
     "fflate": "^0.8.2"
   },
   "devDependencies": {