pixi-effects 0.28.2 → 0.29.0

package/dist/loader.css

@@ -1,7 +1,7 @@
 /*
  * pixi-effects loader: one line of HTML on the page, a few lines of CSS, no JavaScript of your own.
  *
- *   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/pixi-effects@0.28.2/dist/loader.css">
+ *   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/pixi-effects@0.29.0/dist/loader.css">
  *   <div class="stage" style="position: relative">                      <!-- any box the canvas sits in, with position: relative -->
  *     <canvas id="stage" width="1280" height="720"></canvas>
  *     <div class="pe-loader" data-label="LOADING"></div>                <!-- or class="pe-loader pe-loader--bar" -->

package/dist/{Presenter.cjs → present.cjs}

@@ -1,8 +1,270 @@
 'use strict';
 
+require('./chunk-HREBQAY4.cjs');
+require('./chunk-WHNADXXG.cjs');
+require('./chunk-ZVUO325O.cjs');
+require('./chunk-2DXPTKQZ.cjs');
+require('./chunk-LYOKH7KE.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
 
-// src/Presenter.ts
+// src/present/stops.ts
+function nextStopAfter(stops, frame) {
+  return stops.find((s) => s.frame > frame) ?? null;
+}
+function previousStopBefore(stops, frame) {
+  for (let i = stops.length - 1; i >= 0; i--) if (stops[i].frame < frame) return stops[i];
+  return null;
+}
+function stopAtOrBefore(stops, frame) {
+  for (let i = stops.length - 1; i >= 0; i--) if (stops[i].frame <= frame) return stops[i];
+  return null;
+}
+function pageStarts(stops) {
+  return stops.filter((s) => s.pageStart);
+}
+function pictureStops(stops, opts = {}) {
+  if (opts.which === "stops") return opts.pdf ? stops.filter((s) => s.pdf !== false) : [...stops];
+  const byPage = /* @__PURE__ */ new Map();
+  for (const s of stops) byPage.set(s.pageIndex, [...byPage.get(s.pageIndex) ?? [], s]);
+  const take = (list) => opts.pick === "first" ? list[0] : list[list.length - 1];
+  const picks = [];
+  for (const list of byPage.values()) {
+    const flagged = list.filter((s) => s.pdf === true);
+    const usable = list.filter((s) => s.pdf !== false);
+    const one = take(flagged.length ? flagged : usable.length ? usable : opts.pdf ? [] : list);
+    if (one) picks.push(one);
+  }
+  return picks;
+}
+function changedFraction(a, b, threshold = 12) {
+  const n = Math.min(a.length, b.length) >> 2;
+  if (n === 0) return 0;
+  let changed = 0;
+  for (let i = 0; i < n; i++) {
+    const k = i << 2;
+    if (Math.abs(a[k] - b[k]) > threshold || Math.abs(a[k + 1] - b[k + 1]) > threshold || Math.abs(a[k + 2] - b[k + 2]) > threshold) changed++;
+  }
+  return changed / n;
+}
+
+// src/present/navigation.ts
+var listeners = /* @__PURE__ */ new WeakMap();
+var toward = /* @__PURE__ */ new WeakMap();
+function onStop(movie, fn) {
+  let set = listeners.get(movie);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(movie, set);
+  }
+  set.add(fn);
+  return () => {
+    set.delete(fn);
+  };
+}
+function emit(movie, stop) {
+  const e = { index: stop.index, stop, pageIndex: stop.pageIndex };
+  for (const fn of [...listeners.get(movie) ?? []]) fn(e);
+}
+var stopIndex = (movie) => stopAtOrBefore(movie.stops, movie.currentFrame)?.index ?? -1;
+var currentStop = (movie) => stopAtOrBefore(movie.stops, movie.currentFrame);
+var pageIndex = (movie) => currentStop(movie)?.pageIndex ?? -1;
+var pageCount = (movie) => pageStarts(movie.stops).length;
+async function next(movie) {
+  if (!movie.isReady) return;
+  const going = toward.get(movie);
+  if (going && movie.isPlaying) {
+    toward.delete(movie);
+    movie.pause();
+    await movie.gotoFrame(going.frame, true);
+    emit(movie, going);
+    return;
+  }
+  toward.delete(movie);
+  if (movie.currentFrame >= movie.totalFrames) return;
+  const target = nextStopAfter(movie.stops, movie.currentFrame);
+  if (!target) {
+    await movie.playUntil();
+    return;
+  }
+  toward.set(movie, target);
+  const landed = await movie.playUntil(target.frame / movie.frameRate);
+  if (toward.get(movie) === target) toward.delete(movie);
+  if (landed) emit(movie, target);
+}
+async function prev(movie) {
+  if (!movie.isReady) return;
+  toward.delete(movie);
+  movie.pause();
+  const target = previousStopBefore(movie.stops, movie.currentFrame);
+  await movie.gotoFrame(target ? target.frame : 0, true);
+  if (target) emit(movie, target);
+}
+async function goToStop(movie, index) {
+  if (!movie.isReady) return;
+  const stop = movie.stops[index];
+  if (!stop) {
+    console.warn(`pixi-effects: goToStop(movie, ${index}): there are ${movie.stops.length} stops (0 to ${movie.stops.length - 1})`);
+    return;
+  }
+  toward.delete(movie);
+  movie.pause();
+  await movie.gotoFrame(stop.frame, true);
+  emit(movie, stop);
+}
+async function goToPage(movie, page) {
+  const starts = pageStarts(movie.stops);
+  const stop = starts[page];
+  if (!stop) {
+    console.warn(`pixi-effects: goToPage(movie, ${page}): there are ${starts.length} pages (0 to ${starts.length - 1})`);
+    return;
+  }
+  await goToStop(movie, stop.index);
+}
+
+// src/present/pdf.ts
+var enc = (s) => {
+  const out = new Uint8Array(s.length);
+  for (let i = 0; i < s.length; i++) out[i] = s.charCodeAt(i) & 255;
+  return out;
+};
+var num = (n) => String(Math.round(n * 1e3) / 1e3);
+var textString = (s) => {
+  if (/^[\x20-\x7e]*$/.test(s)) return `(${s.replace(/[\\()]/g, (m) => `\\${m}`)})`;
+  let hex = "FEFF";
+  for (let i = 0; i < s.length; i++) hex += s.charCodeAt(i).toString(16).toUpperCase().padStart(4, "0");
+  return `<${hex}>`;
+};
+function buildPdf(pages, opts = {}) {
+  if (pages.length === 0) throw new Error("pixi-effects: a PDF needs at least one page");
+  const first = (i) => 3 + i * 3;
+  const objects = [];
+  objects[1] = [enc("<< /Type /Catalog /Pages 2 0 R >>")];
+  objects[2] = [enc(`<< /Type /Pages /Kids [${pages.map((_, i) => `${first(i)} 0 R`).join(" ")}] /Count ${pages.length} >>`)];
+  pages.forEach((p, i) => {
+    const w = p.width * 0.75, h = p.height * 0.75, n = first(i);
+    objects[n] = [enc(`<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ${num(w)} ${num(h)}] /Resources << /XObject << /Im0 ${n + 2} 0 R >> >> /Contents ${n + 1} 0 R >>`)];
+    const content = `q ${num(w)} 0 0 ${num(h)} 0 0 cm /Im0 Do Q`;
+    objects[n + 1] = [enc(`<< /Length ${content.length} >>
+stream
+${content}
+endstream`)];
+    objects[n + 2] = [enc(`<< /Type /XObject /Subtype /Image /Width ${p.width} /Height ${p.height} /ColorSpace /DeviceRGB /BitsPerComponent 8 /Filter /DCTDecode /Length ${p.jpeg.length} >>
+stream
+`), p.jpeg, enc("\nendstream")];
+  });
+  const infoNo = opts.title !== void 0 ? first(pages.length) : 0;
+  if (infoNo) objects[infoNo] = [enc(`<< /Title ${textString(opts.title)} /Producer (pixi-effects) >>`)];
+  const count = infoNo || first(pages.length);
+  const chunks = [enc("%PDF-1.4\n%\xE2\xE3\xCF\xD3\n")];
+  let offset = chunks[0].length;
+  const offsets = [];
+  for (let n = 1; n < count + (infoNo ? 1 : 0); n++) {
+    const body = objects[n];
+    if (!body) continue;
+    offsets[n] = offset;
+    const parts = [enc(`${n} 0 obj
+`), ...body, enc("\nendobj\n")];
+    for (const part of parts) {
+      chunks.push(part);
+      offset += part.length;
+    }
+  }
+  const size = (infoNo || first(pages.length)) + (infoNo ? 1 : 0);
+  let xref = `xref
+0 ${size}
+0000000000 65535 f 
+`;
+  for (let n = 1; n < size; n++) xref += `${String(offsets[n] ?? 0).padStart(10, "0")} 00000 n 
+`;
+  xref += `trailer
+<< /Size ${size} /Root 1 0 R${infoNo ? ` /Info ${infoNo} 0 R` : ""} >>
+startxref
+${offset}
+%%EOF
+`;
+  chunks.push(enc(xref));
+  const total = chunks.reduce((sum, c) => sum + c.length, 0);
+  const out = new Uint8Array(total);
+  let at = 0;
+  for (const c of chunks) {
+    out.set(c, at);
+    at += c.length;
+  }
+  return out;
+}
+
+// src/present/images.ts
+function requireReady(movie, what) {
+  if (!movie.isReady) throw new Error(`pixi-effects: ${what}() needs a ready movie \u2014 await movie.init(...) first`);
+}
+async function stopImages(movie, opts = {}) {
+  chunkTWZNOUM7_cjs.warnUnknownOptions("stopImages()", opts, ["which", "pick", "scale", "type", "quality", "as", "motionBlur", "pdf", "onImage"]);
+  requireReady(movie, "stopImages");
+  if (movie.stops.length === 0) return [];
+  const picks = pictureStops(movie.stops, { which: opts.which, pick: opts.pick, pdf: opts.pdf });
+  const shot = { scale: opts.scale ?? 1, type: opts.type ?? "image/png", quality: opts.quality, as: opts.as ?? "blob", motionBlur: opts.motionBlur === void 0 ? false : opts.motionBlur };
+  return movie.peek(async () => {
+    const out = [];
+    for (const stop of picks) {
+      const image = await movie.snapshot(stop.frame, shot);
+      const item = { stop, page: stop.pageIndex, image };
+      out.push(item);
+      opts.onImage?.(item);
+    }
+    return out;
+  });
+}
+async function inspectStops(movie, opts = {}) {
+  chunkTWZNOUM7_cjs.warnUnknownOptions("inspectStops()", opts, ["lookback", "tolerance"]);
+  requireReady(movie, "inspectStops");
+  const out = { stops: [], issues: [] };
+  if (movie.stops.length === 0) return out;
+  const lookback = Math.max(1, Math.round(opts.lookback ?? 3));
+  const tolerance = opts.tolerance ?? 4e-3;
+  const small = Math.min(1, 320 / Math.max(1, movie.width));
+  const pixels = async (frame) => (await movie.snapshot(frame, { scale: small, motionBlur: false, as: "imageData" })).data;
+  return movie.peek(async () => {
+    for (const stop of movie.stops) {
+      const before = Math.max(0, stop.frame - lookback);
+      let moving = 0;
+      if (before < stop.frame) {
+        const now = await pixels(stop.frame);
+        moving = changedFraction(now, await pixels(before));
+      }
+      const settled = moving <= tolerance;
+      out.stops.push({ index: stop.index, page: stop.page, at: stop.at, frame: stop.frame, moving, settled });
+      if (!settled) {
+        out.issues.push(`stop ${stop.index + 1}${stop.page ? ` (page "${stop.page}")` : ""} at ${stop.at.toFixed(1)} s: the picture is still changing there (${moving < 0.1 ? (moving * 100).toFixed(1) : Math.round(moving * 100)}% of it changed in the last ${stop.frame - before} frames), so the audience, the page overview and a PDF see it mid-animation. Move the stop to after the animation has finished, or flag a settled stop of the page with \`pdf: true\`.`);
+      }
+    }
+    return out;
+  });
+}
+async function exportPDF(movie, opts = {}) {
+  chunkTWZNOUM7_cjs.warnUnknownOptions("exportPDF()", opts, ["which", "pick", "scale", "quality", "title", "motionBlur", "onImage"]);
+  requireReady(movie, "exportPDF");
+  if (movie.stops.length === 0) throw new Error("pixi-effects: exportPDF(): this movie has no stops, so there are no pages; add `stops` to the composition (or build it with deck())");
+  const scale = opts.scale ?? 1;
+  const images = await stopImages(movie, {
+    which: opts.which,
+    pick: opts.pick,
+    scale,
+    type: "image/jpeg",
+    quality: opts.quality ?? 0.92,
+    as: "blob",
+    motionBlur: opts.motionBlur,
+    pdf: true,
+    onImage: opts.onImage
+  });
+  const pages = await Promise.all(images.map(async (i) => ({
+    jpeg: new Uint8Array(await i.image.arrayBuffer()),
+    width: Math.max(1, Math.round(movie.width * scale)),
+    height: Math.max(1, Math.round(movie.height * scale))
+  })));
+  return new Blob([buildPdf(pages, { title: opts.title })], { type: "application/pdf" });
+}
+
+// src/present/Presenter.ts
 var OPTION_KEYS = ["canvas", "keyboard", "clickToAdvance", "swipe", "indicator", "autoAdvance", "loop", "accent", "onExit"];
 var NEXT_KEYS = /* @__PURE__ */ new Set(["ArrowRight", "ArrowDown", " ", "Enter", "PageDown"]);
 var PREV_KEYS = /* @__PURE__ */ new Set(["ArrowLeft", "ArrowUp", "Backspace", "PageUp"]);
@@ -129,6 +391,7 @@ var Presenter = class {
   wasWrapAttr = false;
   onKey = (e) => this.handleKey(e);
   onStop = (e) => this.handleStop(e);
+  offStop = null;
   onSeeked = () => this.refresh();
   onFrame = () => this.mirror();
   onEnded = () => this.handleEnded();
@@ -202,7 +465,7 @@ var Presenter = class {
     canvas.addEventListener("pointermove", this.onPointerMove);
     if (this.options.keyboard) document.addEventListener("keydown", this.onKey);
     document.addEventListener("fullscreenchange", this.onFullscreenChange);
-    movie.on("stop", this.onStop);
+    this.offStop = onStop(movie, this.onStop);
     movie.on("seeked", this.onSeeked);
     movie.on("ended", this.onEnded);
     this.refresh();
@@ -226,11 +489,11 @@ var Presenter = class {
   }
   next() {
     this.cancelAdvance();
-    return this.run(() => this.movie.next());
+    return this.run(() => next(this.movie));
   }
   prev() {
     this.cancelAdvance();
-    return this.run(() => this.movie.prev());
+    return this.run(() => prev(this.movie));
   }
   /** Black out (`'black'`), white out (`'white'`) or bring the picture back (`'off'`). */
   setCover(mode) {
@@ -248,7 +511,8 @@ var Presenter = class {
     canvas.removeEventListener("pointerup", this.onPointerUp);
     canvas.removeEventListener("pointermove", this.onPointerMove);
     this.closePresenterView();
-    this.movie.off("stop", this.onStop);
+    this.offStop?.();
+    this.offStop = null;
     this.movie.off("seeked", this.onSeeked);
     this.movie.off("ended", this.onEnded);
     for (const t of [this.idleTimer, this.digitsTimer, this.advanceTimer, this.loopTimer]) if (t) clearTimeout(t);
@@ -321,19 +585,19 @@ var Presenter = class {
       this.loopTimer = null;
       void this.run(async () => {
         await this.movie.gotoFrame(0, true);
-        await this.movie.next();
+        await next(this.movie);
       });
     }, 800);
   }
   refresh() {
     const m = this.movie;
-    const pages = m.pageCount ?? 0, stops = m.stops?.length ?? 0;
+    const pages = pageCount(m), stops = m.stops?.length ?? 0;
     if (this.counterEl) {
-      this.counterEl.textContent = pages > 0 ? `${m.pageIndex >= 0 ? m.pageIndex + 1 : "\u2013"} / ${pages}` : "";
+      this.counterEl.textContent = pages > 0 ? `${pageIndex(m) >= 0 ? pageIndex(m) + 1 : "\u2013"} / ${pages}` : "";
       this.counterEl.style.display = pages > 0 ? "" : "none";
     }
-    if (this.titleEl) this.titleEl.textContent = m.currentStop?.page ?? "";
-    if (this.progressEl) this.progressEl.style.setProperty("--mp-fill", String(stops > 0 ? (m.stopIndex + 1) / stops : 0));
+    if (this.titleEl) this.titleEl.textContent = currentStop(m)?.page ?? "";
+    if (this.progressEl) this.progressEl.style.setProperty("--mp-fill", String(stops > 0 ? (stopIndex(m) + 1) / stops : 0));
     this.refreshView();
   }
   wake() {
@@ -391,7 +655,7 @@ var Presenter = class {
       this.showDigits();
       this.navigate(() => {
         this.cancelAdvance();
-        void this.run(() => this.movie.goToPage(page));
+        void this.run(() => goToPage(this.movie, page));
       });
     } else if (k === "Backspace" && this.digits) {
       this.digits = this.digits.slice(0, -1);
@@ -400,11 +664,11 @@ var Presenter = class {
     else if (PREV_KEYS.has(k)) this.navigate(() => void this.prev());
     else if (k === "Home") this.navigate(() => {
       this.cancelAdvance();
-      void this.run(() => this.movie.goToPage(0));
+      void this.run(() => goToPage(this.movie, 0));
     });
     else if (k === "End") this.navigate(() => {
       this.cancelAdvance();
-      void this.run(() => this.movie.goToStop(Math.max(0, (this.movie.stops?.length ?? 1) - 1)));
+      void this.run(() => goToStop(this.movie, Math.max(0, (this.movie.stops?.length ?? 1) - 1)));
     });
     else if (k === "b" || k === "B" || k === ".") this.setCover(this.coverEl.getAttribute("data-mode") === "black" ? "off" : "black");
     else if (k === "w" || k === "W" || k === ",") this.setCover(this.coverEl.getAttribute("data-mode") === "white" ? "off" : "white");
@@ -507,18 +771,18 @@ var Presenter = class {
     if (!v || v.win.closed) return;
     const m = this.movie;
     const stops = m.stops ?? [];
-    const pages = m.pageCount ?? 0;
-    const cur = m.stopIndex ?? -1;
-    v.els.count.textContent = pages > 0 ? `${m.pageIndex >= 0 ? m.pageIndex + 1 : "\u2013"} / ${pages}` : "";
-    v.els.title.textContent = m.currentStop?.page ?? (cur < 0 ? stops[0]?.page ?? "" : "");
-    const upTo = cur < 0 ? 0 : cur, pageIndex = stops[upTo]?.pageIndex;
+    const pages = pageCount(m);
+    const cur = stopIndex(m);
+    v.els.count.textContent = pages > 0 ? `${pageIndex(m) >= 0 ? pageIndex(m) + 1 : "\u2013"} / ${pages}` : "";
+    v.els.title.textContent = currentStop(m)?.page ?? (cur < 0 ? stops[0]?.page ?? "" : "");
+    const upTo = cur < 0 ? 0 : cur, pageIndex2 = stops[upTo]?.pageIndex;
     let notes = "";
-    for (const s of stops) if (s.pageIndex === pageIndex && s.index <= upTo && s.notes) notes = s.notes;
+    for (const s of stops) if (s.pageIndex === pageIndex2 && s.index <= upTo && s.notes) notes = s.notes;
     v.els.notes.textContent = notes;
     v.els.notes.setAttribute("data-empty", String(notes === ""));
-    const next = stops[cur + 1];
-    v.els.nextbox.setAttribute("data-end", String(!next));
-    const src = next ? this.thumbs.get(next.index) : void 0;
+    const next2 = stops[cur + 1];
+    v.els.nextbox.setAttribute("data-end", String(!next2));
+    const src = next2 ? this.thumbs.get(next2.index) : void 0;
     if (src) v.els.next.setAttribute("src", src);
     else v.els.next.removeAttribute("src");
   }
@@ -546,10 +810,11 @@ var Presenter = class {
    * Make a picture of every stop, once. Taking them moves the playhead through the stops and back, which the audience would see:
    * `start()` does it before anything is shown (behind a "Preparing" cover), and an overview opened before that does it on the spot.
    */
+  /** Make the page pictures now (the overview and the presenter view use them): `start()` does it before the audience sees anything. */
   ensureThumbs() {
     this.thumbsPromise ??= (async () => {
       try {
-        await this.movie.stopImages({
+        await stopImages(this.movie, {
           which: "stops",
           as: "dataURL",
           type: "image/jpeg",
@@ -572,8 +837,8 @@ var Presenter = class {
     const stops = (this.movie.stops ?? []).filter((s) => s.pageIndex === page);
     return stops.length ? this.thumbs.get(stops[stops.length - 1].index) : void 0;
   }
-  onThumb(stopIndex) {
-    const stop = this.movie.stops?.[stopIndex];
+  onThumb(stopIndex2) {
+    const stop = this.movie.stops?.[stopIndex2];
     if (stop) this.fillThumb(stop.pageIndex);
     this.refreshView();
   }
@@ -584,18 +849,18 @@ var Presenter = class {
     this.gridEl.style.setProperty("--mp-cols", String(cols));
     this.gridEl.style.setProperty("--mp-ratio", `${width} / ${height}`);
     this.gridEl.innerHTML = "";
-    const current = Math.max(0, this.movie.pageIndex ?? 0);
+    const current = Math.max(0, pageIndex(this.movie));
     pages.forEach((s, i) => {
       const cell = document.createElement("div");
       cell.className = "mp-cell";
-      cell.setAttribute("data-current", String(i === this.movie.pageIndex));
+      cell.setAttribute("data-current", String(i === pageIndex(this.movie)));
       cell.setAttribute("data-selected", String(i === current));
       cell.innerHTML = `<div class="mp-cell-label"><span class="mp-cell-num">${i + 1}</span><span class="mp-cell-name"></span></div>`;
       cell.querySelector(".mp-cell-name").textContent = s.page ?? "";
       cell.addEventListener("click", () => {
         this.overviewEl.setAttribute("data-open", "false");
         this.cancelAdvance();
-        void this.run(() => this.movie.goToPage(i));
+        void this.run(() => goToPage(this.movie, i));
       });
       this.gridEl.appendChild(cell);
       this.fillThumb(i);
@@ -636,7 +901,7 @@ var Presenter = class {
         const page = this.overviewSel;
         this.overviewEl.setAttribute("data-open", "false");
         this.cancelAdvance();
-        void this.run(() => this.movie.goToPage(page));
+        void this.run(() => goToPage(this.movie, page));
         return true;
       }
       case "Escape":
@@ -666,6 +931,80 @@ var Presenter = class {
   }
 };
 
+// src/present/deck.ts
+var PAGE_KEYS = ["name", "duration", "sequences", "stops", "notes", "advance", "initial", "keyframes", "filters", "filterArea", "blendMode", "mask"];
+var DECK_KEYS = ["pages", "transition", "width", "height", "frameRate", "background", "canvas", "assets", "poster", "motionBlur", "loader"];
+function deck(options) {
+  if (!options || !Array.isArray(options.pages) || options.pages.length === 0) throw new Error("deck(): pages must be a list with at least one page: { pages: [{ name, duration, stops, sequences }] }");
+  chunkTWZNOUM7_cjs.warnUnknownOptions("deck()", options, DECK_KEYS);
+  const { pages, transition, ...movieOptions } = options;
+  pages.forEach((p, i) => {
+    if (!p || typeof p !== "object") throw new Error(`deck(): pages[${i}] must be an object`);
+    chunkTWZNOUM7_cjs.warnUnknownOptions(`deck() pages[${i}]`, p, PAGE_KEYS);
+    if (!(typeof p.duration === "number" && Number.isFinite(p.duration) && p.duration > 0)) throw new Error(`deck(): pages[${i}].duration must be a positive number of seconds, got ${String(p.duration)}`);
+    if (!Array.isArray(p.sequences)) throw new Error(`deck(): pages[${i}].sequences must be a list of layers (it may be empty), got ${typeof p.sequences}`);
+  });
+  let overlap = 0;
+  if (transition) {
+    if (!(typeof transition.duration === "number" && transition.duration > 0)) throw new Error("deck(): transition needs a duration in seconds: { kind: 'crossfade', duration: 0.6 }");
+    const shortest = Math.min(...pages.map((p) => p.duration));
+    if (pages.length > 1 && transition.duration >= shortest) throw new Error(`deck(): the transition (${transition.duration} s) must be shorter than every page (the shortest is ${shortest} s)`);
+    overlap = pages.length > 1 ? transition.duration : 0;
+  }
+  const sequences = [];
+  const transitions = [];
+  const stops = [];
+  let start = 0;
+  pages.forEach((page, i) => {
+    const id = `page-${i + 1}`;
+    const label = page.name ? `"${page.name}"` : `pages[${i}]`;
+    const isLast = i === pages.length - 1;
+    const entries = (page.stops ?? [isLast ? page.duration : page.duration - overlap]).map((e, k) => {
+      if (e && typeof e === "object") chunkTWZNOUM7_cjs.warnUnknownOptions(`deck() page ${label} stops[${k}]`, e, ["at", "pdf"]);
+      return typeof e === "object" && e !== null ? e : { at: e };
+    });
+    const local = entries.map((e) => e.at);
+    local.forEach((s, k) => {
+      if (!(typeof s === "number" && Number.isFinite(s) && s > 0 && s <= page.duration + 1e-9)) throw new Error(`deck(): page ${label} has stop ${String(s)}, outside the page (0 to ${page.duration} s)`);
+      if (k > 0 && s <= local[k - 1]) throw new Error(`deck(): page ${label} stops must be in order, earliest first (got ${local.join(", ")})`);
+    });
+    const { name: _n, duration: _d, sequences: inner, stops: _s, notes: _no, advance: _a, ...layerProps } = page;
+    sequences.push({ type: "composition", name: id, at: round(start), duration: page.duration, ...layerProps, sequences: inner });
+    local.forEach((s, k) => {
+      const stop = { at: round(start + s) };
+      if (k === 0) {
+        stop.page = page.name ?? true;
+        if (page.notes !== void 0) stop.notes = page.notes;
+      }
+      if (k === local.length - 1 && page.advance !== void 0) stop.advance = page.advance;
+      if (entries[k].pdf !== void 0) stop.pdf = entries[k].pdf;
+      stops.push(stop);
+    });
+    if (transition && !isLast) {
+      const next2 = start + page.duration - overlap;
+      transitions.push({ ...transition, from: id, to: `page-${i + 2}`, at: round(next2), duration: transition.duration });
+    }
+    start = start + page.duration - (isLast ? 0 : overlap);
+  });
+  const composition = { sequences, stops };
+  if (transitions.length > 0) composition.transitions = transitions;
+  return { ...movieOptions, duration: round(start), composition };
+}
+var round = (v) => Math.round(v * 1e6) / 1e6;
+
 exports.Presenter = Presenter;
-//# sourceMappingURL=Presenter.cjs.map
-//# sourceMappingURL=Presenter.cjs.map
+exports.currentStop = currentStop;
+exports.deck = deck;
+exports.exportPDF = exportPDF;
+exports.goToPage = goToPage;
+exports.goToStop = goToStop;
+exports.inspectStops = inspectStops;
+exports.next = next;
+exports.onStop = onStop;
+exports.pageCount = pageCount;
+exports.pageIndex = pageIndex;
+exports.prev = prev;
+exports.stopImages = stopImages;
+exports.stopIndex = stopIndex;
+//# sourceMappingURL=present.cjs.map
+//# sourceMappingURL=present.cjs.map