- name: Export Language Codes
        id: show-langs
        run: |
          echo "langs=$(python ./scripts/docs.py langs-json)" >> $GITHUB_OUTPUT

  build-docs:
    needs:
      - changes
      - langs
    if: ${{ needs.changes.outputs.docs == 'true' }}
    runs-on: ubuntu-latest
    strategy:
      matrix:
        lang: ${{ fromJson(needs.langs.outputs.langs) }}
    steps:
      - name: Dump GitHub context

        final Normalizer normalizer;
        if (langs == null || langs.length == 0) {
            normalizer = new LangAnalyzerNormalizer(null);
        } else {
            final NormalizerChain chain = new NormalizerChain();
            for (final String lang : langs) {
                chain.add(new LangAnalyzerNormalizer(lang));
            }
            normalizer = chain;

public interface Normalizer {
    /**
     * Normalizes the given text.
     * @param text The text to normalize
     * @param field The field name
     * @param langs The language
     * @return The normalized text
     */
    String normalize(String text, String field, String... langs);

        final ReadingConverter converter;
        if (langs == null || langs.length == 0) {
            converter = new LangAnalyzerConverter(null);
        } else {
            final ReadingConverterChain chain = new ReadingConverterChain();
            for (final String lang : langs) {
                chain.addConverter(new LangAnalyzerConverter(lang));

     * @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.
     */
    List<String> convert(String text, final String field, String... langs) throws IOException;

    List<Normalizer> normalizers = new ArrayList<>();

    @Override
    public String normalize(final String text, final String field, final String... langs) {
        String tmp = text;
        for (final Normalizer normalizer : normalizers) {
            tmp = normalizer.normalize(tmp, field, langs);
        }
        return tmp;
    }

    /**
     * Adds a normalizer to the chain.
     * @param normalizer The normalizer to add.

     * @param normalizer the normalizer to use for normalizing the search words
     * @param analyzer the analyzer to use for analyzing the search words
     * @param langs the array of languages associated with the search words
     * @return a SuggestItem created from the given search words and associated data
     */

     * It should initialize the command and flags2 with default values.
     */
    @Test
    void testConstructor() {
        // Verify that the command is set to SMB_COM_NEGOTIATE
        assertEquals(ServerMessageBlock.SMB_COM_NEGOTIATE, smbComNegotiate.command,
                "Constructor should set the command to SMB_COM_NEGOTIATE.");
        // Verify that flags2 is set to the default flags

                path = readString(buffer, start + pathOffset, len, (flags2 & FLAGS2_UNICODE) != 0);
                if (nodeOffset > 0) {
                    node = readString(buffer, start + nodeOffset, len, (flags2 & FLAGS2_UNICODE) != 0);
                }
            } else if (version == 1) {
                node = readString(buffer, bufferIndex, len, (flags2 & FLAGS2_UNICODE) != 0);
            }

            return size;

    }

    /**
     * Verifies reset() clears flags2 and updates resumeKey and filename used for parameters.
     */
    @Test
    void testResetUpdatesStateAndParameters() {
        // Given
        Trans2FindNext2 next = new Trans2FindNext2(0x0001, 0x0AAA0BBB, "old");
        next.flags2 = 0xFFFF; // simulate non-zero flags2

        // When
        next.reset(0x11121314, "last.dat");