videowright 0.1.0

package/dist/player/hud.js

@@ -0,0 +1,357 @@
+/**
+ * Dev-mode HUD overlay.
+ * Shows segment info, timing, voiceover, mode, keyboard reference, errors.
+ */
+const HUD_STYLES = `
+.vw-hud {
+	position: absolute;
+	inset: 0;
+	pointer-events: none;
+	font-family: system-ui, -apple-system, sans-serif;
+	font-size: 13px;
+	color: #fff;
+	z-index: 9999;
+}
+.vw-hud-inner {
+	position: absolute;
+	bottom: 0;
+	left: 0;
+	right: 0;
+	background: rgba(0,0,0,0.75);
+	padding: 10px 14px;
+	pointer-events: auto;
+	display: flex;
+	flex-wrap: nowrap;
+	gap: 6px 16px;
+	align-items: center;
+	height: 100%;
+	max-width: 100vw;
+	max-height: 80px;
+	overflow: hidden;
+}
+.vw-hud-info {
+	position: relative;
+	display: flex;
+	flex-direction: column;
+	flex: 0 0 auto;
+	max-width: 30vw;
+	min-width: 0;
+	gap: 2px;
+}
+.vw-hud-row {
+	display: flex;
+	align-items: center;
+	gap: 8px;
+}
+.vw-hud-item {
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	flex-shrink: 0;
+}
+.vw-hud-label { opacity: 0.6; margin-right: 4px; }
+.vw-hud-separator { opacity: 0.5; }
+.vw-hud-vo {
+	opacity: 0.8;
+	font-style: italic;
+	min-width: 0;
+	flex: 1 1 0;
+	overflow-y: auto;
+	overflow-x: hidden;
+	max-height: 80px;
+}
+.vw-hud-keys {
+	opacity: 0.4;
+	font-size: 11px;
+	margin-left: auto;
+	flex: 0 0 auto;
+	display: grid;
+	grid-template-columns: auto auto;
+	grid-template-rows: repeat(3, auto);
+	gap: 0 12px;
+	max-height: 80px;
+	overflow-y: auto;
+}
+.vw-hud-key-item { white-space: nowrap; }
+.vw-hud-ended {
+	font-size: 10px;
+	text-transform: uppercase;
+	opacity: 0.7;
+	line-height: 1;
+	position: absolute;
+	top: -12px;
+	left: 0;
+}
+/* Error display: horizontal layout for fixed-height HUD strip.
+   Left accent + icon | two-line title+message (truncated) | reload button.
+   Click the error text to log the full stack trace to the browser console,
+   since the fixed 80px HUD height is too small for inline stack display. */
+.vw-hud-error-overlay {
+	position: absolute;
+	inset: 0;
+	background: rgba(50,10,10,0.95);
+	border-left: 4px solid #e54;
+	display: flex;
+	flex-direction: row;
+	align-items: center;
+	pointer-events: auto;
+	padding: 0 16px;
+	gap: 12px;
+	overflow: hidden;
+}
+.vw-hud-error-icon {
+	font-size: 24px;
+	line-height: 1;
+	flex-shrink: 0;
+	opacity: 0.9;
+}
+.vw-hud-error-text {
+	flex: 1 1 0;
+	min-width: 0;
+	overflow: hidden;
+	cursor: pointer;
+}
+.vw-hud-error-title {
+	font-size: 14px;
+	font-weight: 600;
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	margin: 0;
+}
+.vw-hud-error-message {
+	font-size: 13px;
+	opacity: 0.8;
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	margin: 2px 0 0;
+}
+.vw-hud-btn {
+	background: rgba(255,255,255,0.2);
+	border: 1px solid rgba(255,255,255,0.4);
+	color: #fff;
+	padding: 6px 14px;
+	border-radius: 4px;
+	cursor: pointer;
+	font-size: 13px;
+	white-space: nowrap;
+	flex-shrink: 0;
+}
+.vw-hud-btn:hover { background: rgba(255,255,255,0.3); }
+.vw-hud-play {
+	background: rgba(255,255,255,0.15);
+	border: 1px solid rgba(255,255,255,0.35);
+	color: #fff;
+	width: 36px;
+	height: 36px;
+	border-radius: 50%;
+	cursor: pointer;
+	font-size: 16px;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	pointer-events: auto;
+	padding: 0;
+	line-height: 1;
+	flex-shrink: 0;
+}
+.vw-hud-play:hover { background: rgba(255,255,255,0.3); }
+`;
+const KEY_BINDINGS = [
+    "→: next",
+    "←: prev",
+    "Space: play/pause",
+    "R: restart",
+    "H: HUD",
+    "1-9: jump",
+];
+function formatTime(ms) {
+    const s = Math.floor(ms / 1000);
+    const m = Math.floor(s / 60);
+    const sec = s % 60;
+    return `${m}:${sec.toString().padStart(2, "0")}`;
+}
+let hudStyleRefCount = 0;
+function acquireHudStyles() {
+    hudStyleRefCount++;
+    if (hudStyleRefCount === 1) {
+        const style = document.createElement("style");
+        style.setAttribute("data-vw-hud", "");
+        style.textContent = HUD_STYLES;
+        document.head.appendChild(style);
+    }
+}
+function releaseHudStyles() {
+    hudStyleRefCount--;
+    if (hudStyleRefCount <= 0) {
+        hudStyleRefCount = 0;
+        const style = document.querySelector("style[data-vw-hud]");
+        if (style)
+            style.remove();
+    }
+}
+export function createHud(options) {
+    const el = document.createElement("div");
+    el.className = "vw-hud";
+    acquireHudStyles();
+    let isVisible = true;
+    // Persistent play button -- created once, updated on each render.
+    let playBtn = null;
+    if (options?.onPlayToggle) {
+        playBtn = document.createElement("button");
+        playBtn.className = "vw-hud-play";
+        playBtn.textContent = "▶";
+        playBtn.title = "Play";
+        const handler = options.onPlayToggle;
+        playBtn.addEventListener("click", (e) => {
+            e.stopPropagation();
+            handler();
+        });
+    }
+    const hud = {
+        el,
+        get visible() {
+            return isVisible;
+        },
+        update(state) {
+            el.innerHTML = "";
+            if (state.error) {
+                el.appendChild(renderError(state.error));
+                return;
+            }
+            if (!isVisible)
+                return;
+            const inner = document.createElement("div");
+            inner.className = "vw-hud-inner";
+            // Play/pause button (shown in dev mode, not render)
+            if (state.mode !== "render" && playBtn) {
+                playBtn.textContent = state.playbackMode === "playing" ? "⏸" : "▶";
+                playBtn.title = state.playbackMode === "playing" ? "Pause" : "Play";
+                inner.appendChild(playBtn);
+            }
+            // Info column: segment label + timing row
+            const info = document.createElement("div");
+            info.className = "vw-hud-info";
+            // Ended indicator (absolutely positioned above segment line)
+            if (state.ended) {
+                const badge = document.createElement("div");
+                badge.className = "vw-hud-ended";
+                badge.textContent = "END OF TIMELINE";
+                info.appendChild(badge);
+            }
+            // Row 0: segment label
+            const row0 = document.createElement("div");
+            row0.className = "vw-hud-row";
+            const segItem = document.createElement("span");
+            segItem.className = "vw-hud-item";
+            const segLabel = document.createElement("span");
+            segLabel.className = "vw-hud-label";
+            segLabel.textContent = "segment:";
+            segItem.appendChild(segLabel);
+            segItem.appendChild(document.createTextNode(`${state.beat} ${state.segmentId}`));
+            row0.appendChild(segItem);
+            info.appendChild(row0);
+            // Row 1: timing row
+            const row1 = document.createElement("div");
+            row1.className = "vw-hud-row";
+            const segTimeItem = document.createElement("span");
+            segTimeItem.className = "vw-hud-item";
+            const segTimeLabel = document.createElement("span");
+            segTimeLabel.className = "vw-hud-label";
+            segTimeLabel.textContent = "seg time:";
+            segTimeItem.appendChild(segTimeLabel);
+            segTimeItem.appendChild(document.createTextNode(formatTime(state.segmentTime)));
+            row1.appendChild(segTimeItem);
+            const separator = document.createElement("span");
+            separator.className = "vw-hud-separator";
+            separator.textContent = "·";
+            row1.appendChild(separator);
+            const totalItem = document.createElement("span");
+            totalItem.className = "vw-hud-item";
+            const totalLabel = document.createElement("span");
+            totalLabel.className = "vw-hud-label";
+            totalLabel.textContent = "total:";
+            totalItem.appendChild(totalLabel);
+            totalItem.appendChild(document.createTextNode(formatTime(state.totalTime)));
+            row1.appendChild(totalItem);
+            info.appendChild(row1);
+            inner.appendChild(info);
+            // Voiceover (only when truthy)
+            if (state.voiceover) {
+                const vo = document.createElement("div");
+                vo.className = "vw-hud-vo";
+                vo.textContent = state.voiceover;
+                inner.appendChild(vo);
+            }
+            // Keyboard shortcuts
+            const keys = document.createElement("div");
+            keys.className = "vw-hud-keys";
+            for (const binding of KEY_BINDINGS) {
+                const keyItem = document.createElement("span");
+                keyItem.className = "vw-hud-key-item";
+                keyItem.textContent = binding;
+                keys.appendChild(keyItem);
+            }
+            inner.appendChild(keys);
+            el.appendChild(inner);
+        },
+        show() {
+            isVisible = true;
+            el.style.display = "";
+        },
+        hide() {
+            isVisible = false;
+            el.style.display = "none";
+        },
+        toggle() {
+            if (isVisible)
+                hud.hide();
+            else
+                hud.show();
+        },
+        destroy() {
+            releaseHudStyles();
+        },
+    };
+    return hud;
+}
+function renderError(error) {
+    const overlay = document.createElement("div");
+    overlay.className = "vw-hud-error-overlay";
+    // Error icon
+    const icon = document.createElement("span");
+    icon.className = "vw-hud-error-icon";
+    icon.textContent = "⚠"; // warning sign
+    overlay.appendChild(icon);
+    // Two-line text block: title + message (both truncated with ellipsis)
+    const textBlock = document.createElement("div");
+    textBlock.className = "vw-hud-error-text";
+    const title = document.createElement("div");
+    title.className = "vw-hud-error-title";
+    title.textContent = `Segment error: ${error.segmentId}`;
+    title.title = `Segment error: ${error.segmentId}`;
+    textBlock.appendChild(title);
+    const msg = document.createElement("div");
+    msg.className = "vw-hud-error-message";
+    msg.textContent = error.message;
+    msg.title = error.stack ? `${error.message}\n\n${error.stack}` : error.message;
+    textBlock.appendChild(msg);
+    textBlock.addEventListener("click", () => {
+        if (error.stack) {
+            console.error(`[Videowright] Segment error: ${error.segmentId}\n${error.message}\n\n${error.stack}`);
+        }
+        else {
+            console.error(`[Videowright] Segment error: ${error.segmentId}\n${error.message}`);
+        }
+    });
+    overlay.appendChild(textBlock);
+    // Reload button
+    const reloadBtn = document.createElement("button");
+    reloadBtn.className = "vw-hud-btn";
+    reloadBtn.textContent = "Reload";
+    reloadBtn.addEventListener("click", () => location.reload());
+    overlay.appendChild(reloadBtn);
+    return overlay;
+}
+//# sourceMappingURL=hud.js.map

package/dist/player/hud.js.map

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

package/dist/player/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Player runtime.
+ * Orchestrates segment lifecycle, transitions, input, hash routing, and HUD.
+ */
+import type { SegmentLoaderMap, TransitionLoaderMap } from "../timeline/index.js";
+import type { Timeline } from "../types.js";
+export interface PlayerOptions {
+    hud?: boolean;
+    /** Enable render mode: deterministic frame-by-frame advance, no interactive input. */
+    renderMode?: boolean;
+    /** Frames per second for render mode clock. Default 60. */
+    fps?: number;
+    /** Vite-served audio file URL for voiceover playback (dev only). */
+    audioFile?: string;
+    /**
+     * Fully resolved per-segment timing for auto-advance.
+     * Keys are segment ids; values are advance times in seconds (segment-relative).
+     */
+    resolvedTiming?: Record<string, number[]>;
+}
+type PlayerState = "idle" | "loading" | "playing" | "transitioning" | "ended" | "errored";
+export declare class Player {
+    private host;
+    private hostWrapper;
+    private options;
+    private state;
+    private timeline;
+    private segmentLoaders;
+    private transitionLoaders;
+    private slotA;
+    private slotB;
+    private currentSlot;
+    private hud;
+    private cleanupInput;
+    private cleanupHashChange;
+    private startedAt;
+    private started;
+    private transitioning;
+    private audioEl;
+    private _playbackMode;
+    private autoAdvanceTimer;
+    /** Drift tolerance in ms: snap audio if it drifts beyond this threshold. */
+    private static readonly DRIFT_TOLERANCE_MS;
+    constructor(host: HTMLElement, options?: PlayerOptions);
+    load(timeline: Timeline, segmentLoaders: SegmentLoaderMap, transitionLoaders?: TransitionLoaderMap): Promise<void>;
+    start(): Promise<void>;
+    destroy(): void;
+    get currentState(): PlayerState;
+    get currentSegmentId(): string | null;
+    get currentTimelineIndex(): number;
+    get isEnded(): boolean;
+    get isTransitioning(): boolean;
+    get playbackMode(): "idle" | "playing";
+    togglePlayback(): void;
+    private enterPlaying;
+    private enterIdle;
+    private cancelAutoAdvance;
+    /**
+     * Compute the logical audio time based on where we are in the timeline.
+     * Walks the resolved timing from segment 0 up to the current segment + beat.
+     */
+    private computeLogicalAudioTime;
+    /**
+     * Compute the time until the next advance in the current segment, then schedule it.
+     *
+     * @param driftCorrectionMs - Signed milliseconds to add to the delay.
+     *   Positive = schedule is ahead of audio, so delay is lengthened.
+     *   Negative = schedule is behind audio, so delay is shortened.
+     *   Passed from autoAdvanceTick when drift exceeds DRIFT_TOLERANCE_MS.
+     */
+    private scheduleNextAutoAdvance;
+    private autoAdvanceTick;
+    /**
+     * Advance one beat in render mode. Returns false when the timeline is exhausted.
+     * Only valid when the player was constructed with renderMode: true.
+     *
+     * @param isLast - true when this is the final scheduled advance for the
+     *   current segment. On the last beat the method always transitions to the
+     *   next segment (after draining any pending waitForNext resolver).
+     *
+     * Transitions are NOT awaited — WAAPI animations are driven by the JS time
+     * shim's virtual clock, so they complete as the render driver advances time.
+     * Awaiting transition completion here would deadlock because the transition's
+     * `.finished` promises only resolve when the shim advances the clock.
+     */
+    renderAdvance(isLast: boolean): Promise<boolean>;
+    private handleCommand;
+    /**
+     * Advance one beat. In manual-nav mode (isLastAdvance omitted / false),
+     * draining a pending waitForNext resolver counts as consuming the press
+     * and the player stays on the current segment. When called from
+     * autoAdvanceTick with isLastAdvance=true, the method forces a segment
+     * transition after draining the resolver -- otherwise the last scheduled
+     * advance would be consumed without ever transitioning out.
+     */
+    private handleNext;
+    private handlePrev;
+    private handleRestart;
+    private jumpToIndex;
+    private transitionTo;
+    private mountSegmentAt;
+    private resolveTransition;
+    private getTransitionDuration;
+    private onExternalHashChange;
+    private jumpToSegmentBeat;
+    private handleLifecycleError;
+    private setError;
+    private updateHud;
+    private totalElapsed;
+    /**
+     * Set document.body.dataset.vwState to the current player state.
+     * Used by the render driver to detect when the player is idle (not transitioning)
+     * and ready for the next action.
+     *
+     * States: "idle" | "loading" | "playing" | "transitioning" | "ended" | "errored"
+     */
+    private broadcastState;
+    private getCurrentSlot;
+    private getOtherSlot;
+    private findSegmentIndex;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/player/index.d.ts.map

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