Skip to content

CHANGELOG.md

Latest commit

 

History

History
233 lines (140 loc) · 16.8 KB

CHANGELOG.md

File metadata and controls

233 lines (140 loc) · 16.8 KB
Raw

Changelog

All notable changes to Dirtbag are documented here.

This project follows the spirit of Keep a Changelog and uses version tags such as v0.1.2.

Unreleased

[0.1.18] - 2026-08-23

Added

  • Emit color-scheme and theme-color meta tags derived from the active style variation's background colour. WordPress core emits neither; without color-scheme, form controls and scrollbars render as light user-agent widgets on the dark variations (Terminal, Amber CRT, Blueprint). Derived from the resolved global styles rather than a variation slug, so the tags follow the site owner's own Site Editor customisations. The default Brutalist style declares no background and deliberately gets neither tag.
  • docs/head-metadata.md — who emits what in <head>: what core already provides a block theme, the two tags Dirtbag adds, and why meta description, Open Graph, and JSON-LD deliberately need a plugin.
  • Unit tests for the colour-scheme derivation (tests/php/color-scheme-test.php, dependency-free plain PHP, run by bin/package-check) and a per-style browser spec (tests/styles/head-meta.spec.js).
  • bin/package-check now requires styles.color.background in each style variation to be a literal hex colour, since a non-hex value would silently drop both meta tags.
  • bin/package-check now rejects a styles.css key in any style variation, which would clobber theme.json's root CSS the same way user Additional CSS did.
  • tests/styles/additional-css.spec.js — regression coverage for that clobber, tagged @self-switching alongside sticking.spec.js so the per-style sweep excludes both.
  • A print stylesheet, as an @media print block in theme.json's root styles.css (the theme ships no CSS files). The site printed as-styled before, and browsers do not print background colours: the dark variations (Terminal, Amber CRT, Blueprint) kept their near-white text, lost the black behind it, and came out of the printer blank. Printing is now black on white whatever the variation, with the truck logo's dark-screen filter reset, navigation, skip links, search, post navigation and comment chrome dropped, absolute links in the article body spelled out, and headings kept with what they head.
  • tests/styles/print.spec.js — per-style print coverage, including a check that the post title and content still print, so an over-eager reset fails loudly. Runs in CI as well as locally: every assertion holds for any active variation.
  • docs/print-styles.md — what prints, what deliberately does not, and why the guard has to run per style.

Fixed

  • playground/apply-style.php now links the global-styles post it writes to the active theme, and refuses to report success unless that post is the one the front end reads. A wp_global_styles post is bound to a theme by a wp_theme term; core creates the post with tax_input, which wp_insert_post() applies only when the current user can assign terms — and WP-CLI runs with no current user. On a site with no global-styles post for the active theme yet, every invocation therefore created a fresh, untagged post that the front end's own lookup can never find: the helper printed success, the page never changed, and the per-style sweep scanned the default variation seven times over. Observed on the Studio site as 25 orphaned posts alongside the one working post created through the browser.
  • Repointed the WordPress Studio theme symlink, which referenced a stale path (Developer/GitHub/dirtbag rather than Developer/GitHub/dknauss/dirtbag). The per-style Playwright sweep had been running against whatever theme was active instead of Dirtbag.
  • Adding Additional CSS in the Site Editor no longer deletes the theme's own CSS. Core merges global styles with array_replace_recursive(), and root styles.css is a string, so anything a user typed there replaced theme.json's entire root stylesheet — silently breaking the per-style truck-icon colour, the front-page column grid, the sidebar thumbnails, and the gallery captions. The theme's rules are now re-prepended to the user layer, so both apply and the user's CSS still wins ties. Clearing the panel again is covered too: core merges on the key rather than the value, so a styles.css left present but empty wiped the theme's CSS just as thoroughly.

0.1.17 - 2026-07-03

Added

  • Add the WordPress.org theme listing, support forum, and GitHub Sponsors donation link to the WordPress.org readme and maintainer docs.

Changed

  • Reframe theme-review/testing/backlog docs for post-acceptance maintenance and future WordPress.org releases.

0.1.16 - 2026-06-30

Changed

  • Theme review (themes.trac #277839): refreshed the front-page screenshot to match the current two-column masthead and dynamic Query Loop sections. Version bump for the WordPress.org resubmission accepted in the theme directory.

0.1.15 - 2026-06-23

Changed

  • Theme review (themes.trac #277839): replaced real external links in the Blogroll with XFN pattern with example.com placeholders and generic relationship labels, so the theme ships no hard-coded third-party URLs.
  • Made every user-facing string in patterns/front-page.php translation-ready and replaced hard-coded demo post links with dynamic Query Loop blocks.
  • Added explicit licence type and URL details to each resource entry in readme.txt, clarified that photographs are Playground-only demo media except as incorporated into screenshot.png, and removed the Butterick's Practical Typography influence note from bundled-resource credits.

0.1.14 - 2026-06-21

Changed

  • Packaging: assets/icons/ now ships only the two SVGs the theme actually references (pickup-truck-header.svg for the Site Logo fallback, pickup-truck.svg for the h-card photo). The demo site-logo and favicon PNGs moved to playground/media/ (export-ignored; the seed imports them from there), and three unused variants (pickup-truck-header-white.svg, pickup-truck-white.svg, dirtbag-site-icon-white.png) were removed. Trims the WordPress.org zip; the Playground demo's favicon behaviour is unchanged.

[0.1.13] - 2026-06-21

Added

  • An opaque, manila-backed Site Icon variant (assets/icons/dirtbag-site-icon-opaque.png) for the browser-tab favicon and the WordPress-admin site icon. CSS filters never reach those raster contexts, so the transparent dark truck disappeared on dark tabs / dark mode; the opaque variant stays visible on any background. Documented in docs/site-icons-and-logos.md.

Changed

  • The header Site Logo no longer syncs the Site Icon (shouldSyncIcon:false on both header logos). The header keeps the transparent truck so the per-style truckIconFilter can recolour it on coloured/dark variations, while the favicon uses the opaque variant — the two are now independent. The Playground seed sets a transparent custom_logo and an opaque site_icon accordingly.

[0.1.12] - 2026-06-21

Added

  • functions.php gives the core image lightbox trigger button a static, translatable aria-label ("Enlarge image"). Core renders that <button class="lightbox-trigger"> with only a runtime-bound data-wp-bind--aria-label, so with JavaScript off — or before the Interactivity API hydrates — it has no accessible name and fails the WCAG button-name check. A render_block filter adds the name in the server HTML using the HTML API (matched at the enclosing block, where the lightbox markup is final); core's script still overrides it with the image-specific label once it runs. This lets images keep the lightbox enabled and stay accessible (cf. 0.1.5, which instead disabled the lightbox on the decorative h-card avatar).

[0.1.11] - 2026-06-21

Added

  • A first functions.php: when no Site Logo is set, the header's core/site-logo block falls back to the bundled assets/icons/pickup-truck-header.svg, sized to the block width and wrapped in core's markup so existing styles (including the dark-mode icon filter) apply. This makes the truck appear on a fresh install and in the generic WordPress.org directory preview, which never runs the demo seed that sets the custom logo. An uploaded Site Logo, or a synced Site Icon, still wins. bin/package-check now also lints functions.php.

[0.1.10] - 2026-06-21

Changed

  • Front page: the masthead is now a wide two-column row — the <h1> and an italicised standfirst on the left, a curated "featured posts" link list (bottom-aligned) on the right. The trailing period is dropped from the heading.

[0.1.9] - 2026-06-20

Fixed

  • languages/dirtbag.pot: corrected the Theme URI and Author URI (danknauss → dknauss, matching style.css and the git remote) and refreshed the version metadata.

Added

  • Theme tags for the WordPress.org directory listing: block-patterns (17 patterns), translation-ready (full .pot, patterns use translation functions), microformats (h-card / u-url / h-entry markup), and the blog subject tag. All verified against Theme Check's allowed-tag list.

Changed

  • Regenerated languages/dirtbag.pot after the 0.1.6–0.1.8 content additions, picking up 13 previously-missing translatable strings (the Almanac-card and Byline patterns, the front-page pattern title, the Navigation Overlay template part, and the Archive/Search custom-template names).

Documentation

  • docs/theme-review.md: documented the WordPress.org upload-scanner (Theme Check) triage. Scanning the 0.1.8 release zip yields no required or warning notes; the remaining two Recommended notes (register_block_style / register_block_pattern not found) are block-theme false positives, and the two Info notes (hard-coded blogroll links, single text-domain) are intentional. None require a code change.

[0.1.8] - 2026-06-20

Added

  • Front-page standfirst line under the masthead ("Rural speed, shed talk, hard chirps…").
  • The "We blamed the browser" post's three-screenshot gallery now seeds into the Playground demo. The seed importer gained a small, general token-rewrite step (__DBSRC_<id>__ / __DBID_<id>__) so in-content media is portable across sites.

Changed

  • Front-page masthead: "A Roadside Almanac" → "Roadside Almanac." Gallery images get a 2px currentColor frame.

Fixed

  • Accessibility: gallery image captions render below the image in normal flow instead of WordPress core's white-on-image overlay — fixing colour contrast over light images and the scrollable-region-focusable overlay (the issue first removed in 0.1.4).

[0.1.7] - 2026-06-20

Added

  • Front-page sidebar can render two ways, toggled by one class on .sidebar-content: a magazine float (title/date/excerpt wrap beside and under the thumbnail; the default) or a media-object grid (.is-grid; thumbnail column + text column).
  • Posts "The price of a pun" and "We blamed the browser".
  • docs/repro/: a WordPress-free reproduction and write-up of the Post Title float interaction, filed upstream as WordPress/gutenberg#79372.

Changed

  • Every post now uses a distinct featured image.
  • Baseline-aligned the two front-page section headings; the sidebar's first thumbnail top is flush with the wide column's first image.
  • Pinned the stable Playground blueprint to the current release; ignore .DS_Store.

Fixed

  • Front-page sidebar float: WordPress core styles the Post Title link display: inline-block, an atomic box that drops below the float when it can't fit beside it (longest titles first). A scoped display: inline override restores the wrap. It is not lazy-loading, DPR, subgrid, or a browser bug — see docs/sidebar-thumbnail-layout.md.

[0.1.6] - 2026-06-20

Added

  • Front page: a "Used Cars & Unused Plans" sidebar — a compact secondary feed of non-featured posts with square thumbnails — and a small "The Almanac" card. The masthead gains an <h1>, "A Roadside Almanac".
  • Published "The build sheet" post.
  • docs/sidebar-thumbnail-layout.md: the full investigation of a Chrome below-the-fold float bug and the layout shipped in response.

Changed

  • Front page: shorter tagline ("Good bones and road grit."); a CSS subgrid aligns the two section columns so their first post rows start on the same line, and the sidebar heading is baseline-aligned to the taller wide-column heading.
  • Sidebar thumbnails use a CSS grid (fixed thumbnail track + text column). A float wrap-under was the goal but proved unreliable in Chrome for below-the-fold entries on narrow/scaled viewports; the float is kept as a documented one-block alternative.
  • Every post now has a distinct featured image — "The build sheet" gets its own (a rusty Ford pickup), no longer sharing the Datsun with "Tools that earn their keep".

[0.1.5] - 2026-06-19

Added

  • Per-style accessibility sweep: axe runs against every global style variation with color-contrast gated, in CI and via a local npm run test:styles runner. All seven styles (including the dark Terminal, Amber CRT, and Blueprint themes) are contrast-clean.
  • Commit attribution: a commit-msg hook (.githooks/) requires a Co-Authored-By trailer on every commit.

Changed

  • Accessibility test suite graduated to gating: the confirmed-clean axe rule set (image-alt, link-name, label, heading-order, landmark-unique, region, color-contrast, button-name) now fails the build on regression, with coverage widened to a single post and the 404 template. The scan includes the best-practice tag so the heading/landmark rules are actually evaluated.
  • Photo-free package: removed the bundled CC-licensed photographs and refreshed the theme screenshot.
  • README overview and JavaScript-policy wording.

Fixed

  • Accessibility: the decorative h-card avatar (a 96px icon, alt="") inherited the theme-wide image lightbox, so core rendered an unnamed "enlarge" control (axe button-name, critical). Disabled the lightbox on that block.

0.1.4 - 2026-06-19

Fixed

  • Accessibility: removed the scrollable overlay captions from the front-page gallery (axe scrollable-region-focusable); alt text retained and CC credits remain in readme.txt.

Changed

  • WordPress.org Theme Check cleanup: removed the invalid block-theme tag, added a GPL copyright notice to readme.txt, and externalized the Playground seed so no base64_decode remains in the source.
  • Expanded the README overview and aligned the JavaScript policy wording with the core-Interactivity-first doctrine.
  • Repointed the stable and theme-test Playground blueprints at the release; added a theme-unit-test blueprint.

0.1.3 - 2026-06-18

Added

  • Archive (master index) and Search page templates.
  • Core WordPress 7.0 Breadcrumbs block in the header.
  • Core progressive enhancements — navigation overlay, enhanced (no-reload) query pagination, and image lightbox — each with a plain-HTML fallback.
  • Playground demo content (CC0 imagery and seed posts) and a Playwright end-to-end/accessibility harness with CI.
  • bin/package-check coverage for seed-content integrity, reconcile guardrails, the i18n text domain, and the image inventory.

Changed

  • Stated the JavaScript policy honestly: Dirtbag ships no theme-authored or bundled JavaScript, but WordPress core may load its own (the Interactivity API) when core blocks need it. Where a runtime is ever warranted the order is native HTML → core Interactivity API (the OEM part) → tiny vanilla JavaScript → aftermarket frameworks (Alpine/Reef/VanJS) as an approved exception.
  • Collapsed the style variations to their deltas over theme.json.
  • Documented the editor-controls policy, the CSS and i18n boundaries, and the Studio-versus-demo reseed policy.
  • Required WordPress 7.0 and PHP 7.2+.

Fixed

  • Microformats: h-card profile icon path, front-page post date binding, and u-url.
  • Made the post byline translatable via a pattern.
  • Corrected the GitHub (dknauss) and WordPress.org (dpknauss) usernames.
  • Accessibility: underlined links and post titles sized by heading level.

0.1.2 - 2026-06-18

Changed

  • Applied the barebones Playground export for the header and front page.

0.1.1 - 2026-06-18

Changed

  • Refined header layout.
  • Added Playground demo content.

0.1.0 - 2026-06-18

Added

  • Initial Dirtbag block theme release.