loading-state-zoo 0.4.0 → 0.4.1

package/README.md

@@ -1,6 +1,8 @@
 # loading-state-zoo
 
-**30 loading patterns, one tiny package.** Dots, spinners, orbs, AI, shapes, bars, music and skeletons that tell the user "please wait" — made silky smooth and ready to use in **React**, **plain websites**, and **iOS / Android apps**.
+**26 loading patterns, one tiny package.** Dots, spinners, orbs, shapes, bars, music and skeletons that tell the user "please wait" — made silky smooth and ready to use in **React**, **plain websites**, and **iOS / Android apps**.
+
+> **Recommended production version.** v0.4.1 is the stable, production-tested line of `loading-state-zoo`. Install `npm i loading-state-zoo@^0.4.1` for the latest recommended release.
 
 Think of it as a small zoo of loading animals. You pick an animal, put it in your app's cage, and it starts moving right away. You can even change its **color**, **size** and **speed** — no scissors or glue required.
 
@@ -29,10 +31,6 @@ Think of it as a small zoo of loading animals. You pick an animal, put it in you
 | [Orbit dots](#orbit-dots) | Spinner | Floaty, lightweight loading |
 | [Orbit ring dots](#orbit-ring-dots) | Spinner | Cosmetic ring, data-heavy load |
 | [Sonar](#sonar) | Spinner | Radar pings, location detection |
-| [iOS 27 orb](#ios-27-orb) | Orbs | Voice assistants, AI thinking, holographic waits |
-| [AI orb](#ai-orb) | AI | AI assistants, generative waits |
-| [AI thinking](#ai-thinking) | AI | Chat completions, waiting on answers |
-| [AI neural](#ai-neural) | AI | Neural nets, model training |
 | [Eyes](#eyes) | Shape | Fun state, "watching" waiting |
 | [Morphing square](#morphing-square) | Shape | Modern brand moments |
 | [Breathing pulse](#breathing-pulse) | Shape | Subtle, gentle "alive" loading |
@@ -83,7 +81,7 @@ export function MyLoader() {
 }
 ```
 
-That's it. Importing the package **automatically registers** all 30 elements for you (it's safe to import in many places — duplicates are skipped). It is also safe on the server (SSR/Next.js): on Node there is no browser, so nothing registers and nothing breaks.
+That's it. Importing the package **automatically registers** all 26 elements for you (it's safe to import in many places — duplicates are skipped). It is also safe on the server (SSR/Next.js): on Node there is no browser, so nothing registers and nothing breaks.
 
 If you prefer to register manually:
 
@@ -111,7 +109,7 @@ Add the package from a CDN (or bundle it) and write the tags directly in your HT
 </div>
 ```
 
-Mix and match any of the 30 tags — see the full list below.
+Mix and match any of the 26 tags — see the full list below.
 
 ---
 
@@ -235,9 +233,6 @@ Every number inside every animation is also a CSS variable. Change how far dots
 | `--lz-eq-min` | Equalizer | Shortest bar height | `0.3` |
 | `--lz-slide-from` | Indeterminate bar | Slider start position | `-100%` |
 | `--lz-slide-to` | Indeterminate bar | Slider end position | `300%` |
-| `--lz-ios-fade` | iOS 27 orb | Resting dot opacity | `0.2` |
-| `--lz-ios-min` | iOS 27 orb | Resting dot scale | `0.5` |
-| `--lz-ios-peak` | iOS 27 orb | Glowing dot scale | `1.25` |
 | `--lz-wf-min` | Waveform | Resting bar scale | `0.22` |
 | `--lz-sonar-fade` | Sonar | Ring start opacity | `0.9` |
 | `--lz-note-bob` | Music note | Note bob height | `0.35em` |
@@ -444,73 +439,6 @@ Variables: `--lz-dot-size` · `--lz-orbit-fade`.
 
 ---
 
-### iOS 27 orb
-
-**What it is:** an orb of 27 dots where a bright glow travels from the dot being "touched" to the next, spiraling inward like an iOS listening animation. **Good for:** voice assistants, AI thinking, holographic waits.
-
-```html
-<lz-ios-27-orb size="64" accent="#64d2ff" color="#bf5af2"></lz-ios-27-orb>
-```
-
-```tsx
-<Ios27Orb size={64} accent="#64d2ff" color="#bf5af2" />
-```
-
-Attributes: `size` (default `44`) · `accent` (warm pole hue, default `#0a84ff`) · `color` (cool pole hue, default `#f5f5f7`) · `speed`.
-Variables: `--lz-ios-fade` · `--lz-ios-min` · `--lz-ios-peak`.
-
----
-
-### AI orb
-
-**What it is:** a breathing gradient sphere with an orbiting light dot and twinkling sparkles. **Good for:** AI assistants, generative waits, "smart" ready states.
-
-```html
-<lz-ai-orb size="64" accent="#bf5af2"></lz-ai-orb>
-```
-
-```tsx
-<AiOrb size={64} accent="#bf5af2" />
-```
-
-Attributes: `size` (default `44`) · `accent` (default `#0a84ff`) · `color` (sparkles) · `speed`.
-
----
-
-### AI thinking
-
-**What it is:** a rounded thinking field with typing dots wrapped in a rotating accent ring. **Good for:** chat completions, AI replies, waiting on answers.
-
-```html
-<lz-ai-thinking size="44" accent="#30d158"></lz-ai-thinking>
-```
-
-```tsx
-<AiThinking size={44} accent="#30d158" />
-```
-
-Attributes: `size` (default `40`) · `accent` (default `#0a84ff`) · `color` (typing dots) · `speed`.
-Variables: `--lz-surface` (field background).
-
----
-
-### AI neural
-
-**What it is:** a grid of dots pulsing like an artificial neural network with a diagonal activation wave. **Good for:** neural nets, model training, data pipelines.
-
-```html
-<lz-ai-neural rows="4" cols="7" accent="#fa114f"></lz-ai-neural>
-```
-
-```tsx
-<AiNeural rows={4} cols={7} accent="#fa114f" />
-```
-
-Attributes: `size` (default `6`) · `rows` (default `3`) · `cols` (default `5`) · `gap` (default `10`) · `accent` (checking neurons) · `color` (resting neurons) · `speed`.
-Variables: `--lz-grid-gap` · `--lz-grid-min` · `--lz-grid-fade`.
-
----
-
 ### Eyes
 
 **What it is:** two cartoon eyes that look side to side and blink. **Good for:** fun apps, "watching" moments, kids' stuff.