nx_bgzf.nx

nx_bgzf.nx -- BGZF (Blocked GZIP Format) container per SAMv1 §4.1. BGZF wraps each block in a gzip member with an extra "BC" subfield carrying BSIZE = total block bytes - 1, allowing random access (a reader can advance exactly one block without inflating). G6.0e.1: nx_bgzf_eof_marker -- the canonical 28-byte EOF marker that every BAM file MUST end with (SAMv1 §4.1.2; htslib uses the literal byte sequence). This is a well-known fixed sequence; encoded as a fixed-Huffman empty DEFLATE block. G6.0e.2: nx_bgzf_write_stored_block -- write a single BGZF block carrying `data` of length `len` using DEFLATE BTYPE=00 (stored / no compression). Always succeeds for len up to the stored-block limit (65504 bytes; keeps total ≤ 65535). Composes nx_crc32 (CRC-32 of the uncompressed payload) and nx_le_write_u16/u32 (all multi-byte fields little-endian). Compressed BGZF blocks (BTYPE=01/10) require a DEFLATE ENCODER which the substrate does not yet ship (nx_deflate is decode-only). Stored-block BGZF is a fully spec-conformant BAM container and htslib will read it without warning. expect_exit: 0 license_tier: ORIGINAL