nx_le.nx

nx_le.nx -- canonical little-endian / big-endian fixed-width binary read + write primitives. DRY consolidation per the shared-libraries cardinal. Three existing callers inlined their own LE-read helpers: nx_bmp_header.bmp_read_u32 (BMP image parsing) nx_cbor_decode (byte count reads) (CBOR length parsing) nx_wav.nx (WAV audio parsing) Plus the queued GGUF (model weight) + safetensors + ELF / PE header readers. Per the "rule of three" + no-reinventing cardinals: this is the canonical primitive. ===== LE byte order ============================================= Little-endian: least-significant byte at lowest address. Used by x86, AArch64 (default), RISC-V, ppc64LE, MIPS-LE, GGUF, ELF on LE platforms, BMP, WAV, safetensors, most binary AI formats. ===== BE byte order ============================================= Big-endian: most-significant byte at lowest address. Used by network protocols (TCP/IP headers, DNS, HTTP/2 frames), s390x (big-endian platform), Java class files, PNG, MP3 ID3, MIDI. ===== API ======================================================= All readers take (buf: *u8, off: i64) and return the value as i64 (sign-extended for signed forms). Caller is responsible for bounds-checking off + width <= buf_len. All writers take (buf: *u8, off: i64, val: i64). Per the bounded-loop cardinal: no loops needed (fixed-width extracts are unrolled). genealogy_id: ietf_rfc_8949_cbor + ieee_754_byte_order + wikipedia_endianness lineage_id: substrate_le_be_v1