From 96c3bfca0d0c72e0364d8cf8f8fddcfe6bdb1697 Mon Sep 17 00:00:00 2001
From: Kevin Herron <kevinherron@gmail.com>
Date: Tue, 30 Dec 2025 08:01:26 -0800
Subject: [PATCH 1/2] Add JSpecify dependency and @NullMarked annotations

Add JSpecify 1.0.0 as a dependency to enable null-safety annotations.
Create package-info.java files with @NullMarked for each module's
com.digitalpetri.util package.
---
 byteops-netty/pom.xml                                     | 4 ++++
 .../src/main/java/com/digitalpetri/util/package-info.java | 4 ++++
 byteops-unsigned/pom.xml                                  | 4 ++++
 .../src/main/java/com/digitalpetri/util/package-info.java | 4 ++++
 byteops/pom.xml                                           | 4 ++++
 .../src/main/java/com/digitalpetri/util/package-info.java | 4 ++++
 pom.xml                                                   | 8 ++++++++
 7 files changed, 32 insertions(+)
 create mode 100644 byteops-netty/src/main/java/com/digitalpetri/util/package-info.java
 create mode 100644 byteops-unsigned/src/main/java/com/digitalpetri/util/package-info.java
 create mode 100644 byteops/src/main/java/com/digitalpetri/util/package-info.java

diff --git a/byteops-netty/pom.xml b/byteops-netty/pom.xml
index 5e0238b..544acc3 100644
--- a/byteops-netty/pom.xml
+++ b/byteops-netty/pom.xml
@@ -22,6 +22,10 @@
       <artifactId>netty-buffer</artifactId>
       <version>${netty.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.jspecify</groupId>
+      <artifactId>jspecify</artifactId>
+    </dependency>
 
     <dependency>
       <groupId>com.digitalpetri.util</groupId>
diff --git a/byteops-netty/src/main/java/com/digitalpetri/util/package-info.java b/byteops-netty/src/main/java/com/digitalpetri/util/package-info.java
new file mode 100644
index 0000000..747c10d
--- /dev/null
+++ b/byteops-netty/src/main/java/com/digitalpetri/util/package-info.java
@@ -0,0 +1,4 @@
+@NullMarked
+package com.digitalpetri.util;
+
+import org.jspecify.annotations.NullMarked;
diff --git a/byteops-unsigned/pom.xml b/byteops-unsigned/pom.xml
index ace05c7..f9090ac 100644
--- a/byteops-unsigned/pom.xml
+++ b/byteops-unsigned/pom.xml
@@ -22,6 +22,10 @@
       <artifactId>joou</artifactId>
       <version>${joou.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.jspecify</groupId>
+      <artifactId>jspecify</artifactId>
+    </dependency>
 
     <dependency>
       <groupId>org.junit.jupiter</groupId>
diff --git a/byteops-unsigned/src/main/java/com/digitalpetri/util/package-info.java b/byteops-unsigned/src/main/java/com/digitalpetri/util/package-info.java
new file mode 100644
index 0000000..747c10d
--- /dev/null
+++ b/byteops-unsigned/src/main/java/com/digitalpetri/util/package-info.java
@@ -0,0 +1,4 @@
+@NullMarked
+package com.digitalpetri.util;
+
+import org.jspecify.annotations.NullMarked;
diff --git a/byteops/pom.xml b/byteops/pom.xml
index f6d6fe1..462d27d 100644
--- a/byteops/pom.xml
+++ b/byteops/pom.xml
@@ -12,6 +12,10 @@
   <artifactId>byteops</artifactId>
 
   <dependencies>
+    <dependency>
+      <groupId>org.jspecify</groupId>
+      <artifactId>jspecify</artifactId>
+    </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
diff --git a/byteops/src/main/java/com/digitalpetri/util/package-info.java b/byteops/src/main/java/com/digitalpetri/util/package-info.java
new file mode 100644
index 0000000..747c10d
--- /dev/null
+++ b/byteops/src/main/java/com/digitalpetri/util/package-info.java
@@ -0,0 +1,4 @@
+@NullMarked
+package com.digitalpetri.util;
+
+import org.jspecify.annotations.NullMarked;
diff --git a/pom.xml b/pom.xml
index b6e5688..2fcb1fe 100644
--- a/pom.xml
+++ b/pom.xml
@@ -55,6 +55,9 @@
     <junit.version>5.10.2</junit.version>
     <slf4j.version>2.0.16</slf4j.version>
 
+    <!-- Annotations -->
+    <jspecify.version>1.0.0</jspecify.version>
+
     <!-- Plugin Dependencies -->
     <spotless-maven-plugin.version>3.0.0</spotless-maven-plugin.version>
   </properties>
@@ -85,6 +88,11 @@
         <version>${slf4j.version}</version>
         <scope>test</scope>
       </dependency>
+      <dependency>
+        <groupId>org.jspecify</groupId>
+        <artifactId>jspecify</artifactId>
+        <version>${jspecify.version}</version>
+      </dependency>
     </dependencies>
   </dependencyManagement>
 

From 97a45c091b79aaf6bd17b5536e678f71eca112d1 Mon Sep 17 00:00:00 2001
From: Kevin Herron <kevinherron@gmail.com>
Date: Tue, 30 Dec 2025 08:04:20 -0800
Subject: [PATCH 2/2] ~ move `jspecify.version` definition

---
 pom.xml | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/pom.xml b/pom.xml
index 2fcb1fe..14fe763 100644
--- a/pom.xml
+++ b/pom.xml
@@ -49,15 +49,13 @@
 
     <!-- Dependencies -->
     <joou.version>0.9.4</joou.version>
+    <jspecify.version>1.0.0</jspecify.version>
     <netty.version>4.1.112.Final</netty.version>
 
     <!-- Test Dependencies -->
     <junit.version>5.10.2</junit.version>
     <slf4j.version>2.0.16</slf4j.version>
 
-    <!-- Annotations -->
-    <jspecify.version>1.0.0</jspecify.version>
-
     <!-- Plugin Dependencies -->
     <spotless-maven-plugin.version>3.0.0</spotless-maven-plugin.version>
   </properties>