Begin splitting the Java artifact into components

* The Loader API lives under java/api.
* The current native endpoint for the Prism shared library lives
  under java/native.
* The WASM build and binding lives under java/wasm.

The libraries will be released together but can be developed and
snapshotted independently. Users that copy the source from the
previous java/ will want to grab both java/api/src/main/java and
java/native/src/main/java contents.

Author: headius

.github/dependabot.yml

@@ -9,7 +9,7 @@ updates:
         patterns:
           - "*"
   - package-ecosystem: 'maven'
-    directory: '/java-wasm'
+    directory: '/java/wasm'
     schedule:
       interval: 'weekly'
     groups:

.github/workflows/java-wasm-bindings.yml

@@ -8,7 +8,7 @@ on:
       - "src/"
       - "*akefile*"
       - "java/"
-      - "java-wasm/"
+      - "java/wasm/"
     branches:
       - main
       - ruby-4.0
@@ -46,9 +46,9 @@ jobs:
 
       - name: Run the tests
         run: mvn -B install
-        working-directory: java-wasm
+        working-directory: java/wasm
 
       - uses: actions/upload-artifact@v7
         with:
           name: prism.wasm
-          path: java-wasm/src/test/resources/prism.wasm
+          path: java/wasm/src/test/resources/prism.wasm

.gitignore

@@ -42,7 +42,7 @@ out.svg
 /java/org/ruby_lang/prism/AbstractNodeVisitor.java
 /java/org/ruby_lang/prism/Loader.java
 /java/org/ruby_lang/prism/Nodes.java
-/java-wasm/src/test/resources/prism.wasm
+/java/wasm/src/test/resources/prism.wasm
 /lib/prism/compiler.rb
 /lib/prism/dispatcher.rb
 /lib/prism/dot_visitor.rb

Makefile

@@ -31,7 +31,7 @@ all: shared static
 shared: build/libprism.$(SOEXT)
 static: build/libprism.a
 wasm: javascript/src/prism.wasm
-java-wasm: java-wasm/src/test/resources/prism.wasm
+java-wasm: java/wasm/src/test/resources/prism.wasm
 
 build/libprism.$(SOEXT): $(SHARED_OBJECTS)
 	$(ECHO) "linking $@ with $(CC)"
@@ -51,7 +51,7 @@ javascript/src/prism.wasm: Makefile $(SOURCES) $(HEADERS)
 		-Oz -g0 -flto -fdata-sections -ffunction-sections \
 		-o $@ $(SOURCES)
 
-java-wasm/src/test/resources/prism.wasm: Makefile $(SOURCES) $(HEADERS)
+java/wasm/src/test/resources/prism.wasm: Makefile $(SOURCES) $(HEADERS)
 	$(ECHO) "building $@"
 	$(Q) $(MAKEDIRS) $(@D)
 	$(Q) $(WASI_SDK_PATH)/bin/clang \

README.md

@@ -29,8 +29,10 @@ The repository contains the infrastructure for both a shared library (libprism)
 ├── include
 │   ├── prism             header files for the shared library
 │   └── prism.h           main header file for the shared library
-├── java                  Java bindings for the shared library
-├── java-wasm             Java WASM bindings for the shared library
+├── java
+|   ├── api               Java API for Prism
+|   ├── native            Java native bindings for the shared library
+|   └── wasm              Java WASM bindings for the shared library
 ├── javascript            JavaScript WASM bindings for the shared library
 ├── lib
 │   ├── prism             Ruby library files

Rakefile

@@ -54,7 +54,7 @@ end
 CLOBBER.concat(Prism::Template::TEMPLATES)
 CLOBBER.concat(["build"])
 CLOBBER << "lib/prism/prism.#{RbConfig::CONFIG["DLEXT"]}"
-CLOBBER << "java-wasm/src/main/resources/prism.wasm"
+CLOBBER << "java/wasm/src/main/resources/prism.wasm"
 
 Prism::Template::TEMPLATES.each do |filepath|
   desc "Generate #{filepath}"

java-wasm/pom.xml

@@ -0,0 +1,4 @@
+api/target
+native/target
+wasm/target
+.idea

java/.gitignore

@@ -0,0 +1,25 @@
+# Prism Java API and bindings
+
+This is the top-level project for the Java API and backend bindings for the Prism Ruby language parser.
+
+* api/ contains the API
+* native/ contains a native binding for the Prism shared library
+* wasm/ contains a Chicory-based WASM build and binding
+
+## Updating versions
+
+Run the following command to update all module versions:
+
+```
+mvn versions:set -DnewVersion=1.2.3-SNAPSHOT
+```
+
+## Releasing
+
+Snapshots can be deployed with `mvn deploy` while the versions are `-SNAPSHOT`.
+
+When releasing to Maven Central, all projects should be released together using the `release` profile:
+
+```
+mvn clean deploy -Prelease
+```