checkstyle.xml

<?xml version="1.0"?>
<!DOCTYPE module PUBLIC
    "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
    "https://checkstyle.org/dtds/configuration_1_3.dtd">

<module name="Checker">
  <property name="charset" value="UTF-8"/>
  <property name="severity" value="warning"/>
  <property name="fileExtensions" value="java"/>

  <!-- === Filters === -->
  <module name="BeforeExecutionExclusionFileFilter">
    <property name="fileNamePattern" value="module\-info\.java$"/>
  </module>
  <module name="SuppressWarningsFilter"/>
  <module name="SuppressionFilter">
    <property name="file" value="checkstyle-suppressions.xml"/>
    <property name="optional" value="true"/>
  </module>

  <!-- === Core formatting check only (Spotless handles the rest) === -->
  <module name="FileTabCharacter">
    <property name="eachLine" value="true"/>
  </module>

  <!-- Line length stays useful for code review readability -->
  <module name="LineLength">
    <property name="max" value="120"/>
    <property name="ignorePattern"
              value="^package.*|^import.*|http://|https://"/>
  </module>

  <module name="TreeWalker">

    <!-- ✅ Keep these naming checks -->
    <module name="PackageName"/>
    <module name="TypeName"/>
    <module name="MethodName"/>
    <module name="ParameterName"/>
    <module name="LocalVariableName"/>
    <module name="MemberName"/>

    <!-- Allow names like JParqUtil -->
    <module name="AbbreviationAsWordInName">
      <property name="ignoreFinal" value="true"/>
      <property name="allowedAbbreviationLength" value="3"/>
    </module>

    <!-- ✅ Keep important structural checks -->
    <module name="NeedBraces"/>
    <module name="EmptyBlock">
      <property name="option" value="TEXT"/>
    </module>
    <module name="MissingSwitchDefault"/>
    <module name="FallThrough"/>

    <!-- ✅ Keep logical correctness checks -->
    <module name="NoFinalizer"/>
    <module name="OverloadMethodsDeclarationOrder"/>
    <module name="ConstructorsDeclarationGrouping"/>
    <module name="VariableDeclarationUsageDistance"/>

    <!-- ✅ Javadoc & documentation -->
    <module name="JavadocType">
      <property name="scope" value="public"/>
    </module>
    <module name="JavadocMethod">
      <property name="accessModifiers" value="public"/>
      <property name="allowMissingParamTags" value="true"/>
      <property name="allowMissingReturnTag" value="true"/>
      <property name="allowedAnnotations" value="Override, Test"/>
    </module>
    <module name="JavadocParagraph">
      <property name="allowNewlineParagraph" value="true"/>
    </module>

    <!-- ✅ Keep annotation & modifier order -->
    <module name="AnnotationLocation"/>
    <module name="ModifierOrder"/>

    <!-- ✅ Keep TODO and comment indentation checks -->
    <module name="TodoComment"/>
    <module name="CommentsIndentation"/>

    <!-- ✅ Import sanity (Spotless handles order but we can double-check) -->
    <module name="UnusedImports"/>
    <module name="RedundantImport"/>

    <!-- ❌ Remove or disable formatting checks handled by Spotless -->
    <module name="WhitespaceAfter">
      <property name="severity" value="ignore"/>
    </module>
    <module name="WhitespaceAround">
      <property name="severity" value="ignore"/>
    </module>
    <module name="Indentation">
      <property name="severity" value="ignore"/>
    </module>
    <module name="NoWhitespaceBeforeCaseDefaultColon">
      <property name="severity" value="ignore"/>
    </module>
    <module name="LeftCurly">
      <property name="severity" value="ignore"/>
    </module>
    <module name="RightCurly">
      <property name="severity" value="ignore"/>
    </module>
    <module name="OperatorWrap">
      <property name="severity" value="ignore"/>
    </module>
    <module name="SeparatorWrap">
      <property name="severity" value="ignore"/>
    </module>

  </module>
  <module name="SuppressionFilter">
    <property name="file" value="checkstyle-test-suppressions.xml"/>
    <property name="optional" value="true"/>
  </module>
</module>