@rydr/game-sdk 3.18.0 → 3.19.1

package/dist/protocol/version.d.ts

@@ -9,5 +9,5 @@
 export declare const RYDR_PROTOCOL_VERSION: 16;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export declare const RYDR_SDK_VERSION = "3.18.0";
+export declare const RYDR_SDK_VERSION = "3.19.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/protocol/version.js

@@ -52,5 +52,5 @@
 export const RYDR_PROTOCOL_VERSION = 16;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export const RYDR_SDK_VERSION = "3.18.0";
+export const RYDR_SDK_VERSION = "3.19.1";
 //# sourceMappingURL=version.js.map

package/dist/sound-gallery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sound-gallery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAoB,KAAK,UAAU,EAAsB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG7G,+FAA+F;AAC/F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACpC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,0DAA0D;IAC1D,UAAU,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,kFAAkF;IAClF,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AACD,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAoGD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAwoC5F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sound-gallery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAoB,KAAK,UAAU,EAAsB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkB7G,+FAA+F;AAC/F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACpC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,0DAA0D;IAC1D,UAAU,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,kFAAkF;IAClF,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AACD,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAqHD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAq2C5F"}

package/dist/sound-gallery/index.js

@@ -12,7 +12,21 @@
  * browser.
  */
 import { SOUND_CATEGORIES } from "../sounds/types.js";
-import { computePeaks, cropBuffer, decodeAudio, encodeMp3, peakDb, trimLeadingSilence } from "../sounds/audio-utils.js";
+import { computePeaks, cropBuffer, dbToGain, decodeAudio, encodeMp3, integratedLufs, peakDb, trimLeadingSilence } from "../sounds/audio-utils.js";
+import { STANDARD_BINDINGS, STANDARD_CUES } from "../sounds/soundboard.js";
+/** Per-category target integrated loudness (LUFS). "Normalize" trims a sound's gainDb to hit its
+ *  channel's target so the library is level-consistent. UI/SFX/voice punchier; beds sit lower. */
+const LUFS_TARGETS = {
+    sfx: -16,
+    ui: -16,
+    voice: -16,
+    music: -20,
+    ambience: -20,
+};
+/** Allowed range for the gain trim slider + Normalize, in dB. */
+const GAIN_MIN = -24;
+const GAIN_MAX = 12;
+const clampGain = (db) => Math.min(GAIN_MAX, Math.max(GAIN_MIN, db));
 const CSS = `
 .rydr-sg{position:fixed;inset:0;display:flex;flex-direction:column;font:14px/1.5 system-ui,sans-serif;color:#e7e9ee;background:#0d0f14}
 .rydr-sg *{box-sizing:border-box}
@@ -83,6 +97,17 @@ const CSS = `
 .rydr-sg-fv-row .nm{font-weight:600;cursor:pointer}
 .rydr-sg-fv-row .nm:hover{color:#6fb4ff}
 .rydr-sg-fv-row .c{margin-left:auto;font-size:10px;text-transform:uppercase;letter-spacing:.06em;color:#8b93a7;border:1px solid #2a3242;border-radius:999px;padding:1px 7px}
+.rydr-sg-gain{display:flex;align-items:center;gap:10px}
+.rydr-sg-gain input[type=range]{width:150px;accent-color:#3f74ee}
+.rydr-sg-gain input[type=number]{width:64px;padding:7px 8px;border-radius:8px;border:1px solid #2a3242;background:#12151d;color:#e7e9ee;font:inherit}
+.rydr-sg-ref{margin:12px 0;padding-top:12px;border-top:1px solid #1a1e28}
+.rydr-sg-ref-lbl{font-size:11px;text-transform:uppercase;letter-spacing:.06em;color:#8b93a7;margin-bottom:8px}
+.rydr-sg-ref-row{display:flex;gap:8px;flex-wrap:wrap;align-items:center}
+.rydr-sg-chip{padding:6px 11px;border-radius:999px;border:1px solid #2a3242;background:#12151d;color:#c4cbd8;cursor:pointer;font:inherit;font-size:12px}
+.rydr-sg-chip:hover{border-color:#3f74ee;color:#fff}
+.rydr-sg-chip.on{background:#16233c;border-color:#3f74ee;color:#fff}
+.rydr-sg-chip:disabled{opacity:.5;cursor:default}
+.rydr-sg-ref-none{color:#6b7385;font-size:12px}
 `;
 const STYLE_ID = "rydr-sg-style";
 function ensureStyle() {
@@ -102,6 +127,13 @@ function el(tag, cls, text) {
     return n;
 }
 const fmtTime = (s) => `${Math.floor(s / 60)}:${(s % 60).toFixed(2).padStart(5, "0")}`;
+/** Short chip label for a standard cue id, e.g. "nav.confirm" → "Confirm", "record.wr" → "WR". */
+const cueLabel = (cueId) => {
+    const leaf = (cueId.split(".").pop() ?? cueId).replace(/_/g, " ");
+    if (leaf.length <= 3)
+        return leaf.toUpperCase(); // pb, wr
+    return leaf.charAt(0).toUpperCase() + leaf.slice(1);
+};
 const safeKey = (s) => s.toLowerCase().replace(/\.[a-z0-9]+$/, "").replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 48) || "sound";
 export function mountSoundGallery(root, opts) {
     ensureStyle();
@@ -116,13 +148,86 @@ export function mountSoundGallery(root, opts) {
     let cropBufKey = null; // which asset.key `cropBuf` was decoded from (guards selection races)
     let regionStart = 0;
     let regionEnd = 0;
-    const audio = new Audio();
+    const audio = new Audio(); // edited-sound preview
+    const refAudio = new Audio(); // reference-sound preview (A/B)
+    // Required so routing a cross-origin R2 clip through a MediaElementSource isn't read as silence
+    // (a CORS-tainted stream yields zeros). Must be set before the src loads. The R2 bucket allows
+    // anonymous CORS GETs (same as the runtime music-stream path).
+    audio.crossOrigin = "anonymous";
+    refAudio.crossOrigin = "anonymous";
+    // ── Web Audio preview graph ──
+    // The preview routes through a mixer that MIRRORS the runtime SoundBank (per-category bus →
+    // master → limiter), so the Gain (dB) trim is audible here and the editor sounds like the game.
+    // Built lazily on the first play (inside a user gesture, so the AudioContext can resume).
+    let previewCtx = null;
+    let previewMaster = null;
+    const previewBuses = new Map();
+    let mainGain = null; // edited-sound trim; updated live by the gain slider
+    let refGain = null; // reference-sound trim
+    function ensurePreviewGraph() {
+        if (previewCtx && previewMaster)
+            return previewCtx;
+        const AC = typeof window !== "undefined"
+            ? window.AudioContext ?? window.webkitAudioContext
+            : undefined;
+        if (!AC)
+            return null;
+        const ctx = new AC();
+        const master = ctx.createGain();
+        const lim = ctx.createDynamicsCompressor(); // same settings as SoundBank's master limiter
+        lim.threshold.value = -3;
+        lim.knee.value = 0;
+        lim.ratio.value = 20;
+        lim.attack.value = 0.002;
+        lim.release.value = 0.15;
+        master.connect(lim).connect(ctx.destination);
+        for (const cat of SOUND_CATEGORIES) {
+            const g = ctx.createGain();
+            g.connect(master);
+            previewBuses.set(cat, g);
+        }
+        // Each media element gets ONE source (a MediaElementSource is one-per-element for the element's
+        // life) → its own trim gain → the bus chosen at play time.
+        mainGain = ctx.createGain();
+        ctx.createMediaElementSource(audio).connect(mainGain);
+        refGain = ctx.createGain();
+        ctx.createMediaElementSource(refAudio).connect(refGain);
+        previewCtx = ctx;
+        previewMaster = master;
+        return ctx;
+    }
+    /** Route a trim gain to a category bus (falling back to master) and set its level in dB. */
+    function routeGain(g, cat, db) {
+        try {
+            g.disconnect();
+        }
+        catch {
+            /* not connected yet */
+        }
+        g.gain.value = dbToGain(db);
+        g.connect(previewBuses.get(cat) ?? previewMaster);
+    }
+    /** Live-update the edited-sound trim while the gain slider moves (no reconnect). */
+    function liveGain(db) {
+        if (previewCtx && mainGain)
+            mainGain.gain.setTargetAtTime(dbToGain(db), previewCtx.currentTime, 0.01);
+    }
+    /** Build + resume the graph under a user gesture (selecting an item, pressing Play) so the
+     *  AudioContext is running by the time a clip plays — browsers start it suspended otherwise. */
+    function unlockAudio() {
+        const ctx = ensurePreviewGraph();
+        if (ctx && ctx.state === "suspended")
+            void ctx.resume().catch(() => undefined);
+    }
     // Playback cursor (a seekable playhead over the waveform). Set while a detail view is mounted.
     let waveCursor = null;
     let cursorDur = 0; // duration the waveform spans, in seconds (the full clip)
     let cursorSec = 0; // playback position / start, in full-clip seconds
     let cursorRaf = null;
     let playBtnRef = null; // current toolbar Play button, for its label
+    let refKey = null; // reference sound focused for A/B compare (reset per selection)
+    let refChips = null; // reference-chip buttons, to reflect focus
+    let abOnRef = false; // A/B toggle side: true = reference is the current side, false = edited sound
     // Folder hierarchy (entities) + tree state. `expanded` holds open folder ids; roots auto-open once.
     let folders = [];
     const expanded = new Set();
@@ -193,6 +298,7 @@ export function mountSoundGallery(root, opts) {
     }
     function stopPreview() {
         audio.pause();
+        refAudio.pause();
         stopCursor();
     }
     // ── Playback cursor & transport ──
@@ -222,6 +328,16 @@ export function mountSoundGallery(root, opts) {
         const clip = asset?.clips[0];
         if (!clip)
             return;
+        refAudio.pause(); // A/B: only one preview sounds at a time
+        abOnRef = false;
+        // Route through the preview mixer so the Gain (dB) trim is audible (mirrors the game).
+        const ctx = ensurePreviewGraph();
+        if (ctx) {
+            if (ctx.state === "suspended")
+                void ctx.resume().catch(() => undefined);
+            if (mainGain)
+                routeGain(mainGain, asset.category, asset.gainDb ?? 0);
+        }
         if (audio.src !== clip.url)
             audio.src = clip.url;
         if (cursorSec >= regionEnd - 0.001)
@@ -284,6 +400,55 @@ export function mountSoundGallery(root, opts) {
         placeCursor(regionStart);
         refreshPlayBtn();
     }
+    // ── Reference A/B: audition a `sys.*` standard-cue exemplar at matched monitoring ──
+    /** Play a reference sound through the same mixer (own gainDb + bus), pausing the edited preview. */
+    function playReference(ref) {
+        const clip = ref.clips[0];
+        if (!clip)
+            return;
+        pausePlayback(); // only one preview at a time
+        refKey = ref.key;
+        abOnRef = true;
+        if (refChips)
+            for (const [k, btn] of refChips)
+                btn.classList.toggle("on", k === ref.key);
+        const ctx = ensurePreviewGraph();
+        if (ctx) {
+            if (ctx.state === "suspended")
+                void ctx.resume().catch(() => undefined);
+            if (refGain)
+                routeGain(refGain, ref.category, ref.gainDb ?? 0);
+        }
+        if (refAudio.src !== clip.url)
+            refAudio.src = clip.url;
+        try {
+            refAudio.currentTime = 0;
+        }
+        catch {
+            /* noop */
+        }
+        void refAudio.play().catch(() => undefined);
+    }
+    /** A/B toggle: alternate the edited sound ↔ the focused reference so the ear can match levels. */
+    function toggleAb() {
+        if (abOnRef) {
+            playFromCursor(); // → edited side (also flips abOnRef=false)
+            return;
+        }
+        const ref = (refKey ? sounds.find((s) => s.key === refKey) : null) ?? firstRef();
+        if (ref)
+            playReference(ref); // → reference side (also flips abOnRef=true)
+    }
+    /** The first published reference sound (first bound sys.* cue that resolves), or null. */
+    function firstRef() {
+        for (const cueId of Object.keys(STANDARD_CUES)) {
+            const refK = STANDARD_BINDINGS[cueId];
+            const found = refK ? sounds.find((s) => s.key === refK) : undefined;
+            if (found && found.key !== selectedKey)
+                return found;
+        }
+        return null;
+    }
     // ── Sidebar: folder hierarchy (entities) → sounds. Folders are authoring-only. ──
     const UNFILED = "__unfiled__"; // pseudo-folder id for sounds with no folderId
     const errMsg = (e) => (e instanceof Error ? e.message : String(e));
@@ -514,6 +679,7 @@ export function mountSoundGallery(root, opts) {
     }
     async function selectSound(key) {
         stopPreview();
+        unlockAudio(); // this call runs under the item click — resume the context now
         selectedKey = key;
         selectedFolderId = null;
         cropBuf = null;
@@ -807,6 +973,9 @@ export function mountSoundGallery(root, opts) {
     // ── Detail / editor ──
     function renderDetail() {
         stopPreview();
+        refKey = null;
+        refChips = null;
+        abOnRef = false;
         if (selectedFolderId) {
             renderFolderView(selectedFolderId);
             return;
@@ -868,9 +1037,40 @@ export function mountSoundGallery(root, opts) {
         row2.appendChild(folderField);
         row2.appendChild(mkField("Label", asset.label ?? "", (v) => void patch(asset, { label: v || undefined })));
         row2.appendChild(mkField("Tags (comma-sep)", (asset.tags ?? []).join(", "), (v) => void patch(asset, { tags: v ? v.split(",").map((t) => t.trim()).filter(Boolean) : undefined })));
-        row2.appendChild(mkField("Gain (dB)", String(asset.gainDb ?? 0), (v) => void patch(asset, { gainDb: Number(v) || 0 }), {
-            width: "80px",
-        }));
+        // Gain trim — a live slider + numeric readout. Editing either updates the preview mixer's gain
+        // immediately (audible while playing) and persists on release.
+        const gainField = el("div", "rydr-sg-field");
+        gainField.appendChild(el("label", undefined, "Gain (dB)"));
+        const gwrap = el("div", "rydr-sg-gain");
+        const gslider = el("input");
+        gslider.type = "range";
+        gslider.min = String(GAIN_MIN);
+        gslider.max = String(GAIN_MAX);
+        gslider.step = "0.5";
+        gslider.value = String(asset.gainDb ?? 0);
+        gslider.disabled = !isAdmin;
+        const gnum = el("input");
+        gnum.type = "number";
+        gnum.min = String(GAIN_MIN);
+        gnum.max = String(GAIN_MAX);
+        gnum.step = "0.5";
+        gnum.value = String(asset.gainDb ?? 0);
+        gnum.disabled = !isAdmin;
+        const applyGain = (raw, persist) => {
+            const db = clampGain(Number.isFinite(raw) ? raw : 0);
+            gslider.value = String(db);
+            gnum.value = String(db);
+            liveGain(db); // audible immediately on the currently-playing edited preview
+            if (persist)
+                void patch(asset, { gainDb: db });
+        };
+        gslider.addEventListener("input", () => applyGain(Number(gslider.value), false));
+        gslider.addEventListener("change", () => applyGain(Number(gslider.value), true));
+        gnum.addEventListener("change", () => applyGain(Number(gnum.value), true));
+        gwrap.appendChild(gslider);
+        gwrap.appendChild(gnum);
+        gainField.appendChild(gwrap);
+        row2.appendChild(gainField);
         detail.appendChild(row2);
         // Waveform + crop
         const waveWrap = el("div", "rydr-sg-wave");
@@ -994,6 +1194,10 @@ export function mountSoundGallery(root, opts) {
         stopBtn.addEventListener("click", () => stopPlayback());
         bar.appendChild(stopBtn);
         if (isAdmin) {
+            const normBtn = el("button", "rydr-sg-btn", "⇩ Normalize");
+            normBtn.title = `Measure loudness and trim gain to ${LUFS_TARGETS[asset.category]} LUFS (${asset.category})`;
+            normBtn.addEventListener("click", () => void doNormalize(asset, normBtn, gslider, gnum));
+            bar.appendChild(normBtn);
             const cropBtn = el("button", "rydr-sg-btn primary", "✂ Crop & save");
             cropBtn.addEventListener("click", () => void doCrop(asset, cropBtn));
             bar.appendChild(cropBtn);
@@ -1005,9 +1209,43 @@ export function mountSoundGallery(root, opts) {
             bar.appendChild(delBtn);
         }
         detail.appendChild(bar);
+        // Reference A/B — audition against the platform's sys.* standard-cue exemplars (whichever are
+        // published), at matched monitoring, so levels can be tuned by ear against known-good sounds.
+        const refWrap = el("div", "rydr-sg-ref");
+        refWrap.appendChild(el("div", "rydr-sg-ref-lbl", "Compare against reference"));
+        const refRow = el("div", "rydr-sg-ref-row");
+        refChips = new Map();
+        for (const [cueId, def] of Object.entries(STANDARD_CUES)) {
+            const refK = STANDARD_BINDINGS[cueId];
+            const refAsset = refK ? sounds.find((s) => s.key === refK) : undefined;
+            if (!refAsset || refAsset.key === asset.key)
+                continue; // only published refs; never self
+            const chip = el("button", "rydr-sg-chip", cueLabel(cueId));
+            chip.title = def.description ?? cueId;
+            chip.addEventListener("click", () => playReference(refAsset));
+            refRow.appendChild(chip);
+            refChips.set(refAsset.key, chip);
+        }
+        if (refChips.size === 0) {
+            refRow.appendChild(el("span", "rydr-sg-ref-none", "No sys.* reference sounds published yet."));
+        }
+        else {
+            const abBtn = el("button", "rydr-sg-btn", "⇄ A/B");
+            abBtn.title = "Alternate this sound and the focused reference";
+            abBtn.addEventListener("click", () => toggleAb());
+            refRow.appendChild(abBtn);
+        }
+        refWrap.appendChild(refRow);
+        detail.appendChild(refWrap);
         // Meta footer
         const meta = el("div", "rydr-sg-meta");
-        meta.appendChild(el("div", undefined, `${clip?.filename ?? "—"} · ${dur ? fmtTime(dur) : "?"} · ${asset.loudness?.peakDb != null ? `peak ${asset.loudness.peakDb} dBFS` : "peak ?"}`));
+        const lufs = asset.loudness?.integratedLufs;
+        const peakStr = asset.loudness?.peakDb != null ? `peak ${asset.loudness.peakDb} dBFS` : "peak ?";
+        let lufsStr = lufs != null && Number.isFinite(lufs) ? `${lufs} LUFS` : "LUFS ?";
+        if (lufs != null && Number.isFinite(lufs) && asset.gainDb) {
+            lufsStr += ` (→ ${Math.round((lufs + asset.gainDb) * 10) / 10} w/ trim)`;
+        }
+        meta.appendChild(el("div", undefined, `${clip?.filename ?? "—"} · ${dur ? fmtTime(dur) : "?"} · ${peakStr} · ${lufsStr}`));
         if (clip) {
             const link = el("a", undefined, "open file ↗");
             link.href = clip.url;
@@ -1075,7 +1313,7 @@ export function mountSoundGallery(root, opts) {
                 ...asset,
                 clips: [{ url, filename, durationSec: cropped.duration }],
                 peaks,
-                loudness: { ...asset.loudness, peakDb: peakDb(cropped) },
+                loudness: { ...asset.loudness, peakDb: peakDb(cropped), integratedLufs: await integratedLufs(cropped) },
                 updatedAt: Date.now(),
             };
             await session.saveSound(next);
@@ -1094,6 +1332,35 @@ export function mountSoundGallery(root, opts) {
             btn.textContent = "✂ Crop & save";
         }
     }
+    /** Measure integrated loudness (LUFS) and trim gainDb so the sound hits its channel's target. */
+    async function doNormalize(asset, btn, gslider, gnum) {
+        const buf = await ensureCropBuf(asset);
+        if (!buf)
+            return;
+        btn.disabled = true;
+        btn.textContent = "Measuring…";
+        try {
+            const lufs = await integratedLufs(buf);
+            if (!Number.isFinite(lufs)) {
+                toast("Too quiet to measure loudness.");
+                return;
+            }
+            const gainDb = clampGain(Math.round((LUFS_TARGETS[asset.category] - lufs) * 10) / 10);
+            gslider.value = String(gainDb);
+            gnum.value = String(gainDb);
+            liveGain(gainDb);
+            await patch(asset, { gainDb, loudness: { ...asset.loudness, integratedLufs: lufs } });
+            renderDetail(); // refresh the footer's LUFS readout
+            toast(`Measured ${lufs} LUFS → trim ${gainDb > 0 ? "+" : ""}${gainDb} dB (target ${LUFS_TARGETS[asset.category]}).`);
+        }
+        catch (e) {
+            toast(`Normalize failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        finally {
+            btn.disabled = false;
+            btn.textContent = "⇩ Normalize";
+        }
+    }
     async function patch(asset, changes) {
         const next = { ...asset, ...changes, updatedAt: Date.now() };
         try {
@@ -1195,7 +1462,7 @@ export function mountSoundGallery(root, opts) {
                     folderId: target,
                     clips: [{ url, filename, durationSec: buf.duration }],
                     peaks: computePeaks(buf),
-                    loudness: { peakDb: peakDb(buf) },
+                    loudness: { peakDb: peakDb(buf), integratedLufs: await integratedLufs(buf) },
                     updatedAt: Date.now(),
                 };
                 await session.saveSound(asset);
@@ -1292,6 +1559,10 @@ export function mountSoundGallery(root, opts) {
             closeMenu();
             document.removeEventListener("keydown", onKey);
             document.removeEventListener("click", onDocClick);
+            if (previewCtx)
+                void previewCtx.close().catch(() => undefined);
+            previewCtx = null;
+            previewMaster = null;
             container.remove();
         },
     };