From 4fcab7dc2ffa0cac8fc936c117a634ef6e23a4ba Mon Sep 17 00:00:00 2001
From: Davide Angelocola <davide.angelocola@gmail.com>
Date: Tue, 23 Jun 2026 09:02:40 +0200
Subject: [PATCH 1/2] fix(sonar): suppress S6218 on UnpackSchedule record
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The record (added when the four bitpacked unpack loops were unified) has
array components, which Sonar flags as a bug (equals/hashCode/toString don't
consider array content). UnpackSchedule is a private, never-compared data
carrier passed straight into the unpack loops — the same pattern suppressed
across the reader.array package. Suppress with the standard reason.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .../dfa1/vortex/reader/decode/BitpackedEncodingDecoder.java      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reader/src/main/java/io/github/dfa1/vortex/reader/decode/BitpackedEncodingDecoder.java b/reader/src/main/java/io/github/dfa1/vortex/reader/decode/BitpackedEncodingDecoder.java
index b0b86791..ed26f024 100644
--- a/reader/src/main/java/io/github/dfa1/vortex/reader/decode/BitpackedEncodingDecoder.java
+++ b/reader/src/main/java/io/github/dfa1/vortex/reader/decode/BitpackedEncodingDecoder.java
@@ -102,6 +102,7 @@ private static void fastlanesUnpackToSeg(
     /// @param currWordByteBase  byte offset of the current word within the block
     /// @param nextWordByteBase  byte offset of the next word within the block
     /// @param outRowByteOff     byte offset of the row within the transposed output block
+    @SuppressWarnings("java:S6218") // internal data carrier; record components are arrays of immutable primitives that flow through the unpack loops without ever being compared.
     private record UnpackSchedule(
             int[] shifts, int[] remainingBits, int[] currentBits,
             long[] loMasks, long[] hiMasks,

From 9038f9ff3976bccb8f29ecdac2c39418f20ff3d0 Mon Sep 17 00:00:00 2001
From: Davide Angelocola <davide.angelocola@gmail.com>
Date: Tue, 23 Jun 2026 09:02:40 +0200
Subject: [PATCH 2/2] docs: bump dependency-example versions to 0.8.3

README and compatibility.md showed 0.8.0, tutorial.md showed 0.7.3; align
all Maven dependency snippets with the just-released 0.8.3.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 README.md             | 2 +-
 docs/compatibility.md | 4 ++--
 docs/tutorial.md      | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index dd77881d..69573d8c 100644
--- a/README.md
+++ b/README.md
@@ -66,7 +66,7 @@ line-by-line diff is zero.
 <dependency>
   <groupId>io.github.dfa1.vortex</groupId>
   <artifactId>vortex-reader</artifactId>
-  <version>0.8.0</version>
+  <version>0.8.3</version>
 </dependency>
 ```
 
diff --git a/docs/compatibility.md b/docs/compatibility.md
index 18f9b546..2807fb2d 100644
--- a/docs/compatibility.md
+++ b/docs/compatibility.md
@@ -12,14 +12,14 @@ A consumer that only needs to read Vortex files can depend on a strict subset:
 <dependency>
   <groupId>io.github.dfa1.vortex</groupId>
   <artifactId>vortex-reader</artifactId>
-  <version>0.8.0</version>
+  <version>0.8.3</version>
 </dependency>
 
 <!-- optional: inspector for layout-tree introspection -->
 <dependency>
   <groupId>io.github.dfa1.vortex</groupId>
   <artifactId>vortex-inspector</artifactId>
-  <version>0.8.0</version>
+  <version>0.8.3</version>
 </dependency>
 ```
 
diff --git a/docs/tutorial.md b/docs/tutorial.md
index 00c22e67..8f89c379 100644
--- a/docs/tutorial.md
+++ b/docs/tutorial.md
@@ -26,7 +26,7 @@ Add the dependency to `pom.xml` (inside `<dependencies>`):
 <dependency>
   <groupId>io.github.dfa1.vortex</groupId>
   <artifactId>vortex-reader</artifactId>
-  <version>0.7.3</version>
+  <version>0.8.3</version>
 </dependency>
 ```