Add package-info.java files generated from package.html so Java 25 Javadoc picks up package docs

[shai-almog]

Motivation

• Java 25's Javadoc no longer picks up legacy package.html files, so package-level documentation must be provided as package-info.java to be included in modern Javadoc output.
• Preserve the existing package documentation and any leading license/header comments for many packages across the repository so API docs remain complete.
• Cover the main code areas that ship Javadoc: core CodenameOne sources plus CodenameOneDesigner and the Ports/J2ME packages.

Description

• Added generated package-info.java files (64 files created) under CodenameOne/src, CodenameOneDesigner/src and Ports/J2ME/src to replace/represent the prior package.html content.
• The generator converts package.html content into a Javadoc-style /** ... */ comment block and, when present, preserves preamble HTML license comments as a /* ... */ block at the top of the file.
• Each generated file ends with the appropriate package <pkg.name>; declaration inferred from the file path so the docs are attached to the correct package.

Testing

• Executed a local generation script which produced 64 package-info.java files and verified the script completed successfully.
• Spot-checked several generated files including CodenameOne/src/com/codename1/ui/package-info.java and CodenameOne/src/com/codename1/javascript/package-info.java to confirm the Javadoc block, preserved license header, and package declaration are present.
• No unit tests or CI Javadoc build were run as part of this change; this is a documentation-source change intended to enable upstream Javadoc runs with Java 25.

---

Codex Task

[github-actions]

✅ Continuous Quality Report

Test & Coverage

• ✅ Tests: 2283 total, 0 failed, 0 skipped
• 📊 Line coverage: 52.80% [HTML preview] [Download]
  • Lowest covered classes
    • com.codename1.io.rest.RequestBuilder$FetchAsPropertyListActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$FetchAsPropertiesActionListener – 0.00%
    • com.codename1.ui.Display$EdtException – 0.00%
    • com.codename1.ui.BrowserWindow$BrowserForm – 0.00%
    • com.codename1.ui.plaf.CSSBorder$LinearGradient – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsStringAsyncImplActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsJsonMapActionListener – 0.00%
    • com.codename1.payment.Purchase$SynchronizeReceiptsSyncRunnable – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsBytesAsyncImplActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$FetchAsJsonMapActionListener – 0.00%

Static Analysis

• ✅ SpotBugs: 0 findings (no issues) [Report archive]
• ✅ PMD: 0 findings (no issues) [Report archive]
• ❌ Checkstyle: 112 findings (Error: 112) [HTML preview] [Download]
  • Top findings
    • Error: CodenameOne/src/com/codename1/javascript/JSFunction.java:1 – File does not end with a newline. (rule: NewlineAtEndOfFileCheck)
    • Error: CodenameOne/src/com/codename1/javascript/JSException.java:1 – File does not end with a newline. (rule: NewlineAtEndOfFileCheck)
    • Error: CodenameOne/src/com/codename1/annotations/Async.java:1 – File does not end with a newline. (rule: NewlineAtEndOfFileCheck)
    • Error: CodenameOne/src/com/codename1/io/tar/TarEntry.java:1 – File does not end with a newline. (rule: NewlineAtEndOfFileCheck)
    • Error: CodenameOne/src/com/codename1/io/tar/TarHeader.java:1 – File does not end with a newline. (rule: NewlineAtEndOfFileCheck)
    • …and 107 more

Generated automatically by the PR CI workflow.

[shai-almog]

Compared 30 screenshots: 30 matched.

Native Android coverage

• 📊 Line coverage: 24.87% (2665/10717 lines covered) [HTML preview] (artifact android-coverage-report, jacocoAndroidReport/html/index.html)
  • Other counters: instruction 24.48% (12367/50528), branch 15.37% (718/4672), complexity 17.57% (745/4241), method 33.08% (602/1820), class 34.98% (106/303)
  • Lowest covered classes
    • com.codename1.impl.android.com.codename1.impl.android.AndroidContactsManager – 0.00% (0/400 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.AndroidImplementation$Video – 0.00% (0/168 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.IntentIntegrator – 0.00% (0/139 lines covered)
    • com.codename1.impl.android.util.com.codename1.impl.android.util.Base64 – 0.00% (0/117 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.AndroidImplementation$SocketImpl – 0.00% (0/77 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.AndroidTextureView – 0.00% (0/76 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.AndroidSurfaceView – 0.00% (0/73 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.LocalNotificationPublisher – 0.00% (0/65 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.FridaDetectionUtil – 0.00% (0/64 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.PushNotificationService – 0.00% (0/59 lines covered)

✅ Native Android screenshot tests passed.

Native Android coverage

• 📊 Line coverage: 24.87% (2665/10717 lines covered) [HTML preview] (artifact android-coverage-report, jacocoAndroidReport/html/index.html)
  • Other counters: instruction 24.48% (12367/50528), branch 15.37% (718/4672), complexity 17.57% (745/4241), method 33.08% (602/1820), class 34.98% (106/303)
  • Lowest covered classes
    • com.codename1.impl.android.com.codename1.impl.android.AndroidContactsManager – 0.00% (0/400 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.AndroidImplementation$Video – 0.00% (0/168 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.IntentIntegrator – 0.00% (0/139 lines covered)
    • com.codename1.impl.android.util.com.codename1.impl.android.util.Base64 – 0.00% (0/117 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.AndroidImplementation$SocketImpl – 0.00% (0/77 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.AndroidTextureView – 0.00% (0/76 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.AndroidSurfaceView – 0.00% (0/73 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.LocalNotificationPublisher – 0.00% (0/65 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.FridaDetectionUtil – 0.00% (0/64 lines covered)
    • com.codename1.impl.android.com.codename1.impl.android.PushNotificationService – 0.00% (0/59 lines covered)

[shai-almog]

iOS screenshot updates

Compared 28 screenshots: 17 matched, 6 updated, 1 missing reference, 4 errors.

• BrowserComponent — updated screenshot. Screenshot differs (1206x2622 px, bit depth 8).

  
  Preview info: Preview provided by instrumentation.
  Full-resolution PNG saved as BrowserComponent.png in workflow artifacts.

• graphics-draw-arc — updated screenshot. Screenshot differs (1206x2622 px, bit depth 8).

  
  Preview info: JPEG preview quality 20; JPEG preview quality 20; downscaled to 603x1311.
  Full-resolution PNG saved as graphics-draw-arc.png in workflow artifacts.

• graphics-draw-gradient — updated screenshot. Screenshot differs (1206x2622 px, bit depth 8).

  
  Preview info: JPEG preview quality 10; JPEG preview quality 10; downscaled to 844x1835.
  Full-resolution PNG saved as graphics-draw-gradient.png in workflow artifacts.

• graphics-draw-round-rect — missing reference. Reference screenshot missing at /Users/runner/work/CodenameOne/CodenameOne/scripts/ios/screenshots/graphics-draw-round-rect.png.

  
  Preview info: JPEG preview quality 10; JPEG preview quality 10; downscaled to 844x1835.
  Full-resolution PNG saved as graphics-draw-round-rect.png in workflow artifacts.

• graphics-draw-string — updated screenshot. Screenshot differs (1206x2622 px, bit depth 8).

  
  Preview info: JPEG preview quality 10; JPEG preview quality 10; downscaled to 422x918.
  Full-resolution PNG saved as graphics-draw-string.png in workflow artifacts.

• graphics-draw-string-decorated — updated screenshot. Screenshot differs (1206x2622 px, bit depth 8).

  
  Preview info: JPEG preview quality 10; JPEG preview quality 10; downscaled to 603x1311.
  Full-resolution PNG saved as graphics-draw-string-decorated.png in workflow artifacts.

• graphics-tile-image — comparison error. Comparison error: PNG chunk truncated before CRC while processing: /Users/runner/work/_temp/cn1-ios-tests-b7Vet6/graphics-tile-image.png

  No preview available for this screenshot.
  Full-resolution PNG saved as graphics-tile-image.png in workflow artifacts.

• graphics-transform-perspective — comparison error. Comparison error: PNG chunk truncated before CRC while processing: /Users/runner/work/_temp/cn1-ios-tests-b7Vet6/graphics-transform-perspective.png

  No preview available for this screenshot.
  Full-resolution PNG saved as graphics-transform-perspective.png in workflow artifacts.

• graphics-transform-rotation — comparison error. Comparison error: PNG chunk truncated before CRC while processing: /Users/runner/work/_temp/cn1-ios-tests-b7Vet6/graphics-transform-rotation.png

  No preview available for this screenshot.
  Full-resolution PNG saved as graphics-transform-rotation.png in workflow artifacts.

• graphics-transform-translation — comparison error. Comparison error: PNG chunk truncated before CRC while processing: /Users/runner/work/_temp/cn1-ios-tests-b7Vet6/graphics-transform-translation.png

  No preview available for this screenshot.
  Full-resolution PNG saved as graphics-transform-translation.png in workflow artifacts.

• kotlin — updated screenshot. Screenshot differs (1206x2622 px, bit depth 8).

  
  Preview info: Preview provided by instrumentation.
  Full-resolution PNG saved as kotlin.png in workflow artifacts.

Benchmark Results

• VM Translation Time: 405 seconds
• Compilation Time: 457 seconds

Detailed Performance Metrics

Metric	Duration
Build Time Statistics
Setup & Unzip	40132 ms
Extract Extensions	14 ms
Google Services Setup	2 ms
Scan Classes	685 ms
Extract Libs	1510 ms
Inject Build Hints	49 ms
Generate Unit Tests	3 ms
Generate Stubs	1351 ms
Compile Stubs	2558 ms
Generate Icons	1136 ms
Prepare ParparVM	196 ms
ParparVM Execution	232770 ms
Post-VM Setup	169 ms
CocoaPods	7275 ms
Finalize	96 ms
Total Time	287948 msMaven Overhead : 118000 ms
CocoaPods Install (Script)	2000 ms
Simulator Boot	284000 ms
Simulator Boot (Run)	4000 ms
App Install	22000 ms
App Launch	31000 ms
Test Execution	253000 ms