Support Module Import Declarations (JEP 476, JDK 23)

[sebastiaanspeck]

Consider the following code:

// this will import e.g. all the classes from package java.util, java.util.stream, java.io, java.lang, java.nio.file
import module java.base;

When trying to use google-java-format 1.24.0, this results in: com.google.googlejavaformat.java.FormatterException: 2:1: error: expected token: 'module'; generated java instead

[cushon]

Note that this is currently a preview feature, there's a draft JEP to finalize the feature in Java 25: https://openjdk.org/jeps/8344700

[sormuras]

I wonder where GJF will put import MODULE; declarations in relation to the static and non-static block as described in https://google.github.io/styleguide/javaguide.html#s3.3-import-statements

3.3.3 Ordering and spacing
Imports are ordered as follows:

1. All static imports in a single block.
2. All non-static imports in a single block.

If there are both static and non-static imports, a single blank line separates the two blocks. There are no other blank lines between import statements.

[sormuras]

Finalized as "JEP 511: Module Import Declarations" in Java 25.

[cushon]

The style guide update for module imports is still TBD, but that should happen in time for the Java 25 GA.

It's possible it will discourage module imports in favor of single-type imports (similar to how wildcard imports are already discouraged).

But either way, google-java-format should support the syntax for files that use it.