lotobo/onenote-tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 8 Wiki Activity
Files
670310ea9e88e0c2d40f1cd060777d92cf10a7e7
onenote-tools/docs/REFERENCE_IMPLEMENTATIONS.md

4.3 KiB
Raw Blame History

Specifications and pinned references

Version 0.1.0 records these immutable implementation revisions:

Repository Exact revision Use
toolbox-sdk 5e206baf42dfae5a00f2743fb2cc501bb12d9b7a App contract, React shell, manifest schema/testkit, and nested-path behavior
toolbox-portal 5d2e466ad61e36a0e2be2a2d8459b1a127f53f11 Reviewed ZIP shape, exact checksum lock, and independent-app assembly model
onenote.rs 5138a39a3f4e72b840932f9872fecde52fa9da60 Selected desktop OneStore and MS-ONE structures adapted into TypeScript
rust-cab c5839f5fdfa4c4e7cc9b22f570c79c96af0560e2 CAB structures, checksum, enumeration/extraction, MSZIP history, and unit fixtures
lzxd 0.2.5 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 three 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.

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, 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, 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, sections 2.1-2.4 (CFHEADER, CFFOLDER, CFFILE, and CFDATA) and 3.1 (checksum method).
  • [MS-MCI]: Compression and Decompression Data Structure, MSZIP block framing, raw DEFLATE streams, 32 KiB block/history behavior, and compressed-size bounds.
  • [MS-PATCH]: LZX Delta Compression and Decompression, 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.