@idle-screens/saver-metaquarium 0.20.0 → 0.22.0

package/dist/{chunk-IIYEE6GT.js → chunk-42RIVUT4.js}

@@ -107,7 +107,10 @@ var SWIM_STYLES = [
   // is — the follower samples the SAME closed form at `d - lag`.
   { name: "follow", label: "Follower", speedMul: 1, band: "free", bobAmp: 1.2, bobHz: 0.5, formation: false, travel: 1, bond: "follow" },
   { name: "pair", label: "Pair", speedMul: 0.8, band: "free", bobAmp: 2.5, bobHz: 0.35, formation: false, travel: 1, bond: "pair" },
-  { name: "chase", label: "Chaser", speedMul: 1, band: "free", bobAmp: 1, bobHz: 0.6, formation: false, travel: 1, bond: "chase" }
+  { name: "chase", label: "Chaser", speedMul: 1, band: "free", bobAmp: 1, bobHz: 0.6, formation: false, travel: 1, bond: "chase" },
+  // A seat in a vignette's audience (vignette.ts crowdPose): the script places it, out front facing the
+  // stage. With no vignette playing there is no show to watch, and it hovers.
+  { name: "audience", label: "Audience", speedMul: 0.55, band: "free", bobAmp: 4, bobHz: 0.3, formation: false, travel: 0.12 }
 ];
 var AUTO_STYLE_BY_BREED = {
   angelfish: "school",
@@ -206,12 +209,12 @@ function formationSlot(index, count, variance, halfWidth = FORMATION_HALF_WIDTH,
     const FILE = 6;
     const files = Math.ceil(Math.max(1, count) / FILE);
     const col2 = Math.floor(index / FILE);
-    const within = index % FILE;
+    const within2 = index % FILE;
     const fileLen = Math.min(FILE, count - col2 * FILE);
     return {
       side: (col2 - (files - 1) / 2) * L * 1.6 + (fishHash(index, 4) - 0.5) * L * 0.4 * j,
       up: (fishHash(index, 5) - 0.5) * L * 0.5 * j,
-      back: (within - (fileLen - 1) / 2) * L * 1.7
+      back: (within2 - (fileLen - 1) / 2) * L * 1.7
     };
   }
   if (shape === "ring") {
@@ -236,9 +239,9 @@ function formationSlot(index, count, variance, halfWidth = FORMATION_HALF_WIDTH,
     const VSIZE = 9;
     const layers = Math.ceil(Math.max(1, count) / VSIZE);
     const layer = Math.floor(index / VSIZE);
-    const within = index % VSIZE;
-    const rank = within + 1 >> 1;
-    const wing = within === 0 ? 0 : within % 2 === 1 ? -1 : 1;
+    const within2 = index % VSIZE;
+    const rank = within2 + 1 >> 1;
+    const wing = within2 === 0 ? 0 : within2 % 2 === 1 ? -1 : 1;
     const droop = (rank - 2) * L * (layers === 1 ? 0.24 : 0.12);
     const pitch2 = layers === 1 ? 1.5 : 1.2;
     const jit2 = layers === 1 ? 0.2 : 0.15;
@@ -1415,24 +1418,26 @@ var DEFAULT_COLORS = ["#fff2cf", "#ff8ad0", "#7fdcff"];
 function parseSpotRig(value) {
   const spots = [], problems = [];
   for (const raw of value.split(",").map((s) => s.trim()).filter(Boolean)) {
-    const m = /^(\d{1,2})(?:\/(#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})))?(?:\*(\d+(?:\.\d+)?))?$/.exec(raw);
+    const m = /^(?:(\d{1,2})|@([a-z][a-z0-9]{0,15}))(?:\/(#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})))?(?:\*(\d+(?:\.\d+)?))?$/.exec(raw);
     if (!m) {
-      problems.push(`"${raw}" is not slot[/color][*radius]`);
+      problems.push(`"${raw}" is not slot[/color][*radius] or @mark[/color][*radius]`);
       continue;
     }
     if (spots.length >= MAX_SPOTS) {
       problems.push(`more than ${MAX_SPOTS} spots \u2014 "${raw}" dropped`);
       continue;
     }
-    const slot = Math.min(23, Number(m[1]));
-    if (spots.some((spot2) => spot2.slot === slot)) {
-      problems.push(`slot ${slot} is already spotted \u2014 "${raw}" dropped`);
+    const mark = m[2];
+    const slot = mark ? -1 : Math.min(23, Number(m[1]));
+    if (mark ? spots.some((spot2) => spot2.mark === mark) : spots.some((spot2) => spot2.slot === slot)) {
+      problems.push(`${mark ? `mark ${mark}` : `slot ${slot}`} is already spotted \u2014 "${raw}" dropped`);
       continue;
     }
     spots.push({
       slot,
-      color: m[2] ?? DEFAULT_COLORS[spots.length],
-      radius: Math.min(60, Math.max(12, m[3] ? Number(m[3]) : 28))
+      ...mark ? { mark } : {},
+      color: m[3] ?? DEFAULT_COLORS[spots.length],
+      radius: Math.min(60, Math.max(12, m[4] ? Number(m[4]) : 28))
     });
   }
   return { spots, problems };
@@ -1615,7 +1620,7 @@ function shardGeometry(rng) {
   for (let i = 0; i < n; i += 1) tris.push([top[i], tip, top[(i + 1) % n]]);
   const positions = new Float32Array(tris.length * 9);
   const normals = new Float32Array(tris.length * 9);
-  const smooth3 = new Float32Array(tris.length * 9);
+  const smooth4 = new Float32Array(tris.length * 9);
   tris.forEach((tri, t) => {
     const [a, b, c] = tri;
     const ux = b[0] - a[0], uy = b[1] - a[1], uz = b[2] - a[2];
@@ -1643,12 +1648,12 @@ function shardGeometry(rng) {
       normals[o + 2] = nz;
       const sy = (p[1] - 0.55) * 0.25;
       const sl = Math.hypot(p[0], sy, p[2]) || 1;
-      smooth3[o] = p[0] / sl;
-      smooth3[o + 1] = sy / sl;
-      smooth3[o + 2] = p[2] / sl;
+      smooth4[o] = p[0] / sl;
+      smooth4[o + 1] = sy / sl;
+      smooth4[o + 2] = p[2] / sl;
     });
   });
-  return { positions, normals, smooth: smooth3, triangles: tris.length };
+  return { positions, normals, smooth: smooth4, triangles: tris.length };
 }
 var HABIT_RINGS = {
   lotus: [[1, 0], [6, 30], [9, 55], [16, 85]],
@@ -2495,10 +2500,190 @@ function parseSignMix(value) {
   return { entries, problems };
 }
 
+// src/choreo.ts
+var STARFISH_MOVE_NAMES = [
+  "march",
+  "jacks",
+  "reach",
+  "kick",
+  "twist",
+  "circles",
+  "disco",
+  "spin",
+  "mambo",
+  "sway",
+  "twirl",
+  "dip",
+  "hold",
+  "walk",
+  "lie",
+  "crawl",
+  "curl",
+  "wave",
+  "pop",
+  "rise",
+  "sit"
+];
+var CHOREO_MARKS = {
+  home: [0, 0],
+  left: [-2, 0],
+  right: [2, 0],
+  front: [0, 1.2],
+  back: [0, -1.5],
+  centre: "centre"
+};
+var MAX_CUES = 256;
+function parseChoreography(value, moves) {
+  const lines = /* @__PURE__ */ new Map(), problems = [];
+  const known = new Set(moves);
+  for (const rawLine of value.split("|").map((s) => s.trim()).filter(Boolean)) {
+    const head = /^([a-z]|\*)\s*:\s*(?=\d|\.)/.exec(rawLine);
+    const actor = head ? head[1] === "*" ? "*" : head[1].charCodeAt(0) - 97 : "*";
+    const body = head ? rawLine.slice(head[0].length) : rawLine;
+    if (lines.has(actor)) problems.push(`dancer ${actor === "*" ? "*" : String.fromCharCode(97 + actor)} has two lines; the later one wins`);
+    const cues = [];
+    let b0 = 0;
+    for (const raw of body.split(/,\s*(?=(?:\d+(?:\.\d+)?|\.\d+)\s*:)/).map((s) => s.trim()).filter(Boolean)) {
+      if (cues.length >= MAX_CUES) {
+        problems.push(`more than ${MAX_CUES} cues on one line; the rest are dropped`);
+        break;
+      }
+      const m = /^(\d+(?:\.\d+)?|\.\d+)\s*:\s*([a-z][a-z_]*)([^a-z_].*)?$/.exec(raw);
+      if (!m) {
+        problems.push(`"${raw}" is not <beats>:<move>`);
+        continue;
+      }
+      const beats = Number(m[1]);
+      if (!(beats > 0)) {
+        problems.push(`"${raw}": a cue needs some beats`);
+        continue;
+      }
+      if (!known.has(m[2])) {
+        problems.push(`"${raw}": no move "${m[2]}" (moves: ${moves.join(" ")})`);
+        continue;
+      }
+      const cue = { b0, beats: Math.min(beats, 512), move: m[2], turn: 0, lift: 0 };
+      for (const tok of (m[3] ?? "").replace(/^[,\s]+/, "").split(/\s+/).filter(Boolean)) {
+        const mod = /^([>@~^/%*])(.+)$/.exec(tok);
+        if (!mod) {
+          problems.push(`"${raw}": "${tok}" is not >to, @face, ~turn, ^leap, /lean, %crouch or *groove`);
+          continue;
+        }
+        const [, op, arg] = mod;
+        if (op === ">") {
+          const mark = CHOREO_MARKS[arg];
+          const xy = /^(-?\d+(?:\.\d+)?),(-?\d+(?:\.\d+)?)$/.exec(arg);
+          if (mark) cue.to = mark;
+          else if (xy) cue.to = [clamp(Number(xy[1]), -6, 6), clamp(Number(xy[2]), -6, 6)];
+          else problems.push(`"${raw}": travel to "${arg}" \u2014 a mark (${Object.keys(CHOREO_MARKS).join(" ")}) or side,depth`);
+        } else if (op === "@") {
+          const named = { cam: "cam", room: 0, front: 0, back: 180, left: -90, right: 90 };
+          if (arg in named) cue.face = named[arg];
+          else if (Number.isFinite(Number(arg))) cue.face = Number(arg);
+          else problems.push(`"${raw}": face "${arg}" \u2014 degrees, cam, room, left, right or back`);
+        } else if (op === "/") {
+          if (Number.isFinite(Number(arg))) cue.lean = clamp(Number(arg), -60, 60);
+          else problems.push(`"${raw}": lean "${arg}" is not degrees`);
+        } else if (op === "%") {
+          if (Number.isFinite(Number(arg)) && Number(arg) > 0) cue.squash = clamp(Number(arg), 0.4, 1.5);
+          else problems.push(`"${raw}": crouch "${arg}" is not a height scale`);
+        } else if (op === "*") {
+          if (Number.isFinite(Number(arg)) && Number(arg) > 0) cue.groove = clamp(Number(arg), 0.02, 0.3);
+          else problems.push(`"${raw}": groove "${arg}" is not a depth`);
+        } else if (op === "~") {
+          if (Number.isFinite(Number(arg))) cue.turn = clamp(Number(arg), -1440, 1440);
+          else problems.push(`"${raw}": turn "${arg}" is not degrees`);
+        } else {
+          if (Number.isFinite(Number(arg)) && Number(arg) >= 0) cue.lift = Math.min(Number(arg), 3);
+          else problems.push(`"${raw}": leap "${arg}" is not a height`);
+        }
+      }
+      cues.push(cue);
+      b0 += cue.beats;
+    }
+    if (cues.length) lines.set(actor, { cues, beats: b0 });
+    else problems.push(`line "${rawLine}" has no cues`);
+  }
+  return { lines, problems };
+}
+var CHOREO_HANDOVER = 0.5;
+var clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+var smooth3 = (u) => {
+  const c = clamp(u, 0, 1);
+  return c * c * (3 - 2 * c);
+};
+var posMod = (v, m) => (v % m + m) % m;
+function choreoLine(sheet, slot) {
+  return sheet?.lines.get(slot) ?? sheet?.lines.get("*") ?? null;
+}
+function choreoAt(line, beats) {
+  const b = posMod(beats, line.beats);
+  const n = line.cues.length;
+  let i = 0;
+  while (i < n - 1 && b >= line.cues[i].b0 + line.cues[i].beats) i++;
+  const cue = line.cues[i], next = line.cues[(i + 1) % n], prev = line.cues[(i + n - 1) % n];
+  let side = 0, depth = 0, centre = 0, face = 0, faceCam = 0, turn = 0;
+  const end = (c) => {
+    if (c.to === "centre") centre = 1;
+    else if (c.to) {
+      side = c.to[0];
+      depth = c.to[1];
+      centre = 0;
+    }
+    turn += c.turn;
+  };
+  const facing = (c) => {
+    if (c.face === "cam") faceCam = 1;
+    else if (c.face !== void 0) {
+      face = c.face;
+      faceCam = 0;
+    }
+  };
+  for (let k = 0; k < i; k++) {
+    end(line.cues[k]);
+    facing(line.cues[k]);
+  }
+  facing(cue);
+  const beat = b - cue.b0, u = clamp(beat / cue.beats, 0, 1);
+  const s = smooth3(u);
+  if (cue.to === "centre") centre += (1 - centre) * s;
+  else if (cue.to) {
+    side += (cue.to[0] - side) * s;
+    depth += (cue.to[1] - depth) * s;
+    centre *= 1 - s;
+  }
+  turn += cue.turn * s;
+  const lift = cue.lift > 0 ? cue.lift * Math.sin(Math.PI * u) : 0;
+  const last = i === n - 1;
+  const h = Math.min(CHOREO_HANDOVER, cue.beats / 2, next.beats / 2);
+  const ahead = smooth3((beat - (cue.beats - h)) / h);
+  if (ahead > 0) {
+    if (next.face === "cam") faceCam += (1 - faceCam) * ahead;
+    else if (next.face !== void 0 && !last) {
+      face += angleTo(face, next.face) * ahead;
+      faceCam *= 1 - ahead;
+    } else if (last) {
+      face += angleTo(face, next.face === void 0 ? 0 : next.face) * ahead;
+      faceCam *= 1 - ahead;
+    }
+  }
+  const lean = (cue.lean ?? 0) + ((next.lean ?? 0) - (cue.lean ?? 0)) * ahead;
+  let squash = (cue.squash ?? 1) + ((next.squash ?? 1) - (cue.squash ?? 1)) * ahead;
+  if (next.lift > 0) squash *= 1 - 0.16 * ahead;
+  if (cue.lift > 0) squash *= u < 0.15 ? 0.84 + 0.26 * smooth3(u / 0.15) : 1 + 0.1 * Math.sin(Math.PI * u) - 0.16 * smooth3((u - 0.85) / 0.15);
+  if (prev.lift > 0 && n > 1) squash *= 0.84 + 0.16 * smooth3(beat / Math.min(0.75, cue.beats));
+  const groove = cue.groove ?? 0;
+  if (groove > 0 && cue.lift === 0) squash *= 1 - groove * (1 + Math.cos(2 * Math.PI * posMod(beats, 1))) / 2;
+  return { cue, beat, u, next, ahead, side, depth, centre, face, faceCam, turn, lift, lean, squash };
+}
+function angleTo(a, b) {
+  return posMod(b - a + 180, 360) - 180;
+}
+
 // src/vignette.ts
 var DANCES = ["toprock", "footwork", "windmill", "headspin", "freeze", "drop"];
-var GESTURES = ["talk", "nod", "shake", "hop", "spin", "wiggle", "rest", "peek", "bow", "ink", ...DANCES];
-var BREED_GESTURES = { ink: ["octopus"] };
+var GESTURES = ["talk", "nod", "shake", "hop", "spin", "wiggle", "rest", "peek", "bow", "ink", "puff", ...DANCES];
+var BREED_GESTURES = { ink: ["octopus"], puff: ["blowfish"] };
 var OPEN_MARKS = {
   centre: { x: 0, y: 36, z: 0 },
   left: { x: -70, y: 34, z: 0 },
@@ -2506,30 +2691,32 @@ var OPEN_MARKS = {
   front: { x: 0, y: 30, z: 60 },
   back: { x: 0, y: 40, z: -70 },
   high: { x: 10, y: 62, z: -10 },
-  low: { x: -10, y: 18, z: 10 }
+  low: { x: -10, y: 18, z: 10 },
+  // Behind the mic stand (`stageSet: club` stands it here, facing front).
+  mic: { x: 0, y: 36, z: -4, solo: true }
 };
-var ACTOR = "abc";
+var ACTOR = "abcd";
 var CRUISE = 17;
 var STANDOFF = 20;
 function spot(mark, actor, actors) {
-  if (actors === 1) return mark;
+  if (actors === 1 || mark.solo) return mark;
   const a = actor / actors * Math.PI * 2 + 0.6;
   return { x: mark.x + Math.cos(a) * STANDOFF, y: mark.y + (actor % 2 ? 2.5 : 0), z: mark.z + Math.sin(a) * STANDOFF };
 }
-function parseVignette(script, marks) {
+function parseVignette(script, marks, audience = []) {
   const problems = [];
   const raw = String(script ?? "").split(/[|\n]/).map((b) => b.trim()).filter(Boolean);
   let actors = 0;
   for (const beat of raw) {
     for (const cue of beat.replace(/^\d+(?:\.\d+)?s\s{0,16}:/, "").split(",")) {
       for (const word of cue.trim().split(/\s+/)) {
-        if (!/^[abc]$/.test(word)) break;
+        if (!/^[abcd]$/.test(word)) break;
         actors = Math.max(actors, ACTOR.indexOf(word) + 1);
       }
     }
   }
-  if (!raw.length || !actors) return { actors: 0, beats: [], duration: 0, problems: raw.length ? ["no actor (a, b, c) named"] : [] };
   const centre = marks.centre ?? marks.rug ?? OPEN_MARKS.centre;
+  if (!raw.length || !actors) return { actors: 0, beats: [], duration: 0, problems: raw.length ? ["no actor (a\u2013d) named"] : [], seats: /* @__PURE__ */ new Map(), centre };
   let at = Array.from({ length: actors }, (_, i) => spot(centre, i, actors));
   const start = [];
   const beats = [];
@@ -2547,7 +2734,7 @@ function parseVignette(script, marks) {
     for (const cue of body.split(",").map((c) => c.trim()).filter(Boolean)) {
       const words = cue.split(/\s+/);
       const who = [];
-      while (words.length && /^[abc]$/.test(words[0])) who.push(ACTOR.indexOf(words.shift()));
+      while (words.length && /^[abcd]$/.test(words[0])) who.push(ACTOR.indexOf(words.shift()));
       if (!who.length) {
         problems.push(`beat ${bi + 1}: "${cue}" names no actor`);
         continue;
@@ -2555,7 +2742,7 @@ function parseVignette(script, marks) {
       for (let w = 0; w < words.length; w += 1) {
         const word = words[w];
         const target = (name) => {
-          if (/^[abc]$/.test(name) && ACTOR.indexOf(name) < actors) return { actor: ACTOR.indexOf(name), point: null };
+          if (/^[abcd]$/.test(name) && ACTOR.indexOf(name) < actors) return { actor: ACTOR.indexOf(name), point: null };
           const mk = marks[name];
           if (mk) return { actor: null, point: mk };
           problems.push(`beat ${bi + 1}: no mark or actor "${name}" (marks: ${Object.keys(marks).join(", ")})`);
@@ -2627,7 +2814,9 @@ function parseVignette(script, marks) {
     beats.push({ t0, dur: length, actors: start.map((p) => ({ to: p, moved: true, faceActor: null, facePoint: null, gesture: null, circle: null, follow: null })) });
     t0 += length;
   }
-  return { actors, beats, duration: t0, problems };
+  const seats = /* @__PURE__ */ new Map();
+  for (const slot of audience) if (slot >= actors && !seats.has(slot)) seats.set(slot, seats.size);
+  return { actors, beats, duration: t0, problems, seats, centre };
 }
 var smoother = (u) => {
   const c = Math.min(1, Math.max(0, u));
@@ -2682,7 +2871,10 @@ function poseAcross(v, actor, tSec, dt, own) {
   return poseOf(v, actor, snapBetween(v, actor, tSec, tSec + dt) ? tSec : tSec + dt, own);
 }
 function poseOf(v, actor, tSec, own) {
-  if (actor >= v.actors || !v.duration) return null;
+  if (!v.duration) return null;
+  const seat = v.seats.get(actor);
+  if (seat !== void 0) return crowdPose(v, seat, tSec, own);
+  if (actor >= v.actors) return null;
   const t = (tSec % v.duration + v.duration) % v.duration;
   let bi = v.beats.findIndex((b) => t < b.t0 + b.dur);
   if (bi < 0) bi = v.beats.length - 1;
@@ -2776,6 +2968,7 @@ function poseOf(v, actor, tSec, own) {
           pitch = -0.08 * e;
           break;
         // ink: the body holds still; the octopus squirts its cloud (the tank's InkLayer) and pales.
+        // puff: the body holds still; the blowfish gulps itself round (puffer.ts PufferInput.puffCue).
         // The dances, for a fish with no clips for them: the whole body does what it can.
         case "toprock":
           roll += Math.sin(bt * Math.PI * 2) * 0.3 * e;
@@ -2819,6 +3012,152 @@ function poseOf(v, actor, tSec, own) {
   }
   return { x, y: Math.max(9, y), z, fx, fy, fz, roll, doing, lookAt: target ?? null, ...gesture ? { gesture } : {} };
 }
+var CROWD = {
+  /** Rows out from the stage's middle, front (nearest the camera) first: distance, height, seats.
+   *  Raked: each row higher than the one before, so the back rows see over the front. */
+  rows: [{ r: 48, y: 15, n: 6 }, { r: 64, y: 21, n: 8 }, { r: 80, y: 27, n: 10 }],
+  /** How far round each row reaches, radians either side of straight out front. */
+  arc: 0.7,
+  /** A laugh: it breaks this long before the talk ends, and rolls on this long. */
+  lead: 0.45,
+  laugh: 2.8,
+  /** Seconds a seat can be late to a laugh or the applause. */
+  late: 0.55,
+  /** One seat in this many is a tough crowd: it chuckles where the rest laugh. */
+  tough: 5,
+  /** Seconds the room's heads take to follow the stage: they look where it was, a moment ago. */
+  follow: 1.05
+};
+var seatHash = (seat, k = 0) => {
+  const s = Math.sin(seat * 127.1 + k * 311.7 + 74.7) * 43758.5453;
+  return s - Math.floor(s);
+};
+function crowdSeat(v, seat) {
+  let row = 0, first = 0;
+  while (row < CROWD.rows.length - 1 && seat >= first + CROWD.rows[row].n) {
+    first += CROWD.rows[row].n;
+    row += 1;
+  }
+  const r = CROWD.rows[row];
+  const inRow = Math.min(r.n, v.seats.size - first);
+  const mid = (inRow - 1) / 2;
+  const order = Array.from({ length: inRow }, (_, p) => p).sort((p, q) => Math.abs(p - mid) - Math.abs(q - mid) || q - p);
+  const i = order[seat - first] ?? seat - first;
+  const step = CROWD.arc * 2 / Math.max(1, r.n - 1);
+  const a = (i - (inRow - 1) / 2) * step + (seatHash(seat, 1) - 0.5) * step * 0.3;
+  const d = r.r + (seatHash(seat, 2) - 0.5) * 5;
+  return { x: v.centre.x + Math.sin(a) * d, y: r.y + (seatHash(seat, 3) - 0.5) * 3, z: v.centre.z + Math.cos(a) * d };
+}
+var REACTIONS = /* @__PURE__ */ new WeakMap();
+function reactionsOf(v) {
+  let r = REACTIONS.get(v);
+  if (r) return r;
+  r = { laughs: [], claps: [] };
+  for (const b of v.beats) {
+    if (b.actors.some((a) => a.gesture === "talk")) r.laughs.push(b.t0 + b.dur);
+    if (b.actors.some((a) => a.gesture === "bow")) r.claps.push([b.t0, b.t0 + b.dur]);
+  }
+  REACTIONS.set(v, r);
+  return r;
+}
+function holderAt(v, tSec) {
+  const t = (tSec % v.duration + v.duration) % v.duration;
+  const beat = v.beats.find((b) => t < b.t0 + b.dur) ?? v.beats[v.beats.length - 1];
+  const talking = beat.actors.findIndex((a) => a.gesture === "talk");
+  if (talking >= 0) return talking;
+  let best = 0, bestD = Infinity;
+  beat.actors.forEach((a, i) => {
+    const d = Math.hypot(a.to.x - v.centre.x, a.to.z - v.centre.z);
+    if (d < bestD) {
+      bestD = d;
+      best = i;
+    }
+  });
+  return best;
+}
+function within(v, t, start, len, out) {
+  for (const shift of [-1, 0, 1]) {
+    const u = (t - start - shift * v.duration) / len;
+    if (u > 0 && u < 1) {
+      if (out) out.shift = shift;
+      return u;
+    }
+  }
+  return -1;
+}
+function crowdPose(v, seat, tSec, own) {
+  const p = crowdSeat(v, seat);
+  const t = (tSec % v.duration + v.duration) % v.duration;
+  let gx = 0, gy = 0, gz = 0;
+  const taps = 4;
+  for (let k = 0; k < taps; k++) {
+    const tk = tSec - k / (taps - 1) * CROWD.follow;
+    const m = placeOf(v, holderAt(v, tk), tk);
+    gx += m.x / taps;
+    gy += m.y / taps;
+    gz += m.z / taps;
+  }
+  const look = { x: gx, y: gy, z: gz };
+  let fx = gx - p.x, fy = (gy - p.y) * 0.4, fz = gz - p.z;
+  let fl = Math.hypot(fx, fy, fz) || 1;
+  fx /= fl;
+  fy /= fl;
+  fz /= fl;
+  const { x, z } = p;
+  let y = p.y + Math.sin(tSec * 1.1 + seat * 2.3) * 0.7;
+  let roll = Math.sin(tSec * 0.7 + seat) * 0.03;
+  let pitch = 0;
+  let doing = "watching";
+  let gesture;
+  const { laughs, claps } = reactionsOf(v);
+  const late = seatHash(seat, 4) * CROWD.late;
+  let lu = -1, lat = 0, lk = 0;
+  const loop = { shift: 0 }, lap = Math.floor(tSec / v.duration);
+  let burst;
+  for (let k = 0; k < laughs.length; k++) {
+    const at = laughs[k];
+    const len = CROWD.laugh * (0.8 + 0.45 * seatHash(seat, 10 + k));
+    const u = within(v, t, at - CROWD.lead + late, len, loop);
+    if (u > lu) {
+      lu = u;
+      lat = u * len;
+      lk = k;
+    }
+  }
+  if (lu > 0) {
+    const e = Math.min(1, lu * 6) * (1 - smoother((lu - 0.35) / 0.65));
+    const tough = seatHash(seat, 5) < 1 / CROWD.tough;
+    const amp = tough ? 0.4 : 0.75 + 0.5 * seatHash(seat, 6);
+    const hz = 5.5 + 2.5 * seatHash(seat, 7);
+    doing = "laughing";
+    pitch = (0.3 + Math.sin(lat * hz * 2) * 0.1) * e * amp;
+    y += Math.abs(Math.sin(lat * hz)) * 3.4 * e * amp;
+    roll += Math.sin(lat * hz) * 0.16 * e * amp;
+    if (own?.("talk")) gesture = { name: "talk", at: lat, bar: lat, weight: e * amp };
+    if (!tough) {
+      const start = laughs[lk] - CROWD.lead + late + (lap + loop.shift) * v.duration;
+      burst = { key: `crowd:${seat}:${lk}:${lap + loop.shift}`, t: start + 0.25 };
+    }
+  }
+  for (const [a, b] of claps) {
+    const u = within(v, t, a + late, b - a);
+    if (u <= 0) continue;
+    const e = bell(u) ** 0.6, ct = u * (b - a);
+    doing = "applauding";
+    y += Math.abs(Math.sin(ct * 6.5)) * 1.3 * e;
+    roll += Math.sin(ct * 13) * 0.22 * e;
+    if (own?.("wiggle")) gesture = { name: "wiggle", at: ct, bar: ct, weight: e };
+    break;
+  }
+  if (pitch) {
+    fy += Math.tan(pitch) * Math.hypot(fx, fz);
+    fl = Math.hypot(fx, fy, fz) || 1;
+    fx /= fl;
+    fy /= fl;
+    fz /= fl;
+  }
+  return { x, y: Math.max(9, y), z, fx, fy, fz, roll, doing, lookAt: look, ...gesture ? { gesture } : {}, ...burst ? { burst } : {} };
+}
 var polar = (deg, r, y) => ({ x: Math.cos(deg * Math.PI / 180) * r, y, z: Math.sin(deg * Math.PI / 180) * r });
 var INTERIOR_MARK_POLAR = {
   door: { deg: 28, r: 124, y: 22 },
@@ -2909,11 +3248,48 @@ var VIGNETTES = {
     "6s: a @c bow, b @c bow, c >front bow",
     "5s: a >left, b >right, c @front shake",
     "5s: c >back"
+  ].join(" | "),
+  // Open mic: a host (d) brings on three comics (a b c) in turn — each two bits and a bow — and sends them off;
+  // the two waiting stand in the wings and watch whoever has the mic, nodding along when the room laughs. Then
+  // a goodnight from the host, and the company bows from where it stands. Written for an `@audience` out front (it laughs as each talk
+  // ends), `stageSet: club` and one spot standing on the mic (`spotRig: @mic`): whoever steps up is lit.
+  // openmic cues: 4s:-, 5s:a, 5s:a, 3s:a, 5s:a, 6s:a, 3s:a, 6s:a, 3s:a, 5s:a, 4s:a, 3s:a, 5s:a, 6s:a, 3s:a, 6s:a, 3s:a, 5s:a, 4s:a, 3s:a, 5s:a, 6s:a, 3s:a, 6s:a, 3s:a, 5s:a, 5s:a, 4s:a, 5s:-
+  openmic: [
+    "4s: a =left, b =right, c =left, d =right",
+    "5s: d >mic @front, a @mic nod, b @mic nod, c @mic nod",
+    "5s: d @front talk, a @mic, b @mic, c @mic",
+    "3s: d @a wiggle, a @mic nod, b @mic nod, c @mic nod",
+    "5s: d >right, a >mic @front, b @mic, c @mic",
+    "6s: a @front talk, b @mic, c @mic, d @mic nod",
+    "3s: a @front nod, b @mic nod, c @mic nod, d @mic nod",
+    "6s: a @front talk, b @mic, c @mic, d @mic",
+    "3s: a @front bow, b @mic nod, c @mic nod, d @mic nod",
+    "5s: a >left, d >mic @front, b @mic, c @mic",
+    "4s: d @front talk, a @mic nod, b @mic, c @mic",
+    "3s: d @b wiggle, a @mic, b @mic nod, c @mic",
+    "5s: d >right, b >mic @front, a @mic, c @mic",
+    "6s: b @front talk, a @mic, c @mic, d @mic nod",
+    "3s: b @front rest, a @mic nod, c @mic nod, d @mic nod",
+    "6s: b @front talk, a @mic, c @mic, d @mic",
+    "3s: b @front bow, a @mic nod, c @mic nod, d @mic nod",
+    "5s: b >right, d >mic @front, a @mic, c @mic",
+    "4s: d @front talk, a @mic, b @mic nod, c @mic",
+    "3s: d @c wiggle, a @mic, b @mic, c @mic nod",
+    "5s: d >right, c >mic @front, a @mic, b @mic",
+    "6s: c @front talk, a @mic, b @mic, d @mic nod",
+    "3s: c @front shake, a @mic nod, b @mic nod, d @mic nod",
+    "6s: c @front talk, a @mic, b @mic, d @mic",
+    "3s: c @front bow, a @mic nod, b @mic nod, d @mic nod",
+    "5s: c >left, d >mic @front, a @mic, b @mic",
+    "5s: d @front talk, a @mic nod, b @mic, c @mic nod",
+    "4s: a @front bow, b @front bow, c @front bow, d @front bow",
+    "5s: d >right, a @mic, b @mic, c @mic"
   ].join(" | ")
 };
 var VIGNETTE_CUES = {
   duet: "4s:-, 7s:a, 5s:a, 7s:b, 5s:b, 6s:a+b, 8s:a+b, 6s:a+b, 5s:a+b",
-  trio: "4s:-, 6s:a, 6s:b, 6s:c, 7s:a+b, 7s:b+c, 9s:a+b+c, 6s:a+b+c, 5s:c, 5s:-"
+  trio: "4s:-, 6s:a, 6s:b, 6s:c, 7s:a+b, 7s:b+c, 9s:a+b+c, 6s:a+b+c, 5s:c, 5s:-",
+  openmic: "4s:-, 5s:a, 5s:a, 3s:a, 5s:a, 6s:a, 3s:a, 6s:a, 3s:a, 5s:a, 4s:a, 3s:a, 5s:a, 6s:a, 3s:a, 6s:a, 3s:a, 5s:a, 4s:a, 3s:a, 5s:a, 6s:a, 3s:a, 6s:a, 3s:a, 5s:a, 5s:a, 4s:a, 5s:-"
 };
 function resolveVignette(value) {
   const v = String(value ?? "").trim();
@@ -2926,23 +3302,23 @@ var PARAM_DOCS = {
   cameraAzimuth: "Orbit bearing in degrees. 0 looks at the village from the front.",
   cameraElevation: "Degrees above the floor. 8\u201315 is eye level with the fish; 40+ looks down on a castle.",
   cameraDistance: "Distance from the tank centre. 80 is a close-up, 170\u2013220 a village, 300+ a landmark.",
-  shot: "A named framing: `orbit` (default), `hero` (three-quarter), `front` (level, long lens), `low` (among the plants, looking up), `top` (the floor as a map), `surface` (the water's underside), `macro` (close on the nearest landmark), `cast` (frames the mix's first three wherever they swim). Azimuth and autoRotate turn it; distance scales it.",
+  shot: "A framing: `orbit`, `hero` (three-quarter), `front` (level, long lens), `low`, `top` (a map), `surface`, `macro` (nearest landmark), `cast` (the mix's first three). Azimuth and autoRotate turn it, distance scales it.",
   shotBlend: "Seconds a change of `shot` takes (0 = a cut): the camera moves to the new framing, eased.",
-  cameraFollow: "Ride with one fish (cast slot, 0 = first); -1 is the orbit camera. Orbit params are ignored while following. Pair with `followSpot` on the same slot for a spotlit chase.",
+  cameraFollow: "Ride with one fish (cast slot); -1 is the orbit camera, whose params are ignored while following. With `followSpot` on the slot, a spotlit chase.",
   followAngle: "Where round the followed fish the chase camera stands, degrees: 0 behind (default), 90 beside, 180 in front looking back at its face.",
-  followDistance: "How far behind the followed fish the camera rides (40\u201370 is a chase). Under ~18 it is the fish's eye and the fish is hidden; a floor walker (Dot, crab, octopus, snail, starfish) sees from its own head height.",
+  followDistance: "How far behind the followed fish the camera rides (40\u201370 is a chase). Under ~18 it is the fish's eye; a floor walker sees from its own head height.",
   autoRotate: "Turntable speed, degrees/second. 0 holds the shot (stages, vignettes); 1\u20132 is a slow reveal. frame.state.camera.bearing: where it stands now.",
   followAvoid: "Keep the followed fish in view, 0\u20131: the chase camera rises over low clutter or pulls in, eased. For walks through a village.",
-  nearFade: "A creature at the lens dissolves instead of being sliced, 0\u20131. The followed fish never fades.",
+  nearFade: "A creature at the lens dissolves, not sliced, 0\u20131. The followed fish never fades.",
   // cast
   fishCount: "How many fish when `fishMix` is empty (all are `fishUrl`).",
   finish: "A final full-screen pass: gentle grade, soft vignette, dither against banding, and restrained bloom on high-end devices (0 = none; never on the low tier).",
   tiltShift: "Tilt-shift, 0\u20131: sharp through the middle, soft above and below, like a model. Mid/high tiers.",
-  depthOfField: "Depth of field, 0\u20131: the subject sharp (followed fish, `cast` leads), the rest soft. High tier.",
+  depthOfField: "Depth of field, 0\u20131: the subject (followed fish, `cast` leads) sharp, the rest soft. High tier.",
   ambientOcclusion: "Ambient occlusion, 0\u20131: crevices darken. High tier.",
-  highlights: "Bright light rolls off instead of clipping, 0\u20131: a fish in a shaft stays a fish. Bright rooms want it. Mid/high tiers.",
+  highlights: "Bright light rolls off instead of clipping, 0\u20131: a fish in a shaft stays a fish. Mid/high tiers.",
   fishUrl: "The single model used when `fishMix` is empty: ipfs://, https://assets.idlescreens.com/, or a URL on the page's own origin. Any other host is refused and the default fish swims.",
-  fishMix: "The cast: `id[:count][@style]`, comma-separated: `100:2@drift, 257:1, seahorse:3, shark:1@patrol`. Minted breeds plus bundled creatures: shark crab dori glowfish babyfish hackerfish blowfish starfish octopus snail dot dolphin. Floor walkers keep their own pace (swimSpeed does not hurry them): crab (climbs rocks, forages, pinches, waves), starfish (walks upright too; dances with `starfishDance`), snail (very slow; hides in its shell). `dot` (experimental): Dot the courier, a box on legs with a screen face; `dolphin` (experimental) chatters, flips, blows bubbles, breaches where there is open surface, and in a scene stands on its tail for character beats (talk, nod, bow...). Both act out vignette gestures. Overrides fishCount/fishUrl.",
+  fishMix: "The cast: `id[:count][@style]`, comma-separated: `100:2@drift, seahorse:3, shark:1@patrol`. Minted breeds plus bundled: shark crab dori glowfish babyfish hackerfish blowfish starfish octopus snail dot dolphin. Floor walkers keep their own pace: crab, starfish (dances: `starfishDance`, `choreography`), snail. `dot` (a box on legs), `dolphin` (flips, breaches) play vignette gestures. Overrides fishCount/fishUrl.",
   dracoPath: "Where the Draco decoder lives; leave empty on a channel. Only the page's own origin or the shipped copy is used.",
   swimSpeed: "Global swim speed multiplier. 0.4 is contemplative, 1 lively.",
   swimStyle: "How the cast swims unless a fishMix entry says otherwise (`@style`). `auto` picks by breed.",
@@ -2965,15 +3341,18 @@ var PARAM_DOCS = {
   fishAmbient: "The water's light on the fish in lit mode (backs, flanks, bellies, metal plates). Fixes fish reading dark; 0.6\u20131 in bright tanks. Dims with a follow-spot's house lights.",
   fishGlow: "How strongly GLOW- parts of a fish bloom and light their neighbours and the floor.",
   fishMetal: "`on` (default) gives METAL- parts a polished, reflective finish.",
-  snailShell: "The snails' shells: `banded` (as drawn), `pearl` (iridescent nacre), `gold`, `glow` (a spiral that breathes light; best at night); `mix` (default), each its own. Lit fish only. frame.state.fish[i].shell says which.",
-  starfishDance: "Starfish dance: `aerobics`, a class facing the camera with an instructor, in unison; `freestyle`, each its own move every eight counts; `duet`, couples face to face, best with `spotRig: 0/#ffd27a*26, 1/#ff8ad0*26`. `off` (default): they crawl and wave on their own. Cast a few (`fishMix: starfish:7`); best with `shot: front`, `autoRotate: 0`, a bright room.",
-  danceTempo: "Beats per minute for the starfish dance (60\u2013180, default 128). Glides on the beat.",
-  fishLook: "`neon` dresses the bundled creatures (crab, glowfish, shark\u2026) for blacklight: near-black coats, eyes and a crab's mouth glowing a neon of their own. Best in a dark room (abyss, void) with `finish`. `natural` is the default.",
+  snailShell: "Snail shells: `banded`, `pearl` (iridescent), `gold`, `glow` (a spiral breathing light; best at night); `mix` (default), each its own. Lit fish only. frame.state.fish[i].shell says which.",
+  starfishDance: "Starfish dance: `aerobics` (a class in unison), `freestyle` (a move each per eight counts), `duet` (couples), `off`. Cast a few: `starfish:7`.",
+  danceTempo: "Dance BPM; glides on the beat.",
+  choreography: "Starfish dance cues, on the beat (see grammar).",
+  fishLook: "`neon` dresses the bundled creatures for blacklight: near-black coats, eyes (and a crab's mouth) glowing a neon of their own. Best in a dark room with `finish`. Default `natural`.",
   fishRim: "A thin edge of the water's light round each fish, 0\u20131 (lit mode): dark fish on dark water. 0.6\u20131 in dark rooms.",
-  fishShadows: "Soft shadows on the ground under the swimmers, 0\u20131: dark near the sand, faint high up.",
-  fishFadeIn: "Seconds an arriving fish takes to dissolve in (0 = it pops in).",
-  sceneryShadows: "Soft shadows under rocks, homes, castle, pyramids, geodes and lamps, 0\u20131, so nothing floats.",
-  swimWave: "Fish bend as they swim: a wave runs nose to tail and the body curls into turns (0 = rigid wiggle). Skips the turtle, crab and fish that already have a skeleton; the seahorse gets its own motion instead \u2014 fin, tail and nod.",
+  fishShadows: "Soft shadows under the swimmers, 0\u20131: dark near the sand, faint high up.",
+  fishAO: "A fish's own corners darken, 0\u20131: solid fish. All tiers.",
+  fishFadeIn: "Seconds an arriving fish takes to fade in (0 pops in).",
+  sceneryShadows: "Soft shadows under rocks, homes, castle, pyramids, geodes, lamps, 0\u20131: nothing floats.",
+  voxelAO: "Plant cubes darken where they touch each other and the sand, 0\u20131. All tiers.",
+  swimWave: "Fish bend as they swim: a wave nose to tail, the body curling into turns (0 = rigid wiggle). Skips the turtle, crab and fish with a skeleton; the seahorse gets fin, tail and nod instead.",
   fishAvoid: "Fish make way for each other: a pair about to meet parts a second ahead, the smaller giving more, over or under before round. 1 (default) on, 0 pass-through. `inspect().crowding` counts pairs still touching.",
   eyeLife: "Eyes blink, look, and emote (0 = painted on). Redraws each token's own pixel-grid eye; black and white only.",
   // water and room
@@ -2983,21 +3362,21 @@ var PARAM_DOCS = {
   floorColor: "Sea-floor colour.",
   water: "Water instead of fog: red fades with distance first, then green, blue last \u2014 a red fish goes blue-green before it goes into the murk. 0.6\u20131 for most scenes; 0 is plain fog.",
   waterClarity: "With `water` on: 0 murky (colour lost fast, short reach), 0.5 as before, 1 clear (colour kept, reach \xD71.5). Bright tanks want 0.7\u20131.",
-  waterTint: "The sunlit water, `#rrggbb`: distant things fade into it looking up, half of it on the level, none looking down, and the background becomes that gradient. Empty = off; with `water` on, reef, kelp, ice and lagoon bring their own.",
+  waterTint: "The sunlit water, `#rrggbb`: distance fades into it looking up, half on the level, none looking down; the background takes the gradient. Empty = off; with `water` on, reef, kelp, ice and lagoon bring their own.",
   dither: "`on` adds an invisible dither that removes colour banding in dark fogged gradients on TVs. Recommended with `water`; `off` (default) is byte-exact with older scenes.",
   moteDensity: "Suspended motes.",
   moteColor: "Their colour.",
   environment: "A room preset (floor, ceiling, light shafts). `void` for the mineral-world scenes.",
   floorKind: "Floor shape: `auto` follows the environment, `flat`, or terrain `dunes`, `ridges`, `basin`, `shelf` (the town on a terraced plateau), `trench` (a deep channel across the front), `terraces` (tiers behind the town).",
   waterY: "Height of the water ceiling; -1 = the environment's own.",
-  rayStrength: "Light shafts from the surface, within device budget: 5 on the high tier, 2 on standard, none on the lowest tier in a room with a water surface (reef, kelp, ice, lagoon; abyss, vent and universe keep 2). Where dropped, perceiveChannel reads room.rayStrength 0.",
+  rayStrength: "Surface light shafts, within device budget: 5 high tier, 2 standard; none on the lowest tier with a surface (abyss, vent, universe keep 2; perceiveChannel then reads 0).",
   raySoftness: "Shafts as soft volume, not flat sheets, 0\u20131. 1 for anything cinematic.",
-  floorDetail: "A seabed, not a coloured plane, 0\u20131: ripples, silt, grain; the floor's far edge fades into the fog.",
+  floorDetail: "A seabed, not a coloured plane, 0\u20131: ripples, silt, grain; its far edge fades into the fog.",
   caustics: "The dancing net of light from the surface on the floor, rocks, plants and fish (0 = none). Sharp near the top, soft and dim deep down.",
   causticScale: "Size of the caustic cells: below 1 a fine shimmer, above 1 broad slow bands.",
-  surfaceMirror: "The surface from below: a window up to the light and a rippling mirror of the tank around it (0 = the plain sheet). Needs reef, kelp, ice or lagoon; pays off on the `surface` and `low` shots. High tier reflects the real tank, mid tier the deep water.",
+  surfaceMirror: "The surface from below: a window to the light in a rippling mirror of the tank (0 = plain). Needs reef, kelp, ice or lagoon; for the `surface` and `low` shots. High tier mirrors the tank, mid the deep water.",
   // world
-  propMix: "Crystals: `crystal[:count][@habit][/palette][*size]`. Habits lotus\xB7spire\xB7druse\xB7scatter\xB7coral; palettes env\xB7rainbow or a colour (blue hotpink purple seafoam yellow orange cyan white glass); `*6` is tower-sized. `crystal:3@druse/rainbow`.",
+  propMix: "Crystals: `crystal[:count][@habit][/palette][*size]`. Habits lotus spire druse scatter coral; palettes env rainbow blue hotpink purple seafoam yellow orange cyan white glass; `*6` is tower-sized.",
   envProps: "`on` lets the environment preset plant its own crystals when `propMix` is empty.",
   crystalScale: "Size of the whole mineral world (crystals, rocks, homes, flora).",
   crystalWild: "Organic individuality: lean, bald sides, branching. 0 is a catalogue crystal, 1 is coral.",
@@ -3006,30 +3385,32 @@ var PARAM_DOCS = {
   crystalTint: "How much nearby light sources colour a passing fish. 0.5\u20130.7 ties the cast to the place.",
   rockDensity: "Faceted boulders, an arch and a back ridge around the crystals.",
   rockVeins: "Crystals bursting out of the rocks: each crown broken open, chips on the rim, a colony of the same crystal growing from the breach. 0 is plain stone.",
-  geodeHomes: "Geode houses (0\u20133) in a crescent: a village. Their doors are vignette marks `home1`\u2026, `home1in`\u2026. Capped at 2 on basic/minimal tiers (3 on standard/high); a dropped house takes its homeN/homeNin marks, and indoors there are none.",
+  geodeHomes: "Geode houses (0\u20133) in a crescent: a village. Doors are vignette marks `home1`\u2026, `home1in`\u2026. Capped at 2 on basic/minimal tiers; a dropped house takes its marks, and indoors there are none.",
   stoneStyle: "`weathered`: river-grey rocks and homes with silt on top, not dark holes in a lit room. `classic` (default): dark slate.",
   interior: "`geode` sets the whole scene INSIDE a geode home: furniture, chandelier, marks like `table`, `bed`, `door`.",
   floraDensity: "Voxel plants: one tank-wide budget (\xD7 36/72/108 by tier) shared among crystals and geodes, so more crystals means sparser gardens. What grows is `floraMix`; empty, the room picks.",
-  geodes: "Wild geodes on the floor (0 = none): split geodes, thunder eggs, cathedrals, clusters, one cavern. They glow and pulse with the crystals, take the nearest crystal's mineral, and wake when a fish comes close.",
+  geodes: "Wild geodes on the floor (0 = none): split geodes, thunder eggs, cathedrals, clusters, one cavern. They pulse with the crystals, take the nearest one's mineral, and wake when a fish comes close.",
   geodeMix: "Which geodes: `kind[:weight]`, comma-separated. geode cathedral cluster cavern (the cavern is one at most).",
   geodeMineral: "What they are made of: amethyst agate celestine citrine carnelian rose emerald quartz smoky. Empty = the mineral nearest in colour to the nearest crystal; `world` = two from the seed; or a list.",
-  fountain: "The town square's fountain where the paths meet: `vent` (a hot-vent chimney crusted with crystal, glowing at the mouth) or `geode` (a great geode basin on a plinth). A bubble column, a pebble plaza, a light of its own, and a vignette mark `fountain`.",
-  signs: 'Signs, `kind[@place][>target][/#color][*size][:text]`: `plank` on a post, `arrow` to another place, life-`ring`, lit `porthole`, `neon` lettering, scrolling `led` board, each beside its place. Original words only. `plank@gate:"Welcome to the reef", neon@home1/#ff4fa0:OPEN, arrow@hub>gate:Castle`.',
-  signFlicker: "How unstable the lit signs' power is (neon and LED), 0\u20131, default 0.4: hums, stutters, a dead row for a moment, now and then a reboot. Each sign has its own supply; 0 is steady. Flash-safe at any setting.",
-  streetLamps: "Crystal streetlamps along the paths (0 = none, 1 = about 24): slate posts with a crystal crown in their nearest crystal's colour, a halo and light on the floor. Needs paths.",
+  fountain: "The town square's fountain: `vent` (a crystal-crusted chimney glowing at the mouth) or `geode` (a geode basin on a plinth). A bubble column, a plaza, its own light, and a vignette mark `fountain`.",
+  signs: "Signs, `kind[@place][>target][/#color][*size][:text]`: `plank` on a post, `arrow` to a place, life-`ring`, lit `porthole`, `neon` lettering, scrolling `led`, each beside its place. Original words only. `neon@home1/#ff4fa0:OPEN, arrow@hub>gate:Castle`.",
+  stageSet: "`club`: a brick back wall, a mic on a stand at the `mic` mark, a stool; `mic`: the stand alone. For the `openmic` vignette.",
+  dolphinCast: "Comic dolphins, in fishMix order: `showman` (navy suit, red tie, quick), `drifter` (tan, flannel, trucker cap, slow slouch), `bigguy` (big, slate, dark tee, deadpan), `host` (a bow tie); else `classic`. Types, no likeness.",
+  signFlicker: "How unstable the lit signs' power is, 0\u20131 (default 0.4): hums, stutters, a dead row, now and then a reboot, each sign on its own supply; 0 is steady. Flash-safe.",
+  streetLamps: "Crystal streetlamps along the paths (0\u20131, about 24 at 1): slate posts crowned in the nearest crystal's colour, a halo, light on the floor. Needs paths.",
   townProps: "Village props, kind[:count][/style]: fence (a yard per home; driftwood coral stone crystal), mailbox (by each gate: post clam bottle; marks mailbox1\u2026), bench[:n] (shell stone), sock[:n]. Fences and mailboxes need geodeHomes.",
-  floorCover: "What the village lays on its floor, kind[/style]: lawn (yards; stripes checks), mosaic (a compass rose at the hub; stone shell glass), mat (at doors; kelp stripe), steps (down every walk; slate sand moss), ripples (open sand; fine broad). Lawns and mats need geodeHomes, steps need paths. Flat ground only.",
-  pyramids: "Pyramids built of cubes like the fish (0 = none, 1 = about a dozen complexes): symmetric stacks, a great pyramid and its queens, the great ones at the back. Flat ground only: use floorKind: flat (none on dunes, ridges or a basin).",
+  floorCover: "The village's floor, kind[/style]: lawn (yards; stripes checks), mosaic (at the hub; stone shell glass), mat (at doors; kelp stripe), steps (down walks; slate sand moss), ripples (fine broad). Lawns and mats need geodeHomes, steps paths. Flat ground.",
+  pyramids: "Pyramids of cubes (0 = none, 1 = about a dozen complexes): a great pyramid and its queens, the great ones at the back. Flat ground only (floorKind: flat).",
   pyramidMix: "Shapes and stones, `shape|stone[:weight], \u2026`: giza step bent djoser mayan frame; sandstone limestone obsidian jade gold lapis coral crystal nacre basalt, and lit led and neon (every cube a lamp). Empty = every shape in the room's stone.",
-  pyramidLayout: "field = complexes over the floor; stage = one monumental pyramid in the middle of the camera's orbit (lit if the mix has led or neon, else stone with lit trim), a small one at each side, the field behind. Needs flat ground in the middle.",
+  pyramidLayout: "field = complexes over the floor; stage = one monumental pyramid mid-orbit (lit with led or neon, else stone with lit trim), a small one each side, the field behind. Needs flat ground in the middle.",
   pyramidShow: "The lit pyramids' show (led, neon or trim): auto = one wave through every routine; solo = each its own; a routine (rings beam edges equalizer rainbow twinkle faces rain spiral breathe ripple); or cues `8s:rings, 16s:equalizer`. Live, no rebuild.",
   pyramidBpm: "The light show's tempo, 0\u2013140 (0 = free-running): the motion steps on the beat and each beat lifts the lamps a little \u2014 never a flash.",
   geodeLayout: "`field` (default) scatters them; `gallery` lines them up, a row per kind and a column per mineral, the mega geode behind. Frame with cameraDistance 400, elevation ~26, nothing else in the scene.",
-  floraLayout: "`garden` (default) grows plants round the crystals; `gallery` plants one of each species in two rows across the front (low before tall). With `floraMix` set, only its species. Frame with `shot: front` or `cameraDistance` ~260.",
-  floraPalette: "One colour scheme for the garden: `world` picks a hero hue, a neighbour and an accent from the seed; or give up to six `#rrggbb`. Each colony is pulled most of the way to one of them. Empty = every species its own colours.",
-  floraMix: "Which plants: `species[:weight]`, comma-separated: grass tube bulb fan kelp anemone staghorn brain whip barrel shelf seapen clam bubble elder curl pod (clam: two at most; elder: one). `kelp:3, whip, seapen` is a kelp forest; `staghorn:2, brain, anemone:2, clam` a reef. Empty = the room's garden. Needs floraDensity.",
+  floraLayout: "`garden` (default) grows plants round the crystals; `gallery` plants one of each species in two rows across the front (only floraMix's, if set). Frame with `shot: front` or `cameraDistance` ~260.",
+  floraPalette: "One colour scheme for the garden: `world` (a hero hue, a neighbour and an accent from the seed) or up to six `#rrggbb`; each colony is pulled most of the way to one. Empty = each species its own.",
+  floraMix: "Which plants, `species[:weight]`: grass tube bulb fan kelp anemone staghorn brain whip barrel shelf seapen clam bubble elder curl pod (clam \u22642, elder 1). `kelp:3, whip, seapen` a kelp forest; `staghorn:2, brain, anemone:2, clam` a reef. Needs floraDensity.",
   bubbleVents: "Bubbles from chimneys, fissures and crystals.",
-  bubbleStyle: "How vent bubbles live: `classic` loops puffs; `live` grows each bubble at the vent, rises it to the surface (if there is one) and pops it, resting the vent now and then. Distant bubbles dim instead of fattening.",
+  bubbleStyle: "Vent bubbles: `classic` loops puffs; `live` grows each at the vent, rises it to the surface and pops it, resting the vent now and then. Distant bubbles dim instead of fattening.",
   pearling: "Oxygen pearls on the plants: beads grow on the leaves over half a minute or more, sway with them and let go (0 = none). Needs floraDensity > 0; with no flora there is nothing to pearl on.",
   co2Mist: "A fine haze of tiny bubbles from the vents, drifting on a slow current (0 = none).",
   marineSnow: "Drifting lit particles; gives the water depth.",
@@ -3041,19 +3422,19 @@ var PARAM_DOCS = {
   landmark: "One thing bigger than everything else. `castle`: voxel walls, crystal-spired towers, gate, road, plaza. `citadel`: two storeys. Marks: `gate`, `plaza`, `courtyard`.",
   // stage
   followSpot: "A follow-spot on one fish slot (0 = first of the cast); -1 off. House lights drop with it.",
-  spotStrength: "How hard the spots are on and how far the house lights fall. House lights dim only lit fish's key/fill (to 40% at full) and fishAmbient; reflections, glow, flat fish and the unlit floor/scenery keep theirs, and a `-` blackout only puts out the spots.",
+  spotStrength: "How hard the spots are and how far the house lights fall: lit fish's key/fill (to 40%) and fishAmbient dim; glow, reflections and scenery keep theirs. A `-` blackout puts out only the spots.",
   spotColor: "Colour of the single `followSpot`.",
   spotShadow: "The spotted fish's shadow in its pool. 0 none, 1 true size.",
-  spotRig: "Up to three spots: `slot[/color][*radius]`. `0/#ff8ad0*26, 1/#7fdcff`. They are a, b, c in order. Overrides followSpot.",
-  spotCues: "A looping cue sheet for the rig: `8s:a, 8s:b, 12s:a+b, 4s:-` (`-` = blackout). Spots cross-fade at each cue.",
-  vignette: "A small scene for the first 2\u20133 fish: a preset (tea\xB7bedtime\xB7seek indoors; duet\xB7trio on the open stage) or a script of beats. A floor creature cast as an actor stays on the floor. Grammar below."
+  spotRig: "Up to three spots: `slot[/color][*radius]` follows a fish, `@mark` stands on a mark (`@mic` lights whoever steps up). They are a, b, c in order. Overrides followSpot.",
+  spotCues: "Looping cues for the rig: `8s:a, 12s:a+b, 4s:-` (`-` blackout, cues \u2265 2 s). Spots cross-fade.",
+  vignette: "A small scene for the first 2\u20133 fish: a preset (tea\xB7bedtime\xB7seek indoors; duet\xB7trio\xB7openmic on the open stage) or a script of beats. A floor creature cast as an actor stays on the floor. Grammar below."
 };
 var GRAMMAR = `
 fishMix   id[:count][@style][*size], \u2026        100:2@drift, 257:1, seahorse:3, shark:1@patrol*1.5
           id = a minted token (1\u2013512) or a breed (betafish angelfish seahorse seaturtle). Minted fish are
           individuals: a count casts DISTINCT neighbours. Bundled creatures (a count is copies): shark
           crab dori glowfish babyfish hackerfish blowfish starfish octopus snail dot. *size scales that token over its
-          breed's own size. Styles: loop school drift hover patrol bottom surface follow pair chase.
+          breed's own size. Styles: loop school drift hover patrol bottom surface follow pair chase audience.
 propMix   crystal[#id][:count][@habit][/palette][*size], \u2026      crystal:3@druse/rainbow, crystal:1@spire/cyan*6
           habits lotus spire druse scatter coral \xB7 palettes env rainbow blue hotpink purple seafoam yellow orange cyan white glass
 floraMix  species[:weight], \u2026                              kelp:3, whip, seapen \xB7 staghorn:2, brain, anemone:2, clam
@@ -3069,17 +3450,19 @@ pyramidShow  auto | solo | routine | <sec>s:<routine>, \u2026   8s:rings, 8s:bea
 geodeMix  kind[:weight], \u2026   geode cathedral cluster cavern                          geode:3, cathedral, cluster
 geodeMineral  world | mineral, \u2026   amethyst agate celestine citrine carnelian rose emerald quartz smoky
 floraPalette  world | #rrggbb, \u2026  (\u22646)                          world \xB7 #ff4fa0, #ffb347, #4fd1ff
-spotRig   slot[/color][*radius], \u2026  (\u22643; they become a, b, c)   0/#ffd27a*24, 1/#ff8ad0*24, 2/#7fdcff*24
+spotRig   slot|@mark[/color][*radius], \u2026  (\u22643; they become a, b, c)   0/#ffd27a*24, 1/#ff8ad0*24, 2/#7fdcff*24
 spotCues  <sec>s:<spots>, \u2026  loops                               4s:-, 7s:a, 7s:b, 12s:a+b
+choreography  [a|*:] <beats>:<move> [>to @face ~turn ^leap /lean %crouch *groove],\u2026|\u2026  moves ${STARFISH_MOVE_NAMES.join(" ")}
 signs     kind[@place][>target][/#color][*size][:text], \u2026   plank@gate:"Welcome to the reef", neon@home1/#ff4fa0:OPEN, led@plaza:TIDE 4.2M
           kinds plank arrow ring porthole neon led \xB7 places gate plaza courtyard hub fountain home1 home2 home3 centre left right front back
           an arrow points at >target \xB7 text \u2264 plank 24, arrow 16, ring 10, porthole 4 (empty = a fish), neon 14, led 64 (scrolls) \xB7 \u2264 8 signs
-vignette  beats separated by |, cues by comma; actors a b c are fish slots 0 1 2
+vignette  beats separated by |, cues by comma; actors a b c d are fish slots 0 1 2 3
           [<sec>s:] actor =mark  be there, no travel (a later beat's = snaps at its start)    actor >mark  swim there
           actor @mark | @actor   face it    a b circle mark  each named actor rings it, back to its spot by the beat's end; others stay put
-          actor follow actor     gestures: talk nod shake hop spin wiggle rest peek bow \xB7 ink (octopus only: a cloud of ink)
+          actor follow actor     gestures: talk nod shake hop spin wiggle rest peek bow \xB7 ink (octopus) \xB7 puff (blowfish)
           dances: toprock footwork windmill headspin freeze drop (a betafish dances them with its own body; 2 s beats keep them on a 120 bpm bar)
           Give every beat a duration and end where you began and a spotCues sheet stays in step forever.
+          Fish cast @audience sit out front facing the stage: they laugh as each talk ends and applaud each bow.
           Marks outdoors: ${Object.keys(OPEN_MARKS).join(" ")} \u2014 plus the world's own:
           home1 home1in \u2026 (geodeHomes), gate plaza courtyard (landmark), hub (paths), fountain (fountain).
           Marks indoors (interior: geode): ${Object.keys(INTERIOR_MARKS).join(" ")}
@@ -3089,7 +3472,7 @@ vignette  beats separated by |, cues by comma; actors a b c are fish slots 0 1 2
 var NIGHT = { fogColor: "#0a0a1a", fogNear: 120, fogFar: 700 };
 var STAGE = { fogColor: "#01030a", floorColor: "#0a1322", fogNear: 120, fogFar: 650, autoRotate: 0 };
 var ALIVE = { eyeLife: 1 };
-var CINEMATIC = { highlights: 1, raySoftness: 1, nearFade: 1, finish: 0.6 };
+var CINEMATIC = { highlights: 1, raySoftness: 1, nearFade: 1, voxelAO: 1, fishAO: 1, finish: 0.6 };
 var RECIPES = [
   {
     id: "geode-harbor",
@@ -3273,6 +3656,28 @@ var RECIPES = [
       cameraAzimuth: 0
     }
   },
+  {
+    id: "open-mic",
+    label: "Open mic",
+    what: "A comedy club: a host brings three comic dolphins to the mic in turn; a seated crowd laughs and applauds.",
+    params: {
+      ...ALIVE,
+      ...STAGE,
+      floorColor: "#1a1210",
+      vignette: "openmic",
+      stageSet: "club",
+      spotRig: "@mic/#ffc890*26",
+      spotCues: VIGNETTE_CUES.openmic,
+      spotStrength: 0.3,
+      fishMix: "dolphin:4, dori:2@audience*0.7, crab:2@audience*0.6, octopus:1@audience*0.7, babyfish:5@audience",
+      dolphinCast: "showman, drifter, bigguy, host",
+      signs: "neon@back/#ff4fa0:OPEN MIC",
+      finish: 0.6,
+      cameraDistance: 125,
+      cameraElevation: 12,
+      cameraAzimuth: 0
+    }
+  },
   {
     id: "follow-spot",
     label: "Follow-spot",
@@ -3327,7 +3732,7 @@ var RECIPES = [
   {
     id: "reef-characters",
     label: "Reef characters",
-    what: "The bundled characters on a reef: tangs that look back, blowfish that puff and flirt, an octopus that changes colour and inks, a crab. A slow orbit.",
+    what: "The bundled characters on a reef: tangs that look back, blowfish that puff and flirt, an octopus that inks, a crab.",
     params: {
       ...ALIVE,
       environment: "reef",
@@ -3346,7 +3751,7 @@ var RECIPES = [
   {
     id: "starfish-class",
     label: "Starfish aerobics",
-    what: "Seven starfish stand up on a pale ice floor, face the camera and dance an aerobics routine in unison, an instructor in front.",
+    what: "Seven starfish stand up on a pale ice floor, face the camera and dance aerobics in unison, an instructor in front.",
     params: { environment: "ice", fishMix: "starfish:7", starfishDance: "aerobics", danceTempo: 120, shot: "front", autoRotate: 0 }
   },
   {
@@ -3370,7 +3775,7 @@ var RECIPES = [
   {
     id: "dot-delivers",
     label: "Dot delivers",
-    what: "Dot the courier walks to a neighbour's door and knocks; a blowfish comes out, they bow and chat, Dot spins for joy and walks home. The camera rides beside it.",
+    what: "Dot the courier knocks at a neighbour's door; a blowfish comes out, they bow and chat, Dot spins for joy and walks home.",
     params: {
       ...ALIVE,
       geodeHomes: 3,
@@ -3388,7 +3793,7 @@ var RECIPES = [
   {
     id: "snail-night",
     label: "Snails by night",
-    what: "Glowing snails on a dark floor: each spiral breathes light, the feelers pool green on the sand, and the camera rides beside one.",
+    what: "Glowing snails on a dark floor: each spiral breathes light, feelers pool green on the sand, the camera beside one.",
     params: {
       ...ALIVE,
       ...NIGHT,
@@ -3407,7 +3812,7 @@ var RECIPES = [
   {
     id: "reef-cinematic",
     label: "Reef, cinematic",
-    what: "A small reef cast framed close wherever it swims, in soft shafts, each fish over its shadow. The polished look.",
+    what: "A small reef cast framed close wherever it swims, in soft shafts, each fish over its shadow.",
     params: {
       ...ALIVE,
       ...CINEMATIC,
@@ -3432,7 +3837,7 @@ var RECIPES = [
   {
     id: "night-cinematic",
     label: "Deep night, cinematic",
-    what: "The deep at night: glowfish under jellyfish lanterns, a shark sliding through, every outline rimmed in light.",
+    what: "The deep at night: glowfish under jellyfish lanterns, a shark sliding through, outlines rimmed in light.",
     params: {
       ...ALIVE,
       ...CINEMATIC,
@@ -3456,7 +3861,7 @@ var RECIPES = [
   {
     id: "village-cinematic",
     label: "Village, cinematic",
-    what: "Dot, Puff and Hex meet in a sunlit village of stone homes, seen high through a tilt-shift lens: a model village.",
+    what: "Dot, Puff and Hex meet in a sunlit village of stone homes, seen through a tilt-shift lens.",
     params: {
       ...ALIVE,
       ...CINEMATIC,
@@ -3504,6 +3909,7 @@ function validateMetaquariumParams(params) {
   if (str("townProps")) push("townProps", parseTownProps(str("townProps")).problems);
   if (str("floorCover")) push("floorCover", parseFloorCover(str("floorCover")).problems);
   if (str("pyramidShow")) push("pyramidShow", parsePyramidShow(str("pyramidShow")).problems);
+  if (str("choreography")) push("choreography", parseChoreography(str("choreography"), STARFISH_MOVE_NAMES).problems);
   if (str("geodeMineral")) push("geodeMineral", parseGeodeMineral(str("geodeMineral")).problems);
   const rig = parseSpotRig(str("spotRig"));
   push("spotRig", rig.problems);
@@ -3513,6 +3919,9 @@ function validateMetaquariumParams(params) {
     else push("spotCues", parseSpotCues(str("spotCues"), spots).problems);
   }
   const world = worldMarks(params);
+  for (const s of rig.spots) {
+    if (s.mark && !(s.mark in OPEN_MARKS) && !(s.mark in world)) out.push({ path: "spotRig", message: `no "${s.mark}" mark in this scene \u2014 that spot is dark` });
+  }
   if (str("vignette")) {
     const indoors = params.interior === "geode";
     push("vignette", parseVignette(resolveVignette(str("vignette")), indoors ? INTERIOR_MARKS : { ...OPEN_MARKS, ...world }).problems);
@@ -3598,17 +4007,17 @@ function dependencyProblems(params) {
   const spot2 = Math.round(num("followSpot", -1));
   if (rig.length && set("followSpot")) out.push({ path: "followSpot", also: ["spotRig"], message: "ignored: a spotRig replaces the single followSpot" });
   else if (spot2 >= cast) out.push({ path: "followSpot", also: castParams, message: noFish(spot2) });
-  for (const s of rig) if (s.slot >= cast) out.push({ path: "spotRig", also: castParams, message: noFish(s.slot) });
+  for (const s of rig) if (!s.mark && s.slot >= cast) out.push({ path: "spotRig", also: castParams, message: noFish(s.slot) });
   if (str("vignette")) {
     const v = parseVignette(resolveVignette(str("vignette")), { ...OPEN_MARKS, ...INTERIOR_MARKS });
     const { actors } = v;
-    if (actors > cast) out.push({ path: "vignette", also: castParams, message: `needs ${actors} fish (actors a\u2013${"abc"[actors - 1]} are slots 0\u2013${actors - 1}), but ${castWhy}` });
+    if (actors > cast) out.push({ path: "vignette", also: castParams, message: `needs ${actors} fish (actors a\u2013${"abcd"[actors - 1]} are slots 0\u2013${actors - 1}), but ${castWhy}` });
     const slotBreeds = expandFishMixSlots(mix, 3).map((sl) => sl.breed);
     for (const [g, breeds] of Object.entries(BREED_GESTURES)) {
       for (let a = 0; a < actors; a++) {
         if (!v.beats.some((b) => b.actors[a]?.gesture === g)) continue;
         const breed = slotBreeds[a] ?? "fish";
-        if (!breeds.includes(breed)) out.push({ path: "vignette", also: ["fishMix"], message: `"${"abc"[a]} ${g}" does nothing: ${g} is the ${breeds.join("/")}'s own, and actor ${"abc"[a]} (slot ${a}) is a ${breed}` });
+        if (!breeds.includes(breed)) out.push({ path: "vignette", also: ["fishMix"], message: `"${"abcd"[a]} ${g}" does nothing: ${g} is the ${breeds.join("/")}'s own, and actor ${"abcd"[a]} (slot ${a}) is a ${breed}` });
       }
     }
   }
@@ -3617,7 +4026,9 @@ function dependencyProblems(params) {
   if (dance !== "off" && !starfishSwims) {
     out.push({ path: "starfishDance", also: ["fishMix"], message: "no starfish in the cast to dance \u2014 add e.g. starfish:7 (slots past the cap never swim)" });
   }
-  if (set("danceTempo") && dance === "off") out.push({ path: "danceTempo", also: ["starfishDance"], message: "does nothing while starfishDance is off" });
+  const choreographed = !!str("choreography").trim();
+  if (set("danceTempo") && dance === "off" && !choreographed) out.push({ path: "danceTempo", also: ["starfishDance"], message: "does nothing while starfishDance is off" });
+  if (choreographed && !starfishSwims) out.push({ path: "choreography", also: ["fishMix"], message: "no starfish in the cast to dance it \u2014 add e.g. starfish:5" });
   if (follow < 0) {
     for (const k of ["followDistance", "followAngle", "followAvoid"]) if (set(k)) out.push({ path: k, also: ["cameraFollow"], message: "does nothing while cameraFollow is -1 (the orbit camera)" });
   } else if (follow < cast) {
@@ -3760,7 +4171,7 @@ function describeMetaquarium(params, timed = []) {
   if (Math.round(num("shoal") * CAST_CAP2 * 2.5) >= 3) world.push(`a school of ${str("shoalKind")}`);
   const stage = [];
   const rig = parseSpotRig(str("spotRig")).spots;
-  if (rig.length) stage.push(`${rig.length} spotlight${rig.length === 1 ? "" : "s"} on ${rig.map((s) => slotName(s.slot)).join(", ")}`);
+  if (rig.length) stage.push(`${rig.length} spotlight${rig.length === 1 ? "" : "s"} on ${rig.map((s) => s.mark ? `the ${s.mark} mark` : slotName(s.slot)).join(", ")}`);
   else if (num("followSpot") >= 0) stage.push(`follow-spot on ${slotName(num("followSpot"))}`);
   if (has("spotCues") && (rig.length || num("followSpot") >= 0)) {
     const sheet = parseSpotCues(str("spotCues"), Math.max(1, rig.length));
@@ -3771,6 +4182,7 @@ function describeMetaquarium(params, timed = []) {
     stage.push(VIGNETTES[v] ? `vignette: ${v}` : `vignette: ${v.split(/[|\n]/).filter((b) => b.trim()).length} beats`);
   }
   if (str("starfishDance") !== "off") stage.push(`starfish ${str("starfishDance")}${has("danceTempo") ? ` at ${num("danceTempo")} bpm` : ""}`);
+  if (str("choreography").trim()) stage.push(`a starfish choreography${has("danceTempo") ? ` at ${num("danceTempo")} bpm` : ""}`);
   const camera = [];
   const follow = Math.round(num("cameraFollow"));
   if (follow >= 0) {
@@ -4060,6 +4472,10 @@ var METAQUARIUM_PARAMS = {
    *  mode), brighter on top: what separates a dark fish from dark water.
    *  0 is none. */
   fishRim: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
+  /** The fish's own corners darken — a fin's root, the step at the head, the
+   *  gap under a shell — read off the voxels they are built from. Baked once
+   *  per breed, the first frame it is on; every tier. 0 is off. */
+  fishAO: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
   /** A soft shadow on the ground under every swimmer: small and dark near
    *  the sand, wide and faint high up — what puts a fish at a height instead
    *  of floating in front of the floor. 0 is none (floor walkers always
@@ -4073,6 +4489,10 @@ var METAQUARIUM_PARAMS = {
    *  homes, the castle, pyramids, wild geodes, lamps — so it stands on the
    *  sand instead of floating over it. 0 is none. */
   sceneryShadows: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
+  /** The plants' cubes darken where they meet each other and the sand — the
+   *  corner shading every voxel renderer has — so a coral reads solid instead
+   *  of as flat cut-outs. Baked once, the first frame it is on; every tier. 0 is off. */
+  voxelAO: { type: "number", default: 0, min: 0, max: 1, ease: "smooth" },
   /** A creature that comes too close to the camera dissolves (an ordered
    *  dither by depth) instead of being cut by the lens: at 1 it is whole
    *  beyond about a fish and a half and gone inside about half that. 0 is off. */
@@ -4124,6 +4544,13 @@ var METAQUARIUM_PARAMS = {
   /** The dance's tempo, beats per minute. Every move is a bar of four beats.
    *  Integrated when steered, so a glide speeds the class up on the beat. */
   danceTempo: { type: "number", default: 128, min: 60, max: 180, ease: "smooth" },
+  /** An authored dance on the beat (choreo.ts): a cue sheet per dancer —
+   *  `a: 8:lie, 4:rise, 4:reach >right @cam | *: 4:march ~360, 4:jacks ^0.5`.
+   *  Set, every starfish dances it (in the class's places, or the couples'
+   *  under `starfishDance: duet`), facing `cameraAzimuth`; a dancer it leaves
+   *  out keeps `starfishDance`'s routine, or stands and waits. Beats on the
+   *  `danceTempo` clock from the start, so a sheet lines up with music. */
+  choreography: { type: "string", default: "", ease: "step" },
   /** Eye life, 0..1: blinks on a personal clock, idle saccades, pupils that
    *  lead a turn or a climb, eyes on whoever a vignette has it talking to, a
    *  glance at the camera now and then, wide for a hop and shut for a rest.
@@ -4250,6 +4677,13 @@ var METAQUARIUM_PARAMS = {
    *  fountain home1…, or centre left right front back), facing the front; an LED board
    *  scrolls a long line. Empty = none. */
   signs: { type: "string", default: "", ease: "step" },
+  /** The open-mic set (club.ts): `club` is a brick back wall, a mic on a stand at the `mic` mark and a
+   *  stool; `mic` the stand alone. The `openmic` vignette is written for it, with an `@audience` out front. */
+  stageSet: { type: "enum", default: "none", options: ["none", "club", "mic"], ease: "step" },
+  /** EXPERIMENTAL. The dolphins' cast — comic personas, in the order the dolphins come in fishMix:
+   *  `showman, drifter, bigguy` (dolphin-comics.ts). Each its own look (skin, finish, shirt, prop) and
+   *  act (tempo, size of gesture, slouch, lean, lids). Unknown names, and dolphins past the list: classic. */
+  dolphinCast: { type: "string", default: "", ease: "step" },
   /** How unstable the lit signs' power is (neon and LED boards): 0 steady; higher, more
    *  hum, stutters, a dead row or tube, a slipped row, now and then a reboot. Each sign
    *  has its own supply — most steady, some dodgy. Flash-safe at any setting. */
@@ -4516,6 +4950,10 @@ export {
   SIGN_TEXT_MAX,
   MAX_SIGNS,
   parseSignMix,
+  STARFISH_MOVE_NAMES,
+  parseChoreography,
+  choreoLine,
+  choreoAt,
   GESTURES,
   OPEN_MARKS,
   parseVignette,
@@ -4542,4 +4980,4 @@ export {
   paramSpaceWith,
   coerceNum
 };
-//# sourceMappingURL=chunk-IIYEE6GT.js.map
+//# sourceMappingURL=chunk-42RIVUT4.js.map