@joewinke/jatui 0.14.0 → 0.15.0

package/dist/video/presence.js

@@ -1,25 +1,29 @@
 /**
- * Presence module — CONTRACT ONLY (mos-5lzns.28). Implemented by mos-5lzns.34
- * ("wind-down (Idle Detection API), resume-at-sentence, FLIP open").
+ * Presence (mos-5lzns.34) — the barrel. Three behaviours about whether you
+ * are there and where you were, each an OPTIONAL VideoPlayer prop that is
+ * inert when absent (extension-library FEATURES.md §Wind-down, §Resume at a
+ * sentence, §Open like an object):
  *
- * What lands here (extension-library FEATURES.md §Wind-down,
- * §Resume at a sentence, §Open like an object), as ADVISORS + pure helpers:
+ * · `presence/winddown.ts` — pure: the begin decision, fade levels, hint.
+ *   The desktop says nobody is there → picture and sound fade over 20s and
+ *   the video pauses. The fade IS the prompt; any input cancels it.
+ * · `presence/idle.ts` — the desktop signal: Chromium's Idle Detection API,
+ *   feature-detected, never prompting unless the host opted in (and then
+ *   only from a gesture). Elsewhere the player falls back to page presence,
+ *   reported as `source: 'page'` so the host can label it.
+ * · `presence/resume.ts` — resume-at-sentence glue around .27's
+ *   `advisors/resume-point` (the snapping is NOT duplicated here): the
+ *   host-supplied store (localStorage default), the data mapping, and the
+ *   two integration rules — snap when the boundaries land, stand down once
+ *   the user has taken the wheel.
+ * · `presence/flip.ts` — FLIP open/close over WAAPI with the poster painted
+ *   on every path; a no-op under prefers-reduced-motion except the poster.
  *
- * · wind-down — the desktop says nobody is there (Idle Detection API / user
- *   activity), the player fades picture and sound over ~20s and pauses. The
- *   fade IS the prompt — cancelling it is how you come back.
- * · resume-at-sentence — snap a resume point back to the nearest sentence /
- *   speaker turn / chapter within 15s (CLOSEST wins, not most-specific);
- *   quote the line, never paraphrase; stand down if the user has taken the
- *   wheel (>2.5s from the stored point). Runs when the transcript lands, not
- *   at open.
- * · FLIP open — the clicked card's rectangle → the player shell, WAAPI, two
- *   keyframes, transform-origin top-left, poster painted under the video on
- *   EVERY path (a black rectangle is a bug at any motion setting); no-op
- *   under prefers-reduced-motion except the poster.
- *
- * All three are advisors/mechanics: they read no settings, touch no
- * <video> outside the callbacks the component passes, and fail toward doing
- * nothing.
+ * Advisors and mechanics: they read no settings and touch no <video>; the
+ * component passes knobs in and applies what comes back, and every one of
+ * them fails toward doing nothing.
  */
-export const PRESENCE_NEUTRAL = 1;
+export { WIND_DOWN_FADE_MS, WIND_DOWN_DEPTH, WIND_DOWN_AFTER_DEFAULT, WIND_DOWN_AFTER_MIN, WIND_DOWN_AFTER_MAX, WIND_DOWN_PROBE_MS, windDownAfterMs, shouldBeginWindDown, desktopPresent, windDownProgress, windDownLevels, windDownHint } from './presence/winddown';
+export { IDLE_THRESHOLD_MIN_MS, idleDetectionSupported, idleDetectionPermission, requestIdleDetection, startDesktopWatch, toDesktopSignal } from './presence/idle';
+export { RESUME_WHEEL_SEC, RESUME_MAX_BACK, RESUME_SAVE_MS, RESUME_FLOOR_SEC, RESUME_TAIL_SEC, localResumeStore, coerceResumeSec, resumeToSave, toResumeCtx, hasBoundaries, planResumeSnap } from './presence/resume';
+export { FLIP_EASE, FLIP_OPEN_MS, FLIP_CLOSE_MS, FLIP_FADE_WITH_POSTER, FLIP_FADE_BARE, FLIP_POSTER_CLASS, flipOpen, flipClose, clearPoster, posterBackground, rectOf, onScreen, flipGeometry, awayFrame, homeFrame } from './presence/flip';

package/dist/video/settings.js

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