Breakpoints

Crafty Hedge

Version 1.0.0

August 31, 2026

First stable release.
Restricted JavaScript lazy-loading adapters to none (default) and lazysizes. Removed attributes, custom, Vanilla LazyLoad, and Lozad, along with configurable lazy attribute names and the custom processing handler. Leftover config values fall back to none. Native lazy loading forces adapter none for processing as well as render. Use a custom template for any other library.
Aligned the Settings model thumbhashMode default with plugin config (srcset).
Documented the local-admin front-end process button in Getting Started.
Documented that processing must be run at 100% browser zoom.

Version 0.1.10

August 10, 2026

Added a local-admin front-end process button that appears when a page renders at least one unsaved (non-SVG) transform set, deep-linking into Control Panel processing with auto-run enabled.
Added frontendProcessButtonPosition config (bottom-right, bottom-left, top-right, top-left; default bottom-right) for that button’s corner placement.
Fixed Transform Tracking usage-clear actions so they only require an admin account, not allowAdminChanges, matching runtime bpi_* row clears on staging without full project-config write access.
Removed a redundant Datastar data-persist attribute from the Transform Sets editor markup.

Version 0.1.9

July 6, 2026

Added an "allow hidden" option for transform sets so images that are intentionally hidden on page load (e.g. interaction-only navigation cards) no longer get flagged as mismatches after processing.
Improved hidden-image warning messaging and review handling around hidden and mismatched assets.
Added an escape option with an includeEscapeWidth fallback for breakpoint policy.
Disabled ThumbHash rendering for breakpoint slots that are disabled.
Improved styling for allowed dimension mismatches in the review UI.
Added a button to auto-run processing directly from the Transform Tracking listing.
Added a "delete row(s)" control and fixed the disable behaviour for the Transform Tracking utility.
Fixed various Transform Sets screen UI issues, including toolbar spacing and the compact-cards toggle placement.
Expanded and clarified configuration and getting-started documentation, including ThumbHash modes and the new "allow hidden" set option.

Version 0.1.8

June 30, 2026

Registered the ThumbHash frontend script whenever the integration is enabled and available, instead of tying script registration to per-asset placeholder eligibility.

Version 0.1.7

June 29, 2026

Added optional integration with craftyhedge/craft-thumbhash, including global settings, config options, and per-image thumbhash / thumbhashMode overrides.
Added ThumbHash render modes for picture-level background placeholders and per-source srcset hashes, with transparent SVG placeholders sized to the fallback image when JavaScript lazy loading is active.
Improved non-native lazy-loading output so configured JavaScript lazy-loading adapters move src, srcset, and sizes into the configured data attributes and add the expected image class for lazysizes, Vanilla LazyLoad, or Lozad.
Kept ThumbHash and non-native lazy-loading behavior disabled for native lazy loading, eager images, and priority images.
Added prebuilt breakpointData to picture templates so custom templates that use the provided arrays can receive render-adapter attribute updates without extra template changes.
Improved the settings UI so fields controlled by config/breakpoints.php are disabled inline while preserving their config override warnings.
Clarified DPR documentation to note that project config and Twig options can use any positive numeric ratio, not only the Control Panel's common 2x and 3x presets.
Expanded documentation and tests for ThumbHash, JavaScript lazy-loading output, custom template data, settings validation, and render-context behavior.

Version 0.1.6

June 28, 2026

Added a Transform Tracking utility for development and staging use, with grouped frontend transform-set observations, missing saved-set status, source/page details, and clear tracking controls.
Added processing links for missing observed transform sets, preferring source entry IDs and falling back to observed source URLs.
Added URL-based processing support alongside entry processing, including clearer handling for invalid or missing source URLs.
Removed observation details from the main Transform Sets review UI now that tracking lives in the dedicated utility.

Version 0.1.5

June 27, 2026

Added art-directed raster image sources via image() options, allowing selected canonical slots to render from alternate Craft assets within one <picture> with optional source-specific quality. Custom picture templates that use craft.images.getBreakpointData() continue to receive the correct per-slot source asset automatically.
Added priority and preload options for image() so above-the-fold images can register responsive preload links, including art-directed source assets.

Version 0.1.4

June 21, 2026

Improved lazy-loading activation during processing, especially for lazysizes, by widening lazy-load thresholds, clearing stale lazysizes state, and recording activation diagnostics.
Fixed lazy-loaded placeholder handling so rows remain pending or unresolved until the intended lazy target source is actually promoted, preventing placeholder URLs from being treated as successful transform measurements.
Improved processing readiness tracking for duplicate picture IDs and asset-only picture markers so repeated transform uses are measured as separate images.
Improved processing completion messaging so existing transform sets skipped during auto-save are treated as already saved, clean runs report when no new sets were created, and rendered mismatches keep the final status in a warning state.
Improved review cards for breakpoint and asset mismatches with live card warning signals, resolved-mismatch review states, mismatch counts, clearer mismatch copy, and prioritised ordering for newly created transform sets.
Fixed auto-saving for observed processed transform sets when the saved-set signal is stale, and highlighted newly created transform sets in the rendered review.
Improved review thumbnails and fallback sizing to prefer the resolved sourceUsed URL over lazy-loading placeholder sources.
Fixed compact breakpoint cards so escape-width badges wrap cleanly.
Expanded getting-started and responsive-image documentation with workflow screenshots, clearer review-warning guidance, height-warning notes, and transform-service compatibility notes.
Expanded JavaScript and PHP test coverage for lazy-loading activation, stale lazy targets, duplicate picture IDs, processing completion states, new-set review rendering, source selection, and fallback dimensions.

Version 0.1.3

June 12, 2026

Fixed final-breakpoint processing so each transform set uses its configured normal or escape-width measurement, with a fallback warning when the preferred measurement is unavailable.
Improved processing source selection by activating the requested picture sources and accepting lazy-loaded fallback formats from the selected breakpoint slot.
Reduced the breakpoint measurement margin from 2px to 1px for more accurate viewport-boundary measurements.
Improved allowed-height controls with clearer Shorter heights allowed and All heights allowed indicators and a more responsive options layout.
Added documentation for allowed-height settings and transform-set notes.
Expanded JavaScript and PHP test coverage for final measurements, source activation, lazy-loaded fallback formats, and allowed-height indicators.

Version 0.1.2

June 12, 2026

Added explicit lazy-loading adapters for processing previews, with support for attribute-based loading, lazysizes, vanilla-lazyload, lozad, and custom handlers.
Improved processing reliability for lazy-loaded images, source assets, hidden or skipped breakpoints, and transform dimension changes that require another processing run.
Added direct ratio copying and ratio removal controls for individual or all breakpoints, with clearer scope handling and editor state updates.
Improved transform review feedback for edited, stale, matching, and mismatched dimensions, including clearer warnings and a Process Again state after edits.
Improved observed transform usage so only raster images are recorded and source entry information remains available when no processing run exists.
Simplified database settings around clearing observed usage, processing snapshots, and preview cache data.
Improved the Transform Sets interface with more consistent tab state, styling fixes, disabled invalid ratio-copy choices, and a heading for the currently displayed sets.
Expanded configuration and getting-started documentation for processing adapters and review warnings.

Version 0.1.1

June 10, 2026

Added data-set attributes to picture output so transform usage can be tracked outside processing previews without leaking internal processing markers.
Wrapped SVG output in <picture> markup, preserving picture/image classes while excluding SVGs from transform processing.
Improved handling for observed transform handles that are no longer found on the processed page, including clearer review warnings and an option to remove stale observations.
Kept observed-but-unsaved transform handles out of the sidebar while preserving them in the review flow where they can be processed or dismissed.
Added test coverage for SVG processing exclusions, editable picture attributes, observed-handle review states, and sidebar cleanup behavior.

Version 0.1.0

June 8, 2026

Initial beta release for Craft CMS 5.