# Port provenance

The desktop `.one` reader adapts selected structures from the pinned
`onenote.rs` implementation. It is not a line-for-line or complete port.

| TypeScript module                        | Upstream path(s)                                                                                 | Revision                                              | Port scope and deviations                                                                                                                      |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `src/onenote/onestore/file-node.ts`      | `onestore/desktop/file_structure/file_node_list_fragment.rs`, `file_node/*`, chunk references    | `onenote.rs@5138a39a3f4e72b840932f9872fecde52fa9da60` | Selected; immutable byte input, strict range checks, fragment/child cycle detection, and depth/count limits                                    |
| `src/onenote/onestore/property-set.ts`   | `onestore/shared/{object_prop_set,prop_set,property,object_stream_header}.rs`                    | same                                                  | Substantial; bounded vectors/counts/nesting and serializable discriminated unions                                                              |
| `src/onenote/onestore/desktop-store.ts`  | `onestore/desktop/{file_node,file_structure,objects}/*`                                          | same                                                  | Selected desktop section path; explicit missing-reference errors; file-data/attachment payloads skipped with diagnostics                       |
| `src/onenote/fsshttpb/*`                 | `fsshttpb/{data,data_element,packaging}.rs`                                                      | same                                                  | Native bounded package/header/data-element records, checked compact integers, zero-copy BLOB ranges; fragment records parsed but not assembled |
| `src/onenote/onestore/fsshttp-store.ts`  | `onestore/fsshttpb/{header,mapping_table,object,object_space,revision,revision_role}.rs`         | same                                                  | Unfragmented package-store adapter; bounded/cycle-checked revision chains, newest-revision precedence, resolved positional reference arrays    |
| `src/onenote/one/{constants,section}.ts` | `one/property*`, `one/property_set/*`, `onenote/{section,page,page_series,outline,rich_text}.rs` | same                                                  | Page metadata, titles, and plain text only; bounded graph traversal; visual/embedded content diagnosed                                         |

The browser-native package path has separate MIT provenance:

| TypeScript module                                                        | Upstream path(s)                                       | Revision and selected licence                                               | Port scope and deviations                                                                                                                                                                                   |
| ------------------------------------------------------------------------ | ------------------------------------------------------ | --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `src/onenote/onepkg/{cabinet,checksum}.ts`                               | rust-cab `src/{cabinet,folder,file,ctype,checksum}.rs` | `c5839f5fdfa4c4e7cc9b22f570c79c96af0560e2`, MIT                             | CAB reading/checksum adapted for immutable browser bytes, strict normalized paths, checked ranges/checksums, whole-folder extraction, explicit limits, and cancellation/yield hooks; writers are not ported |
| `src/onenote/onepkg/mszip/decoder.ts`                                    | rust-cab `src/mszip.rs`; fflate raw DEFLATE            | rust-cab revision above; fflate 0.8.3, MIT                                  | `CK` framing and persistent 32 KiB folder history follow rust-cab; raw DEFLATE uses fflate with a caller-owned bounded buffer and strict declared-size checks                                               |
| `src/onenote/onepkg/quantum/{bit-reader,budget,decoder,model,tables}.ts` | compcol `src/quantum/{bits,decoder,model,tables}.rs`   | `04a6db2aa7bd487a89c559631d79d1b384139f50`, MIT                             | Native TypeScript arithmetic/model/LZ decoder; fixed CAB output, 2 MiB maximum window, strict match/frame/trailer checks, two-block lookahead, operation budget, and cancellation checkpoints               |
| `src/onenote/onepkg/lzx/{bit-reader,huffman,decoder}.ts`                 | lzxd 0.2.5 `src/{bitstream,tree,block,window,lib}.rs`  | `4748e43594e3e30cff2ace3a6ad7a376c9816fdd`, MIT option of MIT OR Apache-2.0 | Directly translated core with typed arrays, CAB CFDATA boundaries, persistent folder state, strict malformed-stream errors, and operation/window/cancellation limits; delta reference data is omitted       |

The bounded binary readers, format detection, parser limits/error model, path
policy, worker protocol/DTOs, package-to-section boundary, and application UI
are original TypeScript implementations guided by the normative specifications
and project requirements.

Files adapted from `onenote.rs` carry an MPL-2.0 notice, SPDX identifier,
upstream path/revision, and deviations. Files adapted from rust-cab, compcol,
or lzxd carry their MIT provenance, copyright notice, exact revision, and deviations.
Licence texts are reproduced in `LICENSES/` and included in the release ZIP.

Focused tests cover successful pinned fixtures plus malformed bounds,
references, checksums, paths, Huffman trees, compressed blocks, limits, and
cancellation. Fixture origins and redistribution terms are recorded separately
in `tests/fixtures/README.md`.