Clean release snapshot

2026-08-18 22:42:25 +00:00 · 2026-06-16 18:47:13 +02:00
commit 6c110398b4
574 changed files with 162566 additions and 0 deletions
@@ -0,0 +1,103 @@
+/*
+ * fee[dB]ack v0.3.0 — live guitar tone source preference.
+ *
+ * Lets users who get guitar tone from external hardware (Spark LIVE, pedalboards,
+ * etc.) opt out of the desktop "no internal amp loaded" monitor-mute hint.
+ * Persisted in localStorage; desktop renderer reads the same key directly.
+ */
+(function (root) {
+    'use strict';
+
+    const KEY = 'slopsmith-live-guitar-tone-source';
+
+    const SOURCES = Object.freeze({
+        INTERNAL: 'internal',
+        EXTERNAL_HARDWARE: 'external_hardware',
+        SPARK_CONTROL_X: 'spark_control_x',
+    });
+
+    const DEFAULT = SOURCES.INTERNAL;
+
+    const LABELS = Object.freeze({
+        [SOURCES.INTERNAL]: 'feed[dB]ack internal tone',
+        [SOURCES.EXTERNAL_HARDWARE]: 'External amp / hardware pedalboard',
+        [SOURCES.SPARK_CONTROL_X]: 'Spark LIVE + Spark Control X',
+    });
+
+    const HELP_TEXT =
+        'Choose External/Spark if your guitar tone comes from hardware like Spark LIVE. '
+        + 'feed[dB]ack will still score your playing but won\u2019t warn that no internal amp tone is loaded.';
+
+    function normalize(value) {
+        if (value === SOURCES.EXTERNAL_HARDWARE || value === SOURCES.SPARK_CONTROL_X) return value;
+        return DEFAULT;
+    }
+
+    function get() {
+        try { return normalize(localStorage.getItem(KEY)); } catch (_) { return DEFAULT; }
+    }
+
+    function set(value) {
+        const next = normalize(value);
+        try { localStorage.setItem(KEY, next); } catch (_) { /* private mode / quota */ }
+        syncSelects(next);
+        return next;
+    }
+
+    function shouldSuppressMonitorMuteHint(source) {
+        const s = normalize(source == null ? get() : source);
+        return s === SOURCES.EXTERNAL_HARDWARE || s === SOURCES.SPARK_CONTROL_X;
+    }
+
+    function syncSelects(value) {
+        // Exported + required in tests; guard DOM access so set()/init() can be
+        // called in a non-browser environment without throwing.
+        if (typeof document === 'undefined') return;
+        const v = normalize(value == null ? get() : value);
+        document.querySelectorAll('[data-live-guitar-tone-source]').forEach((el) => {
+            if (el && el.value !== v) el.value = v;
+        });
+    }
+
+    function bindSelect(el) {
+        if (!el || el.dataset.liveGuitarToneBound === '1') return;
+        el.dataset.liveGuitarToneBound = '1';
+        el.setAttribute('data-live-guitar-tone-source', '1');
+        el.value = get();
+        el.addEventListener('change', () => { set(el.value); });
+    }
+
+    function init() {
+        if (typeof document === 'undefined') return;
+        bindSelect(document.getElementById('setting-live-guitar-tone-source'));
+        bindSelect(document.getElementById('player-live-guitar-tone-source'));
+        syncSelects();
+    }
+
+    const api = {
+        KEY,
+        SOURCES,
+        DEFAULT,
+        LABELS,
+        HELP_TEXT,
+        get,
+        set,
+        normalize,
+        shouldSuppressMonitorMuteHint,
+        init,
+    };
+
+    if (root) root.v3LiveGuitarToneSource = api;
+
+    if (typeof module !== 'undefined' && module.exports) {
+        module.exports = api;
+    }
+
+    if (typeof document !== 'undefined') {
+        if (document.readyState === 'loading') {
+            document.addEventListener('DOMContentLoaded', init);
+        } else {
+            init();
+        }
+    }
+}(typeof window !== 'undefined' ? window : null));