[dknauss]

Summary

This bumps Borges to 1.12.0. Merging it releases: release.yml sees the version change in bibliography-builder.php, builds the ZIP, tags v1.12.0, publishes the GitHub Release with the CHANGELOG section as its notes, and dispatches the WordPress.org deploy.

It's a minor version because it adds features (the write abilities) and changes saved markup for newsletters and feeds. Older posts keep validating and switch to the new markup when next saved.

What ships, since 1.11.0:

• Fixed: newsletters and feeds (Make bibliographies read correctly in newsletters and feeds #158). Email and feed readers no longer show every reference in italics or a broken Cite / Export panel. Posts saved earlier are cleaned up as they're sent.
• Fixed: names with particles sort per style (Sort names with particles per each style's demote setting #147). "van Duijnhoven" sorts under D in Chicago and Vancouver, and under V in the other styles.
• Fixed: no period after a "?" or "!" title in Chicago and MLA (Drop the period citeproc-php adds after a "?" or "!" title #155).
• Changed: per-entry formatter cache (Cache formatted entries per style so an edit renders only what changed #176). After an edit, only the changed entries are formatted: about 5 ms instead of 65–105 ms for 200 entries.
• Added: write abilities (Add write abilities wrapping the bibliography write routes (Phase 05 M5) #148). These are opt-in, on WordPress 6.9+ only, and exist only when the write routes are enabled with a filter.
• Internals: Phases A–E of the refactor memo (Scope Prettier with .prettierignore and check formatting in CI (Phase A1) #150–Refresh the large-bibliography benchmark results (Phase A4) #153, Move CSL sanitization out of the root file (Phase B, ticket 5) #160–Move block data and the read model out of the root file (Phase B, ticket 7) #162, Move the read route callbacks out of the root file (Phase B, ticket 8) #164, Share one style table between JS and PHP (Phase C, ticket 10) #165, Move the name particle list into styles.json (Phase C, ticket 11) #167–Add a checkJs type check for src/lib (Phase D, ticket 13) #169, Raise Psalm to level 3 and fix its findings (Phase D) #171–Split parser.js into detection, resolution, and per-format modules (Phase E, ticket 16) #174, Raise Psalm to level 2 #177). There is no output change; the save-parity and style golden tests pin this. The work covered:
  • the module split (the root file went from 1,607 to about 800 lines; save-markup.php and parser.js were split too);
  • one style table shared by JS and PHP;
  • Psalm level 2 and checkJs;
  • a PHP 7.4 compatibility check in PHPCS;
  • the Abilities API in the runtime matrix;
  • /format profiling.

Files changed (same set as the 1.11.0 release, #146):

• The version, in bibliography-builder.php, block.json, package.json, package-lock.json, and the readme.txt stable tag.
• A ## [1.12.0] - 2026-10-22 header in CHANGELOG.md over the accumulated Unreleased notes, plus a short "Internals, for contributors" bullet.
• The readme.txt changelog and upgrade notice, the README release highlights, and the roadmap release baseline.

Validation

• All four version fields read 1.12.0, which release.yml requires.
• node scripts/extract-changelog-section.js 1.12.0 prints the section, so the release job won't fail on a missing section.
• npm test: 1,058 tests pass, including the Playground demo freshness test.
• npm run format:check passes.
• composer test:php: 468 tests pass.
• .github/scripts/verify-metrics.sh passes.
• npm run build && npm run package:release builds the release ZIP.

Checklist

• Version bumped everywhere release.yml checks
• CHANGELOG section for 1.12.0
• readme.txt changelog and upgrade notice
• README highlights and roadmap baseline
• Merge when ready. This publishes the release and deploys to WordPress.org.

---

Generated by Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 88.18%. Comparing base (f36307b) to head (9c58794).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##               main     #178   +/-   ##
=========================================
  Coverage     88.18%   88.18%           
  Complexity       27       27           
=========================================
  Files            76       76           
  Lines          7382     7382           
  Branches        699      699           
=========================================
  Hits           6510     6510           
  Misses          301      301           
  Partials        571      571           

☔ 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.