Initial work on the new JavaScript port

.github/workflows/parparvm-tests.yml

@@ -4,13 +4,15 @@ on:
   pull_request:
     paths:
       - 'vm/**'
+      - 'Ports/JavaScriptPort/**'
       - '!vm/**/README.md'
       - '!vm/**/readme.md'
       - '!vm/**/docs/**'
   push:
     branches: [ master, main ]
     paths:
       - 'vm/**'
+      - 'Ports/JavaScriptPort/**'
       - '!vm/**/README.md'
       - '!vm/**/readme.md'
       - '!vm/**/docs/**'
@@ -79,6 +81,11 @@ jobs:
           java-version: '8'
           cache: 'maven'
 
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
       - name: Run ParparVM JVM tests
         working-directory: vm
         run: mvn -B clean package -pl JavaAPI -am -DskipTests && mvn -B test -pl tests -am -DexcludedGroups=benchmark

.github/workflows/pr.yml

@@ -75,6 +75,11 @@ jobs:
           key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
           restore-keys: |
             ${{ runner.os }}-m2
+      - name: Set up Node
+        if: ${{ matrix.java-version == 8 }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
       - name: Run Unit Tests
         run: |
           MVN_ARGS=""
@@ -113,6 +118,10 @@ jobs:
       - name: Run SpotBugs for ByteCodeTranslator
         if: ${{ matrix.java-version == 8 }}
         run: mvn -B -DskipTests=true -f vm/ByteCodeTranslator/pom.xml verify
+      - name: Run JavaScript Port smoke integration
+        if: ${{ matrix.java-version == 8 }}
+        working-directory: vm
+        run: mvn -B test -pl tests -am -DfailIfNoTests=false -Dsurefire.failIfNoSpecifiedTests=false -Dtest=JavaScriptPortSmokeIntegrationTest
       - name: Generate static analysis HTML summaries
         if: ${{ always() && matrix.java-version == 8 }}
         env:

.github/workflows/scripts-javascript.yml

@@ -0,0 +1,137 @@
+name: Test JavaScript screenshot scripts
+
+on:
+  pull_request:
+    paths:
+      - '.github/workflows/scripts-javascript.yml'
+      - 'scripts/run-javascript-browser-tests.sh'
+      - 'scripts/run-javascript-screenshot-tests.sh'
+      - 'scripts/run-javascript-headless-browser.mjs'
+      - 'scripts/build-javascript-port-hellocodenameone.sh'
+      - 'scripts/javascript_browser_harness.py'
+      - 'scripts/javascript/screenshots/**'
+      - 'scripts/lib/cn1ss.sh'
+      - 'scripts/common/java/**'
+      - 'scripts/hellocodenameone/**'
+      - 'Ports/JavaScriptPort/**'
+      - 'vm/**'
+      - 'maven/**'
+      - '!maven/core-unittests/**'
+      - '!docs/**'
+  push:
+    branches: [ master ]
+    paths:
+      - '.github/workflows/scripts-javascript.yml'
+      - 'scripts/run-javascript-browser-tests.sh'
+      - 'scripts/run-javascript-screenshot-tests.sh'
+      - 'scripts/run-javascript-headless-browser.mjs'
+      - 'scripts/build-javascript-port-hellocodenameone.sh'
+      - 'scripts/javascript_browser_harness.py'
+      - 'scripts/javascript/screenshots/**'
+      - 'scripts/lib/cn1ss.sh'
+      - 'scripts/common/java/**'
+      - 'scripts/hellocodenameone/**'
+      - 'Ports/JavaScriptPort/**'
+      - 'vm/**'
+      - 'maven/**'
+      - '!maven/core-unittests/**'
+      - '!docs/**'
+
+jobs:
+  javascript-screenshots:
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+    runs-on: ubuntu-latest
+    env:
+      GITHUB_TOKEN: ${{ secrets.CN1SS_GH_TOKEN }}
+      GH_TOKEN: ${{ secrets.CN1SS_GH_TOKEN }}
+      ARTIFACTS_DIR: ${{ github.workspace }}/artifacts/javascript-ui-tests
+      CN1_JS_TIMEOUT_SECONDS: "180"
+      CN1_JS_BROWSER_LIFETIME_SECONDS: "150"
+      CN1SS_SKIP_COVERAGE: "1"
+      CN1SS_FAIL_ON_MISMATCH: "1"
+      BROWSER_CMD: "node \"$GITHUB_WORKSPACE/scripts/run-javascript-headless-browser.mjs\""
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java 8 for ParparVM
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: '8'
+          cache: 'maven'
+
+      - name: Prepare Codename One binaries for Maven plugin
+        run: |
+          mkdir -p ~/.codenameone
+          cp maven/UpdateCodenameOne.jar ~/.codenameone/
+
+      - name: Build ParparVM compiler bundle
+        run: mvn -B -f maven/pom.xml -pl parparvm -am -DskipTests -Dmaven.javadoc.skip=true package
+
+      - name: Set up Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: '17'
+          cache: 'maven'
+
+      - name: Set up Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Playwright Chromium
+        run: |
+          cd scripts
+          npm init -y 2>/dev/null || true
+          npm install playwright
+          npx playwright install --with-deps chromium
+
+      - name: Install Xvfb for headless Java AWT
+        run: sudo apt-get update && sudo apt-get install -y xvfb
+
+      - name: Setup workspace
+        run: xvfb-run ./scripts/setup-workspace.sh -q -DskipTests
+
+      - name: Build HelloCodenameOne JavaScript port bundle
+        run: |
+          # Use JAVA_HOME set by actions/setup-java for Java 17
+          # (JAVA_HOME_17_X64 is always available after setup-java@v4)
+          export JAVA_HOME="${JAVA_HOME_17_X64}"
+          export PATH="$JAVA_HOME/bin:$PATH"
+          echo "Using JAVA_HOME=$JAVA_HOME"
+          java -version
+
+          # xvfb-run is required for CSS compilation which uses java.awt
+          SKIP_PARPARVM_BUILD=1 xvfb-run ./scripts/build-javascript-port-hellocodenameone.sh "${GITHUB_WORKSPACE}/artifacts/javascript-ui-tests/hellocodenameone-javascript-port.zip"
+
+      - name: Locate JavaScript bundle
+        id: locate_bundle
+        run: |
+          set -euo pipefail
+          bundle="$(ls -1 \
+            artifacts/javascript-ui-tests/hellocodenameone-javascript-port.zip \
+            scripts/hellocodenameone/parparvm/target/hellocodenameone-javascript-port.zip \
+            2>/dev/null | head -n1 || true)"
+          if [ -z "$bundle" ]; then
+            echo "Unable to locate HelloCodenameOne JavaScript-port bundle" >&2
+            exit 1
+          fi
+          echo "bundle=$bundle" >> "$GITHUB_OUTPUT"
+
+      - name: Run JavaScript screenshot browser tests
+        run: |
+          mkdir -p "${ARTIFACTS_DIR}"
+          ./scripts/run-javascript-browser-tests.sh "${{ steps.locate_bundle.outputs.bundle }}" "${GITHUB_WORKSPACE}/scripts/javascript/screenshots"
+
+      - name: Upload JavaScript screenshot artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: javascript-ui-tests
+          path: artifacts/javascript-ui-tests
+          if-no-files-found: warn
+          retention-days: 14

.gitignore

@@ -96,3 +96,6 @@ dependency-reduced-pom.xml
 /docs/website/.venv-video-refresh/
 /docs/website/.youtube-oauth-token.json
 /docs/website/client_secret.json
+/.playwright-cli
+package-lock.json
+package.json

CodenameOne/src/com/codename1/ui/Graphics.java

@@ -36,7 +36,6 @@
 /// using either a paint callback or a mutable image. There is no supported  way to create this
 /// object directly.
 public final class Graphics {
-
     /// Rendering hint to indicate that the context should prefer to render
     /// primitives in a quick way, at the cost of quality, if there is an
     /// expensive operation.

Ports/JavaScriptPort/LICENSE.md

@@ -0,0 +1,6 @@
+JavaScriptPort and its dedicated fixtures are licensed under the PolyForm Noncommercial License 1.0.0.
+
+Official license text:
+[https://polyformproject.org/licenses/noncommercial/1.0.0/](https://polyformproject.org/licenses/noncommercial/1.0.0/)
+
+This license boundary applies to files inside `Ports/JavaScriptPort/**` unless a file states otherwise.

Ports/JavaScriptPort/NOTICE.md

@@ -0,0 +1,5 @@
+<!-- Licensed under the PolyForm Noncommercial License 1.0.0 -->
+
+This subtree is intentionally licensed separately from the parent Codename One repository.
+
+Files in `Ports/JavaScriptPort/**` are licensed under PolyForm Noncommercial 1.0.0 and must not inherit the parent repository's standard source-file license headers.

Ports/JavaScriptPort/README.md

@@ -0,0 +1,14 @@
+<!-- Licensed under the PolyForm Noncommercial License 1.0.0 -->
+
+JavaScriptPort is the browser-runtime work area for the new Codename One JavaScript port.
+
+Scope of this bootstrap:
+- imported HTML5/runtime code from the existing proprietary browser port as the behavioral/source baseline
+- PolyForm-licensed port boundary under `Ports/JavaScriptPort/**`
+- ParparVM-oriented smoke fixtures under `Ports/JavaScriptPort/tests/**`
+- executable translator/runtime coverage through the local ParparVM test suite in `vm/tests`
+
+License boundary:
+- `Ports/JavaScriptPort/**` is licensed under PolyForm Noncommercial 1.0.0
+- dedicated smoke fixtures under `Ports/JavaScriptPort/tests/**` use the same license boundary
+- the rest of the repository remains under its existing licensing

Ports/JavaScriptPort/STATUS.md

@@ -0,0 +1,75 @@
+<!-- Licensed under the PolyForm Noncommercial License 1.0.0 -->
+
+JavaScript Port Status (ParparVM)
+=================================
+
+The JavaScript port compiles Java bytecode to JavaScript via ParparVM
+(`vm/ByteCodeTranslator/`) and runs the app in a Web Worker against a host
+bridge on the main thread for DOM / Canvas access.
+
+Build
+-----
+
+```
+mvn -B -f maven/pom.xml -pl parparvm -am -DskipTests package
+SKIP_PARPARVM_BUILD=1 ./scripts/build-javascript-port-hellocodenameone.sh \
+    /tmp/hellocodenameone-js.zip
+```
+
+Test
+----
+
+```
+ARTIFACTS_DIR=/tmp/js-verify \
+    CN1_JS_TIMEOUT_SECONDS=300 CN1_JS_BROWSER_LIFETIME_SECONDS=280 \
+    BROWSER_CMD='node scripts/run-javascript-headless-browser.mjs' \
+    ./scripts/run-javascript-browser-tests.sh /tmp/hellocodenameone-js.zip \
+    scripts/javascript/screenshots
+```
+
+CI runs at 375×667 viewport with Playwright `deviceScaleFactor: 2` so the
+density picker lands on `DENSITY_VERY_HIGH` and screenshots come out 750×1334
+— phone-proportional to the iOS/Android baselines in `scripts/ios/screenshots`
+and `scripts/android/screenshots`.
+
+Screenshot baselines
+--------------------
+
+`scripts/javascript/screenshots/` holds the curated JS-port PNGs. They are
+platform-specific (iOS/Android references use the native themes and physical
+device DPIs; the JS port rasterises through `iOS7Theme.res` at headless
+Chromium). Regenerate via a full-suite run — artifacts under
+`$ARTIFACTS_DIR/*.png`.
+
+Known limitations
+-----------------
+
+- `graphics-transform-perspective.png` and `graphics-transform-camera.png`
+  render blank — perspective / 3D transforms aren't implemented in the JS
+  impl (`Transform.isPerspectiveSupported()` returns false). Matches iOS/Android
+  behaviour on older devices that also skip these paths.
+- `BrowserComponentScreenshotTest`, `MediaPlaybackScreenshotTest`,
+  `BytecodeTranslatorRegressionTest`, `BackgroundThreadUiAccessTest`,
+  `VPNDetectionAPITest`, `CallDetectionAPITest`,
+  `LocalNotificationOverrideTest`, `Base64NativePerformanceTest`, and
+  `AccessibilityTest` are intentionally time-limited in HTML5 mode via
+  `Cn1ssDeviceRunner.shouldForceTimeoutInHtml5`; their expected output is the
+  placeholder / spinner frame.
+- `OrientationLockScreenshotTest` is the last test in the suite because it
+  mutates orientation state that other tests don't reset.
+
+Entry points
+------------
+
+- `Ports/JavaScriptPort/src/main/java/com/codename1/impl/html5/HTML5Implementation.java`
+  — CN1 `CodenameOneImplementation` subclass.
+- `Ports/JavaScriptPort/src/main/webapp/port.js` — host-side bindings and
+  `bindCiFallback` shims.
+- `vm/ByteCodeTranslator/src/javascript/browser_bridge.js` — main-thread
+  host bridge handlers.
+- `vm/ByteCodeTranslator/src/javascript/worker.js` /
+  `vm/ByteCodeTranslator/src/javascript/parparvm_runtime.js` — worker-side VM.
+
+See `scripts/hellocodenameone/common/src/main/java/com/codenameone/examples/hellocodenameone/tests/Cn1ssDeviceRunner.java`
+for the suite contents and
+`scripts/run-javascript-headless-browser.mjs` for the Playwright harness.

Ports/JavaScriptPort/src/main/java/com/codename1/html5/interop/AsyncCallback.java

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2026 Codename One and contributors.
+ * Licensed under the PolyForm Noncommercial License 1.0.0.
+ */
+package com.codename1.html5.interop;
+
+/**
+ * Callback interface for async operations.
+ * This is a replacement for TeaVM's AsyncCallback.
+ */
+public interface AsyncCallback<T> {
+    void complete(T result);
+    void error(Throwable e);
+}

Ports/JavaScriptPort/src/main/java/com/codename1/html5/interop/SuppressSyncErrors.java

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2026 Codename One and contributors.
+ * Licensed under the PolyForm Noncommercial License 1.0.0.
+ */
+package com.codename1.html5.interop;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Annotation to suppress synchronization errors.
+ * This is a no-op stub for ParparVM builds.
+ * TeaVM uses this for its async/sync transformation.
+ */
+@Target({ElementType.METHOD, ElementType.TYPE})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface SuppressSyncErrors {
+}

Ports/JavaScriptPort/src/main/java/com/codename1/html5/js/JSBody.java

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2026 Codename One and contributors.
+ * Licensed under the PolyForm Noncommercial License 1.0.0.
+ */
+package com.codename1.html5.js;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Marks a method as implemented by inline JavaScript.
+ * For ParparVM, the script is executed via native binding mechanism.
+ */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface JSBody {
+    String[] params() default {};
+    String script() default "";
+}

Ports/JavaScriptPort/src/main/java/com/codename1/html5/js/JSFunctor.java

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Codename One and contributors.
+ * Licensed under the PolyForm Noncommercial License 1.0.0.
+ */
+package com.codename1.html5.js;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Marks an interface as a JavaScript function type.
+ * Used for callback interfaces that wrap JavaScript functions.
+ */
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface JSFunctor {
+}