feat: stub find-replace exclusions and hide app settings

.phpstan/constants.php

@@ -3,3 +3,6 @@
 define('NAILS_COMMON_PATH', './');
 define('NAILS_CI_SYSTEM_PATH', NAILS_COMMON_PATH . 'vendor/pocketarc/codeigniter/system/');
 define('BASEPATH', NAILS_CI_SYSTEM_PATH);
+define('NAILS_DB_PREFIX', 'nails_');
+
+require_once dirname(__DIR__) . '/src/FindReplace/Interfaces/Exclusion.php';

src/Common/FindReplace/Exclusion/Package.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Nails\Common\FindReplace\Exclusion;
+
+use Nails\FindReplace\Interfaces\Exclusion;
+
+class Package implements Exclusion
+{
+    public function hidden(): array
+    {
+        return [
+            NAILS_DB_PREFIX . 'app_setting',
+        ];
+    }
+
+    public function readOnly(): array
+    {
+        return [];
+    }
+}

src/FindReplace/Interfaces/Exclusion.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Nails\FindReplace\Interfaces;
+
+if (interface_exists(Exclusion::class, false)) {
+    return;
+}
+
+interface Exclusion
+{
+    /**
+     * Never searched. Entries are `table`, `table.*`, `table.column`, or a delimited PCRE pattern.
+     *
+     * @return list<string>
+     */
+    public function hidden(): array;
+
+    /**
+     * Searched and shown, never replaced. Same entry format as hidden().
+     *
+     * @return list<string>
+     */
+    public function readOnly(): array;
+}

tests/FindReplace/Exclusion/PackageTest.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Tests\FindReplace\Exclusion;
+
+use Nails\Common\FindReplace\Exclusion\Package;
+use PHPUnit\Framework\TestCase;
+
+class PackageTest extends TestCase
+{
+    public static function setUpBeforeClass(): void
+    {
+        if (!defined('NAILS_DB_PREFIX')) {
+            define('NAILS_DB_PREFIX', 'nails_');
+        }
+    }
+
+    public function testHidden(): void
+    {
+        self::assertSame(
+            [
+                NAILS_DB_PREFIX . 'app_setting',
+            ],
+            (new Package())->hidden()
+        );
+    }
+
+    public function testReadOnly(): void
+    {
+        self::assertSame(
+            [],
+            (new Package())->readOnly()
+        );
+    }
+}

tests/bootstrap.php

@@ -63,3 +63,5 @@
 
     Testing::bootstrapModule(__FILE__);
 }
+
+require_once dirname(__DIR__) . '/src/FindReplace/Interfaces/Exclusion.php';