@joewinke/jatui 0.50.0 → 0.51.0

package/CLAUDE.md

@@ -177,7 +177,7 @@ Item-by-item review surfaces (MOS review-ux, design mos-z8vgx). One `VerdictOpti
 | `ThumbnailGrid` | Generic thumbnail strip (chimaro port) — image tiles with text-tile fallback, +N overflow counter, remove/add affordances. Decoupled from any media library: pass `{id, url, alt}` items, or a `cell` snippet for full control of tile contents. `removeMode` — `'hover'` (default) reveals the × on hover/focus and keeps it visible on coarse (touch) pointers (ContextMenuTrigger pattern); `'always'` pins it for touch-first flows. `gridCols` (e.g. `'grid-cols-2 sm:grid-cols-4'`) switches the strip to a responsive CSS grid with column-filling tiles. Items take optional `progress` (0–100): an upload ring draws around the tile and a tiny % occupies the remove-× corner, cross-fading into the × at 100 (same slot, no layout shift; per-tile `role="progressbar"`). | `items: ThumbnailItem[]` (`{id, url?, alt, progress?}`), `max`, `size` (`xs\|sm\|md\|lg`), `removable`+`onRemove`, `removeMode` (`hover\|always`), `addable`+`onAdd`, `onSelect`, `gridCols`, `class`, `cell` snippet |
 | `MediaWorkbench` | Full-featured image editor modal — upload, AI generate, AI edit, background removal, annotation canvas. **Preferred over `SmartImageEditor` for new image fields.** Two-column modal: preview left, 4 action tabs right (Generate, Edit, Remove BG, Annotate). Save uploads blob to `uploadEndpoint` or emits `onComplete`. Requires proxy endpoints from jst-23w1l.2. | `value` (bindable `string \| null`), `uploadEndpoint?` (default `/api/media`), `onComplete?`, `accept?` |
 | `MediaLightbox` | Full-screen media preview — z-9040 backdrop, arrow-key paging when given an array, `+/-/0` zoom, download action, Escape/backdrop close. **Use this for the general "just show it big" case** — replaces hand-rolled `fixed inset-0 z-[9040]` modals. For annotated / markup-overlaid image previews, use `ImageLightbox` instead. | `src?`, `filename?`, `kind?: 'image' \| 'video'`, `downloadUrl?`, `items?: MediaItem[]`, `initialIndex?`, `onClose?`, `zIndex?` |
-| `VideoPlayer` | **The default video surface — reach for this over a bare `<video controls>`.** One timeline band carrying a waveform-envelope scrubber, chapter flags (top edge), bookmark diamonds (bottom edge), diarized speaker colouring and scroll-to-zoom, plus an optional transcript pane (click to seek, active line auto-scroll, solo/skip per speaker, `Shift+T` toggle) and a "Talk time" legend (2+ speakers only; one voice gets no legend and no per-row name). **`kind="audio"` renders no stage**, and **`transport="band"`** (the audio default) drops the native `<video controls>` bar for a transport row on the band (play/pause, `now / total`, speed, mute + volume, fullscreen for video), so the band is the ONE timeline. A double-click on the picture toggles fullscreen (band transport; with native controls the browser owns the gesture), a buffering spinner shows while the media is waiting, and volume/mute survive a reload through `settingsStore` (else guarded localStorage). **Every intelligence prop is optional** — a bare mp4 still gets the scrubber, hover-time card, wheel volume and the full keyboard map (Space/K, arrows/J/L, vol/mute, −/= speed + Backspace reset, </> frame step, [/] chapters, B bookmark, t theater, ? help overlay), and each pane lights up as its data arrives (nothing shifts layout when diarization lands late). Wheel means volume over the video (shift = seek, alt = speed; a wheel/keyboard volume change also flashes a clear volume OSD — glyph, level bar and %, "Muted" at 0, opacity-only fade) and zoom over the band; Shift+wheel over the transcript steps line by line (a plain wheel over the transcript scrolls the pane natively — the page is never trapped). Right-click a transcript line (or `Menu` / `Shift+F10` on a focused one) for the **line menu** — Play from here, Copy text, Copy text with timestamp (`[0:02] text`), Copy link at this time when `buildTimeLink` supplies the URL builder (without it the item is absent; `?t=` shape via `buildTimeUrl`); Escape closes and returns focus to the line, the player's keys are dead while it floats, and in fill theater Esc closes the menu without leaving the theater. Internals live in `src/lib/video/` (band/keys/rate/deepLink/settings + contracts for audio/night/presence — see that README; gap audit vs the extension: `VIDEO-PLAYER-GAP-AUDIT.md`). | `src`, `kind?` (`'video' \| 'audio'`), `transport?` (`'native' \| 'band'`), `chapters?`, `speakers?`, `transcript?`, `bookmarks?`, `waveform?`, `talkTime?`, `startAt?`, `poster?`, `captionsSrc?`, `crossorigin?` (`'anonymous'` — what frame-reading features need), `syncUrlTime?` (`?t=` deep-link, opt-in), `transcriptPosition?` (`'below' \| 'side'`), `transcriptMaxHeight?` (pane bound — default `min(40vh, 28rem)` below, the player's height beside; the active-line follow scrolls only the pane; only a gesture that actually moves the PANE pauses it — a wheel that scrolls the page doesn't — behind a "Resume following" pill, and it resumes by itself on seek / line or chapter click / play after pause / `followResumeMs` (6000) idle while playing; a hovered chapter fills its whole span in the theme accent with full-height edges), `followResumeMs?`, `transcriptLineMenu?` (true — right-click/`Menu`/`Shift+F10` on a transcript line opens the line menu; `false` leaves transcript lines to the browser's own context menu), `buildTimeLink?` ((sec) → URL for "Copy link at this time"; the host owns the address shape), `theater?` (bindable — theater mode, NOT fullscreen: control-bar button + `t`, the HOST lays the page out full-width; a side transcript moves below; remembered per viewer as the `player.theater` setting via `settingsStore`, else guarded localStorage), `theaterMode?` (`'width'` default — the host widens its page \| `'fill'` — the player becomes a fixed full-viewport dialog: `role="dialog"` + `aria-modal`, page scroll locked, Tab trapped, Esc/the button exits and returns focus, largest 16:9 stage that fits, transcript beside it ≥64rem else below, z from `--jatui-z-theater`; a remembered theater never fills on load, only a viewer gesture), `theaterButton?` (true), `onTheaterChange?`, `onTimeUpdate?`, `onAddBookmark?`, `onBookmarkContext?` |
+| `VideoPlayer` | **The default video surface — reach for this over a bare `<video controls>`.** One timeline band carrying a waveform-envelope scrubber, chapter flags (top edge), bookmark diamonds (bottom edge), diarized speaker colouring and scroll-to-zoom, plus an optional transcript pane (click to seek, active line auto-scroll, solo/skip per speaker, `Shift+T` toggle) and a "Talk time" legend (2+ speakers only; one voice gets no legend and no per-row name). **`kind="audio"` renders no stage**, and **`transport="band"`** (the audio default) drops the native `<video controls>` bar for a transport row on the band (play/pause, `now / total`, speed, mute + volume, fullscreen for video), so the band is the ONE timeline. A double-click on the picture toggles fullscreen (band transport; with native controls the browser owns the gesture), a buffering spinner shows while the media is waiting, and volume/mute survive a reload through `settingsStore` (else guarded localStorage). **Every intelligence prop is optional** — a bare mp4 still gets the scrubber, hover-time card, wheel volume and the full keyboard map (Space/K, arrows/J/L, vol/mute, −/= speed + Backspace reset, </> frame step, [/] chapters, B bookmark, t theater, ? help overlay), and each pane lights up as its data arrives (nothing shifts layout when diarization lands late). Wheel means volume over the video (shift = seek, alt = speed; a wheel/keyboard volume change also flashes a clear volume OSD — glyph, level bar and %, "Muted" at 0, opacity-only fade) and zoom over the band; Shift+wheel over the transcript steps line by line (a plain wheel over the transcript scrolls the pane natively — the page is never trapped); `/` opens an in-transcript search (only when a transcript exists and focus is not in a text field; the omnibar yields): matches highlight in place with a live `n / m` count (`aria-live`), Enter/Shift+Enter walk next/previous (seek + the line follows), Esc closes the search first in the Esc layering. Right-click a transcript line (or `Menu` / `Shift+F10` on a focused one) for the **line menu** — Play from here, Copy text, Copy text with timestamp (`[0:02] text`), Copy link at this time when `buildTimeLink` supplies the URL builder (without it the item is absent; `?t=` shape via `buildTimeUrl`); Escape closes and returns focus to the line, the player's keys are dead while it floats, and in fill theater Esc closes the menu without leaving the theater. Internals live in `src/lib/video/` (band/keys/rate/deepLink/settings + contracts for audio/night/presence — see that README; gap audit vs the extension: `VIDEO-PLAYER-GAP-AUDIT.md`). | `src`, `kind?` (`'video' \| 'audio'`), `transport?` (`'native' \| 'band'`), `chapters?`, `speakers?`, `transcript?`, `bookmarks?`, `waveform?`, `talkTime?`, `startAt?`, `poster?`, `captionsSrc?`, `crossorigin?` (`'anonymous'` — what frame-reading features need), `syncUrlTime?` (`?t=` deep-link, opt-in), `transcriptPosition?` (`'below' \| 'side'`), `transcriptMaxHeight?` (pane bound — default `min(40vh, 28rem)` below, the player's height beside; the active-line follow scrolls only the pane; only a gesture that actually moves the PANE pauses it — a wheel that scrolls the page doesn't — behind a "Resume following" pill, and it resumes by itself on seek / line or chapter click / play after pause / `followResumeMs` (6000) idle while playing; a hovered chapter fills its whole span in the theme accent with full-height edges), `followResumeMs?`, `transcriptLineMenu?` (true — right-click/`Menu`/`Shift+F10` on a transcript line opens the line menu; `false` leaves transcript lines to the browser's own context menu), `buildTimeLink?` ((sec) → URL for "Copy link at this time"; the host owns the address shape), `theater?` (bindable — theater mode, NOT fullscreen: control-bar button + `t`, the HOST lays the page out full-width; a side transcript moves below; remembered per viewer as the `player.theater` setting via `settingsStore`, else guarded localStorage), `theaterMode?` (`'width'` default — the host widens its page \| `'fill'` — the player becomes a fixed full-viewport dialog: `role="dialog"` + `aria-modal`, page scroll locked, Tab trapped, Esc/the button exits and returns focus, largest 16:9 stage that fits, transcript beside it ≥64rem else below, z from `--jatui-z-theater`; a remembered theater never fills on load, only a viewer gesture), `theaterButton?` (true), `onTheaterChange?`, `onTimeUpdate?`, `onAddBookmark?`, `onBookmarkContext?` |
 | `MediaCapture` | One-tap audio/selfie-video/screen(+mic) recording — a host-agnostic PRIMITIVE. Owns permission requests, MIME negotiation, the record/stop state machine, live self-preview, and mixes screen+mic audio into one track via AudioContext. Never uploads anything — hands the finished clip to `onCapture` as a Blob and the host decides what to do with it. `onCapture` may be async; the component shows "processing" until it resolves. | `onCapture: (result: MediaCaptureResult) => void \| Promise<void>`, `modes?` (default all three), `maxDurationMs?` (default 120000), `label?`, `hint?`, `compact?`, `disabled?` |
 | `MultimodalCaptureField` | "Upload a file, or record yourself going over it" as one input surface — composes `FileDropzone` (capped to one file) with `MediaCapture`. File and recording are independent (either, both, or neither); neither half uploads anything, same "validate and hand back" contract as `FileDropzone`. | `onFileSelected?`, `onFileRemoved?`, `onCapture?`, `onRecordingRemoved?`, `accept?`, `maxFileSize?`, `modes?`, `maxDurationMs?`, `file?`/`fileUrl?`/`fileName?`, `recordingSummary?` |
 | `ListenControl` | "Listen to this page" — a compact pill that expands into a TWO-ROW playback bar over the host's PER-SENTENCE audio (TTS): row 1 = play/pause · chapter chip + current sentence (full remaining width) · ONE settings pill ("1.25× · Sarah" → speed 0.75–2× + voice menu) · close; row 2 = prev/next sentence and −15s/+15s · a document-wide progress bar with chapter ticks (a hatched tail marks the not-yet-synthesized part), time, close. The host supplies an async `source` (sentences/paragraphs with ids → audio URLs, streamed page by page so playback starts on the first chunk while the rest synthesizes; pages merge by id so late URLs fill in) and gets `onSegmentChange(id)` at every boundary for highlight + scroll-follow. Media Session (lock-screen/headset controls, one document-wide position), keyboard scoped to the player (Space/K, ←/→ sentences, Shift+←/→ ±15s, [ / ] speed, Escape), speed+voice persisted in localStorage, `bind:api` for hosts wiring their own global keys, reduced-motion aware, token-only theming, never overflows its host (border-box, `max-width: 100%`, `min-width: 0` chain), fixed sticky mini-bar (same two rows) on narrow screens. Internals in `src/lib/listen/` (one timeline across per-sentence files — `buildTimeline` offsets; see `video/` for the doctrine). Demo synthesizes real WAVs locally. | `source`, `voices?`, `voiceId?` (bindable), `chapters?`, `title?`, `triggerLabel?`, `open?` (bindable), `preload?`, `estimateSec?`, `storageKey?`, `onSegmentChange?`, `onOpenChange?`, `api?` (bindable), `class?`, `children?` (custom trigger) |

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,9 +18,10 @@ 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. |
 | `settings.ts` + `settings/` | **.35** (done) — knobs added by .30–.34 | `settings.ts` is the barrel. `registry.ts` — `VIDEO_SETTINGS`: id, group, label, **mandatory hint**, the prop it drives, the availability gate (`when`); `coerce` never throws (hostile values, throwing `valueOf`, Symbols → undefined). Labels/hints are the single source for the panel AND a host help page. `store.ts` — the host-supplied `VideoSettingsStore` (`get`/`set`, either async; jatui never persists on its own) and `createSettingsSession`: coerced reads, a choice made on screen beats a late read, per-id debounced writes flushed on close. `panel.ts` — `panelGroups` (rows only for features this player has — omitted, never disabled), value formatting, radio stepping. `SettingsPanel.svelte` — the generated dialog (switch / radio group / range, focus trap, Esc/`,` close, focus handed back). `remembered.ts` (jatui-xz6so) — remembered MEDIA state (E12: volume + mute survive a reload), coerced like settings and persisted through the same store split (`settingsStore`, else guarded localStorage) but deliberately never panel rows: remembering is not configuring. In the component a stored choice overlays its prop but never creates a presence-gated feature; `night`/`nightDepth` are written through their bindings and `N`/the moon wheel are saved back. The one permission ask is `sleep.desktopIdle` turned on, from that click. A knob lands WITH its reader. |
 | `audio.ts` + `audio/` | **.31** (done) | `audio.ts` is the barrel. `rider.ts` — pure: RMS dBFS (silence → null), the 12 dB relative-gated loud estimate (rise 0.08 / forget 0.01), want-gain clamped 0.3–1.35, the asymmetric ride (down 0.15 / up 0.02), limiter constants + `compressorMakeupDb`/`limiterTrim` (DynamicsCompressor's automatic makeup, cancelled by a trim node), `routeSafety` (only blob:/data: or a `crossorigin` load — a same-origin URL may redirect cross-origin and route to SILENCE). `graph.ts` — `createAudioSession`: source → gain → quiet chain → limiter → trim → destination, analyser on the source. Context first, route last: the element is taken only when a feature is on, the source is route-safe and `ctx.state === 'running'` (gestures resume + retry; never navigator.userActivation). After routing it watches: an unsafe src or bit-exact zeros while audibly playing ⇒ `broken` (`unsafe-src` / `silent`) via `onBroken`. A construction throw is a permanent `build-failed` (context closed if the element wasn't taken; kept with source → destination if it was). Level off cancels before it sets; limiter moves are ramped. The element never enters the module — the component passes a `route` closure. |
 | `night.ts` + `night/` | **.33** (done) | `night.ts` is the barrel. `meter.ts` — 32×18 frame bytes → Rec.709 luma + blown share, asymmetric smoothing, bias-light cells from the same bytes. `levels.ts` — luma → brightness/saturation/warmth/vignette off `NIGHT_FLOOR` 0.34, blind fixed level, the light-theme surround. `clock.ts` — local-clock `auto` window + the `N` auto/on/off cycle (no hyprsunset). `track.ts` — prediction (only ever adds dimming), flash intervals, `composeNight` (darker at once, brighter released per tick — never a jump). |

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.0",
+  "version": "0.51.0",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",