[dcalhoun]

What?

Align window.wp globals with latest WP Admin state. Flag future misalignment with unit tests.

Why?

Ensure the GutenbergKit environment remains aligned with the WP Admin environment after #780, which removed the window.wp.sync global. Misalignment can lead to cryptic errors.

How?

• Remove window.wp.sync global
• Add the window.wp.undoManager global
• Add unit tests to flag future misalignments

Testing Instructions

N/A, no user-facing changes.

Accessibility Testing Instructions

N/A, no user-facing changes.

Screenshots or screencast

N/A, no user-facing changes.

---

AI-generated details

What: Remove window.wp.sync, expose window.wp.undoManager, and add a unit test that flags window.wp gaps against installed packages flagged wpScript.

Why:

• WordPress 7.0 and 7.1 don't ship wp-sync, and Gutenberg removed the global in 24.2 (Sync: Remove exposed wp.sync package WordPress/gutenberg#81999), which core trunk picks up with its next Gutenberg pin update. @wordpress/dependency-extraction-webpack-plugin 6.57.0 (build(deps-dev): Bump @wordpress/dependency-extraction-webpack-plugin from 6.56.0 to 6.57.0 #780) now bundles it into plugin builds. Its only consumers are real-time collaboration transports, which GutenbergKit never enables.
• WP Admin's post editor exposes wp.undoManager. Plugins bundle it today, but would read the global if it leaves BUNDLED_PACKAGES. Core data and compose already bundle it, so exposing it adds no size.
• A missing global breaks every plugin script that reads it. wp.theme (fix: expose @wordpress/theme as window.wp.theme #614) went missing for ~10 months until Jetpack adopted it; this test would have flagged it on the first dependency bump.

How: The test reads wpScript and wpScriptDefaultExport from each installed @wordpress/*/package.json and the window.wp.X = … assignments in wordpress-globals.js and wordpress-i18n.js. It reads source rather than importing the modules, which Node can't evaluate. It fails when:

• a flagged package has no global (missing globals break every plugin script that reads them);
• a global's shape differs from core's (X.default || X for default-export packages, toCommonJS( X ) otherwise);
• a global has no flagged package (core dropped it, like wp.sync);
• an exclusion is no longer flagged.

wpScript approximates core's globals; base-styles is the one exclusion (flagged only to build its stylesheet).

Testing: make test-web-unit. Each check was confirmed to fail when its case is introduced: removing undoManager, swapping the tokenList/url shapes, and re-adding wp.sync.

🤖 Generated with Claude Code

[wpmobilebot]

XCFramework Build

This PR's XCFramework is available for testing. Add the following to your Package.swift:

.package(url: "https://github.com/wordpress-mobile/GutenbergKit", branch: "pr-build/785")

_{Built from 5db1e88}

[crazytonyli]

Does this mean packages that are built with older version WordPress packages won't be able to get wp.sync? Would that cause any issue?

[dcalhoun]

Yes, but the impact to GBK is very narrow and the breaking change was accepted in upstream Gutenberg core in WordPress/gutenberg#81999. It's expected that plugins bundle @wordpress/sync themselves or access the relevant utility via @wordpress/core-data's Y option added to the provider creator.

Details explained by Claude below:

Only for plugins built with @wordpress/dependency-extraction-webpack-plugin 6.40–6.56 that import @wordpress/sync; builds before Feb 2026 and from 6.57 on bundle their own copy. In practice those are real-time collaboration transports (e.g. Jetpack's, VIP's). Those can't work in GBK anyway, since collaboration only runs when window.__experimentalEnableRealTimeCollaboration is set, which we never do. A script that throws on load doesn't stop the remaining assets from loading.

Upstream accepted the same break: WordPress/gutenberg#81999 lists it as breaking, WP 7.0/7.1 never shipped wp.sync, and Gutenberg 24.2 drops it. On our side, wp.sync was only added in #750 and never shipped in a GBK release, so nothing regresses.