nx_ts_nal.nx

nx_ts_nal.nx -- codec-aware NAL classification for MPEG-TS elementary streams. WHY A LIB AND NOT INLINE (2026-07-31): this logic lived inside nx_ts_index's single scan loop, where it could not be tested without a real multi-megabyte recording. The HEVC hole below was therefore invisible to every gate. Pulling the classification out makes the DECISION testable independently of the I/O that feeds it -- the bug was never in the scanning, it was in the arithmetic. THE HOLE THIS CLOSES: nx_ts_index accepted only stream_type 0x1b (H.264), so an HEVC recording never got a video PID -- no keyframe index AND no NXMK dead-air/motion markers, permanently, for every H.265 asset in the corpus. THE TWO CODECS ARE NOT A TUNING DIFFERENCE, THEY ARE DIFFERENT GEOMETRY: H.264 1-byte NAL header, type = b & 0x1f keyframe = IDR, the single value 5 HEVC 2-byte NAL header, type = (b >> 1) & 0x3f keyframe = IRAP, the RANGE 16..23 ★★★ Reading HEVC through the H.264 mask does not fail loudly -- it takes the wrong bits and yields a plausible small integer, so random frames get marked as keyframes. A seek index that is WRONG is worse than one that is ABSENT, because absent is visibly ready:0 while wrong looks like it works and seeks to garbage. license_tier: ORIGINAL