@glissade/player 0.10.1 → 0.11.0-pre.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Marker, Playhead, Timeline } from "@glissade/core";
+import { Marker, Playhead, ReadonlySignal, Timeline } from "@glissade/core";
 import { Scene } from "@glissade/scene";
 import { Canvas2DBackend } from "@glissade/backend-canvas2d";
 
@@ -116,6 +116,9 @@ interface Player {
   readonly playhead: Playhead;
   readonly duration: number;
   readonly playing: boolean;
+  /** Reactive `playing` — observers re-render on a play/pause/settle transition
+   * (the playhead doesn't move on pause, so the `playing` getter alone goes stale). */
+  readonly playingSignal: ReadonlySignal<boolean>;
   rate: number;
   play(opts?: {
     range?: [number, number];

package/dist/index.js

@@ -1,4 +1,4 @@
-import { buildFontRegistry, compileTimeline } from "@glissade/core";
+import { buildFontRegistry, compileTimeline, signal } from "@glissade/core";
 import { evaluate, validateSceneFonts } from "@glissade/scene";
 import { Canvas2DBackend } from "@glissade/backend-canvas2d";
 //#region src/driver.ts
@@ -61,6 +61,12 @@ function scrollDriver(opts) {
 }
 //#endregion
 //#region src/player.ts
+/**
+* The Player (DESIGN.md §4.2): composes a clock Driver with playback policy.
+* The only stateful object in the runtime; its state is rate, loop mode, and
+* a base-time offset. Time-based, never frame-counted — a dropped frame skips
+* ahead, it never drifts.
+*/
 /** §A.1: machine and Player track-target sets must be statically disjoint. */
 var TargetOverlapError = class extends Error {
 	constructor(overlaps) {
@@ -80,6 +86,11 @@ function createPlayer(init, opts = {}) {
 	const cueCallbacks = /* @__PURE__ */ new Map();
 	let rate = opts.rate ?? 1;
 	let playing = false;
+	const playingSig = signal(false);
+	const setPlaying = (v) => {
+		playing = v;
+		playingSig.set(v);
+	};
 	let driverRunning = false;
 	let ownTargets = new Set(init.targets ?? []);
 	const machines = [];
@@ -100,7 +111,7 @@ function createPlayer(init, opts = {}) {
 		}
 	}
 	function settle(completed) {
-		playing = false;
+		setPlaying(false);
 		elapsedOrigin = null;
 		const resolve = resolveFinished;
 		resolveFinished = null;
@@ -163,6 +174,7 @@ function createPlayer(init, opts = {}) {
 		get playing() {
 			return playing;
 		},
+		playingSignal: playingSig,
 		get rate() {
 			return rate;
 		},
@@ -180,7 +192,7 @@ function createPlayer(init, opts = {}) {
 			playhead.set(base);
 			elapsedOrigin = null;
 			loopsDone = 0;
-			playing = true;
+			setPlaying(true);
 			ensureDriver();
 			return { finished: new Promise((resolve) => {
 				resolveFinished = resolve;

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@glissade/player",
-  "version": "0.10.1",
+  "version": "0.11.0-pre.1",
   "description": "glissade embed runtime: Player, Drivers (clock, scroll), mount().",
   "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20.19"
+  },
   "type": "module",
   "sideEffects": false,
   "exports": {
@@ -15,9 +18,9 @@
     "dist"
   ],
   "dependencies": {
-    "@glissade/backend-canvas2d": "0.10.1",
-    "@glissade/core": "0.10.1",
-    "@glissade/scene": "0.10.1"
+    "@glissade/backend-canvas2d": "0.11.0-pre.1",
+    "@glissade/core": "0.11.0-pre.1",
+    "@glissade/scene": "0.11.0-pre.1"
   },
   "repository": {
     "type": "git",