@particle-academy/fancy-slides 0.8.0 → 0.10.0

package/dist/registry.d.cts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { j as SlideElement } from './types-9BbelJX1.cjs';
+import { k as SlideElement } from './types-C3w37g3A.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 { j as SlideElement } from './types-9BbelJX1.js';
+import { k as SlideElement } from './types-C3w37g3A.js';
 
 /**
  * Renderer signature compatible with `Slide`'s `renderElement` prop. Returns

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

@@ -22,9 +22,21 @@ interface Deck {
     slides: Slide[];
     /** Visual theme for the whole deck. */
     theme: Theme;
+    /**
+     * Schema version the deck was authored against. Omitted == version 1 (the
+     * implicit version for decks created before versioning). Used by the
+     * serialize / parse helpers to migrate older shapes forward. Mirrors
+     * `dark-slide`'s `Schema::SCHEMA_VERSION`.
+     */
+    version?: number;
     /** Free-form metadata — `{ author, createdAt, updatedAt, tags, … }`. */
     metadata?: Record<string, unknown>;
 }
+/**
+ * Current deck schema version. Bump when a structural change needs migration on
+ * load. Kept in lockstep with the sibling `dark-slide` PHP package.
+ */
+declare const SCHEMA_VERSION = 1;
 /** Layout presets that pre-populate / constrain element placement. */
 type SlideLayout = "blank" | "title" | "title-content" | "two-column" | "section-divider" | "image-text" | "text-image" | "quote";
 interface Slide {
@@ -68,6 +80,13 @@ interface ElementBase {
     locked?: boolean;
     /** Hide on this slide (still in the data — for animated reveals). */
     hidden?: boolean;
+    /**
+     * Whole-element hyperlink. When set, the element becomes a click target in
+     * the viewer (opens in a new tab) and the pptx writer emits an
+     * `<a:hlinkClick>` on the shape / picture. For rich inline links *within*
+     * text, use a markdown `[label](url)` in the text content instead.
+     */
+    href?: string;
     /** Entrance build animation — when present the element participates in the slide's build sequence. */
     animation?: ElementAnimation;
 }
@@ -273,6 +292,11 @@ type DeckOp = {
 } | {
     kind: "deck_apply_theme";
     theme: Theme;
+}
+/** Replace the entire deck atomically — stream a full presentation IN in one op. */
+ | {
+    kind: "deck_set";
+    deck: Deck;
 } | {
     kind: "slide_add";
     index: number;
@@ -332,4 +356,4 @@ type DeckOp = {
     animation?: ElementAnimation;
 };
 
-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 };
+export { type AnimationEffect as A, type ChartElement as C, type Deck as D, type ElementAnimation as E, type ImageElement as I, SCHEMA_VERSION as S, type TableElement as T, type AnimationTrigger as a, type CodeElement as b, type DeckActivity as c, type DeckOp as d, type ElementBase as e, type EmbedElement as f, type ShapeElement as g, type ShapeKind as h, type Slide as i, type SlideBackground as j, type SlideElement as k, type SlideLayout as l, type SlideTransition as m, type TextElement as n, type TextStyle as o, type Theme as p, type ThemeColors as q, type ThemeFonts as r, type TransitionKind as s };

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

@@ -22,9 +22,21 @@ interface Deck {
     slides: Slide[];
     /** Visual theme for the whole deck. */
     theme: Theme;
+    /**
+     * Schema version the deck was authored against. Omitted == version 1 (the
+     * implicit version for decks created before versioning). Used by the
+     * serialize / parse helpers to migrate older shapes forward. Mirrors
+     * `dark-slide`'s `Schema::SCHEMA_VERSION`.
+     */
+    version?: number;
     /** Free-form metadata — `{ author, createdAt, updatedAt, tags, … }`. */
     metadata?: Record<string, unknown>;
 }
+/**
+ * Current deck schema version. Bump when a structural change needs migration on
+ * load. Kept in lockstep with the sibling `dark-slide` PHP package.
+ */
+declare const SCHEMA_VERSION = 1;
 /** Layout presets that pre-populate / constrain element placement. */
 type SlideLayout = "blank" | "title" | "title-content" | "two-column" | "section-divider" | "image-text" | "text-image" | "quote";
 interface Slide {
@@ -68,6 +80,13 @@ interface ElementBase {
     locked?: boolean;
     /** Hide on this slide (still in the data — for animated reveals). */
     hidden?: boolean;
+    /**
+     * Whole-element hyperlink. When set, the element becomes a click target in
+     * the viewer (opens in a new tab) and the pptx writer emits an
+     * `<a:hlinkClick>` on the shape / picture. For rich inline links *within*
+     * text, use a markdown `[label](url)` in the text content instead.
+     */
+    href?: string;
     /** Entrance build animation — when present the element participates in the slide's build sequence. */
     animation?: ElementAnimation;
 }
@@ -273,6 +292,11 @@ type DeckOp = {
 } | {
     kind: "deck_apply_theme";
     theme: Theme;
+}
+/** Replace the entire deck atomically — stream a full presentation IN in one op. */
+ | {
+    kind: "deck_set";
+    deck: Deck;
 } | {
     kind: "slide_add";
     index: number;
@@ -332,4 +356,4 @@ type DeckOp = {
     animation?: ElementAnimation;
 };
 
-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 };
+export { type AnimationEffect as A, type ChartElement as C, type Deck as D, type ElementAnimation as E, type ImageElement as I, SCHEMA_VERSION as S, type TableElement as T, type AnimationTrigger as a, type CodeElement as b, type DeckActivity as c, type DeckOp as d, type ElementBase as e, type EmbedElement as f, type ShapeElement as g, type ShapeKind as h, type Slide as i, type SlideBackground as j, type SlideElement as k, type SlideLayout as l, type SlideTransition as m, type TextElement as n, type TextStyle as o, type Theme as p, type ThemeColors as q, type ThemeFonts as r, type TransitionKind as s };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/fancy-slides",
-  "version": "0.8.0",
+  "version": "0.10.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",