@particle-academy/fancy-slides 0.3.0 → 0.4.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-P-9MmnGU.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-P-9MmnGU.js';
 
 /**
  * Renderer signature compatible with `Slide`'s `renderElement` prop. Returns

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

@@ -68,6 +68,32 @@ 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;
 }
 interface TextElement extends ElementBase {
     type: "text";
@@ -289,6 +315,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-P-9MmnGU.d.ts}

@@ -68,6 +68,32 @@ 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;
 }
 interface TextElement extends ElementBase {
     type: "text";
@@ -289,6 +315,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.4.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",