Gradle's public API requires equal access from all JVM-based languages.
Kotlin, Groovy, Java, and other JVM-based languages should be able to use the Gradle API without relying on another language's standard library.

Historically, Gradle has shipped with some Groovy types in very prominent APIs.
This required the Kotlin DSL to add special integration to work with Groovy closures.
This has also forced plugins written in languages other than Groovy to use Groovy types for some APIs.

     */
    public void setRoles(final String[] roles) {
        this.roles = roles;
    }

    /**
     * Sets the languages of the suggest item.
     * @param languages The languages to set.
     */
    public void setLanguages(final String[] languages) {
        this.languages = languages;
    }

    /**
     * Sets the kinds of the suggest item.
     * @param kinds The kinds to set.
     */

        try {
            String[] languages = searchHelper.getLanguages(getMockRequest(), params);

            assertNotNull(languages);
            if (languages.length > 0) {
                // Note: The actual order might be different due to normalization
                boolean hasEn = false, hasJa = false;
                for (String lang : languages) {
                    if ("en".equals(lang))

    private final Normalizer normalizer;
    private final List<String> languages;
    private final float prefixMatchWeight;

    /**
     * Constructs a new SuggestQueryBuilder.
     *
     * @param readingConverter The reading converter.
     * @param normalizer The normalizer.
     * @param languages The list of languages.
     * @param prefixMatchWeight The prefix match weight.
     */

        this.skipDuplicateWords = skipDuplicateWords;
    }

    /**
     * Adds a language to filter by.
     * @param lang The language.
     */
    public void addLang(final String lang) {
        languages.add(lang);
    }

    @Override
    protected String getValidationError() {
        return null;
    }

                    "<script src=\"https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/languages/xml.min.js\"></script>" +
                    "<script src=\"https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/languages/kotlin.min.js\"></script>" +
                    "<script src=\"https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/languages/groovy.min.js\"></script>" +

      matrix:
        # Override automatic language detection by changing the below list
        # Supported options are ['csharp', 'cpp', 'go', 'java', 'javascript', 'python']
        language: ['java']
        # Learn more...
        # https://docs.github.com/en/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection

    steps:
    - name: Checkout repository

        SuggestItem item2 = createItemWithLanguages("text", "ja", "zh");

        SuggestItem merged = SuggestItemMerger.merge(item1, item2);

        String[] languages = merged.getLanguages();
        Set<String> langSet = new HashSet<>(Arrays.asList(languages));

        assertEquals(3, langSet.size());
        assertTrue(langSet.contains("en"));
        assertTrue(langSet.contains("ja"));

     */
    void init() throws IOException;

    /**
     * Converts the given text into a list of readings based on the specified field and languages.
     *
     * @param text the text to be converted.
     * @param field the field to be used for conversion.
     * @param langs the languages to be used for conversion.
     * @return a list of readings for the given text.
     * @throws IOException if an I/O error occurs during conversion.

      - id: generate-readme
        language: unsupported
        name: generate README.md from index.md
        entry: uv run ./scripts/docs.py generate-readme
        files: ^docs/en/docs/index\.md|docs/en/data/sponsors\.yml|scripts/docs\.py$
        pass_filenames: false

      - id: update-languages
        language: unsupported
        name: update languages
        entry: uv run ./scripts/docs.py update-languages