=== Blockwist Toolkit ===
Contributors: danbandi
Tags: block editor, animation, effects, gutenberg, accessibility
Requires at least: 6.6
Tested up to: 7.1
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Extend WordPress core blocks with lightweight editor and frontend enhancements, including scroll animations.

== Description ==

Blockwist Toolkit extends supported WordPress core blocks with lightweight editor and frontend enhancements.

It is designed to complement the native WordPress block experience rather than replace it. Toolkit works with Blockwist and other compatible WordPress themes, so the Blockwist theme is not required.

The initial release focuses on scroll animations. Select a supported block in the editor and choose an entrance effect, duration, delay, and whether the animation should play once or replay when the block leaves and re-enters the viewport.

= Scroll Animations =

Choose from six entrance effects:

* Fade
* Fade Up
* Fade Down
* Fade Left
* Fade Right
* Zoom In

Animation controls are integrated directly into the block editor and include:

* Animation effect
* Duration
* Delay
* Play once or replay

= Supported Blocks =

Scroll animations are currently available for:

* Group
* Columns and Column
* Cover
* Image
* Media & Text
* Heading
* Paragraph
* Buttons and Button

= Native and Lightweight =

Blockwist Toolkit uses native WordPress block APIs, local CSS, and a small vanilla JavaScript runtime.

It does not require an external animation library, remote service, account, or theme dependency.

= Progressive Enhancement =

Animations are treated as an enhancement rather than a requirement for accessing your content.

Content remains visible when JavaScript is unavailable, IntersectionObserver is unsupported, reduced motion is requested, or Toolkit is deactivated.

= Works Beyond Blockwist =

Despite its name, Blockwist Toolkit does not require the Blockwist theme.

Toolkit enhances supported WordPress core blocks and can be used with Blockwist, Blockwist child themes, and other compatible WordPress themes.

== Installation ==

1. Upload the `blockwist-toolkit` folder to `/wp-content/plugins/`, or install the plugin ZIP through Plugins > Add New.
2. Activate Blockwist Toolkit.
3. Select a supported block in the Block Editor.
4. Open the Blockwist Effects panel and configure the available enhancement.

For version 1.0.0, the available enhancement is Scroll Animations.

== Frequently Asked Questions ==

= Does Blockwist Toolkit require the Blockwist theme? =

No. Blockwist Toolkit works independently of the Blockwist theme. It enhances supported WordPress core blocks and can be used with Blockwist, Blockwist child themes, and other compatible WordPress themes.

= What does Blockwist Toolkit add? =

Blockwist Toolkit is designed to provide lightweight enhancements for supported WordPress core blocks.

Version 1.0.0 focuses on scroll animations, including six entrance effects with duration, delay, and play-once or replay controls.

= Does Toolkit replace WordPress blocks with its own blocks? =

No. Toolkit enhances supported WordPress core blocks rather than replacing them with a separate page-building system.

= What happens if I deactivate the plugin? =

Your WordPress block content remains intact and renders normally.

= Does the plugin respect reduced-motion preferences? =

Yes. When `prefers-reduced-motion: reduce` is active, Toolkit does not hide or animate affected content.

= Does it load an animation library? =

No. The current scroll-animation feature uses local CSS and a small vanilla JavaScript runtime.

= Does Blockwist Toolkit use external services or tracking? =

No. Version 1.0.0 does not require an account, external service, telemetry, or tracking.

== Changelog ==

= 1.0.0 =

* Initial release.
* Added lightweight scroll-animation controls for supported WordPress core blocks.
* Added six entrance effects: Fade, Fade Up, Fade Down, Fade Left, Fade Right, and Zoom In.
* Added duration, delay, and play-once or replay controls.
* Added reduced-motion support and fail-open frontend behavior.
* Added compatibility with Blockwist and other compatible WordPress themes.