@joewinke/jatui 0.13.0 → 0.15.0

package/dist/video/rate.d.ts

@@ -1,69 +1,26 @@
 /**
- * Playback-rate arbitration for VideoPlayer (mos-5lzns.28 internal split).
+ * Rate module (mos-5lzns.32) — the rate composer and its advisors: smart
+ * speed, per-speaker pace, skip ad reads. Ported from extension-library
+ * FEATURES.md §The rate composer.
  *
- * THE RATE COMPOSER CONTRACT (extension-library FEATURES.md — "The rate
- * composer") — this is the one non-obvious rule, stated up front because it
- * looks like a bug from the outside:
+ *   rate = base × speaker × silence        (clamp [0.0625, 16], 0.001 deadband)
  *
- * Three features want `playbackRate`, and NONE of them writes it:
- *   · you        — the speed keys (−/=/Backspace, alt+wheel)
- *   · speaker    — "this person talks fast"        (mos-5lzns.32 fills)
- *   · silence    — "nothing is being said here"    (mos-5lzns.32 fills)
+ * `base` is the only factor a human chose and the only one the UI reports.
  *
- * They contribute to a product:  rate = base × speaker × silence
+ * Layout (every file pure and node-testable — `npm run test:unit`):
  *
- * `base` is the only one a human chose, and therefore the only one the UI
- * reports. The speed readout must keep saying `1×` while a gap is being taken
- * at 2.2×, or the label becomes a strobe.
- *
- *   1. Both advisors collapse to `1` the moment their setting is off or their
- *      data has not arrived — `1` is the multiplicative identity, so the
- *      composer runs identically on a video with no transcript, no waveform
- *      and no speakers. There is no "feature absent" branch anywhere.
- *   2. `base === 0` is a state, not a level (the frozen-frame end of the
- *      staircase) — it returns early, before any multiplication, because no
- *      advisor gets to un-pause the video by multiplying its way out of zero.
- *   3. Only real changes are written. `playbackRate` is a live audio
- *      parameter: writing a *slightly* different value is audible as a wobble.
- *      Hence the 0.001 deadband.
- *   4. The clamp is [0.0625, 16] — the range HTML media elements actually
- *      support. A product of three multipliers can leave it; a single one
- *      cannot.
- *
- * The SPEED_STEPS staircase and formatSpeedLabel are ported from the
- * extension's theater (linear 0.1 steps below 1×, all the way down to 0 —
- * playbackRate=0 is a genuine frozen frame; above 1× the familiar jumps).
- */
-/** The speed staircase — one step per press of −/=, Backspace resets to 1. */
-export declare const SPEED_STEPS: number[];
-/**
- * "A quarter speed" reads faster as "−.75" than "0.25×" — below 1× the label
- * is the delta, not the multiplier. The 0 step is the frozen-frame end of the
- * staircase — a state, not a level — and the label says so ("0×"), because a
- * frozen frame labeled "1×" lies. Garbage degrades to `1×`.
- */
-export declare function formatSpeedLabel(rate: number): string;
-/**
- * One step along the staircase. Unknown current rate snaps to 1 first (a
- * hand-set rate off the staircase still steps from where the user expects).
- */
-export declare function stepRate(current: number, direction: 1 | -1): number;
-/** The clamp the composer applies — the range HTML media elements actually support. */
-export declare const RATE_MIN = 0.0625;
-export declare const RATE_MAX = 16;
-/** Writes only on real change — a slightly-different write is audible as a wobble. */
-export declare const RATE_DEADBAND = 0.001;
-export interface ComposedRate {
-    rate: number;
-    /** False when the deadband swallowed the write (keep the previous rate). */
-    changed: boolean;
-}
-/**
- * The whole arbitration. `speaker` and `silence` are advisor products in
- * [0.0625, 16] that COLLAPSE TO 1 when their feature is off or its data has
- * not arrived — mos-5lzns.32 fills both; until then they are always 1 and
- * this is exactly `base`.
- *
- * `base === 0` returns early: a frozen frame is a state, not a level.
+ * · rate/compose.ts — the contract: SPEED_STEPS staircase, formatSpeedLabel,
+ *   composeRate (base 0 is a state, advisors collapse to 1, clamp), and
+ *   shouldWriteRate (deadband, except an exact return to base).
+ * · rate/speaker.ts — props → advisors/speaker-rate; manual rates keyed by
+ *   NAME always beat measured ones.
+ * · rate/silence.ts — waveform → advisors/smart-speed map + boost factor.
+ * · rate/ads.ts     — adSpans ∪ `ad: true` turns; skip only when PLAYBACK
+ *   runs into an ad, never when a seek lands in one.
+ * · rate/tick.ts    — the 120ms loop's one-tick decision.
  */
-export declare function composeRate(base: number, speaker: number, silence: number): ComposedRate;
+export * from './rate/compose';
+export * from './rate/speaker';
+export * from './rate/silence';
+export * from './rate/ads';
+export * from './rate/tick';

package/dist/video/rate.js

@@ -1,88 +1,26 @@
 /**
- * Playback-rate arbitration for VideoPlayer (mos-5lzns.28 internal split).
+ * Rate module (mos-5lzns.32) — the rate composer and its advisors: smart
+ * speed, per-speaker pace, skip ad reads. Ported from extension-library
+ * FEATURES.md §The rate composer.
  *
- * THE RATE COMPOSER CONTRACT (extension-library FEATURES.md — "The rate
- * composer") — this is the one non-obvious rule, stated up front because it
- * looks like a bug from the outside:
+ *   rate = base × speaker × silence        (clamp [0.0625, 16], 0.001 deadband)
  *
- * Three features want `playbackRate`, and NONE of them writes it:
- *   · you        — the speed keys (−/=/Backspace, alt+wheel)
- *   · speaker    — "this person talks fast"        (mos-5lzns.32 fills)
- *   · silence    — "nothing is being said here"    (mos-5lzns.32 fills)
+ * `base` is the only factor a human chose and the only one the UI reports.
  *
- * They contribute to a product:  rate = base × speaker × silence
+ * Layout (every file pure and node-testable — `npm run test:unit`):
  *
- * `base` is the only one a human chose, and therefore the only one the UI
- * reports. The speed readout must keep saying `1×` while a gap is being taken
- * at 2.2×, or the label becomes a strobe.
- *
- *   1. Both advisors collapse to `1` the moment their setting is off or their
- *      data has not arrived — `1` is the multiplicative identity, so the
- *      composer runs identically on a video with no transcript, no waveform
- *      and no speakers. There is no "feature absent" branch anywhere.
- *   2. `base === 0` is a state, not a level (the frozen-frame end of the
- *      staircase) — it returns early, before any multiplication, because no
- *      advisor gets to un-pause the video by multiplying its way out of zero.
- *   3. Only real changes are written. `playbackRate` is a live audio
- *      parameter: writing a *slightly* different value is audible as a wobble.
- *      Hence the 0.001 deadband.
- *   4. The clamp is [0.0625, 16] — the range HTML media elements actually
- *      support. A product of three multipliers can leave it; a single one
- *      cannot.
- *
- * The SPEED_STEPS staircase and formatSpeedLabel are ported from the
- * extension's theater (linear 0.1 steps below 1×, all the way down to 0 —
- * playbackRate=0 is a genuine frozen frame; above 1× the familiar jumps).
- */
-/** The speed staircase — one step per press of −/=, Backspace resets to 1. */
-export const SPEED_STEPS = [
-    0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1, 1.1, 1.2, 1.3, 1.4, 1.5, 1.75, 2, 2.5, 5, 10
-];
-/**
- * "A quarter speed" reads faster as "−.75" than "0.25×" — below 1× the label
- * is the delta, not the multiplier. The 0 step is the frozen-frame end of the
- * staircase — a state, not a level — and the label says so ("0×"), because a
- * frozen frame labeled "1×" lies. Garbage degrades to `1×`.
- */
-export function formatSpeedLabel(rate) {
-    if (!Number.isFinite(rate) || rate < 0)
-        return '1×';
-    if (rate === 0)
-        return '0×';
-    if (rate < 1) {
-        return (rate - 1).toFixed(2).replace(/\.?0+$/, '').replace(/^-0\./, '-.') + '×';
-    }
-    return rate.toFixed(2).replace(/\.?0+$/, '') + '×';
-}
-/**
- * One step along the staircase. Unknown current rate snaps to 1 first (a
- * hand-set rate off the staircase still steps from where the user expects).
- */
-export function stepRate(current, direction) {
-    const i = SPEED_STEPS.indexOf(current);
-    const cur = i === -1 ? SPEED_STEPS.indexOf(1) : i;
-    return SPEED_STEPS[Math.min(SPEED_STEPS.length - 1, Math.max(0, cur + direction))];
-}
-/** The clamp the composer applies — the range HTML media elements actually support. */
-export const RATE_MIN = 0.0625;
-export const RATE_MAX = 16;
-/** Writes only on real change — a slightly-different write is audible as a wobble. */
-export const RATE_DEADBAND = 0.001;
-/**
- * The whole arbitration. `speaker` and `silence` are advisor products in
- * [0.0625, 16] that COLLAPSE TO 1 when their feature is off or its data has
- * not arrived — mos-5lzns.32 fills both; until then they are always 1 and
- * this is exactly `base`.
- *
- * `base === 0` returns early: a frozen frame is a state, not a level.
+ * · rate/compose.ts — the contract: SPEED_STEPS staircase, formatSpeedLabel,
+ *   composeRate (base 0 is a state, advisors collapse to 1, clamp), and
+ *   shouldWriteRate (deadband, except an exact return to base).
+ * · rate/speaker.ts — props → advisors/speaker-rate; manual rates keyed by
+ *   NAME always beat measured ones.
+ * · rate/silence.ts — waveform → advisors/smart-speed map + boost factor.
+ * · rate/ads.ts     — adSpans ∪ `ad: true` turns; skip only when PLAYBACK
+ *   runs into an ad, never when a seek lands in one.
+ * · rate/tick.ts    — the 120ms loop's one-tick decision.
  */
-export function composeRate(base, speaker, silence) {
-    if (!Number.isFinite(base) || base <= 0) {
-        return { rate: Math.max(0, Number.isFinite(base) ? base : 0), changed: false };
-    }
-    const sp = Number.isFinite(speaker) && speaker > 0 ? speaker : 1;
-    const si = Number.isFinite(silence) && silence > 0 ? silence : 1;
-    const rate = Math.min(RATE_MAX, Math.max(RATE_MIN, base * sp * si));
-    const changed = Math.abs(rate - base) > RATE_DEADBAND;
-    return { rate: changed ? rate : base, changed };
-}
+export * from './rate/compose';
+export * from './rate/speaker';
+export * from './rate/silence';
+export * from './rate/ads';
+export * from './rate/tick';

package/dist/video/settings.js

@@ -40,7 +40,14 @@ export const VIDEO_SETTINGS = [
     { id: 'audio.target', type: 'range', default: -20, min: -30, max: -12, step: 2, owner: 'mos-5lzns.31', wired: true },
     { id: 'audio.quiet', type: 'bool', default: true, owner: 'mos-5lzns.31', wired: true },
     { id: 'audio.limiter', type: 'bool', default: true, owner: 'mos-5lzns.31', wired: true },
-    // { id: 'player.speakerRate', type: 'bool', default: false, owner: 'mos-5lzns.32' },
+    // Read by VideoPlayer's `smartSpeed` / `speakerPace` (+ `speakerRates`) /
+    // `skipAds` (+ `adSpans`) props → video/rate/* (silenceMapFor + silenceFactor,
+    // speakerRateMap + speakerFactor, normalizeAdSpans + adSkipTarget), composed
+    // by rate/compose.ts composeRate. All default off: an automatic rate change
+    // is the host's opt-in.
+    { id: 'player.smartSpeed', type: 'bool', default: false, owner: 'mos-5lzns.32', wired: true },
+    { id: 'player.speakerRate', type: 'bool', default: false, owner: 'mos-5lzns.32', wired: true },
+    { id: 'player.skipAds', type: 'bool', default: false, owner: 'mos-5lzns.32', wired: true },
     // Read by VideoPlayer's `night` / `nightDepth` / `biasLight` / `predictive` /
     // `strobeGuard` props → video/night/* (clock.nightArmed, levels.nightLevels,
     // meter.biasCells, track.lumaAhead / inFlash / composeNight). Unlike the
@@ -51,7 +58,23 @@ export const VIDEO_SETTINGS = [
     { id: 'night.bias', type: 'bool', default: true, owner: 'mos-5lzns.33', wired: true },
     { id: 'player.predictive', type: 'bool', default: true, owner: 'mos-5lzns.33', wired: true },
     { id: 'player.strobeGuard', type: 'bool', default: true, owner: 'mos-5lzns.33', wired: true },
-    // { id: 'sleep.enabled', type: 'bool', default: true, owner: 'mos-5lzns.34' },
+    // Read by VideoPlayer's `windDown` / `windDownAfter` / `windDownNightOnly` /
+    // `idleDetection` props → video/presence/winddown.ts (shouldBeginWindDown,
+    // windDownAfterMs) + presence/idle.ts (startDesktopWatch). As with night,
+    // the DEFAULT is the host's opt-in: an absent `windDown` prop means the
+    // feature does not exist on that player. `sleep.desktopIdle` defaults OFF
+    // because turning it on is what asks the browser for a permission — the
+    // host calls `requestIdleDetection()` from the click that turns it on.
+    { id: 'sleep.enabled', type: 'bool', default: true, owner: 'mos-5lzns.34', wired: true },
+    { id: 'sleep.after', type: 'range', default: 30, min: 10, max: 90, step: 5, owner: 'mos-5lzns.34', wired: true },
+    { id: 'sleep.nightOnly', type: 'bool', default: true, owner: 'mos-5lzns.34', wired: true },
+    { id: 'sleep.desktopIdle', type: 'bool', default: false, owner: 'mos-5lzns.34', wired: true },
+    // Read by VideoPlayer's `resumeSnap` prop (with `resumeKey` present) →
+    // video/presence/resume.ts planResumeSnap → advisors/resume-point snapResume.
+    { id: 'player.resumeSnap', type: 'bool', default: true, owner: 'mos-5lzns.34', wired: true },
+    // Read by VideoPlayer's `openMotion` prop (with `openFrom` present) →
+    // video/presence/flip.ts flipOpen. Off ⇒ the poster still paints.
+    { id: 'player.openMotion', type: 'bool', default: true, owner: 'mos-5lzns.34', wired: true },
 ];
 /** Coerce a raw stored value against a spec — never throws, never returns junk. */
 export function coerce(spec, raw) {

package/package.json

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