Playground demos: open on a demo page covering every input format

[dknauss]

Summary

What changed?

The release, main-build, and WordPress.org Preview blueprints now open the block editor on a generated demo page. Before, they opened a one-block starter.

1. Section 1: samples of every accepted input. Copy-ready code blocks, grouped by format, above an empty Bibliography block:

   • DOI: bare, doi:, and a doi.org link.
   • PMID and PMCID.
   • arXiv: modern, legacy, arxiv.org link, and an arXiv DOI.
   • ISBN: labeled ISBN-13, bare ISBN-13, and ISBN-10.
   • BibTeX and BibLaTeX.
   • Formatted book, journal article, chapter, and webpage citations, plus one with an embedded DOI.

   23 samples in total, well under the 50-per-paste limit.

2. Section 2: brief feature notes. Styles, editing entries, manual entry, duplicates, ordering, exports, per-entry Cite / Export, machine-readable output, and a link to the post's read-only REST data.

3. Section 3: example bibliographies.

   • The three examples are Chicago notes-bibliography with Cite / Export and COinS, APA 7, and IEEE.
   • At boot they are formatted by the plugin's own citeproc formatter and rendered by its PHP port of save() from Phase 05 M2 spike: PHP save() port with parity harness; M1 review-route fixes #97. They therefore validate against whatever version the blueprint installs.
   • A release without the port (anything before 1.7.0) shows a note in their place.
   • Citations are stored in display order, together with the export strings the editor computes. The untouched page therefore opens with no unsaved changes.

4. Welcome Guide. It is turned off (the core/edit-post persisted preference), so the page is what opens.

Maintenance.

• The page is defined once, in playground/demo-content.json (the data) and playground/demo-content.php (the writer).
• Blueprints can't load repository files, so npm run playground:build inlines both into each blueprint's runPHP step. It also reformats short arrays in the blueprints, which is cosmetic.
• The new src/playground-demo.test.js fails when:
  • a blueprint is stale;
  • a sample stops reaching the parser backend it claims (the test runs offline, and each resolver's error identifies the route);
  • the samples stop covering every format;
  • the stored export strings drift from computeExportStrings.
• playground/ joins scripts/ in the exclusions for the first-party PHP metric, since it never ships (it is already in .distignore).

Why? So visitors can try every input format and the key features without having to find their own identifiers.

Heads-up, not changed here: the bundled CSL styles in packages/citation-style-language-styles/ are about 2 KB, project-written stand-ins. So "APA" and "Chicago" output initializes given names and omits volume, issue, and pages. The examples show exactly what the editor produces.

Validation

• npm run lint:js passes
• npm run lint:css: no CSS changes
• npm run lint:i18n: no source strings changed
• npm run test passes (872 passed)
• npm run build succeeds
• Tested in the block editor. I ran the generated main blueprint in a local Playground (CLI 3.1.40, WordPress trunk, this build mounted) and checked it in Chromium:
  • all 44 blocks are valid, including the 4 bibliographies;
  • the editor reports no unsaved changes;
  • no Welcome Guide appears;
  • the front end renders every bibliography with its Cite / Export panels.
• verify-metrics.sh passes

I haven't run the hosted playground.wordpress.net Playground: WordPress.org is blocked in this sandbox. The runPHP step uses only core APIs plus the plugin's own functions, and those calls are guarded with function_exists.

Checklist

• Linked issue or explained why none was needed: requested directly (demo coverage of every input format).
• No sensitive details disclosed publicly

🤖 Generated with Claude Code

https://claude.ai/code/session_01KbVuMPN7YTcV27vwsG3LZ2

---

Generated by Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.65%. Comparing base (3afed26) to head (70468c7).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #102   +/-   ##
=======================================
  Coverage   86.65%   86.65%           
=======================================
  Files          52       52           
  Lines        5367     5367           
  Branches      597      597           
=======================================
  Hits         4651     4651           
  Misses        235      235           
  Partials      481      481           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.