same_page_preview 3.0.0

First stable release of Same Page Preview 3 for Drupal 11, bringing together the editor workflow, accessibility, settings and compatibility improvements from five release candidates.

Highlights

• Preview content beside the editing form, including new nodes and incomplete drafts, while retaining normal validation when saving.
• Preserve the selected view mode across refreshes, form rebuilds and new-window previews.
• Refresh after committed Paragraphs and tabledrag reordering, with loading feedback during preview refreshes.
• Improve narrow, full-screen and RTL layouts.
• Provide keyboard access, skip-to-preview navigation, named preview landmarks, current frame context, focus return and repeatable polite close feedback.
• Configure site-wide display defaults, Settings visibility and allowed view modes.
• Respect per-content-type settings, including Drupal core’s “Preview before submitting” setting.
• Improve Domain Source, Responsive Preview and Site Studio coexistence, and support browsers where local storage is blocked.

Changes since rc5

Runtime behavior is unchanged from rc5. This release adds optional Canvas regression coverage and execution evidence for issue #3619941. The tested preview path already prevents stale render-cache reuse and unsaved content entering the public render cache; no production cache hook was needed.

Requirements and upgrading

• Requires PHP 8.3 or newer and Drupal ^11.2 || ^12. Drupal 10 sites should remain on the 2.1.x release line until upgrading core.
• Install or upgrade with composer require 'drupal/same_page_preview:^3.0', then run drush updb and drush cr.
• Updates 8001 through 8003 validate stored content-type settings and add display defaults while preserving existing behavior. There are no new database updates or configuration changes since rc5.
• Custom integrations calling the removed procedural hooks must migrate to the object-oriented hooks in src/Hook/SamePagePreviewHooks.php.

Validation and known limitations

GitLab CI passes for current Drupal, Drupal 11.3.18 and the Drupal 12 next-major test lane. All 80 JavaScript regression tests pass. Windows NVDA evidence and the Canvas cache-isolation investigation are included in the repository.

The Drupal 12 constraint permits next-major testing; complete Drupal 12 and HTMX 4 compatibility are not claimed. HTMX 4 and live Site Studio Layout Canvas support are planned for 4.x.

Settings popover presentation, preview zoom, device-width presets and VoiceOver/Safari coverage remain follow-up work. Preview text-format access checks cover node text fields; text fields inside nested entities such as Paragraphs remain a known limitation.