@songsid/agend 2.3.3-beta.1 → 2.3.3-beta.10

package/dist/ui/shared/effect-profiler.js

@@ -1,184 +0,0 @@
-/** #1629: host observations only. This pure module mounts nothing and accepts no frame/Worker messages. */
-const finite = v => typeof v === "number" && Number.isFinite(v);
-const plain = v => !!v && (Object.getPrototypeOf(v) === Object.prototype || Object.getPrototypeOf(v) === null);
-const DAY = 86400000;
-export const EFFECT_BUDGETS = Object.freeze({
-  standard: Object.freeze({ fps: 55, longTaskMsPerSecond: 50 }),
-  constrained: Object.freeze({ fps: 50, longTaskMsPerSecond: 25 }),
-});
-const deviceClass = v => v === "standard" || v === "constrained";
-const id = v => typeof v === "string" && /^[0-9a-f]{32}$/.test(v);
-
-/** One host-owned mount. The registry must remove the frame when remove is true, never merely hide it. */
-export class EffectBudget {
-  constructor({ device, baselineFps, clock = () => performance.now(), longTasksSupported = false } = {}) {
-    if (!deviceClass(device) || baselineFps !== undefined && (!finite(baselineFps) || baselineFps <= 0 || baselineFps > 1000) || typeof clock !== "function" || typeof longTasksSupported !== "boolean") throw new TypeError("effect budget options");
-    this.device = device;
-    // Legacy host measurements may still be supplied by pure probes. Product playback starts
-    // immediately and learns cadence concurrently from host rAF, never Worker timing.
-    // Freeze before the first report: a mount's profile floor must remain coherent.
-    this.fpsFloor = baselineFps === undefined ? null : Math.min(EFFECT_BUDGETS[device].fps, baselineFps * 0.9);
-    this.cadence = [];
-    this.cadenceAt = null;
-    this.clock = clock;
-    this.longTasksSupported = longTasksSupported;
-    this.last = null;
-    this.epoch = this.time();
-    this.lastWindow = null;
-    this.frames = [];
-    this.tasks = [];
-    this.overflow = false;
-    this.hiddenAt = null;
-    this.verdict = "ok";
-    this.reason = null;
-    this.badWindows = 0;
-    this.metrics = null;
-    this.loadMs = null;
-    if (this.epoch === null) this.stop("clock_unavailable");
-  }
-  time() {
-    let now;
-    try { now = this.clock(); } catch { return null; }
-    if (!finite(now) || now < 0 || this.last !== null && now < this.last) return null;
-    this.last = now;
-    return now;
-  }
-  stop(reason = "stopped") {
-    if (this.verdict === "paused") return this.snapshot();
-    this.verdict = "paused";
-    this.reason = reason;
-    this.frames = [];
-    this.tasks = [];
-    return this.snapshot();
-  }
-  /** Invoke on host-observed load, not on child-provided timing. First load only. */
-  loaded() {
-    const now = this.time();
-    if (now === null) return this.stop("clock_unavailable");
-    if (this.verdict !== "paused" && this.loadMs === null) this.loadMs = now - this.epoch;
-    return this.snapshot();
-  }
-  /** Invoke from the host's rAF callback; elapsed time always comes from the host clock. */
-  frame() {
-    const now = this.time();
-    if (now === null) return this.stop("clock_unavailable");
-    if (this.verdict === "paused" || this.hiddenAt !== null) return this.snapshot();
-    if (this.fpsFloor === null) {
-      const interval = this.cadenceAt === null ? null : now - this.cadenceAt;
-      this.cadenceAt = now;
-      if (interval !== null && interval >= 1 && interval <= 1000) {
-        if (this.cadence.length === 256) this.cadence.shift();
-        this.cadence.push(interval);
-      }
-    }
-    if (now < this.epoch + 1000) return this.snapshot();
-    this.trim(now);
-    if (this.frames.at(-1) !== now) {
-      if (this.frames.length >= 2048) this.overflow = true;
-      else this.frames.push(now);
-    }
-    return this.snapshot();
-  }
-  /** Only the host observer calls this. `attributed` means it matched THIS host-owned container. */
-  longTask(start, duration, attributed = false) {
-    const now = this.time();
-    if (now === null) return this.stop("clock_unavailable");
-    if (this.verdict === "paused" || this.hiddenAt !== null || !this.longTasksSupported) return false;
-    if (!finite(start) || start < 0 || !finite(duration) || duration < 50 || duration > 60000 || start + duration > now || typeof attributed !== "boolean") return false;
-    const from = Math.max(start, this.epoch + 1000, now - 2000), to = start + duration;
-    if (from >= to) return false;
-    this.trim(now);
-    if (this.tasks.length >= 256) { this.overflow = true; return false; }
-    this.tasks.push({ from, to, attributed });
-    return true;
-  }
-  trim(now) {
-    this.frames = this.frames.filter(t => t > now - 2000);
-    this.tasks = this.tasks.filter(t => t.to > now - 2000);
-  }
-  /** Strict booleans: unknown page gates fail closed. No setting can revive a paused mount. */
-  gates(raw = {}) {
-    const now = this.time();
-    if (now === null) return this.stop("clock_unavailable");
-    if (!plain(raw)) return this.stop("gates_unknown");
-    const { hidden, reducedMotion, show } = raw;
-    if ([hidden, reducedMotion, show].some(v => typeof v !== "boolean")) return this.stop("gates_unknown");
-    if (this.verdict === "paused") return this.snapshot();
-    if (reducedMotion || !show) return this.stop(reducedMotion ? "reduced_motion" : "viewer_off");
-    if (hidden && this.hiddenAt === null) this.hiddenAt = now;
-    if (hidden && now - this.hiddenAt >= 10000) return this.stop("hidden");
-    if (!hidden && this.hiddenAt !== null) {
-      // A delayed visibility callback must not revive a frame whose removal deadline already passed.
-      if (now - this.hiddenAt >= 10000) return this.stop("hidden");
-      this.hiddenAt = null;
-      this.epoch = now;
-      this.lastWindow = null;
-      this.frames = [];
-      this.tasks = [];
-      this.overflow = false;
-      this.badWindows = 0;
-      this.metrics = null;
-      this.cadence = []; this.cadenceAt = null;
-    }
-    return this.snapshot();
-  }
-  /** Poll no faster than once per second; a delayed callback never fabricates missed windows. */
-  poll() {
-    const now = this.time();
-    if (now === null) return this.stop("clock_unavailable");
-    if (this.verdict === "paused") return this.snapshot();
-    if (this.hiddenAt !== null) return now - this.hiddenAt >= 10000 ? this.stop("hidden") : this.snapshot();
-    if (now < this.epoch + 3000 || this.lastWindow !== null && now - this.lastWindow < 1000) return this.snapshot();
-    this.lastWindow = now;
-    this.trim(now);
-    const sum = attributed => this.tasks.filter(t => attributed === null || t.attributed === attributed)
-      .reduce((n, t) => n + Math.max(0, t.to - Math.max(t.from, now - 2000)), 0) / 2;
-    const fps = this.frames.length / 2;
-    const hostMs = this.longTasksSupported ? sum(null) : null;
-    const ownMs = this.longTasksSupported && this.tasks.some(t => t.attributed) ? sum(true) : null;
-    const limits = EFFECT_BUDGETS[this.device];
-    if (this.fpsFloor === null && this.cadence.length >= 3) {
-      // Faster observed intervals distinguish intermittent jank from a genuinely slower
-      // display. This is a live reference, not an empty-page health certification.
-      const sorted = [...this.cadence].sort((a, b) => a - b);
-      const interval = sorted[Math.ceil(sorted.length * (sorted.length < 8 ? 0.5 : 0.2)) - 1];
-      this.fpsFloor = Math.min(limits.fps, 900 / interval);
-      this.cadence = []; this.cadenceAt = null;
-    }
-    const bad = this.overflow || this.fpsFloor === null || fps < this.fpsFloor || hostMs !== null && hostMs > limits.longTaskMsPerSecond;
-    this.metrics = this.fpsFloor === null ? null : { at: now, hostFps: fps, hostLongTaskMsPerSecond: hostMs, attributedLongTaskMsPerSecond: ownMs,
-      attribution: ownMs === null ? "unknown" : "observed", fpsFloor: this.fpsFloor, windowMs: 2000 };
-    this.overflow = false;
-    if (bad) {
-      this.badWindows++;
-      this.verdict = "degraded";
-      this.reason = "host_budget";
-      if (this.badWindows >= 3) return this.stop("host_budget");
-    } else this.badWindows = 0;
-    return this.snapshot();
-  }
-  snapshot() {
-    const remove = this.verdict === "paused";
-    return { verdict: this.verdict, reason: this.reason, remove, forward: !remove && this.hiddenAt === null,
-      quality: this.verdict === "ok" ? "normal" : "low", pointerHz: this.verdict === "ok" ? 60 : 30,
-      badWindows: this.badWindows, loadMs: this.loadMs, metrics: this.metrics ? { ...this.metrics } : null };
-  }
-}
-
-/** Persisted calendar policy is separate from monotonic measurement. No storage is opened by this module. */
-export function newEffectPauseHistory(effectId, device, wall) {
-  if (!id(effectId) || !deviceClass(device) || !finite(wall) || wall < 0) return null;
-  return { v: 1, id: effectId, device, pauses: [], off: false, lastWall: wall };
-}
-export function recordEffectPause(history, wall) {
-  if (!plain(history) || Object.keys(history).sort().join(",") !== "device,id,lastWall,off,pauses,v" || history.v !== 1 || !id(history.id) || !deviceClass(history.device) || typeof history.off !== "boolean" || !finite(history.lastWall) || history.lastWall < 0 || !finite(wall) || wall < 0 || !Array.isArray(history.pauses) || history.pauses.length > 3) return { ok: false, error: "pause_history_unknown" };
-  let previous = -1;
-  for (const at of history.pauses) {
-    if (!finite(at) || at < 0 || at < previous || at > history.lastWall) return { ok: false, error: "pause_history_unknown" };
-    previous = at;
-  }
-  // A wall-clock rollback cannot age out pauses. A forward jump can; off remains sticky for this content id.
-  const now = Math.max(wall, history.lastWall);
-  const pauses = [...history.pauses.filter(t => t > now - DAY), now].slice(-3);
-  return { ok: true, history: { ...history, pauses, lastWall: now, off: history.off || pauses.length >= 3 } };
-}

package/dist/ui/shared/effect-profiles.js

@@ -1,65 +0,0 @@
-/** #1629: bounded host-window quantiles; not a frame message handler or admission verdict. */
-const plain = o => !!o && (Object.getPrototypeOf(o) === Object.prototype || Object.getPrototypeOf(o) === null);
-const finite = x => typeof x === "number" && Number.isFinite(x);
-const bounded = (x, max) => finite(x) && x >= 0 && x <= max;
-const reasons = [null, "host_budget", "clock_unavailable", "gates_unknown", "hidden", "reduced_motion", "save_data", "viewer_off"];
-const keys = ["key", "id", "device", "verdict", "reason", "remove", "forward", "quality", "pointerHz", "badWindows", "loadMs", "metrics"];
-const metricKeys = ["at", "hostFps", "hostLongTaskMsPerSecond", "attributedLongTaskMsPerSecond", "attribution", "fpsFloor", "windowMs"];
-const exact = (o, allowed) => plain(o) && Object.keys(o).sort().join(",") === [...allowed].sort().join(",");
-const quantile = (values, q) => { if (!values.length) return null; const a = [...values].sort((x, y) => x - y); return a[Math.max(0, Math.ceil(q * a.length) - 1)]; };
-
-/** A new collector belongs to one exact registry key/id/class mount. It never reads message content or child data. */
-export function createEffectProfileCollector(options = {}) {
-  let key, id, device, clock;
-  try { if (!exact(options, ["key", "id", "device", "clock"])) return { ok: false }; ({ key, id, device, clock } = options); } catch { return { ok: false }; }
-  if (typeof key !== "string" || key.length < 1 || key.length > 256 || typeof id !== "string" || !/^[a-f0-9]{32}$/.test(id) || !["standard", "constrained"].includes(device) || typeof clock !== "function") return { ok: false };
-  let dead = false, previous = null, lastSample = null, floor = null, last = null;
-  const samples = [];
-  const time = () => {
-    let n; try { n = clock(); } catch { dead = true; return null; }
-    if (!finite(n) || n < 0 || previous !== null && n < previous) { dead = true; return null; }
-    previous = n; return n;
-  };
-  if (time() === null) return { ok: false };
-  return { ok: true,
-    add(raw) {
-      if (dead) return false;
-      try {
-        // Reject unknown keys without reading their values or accessors.
-        if (!exact(raw, keys) || raw.key !== key || raw.id !== id || raw.device !== device || !["ok", "degraded", "paused"].includes(raw.verdict) || !reasons.includes(raw.reason)
-          || typeof raw.remove !== "boolean" || typeof raw.forward !== "boolean" || raw.remove !== (raw.verdict === "paused") || raw.remove && raw.forward
-          || raw.quality !== (raw.verdict === "ok" ? "normal" : "low") || raw.pointerHz !== (raw.verdict === "ok" ? 60 : 30)
-          || !Number.isInteger(raw.badWindows) || raw.badWindows < 0 || raw.badWindows > 3 || raw.loadMs !== null && !bounded(raw.loadMs, 600000)) { dead = true; return false; }
-        const n = time(); if (n === null) return false;
-        // Warmup is not an observed window and never turns missing measurements into zero cost.
-        if (raw.metrics === null) return false;
-        const m = raw.metrics;
-        if (!exact(m, metricKeys) || !finite(m.at) || m.at < 0 || m.at > n || !bounded(m.hostFps, 1000) || !finite(m.fpsFloor) || m.fpsFloor <= 0 || m.fpsFloor > 1000 || m.windowMs !== 2000
-          || m.hostLongTaskMsPerSecond !== null && !bounded(m.hostLongTaskMsPerSecond, 256000)
-          || m.attributedLongTaskMsPerSecond !== null && (!bounded(m.attributedLongTaskMsPerSecond, 256000) || m.hostLongTaskMsPerSecond === null || m.attributedLongTaskMsPerSecond > m.hostLongTaskMsPerSecond)
-          || m.attribution !== (m.attributedLongTaskMsPerSecond === null ? "unknown" : "observed") || floor !== null && m.fpsFloor !== floor) { dead = true; return false; }
-        // Only poll() creates a window. rAF/gates/load/stop snapshots retain its immutable host timestamp.
-        // A paused duplicate may describe the last verdict, but cannot renew the observation or add a sample.
-        if (lastSample !== null && m.at === lastSample && last) last = { verdict: raw.verdict, reason: raw.reason, loadMs: raw.loadMs };
-        if (n - m.at > 5000 || lastSample !== null && m.at - lastSample < 1000) return false;
-        floor = m.fpsFloor; lastSample = m.at;
-        samples.push({ fps: m.hostFps, task: m.hostLongTaskMsPerSecond, own: m.attributedLongTaskMsPerSecond });
-        if (samples.length > 120) samples.shift();
-        last = { verdict: raw.verdict, reason: raw.reason, loadMs: raw.loadMs };
-        return true;
-      } catch { dead = true; return false; }
-    },
-    report(options = {}) {
-      let off;
-      try { if (!plain(options) || Object.keys(options).some(k => k !== "off")) return null; off = options.off ?? false; } catch { dead = true; return null; }
-      if (dead || typeof off !== "boolean" || lastSample === null || !last) return null;
-      const n = time(); if (n === null || n - lastSample > 5000) return null;
-      const host = samples.filter(s => s.task !== null).map(s => s.task), own = samples.filter(s => s.own !== null).map(s => s.own), fps = samples.map(s => s.fps);
-      return { id, profile: { v: 1, device, verdict: off ? "off" : last.verdict, reason: last.reason, samples: samples.length,
-        fps_p50: quantile(fps, 0.5), fps_p10: quantile(fps, 0.1), fps_floor: floor,
-        long_task_p95: quantile(host, 0.95), long_task_samples: host.length,
-        attributed_long_task_p95: quantile(own, 0.95), attributed_samples: own.length, attribution: own.length ? "observed" : "unknown", load_ms: last.loadMs } };
-    },
-    dispose() { dead = true; samples.length = 0; last = null; },
-  };
-}