*/
  public static DiscreteDomain<Integer> integers() {
    return IntegerDomain.INSTANCE;
  }

  private static final class IntegerDomain extends DiscreteDomain<Integer> implements Serializable {
    private static final IntegerDomain INSTANCE = new IntegerDomain();

    IntegerDomain() {
      super(true);
    }

    @Override
    public @Nullable Integer next(Integer value) {

 * to prevent them from being treated as critical errors.
 */
@Plugin(name = "ErrorToWarnRewritePolicy", category = Core.CATEGORY_NAME, elementType = "rewritePolicy", printObject = true)
public class ErrorToWarnRewritePolicy implements RewritePolicy {

    /** Array of logger name prefixes to apply the ERROR to WARN conversion */
    private final String[] loggerNames;

    /**

 *
 * BufferedReader reader = ...;
 * for (String line : iterable(reader)) {
 *     ...
 * }
 * </pre>
 *
 * @author koichik
 */
public class LineIterator implements Iterator<String> {

    /** String object indicating that {@link #line} is empty */
    protected static final String EMPTY = new String();

    /** {@link BufferedReader} */
    protected final BufferedReader reader;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * Test class for SMB file locking operations.
 * This class is used to test concurrent file access and locking behavior.
 */
public class TestLocking implements Runnable {

    private static final Logger logger = LoggerFactory.getLogger(TestLocking.class);

    /**
     * Default constructor for TestLocking
     */
    public TestLocking() {

import org.apache.maven.model.ActivationOS;
import org.apache.maven.model.Profile;
import org.apache.maven.utils.Os;

/**
 * OperatingSystemProfileActivator
 */
@Deprecated
public class OperatingSystemProfileActivator implements ProfileActivator {

    @Override
    public boolean canDetermineActivation(Profile profile) {
        Activation activation = profile.getActivation();
        return activation != null && activation.getOs() != null;

import org.apache.maven.artifact.repository.layout.ArtifactRepositoryLayout2;

/**
 */
@Named
@Singleton
@Deprecated
public class DefaultArtifactRepositoryFactory implements ArtifactRepositoryFactory {
    // TODO use settings?
    private String globalUpdatePolicy;

    private String globalChecksumPolicy;

    @Inject

        public ArtifactInstallerRequest build() {
            return new DefaultArtifactInstallerRequest(session, trace, artifacts);
        }

        static class DefaultArtifactInstallerRequest extends BaseRequest<Session> implements ArtifactInstallerRequest {

            private final Collection<ProducedArtifact> artifacts;

            DefaultArtifactInstallerRequest(
                    @Nonnull Session session,

/**
 * A stub implementation that assumes an empty lifecycle to bypass interaction with the plugin manager and to avoid
 * plugin artifact resolution from repositories.
 *
 */
@Deprecated
public class EmptyLifecycleExecutor implements LifecycleExecutor {

    @Override
    public MavenExecutionPlan calculateExecutionPlan(MavenSession session, String... tasks) {
        return new MavenExecutionPlan(null, new DefaultLifecycles());
    }

Então vamos usar esse mesmo conhecimento para documentar como a *API externa* deveria ser... criando as *operações de rota* que a *API externa* deveria implementar (as que sua API irá chamar).

/// tip | Dica

import org.jspecify.annotations.NullMarked;

/**
 * Create string sets for collection tests.
 *
 * @author Kevin Bourrillion
 */
@GwtCompatible
@NullMarked
public abstract class TestStringSetGenerator implements TestSetGenerator<String> {
  @Override
  public SampleElements<String> samples() {
    return new Strings();
  }

  @Override
  public Set<String> create(Object... elements) {