=== Block Override Inspector ===
Contributors: simonbek
Tags: gutenberg, block editor, theme json, design system, audit
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find local Gutenberg style overrides and compare them with your site's design presets.

== Description ==

Block Override Inspector scans published Gutenberg content for local block style values and compares them with the site's WordPress design presets.

The report helps site administrators find:

* The content and block containing an override.
* The current local value.
* An exact matching preset, when one exists.
* The closest compatible font-size or spacing preset.
* Values with no matching preset or values that cannot yet be compared safely.

The plugin analyzes colors, typography, spacing, borders, and block-level custom CSS exposed by WordPress block attributes. It scans Posts, Pages, and public editor-enabled custom post types in batches, including nested blocks.

Block Override Inspector is read-only. It does not edit post content, replace values, create database tables, send telemetry, or connect to external services.

== Installation ==

1. Upload the `block-override-inspector` folder to `/wp-content/plugins/`, or install the plugin ZIP from the WordPress Plugins screen.
2. Activate Block Override Inspector.
3. Open Tools > Block Override Inspector.
4. Select Scan Site to run a manual audit.

== Frequently Asked Questions ==

= Does the plugin change block content? =

No. Version 0.1.1 only reads block attributes and WordPress design presets.

= Are scan results stored? =

No. Results exist only for the current admin request and are not stored in the database.

= Which content is scanned? =

Published Posts, Pages, and public custom post types that use the WordPress editor are scanned. Nested Gutenberg blocks are included.

= Why does a result say "Not compared yet"? =

The value remains visible, but the plugin does not have a reliable matcher for that property or cannot compare its CSS unit safely.

== Screenshots ==

1. Scan summary and design-system match statistics.
2. Searchable and filterable local override report.

== Changelog ==

= 0.1.1 =

* Redesigned the admin interface and improved the empty state, statistics, filters, and results table.

= 0.1.0 =

* Initial free release.
* Added manual batched site scanning for Gutenberg content.
* Added local override detection for color, typography, spacing, border, and custom CSS values.
* Added exact and closest compatible preset matching.
* Added scan statistics, block paths, filters, search, and editor links.

== Upgrade Notice ==

= 0.1.1 =

Introduces a redesigned admin interface with improved reporting and navigation.

= 0.1.0 =

Initial release.
