51 lines
4.5 KiB
Markdown
51 lines
4.5 KiB
Markdown
# Specifications and pinned references
|
|
|
|
Version 0.1.0 records these immutable implementation revisions:
|
|
|
|
| Repository | Exact revision | Use |
|
|
| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------- |
|
|
| [`toolbox-sdk`](https://git.add-ideas.de/zemion/toolbox-sdk/src/commit/5e206baf42dfae5a00f2743fb2cc501bb12d9b7a) | `5e206baf42dfae5a00f2743fb2cc501bb12d9b7a` | App contract, React shell, manifest schema/testkit, and nested-path behavior |
|
|
| [`toolbox-portal`](https://git.add-ideas.de/zemion/toolbox-portal/src/commit/5d2e466ad61e36a0e2be2a2d8459b1a127f53f11) | `5d2e466ad61e36a0e2be2a2d8459b1a127f53f11` | Reviewed ZIP shape, exact checksum lock, and independent-app assembly model |
|
|
| [`onenote.rs`](https://github.com/msiemens/onenote.rs/tree/5138a39a3f4e72b840932f9872fecde52fa9da60) | `5138a39a3f4e72b840932f9872fecde52fa9da60` | Selected desktop OneStore and MS-ONE structures adapted into TypeScript |
|
|
| [`rust-cab`](https://github.com/mdsteele/rust-cab/tree/c5839f5fdfa4c4e7cc9b22f570c79c96af0560e2) | `c5839f5fdfa4c4e7cc9b22f570c79c96af0560e2` | CAB structures, checksum, enumeration/extraction, MSZIP history, and unit fixtures |
|
|
| [`compcol`](https://github.com/KarpelesLab/compcol/tree/04a6db2aa7bd487a89c559631d79d1b384139f50) | `04a6db2aa7bd487a89c559631d79d1b384139f50` | Quantum bit reader, arithmetic models, LZ window, CAB sentinel behavior, and tests |
|
|
| [`lzxd` 0.2.5](https://github.com/Lonami/lzxd/tree/4748e43594e3e30cff2ace3a6ad7a376c9816fdd) | `4748e43594e3e30cff2ace3a6ad7a376c9816fdd` | LZX bitstream, Huffman, block/window, match, and E8 logic adapted into TypeScript |
|
|
|
|
The SDK and Portal revisions were inspected from the local repositories. The
|
|
four parser references were cloned and reviewed at the hashes above; a branch
|
|
name or package version alone is not used as provenance. Source-level mappings
|
|
and behavioural deviations are in [PORTING.md](PORTING.md).
|
|
|
|
## Normative Microsoft documents
|
|
|
|
The implementation uses the official specifications as the source of format
|
|
truth and the pinned projects as implementation references:
|
|
|
|
- [[MS-ONESTORE]: OneNote Revision Store File Format](https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-onestore/ae670cd2-4b38-4b24-82d1-87cfb2cc3725),
|
|
particularly sections 2.2.4 (chunk references), 2.3.1 (header), 2.4
|
|
(file-node lists and fragments), 2.5.1-2.5.8 (object-space/revision
|
|
manifests), and 2.6.7 (property sets).
|
|
- [[MS-ONE]: OneNote File Format](https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-one/73d22548-a613-4350-8c23-07d15576be50),
|
|
particularly sections 2.1.8-2.1.13 (root objects, page object spaces, and
|
|
property sets), 2.2.17-2.2.23 (section/page-series/outline/rich-text nodes),
|
|
and 2.2.30, 2.2.34, 2.2.62-2.2.65, and 2.2.91 (page metadata/manifest,
|
|
titles, page-space references, and section name).
|
|
- [[MS-CAB]: Cabinet File Format](https://download.microsoft.com/download/4/d/a/4da14f27-b4ef-4170-a6e6-5b1ef85b1baa/%5Bms-cab%5D.pdf),
|
|
sections 2.1-2.4 (`CFHEADER`, `CFFOLDER`, `CFFILE`, and `CFDATA`) and 3.1
|
|
(checksum method).
|
|
- [[MS-MCI]: Compression and Decompression Data Structure](https://learn.microsoft.com/en-us/openspecs/exchange_server_protocols/ms-mci/3048c471-f739-4d30-bcb3-a962cfe84a69),
|
|
MSZIP block framing, raw DEFLATE streams, 32 KiB block/history behavior, and
|
|
compressed-size bounds.
|
|
- [[MS-PATCH]: LZX Delta Compression and Decompression](https://learn.microsoft.com/en-us/openspecs/exchange_server_protocols/ms-patch/cc78752a-b4af-4eee-88cb-01f4d8a4c2bf),
|
|
sections 2.1-2.7 (bitstream/window concepts, header/E8 translation, blocks,
|
|
Huffman trees, pretree encoding, tokens, and decoding). `lzxd` 0.2.5 states
|
|
that it was based on revision 9.0; the port removes delta/reference-data use
|
|
and applies CAB CFDATA chunk framing.
|
|
|
|
The Microsoft documents are linked rather than copied. Their published pages
|
|
can change independently; the source references and golden bytes remain pinned
|
|
for reproducibility.
|
|
|
|
`one2html` is deliberately not pinned or inspected because visual HTML
|
|
rendering is outside this release.
|