Update CS fixer config, update facades automatically

Author: mbabker

.github/facades.yml

@@ -0,0 +1,44 @@
+name: 'Update Facade Docblocks'
+
+on:
+  push:
+    branches:
+      - '*.x'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  facades:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: true
+
+    name: 'Update Facade Docblocks'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          tools: composer:v2
+          coverage: none
+
+      - name: Install dependencies
+        run: |
+          composer config repositories.facade-documenter vcs [email protected]:laravel/facade-documenter.git
+          composer require --dev laravel/facade-documenter:dev-main --prefer-stable --prefer-dist --no-interaction --no-progress
+
+      - name: Update docblocks
+        run: php -f vendor/bin/facade.php BabDev\\Breadcrumbs\\Facades\\Breadcrumbs
+
+      - name: Commit updates
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: Update facade docblocks
+          file_pattern: src/

.php-cs-fixer.php

@@ -3,6 +3,7 @@
 $finder = (new PhpCsFixer\Finder())
     ->notPath('config')
     ->notPath('vendor')
+    ->notPath('Facades')
     ->in(__DIR__)
     ->name('*.php')
     ->notName('*.blade.php')
@@ -37,21 +38,19 @@
                 'while',
             ],
         ],
-        'braces'                                      => true,
         'cast_spaces'                                 => [
             'space' => 'single',
         ],
         'class_definition'                            => true,
         'combine_consecutive_issets'                  => true,
         'combine_consecutive_unsets'                  => true,
-        'compact_nullable_typehint'                   => true,
+        'compact_nullable_type_declaration'           => true,
         'concat_space'                                => [
             'spacing' => 'one',
         ],
         'declare_strict_types'                        => false,
         'dir_constant'                                => true,
         'function_to_constant'                        => true,
-        'function_typehint_space'                     => true,
         'increment_style'                             => [
             'style' => 'post',
         ],
@@ -69,7 +68,7 @@
         'native_constant_invocation'                  => true,
         'native_function_casing'                      => true,
         'native_function_invocation'                  => true,
-        'new_with_braces'                             => true,
+        'new_with_parentheses'                        => true,
         'no_alias_functions'                          => true,
         'no_blank_lines_after_class_opening'          => true,
         'no_blank_lines_after_phpdoc'                 => true,
@@ -82,9 +81,9 @@
         'no_null_property_initialization'             => true,
         'no_short_bool_cast'                          => true,
         'no_spaces_after_function_name'               => true,
-        'no_spaces_inside_parenthesis'                => true,
+        'spaces_inside_parentheses'                   => false,
         'no_superfluous_elseif'                       => true,
-        'no_trailing_comma_in_singleline_array'       => true,
+        'no_trailing_comma_in_singleline'             => true,
         'no_trailing_whitespace'                      => true,
         'no_trailing_whitespace_in_comment'           => true,
         'no_unneeded_control_parentheses'             => true,
@@ -114,6 +113,7 @@
                 'arrays',
             ],
         ],
+        'type_declaration_spaces'                     => true,
         'visibility_required'                         => [
             'elements' => ['property', 'method', 'const'],
         ],

src/Facades/Breadcrumbs.php

@@ -2,22 +2,10 @@
 
 namespace BabDev\Breadcrumbs\Facades;
 
-use BabDev\Breadcrumbs\BreadcrumbsManager;
-use Illuminate\Contracts\View\View;
-use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Facade;
-use Illuminate\Support\Traits\Macroable;
 
 /**
- * @method static void        for(string $name, callable $callback)
- * @method static bool        exists(?string $name = null)
- * @method static Collection  generate(?string $name = null, ...$params)
- * @method static View        view(string $view, ?string $name = null, ...$params)
- * @method static View        render(?string $name = null, ...$params)
- * @method static object|null current()
- *
- * @mixin Macroable
- * @see BreadcrumbsManager
+ * @see \BabDev\Breadcrumbs\BreadcrumbsManager
  */
 class Breadcrumbs extends Facade
 {