Implement wams-spring-shell.

Author: fniephaus

.github/workflows/native-image-wasm-spring-shell.yml

@@ -0,0 +1,43 @@
+name: native-image/wasm-spring-shell
+on:
+  push:
+    paths:
+      - 'native-image/wasm-spring-shell/**'
+      - '.github/workflows/native-image-wasm-spring-shell.yml'
+  pull_request:
+    paths:
+      - 'native-image/wasm-spring-shell/**'
+      - '.github/workflows/native-image-wasm-spring-shell.yml'
+  schedule:
+    - cron: "0 0 1 * *" # run every month
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  run:
+    name: Run 'native-image/wasm-spring-shell'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - name: Download GraalVM 25.1 EA builds
+        run: curl -sL -o $RUNNER_TEMP/graalvm-jdk-25e1-linux-amd64.tar.gz https://github.com/graalvm/oracle-graalvm-ea-builds/releases/download/jdk-25e1-25.0.0-ea.01/graalvm-jdk-25e1-25.0.0-ea.01_linux-x64_bin.tar.gz
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '25'
+          distribution: 'jdkfile'
+          jdkFile: ${{ runner.temp }}/graalvm-jdk-25e1-linux-amd64.tar.gz
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Set up Binaryen
+        run: |
+          curl -sLO https://github.com/WebAssembly/binaryen/releases/download/version_122/binaryen-version_122-x86_64-linux.tar.gz
+          tar xzf binaryen-version_122-x86_64-linux.tar.gz
+          echo "$(pwd)/binaryen-version_122/bin" >> "$GITHUB_PATH"
+      - name: Run 'native-image/wasm-spring-shell'
+        run: |
+          cd native-image/wasm-spring-shell
+          ./mvnw --no-transfer-progress -Pnative package
+          node target/wasm-spring-shell help
+          node target/wasm-spring-shell hello Jane

native-image/wasm-spring-shell/README.md

@@ -0,0 +1,27 @@
+# Compile Spring Shell into a Wasm Module
+
+This demo illustrates how to use GraalVM Web Image to compile a Spring Shell application into a Wasm module that can then run on the command-line or in the browser. [Check out the live demo here](https://graalvm.github.io/graalvm-demos/native-image/wasm-spring-shell/).
+
+## Prerequisites
+
+This demo requires:
+
+1. This [Early Access Build](https://github.com/graalvm/oracle-graalvm-ea-builds/releases/tag/jdk-25e1-25.0.0-ea.01) of Oracle GraalVM 25.1 or later.
+2. The [Binaryen toolchain](https://github.com/WebAssembly/binaryen) in version 119 or later and on the system path.
+    For example, using Homebrew: `brew install binaryen`
+
+## Run Spring Shell on Node
+
+1. Build the Wasm module with the `native` profile:
+    ```bash
+    $ ./mvnw -Pnative package
+    ```
+    The demo uses the [Native Build Tools](https://graalvm.github.io/native-build-tools/latest/index.html) for building native images with GraalVM and Maven.
+    This command generates a Wasm file and a corresponding JavaScript binding in the `target` directory.
+
+2. Run the Wasm module on Node:
+    ```bash
+    node target/wasm-spring-shell help
+    node target/wasm-spring-shell hello Jane
+    ```
+    This requires Node.js 22 or later.

native-image/wasm-spring-shell/pom.xml

@@ -64,6 +64,17 @@
 			<plugin>
 				<groupId>org.graalvm.buildtools</groupId>
 				<artifactId>native-maven-plugin</artifactId>
+                <configuration>
+                    <buildArgs>
+                        <!-- Enable Web Image -->
+                        <buildArg>--tool:svm-wasm</buildArg>
+                        <!-- Annotate Wasm module with debug info -->
+                        <buildArg>-g</buildArg>
+                        <!-- macOS-specific initialization policies -->
+                        <buildArg>--initialize-at-build-time=apple.security.AppleProvider</buildArg>
+                        <buildArg>--initialize-at-build-time=apple.security.AppleProvider$ProviderService</buildArg>
+                    </buildArgs>
+                </configuration>
 			</plugin>
 			<plugin>
 				<groupId>org.springframework.boot</groupId>

native-image/wasm-spring-shell/src/main/java/com/example/wasm_spring_shell/MyCommands.java

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2025, Oracle and/or its affiliates.
+ *
+ * Licensed under the Universal Permissive License v 1.0 as shown at https://opensource.org/license/UPL.
+ */
+
+package com.example.wasm_spring_shell;
+
+import org.springframework.shell.standard.ShellComponent;
+import org.springframework.shell.standard.ShellMethod;
+import org.springframework.shell.standard.ShellOption;
+
+@ShellComponent
+public class MyCommands {
+
+    @ShellMethod(key = "hello")
+    public String hello(@ShellOption(defaultValue = "Spring") String arg) {
+        return "Hello " + arg + " from WebAssembly built with GraalVM!";
+    }
+    
+}

native-image/wasm-spring-shell/src/main/java/com/example/wasm_spring_shell/WasmSpringShellApplication.java

@@ -1,6 +1,14 @@
+/*
+ * Copyright (c) 2025, Oracle and/or its affiliates.
+ *
+ * Licensed under the Universal Permissive License v 1.0 as shown at https://opensource.org/license/UPL.
+ */
+
 package com.example.wasm_spring_shell;
 
 import org.springframework.boot.SpringApplication;
+import org.springframework.boot.ansi.AnsiOutput;
+import org.springframework.boot.ansi.AnsiOutput.Enabled;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 
 @SpringBootApplication
@@ -10,4 +18,9 @@ public static void main(String[] args) {
 		SpringApplication.run(WasmSpringShellApplication.class, args);
 	}
 
+    static {
+        /* Always enable colorful terminal output. */
+        AnsiOutput.setEnabled(Enabled.ALWAYS);
+    }
+
 }

native-image/wasm-spring-shell/src/test/java/com/example/wasm_spring_shell/WasmSpringShellApplicationTests.java

@@ -1,3 +1,9 @@
+/*
+ * Copyright (c) 2025, Oracle and/or its affiliates.
+ *
+ * Licensed under the Universal Permissive License v 1.0 as shown at https://opensource.org/license/UPL.
+ */
+
 package com.example.wasm_spring_shell;
 
 import org.junit.jupiter.api.Test;