postext-folio 0.6.0 → 0.7.0

package/dist/paper.d.ts

@@ -37,8 +37,15 @@ export interface PaperSpec {
  * through about twice the light its opacity loses (opacity is a contrast
  * over a black backing; diffuse transmittance runs 15–20 % for 80 g/m²
  * offset, a third and more for bible paper).
+ *
+ * That bending length is the stock's, in millimetres, so across a sheet
+ * wider than a book's page (`pageWidthMm`: a tabloid, a Berliner, a
+ * broadsheet) it is a smaller share of the page: such a sheet rolls
+ * tighter for its width, flutters more and swings back more slowly, as a
+ * longer pendulum does. A broadsheet of newsprint flops where a book page
+ * of the same paper curls.
  */
-export declare function paperSpec(paper: ResolvedPaper): PaperSpec;
+export declare function paperSpec(paper: ResolvedPaper, pageWidthMm?: number): PaperSpec;
 /** The paper of a page: the book's, with the page's own stock over it (a
  *  page that names a stock takes that stock's defaults, not the book's). */
 export declare function pagePaper(book: FolioConfig | undefined, own: FolioPaperConfig | undefined): ResolvedPaper;

package/dist/paper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paper.d.ts","sourceRoot":"","sources":["../src/paper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhH,MAAM,MAAM,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAEzD,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB;6EACyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAwBD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAoBzD;AAED;4EAC4E;AAC5E,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,aAAa,CAIzG;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM9D"}
+{"version":3,"file":"paper.d.ts","sourceRoot":"","sources":["../src/paper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhH,MAAM,MAAM,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAEzD,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB;6EACyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAkCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAqB/E;AAED;4EAC4E;AAC5E,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,aAAa,CAIzG;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM9D"}

package/dist/paper.js

@@ -12,8 +12,17 @@ const OPACITY_K = {
     cardStock: 0.03,
     board: 0.03,
 };
+/** How much more of the reverse's print shows than the sheet's opacity
+ *  alone lets through: on newsprint the coldset ink is not dried on the
+ *  surface but soaks into the open groundwood sheet (strike-through), so
+ *  the other side reads through more than its 90 % opacity suggests. */
+const STRIKE_THROUGH = {
+    newsprint: 1.7,
+};
 /** The reference leaf: 90 g/m² × 1.25 cm³/g. */
 const REF_CALIPER_UM = 112.5;
+/** Pages up to this wide (mm) curl as their stock alone says. */
+const LARGE_PAGE_MM = 230;
 const smooth = (a, b, x) => {
     const t = Math.min(1, Math.max(0, (x - a) / (b - a)));
     return t * t * (3 - 2 * t);
@@ -28,22 +37,30 @@ const smooth = (a, b, x) => {
  * through about twice the light its opacity loses (opacity is a contrast
  * over a black backing; diffuse transmittance runs 15–20 % for 80 g/m²
  * offset, a third and more for bible paper).
+ *
+ * That bending length is the stock's, in millimetres, so across a sheet
+ * wider than a book's page (`pageWidthMm`: a tabloid, a Berliner, a
+ * broadsheet) it is a smaller share of the page: such a sheet rolls
+ * tighter for its width, flutters more and swings back more slowly, as a
+ * longer pendulum does. A broadsheet of newsprint flops where a book page
+ * of the same paper curls.
  */
-export function paperSpec(paper) {
+export function paperSpec(paper, pageWidthMm) {
     const caliperUm = paper.grammage * paper.bulk;
     const ratio = Math.pow(caliperUm / REF_CALIPER_UM, 2 / 3);
+    const size = pageWidthMm && pageWidthMm > LARGE_PAGE_MM ? LARGE_PAGE_MM / pageWidthMm : 1;
     const opacity = 1 - Math.exp(-OPACITY_K[paper.type] * paper.grammage);
     const finish = paper.finish;
     return {
         paper,
         caliperMm: caliperUm / 1000,
-        roll: Math.min(6, Math.max(0.45, ratio)),
+        roll: Math.min(6, Math.max(0.45, ratio)) * size,
         rigidity: smooth(1.3, 4, ratio),
         opacity,
-        showThrough: paper.showThrough ? Math.min(0.4, (1 - opacity) * 1.25) : 0,
+        showThrough: paper.showThrough ? Math.min(0.4, (1 - opacity) * 1.25 * (STRIKE_THROUGH[paper.type] ?? 1)) : 0,
         transmission: paper.showThrough ? Math.min(0.5, (1 - opacity) * 2) : 0,
         follow: 0.35 / (1 + 0.35 * Math.max(0, Math.log(ratio))),
-        spring: 0.0085 * Math.min(1.6, Math.max(0.75, Math.sqrt(ratio))),
+        spring: 0.0085 * Math.min(1.6, Math.max(0.75, Math.sqrt(ratio))) * Math.sqrt(size),
         roughness: finish === "gloss" ? 0.32 : finish === "silk" ? 0.5 : finish === "matte" ? 0.7 : 0.88,
         clearcoat: finish === "gloss" ? 1 : finish === "silk" ? 0.45 : finish === "matte" ? 0.12 : 0,
         clearcoatRoughness: finish === "gloss" ? 0.06 : finish === "silk" ? 0.28 : 0.6,

package/dist/paper.js.map

@@ -1 +1 @@
-{"version":3,"file":"paper.js","sourceRoot":"","sources":["../src/paper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"paper.js","sourceRoot":"","sources":["../src/paper.ts"],"names":[],"mappings":"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"}

package/dist/postext.d.ts

@@ -22,11 +22,17 @@ export interface FolioDocumentOptions extends Omit<FolioOptions, "pages" | "firs
     /**
      * Videos printed on the pages play there (#477): a click on a video's
      * poster plays it on the page (in every pointer mode), a click on it
-     * again pauses it, and it goes on playing while its leaf turns. A video
-     * with `player.autoplay` starts by itself the first time its spread is
-     * shown (muted until the reader has interacted with the page). Starting another
-     * stops the one playing; it stops too when the book comes to rest on a
-     * spread that does not show it. Self-hosted videos only (a file, or its
+     * again pauses it, and it goes on playing while its leaf turns. Several
+     * may play at once (#507, up to eight drawn): starting a video stops the
+     * other exclusive ones (`player.exclusive`, the default) and holds those
+     * playing alongside (`exclusive: false`) until it pauses or ends; one
+     * playing alongside pauses only the exclusive ones. A video with
+     * `player.autoplay` starts by itself, muted: an exclusive one the first
+     * time its spread is shown (with its sound once the reader has
+     * interacted with the page), one playing alongside each time its page
+     * comes into view, unless the reader asks for less motion
+     * (`prefers-reduced-motion`). A video stops when the book comes to rest
+     * on a spread that does not show it. Self-hosted videos only (a file, or its
      * address: MP4, WebM or an HLS stream); a YouTube or Vimeo poster turns
      * the page as any other. The video's server must allow cross-origin
      * reads (CORS) for WebGL to draw it. Default true.
@@ -61,7 +67,7 @@ export interface FolioDocumentViewer extends FolioViewer {
     /** Plays or pauses the video printed at a point of a page, as a click
      *  there does; false when no playable video lies there. */
     toggleVideoAt(point: FolioPagePoint): boolean;
-    /** Stops the video playing on a page (its poster shows again). */
+    /** Stops the videos playing on the pages (their posters show again). */
     stopVideo(): void;
 }
 /** Whether the document's first page is a recto: page 1, or a chapter
@@ -79,7 +85,10 @@ export declare function trimmedSize(page: VDTPage, doc: VDTDocument): {
  *  book), with the host's own appearance laid over them. The pages round
  *  it are the host's word when it gives them (`extraPages`: a host laying
  *  a book out a chapter at a time knows the chapters after this one, which
- *  the document only knows when it was given the book's page count). */
+ *  the document only knows when it was given the book's page count). A
+ *  newspaper trim (`page.sizePreset` broadsheet, berliner, tabloid or
+ *  compact) shows folded newsprint unless the settings name a stock or a
+ *  binding (#506). */
 export declare function appearanceOf(doc: VDTDocument, own: FolioAppearance | undefined): FolioAppearance;
 /**
  * Which paintings a new layout can keep: new page index → old page index,

package/dist/postext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postext.d.ts","sourceRoot":"","sources":["../src/postext.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"postext.d.ts","sourceRoot":"","sources":["../src/postext.ts"],"names":[],"mappings":"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"}

package/dist/postext.js

@@ -1,8 +1,8 @@
 import { renderPageToCanvas } from "postext";
-import { resolveFolioConfig } from "postext";
+import { folioForTrim, resolveFolioConfig } from "postext";
 import { BLOCK_PAGES } from "./pageFlip";
 import { createFolio } from "./viewer";
-import { attachVideoSource, isHlsVideo, pageVideoSpots, spotContains } from "./videos";
+import { attachVideoSource, autoKey, autoplayPlan, isHlsVideo, makeWay, pageVideoSpots, spotContains } from "./videos";
 /** Whether the document's first page is a recto: page 1, or a chapter
  *  continued after an even number of pages. */
 export function firstPageIsRecto(doc) {
@@ -25,12 +25,15 @@ function paperOf(doc) {
  *  book), with the host's own appearance laid over them. The pages round
  *  it are the host's word when it gives them (`extraPages`: a host laying
  *  a book out a chapter at a time knows the chapters after this one, which
- *  the document only knows when it was given the book's page count). */
+ *  the document only knows when it was given the book's page count). A
+ *  newspaper trim (`page.sizePreset` broadsheet, berliner, tabloid or
+ *  compact) shows folded newsprint unless the settings name a stock or a
+ *  binding (#506). */
 export function appearanceOf(doc, own) {
     const page = doc.pages[0];
     const before = Math.max(0, own?.extraPages?.before ?? doc.pageIndexOffset ?? 0);
     const after = Math.max(0, own?.extraPages?.after ?? (doc.bookPageCount ?? 0) - before - doc.pages.length);
-    const folio = own && "folio" in own ? own.folio : doc.config.folio;
+    const folio = folioForTrim(own && "folio" in own ? own.folio : doc.config.folio, doc.config.page.sizePreset);
     // The document's own covers: the book's first page (a recto) and its
     // last, when that is a verso (an even page number). A chapter from the
     // middle of the book has neither: its first and last leaves are paper
@@ -38,11 +41,11 @@ export function appearanceOf(doc, own) {
     const ownCovers = resolveFolioConfig(folio).binding.cover === "pages";
     const total = before + doc.pages.length;
     return {
-        folio: doc.config.folio,
         covers: { front: ownCovers && before === 0, back: ownCovers && after === 0 && total % 2 === 0 },
         // Page sizes are in device pixels at the page's dpi.
         ...(page ? { pageWidthMm: (trimmedSize(page, doc).width * 25.4) / (doc.config.page.dpi || 300) } : {}),
         ...own,
+        folio,
         extraPages: { before, after },
     };
 }
@@ -124,6 +127,9 @@ export function sweepFor(run, settled, target, count) {
 }
 /** Painting time per frame while leaves are in the air. */
 const SWEEP_BUDGET_MS = 8;
+/** The reader has asked for less motion: no video starts on its own to
+ *  play alongside the others. */
+const reducedMotion = () => typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
 /** How long the book must stay as it is before a video set to play on its
  *  own starts (a host's layouts settling, a run of turns). */
 const AUTOPLAY_SETTLE_MS = 700;
@@ -326,14 +332,18 @@ export function createFolioFromDocument(container, doc, options = {}) {
         // The leaf a hand would lift next shows the neighbours' pages.
         return [...pages, pages[0] - 2, pages[0] - 1, pages[pages.length - 1] + 1, pages[pages.length - 1] + 2];
     };
-    // ── Videos on the pages (#477) ──
+    // ── Videos on the pages (#477, #507) ──
     /** The video spots of each page of the current document, as found. */
     let spots = new Map();
-    /** The video playing (or paused) on a page; `autoMuted` while it plays
-     *  muted because it started on its own. */
-    let playing = null;
-    /** The videos that have started on their own once (`player.autoplay`). */
+    /** The videos playing (or paused) on the pages, in the order they
+     *  started. */
+    let players = [];
+    /** The videos that have started on their own once (`player.autoplay`
+     *  with `exclusive`). */
     const autoplayed = new Set();
+    /** The videos playing alongside that have started on their own since
+     *  their page last came into view (`page|key`). */
+    const autoStarted = new Set();
     const spotsOf = (i) => {
         let found = spots.get(i);
         if (!found) {
@@ -351,57 +361,118 @@ export function createFolioFromDocument(container, doc, options = {}) {
         return (v.fileId ? options.videoUrl?.(v.fileId) : undefined) ?? v.link;
     };
     const spotAt = (point) => options.videos === false ? undefined : spotsOf(point.page).find((s) => urlOf(s) && spotContains(s, point.x, point.y));
-    const report = (state) => {
-        if (playing)
-            options.onVideo?.({ resourceId: playing.spot.resourceId, page: playing.page, state });
+    const playerOf = (page, spot) => players.find((p) => p.page === page && p.spot.key === spot.key);
+    const onShow = (p) => viewer.state.pages.includes(p.page);
+    const report = (p, state) => {
+        options.onVideo?.({ resourceId: p.spot.resourceId, page: p.page, state });
     };
-    /** Shows the playing video on its page (once it has a frame to show). */
-    function showVideo() {
-        if (!playing)
-            return;
-        playing.shown = true;
-        viewer.setPageVideo({ page: playing.page, element: playing.element, origin: playing.spot.origin, across: playing.spot.across, down: playing.spot.down, ...(playing.spot.crop ? { crop: playing.spot.crop } : {}) });
+    /** Shows the videos that have a frame to show on their pages. */
+    function showVideos() {
+        viewer.setPageVideos(players
+            .filter((p) => p.shown)
+            .map((p) => ({ page: p.page, element: p.element, origin: p.spot.origin, across: p.spot.across, down: p.spot.down, ...(p.spot.crop ? { crop: p.spot.crop } : {}) })));
     }
-    function stopVideo(state = "stopped") {
-        const p = playing;
-        if (!p)
+    /** Stops a video: its poster shows again, and the videos it held go on. */
+    function stopPlayer(p, state = "stopped") {
+        if (!players.includes(p))
             return;
-        report(state);
-        playing = null;
+        players = players.filter((q) => q !== p);
+        report(p, state);
         p.element.pause();
         p.release?.();
         if (p.shown)
-            viewer.setPageVideo(null);
+            showVideos();
+        resumeHeld(p);
+    }
+    function stopVideos() {
+        for (const p of [...players])
+            stopPlayer(p);
+    }
+    /** The videos playing alongside that `by` held go on (on show only),
+     *  and those set to play on their own that have not started yet start. */
+    function resumeHeld(by) {
+        if (by.alongside)
+            return;
+        for (const q of players) {
+            if (q.heldBy !== by)
+                continue;
+            q.heldBy = null;
+            if (onShow(q))
+                void q.element.play().catch(() => { });
+        }
+        if (!turning)
+            autoplayOn(viewer.state.pages, { exclusive: false });
+    }
+    /** A video starts (or goes on): the others make way for it (see
+     *  `makeWay`). */
+    function makeWayFor(p) {
+        p.heldBy = null;
+        // Those waiting for another exclusive video wait for this one now.
+        if (!p.alongside)
+            for (const q of players)
+                if (q.heldBy)
+                    q.heldBy = p;
+        const list = [...players.filter((q) => q !== p), p].map((q) => ({ q, alongside: q.alongside, paused: q.element.paused }));
+        const way = makeWay(list[list.length - 1], list);
+        for (const { q } of way.hold) {
+            q.heldBy = p;
+            q.element.pause();
+        }
+        for (const { q } of way.pause)
+            q.element.pause();
+        for (const { q } of way.stop)
+            stopPlayer(q);
     }
+    /** Plays the video at `spot` on `page`, from its start; `auto` when it
+     *  starts on its own. */
     function startVideo(page, spot, auto = false) {
-        stopVideo();
         const url = urlOf(spot);
         if (!url)
             return;
+        const player = spot.video.player;
+        const alongside = player.exclusive === false;
         const element = document.createElement("video");
         element.playsInline = true;
         element.preload = "auto";
         // WebGL draws the picture only when its server allows the read.
         if (!/^(blob|data):/i.test(url))
             element.crossOrigin = "anonymous";
-        const player = spot.video.player;
+        const range = { start: spot.video.start ?? 0, end: spot.video.end };
+        // A loop from the file's start loops by itself (seamlessly); one from
+        // later on is sent back by hand.
+        element.loop = player.loop && !range.start;
         // A video that starts on its own has its sound once the reader has
         // clicked or typed on the page (the browser allows it then); before
         // that it starts muted, as browsers require, and a click unmutes it.
+        // One playing alongside always starts muted on its own: a page of
+        // living pictures is a quiet one.
         const activated = navigator.userActivation?.hasBeenActive ?? false;
-        element.muted = player.muted || (auto && !activated);
-        const entry = { page, spot, element, shown: false, autoMuted: !player.muted && element.muted };
-        playing = entry;
-        const live = () => playing === entry;
-        const range = { start: spot.video.start ?? 0, end: spot.video.end };
-        element.addEventListener("error", () => live() && stopVideo("error"));
+        element.muted = player.muted || (auto && (alongside || !activated));
+        const entry = { page, spot, element, shown: false, autoMuted: !player.muted && element.muted, alongside, heldBy: null };
+        // The others make way at once (an exclusive one, still loading, holds
+        // the videos playing alongside from now).
+        players = [...players, entry];
+        makeWayFor(entry);
+        const live = () => players.includes(entry);
+        element.addEventListener("error", () => live() && stopPlayer(entry, "error"));
         element.addEventListener("loadedmetadata", () => {
             if (range.start)
                 element.currentTime = range.start;
         }, { once: true });
-        element.addEventListener("loadeddata", () => live() && showVideo(), { once: true });
-        element.addEventListener("playing", () => live() && report("playing"));
-        element.addEventListener("pause", () => live() && !element.ended && report("paused"));
+        element.addEventListener("loadeddata", () => {
+            if (!live())
+                return;
+            entry.shown = true;
+            showVideos();
+        }, { once: true });
+        element.addEventListener("play", () => live() && makeWayFor(entry));
+        element.addEventListener("playing", () => live() && report(entry, "playing"));
+        element.addEventListener("pause", () => {
+            if (!live() || element.ended)
+                return;
+            report(entry, "paused");
+            resumeHeld(entry);
+        });
         const atEnd = () => {
             if (!live())
                 return;
@@ -410,7 +481,7 @@ export function createFolioFromDocument(container, doc, options = {}) {
                 void element.play().catch(() => { });
             }
             else
-                stopVideo();
+                stopPlayer(entry);
         };
         element.addEventListener("ended", atEnd);
         element.addEventListener("timeupdate", () => {
@@ -424,6 +495,9 @@ export function createFolioFromDocument(container, doc, options = {}) {
             if (!live())
                 return release();
             entry.release = release;
+            // Held back already (an exclusive video started meanwhile).
+            if (entry.heldBy)
+                return;
             // The click's gesture lets it play with sound; a browser that still
             // refuses gets it muted.
             element.play().catch((err) => {
@@ -435,8 +509,8 @@ export function createFolioFromDocument(container, doc, options = {}) {
                     return element.play();
                 }
                 throw err;
-            }).catch(() => live() && stopVideo("error"));
-        }, () => live() && stopVideo("error"));
+            }).catch(() => live() && stopPlayer(entry, "error"));
+        }, () => live() && stopPlayer(entry, "error"));
     }
     /** A click at a point of a page: plays, pauses or resumes the video
      *  printed there. */
@@ -444,18 +518,16 @@ export function createFolioFromDocument(container, doc, options = {}) {
         const spot = spotAt(point);
         if (!spot)
             return false;
-        if (playing && playing.page === point.page && playing.spot.key === spot.key)
-            togglePlaying();
+        const p = playerOf(point.page, spot);
+        if (p)
+            togglePlaying(p);
         else
             startVideo(point.page, spot);
         return true;
     }
-    /** A click (or Space) on the video playing: one that started on its own
+    /** A click (or Space) on a video playing: one that started on its own
      *  is unmuted first; otherwise it pauses or resumes. */
-    function togglePlaying() {
-        const p = playing;
-        if (!p)
-            return;
+    function togglePlaying(p) {
         if (p.autoMuted && !p.element.paused) {
             p.autoMuted = false;
             p.element.muted = false;
@@ -477,42 +549,51 @@ export function createFolioFromDocument(container, doc, options = {}) {
                 autoplayOn(viewer.state.pages);
         }, AUTOPLAY_SETTLE_MS);
     };
-    /** The first time a spread shows a video set to play on its own
-     *  (`player.autoplay`), it starts, muted; never again in this viewer. */
-    function autoplayOn(pages) {
-        if (options.videos === false || playing)
+    /**
+     * The videos on show set to play on their own (`player.autoplay`) start,
+     * muted. One playing alongside the others (`exclusive: false`) starts
+     * each time its page comes into view (not while an exclusive video
+     * plays there, nor when the reader asks for less motion); an exclusive
+     * one, the first time its spread is shown and never again in this
+     * viewer, when no other exclusive video is on.
+     */
+    function autoplayOn(pages, { exclusive = true } = {}) {
+        if (options.videos === false)
             return;
-        for (const page of pages) {
-            for (const spot of spotsOf(page)) {
-                if (!spot.video.player.autoplay || !urlOf(spot) || autoplayed.has(spot.key))
-                    continue;
+        const state = {
+            players: players.map((p) => ({ page: p.page, key: p.spot.key, alongside: p.alongside, paused: p.element.paused, shown: p.shown })),
+            autoplayed,
+            autoStarted,
+        };
+        for (const { page, spot } of autoplayPlan(pages, spotsOf, (s) => !!urlOf(s), state, { exclusive, reducedMotion: reducedMotion() })) {
+            if (spot.video.player.exclusive === false)
+                autoStarted.add(autoKey(page, spot.key));
+            else
                 autoplayed.add(spot.key);
-                startVideo(page, spot, true);
-                return;
-            }
+            startVideo(page, spot, true);
         }
     }
-    /** A new layout: the playing video follows its resource to where the
-     *  layout puts it, or stops when it is gone. */
-    function followVideo() {
+    /** A new layout: each video follows its resource to where the layout
+     *  puts it, or stops when it is gone (or, at rest, off the pages on
+     *  show). */
+    function followVideos() {
         spots = new Map();
-        const p = playing;
-        if (!p)
-            return;
-        const near = [p.page, ...viewer.state.pages];
-        for (let i = 0; i < current.pages.length; i++)
-            near.push(i);
-        for (const i of near) {
-            const spot = spotsOf(i).find((s) => s.key === p.spot.key && urlOf(s) === urlOf(p.spot));
-            if (!spot)
+        let moved = false;
+        for (const p of [...players]) {
+            const near = [p.page, ...viewer.state.pages];
+            for (let i = 0; i < current.pages.length; i++)
+                near.push(i);
+            const at = near.find((i) => spotsOf(i).some((s) => s.key === p.spot.key && urlOf(s) === urlOf(p.spot)));
+            if (at === undefined || (!turning && !viewer.state.pages.includes(at))) {
+                stopPlayer(p);
                 continue;
-            p.page = i;
-            p.spot = spot;
-            if (p.shown)
-                showVideo();
-            return;
+            }
+            p.page = at;
+            p.spot = spotsOf(at).find((s) => s.key === p.spot.key && urlOf(s) === urlOf(p.spot));
+            moved ||= p.shown;
         }
-        stopVideo();
+        if (moved)
+            showVideos();
     }
     const first = doc.pages[0];
     const viewer = createFolio(container, {
@@ -538,9 +619,13 @@ export function createFolioFromDocument(container, doc, options = {}) {
         isPageAction: (point) => !!spotAt(point) || !!options.isPageAction?.(point),
         onChange: (state) => {
             // A video whose page has turned away stops; one set to play on its
-            // own starts the first time its spread is shown.
-            if (playing && !state.pages.includes(playing.page))
-                stopVideo();
+            // own starts when its spread is shown (see `autoplayOn`).
+            for (const p of [...players])
+                if (!state.pages.includes(p.page))
+                    stopPlayer(p);
+            for (const key of [...autoStarted])
+                if (!state.pages.some((i) => key.startsWith(autoKey(i, ""))))
+                    autoStarted.delete(key);
             scheduleAutoplay();
             focus = state.pages;
             settled = state.pages;
@@ -570,7 +655,7 @@ export function createFolioFromDocument(container, doc, options = {}) {
     // Debugging (`__postextFolioPreserve`, as for the renderer): the videos.
     if (globalThis.__postextFolioPreserve) {
         globalThis.__postextFolioVideos = {
-            playing: () => playing,
+            playing: () => players,
             autoplayed,
             spots: (i) => spotsOf(i),
             state: () => viewer.state,
@@ -582,8 +667,10 @@ export function createFolioFromDocument(container, doc, options = {}) {
         if (event.target !== viewer.element || (event.key !== " " && event.key !== "Enter") || options.videos === false)
             return;
         const on = viewer.state.pages;
-        if (playing && on.includes(playing.page))
-            togglePlaying();
+        const shown = players.filter((p) => on.includes(p.page));
+        const p = shown.find((x) => !x.alongside) ?? shown[0];
+        if (p)
+            togglePlaying(p);
         else {
             const page = on.find((i) => spotsOf(i).some((s) => urlOf(s)));
             if (page === undefined)
@@ -601,8 +688,9 @@ export function createFolioFromDocument(container, doc, options = {}) {
         setPages: viewer.setPages,
         refreshPage: viewer.refreshPage,
         setPageVideo: viewer.setPageVideo,
+        setPageVideos: viewer.setPageVideos,
         toggleVideoAt,
-        stopVideo: () => stopVideo(),
+        stopVideo: stopVideos,
         setLabels: viewer.setLabels,
         resetView: viewer.resetView,
         getView: viewer.getView,
@@ -679,7 +767,7 @@ export function createFolioFromDocument(container, doc, options = {}) {
                 run = null;
             }
             refresh(around(viewer.state));
-            followVideo();
+            followVideos();
             scheduleAutoplay();
         },
         redecorate(pages) {
@@ -698,7 +786,7 @@ export function createFolioFromDocument(container, doc, options = {}) {
         },
         dispose() {
             clearTimeout(autoTimer);
-            stopVideo();
+            stopVideos();
             cancelIdle(idle);
             cancelAnimationFrame(sweepFrame);
             clearTimeout(resizeTimer);