phpcs.xml

<?xml version="1.0"?>
<ruleset name="Aegis Theme">
    <description>WordPress Coding Standards for the Aegis Block Theme</description>

    <arg name="extensions" value="php"/>
    <arg name="cache"/>
    <arg name="basepath" value="./"/>
    <arg name="parallel" value="20"/>
    <arg value="ps"/>
    <arg name="colors"/>

    <ini name="memory_limit" value="256M"/>

    <file>./src</file>
    <file>./functions.php</file>
    <file>./patterns</file>
    <file>./embed-content.php</file>

    <exclude-pattern>*/vendor/*</exclude-pattern>
    <exclude-pattern>*/node_modules/*</exclude-pattern>
    <exclude-pattern>*/build/*</exclude-pattern>
    <exclude-pattern>*/src/Blocks/*/index.js</exclude-pattern>
    <exclude-pattern>*/src/Blocks/*/view.js</exclude-pattern>
    <exclude-pattern>*/src/Blocks/*/style.js</exclude-pattern>
    <exclude-pattern>*/src/Blocks/editor/*</exclude-pattern>

    <!-- Generated files (webpack / tools/generate-blocks-manifest.php). -->
    <exclude-pattern>*.asset.php</exclude-pattern>
    <exclude-pattern>*/src/Blocks/blocks-manifest.php</exclude-pattern>
    <exclude-pattern>*/src/Admin/build/*</exclude-pattern>

    <!-- Gate CI on errors only; warnings stay visible in reports. -->
    <config name="ignore_warnings_on_exit" value="1"/>

    <rule ref="WordPress-Core"/>
    <rule ref="WordPress-Docs"/>
    <rule ref="WordPress-Extra"/>

    <rule ref="WordPress.WP.I18n">
        <properties>
            <property name="text_domain" type="array">
                <element value="aegis"/>
            </property>
        </properties>
    </rule>

    <rule ref="WordPress.NamingConventions.PrefixAllGlobals">
        <properties>
            <property name="prefixes" type="array">
                <element value="aegis"/>
            </property>
        </properties>
    </rule>

    <!--
    Block render templates, patterns and theme templates are included by core
    inside function scope, so their file-level variables are not globals.
    -->
    <rule ref="WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound">
        <exclude-pattern>*/patterns/*</exclude-pattern>
        <exclude-pattern>*/src/Blocks/*/render.php</exclude-pattern>
        <exclude-pattern>embed-content.php</exclude-pattern>
    </rule>
    <rule ref="WordPress.WP.GlobalVariablesOverride.Prohibited">
        <exclude-pattern>*/patterns/*</exclude-pattern>
        <exclude-pattern>*/src/Blocks/*/render.php</exclude-pattern>
        <exclude-pattern>embed-content.php</exclude-pattern>
    </rule>

    <!-- embed-content.php fires core embed hooks (embed_content, embed_thumbnail_id, …). -->
    <rule ref="WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound">
        <exclude-pattern>embed-content.php</exclude-pattern>
    </rule>

    <!-- Pattern files use the WordPress pattern header comment, not a PHPDoc file comment. -->
    <rule ref="Squiz.Commenting.FileComment">
        <exclude-pattern>*/patterns/*</exclude-pattern>
    </rule>

    <!-- Pattern markup is block HTML; space indentation is intentional and not WPCS-tabbed PHP. -->
    <rule ref="Generic.WhiteSpace.DisallowSpaceIndent">
        <exclude-pattern>*/patterns/*</exclude-pattern>
    </rule>

    <rule ref="WordPress.PHP.YodaConditions.NotYoda">
        <type>warning</type>
    </rule>
    <rule ref="WordPress.NamingConventions.ValidVariableName.VariableNotSnakeCase">
        <type>warning</type>
    </rule>
    <rule ref="WordPress.DB.PreparedSQL.InterpolatedNotPrepared">
        <type>warning</type>
    </rule>
    <rule ref="WordPress.DB.PreparedSQL.NotPrepared">
        <type>warning</type>
    </rule>

    <rule ref="WordPress.Files.FileName">
        <exclude-pattern>*/src/*</exclude-pattern>
        <!-- Pattern filenames mirror core/WooCommerce taxonomy template slugs (underscores). -->
        <exclude-pattern>*/patterns/template/taxonomy-*.php</exclude-pattern>
    </rule>

    <config name="testVersion" value="8.1-"/>
</ruleset>