@joewinke/jatui 0.11.0 → 0.13.0

package/dist/video/night.js

@@ -1,26 +1,31 @@
 /**
- * Night module — CONTRACT ONLY (mos-5lzns.28). Implemented by mos-5lzns.33
- * ("night dimming, bias light, predictive dimming, strobe guard").
+ * Night module (mos-5lzns.33) — night dimming, bias light, predictive
+ * dimming (the luma track), strobe guard. Ported from extension-library
+ * FEATURES.md §Night dimming, §Bias light, §The light track.
  *
- * What lands here (extension-library FEATURES.md §Night dimming, §Bias light,
- * §The light track), as ADVISORS + paint helpers:
+ * Layout (every file pure and node-testable — `npm run test:unit`):
  *
- * · night dimming — every ~900ms while playing, sample the frame's actual
- *   brightness (downscaled canvas read), drive filter: brightness() toward
- *   `1 − 0.5·depth·excess`. Attack fast, release slow, so a dark cut inside a
- *   bright video doesn't flash. `N` cycles auto/on/off — add its row to
- *   keys.ts PLAYER_KEYS when the reader lands, not before.
- * · bias light — the frame's own colours, blurred, behind the player
- *   (radial-gradient cells at z-index −1).
- * · predictive dimming — the pre-scanned luma track read ~1s ahead so
- *   dimming starts BEFORE a bright cut; the light ribbon rides the same
- *   track on whichever axis owns scrubbing (mos-5lzns.30's one-axis).
- * · strobe guard — hold the level down across detected flash intervals.
+ * · night/meter.ts  — 32×18 frame bytes → Rec.709 luma (+ blown-out share),
+ *   asymmetric smoothing (attack 0.5, release 0.12), and the 3×3 bias-light
+ *   cells read from the SAME bytes.
+ * · night/levels.ts — luma → brightness / saturation / warmth / vignette off
+ *   NIGHT_FLOOR 0.34; the blind fixed level; the surround level that re-tunes
+ *   night for LIGHT themes.
+ * · night/clock.ts  — what arms it: local clock (prefers-color-scheme dark only
+ *   widens the window) + the manual auto/on/off cycle (`N`). No hyprsunset.
+ * · night/track.ts  — prediction (can only ADD dimming), flash intervals, and
+ *   `composeNight`, the one-tick decision: darker lands at once, brighter is
+ *   released per tick, so nothing ever brightens in a jump.
  *
- * The measuring code is an advisor: it reads no settings, touches no
- * <video>, and returns safe neutral values on garbage input (CORS-tainted
- * canvas ⇒ escalate to the caller, never silently guess brightness). The
- * component decides and applies. Respect prefers-reduced-motion where it
- * applies: the correction is the feature, the ramp is only how it arrives.
+ * The advisor rule (README): nothing here reads a setting, touches the
+ * <video>, or draws. The component samples the frame (crossorigin="anonymous"
+ * is the host's call), escalates a tainted canvas via `onNightBlind`, and
+ * applies the numbers as CSS variables that exist only while night acts — off
+ * leaves no trace. prefers-reduced-motion drops the ramps, never the
+ * correction: the dimming is the feature, the ramp is only how it arrives.
  */
 export const NIGHT_NEUTRAL = 1;
+export * from './night/meter';
+export * from './night/levels';
+export * from './night/clock';
+export * from './night/track';

package/dist/video/settings.js

@@ -32,9 +32,25 @@
 export const VIDEO_SETTINGS = [
     // Read by VideoPlayer's `oneAxis` prop → video/band/axis.ts resolveAxis().
     { id: 'player.oneAxis', type: 'bool', default: true, owner: 'mos-5lzns.30', wired: true },
-    // { id: 'audio.level', type: 'bool', default: true, owner: 'mos-5lzns.31' },
+    // Read by VideoPlayer's `loudness` / `loudnessTarget` / `quietListening` /
+    // `limiter` props → video/audio/* (graph.createAudioSession, rider.*). As with
+    // night, the DEFAULT is the host's opt-in: an absent prop means nothing is
+    // ever routed through WebAudio on that player.
+    { id: 'audio.level', type: 'bool', default: true, owner: 'mos-5lzns.31', wired: true },
+    { 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' },
-    // { id: 'night.mode', type: 'enum', default: 'auto', options: ['auto','on','off'], owner: 'mos-5lzns.33' },
+    // Read by VideoPlayer's `night` / `nightDepth` / `biasLight` / `predictive` /
+    // `strobeGuard` props → video/night/* (clock.nightArmed, levels.nightLevels,
+    // meter.biasCells, track.lumaAhead / inFlash / composeNight). Unlike the
+    // extension, night.mode's DEFAULT here is the host's opt-in: an absent `night`
+    // prop means the feature does not exist on that player.
+    { id: 'night.mode', type: 'enum', default: 'auto', options: ['auto', 'on', 'off'], owner: 'mos-5lzns.33', wired: true },
+    { id: 'night.depth', type: 'range', default: 0.7, min: 0.2, max: 1, step: 0.1, owner: 'mos-5lzns.33', wired: true },
+    { 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' },
 ];
 /** Coerce a raw stored value against a spec — never throws, never returns junk. */

package/package.json

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