Unpacks a Stream into a given PackedBundle The StreamUnpacker will read as many words from input as necessary to unpack all fields. Fields that exceed a word width will be wrapped into as many subsequent words needed.

Unpacks a Stream given a layout of Data fields. Field layout is accepted as pairs of Data and their start bits. Starting bits are interpreted as absolute bit positions within a multi-word layout. The StreamUnpacker will read as many words from input as necessary to unpack all fields. Fields that exceed a word width will be wrapped into as many subsequent words needed.

Decomposes a Data field into a map of words to Word-relative range -> Field-relative range. The starting bit is any absolute position within some set of words,

For example, a word with 16 bits starting at bit 4 decomposed into 8 bit words would result in: { 0 -> ((4 to 7) -> (0 to 3)), 1 -> ((0 to 7) -> (4 to 11)), 2 -> ((0 to 3) -> (12 to 15)) }

Converts a layout of Data and starting bit pairs into a map of word range to Data range slices for each word that the Data spans, indexed by each Data. The return type is a 2D map relating each Data to each word index. The range pairs for each word index represent which bits of the word (local to the width of the word) map to the bits of Data that lie within the word.