Improvements to baseline based on porting exercise

.github/workflows/input-validation.yml

@@ -127,14 +127,20 @@ jobs:
           restore-keys: |
             cn1-binaries-${{ runner.os }}-
 
+      # Use the exact key build-port saved against (published as a job
+      # output). Recomputing the src_hash on this runner has been
+      # observed to produce a different value than build-port on the
+      # same SHA -- and even when the algorithm is identical, any new
+      # source path added to the hash here has to land in three
+      # places at once or the keys diverge.
       - name: Restore built CN1 + iOS port artifacts
         uses: actions/cache/restore@v4
         with:
           path: |
             ~/.m2/repository/com/codenameone
             Themes
             Ports/iOSPort/nativeSources
-          key: cn1-built-${{ runner.os }}-${{ steps.src_hash.outputs.hash }}
+          key: ${{ needs.build-port.outputs.cn1_built_cache_key }}
           fail-on-cache-miss: true
 
       - name: Install XcodeGen

.github/workflows/parparvm-tests.yml

@@ -71,7 +71,7 @@ jobs:
       - name: Set up JDK 25
         uses: actions/setup-java@v4
         with:
-          distribution: 'zulu'
+          distribution: 'temurin'
           java-version: '25'
       - name: Save JDK 25 Path
         run: echo "JDK_25_HOME=$JAVA_HOME" >> $GITHUB_ENV

.github/workflows/scripts-android.yml

@@ -113,7 +113,7 @@ jobs:
         uses: actions/setup-java@v4
         with:
           java-version: ${{ matrix.java_version }}
-          distribution: 'zulu'
+          distribution: 'temurin'
       - name: Set JDK_HOME
         if: matrix.id != 'default'
         run: echo "JDK_HOME=${JAVA_HOME}" >> $GITHUB_ENV

.github/workflows/scripts-javascript.yml

@@ -87,7 +87,7 @@ jobs:
       - name: Set up Java 8 for ParparVM
         uses: actions/setup-java@v4
         with:
-          distribution: 'zulu'
+          distribution: 'temurin'
           java-version: '8'
           cache: 'maven'
 
@@ -102,7 +102,7 @@ jobs:
       - name: Set up Java 17
         uses: actions/setup-java@v4
         with:
-          distribution: 'zulu'
+          distribution: 'temurin'
           java-version: '17'
           cache: 'maven'
 

.github/workflows/scripts-javase.yml

@@ -40,7 +40,7 @@ jobs:
         uses: actions/setup-java@v4
         with:
           java-version: '8'
-          distribution: 'zulu'
+          distribution: 'temurin'
 
       - name: Set TMPDIR
         run: echo "TMPDIR=${{ runner.temp }}" >> "$GITHUB_ENV"

CodenameOne/src/com/codename1/annotations/rest/Body.java

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// Marks an interface method parameter as the request body. The
+/// processor serialises the argument via `Mappers.toJson(...)` and
+/// attaches it with `Content-Type: application/json`. At most one
+/// `@Body`-annotated parameter is allowed per method.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.PARAMETER)
+public @interface Body {
+}

CodenameOne/src/com/codename1/annotations/rest/Cookie.java

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// Binds an interface method parameter to a `Cookie` request-header
+/// entry. Multiple `@Cookie`-annotated parameters on the same method
+/// are joined into a single `Cookie: a=1; b=2` header. `null`
+/// arguments are skipped; values are URL-encoded.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.PARAMETER)
+public @interface Cookie {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/DELETE.java

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// HTTP `DELETE` request. See [GET] for path semantics.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.METHOD)
+public @interface DELETE {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/GET.java

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// HTTP `GET` request. The value is the URL path relative to the
+/// `baseUrl` passed to `<Tag>Api.of(baseUrl)`. Path placeholders such
+/// as `/pet/{petId}` are substituted from method parameters annotated
+/// with [Path].
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.METHOD)
+public @interface GET {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/Header.java

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// Binds an interface method parameter to an HTTP request header.
+/// `null` argument values skip the header. `Authorization` is the
+/// usual carrier for the bearer token argument emitted by
+/// `cn1:generate-openapi`.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.PARAMETER)
+public @interface Header {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/PATCH.java

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// HTTP `PATCH` request. See [GET] for path semantics.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.METHOD)
+public @interface PATCH {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/POST.java

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// HTTP `POST` request. See [GET] for path semantics.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.METHOD)
+public @interface POST {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/PUT.java

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// HTTP `PUT` request. See [GET] for path semantics.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.METHOD)
+public @interface PUT {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/Path.java

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// Binds an interface method parameter to a `{name}` placeholder in
+/// the URL path declared on the verb annotation. The parameter value
+/// is URL-encoded before substitution.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.PARAMETER)
+public @interface Path {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/Query.java

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ */
+package com.codename1.annotations.rest;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/// Binds an interface method parameter to a URL query-string entry.
+/// `null` arguments are skipped; collections are appended as repeated
+/// `name=value` pairs.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.PARAMETER)
+public @interface Query {
+    String value();
+}

CodenameOne/src/com/codename1/annotations/rest/RestClient.java

@@ -0,0 +1,31 @@
+/*
+ * Copyright (c) 2026, Codename One and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Codename One designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ */
+package com.codename1.annotations.rest;
+
+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 REST client that the build-time
+/// annotation processor wires up to a generated network implementation.
+/// Companion HTTP-verb annotations ([GET], [POST], [PUT], [DELETE],
+/// [PATCH]) on each method carry the path; parameter annotations
+/// ([Path], [Query], [Header], [Body]) describe how each argument is
+/// attached to the request.
+///
+/// The processor emits a `<Tag>ApiImpl` class in generated-sources and
+/// registers it with [com.codename1.io.rest.RestClients] so the
+/// interface's `static T of(String baseUrl)` factory can return an
+/// instance without the project source referencing the impl directly.
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.TYPE)
+public @interface RestClient {
+}