@particle-academy/fancy-slides 0.3.0 → 0.5.0

package/dist/registry.d.cts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { h as SlideElement } from './types-B2ecrEAz.cjs';
+import { j as SlideElement } from './types-9BbelJX1.cjs';
 
 /**
  * Renderer signature compatible with `Slide`'s `renderElement` prop. Returns

package/dist/registry.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { h as SlideElement } from './types-B2ecrEAz.js';
+import { j as SlideElement } from './types-9BbelJX1.js';
 
 /**
  * Renderer signature compatible with `Slide`'s `renderElement` prop. Returns

package/dist/{types-B2ecrEAz.d.cts → types-9BbelJX1.d.cts}

@@ -68,6 +68,42 @@ interface ElementBase {
     locked?: boolean;
     /** Hide on this slide (still in the data — for animated reveals). */
     hidden?: boolean;
+    /** Entrance build animation — when present the element participates in the slide's build sequence. */
+    animation?: ElementAnimation;
+}
+/** Visual entrance effect played when an element builds onto the slide. */
+type AnimationEffect = "fade" | "fly-in" | "zoom" | "wipe";
+/** When an element's build fires relative to the surrounding builds. */
+type AnimationTrigger = "on-click" | "with-prev" | "after-prev";
+/**
+ * Per-element entrance animation ("build step"). Elements with an `animation`
+ * start hidden and reveal as the presenter advances through the slide's build
+ * sequence. The shape is shared with the sibling `dark-slide` PHP package, so
+ * keep it byte-for-byte aligned.
+ */
+interface ElementAnimation {
+    /** Visual effect. */
+    effect: AnimationEffect;
+    /** When the build fires relative to its neighbours. Default `"on-click"`. */
+    trigger?: AnimationTrigger;
+    /** Direction for `fly-in` / `wipe`. Default `"left"`. */
+    direction?: "left" | "right" | "up" | "down";
+    /** Effect duration in ms. Default `500`. */
+    duration?: number;
+    /** Delay before the effect starts, in ms. Default `0`. */
+    delay?: number;
+    /** Build order within the slide, ascending; ties broken by element array index. */
+    order?: number;
+    /**
+     * Reveal a TEXT element one paragraph/line at a time (PowerPoint/Google
+     * Slides "By paragraph"). The element expands into one build per paragraph
+     * — the element's `content` split on `"\n"` (a trailing empty line is
+     * dropped). The first paragraph uses this animation's `trigger`; every
+     * subsequent paragraph reveals on a fresh click. Only meaningful for text
+     * elements; ignored for other types and when the element has 0/1 paragraphs
+     * (then it behaves like a normal single build).
+     */
+    byParagraph?: boolean;
 }
 interface TextElement extends ElementBase {
     type: "text";
@@ -289,6 +325,11 @@ type DeckOp = {
     elementId: string;
     w: number;
     h: number;
+} | {
+    kind: "element_set_animation";
+    slideId: string;
+    elementId: string;
+    animation?: ElementAnimation;
 };
 
-export type { ChartElement as C, Deck as D, ElementBase as E, ImageElement as I, ShapeElement as S, TableElement as T, CodeElement as a, DeckActivity as b, DeckOp as c, EmbedElement as d, ShapeKind as e, Slide as f, SlideBackground as g, SlideElement as h, SlideLayout as i, SlideTransition as j, TextElement as k, TextStyle as l, Theme as m, ThemeColors as n, ThemeFonts as o, TransitionKind as p };
+export type { AnimationEffect as A, ChartElement as C, Deck as D, ElementAnimation as E, ImageElement as I, ShapeElement as S, TableElement as T, AnimationTrigger as a, CodeElement as b, DeckActivity as c, DeckOp as d, ElementBase as e, EmbedElement as f, ShapeKind as g, Slide as h, SlideBackground as i, SlideElement as j, SlideLayout as k, SlideTransition as l, TextElement as m, TextStyle as n, Theme as o, ThemeColors as p, ThemeFonts as q, TransitionKind as r };

package/dist/{types-B2ecrEAz.d.ts → types-9BbelJX1.d.ts}

@@ -68,6 +68,42 @@ interface ElementBase {
     locked?: boolean;
     /** Hide on this slide (still in the data — for animated reveals). */
     hidden?: boolean;
+    /** Entrance build animation — when present the element participates in the slide's build sequence. */
+    animation?: ElementAnimation;
+}
+/** Visual entrance effect played when an element builds onto the slide. */
+type AnimationEffect = "fade" | "fly-in" | "zoom" | "wipe";
+/** When an element's build fires relative to the surrounding builds. */
+type AnimationTrigger = "on-click" | "with-prev" | "after-prev";
+/**
+ * Per-element entrance animation ("build step"). Elements with an `animation`
+ * start hidden and reveal as the presenter advances through the slide's build
+ * sequence. The shape is shared with the sibling `dark-slide` PHP package, so
+ * keep it byte-for-byte aligned.
+ */
+interface ElementAnimation {
+    /** Visual effect. */
+    effect: AnimationEffect;
+    /** When the build fires relative to its neighbours. Default `"on-click"`. */
+    trigger?: AnimationTrigger;
+    /** Direction for `fly-in` / `wipe`. Default `"left"`. */
+    direction?: "left" | "right" | "up" | "down";
+    /** Effect duration in ms. Default `500`. */
+    duration?: number;
+    /** Delay before the effect starts, in ms. Default `0`. */
+    delay?: number;
+    /** Build order within the slide, ascending; ties broken by element array index. */
+    order?: number;
+    /**
+     * Reveal a TEXT element one paragraph/line at a time (PowerPoint/Google
+     * Slides "By paragraph"). The element expands into one build per paragraph
+     * — the element's `content` split on `"\n"` (a trailing empty line is
+     * dropped). The first paragraph uses this animation's `trigger`; every
+     * subsequent paragraph reveals on a fresh click. Only meaningful for text
+     * elements; ignored for other types and when the element has 0/1 paragraphs
+     * (then it behaves like a normal single build).
+     */
+    byParagraph?: boolean;
 }
 interface TextElement extends ElementBase {
     type: "text";
@@ -289,6 +325,11 @@ type DeckOp = {
     elementId: string;
     w: number;
     h: number;
+} | {
+    kind: "element_set_animation";
+    slideId: string;
+    elementId: string;
+    animation?: ElementAnimation;
 };
 
-export type { ChartElement as C, Deck as D, ElementBase as E, ImageElement as I, ShapeElement as S, TableElement as T, CodeElement as a, DeckActivity as b, DeckOp as c, EmbedElement as d, ShapeKind as e, Slide as f, SlideBackground as g, SlideElement as h, SlideLayout as i, SlideTransition as j, TextElement as k, TextStyle as l, Theme as m, ThemeColors as n, ThemeFonts as o, TransitionKind as p };
+export type { AnimationEffect as A, ChartElement as C, Deck as D, ElementAnimation as E, ImageElement as I, ShapeElement as S, TableElement as T, AnimationTrigger as a, CodeElement as b, DeckActivity as c, DeckOp as d, ElementBase as e, EmbedElement as f, ShapeKind as g, Slide as h, SlideBackground as i, SlideElement as j, SlideLayout as k, SlideTransition as l, TextElement as m, TextStyle as n, Theme as o, ThemeColors as p, ThemeFonts as q, TransitionKind as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/fancy-slides",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Presentation editor + web viewer for the fancy UI set — Google-Slides-style deck authoring with a JSON-friendly schema, full keyboard-driven viewer, and an agent bridge so LLMs can compose decks directly.",
   "repository": {
     "type": "git",