feat: add org.reactivestreams (#9)

- chore: add `org.reactivestreams` submodule
- chore: pin to reactive-streams/reactive-streams-jvm#556
- chore: sync repository
- chore: add to version catalog

Relates-To: #1

Signed-off-by: Sam Gammon <sam@elide.ventures>

Author: sgammon

.gitmodules

@@ -13,3 +13,6 @@
 [submodule "guava"]
 	path = com.google.guava
 	url = git@github.com:sgammon/guava.git
+[submodule "reactive-streams"]
+	path = org.reactivestreams
+	url = git@github.com:sgammon/reactive-streams-jvm.git

Makefile

@@ -16,16 +16,18 @@ ifeq ($(SNAPSHOT),yes)
 export CHECKER_FRAMEWORK_VERSION ?= 3.43.0-SNAPSHOT
 export GUAVA_VERSION ?= 1.0-HEAD-jre-SNAPSHOT
 export GUAVA_FAILUREACCESS_VERSION ?= 1.0.3-jpms
+export REACTIVE_STREAMS_VERSION ?= 1.0.5-SNAPSHOT
 else
 export CHECKER_FRAMEWORK_VERSION ?= 3.43.0-SNAPSHOT
 export GUAVA_VERSION ?= 33.0.0-jre-jpms
 export GUAVA_FAILUREACCESS_VERSION ?= 1.0.3-jpms
+export REACTIVE_STREAMS_VERSION ?= 1.0.5-jpms
 endif
 
 export PROJECT ?= $(shell pwd)
 export LIBS ?= $(PROJECT)/libs
 
-DEPS ?= com.google.guava com.google.errorprone com.google.j2objc org.checkerframework
+DEPS ?= com.google.guava com.google.errorprone com.google.j2objc org.checkerframework org.reactivestreams
 POSIX_FLAGS ?=
 
 ifeq ($(VERBOSE),yes)
@@ -140,6 +142,19 @@ com.google.guava/guava/futures/failureaccess/target:
 		&& $(GIT) checkout . \
 		&& echo "Guava Failure Access ready."
 
+reactivestreams: org.reactivestreams  ## Build Reactive Streams.
+org.reactivestreams: org.reactivestreams/api/build/libs
+org.reactivestreams/api/build/libs:
+	$(info Building Reactive Streams...)
+	$(RULE)cd org.reactivestreams \
+		&& $(GRADLE) \
+			-Pversion=$(REACTIVE_STREAMS_VERSION) \
+			-PreleaseVersion=$(REACTIVE_STREAMS_VERSION) \
+			$(GRADLE_GOAL) \
+			publishToMavenLocal \
+			publishAllPublicationsToMavenLocalRepository \
+		&& echo "Reactive Streams ready."
+
 #
 # Top-level commands
 #
@@ -171,6 +186,7 @@ $(LIBS):
 		com.google.errorprone/annotations/target/*.jar \
 		com.google.j2objc/annotations/target/*.jar \
 		org.checkerframework/checker-qual/build/libs/*.jar \
+		org.reactivestreams/api/build/libs/*.jar \
 		com.google.guava/guava/target/*.jar \
 		$(LIBS)
 
@@ -192,6 +208,7 @@ git-add:
 		repository/com/google/j2objc \
 		repository/com/google/errorprone \
 		repository/org/checkerframework \
+		repository/org/reactivestreams \
 		repository/dev/javamodules
 	$(GIT) status -sb
 
@@ -205,6 +222,7 @@ clean:  ## Clean all built targets.
 		com.google.guava/futures/failureaccess/target \
 		org.checkerframework/build \
 		org.checkerframework/*/build \
+		org.reactivestreams/*/build \
 		samples/gradle-platform/app/build \
 		samples/modular-guava/app/build \
 		samples/modular-guava-repo/app/build \

README.md

@@ -27,6 +27,8 @@ Tracking issue [here][6] provides the best tracker. Once these PRs are merged an
 
 - **[`org.checkerframework`][0]:** **Checker Framework** is a type-checking framework for Java. The `checker-qual` package is used by Guava, so it is included here transitively. Checker Framework added a JPMS module definition in a [recent PR][1], so this is sub-moduled at `master`. At the time of this writing no release has taken place.
 
+- **[`org.reactivestreams`][16]:** **Reactive Streams** is a universal JVM API for building reactive software in an implementation-agnostic manner.
+
 ### How do I use it?
 
 Add this domain as a repository within any JVM build tool: [Maven][7], [Gradle][8], [Bazel][9], [sbt][10]. For example:
@@ -81,6 +83,19 @@ You should use a JPMS-enabled library version which has no conflict with Maven C
 | `com.google.guava:guava`                        | `33.0.0-jre-jpms`       | 🔄       |
 | `com.google.j2objc:j2objc-annotations`          | `3.0.0`                 | ✅       |
 | `org.checkerframework:checker-qual`             | `3.43.0-SNAPSHOT`       | 🔄       |
+| `org.reactivestreams:reactive-streams`          | `1.0.5-jpms`            | ✅       |
+
+### Using the modules
+
+Use the modules in your `module-info.java`:
+
+| Coordinate                                      | Module                              |
+| ----------------------------------------------- | ----------------------------------- |
+| `com.google.errorprone:error_prone_annotations` | `com.google.errorprone.annotations` |
+| `com.google.guava:guava`                        | `com.google.common`                 |
+| `com.google.j2objc:j2objc-annotations`          | `com.google.j2objc.annotations`     |
+| `org.checkerframework:checker-qual`             | `org.checkerframework.checker.qual` |
+| `org.reactivestreams:reactive-streams`          | `org.reactivestreams`               |
 
 ### BOMs & Catalogs
 
@@ -171,3 +186,4 @@ This repo is open source, licensed under [Apache 2.0](./LICENSE.txt). The librar
 [13]: https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#bill-of-materials-bom-poms
 [14]: https://docs.gradle.org/current/userguide/platforms.html
 [15]: https://docs.gradle.org/current/userguide/dependency_version_alignment.html
+[16]: https://github.com/reactive-streams/reactive-streams-jvm

org.reactivestreams

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata modelVersion="1.1.0">
+  <groupId>org.reactivestreams</groupId>
+  <artifactId>reactive-streams</artifactId>
+  <versioning>
+    <lastUpdated>20240313040850</lastUpdated>
+    <snapshot>
+      <localCopy>true</localCopy>
+    </snapshot>
+    <snapshotVersions>
+      <snapshotVersion>
+        <extension>jar</extension>
+        <value>1.0.5-SNAPSHOT</value>
+        <updated>20240313040850</updated>
+      </snapshotVersion>
+      <snapshotVersion>
+        <extension>pom</extension>
+        <value>1.0.5-SNAPSHOT</value>
+        <updated>20240313040850</updated>
+      </snapshotVersion>
+      <snapshotVersion>
+        <extension>module</extension>
+        <value>1.0.5-SNAPSHOT</value>
+        <updated>20240313040850</updated>
+      </snapshotVersion>
+    </snapshotVersions>
+  </versioning>
+  <version>1.0.5-SNAPSHOT</version>
+</metadata>

repository/org/reactivestreams/reactive-streams/1.0.5-SNAPSHOT/maven-metadata-local.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata modelVersion="1.1.0">
+  <groupId>org.reactivestreams</groupId>
+  <artifactId>reactive-streams</artifactId>
+  <versioning>
+    <lastUpdated>20240313040846</lastUpdated>
+    <snapshot>
+      <timestamp>20240313.040846</timestamp>
+      <buildNumber>3</buildNumber>
+    </snapshot>
+    <snapshotVersions>
+      <snapshotVersion>
+        <extension>jar</extension>
+        <value>1.0.5-20240313.040846-3</value>
+        <updated>20240313040846</updated>
+      </snapshotVersion>
+      <snapshotVersion>
+        <extension>pom</extension>
+        <value>1.0.5-20240313.040846-3</value>
+        <updated>20240313040846</updated>
+      </snapshotVersion>
+      <snapshotVersion>
+        <extension>module</extension>
+        <value>1.0.5-20240313.040846-3</value>
+        <updated>20240313040846</updated>
+      </snapshotVersion>
+    </snapshotVersions>
+  </versioning>
+  <version>1.0.5-SNAPSHOT</version>
+</metadata>

repository/org/reactivestreams/reactive-streams/1.0.5-SNAPSHOT/maven-metadata.xml

@@ -0,0 +1 @@
+2f02be4e952bf9088283830ddf9f5343

repository/org/reactivestreams/reactive-streams/1.0.5-SNAPSHOT/maven-metadata.xml.md5

@@ -0,0 +1 @@
+a6ad042fb0c58ee74726856142a274c2795e418f

repository/org/reactivestreams/reactive-streams/1.0.5-SNAPSHOT/maven-metadata.xml.sha1

@@ -0,0 +1 @@
+80ac42244391ba2500bf9b834ea0a0f5e3772baff79cc62c0de26f99cb85b8f8

repository/org/reactivestreams/reactive-streams/1.0.5-SNAPSHOT/maven-metadata.xml.sha256

@@ -0,0 +1 @@
+a0599893bc9711329ac77c5aa07bbcb93b1740946028d1f5a87050371b4b63444839cbcff937f454f3906c48b8e40b2c3e191ce24e816546b71c615dd60717d0