@glissade/player 0.19.1 → 0.20.0-pre.4

package/README.md

@@ -13,6 +13,20 @@ const { player } = mount(scene, doc, canvas, { loop: true, autoplay: true });
 player.seek(1.5); // pure: identical to having played there
 ```
 
+### Custom render backend
+
+`mount()` rasterizes through `Canvas2DBackend` by default. To drive a different
+`RenderBackend` (e.g. a future `@glissade/backend-dom` preview renderer), pass a
+factory as `opts.backend` — it receives the mount target and returns the backend:
+
+```ts
+mount(scene, doc, canvas, { backend: (target) => new MyBackend(target) });
+```
+
+Omit it and the default `Canvas2DBackend` is used, so every existing call site is
+unchanged. This is the single injection seam: `@glissade/player` never statically
+imports a non-default backend — the caller above it supplies the alternative.
+
 ## Part of glissade
 
 *(glide & slide)* — programmatic motion graphics for TypeScript: realtime-first in any web page, deterministic headless video export from the same code, a visual studio over the same document. No generator functions.

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { Marker, Playhead, ReadonlySignal, Timeline } from "@glissade/core";
-import { Scene } from "@glissade/scene";
-import { Canvas2DBackend } from "@glissade/backend-canvas2d";
+import { RenderBackend, Scene } from "@glissade/scene";
 
 //#region src/driver.d.ts
 
@@ -85,6 +84,16 @@ interface PlayerOptions {
   strictFonts?: boolean;
   /** OS-installed families to treat as registered for strict mode. */
   osFonts?: ReadonlySet<string>;
+  /**
+   * Backend-injection seam (dom-backend memo, Seam 2 — the S3 foundation). A
+   * factory that builds the `RenderBackend` mount() drives, given the render
+   * target. Defaults to `Canvas2DBackend`, so EVERY existing call site is
+   * byte-for-byte unchanged and the static `player → backend-canvas2d`
+   * dependency stands. The caller ABOVE player (element/react/an app) injects
+   * an alternative target (e.g. a future `@glissade/backend-dom`) here without
+   * forking the mount body — player itself gains no new static backend dep.
+   */
+  backend?: (target: HTMLCanvasElement | OffscreenCanvas) => RenderBackend;
 }
 interface PlayHandle {
   /** true = completed naturally, false = interrupted. Completion signal ONLY (§2). */
@@ -154,7 +163,12 @@ declare function createPlayer(init: PlayerInit, opts?: PlayerOptions): Player;
 //#region src/mount.d.ts
 interface Mounted {
   player: Player;
-  backend: Canvas2DBackend;
+  /**
+   * The live render backend. `Canvas2DBackend` by default; the abstract
+   * `RenderBackend` contract when an `opts.backend` factory was injected
+   * (dom-backend memo, Seam 2).
+   */
+  backend: RenderBackend;
   /** Force a synchronous render of the current playhead time. */
   render(): void;
   /**

package/dist/index.js

@@ -288,7 +288,7 @@ function mount(initialScene, initialDoc, canvas, opts = {}) {
 	let scene = initialScene;
 	let doc = initialDoc;
 	const compiled = compileTimeline(doc);
-	const backend = new Canvas2DBackend(canvas);
+	const backend = opts.backend ? opts.backend(canvas) : new Canvas2DBackend(canvas);
 	scene.setTextMeasurer(backend);
 	const playhead = scene.playhead;
 	const player = createPlayer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/player",
-  "version": "0.19.1",
+  "version": "0.20.0-pre.4",
   "description": "glissade embed runtime: Player, Drivers (clock, scroll), mount().",
   "license": "Apache-2.0",
   "engines": {
@@ -18,9 +18,9 @@
     "dist"
   ],
   "dependencies": {
-    "@glissade/backend-canvas2d": "0.19.1",
-    "@glissade/core": "0.19.1",
-    "@glissade/scene": "0.19.1"
+    "@glissade/backend-canvas2d": "0.20.0-pre.4",
+    "@glissade/core": "0.20.0-pre.4",
+    "@glissade/scene": "0.20.0-pre.4"
   },
   "repository": {
     "type": "git",