nebkat / dart-bjdata / 32915282208

85%

push

github

fix: Support decoding N-dimensional arrays

N-dimensional arrays are a draft 3 construct that this library rejected as
invalid, so valid draft 3 data could not be read.

`[$type#[Nx Ny ...]` now decodes to nested lists, keeping the innermost axis as
the typed list. The nesting is built from views rather than copies, so an
N-dimensional array is still one contiguous allocation once decoded. Dimension
arrays are accepted in both optimized and non-optimized form.

The column-major form, `[$type#[[Nx Ny ...]]` as MATLAB and FORTRAN write it,
is reordered into row-major order so that it reads the same way as an array of
the same shape written row-major. Elements are permuted whole, whatever their
width, so this works for every strong type.

Encoding N-dimensional arrays is not supported, so a decoded array is written
back as nested arrays; the values are unchanged.

Also throws a FormatException rather than a RangeError when a string or buffer
runs past the end of the input, which a payload shorter than its dimensions
makes easy to hit.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

86 of 108 new or added lines in 2 files covered. (79.63%)

410 of 589 relevant lines covered (69.61%)

1.3 hits per line