}

    @Test
    @DisplayName("Iteration skips '.' and '..' and returns valid entries")
    void iterationSkipsDotAndDotDot() throws Exception {
        // Arrange
        stubAcquireReturnsSelf();
        FileEntry initial = entry("a");
        // Include entries that should be skipped by internal filter
        FileEntry[] page1 = new FileEntry[] { entry("."), entry(".."), entry("b") };

    }

    @Test
    @DisplayName("Messages: array is present and contains expected first entries")
    void dosErrorMessagesContainsExpectedTexts() {
        // Arrange & Act
        String[] msgs = DosError.DOS_ERROR_MESSAGES;

        // Assert
        assertNotNull(msgs);
        assertTrue(msgs.length >= 3, "Expect at least the first 3 entries present");
        assertEquals("The operation completed successfully.", msgs[0]);

/**
 * A bimap (or "bidirectional map") is a map that preserves the uniqueness of its values as well as
 * that of its keys. This constraint enables bimaps to support an "inverse view", which is another
 * bimap containing the same entries as this bimap but with reversed keys and values.
 *
 * <h3>Implementations</h3>
 *
 * <ul>
 *   <li>{@link ImmutableBiMap}
 *   <li>{@link HashBiMap}
 *   <li>{@link EnumBiMap}
 *   <li>{@link EnumHashBiMap}

import org.lastaflute.web.validation.theme.conversion.ValidateTypeFailure;

import jakarta.validation.constraints.Size;

/**
 * Form class for creating new elevate word configuration entries.
 * This form handles the creation of elevate word rules that boost
 * specific documents in search results when certain keywords are matched.
 */
public class CreateForm {

    /**

import jakarta.validation.constraints.Size;

/**
 * Form class for editing data crawling configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing data config entries,
 * including tracking information for optimistic locking and audit trails.
 * Data configs define how to crawl and extract data from databases, CSV files, and other data sources.
 *
 */

import jakarta.validation.constraints.Size;

/**
 * Form class for editing user groups in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing group entries,
 * including tracking information for optimistic locking and audit trails.
 * Groups are used to organize users and define access permissions.
 *
 */
public class EditForm extends CreateForm {

    /**

import jakarta.validation.constraints.Size;

/**
 * Form class for editing path mapping configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing path map entries,
 * including tracking information for optimistic locking and audit trails.
 * Path mappings are used to transform document URLs and paths during indexing and display.
 *
 */
public class EditForm extends CreateForm {

import jakarta.validation.constraints.Size;

/**
 * Form class for editing related content configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing related content entries,
 * including tracking information for optimistic locking and audit trails.
 * Related content configurations define relationships between documents for enhanced search results.
 *
 */

import jakarta.validation.constraints.Size;

/**
 * Form class for editing web authentication configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing web authentication entries,
 * including tracking information for optimistic locking and audit trails.
 * Web authentication configurations define credentials for accessing protected web resources during crawling.
 */

import jakarta.validation.constraints.Size;

/**
 * The edit form for Related Query.
 * This form extends CreateForm and adds fields necessary for editing existing related query entries.
 */
public class EditForm extends CreateForm {

    /** Unique identifier for the related query entry */
    @Required
    @Size(max = 1000)
    public String id;