@particle-academy/fancy-slides 0.3.0 → 0.5.0

package/README.md

@@ -81,6 +81,41 @@ See `docs/human-plus.md` for the full contract.
 | `shape`  | SVG primitives (rect, ellipse, line, arrow) | |
 | `embed`  | iframe                                     | for video / external |
 
+## Build animations
+
+Any element can carry an `animation` to reveal it as an entrance "build step",
+the way PowerPoint/Keynote builds work:
+
+```ts
+element.animation = {
+    effect: "fly-in",      // "fade" | "fly-in" | "zoom" | "wipe"
+    trigger: "on-click",   // "on-click" (new step) | "with-prev" | "after-prev"
+    direction: "left",     // for fly-in / wipe
+    duration: 500,         // ms
+    delay: 0,              // ms
+    order: 0,              // build order, ascending; ties broken by element index
+    byParagraph: false,    // text only — reveal one line/bullet per click
+};
+```
+
+For a **text** element you can set `byParagraph: true` to reveal it one
+paragraph at a time (PowerPoint/Google Slides "By paragraph"). The element's
+`content` is split on `"\n"` (a trailing empty line is dropped) and expands into
+one build per line — the first line uses the element's own `trigger`, every
+subsequent line reveals on a fresh click. Each markdown line renders through the
+normal path, so a `- …` bullet line builds in as its own item. Toggle it from
+the Build tab when a text element has an effect selected.
+
+A slide's builds group into *click steps*: the first build and every
+`on-click` build opens a new step; `with-prev` plays alongside that step's lead
+and `after-prev` follows it. In `SlideViewer` / `PresenterView`, → / Space /
+click fires the next step, then advances to the next slide once all builds have
+run; ← steps back a whole slide shown fully built. Elements with no `animation`
+are always visible; the editor canvas always shows everything. All effects are
+pure CSS and honor `prefers-reduced-motion: reduce`. Edit builds in the
+inspector's **Build** tab (per element) and the **Build order** list in slide
+settings.
+
 ## Theme
 
 ```ts