@typeonce/ritmo-tools 0.17.0 → 0.19.0

package/dist/sound/core/measure.js

@@ -0,0 +1,138 @@
+import { fft, render } from "./render.js";
+const db = (amplitude) => (amplitude <= 1e-9 ? -180 : 20 * Math.log10(amplitude));
+const round = (value, digits = 1) => Math.round(value * 10 ** digits) / 10 ** digits;
+export const measure = ({ samples, sampleRate }) => {
+    let peak = 0;
+    for (const x of samples)
+        peak = Math.max(peak, Math.abs(x));
+    let last = 0;
+    const quiet = 0.001;
+    for (let i = samples.length - 1; i >= 0; i--) {
+        if (Math.abs(samples[i]) >= quiet) {
+            last = i + 1;
+            break;
+        }
+    }
+    let first = 0;
+    while (first < samples.length && Math.abs(samples[first]) < peak * 0.1)
+        first++;
+    // The loudest 50 ms, in steps of 5 ms.
+    const window = Math.round(sampleRate * 0.05);
+    const hop = Math.round(sampleRate * 0.005);
+    let loudest = 0;
+    let loudestAt = 0;
+    for (let start = 0; start < Math.max(1, samples.length - window + 1); start += hop) {
+        let sum = 0;
+        const end = Math.min(samples.length, start + window);
+        for (let i = start; i < end; i++)
+            sum += samples[i] * samples[i];
+        const rms = Math.sqrt(sum / window);
+        if (rms > loudest) {
+            loudest = rms;
+            loudestAt = start;
+        }
+    }
+    const tail = Math.round(sampleRate * 0.001);
+    let ending = 0;
+    for (let i = Math.max(0, last - tail); i < last; i++)
+        ending = Math.max(ending, Math.abs(samples[i]));
+    return {
+        duration: round(last / sampleRate, 3),
+        peak: round(db(peak)),
+        loudness: round(db(loudest)),
+        attack: round((first / sampleRate) * 1000),
+        brightness: Math.round(centroid(samples, sampleRate, loudestAt, window)),
+        ending: round(db(ending))
+    };
+};
+/** The spectral centroid of `size` samples from `start` (Hann windowed, zero-padded to a power of two). */
+const centroid = (samples, sampleRate, start, size) => {
+    let n = 1;
+    while (n < size)
+        n <<= 1;
+    const re = new Float64Array(n);
+    const im = new Float64Array(n);
+    for (let i = 0; i < size && start + i < samples.length; i++)
+        re[i] = samples[start + i] * (0.5 - 0.5 * Math.cos((2 * Math.PI * i) / (size - 1)));
+    fft(re, im, false);
+    let weighted = 0;
+    let total = 0;
+    for (let k = 1; k < n / 2; k++) {
+        const magnitude = Math.hypot(re[k], im[k]);
+        weighted += magnitude * ((k * sampleRate) / n);
+        total += magnitude;
+    }
+    return total === 0 ? 0 : weighted / total;
+};
+/** Limits a sound is checked against. */
+export const limits = {
+    /** A sound quieter than this at its peak is not heard in a game (dBFS). */
+    silent: -40,
+    /** Past full scale, samples are clipped: the sound distorts (dBFS). */
+    clipping: 0,
+    /** A game sound must answer an action at once: later than this (ms) feels late (a swing's whoosh builds for about 60). */
+    lateStart: 80,
+    /** Longer than this (s) is long for an effect. */
+    long: 3,
+    /** A last millisecond louder than this (dBFS) ends with a click. */
+    endClick: -40,
+    /** Louder or quieter than the middle of its kind (heavy or not) by this many dB stands out. */
+    louder: 10,
+    quieter: 14
+};
+/** The issues of one sound, given the middle loudness of its kind in the bank (the median of the heavy sounds, or of the others). */
+export const issuesOf = (recipe, measures, middle) => {
+    const issues = [];
+    if (recipe.layers.length === 0)
+        return [{ rule: "empty", severity: "error", message: "No layers: the sound is silent." }];
+    if (measures.peak < limits.silent)
+        issues.push({ rule: "silent", severity: "error", message: `Peaks at ${measures.peak} dBFS: too quiet to be heard. Raise the layers' gain.` });
+    if (measures.peak > limits.clipping)
+        issues.push({ rule: "clipping", severity: "error", message: `Peaks at +${measures.peak} dBFS: it clips and distorts. Lower the gain (or the tune's volume) by ${Math.ceil(measures.peak + 1)} dB.` });
+    if (measures.attack > limits.lateStart)
+        issues.push({
+            rule: "late-start",
+            severity: "warning",
+            message: `Reaches a tenth of its peak after ${measures.attack} ms: it will feel late if it answers an action (fine for a swell). Shorten the first layer's attack, or start a layer at once.`
+        });
+    if (measures.duration > limits.long)
+        issues.push({ rule: "long", severity: "warning", message: `Lasts ${measures.duration} s, long for an effect.` });
+    if (measures.ending > limits.endClick)
+        issues.push({ rule: "end-click", severity: "warning", message: `Stops abruptly (${measures.ending} dBFS in its last millisecond): it ends with a click.` });
+    if (middle !== undefined && measures.loudness > middle + limits.louder)
+        issues.push({ rule: "too-loud", severity: "warning", message: `${round(measures.loudness - middle)} dB louder than the middle of its kind (${middle} dBFS${recipe.heavy === true ? ", heavy sounds" : ""}): it will stand out.` });
+    if (middle !== undefined && measures.loudness < middle - limits.quieter)
+        issues.push({ rule: "too-quiet", severity: "warning", message: `${round(middle - measures.loudness)} dB quieter than the middle of its kind (${middle} dBFS${recipe.heavy === true ? ", heavy sounds" : ""}): it may get lost.` });
+    return issues;
+};
+const median = (values) => {
+    if (values.length === 0)
+        return undefined;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return round(sorted.length % 2 === 1 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2);
+};
+/** Measures every sound (or the named ones) of a bank, each against the whole bank's middle loudness. */
+export const checkBank = (bank, names) => {
+    const all = Object.entries(bank.sounds).map(([name, recipe]) => ({ name, recipe, measures: measure(render(recipe, { master: bank.master })) }));
+    const kind = (heavy) => all.filter((entry) => entry.recipe.layers.length > 0 && (entry.recipe.heavy === true) === heavy).map((entry) => entry.measures.loudness);
+    const heavy = kind(true);
+    const other = kind(false);
+    // A kind of fewer than three sounds has no middle to stand out from.
+    const middle = { heavy: heavy.length >= 3 ? median(heavy) : undefined, other: other.length >= 3 ? median(other) : undefined };
+    const chosen = names === undefined || names.length === 0 ? all : all.filter((entry) => names.includes(entry.name));
+    const sounds = chosen.map(({ name, recipe, measures }) => ({
+        name,
+        about: recipe.about,
+        ...measures,
+        issues: issuesOf(recipe, measures, recipe.heavy === true ? middle.heavy : middle.other)
+    }));
+    const errors = sounds.reduce((n, sound) => n + sound.issues.filter((issue) => issue.severity === "error").length, 0);
+    const warnings = sounds.reduce((n, sound) => n + sound.issues.filter((issue) => issue.severity === "warning").length, 0);
+    const verdict = errors > 0 ? "errors" : warnings > 0 ? "warnings" : "clean";
+    const summary = verdict === "clean"
+        ? `${sounds.length} sound${sounds.length === 1 ? "" : "s"}, nothing to fix.`
+        : `${sounds.length} sound${sounds.length === 1 ? "" : "s"}: ${errors} error${errors === 1 ? "" : "s"}, ${warnings} warning${warnings === 1 ? "" : "s"}.`;
+    return { verdict, summary, middle, sounds };
+};
+//# sourceMappingURL=measure.js.map

package/dist/sound/core/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.js","sourceRoot":"","sources":["../../../src/sound/core/measure.ts"],"names":[],"mappings":"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"}

package/dist/sound/core/recipe.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Sound recipes: a game sound as plain JSON, a few layers built from small
+ * instruments, mixed into a room. The renderer (`render.ts`) turns a recipe
+ * into samples the same way in Node and in the browser, so what the page
+ * plays, what the CLI measures, and what the game plays are one sound.
+ *
+ * ```json
+ * {
+ *   "reverb": 0.12,
+ *   "layers": [
+ *     { "type": "click", "gain": 0.45 },
+ *     { "type": "tone", "wave": "sine", "from": 160, "to": 55, "duration": 0.12, "gain": 0.65, "attack": 0.002 },
+ *     { "type": "crunch", "from": 1500, "to": 500, "duration": 0.07, "gain": 0.3 }
+ *   ]
+ * }
+ * ```
+ *
+ * A bank is a file of named recipes (`{"version": 1, "master": 0.6,
+ * "sounds": {...}}`): the game's sounds, one file, and the master volume the
+ * game plays them at.
+ */
+export type Wave = "sine" | "triangle" | "square" | "sawtooth";
+export declare const waves: ReadonlyArray<Wave>;
+export type Filter = "lowpass" | "highpass" | "bandpass";
+export declare const filters: ReadonlyArray<Filter>;
+/** Every layer starts `delay` seconds after the sound does, and fades in over `attack` seconds. */
+interface Timed {
+    readonly delay: number;
+    readonly gain: number;
+}
+/** A tone gliding from `from` to `to` Hz over its duration, fading in and dying away: thuds, notes, hums. */
+export interface ToneLayer extends Timed {
+    readonly type: "tone";
+    readonly wave: Wave;
+    readonly from: number;
+    readonly to: number;
+    readonly duration: number;
+    readonly attack: number;
+}
+/** A burst of noise through a filter gliding from `from` to `to` Hz: air, debris, hiss, rumble. */
+export interface NoiseLayer extends Timed {
+    readonly type: "noise";
+    readonly filter: Filter;
+    readonly from: number;
+    readonly to: number;
+    /** How narrow the band (bandpass), or how much the cutoff rings (lowpass, highpass, in dB). */
+    readonly q: number;
+    readonly duration: number;
+    readonly attack: number;
+}
+/**
+ * A swing through the air: a band of noise rising from `low` to `peak` Hz
+ * as the swing speeds up, loudest at `peakAt` (a share of the duration),
+ * then falling away.
+ */
+export interface SwishLayer extends Timed {
+    readonly type: "swish";
+    readonly low: number;
+    readonly peak: number;
+    readonly peakAt: number;
+    readonly q: number;
+    readonly duration: number;
+}
+/** Distorted band-passed noise gliding from `from` to `to` Hz: the crack of a blow. */
+export interface CrunchLayer extends Timed {
+    readonly type: "crunch";
+    readonly from: number;
+    readonly to: number;
+    readonly duration: number;
+}
+/** A metallic ring: inharmonic partials of `pitch` Hz, the higher ones dying first. */
+export interface MetalLayer extends Timed {
+    readonly type: "metal";
+    readonly pitch: number;
+    readonly duration: number;
+}
+/** The contact of a blow: a very short, bright tick. */
+export interface ClickLayer extends Timed {
+    readonly type: "click";
+}
+export type Layer = ToneLayer | NoiseLayer | SwishLayer | CrunchLayer | MetalLayer | ClickLayer;
+export type LayerType = Layer["type"];
+export declare const layerTypes: ReadonlyArray<LayerType>;
+/**
+ * Broad changes over the whole sound, made by the person with sliders, kept
+ * apart from the layers so they can be read and undone at a glance.
+ */
+export interface Tune {
+    /** Semitones up (or down): every frequency, tones and filters. */
+    readonly pitch: number;
+    /** Every duration and delay times this. */
+    readonly length: number;
+    /** Semitones up (or down) for the filters only: brighter or darker without changing the notes. */
+    readonly brightness: number;
+    /** Added to the room's share (0 to 1 in all). */
+    readonly echo: number;
+    /** Decibels up (or down). */
+    readonly volume: number;
+}
+export declare const neutralTune: Tune;
+export interface Recipe {
+    /** What the sound is for, in a few words: the agent's intent, shown to the person. */
+    readonly about?: string | undefined;
+    /** How much of the sound goes to the room, 0 to 1. */
+    readonly reverb: number;
+    /** A heavy sound turns the others down for a moment (the game's mixer reads this). */
+    readonly heavy?: boolean | undefined;
+    /** The least time between two plays, in seconds (the game's mixer reads this). */
+    readonly interval?: number | undefined;
+    readonly layers: ReadonlyArray<Layer>;
+    readonly tune?: Tune | undefined;
+}
+export interface Bank {
+    /** The game's master volume over every sound, 1 by default: sounds are measured as the game plays them. */
+    readonly master?: number | undefined;
+    readonly sounds: Readonly<Record<string, Recipe>>;
+}
+export type Decoded<A> = {
+    readonly ok: true;
+    readonly value: A;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+/** Reads one recipe from parsed JSON; `at` names it in errors. */
+export declare const decodeRecipeValue: (raw: unknown, at: string, errors: Array<string>) => Recipe | undefined;
+/** Reads one recipe written by `encodeRecipe` (or by hand). */
+export declare const decodeRecipe: (text: string) => Decoded<Recipe>;
+/** Sound names are ids the game's code refers to: letters, digits, `-`, `_`, and `.`. */
+export declare const isSoundName: (name: string) => boolean;
+/** Reads a bank file: `{"version": 1, "sounds": {"name": recipe, ...}}`, reporting every problem at once. */
+export declare const decodeBank: (text: string) => Decoded<Bank>;
+/** A recipe as JSON values, with defaults and empty fields left out, so files stay short. */
+export declare const recipeValue: (recipe: Recipe) => Record<string, unknown>;
+export declare const isNeutral: (tune: Tune) => boolean;
+export declare const encodeRecipe: (recipe: Recipe) => string;
+export declare const encodeBank: (bank: Bank) => string;
+/** The recipe with its tune folded into the layers: what the renderer plays, and what a game without tunes would ship. */
+export declare const applyTune: (recipe: Recipe) => Recipe;
+/** A layer in a few words, for lists: "tone sine 160→55 Hz, 0.12 s". */
+export declare const describeLayer: (layer: Layer) => string;
+export {};
+//# sourceMappingURL=recipe.d.ts.map

package/dist/sound/core/recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../src/sound/core/recipe.ts"],"names":[],"mappings":"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"}

package/dist/sound/core/recipe.js

@@ -0,0 +1,292 @@
+/**
+ * Sound recipes: a game sound as plain JSON, a few layers built from small
+ * instruments, mixed into a room. The renderer (`render.ts`) turns a recipe
+ * into samples the same way in Node and in the browser, so what the page
+ * plays, what the CLI measures, and what the game plays are one sound.
+ *
+ * ```json
+ * {
+ *   "reverb": 0.12,
+ *   "layers": [
+ *     { "type": "click", "gain": 0.45 },
+ *     { "type": "tone", "wave": "sine", "from": 160, "to": 55, "duration": 0.12, "gain": 0.65, "attack": 0.002 },
+ *     { "type": "crunch", "from": 1500, "to": 500, "duration": 0.07, "gain": 0.3 }
+ *   ]
+ * }
+ * ```
+ *
+ * A bank is a file of named recipes (`{"version": 1, "master": 0.6,
+ * "sounds": {...}}`): the game's sounds, one file, and the master volume the
+ * game plays them at.
+ */
+export const waves = ["sine", "triangle", "square", "sawtooth"];
+export const filters = ["lowpass", "highpass", "bandpass"];
+export const layerTypes = ["tone", "noise", "swish", "crunch", "metal", "click"];
+export const neutralTune = { pitch: 0, length: 1, brightness: 0, echo: 0, volume: 0 };
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** Reads values out of untrusted JSON, collecting every problem with where it is. */
+const reader = (errors) => {
+    const number = (value, name, fallback, min, max) => {
+        if (value === undefined) {
+            if (fallback === undefined)
+                errors.push(`${name} is missing`);
+            return fallback ?? 0;
+        }
+        if (typeof value !== "number" || !Number.isFinite(value)) {
+            errors.push(`${name} must be a number`);
+            return fallback ?? 0;
+        }
+        if (min !== undefined && value < min)
+            errors.push(`${name} must be at least ${min}`);
+        if (max !== undefined && value > max)
+            errors.push(`${name} must be at most ${max}`);
+        return value;
+    };
+    const oneOf = (value, name, options, fallback) => {
+        if (value === undefined)
+            return fallback;
+        const found = options.find((option) => option === value);
+        if (found !== undefined)
+            return found;
+        errors.push(`${name} must be one of ${options.join(", ")}`);
+        return fallback;
+    };
+    return { number, oneOf };
+};
+/** The highest frequency a layer may ask for: past it, nothing is heard at 44.1 kHz. */
+const NYQUIST = 20000;
+const decodeLayer = (raw, at, errors) => {
+    if (!isRecord(raw)) {
+        errors.push(`${at} must be an object`);
+        return undefined;
+    }
+    const { number, oneOf } = reader(errors);
+    const type = raw.type;
+    const delay = number(raw.delay, `${at}.delay`, 0, 0);
+    const gain = number(raw.gain, `${at}.gain`, undefined, 0, 4);
+    const hz = (key, fallback) => number(raw[key], `${at}.${key}`, fallback, 1, NYQUIST);
+    const duration = () => number(raw.duration, `${at}.duration`, undefined, 0.001, 10);
+    switch (type) {
+        case "tone":
+            return {
+                type,
+                wave: oneOf(raw.wave, `${at}.wave`, waves, "sine"),
+                from: hz("from"),
+                to: hz("to", typeof raw.from === "number" ? raw.from : undefined),
+                duration: duration(),
+                gain,
+                delay,
+                attack: number(raw.attack, `${at}.attack`, 0.006, 0.0005)
+            };
+        case "noise":
+            return {
+                type,
+                filter: oneOf(raw.filter, `${at}.filter`, filters, "lowpass"),
+                from: hz("from"),
+                to: hz("to", typeof raw.from === "number" ? raw.from : undefined),
+                q: number(raw.q, `${at}.q`, 1, 0.01, 40),
+                duration: duration(),
+                gain,
+                delay,
+                attack: number(raw.attack, `${at}.attack`, 0.004, 0.0005)
+            };
+        case "swish":
+            return {
+                type,
+                low: hz("low"),
+                peak: hz("peak"),
+                peakAt: number(raw.peakAt, `${at}.peakAt`, 0.4, 0.01, 0.99),
+                q: number(raw.q, `${at}.q`, 1, 0.01, 40),
+                duration: duration(),
+                gain,
+                delay
+            };
+        case "crunch":
+            return { type, from: hz("from"), to: hz("to", typeof raw.from === "number" ? raw.from : undefined), duration: duration(), gain, delay };
+        case "metal":
+            return { type, pitch: hz("pitch"), duration: duration(), gain, delay };
+        case "click":
+            return { type, gain, delay };
+        default:
+            errors.push(`${at}.type must be one of ${layerTypes.join(", ")}`);
+            return undefined;
+    }
+};
+const decodeTune = (raw, at, errors) => {
+    if (raw === undefined)
+        return undefined;
+    if (!isRecord(raw)) {
+        errors.push(`${at} must be an object`);
+        return undefined;
+    }
+    const { number } = reader(errors);
+    return {
+        pitch: number(raw.pitch, `${at}.pitch`, 0, -24, 24),
+        length: number(raw.length, `${at}.length`, 1, 0.25, 4),
+        brightness: number(raw.brightness, `${at}.brightness`, 0, -24, 24),
+        echo: number(raw.echo, `${at}.echo`, 0, -1, 1),
+        volume: number(raw.volume, `${at}.volume`, 0, -40, 24)
+    };
+};
+/** Reads one recipe from parsed JSON; `at` names it in errors. */
+export const decodeRecipeValue = (raw, at, errors) => {
+    if (!isRecord(raw)) {
+        errors.push(`${at} must be an object`);
+        return undefined;
+    }
+    const { number } = reader(errors);
+    if (!Array.isArray(raw.layers)) {
+        errors.push(`${at}.layers must be a list`);
+        return undefined;
+    }
+    const layers = raw.layers.flatMap((layer, i) => decodeLayer(layer, `${at}.layers[${i}]`, errors) ?? []);
+    if (raw.about !== undefined && typeof raw.about !== "string")
+        errors.push(`${at}.about must be text`);
+    if (raw.heavy !== undefined && typeof raw.heavy !== "boolean")
+        errors.push(`${at}.heavy must be true or false`);
+    const recipe = {
+        about: typeof raw.about === "string" ? raw.about : undefined,
+        reverb: number(raw.reverb, `${at}.reverb`, 0, 0, 1),
+        heavy: raw.heavy === true ? true : undefined,
+        interval: raw.interval === undefined ? undefined : number(raw.interval, `${at}.interval`, 0, 0),
+        layers,
+        tune: decodeTune(raw.tune, `${at}.tune`, errors)
+    };
+    return recipe;
+};
+const parse = (text) => {
+    try {
+        return { ok: true, value: JSON.parse(text) };
+    }
+    catch (error) {
+        return { ok: false, error: `not JSON: ${error instanceof Error ? error.message : String(error)}` };
+    }
+};
+/** Reads one recipe written by `encodeRecipe` (or by hand). */
+export const decodeRecipe = (text) => {
+    const parsed = parse(text);
+    if (!parsed.ok)
+        return parsed;
+    const errors = [];
+    const recipe = decodeRecipeValue(parsed.value, "recipe", errors);
+    return recipe === undefined || errors.length > 0 ? { ok: false, error: errors.join("; ") } : { ok: true, value: recipe };
+};
+/** Sound names are ids the game's code refers to: letters, digits, `-`, `_`, and `.`. */
+export const isSoundName = (name) => /^[A-Za-z][\w.-]{0,63}$/.test(name);
+/** Reads a bank file: `{"version": 1, "sounds": {"name": recipe, ...}}`, reporting every problem at once. */
+export const decodeBank = (text) => {
+    const parsed = parse(text);
+    if (!parsed.ok)
+        return parsed;
+    const raw = parsed.value;
+    if (!isRecord(raw) || !isRecord(raw.sounds))
+        return { ok: false, error: 'a bank is {"version": 1, "sounds": {"name": recipe, ...}}' };
+    if (raw.version !== undefined && raw.version !== 1)
+        return { ok: false, error: `bank version ${String(raw.version)} is not known (this tool reads version 1)` };
+    const errors = [];
+    const sounds = {};
+    for (const [name, value] of Object.entries(raw.sounds)) {
+        if (!isSoundName(name))
+            errors.push(`"${name}" is not a sound name (letters, digits, -, _, and ., starting with a letter)`);
+        const recipe = decodeRecipeValue(value, name, errors);
+        if (recipe !== undefined)
+            sounds[name] = recipe;
+    }
+    const master = raw.master === undefined ? undefined : reader(errors).number(raw.master, "master", 1, 0.01, 4);
+    return errors.length > 0 ? { ok: false, error: errors.join("; ") } : { ok: true, value: { master, sounds } };
+};
+/** A recipe as JSON values, with defaults and empty fields left out, so files stay short. */
+export const recipeValue = (recipe) => {
+    const layers = recipe.layers.map((layer) => {
+        const { delay, ...rest } = layer;
+        const out = { ...rest };
+        if (delay !== 0)
+            out.delay = delay;
+        return out;
+    });
+    const tune = recipe.tune === undefined || isNeutral(recipe.tune) ? undefined : recipe.tune;
+    return {
+        ...(recipe.about === undefined ? {} : { about: recipe.about }),
+        reverb: recipe.reverb,
+        ...(recipe.heavy === true ? { heavy: true } : {}),
+        ...(recipe.interval === undefined ? {} : { interval: recipe.interval }),
+        layers,
+        ...(tune === undefined ? {} : { tune })
+    };
+};
+export const isNeutral = (tune) => tune.pitch === 0 && tune.length === 1 && tune.brightness === 0 && tune.echo === 0 && tune.volume === 0;
+/**
+ * JSON with each layer on one line: a bank is read and diffed by people and
+ * agents, and a layer is one thought.
+ */
+const write = (value, indent) => {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "[]";
+        return `[\n${value.map((item) => `${indent}  ${JSON.stringify(item)}`).join(",\n")}\n${indent}]`;
+    }
+    if (isRecord(value)) {
+        const entries = Object.entries(value).filter(([, item]) => item !== undefined);
+        if (entries.length === 0)
+            return "{}";
+        return `{\n${entries.map(([key, item]) => `${indent}  ${JSON.stringify(key)}: ${key === "tune" ? JSON.stringify(item) : write(item, `${indent}  `)}`).join(",\n")}\n${indent}}`;
+    }
+    return JSON.stringify(value);
+};
+export const encodeRecipe = (recipe) => write(recipeValue(recipe), "") + "\n";
+export const encodeBank = (bank) => {
+    const sounds = {};
+    for (const [name, recipe] of Object.entries(bank.sounds))
+        sounds[name] = recipeValue(recipe);
+    return write({ version: 1, ...(bank.master === undefined ? {} : { master: bank.master }), sounds }, "") + "\n";
+};
+/** The recipe with its tune folded into the layers: what the renderer plays, and what a game without tunes would ship. */
+export const applyTune = (recipe) => {
+    const tune = recipe.tune;
+    if (tune === undefined || isNeutral(tune))
+        return recipe;
+    const pitch = Math.pow(2, tune.pitch / 12);
+    const bright = pitch * Math.pow(2, tune.brightness / 12);
+    const gain = Math.pow(10, tune.volume / 20);
+    const time = tune.length;
+    const layers = recipe.layers.map((layer) => {
+        const delay = layer.delay * time;
+        const g = layer.gain * gain;
+        switch (layer.type) {
+            case "tone":
+                return { ...layer, from: clampHz(layer.from * pitch), to: clampHz(layer.to * pitch), duration: layer.duration * time, attack: layer.attack * time, delay, gain: g };
+            case "noise":
+                return { ...layer, from: clampHz(layer.from * bright), to: clampHz(layer.to * bright), duration: layer.duration * time, attack: layer.attack * time, delay, gain: g };
+            case "swish":
+                return { ...layer, low: clampHz(layer.low * bright), peak: clampHz(layer.peak * bright), duration: layer.duration * time, delay, gain: g };
+            case "crunch":
+                return { ...layer, from: clampHz(layer.from * bright), to: clampHz(layer.to * bright), duration: layer.duration * time, delay, gain: g };
+            case "metal":
+                return { ...layer, pitch: clampHz(layer.pitch * pitch), duration: layer.duration * time, delay, gain: g };
+            case "click":
+                return { ...layer, delay, gain: g };
+        }
+    });
+    return { ...recipe, reverb: Math.min(1, Math.max(0, recipe.reverb + tune.echo)), layers, tune: undefined };
+};
+const clampHz = (hz) => Math.min(NYQUIST, Math.max(1, hz));
+/** A layer in a few words, for lists: "tone sine 160→55 Hz, 0.12 s". */
+export const describeLayer = (layer) => {
+    const s = (seconds) => `${seconds < 0.1 ? Math.round(seconds * 1000) + " ms" : Math.round(seconds * 100) / 100 + " s"}`;
+    const glide = (from, to) => (Math.round(from) === Math.round(to) ? `${Math.round(from)} Hz` : `${Math.round(from)}→${Math.round(to)} Hz`);
+    switch (layer.type) {
+        case "tone":
+            return `${layer.wave} ${glide(layer.from, layer.to)}, ${s(layer.duration)}`;
+        case "noise":
+            return `${layer.filter} ${glide(layer.from, layer.to)}, ${s(layer.duration)}`;
+        case "swish":
+            return `${Math.round(layer.low)}→${Math.round(layer.peak)} Hz, ${s(layer.duration)}`;
+        case "crunch":
+            return `${glide(layer.from, layer.to)}, ${s(layer.duration)}`;
+        case "metal":
+            return `${Math.round(layer.pitch)} Hz, ${s(layer.duration)}`;
+        case "click":
+            return "tick";
+    }
+};
+//# sourceMappingURL=recipe.js.map

package/dist/sound/core/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../../src/sound/core/recipe.ts"],"names":[],"mappings":"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"}