feat(wpmc S4): OptionsPage::do_register registers routing field group

Also: add acf_add_options_page to acf-stubs.php; add translation-function
stubs to acf-stubs.php; fix TestCase::tearDown to call Patchwork::restoreAll()
in a finally block so that when('function_exists') routes are always cleaned up
even when Mockery::close() throws InvalidCountException.

tests/OptionsPageTest.php

@@ -26,4 +26,68 @@ final class OptionsPageTest extends TestCase
             'OptionsPage::register() must hook wpmc_main_town_slug filter'
         );
     }
+
+    public function test_do_register_is_noop_when_acf_missing(): void
+    {
+        // Order matters: expect() must come BEFORE function_exists alias so that
+        // Brain Monkey's FunctionStub::__construct sees the real function_exists
+        // and doesn't re-eval an already-declared stub.
+        \Brain\Monkey\Functions\expect('acf_add_options_page')->never();
+        \Brain\Monkey\Functions\expect('acf_add_local_field_group')->never();
+        \Brain\Monkey\Functions\when('function_exists')->alias(function ($name) {
+            return $name !== 'acf_add_options_page' && $name !== 'acf_add_local_field_group';
+        });
+
+        OptionsPage::do_register();
+
+        self::assertTrue(true);
+    }
+
+    public function test_do_register_creates_options_page(): void
+    {
+        \Brain\Monkey\Functions\expect('acf_add_options_page')
+            ->once()
+            ->with(\Mockery::on(function ($args) {
+                return ($args['menu_slug'] ?? null) === 'wp-multi-city'
+                    && ($args['page_title'] ?? null) === 'WP Multi City';
+            }));
+        \Brain\Monkey\Functions\when('acf_add_local_field_group')->justReturn();
+        \Brain\Monkey\Functions\when('function_exists')->alias(function ($name) {
+            return $name === 'acf_add_options_page' || $name === 'acf_add_local_field_group';
+        });
+
+        OptionsPage::do_register();
+
+        self::assertTrue(true);
+    }
+
+    public function test_do_register_registers_routing_field_group(): void
+    {
+        \Brain\Monkey\Functions\when('acf_add_options_page')->justReturn();
+
+        $captured = null;
+        \Brain\Monkey\Functions\expect('acf_add_local_field_group')
+            ->once()
+            ->with(\Mockery::on(function ($group) use (&$captured) {
+                $captured = $group;
+                return true;
+            }));
+        \Brain\Monkey\Functions\when('function_exists')->alias(function ($name) {
+            return $name === 'acf_add_options_page' || $name === 'acf_add_local_field_group';
+        });
+
+        OptionsPage::do_register();
+
+        self::assertSame('group_wpmc_routing', $captured['key']);
+        self::assertSame(
+            [[['param' => 'options_page', 'operator' => '==', 'value' => 'wp-multi-city']]],
+            $captured['location']
+        );
+
+        $names = array_column($captured['fields'], 'name');
+        self::assertContains('main_town_slug', $names);
+        self::assertContains('index_town_alt', $names);
+        self::assertContains('page_unic', $names);
+        self::assertContains('page_no_rep', $names);
+    }
 }

tests/TestCase.php

@@ -33,7 +33,15 @@ abstract class TestCase extends BaseTestCase
             $GLOBALS['wp_the_query'],
             $GLOBALS['post']
         );
-        Monkey\tearDown();
+        try {
+            Monkey\tearDown();
+        } finally {
+            // Patchwork routes MUST be disconnected even when Monkey\tearDown() throws
+            // (e.g. Mockery count validation failure).  If they are not, any
+            // when('function_exists')->alias() from the failed test stays active and
+            // causes "Cannot redeclare function __()..." in the next test's setUp().
+            \Patchwork\restoreAll();
+        }
         parent::tearDown();
     }
 }

tests/acf-stubs.php

@@ -16,3 +16,60 @@ declare(strict_types=1);
 if (!function_exists('acf_add_local_field_group')) {
     function acf_add_local_field_group($field_group): void {}
 }
+
+if (!function_exists('acf_add_options_page')) {
+    function acf_add_options_page($args): void {}
+}
+
+// Translation function stubs — declared here (via Patchwork's stream wrapper) so that
+// Brain\Monkey\Functions\stubTranslationFunctions() finds them via function_exists() and
+// never falls back to eval(), which would cause "Cannot redeclare" fatals across tests
+// that use when('function_exists')->alias(...).
+if (!function_exists('__')) {
+    function __($text, $domain = 'default') { return $text; }
+}
+if (!function_exists('_x')) {
+    function _x($text, $context, $domain = 'default') { return $text; }
+}
+if (!function_exists('translate')) {
+    function translate($text, $domain = 'default') { return $text; }
+}
+if (!function_exists('_n')) {
+    function _n($single, $plural, $number, $domain = 'default') { return $number === 1 ? $single : $plural; }
+}
+if (!function_exists('_nx')) {
+    function _nx($single, $plural, $number, $context, $domain = 'default') { return $number === 1 ? $single : $plural; }
+}
+if (!function_exists('_e')) {
+    function _e($text, $domain = 'default') { echo $text; }
+}
+if (!function_exists('_ex')) {
+    function _ex($text, $context, $domain = 'default') { echo $text; }
+}
+if (!function_exists('esc_html__')) {
+    function esc_html__($text, $domain = 'default') { return $text; }
+}
+if (!function_exists('esc_html_x')) {
+    function esc_html_x($text, $context, $domain = 'default') { return $text; }
+}
+if (!function_exists('esc_attr__')) {
+    function esc_attr__($text, $domain = 'default') { return $text; }
+}
+if (!function_exists('esc_attr_x')) {
+    function esc_attr_x($text, $context, $domain = 'default') { return $text; }
+}
+if (!function_exists('esc_html_e')) {
+    function esc_html_e($text, $domain = 'default') { echo $text; }
+}
+if (!function_exists('esc_attr_e')) {
+    function esc_attr_e($text, $domain = 'default') { echo $text; }
+}
+if (!function_exists('_n_noop')) {
+    function _n_noop($singular, $plural, $domain = 'default') { return compact('singular', 'plural'); }
+}
+if (!function_exists('_nx_noop')) {
+    function _nx_noop($singular, $plural, $context, $domain = 'default') { return compact('singular', 'plural'); }
+}
+if (!function_exists('translate_nooped_plural')) {
+    function translate_nooped_plural($nooped_plural, $count, $domain = 'default') { return $count === 1 ? $nooped_plural['singular'] : $nooped_plural['plural']; }
+}