58 lines
5.6 KiB
Markdown
58 lines
5.6 KiB
Markdown
# Specifications and pinned references
|
|
|
|
Version 0.3.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/d46f1b61fb85a18299b6b8af2148dcd991ef6b05) | `d46f1b61fb85a18299b6b8af2148dcd991ef6b05` | Reviewed ZIP shape, exact checksum lock, independent-app assembly, and nginx deployment model |
|
|
| [`onenote.rs`](https://github.com/msiemens/onenote.rs/tree/5138a39a3f4e72b840932f9872fecde52fa9da60) | `5138a39a3f4e72b840932f9872fecde52fa9da60` | Selected desktop/FSSHTTPB 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 |
|
|
| [`libmspack`](https://github.com/kyz/libmspack/tree/55d501976171397ccd5d5a7a1ca7da065b1d9a06) | `55d501976171397ccd5d5a7a1ca7da065b1d9a06` | Multi-cabinet chain, split CFDATA, spanning-file semantics, and licensed fixtures |
|
|
| [`one2html`](https://github.com/msiemens/one2html/tree/59930ad309004030f812790c6749efe4265bb6bd) | `59930ad309004030f812790c6749efe4265bb6bd` | Behavioral reference for rich text, tables, images, attachments, ink, and HTML rendering |
|
|
|
|
The SDK and Portal revisions were inspected from the local repositories. Every
|
|
parser/renderer reference was cloned and reviewed at the hash 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), 2.6.7 (property sets), 2.7 (FSSHTTPB package-store objects), and
|
|
2.8.1 (OneStore Packaging Structure).
|
|
- [[MS-FSSHTTPB]: Binary Requests for File Synchronization via SOAP Protocol](https://learn.microsoft.com/en-us/openspecs/sharepoint_protocols/ms-fsshttpb/99a25464-99b5-4262-a964-baabed2170eb),
|
|
particularly the stream-object headers/end markers and section 2.2.1.12 Data
|
|
Element Package structures used by the OneStore package envelope.
|
|
- [[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.
|
|
|
|
The `one2html` renderer is a behavioral reference only: no Rust, Askama
|
|
template, stylesheet, or generated HTML is shipped or executed by this
|
|
application.
|