=== Trunk Component Preview ===
Contributors: trunk
Tags: components, design system, preview
Requires at least: 6.4
Tested up to: 6.8
Requires PHP: 8.1
Stable tag: 0.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Preview design system components inside WordPress.

== Description ==

Describe the plugin here. This file follows the WordPress.org readme format;
keep it even for private plugins, as many update servers and tools parse it.

== Installation ==

1. Upload the `trunk-component-preview` folder to `/wp-content/plugins/`.
2. Run `composer install --no-dev` inside the plugin folder (optional — a
   fallback autoloader ships with the plugin).
3. Activate the plugin through the "Plugins" screen in WordPress.

== Changelog ==

= 0.2.1 =
* Components whose height is really scroll distance — stacked viewport-height sections
  built for a scroll-driven animation — are detected and declined with an explanation
  and a "Show it anyway" button, instead of being clamped to a mostly-empty box.
* Content that only appears once a scroll handler runs now appears: a synthetic scroll
  event is dispatched once a preview reaches its final height. Stat Highlight rows
  previewed as a bare "+" with no figure before this.
* New trunk_component_preview_css_vars filter for page-level custom properties. Without
  the theme's --accent-colour, CTA card hover states rendered white text on a white
  pill, because an undefined custom property makes an inherited declaration inherit.
* New trunk_component_preview_dispatch_events and
  trunk_component_preview_viewport_height_limit filters.

= 0.2.0 =
* Previews on ACF options pages, resolved to the archive the rows render on.
* Layouts with no fields of their own can be previewed; they used to open the
  preview in a new tab.
* Layout names keep their case, so CamelCase layouts resolve to the right view on
  a case-sensitive filesystem.
* Links and form submissions inside a preview no longer navigate the frame.
  Cmd/Ctrl-click still opens the real page in a new tab.
* Chat widgets, tag managers, analytics and consent banners are blocked inside
  previews, via the trunk_component_preview_blocked_urls filter.
* No preview toggle on screens where a component cannot be previewed at all.
* Preview heights are bounded, so a component sized in vh cannot grow without
  limit; the panel says when a height has been clamped.
* A theme script that throws inside a preview is reported in the panel and the
  browser console instead of silently costing the preview its styles.
* Components whose content is hidden until a scroll-reveal animation runs now show
  that content, instead of rendering as an empty box.
* A component's outer top and bottom margin is dropped in previews, since there are no
  neighbouring components for it to separate; its own padding is kept.
* Previews no longer scroll internally.
* Referrer policy is set on the document rather than as a header a server would
  override.

= 0.1.0 =
* Initial scaffold.
