From 41119f4e359e04dbd4ec7ac5ddb5b69957946666 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Mar 2026 06:40:11 +0000
Subject: [PATCH 1/4] Initial plan


From 09ddedbda57e7aa0effa7ee93ec11e891492c2ab Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Mar 2026 06:41:14 +0000
Subject: [PATCH 2/4] docs: fix markdown links inside callout div in
 client-side navigation compatibility guide

Agent-Logs-Url: https://github.com/WordPress/gutenberg/sessions/28f79e52-cbc1-43ee-8656-8cb10982dbe7

Co-authored-by: luisherranz <3305402+luisherranz@users.noreply.github.com>
---
 .../core-concepts/client-side-navigation-compatibility.md       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md b/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
index 0fa0b333fa67c7..09150e2b005bc8 100644
--- a/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
+++ b/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
@@ -8,7 +8,7 @@ This guide explains what to consider when evaluating compatibility. While the ex
 
 <div class="callout callout-info">
 
-This guide assumes familiarity with [blocks](https://developer.wordpress.org/block-editor/getting-started/), [`block.json`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/), and the basics of the [Interactivity API](/docs/reference-guides/interactivity-api/). If you're new to the Interactivity API, start with the [Quick Start Guide](/docs/reference-guides/interactivity-api/iapi-quick-start-guide.md) first.
+This guide assumes familiarity with <a href="https://developer.wordpress.org/block-editor/getting-started/">blocks</a>, <a href="https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/"><code>block.json</code></a>, and the basics of the <a href="https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/">Interactivity API</a>. If you're new to the Interactivity API, start with the <a href="https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/iapi-quick-start-guide/">Quick Start Guide</a> first.
 
 </div>
 

From b0c9046075d5b780ca550536d38ae644a28f8ea0 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Mar 2026 06:47:56 +0000
Subject: [PATCH 3/4] docs: de-indent PHP code block in client-side navigation
 compatibility guide

Agent-Logs-Url: https://github.com/WordPress/gutenberg/sessions/7e0bdd17-9f02-47b7-bbd1-720ce9d6a4a5

Co-authored-by: luisherranz <3305402+luisherranz@users.noreply.github.com>
---
 .../client-side-navigation-compatibility.md         | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md b/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
index 09150e2b005bc8..3c1f8b542baa11 100644
--- a/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
+++ b/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
@@ -158,12 +158,13 @@ The key rules for script modules and client-side navigation:
 -   Only **external** script modules (those with a `src` attribute) are processed. Inline script modules — where the code is written directly inside the `<script>` tag — are not re-executed.
 -   The Interactivity API only loads modules that contain the `data-wp-router-options='{"loadOnClientNavigation":true}'` attribute.
     -   For blocks, the `loadOnClientNavigation` flag is set automatically when the script module is declared in `block.json` and `supports.interactivity` or `supports.interactivity.clientNavigation` is `true`.
-    -   For non-block script modules (e.g., those enqueued by a theme or plugin), register the script module for client-side navigation explicitly using [`add_client_navigation_support_to_script_module()`](/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation.md#ensuring-script-modules-load-during-navigation):
-        ```php
-        wp_interactivity()->add_client_navigation_support_to_script_module(
-        	'my-plugin/navigation-handler'
-        );
-        ```
+    -   For non-block script modules (e.g., those enqueued by a theme or plugin), register the script module for client-side navigation explicitly using [`add_client_navigation_support_to_script_module()`](/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation.md#ensuring-script-modules-load-during-navigation).
+
+```php
+wp_interactivity()->add_client_navigation_support_to_script_module(
+    'my-plugin/navigation-handler'
+);
+```
 
 For more details on how script modules are handled during navigation, see the [Script module handling](/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation.md#script-module-handling) section of the Client-Side Navigation guide.
 

From eebceccde11d7c8b54aef0dc6f80e717029c933d Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Mar 2026 08:43:28 +0000
Subject: [PATCH 4/4] docs: Remove markdown checkboxes from compatibility
 checklist

Agent-Logs-Url: https://github.com/WordPress/gutenberg/sessions/f8b73496-7092-4e1f-a617-a2c8bedb83db

Co-authored-by: luisherranz <3305402+luisherranz@users.noreply.github.com>
---
 .../client-side-navigation-compatibility.md   | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md b/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
index 3c1f8b542baa11..5f974fd0f6d649 100644
--- a/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
+++ b/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation-compatibility.md
@@ -310,14 +310,14 @@ After implementing the guidelines above, use the following approach to confirm t
 
 Before marking your block as compatible with client-side navigation, verify the following:
 
--   [ ] The block does not inject `<style>` or `<link>` elements dynamically through JavaScript.
--   [ ] The block does not modify existing stylesheets at runtime (e.g., via CSSOM APIs).
--   [ ] CSS selectors (class names, IDs) are stable across navigations — no use of `wp_unique_id()` for selectors.
--   [ ] The block uses script modules, not regular `<script>` tags.
--   [ ] The block does not import from `window.wp.*` globals — it uses ES module imports instead.
--   [ ] The block does not rely on `DOMContentLoaded` or `load` events for initialization — it uses `data-wp-init` instead.
--   [ ] If the block needs to sync state or context from the server on each navigation, it uses `getServerState()` or `getServerContext()`.
--   [ ] Lists of sibling elements that can change between navigations use `data-wp-key`.
--   [ ] The block does not manipulate the DOM using APIs outside the Interactivity API (e.g., `document.createElement`, jQuery).
--   [ ] Any HTML that needs to live outside the block's boundaries (e.g., overlays on `<body>`) uses `attachTo` to define its own region.
--   [ ] (Optional) The block works correctly with the [experimental full-page client-side navigation](/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation.md#full-page-client-side-navigation-experimental) mode.
+-   The block does not inject `<style>` or `<link>` elements dynamically through JavaScript.
+-   The block does not modify existing stylesheets at runtime (e.g., via CSSOM APIs).
+-   CSS selectors (class names, IDs) are stable across navigations — no use of `wp_unique_id()` for selectors.
+-   The block uses script modules, not regular `<script>` tags.
+-   The block does not import from `window.wp.*` globals — it uses ES module imports instead.
+-   The block does not rely on `DOMContentLoaded` or `load` events for initialization — it uses `data-wp-init` instead.
+-   If the block needs to sync state or context from the server on each navigation, it uses `getServerState()` or `getServerContext()`.
+-   Lists of sibling elements that can change between navigations use `data-wp-key`.
+-   The block does not manipulate the DOM using APIs outside the Interactivity API (e.g., `document.createElement`, jQuery).
+-   Any HTML that needs to live outside the block's boundaries (e.g., overlays on `<body>`) uses `attachTo` to define its own region.
+-   (Optional) The block works correctly with the [experimental full-page client-side navigation](/docs/reference-guides/interactivity-api/core-concepts/client-side-navigation.md#full-page-client-side-navigation-experimental) mode.