@particle-academy/fancy-slides 0.9.0 → 0.11.0

package/dist/index.cjs

@@ -1793,6 +1793,7 @@ function useDeckState({ value, onChange, onOp }) {
       apply,
       setTitle: (title) => apply({ kind: "deck_set_title", title }),
       applyTheme: (theme) => apply({ kind: "deck_apply_theme", theme }),
+      setDeck: (deck) => apply({ kind: "deck_set", deck }),
       addSlide: (index, partial) => {
         const id = partial?.id ?? slideId();
         const slide = {
@@ -1847,6 +1848,8 @@ function reduce(deck, op) {
       return { ...deck, title: op.title };
     case "deck_apply_theme":
       return { ...deck, theme: op.theme };
+    case "deck_set":
+      return op.deck;
     case "slide_add": {
       const slides = [...deck.slides];
       slides.splice(Math.max(0, Math.min(slides.length, op.index)), 0, op.slide);
@@ -3357,6 +3360,74 @@ function DeckEditor({
 // src/types.ts
 var SCHEMA_VERSION = 1;
 
+// src/utils/serialize.ts
+var ELEMENT_TYPES = ["text", "image", "chart", "code", "table", "shape", "embed"];
+function validateDeck(deck) {
+  const errors = [];
+  const d = deck;
+  if (!d || typeof d !== "object") {
+    return { ok: false, errors: ["deck is not an object"] };
+  }
+  if (typeof d.id !== "string" || !d.id) errors.push("deck.id must be a non-empty string");
+  if (typeof d.title !== "string") errors.push("deck.title must be a string");
+  if (!d.theme || typeof d.theme !== "object") errors.push("deck.theme must be an object");
+  if (!Array.isArray(d.slides)) {
+    errors.push("deck.slides must be an array");
+    return { ok: errors.length === 0, errors };
+  }
+  d.slides.forEach((slide, si) => {
+    if (!slide || typeof slide !== "object") {
+      errors.push(`slides[${si}] is not an object`);
+      return;
+    }
+    if (typeof slide.id !== "string" || !slide.id) errors.push(`slides[${si}].id must be a non-empty string`);
+    if (!Array.isArray(slide.elements)) {
+      errors.push(`slides[${si}].elements must be an array`);
+      return;
+    }
+    slide.elements.forEach((el, ei) => {
+      const where = `slides[${si}].elements[${ei}]`;
+      if (!el || typeof el !== "object") {
+        errors.push(`${where} is not an object`);
+        return;
+      }
+      if (typeof el.id !== "string" || !el.id) errors.push(`${where}.id must be a non-empty string`);
+      if (!ELEMENT_TYPES.includes(el.type)) errors.push(`${where}.type "${el.type}" is not a known element type`);
+      for (const k of ["x", "y", "w", "h"]) {
+        const v = el[k];
+        if (typeof v !== "number" || v < 0 || v > 1) errors.push(`${where}.${k} must be a number in 0..1`);
+      }
+    });
+  });
+  return { ok: errors.length === 0, errors };
+}
+function migrateDeck(deck) {
+  let d = deck;
+  d.version ?? 1;
+  return d.version === SCHEMA_VERSION ? d : { ...d, version: SCHEMA_VERSION };
+}
+function serializeDeck(deck, pretty = false) {
+  const stamped = deck.version === SCHEMA_VERSION ? deck : { ...deck, version: SCHEMA_VERSION };
+  return JSON.stringify(stamped, null, pretty ? 2 : void 0);
+}
+function parseDeck(input) {
+  let raw;
+  if (typeof input === "string") {
+    try {
+      raw = JSON.parse(input);
+    } catch (e) {
+      throw new Error(`parseDeck: invalid JSON \u2014 ${e.message}`);
+    }
+  } else {
+    raw = input;
+  }
+  const result = validateDeck(raw);
+  if (!result.ok) {
+    throw new Error(`parseDeck: invalid deck \u2014 ${result.errors.join("; ")}`);
+  }
+  return migrateDeck(raw);
+}
+
 exports.DeckEditor = DeckEditor;
 exports.EditorToolbar = EditorToolbar;
 exports.ElementInspector = ElementInspector;
@@ -3382,11 +3453,14 @@ exports.defaultTheme = defaultTheme;
 exports.defineTheme = defineTheme;
 exports.elementId = elementId;
 exports.isByParagraph = isByParagraph;
+exports.migrateDeck = migrateDeck;
 exports.nextId = nextId;
 exports.normalizeSlideMarkdown = normalizeSlideMarkdown;
 exports.paragraphReveals = paragraphReveals;
+exports.parseDeck = parseDeck;
 exports.reduceDeck = reduce;
 exports.resolveTheme = resolveTheme;
+exports.serializeDeck = serializeDeck;
 exports.slideId = slideId;
 exports.splitParagraphs = splitParagraphs;
 exports.stepDelays = stepDelays;
@@ -3396,6 +3470,7 @@ exports.useIsDarkSlide = useIsDarkSlide;
 exports.useSlideContext = useSlideContext;
 exports.useSlideKeyboard = useSlideKeyboard;
 exports.useSlideTheme = useSlideTheme;
+exports.validateDeck = validateDeck;
 exports.visibleElementIds = visibleElementIds;
 exports.vividTheme = vividTheme;
 //# sourceMappingURL=index.cjs.map