=== Starry Sky – Interactive Night Sky Cover Block ===
Contributors: paxblueribbon
Tags: block, cover, stars, hero, parallax
Requires at least: 6.3
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A cover-like block with a realistic black starry sky that reacts to mouse movement. Drop any blocks on top.

== Description ==

Starry Sky adds a container block that behaves like the core Cover block — you
can nest any blocks on top of it (headings, paragraphs, buttons, etc.) — but
instead of a background image it paints a realistic night sky on an HTML canvas:

* Hundreds of stars with varied sizes, brightness, and true stellar colours
  (blue-white, white, warm, orange, and red), rendered with a soft glow.
* Diffraction "sparkle" spikes on the brightest stars.
* Gentle twinkling.
* Mouse interaction: the whole field parallaxes with the pointer (nearer stars
  move more), and stars near the cursor are pushed away and spring back — a
  push-and-pull that follows the mouse.
* Click the sky to launch a shooting star from that point.
* Occasional shooting stars drift by on their own, at a rate you set
  (shooting stars per minute; 0 to turn them off).

Settings (block sidebar):

* Minimum height
* Star density
* React to mouse movement (on/off)
* Twinkle (on/off)
* Shooting star on click (on/off)
* Shooting stars per minute (0–30; 0 = off)
* Sky colour
* Vertical alignment of the overlaid content (toolbar)

Accessibility & performance:

* Respects `prefers-reduced-motion` (renders a static sky, no animation or
  pointer reaction).
* Uses pre-baked sprites and pauses rendering while the block is off-screen.

== Installation ==

1. Copy the `starry-sky` folder into `wp-content/plugins/` (or zip the folder and
   upload it via Plugins → Add New → Upload Plugin).
2. Activate "Starry Sky".
3. In the editor, add the **Starry Sky** block and drop content on top.

No build step is required — the plugin ships ready to run.

== Changelog ==

= 1.0.0 =
* Initial release.
