Files
libfreemkv/docs/bdnav.md
T
Matthew Jackson 6e14fc0c0c libfreemkv: 1.7.0 groundwork — sector-recycle soundness + CI hardening
Security
- Remove the unsafe Vec::set_len over recycled sector buffers — UB reachable
  from safe code (GHSA-j8ww-f5fg-9pmh, low). Uses Vec::resize; pooling unchanged.

CI / tooling
- clippy on stable with the MSRV single-sourced from Cargo.toml; cargo-deny
  dependency-audit gate with first-party git sources allowed (#15); audience-based
  comment-guard (#17).

Docs
- README (keydb ownership, BD-J parser count), drive-access transport/reset
  notes, mux timeline module-doc links.
2026-09-02 12:40:55 -07:00

950 B

bdnav — HDMV navigation resolver

Notes relocated from src/bdnav/mod.rs doc comments (kept out of the source to respect the comment-guard's prose caps).

No per-disc special-casing

There is no per-disc special-casing: one correctly-booted VM resolves densely-branched dispatchers as well as simple ones. The honest boundary is BD-J (the feature is chosen by a Java Xlet, not by the HDMV VM); there — and on any malformed data or non-convergence — the resolver ABSTAINS (None) and selection falls back to the structural/heuristic order.

resolve_feature

Resolves the playlist id the disc's First-Play navigation plays as the feature, restricted to ids the caller marks as feature candidates (is_feature_candidate — typically video-bearing, non-trivial titles, so a short logo/pre-roll PlayPlayList is skipped). Returns None for BD-J discs, missing/malformed nav data, or when navigation does not converge on a candidate.