@idle-screens/schema 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/schema
+
+Declarative, agent-authorable saver format for idle-screens. Validate a data spec, then compile it into a runnable, seeded, flash-safe SaverPlugin.
+
+See the [idle-screens repository](https://github.com/shaaaaawn/idle-screens) for full documentation.

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+import { Rng, SaverPlugin, SaverManifest } from '@idle-screens/core';
+
+/**
+ * Declarative, agent-authorable saver format. A `SaverSpec` describes a saver as DATA
+ * (no code), which `compileSaver` turns into a seeded, deterministic, flash-safe
+ * SaverPlugin. It models the "drifting sprite field" family that covers most classic
+ * savers (fish, toasters, DVD, rain, messages): a static background plus one or more
+ * layers of entities that move.
+ *
+ * SAFETY INVARIANT: there is deliberately NO full-field strobe/flash primitive — the
+ * background is static and entities are bounded sprites — so a compiled spec cannot
+ * produce photosensitive flashing by construction (proven by sampling a compiled spec
+ * through @idle-screens/validator).
+ */
+declare const SCHEMA_VERSION: 1;
+interface SaverSpec {
+    schemaVersion: 1;
+    id: string;
+    label: string;
+    /** Deterministic seed; falls back to the host's SaverContext.seed. */
+    seed?: number;
+    background?: BackgroundSpec;
+    layers: LayerSpec[];
+    motionIntensity?: 'calm' | 'moderate' | 'energetic';
+}
+type BackgroundSpec = {
+    type: 'solid';
+    color: string;
+} | {
+    type: 'gradient';
+    stops: GradientStop[];
+    band?: BandSpec;
+};
+/** A vertical gradient stop (`at` 0 = top, 1 = bottom). */
+interface GradientStop {
+    at: number;
+    color: string;
+}
+/** An optional solid band at the bottom (e.g. an aquarium seafloor). */
+interface BandSpec {
+    color: string;
+    /** Band height in px. */
+    height: number;
+}
+interface LayerSpec {
+    count: number;
+    sprite: SpriteSpec;
+    /** Sprite size range in px (font size for emoji/text; ignored for circle). */
+    size?: [number, number];
+    motion: MotionSpec;
+    /** Wrap around the opposite edge when leaving the viewport. Default true. */
+    wrap?: boolean;
+    /** Flip the sprite horizontally to face its heading. Default false. */
+    flip?: boolean;
+}
+type SpriteSpec = {
+    kind: 'emoji';
+    glyphs: string[];
+} | {
+    kind: 'text';
+    strings: string[];
+    color?: string;
+    font?: string;
+} | {
+    kind: 'circle';
+    radius: [number, number];
+    color: string;
+};
+type MotionSpec = 
+/**
+ * Drift at a per-entity speed picked from `speed` (px/sec) along `angle` degrees
+ * (0 = right, 90 = down; default 0). `bidirectional` randomly flips horizontal
+ * direction per entity (e.g. fish swimming both ways); `bob` adds a small vertical
+ * wobble amplitude (px). Covers horizontal fields, diagonals (toasters) and rain
+ * (angle 90).
+ */
+{
+    type: 'drift';
+    speed: [number, number];
+    angle?: number;
+    bidirectional?: boolean;
+    bob?: number;
+}
+/** Rise upward (px/sec) with an optional horizontal sway amplitude (px) — bubbles. */
+ | {
+    type: 'rise';
+    speed: [number, number];
+    sway?: number;
+}
+/** Bounce diagonally at a per-entity speed, reflecting off the edges (px/sec). */
+ | {
+    type: 'bounce';
+    speed: [number, number];
+};
+/** A validation problem, pointing at a JSON path within the spec. */
+interface SpecError {
+    path: string;
+    message: string;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: SpecError[];
+}
+/** Perf/safety caps enforced by `validateSpec`. */
+declare const LIMITS: {
+    readonly maxPerLayer: 400;
+    readonly maxTotal: 800;
+    readonly maxLayers: 8;
+    readonly maxSpeed: 4000;
+};
+
+/**
+ * Validate an untrusted (agent- or JSON-authored) spec structurally + semantically.
+ * Returns typed errors; never throws. `compileSaver` refuses to run an invalid spec.
+ */
+declare function validateSpec(spec: unknown): ValidationResult;
+/** Narrowing helper: validate + cast. Throws with a joined message when invalid. */
+declare function assertValidSpec(spec: unknown): SaverSpec;
+
+/** A seeded entity: initial state + resolved velocity. `positionAt` is a pure function
+ *  of this + time, so the rAF loop and renderFrame(t) produce identical results. */
+interface Entity {
+    x0: number;
+    y0: number;
+    size: number;
+    spriteIndex: number;
+    phase: number;
+    vx: number;
+    vy: number;
+    bob: number;
+    motion: 'drift' | 'rise' | 'bounce';
+    headingLeft: boolean;
+}
+interface Placed {
+    x: number;
+    y: number;
+    flip: boolean;
+}
+declare function spriteVariants(sprite: SpriteSpec): number;
+/** Deterministically place a layer's entities using the seeded RNG (never Math.random). */
+declare function buildEntities(layer: LayerSpec, rng: Rng, w: number, h: number): Entity[];
+/** Analytic position of an entity at logical time `t` (ms). Pure & deterministic. */
+declare function positionAt(e: Entity, t: number, w: number, h: number): Placed;
+
+/** Derive a manifest so a compiled spec composes with @idle-screens/capabilities. */
+declare function manifestFor(spec: SaverSpec): SaverManifest;
+/**
+ * Compile a declarative spec into a runnable SaverPlugin. Throws if the spec is invalid
+ * (so an agent-authored spec is validated before it can run). The result is seeded,
+ * deterministic, `renderFrame(t,seed)`-addressable, and flash-safe by construction.
+ */
+declare function compileSaver(spec: unknown): SaverPlugin;
+
+/**
+ * Reproduces the hand-coded Fish Aquarium saver as pure DATA — the discriminating test
+ * that the schema is actually expressive: two layers (fish drifting both ways at varied
+ * speeds with a bob + flip, over a gradient with a seafloor band; bubbles rising with sway).
+ */
+declare const AQUARIUM_SPEC: SaverSpec;
+/** Rain: dense text streaks falling straight down over a near-black sky. */
+declare const RAIN_SPEC: SaverSpec;
+declare const EXAMPLE_SPECS: SaverSpec[];
+
+export { AQUARIUM_SPEC, type BackgroundSpec, type BandSpec, EXAMPLE_SPECS, type Entity, type GradientStop, LIMITS, type LayerSpec, type MotionSpec, type Placed, RAIN_SPEC, SCHEMA_VERSION, type SaverSpec, type SpecError, type SpriteSpec, type ValidationResult, assertValidSpec, buildEntities, compileSaver, manifestFor, positionAt, spriteVariants, validateSpec };

package/dist/index.js

@@ -0,0 +1,432 @@
+// src/types.ts
+var SCHEMA_VERSION = 1;
+var LIMITS = {
+  maxPerLayer: 400,
+  maxTotal: 800,
+  maxLayers: 8,
+  maxSpeed: 4e3
+  // px/sec — bounds motion so nothing teleports
+};
+
+// src/validate.ts
+var HEX = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
+var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isStr = (v) => typeof v === "string";
+var isNum = (v) => typeof v === "number" && Number.isFinite(v);
+var isRange = (v) => Array.isArray(v) && v.length === 2 && isNum(v[0]) && isNum(v[1]) && v[0] <= v[1];
+function validateSpec(spec) {
+  const errors = [];
+  const err = (path, message) => void errors.push({ path, message });
+  if (!isObj(spec)) return { valid: false, errors: [{ path: "", message: "spec must be an object" }] };
+  if (spec.schemaVersion !== SCHEMA_VERSION) err("schemaVersion", `must be ${SCHEMA_VERSION}`);
+  if (!isStr(spec.id) || spec.id.trim() === "") err("id", "must be a non-empty string");
+  if (!isStr(spec.label) || spec.label.trim() === "") err("label", "must be a non-empty string");
+  if (spec.seed !== void 0 && !isNum(spec.seed)) err("seed", "must be a number");
+  if (spec.motionIntensity !== void 0 && !["calm", "moderate", "energetic"].includes(spec.motionIntensity)) {
+    err("motionIntensity", "must be calm | moderate | energetic");
+  }
+  if (spec.background !== void 0) validateBackground(spec.background, err);
+  if (!Array.isArray(spec.layers) || spec.layers.length === 0) {
+    err("layers", "must be a non-empty array");
+  } else {
+    if (spec.layers.length > LIMITS.maxLayers) err("layers", `at most ${LIMITS.maxLayers} layers`);
+    let total = 0;
+    spec.layers.forEach((layer, i) => {
+      total += isObj(layer) && isNum(layer.count) ? layer.count : 0;
+      validateLayer(layer, `layers[${i}]`, err);
+    });
+    if (total > LIMITS.maxTotal) err("layers", `total entities ${total} exceeds cap ${LIMITS.maxTotal}`);
+  }
+  return { valid: errors.length === 0, errors };
+}
+function color(v, path, err) {
+  if (!isStr(v) || !HEX.test(v)) err(path, "must be a hex colour like #0a3a52");
+}
+function validateBackground(bg, err) {
+  if (!isObj(bg)) return err("background", "must be an object");
+  if (bg.type === "solid") {
+    color(bg.color, "background.color", err);
+  } else if (bg.type === "gradient") {
+    if (!Array.isArray(bg.stops) || bg.stops.length < 2) {
+      err("background.stops", "gradient needs at least 2 stops");
+    } else {
+      bg.stops.forEach((s, i) => {
+        if (!isObj(s) || !isNum(s.at) || s.at < 0 || s.at > 1) err(`background.stops[${i}].at`, "must be 0..1");
+        color(isObj(s) ? s.color : void 0, `background.stops[${i}].color`, err);
+      });
+    }
+    if (bg.band !== void 0) {
+      if (!isObj(bg.band)) err("background.band", "must be an object");
+      else {
+        color(bg.band.color, "background.band.color", err);
+        if (!isNum(bg.band.height) || bg.band.height <= 0) err("background.band.height", "must be > 0");
+      }
+    }
+  } else {
+    err("background.type", "must be solid | gradient");
+  }
+}
+function validateLayer(layer, path, err) {
+  if (!isObj(layer)) return err(path, "must be an object");
+  if (!isNum(layer.count) || !Number.isInteger(layer.count) || layer.count < 1) {
+    err(`${path}.count`, "must be a positive integer");
+  } else if (layer.count > LIMITS.maxPerLayer) {
+    err(`${path}.count`, `at most ${LIMITS.maxPerLayer} per layer`);
+  }
+  if (layer.size !== void 0 && (!isRange(layer.size) || layer.size[0] <= 0)) {
+    err(`${path}.size`, "must be a [min,max] range of positive px");
+  }
+  if (layer.wrap !== void 0 && typeof layer.wrap !== "boolean") err(`${path}.wrap`, "must be a boolean");
+  if (layer.flip !== void 0 && typeof layer.flip !== "boolean") err(`${path}.flip`, "must be a boolean");
+  validateSprite(layer.sprite, `${path}.sprite`, err);
+  validateMotion(layer.motion, `${path}.motion`, err);
+}
+function validateSprite(sprite, path, err) {
+  if (!isObj(sprite)) return err(path, "must be an object");
+  if (sprite.kind === "emoji") {
+    if (!Array.isArray(sprite.glyphs) || sprite.glyphs.length === 0 || !sprite.glyphs.every(isStr)) {
+      err(`${path}.glyphs`, "must be a non-empty array of strings");
+    }
+  } else if (sprite.kind === "text") {
+    if (!Array.isArray(sprite.strings) || sprite.strings.length === 0 || !sprite.strings.every(isStr)) {
+      err(`${path}.strings`, "must be a non-empty array of strings");
+    }
+    if (sprite.color !== void 0) color(sprite.color, `${path}.color`, err);
+  } else if (sprite.kind === "circle") {
+    if (!isRange(sprite.radius) || sprite.radius[0] <= 0) err(`${path}.radius`, "must be a [min,max] range of positive px");
+    color(sprite.color, `${path}.color`, err);
+  } else {
+    err(`${path}.kind`, "must be emoji | text | circle");
+  }
+}
+function validateMotion(motion, path, err) {
+  if (!isObj(motion)) return err(path, "must be an object");
+  const speedOk = (v, p) => {
+    if (!isRange(v)) err(p, "must be a [min,max] range");
+    else if (v[1] > LIMITS.maxSpeed) err(p, `speed exceeds cap ${LIMITS.maxSpeed} px/sec`);
+  };
+  if (motion.type === "drift") {
+    speedOk(motion.speed, `${path}.speed`);
+    if (motion.angle !== void 0 && !isNum(motion.angle)) err(`${path}.angle`, "must be a number (degrees)");
+    if (motion.bidirectional !== void 0 && typeof motion.bidirectional !== "boolean") err(`${path}.bidirectional`, "must be a boolean");
+    if (motion.bob !== void 0 && !isNum(motion.bob)) err(`${path}.bob`, "must be a number");
+  } else if (motion.type === "rise") {
+    speedOk(motion.speed, `${path}.speed`);
+    if (motion.sway !== void 0 && !isNum(motion.sway)) err(`${path}.sway`, "must be a number");
+  } else if (motion.type === "bounce") {
+    speedOk(motion.speed, `${path}.speed`);
+  } else {
+    err(`${path}.type`, "must be drift | rise | bounce");
+  }
+}
+function assertValidSpec(spec) {
+  const r = validateSpec(spec);
+  if (!r.valid) {
+    throw new Error(`invalid saver spec:
+${r.errors.map((e) => `  ${e.path || "<root>"}: ${e.message}`).join("\n")}`);
+  }
+  return spec;
+}
+
+// src/simulate.ts
+function spriteVariants(sprite) {
+  if (sprite.kind === "emoji") return sprite.glyphs.length;
+  if (sprite.kind === "text") return sprite.strings.length;
+  return 1;
+}
+function buildEntities(layer, rng, w, h) {
+  const [smin, smax] = layer.size ?? [20, 40];
+  const variants = spriteVariants(layer.sprite);
+  const out = [];
+  for (let i = 0; i < layer.count; i++) {
+    const size = layer.sprite.kind === "circle" ? rng.range(layer.sprite.radius[0], layer.sprite.radius[1]) * 2 : rng.range(smin, smax);
+    let vx = 0;
+    let vy = 0;
+    let bob = 0;
+    let motion = "drift";
+    const m = layer.motion;
+    if (m.type === "drift") {
+      const s = rng.range(m.speed[0], m.speed[1]);
+      let angle = (m.angle ?? 0) * Math.PI / 180;
+      if (m.bidirectional && rng.next() < 0.5) angle = Math.PI - angle;
+      vx = s * Math.cos(angle);
+      vy = s * Math.sin(angle);
+      bob = m.bob ?? 0;
+    } else if (m.type === "rise") {
+      motion = "rise";
+      vy = -rng.range(m.speed[0], m.speed[1]);
+      bob = m.sway ?? 0;
+    } else {
+      motion = "bounce";
+      const s = rng.range(m.speed[0], m.speed[1]);
+      const a = rng.range(0, Math.PI * 2);
+      vx = s * Math.cos(a);
+      vy = s * Math.sin(a);
+    }
+    out.push({
+      x0: rng.range(0, w),
+      y0: rng.range(0, h),
+      size,
+      spriteIndex: variants > 1 ? rng.int(0, variants - 1) : 0,
+      phase: rng.range(0, Math.PI * 2),
+      vx,
+      vy,
+      bob,
+      motion,
+      headingLeft: vx < 0
+    });
+  }
+  return out;
+}
+function wrap(v, min, max) {
+  const range = max - min;
+  return ((v - min) % range + range) % range + min;
+}
+function reflect(v, min, max) {
+  const range = max - min;
+  if (range <= 0) return min;
+  const period = 2 * range;
+  const p = ((v - min) % period + period) % period;
+  return min + (p < range ? p : period - p);
+}
+function positionAt(e, t, w, h) {
+  const dt = t / 1e3;
+  const m = e.size;
+  if (e.motion === "bounce") {
+    return {
+      x: reflect(e.x0 + e.vx * dt, m / 2, w - m / 2),
+      y: reflect(e.y0 + e.vy * dt, m / 2, h - m / 2),
+      flip: false
+    };
+  }
+  if (e.motion === "rise") {
+    return {
+      x: e.x0 + (e.bob ? e.bob * Math.sin(t / 700 + e.phase) : 0),
+      y: wrap(e.y0 + e.vy * dt, -m, h + m),
+      flip: false
+    };
+  }
+  const x = wrap(e.x0 + e.vx * dt, -m, w + m);
+  let y = e.vy !== 0 ? wrap(e.y0 + e.vy * dt, -m, h + m) : e.y0;
+  if (e.bob) y += e.bob * Math.sin(t / 500 + e.phase);
+  return { x, y, flip: e.headingLeft };
+}
+
+// src/compile.ts
+import {
+  createRng
+} from "@idle-screens/core";
+function manifestFor(spec) {
+  const total = spec.layers.reduce((n, l) => n + l.count, 0);
+  const costTier = total < 30 ? "idle" : total < 150 ? "low" : total < 400 ? "medium" : "high";
+  return {
+    id: spec.id,
+    label: spec.label,
+    passthrough: false,
+    minBackend: "canvas2d",
+    costTier,
+    motionIntensity: spec.motionIntensity ?? "moderate",
+    reducedMotionFallback: "static",
+    // Flash-safe by construction: static background + bounded sprites, no strobe
+    // primitive. Proven by sampling a compiled spec through @idle-screens/validator.
+    a11y: { flashSafe: true }
+  };
+}
+var SpecInstance = class {
+  constructor(spec, ctx) {
+    this.spec = spec;
+    this.seed = (spec.seed ?? ctx.seed) >>> 0 || 1;
+    const canvas = document.createElement("canvas");
+    canvas.style.cssText = "display:block;width:100%;height:100%";
+    canvas.setAttribute("aria-hidden", "true");
+    ctx.host.appendChild(canvas);
+    this.canvas = canvas;
+    const c2d = canvas.getContext("2d", { alpha: false });
+    if (!c2d) throw new Error("schema saver: no 2d context");
+    this.ctx = c2d;
+    this.w = ctx.width;
+    this.h = ctx.height;
+    this.sizeCanvas();
+    this.rebuild();
+    this.paused = ctx.reducedMotion;
+    if (this.paused) this.renderFrame(0, this.seed);
+    else this.start();
+  }
+  spec;
+  canvas;
+  ctx;
+  seed;
+  w;
+  h;
+  layers = [];
+  frameId = null;
+  paused = false;
+  startT = 0;
+  sizeCanvas() {
+    const dpr = Math.min(typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1, 2);
+    this.canvas.width = Math.max(1, Math.round(this.w * dpr));
+    this.canvas.height = Math.max(1, Math.round(this.h * dpr));
+    this.ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+  }
+  /** (Re)seed and place all entities — deterministic for the seed + size. */
+  rebuild() {
+    const rng = createRng(this.seed);
+    this.layers = this.spec.layers.map((layer) => ({ layer, entities: buildEntities(layer, rng, this.w, this.h) }));
+  }
+  start() {
+    if (this.frameId !== null || typeof requestAnimationFrame === "undefined") return;
+    this.startT = 0;
+    this.frameId = requestAnimationFrame((now) => this.loop(now));
+  }
+  stop() {
+    if (this.frameId !== null) {
+      cancelAnimationFrame(this.frameId);
+      this.frameId = null;
+    }
+  }
+  loop(now) {
+    this.frameId = requestAnimationFrame((n) => this.loop(n));
+    if (this.startT === 0) this.startT = now;
+    this.renderFrame(now - this.startT, this.seed);
+  }
+  drawBackground() {
+    const { ctx, w, h } = this;
+    const bg = this.spec.background;
+    if (!bg || bg.type === "solid") {
+      ctx.fillStyle = bg?.color ?? "#05050a";
+      ctx.fillRect(0, 0, w, h);
+      return;
+    }
+    const g = ctx.createLinearGradient(0, 0, 0, h);
+    for (const s of bg.stops) g.addColorStop(Math.max(0, Math.min(1, s.at)), s.color);
+    ctx.fillStyle = g;
+    ctx.fillRect(0, 0, w, h);
+    if (bg.band) {
+      ctx.fillStyle = bg.band.color;
+      ctx.fillRect(0, h - bg.band.height, w, bg.band.height);
+    }
+  }
+  drawEntity(built, e, t) {
+    const { ctx } = this;
+    const p = positionAt(e, t, this.w, this.h);
+    const sprite = built.layer.sprite;
+    if (sprite.kind === "circle") {
+      ctx.fillStyle = sprite.color;
+      ctx.beginPath();
+      ctx.arc(p.x, p.y, e.size / 2, 0, Math.PI * 2);
+      ctx.fill();
+      return;
+    }
+    ctx.save();
+    ctx.translate(p.x, p.y);
+    if (p.flip && built.layer.flip) ctx.scale(-1, 1);
+    ctx.textAlign = "center";
+    ctx.textBaseline = "middle";
+    if (sprite.kind === "emoji") {
+      ctx.font = `${e.size}px serif`;
+      ctx.fillText(sprite.glyphs[e.spriteIndex] ?? sprite.glyphs[0], 0, 0);
+    } else {
+      ctx.font = sprite.font ?? `${e.size}px system-ui, sans-serif`;
+      ctx.fillStyle = sprite.color ?? "#e6e8ef";
+      ctx.fillText(sprite.strings[e.spriteIndex] ?? sprite.strings[0], 0, 0);
+    }
+    ctx.restore();
+  }
+  /** Deterministic, frame-addressable render (shared by the rAF loop). */
+  renderFrame(t, _seed) {
+    this.drawBackground();
+    for (const built of this.layers) {
+      for (const e of built.entities) this.drawEntity(built, e, t);
+    }
+  }
+  setPaused(paused) {
+    this.paused = paused;
+    if (paused) {
+      this.stop();
+    } else {
+      this.start();
+    }
+  }
+  resize(width, height) {
+    this.w = width;
+    this.h = height;
+    this.sizeCanvas();
+    this.rebuild();
+    if (this.paused) this.renderFrame(0, this.seed);
+  }
+  dispose() {
+    this.stop();
+    this.canvas.remove();
+  }
+};
+function compileSaver(spec) {
+  const valid = assertValidSpec(spec);
+  return {
+    manifest: manifestFor(valid),
+    mount: (ctx) => new SpecInstance(valid, ctx)
+  };
+}
+
+// src/examples.ts
+var AQUARIUM_SPEC = {
+  schemaVersion: 1,
+  id: "aquarium",
+  label: "Aquarium (declarative)",
+  seed: 42,
+  motionIntensity: "calm",
+  background: {
+    type: "gradient",
+    stops: [
+      { at: 0, color: "#0a3a52" },
+      { at: 0.6, color: "#062534" },
+      { at: 1, color: "#02141d" }
+    ],
+    band: { color: "#0b1a12", height: 24 }
+  },
+  layers: [
+    {
+      count: 14,
+      sprite: { kind: "emoji", glyphs: ["\u{1F41F}", "\u{1F420}", "\u{1F421}", "\u{1F988}", "\u{1F419}"] },
+      size: [34, 72],
+      motion: { type: "drift", speed: [30, 110], bidirectional: true, bob: 6 },
+      flip: true
+    },
+    {
+      count: 22,
+      sprite: { kind: "circle", radius: [2, 7], color: "#c8ebff" },
+      motion: { type: "rise", speed: [24, 78], sway: 8 }
+    }
+  ]
+};
+var RAIN_SPEC = {
+  schemaVersion: 1,
+  id: "rain",
+  label: "Rain (declarative)",
+  seed: 7,
+  motionIntensity: "moderate",
+  background: { type: "solid", color: "#05070a" },
+  layers: [
+    {
+      count: 140,
+      sprite: { kind: "text", strings: ["\u2502"], color: "#9fd0ff" },
+      size: [12, 26],
+      motion: { type: "drift", angle: 90, speed: [520, 900] }
+    }
+  ]
+};
+var EXAMPLE_SPECS = [AQUARIUM_SPEC, RAIN_SPEC];
+export {
+  AQUARIUM_SPEC,
+  EXAMPLE_SPECS,
+  LIMITS,
+  RAIN_SPEC,
+  SCHEMA_VERSION,
+  assertValidSpec,
+  buildEntities,
+  compileSaver,
+  manifestFor,
+  positionAt,
+  spriteVariants,
+  validateSpec
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/validate.ts","../src/simulate.ts","../src/compile.ts","../src/examples.ts"],"sourcesContent":["/**\n * Declarative, agent-authorable saver format. A `SaverSpec` describes a saver as DATA\n * (no code), which `compileSaver` turns into a seeded, deterministic, flash-safe\n * SaverPlugin. It models the \"drifting sprite field\" family that covers most classic\n * savers (fish, toasters, DVD, rain, messages): a static background plus one or more\n * layers of entities that move.\n *\n * SAFETY INVARIANT: there is deliberately NO full-field strobe/flash primitive — the\n * background is static and entities are bounded sprites — so a compiled spec cannot\n * produce photosensitive flashing by construction (proven by sampling a compiled spec\n * through @idle-screens/validator).\n */\nexport const SCHEMA_VERSION = 1 as const;\n\nexport interface SaverSpec {\n  schemaVersion: 1;\n  id: string;\n  label: string;\n  /** Deterministic seed; falls back to the host's SaverContext.seed. */\n  seed?: number;\n  background?: BackgroundSpec;\n  layers: LayerSpec[];\n  motionIntensity?: 'calm' | 'moderate' | 'energetic';\n}\n\nexport type BackgroundSpec =\n  | { type: 'solid'; color: string }\n  | { type: 'gradient'; stops: GradientStop[]; band?: BandSpec };\n\n/** A vertical gradient stop (`at` 0 = top, 1 = bottom). */\nexport interface GradientStop {\n  at: number;\n  color: string;\n}\n\n/** An optional solid band at the bottom (e.g. an aquarium seafloor). */\nexport interface BandSpec {\n  color: string;\n  /** Band height in px. */\n  height: number;\n}\n\nexport interface LayerSpec {\n  count: number;\n  sprite: SpriteSpec;\n  /** Sprite size range in px (font size for emoji/text; ignored for circle). */\n  size?: [number, number];\n  motion: MotionSpec;\n  /** Wrap around the opposite edge when leaving the viewport. Default true. */\n  wrap?: boolean;\n  /** Flip the sprite horizontally to face its heading. Default false. */\n  flip?: boolean;\n}\n\nexport type SpriteSpec =\n  | { kind: 'emoji'; glyphs: string[] }\n  | { kind: 'text'; strings: string[]; color?: string; font?: string }\n  | { kind: 'circle'; radius: [number, number]; color: string };\n\nexport type MotionSpec =\n  /**\n   * Drift at a per-entity speed picked from `speed` (px/sec) along `angle` degrees\n   * (0 = right, 90 = down; default 0). `bidirectional` randomly flips horizontal\n   * direction per entity (e.g. fish swimming both ways); `bob` adds a small vertical\n   * wobble amplitude (px). Covers horizontal fields, diagonals (toasters) and rain\n   * (angle 90).\n   */\n  | { type: 'drift'; speed: [number, number]; angle?: number; bidirectional?: boolean; bob?: number }\n  /** Rise upward (px/sec) with an optional horizontal sway amplitude (px) — bubbles. */\n  | { type: 'rise'; speed: [number, number]; sway?: number }\n  /** Bounce diagonally at a per-entity speed, reflecting off the edges (px/sec). */\n  | { type: 'bounce'; speed: [number, number] };\n\n/** A validation problem, pointing at a JSON path within the spec. */\nexport interface SpecError {\n  path: string;\n  message: string;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: SpecError[];\n}\n\n/** Perf/safety caps enforced by `validateSpec`. */\nexport const LIMITS = {\n  maxPerLayer: 400,\n  maxTotal: 800,\n  maxLayers: 8,\n  maxSpeed: 4000, // px/sec — bounds motion so nothing teleports\n} as const;\n","import { LIMITS, SCHEMA_VERSION, type SaverSpec, type SpecError, type ValidationResult } from './types';\n\nconst HEX = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;\nconst isObj = (v: unknown): v is Record<string, unknown> => typeof v === 'object' && v !== null && !Array.isArray(v);\nconst isStr = (v: unknown): v is string => typeof v === 'string';\nconst isNum = (v: unknown): v is number => typeof v === 'number' && Number.isFinite(v);\nconst isRange = (v: unknown): v is [number, number] =>\n  Array.isArray(v) && v.length === 2 && isNum(v[0]) && isNum(v[1]) && v[0] <= v[1];\n\n/**\n * Validate an untrusted (agent- or JSON-authored) spec structurally + semantically.\n * Returns typed errors; never throws. `compileSaver` refuses to run an invalid spec.\n */\nexport function validateSpec(spec: unknown): ValidationResult {\n  const errors: SpecError[] = [];\n  const err = (path: string, message: string): void => void errors.push({ path, message });\n\n  if (!isObj(spec)) return { valid: false, errors: [{ path: '', message: 'spec must be an object' }] };\n\n  if (spec.schemaVersion !== SCHEMA_VERSION) err('schemaVersion', `must be ${SCHEMA_VERSION}`);\n  if (!isStr(spec.id) || spec.id.trim() === '') err('id', 'must be a non-empty string');\n  if (!isStr(spec.label) || spec.label.trim() === '') err('label', 'must be a non-empty string');\n  if (spec.seed !== undefined && !isNum(spec.seed)) err('seed', 'must be a number');\n  if (spec.motionIntensity !== undefined && !['calm', 'moderate', 'energetic'].includes(spec.motionIntensity as string)) {\n    err('motionIntensity', 'must be calm | moderate | energetic');\n  }\n\n  if (spec.background !== undefined) validateBackground(spec.background, err);\n\n  if (!Array.isArray(spec.layers) || spec.layers.length === 0) {\n    err('layers', 'must be a non-empty array');\n  } else {\n    if (spec.layers.length > LIMITS.maxLayers) err('layers', `at most ${LIMITS.maxLayers} layers`);\n    let total = 0;\n    spec.layers.forEach((layer, i) => {\n      total += isObj(layer) && isNum(layer.count) ? layer.count : 0;\n      validateLayer(layer, `layers[${i}]`, err);\n    });\n    if (total > LIMITS.maxTotal) err('layers', `total entities ${total} exceeds cap ${LIMITS.maxTotal}`);\n  }\n\n  return { valid: errors.length === 0, errors };\n}\n\nfunction color(v: unknown, path: string, err: (p: string, m: string) => void): void {\n  if (!isStr(v) || !HEX.test(v)) err(path, 'must be a hex colour like #0a3a52');\n}\n\nfunction validateBackground(bg: unknown, err: (p: string, m: string) => void): void {\n  if (!isObj(bg)) return err('background', 'must be an object');\n  if (bg.type === 'solid') {\n    color(bg.color, 'background.color', err);\n  } else if (bg.type === 'gradient') {\n    if (!Array.isArray(bg.stops) || bg.stops.length < 2) {\n      err('background.stops', 'gradient needs at least 2 stops');\n    } else {\n      bg.stops.forEach((s, i) => {\n        if (!isObj(s) || !isNum(s.at) || s.at < 0 || s.at > 1) err(`background.stops[${i}].at`, 'must be 0..1');\n        color(isObj(s) ? s.color : undefined, `background.stops[${i}].color`, err);\n      });\n    }\n    if (bg.band !== undefined) {\n      if (!isObj(bg.band)) err('background.band', 'must be an object');\n      else {\n        color(bg.band.color, 'background.band.color', err);\n        if (!isNum(bg.band.height) || bg.band.height <= 0) err('background.band.height', 'must be > 0');\n      }\n    }\n  } else {\n    err('background.type', 'must be solid | gradient');\n  }\n}\n\nfunction validateLayer(layer: unknown, path: string, err: (p: string, m: string) => void): void {\n  if (!isObj(layer)) return err(path, 'must be an object');\n  if (!isNum(layer.count) || !Number.isInteger(layer.count) || layer.count < 1) {\n    err(`${path}.count`, 'must be a positive integer');\n  } else if (layer.count > LIMITS.maxPerLayer) {\n    err(`${path}.count`, `at most ${LIMITS.maxPerLayer} per layer`);\n  }\n  if (layer.size !== undefined && (!isRange(layer.size) || layer.size[0] <= 0)) {\n    err(`${path}.size`, 'must be a [min,max] range of positive px');\n  }\n  if (layer.wrap !== undefined && typeof layer.wrap !== 'boolean') err(`${path}.wrap`, 'must be a boolean');\n  if (layer.flip !== undefined && typeof layer.flip !== 'boolean') err(`${path}.flip`, 'must be a boolean');\n\n  validateSprite(layer.sprite, `${path}.sprite`, err);\n  validateMotion(layer.motion, `${path}.motion`, err);\n}\n\nfunction validateSprite(sprite: unknown, path: string, err: (p: string, m: string) => void): void {\n  if (!isObj(sprite)) return err(path, 'must be an object');\n  if (sprite.kind === 'emoji') {\n    if (!Array.isArray(sprite.glyphs) || sprite.glyphs.length === 0 || !sprite.glyphs.every(isStr)) {\n      err(`${path}.glyphs`, 'must be a non-empty array of strings');\n    }\n  } else if (sprite.kind === 'text') {\n    if (!Array.isArray(sprite.strings) || sprite.strings.length === 0 || !sprite.strings.every(isStr)) {\n      err(`${path}.strings`, 'must be a non-empty array of strings');\n    }\n    if (sprite.color !== undefined) color(sprite.color, `${path}.color`, err);\n  } else if (sprite.kind === 'circle') {\n    if (!isRange(sprite.radius) || sprite.radius[0] <= 0) err(`${path}.radius`, 'must be a [min,max] range of positive px');\n    color(sprite.color, `${path}.color`, err);\n  } else {\n    err(`${path}.kind`, 'must be emoji | text | circle');\n  }\n}\n\nfunction validateMotion(motion: unknown, path: string, err: (p: string, m: string) => void): void {\n  if (!isObj(motion)) return err(path, 'must be an object');\n  const speedOk = (v: unknown, p: string): void => {\n    if (!isRange(v)) err(p, 'must be a [min,max] range');\n    else if (v[1] > LIMITS.maxSpeed) err(p, `speed exceeds cap ${LIMITS.maxSpeed} px/sec`);\n  };\n  if (motion.type === 'drift') {\n    speedOk(motion.speed, `${path}.speed`);\n    if (motion.angle !== undefined && !isNum(motion.angle)) err(`${path}.angle`, 'must be a number (degrees)');\n    if (motion.bidirectional !== undefined && typeof motion.bidirectional !== 'boolean') err(`${path}.bidirectional`, 'must be a boolean');\n    if (motion.bob !== undefined && !isNum(motion.bob)) err(`${path}.bob`, 'must be a number');\n  } else if (motion.type === 'rise') {\n    speedOk(motion.speed, `${path}.speed`);\n    if (motion.sway !== undefined && !isNum(motion.sway)) err(`${path}.sway`, 'must be a number');\n  } else if (motion.type === 'bounce') {\n    speedOk(motion.speed, `${path}.speed`);\n  } else {\n    err(`${path}.type`, 'must be drift | rise | bounce');\n  }\n}\n\n/** Narrowing helper: validate + cast. Throws with a joined message when invalid. */\nexport function assertValidSpec(spec: unknown): SaverSpec {\n  const r = validateSpec(spec);\n  if (!r.valid) {\n    throw new Error(`invalid saver spec:\\n${r.errors.map((e) => `  ${e.path || '<root>'}: ${e.message}`).join('\\n')}`);\n  }\n  return spec as SaverSpec;\n}\n","import type { Rng } from '@idle-screens/core';\nimport type { LayerSpec, SpriteSpec } from './types';\n\n/** A seeded entity: initial state + resolved velocity. `positionAt` is a pure function\n *  of this + time, so the rAF loop and renderFrame(t) produce identical results. */\nexport interface Entity {\n  x0: number;\n  y0: number;\n  size: number;\n  spriteIndex: number;\n  phase: number;\n  vx: number; // px/sec\n  vy: number; // px/sec\n  bob: number; // vertical bob / horizontal sway amplitude (px)\n  motion: 'drift' | 'rise' | 'bounce';\n  headingLeft: boolean;\n}\n\nexport interface Placed {\n  x: number;\n  y: number;\n  flip: boolean;\n}\n\nexport function spriteVariants(sprite: SpriteSpec): number {\n  if (sprite.kind === 'emoji') return sprite.glyphs.length;\n  if (sprite.kind === 'text') return sprite.strings.length;\n  return 1;\n}\n\n/** Deterministically place a layer's entities using the seeded RNG (never Math.random). */\nexport function buildEntities(layer: LayerSpec, rng: Rng, w: number, h: number): Entity[] {\n  const [smin, smax] = layer.size ?? [20, 40];\n  const variants = spriteVariants(layer.sprite);\n  const out: Entity[] = [];\n  for (let i = 0; i < layer.count; i++) {\n    const size =\n      layer.sprite.kind === 'circle'\n        ? rng.range(layer.sprite.radius[0], layer.sprite.radius[1]) * 2\n        : rng.range(smin, smax);\n\n    let vx = 0;\n    let vy = 0;\n    let bob = 0;\n    let motion: Entity['motion'] = 'drift';\n    const m = layer.motion;\n    if (m.type === 'drift') {\n      const s = rng.range(m.speed[0], m.speed[1]);\n      let angle = ((m.angle ?? 0) * Math.PI) / 180;\n      if (m.bidirectional && rng.next() < 0.5) angle = Math.PI - angle;\n      vx = s * Math.cos(angle);\n      vy = s * Math.sin(angle);\n      bob = m.bob ?? 0;\n    } else if (m.type === 'rise') {\n      motion = 'rise';\n      vy = -rng.range(m.speed[0], m.speed[1]); // upward\n      bob = m.sway ?? 0;\n    } else {\n      motion = 'bounce';\n      const s = rng.range(m.speed[0], m.speed[1]);\n      const a = rng.range(0, Math.PI * 2);\n      vx = s * Math.cos(a);\n      vy = s * Math.sin(a);\n    }\n\n    out.push({\n      x0: rng.range(0, w),\n      y0: rng.range(0, h),\n      size,\n      spriteIndex: variants > 1 ? rng.int(0, variants - 1) : 0,\n      phase: rng.range(0, Math.PI * 2),\n      vx,\n      vy,\n      bob,\n      motion,\n      headingLeft: vx < 0,\n    });\n  }\n  return out;\n}\n\nfunction wrap(v: number, min: number, max: number): number {\n  const range = max - min;\n  return ((((v - min) % range) + range) % range) + min;\n}\n\nfunction reflect(v: number, min: number, max: number): number {\n  const range = max - min;\n  if (range <= 0) return min;\n  const period = 2 * range;\n  const p = (((v - min) % period) + period) % period;\n  return min + (p < range ? p : period - p);\n}\n\n/** Analytic position of an entity at logical time `t` (ms). Pure & deterministic. */\nexport function positionAt(e: Entity, t: number, w: number, h: number): Placed {\n  const dt = t / 1000;\n  const m = e.size;\n  if (e.motion === 'bounce') {\n    return {\n      x: reflect(e.x0 + e.vx * dt, m / 2, w - m / 2),\n      y: reflect(e.y0 + e.vy * dt, m / 2, h - m / 2),\n      flip: false,\n    };\n  }\n  if (e.motion === 'rise') {\n    return {\n      x: e.x0 + (e.bob ? e.bob * Math.sin(t / 700 + e.phase) : 0),\n      y: wrap(e.y0 + e.vy * dt, -m, h + m),\n      flip: false,\n    };\n  }\n  // drift\n  const x = wrap(e.x0 + e.vx * dt, -m, w + m);\n  let y = e.vy !== 0 ? wrap(e.y0 + e.vy * dt, -m, h + m) : e.y0;\n  if (e.bob) y += e.bob * Math.sin(t / 500 + e.phase);\n  return { x, y, flip: e.headingLeft };\n}\n","import {\n  createRng,\n  type SaverContext,\n  type SaverInstance,\n  type SaverManifest,\n  type SaverPlugin,\n} from '@idle-screens/core';\nimport { assertValidSpec } from './validate';\nimport { buildEntities, positionAt, type Entity } from './simulate';\nimport type { LayerSpec, SaverSpec } from './types';\n\n/** Derive a manifest so a compiled spec composes with @idle-screens/capabilities. */\nexport function manifestFor(spec: SaverSpec): SaverManifest {\n  const total = spec.layers.reduce((n, l) => n + l.count, 0);\n  const costTier = total < 30 ? 'idle' : total < 150 ? 'low' : total < 400 ? 'medium' : 'high';\n  return {\n    id: spec.id,\n    label: spec.label,\n    passthrough: false,\n    minBackend: 'canvas2d',\n    costTier,\n    motionIntensity: spec.motionIntensity ?? 'moderate',\n    reducedMotionFallback: 'static',\n    // Flash-safe by construction: static background + bounded sprites, no strobe\n    // primitive. Proven by sampling a compiled spec through @idle-screens/validator.\n    a11y: { flashSafe: true },\n  };\n}\n\ninterface Built {\n  layer: LayerSpec;\n  entities: Entity[];\n}\n\nclass SpecInstance implements SaverInstance {\n  private readonly canvas: HTMLCanvasElement;\n  private readonly ctx: CanvasRenderingContext2D;\n  private readonly seed: number;\n  private w: number;\n  private h: number;\n  private layers: Built[] = [];\n  private frameId: number | null = null;\n  private paused = false;\n  private startT = 0;\n\n  constructor(\n    private readonly spec: SaverSpec,\n    ctx: SaverContext,\n  ) {\n    this.seed = ((spec.seed ?? ctx.seed) >>> 0) || 1;\n    const canvas = document.createElement('canvas');\n    canvas.style.cssText = 'display:block;width:100%;height:100%';\n    canvas.setAttribute('aria-hidden', 'true');\n    ctx.host.appendChild(canvas);\n    this.canvas = canvas;\n    const c2d = canvas.getContext('2d', { alpha: false });\n    if (!c2d) throw new Error('schema saver: no 2d context');\n    this.ctx = c2d;\n\n    this.w = ctx.width;\n    this.h = ctx.height;\n    this.sizeCanvas();\n    this.rebuild();\n\n    this.paused = ctx.reducedMotion;\n    if (this.paused) this.renderFrame(0, this.seed);\n    else this.start();\n  }\n\n  private sizeCanvas(): void {\n    const dpr = Math.min(typeof window !== 'undefined' ? window.devicePixelRatio || 1 : 1, 2);\n    this.canvas.width = Math.max(1, Math.round(this.w * dpr));\n    this.canvas.height = Math.max(1, Math.round(this.h * dpr));\n    this.ctx.setTransform(dpr, 0, 0, dpr, 0, 0);\n  }\n\n  /** (Re)seed and place all entities — deterministic for the seed + size. */\n  private rebuild(): void {\n    const rng = createRng(this.seed);\n    this.layers = this.spec.layers.map((layer) => ({ layer, entities: buildEntities(layer, rng, this.w, this.h) }));\n  }\n\n  private start(): void {\n    if (this.frameId !== null || typeof requestAnimationFrame === 'undefined') return;\n    this.startT = 0;\n    this.frameId = requestAnimationFrame((now) => this.loop(now));\n  }\n\n  private stop(): void {\n    if (this.frameId !== null) {\n      cancelAnimationFrame(this.frameId);\n      this.frameId = null;\n    }\n  }\n\n  private loop(now: number): void {\n    this.frameId = requestAnimationFrame((n) => this.loop(n));\n    if (this.startT === 0) this.startT = now;\n    this.renderFrame(now - this.startT, this.seed);\n  }\n\n  private drawBackground(): void {\n    const { ctx, w, h } = this;\n    const bg = this.spec.background;\n    if (!bg || bg.type === 'solid') {\n      ctx.fillStyle = bg?.color ?? '#05050a';\n      ctx.fillRect(0, 0, w, h);\n      return;\n    }\n    const g = ctx.createLinearGradient(0, 0, 0, h);\n    for (const s of bg.stops) g.addColorStop(Math.max(0, Math.min(1, s.at)), s.color);\n    ctx.fillStyle = g;\n    ctx.fillRect(0, 0, w, h);\n    if (bg.band) {\n      ctx.fillStyle = bg.band.color;\n      ctx.fillRect(0, h - bg.band.height, w, bg.band.height);\n    }\n  }\n\n  private drawEntity(built: Built, e: Entity, t: number): void {\n    const { ctx } = this;\n    const p = positionAt(e, t, this.w, this.h);\n    const sprite = built.layer.sprite;\n    if (sprite.kind === 'circle') {\n      ctx.fillStyle = sprite.color;\n      ctx.beginPath();\n      ctx.arc(p.x, p.y, e.size / 2, 0, Math.PI * 2);\n      ctx.fill();\n      return;\n    }\n    ctx.save();\n    ctx.translate(p.x, p.y);\n    if (p.flip && built.layer.flip) ctx.scale(-1, 1);\n    ctx.textAlign = 'center';\n    ctx.textBaseline = 'middle';\n    if (sprite.kind === 'emoji') {\n      ctx.font = `${e.size}px serif`;\n      ctx.fillText(sprite.glyphs[e.spriteIndex] ?? sprite.glyphs[0]!, 0, 0);\n    } else {\n      ctx.font = sprite.font ?? `${e.size}px system-ui, sans-serif`;\n      ctx.fillStyle = sprite.color ?? '#e6e8ef';\n      ctx.fillText(sprite.strings[e.spriteIndex] ?? sprite.strings[0]!, 0, 0);\n    }\n    ctx.restore();\n  }\n\n  /** Deterministic, frame-addressable render (shared by the rAF loop). */\n  renderFrame(t: number, _seed: number): void {\n    this.drawBackground();\n    for (const built of this.layers) {\n      for (const e of built.entities) this.drawEntity(built, e, t);\n    }\n  }\n\n  setPaused(paused: boolean): void {\n    this.paused = paused;\n    if (paused) {\n      this.stop();\n    } else {\n      this.start();\n    }\n  }\n\n  resize(width: number, height: number): void {\n    this.w = width;\n    this.h = height;\n    this.sizeCanvas();\n    this.rebuild();\n    if (this.paused) this.renderFrame(0, this.seed);\n  }\n\n  dispose(): void {\n    this.stop();\n    this.canvas.remove();\n  }\n}\n\n/**\n * Compile a declarative spec into a runnable SaverPlugin. Throws if the spec is invalid\n * (so an agent-authored spec is validated before it can run). The result is seeded,\n * deterministic, `renderFrame(t,seed)`-addressable, and flash-safe by construction.\n */\nexport function compileSaver(spec: unknown): SaverPlugin {\n  const valid = assertValidSpec(spec);\n  return {\n    manifest: manifestFor(valid),\n    mount: (ctx: SaverContext) => new SpecInstance(valid, ctx),\n  };\n}\n","import type { SaverSpec } from './types';\n\n/**\n * Reproduces the hand-coded Fish Aquarium saver as pure DATA — the discriminating test\n * that the schema is actually expressive: two layers (fish drifting both ways at varied\n * speeds with a bob + flip, over a gradient with a seafloor band; bubbles rising with sway).\n */\nexport const AQUARIUM_SPEC: SaverSpec = {\n  schemaVersion: 1,\n  id: 'aquarium',\n  label: 'Aquarium (declarative)',\n  seed: 42,\n  motionIntensity: 'calm',\n  background: {\n    type: 'gradient',\n    stops: [\n      { at: 0, color: '#0a3a52' },\n      { at: 0.6, color: '#062534' },\n      { at: 1, color: '#02141d' },\n    ],\n    band: { color: '#0b1a12', height: 24 },\n  },\n  layers: [\n    {\n      count: 14,\n      sprite: { kind: 'emoji', glyphs: ['🐟', '🐠', '🐡', '🦈', '🐙'] },\n      size: [34, 72],\n      motion: { type: 'drift', speed: [30, 110], bidirectional: true, bob: 6 },\n      flip: true,\n    },\n    {\n      count: 22,\n      sprite: { kind: 'circle', radius: [2, 7], color: '#c8ebff' },\n      motion: { type: 'rise', speed: [24, 78], sway: 8 },\n    },\n  ],\n};\n\n/** Rain: dense text streaks falling straight down over a near-black sky. */\nexport const RAIN_SPEC: SaverSpec = {\n  schemaVersion: 1,\n  id: 'rain',\n  label: 'Rain (declarative)',\n  seed: 7,\n  motionIntensity: 'moderate',\n  background: { type: 'solid', color: '#05070a' },\n  layers: [\n    {\n      count: 140,\n      sprite: { kind: 'text', strings: ['│'], color: '#9fd0ff' },\n      size: [12, 26],\n      motion: { type: 'drift', angle: 90, speed: [520, 900] },\n    },\n  ],\n};\n\nexport const EXAMPLE_SPECS: SaverSpec[] = [AQUARIUM_SPEC, RAIN_SPEC];\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@idle-screens/schema",
+  "version": "0.1.0",
+  "description": "Declarative, agent-authorable saver format for idle-screens: validate a data spec, then compile it into a runnable, seeded, flash-safe SaverPlugin.",
+  "license": "MIT",
+  "author": "Shawn Partridge",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shaaaaawn/idle-screens",
+    "directory": "packages/schema"
+  },
+  "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",
+    "declarative",
+    "schema",
+    "canvas"
+  ],
+  "bugs": {
+    "url": "https://github.com/shaaaaawn/idle-screens/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@idle-screens/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@idle-screens/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  }
+}