*     ranges 0..9, a..z and A..Z are always safe and should not be specified here)
   * @param plusForSpace true if ASCII space should be escaped to {@code +} rather than {@code %20}
   * @throws IllegalArgumentException if any of the parameters were invalid
   */
  public PercentEscaper(String safeChars, boolean plusForSpace) {
    // TODO(dbeaumont): Switch to static factory methods for creation now that class is final.

    return Primitives.wrap(type).cast(value);
  }

    private Object writeReplace() {
    return new SerializedForm<>(delegate());
  }

    private void readObject(ObjectInputStream stream) throws InvalidObjectException {
    throw new InvalidObjectException("Use SerializedForm");
  }

  /** Serialized form of the map, to avoid serializing the constraint. */

                    }
                    throw new FessUserNotFoundException(username);
                });
            } else {
                logger.warn("Password change not applied by authentication manager: username={}", username);
            }
        } catch (final FessUserNotFoundException e) {
            throw e;
        } catch (final Exception e) {

public class PagerCreatorTest extends UnitFessTestCase {

    private PagerCreator pagerCreator;
    private NamingConvention namingConvention;

    @Override
    protected void setUp(TestInfo testInfo) throws Exception {
        super.setUp(testInfo);
        namingConvention = new MockNamingConvention();
        pagerCreator = new PagerCreator(namingConvention);
    }

    // Test constructor initialization
    @Test

     *
     * @param format the format name
     * @return the formatter instance
     * @throws IllegalArgumentException if the format is null, empty, or not supported
     */
    protected IndexExportFormatter createFormatter(final String format) {
        if (format == null || format.trim().isEmpty()) {
            throw new IllegalArgumentException("Export format must not be null or empty");
        }

                    return true; // not a package-info.java file, we ignore it
                }
            } catch (IOException e) {
                throw UncheckedException.throwAsUncheckedException(e, true);
            }
        }

        private String getPackageName(File file) throws IOException {
            try (Stream<String> lines = Files.lines(file.toPath())) {

     * @param dataStore the data store instance to register, must not be null
     * @throws IllegalArgumentException if either name or dataStore is null
     */
    public void add(final String name, final DataStore dataStore) {
        if (name == null || dataStore == null) {
            throw new IllegalArgumentException(

- **License Headers**: Required (use `mvn license:format`)

### Naming & Style

Standard Java conventions (PascalCase classes, camelCase methods, UPPER_SNAKE_CASE constants). Add JavaDoc with `@param`, `@return`, `@throws` for new public APIs.

---

## Quick Reference

### Essential Files

| File | Purpose |
|------|---------|
| `Suggester.java` | Main entry point, index management |

     * Verifies that unwrap can throw exceptions when appropriate.
     */
    @Test
    void testUnwrap_throwsException() {
        when(smbTree.unwrap(any())).thenThrow(new ClassCastException("Cannot unwrap to specified type"));

        assertThrows(ClassCastException.class, () -> smbTree.unwrap(CustomSmbTree.class),
                "Should throw ClassCastException when type is incompatible");
    }

    }
  }

  @Override
  public void invalidateAll() {
    throw new UnsupportedOperationException();
  }

  @Override
  public CacheStats stats() {
    throw new UnsupportedOperationException();
  }

  @Override
  @J2ktIncompatible // Thread safety complexity
  public ConcurrentMap<K, V> asMap() {
    throw new UnsupportedOperationException();
  }

  /**