@joewinke/jatui 0.50.1 → 0.51.0

package/dist/components/VideoPlayer.svelte

@@ -267,6 +267,7 @@
 		SETTINGS_WRITE_DELAY_MS,
 		VIDEO_SETTINGS,
 		REMEMBERED_MUTED,
+		REMEMBERED_SPEAKER_SPEEDS,
 		REMEMBERED_TRANSCRIPT,
 		REMEMBERED_VOLUME,
 		type SettingAvailability,
@@ -1566,6 +1567,53 @@
 		resumeFollow();
 	}
 
+	// ── Per-speaker manual speed (E73, jatui-p3m3u) ──────────────────
+	// Extension parity (library.js:4605): the chip menu's "this speaker at
+	// 1.5×". Remembered per viewer through the remembered-settings split (the
+	// host's settingsStore, else this browser's localStorage) — a choice made
+	// before the load-time read resolves wins, like every remembered state.
+	const localSpeedStore = localSettingsStore();
+	let speedsTouched = false;
+	let viewerSpeakerSpeeds = $state<Record<string, number>>({});
+
+	/** Set (or, with rate 1/null, clear) one speaker's manual speed and save it. */
+	function setSpeakerSpeed(key: string, rate: number | null) {
+		const next = { ...viewerSpeakerSpeeds };
+		const r = rate == null || rate === 1 ? null : Math.min(16, Math.max(0.0625, rate));
+		if (r != null) next[key] = r;
+		else delete next[key];
+		viewerSpeakerSpeeds = next;
+		speedsTouched = true;
+		writeRemembered(
+			settingsStore ?? localSpeedStore,
+			REMEMBERED_SPEAKER_SPEEDS.id,
+			Object.keys(next).length > 0 ? { ...next } : {}
+		);
+	}
+
+	function speakerSpeedOf(key: string): number {
+		return viewerSpeakerSpeeds[key] ?? 1;
+	}
+
+	// The load-time read, once: a junk store reads as nothing stored, and a
+	// choice made before the read resolves wins (the settings session's rule).
+	$effect(() => {
+		const store = settingsStore ?? localSpeedStore;
+		let cancelled = false;
+		untrack(() => {
+			void Promise.resolve(store.get(REMEMBERED_SPEAKER_SPEEDS.id))
+				.then((raw) => {
+					if (cancelled || speedsTouched) return;
+					const v = REMEMBERED_SPEAKER_SPEEDS.coerce(raw);
+					if (v !== undefined) viewerSpeakerSpeeds = v;
+				})
+				.catch(() => {});
+		});
+		return () => {
+			cancelled = true;
+		};
+	});
+
 	// ── Speed + rate composer (video/rate/*, mos-5lzns.32) ──────────────────
 	// rate = base × speaker × silence. `base` is the only rate a human chose
 	// and the only one the OSD reports; the advisors multiply into the APPLIED
@@ -1574,10 +1622,27 @@
 	// exactly `base` — the contract in video/rate/compose.ts.
 	const rateTurns = $derived(toRateTurns(speakers));
 	const rateSegments = $derived(toRateSegments(transcript));
+	// E73 (jatui-p3m3u) — the viewer's hand-set per-speaker speeds (the chip
+	// menu, remembered per viewer). They multiply with the automatic advisor
+	// and the base, whatever either is doing; an empty map is the identity.
+	// The chip/legend keys a speaker by IDENTITY (speakerKeyOf), the rate
+	// composer keys by NAME (speakerNameOf) — the index bridges the two.
+	const viewerSpeedByName = $derived.by(() => {
+		const keys = Object.keys(viewerSpeakerSpeeds);
+		if (keys.length === 0) return null;
+		const out: Record<string, number> = {};
+		for (const key of keys) {
+			const info = speakerIndex.get(key);
+			const name = info && info.name !== 'Unknown speaker' ? info.name : key;
+			out[name] = viewerSpeakerSpeeds[key];
+		}
+		return out;
+	});
 	const rateAdvisors = $derived({
 		speakerRates: speakerPace
 			? speakerRateMap({ turns: rateTurns, segments: rateSegments, manual: speakerRates, measure: true })
 			: null,
+		manual: viewerSpeedByName,
 		turns: rateTurns,
 		silence: smartSpeed ? silenceMapFor(waveform, effectiveDuration) : null
 	});
@@ -3679,6 +3744,31 @@
 		return t.speakerIdentity ?? t.speakerName ?? UNKNOWN_KEY;
 	}
 
+	// ── Chip speed menu (E73, jatui-p3m3u) ──────────────────────────────────
+	// One menu open at a time; a click anywhere else closes it.
+	let speedMenuKey = $state<string | null>(null);
+	const SPEED_CHOICES = [0.75, 1, 1.25, 1.5, 1.75, 2, 3];
+
+	function toggleSpeedMenu(key: string) {
+		speedMenuKey = speedMenuKey === key ? null : key;
+	}
+	function pickSpeakerSpeed(key: string, name: string, rate: number) {
+		setSpeakerSpeed(key, rate);
+		speedMenuKey = null;
+		flashOsd(rate === 1 ? `${name} · 1×` : `${name} · ${formatSpeedLabel(rate)}`);
+	}
+	$effect(() => {
+		if (speedMenuKey == null) return;
+		const close = (e: PointerEvent) => {
+			// A press inside the open menu (or on its trigger) is the menu's own
+			// click — the buttons close it themselves.
+			if ((e.target as Element | null)?.closest?.('.vp-speed-menu')) return;
+			speedMenuKey = null;
+		};
+		document.addEventListener('pointerdown', close);
+		return () => document.removeEventListener('pointerdown', close);
+	});
+
 	function submitBookmark() {
 		onAddBookmark?.(currentTime, bookmarkLabel.trim());
 		bookmarkLabel = '';
@@ -4201,6 +4291,7 @@
 						{@const key = talkTimeKey(tt)}
 						{@const name = tt.speakerName ?? 'Unknown speaker'}
 						<span class="vp-legend-item">
+							<span class="vp-speed-menu">
 							<button
 								type="button"
 								class="vp-chip"
@@ -4219,6 +4310,37 @@
 								{name}
 								<span class="vp-chip-time">{formatDuration(tt.seconds)}</span>
 							</button>
+							<!-- E73: this speaker's own speed, remembered. 1× is the
+							     reset; the composer clamps the product. -->
+							<button
+								type="button"
+								class="vp-chip-speed"
+								class:on={speakerSpeedOf(key) !== 1}
+								onclick={() => toggleSpeedMenu(key)}
+								aria-expanded={speedMenuKey === key}
+								aria-haspopup="menu"
+								aria-label="Speed for {name}: {formatSpeedLabel(speakerSpeedOf(key))}"
+								title="Speed for {name}"
+							>
+								{formatSpeedLabel(speakerSpeedOf(key))}
+							</button>
+							{#if speedMenuKey === key}
+								<div class="vp-speed-pop" role="menu" aria-label="Speed for {name}">
+									{#each SPEED_CHOICES as choice (choice)}
+										<button
+											type="button"
+											role="menuitemradio"
+											aria-checked={speakerSpeedOf(key) === choice}
+											class="vp-speed-opt"
+											class:current={speakerSpeedOf(key) === choice}
+											onclick={() => pickSpeakerSpeed(key, name, choice)}
+										>
+											{formatSpeedLabel(choice)}{choice === 1 ? ' (reset)' : ''}
+										</button>
+									{/each}
+								</div>
+							{/if}
+							</span>
 							<button
 								type="button"
 								class="vp-mute"
@@ -5499,6 +5621,66 @@
 		border-color: var(--color-primary);
 	}
 
+	/* E73 — per-speaker speed trigger + its menu. The wrapper is the
+	   click-outside boundary: a press inside stays the menu's own click. */
+	.vp-speed-menu {
+		position: relative;
+		display: inline-flex;
+		align-items: center;
+	}
+
+	.vp-chip-speed {
+		padding: var(--jatui-space-xs, 2px) var(--jatui-space-xs, 2px);
+		background: none;
+		border: none;
+		border-radius: var(--jatui-radius-selector, 0.375rem);
+		color: color-mix(in oklch, var(--color-base-content) 60%, transparent);
+		font-size: inherit;
+		font-variant-numeric: tabular-nums;
+		cursor: pointer;
+	}
+
+	.vp-chip-speed.on {
+		color: var(--color-primary);
+		font-weight: 600;
+	}
+
+	.vp-speed-pop {
+		position: absolute;
+		z-index: 30;
+		top: calc(100% + 4px);
+		left: 0;
+		display: flex;
+		flex-direction: column;
+		min-width: 7rem;
+		padding: var(--jatui-space-sm, 4px);
+		background: var(--color-base-100);
+		border: var(--jatui-border-w, 1px) solid color-mix(in oklch, var(--color-base-content) 15%, transparent);
+		border-radius: var(--jatui-radius-selector, 0.375rem);
+		box-shadow: 0 4px 12px rgb(0 0 0 / 0.25);
+	}
+
+	.vp-speed-opt {
+		padding: var(--jatui-space-xs, 2px) var(--jatui-space-md, 6px);
+		background: none;
+		border: none;
+		border-radius: var(--jatui-radius-selector, 0.375rem);
+		color: var(--color-base-content);
+		font-size: inherit;
+		font-variant-numeric: tabular-nums;
+		text-align: left;
+		cursor: pointer;
+	}
+
+	.vp-speed-opt:hover {
+		background: color-mix(in oklch, var(--color-base-content) 8%, transparent);
+	}
+
+	.vp-speed-opt.current {
+		color: var(--color-primary);
+		font-weight: 600;
+	}
+
 	.vp-chip-clear {
 		background: none;
 		color: var(--color-primary);

package/dist/video/README.md

@@ -18,7 +18,7 @@ props + callback surfaces.
 | `band.ts` | .28 (done) — extended by **.30** | The timeline band: zoom window (`BandWindow`, `zoomAt`, `followPlayhead`), hit tests (`segmentAt`, `chapterAt`, `biasToSegmentStart`, `nearestBookmark`), and `paintBand` (canvas). .30 adds one-axis arbitration + the light ribbon; its state lives HERE. |
 | `band/` | **.30** (done) | `window.ts` — the zoom-window math (moved out of band.ts, re-exported there; shared by every band layer without an import cycle). `axis.ts` — one-axis four-state arbitration (`resolveAxis`, `BandState`, the churn-guarded microtask `createBandReporter`), `playheadX` (the one "where you are" mapping — ≤0.2px agreement) and `overviewBracket`. `luma.ts` — the light track (`VideoLumaTrack`, the sidecar verbatim) → ribbon (`v² × 0.55`, max-per-interval). `markers.ts` — `VideoMarker` comments (clustered dots) + like heat. |
 | `keys.ts` | .28 (done) | The keyboard map — `PLAYER_KEYS` (the `?` overlay renders it), `chapterJump`, `FRAME_STEP_SEC`. Every key that exists is in the map; a key not in the map doesn't exist. |
-| `rate.ts` + `rate/` | .28 contract — **.32** (done) | `rate.ts` is the barrel. `compose.ts` — the contract (`composeRate`, clamp [0.0625, 16], `shouldWriteRate`'s 0.001 deadband with an exact return to base), the `SPEED_STEPS` staircase, `formatSpeedLabel`. `speaker.ts` — props → `advisors/speaker-rate`; manual rates keyed by NAME always beat measured. `silence.ts` — waveform → `advisors/smart-speed` map + boost + the OSD saving claim. `ads.ts` — `adSpans` ∪ `ad: true` turns; skip only when PLAYBACK runs into an ad, never when a seek lands in one. `tick.ts` — the component's own 120ms loop's one-tick decision. None of them write `playbackRate`; they advise. |
+| `rate.ts` + `rate/` | .28 contract — **.32** (done) | `rate.ts` is the barrel. `compose.ts` — the contract (`composeRate`, clamp [0.0625, 16], `shouldWriteRate`'s 0.001 deadband with an exact return to base), the `SPEED_STEPS` staircase, `formatSpeedLabel`. `speaker.ts` — props → `advisors/speaker-rate`; manual rates keyed by NAME always beat measured. `silence.ts` — waveform → `advisors/smart-speed` map + boost + the OSD saving claim. `ads.ts` — `adSpans` ∪ `ad: true` turns; skip only when PLAYBACK runs into an ad, never when a seek lands in one. `tick.ts` — the component's own 120ms loop's one-tick decision. `manual` (E73, jatui-p3m3u) — the viewer's remembered per-speaker speeds from the chip menu, multiplying with the automatic advisor; the composer clamps the product. None of them write `playbackRate`; they advise. |
 | `deepLink.ts` | .28 (done) | `?t=` parse/format/read/write (replaceState, throttled, other params preserved) + `buildTimeUrl` (jatui-3wl5x) — the `?t=` URL builder hosts pass as `buildTimeLink` (MOS's "copy link at this time" shape). |
 | `lineMenu.ts` | **jatui-3wl5x** | The transcript line right-click menu's pure pieces: `isContextMenuKey` (the keyboard's right-click — Context-menu key or Shift+F10) and `lineTextWithTime` (`[1:23] text`, the row's own clock). The component owns the DOM — which row opened it, cursor vs row anchoring, focus return — and the menu itself is the shared `ContextMenu`. |
 | `transcriptSearch.ts` | **jatui-xmtnv** (E25/E57) | The transcript search + wheel line-scrub pure helpers: `searchHits` (case-insensitive, non-overlapping), `highlightRowHtml` (`<mark>`s around matches, everything else escaped — host transcript text is never markup), `pickMatch` (Enter walks matches from the playhead, wrapping), `lineScrubTarget` + `transcriptWheelDecision`/`effectiveWheelDelta` (Shift+wheel steps a line per ~100px notch; a plain wheel is never claimed). The component owns the box, focus, Esc layering and the `n / m` count. |

package/dist/video/rate/tick.d.ts

@@ -17,6 +17,13 @@ export declare const RATE_TICK_MS = 120;
 export interface RateAdvisors {
     /** null ⇒ the speaker advisor is off (collapses to 1). */
     speakerRates: RateMap | null;
+    /**
+     * Viewer hand-set per-speaker speeds (the chip menu, remembered). They
+     * MULTIPLY with the automatic advisor — "this speaker at 1.5×" is the
+     * viewer's intent and stands on top of whatever the pace advisor measured.
+     * null/empty ⇒ 1 (the identity; see compose.ts).
+     */
+    manual?: RateMap | null;
     turns: RateTurn[];
     /** null ⇒ smart speed is off or has no map yet (collapses to 1). */
     silence: SilenceMap | null;

package/dist/video/rate/tick.js

@@ -5,11 +5,14 @@ import { speakerFactor } from './speaker';
 export const RATE_TICK_MS = 120;
 /** The composed rate at playhead `t` for the human's `base`. */
 export function adviseRate(base, t, a) {
-    const speaker = speakerFactor(t, a.turns, a.speakerRates);
+    const speaker = speakerFactor(t, a.turns, a.speakerRates) * speakerFactor(t, a.turns, a.manual ?? null);
     const silence = silenceFactor(t, a.silence, a.boost ?? null);
     return { speaker, silence, rate: composeRate(base, speaker, silence).rate };
 }
 /** Is any advisor able to move the rate? False ⇒ the loop need not run. */
 export function advisorsActive(a) {
-    return !!a.silence || (!!a.speakerRates && a.turns.length > 0 && Object.keys(a.speakerRates).length > 0);
+    const manual = a.manual;
+    return (!!a.silence ||
+        (!!manual && a.turns.length > 0 && Object.keys(manual).length > 0) ||
+        (!!a.speakerRates && a.turns.length > 0 && Object.keys(a.speakerRates).length > 0));
 }

package/dist/video/settings/remembered.d.ts

@@ -35,5 +35,15 @@ export declare const REMEMBERED_VOLUME: RememberedSpec<number>;
  */
 export type TranscriptLayout = 'side' | 'below' | 'hidden';
 export declare const REMEMBERED_TRANSCRIPT: RememberedSpec<TranscriptLayout>;
+/**
+ * Remembered per-speaker playback speed (E73, jatui-p3m3u) — the chip menu's
+ * "this speaker at 1.5×" survives a reload. A record keyed by speaker NAME
+ * (the display name in the legend), coerced entry-by-entry: junk names and
+ * rates outside the composer's clamp range drop out, so a hostile store reads
+ * as nothing stored rather than a speed of 10⁹. Composed multiplicatively
+ * with the user's speed and the automatic pace advisor by the rate composer
+ * (rate/tick.ts), which clamps the product.
+ */
+export declare const REMEMBERED_SPEAKER_SPEEDS: RememberedSpec<Record<string, number>>;
 /** Whether playback starts muted. */
 export declare const REMEMBERED_MUTED: RememberedSpec<boolean>;

package/dist/video/settings/remembered.js

@@ -39,6 +39,40 @@ export const REMEMBERED_TRANSCRIPT = {
         return undefined;
     }
 };
+/**
+ * Remembered per-speaker playback speed (E73, jatui-p3m3u) — the chip menu's
+ * "this speaker at 1.5×" survives a reload. A record keyed by speaker NAME
+ * (the display name in the legend), coerced entry-by-entry: junk names and
+ * rates outside the composer's clamp range drop out, so a hostile store reads
+ * as nothing stored rather than a speed of 10⁹. Composed multiplicatively
+ * with the user's speed and the automatic pace advisor by the rate composer
+ * (rate/tick.ts), which clamps the product.
+ */
+export const REMEMBERED_SPEAKER_SPEEDS = {
+    id: 'player.speakerSpeeds',
+    default: {},
+    coerce(raw) {
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+            return undefined;
+        const src = raw;
+        const out = {};
+        let any = false;
+        for (const [k, v] of Object.entries(src)) {
+            const name = k.trim();
+            try {
+                const n = typeof v === 'number' ? v : typeof v === 'string' && v.trim() !== '' ? Number(v) : NaN;
+                if (name && Number.isFinite(n) && n >= 0.0625 && n <= 16) {
+                    out[name] = n;
+                    any = true;
+                }
+            }
+            catch {
+                /* a throwing valueOf is a value not stored */
+            }
+        }
+        return any ? out : undefined;
+    }
+};
 /** Whether playback starts muted. */
 export const REMEMBERED_MUTED = {
     id: 'player.muted',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joewinke/jatui",
-  "version": "0.50.1",
+  "version": "0.51.0",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",