@homie-rocks/studio 0.19.2 → 0.20.0

package/lab/lab.ts

@@ -0,0 +1,180 @@
+/*
+ * @homie-rocks/studio/lab — a game opts into the Game Lab (`homie-studio lab <game>`) with a few calls. The lab plays
+ * the same take in two builds side by side, New (the working tree) and Today (the last commit), on one clock, with the
+ * same seed and the same presses, and draws what these calls report: a timeline of phases, graphs of tracked values,
+ * the game's own overlays, preset views and live sliders.
+ *
+ * Outside the lab every call is a no-op (one check of a constant), so the calls stay in the game for good and cost a
+ * player nothing. The lab's clock, dice and inputs are installed in the game's page before its first script (the
+ * lab's harness, lab/harness.js): requestAnimationFrame, performance.now(), Date.now(), timers and Math.random() all
+ * run on the lab's clock there, so netplay's offline host, a round's countdown and a knockback's timer all slow down,
+ * pause and step together.
+ *
+ *   import { lab } from '@homie-rocks/studio/lab';
+ *   import tuning from '../tunables.json';
+ *
+ *   const T = lab.tunables(tuning);                 // T.knockSpeed: the file's value; in the lab, the slider's
+ *   const view = lab.camera({ game: null, close: { zoom: 2.4 } });
+ *   lab.overlay('trail', (ctx) => { for (const p of lab.past('me', 30)) dot(ctx, p.x, p.y); });
+ *
+ *   function frame(t: number): void {
+ *     const dt = lab.time.dt(t, 0.05);              // seconds since the last frame, at most 0.05
+ *     ...
+ *     lab.track('speed', Math.hypot(vx, vy), 'px/s');
+ *     lab.phase(knocked ? 'LAUNCH' : null, 'Leaves fast, eases out');
+ *     lab.pose('me', { x, y });
+ *     ...in the world's transform: lab.draw(ctx);
+ *   }
+ *
+ * tunables.json (next to game.json): { "knockSpeed": { "value": 950, "min": 300, "max": 2000, "step": 10,
+ * "unit": "px/s", "group": "Knock", "note": "How fast a bumped body leaves" }, ... }. A slider the person keeps is
+ * written back into that file by the lab, so a kept change is code.
+ */
+
+/** One tunable in tunables.json: its value and the slider around it. A bare number is a value with no range. */
+export interface TunableSpec {
+  value: number;
+  min?: number;
+  max?: number;
+  step?: number;
+  unit?: string;
+  group?: string;
+  note?: string;
+}
+export type TunableFile = Record<string, TunableSpec | number>;
+export type Tuned<S extends TunableFile> = { readonly [K in keyof S]: number };
+
+/** What the lab's harness puts on the page (window.__homieLab) before the game's first script. */
+interface LabHost {
+  v: 1;
+  pane: 'new' | 'today';
+  stage: string | null;
+  frame: number;
+  fps: number;
+  scale: number;
+  paused: boolean;
+  track(name: string, value: number, unit?: string): void;
+  phase(name: string | null, note?: string): void;
+  pose(name: string, value: Record<string, unknown>): void;
+  past(name: string, count: number, every: number): Record<string, unknown>[];
+  views(names: string[]): void;
+  view(): string | null;
+  overlays(names: string[]): void;
+  overlay(name: string): boolean;
+  tunables(spec: TunableFile): Record<string, number>;
+  random(): number;
+  hold(): void;
+  ready(): void;
+}
+
+const host: LabHost | null = typeof window !== 'undefined' ? ((window as unknown as { __homieLab?: LabHost }).__homieLab ?? null) : null;
+const ON = Boolean(host && host.v === 1);
+
+type Draw = (ctx: unknown, ...rest: unknown[]) => void;
+const drawers = new Map<string, Draw>();
+let lastT = -1;
+
+const valueOf = (s: TunableSpec | number): number => (typeof s === 'number' ? s : Number(s?.value));
+
+export const lab = {
+  /** True when this page is a pane of the Game Lab. */
+  on: ON,
+
+  time: {
+    /**
+     * Seconds since the previous frame, at most `max` (a tab that slept does not teleport the world). Call it once a
+     * frame with requestAnimationFrame's time. In the lab that time is the lab's clock: every frame is exactly one step
+     * of its frame rate (60, 30, 15 or 12 a second), so a take plays the same every time, at any speed.
+     */
+    dt(t: number, max = 0.05): number {
+      const d = lastT < 0 ? 0 : Math.max(0, (t - lastT) / 1000);
+      lastT = t;
+      return Math.min(max, d);
+    },
+    /** The time now in ms (performance.now(); the lab's clock in the lab). */
+    now(): number { return performance.now(); },
+    /** The lab's frame number (1 is the take's first frame); 0 outside the lab. */
+    get frame(): number { return host?.frame ?? 0; },
+    /** Frames a second the lab runs the game at (60 outside the lab). */
+    get fps(): number { return host?.fps ?? 60; },
+    /** How fast the lab plays (1, 0.5, 0.25, 0.1): the game never needs it, a frame is a frame at any speed. */
+    get scale(): number { return host?.scale ?? 1; },
+    get paused(): boolean { return host?.paused ?? false; },
+  },
+
+  /**
+   * The take's stage (lab.json "stage"), or null: a scene the game sets up for one mechanic, the way a fighting game's
+   * training mode stands a dummy in front of you. Read it where the round starts; it is null outside the lab, so a
+   * stage never reaches a player. Check the mechanic in a take without a stage too: real play is the test.
+   */
+  get stage(): string | null { return host?.stage ?? null; },
+
+  /** A number to graph this frame (New against Today). `unit` names its axis the first time. */
+  track(name: string, value: number, unit?: string): void { if (ON) host!.track(name, value, unit); },
+
+  /**
+   * The phase the mechanic is in from now on: a short name in capitals (COIL, RISE, HANG, LAUNCH, SETTLE) and a note
+   * that says what it is for ("Overlap on the way out"). null: none. It lasts until the next call, so call it when the
+   * phase changes, or every frame with what it is.
+   */
+  phase(name: string | null, note?: string): void { if (ON) host!.phase(name, note); },
+
+  /** A small picture of something this frame ({ x, y, angle, sx, sy }): what `past` returns to an overlay. */
+  pose(name: string, value: Record<string, unknown>): void { if (ON) host!.pose(name, value); },
+
+  /** The last `count` poses of `name`, newest first, one every `every` frames (onion skins, arcs, trails). */
+  past<P extends Record<string, unknown> = Record<string, number>>(name: string, count = 8, every = 1): P[] {
+    return ON ? (host!.past(name, count, every) as P[]) : [];
+  },
+
+  /**
+   * Preset views the lab offers as buttons (Side, Front, Top, Orbit in a 3D game; Close, Arena in a flat one). Returns
+   * the active preset's value each frame: the first preset outside the lab (give it null: the game's own camera).
+   */
+  camera<V>(presets: Record<string, V>): () => V | null {
+    const names = Object.keys(presets);
+    const first = names.length ? (presets[names[0] as string] as V) : null;
+    if (!ON) return () => first;
+    host!.views(names);
+    return () => { const v = host!.view(); return v !== null && Object.hasOwn(presets, v) ? (presets[v] as V) : first; };
+  },
+
+  /** An overlay the lab can switch on (onion skin, arcs, smears, hit boxes): drawn by the game's own renderer. */
+  overlay(name: string, draw: Draw): void {
+    if (!ON) return;
+    drawers.set(name, draw);
+    host!.overlays([...drawers.keys()]);
+  },
+
+  /** Draw every overlay the lab has on, in whatever transform the game is in (call it in world space). */
+  draw(ctx: unknown, ...rest: unknown[]): void {
+    if (!ON) return;
+    for (const [name, fn] of drawers) if (host!.overlay(name)) { try { fn(ctx, ...rest); } catch { /* an overlay never breaks the frame */ } }
+  },
+
+  /**
+   * The game's tunables (tunables.json): an object of numbers by name. Outside the lab, the file's values. In the lab,
+   * the values the sliders hold now (a take restarts when one moves); the lab writes kept values back into the file.
+   */
+  tunables<S extends TunableFile>(spec: S): Tuned<S> {
+    const base: Record<string, number> = {};
+    for (const [k, s] of Object.entries(spec)) base[k] = valueOf(s);
+    if (!ON) return Object.freeze(base) as Tuned<S>;
+    const live = host!.tunables(spec);
+    const out = {} as Record<string, number>;
+    for (const k of Object.keys(base)) Object.defineProperty(out, k, { enumerable: true, get: () => (Number.isFinite(live[k]) ? (live[k] as number) : (base[k] as number)) });
+    return out as Tuned<S>;
+  },
+
+  /**
+   * Dice for juice (particles, shake, sparks): its own stream in the lab, so a build that adds a particle never moves
+   * a gem or a bot in the other build (Math.random() is the world's dice, the same in both). Math.random() outside.
+   */
+  random(): number { return ON ? host!.random() : Math.random(); },
+
+  /** A game that loads assets after its page has loaded: hold() early, ready() when it can play. */
+  hold(): void { if (ON) host!.hold(); },
+  ready(): void { if (ON) host!.ready(); },
+};
+
+export default lab;

package/lab/page/index.html

@@ -0,0 +1,83 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+<meta name="color-scheme" content="dark">
+<title>Game Lab</title>
+<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M8 1l7 7-7 7-7-7z' fill='%23ffad3b'/%3E%3C/svg%3E">
+<link rel="stylesheet" href="/_lab/lab.css">
+</head>
+<body>
+<header class="bar top">
+  <div class="brand"><span class="mark" aria-hidden="true"></span><span class="word">GAME LAB</span></div>
+  <div class="title"><b id="game-name">…</b><span class="sep">/</span><span id="take-name">…</span></div>
+  <div class="status" id="status" aria-live="polite"></div>
+</header>
+
+<nav class="bar tools" aria-label="View">
+  <div class="group" role="group" aria-label="Which build" id="layout"></div>
+  <div class="group" role="group" aria-label="Views" id="views"></div>
+  <div class="group" role="group" aria-label="Device" id="device"></div>
+  <div class="group" role="group" aria-label="Overlays" id="overlays"></div>
+  <div class="group grow"></div>
+  <div class="group" role="group" aria-label="Take">
+    <label class="select"><span class="sr">Take</span><select id="take-pick"></select></label>
+    <button type="button" id="rec" class="rec" title="Record a take: play it in NEW">● REC</button>
+  </div>
+</nav>
+
+<main class="work">
+  <section class="stage" id="stage" aria-label="New and Today side by side">
+    <div class="slot" data-pane="new">
+      <div class="frame"><iframe title="New: the working tree" id="pane-new" tabindex="-1"></iframe></div>
+      <div class="tag new"><span>NEW</span><small id="new-sub"></small></div>
+      <div class="caption" id="cap-new"></div>
+      <div class="veil" id="veil-new" hidden></div>
+    </div>
+    <div class="slot" data-pane="today">
+      <div class="frame"><iframe title="Today: the last commit" id="pane-today" tabindex="-1"></iframe></div>
+      <div class="tag today"><span>TODAY</span><small id="today-sub"></small></div>
+      <div class="caption" id="cap-today"></div>
+      <div class="veil" id="veil-today" hidden></div>
+    </div>
+    <div class="recbar" id="recbar" hidden><span class="dot"></span><span id="rec-text">Recording: play in NEW</span><button type="button" id="rec-stop">Stop</button></div>
+  </section>
+
+  <aside class="tune" id="tune" aria-label="Tunables">
+    <div class="tune-head"><b>TUNABLES</b><small id="tune-file"></small></div>
+    <div class="tune-list" id="tune-list"></div>
+    <div class="tune-foot">
+      <button type="button" id="keep" class="primary" disabled>Keep in code</button>
+      <button type="button" id="undo" disabled>Undo</button>
+    </div>
+  </aside>
+
+  <section class="deck" aria-label="Timeline">
+    <div class="transport">
+      <div class="group" role="group" aria-label="Playback">
+        <button type="button" id="to-start" title="Start (Home)">|◀</button>
+        <button type="button" id="back" title="Back a frame (←)">◀</button>
+        <button type="button" id="play" class="wide" title="Play or pause (Space)">Pause</button>
+        <button type="button" id="fwd" title="Forward a frame (→)">▶</button>
+        <button type="button" id="to-end" title="End (End)">▶|</button>
+      </div>
+      <div class="group" role="group" aria-label="Speed" id="speeds"></div>
+      <div class="group" role="group" aria-label="Frames a second" id="fpses"></div>
+      <div class="group" role="group" aria-label="Loop"><button type="button" id="loop" class="on" title="Play the take again from the start">Loop</button></div>
+      <div class="counter" id="counter">F 0 / 0 · 0.00 s</div>
+    </div>
+    <div class="legend" id="legend"></div>
+    <div class="lines">
+      <canvas id="timeline" aria-label="Phases of the take, New above Today: click or drag to move the playhead"></canvas>
+    </div>
+    <div class="tracks" id="tracks" role="tablist" aria-label="Graphs"></div>
+    <div class="lines">
+      <canvas id="graph" aria-label="The chosen value over the take, New against Today"></canvas>
+    </div>
+    <p class="hint" id="hint"></p>
+  </section>
+</main>
+<script type="module" src="/_lab/page.js"></script>
+</body>
+</html>

package/lab/page/lab.css

@@ -0,0 +1,174 @@
+/* The Game Lab: a dark, crisp tool for one mechanic at a time. Everything is drawn by the browser: no web fonts, no
+ * images. Labels are small capitals in the system's monospace; the accent is amber, Today is a cool blue. */
+:root {
+  --bg: #080b12;
+  --panel: #0e1320;
+  --panel2: #131a2a;
+  --raise: #1a2236;
+  --line: #232c42;
+  --line2: #2e3954;
+  --text: #e7eaf3;
+  --dim: #8d96b0;
+  --faint: #59627c;
+  --accent: #ffad3b;
+  --accent-ink: #1b1204;
+  --new: #ffad3b;
+  --today: #7cc4ff;
+  --bad: #ff5d6c;
+  --ok: #4fe0a0;
+  --mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
+  --sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  color-scheme: dark;
+}
+* { box-sizing: border-box; }
+html, body { margin: 0; background: var(--bg); color: var(--text); font: 13px/1.35 var(--sans); }
+body { min-height: 100vh; display: grid; grid-template-columns: minmax(0, 1fr); grid-template-rows: auto auto 1fr; overflow-x: hidden; }
+button, select { font: inherit; color: inherit; }
+[hidden] { display: none !important; }
+.sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
+
+/* ------------------------------------------------------------------ bars and buttons */
+.bar { display: flex; align-items: center; gap: 10px; padding: 8px 14px; background: var(--panel); border-bottom: 1px solid var(--line); }
+.bar.top { padding-top: max(8px, env(safe-area-inset-top)); gap: 14px; }
+.brand { display: flex; align-items: center; gap: 9px; font: 800 13px/1 var(--mono); letter-spacing: .32em; }
+.brand .mark { width: 12px; height: 12px; background: var(--accent); transform: rotate(45deg); box-shadow: 0 0 0 3px rgba(255, 173, 59, .16); }
+.title { display: flex; align-items: baseline; gap: 8px; min-width: 0; flex: 1 1 auto; font: 600 13px/1.2 var(--mono); color: var(--dim); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.title b { color: var(--text); font-weight: 700; }
+.title .sep { color: var(--faint); }
+.status { margin-left: auto; display: flex; gap: 6px; flex-wrap: wrap; justify-content: flex-end; }
+.chip { display: inline-flex; align-items: center; gap: 6px; height: 22px; padding: 0 8px; border: 1px solid var(--line2); background: var(--panel2); font: 700 10.5px/1 var(--mono); letter-spacing: .08em; text-transform: uppercase; color: var(--dim); white-space: nowrap; }
+.chip .dot { width: 7px; height: 7px; border-radius: 50%; background: currentColor; }
+.chip.ok { color: var(--ok); border-color: rgba(79, 224, 160, .35); }
+.chip.bad { color: var(--bad); border-color: rgba(255, 93, 108, .4); cursor: help; }
+.chip.warn { color: var(--accent); border-color: rgba(255, 173, 59, .4); }
+.chip.busy .dot { animation: blink 1s steps(2, start) infinite; }
+@keyframes blink { to { visibility: hidden; } }
+
+.tools { gap: 12px; flex-wrap: wrap; row-gap: 8px; }
+.group { display: flex; align-items: center; gap: 2px; }
+.group.grow { flex: 1; }
+.group:empty { display: none; }
+.group .label { font: 700 10px/1 var(--mono); letter-spacing: .14em; color: var(--faint); margin-right: 6px; text-transform: uppercase; }
+.bar button, .deck button, .tune button, .recbar button {
+  height: 26px; min-width: 26px; padding: 0 9px; border: 1px solid var(--line2); background: var(--panel2); color: var(--text);
+  font: 700 11px/1 var(--mono); letter-spacing: .06em; text-transform: uppercase; cursor: pointer; border-radius: 2px;
+}
+.bar button:hover, .deck button:hover, .tune button:hover { border-color: var(--faint); background: var(--raise); }
+button.on { background: var(--accent); border-color: var(--accent); color: var(--accent-ink); }
+button.on:hover { background: #ffbd61; border-color: #ffbd61; }
+button:disabled { opacity: .4; cursor: default; }
+button:focus-visible, select:focus-visible, input:focus-visible { outline: 2px solid var(--today); outline-offset: 1px; }
+button.wide { min-width: 64px; }
+button.rec { color: #ff8a95; }
+button.rec.on { background: var(--bad); border-color: var(--bad); color: #fff; }
+.select select { height: 26px; padding: 0 26px 0 9px; border: 1px solid var(--line2); background: var(--panel2) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='10' height='6'%3E%3Cpath d='M0 0l5 6 5-6z' fill='%238d96b0'/%3E%3C/svg%3E") no-repeat right 9px center; appearance: none; font: 700 11px/1 var(--mono); letter-spacing: .04em; border-radius: 2px; max-width: 220px; }
+
+/* ------------------------------------------------------------------ the work area */
+.work { display: grid; grid-template-columns: minmax(0, 1fr) 300px; grid-template-rows: minmax(260px, 1fr) auto; grid-template-areas: "stage tune" "deck tune"; min-height: 0; }
+/* A computer: the whole lab in the window (the tunables scroll in their own column). */
+@media (min-width: 1101px) { body { height: 100vh; min-height: 0; } .tune { min-height: 0; overflow: hidden; } }
+.stage { grid-area: stage; position: relative; overflow: hidden; min-height: 260px;
+  background: radial-gradient(rgba(141, 150, 176, .14) 1px, transparent 1.2px) 0 0 / 18px 18px, #0a0e18; }
+.slot { position: absolute; }
+.slot .frame { position: absolute; left: 0; right: 0; top: 26px; bottom: 34px; overflow: hidden; background: #000; box-shadow: 0 0 0 1px var(--line2), 0 12px 40px rgba(0, 0, 0, .45); }
+.slot iframe { position: absolute; left: 0; top: 0; border: 0; transform-origin: 0 0; background: #000; }
+.slot[data-pane="new"] .frame { box-shadow: 0 0 0 1px rgba(255, 173, 59, .55), 0 12px 40px rgba(0, 0, 0, .45); }
+.slot[data-pane="today"] .frame { box-shadow: 0 0 0 1px rgba(124, 196, 255, .45), 0 12px 40px rgba(0, 0, 0, .45); }
+.slot.ghost { pointer-events: none; }
+.slot.ghost .frame { background: transparent; box-shadow: none; opacity: .5; }
+.slot.ghost .tag { left: auto; right: 0; flex-direction: row-reverse; }
+.slot.ghost .caption { left: auto; right: 0; flex-direction: row-reverse; }
+.tag { position: absolute; left: 0; top: 0; height: 20px; display: flex; align-items: center; gap: 6px; pointer-events: none; max-width: 100%; }
+.tag span { padding: 4px 7px 3px; font: 800 10.5px/1 var(--mono); letter-spacing: .14em; border: 1px solid; background: rgba(8, 11, 18, .86); }
+.tag.new span { color: var(--new); border-color: rgba(255, 173, 59, .7); }
+.tag.today span { color: var(--today); border-color: rgba(124, 196, 255, .6); }
+.tag small { font: 600 10.5px/1.2 var(--mono); color: var(--dim); background: rgba(8, 11, 18, .7); padding: 3px 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.caption { position: absolute; left: 0; bottom: 0; height: 26px; display: flex; gap: 6px; align-items: stretch; pointer-events: none; max-width: 100%; }
+.caption:empty { display: none; }
+.caption b { padding: 5px 8px 4px; font: 800 12.5px/1 var(--mono); letter-spacing: .2em; border: 2px solid; background: rgba(8, 11, 18, .88); }
+.caption span { padding: 6px 9px; font: 700 11.5px/1 var(--mono); color: var(--text); border: 1px solid var(--line2); background: rgba(8, 11, 18, .82); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.veil { position: absolute; left: 0; right: 0; top: 26px; bottom: 34px; display: grid; place-items: center; padding: 18px; text-align: center; background: rgba(8, 11, 18, .82); font: 600 12.5px/1.5 var(--mono); color: var(--dim); }
+.veil b { display: block; color: var(--text); margin-bottom: 6px; letter-spacing: .1em; }
+.recbar { position: absolute; left: 50%; top: 10px; transform: translateX(-50%); display: flex; align-items: center; gap: 10px; padding: 6px 8px 6px 12px; background: rgba(40, 8, 14, .92); border: 1px solid var(--bad); font: 700 11px/1 var(--mono); letter-spacing: .06em; text-transform: uppercase; z-index: 3; }
+.recbar .dot { width: 9px; height: 9px; border-radius: 50%; background: var(--bad); animation: blink 1s steps(2, start) infinite; }
+
+/* ------------------------------------------------------------------ tunables */
+.tune { grid-area: tune; display: flex; flex-direction: column; min-height: 0; background: var(--panel); border-left: 1px solid var(--line); }
+.tune-head { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; padding: 12px 14px 8px; font: 800 11px/1 var(--mono); letter-spacing: .2em; }
+.tune-head small { font: 600 10.5px/1 var(--mono); letter-spacing: 0; color: var(--faint); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.tune-list { flex: 1; overflow: auto; padding: 0 14px 10px; }
+.tune-group { margin: 12px 0 4px; font: 700 10px/1 var(--mono); letter-spacing: .18em; color: var(--faint); text-transform: uppercase; }
+.knob { padding: 9px 0 10px; border-bottom: 1px solid var(--line); }
+.knob .row { display: flex; align-items: baseline; gap: 8px; }
+.knob .name { font: 700 12px/1.2 var(--mono); color: var(--text); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.knob.changed .name::before { content: ""; display: inline-block; width: 6px; height: 6px; margin-right: 6px; background: var(--accent); transform: rotate(45deg) translateY(-1px); }
+.knob .val { margin-left: auto; font: 800 12px/1 var(--mono); color: var(--new); font-variant-numeric: tabular-nums; }
+.knob .unit { font: 600 10.5px/1 var(--mono); color: var(--faint); }
+.knob .was { display: block; margin-top: 3px; font: 600 10.5px/1.3 var(--mono); color: var(--today); }
+.knob .note { display: block; margin-top: 3px; font: 12px/1.35 var(--sans); color: var(--dim); }
+.knob .track { position: relative; margin-top: 8px; height: 18px; }
+.knob input[type=range] { position: absolute; inset: 0; width: 100%; margin: 0; appearance: none; background: transparent; cursor: pointer; }
+.knob input[type=range]::-webkit-slider-runnable-track { height: 4px; background: linear-gradient(90deg, var(--accent) var(--fill, 50%), var(--line2) var(--fill, 50%)); border-radius: 2px; }
+.knob input[type=range]::-moz-range-track { height: 4px; background: var(--line2); border-radius: 2px; }
+.knob input[type=range]::-moz-range-progress { height: 4px; background: var(--accent); }
+.knob input[type=range]::-webkit-slider-thumb { appearance: none; width: 14px; height: 14px; margin-top: -5px; background: var(--text); border: 2px solid var(--accent); transform: rotate(45deg); }
+.knob input[type=range]::-moz-range-thumb { width: 12px; height: 12px; background: var(--text); border: 2px solid var(--accent); border-radius: 0; }
+.knob .tick { position: absolute; top: 1px; width: 2px; height: 16px; background: var(--today); pointer-events: none; box-shadow: 0 0 0 1px rgba(8, 11, 18, .8); }
+.tune-foot { display: flex; gap: 6px; padding: 10px 14px max(12px, env(safe-area-inset-bottom)); border-top: 1px solid var(--line); }
+.tune-foot .primary { flex: 1; }
+.tune-foot .primary:not(:disabled) { background: var(--accent); border-color: var(--accent); color: var(--accent-ink); }
+.tune-empty { margin: 8px 0; font: 12.5px/1.5 var(--sans); color: var(--dim); }
+.tune-empty code { font: 600 11.5px/1 var(--mono); color: var(--text); }
+
+/* ------------------------------------------------------------------ timeline and graph */
+.deck { grid-area: deck; padding: 10px 14px 12px; background: var(--panel); border-top: 1px solid var(--line); min-width: 0; }
+.transport { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; row-gap: 8px; }
+.counter { margin-left: auto; font: 800 13px/1 var(--mono); letter-spacing: .12em; color: var(--accent); font-variant-numeric: tabular-nums; white-space: nowrap; }
+.legend { display: flex; gap: 14px; margin: 10px 0 6px; font: 700 10px/1 var(--mono); letter-spacing: .16em; color: var(--dim); text-transform: uppercase; flex-wrap: wrap; }
+.legend i { display: inline-block; width: 9px; height: 9px; margin-right: 6px; vertical-align: -1px; }
+.legend .right { margin-left: auto; letter-spacing: .08em; }
+.lines { position: relative; }
+.lines canvas { display: block; width: 100%; cursor: ew-resize; touch-action: none; }
+#timeline { height: 58px; }
+#graph { height: 132px; margin-top: 4px; }
+.tracks { display: flex; gap: 2px; margin-top: 10px; flex-wrap: wrap; }
+.tracks button { height: 22px; font-size: 10.5px; }
+.hint { margin: 8px 0 0; font: 12px/1.4 var(--sans); color: var(--dim); min-height: 1em; }
+.hint code { font: 600 11px/1 var(--mono); color: var(--text); }
+
+/* ------------------------------------------------------------------ a phone, or a narrow window */
+@media (max-width: 1100px) {
+  .work { grid-template-columns: minmax(0, 1fr); grid-template-rows: auto auto auto; grid-template-areas: "stage" "deck" "tune"; }
+  .stage { height: min(62vh, 620px); }
+  .tune { border-left: 0; border-top: 1px solid var(--line); }
+  .tune-list { max-height: none; }
+}
+@media (max-width: 640px) {
+  .bar { padding: 7px 10px; }
+  .bar.top { flex-wrap: wrap; row-gap: 6px; }
+  .title { flex-basis: 100%; }
+  .title #take-name { overflow: hidden; text-overflow: ellipsis; }
+  .status { margin-left: 0; width: 100%; justify-content: flex-start; }
+  .legend .right { display: none; }
+  .tools { flex-wrap: nowrap; overflow-x: auto; scrollbar-width: none; }
+  .tools::-webkit-scrollbar { display: none; }
+  .group.grow { display: none; }
+  .stage { height: 58vh; min-height: 300px; }
+  .deck { padding: 10px 10px 12px; }
+  .transport { gap: 8px; }
+  .counter { width: 100%; margin-left: 0; order: -1; font-size: 14px; }
+  .bar button, .deck button, .tune button { height: 32px; min-width: 32px; padding: 0 9px; }
+  .caption b { font-size: 12px; padding: 5px 7px 4px; }
+  .caption span { font-size: 11px; padding: 5px 7px; }
+  #graph { height: 116px; }
+}
+
+/* ------------------------------------------------------------------ the index of games */
+body.index { display: block; }
+body.index main { max-width: 640px; margin: 10vh auto; padding: 0 20px; }
+body.index .brand { margin: 0 0 18px; }
+body.index h1 { font: 800 28px/1.1 var(--sans); margin: 0 0 18px; }
+body.index .games { list-style: none; padding: 0; margin: 0; border-top: 1px solid var(--line); }
+body.index .games li { padding: 14px 0; border-bottom: 1px solid var(--line); }
+body.index .games a { color: var(--accent); font: 700 15px/1 var(--mono); text-decoration: none; letter-spacing: .04em; }
+body.index .games small { margin-left: 10px; color: var(--faint); font: 600 11px/1 var(--mono); }