@idle-screens/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shawn Partridge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @idle-screens/core
+
+Engine, `<idle-screen>` custom element, plugin registry, seeded RNG, control-track, and types for idle-screens.
+
+See the [idle-screens repository](https://github.com/shaaaaawn/idle-screens) for full documentation.

package/dist/index.d.ts

@@ -0,0 +1,320 @@
+import { ReadonlySignal } from '@preact/signals-core';
+export { ReadonlySignal, Signal, batch, computed, effect, signal, untracked } from '@preact/signals-core';
+
+/**
+ * A tiny, fast, seedable PRNG (splitmix32). Deterministic: the same seed always
+ * yields the same sequence, on any machine. This is what makes "same program +
+ * seed + control-track = identical frames" hold. Savers take an `Rng` from their
+ * `SaverContext` instead of calling `Math.random()`.
+ */
+interface Rng {
+    /** Next float in [0, 1). */
+    next(): number;
+    /** Float in [min, max). */
+    range(min: number, max: number): number;
+    /** Integer in [min, max] inclusive. */
+    int(min: number, max: number): number;
+    /** Random element of a non-empty array. */
+    pick<T>(arr: readonly T[]): T;
+    /** A fresh independent stream (e.g. per subsystem), derived from this seed. */
+    fork(salt: number): Rng;
+}
+declare function createRng(seed: number): Rng;
+
+/** How a parameter interpolates between control-track deltas. */
+type Ease = 'step' | 'linear' | 'smooth';
+type ParamType = 'number' | 'color' | 'bool' | 'enum';
+type ParamValue = number | string | boolean;
+/** One typed, ranged, interpolatable knob: an agent's steering surface. */
+interface ParamDef {
+    type: ParamType;
+    default: ParamValue;
+    min?: number;
+    max?: number;
+    options?: string[];
+    /** Default interpolation when a delta targets this knob. */
+    ease?: Ease;
+}
+type ParamSpace = Record<string, ParamDef>;
+/** A sparse, timestamped, interpolatable parameter change. Agents stream THESE
+ *  (over AG-UI state-patches / MCP resource updates), never frames. */
+interface ParamDelta {
+    /** ms from track start. */
+    t: number;
+    /** key in the saver's paramSpace. */
+    path: string;
+    value: ParamValue;
+    ease?: Ease;
+    /** ramp duration ms from the previous value (0 = instant). */
+    dur?: number;
+}
+/** A recorded or live steering performance for a seeded program. */
+interface ControlTrack {
+    program: string;
+    seed: number;
+    duration?: number;
+    loop?: boolean;
+    deltas: ParamDelta[];
+}
+/** Page-context seam: passthrough savers read/eat the live page through this,
+ *  rather than querying `document` directly. */
+interface PageContext {
+    /** Sample dominant colors of the page (for palette-reactive savers). */
+    palette(): string[];
+    /** Visible page blocks a passthrough saver may transform ("victims"). */
+    victims(selector: string): HTMLElement[];
+}
+/** What the host hands a saver when it mounts. */
+interface SaverContext {
+    /** A full-viewport container the saver renders into. Canvas savers create a
+     *  canvas inside it; DOM savers (toasters, DVD, messages) append elements. The
+     *  host is cleared by the runtime on dispose. */
+    host: HTMLElement;
+    width: number;
+    height: number;
+    /** Seeded PRNG. Use this, never Math.random(), for determinism. */
+    rng: Rng;
+    seed: number;
+    reducedMotion: boolean;
+    /** Present for passthrough savers (over the live page). */
+    page?: PageContext;
+}
+/** A mounted, running saver visual. */
+interface SaverInstance {
+    /** Freeze/unfreeze the render loop (paused, reduced-motion, or screensaver end). */
+    setPaused(paused: boolean): void;
+    resize(width: number, height: number): void;
+    /** Deterministic, frame-addressable render: draw the state at logical time `t`
+     *  (ms) for `seed`. Pure w.r.t. (program, seed, applied track, t). Optional. */
+    renderFrame?(t: number, seed: number): void;
+    /** Steer parameters over time. Optional. */
+    applyTrack?(track: ControlTrack): void;
+    /** Tear down; MUST restore any live-page mutations. */
+    dispose(): void;
+}
+/** Self-describing metadata, readable WITHOUT executing the saver. */
+interface SaverManifest {
+    id: string;
+    label: string;
+    passthrough?: boolean;
+    minBackend?: 'css' | 'canvas2d' | 'webgl2' | 'webgpu';
+    costTier?: 'idle' | 'low' | 'medium' | 'high';
+    motionIntensity?: 'calm' | 'moderate' | 'energetic';
+    reducedMotionFallback?: 'static' | 'slow' | 'hide';
+    palette?: string[];
+    paramSpace?: ParamSpace;
+    a11y?: {
+        flashSafe?: boolean;
+        notes?: string;
+    };
+    provenance?: {
+        prompt?: string;
+        seed?: number;
+        model?: string;
+    };
+    thumbnail?: string;
+}
+/** A registered saver: manifest + a (possibly lazy/async) mount factory. */
+interface SaverPlugin {
+    manifest: SaverManifest;
+    mount(ctx: SaverContext): SaverInstance | Promise<SaverInstance>;
+}
+/** Engine configuration. */
+interface IdleScreensConfig {
+    /** Idle time before sleeping, in ms. */
+    timeoutMs: number;
+    /** Also sleep when the window loses focus. */
+    sleepOnBlur: boolean;
+    /** Do not run on localhost (debug hooks bypass this). */
+    disableOnLocalhost: boolean;
+    /** Which registered saver to show. */
+    defaultPluginId: string;
+    /** How to pick across sleeps. */
+    selection: 'fixed' | 'random' | 'rotate';
+    /** Show the clock chrome (non-passthrough savers only). */
+    showClock: boolean;
+    /** Exact document title while asleep. */
+    sleepTitle?: string;
+    /** Master seed for plugin selection + the default saver seed. */
+    seed: number;
+    /** Return true for a URL where the saver must never sleep. */
+    suppress?: (url: string) => boolean;
+    /** Pluggable persistence (defaults to localStorage when available). */
+    storage?: {
+        get(key: string): string | null;
+        set(key: string, value: string): void;
+    };
+    /** Built-in, keyboard-opened config menu (saver picker). `true`/omitted =
+     *  enabled with ⌘K / Ctrl+K; `false` = no hotkey and no built-in menu (the
+     *  `configMenuOpen` signal + open/close API still work, so a host may render
+     *  its own). Pass an object to reconfigure. */
+    configMenu?: boolean | ConfigMenuConfig;
+}
+/** Options for the built-in, keyboard-opened config menu. */
+interface ConfigMenuConfig {
+    /** Master switch. Default true. */
+    enabled?: boolean;
+    /** Decides whether a keydown opens/toggles the menu. Default: ⌘K / Ctrl+K. */
+    hotkey?: (e: KeyboardEvent) => boolean;
+    /** Show the saver picker control. Default true. */
+    showPicker?: boolean;
+    /** Preview the picked saver immediately (sleep to show it). Default true. */
+    previewOnPick?: boolean;
+    /** Heading text. Default 'Screen Saver'. */
+    title?: string;
+}
+/** Default menu hotkey: ⌘K (mac) / Ctrl+K, no other modifiers. */
+declare const DEFAULT_MENU_HOTKEY: (e: KeyboardEvent) => boolean;
+/** Normalize `configMenu` to a filled config, or null when disabled. */
+declare function resolveConfigMenu(c: boolean | ConfigMenuConfig | undefined): Required<ConfigMenuConfig> | null;
+declare const DEFAULT_CONFIG: IdleScreensConfig;
+
+/**
+ * Sample a control track: given the saver's param space (defaults + types) and a
+ * track, return the interpolated parameter values at logical time `t` (ms). Pure
+ * and deterministic: identical `(space, track, t)` yields identical output.
+ */
+declare function sampleTrack(space: ParamSpace, track: ControlTrack, t: number): Record<string, ParamValue>;
+/** Default param values (the "resting" program before any track is applied). */
+declare function defaultParams(space: ParamSpace): Record<string, ParamValue>;
+
+/**
+ * Detects user inactivity. `idle` flips true once no activity for `timeoutMs`.
+ * Framework-agnostic port of the Angular IdleService: 6 activity events + a
+ * single `setTimeout` (not a poll) whose reschedule is throttled to >=500ms so
+ * frequent pointermove events do not thrash timers.
+ */
+declare class IdleDetector {
+    private readonly timeoutMs;
+    private readonly _idle;
+    readonly idle: ReadonlySignal<boolean>;
+    private timer;
+    private lastReset;
+    private running;
+    private static readonly EVENTS;
+    constructor(timeoutMs: number);
+    private readonly onActivity;
+    start(): void;
+    stop(): void;
+    /** Force an activity pulse (resets the countdown, wakes from idle). */
+    markActive(): void;
+    private schedule;
+    private clear;
+}
+
+type EngineState = 'awake' | 'sleeping';
+/**
+ * The framework-agnostic idle-screens state machine (port of the Angular
+ * ScreensaverService). Owns: awake/sleeping state, plugin selection, the sleep
+ * clock, reduced-motion + visibility, idle/blur triggers, and the
+ * `window.__idleScreens` debug hook. It does NOT render; the `<idle-screen>`
+ * element observes its signals.
+ */
+declare class IdleScreensEngine {
+    readonly config: IdleScreensConfig;
+    private readonly plugins;
+    private readonly storage;
+    private readonly idle;
+    private readonly selectionRng;
+    private readonly _state;
+    readonly state: ReadonlySignal<EngineState>;
+    readonly isSleeping: ReadonlySignal<boolean>;
+    private readonly _activeId;
+    readonly activePlugin: ReadonlySignal<SaverPlugin | null>;
+    readonly activeIsPassthrough: ReadonlySignal<boolean>;
+    private readonly _now;
+    readonly now: ReadonlySignal<Date>;
+    private readonly _hidden;
+    readonly hidden: ReadonlySignal<boolean>;
+    private readonly _reducedMotion;
+    readonly reducedMotion: ReadonlySignal<boolean>;
+    /** Resolved built-in config-menu options, or null when disabled. */
+    readonly configMenu: Required<ConfigMenuConfig> | null;
+    private readonly _configMenuOpen;
+    /** Whether the config menu is open. Drives the built-in `<idle-screen>` menu;
+     *  a host may also observe this to render its own. */
+    readonly configMenuOpen: ReadonlySignal<boolean>;
+    private clockTimer;
+    private started;
+    private disposers;
+    constructor(config: Partial<IdleScreensConfig>, plugins: SaverPlugin[]);
+    get pluginList(): Array<{
+        id: string;
+        label: string;
+    }>;
+    /** Begin idle detection + listeners + debug hook. */
+    init(): void;
+    destroy(): void;
+    private suppressed;
+    sleep(): void;
+    /** Sleep ignoring suppression rules (debug / manual). */
+    forceSleep(): void;
+    wake(): void;
+    toggle(): void;
+    openConfigMenu(): void;
+    closeConfigMenu(): void;
+    toggleConfigMenu(): void;
+    setPlugin(id: string): void;
+    private pickPlugin;
+    private installDebugHook;
+}
+
+/** Node-safe base: during SSR/prerender there is no `HTMLElement`, and importing
+ *  this module (for the engine/types) must not crash. The element is only ever
+ *  constructed/registered in the browser. */
+declare const HostBase: typeof HTMLElement;
+/**
+ * `<idle-screen>` — the framework-agnostic overlay (port of the Angular
+ * ScreensaverComponent). Owns the top-layer `<dialog>`, mounts the active saver
+ * into a canvas, shows the clock + "press any key" hint, fades in/out, wakes on
+ * input with a 450ms arm-guard, and goes transparent for passthrough savers.
+ *
+ * Configure by setting the `.config` and `.plugins` properties (Angular can do
+ * this via `[config]` / `[plugins]` with CUSTOM_ELEMENTS_SCHEMA).
+ */
+declare class IdleScreenElement extends HostBase {
+    private _engine;
+    private ownsEngine;
+    private _externalEngine;
+    private _config;
+    private _plugins;
+    private dialog;
+    private surface;
+    private clockEl;
+    private hintEl;
+    private menuDialog;
+    private menuSelect;
+    private menuBuilt;
+    private instance;
+    private mountToken;
+    private armed;
+    private armTimer;
+    private hintTimer;
+    private closeTimer;
+    private disposers;
+    set config(c: Partial<IdleScreensConfig>);
+    set plugins(p: SaverPlugin[]);
+    /** Use an externally-owned, already-initialized engine (e.g. an Angular service
+     *  that also drives a config menu) instead of creating one from config+plugins. */
+    set engine(e: IdleScreensEngine);
+    /** The live engine (for host code / tests). */
+    get idleEngine(): IdleScreensEngine | null;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private buildDom;
+    private maybeStart;
+    private buildMenu;
+    private syncMenuSelection;
+    private pageContext;
+    private open;
+    private close;
+    private disposeInstance;
+    private arm;
+    private scheduleHint;
+    private onWakeInput;
+    private teardown;
+}
+/** Register the <idle-screen> custom element (idempotent). */
+declare function defineIdleScreen(tag?: string): void;
+
+export { type ConfigMenuConfig, type ControlTrack, DEFAULT_CONFIG, DEFAULT_MENU_HOTKEY, type Ease, type EngineState, IdleDetector, IdleScreenElement, type IdleScreensConfig, IdleScreensEngine, type PageContext, type ParamDef, type ParamDelta, type ParamSpace, type ParamType, type ParamValue, type Rng, type SaverContext, type SaverInstance, type SaverManifest, type SaverPlugin, createRng, defaultParams, defineIdleScreen, resolveConfigMenu, sampleTrack };

package/dist/index.js

@@ -0,0 +1,760 @@
+// src/types.ts
+var DEFAULT_MENU_HOTKEY = (e) => (e.metaKey || e.ctrlKey) && !e.altKey && !e.shiftKey && e.key.toLowerCase() === "k";
+function resolveConfigMenu(c) {
+  if (c === false) return null;
+  const o = c === true || c === void 0 ? {} : c;
+  if (o.enabled === false) return null;
+  return {
+    enabled: true,
+    hotkey: o.hotkey ?? DEFAULT_MENU_HOTKEY,
+    showPicker: o.showPicker ?? true,
+    previewOnPick: o.previewOnPick ?? true,
+    title: o.title ?? "Screen Saver"
+  };
+}
+var DEFAULT_CONFIG = {
+  timeoutMs: 6e4,
+  sleepOnBlur: true,
+  disableOnLocalhost: false,
+  defaultPluginId: "",
+  selection: "fixed",
+  showClock: true,
+  seed: 1,
+  configMenu: true
+};
+
+// src/rng.ts
+function createRng(seed) {
+  let a = seed >>> 0;
+  const next = () => {
+    a |= 0;
+    a = a + 2654435769 | 0;
+    let t = a ^ a >>> 16;
+    t = Math.imul(t, 569420461);
+    t = t ^ t >>> 15;
+    t = Math.imul(t, 1935289751);
+    return ((t = t ^ t >>> 15) >>> 0) / 4294967296;
+  };
+  const rng = {
+    next,
+    range: (min, max) => min + (max - min) * next(),
+    int: (min, max) => min + Math.floor(next() * (max - min + 1)),
+    pick: (arr) => arr[Math.floor(next() * arr.length)],
+    fork: (salt) => createRng((seed ^ Math.imul(salt + 1, 2654435769)) >>> 0)
+  };
+  return rng;
+}
+
+// src/reactive.ts
+import {
+  signal,
+  computed,
+  effect,
+  batch,
+  untracked
+} from "@preact/signals-core";
+
+// src/control-track.ts
+function easeFn(e, p) {
+  const x = p <= 0 ? 0 : p >= 1 ? 1 : p;
+  switch (e) {
+    case "step":
+      return x >= 1 ? 1 : 0;
+    case "smooth":
+      return x * x * (3 - 2 * x);
+    case "linear":
+    default:
+      return x;
+  }
+}
+function lerp(a, b, p) {
+  return a + (b - a) * p;
+}
+function parseHex(c) {
+  const m = /^#?([0-9a-f]{6})$/i.exec(c.trim());
+  if (!m) return null;
+  const n = parseInt(m[1], 16);
+  return [n >> 16 & 255, n >> 8 & 255, n & 255];
+}
+function toHex(rgb) {
+  const h = (v) => Math.round(Math.max(0, Math.min(255, v))).toString(16).padStart(2, "0");
+  return `#${h(rgb[0])}${h(rgb[1])}${h(rgb[2])}`;
+}
+function lerpValue(type, a, b, p) {
+  if (type === "number" && typeof a === "number" && typeof b === "number") return lerp(a, b, p);
+  if (type === "color" && typeof a === "string" && typeof b === "string") {
+    const ca = parseHex(a);
+    const cb = parseHex(b);
+    if (ca && cb) return toHex([lerp(ca[0], cb[0], p), lerp(ca[1], cb[1], p), lerp(ca[2], cb[2], p)]);
+  }
+  return p >= 1 ? b : a;
+}
+function evalPath(dflt, type, defaultEase, deltas, t) {
+  if (deltas.length === 0) return dflt;
+  let prevVal = dflt;
+  let prevT = -Infinity;
+  for (const k of deltas) {
+    if (t < k.t) {
+      const rampStart = k.dur != null ? k.t - k.dur : prevT === -Infinity ? k.t : prevT;
+      if (t <= rampStart) return prevVal;
+      const p = easeFn(k.ease ?? defaultEase, (t - rampStart) / (k.t - rampStart || 1));
+      return lerpValue(type, prevVal, k.value, p);
+    }
+    prevVal = k.value;
+    prevT = k.t;
+  }
+  return prevVal;
+}
+function sampleTrack(space, track, t) {
+  const byPath = /* @__PURE__ */ new Map();
+  for (const d of track.deltas) {
+    const arr = byPath.get(d.path) ?? [];
+    arr.push(d);
+    byPath.set(d.path, arr);
+  }
+  const wrapped = track.loop && track.duration && track.duration > 0 ? t % track.duration : t;
+  const out = {};
+  for (const [path, def] of Object.entries(space)) {
+    const deltas = (byPath.get(path) ?? []).slice().sort((a, b) => a.t - b.t);
+    out[path] = evalPath(def.default, def.type, def.ease ?? "linear", deltas, wrapped);
+  }
+  return out;
+}
+function defaultParams(space) {
+  const out = {};
+  for (const [path, def] of Object.entries(space)) out[path] = def.default;
+  return out;
+}
+
+// src/idle-detector.ts
+var IdleDetector = class _IdleDetector {
+  constructor(timeoutMs) {
+    this.timeoutMs = timeoutMs;
+  }
+  timeoutMs;
+  _idle = signal(false);
+  idle = this._idle;
+  timer = null;
+  lastReset = 0;
+  running = false;
+  static EVENTS = [
+    "pointerdown",
+    "pointermove",
+    "keydown",
+    "wheel",
+    "touchstart",
+    "scroll"
+  ];
+  onActivity = () => this.markActive();
+  start() {
+    if (this.running || typeof window === "undefined") return;
+    this.running = true;
+    for (const e of _IdleDetector.EVENTS) {
+      window.addEventListener(e, this.onActivity, { passive: true });
+    }
+    this.schedule();
+  }
+  stop() {
+    if (!this.running) return;
+    this.running = false;
+    for (const e of _IdleDetector.EVENTS) {
+      window.removeEventListener(e, this.onActivity);
+    }
+    this.clear();
+  }
+  /** Force an activity pulse (resets the countdown, wakes from idle). */
+  markActive() {
+    if (this._idle.value) this._idle.value = false;
+    const now = typeof performance !== "undefined" ? performance.now() : Date.now();
+    if (now - this.lastReset < 500) return;
+    this.lastReset = now;
+    this.schedule();
+  }
+  schedule() {
+    this.clear();
+    this.timer = setTimeout(() => {
+      this._idle.value = true;
+    }, this.timeoutMs);
+  }
+  clear() {
+    if (this.timer !== null) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+  }
+};
+
+// src/engine.ts
+var hasWindow = typeof window !== "undefined";
+var hasDoc = typeof document !== "undefined";
+function defaultStorage() {
+  return {
+    get: (k) => {
+      try {
+        return hasWindow ? window.localStorage.getItem(k) : null;
+      } catch {
+        return null;
+      }
+    },
+    set: (k, v) => {
+      try {
+        if (hasWindow) window.localStorage.setItem(k, v);
+      } catch {
+      }
+    }
+  };
+}
+var IdleScreensEngine = class {
+  config;
+  plugins;
+  storage;
+  idle;
+  selectionRng;
+  _state = signal("awake");
+  state = this._state;
+  isSleeping = computed(() => this._state.value === "sleeping");
+  _activeId = signal("");
+  activePlugin = computed(
+    () => this.plugins.find((p) => p.manifest.id === this._activeId.value) ?? this.plugins[0] ?? null
+  );
+  activeIsPassthrough = computed(
+    () => this.activePlugin.value?.manifest.passthrough ?? false
+  );
+  _now = signal(/* @__PURE__ */ new Date(0));
+  now = this._now;
+  _hidden = signal(false);
+  hidden = this._hidden;
+  _reducedMotion = signal(false);
+  reducedMotion = this._reducedMotion;
+  /** Resolved built-in config-menu options, or null when disabled. */
+  configMenu;
+  _configMenuOpen = signal(false);
+  /** Whether the config menu is open. Drives the built-in `<idle-screen>` menu;
+   *  a host may also observe this to render its own. */
+  configMenuOpen = this._configMenuOpen;
+  clockTimer = null;
+  started = false;
+  disposers = [];
+  constructor(config, plugins) {
+    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.plugins = plugins;
+    this.configMenu = resolveConfigMenu(this.config.configMenu);
+    this.storage = this.config.storage ?? defaultStorage();
+    this.idle = new IdleDetector(this.config.timeoutMs);
+    this.selectionRng = createRng(this.config.seed >>> 0);
+    const stored = this.storage.get("idleScreens.plugin");
+    const initialId = stored && plugins.some((p) => p.manifest.id === stored) && stored || this.config.defaultPluginId || plugins[0]?.manifest.id || "";
+    this._activeId.value = initialId;
+  }
+  get pluginList() {
+    return this.plugins.map((p) => ({ id: p.manifest.id, label: p.manifest.label }));
+  }
+  /** Begin idle detection + listeners + debug hook. */
+  init() {
+    if (this.started || !hasWindow) return;
+    this.started = true;
+    if (hasDoc) {
+      this._hidden.value = document.hidden;
+      const onVis = () => {
+        this._hidden.value = document.hidden;
+      };
+      document.addEventListener("visibilitychange", onVis);
+      this.disposers.push(() => document.removeEventListener("visibilitychange", onVis));
+    }
+    const mq = hasWindow ? window.matchMedia("(prefers-reduced-motion: reduce)") : null;
+    if (mq) {
+      this._reducedMotion.value = mq.matches;
+      const onMq = () => {
+        this._reducedMotion.value = mq.matches;
+      };
+      mq.addEventListener("change", onMq);
+      this.disposers.push(() => mq.removeEventListener("change", onMq));
+    }
+    this.idle.start();
+    this.disposers.push(
+      effect(() => {
+        if (this.idle.idle.value) untracked(() => this.sleep());
+      })
+    );
+    if (this.config.sleepOnBlur) {
+      const onBlur = () => this.sleep();
+      window.addEventListener("blur", onBlur);
+      this.disposers.push(() => window.removeEventListener("blur", onBlur));
+    }
+    if (this.configMenu) {
+      const hotkey = this.configMenu.hotkey;
+      const onKey = (e) => {
+        if (hotkey(e)) {
+          e.preventDefault();
+          this.toggleConfigMenu();
+        }
+      };
+      window.addEventListener("keydown", onKey);
+      this.disposers.push(() => window.removeEventListener("keydown", onKey));
+    }
+    this.disposers.push(
+      effect(() => {
+        const ticking = this._state.value === "sleeping" && !this._hidden.value;
+        if (ticking && this.clockTimer === null) {
+          this._now.value = /* @__PURE__ */ new Date();
+          this.clockTimer = setInterval(() => {
+            this._now.value = /* @__PURE__ */ new Date();
+          }, 1e3);
+        } else if (!ticking && this.clockTimer !== null) {
+          clearInterval(this.clockTimer);
+          this.clockTimer = null;
+        }
+      })
+    );
+    this.installDebugHook();
+  }
+  destroy() {
+    this.idle.stop();
+    if (this.clockTimer !== null) {
+      clearInterval(this.clockTimer);
+      this.clockTimer = null;
+    }
+    for (const d of this.disposers) d();
+    this.disposers = [];
+    this.started = false;
+  }
+  suppressed() {
+    if (this.config.disableOnLocalhost && hasWindow && /^(localhost|127\.|\[::1\])/.test(location.hostname)) {
+      return true;
+    }
+    const url = hasWindow ? location.pathname + location.search : "";
+    return this.config.suppress ? this.config.suppress(url) : false;
+  }
+  sleep() {
+    if (this._state.value === "sleeping" || this.suppressed()) return;
+    this.pickPlugin();
+    this._state.value = "sleeping";
+  }
+  /** Sleep ignoring suppression rules (debug / manual). */
+  forceSleep() {
+    if (this._state.value === "sleeping") return;
+    this.pickPlugin();
+    this._state.value = "sleeping";
+  }
+  wake() {
+    if (this._state.value === "awake") return;
+    this._state.value = "awake";
+    this.idle.markActive();
+  }
+  toggle() {
+    if (this.isSleeping.value) this.wake();
+    else this.forceSleep();
+  }
+  openConfigMenu() {
+    this._configMenuOpen.value = true;
+  }
+  closeConfigMenu() {
+    this._configMenuOpen.value = false;
+  }
+  toggleConfigMenu() {
+    this._configMenuOpen.value = !this._configMenuOpen.value;
+  }
+  setPlugin(id) {
+    if (!this.plugins.some((p) => p.manifest.id === id)) return;
+    this._activeId.value = id;
+    this.storage.set("idleScreens.plugin", id);
+  }
+  pickPlugin() {
+    if (this.plugins.length === 0) return;
+    switch (this.config.selection) {
+      case "random": {
+        const i = this.selectionRng.int(0, this.plugins.length - 1);
+        this._activeId.value = this.plugins[i].manifest.id;
+        break;
+      }
+      case "rotate": {
+        const cur = this.plugins.findIndex((p) => p.manifest.id === this._activeId.value);
+        const next = this.plugins[(cur + 1) % this.plugins.length];
+        this._activeId.value = next.manifest.id;
+        break;
+      }
+      case "fixed":
+      default:
+        break;
+    }
+  }
+  installDebugHook() {
+    if (!hasWindow) return;
+    window.__idleScreens = {
+      sleep: () => this.forceSleep(),
+      wake: () => this.wake(),
+      toggle: () => this.toggle(),
+      setPlugin: (id) => this.setPlugin(id),
+      openMenu: () => this.openConfigMenu(),
+      closeMenu: () => this.closeConfigMenu(),
+      toggleMenu: () => this.toggleConfigMenu(),
+      state: () => this._state.value,
+      menuOpen: () => this._configMenuOpen.value,
+      active: () => this.activePlugin.value?.manifest.id ?? null,
+      plugins: this.pluginList
+    };
+  }
+};
+
+// src/idle-screen.element.ts
+var STYLE = `
+  :host { all: initial; }
+  dialog.frame {
+    position: fixed; inset: 0; width: 100%; height: 100%;
+    max-width: none; max-height: none; margin: 0; border: 0; padding: 0;
+    background: #0a0a0f; overflow: hidden; cursor: none; color: #fff;
+  }
+  dialog.frame[open] { animation: ss-in 0.5s ease; }
+  dialog.frame.leaving { animation: ss-out 0.32s ease forwards; }
+  dialog.frame.reduced { animation: none; }
+  dialog.frame::backdrop { background: #0a0a0f; }
+  dialog.frame.passthrough, dialog.frame.passthrough::backdrop { background: transparent; }
+  @keyframes ss-in { from { opacity: 0; } to { opacity: 1; } }
+  @keyframes ss-out { from { opacity: 1; } to { opacity: 0; } }
+  .surface { position: absolute; inset: 0; display: block; width: 100%; height: 100%; }
+  .surface > canvas { display: block; width: 100%; height: 100%; }
+  .clock {
+    position: absolute; top: 10px; right: 12px; text-align: right;
+    font-family: 'Orbitron', system-ui, sans-serif; pointer-events: none;
+  }
+  .clock .day { font-size: 34px; opacity: 0.9; }
+  .clock .time { font-size: 54px; }
+  .hint {
+    position: fixed; bottom: 26px; left: 50%; transform: translateX(-50%);
+    color: rgba(230,230,230,0.6); font: 12px ui-monospace, monospace;
+    letter-spacing: 0.25em; text-transform: uppercase; opacity: 0;
+    transition: opacity 1s ease; pointer-events: none;
+  }
+  .hint.show { opacity: 1; }
+
+  /* Built-in config menu: a normal (interactive) centered dialog, distinct from
+     the cursor-hidden saver frame. */
+  dialog.menu {
+    position: fixed; inset: 0; margin: auto; border: 0; padding: 0;
+    width: min(420px, calc(100vw - 32px)); max-width: none;
+    background: transparent; color: #f2f2f5;
+  }
+  dialog.menu::backdrop { background: rgba(6,6,10,0.5); backdrop-filter: blur(2px); }
+  .menu-card {
+    background: #14141b; border: 1px solid rgba(255,255,255,0.12);
+    border-radius: 14px; padding: 20px; box-shadow: 0 24px 60px rgba(0,0,0,0.5);
+    font-family: system-ui, sans-serif;
+  }
+  .menu-title { font-size: 18px; font-weight: 600; margin: 0 0 14px; }
+  .menu-row { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 14px; }
+  .menu-row > span { font-size: 14px; opacity: 0.85; }
+  .menu-select {
+    flex: 1; max-width: 60%; padding: 7px 10px; border-radius: 8px;
+    background: #0d0d12; color: #f2f2f5; border: 1px solid rgba(255,255,255,0.16);
+    font-size: 14px;
+  }
+  .menu-actions { display: flex; justify-content: flex-end; }
+  .menu-close {
+    padding: 7px 16px; border-radius: 8px; cursor: pointer; font-size: 14px;
+    background: #2a2a37; color: #f2f2f5; border: 1px solid rgba(255,255,255,0.14);
+  }
+  .menu-close:hover { background: #34344a; }
+`;
+var HostBase = typeof HTMLElement !== "undefined" ? HTMLElement : class {
+};
+var IdleScreenElement = class extends HostBase {
+  _engine = null;
+  ownsEngine = false;
+  _externalEngine = null;
+  _config = null;
+  _plugins = null;
+  dialog;
+  surface;
+  clockEl;
+  hintEl;
+  menuDialog = null;
+  menuSelect = null;
+  menuBuilt = false;
+  instance = null;
+  mountToken = 0;
+  armed = false;
+  armTimer = null;
+  hintTimer = null;
+  closeTimer = null;
+  disposers = [];
+  set config(c) {
+    this._config = c;
+    this.maybeStart();
+  }
+  set plugins(p) {
+    this._plugins = p;
+    this.maybeStart();
+  }
+  /** Use an externally-owned, already-initialized engine (e.g. an Angular service
+   *  that also drives a config menu) instead of creating one from config+plugins. */
+  set engine(e) {
+    this._externalEngine = e;
+    this.maybeStart();
+  }
+  /** The live engine (for host code / tests). */
+  get idleEngine() {
+    return this._engine;
+  }
+  connectedCallback() {
+    if (!this.shadowRoot) this.buildDom();
+    this.maybeStart();
+  }
+  disconnectedCallback() {
+    this.teardown();
+  }
+  buildDom() {
+    const root = this.attachShadow({ mode: "open" });
+    const style = document.createElement("style");
+    style.textContent = STYLE;
+    this.dialog = document.createElement("dialog");
+    this.dialog.className = "frame";
+    this.surface = document.createElement("div");
+    this.surface.className = "surface";
+    this.clockEl = document.createElement("div");
+    this.clockEl.className = "clock";
+    this.hintEl = document.createElement("div");
+    this.hintEl.className = "hint";
+    this.hintEl.textContent = "press any key";
+    this.dialog.append(this.surface, this.clockEl, this.hintEl);
+    root.append(style, this.dialog);
+    for (const ev of ["pointerdown", "pointermove", "keydown", "wheel", "touchstart"]) {
+      this.dialog.addEventListener(ev, () => this.onWakeInput(), { passive: true });
+    }
+    this.dialog.addEventListener("cancel", (e) => {
+      e.preventDefault();
+      this._engine?.wake();
+    });
+  }
+  maybeStart() {
+    if (this._engine || !this.shadowRoot || typeof window === "undefined") return;
+    if (this._externalEngine) {
+      this._engine = this._externalEngine;
+      this.ownsEngine = false;
+    } else if (this._config && this._plugins) {
+      this._engine = new IdleScreensEngine(this._config, this._plugins);
+      this._engine.init();
+      this.ownsEngine = true;
+    } else {
+      return;
+    }
+    const eng = this._engine;
+    this.disposers.push(
+      effect(() => {
+        const sleeping = eng.isSleeping.value;
+        const active = eng.activePlugin.value;
+        const passthrough = eng.activeIsPassthrough.value;
+        if (sleeping && active) this.open(active, passthrough);
+        else this.close();
+      })
+    );
+    this.disposers.push(
+      effect(() => {
+        const show = this._engine.config.showClock && !eng.activeIsPassthrough.value;
+        const now = eng.now.value;
+        this.clockEl.style.display = show && eng.isSleeping.value ? "block" : "none";
+        if (show) {
+          const day = now.toLocaleDateString(void 0, {
+            weekday: "long",
+            month: "long",
+            day: "numeric"
+          });
+          const time = now.toLocaleTimeString();
+          this.clockEl.innerHTML = `<div class="day">${day}</div><div class="time">${time}</div>`;
+        }
+      })
+    );
+    if (eng.configMenu) {
+      this.buildMenu(eng.configMenu);
+      this.disposers.push(
+        effect(() => {
+          const open = eng.configMenuOpen.value;
+          const d = this.menuDialog;
+          if (!d) return;
+          if (open && !d.open) {
+            this.syncMenuSelection();
+            d.showModal();
+          } else if (!open && d.open) {
+            d.close();
+          }
+        })
+      );
+      this.disposers.push(
+        effect(() => {
+          const id = eng.activePlugin.value?.manifest.id ?? "";
+          if (this.menuSelect && this.menuSelect.value !== id) this.menuSelect.value = id;
+        })
+      );
+    }
+  }
+  buildMenu(cfg) {
+    if (this.menuBuilt || !this.shadowRoot) return;
+    const eng = this._engine;
+    const d = document.createElement("dialog");
+    d.className = "menu";
+    const card = document.createElement("div");
+    card.className = "menu-card";
+    const title = document.createElement("div");
+    title.className = "menu-title";
+    title.textContent = cfg.title;
+    card.append(title);
+    if (cfg.showPicker) {
+      const row = document.createElement("label");
+      row.className = "menu-row";
+      const label = document.createElement("span");
+      label.textContent = "Saver";
+      const select = document.createElement("select");
+      select.className = "menu-select";
+      for (const p of eng.pluginList) {
+        const opt = document.createElement("option");
+        opt.value = p.id;
+        opt.textContent = p.label;
+        select.append(opt);
+      }
+      select.addEventListener("change", () => {
+        eng.setPlugin(select.value);
+        if (cfg.previewOnPick) {
+          eng.closeConfigMenu();
+          eng.forceSleep();
+        }
+      });
+      row.append(label, select);
+      card.append(row);
+      this.menuSelect = select;
+    }
+    const actions = document.createElement("div");
+    actions.className = "menu-actions";
+    const close = document.createElement("button");
+    close.className = "menu-close";
+    close.type = "button";
+    close.textContent = "Close";
+    close.addEventListener("click", () => eng.closeConfigMenu());
+    actions.append(close);
+    card.append(actions);
+    d.append(card);
+    d.addEventListener("cancel", (e) => {
+      e.preventDefault();
+      eng.closeConfigMenu();
+    });
+    d.addEventListener("click", (e) => {
+      if (e.target === d) eng.closeConfigMenu();
+    });
+    this.shadowRoot.append(d);
+    this.menuDialog = d;
+    this.menuBuilt = true;
+  }
+  syncMenuSelection() {
+    if (this.menuSelect) {
+      this.menuSelect.value = this._engine?.activePlugin.value?.manifest.id ?? "";
+    }
+  }
+  pageContext() {
+    return {
+      palette: () => [],
+      victims: (selector) => typeof document !== "undefined" ? Array.from(document.querySelectorAll(selector)) : []
+    };
+  }
+  async open(plugin, passthrough) {
+    const eng = this._engine;
+    this.dialog.classList.toggle("passthrough", passthrough);
+    this.dialog.classList.toggle("reduced", eng.reducedMotion.value);
+    if (!this.dialog.open) {
+      this.dialog.classList.remove("leaving");
+      this.dialog.showModal();
+      this.arm();
+      this.scheduleHint();
+    }
+    const token = ++this.mountToken;
+    await this.disposeInstance();
+    const w = window.innerWidth;
+    const h = window.innerHeight;
+    const seed = eng.config.seed >>> 0;
+    const inst = await plugin.mount({
+      host: this.surface,
+      width: w,
+      height: h,
+      rng: createRng(seed),
+      seed,
+      reducedMotion: eng.reducedMotion.value,
+      page: plugin.manifest.passthrough ? this.pageContext() : void 0
+    });
+    if (token !== this.mountToken) {
+      inst.dispose();
+      return;
+    }
+    this.instance = inst;
+    inst.setPaused(eng.reducedMotion.value);
+  }
+  close() {
+    if (!this.dialog?.open) return;
+    this.hintEl.classList.remove("show");
+    if (this.hintTimer) clearTimeout(this.hintTimer);
+    void this.disposeInstance();
+    const reduced = this._engine?.reducedMotion.value;
+    if (reduced) {
+      this.dialog.close();
+      return;
+    }
+    this.dialog.classList.add("leaving");
+    if (this.closeTimer) clearTimeout(this.closeTimer);
+    this.closeTimer = setTimeout(() => {
+      if (this.dialog.open) this.dialog.close();
+      this.dialog.classList.remove("leaving");
+    }, 320);
+  }
+  async disposeInstance() {
+    if (this.instance) {
+      this.instance.dispose();
+      this.instance = null;
+    }
+    this.surface?.replaceChildren();
+  }
+  arm() {
+    this.armed = false;
+    if (this.armTimer) clearTimeout(this.armTimer);
+    this.armTimer = setTimeout(() => {
+      this.armed = true;
+    }, 450);
+  }
+  scheduleHint() {
+    if (this.hintTimer) clearTimeout(this.hintTimer);
+    this.hintEl.classList.remove("show");
+    this.hintTimer = setTimeout(() => this.hintEl.classList.add("show"), 3e3);
+  }
+  onWakeInput() {
+    if (!this.armed) return;
+    this._engine?.wake();
+  }
+  teardown() {
+    void this.disposeInstance();
+    if (this.armTimer) clearTimeout(this.armTimer);
+    if (this.hintTimer) clearTimeout(this.hintTimer);
+    if (this.closeTimer) clearTimeout(this.closeTimer);
+    for (const d of this.disposers) d();
+    this.disposers = [];
+    if (this.ownsEngine) this._engine?.destroy();
+    this._engine = null;
+  }
+};
+function defineIdleScreen(tag = "idle-screen") {
+  if (typeof customElements !== "undefined" && !customElements.get(tag)) {
+    customElements.define(tag, IdleScreenElement);
+  }
+}
+export {
+  DEFAULT_CONFIG,
+  DEFAULT_MENU_HOTKEY,
+  IdleDetector,
+  IdleScreenElement,
+  IdleScreensEngine,
+  batch,
+  computed,
+  createRng,
+  defaultParams,
+  defineIdleScreen,
+  effect,
+  resolveConfigMenu,
+  sampleTrack,
+  signal,
+  untracked
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/rng.ts","../src/reactive.ts","../src/control-track.ts","../src/idle-detector.ts","../src/engine.ts","../src/idle-screen.element.ts"],"sourcesContent":["import type { Rng } from './rng';\n\n/** How a parameter interpolates between control-track deltas. */\nexport type Ease = 'step' | 'linear' | 'smooth';\n\nexport type ParamType = 'number' | 'color' | 'bool' | 'enum';\nexport type ParamValue = number | string | boolean;\n\n/** One typed, ranged, interpolatable knob: an agent's steering surface. */\nexport interface ParamDef {\n  type: ParamType;\n  default: ParamValue;\n  min?: number;\n  max?: number;\n  options?: string[];\n  /** Default interpolation when a delta targets this knob. */\n  ease?: Ease;\n}\n\nexport type ParamSpace = Record<string, ParamDef>;\n\n/** A sparse, timestamped, interpolatable parameter change. Agents stream THESE\n *  (over AG-UI state-patches / MCP resource updates), never frames. */\nexport interface ParamDelta {\n  /** ms from track start. */\n  t: number;\n  /** key in the saver's paramSpace. */\n  path: string;\n  value: ParamValue;\n  ease?: Ease;\n  /** ramp duration ms from the previous value (0 = instant). */\n  dur?: number;\n}\n\n/** A recorded or live steering performance for a seeded program. */\nexport interface ControlTrack {\n  program: string;\n  seed: number;\n  duration?: number;\n  loop?: boolean;\n  deltas: ParamDelta[];\n}\n\n/** Page-context seam: passthrough savers read/eat the live page through this,\n *  rather than querying `document` directly. */\nexport interface PageContext {\n  /** Sample dominant colors of the page (for palette-reactive savers). */\n  palette(): string[];\n  /** Visible page blocks a passthrough saver may transform (\"victims\"). */\n  victims(selector: string): HTMLElement[];\n}\n\n/** What the host hands a saver when it mounts. */\nexport interface SaverContext {\n  /** A full-viewport container the saver renders into. Canvas savers create a\n   *  canvas inside it; DOM savers (toasters, DVD, messages) append elements. The\n   *  host is cleared by the runtime on dispose. */\n  host: HTMLElement;\n  width: number;\n  height: number;\n  /** Seeded PRNG. Use this, never Math.random(), for determinism. */\n  rng: Rng;\n  seed: number;\n  reducedMotion: boolean;\n  /** Present for passthrough savers (over the live page). */\n  page?: PageContext;\n}\n\n/** A mounted, running saver visual. */\nexport interface SaverInstance {\n  /** Freeze/unfreeze the render loop (paused, reduced-motion, or screensaver end). */\n  setPaused(paused: boolean): void;\n  resize(width: number, height: number): void;\n  /** Deterministic, frame-addressable render: draw the state at logical time `t`\n   *  (ms) for `seed`. Pure w.r.t. (program, seed, applied track, t). Optional. */\n  renderFrame?(t: number, seed: number): void;\n  /** Steer parameters over time. Optional. */\n  applyTrack?(track: ControlTrack): void;\n  /** Tear down; MUST restore any live-page mutations. */\n  dispose(): void;\n}\n\n/** Self-describing metadata, readable WITHOUT executing the saver. */\nexport interface SaverManifest {\n  id: string;\n  label: string;\n  passthrough?: boolean;\n  minBackend?: 'css' | 'canvas2d' | 'webgl2' | 'webgpu';\n  costTier?: 'idle' | 'low' | 'medium' | 'high';\n  motionIntensity?: 'calm' | 'moderate' | 'energetic';\n  reducedMotionFallback?: 'static' | 'slow' | 'hide';\n  palette?: string[];\n  paramSpace?: ParamSpace;\n  a11y?: { flashSafe?: boolean; notes?: string };\n  provenance?: { prompt?: string; seed?: number; model?: string };\n  thumbnail?: string;\n}\n\n/** A registered saver: manifest + a (possibly lazy/async) mount factory. */\nexport interface SaverPlugin {\n  manifest: SaverManifest;\n  mount(ctx: SaverContext): SaverInstance | Promise<SaverInstance>;\n}\n\n/** Engine configuration. */\nexport interface IdleScreensConfig {\n  /** Idle time before sleeping, in ms. */\n  timeoutMs: number;\n  /** Also sleep when the window loses focus. */\n  sleepOnBlur: boolean;\n  /** Do not run on localhost (debug hooks bypass this). */\n  disableOnLocalhost: boolean;\n  /** Which registered saver to show. */\n  defaultPluginId: string;\n  /** How to pick across sleeps. */\n  selection: 'fixed' | 'random' | 'rotate';\n  /** Show the clock chrome (non-passthrough savers only). */\n  showClock: boolean;\n  /** Exact document title while asleep. */\n  sleepTitle?: string;\n  /** Master seed for plugin selection + the default saver seed. */\n  seed: number;\n  /** Return true for a URL where the saver must never sleep. */\n  suppress?: (url: string) => boolean;\n  /** Pluggable persistence (defaults to localStorage when available). */\n  storage?: { get(key: string): string | null; set(key: string, value: string): void };\n  /** Built-in, keyboard-opened config menu (saver picker). `true`/omitted =\n   *  enabled with ⌘K / Ctrl+K; `false` = no hotkey and no built-in menu (the\n   *  `configMenuOpen` signal + open/close API still work, so a host may render\n   *  its own). Pass an object to reconfigure. */\n  configMenu?: boolean | ConfigMenuConfig;\n}\n\n/** Options for the built-in, keyboard-opened config menu. */\nexport interface ConfigMenuConfig {\n  /** Master switch. Default true. */\n  enabled?: boolean;\n  /** Decides whether a keydown opens/toggles the menu. Default: ⌘K / Ctrl+K. */\n  hotkey?: (e: KeyboardEvent) => boolean;\n  /** Show the saver picker control. Default true. */\n  showPicker?: boolean;\n  /** Preview the picked saver immediately (sleep to show it). Default true. */\n  previewOnPick?: boolean;\n  /** Heading text. Default 'Screen Saver'. */\n  title?: string;\n}\n\n/** Default menu hotkey: ⌘K (mac) / Ctrl+K, no other modifiers. */\nexport const DEFAULT_MENU_HOTKEY = (e: KeyboardEvent): boolean =>\n  (e.metaKey || e.ctrlKey) && !e.altKey && !e.shiftKey && e.key.toLowerCase() === 'k';\n\n/** Normalize `configMenu` to a filled config, or null when disabled. */\nexport function resolveConfigMenu(\n  c: boolean | ConfigMenuConfig | undefined,\n): Required<ConfigMenuConfig> | null {\n  if (c === false) return null;\n  const o: ConfigMenuConfig = c === true || c === undefined ? {} : c;\n  if (o.enabled === false) return null;\n  return {\n    enabled: true,\n    hotkey: o.hotkey ?? DEFAULT_MENU_HOTKEY,\n    showPicker: o.showPicker ?? true,\n    previewOnPick: o.previewOnPick ?? true,\n    title: o.title ?? 'Screen Saver',\n  };\n}\n\nexport const DEFAULT_CONFIG: IdleScreensConfig = {\n  timeoutMs: 60_000,\n  sleepOnBlur: true,\n  disableOnLocalhost: false,\n  defaultPluginId: '',\n  selection: 'fixed',\n  showClock: true,\n  seed: 1,\n  configMenu: true,\n};\n","/**\n * A tiny, fast, seedable PRNG (splitmix32). Deterministic: the same seed always\n * yields the same sequence, on any machine. This is what makes \"same program +\n * seed + control-track = identical frames\" hold. Savers take an `Rng` from their\n * `SaverContext` instead of calling `Math.random()`.\n */\nexport interface Rng {\n  /** Next float in [0, 1). */\n  next(): number;\n  /** Float in [min, max). */\n  range(min: number, max: number): number;\n  /** Integer in [min, max] inclusive. */\n  int(min: number, max: number): number;\n  /** Random element of a non-empty array. */\n  pick<T>(arr: readonly T[]): T;\n  /** A fresh independent stream (e.g. per subsystem), derived from this seed. */\n  fork(salt: number): Rng;\n}\n\nexport function createRng(seed: number): Rng {\n  let a = seed >>> 0;\n  const next = (): number => {\n    a |= 0;\n    a = (a + 0x9e3779b9) | 0;\n    let t = a ^ (a >>> 16);\n    t = Math.imul(t, 0x21f0aaad);\n    t = t ^ (t >>> 15);\n    t = Math.imul(t, 0x735a2d97);\n    return ((t = t ^ (t >>> 15)) >>> 0) / 4294967296;\n  };\n  const rng: Rng = {\n    next,\n    range: (min, max) => min + (max - min) * next(),\n    int: (min, max) => min + Math.floor(next() * (max - min + 1)),\n    pick: (arr) => arr[Math.floor(next() * arr.length)] as (typeof arr)[number],\n    fork: (salt) => createRng((seed ^ Math.imul(salt + 1, 0x9e3779b9)) >>> 0),\n  };\n  return rng;\n}\n","/**\n * Framework-agnostic reactivity. We re-export `@preact/signals-core` so the rest\n * of the engine uses the same `signal` / `computed` / `effect` primitives it did\n * as Angular signals, with near-identical semantics.\n */\nexport {\n  signal,\n  computed,\n  effect,\n  batch,\n  untracked,\n  type Signal,\n  type ReadonlySignal,\n} from '@preact/signals-core';\n","import type { ControlTrack, Ease, ParamDelta, ParamSpace, ParamValue } from './types';\n\nfunction easeFn(e: Ease, p: number): number {\n  const x = p <= 0 ? 0 : p >= 1 ? 1 : p;\n  switch (e) {\n    case 'step':\n      return x >= 1 ? 1 : 0;\n    case 'smooth':\n      return x * x * (3 - 2 * x);\n    case 'linear':\n    default:\n      return x;\n  }\n}\n\nfunction lerp(a: number, b: number, p: number): number {\n  return a + (b - a) * p;\n}\n\nfunction parseHex(c: string): [number, number, number] | null {\n  const m = /^#?([0-9a-f]{6})$/i.exec(c.trim());\n  if (!m) return null;\n  const n = parseInt(m[1]!, 16);\n  return [(n >> 16) & 255, (n >> 8) & 255, n & 255];\n}\n\nfunction toHex(rgb: [number, number, number]): string {\n  const h = (v: number): string =>\n    Math.round(Math.max(0, Math.min(255, v)))\n      .toString(16)\n      .padStart(2, '0');\n  return `#${h(rgb[0])}${h(rgb[1])}${h(rgb[2])}`;\n}\n\nfunction lerpValue(type: string, a: ParamValue, b: ParamValue, p: number): ParamValue {\n  if (type === 'number' && typeof a === 'number' && typeof b === 'number') return lerp(a, b, p);\n  if (type === 'color' && typeof a === 'string' && typeof b === 'string') {\n    const ca = parseHex(a);\n    const cb = parseHex(b);\n    if (ca && cb) return toHex([lerp(ca[0], cb[0], p), lerp(ca[1], cb[1], p), lerp(ca[2], cb[2], p)]);\n  }\n  return p >= 1 ? b : a; // bool / enum / step\n}\n\nfunction evalPath(\n  dflt: ParamValue,\n  type: string,\n  defaultEase: Ease,\n  deltas: ParamDelta[],\n  t: number,\n): ParamValue {\n  if (deltas.length === 0) return dflt;\n  let prevVal = dflt;\n  let prevT = -Infinity;\n  for (const k of deltas) {\n    if (t < k.t) {\n      const rampStart = k.dur != null ? k.t - k.dur : prevT === -Infinity ? k.t : prevT;\n      if (t <= rampStart) return prevVal;\n      const p = easeFn(k.ease ?? defaultEase, (t - rampStart) / (k.t - rampStart || 1));\n      return lerpValue(type, prevVal, k.value, p);\n    }\n    prevVal = k.value;\n    prevT = k.t;\n  }\n  return prevVal; // after the last keyframe\n}\n\n/**\n * Sample a control track: given the saver's param space (defaults + types) and a\n * track, return the interpolated parameter values at logical time `t` (ms). Pure\n * and deterministic: identical `(space, track, t)` yields identical output.\n */\nexport function sampleTrack(\n  space: ParamSpace,\n  track: ControlTrack,\n  t: number,\n): Record<string, ParamValue> {\n  const byPath = new Map<string, ParamDelta[]>();\n  for (const d of track.deltas) {\n    const arr = byPath.get(d.path) ?? [];\n    arr.push(d);\n    byPath.set(d.path, arr);\n  }\n  const wrapped =\n    track.loop && track.duration && track.duration > 0 ? t % track.duration : t;\n\n  const out: Record<string, ParamValue> = {};\n  for (const [path, def] of Object.entries(space)) {\n    const deltas = (byPath.get(path) ?? []).slice().sort((a, b) => a.t - b.t);\n    out[path] = evalPath(def.default, def.type, def.ease ?? 'linear', deltas, wrapped);\n  }\n  return out;\n}\n\n/** Default param values (the \"resting\" program before any track is applied). */\nexport function defaultParams(space: ParamSpace): Record<string, ParamValue> {\n  const out: Record<string, ParamValue> = {};\n  for (const [path, def] of Object.entries(space)) out[path] = def.default;\n  return out;\n}\n","import { signal, type ReadonlySignal } from './reactive';\n\n/**\n * Detects user inactivity. `idle` flips true once no activity for `timeoutMs`.\n * Framework-agnostic port of the Angular IdleService: 6 activity events + a\n * single `setTimeout` (not a poll) whose reschedule is throttled to >=500ms so\n * frequent pointermove events do not thrash timers.\n */\nexport class IdleDetector {\n  private readonly _idle = signal(false);\n  readonly idle: ReadonlySignal<boolean> = this._idle;\n\n  private timer: ReturnType<typeof setTimeout> | null = null;\n  private lastReset = 0;\n  private running = false;\n\n  private static readonly EVENTS = [\n    'pointerdown',\n    'pointermove',\n    'keydown',\n    'wheel',\n    'touchstart',\n    'scroll',\n  ] as const;\n\n  constructor(private readonly timeoutMs: number) {}\n\n  private readonly onActivity = (): void => this.markActive();\n\n  start(): void {\n    if (this.running || typeof window === 'undefined') return;\n    this.running = true;\n    for (const e of IdleDetector.EVENTS) {\n      window.addEventListener(e, this.onActivity, { passive: true });\n    }\n    this.schedule();\n  }\n\n  stop(): void {\n    if (!this.running) return;\n    this.running = false;\n    for (const e of IdleDetector.EVENTS) {\n      window.removeEventListener(e, this.onActivity);\n    }\n    this.clear();\n  }\n\n  /** Force an activity pulse (resets the countdown, wakes from idle). */\n  markActive(): void {\n    if (this._idle.value) this._idle.value = false;\n    const now = typeof performance !== 'undefined' ? performance.now() : Date.now();\n    if (now - this.lastReset < 500) return; // throttle reschedules\n    this.lastReset = now;\n    this.schedule();\n  }\n\n  private schedule(): void {\n    this.clear();\n    this.timer = setTimeout(() => {\n      this._idle.value = true;\n    }, this.timeoutMs);\n  }\n\n  private clear(): void {\n    if (this.timer !== null) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n  }\n}\n","import { computed, effect, signal, untracked, type ReadonlySignal } from './reactive';\nimport { IdleDetector } from './idle-detector';\nimport { createRng, type Rng } from './rng';\nimport {\n  DEFAULT_CONFIG,\n  resolveConfigMenu,\n  type ConfigMenuConfig,\n  type IdleScreensConfig,\n  type SaverPlugin,\n} from './types';\n\nexport type EngineState = 'awake' | 'sleeping';\n\nconst hasWindow = typeof window !== 'undefined';\nconst hasDoc = typeof document !== 'undefined';\n\nfunction defaultStorage(): IdleScreensConfig['storage'] {\n  return {\n    get: (k) => {\n      try {\n        return hasWindow ? window.localStorage.getItem(k) : null;\n      } catch {\n        return null;\n      }\n    },\n    set: (k, v) => {\n      try {\n        if (hasWindow) window.localStorage.setItem(k, v);\n      } catch {\n        /* private mode / disabled storage */\n      }\n    },\n  };\n}\n\n/**\n * The framework-agnostic idle-screens state machine (port of the Angular\n * ScreensaverService). Owns: awake/sleeping state, plugin selection, the sleep\n * clock, reduced-motion + visibility, idle/blur triggers, and the\n * `window.__idleScreens` debug hook. It does NOT render; the `<idle-screen>`\n * element observes its signals.\n */\nexport class IdleScreensEngine {\n  readonly config: IdleScreensConfig;\n  private readonly plugins: SaverPlugin[];\n  private readonly storage: NonNullable<IdleScreensConfig['storage']>;\n  private readonly idle: IdleDetector;\n  private readonly selectionRng: Rng;\n\n  private readonly _state = signal<EngineState>('awake');\n  readonly state: ReadonlySignal<EngineState> = this._state;\n  readonly isSleeping = computed(() => this._state.value === 'sleeping');\n\n  private readonly _activeId = signal('');\n  readonly activePlugin = computed(\n    () =>\n      this.plugins.find((p) => p.manifest.id === this._activeId.value) ??\n      this.plugins[0] ??\n      null,\n  );\n  readonly activeIsPassthrough = computed(\n    () => this.activePlugin.value?.manifest.passthrough ?? false,\n  );\n\n  private readonly _now = signal(new Date(0));\n  readonly now: ReadonlySignal<Date> = this._now;\n  private readonly _hidden = signal(false);\n  readonly hidden: ReadonlySignal<boolean> = this._hidden;\n  private readonly _reducedMotion = signal(false);\n  readonly reducedMotion: ReadonlySignal<boolean> = this._reducedMotion;\n\n  /** Resolved built-in config-menu options, or null when disabled. */\n  readonly configMenu: Required<ConfigMenuConfig> | null;\n  private readonly _configMenuOpen = signal(false);\n  /** Whether the config menu is open. Drives the built-in `<idle-screen>` menu;\n   *  a host may also observe this to render its own. */\n  readonly configMenuOpen: ReadonlySignal<boolean> = this._configMenuOpen;\n\n  private clockTimer: ReturnType<typeof setInterval> | null = null;\n  private started = false;\n  private disposers: Array<() => void> = [];\n\n  constructor(config: Partial<IdleScreensConfig>, plugins: SaverPlugin[]) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this.plugins = plugins;\n    this.configMenu = resolveConfigMenu(this.config.configMenu);\n    this.storage = this.config.storage ?? defaultStorage()!;\n    this.idle = new IdleDetector(this.config.timeoutMs);\n    this.selectionRng = createRng(this.config.seed >>> 0);\n\n    const stored = this.storage.get('idleScreens.plugin');\n    const initialId =\n      (stored && plugins.some((p) => p.manifest.id === stored) && stored) ||\n      this.config.defaultPluginId ||\n      plugins[0]?.manifest.id ||\n      '';\n    this._activeId.value = initialId;\n  }\n\n  get pluginList(): Array<{ id: string; label: string }> {\n    return this.plugins.map((p) => ({ id: p.manifest.id, label: p.manifest.label }));\n  }\n\n  /** Begin idle detection + listeners + debug hook. */\n  init(): void {\n    if (this.started || !hasWindow) return;\n    this.started = true;\n\n    if (hasDoc) {\n      this._hidden.value = document.hidden;\n      const onVis = (): void => {\n        this._hidden.value = document.hidden;\n      };\n      document.addEventListener('visibilitychange', onVis);\n      this.disposers.push(() => document.removeEventListener('visibilitychange', onVis));\n    }\n\n    const mq = hasWindow ? window.matchMedia('(prefers-reduced-motion: reduce)') : null;\n    if (mq) {\n      this._reducedMotion.value = mq.matches;\n      const onMq = (): void => {\n        this._reducedMotion.value = mq.matches;\n      };\n      mq.addEventListener('change', onMq);\n      this.disposers.push(() => mq.removeEventListener('change', onMq));\n    }\n\n    // Sleep when idle fires (unless suppressed). `sleep()` reads `state` in its\n    // guard; wrap it in `untracked` so this effect depends ONLY on the idle\n    // signal — otherwise flipping `state` to awake in wake() (while idle is still\n    // latched true) would re-trigger this effect and immediately re-sleep.\n    this.idle.start();\n    this.disposers.push(\n      effect(() => {\n        if (this.idle.idle.value) untracked(() => this.sleep());\n      }),\n    );\n\n    if (this.config.sleepOnBlur) {\n      const onBlur = (): void => this.sleep();\n      window.addEventListener('blur', onBlur);\n      this.disposers.push(() => window.removeEventListener('blur', onBlur));\n    }\n\n    // Optional built-in config-menu hotkey (⌘K / Ctrl+K by default).\n    if (this.configMenu) {\n      const hotkey = this.configMenu.hotkey;\n      const onKey = (e: KeyboardEvent): void => {\n        if (hotkey(e)) {\n          e.preventDefault();\n          this.toggleConfigMenu();\n        }\n      };\n      window.addEventListener('keydown', onKey);\n      this.disposers.push(() => window.removeEventListener('keydown', onKey));\n    }\n\n    // Drive the clock only while asleep + visible.\n    this.disposers.push(\n      effect(() => {\n        const ticking = this._state.value === 'sleeping' && !this._hidden.value;\n        if (ticking && this.clockTimer === null) {\n          this._now.value = new Date();\n          this.clockTimer = setInterval(() => {\n            this._now.value = new Date();\n          }, 1000);\n        } else if (!ticking && this.clockTimer !== null) {\n          clearInterval(this.clockTimer);\n          this.clockTimer = null;\n        }\n      }),\n    );\n\n    this.installDebugHook();\n  }\n\n  destroy(): void {\n    this.idle.stop();\n    if (this.clockTimer !== null) {\n      clearInterval(this.clockTimer);\n      this.clockTimer = null;\n    }\n    for (const d of this.disposers) d();\n    this.disposers = [];\n    this.started = false;\n  }\n\n  private suppressed(): boolean {\n    if (this.config.disableOnLocalhost && hasWindow && /^(localhost|127\\.|\\[::1\\])/.test(location.hostname)) {\n      return true;\n    }\n    const url = hasWindow ? location.pathname + location.search : '';\n    return this.config.suppress ? this.config.suppress(url) : false;\n  }\n\n  sleep(): void {\n    if (this._state.value === 'sleeping' || this.suppressed()) return;\n    this.pickPlugin();\n    this._state.value = 'sleeping';\n  }\n\n  /** Sleep ignoring suppression rules (debug / manual). */\n  forceSleep(): void {\n    if (this._state.value === 'sleeping') return;\n    this.pickPlugin();\n    this._state.value = 'sleeping';\n  }\n\n  wake(): void {\n    if (this._state.value === 'awake') return;\n    this._state.value = 'awake';\n    this.idle.markActive();\n  }\n\n  toggle(): void {\n    if (this.isSleeping.value) this.wake();\n    else this.forceSleep();\n  }\n\n  openConfigMenu(): void {\n    this._configMenuOpen.value = true;\n  }\n  closeConfigMenu(): void {\n    this._configMenuOpen.value = false;\n  }\n  toggleConfigMenu(): void {\n    this._configMenuOpen.value = !this._configMenuOpen.value;\n  }\n\n  setPlugin(id: string): void {\n    if (!this.plugins.some((p) => p.manifest.id === id)) return;\n    this._activeId.value = id;\n    this.storage.set('idleScreens.plugin', id);\n  }\n\n  private pickPlugin(): void {\n    if (this.plugins.length === 0) return;\n    switch (this.config.selection) {\n      case 'random': {\n        const i = this.selectionRng.int(0, this.plugins.length - 1);\n        this._activeId.value = this.plugins[i]!.manifest.id;\n        break;\n      }\n      case 'rotate': {\n        const cur = this.plugins.findIndex((p) => p.manifest.id === this._activeId.value);\n        const next = this.plugins[(cur + 1) % this.plugins.length]!;\n        this._activeId.value = next.manifest.id;\n        break;\n      }\n      case 'fixed':\n      default:\n        // Keep the current (persisted / menu-chosen) plugin. `defaultPluginId`\n        // is only the INITIAL pick (see constructor); once the user chooses a\n        // saver via setPlugin/the menu it sticks across sleeps.\n        break;\n    }\n  }\n\n  private installDebugHook(): void {\n    if (!hasWindow) return;\n    (window as unknown as { __idleScreens?: unknown }).__idleScreens = {\n      sleep: () => this.forceSleep(),\n      wake: () => this.wake(),\n      toggle: () => this.toggle(),\n      setPlugin: (id: string) => this.setPlugin(id),\n      openMenu: () => this.openConfigMenu(),\n      closeMenu: () => this.closeConfigMenu(),\n      toggleMenu: () => this.toggleConfigMenu(),\n      state: () => this._state.value,\n      menuOpen: () => this._configMenuOpen.value,\n      active: () => this.activePlugin.value?.manifest.id ?? null,\n      plugins: this.pluginList,\n    };\n  }\n}\n","import { effect } from './reactive';\nimport { IdleScreensEngine } from './engine';\nimport { createRng } from './rng';\nimport type { IdleScreensConfig, PageContext, SaverInstance, SaverPlugin } from './types';\n\nconst STYLE = `\n  :host { all: initial; }\n  dialog.frame {\n    position: fixed; inset: 0; width: 100%; height: 100%;\n    max-width: none; max-height: none; margin: 0; border: 0; padding: 0;\n    background: #0a0a0f; overflow: hidden; cursor: none; color: #fff;\n  }\n  dialog.frame[open] { animation: ss-in 0.5s ease; }\n  dialog.frame.leaving { animation: ss-out 0.32s ease forwards; }\n  dialog.frame.reduced { animation: none; }\n  dialog.frame::backdrop { background: #0a0a0f; }\n  dialog.frame.passthrough, dialog.frame.passthrough::backdrop { background: transparent; }\n  @keyframes ss-in { from { opacity: 0; } to { opacity: 1; } }\n  @keyframes ss-out { from { opacity: 1; } to { opacity: 0; } }\n  .surface { position: absolute; inset: 0; display: block; width: 100%; height: 100%; }\n  .surface > canvas { display: block; width: 100%; height: 100%; }\n  .clock {\n    position: absolute; top: 10px; right: 12px; text-align: right;\n    font-family: 'Orbitron', system-ui, sans-serif; pointer-events: none;\n  }\n  .clock .day { font-size: 34px; opacity: 0.9; }\n  .clock .time { font-size: 54px; }\n  .hint {\n    position: fixed; bottom: 26px; left: 50%; transform: translateX(-50%);\n    color: rgba(230,230,230,0.6); font: 12px ui-monospace, monospace;\n    letter-spacing: 0.25em; text-transform: uppercase; opacity: 0;\n    transition: opacity 1s ease; pointer-events: none;\n  }\n  .hint.show { opacity: 1; }\n\n  /* Built-in config menu: a normal (interactive) centered dialog, distinct from\n     the cursor-hidden saver frame. */\n  dialog.menu {\n    position: fixed; inset: 0; margin: auto; border: 0; padding: 0;\n    width: min(420px, calc(100vw - 32px)); max-width: none;\n    background: transparent; color: #f2f2f5;\n  }\n  dialog.menu::backdrop { background: rgba(6,6,10,0.5); backdrop-filter: blur(2px); }\n  .menu-card {\n    background: #14141b; border: 1px solid rgba(255,255,255,0.12);\n    border-radius: 14px; padding: 20px; box-shadow: 0 24px 60px rgba(0,0,0,0.5);\n    font-family: system-ui, sans-serif;\n  }\n  .menu-title { font-size: 18px; font-weight: 600; margin: 0 0 14px; }\n  .menu-row { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 14px; }\n  .menu-row > span { font-size: 14px; opacity: 0.85; }\n  .menu-select {\n    flex: 1; max-width: 60%; padding: 7px 10px; border-radius: 8px;\n    background: #0d0d12; color: #f2f2f5; border: 1px solid rgba(255,255,255,0.16);\n    font-size: 14px;\n  }\n  .menu-actions { display: flex; justify-content: flex-end; }\n  .menu-close {\n    padding: 7px 16px; border-radius: 8px; cursor: pointer; font-size: 14px;\n    background: #2a2a37; color: #f2f2f5; border: 1px solid rgba(255,255,255,0.14);\n  }\n  .menu-close:hover { background: #34344a; }\n`;\n\n/** Node-safe base: during SSR/prerender there is no `HTMLElement`, and importing\n *  this module (for the engine/types) must not crash. The element is only ever\n *  constructed/registered in the browser. */\nconst HostBase: typeof HTMLElement =\n  typeof HTMLElement !== 'undefined'\n    ? HTMLElement\n    : (class {} as unknown as typeof HTMLElement);\n\n/**\n * `<idle-screen>` — the framework-agnostic overlay (port of the Angular\n * ScreensaverComponent). Owns the top-layer `<dialog>`, mounts the active saver\n * into a canvas, shows the clock + \"press any key\" hint, fades in/out, wakes on\n * input with a 450ms arm-guard, and goes transparent for passthrough savers.\n *\n * Configure by setting the `.config` and `.plugins` properties (Angular can do\n * this via `[config]` / `[plugins]` with CUSTOM_ELEMENTS_SCHEMA).\n */\nexport class IdleScreenElement extends HostBase {\n  private _engine: IdleScreensEngine | null = null;\n  private ownsEngine = false;\n  private _externalEngine: IdleScreensEngine | null = null;\n  private _config: Partial<IdleScreensConfig> | null = null;\n  private _plugins: SaverPlugin[] | null = null;\n\n  private dialog!: HTMLDialogElement;\n  private surface!: HTMLDivElement;\n  private clockEl!: HTMLDivElement;\n  private hintEl!: HTMLDivElement;\n  private menuDialog: HTMLDialogElement | null = null;\n  private menuSelect: HTMLSelectElement | null = null;\n  private menuBuilt = false;\n\n  private instance: SaverInstance | null = null;\n  private mountToken = 0;\n  private armed = false;\n  private armTimer: ReturnType<typeof setTimeout> | null = null;\n  private hintTimer: ReturnType<typeof setTimeout> | null = null;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  private disposers: Array<() => void> = [];\n\n  set config(c: Partial<IdleScreensConfig>) {\n    this._config = c;\n    this.maybeStart();\n  }\n  set plugins(p: SaverPlugin[]) {\n    this._plugins = p;\n    this.maybeStart();\n  }\n  /** Use an externally-owned, already-initialized engine (e.g. an Angular service\n   *  that also drives a config menu) instead of creating one from config+plugins. */\n  set engine(e: IdleScreensEngine) {\n    this._externalEngine = e;\n    this.maybeStart();\n  }\n  /** The live engine (for host code / tests). */\n  get idleEngine(): IdleScreensEngine | null {\n    return this._engine;\n  }\n\n  connectedCallback(): void {\n    if (!this.shadowRoot) this.buildDom();\n    this.maybeStart();\n  }\n\n  disconnectedCallback(): void {\n    this.teardown();\n  }\n\n  private buildDom(): void {\n    const root = this.attachShadow({ mode: 'open' });\n    const style = document.createElement('style');\n    style.textContent = STYLE;\n    this.dialog = document.createElement('dialog');\n    this.dialog.className = 'frame';\n    this.surface = document.createElement('div');\n    this.surface.className = 'surface';\n    this.clockEl = document.createElement('div');\n    this.clockEl.className = 'clock';\n    this.hintEl = document.createElement('div');\n    this.hintEl.className = 'hint';\n    this.hintEl.textContent = 'press any key';\n    this.dialog.append(this.surface, this.clockEl, this.hintEl);\n    root.append(style, this.dialog);\n\n    for (const ev of ['pointerdown', 'pointermove', 'keydown', 'wheel', 'touchstart'] as const) {\n      this.dialog.addEventListener(ev, () => this.onWakeInput(), { passive: true });\n    }\n    this.dialog.addEventListener('cancel', (e) => {\n      e.preventDefault();\n      this._engine?.wake();\n    });\n  }\n\n  private maybeStart(): void {\n    if (this._engine || !this.shadowRoot || typeof window === 'undefined') return;\n    if (this._externalEngine) {\n      this._engine = this._externalEngine; // caller owns lifecycle + init()\n      this.ownsEngine = false;\n    } else if (this._config && this._plugins) {\n      this._engine = new IdleScreensEngine(this._config, this._plugins);\n      this._engine.init();\n      this.ownsEngine = true;\n    } else {\n      return;\n    }\n    const eng = this._engine;\n\n    this.disposers.push(\n      effect(() => {\n        // Read reactive deps up front.\n        const sleeping = eng.isSleeping.value;\n        const active = eng.activePlugin.value;\n        const passthrough = eng.activeIsPassthrough.value;\n        if (sleeping && active) this.open(active, passthrough);\n        else this.close();\n      }),\n    );\n\n    // Clock chrome.\n    this.disposers.push(\n      effect(() => {\n        const show = this._engine!.config.showClock && !eng.activeIsPassthrough.value;\n        const now = eng.now.value;\n        this.clockEl.style.display = show && eng.isSleeping.value ? 'block' : 'none';\n        if (show) {\n          const day = now.toLocaleDateString(undefined, {\n            weekday: 'long',\n            month: 'long',\n            day: 'numeric',\n          });\n          const time = now.toLocaleTimeString();\n          this.clockEl.innerHTML = `<div class=\"day\">${day}</div><div class=\"time\">${time}</div>`;\n        }\n      }),\n    );\n\n    // Optional built-in config menu (saver picker), opened via engine hotkey/API.\n    if (eng.configMenu) {\n      this.buildMenu(eng.configMenu);\n      this.disposers.push(\n        effect(() => {\n          const open = eng.configMenuOpen.value;\n          const d = this.menuDialog;\n          if (!d) return;\n          if (open && !d.open) {\n            this.syncMenuSelection();\n            d.showModal();\n          } else if (!open && d.open) {\n            d.close();\n          }\n        }),\n      );\n      // Keep the picker in sync if the active saver changes elsewhere.\n      this.disposers.push(\n        effect(() => {\n          const id = eng.activePlugin.value?.manifest.id ?? '';\n          if (this.menuSelect && this.menuSelect.value !== id) this.menuSelect.value = id;\n        }),\n      );\n    }\n  }\n\n  private buildMenu(cfg: NonNullable<IdleScreensEngine['configMenu']>): void {\n    if (this.menuBuilt || !this.shadowRoot) return;\n    const eng = this._engine!;\n    const d = document.createElement('dialog');\n    d.className = 'menu';\n    const card = document.createElement('div');\n    card.className = 'menu-card';\n\n    const title = document.createElement('div');\n    title.className = 'menu-title';\n    title.textContent = cfg.title;\n    card.append(title);\n\n    if (cfg.showPicker) {\n      const row = document.createElement('label');\n      row.className = 'menu-row';\n      const label = document.createElement('span');\n      label.textContent = 'Saver';\n      const select = document.createElement('select');\n      select.className = 'menu-select';\n      for (const p of eng.pluginList) {\n        const opt = document.createElement('option');\n        opt.value = p.id;\n        opt.textContent = p.label;\n        select.append(opt);\n      }\n      select.addEventListener('change', () => {\n        eng.setPlugin(select.value);\n        if (cfg.previewOnPick) {\n          // Close the menu first so the saver isn't stacked behind this modal,\n          // then show the chosen saver right away.\n          eng.closeConfigMenu();\n          eng.forceSleep();\n        }\n      });\n      row.append(label, select);\n      card.append(row);\n      this.menuSelect = select;\n    }\n\n    const actions = document.createElement('div');\n    actions.className = 'menu-actions';\n    const close = document.createElement('button');\n    close.className = 'menu-close';\n    close.type = 'button';\n    close.textContent = 'Close';\n    close.addEventListener('click', () => eng.closeConfigMenu());\n    actions.append(close);\n    card.append(actions);\n\n    d.append(card);\n    // Escape and backdrop click both close (without waking the saver).\n    d.addEventListener('cancel', (e) => {\n      e.preventDefault();\n      eng.closeConfigMenu();\n    });\n    d.addEventListener('click', (e) => {\n      if (e.target === d) eng.closeConfigMenu();\n    });\n    this.shadowRoot.append(d);\n    this.menuDialog = d;\n    this.menuBuilt = true;\n  }\n\n  private syncMenuSelection(): void {\n    if (this.menuSelect) {\n      this.menuSelect.value = this._engine?.activePlugin.value?.manifest.id ?? '';\n    }\n  }\n\n  private pageContext(): PageContext {\n    return {\n      palette: () => [],\n      victims: (selector: string) =>\n        typeof document !== 'undefined'\n          ? Array.from(document.querySelectorAll<HTMLElement>(selector))\n          : [],\n    };\n  }\n\n  private async open(plugin: SaverPlugin, passthrough: boolean): Promise<void> {\n    const eng = this._engine!;\n    this.dialog.classList.toggle('passthrough', passthrough);\n    this.dialog.classList.toggle('reduced', eng.reducedMotion.value);\n    if (!this.dialog.open) {\n      this.dialog.classList.remove('leaving');\n      this.dialog.showModal();\n      this.arm();\n      this.scheduleHint();\n    }\n    // (Re)mount the active saver.\n    const token = ++this.mountToken;\n    await this.disposeInstance();\n    const w = window.innerWidth;\n    const h = window.innerHeight;\n    const seed = eng.config.seed >>> 0;\n    const inst = await plugin.mount({\n      host: this.surface,\n      width: w,\n      height: h,\n      rng: createRng(seed),\n      seed,\n      reducedMotion: eng.reducedMotion.value,\n      page: plugin.manifest.passthrough ? this.pageContext() : undefined,\n    });\n    if (token !== this.mountToken) {\n      inst.dispose(); // superseded while awaiting\n      return;\n    }\n    this.instance = inst;\n    inst.setPaused(eng.reducedMotion.value);\n  }\n\n  private close(): void {\n    if (!this.dialog?.open) return;\n    this.hintEl.classList.remove('show');\n    if (this.hintTimer) clearTimeout(this.hintTimer);\n    void this.disposeInstance();\n    const reduced = this._engine?.reducedMotion.value;\n    if (reduced) {\n      this.dialog.close();\n      return;\n    }\n    this.dialog.classList.add('leaving');\n    if (this.closeTimer) clearTimeout(this.closeTimer);\n    this.closeTimer = setTimeout(() => {\n      if (this.dialog.open) this.dialog.close();\n      this.dialog.classList.remove('leaving');\n    }, 320);\n  }\n\n  private async disposeInstance(): Promise<void> {\n    if (this.instance) {\n      this.instance.dispose();\n      this.instance = null;\n    }\n    this.surface?.replaceChildren(); // clear any saver DOM / canvas\n  }\n\n  private arm(): void {\n    this.armed = false;\n    if (this.armTimer) clearTimeout(this.armTimer);\n    this.armTimer = setTimeout(() => {\n      this.armed = true;\n    }, 450);\n  }\n\n  private scheduleHint(): void {\n    if (this.hintTimer) clearTimeout(this.hintTimer);\n    this.hintEl.classList.remove('show');\n    this.hintTimer = setTimeout(() => this.hintEl.classList.add('show'), 3000);\n  }\n\n  private onWakeInput(): void {\n    if (!this.armed) return; // grace period after sleeping\n    this._engine?.wake();\n  }\n\n  private teardown(): void {\n    void this.disposeInstance();\n    if (this.armTimer) clearTimeout(this.armTimer);\n    if (this.hintTimer) clearTimeout(this.hintTimer);\n    if (this.closeTimer) clearTimeout(this.closeTimer);\n    for (const d of this.disposers) d();\n    this.disposers = [];\n    if (this.ownsEngine) this._engine?.destroy(); // external engines are the caller's to destroy\n    this._engine = null;\n  }\n}\n\n/** Register the <idle-screen> custom element (idempotent). */\nexport function defineIdleScreen(tag = 'idle-screen'): void {\n  if (typeof customElements !== 'undefined' && !customElements.get(tag)) {\n    customElements.define(tag, IdleScreenElement);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@idle-screens/core",
+  "version": "0.1.0",
+  "description": "Engine, <idle-screen> custom element, plugin registry, seeded RNG, control-track, and types for idle-screens.",
+  "license": "MIT",
+  "author": "Shawn Partridge",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shaaaaawn/idle-screens",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/shaaaaawn/idle-screens#readme",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "screensaver",
+    "idle",
+    "ambient",
+    "web-components",
+    "canvas",
+    "custom-element"
+  ],
+  "bugs": {
+    "url": "https://github.com/shaaaaawn/idle-screens/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@preact/signals-core": "^1.8.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  }
+}