MainComponent.cpp

// Super Timecode Converter
// Copyright (c) 2026 Fiverecords -- MIT License
// https://github.com/fiverecords/SuperTimecodeConverter

#include "MainComponent.h"
#include "WaveformCache.h"

using SrcType = TimecodeEngine::InputSource;

//==============================================================================
// Remove " *" or " [Engine N]" markers from combo item text to get the
// underlying device name.  Used when saving device names to settings.
//==============================================================================
static juce::String stripComboMarker(const juce::String& text)
{
    static const juce::String dotChar = juce::String::charToString(0x25CF);
    static const juce::String dotWithSpace = juce::String(" ") + dotChar;
    auto s = text;
    if (s.endsWith(dotWithSpace))
        s = s.dropLastCharacters(dotWithSpace.length());
    else if (s.endsWith(dotChar))
        s = s.dropLastCharacters(dotChar.length());
    int bracket = s.lastIndexOf(" [");
    if (bracket >= 0 && s.endsWith("]"))
        s = s.substring(0, bracket);
    return s.trimEnd();
}

//==============================================================================
// Select the item of `cmb` that shows `label` (markers stripped), preferring
// `preferredId` while its item still shows it -- two MIDI ports can share a
// name.  With no such item nothing is selected.  Returns whether one was.
//==============================================================================
static bool selectComboItemByLabel(juce::ComboBox& cmb, const juce::String& label, int preferredId)
{
    const int preferredIndex = cmb.indexOfItemId(preferredId);
    if (preferredIndex >= 0 && stripComboMarker(cmb.getItemText(preferredIndex)) == label)
    {
        cmb.setSelectedId(preferredId, juce::dontSendNotification);
        return true;
    }
    for (int i = 0; i < cmb.getNumItems(); ++i)
        if (stripComboMarker(cmb.getItemText(i)) == label)
        {
            cmb.setSelectedItemIndex(i, juce::dontSendNotification);
            return true;
        }
    cmb.setSelectedId(0, juce::dontSendNotification);
    return false;
}

//==============================================================================
// Where the interface labelled `label` ("name (ip)") is in `labels`: the
// same label, or else the only label with the same interface name -- the
// interface with a new address, such as a link-local one replaced by a
// DHCP lease.  -1 when there is neither, or when the name is listed with
// more than one address and none is the old one.
//==============================================================================
static int findInterfaceLabel(const juce::StringArray& labels, const juce::String& label)
{
    if (const int same = labels.indexOf(label); same >= 0)
        return same;
    auto nameOf = [](const juce::String& l) { return l.upToLastOccurrenceOf(" (", false, false); };
    const auto name = nameOf(label);
    int found = -1;
    for (int i = 0; i < labels.size(); ++i)
    {
        if (nameOf(labels[i]) != name)
            continue;
        if (found >= 0)
            return -1;
        found = i;
    }
    return found;
}

//==============================================================================
// The position, in the MIDI device list as it is now, of the device a MIDI
// selector shows -- or, with nothing selected, of `savedName`, the engine's
// configured device.  The selector's items are the list from when it was
// filled, and the MTC input or output enumerates the devices again when it
// starts, so a device plugged in or out since then moved the positions.
// The shown device is the name the selector was filled with for that item
// (`filledNames`, by item ID - 1), not the item's text: the text carries
// the in-use marker, and stripping it cannot tell a device named
// "Port [2]" from a "Port" in use by another engine.  That exact name is
// looked for at the shown position (two ports can share one), then
// anywhere.  The saved name is stripComboMarker's text, as flushSettings
// saves it, which also strips a device's own trailing " [...]" or space:
// it matches a device by its name, then by its name stripped the same way.
// -1 when the device is not listed, or there is no name: the engine opens
// nothing then, so STC never opens a MIDI port the operator did not pick
// (AUDIT UI-6).  Message thread.
//==============================================================================
static int midiDeviceToStart(const juce::ComboBox& cmb, const juce::StringArray& filledNames,
                             const juce::String& savedName, bool isInput)
{
    const int selectedId = cmb.getSelectedId();
    const juce::String name = selectedId > 0 ? filledNames[selectedId - 1] : stripComboMarker(savedName);
    if (name.isEmpty())
        return -1;
    const auto devices = isInput ? juce::MidiInput::getAvailableDevices()
                                 : juce::MidiOutput::getAvailableDevices();
    for (const bool exact : { true, false })
    {
        if (! exact && selectedId > 0)
            break;   // the shown device is known by its own name
        auto isNamed = [&name, exact](const juce::String& device)
        {
            return exact ? device == name : stripComboMarker(device) == name;
        };
        if (selectedId > 0 && selectedId <= devices.size() && isNamed(devices[selectedId - 1].name))
            return selectedId - 1;
        for (int i = 0; i < devices.size(); ++i)
            if (isNamed(devices[i].name))
                return i;
    }
    return -1;
}

//==============================================================================
// BPM x 100 for a TCNet layer, as the casts it replaces computed it
// (truncated), and 0 for a tempo that is unknown, not finite, negative or
// beyond 1000 BPM: a double -> uint32_t cast of a value out of range is
// undefined (AUDIT A17).  getBPM's own 0 for an unknown tempo (AUDIT PDL-1)
// is not relied on.
//==============================================================================
static uint32_t bpmToTimes100(double bpm)
{
    return (bpm > 0.0 && bpm < 1000.0) ? (uint32_t) (bpm * 100.0) : 0u;
}

//==============================================================================
// An Engine DJ cue's sample offset as ms, 0 when it is not a finite value
// that fits: the database is the device's, and a double -> uint32_t cast of
// a value out of range is undefined.
//==============================================================================
static uint32_t denonCueToMs(double sampleOffset, double sampleRate)
{
    const double ms = sampleOffset / sampleRate * 1000.0;
    return (std::isfinite(ms) && ms >= 0.0 && ms <= 4294967295.0) ? (uint32_t) ms : 0u;
}

//==============================================================================
// BACKGROUND AUDIO DEVICE SCANNER
//==============================================================================
MainComponent::AudioScanThread::AudioScanThread(MainComponent* owner)
    : juce::Thread("AudioScanThread"), safeOwner(owner) {}

void MainComponent::AudioScanThread::run()
{
    juce::Array<AudioDeviceEntry> inputs, outputs;

    if (!tempManager)
        return;

    for (auto* type : tempManager->getAvailableDeviceTypes())
    {
        if (threadShouldExit()) return;
        auto typeName = type->getTypeName();
        type->scanForDevices();
        for (auto& name : type->getDeviceNames(true))
            inputs.add({ typeName, name, AudioDeviceEntry::makeDisplayName(typeName, name) });
        for (auto& name : type->getDeviceNames(false))
            outputs.add({ typeName, name, AudioDeviceEntry::makeDisplayName(typeName, name) });
    }

    // A scan that sees the stop request -- from the destructor, or from a
    // newer scan that replaces it -- before posting posts nothing: its lists
    // would arrive after, or on top of, the newer state (AUDIT UI-1).  A
    // stop requested after this check still posts; those lists then apply
    // before the newer scan's.
    if (threadShouldExit()) return;

    juce::MessageManager::callAsync([owner = safeOwner, inputs, outputs]()
    {
        if (auto* comp = owner.getComponent())
            comp->onAudioScanComplete(inputs, outputs);
    });
}

//==============================================================================
// SAMPLE RATE / BUFFER SIZE helpers (same as v1.3)
//==============================================================================
static int sampleRateToComboId(double sr)
{
    if (sr <= 0) return 1;
    if (std::abs(sr - 44100) < 1) return 2;
    if (std::abs(sr - 48000) < 1) return 3;
    if (std::abs(sr - 88200) < 1) return 4;
    if (std::abs(sr - 96000) < 1) return 5;
    return 1;
}

static int bufferSizeToComboId(int bs)
{
    if (bs <= 0)    return 1;
    if (bs <= 32)   return 2;
    if (bs <= 64)   return 3;
    if (bs <= 128)  return 4;
    if (bs <= 256)  return 5;
    if (bs <= 512)  return 6;
    if (bs <= 1024) return 7;
    if (bs <= 2048) return 8;
    if (bs <= 4096) return 9;
    return 10;
}

//==============================================================================
// CONSTRUCTOR / DESTRUCTOR
//==============================================================================
MainComponent::MainComponent()
{
    setLookAndFeel(&customLookAndFeel);

    // --- Create initial engine BEFORE setSize, because setSize triggers
    //     resized() which calls currentEngine() ---
    engines.push_back(std::make_unique<TimecodeEngine>(0));
    engines[0]->setSharedProDJLinkInput(&sharedProDJLinkInput);
    engines[0]->setSharedStageLinQInput(&sharedStageLinQInput);
    sharedStageLinQInput.onMetadataRequest = [this](const juce::String& path)
    {
        sharedStageLinQDb.requestMetadata(path);
    };
    sharedStageLinQInput.onFileTransferAvailable = [this](const juce::String& ip, uint16_t port, const uint8_t* token)
    {
        sharedStageLinQDb.start(ip, port, token);
    };
    sharedProDJLinkInput.onPlayerLost = [this](const juce::String& playerIP)
    {
        sharedDbClient.invalidatePlayer(playerIP);
    };
    sharedProDJLinkInput.onPlayerMoved = [this](const juce::String& oldIp, const juce::String& newIp)
    {
        sharedDbClient.movePlayer(oldIp, newIp);
    };
    sharedProDJLinkInput.onMediaChanged = [this](const juce::String& playerIP, uint8_t slot)
    {
        sharedDbClient.mediaChanged(playerIP, slot);
    };
    engines[0]->setDbServerClient(&sharedDbClient);
    engines[0]->setTrackMap(&settings.trackMap);
    engines[0]->setMixerMap(&sharedMixerMap);
    engines[0]->setSlqMixerMap(&sharedSlqMixerMap);

    setSize(900, 700);
    setWantsKeyboardFocus(true);  // for the keyboard shortcuts in keyPressed

    // --- Tab bar ---
    addAndMakeVisible(btnAddEngine);
    btnAddEngine.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF1A1D23));
    btnAddEngine.setColour(juce::TextButton::textColourOffId, accentBlue);
    btnAddEngine.onClick = [this] { if (!isShowLocked()) addEngine(); };
    rebuildTabButtons();

    // --- Left panel scrollable viewport ---
    addAndMakeVisible(leftViewport);
    leftViewport.setViewedComponent(&leftContent, false);
    leftViewport.setScrollBarsShown(true, false);

    // --- Right panel scrollable viewport ---
    addAndMakeVisible(rightViewport);
    rightViewport.setViewedComponent(&rightContent, false);
    rightViewport.setScrollBarsShown(true, false);

    // --- Input buttons ---
    for (auto* btn : { &btnMtcIn, &btnArtnetIn, &btnSysTime, &btnLtcIn, &btnProDJLinkIn, &btnStageLinQIn, &btnLANetTCIn })
    { leftContent.addAndMakeVisible(btn); btn->setClickingTogglesState(false); }
    // HippoNet input hidden pending hardware validation (code preserved in HippotizerInput.h)
    btnHippoIn.setVisible(false);
    // Winamp input: Windows-only (the WinampInput class is a stub on macOS).
    // The button is added to the layout on every platform so the resized()
    // logic doesn't have to branch, but on macOS it is hidden so the user
    // never sees an unusable control.
    leftContent.addAndMakeVisible(btnWinampIn);
    btnWinampIn.setClickingTogglesState(false);
   #if JUCE_WINDOWS
    btnWinampIn.setVisible(true);
   #else
    btnWinampIn.setVisible(false);
   #endif

    // Winamp expandable panel labels.  Start hidden -- shown only when
    // Winamp is the active source AND the input config is expanded.
    leftContent.addAndMakeVisible(lblWinampInfoHeader);
    leftContent.addAndMakeVisible(lblWinampInfo);
    lblWinampInfoHeader.setText("WINAMP STATUS:", juce::dontSendNotification);
    styleLabel(lblWinampInfoHeader);
    styleLabel(lblWinampInfo);
    lblWinampInfo.setText("--", juce::dontSendNotification);
    lblWinampInfoHeader.setVisible(false);
    lblWinampInfo.setVisible(false);

    btnMtcIn.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::MTC) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else { inputConfigExpanded = true; eng.setInputSource(SrcType::MTC); startCurrentMtcInput(); updateInputButtonStates(); updateDeviceSelectorVisibility(); resized(); populateFilteredOutputDeviceCombos(); saveSettings(); }
    };
    btnArtnetIn.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::ArtNet) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else { inputConfigExpanded = true; eng.setInputSource(SrcType::ArtNet); startCurrentArtnetInput(); updateInputButtonStates(); updateDeviceSelectorVisibility(); resized(); populateFilteredOutputDeviceCombos(); saveSettings(); }
    };
    btnLANetTCIn.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::LANetTC) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else { inputConfigExpanded = true; eng.setInputSource(SrcType::LANetTC); startCurrentLANetTCInput(); updateInputButtonStates(); updateDeviceSelectorVisibility(); resized(); populateFilteredOutputDeviceCombos(); saveSettings(); }
    };
    btnSysTime.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::SystemTime) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else
        {
            inputConfigExpanded = true;
            eng.setInputSource(SrcType::SystemTime);
            // Reopen the Generator audio output if the toggle was left on
            // from before -- setInputSource() closed it when leaving
            // SystemTime to free the device for other engines, so the
            // symmetrical thing on returning is to reopen if the user
            // had it on.
            if (btnGenAudioOut.getToggleState()
                && cmbGenAudioDevice.getSelectedId() > 0
                && cmbGenAudioDevice.getSelectedId() != kPlaceholderItemId)
            {
                startCurrentGenAudio();
            }
            // Re-push the selected preset's cues into the engine.
            // setInputSource cleared armedCues + rawGeneratorCues to keep
            // sources from leaking into each other; without this restore
            // the user would have to re-select their preset in the combo
            // for cues to fire after switching back from another input.
            if (cmbGenPreset.isVisible() && cmbGenPreset.getSelectedId() > 0)
            {
                if (auto* preset = settings.generatorPresets.find(cmbGenPreset.getText()))
                    eng.setGeneratorCuePoints(preset->cuePoints);
            }
            updateInputButtonStates(); updateDeviceSelectorVisibility(); resized();
            populateFilteredOutputDeviceCombos();  // refresh markers (Gen audio device may have changed occupancy)
            saveSettings();
        }
    };
    btnLtcIn.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::LTC) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else { inputConfigExpanded = true; eng.setInputSource(SrcType::LTC); if (!scannedAudioInputs.isEmpty()) startCurrentLtcInput(); updateInputButtonStates(); updateDeviceSelectorVisibility(); resized(); populateFilteredOutputDeviceCombos(); saveSettings(); }
    };

    btnProDJLinkIn.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::ProDJLink) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else { inputConfigExpanded = true; eng.setInputSource(SrcType::ProDJLink); startCurrentProDJLinkInput(); updateInputButtonStates(); updateDeviceSelectorVisibility(); resized(); populateFilteredOutputDeviceCombos(); saveSettings(); }
    };

    btnStageLinQIn.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::StageLinQ) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else { inputConfigExpanded = true; eng.setInputSource(SrcType::StageLinQ); startCurrentStageLinQInput(); updateInputButtonStates(); updateDeviceSelectorVisibility(); resized(); populateFilteredOutputDeviceCombos(); saveSettings(); }
    };

    btnHippoIn.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::Hippotizer) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else { inputConfigExpanded = true; eng.setInputSource(SrcType::Hippotizer); startCurrentHippotizerInput(); updateInputButtonStates(); updateDeviceSelectorVisibility(); resized(); populateFilteredOutputDeviceCombos(); saveSettings(); }
    };

    btnWinampIn.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::Winamp) { inputConfigExpanded = !inputConfigExpanded; updateDeviceSelectorVisibility(); resized(); }
        else { inputConfigExpanded = true; eng.setInputSource(SrcType::Winamp); eng.startWinampInput(); updateInputButtonStates(); updateDeviceSelectorVisibility(); resized(); populateFilteredOutputDeviceCombos(); saveSettings(); }
    };

    // --- Output toggles ---
    for (auto* btn : { &btnMtcOut, &btnArtnetOut, &btnLtcOut, &btnThruOut, &btnTcnetOut, &btnLANetTCOut })
        rightContent.addAndMakeVisible(btn);

    styleOutputToggle(btnMtcOut, accentRed);
    styleOutputToggle(btnArtnetOut, accentOrange);
    styleOutputToggle(btnLANetTCOut, juce::Colour{0xFF63D8FB});
    styleOutputToggle(btnLtcOut, accentPurple);
    styleOutputToggle(btnThruOut, accentCyan);
    styleOutputToggle(btnTcnetOut, juce::Colour(0xFF00CC66));

    // On-air gate lives in the ProDJLink input panel (it gates input activity,
    // not a particular output). Use the small tick-style toggle like btnLink
    // to match the look of the ProDJLink panel controls, not the big output
    // toggles on the right side.
    leftContent.addAndMakeVisible(btnOnAirGate);
    btnOnAirGate.setColour(juce::ToggleButton::textColourId, textMid);
    btnOnAirGate.setColour(juce::ToggleButton::tickColourId, juce::Colour(0xFFE040FB));

    btnOnAirGate.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnOnAirGate)) return;
        currentEngine().setOnAirGateEnabled(btnOnAirGate.getToggleState());
        saveSettings();
    };

    auto outputToggleHandler = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto& eng = currentEngine();
        eng.setOutputMtcEnabled(btnMtcOut.getToggleState());
        eng.setOutputArtnetEnabled(btnArtnetOut.getToggleState());
        eng.setOutputLANetTCEnabled(btnLANetTCOut.getToggleState());
        eng.setOutputLtcEnabled(btnLtcOut.getToggleState());
        eng.setOutputThruEnabled(btnThruOut.getToggleState());
        eng.setOutputTcnetEnabled(btnTcnetOut.getToggleState());

        // Auto-start/stop shared TCNet output based on any engine needing it
        bool anyTcnet = false;
        for (auto& e : engines)
            if (e->isOutputTcnetEnabled()) { anyTcnet = true; break; }
        if (anyTcnet && !sharedTcnetOutput.getIsRunning())
        {
            sharedTcnetOutput.refreshNetworkInterfaces();
            sharedTcnetOutput.start(nicIdToStart(cmbTcnetInterface, kNicTcnet) - 2);   // what the selector shows, as listed now (AUDIT UI-6)
        }
        else if (!anyTcnet && sharedTcnetOutput.getIsRunning())
        {
            sharedTcnetOutput.stop();
        }

        updateCurrentOutputStates();
        // After toggling outputs, audio devices for LTC out / Thru out are
        // opened/closed in updateCurrentOutputStates(); MIDI devices for MTC
        // out are too.  Refresh both combo families so the in-use markers
        // (bullet for current engine, [ENGINE N] for others) reflect the
        // new occupancy across all selectors.
        populateFilteredOutputDeviceCombos();
        populateMidiAndNetworkCombos();
        updateDeviceSelectorVisibility();
        resized();
        saveSettings();
    };
    btnMtcOut.onClick = btnArtnetOut.onClick = btnLtcOut.onClick = btnThruOut.onClick = btnTcnetOut.onClick = btnLANetTCOut.onClick = outputToggleHandler;

    // --- Collapse toggle buttons for outputs ---
    for (auto* btn : { &btnCollapseMtcOut, &btnCollapseArtnetOut, &btnCollapseLtcOut, &btnCollapseThruOut, &btnCollapseLANetTCOut })
    {
        rightContent.addAndMakeVisible(btn);
        styleCollapseButton(*btn);
    }
    auto makeCollapseHandler = [this](bool& expandedFlag, juce::TextButton& collapseBtn) {
        return [this, &expandedFlag, &collapseBtn] {
            expandedFlag = !expandedFlag;
            updateCollapseButtonText(collapseBtn, expandedFlag);
            updateDeviceSelectorVisibility();
            resized();
        };
    };
    btnCollapseMtcOut.onClick    = makeCollapseHandler(mtcOutExpanded,    btnCollapseMtcOut);
    btnCollapseArtnetOut.onClick = makeCollapseHandler(artnetOutExpanded, btnCollapseArtnetOut);
    btnCollapseLANetTCOut.onClick = makeCollapseHandler(laNetTCOutExpanded, btnCollapseLANetTCOut);
    btnCollapseLtcOut.onClick    = makeCollapseHandler(ltcOutExpanded,    btnCollapseLtcOut);
    btnCollapseThruOut.onClick   = makeCollapseHandler(thruOutExpanded,   btnCollapseThruOut);
    updateCollapseButtonText(btnCollapseMtcOut, mtcOutExpanded);
    updateCollapseButtonText(btnCollapseArtnetOut, artnetOutExpanded);
    updateCollapseButtonText(btnCollapseLANetTCOut, laNetTCOutExpanded);
    updateCollapseButtonText(btnCollapseLtcOut, ltcOutExpanded);
    updateCollapseButtonText(btnCollapseThruOut, thruOutExpanded);

    // Input collapse button
    leftContent.addAndMakeVisible(btnCollapseInput);
    styleCollapseButton(btnCollapseInput);
    btnCollapseInput.onClick = [this] {
        inputConfigExpanded = !inputConfigExpanded;
        updateCollapseButtonText(btnCollapseInput, inputConfigExpanded);
        updateDeviceSelectorVisibility();
        resized();
    };
    updateCollapseButtonText(btnCollapseInput, inputConfigExpanded);

    // --- FPS buttons ---
    for (auto* btn : { &btnFps2398, &btnFps24, &btnFps25, &btnFps2997, &btnFps30 })
    { addAndMakeVisible(btn); btn->setClickingTogglesState(false); }

    btnFps2398.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        // LTC and LA-Net (24, 25 or 30 only), MTC and Art-Net (rate code 0)
        // carry 23.976 as 24: the choice is marked so that the engine's
        // input branch keeps 23.976 against a detected 24 (AUDIT NET-4,
        // TimecodeEngine::followDetectedRate).  The flag is persisted as
        // ltcFpsUserOverride.
        const auto src = eng.getActiveInput();
        if (src == SrcType::LTC || src == SrcType::MTC || src == SrcType::ArtNet || src == SrcType::LANetTC)
            eng.setUserOverrodeLtcFps(true);
        eng.setFrameRate(FrameRate::FPS_2398); updateFpsButtonStates(); saveSettings();
    };
    btnFps24.onClick = [this] {
        if (syncing || isShowLocked()) return;
        currentEngine().setUserOverrodeLtcFps(false);
        currentEngine().setFrameRate(FrameRate::FPS_24); updateFpsButtonStates(); saveSettings();
    };
    btnFps25.onClick = [this] {
        if (syncing || isShowLocked()) return;
        currentEngine().setUserOverrodeLtcFps(false);
        currentEngine().setFrameRate(FrameRate::FPS_25); updateFpsButtonStates(); saveSettings();
    };
    btnFps2997.onClick = [this] {
        if (syncing || isShowLocked()) return;
        auto& eng = currentEngine();
        // LTC and LA-Net carry 29.97 as 30 (MTC and Art-Net have a code for
        // it): marked as for 23.976 above (AUDIT NET-4).
        const auto src = eng.getActiveInput();
        if (src == SrcType::LTC || src == SrcType::LANetTC)
            eng.setUserOverrodeLtcFps(true);
        eng.setFrameRate(FrameRate::FPS_2997); updateFpsButtonStates(); saveSettings();
    };
    btnFps30.onClick = [this] {
        if (syncing || isShowLocked()) return;
        currentEngine().setUserOverrodeLtcFps(false);
        currentEngine().setFrameRate(FrameRate::FPS_30); updateFpsButtonStates(); saveSettings();
    };

    // --- FPS Conversion ---
    addAndMakeVisible(btnFpsConvert);
    styleOutputToggle(btnFpsConvert, accentGreen);
    btnFpsConvert.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnFpsConvert)) return;
        auto& eng = currentEngine();
        eng.setFpsConvertEnabled(btnFpsConvert.getToggleState());
        updateOutputFpsButtonStates();
        resized(); repaint();
        saveSettings();
    };

    for (auto* btn : { &btnOutFps2398, &btnOutFps24, &btnOutFps25, &btnOutFps2997, &btnOutFps30 })
    { addAndMakeVisible(btn); btn->setClickingTogglesState(false); }

    btnOutFps2398.onClick = [this] { if (!syncing && !isShowLocked()) { currentEngine().setOutputFrameRate(FrameRate::FPS_2398); updateOutputFpsButtonStates(); saveSettings(); } };
    btnOutFps24.onClick   = [this] { if (!syncing && !isShowLocked()) { currentEngine().setOutputFrameRate(FrameRate::FPS_24);   updateOutputFpsButtonStates(); saveSettings(); } };
    btnOutFps25.onClick   = [this] { if (!syncing && !isShowLocked()) { currentEngine().setOutputFrameRate(FrameRate::FPS_25);   updateOutputFpsButtonStates(); saveSettings(); } };
    btnOutFps2997.onClick = [this] { if (!syncing && !isShowLocked()) { currentEngine().setOutputFrameRate(FrameRate::FPS_2997); updateOutputFpsButtonStates(); saveSettings(); } };
    btnOutFps30.onClick   = [this] { if (!syncing && !isShowLocked()) { currentEngine().setOutputFrameRate(FrameRate::FPS_30);   updateOutputFpsButtonStates(); saveSettings(); } };

    addAndMakeVisible(timecodeDisplay);

    // =====================================================================
    // LEFT PANEL -- INPUT SELECTORS
    // =====================================================================
    auto addLabelAndCombo = [this](juce::Label& lbl, juce::ComboBox& cmb, const juce::String& text)
    {
        leftContent.addAndMakeVisible(lbl); leftContent.addAndMakeVisible(cmb);
        lbl.setText(text, juce::dontSendNotification);
        styleLabel(lbl); styleComboBox(cmb);
    };

    auto addRightLabelAndCombo = [this](juce::Label& lbl, juce::ComboBox& cmb, const juce::String& text)
    {
        rightContent.addAndMakeVisible(lbl); rightContent.addAndMakeVisible(cmb);
        lbl.setText(text, juce::dontSendNotification);
        styleLabel(lbl); styleComboBox(cmb);
    };

    addLabelAndCombo(lblAudioInputTypeFilter, cmbAudioInputTypeFilter, "AUDIO DRIVER:");
    cmbAudioInputTypeFilter.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        populateFilteredInputDeviceCombo();
        if (currentEngine().getActiveInput() == SrcType::LTC)
            startCurrentLtcInput();
        saveSettings();
    };

    addLabelAndCombo(lblSampleRate, cmbSampleRate, "SAMPLE RATE / BUFFER:");
    populateSampleRateCombo();
    cmbSampleRate.onChange = [this] {
        if (syncing || isShowLockedRevert()) return;
        cmbSampleRateOut.setSelectedId(cmbSampleRate.getSelectedId(), juce::dontSendNotification);
        restartAllAudioDevices(); saveSettings();
    };

    addLabelAndCombo(lblBufferSize, cmbBufferSize, "BUFFER SIZE:");
    populateBufferSizeCombo();
    populateOutputAudioCombos();
    cmbBufferSize.onChange = [this] {
        if (syncing || isShowLockedRevert()) return;
        cmbBufferSizeOut.setSelectedId(cmbBufferSize.getSelectedId(), juce::dontSendNotification);
        restartAllAudioDevices(); saveSettings();
    };

    addLabelAndCombo(lblMidiInputDevice, cmbMidiInputDevice, "MIDI INPUT DEVICE:");

    // AUDIT D10: how long the signal inputs keep counting as present after the
    // last frame or packet.  The operator's trade-off: a longer window
    // rides through USB stalls and display wakes without the outputs
    // noticing; a real stop reaches them that much later.
    addLabelAndCombo(lblInputFreewheel, cmbInputFreewheel, "FREEWHEEL:");
    cmbInputFreewheel.addItem("150 ms (default)", 150);
    cmbInputFreewheel.addItem("250 ms", 250);
    cmbInputFreewheel.addItem("500 ms", 500);
    cmbInputFreewheel.addItem("1 s", 1000);
    cmbInputFreewheel.addItem("2 s", 2000);
    cmbInputFreewheel.setSelectedId(150, juce::dontSendNotification);
    cmbInputFreewheel.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        currentEngine().setInputFreewheelMs(cmbInputFreewheel.getSelectedId());
        saveSettings();
    };
    cmbMidiInputDevice.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (cmbMidiInputDevice.getSelectedId() > 0 && currentEngine().getActiveInput() == SrcType::MTC)
        {
            const int sel = midiDeviceToStart(cmbMidiInputDevice, midiInputNames, {}, true);   // as listed now (AUDIT UI-6)
            currentEngine().stopMtcInput();
            currentEngine().getMtcInput().refreshDeviceList();
            currentEngine().startMtcInput(sel);
            populateMidiAndNetworkCombos();  // refresh markers (auto-restores selections)
            saveSettings();
        }
    };

    addLabelAndCombo(lblArtnetInputInterface, cmbArtnetInputInterface, "ART-NET INPUT DEVICE:");
    cmbArtnetInputInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (currentEngine().getActiveInput() == SrcType::ArtNet)
        {
            int sel = nicIdToStart(cmbArtnetInputInterface, kNicArtnetIn) - 1;   // as listed now (AUDIT UI-6)
            currentEngine().stopArtnetInput();
            currentEngine().startArtnetInput(sel);
            // A bind that fell back to All Interfaces shows it before the
            // repopulate.  Only then: the selector's IDs are positions in the
            // list it was filled from, the input's in today's.
            const int actual = currentEngine().getArtnetInput().getSelectedInterface();
            if (actual != sel)
                cmbArtnetInputInterface.setSelectedId(actual + 1, juce::dontSendNotification);
            populateMidiAndNetworkCombos();  // refresh markers (auto-restores all selections)
            saveSettings();
        }
    };

    addLabelAndCombo(lblLANetTCInputInterface, cmbLANetTCInputInterface, "LA-NET INPUT DEVICE:");
    cmbLANetTCInputInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (currentEngine().getActiveInput() == SrcType::LANetTC)
        {
            int sel = nicIdToStart(cmbLANetTCInputInterface, kNicLANetIn) - 1;   // as listed now (AUDIT UI-6)
            currentEngine().stopLANetTCInput();
            currentEngine().startLANetTCInput(sel);
            // A fallback to All Interfaces shows (see the Art-Net input).
            const int actual = currentEngine().getLANetTCInput().getSelectedInterface();
            if (actual != sel)
                cmbLANetTCInputInterface.setSelectedId(actual + 1, juce::dontSendNotification);
            populateMidiAndNetworkCombos();  // refresh markers (auto-restores all selections)
            saveSettings();
        }
    };

    addLabelAndCombo(lblHippoInputInterface, cmbHippoInputInterface, "HIPPONET INPUT DEVICE:");
    cmbHippoInputInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (currentEngine().getActiveInput() == SrcType::Hippotizer)
        {
            int sel = nicIdToStart(cmbHippoInputInterface, kNicHippoIn) - 1;   // as listed now (AUDIT UI-6)
            currentEngine().stopHippotizerInput();
            currentEngine().startHippotizerInput(sel);
            // A fallback to All Interfaces shows (see the Art-Net input).
            const int actual = currentEngine().getHippotizerInput().getSelectedInterface();
            if (actual != sel)
                cmbHippoInputInterface.setSelectedId(actual + 1, juce::dontSendNotification);
            populateMidiAndNetworkCombos();
            saveSettings();
        }
    };

    addLabelAndCombo(lblHippoTcChannel, cmbHippoTcChannel, "HIPPONET TC CHANNEL:");
    cmbHippoTcChannel.addItem("TC 1", 1);
    cmbHippoTcChannel.addItem("TC 2", 2);
    cmbHippoTcChannel.setSelectedId(1, juce::dontSendNotification);
    cmbHippoTcChannel.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRestore([this] {
                cmbHippoTcChannel.setSelectedId(currentEngine().getHippotizerInput().getSelectedTcIndex() + 1,
                                                juce::dontSendNotification); }))
            return;
        int sel = cmbHippoTcChannel.getSelectedId() - 1;  // 0-based
        currentEngine().getHippotizerInput().setSelectedTcIndex(sel);
        saveSettings();
    };

    // --- Generator controls (play/pause/stop + start/stop TC) ---
    {
        leftContent.addAndMakeVisible(btnGenClock);
        btnGenClock.setVisible(false);
        btnGenClock.setColour(juce::ToggleButton::textColourId, juce::Colour(0xFFAAAAAA));
        btnGenClock.onClick = [this]
        {
            if (isShowLocked()) { btnGenClock.setToggleState(!btnGenClock.getToggleState(), juce::dontSendNotification); return; }
            auto& eng = currentEngine();
            eng.setGeneratorClockMode(btnGenClock.getToggleState());
            updateDeviceSelectorVisibility();
            resized();
            saveSettings();
        };

        auto genBtnColor = juce::Colour(0xFF444444);
        for (auto* btn : { &btnGenPlay, &btnGenPause, &btnGenStop })
        {
            leftContent.addAndMakeVisible(btn);
            btn->setColour(juce::TextButton::buttonColourId, genBtnColor);
            btn->setVisible(false);
        }
        btnGenPlay.onClick = [this] {
            auto& eng = currentEngine();
            eng.generatorPlay();
        };
        btnGenPause.onClick = [this] {
            auto& eng = currentEngine();
            eng.generatorPause();
        };
        btnGenStop.onClick = [this] {
            auto& eng = currentEngine();
            eng.generatorStop();
        };

        auto setupTcEditor = [&](juce::TextEditor& ed, juce::Label& lbl,
                                  const juce::String& labelText)
        {
            leftContent.addAndMakeVisible(ed);
            ed.setFont(juce::Font(juce::FontOptions(11.0f)));
            ed.setColour(juce::TextEditor::backgroundColourId, juce::Colour(0xFF222222));
            ed.setColour(juce::TextEditor::textColourId, juce::Colours::white);
            ed.setJustification(juce::Justification::centred);
            ed.setVisible(false);
            ed.setText("00:00:00:00", juce::dontSendNotification);

            leftContent.addAndMakeVisible(lbl);
            styleLabel(lbl, 8.0f);
            lbl.setText(labelText, juce::dontSendNotification);
            lbl.setVisible(false);
        };

        setupTcEditor(txtGenStartTC, lblGenStartTC, "START TC:");
        setupTcEditor(txtGenStopTC,  lblGenStopTC,  "STOP TC (0=FREE):");

        // Callbacks use member pointers directly (no dangling reference)
        // Locked: the field shows the engine's value again rather than the
        // one typed and not applied.
        auto applyStartTC = [this] {
            auto& eng = currentEngine();
            if (isShowLockedRestore([&] { txtGenStartTC.setText(msToTimecodeString(eng.getGeneratorStartMs(), eng.getCurrentFps()), false); }))
                return;
            eng.setGeneratorStartMs(parseTimecodeToMs(txtGenStartTC.getText(), eng.getCurrentFps()));
            txtGenStartTC.setText(msToTimecodeString(eng.getGeneratorStartMs(), eng.getCurrentFps()), false);
            saveSettings();
        };
        txtGenStartTC.onReturnKey = applyStartTC;
        txtGenStartTC.onFocusLost = applyStartTC;

        auto applyStopTC = [this] {
            auto& eng = currentEngine();
            if (isShowLockedRestore([&] { txtGenStopTC.setText(msToTimecodeString(eng.getGeneratorStopMs(), eng.getCurrentFps()), false); }))
                return;
            eng.setGeneratorStopMs(parseTimecodeToMs(txtGenStopTC.getText(), eng.getCurrentFps()));
            txtGenStopTC.setText(msToTimecodeString(eng.getGeneratorStopMs(), eng.getCurrentFps()), false);
            saveSettings();
        };
        txtGenStopTC.onReturnKey = applyStopTC;
        txtGenStopTC.onFocusLost = applyStopTC;

        // Preset selector
        leftContent.addAndMakeVisible(lblGenPreset);
        styleLabel(lblGenPreset, 8.0f);
        lblGenPreset.setText("PRESET:", juce::dontSendNotification);
        lblGenPreset.setVisible(false);

        leftContent.addAndMakeVisible(cmbGenPreset);
        cmbGenPreset.setVisible(false);
        cmbGenPreset.setTextWhenNothingSelected("(select preset)");
        cmbGenPreset.onChange = [this] {
            int sel = cmbGenPreset.getSelectedId();
            if (sel > 0)
                loadGenPresetToFields(cmbGenPreset.getText());
        };

        leftContent.addAndMakeVisible(btnGenPrev);
        btnGenPrev.setVisible(false);
        btnGenPrev.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF444444));
        btnGenPrev.onClick = [this] { cycleGenPreset(-1); };

        leftContent.addAndMakeVisible(btnGenNext);
        btnGenNext.setVisible(false);
        btnGenNext.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF444444));
        btnGenNext.onClick = [this] { cycleGenPreset(+1); };

        leftContent.addAndMakeVisible(btnGenGo);
        btnGenGo.setVisible(false);
        btnGenGo.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF22AA44));
        btnGenGo.onClick = [this] {
            int sel = cmbGenPreset.getSelectedId();
            if (sel > 0)
                activateGenPreset(cmbGenPreset.getText());
        };

        leftContent.addAndMakeVisible(btnGenPresetEdit);
        btnGenPresetEdit.setVisible(false);
        btnGenPresetEdit.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF444444));
        btnGenPresetEdit.onClick = [this] {
            if (isShowLocked()) return;
            openGeneratorPresetEditor();
        };

        // --- Generator audio playback (plays the audio file attached to a preset) ---
        leftContent.addAndMakeVisible(btnGenAudioOut);
        styleOutputToggle(btnGenAudioOut, juce::Colour(0xFFCC8844));
        btnGenAudioOut.setVisible(false);
        btnGenAudioOut.onClick = [this]
        {
            if (isShowLocked()) { btnGenAudioOut.setToggleState(!btnGenAudioOut.getToggleState(), juce::dontSendNotification); return; }
            auto& eng = currentEngine();
            if (btnGenAudioOut.getToggleState())
                startCurrentGenAudio();
            else
                eng.stopGeneratorAudio();
            populateFilteredOutputDeviceCombos();  // refresh in-use markers
            updateDeviceSelectorVisibility();
            resized();
            saveSettings();
        };

        addLabelAndCombo(lblGenAudioDevice, cmbGenAudioDevice, "AUDIO PLAYBACK DEVICE:");
        cmbGenAudioDevice.setVisible(false); lblGenAudioDevice.setVisible(false);
        cmbGenAudioDevice.onChange = [this]
        {
            if (syncing) return;
            if (isShowLockedRevert()) return;
            if (cmbGenAudioDevice.getSelectedId() > 0
                && cmbGenAudioDevice.getSelectedId() != kPlaceholderItemId
                && btnGenAudioOut.getToggleState())
            {
                startCurrentGenAudio();
                populateFilteredOutputDeviceCombos();  // refresh markers
            }
            saveSettings();
        };

        addLabelAndCombo(lblGenAudioChannel, cmbGenAudioChannel, "AUDIO CHANNEL:");
        cmbGenAudioChannel.setVisible(false); lblGenAudioChannel.setVisible(false);
        cmbGenAudioChannel.onChange = [this]
        {
            if (syncing) return;
            if (isShowLockedRevert()) return;
            if (btnGenAudioOut.getToggleState() && cmbGenAudioDevice.getSelectedId() > 0
                && cmbGenAudioDevice.getSelectedId() != kPlaceholderItemId)
            {
                startCurrentGenAudio();
            }
            saveSettings();
        };

        // File channel mode: which channel(s) of the audio FILE to use.
        // Independent of the output routing -- handles the common case of
        // industry-standard files with audio on L and LTC on R.
        addLabelAndCombo(lblGenAudioFileMode, cmbGenAudioFileMode, "FILE CHANNELS:");
        cmbGenAudioFileMode.addItem("Stereo (L+R)", 1);
        cmbGenAudioFileMode.addItem("Left only",    2);
        cmbGenAudioFileMode.addItem("Right only",   3);
        cmbGenAudioFileMode.setSelectedId(1, juce::dontSendNotification);
        cmbGenAudioFileMode.setVisible(false); lblGenAudioFileMode.setVisible(false);
        cmbGenAudioFileMode.onChange = [this]
        {
            if (syncing) return;
            if (isShowLockedRestore([this] {
                    cmbGenAudioFileMode.setSelectedId(
                        juce::jlimit(0, 2, currentEngine().getGeneratorAudioFileChannelMode()) + 1,
                        juce::dontSendNotification); }))
                return;
            // No need to reopen the device or reload the file -- the player
            // reads this flag in the audio callback on every block, so the
            // change takes effect immediately.
            const int mode = cmbGenAudioFileMode.getSelectedId() - 1;   // 0..2
            currentEngine().setGeneratorAudioFileChannelMode(mode);
            saveSettings();
        };

        // No sample rate / buffer of its own: the generator's audio follows
        // the global SAMPLE RATE / BUFFER SIZE like every other audio
        // component (DESIGN D7, DESIGN D23).  The interface is one shared
        // device with one format, and a per-engine format here could only
        // disagree with what was actually running.

        // Volume slider: 0..1.5 linear (1=unity, 1.5=+3.5 dB headroom).
        leftContent.addAndMakeVisible(lblGenAudioVolume);
        styleLabel(lblGenAudioVolume, 9.0f);
        lblGenAudioVolume.setText("VOLUME", juce::dontSendNotification);
        lblGenAudioVolume.setVisible(false);
        leftContent.addAndMakeVisible(sldGenAudioVolume);
        sldGenAudioVolume.setSliderStyle(juce::Slider::LinearHorizontal);
        sldGenAudioVolume.setRange(0.0, 1.5, 0.0);
        sldGenAudioVolume.setValue(1.0, juce::dontSendNotification);
        sldGenAudioVolume.setTextBoxStyle(juce::Slider::TextBoxRight, false, 50, 18);
        sldGenAudioVolume.setNumDecimalPlacesToDisplay(2);
        sldGenAudioVolume.setVisible(false);
        // Not locked by Show Lock: a level ridden during the show, like the
        // generator transport and preset buttons.
        sldGenAudioVolume.onValueChange = [this]
        {
            if (syncing) return;
            currentEngine().setGeneratorAudioVolume((float) sldGenAudioVolume.getValue());
            // Mirror the value in the floating waveform window if open.
            if (genWaveformWindow != nullptr)
            {
                if (auto* content = dynamic_cast<GeneratorWaveformWindow*>(genWaveformWindow->getContentComponent()))
                    content->setVolumeFromOutside((float) sldGenAudioVolume.getValue());
            }
        };
        // Save settings only when the user finishes dragging, not on every
        // intermediate value (avoids JSON write storms while sliding).
        sldGenAudioVolume.onDragEnd = [this] { saveSettings(); };

        leftContent.addAndMakeVisible(lblGenAudioStatus);
        styleLabel(lblGenAudioStatus, 8.0f);
        lblGenAudioStatus.setVisible(false);

        // Mini waveform view (clickable -> opens the floating window).
        leftContent.addAndMakeVisible(miniWaveform);
        miniWaveform.setMode(GeneratorWaveformView::Mode::Mini);
        miniWaveform.setVisible(false);
        miniWaveform.onMiniClick = [this] { openGeneratorWaveformWindow(); };

        leftContent.addAndMakeVisible(btnGenWaveformOpen);
        btnGenWaveformOpen.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF444444));
        btnGenWaveformOpen.setVisible(false);
        btnGenWaveformOpen.onClick = [this] { openGeneratorWaveformWindow(); };
    }

    // --- OSC Input (generator remote control) ---
    leftContent.addAndMakeVisible(btnOscIn);
    styleOutputToggle(btnOscIn, juce::Colour(0xFF8888CC));
    btnOscIn.setVisible(false);
    btnOscIn.onClick = [this]
    {
        if (isShowLocked()) { btnOscIn.setToggleState(!btnOscIn.getToggleState(), juce::dontSendNotification); return; }
        if (btnOscIn.getToggleState())
            startOscInput();
        else
            stopOscInput();
        updateDeviceSelectorVisibility();
        resized();
        saveSettings();
    };

    addLabelAndCombo(lblOscInputInterface, cmbOscInputInterface, "OSC NETWORK DEVICE:");
    cmbOscInputInterface.onChange = [this]
    {
        if (isShowLockedRestore([this] { cmbOscInputInterface.setSelectedId(settings.oscInputInterface + 1, juce::dontSendNotification); }))
            return;
        settings.oscInputInterface = cmbOscInputInterface.getSelectedId() - 1;
        if (btnOscIn.getToggleState())
        {
            stopOscInput();
            startOscInput();
        }
        saveSettings();
    };

    leftContent.addAndMakeVisible(lblOscInPort);
    styleLabel(lblOscInPort, 8.0f);
    lblOscInPort.setText("OSC PORT:", juce::dontSendNotification);
    lblOscInPort.setVisible(false);

    leftContent.addAndMakeVisible(txtOscInPort);
    txtOscInPort.setFont(juce::Font(juce::FontOptions(11.0f)));
    txtOscInPort.setColour(juce::TextEditor::backgroundColourId, juce::Colour(0xFF222222));
    txtOscInPort.setColour(juce::TextEditor::textColourId, juce::Colours::white);
    txtOscInPort.setJustification(juce::Justification::centred);
    txtOscInPort.setText("9800", juce::dontSendNotification);
    txtOscInPort.setVisible(false);
    auto applyOscPort = [this]
    {
        if (isShowLockedRestore([this] { txtOscInPort.setText(juce::String(settings.oscInputPort), false); }))
            return;
        int port = juce::jlimit(1, 65535, txtOscInPort.getText().getIntValue());
        txtOscInPort.setText(juce::String(port), false);
        settings.oscInputPort = port;
        if (btnOscIn.getToggleState())
        {
            stopOscInput();
            startOscInput();
        }
        saveSettings();
    };
    txtOscInPort.onReturnKey = applyOscPort;
    txtOscInPort.onFocusLost = applyOscPort;

    leftContent.addAndMakeVisible(lblOscInStatus);
    styleLabel(lblOscInStatus, 8.0f);
    lblOscInStatus.setVisible(false);

    setupOscInputServer();

    // --- Pro DJ Link controls ---
    addLabelAndCombo(lblProDJLinkInterface, cmbProDJLinkInterface, "PRO DJ LINK INTERFACE:");
    cmbProDJLinkInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (currentEngine().getActiveInput() == SrcType::ProDJLink)
        {
            startCurrentProDJLinkInput();
            populateMidiAndNetworkCombos();
            saveSettings();
        }
    };

    // --- ProDJLink bridge identity profile (v1.9.11-beta15) ---
    // A/B setting for the two-byte keepalive conflict between the two real
    // bridge captures (see AppSettings + ProDJLinkInput for the rationale).
    // Changing it restarts the shared PDL connection so peers re-register us
    // from a clean announce -- flipping identity mid-registration would give
    // ambiguous results on the very hardware this exists to diagnose.
    addLabelAndCombo(lblPdlBridgeIdentity, cmbPdlBridgeIdentity, "BRIDGE IDENTITY:");
    cmbPdlBridgeIdentity.addItem("F9 (A9 CAPTURE)",      1);
    cmbPdlBridgeIdentity.addItem("C0 (NXS2 CAPTURE)",    2);
    cmbPdlBridgeIdentity.addItem("E4 (A9+3000 CAPTURE)", 3);
    cmbPdlBridgeIdentity.addItem("AUTO (COUNT)",         4);
    cmbPdlBridgeIdentity.setSelectedId(1, juce::dontSendNotification);
    cmbPdlBridgeIdentity.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        settings.prodjlinkBridgeIdentity = cmbPdlBridgeIdentity.getSelectedId() - 1;
        if (currentEngine().getActiveInput() == SrcType::ProDJLink)
        {
            if (sharedProDJLinkInput.getIsRunning())
            {
                DBG("MainComponent: bridge identity profile changed -- restarting PDL");
                sharedProDJLinkInput.stop();
                sharedDbClient.stop();
            }
            startCurrentProDJLinkInput();
        }
        saveSettings();
    };

    // --- ProDJLink 95B keepalive scope (v1.9.11-beta15) ---
    // Applied LIVE (no restart): turning the 95B off mid-session while
    // status keeps flowing is itself one of the diagnostic experiments.
    addLabelAndCombo(lblPdl95bMode, cmbPdl95bMode, "CDJ 95B KEEPALIVE:");
    cmbPdl95bMode.addItem("ALL PLAYERS",   1);
    cmbPdl95bMode.addItem("CDJ-3000 ONLY", 2);
    cmbPdl95bMode.addItem("OFF",           3);
    cmbPdl95bMode.setSelectedId(1, juce::dontSendNotification);
    cmbPdl95bMode.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        settings.prodjlink95bMode = cmbPdl95bMode.getSelectedId() - 1;
        sharedProDJLinkInput.setDbKeepaliveMode(settings.prodjlink95bMode);
        saveSettings();
    };

    addLabelAndCombo(lblStageLinQInterface, cmbStageLinQInterface, "STAGELINQ INTERFACE:");
    cmbStageLinQInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (currentEngine().getActiveInput() == SrcType::StageLinQ)
        {
            startCurrentStageLinQInput();
            populateMidiAndNetworkCombos();
            saveSettings();
        }
    };

    addLabelAndCombo(lblProDJLinkPlayer, cmbProDJLinkPlayer, "PLAYER:");
    for (int i = 1; i <= ProDJLink::kMaxPlayers; ++i)
        cmbProDJLinkPlayer.addItem("PLAYER " + juce::String(i), i);
    cmbProDJLinkPlayer.addItem("XF-A", 7);
    cmbProDJLinkPlayer.addItem("XF-B", 8);
    cmbProDJLinkPlayer.addItem("MASTER", 9);
    cmbProDJLinkPlayer.addItem("ON AIR", 10);   // DESIGN D34
    cmbProDJLinkPlayer.setSelectedId(1, juce::dontSendNotification);
    cmbProDJLinkPlayer.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto activeIn = currentEngine().getActiveInput();
        if (activeIn == SrcType::ProDJLink || activeIn == SrcType::StageLinQ)
        {
            int player = cmbProDJLinkPlayer.getSelectedId();
            if (player >= 1)
            {
                currentEngine().setProDJLinkPlayer(player);
                // Reset UI display so stale data from previous player doesn't linger
                displayedArtworkId = 0;
                artworkDisplay.clearImage();
                displayedWaveformTrackId = 0;
                displayedSlqTrackVersion = 0;
                slqPanelClearedFor = 0;
                displayedPdlMedia.clear();
                waveformDisplay.clearWaveform();
                lblProDJLinkTrackInfo.setText("", juce::dontSendNotification);
                lblProDJLinkMetadata.setText("", juce::dontSendNotification);
                lblNextCue.setText("", juce::dontSendNotification);
            }
            updateOnAirQuietVisibility();
            resized();
            saveSettings();
        }
    };

    // OFF AIR AT: when a deck counts as quiet for ON AIR on StageLinQ (DESIGN D34).
    // Pro DJ Link has no level to compare -- the DJM decides on-air -- so it
    // only shows with StageLinQ and ON AIR selected.
    addLabelAndCombo(lblOnAirQuiet, cmbOnAirQuiet, "OFF AIR AT:");
    cmbOnAirQuiet.addItem("SILENCE", 1);
    cmbOnAirQuiet.addItem("-80 dB", 2);
    cmbOnAirQuiet.addItem("-60 dB", 3);
    cmbOnAirQuiet.addItem("-40 dB", 4);
    cmbOnAirQuiet.setSelectedId(1, juce::dontSendNotification);
    cmbOnAirQuiet.setVisible(false);
    lblOnAirQuiet.setVisible(false);
    cmbOnAirQuiet.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        currentEngine().setOnAirQuietStep(cmbOnAirQuiet.getSelectedId() - 1);
        saveSettings();
    };

    leftContent.addAndMakeVisible(lblProDJLinkMetadata);
    styleLabel(lblProDJLinkMetadata, 9.0f);
    lblProDJLinkMetadata.setVisible(false);

    leftContent.addAndMakeVisible(lblNextCue);
    lblNextCue.setFont(juce::Font(juce::FontOptions(10.0f)));
    lblNextCue.setColour(juce::Label::textColourId, juce::Colour(0xFFFFAA00));  // amber
    lblNextCue.setVisible(false);

    leftContent.addAndMakeVisible(lblMixerStatus);
    lblMixerStatus.setFont(juce::Font(juce::FontOptions(juce::Font::getDefaultMonospacedFontName(), 9.0f, juce::Font::plain)));
    lblMixerStatus.setColour(juce::Label::textColourId, juce::Colour(0xFF888888));
    lblMixerStatus.setVisible(false);

    leftContent.addAndMakeVisible(artworkDisplay);
    artworkDisplay.setVisible(false);
    leftContent.addAndMakeVisible(waveformDisplay);
    waveformDisplay.setVisible(false);

    leftContent.addAndMakeVisible(lblProDJLinkTrackInfo);
    styleLabel(lblProDJLinkTrackInfo, 8.0f);
    lblProDJLinkTrackInfo.setVisible(false);

    // --- ProDJLink features: TrackMap, MIDI Clock, OSC BPM, Ableton Link ---
    auto pdlAccent = juce::Colour(0xFF00AAFF);

    leftContent.addAndMakeVisible(btnTrackMap);
    btnTrackMap.setVisible(false);
    btnTrackMap.setColour(juce::ToggleButton::textColourId, textMid);
    btnTrackMap.setColour(juce::ToggleButton::tickColourId, pdlAccent);
    btnTrackMap.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnTrackMap)) return;
        bool enabled = btnTrackMap.getToggleState();
        for (auto& eng : engines)
            eng->setTrackMapEnabled(enabled);
        updateDeviceSelectorVisibility();
        saveSettings();
    };

    leftContent.addAndMakeVisible(btnTrackMapEdit);
    btnTrackMapEdit.setVisible(false);
    btnTrackMapEdit.setColour(juce::TextButton::buttonColourId, pdlAccent.withAlpha(0.15f));
    btnTrackMapEdit.setColour(juce::TextButton::textColourOffId, pdlAccent.brighter(0.3f));
    btnTrackMapEdit.onClick = [this] { if (!isShowLocked()) openTrackMapEditor(); };

    leftContent.addAndMakeVisible(btnProDJLinkView);
    btnProDJLinkView.setVisible(false);
    btnProDJLinkView.setColour(juce::TextButton::buttonColourId, pdlAccent.withAlpha(0.15f));
    btnProDJLinkView.setColour(juce::TextButton::textColourOffId, pdlAccent.brighter(0.3f));
    btnProDJLinkView.onClick = [this] { openProDJLinkView(); };

    auto slqAccent = juce::Colour(0xFF00CC66);
    leftContent.addAndMakeVisible(btnStageLinQView);
    btnStageLinQView.setVisible(false);
    btnStageLinQView.setColour(juce::TextButton::buttonColourId, slqAccent.withAlpha(0.15f));
    btnStageLinQView.setColour(juce::TextButton::textColourOffId, slqAccent.brighter(0.3f));
    btnStageLinQView.onClick = [this] { openStageLinQView(); };

    leftContent.addAndMakeVisible(btnMixerMapEdit);
    btnMixerMapEdit.setVisible(false);
    btnMixerMapEdit.setColour(juce::TextButton::buttonColourId, pdlAccent.withAlpha(0.15f));
    btnMixerMapEdit.setColour(juce::TextButton::textColourOffId, pdlAccent.brighter(0.3f));
    btnMixerMapEdit.onClick = [this] { if (!isShowLocked()) openMixerMapEditor(); };   // like Track Map (AUDIT UI-3)

    addAndMakeVisible(btnBackup);
    btnBackup.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF1A1D23));
    btnBackup.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFF66CC66));
    btnBackup.onClick = [this] { if (!isShowLocked()) exportConfig(); };

    addAndMakeVisible(btnRestore);
    btnRestore.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF1A1D23));
    btnRestore.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFFFF9966));
    btnRestore.onClick = [this] { if (!isShowLocked()) importConfig(); };

    // --- Show Lock button ---
    addAndMakeVisible(btnShowLock);
    auto updateShowLockVisuals = [this]()
    {
        if (settings.showModeLocked)
        {
            btnShowLock.setButtonText("LOCKED");
            btnShowLock.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFFCC2222));
            btnShowLock.setColour(juce::TextButton::textColourOffId, juce::Colours::white);
        }
        else
        {
            btnShowLock.setButtonText("SHOW LOCK");
            btnShowLock.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF1A1D23));
            btnShowLock.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFF888888));
        }
    };
    updateShowLockVisuals();

    btnShowLock.onClick = [this, updateShowLockVisuals]
    {
        if (settings.showModeLocked)
        {
            // Unlock: confirm dialog to prevent accidental unlock
            auto options = juce::MessageBoxOptions()
                .withIconType(juce::MessageBoxIconType::WarningIcon)
                .withTitle("Unlock Show Mode?")
                .withMessage("Show Lock is active. Unlocking allows changes to "
                             "input sources, devices, frame rates, and engine "
                             "configuration.\n\nUnlock now?")
                .withButton("Unlock")
                .withButton("Cancel");
            juce::Component::SafePointer<MainComponent> safeThis(this);
            juce::AlertWindow::showAsync(options, [safeThis, updateShowLockVisuals](int result)
            {
                if (safeThis == nullptr) return;
                if (result == 1)
                {
                    safeThis->settings.showModeLocked = false;
                    safeThis->showLockFlashCountdown = 0;  // cancel pending flash
                    updateShowLockVisuals();
                    safeThis->saveSettings();
                }
            });
        }
        else
        {
            // Save what was changed before the lock while flushSettings still
            // reads the destination fields (they are not saved while locked).
            if (settingsDirty)
                flushSettings();
            settings.showModeLocked = true;
            // Close the configuration editors -- cue points, Track Map, Mixer
            // Map, generator presets.  They shouldn't be open during the
            // show: their edits change what goes out (Track Map offsets and
            // triggers, mixer forwarding, generator cues), and none of them
            // checks Show Lock itself (AUDIT UI-3).  The floating ones close
            // as from their close button, which keeps their bounds.
            if (cuePointWindow != nullptr) { cuePointWindow.reset(); cuePointTrackKey.clear(); cuePointEditedArtist.clear(); cuePointEditedTitle.clear(); }
            for (auto* w : { trackMapWindow.getComponent(), mixerMapWindow.getComponent(),
                             genPresetWindow.getComponent() })
                if (w != nullptr)
                    w->closeButtonPressed();
            updateShowLockVisuals();
            saveSettings();
        }
    };

    leftContent.addAndMakeVisible(btnMidiClock);

    btnMidiClock.setVisible(false);
    btnMidiClock.setColour(juce::ToggleButton::textColourId, textMid);
    btnMidiClock.setColour(juce::ToggleButton::tickColourId, pdlAccent);
    btnMidiClock.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnMidiClock)) return;
        bool wantClock = btnMidiClock.getToggleState();
        currentEngine().setMidiClockEnabled(wantClock);  // set flag (clock may not start yet if device not open)
        applyTriggerSettings();  // ensure MIDI device is opened/closed based on needs
        if (wantClock)
            currentEngine().setMidiClockEnabled(true);  // re-try now that device is open
        propagateGlobalSettings();
        populateMidiAndNetworkCombos();  // refresh markers (trigger device may have opened/closed)
        updateDeviceSelectorVisibility();
        saveSettings();
    };

    leftContent.addAndMakeVisible(btnOscFwdBpm);
    btnOscFwdBpm.setVisible(false);
    btnOscFwdBpm.setColour(juce::ToggleButton::textColourId, textMid);
    btnOscFwdBpm.setColour(juce::ToggleButton::tickColourId, pdlAccent);
    btnOscFwdBpm.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnOscFwdBpm)) return;
        currentEngine().setOscForward(btnOscFwdBpm.getToggleState(), edOscFwdBpmAddr.getText(), edOscFwdBpmCmd.getText());
        applyTriggerSettings();  // ensure OSC connection is opened/closed
        propagateGlobalSettings();
        populateMidiAndNetworkCombos();  // refresh markers
        updateDeviceSelectorVisibility();
        saveSettings();
    };

    leftContent.addAndMakeVisible(lblOscFwdBpmAddr);
    lblOscFwdBpmAddr.setText("Addr:", juce::dontSendNotification);
    lblOscFwdBpmAddr.setFont(juce::Font(juce::FontOptions(10.0f)));
    lblOscFwdBpmAddr.setColour(juce::Label::textColourId, textDim);
    lblOscFwdBpmAddr.setVisible(false);

    leftContent.addAndMakeVisible(edOscFwdBpmAddr);
    edOscFwdBpmAddr.setVisible(false);
    edOscFwdBpmAddr.setText("/composition/tempocontroller/tempo");
    edOscFwdBpmAddr.setFont(juce::Font(juce::FontOptions(10.0f)));
    edOscFwdBpmAddr.setColour(juce::TextEditor::backgroundColourId, juce::Colour(0xFF2A2A2A));
    edOscFwdBpmAddr.setColour(juce::TextEditor::textColourId, textLight);
    edOscFwdBpmAddr.setColour(juce::TextEditor::outlineColourId, juce::Colour(0xFF444444));
    auto applyOscBpmSettings = [this]
    {
        if (!syncing && !isShowLockedRevert())
        {
            currentEngine().setOscForward(btnOscFwdBpm.getToggleState(),
                                          edOscFwdBpmAddr.getText(),
                                          edOscFwdBpmCmd.getText());
            propagateGlobalSettings();
            saveSettings();
        }
    };
    edOscFwdBpmAddr.onReturnKey = applyOscBpmSettings;
    edOscFwdBpmAddr.onFocusLost = applyOscBpmSettings;

    leftContent.addAndMakeVisible(lblOscFwdBpmCmd);
    lblOscFwdBpmCmd.setVisible(false);
    lblOscFwdBpmCmd.setText("CMD:", juce::dontSendNotification);
    lblOscFwdBpmCmd.setFont(juce::Font(juce::FontOptions(9.0f)));
    lblOscFwdBpmCmd.setColour(juce::Label::textColourId, textMid);
    lblOscFwdBpmCmd.setJustificationType(juce::Justification::centredRight);

    leftContent.addAndMakeVisible(edOscFwdBpmCmd);
    edOscFwdBpmCmd.setVisible(false);
    edOscFwdBpmCmd.setFont(juce::Font(juce::FontOptions(10.0f)));
    edOscFwdBpmCmd.setColour(juce::TextEditor::backgroundColourId, juce::Colour(0xFF2A2A2A));
    edOscFwdBpmCmd.setColour(juce::TextEditor::textColourId, textLight);
    edOscFwdBpmCmd.setColour(juce::TextEditor::outlineColourId, juce::Colour(0xFF444444));
    edOscFwdBpmCmd.setTextToShowWhenEmpty("float (empty=float, %BPM%=string)", juce::Colour(0xFF555555));
    edOscFwdBpmCmd.onReturnKey = applyOscBpmSettings;
    edOscFwdBpmCmd.onFocusLost = applyOscBpmSettings;

    leftContent.addAndMakeVisible(btnOscMixerFwd);
    btnOscMixerFwd.setVisible(false);
    btnOscMixerFwd.setColour(juce::ToggleButton::textColourId, textMid);
    btnOscMixerFwd.setColour(juce::ToggleButton::tickColourId, pdlAccent);
    btnOscMixerFwd.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnOscMixerFwd)) return;
        currentEngine().setOscMixerForward(btnOscMixerFwd.getToggleState());
        applyTriggerSettings();
        propagateGlobalSettings();
        populateMidiAndNetworkCombos();  // refresh markers (trigger device may have opened/closed)
        saveSettings();
    };

    leftContent.addAndMakeVisible(btnMidiMixerFwd);
    btnMidiMixerFwd.setVisible(false);
    btnMidiMixerFwd.setColour(juce::ToggleButton::textColourId, textMid);
    btnMidiMixerFwd.setColour(juce::ToggleButton::tickColourId, pdlAccent);
    btnMidiMixerFwd.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnMidiMixerFwd)) return;
        currentEngine().setMidiMixerForward(btnMidiMixerFwd.getToggleState(),
                                             cmbMidiMixCCCh.getSelectedId(),
                                             cmbMidiMixNoteCh.getSelectedId());
        applyTriggerSettings();
        propagateGlobalSettings();
        populateMidiAndNetworkCombos();  // refresh markers
        updateDeviceSelectorVisibility();
        saveSettings();
    };

    auto setupMidiChCombo = [this](juce::ComboBox& cmb, juce::Label& lbl, const juce::String& labelText)
    {
        leftContent.addAndMakeVisible(lbl);
        lbl.setVisible(false);
        lbl.setText(labelText, juce::dontSendNotification);
        lbl.setFont(juce::Font(juce::FontOptions(10.0f)));
        lbl.setColour(juce::Label::textColourId, textDim);

        leftContent.addAndMakeVisible(cmb);
        cmb.setVisible(false);
        for (int ch = 1; ch <= 16; ++ch)
            cmb.addItem("Ch " + juce::String(ch), ch);
        cmb.setSelectedId(1, juce::dontSendNotification);
        styleComboBox(cmb);
        cmb.onChange = [this]
        {
            if (syncing) return;
            if (isShowLockedRevert()) return;
            currentEngine().setMidiMixerForward(btnMidiMixerFwd.getToggleState(),
                                                 cmbMidiMixCCCh.getSelectedId(),
                                                 cmbMidiMixNoteCh.getSelectedId());
            propagateGlobalSettings();
            saveSettings();
        };
    };
    setupMidiChCombo(cmbMidiMixCCCh, lblMidiMixCCCh, "CC CH:");
    setupMidiChCombo(cmbMidiMixNoteCh, lblMidiMixNoteCh, "NOTE CH:");

    leftContent.addAndMakeVisible(btnArtnetMixerFwd);
    btnArtnetMixerFwd.setVisible(false);
    btnArtnetMixerFwd.setColour(juce::ToggleButton::textColourId, textMid);
    btnArtnetMixerFwd.setColour(juce::ToggleButton::tickColourId, pdlAccent);
    btnArtnetMixerFwd.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnArtnetMixerFwd)) return;
        currentEngine().setArtnetMixerForward(btnArtnetMixerFwd.getToggleState(),
                                               getArtNetAddressFromCombos(cmbArtMixNet, cmbArtMixSub, cmbArtMixUni));
        // Ensure ArtNet output is running -- DMX uses the same socket.
        // If ArtNet timecode out is already running, this is a no-op.
        if (btnArtnetMixerFwd.getToggleState() && !currentEngine().getArtnetOutput().getIsRunning())
        {
            int iface = nicIdToStart(cmbArtnetDmxInterface, kNicArtnetDmx) - 2;  // -1=All, 0+=NIC
            currentEngine().startArtnetOutput(iface);
        }
        propagateGlobalSettings();
        updateDeviceSelectorVisibility();
        saveSettings();
    };

    setupArtNetAddressCombos(cmbArtMixNet, cmbArtMixSub, cmbArtMixUni, lblArtMixAddr,
                             "MIXER:", [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        currentEngine().setArtnetMixerForward(btnArtnetMixerFwd.getToggleState(),
                                               getArtNetAddressFromCombos(cmbArtMixNet, cmbArtMixSub, cmbArtMixUni));
        propagateGlobalSettings();
        saveSettings();
    });

    leftContent.addAndMakeVisible(btnLink);
    btnLink.setVisible(false);
    btnLink.setColour(juce::ToggleButton::textColourId, textMid);
    btnLink.setColour(juce::ToggleButton::tickColourId, pdlAccent);
    btnLink.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnLink)) return;

        if (btnLink.getToggleState())
        {
            // Check if another engine already has Link active
            int owner = findLinkOwnerOtherThan(selectedEngine);
            if (owner >= 0)
            {
                // Block: revert toggle and show which engine has it
                btnLink.setToggleState(false, juce::dontSendNotification);
                lblLinkStatus.setText("Link active on " + engines[(size_t)owner]->getName(),
                                     juce::dontSendNotification);
                lblLinkStatus.setColour(juce::Label::textColourId, juce::Colour(0xFFFF5555));
                lblLinkStatus.setVisible(true);
                resized();
                return;
            }
        }

        currentEngine().getLinkBridge().setEnabled(btnLink.getToggleState());
        propagateGlobalSettings();
        updateDeviceSelectorVisibility();
        saveSettings();
    };

    leftContent.addAndMakeVisible(lblLinkStatus);
    lblLinkStatus.setVisible(false);
    lblLinkStatus.setFont(juce::Font(juce::FontOptions(10.0f)));
    lblLinkStatus.setColour(juce::Label::textColourId, textMid);
    lblLinkStatus.setJustificationType(juce::Justification::centredLeft);

    // --- Audio BPM detection (for non-DJ sources: MTC, LTC, ArtNet, SystemTime) ---
    {
        juce::Colour bpmAccent(0xFFFF9900);  // orange for audio BPM
        leftContent.addAndMakeVisible(btnAudioBpm);
        btnAudioBpm.setVisible(false);
        btnAudioBpm.setColour(juce::ToggleButton::textColourId, textMid);
        btnAudioBpm.setColour(juce::ToggleButton::tickColourId, bpmAccent);
        btnAudioBpm.onClick = [this]
        {
            if (syncing) return;
            if (isShowLockedToggle(btnAudioBpm)) return;
            if (btnAudioBpm.getToggleState())
            {
                // When LTC is active, populate the separate BPM device combo
                if (currentEngine().getActiveInput() == SrcType::LTC)
                {
                    cmbAudioBpmDevice.clear(juce::dontSendNotification);
                    for (int i = 0; i < scannedAudioInputs.size(); i++)
                    {
                        auto marker = getDeviceInUseMarker(scannedAudioInputs[i].deviceName,
                                                            scannedAudioInputs[i].typeName, true);
                        cmbAudioBpmDevice.addItem(scannedAudioInputs[i].displayName + marker, i + 1);
                    }
                    if (cmbAudioBpmDevice.getNumItems() > 0)
                        cmbAudioBpmDevice.setSelectedId(1, juce::dontSendNotification);
                    populateAudioBpmChannels();
                }
                restartAudioBpm();
            }
            else
                currentEngine().stopAudioBpm();
            applyTriggerSettings();
            populateFilteredInputDeviceCombo();  // refresh markers (BPM device occupancy)
            updateDeviceSelectorVisibility();
            resized();
            saveSettings();
        };

        leftContent.addAndMakeVisible(lblBpmValue);
        lblBpmValue.setVisible(false);
        lblBpmValue.setFont(juce::Font(juce::FontOptions(18.0f, juce::Font::bold)));
        lblBpmValue.setColour(juce::Label::textColourId, juce::Colour(0xFF666666));
        lblBpmValue.setJustificationType(juce::Justification::centredLeft);
        lblBpmValue.setText("--- BPM", juce::dontSendNotification);

        leftContent.addAndMakeVisible(ledBeat);
        ledBeat.setVisible(false);
        ledBeat.setLedColour(bpmAccent);

        leftContent.addAndMakeVisible(sldBpmSmoothing); styleGainSlider(sldBpmSmoothing);
        leftContent.addAndMakeVisible(lblBpmSmoothing); lblBpmSmoothing.setText("BPM SMOOTHING:", juce::dontSendNotification); styleLabel(lblBpmSmoothing);
        sldBpmSmoothing.setRange(0.0, 100.0, 1.0);
        sldBpmSmoothing.setValue(50.0, juce::dontSendNotification);  // default 50% = 0.5
        sldBpmSmoothing.setVisible(false);
        sldBpmSmoothing.onValueChange = [this]
        {
            if (syncing) return;
            if (isShowLockedSlider(sldBpmSmoothing, currentEngine().getAudioBpmInput().getSmoothing() * 100.0f))
                return;
            float s = (float)sldBpmSmoothing.getValue() / 100.0f;
            currentEngine().getAudioBpmInput().setSmoothing(s);
            saveSettings();
        };

        addLabelAndCombo(lblAudioBpmDevice, cmbAudioBpmDevice, "BPM DEVICE:");
        cmbAudioBpmDevice.onChange = [this]
        {
            if (syncing || isShowLockedRevert()) return;
            populateAudioBpmChannels();
            if (btnAudioBpm.getToggleState()) restartAudioBpm();
            populateFilteredInputDeviceCombo();  // refresh LTC combo markers
            saveSettings();
        };

        addLabelAndCombo(lblAudioBpmChannel, cmbAudioBpmChannel, "BPM CHANNEL:");
        cmbAudioBpmChannel.onChange = [this]
        {
            if (syncing || isShowLockedRevert()) return;
            if (btnAudioBpm.getToggleState()) restartAudioBpm();
            saveSettings();
        };

        leftContent.addAndMakeVisible(sldBpmInputGain); styleGainSlider(sldBpmInputGain);
        leftContent.addAndMakeVisible(lblBpmInputGain); lblBpmInputGain.setText("BPM INPUT GAIN:", juce::dontSendNotification); styleLabel(lblBpmInputGain);
        sldBpmInputGain.setVisible(false);
        sldBpmInputGain.onValueChange = [this]
        {
            if (syncing) return;
            if (isShowLockedSlider(sldBpmInputGain, currentEngine().getAudioBpmInput().getInputGain() * 100.0f))
                return;
            float gain = (float)sldBpmInputGain.getValue() / 100.0f;
            currentEngine().getAudioBpmInput().setInputGain(gain);
            saveSettings();
        };

        leftContent.addAndMakeVisible(mtrAudioBpm);
        mtrAudioBpm.setMeterColour(bpmAccent);
        mtrAudioBpm.setVisible(false);
    }

    // --- BPM Multiplier buttons (per-player, ProDJLink only) ---
    // Single click: session override (temporary). Double click: save to TrackMap (persistent).
    {
        auto setupBpmBtn = [this, pdlAccent](juce::TextButton& btn, int mult)
        {
            leftContent.addAndMakeVisible(btn);
            btn.setVisible(false);
            btn.setColour(juce::TextButton::buttonColourId,   bgPanel);
            btn.setColour(juce::TextButton::textColourOffId,  textMid);
            btn.setColour(juce::TextButton::buttonOnColourId, pdlAccent.withAlpha(0.30f));
            btn.setColour(juce::TextButton::textColourOnId,   pdlAccent.brighter(0.3f));
            btn.setClickingTogglesState(false);
            btn.onClick = [this, mult]
            {
                if (syncing) return;
                auto now = (juce::int64)juce::Time::getMillisecondCounter();
                bool isDouble = (mult == lastBpmClickMult
                                 && (now - lastBpmClickMs) < 400);
                lastBpmClickMs   = now;
                lastBpmClickMult = mult;

                if (isDouble)
                {
                    // Double click: persist to TrackMap (toggle)
                    if (!isShowLocked())  // TrackMap is config -- blocked in Show Lock
                        saveBpmMultToTrackMap(mult);
                }
                else
                {
                    // Single click: set session override (skip if already effective)
                    auto& eng = currentEngine();
                    if (eng.getEffectiveBpmMultiplier() != mult)
                        eng.setBpmPlayerOverride(mult);
                }
                updateBpmMultButtonStates();
            };
        };
        setupBpmBtn(btnBpmOff,  0);
        setupBpmBtn(btnBpmX2,  1);
        setupBpmBtn(btnBpmX4,  2);
        setupBpmBtn(btnBpmD2, -1);
        setupBpmBtn(btnBpmD4, -2);
    }

    // --- Track change trigger controls ---
    auto accentAmber = juce::Colour(0xFFFFAB00);

    leftContent.addAndMakeVisible(btnTriggerMidi);
    btnTriggerMidi.setVisible(false);
    btnTriggerMidi.setColour(juce::ToggleButton::textColourId, textMid);
    btnTriggerMidi.setColour(juce::ToggleButton::tickColourId, accentAmber);
    btnTriggerMidi.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnTriggerMidi)) return;
        applyTriggerSettings();
        populateMidiAndNetworkCombos();  // refresh markers (trigger MIDI device occupancy)
        saveSettings();
    };

    leftContent.addAndMakeVisible(cmbTriggerMidiDevice);
    cmbTriggerMidiDevice.setVisible(false);
    styleComboBox(cmbTriggerMidiDevice);
    cmbTriggerMidiDevice.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        applyTriggerSettings();
        populateMidiAndNetworkCombos();  // refresh markers (trigger MIDI device occupancy)
        saveSettings();
    };

    leftContent.addAndMakeVisible(btnTriggerOsc);
    btnTriggerOsc.setVisible(false);
    btnTriggerOsc.setColour(juce::ToggleButton::textColourId, textMid);
    btnTriggerOsc.setColour(juce::ToggleButton::tickColourId, accentAmber);
    btnTriggerOsc.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnTriggerOsc)) return;
        applyTriggerSettings();
        saveSettings();
    };

    leftContent.addAndMakeVisible(edOscIp);
    edOscIp.setVisible(false);
    edOscIp.setFont(juce::Font(juce::FontOptions(10.0f)));
    edOscIp.setColour(juce::TextEditor::backgroundColourId, bgDarker);
    edOscIp.setColour(juce::TextEditor::textColourId, textBright);
    edOscIp.setColour(juce::TextEditor::outlineColourId, borderCol);
    edOscIp.setTextToShowWhenEmpty("127.0.0.1", textDim);
    // The OSC destination of triggers, BPM and mixer forwarding: locked like
    // the other destination fields (AUDIT UI-3).
    auto applyOscDestination = [this]
    {
        if (syncing || isShowLockedRevert()) return;
        applyTriggerSettings();
        saveSettings();
    };
    edOscIp.onFocusLost = applyOscDestination;
    edOscIp.onReturnKey  = applyOscDestination;

    leftContent.addAndMakeVisible(edOscPort);
    edOscPort.setVisible(false);
    edOscPort.setFont(juce::Font(juce::FontOptions(10.0f)));
    edOscPort.setColour(juce::TextEditor::backgroundColourId, bgDarker);
    edOscPort.setColour(juce::TextEditor::textColourId, textBright);
    edOscPort.setColour(juce::TextEditor::outlineColourId, borderCol);
    edOscPort.setTextToShowWhenEmpty("53000", textDim);
    edOscPort.setInputRestrictions(5, "0123456789");
    edOscPort.onFocusLost = applyOscDestination;
    edOscPort.onReturnKey  = applyOscDestination;

    leftContent.addAndMakeVisible(btnArtnetTrigger);
    btnArtnetTrigger.setVisible(false);
    btnArtnetTrigger.setColour(juce::ToggleButton::textColourId, textMid);
    btnArtnetTrigger.setColour(juce::ToggleButton::tickColourId, accentAmber);
    btnArtnetTrigger.onClick = [this]
    {
        if (syncing) return;
        if (isShowLockedToggle(btnArtnetTrigger)) return;
        currentEngine().setArtnetTriggerEnabled(btnArtnetTrigger.getToggleState());
        // Ensure ArtNet output is running if enabled
        if (btnArtnetTrigger.getToggleState() && !currentEngine().getArtnetOutput().getIsRunning())
        {
            int iface = nicIdToStart(cmbArtnetDmxInterface, kNicArtnetDmx) - 2;  // -1=All, 0+=NIC
            currentEngine().startArtnetOutput(iface);
        }
        updateDeviceSelectorVisibility();
        saveSettings();
    };

    setupArtNetAddressCombos(cmbArtTrigNet, cmbArtTrigSub, cmbArtTrigUni, lblArtTrigAddr,
                             "TRIGGER:", [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        currentEngine().setArtnetTriggerUniverse(getArtNetAddressFromCombos(cmbArtTrigNet, cmbArtTrigSub, cmbArtTrigUni));
        saveSettings();
    });
    // Default universe 1 (Net=0, Sub=0, Uni=1)
    cmbArtTrigUni.setSelectedId(2, juce::dontSendNotification);

    // Art-Net DMX interface selector (for triggers and mixer forward)
    addLabelAndCombo(lblArtnetDmxInterface, cmbArtnetDmxInterface, "ART-NET DMX INTERFACE:");
    cmbArtnetDmxInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto& eng = currentEngine();
        bool needsArtnet = eng.isArtnetMixerForwardEnabled() || eng.isArtnetTriggerEnabled();
        if (needsArtnet)
        {
            int sel = nicIdToStart(cmbArtnetDmxInterface, kNicArtnetDmx) - 2;  // -1=All, 0+=NIC, as listed now (AUDIT UI-6)
            // Restart ArtnetOutput on the new interface (only if timecode output isn't controlling it)
            if (!eng.isOutputArtnetEnabled() || !eng.getArtnetOutput().getIsRunning())
                eng.startArtnetOutput(sel);
        }
        saveSettings();
    };

    addLabelAndCombo(lblAudioInputDevice, cmbAudioInputDevice, "AUDIO INPUT DEVICE:");
    cmbAudioInputDevice.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto& eng = currentEngine();
        if (eng.getActiveInput() == SrcType::LTC
            && cmbAudioInputDevice.getSelectedId() > 0
            && cmbAudioInputDevice.getSelectedId() != kPlaceholderItemId)
        {
            startCurrentLtcInput();
            populateFilteredInputDeviceCombo();  // refresh markers (auto-restores selection)
            populateAudioInputChannels();
            saveSettings();
        }
        else if (btnAudioBpm.getToggleState()
                 && cmbAudioInputDevice.getSelectedId() > 0
                 && cmbAudioInputDevice.getSelectedId() != kPlaceholderItemId)
        {
            populateAudioInputChannels();
            restartAudioBpm();
            populateFilteredInputDeviceCombo();  // refresh markers (BPM device changed)
            saveSettings();
        }
    };

    addLabelAndCombo(lblAudioInputChannel, cmbAudioInputChannel, "LTC CHANNEL:");
    cmbAudioInputChannel.onChange = [this]
    {
        if (syncing || isShowLockedRevert()) return;
        if (currentEngine().getActiveInput() == SrcType::LTC) { startCurrentLtcInput(); saveSettings(); }
        else if (btnAudioBpm.getToggleState()) { restartAudioBpm(); saveSettings(); }
    };

    leftContent.addAndMakeVisible(sldLtcInputGain); styleGainSlider(sldLtcInputGain);
    leftContent.addAndMakeVisible(lblLtcInputGain); lblLtcInputGain.setText("LTC INPUT GAIN:", juce::dontSendNotification); styleLabel(lblLtcInputGain);
    leftContent.addAndMakeVisible(mtrLtcInput); mtrLtcInput.setMeterColour(accentPurple);
    sldLtcInputGain.onValueChange = [this]
    {
        if (syncing) return;
        auto& eng = currentEngine();
        // The slider shows the Audio BPM gain when that analyser has the
        // shared input (as syncUIFromEngine sets it), the LTC gain otherwise.
        const bool showsBpmGain = eng.isAudioBpmRunning() && eng.getActiveInput() != SrcType::LTC;
        if (isShowLockedSlider(sldLtcInputGain, (showsBpmGain ? eng.getAudioBpmInput().getInputGain()
                                                               : eng.getLtcInput().getInputGain()) * 100.0f))
            return;
        float gain = (float)sldLtcInputGain.getValue() / 100.0f;
        if (eng.getActiveInput() == SrcType::LTC)
            eng.getLtcInput().setInputGain(gain);
        if (eng.isAudioBpmRunning())
            eng.getAudioBpmInput().setInputGain(gain);
        saveSettings();
    };

    addLabelAndCombo(lblThruInputChannel, cmbThruInputChannel, "AUDIO THRU CHANNEL:");
    cmbThruInputChannel.onChange = [this] { if (!syncing && !isShowLockedRevert() && currentEngine().getActiveInput() == SrcType::LTC) { startCurrentLtcInput(); saveSettings(); } };

    leftContent.addAndMakeVisible(sldThruInputGain); styleGainSlider(sldThruInputGain);
    leftContent.addAndMakeVisible(lblThruInputGain); lblThruInputGain.setText("AUDIO THRU INPUT GAIN:", juce::dontSendNotification); styleLabel(lblThruInputGain);
    leftContent.addAndMakeVisible(mtrThruInput); mtrThruInput.setMeterColour(accentCyan);
    sldThruInputGain.onValueChange = [this] { if (!syncing && !isShowLockedSlider(sldThruInputGain, currentEngine().getLtcInput().getPassthruGain() * 100.0f)) { currentEngine().getLtcInput().setPassthruGain((float)sldThruInputGain.getValue() / 100.0f); saveSettings(); } };

    leftContent.addAndMakeVisible(lblInputStatus); styleLabel(lblInputStatus); lblInputStatus.setColour(juce::Label::textColourId, accentGreen);
    // LTC IN: recovered user bits (only meaningful when the source is LTC).
    leftContent.addAndMakeVisible(lblLtcInUserBits); styleLabel(lblLtcInUserBits, 8.0f);
    lblLtcInUserBits.setText("USER BITS: --", juce::dontSendNotification);
    lblLtcInUserBits.setVisible(false);

    // =====================================================================
    // RIGHT PANEL -- OUTPUT SELECTORS
    // =====================================================================
    addRightLabelAndCombo(lblMidiOutputDevice, cmbMidiOutputDevice, "MIDI OUTPUT DEVICE:");
    cmbMidiOutputDevice.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto& eng = currentEngine();
        if (cmbMidiOutputDevice.getSelectedId() > 0 && eng.isOutputMtcEnabled())
        {
            const int sel = midiDeviceToStart(cmbMidiOutputDevice, midiOutputNames, {}, false);   // as listed now (AUDIT UI-6)

            // Clear sharing before stopping old MTC device
            eng.getTriggerOutput().setSharedMidiOutput(nullptr);
            eng.stopMtcOutput();

            // Release trigger's own handle if it matches the new device
            eng.getMtcOutput().refreshDeviceList();
            auto mtcNames = eng.getMtcOutput().getDeviceNames();
            if (sel >= 0 && sel < mtcNames.size()
                && eng.getTriggerOutput().hasOwnMidiOpen()
                && eng.getTriggerOutput().getCurrentMidiDeviceName() == mtcNames[sel])
            {
                eng.getTriggerOutput().releaseOwnMidi();
            }

            eng.startMtcOutput(sel);

            // Re-establish sharing if devices match
            if (eng.getMtcOutput().getIsRunning())
            {
                auto trigDevName = stripComboMarker(cmbTriggerMidiDevice.getText());
                if (trigDevName == eng.getMtcOutput().getCurrentDeviceName())
                    eng.getTriggerOutput().setSharedMidiOutput(eng.getMtcOutput().getMidiOutputPtr());
                else
                    applyTriggerSettings();  // reopen trigger on its own device
            }
            else
            {
                // Refused -- another engine streams MTC on that port (DESIGN D32) --
                // or failed to open.  The trigger output may have given up its
                // own port above: let it take it back.
                applyTriggerSettings();
            }
            populateMidiAndNetworkCombos();
            saveSettings();
        }
    };
    rightContent.addAndMakeVisible(lblOutputMtcStatus); styleLabel(lblOutputMtcStatus); lblOutputMtcStatus.setColour(juce::Label::textColourId, accentRed);
    rightContent.addAndMakeVisible(sldMtcOffset); styleOffsetSlider(sldMtcOffset);
    rightContent.addAndMakeVisible(lblMtcOffset); lblMtcOffset.setText("MTC OFFSET:", juce::dontSendNotification); styleLabel(lblMtcOffset);
    sldMtcOffset.onValueChange = [this] { if (!syncing && !isShowLockedSlider(sldMtcOffset, currentEngine().getMtcOutputOffset())) { currentEngine().setMtcOutputOffset((int)sldMtcOffset.getValue()); saveSettings(); } };

    addRightLabelAndCombo(lblArtnetOutputInterface, cmbArtnetOutputInterface, "ART-NET OUTPUT DEVICE:");
    cmbArtnetOutputInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto& eng = currentEngine();
        if (eng.isOutputArtnetEnabled())
        {
            int sel = nicIdToStart(cmbArtnetOutputInterface, kNicArtnetOut) - 2;   // as listed now (AUDIT UI-6)
            eng.stopArtnetOutput();
            eng.startArtnetOutput(sel);
            // A fallback to All Interfaces shows (see the Art-Net input).
            const int actual = eng.getArtnetOutput().getSelectedInterface();
            if (actual != sel)
                cmbArtnetOutputInterface.setSelectedId(actual + 2, juce::dontSendNotification);
            populateMidiAndNetworkCombos();  // refresh markers (auto-restores all selections)
            saveSettings();
        }
    };
    rightContent.addAndMakeVisible(lblOutputArtnetStatus); styleLabel(lblOutputArtnetStatus); lblOutputArtnetStatus.setColour(juce::Label::textColourId, accentOrange);
    rightContent.addAndMakeVisible(sldArtnetOffset); styleOffsetSlider(sldArtnetOffset);
    rightContent.addAndMakeVisible(lblArtnetOffset); lblArtnetOffset.setText("ART-NET OFFSET:", juce::dontSendNotification); styleLabel(lblArtnetOffset);
    sldArtnetOffset.onValueChange = [this] { if (!syncing && !isShowLockedSlider(sldArtnetOffset, currentEngine().getArtnetOutputOffset())) { currentEngine().setArtnetOutputOffset((int)sldArtnetOffset.getValue()); saveSettings(); } };

    addRightLabelAndCombo(lblLANetTCOutputInterface, cmbLANetTCOutputInterface, "LA-NET OUTPUT DEVICE:");
    cmbLANetTCOutputInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto& eng = currentEngine();
        if (eng.isOutputLANetTCEnabled())
        {
            int sel = nicIdToStart(cmbLANetTCOutputInterface, kNicLANetOut) - 3;   // as listed now (AUDIT UI-6)
            eng.stopLANetTCOutput();
            eng.startLANetTCOutput(sel);
            // A fallback to All Interfaces shows (see the Art-Net input).
            const int actual = eng.getLANetTCOutput().getSelectedInterface();
            if (actual != sel)
                cmbLANetTCOutputInterface.setSelectedId(actual + 3, juce::dontSendNotification);
            populateMidiAndNetworkCombos();  // refresh markers (auto-restores all selections)
            saveSettings();
        }
    };
    rightContent.addAndMakeVisible(lblOutputLANetTCStatus); styleLabel(lblOutputLANetTCStatus); lblOutputLANetTCStatus.setColour(juce::Label::textColourId, accentOrange);
    rightContent.addAndMakeVisible(sldLANetTCOffset); styleOffsetSlider(sldLANetTCOffset);
    rightContent.addAndMakeVisible(lblLANetTCOffset); lblLANetTCOffset.setText("LA-NET OFFSET:", juce::dontSendNotification); styleLabel(lblLANetTCOffset);
    sldLANetTCOffset.onValueChange = [this] { if (!syncing && !isShowLockedSlider(sldLANetTCOffset, currentEngine().getLANetTCOutputOffset())) { currentEngine().setLANetTCOutputOffset((int)sldLANetTCOffset.getValue()); saveSettings(); } };

    // TCNet interface combo (shown when TCNET OUT is enabled)
    addRightLabelAndCombo(lblTcnetInterface, cmbTcnetInterface, "TCNET INTERFACE:");
    cmbTcnetInterface.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        settings.tcnetInterface = cmbTcnetInterface.getSelectedId() - 2;  // 1=All(-1), 2+=NIC index
        forgetNicMove(nullptr, kNicTcnet);   // the operator's choice (AUDIT UI-6)
        if (sharedTcnetOutput.getIsRunning())
        {
            sharedTcnetOutput.stop();
            sharedTcnetOutput.refreshNetworkInterfaces();
            sharedTcnetOutput.start(nicIdToStart(cmbTcnetInterface, kNicTcnet) - 2);   // as listed now (AUDIT UI-6)
        }
        saveSettings();
    };

    // TCNet layer selector (per-engine, selects which TCNet layer 1-4 this engine announces)
    addRightLabelAndCombo(lblTcnetLayer, cmbTcnetLayer, "TCNET LAYER:");
    cmbTcnetLayer.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        int sel = cmbTcnetLayer.getSelectedId() - 1;  // 1-4 -> 0-3
        currentEngine().setTcnetLayer(sel);
        repopulateTcnetLayerCombo();
        saveSettings();
    };

    rightContent.addAndMakeVisible(sldTcnetOffset);
    sldTcnetOffset.setSliderStyle(juce::Slider::LinearHorizontal);
    sldTcnetOffset.setTextBoxStyle(juce::Slider::TextBoxRight, false, 52, 20);
    sldTcnetOffset.setRange(-1000.0, 1000.0, 1.0);
    sldTcnetOffset.setValue(0.0, juce::dontSendNotification);
    sldTcnetOffset.setTextValueSuffix(" ms");
    sldTcnetOffset.setDoubleClickReturnValue(true, 0.0);
    sldTcnetOffset.setColour(juce::Slider::backgroundColourId, juce::Colour(0xFF1A1D23));
    sldTcnetOffset.setColour(juce::Slider::trackColourId, juce::Colour(0xFF37474F));
    sldTcnetOffset.setColour(juce::Slider::thumbColourId, juce::Colour(0xFF78909C));
    sldTcnetOffset.setColour(juce::Slider::textBoxTextColourId, textBright);
    sldTcnetOffset.setColour(juce::Slider::textBoxBackgroundColourId, juce::Colour(0xFF1A1D23));
    sldTcnetOffset.setColour(juce::Slider::textBoxOutlineColourId, borderCol);
    rightContent.addAndMakeVisible(lblTcnetOffset);
    lblTcnetOffset.setText("TCNET OFFSET:", juce::dontSendNotification);
    styleLabel(lblTcnetOffset);
    sldTcnetOffset.onValueChange = [this] { if (!syncing && !isShowLockedSlider(sldTcnetOffset, currentEngine().getTcnetOutputOffsetMs())) { currentEngine().setTcnetOutputOffsetMs((int)sldTcnetOffset.getValue()); saveSettings(); } };

    // Global TCNet offset: same range as per-engine ±1000 ms doubled to
    // ±2000 ms (full venue capture/encode chains can run hundreds of ms
    // on their own), summed inside sharedTcnetOutput.setLayerFromEngine
    // before SMPTE encoding.  Wired to update both settings.tcnetGlobalOffsetMs
    // and sharedTcnetOutput.setGlobalOffsetMs() so the change is live
    // immediately and persists across launches.  Show Lock blocks edits
    // for consistency with the per-engine offset.
    rightContent.addAndMakeVisible(sldTcnetGlobalOffset);
    sldTcnetGlobalOffset.setSliderStyle(juce::Slider::LinearHorizontal);
    sldTcnetGlobalOffset.setTextBoxStyle(juce::Slider::TextBoxRight, false, 52, 20);
    sldTcnetGlobalOffset.setRange(-2000.0, 2000.0, 1.0);
    sldTcnetGlobalOffset.setValue(0.0, juce::dontSendNotification);
    sldTcnetGlobalOffset.setTextValueSuffix(" ms");
    sldTcnetGlobalOffset.setDoubleClickReturnValue(true, 0.0);
    sldTcnetGlobalOffset.setColour(juce::Slider::backgroundColourId, juce::Colour(0xFF1A1D23));
    sldTcnetGlobalOffset.setColour(juce::Slider::trackColourId, juce::Colour(0xFF37474F));
    sldTcnetGlobalOffset.setColour(juce::Slider::thumbColourId, juce::Colour(0xFF78909C));
    sldTcnetGlobalOffset.setColour(juce::Slider::textBoxTextColourId, textBright);
    sldTcnetGlobalOffset.setColour(juce::Slider::textBoxBackgroundColourId, juce::Colour(0xFF1A1D23));
    sldTcnetGlobalOffset.setColour(juce::Slider::textBoxOutlineColourId, borderCol);
    rightContent.addAndMakeVisible(lblTcnetGlobalOffset);
    lblTcnetGlobalOffset.setText("TCNET GLOBAL OFFSET:", juce::dontSendNotification);
    styleLabel(lblTcnetGlobalOffset);
    sldTcnetGlobalOffset.onValueChange = [this]
    {
        if (syncing) return;
        if (isShowLockedSlider(sldTcnetGlobalOffset, settings.tcnetGlobalOffsetMs)) return;
        const int v = (int) sldTcnetGlobalOffset.getValue();
        settings.tcnetGlobalOffsetMs = v;
        sharedTcnetOutput.setGlobalOffsetMs(v);
        saveSettings();
    };

    // --- Hippotizer output controls ---
    rightContent.addAndMakeVisible(lblHippoDestIp);
    lblHippoDestIp.setText("HIPPONET DEST IP:", juce::dontSendNotification);
    styleLabel(lblHippoDestIp);
    rightContent.addAndMakeVisible(txtHippoDestIp);
    txtHippoDestIp.setText("255.255.255.255", false);
    txtHippoDestIp.setFont(juce::Font(juce::FontOptions(13.0f)));
    txtHippoDestIp.setColour(juce::TextEditor::backgroundColourId, juce::Colour(0xFF1A1D23));
    txtHippoDestIp.setColour(juce::TextEditor::textColourId, textBright);
    txtHippoDestIp.setColour(juce::TextEditor::outlineColourId, borderCol);
    auto hippoIpChanged = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto& eng = currentEngine();
        if (eng.isOutputHippoEnabled())
        {
            juce::String ip = txtHippoDestIp.getText().trim();
            if (ip.isEmpty()) ip = "255.255.255.255";
            eng.stopHippotizerOutput();
            eng.startHippotizerOutput(ip);
        }
        saveSettings();
    };
    txtHippoDestIp.onReturnKey = hippoIpChanged;
    txtHippoDestIp.onFocusLost = hippoIpChanged;
    rightContent.addAndMakeVisible(lblHippoOutStatus);
    lblHippoOutStatus.setFont(juce::Font(juce::FontOptions(11.0f)));
    lblHippoOutStatus.setColour(juce::Label::textColourId, textMid);

    addRightLabelAndCombo(lblAudioOutputTypeFilter, cmbAudioOutputTypeFilter, "AUDIO DRIVER:");
    cmbAudioOutputTypeFilter.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        populateFilteredOutputDeviceCombos();
        auto& eng = currentEngine();
        if (eng.isOutputLtcEnabled()) startCurrentLtcOutput();
        if (eng.isOutputThruEnabled()) startCurrentThruOutput();
        saveSettings();
    };

    addRightLabelAndCombo(lblAudioOutputDevice, cmbAudioOutputDevice, "LTC OUTPUT DEVICE:");
    cmbAudioOutputDevice.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (cmbAudioOutputDevice.getSelectedId() > 0
            && cmbAudioOutputDevice.getSelectedId() != kPlaceholderItemId && currentEngine().isOutputLtcEnabled())
        {
            startCurrentLtcOutput();
            populateFilteredOutputDeviceCombos();  // refresh markers (auto-restores both combos)
            saveSettings();
        }
    };

    addRightLabelAndCombo(lblAudioOutputChannel, cmbAudioOutputChannel, "LTC CHANNEL:");

    // Sample rate and buffer size for the output device.  These are the same
    // global values the input panel shows: the audio configuration applies to
    // every device STC opens, in either direction and across all engines, and
    // an ASIO driver has a single rate and buffer for the whole interface
    // anyway.  Mirroring them here makes that visible instead of leaving them
    // looking like input-only settings (issue #18); the two pairs stay in
    // step because they read and write the same setting.
    addRightLabelAndCombo(lblSampleRateOut, cmbSampleRateOut, "SAMPLE RATE:");
    addRightLabelAndCombo(lblBufferSizeOut, cmbBufferSizeOut, "BUFFER SIZE:");
    cmbSampleRateOut.setTooltip("Shared by every audio device STC uses, input and output");
    cmbBufferSizeOut.setTooltip("Shared by every audio device STC uses, input and output");
    cmbSampleRateOut.onChange = [this] {
        if (syncing || isShowLockedRevert()) return;
        cmbSampleRate.setSelectedId(cmbSampleRateOut.getSelectedId(), juce::dontSendNotification);
        restartAllAudioDevices(); saveSettings();
    };
    cmbBufferSizeOut.onChange = [this] {
        if (syncing || isShowLockedRevert()) return;
        cmbBufferSize.setSelectedId(cmbBufferSizeOut.getSelectedId(), juce::dontSendNotification);
        restartAllAudioDevices(); saveSettings();
    };
    cmbAudioOutputChannel.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (currentEngine().isOutputLtcEnabled() && cmbAudioOutputDevice.getSelectedId() > 0
            && cmbAudioOutputDevice.getSelectedId() != kPlaceholderItemId)
        { startCurrentLtcOutput(); saveSettings(); }
    };

    rightContent.addAndMakeVisible(sldLtcOutputGain); styleGainSlider(sldLtcOutputGain);
    rightContent.addAndMakeVisible(lblLtcOutputGain); lblLtcOutputGain.setText("LTC OUTPUT GAIN:", juce::dontSendNotification); styleLabel(lblLtcOutputGain);
    rightContent.addAndMakeVisible(mtrLtcOutput); mtrLtcOutput.setMeterColour(accentPurple);
    sldLtcOutputGain.onValueChange = [this] { if (!syncing && !isShowLockedSlider(sldLtcOutputGain, currentEngine().getLtcOutput().getOutputGain() * 100.0f)) { currentEngine().getLtcOutput().setOutputGain((float)sldLtcOutputGain.getValue() / 100.0f); saveSettings(); } };

    rightContent.addAndMakeVisible(btnLtcHoldOnPause);
    // A boolean option of the LTC output, not an output in its own right, so
    // it gets the plain checkbox treatment used by the other option toggles
    // (ON-AIR ONLY, TRACK MAP) rather than styleOutputToggle, which is
    // reserved for the protocol outputs themselves.
    btnLtcHoldOnPause.setColour(juce::ToggleButton::textColourId, textMid);
    btnLtcHoldOnPause.setColour(juce::ToggleButton::tickColourId, accentPurple);
    btnLtcHoldOnPause.onClick = [this]
    {
        if (syncing) return;
        if (isShowLocked()) { btnLtcHoldOnPause.setToggleState(!btnLtcHoldOnPause.getToggleState(), juce::dontSendNotification); return; }
        currentEngine().getLtcOutput().setHoldOnPause(btnLtcHoldOnPause.getToggleState());
        saveSettings();
    };

    // MANUAL user bits only: ST 12 sets no digit order for free-form hex and
    // readers differ; this lets the operator match the reader in front of
    // them.  Hidden in the other modes (DATE and NAME are addressed by group
    // number per the standards; FROM LTC IN passes groups through).
    rightContent.addAndMakeVisible(btnLtcUserBitsReverse);
    btnLtcUserBitsReverse.setColour(juce::ToggleButton::textColourId, textMid);
    btnLtcUserBitsReverse.setColour(juce::ToggleButton::tickColourId, accentPurple);
    btnLtcUserBitsReverse.onClick = [this]
    {
        if (syncing) return;
        if (isShowLocked()) { btnLtcUserBitsReverse.setToggleState(!btnLtcUserBitsReverse.getToggleState(), juce::dontSendNotification); return; }
        currentEngine().setLtcUserBitsReversed(btnLtcUserBitsReverse.getToggleState());
        saveSettings();
    };

    rightContent.addAndMakeVisible(lblOutputLtcStatus); styleLabel(lblOutputLtcStatus); lblOutputLtcStatus.setColour(juce::Label::textColourId, accentPurple);
    rightContent.addAndMakeVisible(sldLtcOffset); styleOffsetSlider(sldLtcOffset);
    rightContent.addAndMakeVisible(lblLtcOffset); lblLtcOffset.setText("LTC OFFSET:", juce::dontSendNotification); styleLabel(lblLtcOffset);
    sldLtcOffset.onValueChange = [this] { if (!syncing && !isShowLockedSlider(sldLtcOffset, currentEngine().getLtcOutputOffset())) { currentEngine().setLtcOutputOffset((int)sldLtcOffset.getValue()); saveSettings(); } };

    // LTC user bits (SMPTE 12M binary groups).  Issue #13.
    // Source mode first, then the manual value field.
    addRightLabelAndCombo(lblLtcUserBitsMode, cmbLtcUserBitsMode, "LTC USER BITS:");
    cmbLtcUserBitsMode.addItem("MANUAL VALUE", 1);
    cmbLtcUserBitsMode.addItem("FROM LTC IN",  2);
    cmbLtcUserBitsMode.addItem("DATE (ST 309)", 3);
    cmbLtcUserBitsMode.addItem("NAME (4 CHAR)", 4);
    cmbLtcUserBitsMode.addItem("DEBUG: BUFFER COUNTER", 5);   // #19: audio buffer boundaries visible on the wire
    cmbLtcUserBitsMode.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        auto& e = currentEngine();
        e.setLtcUserBitsMode(cmbLtcUserBitsMode.getSelectedId() - 1);
        const int m = e.getLtcUserBitsMode();
        const bool manual = m == TimecodeEngine::kUserBitsManual;
        const bool named  = m == TimecodeEngine::kUserBitsName;
        txtLtcUserBits.setReadOnly(!manual && !named);
        applyUserBitsFieldMode(m);
        if (manual)
            txtLtcUserBits.setText(e.getLtcUserBitsHex(), juce::dontSendNotification);
        else if (named)
            txtLtcUserBits.setText(e.getLtcUserBitsName(), juce::dontSendNotification);
        btnLtcUserBitsReverse.setVisible(manual && btnLtcHoldOnPause.isVisible());
        resized();
        saveSettings();
    };

    rightContent.addAndMakeVisible(lblLtcUserBits);
    styleLabel(lblLtcUserBits);
    rightContent.addAndMakeVisible(txtLtcUserBits);
    txtLtcUserBits.setFont(juce::Font(juce::FontOptions(11.0f)));
    txtLtcUserBits.setColour(juce::TextEditor::backgroundColourId, juce::Colour(0xFF222222));
    txtLtcUserBits.setColour(juce::TextEditor::textColourId, juce::Colours::white);
    txtLtcUserBits.setJustification(juce::Justification::centred);
    // The label text, the input restrictions and the placeholder all depend
    // on the user-bits mode (hex digits vs four characters), so they have a
    // single owner rather than being set here and overridden later.
    applyUserBitsFieldMode(TimecodeEngine::kUserBitsManual);
    auto applyUserBits = [this]
    {
        if (syncing || isShowLockedRevert()) return;
        auto& e = currentEngine();
        if (e.getLtcUserBitsMode() == TimecodeEngine::kUserBitsName)
        {
            e.setLtcUserBitsName(txtLtcUserBits.getText());
            txtLtcUserBits.setText(e.getLtcUserBitsName(), juce::dontSendNotification);
        }
        else
        {
            e.setLtcUserBitsHex(txtLtcUserBits.getText());
            // Reflect the normalised value back (upper-case, zeros collapsed)
            txtLtcUserBits.setText(e.getLtcUserBitsHex(), juce::dontSendNotification);
        }
        saveSettings();
    };
    txtLtcUserBits.onReturnKey  = applyUserBits;
    txtLtcUserBits.onFocusLost  = applyUserBits;

    // AudioThru controls visible for all engines in the panel but only functional for engine 0
    addRightLabelAndCombo(lblThruOutputDevice, cmbThruOutputDevice, "AUDIO THRU OUTPUT DEVICE:");
    cmbThruOutputDevice.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (currentEngine().isOutputThruEnabled() && cmbThruOutputDevice.getSelectedId() != kPlaceholderItemId)
        {
            startCurrentThruOutput();
            populateFilteredOutputDeviceCombos();  // refresh markers (auto-restores both combos)
            saveSettings();
        }
    };

    addRightLabelAndCombo(lblThruOutputChannel, cmbThruOutputChannel, "AUDIO THRU OUTPUT CHANNEL:");
    cmbThruOutputChannel.onChange = [this]
    {
        if (syncing) return;
        if (isShowLockedRevert()) return;
        if (currentEngine().isOutputThruEnabled() && cmbThruOutputDevice.getSelectedId() != kPlaceholderItemId)
        { startCurrentThruOutput(); saveSettings(); }
    };

    rightContent.addAndMakeVisible(sldThruOutputGain); styleGainSlider(sldThruOutputGain);
    rightContent.addAndMakeVisible(lblThruOutputGain); lblThruOutputGain.setText("AUDIO THRU OUTPUT GAIN:", juce::dontSendNotification); styleLabel(lblThruOutputGain);
    rightContent.addAndMakeVisible(mtrThruOutput); mtrThruOutput.setMeterColour(accentCyan);
    sldThruOutputGain.onValueChange = [this] {
        auto* thru = currentEngine().getAudioThru();
        if (syncing || thru == nullptr) return;
        if (isShowLockedSlider(sldThruOutputGain, thru->getOutputGain() * 100.0f)) return;
        thru->setOutputGain((float)sldThruOutputGain.getValue() / 100.0f);
        saveSettings();
    };

    rightContent.addAndMakeVisible(lblOutputThruStatus); styleLabel(lblOutputThruStatus); lblOutputThruStatus.setColour(juce::Label::textColourId, accentCyan);

    rightContent.addAndMakeVisible(btnRefreshDevices);
    // Locked like the device selectors: the rescan ends in applyAudioSettings,
    // which reopens LTC in and out, Audio Thru and the generators' audio on
    // every engine -- a gap on every LTC output (AUDIT UI-1).
    btnRefreshDevices.onClick = [this]
    {
        if (isShowLocked()) return;
        populateMidiAndNetworkCombos();
        startAudioDeviceScan();
    };
    btnRefreshDevices.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF1A1D23));
    btnRefreshDevices.setColour(juce::TextButton::textColourOffId, textMid);

    addAndMakeVisible(btnGitHub);
    btnGitHub.setFont(juce::Font(juce::FontOptions(getMonoFontName(), 9.0f, juce::Font::plain)), false);
    btnGitHub.setColour(juce::HyperlinkButton::textColourId, juce::Colour(0xFF546E7A));

    // --- Update checker button (hidden until update found) ---
    addChildComponent(btnUpdateAvailable);   // hidden by default
    btnUpdateAvailable.setFont(juce::Font(juce::FontOptions(getMonoFontName(), 10.0f, juce::Font::bold)), false);
    btnUpdateAvailable.setColour(juce::HyperlinkButton::textColourId, juce::Colour(0xFF4FC3F7));  // cyan

    addAndMakeVisible(btnCheckUpdates);
    btnCheckUpdates.setColour(juce::TextButton::buttonColourId, juce::Colours::transparentBlack);
    btnCheckUpdates.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFF546E7A));
    btnCheckUpdates.onClick = [this]
    {
        auto appVer = juce::JUCEApplication::getInstance()->getApplicationVersion();
        updateNotificationShown = false;
        updateCheckDelay = 0;
        btnUpdateAvailable.setVisible(false);
        btnCheckUpdates.setButtonText("Checking...");
        btnCheckUpdates.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFF78909C));
        updateChecker.checkAsync(appVer);
    };
    updateCheckDelay = 180;  // ~3 seconds at 60Hz before first check

    // =====================================================================
    // STARTUP
    // =====================================================================
    populateMidiAndNetworkCombos();
    loadAndApplyNonAudioSettings();

    // A settings, TrackMap, mixer map or preset file that exists but could
    // not be read has been moved aside (SafeJsonFile) and defaults are in
    // use.  Say so once, now, rather than let the operator find out at the
    // show that the configuration is gone.
    if (SafeJsonFile::lastLoadProblem().isNotEmpty())
    {
        const juce::String problem = SafeJsonFile::lastLoadProblem();
        SafeJsonFile::lastLoadProblem().clear();
        juce::MessageManager::callAsync([problem]
        {
            juce::AlertWindow::showMessageBoxAsync(juce::MessageBoxIconType::WarningIcon,
                "Configuration file could not be read",
                problem + "\nNothing has been overwritten. The files are in the "
                "SuperTimecodeConverter folder of your application data directory.");
        });
    }

    for (auto* cmb : { &cmbAudioInputDevice, &cmbAudioOutputDevice, &cmbThruOutputDevice, &cmbGenAudioDevice })
        cmb->addItem("Scanning...", kPlaceholderItemId);

    startTimerHz(60);
    startAudioDeviceScan();

    // GPU-accelerated rendering: DISABLED for thread safety.
    //
    // When glContext.attachTo(*this) is active, JUCE calls paint() for ALL
    // child components on the OpenGL thread -- not the message thread.
    // Meanwhile, timerCallback() writes juce::String members (artist, title,
    // playState, sourceName, etc.) on the message thread.  juce::String is
    // reference-counted: a concurrent read during write can corrupt the
    // refcount and crash.  This affects TimecodeDisplay, ProDJLinkView,
    // all juce::Label instances, and any component that reads String data
    // in paint().
    //
    // JUCE's OpenGL renderer paints into software images on the CPU and
    // only uses the GPU for the final texture upload + composite.  With
    // the waveform image cache, HiDPI deck image cache, and targeted
    // dirty-rect repainting already in place, the performance difference
    // is negligible.  Windows DWM already hardware-accelerates the native
    // GDI composite path.
    //
    // For a live performance application, eliminating the entire class of
    // GL-thread data races is worth more than the marginal compositing
    // speedup.  If GPU acceleration is ever re-enabled, all juce::String
    // members read in paint() must be replaced with atomic-safe types
    // (fixed char arrays, packed atomics, or a SpinLock-protected snapshot).
}

MainComponent::~MainComponent()
{
    // 1. Stop our UI timer first -- no more timerCallback() after this
    stopTimer();

    // 2. Detach LookAndFeel before destroying any child components
    setLookAndFeel(nullptr);

    // 3. Settings are saved once, at the end of step 6, with every floating
    //    window's bounds and the main window's (stored by MainWindow before
    //    it quit); the engines are still alive there.  The exit used to save
    //    three times (AUDIT UI-12).

    // 4. UpdateChecker thread stops in its own destructor (10s timeout)

    // 5. Stop AudioScanThread (see stopAudioScanThread)
    stopAudioScanThread();

    // 6. Capture window bounds before closing (delete doesn't call closeButtonPressed)
    if (trackMapWindow != nullptr)
    {
        auto b = trackMapWindow->getBounds();
        settings.trackMapBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        delete trackMapWindow.getComponent();
    }

    if (mixerMapWindow != nullptr)
    {
        auto b = mixerMapWindow->getBounds();
        settings.mixerMapBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        delete mixerMapWindow.getComponent();
    }

    if (genPresetWindow != nullptr)
    {
        auto b = genPresetWindow->getBounds();
        settings.genPresetBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                 + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        delete genPresetWindow.getComponent();
    }

    if (genWaveformWindow != nullptr)
    {
        auto b = genWaveformWindow->getBounds();
        settings.genWaveformBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                   + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        delete genWaveformWindow.getComponent();
    }

    oscInputServer.stop();

    if (proDJLinkViewWindow != nullptr)
    {
        auto b = proDJLinkViewWindow->getBounds();
        settings.pdlViewBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                               + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        settings.pdlViewHorizontal = proDJLinkViewWindow->getLayoutHorizontal();
        settings.pdlViewAlternating = proDJLinkViewWindow->getLayoutAlternating();
        settings.pdlViewShowMixer  = proDJLinkViewWindow->getShowMixer();
        proDJLinkViewWindow.reset();
    }

    if (stageLinQViewWindow != nullptr)
    {
        auto b = stageLinQViewWindow->getBounds();
        settings.slqViewBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                               + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        settings.slqViewHorizontal = stageLinQViewWindow->getLayoutHorizontal();
        stageLinQViewWindow.reset();
    }

    // The one save at exit: flushSettings copies the engines' state into the
    // settings and writes them (nothing, after a restore: AUDIT SET-5).
    flushSettings();

    // 7. Stop ProDJLink receiver FIRST. This joins its thread, so nothing
    //    can fire onPlayerLost, onPlayerMoved or onMediaChanged after this
    //    returns.
    sharedProDJLinkInput.stop();

    // 8. Now it's safe to disconnect the callbacks and stop DbClient.
    //    Reassigning std::function from another thread while the ProDJLink
    //    thread might be invoking it would be a race (std::function is not
    //    atomic). Doing it after stop() ensures the callback isn't running.
    sharedProDJLinkInput.onPlayerLost = nullptr;
    sharedProDJLinkInput.onPlayerMoved = nullptr;
    sharedProDJLinkInput.onMediaChanged = nullptr;
    sharedDbClient.stop();

    // 9. Stop StageLinQ receiver first to join its thread, so the callbacks
    //    (onMetadataRequest, onFileTransferAvailable) can't fire into a
    //    stopped StageLinQ db client.
    sharedStageLinQInput.stop();

    // 10. Now stop StageLinQ database client
    sharedStageLinQDb.stop();

    // 11. Explicitly shut down each engine (timers, threads, sockets)
    //    BEFORE engines.clear() destroys the objects, so all HighResolutionTimer
    //    threads are stopped while the message manager is still alive.
    //    Also disconnect shared pointers (TrackMap, MixerMap, ProDJLink, DbServer)
    //    so no stale references survive into AppSettings destruction.
    //
    // Order is important: the generator audio player and Audio BPM are
    // clients of a shared device (AudioDeviceHub, DESIGN D23) whose callback
    // reads atomics from this engine; releasing them here waits for an
    // in-flight callback to return BEFORE engines.clear() races the
    // destructor.  TriggerOutput's MIDI and OSC are closed for the same
    // reason.  Without these explicit stops a closing app could trip an
    // std::atomic load on a member whose owning engine had already started
    // destruction.
    for (auto& eng : engines)
    {
        eng->setMidiClockEnabled(false);
        eng->setTrackMap(nullptr);
        eng->setMixerMap(nullptr);
        eng->setSlqMixerMap(nullptr);
        eng->setSharedProDJLinkInput(nullptr);
        eng->setSharedStageLinQInput(nullptr);
        eng->setDbServerClient(nullptr);
        eng->stopGeneratorAudio();      // releases its hub device client + stops the read-ahead thread
        eng->stopAudioBpm();            // releases its hub device client + frees the BTT analyser
        eng->getTriggerOutput().stopMidi();
        eng->getTriggerOutput().disconnectOsc();
        eng->stopMtcOutput();
        eng->stopArtnetOutput();
        eng->stopLANetTCOutput();
        eng->stopLtcOutput();
        eng->stopThruOutput();
        eng->stopMtcInput();
        eng->stopArtnetInput();
        eng->stopLANetTCInput();
        eng->stopLtcInput();
    }

    // 12. Now safe to destroy engine objects
    engines.clear();

    // 13. Every audio client has released its device; close the shared
    // devices and drop their managers while JUCE is still alive, so the
    // hub's static instance destroys nothing at process exit.
    AudioDeviceHub::shutdown();
}

//==============================================================================
// ENGINE MANAGEMENT
//==============================================================================
void MainComponent::addEngine()
{
    if ((int)engines.size() >= kMaxEngines)
        return;

    // Generate a unique name
    int nameNum = (int)engines.size() + 1;
    auto nameExists = [this](const juce::String& name) {
        for (auto& e : engines)
            if (e->getName() == name) return true;
        return false;
    };
    juce::String newName;
    do { newName = "ENGINE " + juce::String(nameNum++); } while (nameExists(newName));

    int newIndex = (int)engines.size();
    engines.push_back(std::make_unique<TimecodeEngine>(newIndex, newName));
    engines.back()->setSharedProDJLinkInput(&sharedProDJLinkInput);
    engines.back()->setSharedStageLinQInput(&sharedStageLinQInput);
    engines.back()->setDbServerClient(&sharedDbClient);
    engines.back()->setTrackMap(&settings.trackMap);
    engines.back()->setMixerMap(&sharedMixerMap);
    engines.back()->setSlqMixerMap(&sharedSlqMixerMap);
    rebuildTabButtons();
    selectEngine(newIndex);
    saveSettings();
}

void MainComponent::removeEngine(int index)
{
    if (engines.size() <= 1 || index < 0 || index >= (int)engines.size())
        return;

    // Flush pending settings before modifying arrays
    if (settingsDirty)
        flushSettings();

    // A TrackMap editor open on an engine's override layer holds a reference
    // into that engine; indices shift on removal, so close it.
    if (trackMapWindow != nullptr && trackMapEditorScope >= 0)
    {
        if (cuePointWindow != nullptr) { cuePointWindow.reset(); cuePointTrackKey.clear(); }
        delete trackMapWindow.getComponent();
        trackMapEditorScope = -1;
    }

    // Remember if the deleted engine was the primary and had thru enabled,
    // so we can restart AudioThru on the new primary after reindexing.
    bool deletedWasPrimary = engines[(size_t)index]->isPrimary();
    bool deletedHadThru    = deletedWasPrimary
                           && engines[(size_t)index]->isOutputThruEnabled();

    // Explicitly stop all protocols on the engine being deleted BEFORE
    // erasing it, so destructors don't race with any pending callbacks.
    // Disconnect shared pointers first to prevent stale access during stop.
    engines[(size_t)index]->setTrackMap(nullptr);
    engines[(size_t)index]->setMixerMap(nullptr);
    engines[(size_t)index]->setSlqMixerMap(nullptr);
    engines[(size_t)index]->setSharedProDJLinkInput(nullptr);
    engines[(size_t)index]->setSharedStageLinQInput(nullptr);
    engines[(size_t)index]->setDbServerClient(nullptr);
    engines[(size_t)index]->setMidiClockEnabled(false);
    engines[(size_t)index]->getTriggerOutput().setSharedMidiOutput(nullptr);
    engines[(size_t)index]->stopMtcOutput();
    engines[(size_t)index]->stopArtnetOutput();
    engines[(size_t)index]->stopLANetTCOutput();
    engines[(size_t)index]->stopLtcOutput();
    engines[(size_t)index]->stopThruOutput();
    engines[(size_t)index]->stopMtcInput();
    engines[(size_t)index]->stopArtnetInput();
    engines[(size_t)index]->stopLANetTCInput();
    engines[(size_t)index]->stopLtcInput();

    // Detach waveform views from the engine about to be deleted so we never
    // dereference a dangling player/engine pointer in setAudioPlayer (called
    // from the syncUIFromEngine() that follows the erase).
    miniWaveform.setAudioPlayer(nullptr);
    miniWaveform.setEngine(nullptr);
    if (genWaveformWindow != nullptr)
    {
        if (auto* content = dynamic_cast<GeneratorWaveformWindow*>(genWaveformWindow->getContentComponent()))
        {
            content->setAudioPlayer(nullptr);
            content->setEngine(nullptr);
        }
    }

    forgetNicMoves(engines[(size_t)index].get());   // keyed by the engine about to go
    engines.erase(engines.begin() + index);

    // Re-index remaining engines so isPrimary() and getIndex() stay correct.
    // This also creates AudioThru on the new primary engine if engine 0 was deleted.
    for (int i = 0; i < (int)engines.size(); i++)
        engines[(size_t)i]->reindex(i);

    // Keep settings.engines in sync with engines vector
    if (index < (int)settings.engines.size())
        settings.engines.erase(settings.engines.begin() + index);

    // Fix selectedEngine to track the same engine after shift
    if (index < selectedEngine)
        selectedEngine--;               // engine we were on shifted left
    else if (selectedEngine >= (int)engines.size())
        selectedEngine = (int)engines.size() - 1;  // we deleted the one we were on (or last)

    rebuildTabButtons();
    syncUIFromEngine();

    // If the deleted engine was the primary with AudioThru active,
    // the new primary engine (index 0) got a fresh AudioThru instance
    // from reindex() but it's not started.  Attempt to restart it if
    // the new primary's LTC input is running and thru settings exist.
    if (deletedHadThru && !engines.empty())
    {
        auto& newPrimary = *engines[0];
        if (newPrimary.getActiveInput() == SrcType::LTC
            && newPrimary.getLtcInput().getIsRunning()
            && !settings.engines.empty()
            && settings.engines[0].thruOutEnabled)
        {
            newPrimary.setOutputThruEnabled(true);
            // If engine 0 is currently selected, use UI combos; otherwise use saved settings
            if (selectedEngine == 0)
            {
                startCurrentThruOutput();
            }
            else if (!settings.engines[0].thruOutputDevice.isEmpty())
            {
                int ch = settings.engines[0].thruOutputStereo ? -1 : settings.engines[0].thruOutputChannel;
                newPrimary.startThruOutput(settings.engines[0].thruOutputType,
                                           settings.engines[0].thruOutputDevice, ch,
                                           getPreferredSampleRate(), getPreferredBufferSize());
            }
        }
    }

    saveSettings();
}

void MainComponent::selectEngine(int index)
{
    if (index < 0 || index >= (int)engines.size() || index == selectedEngine)
        return;

    // Flush any pending settings from the current engine before switching
    if (settingsDirty)
        flushSettings();

    selectedEngine = index;
    inputConfigExpanded = true;
    mtcOutExpanded = artnetOutExpanded = ltcOutExpanded = thruOutExpanded = laNetTCOutExpanded = true;

    // Reset FPS tracking so buttons update immediately for new engine
    lastDisplayedFps    = engines[(size_t)index]->getCurrentFps();
    lastDisplayedOutFps = engines[(size_t)index]->getEffectiveOutputFps();

    syncUIFromEngine();
    updateTabAppearance();
    pushFpsToGenPresetEditor();
    repaint();
}

void MainComponent::renameEngine(int index)
{
    if (index < 0 || index >= (int)engines.size()) return;

    auto alertWindow = std::make_shared<juce::AlertWindow>("Rename Engine",
                                                "Enter a name for this engine:",
                                                juce::MessageBoxIconType::NoIcon, this);
    alertWindow->addTextEditor("name", engines[(size_t)index]->getName());
    alertWindow->addButton("OK", 1);
    alertWindow->addButton("Cancel", 0);

    juce::Component::SafePointer<MainComponent> safeThis(this);
    alertWindow->enterModalState(true, juce::ModalCallbackFunction::create(
        [safeThis, index, alertWindow](int result)
        {
            if (result == 1 && safeThis != nullptr)
            {
                auto newName = alertWindow->getTextEditorContents("name").trim();
                if (newName.isNotEmpty() && index < (int)safeThis->engines.size())
                {
                    safeThis->engines[(size_t)index]->setName(newName);
                    // Only update text -- don't rebuild buttons (avoids heap
                    // corruption from destroying components during modal callback)
                    safeThis->updateTabAppearance();
                    safeThis->resized();  // reposition in case text width changed
                    safeThis->saveSettings();
                }
            }
            // alertWindow destroyed when shared_ptr goes out of scope
        }), false);  // deleteWhenDismissed = false -- shared_ptr owns the window
}

//==============================================================================
// TAB BAR
//==============================================================================
void MainComponent::rebuildTabButtons()
{
    for (auto& tb : tabButtons)
        removeChildComponent(tb.get());
    tabButtons.clear();

    for (int i = 0; i < (int)engines.size(); i++)
    {
        auto btn = std::make_unique<TabButton>(engines[(size_t)i]->getName());
        btn->setClickingTogglesState(false);
        int idx = i;
        btn->onClick = [this, idx] { selectEngine(idx); };
        btn->onRightClick = [this, idx] { showTabContextMenu(idx); };
        addAndMakeVisible(btn.get());
        tabButtons.push_back(std::move(btn));
    }

    updateTabAppearance();
    resized();

    // Disable "+" button when at max engines
    btnAddEngine.setEnabled((int)engines.size() < kMaxEngines);
    btnAddEngine.setAlpha((int)engines.size() < kMaxEngines ? 1.0f : 0.3f);
}

void MainComponent::updateTabAppearance()
{
    for (int i = 0; i < (int)tabButtons.size(); i++)
    {
        bool active = (i == selectedEngine);
        auto& btn = *tabButtons[(size_t)i];
        btn.setButtonText(engines[(size_t)i]->getName());
        btn.setColour(juce::TextButton::buttonColourId, active ? accentBlue.withAlpha(0.2f) : juce::Colour(0xFF1A1D23));
        btn.setColour(juce::TextButton::textColourOffId, active ? textBright : textMid);
    }
}

void MainComponent::showTabContextMenu(int index)
{
    if (isShowLocked()) return;  // no engine changes during show

    juce::PopupMenu menu;
    menu.addItem(1, "Rename");
    if (engines.size() > 1)
        menu.addItem(2, "Delete");

    juce::Component::SafePointer<MainComponent> safeThis(this);
    menu.showMenuAsync(juce::PopupMenu::Options(), [safeThis, index](int result) {
        if (safeThis == nullptr) return;
        if (result == 1) safeThis->renameEngine(index);
        else if (result == 2) safeThis->removeEngine(index);
    });
}

//==============================================================================
// SYNC UI <-> ENGINE
//==============================================================================
void MainComponent::syncUIFromEngine()
{
    syncing = true;

    auto& eng = currentEngine();

    // Generator waveform: re-bind mini view (and floating window if open) to
    // the now-selected engine's audio player and engine.
    miniWaveform.setAudioPlayer(&eng.getGeneratorAudio());
    miniWaveform.setEngine(&eng);
    if (genWaveformWindow != nullptr)
    {
        if (auto* content = dynamic_cast<GeneratorWaveformWindow*>(genWaveformWindow->getContentComponent()))
        {
            content->setAudioPlayer(&eng.getGeneratorAudio());
            content->setEngine(&eng);
        }
    }

    // Input buttons
    updateInputButtonStates();
    updateBpmMultButtonStates();

    // FPS
    updateFpsButtonStates();
    btnFpsConvert.setToggleState(eng.isFpsConvertEnabled(), juce::dontSendNotification);
    updateOutputFpsButtonStates();

    // Output toggles
    btnMtcOut.setToggleState(eng.isOutputMtcEnabled(), juce::dontSendNotification);
    btnArtnetOut.setToggleState(eng.isOutputArtnetEnabled(), juce::dontSendNotification);
    btnLANetTCOut.setToggleState(eng.isOutputLANetTCEnabled(), juce::dontSendNotification);
    btnLtcOut.setToggleState(eng.isOutputLtcEnabled(), juce::dontSendNotification);

    // AudioThru toggle: only show for primary engine
    btnThruOut.setToggleState(eng.isOutputThruEnabled(), juce::dontSendNotification);
    btnThruOut.setVisible(eng.isPrimary());
    btnTcnetOut.setToggleState(eng.isOutputTcnetEnabled(), juce::dontSendNotification);
    repopulateTcnetLayerCombo();
    btnHippoOut.setToggleState(eng.isOutputHippoEnabled(), juce::dontSendNotification);
    if (selectedEngine < (int)settings.engines.size())
        txtHippoDestIp.setText(settings.engines[(size_t)selectedEngine].hippotizerDestIp, false);

    // On-air gate
    btnOnAirGate.setToggleState(eng.isOnAirGateEnabled(), juce::dontSendNotification);
    cmbOnAirQuiet.setSelectedId(eng.getOnAirQuietStep() + 1, juce::dontSendNotification);

    // Generator TC fields
    btnGenClock.setToggleState(eng.getGeneratorClockMode(), juce::dontSendNotification);
    txtGenStartTC.setText(msToTimecodeString(eng.getGeneratorStartMs(), eng.getCurrentFps()), false);
    txtGenStopTC.setText(msToTimecodeString(eng.getGeneratorStopMs(), eng.getCurrentFps()), false);
    populateGenPresetCombo();
    // Show the preset in use (persisted per engine) without re-applying it,
    // or none: the selection populateGenPresetCombo keeps is the previous
    // engine's, and GO would apply it to this one.
    cmbGenPreset.setSelectedId(0, juce::dontSendNotification);
    for (int i = 0; i < cmbGenPreset.getNumItems(); ++i)
        if (cmbGenPreset.getItemText(i) == eng.getGeneratorPresetName())
        {
            cmbGenPreset.setSelectedItemIndex(i, juce::dontSendNotification);
            break;
        }

    // OSC Input (global)
    btnOscIn.setToggleState(oscInputServer.getIsRunning(), juce::dontSendNotification);
    txtOscInPort.setText(juce::String(settings.oscInputPort), false);
    cmbOscInputInterface.setSelectedId(settings.oscInputInterface + 1, juce::dontSendNotification);

    // Offsets
    sldMtcOffset.setValue(eng.getMtcOutputOffset(), juce::dontSendNotification);
    sldArtnetOffset.setValue(eng.getArtnetOutputOffset(), juce::dontSendNotification);
    sldLANetTCOffset.setValue(eng.getLANetTCOutputOffset(), juce::dontSendNotification);
    sldLtcOffset.setValue(eng.getLtcOutputOffset(), juce::dontSendNotification);
    cmbLtcUserBitsMode.setSelectedId(juce::jlimit(0, (int) TimecodeEngine::kUserBitsDebugBuffers,
                                                  eng.getLtcUserBitsMode()) + 1,
                                     juce::dontSendNotification);
    {
        const int ubMode = eng.getLtcUserBitsMode();
        const bool manualUb = ubMode == TimecodeEngine::kUserBitsManual;
        const bool namedUb  = ubMode == TimecodeEngine::kUserBitsName;
        applyUserBitsFieldMode(ubMode);
        txtLtcUserBits.setReadOnly(!manualUb && !namedUb);
        txtLtcUserBits.setText(
            manualUb ? eng.getLtcUserBitsHex()
                     : namedUb ? eng.getLtcUserBitsName()
                     : TimecodeEngine::normaliseUserBitsHex(
                           juce::String::toHexString((juce::int64) eng.getEffectiveLtcUserBits())),
            juce::dontSendNotification);
    }
    {
    }
    sldTcnetOffset.setValue(eng.getTcnetOutputOffsetMs(), juce::dontSendNotification);
    sldTcnetGlobalOffset.setValue(settings.tcnetGlobalOffsetMs, juce::dontSendNotification);

    // Gains
    if (eng.isAudioBpmRunning() && eng.getActiveInput() != SrcType::LTC)
        sldLtcInputGain.setValue(eng.getAudioBpmInput().getInputGain() * 100.0f, juce::dontSendNotification);
    else
        sldLtcInputGain.setValue(eng.getLtcInput().getInputGain() * 100.0f, juce::dontSendNotification);
    sldThruInputGain.setValue(eng.getLtcInput().getPassthruGain() * 100.0f, juce::dontSendNotification);
    sldLtcOutputGain.setValue(eng.getLtcOutput().getOutputGain() * 100.0f, juce::dontSendNotification);
    btnLtcHoldOnPause.setToggleState(eng.getLtcOutput().getHoldOnPause(), juce::dontSendNotification);
    btnLtcUserBitsReverse.setToggleState(eng.isLtcUserBitsReversed(), juce::dontSendNotification);
    cmbInputFreewheel.setSelectedId(eng.getInputFreewheelMs(), juce::dontSendNotification);
    if (eng.getAudioThru())
        sldThruOutputGain.setValue(eng.getAudioThru()->getOutputGain() * 100.0f, juce::dontSendNotification);

    // Repopulate device combos so in-use markers reflect the new engine context
    populateMidiAndNetworkCombos();
    populateFilteredInputDeviceCombo();
    populateFilteredOutputDeviceCombos();

    // MIDI device selections -- find matching device in combo
    // First try running device, then saved setting, else deselect
    {
        int idx = findDeviceByName(cmbMidiInputDevice, eng.getMtcInput().getCurrentDeviceName());
        if (idx < 0 && selectedEngine < (int)settings.engines.size())
            idx = findDeviceByName(cmbMidiInputDevice, settings.engines[(size_t)selectedEngine].midiInputDevice);
        cmbMidiInputDevice.setSelectedId(idx >= 0 ? idx + 1 : 0, juce::dontSendNotification);
    }
    {
        int idx = findDeviceByName(cmbMidiOutputDevice, eng.getMtcOutput().getCurrentDeviceName());
        if (idx < 0 && selectedEngine < (int)settings.engines.size())
            idx = findDeviceByName(cmbMidiOutputDevice, settings.engines[(size_t)selectedEngine].midiOutputDevice);
        cmbMidiOutputDevice.setSelectedId(idx >= 0 ? idx + 1 : 0, juce::dontSendNotification);
    }

    if (selectedEngine < (int)settings.engines.size())
    {
        auto& es = settings.engines[(size_t)selectedEngine];

        // Interface selections (Art-Net, LA-Net, HippoNet, DMX, and the
        // global TCNet, Pro DJ Link and StageLinQ) -- restore from the
        // settings, at their in-session positions.  A setting whose
        // interface is no longer listed selects nothing rather than
        // whatever now sits at its position (AUDIT UI-6).
        selectNicsFromSettings(false);
        cmbHippoTcChannel.setSelectedId(es.hippotizerTcChannel + 1, juce::dontSendNotification);
        eng.getHippotizerInput().setSelectedTcIndex(es.hippotizerTcChannel);

        // TrackMap toggle
        btnTrackMap.setToggleState(eng.isTrackMapEnabled(), juce::dontSendNotification);

        // MIDI Clock toggle
        btnMidiClock.setToggleState(eng.isMidiClockEnabled(), juce::dontSendNotification);

        // OSC Forward toggle + address fields
        btnOscFwdBpm.setToggleState(eng.isOscForwardEnabled(), juce::dontSendNotification);
        btnOscMixerFwd.setToggleState(eng.isOscMixerForwardEnabled(), juce::dontSendNotification);
        btnMidiMixerFwd.setToggleState(eng.isMidiMixerForwardEnabled(), juce::dontSendNotification);
        cmbMidiMixCCCh.setSelectedId(eng.getMidiMixerCCChannel(), juce::dontSendNotification);
        cmbMidiMixNoteCh.setSelectedId(eng.getMidiMixerNoteChannel(), juce::dontSendNotification);
        btnArtnetMixerFwd.setToggleState(eng.isArtnetMixerForwardEnabled(), juce::dontSendNotification);
        setArtNetCombosFromAddress(cmbArtMixNet, cmbArtMixSub, cmbArtMixUni, eng.getArtnetMixerUniverse());
        setArtNetCombosFromAddress(cmbArtTrigNet, cmbArtTrigSub, cmbArtTrigUni, eng.getArtnetTriggerUniverse());
        edOscFwdBpmAddr.setText(eng.getOscFwdBpmAddr(), false);
        edOscFwdBpmCmd.setText(eng.getOscFwdBpmCmd(), false);

        // Ableton Link toggle
        btnLink.setToggleState(eng.getLinkBridge().isEnabled(), juce::dontSendNotification);

        // Audio BPM toggle + smoothing
        btnAudioBpm.setToggleState(eng.isAudioBpmRunning(), juce::dontSendNotification);
        sldBpmSmoothing.setValue(eng.getAudioBpmInput().getSmoothing() * 100.0f, juce::dontSendNotification);

        // When LTC is active, Audio BPM uses separate device/channel combos
        if (eng.getActiveInput() == SrcType::LTC && eng.isAudioBpmRunning())
        {
            cmbAudioBpmDevice.clear(juce::dontSendNotification);
            for (int i = 0; i < scannedAudioInputs.size(); i++)
            {
                auto marker = getDeviceInUseMarker(scannedAudioInputs[i].deviceName,
                                                    scannedAudioInputs[i].typeName, true);
                cmbAudioBpmDevice.addItem(scannedAudioInputs[i].displayName + marker, i + 1);
            }
            // Select saved device
            for (int i = 0; i < scannedAudioInputs.size(); i++)
                if (scannedAudioInputs[i].deviceName == es.audioBpmDevice
                    && scannedAudioInputs[i].typeName == es.audioBpmType)
                { cmbAudioBpmDevice.setSelectedId(i + 1, juce::dontSendNotification); break; }
            populateAudioBpmChannels();
            int abChId = es.audioBpmChannel + 2;
            if (abChId >= 1 && abChId <= cmbAudioBpmChannel.getNumItems())
                cmbAudioBpmChannel.setSelectedId(abChId, juce::dontSendNotification);
            sldBpmInputGain.setValue(eng.getAudioBpmInput().getInputGain() * 100.0f, juce::dontSendNotification);
        }

        // Pro DJ Link (per-engine player) -- ids 1-6 = players, 7=XF-A, 8=XF-B, 9=MASTER, 10=ON AIR
        cmbProDJLinkPlayer.setSelectedId(juce::jlimit(1, 10, es.proDJLinkPlayer), juce::dontSendNotification);

        // ProDJLink bridge identity + 95B keepalive scope (global)
        cmbPdlBridgeIdentity.setSelectedId(
            juce::jlimit(0, 3, settings.prodjlinkBridgeIdentity) + 1,
            juce::dontSendNotification);
        cmbPdl95bMode.setSelectedId(
            juce::jlimit(0, 2, settings.prodjlink95bMode) + 1,
            juce::dontSendNotification);

        // Trigger toggles + destination
        auto& trig = eng.getTriggerOutput();
        btnTriggerMidi.setToggleState(trig.isMidiEnabled(), juce::dontSendNotification);
        btnTriggerOsc.setToggleState(trig.isOscEnabled(), juce::dontSendNotification);
        btnArtnetTrigger.setToggleState(eng.isArtnetTriggerEnabled(), juce::dontSendNotification);

        // Populate trigger MIDI device combo
        trig.refreshMidiDevices();
        cmbTriggerMidiDevice.clear(juce::dontSendNotification);
        for (int d = 0; d < trig.getMidiDeviceCount(); ++d)
            cmbTriggerMidiDevice.addItem(trig.getMidiDeviceName(d), d + 1);
        if (trig.isMidiOpen())
        {
            int idx = trig.findMidiDeviceByName(trig.getCurrentMidiDeviceName());
            if (idx >= 0) cmbTriggerMidiDevice.setSelectedId(idx + 1, juce::dontSendNotification);
        }
        else if (es.triggerMidiDevice.isNotEmpty())
        {
            int idx = trig.findMidiDeviceByName(es.triggerMidiDevice);
            if (idx >= 0) cmbTriggerMidiDevice.setSelectedId(idx + 1, juce::dontSendNotification);
        }

        edOscIp.setText(es.oscDestIp.isNotEmpty() ? es.oscDestIp : "127.0.0.1", false);
        edOscPort.setText(juce::String(es.oscDestPort > 0 ? es.oscDestPort : 53000), false);
    }

    // Audio device selections -- find matching device in filtered list
    if (selectedEngine < (int)settings.engines.size())
    {
        auto& es = settings.engines[(size_t)selectedEngine];

        // Audio input device: use Audio BPM device when BPM is active on a non-LTC source
        bool bpmUsesSharedAudio = eng.isAudioBpmRunning() && eng.getActiveInput() != SrcType::LTC;
        juce::String inType  = bpmUsesSharedAudio ? es.audioBpmType   : es.audioInputType;
        juce::String inDev   = bpmUsesSharedAudio ? es.audioBpmDevice : es.audioInputDevice;
        int audioInIdx = findFilteredIndex(filteredInputIndices, scannedAudioInputs, inType, inDev);
        cmbAudioInputDevice.setSelectedId(audioInIdx >= 0 ? audioInIdx + 1 : 0, juce::dontSendNotification);

        int audioOutIdx = findFilteredIndex(filteredOutputIndices, scannedAudioOutputs,
                                             es.audioOutputType, es.audioOutputDevice);
        cmbAudioOutputDevice.setSelectedId(audioOutIdx >= 0 ? audioOutIdx + 1 : 0, juce::dontSendNotification);

        int thruOutIdx = findFilteredIndex(filteredOutputIndices, scannedAudioOutputs,
                                            es.thruOutputType, es.thruOutputDevice);
        cmbThruOutputDevice.setSelectedId(thruOutIdx >= 0 ? thruOutIdx + 1 : 0, juce::dontSendNotification);

        int genAudioIdx = findFilteredIndex(filteredOutputIndices, scannedAudioOutputs,
                                             es.generatorAudioType, es.generatorAudioDevice);
        cmbGenAudioDevice.setSelectedId(genAudioIdx >= 0 ? genAudioIdx + 1 : 0, juce::dontSendNotification);

        btnGenAudioOut.setToggleState(eng.isGeneratorAudioRunning() || es.generatorAudioEnabled,
                                       juce::dontSendNotification);
    }

    // Audio channel selections based on running engines
    if (eng.getLtcInput().getIsRunning())
    {
        int ch = eng.getLtcInput().getSelectedChannel();
        if (ch >= 0) cmbAudioInputChannel.setSelectedId(ch + 1, juce::dontSendNotification);

        if (eng.getLtcInput().hasPassthruChannel())
        {
            int thruCh = eng.getLtcInput().getPassthruChannel();
            if (thruCh >= 0) cmbThruInputChannel.setSelectedId(thruCh + 1, juce::dontSendNotification);
        }
    }
    else if (eng.isAudioBpmRunning())
    {
        int ch = eng.getAudioBpmInput().getSelectedChannel();
        if (ch >= 0) cmbAudioInputChannel.setSelectedId(ch + 1, juce::dontSendNotification);
    }
    else if (selectedEngine < (int)settings.engines.size())
    {
        auto& es = settings.engines[(size_t)selectedEngine];
        cmbAudioInputChannel.setSelectedId(es.audioInputChannel + 1, juce::dontSendNotification);
        cmbThruInputChannel.setSelectedId(es.thruInputChannel + 1, juce::dontSendNotification);
    }

    if (eng.getLtcOutput().getIsRunning())
    {
        int ch = eng.getLtcOutput().getSelectedChannel();
        if (ch == -1)
            cmbAudioOutputChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
        else if (ch >= 0)
            cmbAudioOutputChannel.setSelectedId(ch + 1, juce::dontSendNotification);
    }
    else if (selectedEngine < (int)settings.engines.size())
    {
        auto& es = settings.engines[(size_t)selectedEngine];
        if (es.audioOutputStereo)
            cmbAudioOutputChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
        else
            cmbAudioOutputChannel.setSelectedId(es.audioOutputChannel + 1, juce::dontSendNotification);
    }

    if (eng.getAudioThru() && eng.getAudioThru()->getIsRunning())
    {
        int ch = eng.getAudioThru()->getSelectedChannel();
        if (ch == -1)
            cmbThruOutputChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
        else if (ch >= 0)
            cmbThruOutputChannel.setSelectedId(ch + 1, juce::dontSendNotification);
    }
    else if (selectedEngine < (int)settings.engines.size())
    {
        auto& es = settings.engines[(size_t)selectedEngine];
        if (es.thruOutputStereo)
            cmbThruOutputChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
        else
            cmbThruOutputChannel.setSelectedId(es.thruOutputChannel + 1, juce::dontSendNotification);
    }

    if (eng.isGeneratorAudioRunning())
    {
        populateGenAudioChannels();
        int ch = eng.getGeneratorAudio().getSelectedChannel();
        if (ch == -1)
            cmbGenAudioChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
        else if (ch >= 0)
            cmbGenAudioChannel.setSelectedId(ch + 1, juce::dontSendNotification);
    }
    else if (selectedEngine < (int)settings.engines.size())
    {
        auto& es = settings.engines[(size_t)selectedEngine];
        if (es.generatorAudioStereo)
            cmbGenAudioChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
        else
            cmbGenAudioChannel.setSelectedId(es.generatorAudioChannel + 1, juce::dontSendNotification);
    }

    // Per-engine volume and file channel mode for gen audio playback.
    if (selectedEngine < (int)settings.engines.size())
    {
        const auto& es = settings.engines[(size_t)selectedEngine];
        sldGenAudioVolume.setValue(es.generatorAudioVolume, juce::dontSendNotification);

        // File channel mode (1=Stereo, 2=L only, 3=R only).
        cmbGenAudioFileMode.setSelectedId(juce::jlimit(0, 2, es.generatorAudioFileChannelMode) + 1,
                                           juce::dontSendNotification);
    }

    updateDeviceSelectorVisibility();
    resized();
    repaint();

    syncing = false;
}

//==============================================================================
// ENGINE-LEVEL START/STOP (gathers params from UI)
//==============================================================================
void MainComponent::startCurrentMtcInput()
{
    auto& eng = currentEngine();
    // The device shown, or with an empty selector the configured one if it
    // is listed now; otherwise nothing is opened (AUDIT UI-6).
    const juce::String saved = selectedEngine >= 0 && selectedEngine < (int) settings.engines.size()
                             ? settings.engines[(size_t) selectedEngine].midiInputDevice : juce::String();
    eng.startMtcInput(midiDeviceToStart(cmbMidiInputDevice, midiInputNames, saved, true));
}

void MainComponent::startCurrentArtnetInput()
{
    auto& eng = currentEngine();
    int sel = nicIdToStart(cmbArtnetInputInterface, kNicArtnetIn) - 1;
    eng.startArtnetInput(sel);
}

void MainComponent::startCurrentLANetTCInput()
{
    auto& eng = currentEngine();
    int sel = nicIdToStart(cmbLANetTCInputInterface, kNicLANetIn) - 1;
    eng.startLANetTCInput(sel);
}

void MainComponent::startCurrentLtcInput()
{
    auto& eng = currentEngine();
    auto entry = getSelectedAudioInput();
    if (entry.deviceName.isEmpty() && !filteredInputIndices.isEmpty())
    { cmbAudioInputDevice.setSelectedId(1, juce::dontSendNotification); entry = getSelectedAudioInput(); }

    int ltcCh = cmbAudioInputChannel.getSelectedId() - 1;
    if (ltcCh < 0) ltcCh = 0;

    int thruCh = -1;
    if (eng.isPrimary() && eng.isOutputThruEnabled())
    { thruCh = cmbThruInputChannel.getSelectedId() - 1; if (thruCh < 0) thruCh = 1; }

    if (eng.startLtcInput(entry.typeName, entry.deviceName, ltcCh, thruCh,
                           getPreferredSampleRate(), getPreferredBufferSize()))
    {
        eng.getLtcInput().setInputGain((float)sldLtcInputGain.getValue() / 100.0f);
        eng.getLtcInput().setPassthruGain((float)sldThruInputGain.getValue() / 100.0f);
        populateAudioInputChannels();
        if (eng.isPrimary() && eng.isOutputThruEnabled())
            startCurrentThruOutput();
    }
    saveSettings();
}


void MainComponent::startCurrentProDJLinkInput()
{
    auto& eng = currentEngine();
    bool pdlListed = false;
    int iface = nicIdToStart(cmbProDJLinkInterface, kNicProDJLink, &pdlListed) - 1;
    int player = cmbProDJLinkPlayer.getSelectedId();
    if (player < 1) player = 1;
    if (iface < 0) iface = 0;

    // If already running on a DIFFERENT interface, stop and restart.
    // This handles the case where the user changes the network interface
    // combo while ProDJLink is active. Without this, the new interface
    // selection is ignored because start() bails on getIsRunning()==true.
    // Compared by address: the running input's position is one in the list
    // of its own start, iface one in today's (AUDIT UI-6).  Only when the
    // interface wanted is listed now (nicIdToStart): one that is not -- a
    // cable out, no address yet -- leaves iface at a position that names
    // another interface or none, and the running input stays where it is,
    // as it did when the positions were compared.
    const auto pdlNets = getNetworkInterfaces();   // the list ProDJLinkInput::start takes
    const juce::String pdlWantIp = pdlNets.isEmpty() ? juce::String()
                                 : pdlNets[juce::jlimit(0, pdlNets.size() - 1, iface)].ip;
    if (sharedProDJLinkInput.getIsRunning() && pdlListed
        && sharedProDJLinkInput.getBindInfo() != pdlWantIp)
    {
        DBG("MainComponent: ProDJLink interface changed from "
            << sharedProDJLinkInput.getBindInfo() << " to " << pdlWantIp
            << " -- restarting");
        sharedProDJLinkInput.stop();
        // DbClient also needs restart since it depends on network connectivity
        sharedDbClient.stop();
    }

    // Apply the identity/95B settings BEFORE any (re)start.  The 95B mode is
    // also applied when already running: it is a live send-gate and the
    // "does status keep flowing once the 95B stops" experiment depends on
    // being able to flip it mid-session.  Identity changes, in contrast, are
    // applied here but only take full effect through the restart path (see
    // the cmbPdlBridgeIdentity onChange, which stops the connection first).
    sharedProDJLinkInput.setBridgeIdentityProfile(settings.prodjlinkBridgeIdentity);
    sharedProDJLinkInput.setDbKeepaliveMode(settings.prodjlink95bMode);

    // Start shared connection if not already running
    if (!sharedProDJLinkInput.getIsRunning())
    {
        sharedProDJLinkInput.refreshNetworkInterfaces();
        sharedProDJLinkInput.start(iface);
    }

    // Phase 2: start dbClient for metadata queries
    if (!sharedDbClient.getIsRunning())
    {
        DBG("MainComponent: starting DbServerClient for metadata queries");
        sharedDbClient.start();
    }
    else
    {
        DBG("MainComponent: DbServerClient already running");
    }

    // Set this engine's player
    eng.startProDJLinkInput(player);
    sharedProDJLinkInput.setOutputFrameRate(eng.getCurrentFps());
}

void MainComponent::startCurrentStageLinQInput()
{
    auto& eng = currentEngine();
    bool slqListed = false;
    int iface = nicIdToStart(cmbStageLinQInterface, kNicStageLinQ, &slqListed) - 1;
    int player = cmbProDJLinkPlayer.getSelectedId();
    if (player < 1) player = 1;
    if (iface < 0) iface = 0;

    // If already running on a DIFFERENT interface, stop and restart --
    // compared by address, and only when the interface wanted is listed
    // now, as for Pro DJ Link (AUDIT UI-6).
    const auto slqNets = getNetworkInterfaces();   // the list StageLinQInput::start takes
    const juce::String slqWantIp = slqNets.isEmpty() ? juce::String()
                                 : slqNets[juce::jlimit(0, slqNets.size() - 1, iface)].ip;
    if (sharedStageLinQInput.getIsRunning() && slqListed
        && sharedStageLinQInput.getBindInfo() != slqWantIp)
    {
        DBG("MainComponent: StageLinQ interface changed from "
            << sharedStageLinQInput.getBindInfo() << " to " << slqWantIp
            << " -- restarting");
        sharedStageLinQInput.stop();
        sharedStageLinQDb.stop();
    }

    // Start shared StageLinQ connection if not already running
    if (!sharedStageLinQInput.getIsRunning())
    {
        sharedStageLinQInput.refreshNetworkInterfaces();
        sharedStageLinQInput.start(iface);
    }

    // Set this engine's deck (DECK 1-4, XF-A / XF-B, ON AIR)
    eng.startStageLinQInput(player);
}

void MainComponent::startCurrentHippotizerInput()
{
    auto& eng = currentEngine();
    int sel = nicIdToStart(cmbHippoInputInterface, kNicHippoIn) - 1;
    eng.startHippotizerInput(sel);
}

void MainComponent::applyTriggerSettings()
{
    auto& eng = currentEngine();
    auto& trig = eng.getTriggerOutput();

    // --- MIDI ---
    trig.setMidiEnabled(btnTriggerMidi.getToggleState());
    bool needsMidi = btnTriggerMidi.getToggleState() || eng.isMidiClockEnabled()
                  || eng.isMidiMixerForwardEnabled();
    if (needsMidi)
    {
        auto trigDevName = stripComboMarker(cmbTriggerMidiDevice.getText());

        // Share MtcOutput's handle if it's already open on the same device
        if (eng.getMtcOutput().getIsRunning()
            && trigDevName == eng.getMtcOutput().getCurrentDeviceName())
        {
            trig.releaseOwnMidi();
            trig.setSharedMidiOutput(eng.getMtcOutput().getMidiOutputPtr());
        }
        else
        {
            // Different device or MTC not running -- open our own handle
            trig.setSharedMidiOutput(nullptr);
            int sel = cmbTriggerMidiDevice.getSelectedId() - 1;
            if (sel >= 0)
            {
                if (!trig.hasOwnMidiOpen()
                    || trig.getCurrentMidiDeviceName() != trigDevName)
                {
                    trig.startMidi(sel);
                }
            }
        }
    }
    else
    {
        trig.setSharedMidiOutput(nullptr);
        trig.stopMidi();
    }

    // --- OSC ---
    trig.setOscEnabled(btnTriggerOsc.getToggleState());
    bool needsOsc = btnTriggerOsc.getToggleState() || eng.isOscForwardEnabled()
                 || eng.isOscMixerForwardEnabled();
    if (needsOsc)
    {
        auto ip = edOscIp.getText().trim();
        if (ip.isEmpty()) ip = "127.0.0.1";
        int port = edOscPort.getText().getIntValue();
        if (port <= 0 || port > 65535) port = 53000;

        if (!trig.isOscConnected())
            trig.connectOsc(ip, port);
        else
            trig.updateOscDestination(ip, port);
    }
    else
    {
        trig.disconnectOsc();
    }

    // Refresh visibility (MIDI device combo / OSC fields show/hide)
    updateDeviceSelectorVisibility();
    resized();
}

//==============================================================================
// Propagate global Pro DJ Link settings to all engines.
// BPM sources (MIDI Clock, OSC BPM, Ableton Link) and mixer forward
// are network-global: one master, one DJM. When enabled on any engine,
// all engines should share the same enabled state.
//==============================================================================
void MainComponent::propagateGlobalSettings()
{
    auto& cur = currentEngine();

    bool clockEn   = cur.isMidiClockEnabled();
    bool oscBpmEn  = cur.isOscForwardEnabled();
    auto  bpmAddr  = cur.getOscFwdBpmAddr();
    auto  bpmCmd   = cur.getOscFwdBpmCmd();
    bool oscMixEn  = cur.isOscMixerForwardEnabled();
    bool midiMixEn = cur.isMidiMixerForwardEnabled();
    int  midiCCCh  = cur.getMidiMixerCCChannel();
    int  midiNotCh = cur.getMidiMixerNoteChannel();
    bool artMixEn  = cur.isArtnetMixerForwardEnabled();
    int  artMixUni = cur.getArtnetMixerUniverse();

    for (auto& engPtr : engines)
    {
        if (engPtr.get() == &cur) continue;
        auto& eng = *engPtr;

        eng.setMidiClockEnabled(clockEn);
        eng.setOscForward(oscBpmEn, bpmAddr, bpmCmd);
        eng.setOscMixerForward(oscMixEn);
        eng.setMidiMixerForward(midiMixEn, midiCCCh, midiNotCh);
        eng.setArtnetMixerForward(artMixEn, artMixUni);
        // Link is NOT propagated -- it's exclusive (only one engine at a time)
    }
}

void MainComponent::persistTrackMapScope(int scope)
{
    if (scope < 0)
    {
        settings.trackMap.save();
        for (auto& eng : engines)
            eng->refreshTrackMapLookup();
    }
    else if (scope < (int) engines.size())
    {
        // The override layer lives in the engine and is copied into its
        // settings block on save.
        saveSettings();
        engines[(size_t) scope]->refreshTrackMapLookup();
    }
}

void MainComponent::openTrackMapEditor(int scopeEngine)
{
    if (scopeEngine >= (int) engines.size())
        scopeEngine = -1;

    // If already open on the same scope, bring to front; on another scope,
    // close and re-open on the requested map.
    if (trackMapWindow != nullptr)
    {
        if (scopeEngine == trackMapEditorScope)
        {
            trackMapWindow->toFront(true);
            return;
        }
        delete trackMapWindow.getComponent();
    }
    // A cue point editor open on an entry of another map would keep a
    // reference into it; close it rather than let two scopes coexist.
    if (cuePointWindow != nullptr && cuePointEditorScope != scopeEngine)
    {
        cuePointWindow.reset();
        cuePointTrackKey.clear();
    }
    trackMapEditorScope = scopeEngine;

    auto& eng = currentEngine();

    TrackMap& scopedMap = (scopeEngine < 0) ? settings.trackMap
                                            : engines[(size_t) scopeEngine]->getTrackMapOverrides().map;
    auto* editor = new TrackMapEditor(scopedMap, &sharedProDJLinkInput);
    {
        juce::StringArray names;
        for (auto& e : engines) names.add(e->getName());
        editor->setScope(scopeEngine, names, &settings.trackMap);
    }
    juce::Component::SafePointer<MainComponent> safeSelf(this);
    editor->onScopeChange = [safeSelf](int chosen)
    {
        // Re-open from the message queue: the request comes from inside the
        // editor that is about to be deleted.
        juce::MessageManager::callAsync([safeSelf, chosen]
        {
            if (safeSelf == nullptr) return;
            auto* self = safeSelf.getComponent();
            if (self->isShowLocked())
            {
                // Configuration is locked: put the selector back where it was.
                if (self->trackMapWindow != nullptr)
                    if (auto* ed = dynamic_cast<TrackMapEditor*>(self->trackMapWindow->getContentComponent()))
                    {
                        juce::StringArray names;
                        for (auto& e : self->engines) names.add(e->getName());
                        ed->setScope(self->trackMapEditorScope, names, &self->settings.trackMap);
                    }
                return;
            }
            self->openTrackMapEditor(chosen);
        });
    };
    editor->setDbServerClient(&sharedDbClient);
    {
        auto info = eng.getActiveTrackInfo();
        editor->setActiveTrack(info.artist, info.title);
    }
    // Show the Learn "Player:" combo only when the current engine uses a
    // ProDJLink source.  StageLinQ exposes its loaded track via the engine's
    // cached track info (read through the onLearnTrackInfo callback below),
    // and Winamp has no player concept -- in both cases the combo would be
    // misleading, so we hide it and force onLearn() to use the callback path.
    editor->setShowPlayerSelector(eng.getActiveInput() == SrcType::ProDJLink);

    editor->onChange = [this, scopeEngine]
    {
        // Close CuePointEditor FIRST, before save/refresh.  It holds a
        // TrackMapEntry& into the map: remove(), clear() and load() destroy
        // that entry, and addOrUpdate() of the same key replaces its
        // contents; a rehash moves no element.  The mutation has already
        // happened when this callback fires (synchronously, message
        // thread), so the editor is closed before anything can touch the
        // reference.
        if (cuePointWindow != nullptr)
        {
            cuePointWindow.reset();
            cuePointTrackKey.clear();
            cuePointEditedArtist.clear();
            cuePointEditedTitle.clear();
        }

        persistTrackMapScope(scopeEngine);
    };

    editor->onOpenCueEditor = [this](TrackMapEntry* entry)
    {
        if (entry && !settings.showModeLocked) openCuePointEditor(entry);
    };

    editor->onLearnTrackInfo = [this]() -> TrackMapEditor::LearnTrackInfo
    {
        // The generator reports its loaded file as a track (for TCNet
        // metadata), but the Track Map does not apply to generator files, so
        // Learn must not capture them -- an entry would sit there doing
        // nothing.  See BACKLOG "Track Map for generator files".
        if (currentEngine().getActiveInput() == SrcType::SystemTime)
            return {};
        auto info = currentEngine().getActiveTrackInfo();
        return { info.artist, info.title, info.durationSec };
    };

    // Non-modal window (self-deleting on close so SafePointer auto-nulls)
    struct FloatingWindow : juce::DocumentWindow
    {
        FloatingWindow(const juce::String& t, juce::Colour bg)
            : DocumentWindow(t, bg, DocumentWindow::closeButton | DocumentWindow::maximiseButton) {}
        void closeButtonPressed() override { if (onClose) onClose(); delete this; }
        std::function<void()> onClose;
    };

    auto* win = new FloatingWindow(scopeEngine < 0 ? juce::String("Track Map Editor")
                                                   : "Track Map Editor - " + engines[(size_t) scopeEngine]->getName() + " overrides",
                                   juce::Colour(0xFF12141A));
    win->setContentOwned(editor, true);
    win->setUsingNativeTitleBar(false);
    win->setTitleBarHeight(20);
    win->setColour(juce::DocumentWindow::textColourId, juce::Colour(0xFF546E7A));
    win->setResizable(true, true);
    win->centreWithSize(editor->getWidth(), editor->getHeight());
    if (settings.trackMapBounds.isNotEmpty())
    {
        auto parts = juce::StringArray::fromTokens(settings.trackMapBounds, " ", "");
        if (parts.size() == 4)
        {
            auto b = juce::Rectangle<int>(parts[0].getIntValue(), parts[1].getIntValue(),
                                           parts[2].getIntValue(), parts[3].getIntValue());
            if (b.getWidth() >= 200 && b.getHeight() >= 150)
            {
                auto c = b.getCentre();
                for (auto& d : juce::Desktop::getInstance().getDisplays().displays)
                    if (d.logicalBounds.contains(c.toFloat())) { win->setBounds(b); break; }
            }
        }
    }
    win->onClose = [this, win]()
    {
        auto b = win->getBounds();
        settings.trackMapBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        saveSettings();
    };
    win->setVisible(true);
    trackMapWindow = win;
}

void MainComponent::openCuePointEditor(TrackMapEntry* entry)
{
    if (!entry) return;

    // If already open for a different track, close it first
    if (cuePointWindow != nullptr)
    {
        cuePointWindow.reset();
    }

    cuePointWindow = std::make_unique<CuePointEditorWindow>(*entry);
    cuePointEditorScope   = trackMapEditorScope;   // the entry belongs to the open TrackMap editor's map
    cuePointTrackKey      = entry->key();
    cuePointEditedArtist  = entry->artist;
    cuePointEditedTitle   = entry->title;

    // The waveform cache (.wfc) has no source tag.  A Pioneer preview goes
    // under the Track Map key, which DbServerClient and the PDL View load
    // for a Pro DJ Link deck; a StageLinQ deck's Engine DJ overview goes
    // under a key of its own, so it is never taken for a Pioneer deck's
    // preview (AUDIT META-15).  A .wfc that does not load (none, or one an
    // older version left truncated) is written again (AUDIT META-10).
    const std::string slqWaveformKey = entry->key() + "|slq";

    // Try to find artwork, waveform, and duration for this track
    bool foundMeta = false;
    bool foundWaveform = false;
    bool foundArtwork = false;
    for (auto& eng : engines)
    {
        auto info = eng->getActiveTrackInfo();
        if (info.title.isNotEmpty()
            && TrackMapEntry::makeKey(info.artist, info.title, info.durationSec)
                == entry->key())
        {
            // The dbserver cache holds Pro DJ Link tracks only, keyed by the
            // player holding the media, the slot and the rekordbox ID
            // (AUDIT META-5); a StageLinQ engine's track ID is something else.
            if (info.trackId != 0 && eng->getActiveInput() == SrcType::ProDJLink)
            {
                const auto media = getPdlMediaSource(eng->getEffectivePlayer());
                auto meta = sharedDbClient.getCachedMetadata(media.ip, media.slot, info.trackId);

                // Artwork
                if (meta.artworkId != 0)
                {
                    auto art = sharedDbClient.getCachedArtwork(media.ip, media.slot, meta.artworkId);
                    if (art.isValid())
                    {
                        cuePointWindow->setArtwork(art);
                        foundArtwork = true;
                        if (!WaveformCache::artworkExists(entry->key()))
                            WaveformCache::saveArtwork(entry->key(), art);
                    }
                }

                // Waveform
                if (meta.hasWaveform())
                {
                    cuePointWindow->setWaveformData(meta.waveformData,
                        meta.waveformEntryCount, meta.waveformBytesPerEntry);
                    foundWaveform = true;

                    // Cache waveform to disk for offline use
                    if (!WaveformCache::load(entry->key()).valid)
                    {
                        uint32_t durMs = (meta.durationSeconds > 0)
                            ? (uint32_t)meta.durationSeconds * 1000
                            : (info.durationSec > 0 ? (uint32_t)info.durationSec * 1000 : 0);
                        WaveformCache::save(entry->key(), meta.waveformData,
                            meta.waveformEntryCount, meta.waveformBytesPerEntry, durMs);
                    }
                }

                // Duration
                if (meta.durationSeconds > 0)
                {
                    cuePointWindow->setDurationMs((uint32_t)meta.durationSeconds * 1000);
                    foundMeta = true;
                }
            }

            // Fallback duration: from engine (StageLinQ tracks have no dbClient metadata)
            if (!foundMeta && info.durationSec > 0)
                cuePointWindow->setDurationMs((uint32_t)info.durationSec * 1000);

            // StageLinQ: try waveform + artwork from StageLinQDbClient
            if (!foundWaveform
                && eng->getActiveInput() == SrcType::StageLinQ)
            {
                int deck = eng->getEffectivePlayer();
                auto netPath = sharedStageLinQInput.getTrackNetworkPath(deck);
                if (netPath.isNotEmpty())
                {
                    auto wf = sharedStageLinQDb.getWaveformForTrack(netPath);
                    if (wf.valid && !wf.data.empty())
                    {
                        cuePointWindow->setWaveformData(wf.data, wf.entryCount, 3);
                        foundWaveform = true;

                        if (!WaveformCache::load(slqWaveformKey).valid)
                        {
                            uint32_t durMs = (info.durationSec > 0)
                                ? (uint32_t)info.durationSec * 1000 : 0;
                            WaveformCache::save(slqWaveformKey, wf.data,
                                wf.entryCount, 3, durMs);
                        }
                    }

                    if (!foundArtwork)
                    {
                        auto art = sharedStageLinQDb.getArtworkForTrack(netPath);
                        if (art.isValid())
                        {
                            cuePointWindow->setArtwork(art);
                            foundArtwork = true;
                            if (!WaveformCache::artworkExists(entry->key()))
                                WaveformCache::saveArtwork(entry->key(), art);
                        }
                    }
                }
            }

            break;
        }
    }

    // If no engine has this track active, search the dbClient cache directly.
    // This covers tracks loaded on a player that no engine follows (e.g. Link Export
    // from another CDJ, or a player the user hasn't assigned to any engine).
    if (!foundWaveform || !foundArtwork)
    {
        auto entryKey = entry->key();
        for (int pn = 1; pn <= 6; ++pn)
        {
            if (!sharedProDJLinkInput.isPlayerDiscovered(pn)) continue;
            uint32_t tid = sharedProDJLinkInput.getTrackID(pn);
            if (tid == 0) continue;

            const auto media = getPdlMediaSource(pn);
            auto meta = sharedDbClient.getCachedMetadata(media.ip, media.slot, tid);
            if (!meta.isValid()) continue;

            auto metaKey = TrackMapEntry::makeKey(meta.artist, meta.title, meta.durationSeconds);
            if (metaKey != entryKey) continue;

            if (!foundArtwork && meta.artworkId != 0)
            {
                auto art = sharedDbClient.getCachedArtwork(media.ip, media.slot, meta.artworkId);
                if (art.isValid())
                {
                    cuePointWindow->setArtwork(art);
                    foundArtwork = true;
                    if (!WaveformCache::artworkExists(entry->key()))
                        WaveformCache::saveArtwork(entry->key(), art);
                }
            }
            if (!foundWaveform && meta.hasWaveform())
            {
                cuePointWindow->setWaveformData(meta.waveformData,
                    meta.waveformEntryCount, meta.waveformBytesPerEntry);
                foundWaveform = true;
                if (!WaveformCache::load(entry->key()).valid)
                {
                    uint32_t durMs = (meta.durationSeconds > 0)
                        ? (uint32_t)meta.durationSeconds * 1000 : 0;
                    WaveformCache::save(entry->key(), meta.waveformData,
                        meta.waveformEntryCount, meta.waveformBytesPerEntry, durMs);
                }
            }
            if (!foundMeta && meta.durationSeconds > 0)
            {
                cuePointWindow->setDurationMs((uint32_t)meta.durationSeconds * 1000);
                foundMeta = true;
            }
            break;
        }
    }

    // If no live waveform was found, try loading from cache: the Pioneer
    // preview, else the Engine DJ overview
    if (!foundWaveform)
    {
        auto cached = WaveformCache::load(entry->key());
        if (!cached.valid)
            cached = WaveformCache::load(slqWaveformKey);
        if (cached.valid)
        {
            cuePointWindow->setWaveformData(cached.data,
                cached.entryCount, cached.bytesPerEntry);
            // Use cached duration if we didn't get one from live sources
            if (!foundMeta && cached.durationMs > 0)
                cuePointWindow->setDurationMs(cached.durationMs);
        }
    }

    // If no live artwork was found, try loading from cache
    if (!foundArtwork)
    {
        auto cachedArt = WaveformCache::loadArtwork(entry->key());
        if (cachedArt.isValid())
            cuePointWindow->setArtwork(cachedArt);
    }

    // Last resort: use duration from the TrackMap entry itself
    if (!foundMeta && entry->durationSec > 0)
        cuePointWindow->setDurationMs((uint32_t)entry->durationSec * 1000);

    cuePointWindow->setOnChange([this]
    {
        // The entry belongs to the map this editor was opened from (the
        // global file or an engine's override layer).
        persistTrackMapScope(cuePointEditorScope);

        // Refresh TrackMap editor table if open (cue count column)
        if (trackMapWindow != nullptr)
        {
            if (auto* editor = dynamic_cast<TrackMapEditor*>(trackMapWindow->getContentComponent()))
                editor->refresh();
        }
    });

    cuePointWindow->setOnCapturePlayhead([this]() -> uint32_t
    {
        // Only return live playhead if the currently playing track matches
        // the track being edited.  Otherwise return sentinel so the editor
        // hides the red cursor and doesn't interfere with mouse editing.
        //
        // The match is on artist + title only, NOT on the full TrackMap
        // key (which includes duration), because duration is metadata
        // about the track rather than part of its identity:
        //   * Winamp / AIMP need a second or so after track load to
        //     decode the VBR duration -- before that, info.durationSec
        //     is 0 and a duration-keyed match would always fail for the
        //     first second of every track.
        //   * The user might have learned the TrackMap entry from a
        //     CDJ (rekordbox-derived duration) but be playing the same
        //     file through Winamp from a slightly differently encoded
        //     copy.  A few-second duration discrepancy is a normal MP3
        //     encoding artefact and should not break the cursor link
        //     when artist + title clearly identify the same song.
        // The full-key match path remains the primary way the engine's
        // lookupTrackInMap selects an entry; this looser comparison is
        // only used to decide whether the editor's UI playhead follows
        // the live playback.
        auto& eng = currentEngine();
        auto info = eng.getActiveTrackInfo();
        if (info.title.isEmpty()) return UINT32_MAX;

        std::string playingNoDur = TrackMapEntry::makeKey(info.artist, info.title, 0);
        std::string editingNoDur = TrackMapEntry::makeKey(cuePointEditedArtist,
                                                          cuePointEditedTitle, 0);
        if (playingNoDur != editingNoDur)
            return UINT32_MAX;

        return eng.getSmoothedPlayheadMs();
    });

    // Restore saved window position
    if (settings.cuePointBounds.isNotEmpty())
    {
        auto parts = juce::StringArray::fromTokens(settings.cuePointBounds, " ", "");
        if (parts.size() == 4)
        {
            auto b = juce::Rectangle<int>(parts[0].getIntValue(), parts[1].getIntValue(),
                                           parts[2].getIntValue(), parts[3].getIntValue());
            if (b.getWidth() >= 400 && b.getHeight() >= 300)
            {
                auto c = b.getCentre();
                for (auto& d : juce::Desktop::getInstance().getDisplays().displays)
                    if (d.logicalBounds.contains(c.toFloat())) { cuePointWindow->setBounds(b); break; }
            }
        }
    }

    // Save window position on close
    cuePointWindow->onBoundsCapture = [this]
    {
        if (cuePointWindow != nullptr)
        {
            auto b = cuePointWindow->getBounds();
            settings.cuePointBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                    + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
            saveSettings();
        }
    };
}

void MainComponent::openMixerMapEditor()
{
    if (mixerMapWindow != nullptr)
    {
        mixerMapWindow->toFront(true);
        return;
    }

    // Choose mixer map based on active input
    bool isSlq = currentEngine().getActiveInput() == SrcType::StageLinQ;
    MixerMap& activeMap = isSlq ? sharedSlqMixerMap : sharedMixerMap;

    auto* editor = new MixerMapEditor(activeMap,
                                      isSlq ? DjmModel::All : djmModelFromString(sharedProDJLinkInput.getDJMModel()));
    editor->onChange = [this, isSlq]
    {
        if (isSlq)
            sharedSlqMixerMap.save();
        else
            sharedMixerMap.save();
    };

    juce::String title = isSlq ? "Mixer Map - Denon StageLinQ" : "Mixer Map - DJM Parameter Routing";

    // Non-modal window (self-deleting on close so SafePointer auto-nulls)
    struct FloatingWindow : juce::DocumentWindow
    {
        FloatingWindow(const juce::String& t, juce::Colour bg)
            : DocumentWindow(t, bg, DocumentWindow::closeButton | DocumentWindow::maximiseButton) {}
        void closeButtonPressed() override { if (onClose) onClose(); delete this; }
        std::function<void()> onClose;
    };

    auto* win = new FloatingWindow(title, juce::Colour(0xFF12141A));
    win->setContentOwned(editor, true);
    win->setUsingNativeTitleBar(false);
    win->setTitleBarHeight(20);
    win->setColour(juce::DocumentWindow::textColourId, juce::Colour(0xFF546E7A));
    win->setResizable(true, true);
    win->centreWithSize(editor->getWidth(), editor->getHeight());
    if (settings.mixerMapBounds.isNotEmpty())
    {
        auto parts = juce::StringArray::fromTokens(settings.mixerMapBounds, " ", "");
        if (parts.size() == 4)
        {
            auto b = juce::Rectangle<int>(parts[0].getIntValue(), parts[1].getIntValue(),
                                           parts[2].getIntValue(), parts[3].getIntValue());
            if (b.getWidth() >= 200 && b.getHeight() >= 150)
            {
                auto c = b.getCentre();
                for (auto& d : juce::Desktop::getInstance().getDisplays().displays)
                    if (d.logicalBounds.contains(c.toFloat())) { win->setBounds(b); break; }
            }
        }
    }
    win->onClose = [this, win]()
    {
        auto b = win->getBounds();
        settings.mixerMapBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        saveSettings();
    };
    win->setVisible(true);
    mixerMapWindow = win;
}

void MainComponent::openProDJLinkView()
{
    // If already open and visible, bring to front
    if (proDJLinkViewWindow != nullptr && proDJLinkViewWindow->isVisible())
    {
        proDJLinkViewWindow->toFront(true);
        return;
    }

    // Recreate window (simpler than restarting timer + resetting state)
    proDJLinkViewWindow = std::make_unique<ProDJLinkViewWindow>(
        sharedProDJLinkInput, sharedDbClient, settings.trackMap, engines);

    // Restore layout state and window bounds
    proDJLinkViewWindow->setLayoutState(settings.pdlViewHorizontal, settings.pdlViewShowMixer);
    proDJLinkViewWindow->setLayoutAlternating(settings.pdlViewAlternating);
    if (settings.pdlViewBounds.isNotEmpty())
        proDJLinkViewWindow->restoreFromBoundsString(settings.pdlViewBounds);

    proDJLinkViewWindow->setOnTrackMapChanged([this]
    {
        settings.trackMap.save();
        for (auto& eng : engines)
            eng->refreshTrackMapLookup();
        updateBpmMultButtonStates();

        if (trackMapWindow != nullptr)
        {
            if (auto* editor = dynamic_cast<TrackMapEditor*>(trackMapWindow->getContentComponent()))
                editor->refresh();
        }
    });
    proDJLinkViewWindow->setIsShowLockedFn([this] { return settings.showModeLocked; });
    proDJLinkViewWindow->setOnLayoutChanged([this]
    {
        if (proDJLinkViewWindow != nullptr)
        {
            settings.pdlViewHorizontal = proDJLinkViewWindow->getLayoutHorizontal();
            settings.pdlViewAlternating = proDJLinkViewWindow->getLayoutAlternating();
            settings.pdlViewShowMixer  = proDJLinkViewWindow->getShowMixer();
            saveSettings();
        }
    });
    proDJLinkViewWindow->onBoundsCapture = [this]
    {
        if (proDJLinkViewWindow != nullptr)
        {
            auto b = proDJLinkViewWindow->getBounds();
            settings.pdlViewBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                   + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
            settings.pdlViewHorizontal = proDJLinkViewWindow->getLayoutHorizontal();
            settings.pdlViewAlternating = proDJLinkViewWindow->getLayoutAlternating();
            settings.pdlViewShowMixer  = proDJLinkViewWindow->getShowMixer();
            saveSettings();
        }
    };
}

void MainComponent::openStageLinQView()
{
    // If already open and visible, bring to front
    if (stageLinQViewWindow != nullptr && stageLinQViewWindow->isVisible())
    {
        stageLinQViewWindow->toFront(true);
        return;
    }

    stageLinQViewWindow = std::make_unique<StageLinQViewWindow>(
        sharedStageLinQInput, sharedStageLinQDb, settings.trackMap, engines);

    // Restore layout state and bounds
    if (settings.slqViewBounds.isNotEmpty())
        stageLinQViewWindow->restoreFromBoundsString(settings.slqViewBounds);

    stageLinQViewWindow->setOnLayoutChanged([this]
    {
        if (stageLinQViewWindow != nullptr)
        {
            settings.slqViewHorizontal = stageLinQViewWindow->getLayoutHorizontal();
            saveSettings();
        }
    });
    stageLinQViewWindow->onBoundsCapture = [this]
    {
        if (stageLinQViewWindow != nullptr)
        {
            auto b = stageLinQViewWindow->getBounds();
            settings.slqViewBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                   + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
            settings.slqViewHorizontal = stageLinQViewWindow->getLayoutHorizontal();
            saveSettings();
        }
    };
}

//==============================================================================
// CONFIGURATION BACKUP / RESTORE
//==============================================================================
void MainComponent::exportConfig()
{
    // The bundle is read back from the files on disk (buildExportBundle), so
    // write the current state first.  saveSettings() only armed the
    // half-second debounce, and a backup taken right after a change missed
    // it.  After a restore saves are suspended and nothing is written: the
    // backup then carries the restored files (AUDIT SET-5).
    flushSettings();
    sharedMixerMap.save();
    sharedSlqMixerMap.save();

    configFileChooser = std::make_unique<juce::FileChooser>(
        "Export STC Configuration",
        juce::File::getSpecialLocation(juce::File::userDesktopDirectory)
            .getChildFile("stc_backup.json"),
        "*.json");

    configFileChooser->launchAsync(
        juce::FileBrowserComponent::saveMode | juce::FileBrowserComponent::canSelectFiles,
        [this](const juce::FileChooser& fc)
        {
            auto file = fc.getResult();
            if (file == juce::File()) return;

            auto bundle = settings.buildExportBundle();
            file.replaceWithText(juce::JSON::toString(bundle));
        });
}

void MainComponent::importConfig()
{
    configFileChooser = std::make_unique<juce::FileChooser>(
        "Import STC Configuration",
        juce::File::getSpecialLocation(juce::File::userDesktopDirectory),
        "*.json");

    configFileChooser->launchAsync(
        juce::FileBrowserComponent::openMode | juce::FileBrowserComponent::canSelectFiles,
        [this](const juce::FileChooser& fc)
        {
            auto file = fc.getResult();
            if (file == juce::File() || !file.existsAsFile()) return;

            auto parsed = juce::JSON::parse(file.loadFileAsString());
            auto* obj = parsed.getDynamicObject();
            if (!obj || !obj->hasProperty("stc_backup_version"))
            {
                juce::AlertWindow::showMessageBoxAsync(
                    juce::MessageBoxIconType::WarningIcon,
                    "Import Failed",
                    "This file is not a valid STC backup.");
                return;
            }

            auto options = juce::MessageBoxOptions()
                .withIconType(juce::MessageBoxIconType::QuestionIcon)
                .withTitle("Import Configuration")
                .withMessage("This will replace ALL current settings, track maps, generator presets "
                             "and mixer maps. The application will need to restart to apply changes.\n\n"
                             "Continue?")
                .withButton("Import")
                .withButton("Cancel");

            importConfirmBox = juce::AlertWindow::showScopedAsync(options,
                [this, parsed](int result)
                {
                    if (result != 1) return;

                    // Close every editor holding a reference into the maps
                    // the reload below rebuilds: the cue editor a
                    // TrackMapEntry&, the Track Map editor row pointers into
                    // its map, the preset editor's cue window a
                    // GeneratorPreset&, the Mixer Map editor its map's
                    // entries (AUDIT SET-5).
                    if (cuePointWindow != nullptr)
                    {
                        cuePointWindow.reset();
                        cuePointTrackKey.clear();
                        cuePointEditedArtist.clear();
                        cuePointEditedTitle.clear();
                    }
                    if (trackMapWindow != nullptr)  delete trackMapWindow.getComponent();
                    if (genPresetWindow != nullptr) delete genPresetWindow.getComponent();
                    if (mixerMapWindow != nullptr)  delete mixerMapWindow.getComponent();

                    if (settings.applyImportBundle(parsed))
                    {
                        // From here to the restart nothing is saved: the
                        // running engines keep their configuration, and any
                        // save -- the debounced one, the exit one -- would
                        // write it back over the restored files (AUDIT SET-5;
                        // why, at SafeJsonFile::writesSuspended).  The message
                        // below says so.
                        AppSettings::suspendSavesUntilRestart();

                        // Reload the maps the engines share, so they see the
                        // restored Track Map, presets and mixer maps.  Show
                        // Lock keeps its state for this session (the restore
                        // runs unlocked); the restored one applies at the
                        // restart.
                        const bool locked = settings.showModeLocked;
                        settings.load();
                        settings.showModeLocked = locked;
                        forgetNicMoves(nullptr);   // the restored interface settings replace them (AUDIT UI-6)
                        sharedMixerMap.resetToDefaults();
                        sharedMixerMap.load();
                        sharedSlqMixerMap.resetToDefaults();
                        sharedSlqMixerMap.load();
                        for (auto& e : engines)
                            e->refreshTrackMapLookup();
                        populateGenPresetCombo();

                        juce::AlertWindow::showMessageBoxAsync(
                            juce::MessageBoxIconType::InfoIcon,
                            "Import Complete",
                            "Configuration restored. Restart STC now to apply it -- "
                            "until then, changes are not saved.");
                    }
                    else
                    {
                        juce::AlertWindow::showMessageBoxAsync(
                            juce::MessageBoxIconType::WarningIcon,
                            "Import Failed",
                            "Could not apply the backup file.");
                    }
                });
        });
}

void MainComponent::startCurrentThruOutput()
{
    auto& eng = currentEngine();
    if (!eng.isPrimary()) return;

    auto entry = getSelectedThruOutput();
    if (entry.deviceName.isEmpty() && !filteredOutputIndices.isEmpty())
    { cmbThruOutputDevice.setSelectedId(1, juce::dontSendNotification); entry = getSelectedThruOutput(); }

    // Settings fallback for empty-combo case (first launch before populate*).
    int settingsCh   = 1;
    bool settingsStereo = true;
    if (selectedEngine < (int) settings.engines.size())
    {
        const auto& es = settings.engines[(size_t) selectedEngine];
        settingsCh     = es.thruOutputChannel;
        settingsStereo = es.thruOutputStereo;
    }
    int outCh = getChannelFromComboOrSettings(cmbThruOutputChannel, settingsCh, settingsStereo);
    eng.startThruOutput(entry.typeName, entry.deviceName, outCh,
                         getPreferredSampleRate(), getPreferredBufferSize());

    if (eng.getAudioThru() && eng.getAudioThru()->getIsRunning())
    {
        eng.getAudioThru()->setOutputGain((float)sldThruOutputGain.getValue() / 100.0f);
        populateThruOutputChannels();
    }
}

void MainComponent::startCurrentMtcOutput()
{
    auto& eng = currentEngine();
    auto& trig = eng.getTriggerOutput();
    // The device shown, or with an empty selector the configured one if it
    // is listed now; otherwise nothing is opened (AUDIT UI-6).
    const juce::String saved = selectedEngine >= 0 && selectedEngine < (int) settings.engines.size()
                             ? settings.engines[(size_t) selectedEngine].midiOutputDevice : juce::String();
    const int sel = midiDeviceToStart(cmbMidiOutputDevice, midiOutputNames, saved, false);

    // If TriggerOutput has its OWN port open on the same device, release it
    // before MtcOutput opens.  Historical: the two were separate JUCE handles
    // until DESIGN D32; MidiOutputHub now gives both the same port.
    if (trig.hasOwnMidiOpen() && sel >= 0)
    {
        eng.getMtcOutput().refreshDeviceList();
        auto mtcNames = eng.getMtcOutput().getDeviceNames();
        if (sel < mtcNames.size()
            && trig.getCurrentMidiDeviceName() == mtcNames[sel])
        {
            trig.releaseOwnMidi();
        }
    }

    eng.startMtcOutput(sel);

    // Share MtcOutput's open handle with TriggerOutput if same device
    if (eng.getMtcOutput().getIsRunning())
    {
        auto trigDevName = stripComboMarker(cmbTriggerMidiDevice.getText());
        if (trigDevName == eng.getMtcOutput().getCurrentDeviceName())
            trig.setSharedMidiOutput(eng.getMtcOutput().getMidiOutputPtr());
        else
            trig.setSharedMidiOutput(nullptr);
    }
    else
    {
        // Refused -- another engine streams MTC on that port (DESIGN D32) -- or
        // failed to open: the trigger output takes back the port it may have
        // released above.
        applyTriggerSettings();
    }
}

void MainComponent::startCurrentArtnetOutput()
{
    auto& eng = currentEngine();
    // ArtnetOutput convention: -1 = All Interfaces, 0 = first NIC
    // Combo IDs: 1 = All, 2 = first NIC -> subtract 2
    int sel = nicIdToStart(cmbArtnetOutputInterface, kNicArtnetOut) - 2;
    eng.startArtnetOutput(sel);
}

void MainComponent::startCurrentLANetTCOutput()
{
    auto& eng = currentEngine();
    int sel = nicIdToStart(cmbLANetTCOutputInterface, kNicLANetOut) - 3;
    eng.startLANetTCOutput(sel);
}

void MainComponent::startCurrentLtcOutput()
{
    auto& eng = currentEngine();
    eng.stopLtcOutput();

    auto entry = getSelectedAudioOutput();
    if (entry.deviceName.isEmpty() && !filteredOutputIndices.isEmpty())
    { cmbAudioOutputDevice.setSelectedId(1, juce::dontSendNotification); entry = getSelectedAudioOutput(); }

    // Combo may be empty on first launch (before populateAudioOutputChannels);
    // fall back to the persisted settings in that window so the user's saved
    // channel is honoured instead of silently defaulting to stereo.  See
    // getChannelFromComboOrSettings comment.
    int settingsCh   = 0;
    bool settingsStereo = true;
    if (selectedEngine < (int) settings.engines.size())
    {
        const auto& es = settings.engines[(size_t) selectedEngine];
        settingsCh     = es.audioOutputChannel;
        settingsStereo = es.audioOutputStereo;
    }
    int channel = getChannelFromComboOrSettings(cmbAudioOutputChannel, settingsCh, settingsStereo);

    if (eng.startLtcOutput(entry.typeName, entry.deviceName, channel,
                            getPreferredSampleRate(), getPreferredBufferSize()))
    {
        eng.getLtcOutput().setOutputGain((float)sldLtcOutputGain.getValue() / 100.0f);
        populateAudioOutputChannels();

        // Restart thru if it was stopped due to a previous device conflict
        if (eng.isPrimary() && eng.isOutputThruEnabled()
            && eng.getAudioThru() && !eng.getAudioThru()->getIsRunning())
        {
            auto thruEntry = getSelectedThruOutput();
            if (thruEntry.deviceName.isNotEmpty()
                && !(thruEntry.deviceName == entry.deviceName && thruEntry.typeName == entry.typeName))
                startCurrentThruOutput();
        }
    }
}

void MainComponent::startCurrentGenAudio()
{
    auto& eng = currentEngine();
    eng.stopGeneratorAudio();

    auto entry = getSelectedGenAudioOutput();
    if (entry.deviceName.isEmpty() && !filteredOutputIndices.isEmpty())
    {
        cmbGenAudioDevice.setSelectedId(1, juce::dontSendNotification);
        entry = getSelectedGenAudioOutput();
    }

    // Settings fallback for empty-combo case (first launch before populate*).
    int settingsCh   = 0;
    bool settingsStereo = true;
    if (selectedEngine < (int) settings.engines.size())
    {
        const auto& es = settings.engines[(size_t) selectedEngine];
        settingsCh     = es.generatorAudioChannel;
        settingsStereo = es.generatorAudioStereo;
    }
    int channel = getChannelFromComboOrSettings(cmbGenAudioChannel, settingsCh, settingsStereo);

    if (eng.startGeneratorAudio(entry.typeName, entry.deviceName, channel,
                                 getPreferredSampleRate(),
                                 getPreferredBufferSize()))
    {
        populateGenAudioChannels();

        // Apply current volume (the slider is the source of truth).
        eng.setGeneratorAudioVolume((float) sldGenAudioVolume.getValue());

        // Audio file (if any) was already loaded into the player by the last
        // activateGenPreset() call -- loadFile() works even when the device
        // is closed, and attachReaderToTransport() (called from openDevice)
        // re-binds the source to the transport.

        // If the generator is currently playing, resume audio at the current
        // position rather than waiting for the next play/stop transition.
        if (eng.getGeneratorState() == TimecodeEngine::GeneratorState::Playing)
        {
            double pos = (eng.getGeneratorCurrentMs() - eng.getGeneratorStartMs()) / 1000.0;
            eng.getGeneratorAudio().seekSeconds(juce::jmax(0.0, pos));
            eng.getGeneratorAudio().play();
        }
    }
}

void MainComponent::updateCurrentOutputStates()
{
    auto& eng = currentEngine();

    if (eng.isOutputMtcEnabled() && !eng.getMtcOutput().getIsRunning()) startCurrentMtcOutput();
    else if (!eng.isOutputMtcEnabled() && eng.getMtcOutput().getIsRunning())
    {
        // Clear sharing before stopping -- TriggerOutput must not hold a dangling pointer
        eng.getTriggerOutput().setSharedMidiOutput(nullptr);
        eng.stopMtcOutput();
        // Re-open trigger's own device if it still needs MIDI
        applyTriggerSettings();
    }

    if (eng.isOutputArtnetEnabled() && !eng.getArtnetOutput().getIsRunning()) startCurrentArtnetOutput();
    else if (!eng.isOutputArtnetEnabled() && eng.getArtnetOutput().getIsRunning()) eng.stopArtnetOutput();

    if (eng.isOutputLANetTCEnabled() && !eng.getLANetTCOutput().getIsRunning()) startCurrentLANetTCOutput();
    else if (!eng.isOutputLANetTCEnabled() && eng.getLANetTCOutput().getIsRunning()) eng.stopLANetTCOutput();

    if (eng.isOutputLtcEnabled() && !eng.getLtcOutput().getIsRunning() && !scannedAudioOutputs.isEmpty()) startCurrentLtcOutput();
    else if (!eng.isOutputLtcEnabled() && eng.getLtcOutput().getIsRunning()) eng.stopLtcOutput();

    if (eng.isPrimary())
    {
        if (eng.isOutputThruEnabled() && eng.getAudioThru() && !eng.getAudioThru()->getIsRunning())
        {
            if (eng.getActiveInput() == SrcType::LTC)
                startCurrentLtcInput();
            else
                startCurrentThruOutput();
        }
        else if (!eng.isOutputThruEnabled() && eng.getAudioThru() && eng.getAudioThru()->getIsRunning())
        {
            eng.stopThruOutput();
        }
    }
}

//==============================================================================
// BACKGROUND AUDIO SCAN
//==============================================================================
void MainComponent::startAudioDeviceScan()
{
    // A scan still running is asked to stop; one that has not reached its
    // last check posts nothing (run()).  If it does not stop in time, no new
    // scan starts this time.
    if (!stopAudioScanThread())
    { DBG("WARNING: AudioScanThread did not stop within 2s timeout -- skipping new scan"); return; }
    scanThread = std::make_unique<AudioScanThread>(this);
    // The manager is made, initialised and later deleted on the message
    // thread: its MIDI device-list connection registers with, and removes
    // itself from, a JUCE broadcaster that asserts the message thread.
    scanThread->tempManager = std::make_unique<juce::AudioDeviceManager>();
    // Zero channels "needed": JUCE then fills in no default device names and
    // opens nothing.  With 128/128 this manager opened the current type's
    // default input and output devices at startup and kept them open for
    // the life of the application, for a scan that only needs the names.
    //
    // initialise() is where most of the scanning happens, here on the
    // message thread: it creates every device type and scans each one twice
    // (createDeviceTypesIfNeeded, then scanDevicesIfNeeded; JUCE 9.0.3).  It
    // cannot move to the scan thread: WASAPI's device type creates a hidden
    // message window when it is constructed, and its first scan creates the
    // COM device enumerator, which needs a thread that has called
    // CoInitialize -- the scan thread has not.  The thread then scans every
    // type once more and posts the names.  A scan therefore holds the
    // message thread, and with it every engine's tick (AUDIT D8), for as
    // long as the drivers take to enumerate (AUDIT UI-8).
    scanThread->tempManager->initialise(0, 0, nullptr, false);
    scanThread->startThread();
}

bool MainComponent::stopAudioScanThread()
{
    // The thread scans with the AudioDeviceManager it owns (tempManager), so
    // the two can be deleted only once run() has returned.  It is asked to
    // stop, which run() checks between device types, and waited for.  A
    // driver that hangs in scanForDevices() keeps it past the wait.  Such a
    // thread is released, with its manager, and never deleted -- a leak,
    // only when a driver hangs; it finishes when the driver returns, and
    // posts nothing (run()).  It is not killed, as stopThread() would kill
    // it after its timeout (AUDIT UI-7).  On Linux the kill is a
    // pthread_cancel: at the thread's next cancellation point -- a driver
    // blocked in poll, read or open, or any later close or write -- the
    // unwind it starts reaches JUCE's catch (...) around run(), and STC
    // aborts.  On Windows it is a TerminateThread, which can leave a heap
    // or driver lock held.  And deleting the manager after the kill, as
    // this code used to, freed it under a scan still running.  Message
    // thread.
    if (scanThread == nullptr)
        return true;
    scanThread->signalThreadShouldExit();
    if (scanThread->isThreadRunning() && !scanThread->waitForThreadToExit(2000))
    {
        DBG("WARNING: AudioScanThread did not stop within 2s timeout -- left behind");
        juce::ignoreUnused(scanThread.release());
        return false;
    }
    scanThread = nullptr;   // stopped: deletes the thread object and its manager
    return true;
}

void MainComponent::onAudioScanComplete(const juce::Array<AudioDeviceEntry>& inputs,
                                         const juce::Array<AudioDeviceEntry>& outputs)
{
    scannedAudioInputs  = inputs;
    scannedAudioOutputs = outputs;
    populateAudioCombos();
    // The first scan opens the configured audio devices.  A later one
    // (Refresh Devices) reopens all of them; if Show Lock was engaged while
    // it ran, only the lists are updated and the running devices are left
    // alone, as Refresh Devices itself is locked (AUDIT UI-1).
    if (!audioDevicesApplied || !settings.showModeLocked)
    {
        applyAudioSettings();
        audioDevicesApplied = true;
    }
    syncUIFromEngine();  // Re-populate Audio BPM device combo now that scan data is available
}

//==============================================================================
// DRIVER TYPE FILTER HELPERS (same as v1.3)
//==============================================================================
juce::StringArray MainComponent::getUniqueTypeNames(const juce::Array<AudioDeviceEntry>& entries) const
{
    juce::StringArray types;
    for (auto& e : entries)
        if (!types.contains(e.typeName))
            types.add(e.typeName);
    return types;
}

juce::String MainComponent::getInputTypeFilter() const
{
    int sel = cmbAudioInputTypeFilter.getSelectedId();
    return (sel <= 1) ? juce::String() : cmbAudioInputTypeFilter.getText();
}

juce::String MainComponent::getOutputTypeFilter() const
{
    int sel = cmbAudioOutputTypeFilter.getSelectedId();
    return (sel <= 1) ? juce::String() : cmbAudioOutputTypeFilter.getText();
}

void MainComponent::populateTypeFilterCombos()
{
    auto inputTypes = getUniqueTypeNames(scannedAudioInputs);
    auto outputTypes = getUniqueTypeNames(scannedAudioOutputs);

    cmbAudioInputTypeFilter.clear(juce::dontSendNotification);
    cmbAudioInputTypeFilter.addItem("All Drivers", 1);
    for (int i = 0; i < inputTypes.size(); i++)
    {
        auto shortName = AudioDeviceEntry::shortenTypeName(inputTypes[i]);
        cmbAudioInputTypeFilter.addItem(shortName.isEmpty() ? inputTypes[i] : shortName, i + 2);
    }

    // Restore saved filter
    if (settings.audioInputTypeFilter.isNotEmpty())
    {
        for (int i = 0; i < inputTypes.size(); i++)
        {
            auto shortName = AudioDeviceEntry::shortenTypeName(inputTypes[i]);
            if (shortName == settings.audioInputTypeFilter || inputTypes[i] == settings.audioInputTypeFilter)
            { cmbAudioInputTypeFilter.setSelectedId(i + 2, juce::dontSendNotification); break; }
        }
    }
    if (cmbAudioInputTypeFilter.getSelectedId() == 0)
        cmbAudioInputTypeFilter.setSelectedId(1, juce::dontSendNotification);

    cmbAudioOutputTypeFilter.clear(juce::dontSendNotification);
    cmbAudioOutputTypeFilter.addItem("All Drivers", 1);
    for (int i = 0; i < outputTypes.size(); i++)
    {
        auto shortName = AudioDeviceEntry::shortenTypeName(outputTypes[i]);
        cmbAudioOutputTypeFilter.addItem(shortName.isEmpty() ? outputTypes[i] : shortName, i + 2);
    }

    if (settings.audioOutputTypeFilter.isNotEmpty())
    {
        for (int i = 0; i < outputTypes.size(); i++)
        {
            auto shortName = AudioDeviceEntry::shortenTypeName(outputTypes[i]);
            if (shortName == settings.audioOutputTypeFilter || outputTypes[i] == settings.audioOutputTypeFilter)
            { cmbAudioOutputTypeFilter.setSelectedId(i + 2, juce::dontSendNotification); break; }
        }
    }
    if (cmbAudioOutputTypeFilter.getSelectedId() == 0)
        cmbAudioOutputTypeFilter.setSelectedId(1, juce::dontSendNotification);
}

void MainComponent::populateFilteredInputDeviceCombo()
{
    int savedId = cmbAudioInputDevice.getSelectedId();
    auto filter = getInputTypeFilter();
    filteredInputIndices.clear();
    cmbAudioInputDevice.clear(juce::dontSendNotification);

    for (int i = 0; i < scannedAudioInputs.size(); i++)
    {
        if (filter.isEmpty() || AudioDeviceEntry::shortenTypeName(scannedAudioInputs[i].typeName) == filter
            || scannedAudioInputs[i].typeName == filter)
        {
            filteredInputIndices.add(i);
            auto marker = getDeviceInUseMarker(scannedAudioInputs[i].deviceName,
                                                scannedAudioInputs[i].typeName, true);
            cmbAudioInputDevice.addItem(scannedAudioInputs[i].displayName + marker,
                                         filteredInputIndices.size());
        }
    }
    if (savedId > 0 && savedId <= cmbAudioInputDevice.getNumItems())
        cmbAudioInputDevice.setSelectedId(savedId, juce::dontSendNotification);
}

void MainComponent::populateFilteredOutputDeviceCombos()
{
    int savedOutId = cmbAudioOutputDevice.getSelectedId();
    int savedThruId = cmbThruOutputDevice.getSelectedId();
    int savedGenAudioId = cmbGenAudioDevice.getSelectedId();
    auto filter = getOutputTypeFilter();
    filteredOutputIndices.clear();
    cmbAudioOutputDevice.clear(juce::dontSendNotification);
    cmbThruOutputDevice.clear(juce::dontSendNotification);
    cmbGenAudioDevice.clear(juce::dontSendNotification);

    for (int i = 0; i < scannedAudioOutputs.size(); i++)
    {
        if (filter.isEmpty() || AudioDeviceEntry::shortenTypeName(scannedAudioOutputs[i].typeName) == filter
            || scannedAudioOutputs[i].typeName == filter)
        {
            filteredOutputIndices.add(i);
            int id = filteredOutputIndices.size();
            auto marker = getDeviceInUseMarker(scannedAudioOutputs[i].deviceName,
                                                scannedAudioOutputs[i].typeName, false);
            cmbAudioOutputDevice.addItem(scannedAudioOutputs[i].displayName + marker, id);
            cmbThruOutputDevice.addItem(scannedAudioOutputs[i].displayName + marker, id);
            cmbGenAudioDevice.addItem(scannedAudioOutputs[i].displayName + marker, id);
        }
    }
    if (savedOutId > 0 && savedOutId <= cmbAudioOutputDevice.getNumItems())
        cmbAudioOutputDevice.setSelectedId(savedOutId, juce::dontSendNotification);
    if (savedThruId > 0 && savedThruId <= cmbThruOutputDevice.getNumItems())
        cmbThruOutputDevice.setSelectedId(savedThruId, juce::dontSendNotification);
    if (savedGenAudioId > 0 && savedGenAudioId <= cmbGenAudioDevice.getNumItems())
        cmbGenAudioDevice.setSelectedId(savedGenAudioId, juce::dontSendNotification);
}

//==============================================================================
// Returns " [ENGINE N]" if the device is in use by another engine, "" otherwise.
// typeName is checked for audio devices; for MIDI pass "".
//==============================================================================
juce::String MainComponent::getDeviceInUseMarker(const juce::String& devName,
                                                  const juce::String& typeName,
                                                  bool isInput)
{
    if (devName.isEmpty()) return {};

    juce::String result;

    for (int i = 0; i < (int)engines.size(); i++)
    {
        auto& eng = *engines[(size_t)i];
        bool isCurrent = (i == selectedEngine);

        if (isInput)
        {
            // MIDI input (typeName empty -> MIDI check)
            if (typeName.isEmpty()
                && eng.getMtcInput().getIsRunning()
                && eng.getMtcInput().getCurrentDeviceName() == devName)
            {
                if (isCurrent) { result += juce::String::charToString(0x25CF); }   // "*"
                else           { return " [" + eng.getName() + "]"; }
            }

            // Audio input (LTC)
            if (typeName.isNotEmpty()
                && eng.getLtcInput().getIsRunning()
                && eng.getLtcInput().getCurrentDeviceName() == devName
                && eng.getLtcInput().getCurrentTypeName() == typeName)
            {
                if (isCurrent) { result += juce::String::charToString(0x25CF); }
                else           { return " [" + eng.getName() + "]"; }
            }

            // Audio input (BPM detection)
            if (typeName.isNotEmpty()
                && eng.isAudioBpmRunning()
                && eng.getAudioBpmInput().getCurrentDeviceName() == devName
                && eng.getAudioBpmInput().getCurrentTypeName() == typeName)
            {
                if (isCurrent) { result += juce::String::charToString(0x25CF); }
                else           { return " [" + eng.getName() + " BPM]"; }
            }
        }
        else
        {
            // MIDI output
            if (typeName.isEmpty()
                && eng.getMtcOutput().getIsRunning()
                && eng.getMtcOutput().getCurrentDeviceName() == devName)
            {
                if (isCurrent) { result += juce::String::charToString(0x25CF); }
                else           { return " [" + eng.getName() + "]"; }
            }

            // MIDI output (Trigger)
            // The trigger output opens its own MIDI device when not sharing
            // with MTC; without this case the device looks free even though
            // the trigger has it locked.
            if (typeName.isEmpty()
                && eng.getTriggerOutput().hasOwnMidiOpen()
                && eng.getTriggerOutput().getCurrentMidiDeviceName() == devName)
            {
                if (isCurrent) { result += juce::String::charToString(0x25CF); }
                else           { return " [" + eng.getName() + " TRIG]"; }
            }

            // Audio output (LTC)
            if (typeName.isNotEmpty()
                && eng.getLtcOutput().getIsRunning()
                && eng.getLtcOutput().getCurrentDeviceName() == devName
                && eng.getLtcOutput().getCurrentTypeName() == typeName)
            {
                if (isCurrent) { result += juce::String::charToString(0x25CF); }
                else           { return " [" + eng.getName() + "]"; }
            }

            // Audio output (Thru)
            if (typeName.isNotEmpty()
                && eng.getAudioThru() && eng.getAudioThru()->getIsRunning()
                && eng.getAudioThru()->getCurrentDeviceName() == devName
                && eng.getAudioThru()->getCurrentTypeName() == typeName)
            {
                if (isCurrent) { result += juce::String::charToString(0x25CF); }
                else           { return " [" + eng.getName() + " THRU]"; }
            }

            // Audio output (Generator audio playback)
            // Without this, the Generator's bullet (current engine) and
            // bracketed engine label (other engines) never appear on
            // cmbGenAudioDevice / cmbAudioOutputDevice / cmbThruOutputDevice
            // for the device the Generator is using -- the user can't
            // tell from the UI which device is actually busy.
            if (typeName.isNotEmpty()
                && eng.isGeneratorAudioRunning()
                && eng.getGeneratorAudio().getCurrentDeviceName() == devName
                && eng.getGeneratorAudio().getCurrentTypeName() == typeName)
            {
                if (isCurrent) { result += juce::String::charToString(0x25CF); }
                else           { return " [" + eng.getName() + " GEN]"; }
            }
        }
    }

    // "*" prefix for current engine's active device
    if (result.isNotEmpty())
        return " " + result;

    return {};
}

void MainComponent::populateSampleRateCombo()
{
    cmbSampleRate.clear(juce::dontSendNotification);
    cmbSampleRate.addItem("Default", 1);
    cmbSampleRate.addItem("44100", 2);
    cmbSampleRate.addItem("48000", 3);
    cmbSampleRate.addItem("88200", 4);
    cmbSampleRate.addItem("96000", 5);
    cmbSampleRate.setSelectedId(1, juce::dontSendNotification);
}

void MainComponent::populateOutputAudioCombos()
{
    // Same option lists as the input-panel combos, copied so the two views
    // cannot drift apart if the source lists ever change.
    auto copyItems = [](juce::ComboBox& from, juce::ComboBox& to)
    {
        to.clear(juce::dontSendNotification);
        for (int i = 0; i < from.getNumItems(); ++i)
            to.addItem(from.getItemText(i), from.getItemId(i));
        to.setSelectedId(from.getSelectedId(), juce::dontSendNotification);
    };
    copyItems(cmbSampleRate, cmbSampleRateOut);
    copyItems(cmbBufferSize, cmbBufferSizeOut);
}

void MainComponent::populateBufferSizeCombo()
{
    cmbBufferSize.clear(juce::dontSendNotification);
    cmbBufferSize.addItem("Default", 1);
    cmbBufferSize.addItem("32", 2);
    cmbBufferSize.addItem("64", 3);
    cmbBufferSize.addItem("128", 4);
    cmbBufferSize.addItem("256", 5);
    cmbBufferSize.addItem("512", 6);
    cmbBufferSize.addItem("1024", 7);
    cmbBufferSize.addItem("2048", 8);
    cmbBufferSize.addItem("4096", 9);    // beyond the usual: a buffer of a frame or more makes the
    cmbBufferSize.addItem("8192", 10);   // DEBUG buffer counter step once per frame (#19)
    cmbBufferSize.setSelectedId(1, juce::dontSendNotification);
}

void MainComponent::applyUserBitsFieldMode(int mode)
{
    if (mode == TimecodeEngine::kUserBitsName)
    {
        // Four ISO characters (SMPTE 12M-1 sec. 8.4.2).
        txtLtcUserBits.setInputRestrictions(4, {});
        txtLtcUserBits.setTextToShowWhenEmpty("STC1", juce::Colour(0xFF666666));
        lblLtcUserBits.setText("LTC USER BITS (NAME):", juce::dontSendNotification);
    }
    else
    {
        txtLtcUserBits.setInputRestrictions(8, "0123456789abcdefABCDEF");
        txtLtcUserBits.setTextToShowWhenEmpty("00000000", juce::Colour(0xFF666666));
        lblLtcUserBits.setText("LTC USER BITS (HEX):", juce::dontSendNotification);
    }
}

double MainComponent::getPreferredSampleRate() const
{
    switch (cmbSampleRate.getSelectedId())
    {
        case 2: return 44100; case 3: return 48000;
        case 4: return 88200; case 5: return 96000;
        default: return 0;
    }
}

int MainComponent::getPreferredBufferSize() const
{
    switch (cmbBufferSize.getSelectedId())
    {
        case 2: return 32; case 3: return 64; case 4: return 128;
        case 5: return 256; case 6: return 512; case 7: return 1024; case 8: return 2048;
        case 9: return 4096; case 10: return 8192;
        default: return 0;
    }
}

void MainComponent::restartAllAudioDevices()
{
    // The devices are shared (AudioDeviceHub): a rate or buffer change is
    // applied to each open device once, and every client on it -- LTC in
    // and out of every engine, Audio Thru, Audio BPM, the generators' audio
    // -- sees one stop/start.  Restarting the components one by one, as
    // this used to, would restart a shared device several times.
    AudioDeviceHub::get().reconfigureAll(getPreferredSampleRate(), getPreferredBufferSize());
    saveSettings();
}

void MainComponent::populateMidiAndNetworkCombos()
{
    // Save current selections before clearing: the ID and what the item
    // shows, markers stripped -- the device, or "name (ip)".
    struct Saved { int id; juce::String label; };
    auto save = [](const juce::ComboBox& cmb) -> Saved
    {
        const int id = cmb.getSelectedId();
        return { id, id > 0 ? stripComboMarker(cmb.getText()) : juce::String() };
    };
    const Saved savedMidiIn   = save(cmbMidiInputDevice);
    const Saved savedMidiOut  = save(cmbMidiOutputDevice);
    const Saved savedArtIn    = save(cmbArtnetInputInterface);
    const Saved savedHippoIn  = save(cmbHippoInputInterface);
    const Saved savedLAIn     = save(cmbLANetTCInputInterface);
    const Saved savedArtOut   = save(cmbArtnetOutputInterface);
    const Saved savedLAOut    = save(cmbLANetTCOutputInterface);
    const Saved savedArtDmx   = save(cmbArtnetDmxInterface);
    const Saved savedTcnetIf  = save(cmbTcnetInterface);
    const Saved savedProDJLinkIf = save(cmbProDJLinkInterface);
    const Saved savedStageLinQIf = save(cmbStageLinQInterface);

    // MIDI Input
    auto midiIns = juce::MidiInput::getAvailableDevices();
    cmbMidiInputDevice.clear(juce::dontSendNotification);
    midiInputNames.clear();
    for (int i = 0; i < midiIns.size(); i++)
    {
        auto marker = getDeviceInUseMarker(midiIns[i].name, "", true);
        cmbMidiInputDevice.addItem(midiIns[i].name + marker, i + 1);
        midiInputNames.add(midiIns[i].name);
    }

    // MIDI Output
    auto midiOuts = juce::MidiOutput::getAvailableDevices();
    cmbMidiOutputDevice.clear(juce::dontSendNotification);
    midiOutputNames.clear();
    for (int i = 0; i < midiOuts.size(); i++)
    {
        auto marker = getDeviceInUseMarker(midiOuts[i].name, "", false);
        cmbMidiOutputDevice.addItem(midiOuts[i].name + marker, i + 1);
        midiOutputNames.add(midiOuts[i].name);
    }

    // Art-Net interfaces
    auto nets = getNetworkInterfaces(true);   // same list the Art-Net / LA-Net components use, localhost last
    const juce::StringArray previousNicLabels = nicLabels;
    {
        juce::StringArray labels;
        for (auto& ni : nets)
            labels.add(ni.name + " (" + ni.ip + ")");
        remapNicSettings(labels);
    }
    cmbArtnetInputInterface.clear(juce::dontSendNotification);
    cmbArtnetOutputInterface.clear(juce::dontSendNotification);
    cmbArtnetDmxInterface.clear(juce::dontSendNotification);

    // LaserAnimation Net-Timecode Interfaces
    cmbLANetTCInputInterface.clear(juce::dontSendNotification);
    cmbLANetTCOutputInterface.clear(juce::dontSendNotification);

    // Helper: check if an Art-Net interface combo ID is in use by another engine
    auto getArtnetMarker = [&](int comboId, bool isInput) -> juce::String
    {
        juce::String currentDot;

        for (int i = 0; i < (int)engines.size(); i++)
        {
            auto& eng = *engines[(size_t)i];
            bool isCurrent = (i == selectedEngine);

            if (isInput && eng.getArtnetInput().getIsRunning())
            {
                int inUseComboId = eng.getArtnetInput().getSelectedInterface() + 1;
                if (inUseComboId == comboId)
                {
                    if (isCurrent) currentDot = juce::String(" ") + juce::String::charToString(0x25CF);
                    else           return " [" + eng.getName() + "]";
                }
            }
            if (!isInput && eng.getArtnetOutput().getIsRunning())
            {
                int inUseComboId = eng.getArtnetOutput().getSelectedInterface() + 2;
                if (inUseComboId == comboId)
                {
                    if (isCurrent) currentDot = juce::String(" ") + juce::String::charToString(0x25CF);
                    else           return " [" + eng.getName() + "]";
                }
            }
        }
        return currentDot;
    };

    auto getLANetTCMarker = [&](int comboId, bool isInput) -> juce::String
    {
        juce::String currentDot;

        for (int i = 0; i < (int)engines.size(); i++)
        {
            auto& eng = *engines[(size_t)i];
            bool isCurrent = (i == selectedEngine);

            if (isInput && eng.getLANetTCInput().getIsRunning())
            {
                int inUseComboId = eng.getLANetTCInput().getSelectedInterface() + 1;
                if (inUseComboId == comboId)
                {
                    if (isCurrent) currentDot = juce::String(" ") + juce::String::charToString(0x25CF);
                    else           return " [" + eng.getName() + "]";
                }
            }
            if (!isInput && eng.getLANetTCOutput().getIsRunning())
            {
                int inUseComboId = eng.getLANetTCOutput().getSelectedInterface() + 3;
                if (inUseComboId == comboId)
                {
                    if (isCurrent) currentDot = juce::String(" ") + juce::String::charToString(0x25CF);
                    else           return " [" + eng.getName() + "]";
                }
            }
        }
        return currentDot;
    };

    cmbArtnetInputInterface.addItem("All Interfaces" + getArtnetMarker(1, true), 1);
    cmbArtnetOutputInterface.addItem("All Interfaces (Broadcast)" + getArtnetMarker(1, false), 1);
    cmbArtnetDmxInterface.addItem("All Interfaces (Broadcast)", 1);
    cmbTcnetInterface.clear(juce::dontSendNotification);
    cmbTcnetInterface.addItem("All Interfaces (Broadcast)", 1);

    cmbLANetTCInputInterface.addItem("All Interfaces" + getLANetTCMarker(1, true), 1);
    cmbLANetTCOutputInterface.addItem("All Interfaces (Broadcast)" + getLANetTCMarker(1, false), 1);
    cmbLANetTCOutputInterface.addItem("Localhost (127.0.0.1)" + getLANetTCMarker(2, false), 2);

    for (int i = 0; i < nets.size(); i++)
    {
        auto label = nets[i].name + " (" + nets[i].ip + ")";
        cmbArtnetInputInterface.addItem(label + getArtnetMarker(i + 2, true), i + 2);
        cmbArtnetOutputInterface.addItem(label + getArtnetMarker(i + 2, false), i + 2);
        cmbArtnetDmxInterface.addItem(label, i + 2);
        cmbTcnetInterface.addItem(label, i + 2);
        cmbLANetTCInputInterface.addItem(label + getLANetTCMarker(i + 2, true), i + 2);
        cmbLANetTCOutputInterface.addItem(label + getLANetTCMarker(i + 3, false), i + 3);
    }

    // Pro DJ Link interfaces
    cmbProDJLinkInterface.clear(juce::dontSendNotification);
    {
        // Determine which IP is currently active for ProDJLink
        juce::String activeIp;
        if (sharedProDJLinkInput.getIsRunning())
            activeIp = sharedProDJLinkInput.getBindInfo();

        static const juce::String dot = juce::String(" ") + juce::String::charToString(0x25CF);
        for (int i = 0; i < nets.size(); i++)
        {
            juce::String label = nets[i].name + " (" + nets[i].ip + ")";
            if (activeIp.isNotEmpty() && nets[i].ip == activeIp)
                label += dot;
            cmbProDJLinkInterface.addItem(label, i + 1);
        }
    }

    // StageLinQ interfaces (independent combo)
    cmbStageLinQInterface.clear(juce::dontSendNotification);
    {
        juce::String slqActiveIp;
        if (sharedStageLinQInput.getIsRunning())
            slqActiveIp = sharedStageLinQInput.getBindInfo();

        static const juce::String dot = juce::String(" ") + juce::String::charToString(0x25CF);
        for (int i = 0; i < nets.size(); i++)
        {
            juce::String label = nets[i].name + " (" + nets[i].ip + ")";
            if (slqActiveIp.isNotEmpty() && nets[i].ip == slqActiveIp)
                label += dot;
            cmbStageLinQInterface.addItem(label, i + 1);
        }
    }

    // Hippotizer interfaces (same NIC list as Art-Net, with All Interfaces)
    cmbHippoInputInterface.clear(juce::dontSendNotification);
    cmbHippoInputInterface.addItem("All Interfaces", 1);
    for (int i = 0; i < nets.size(); i++)
        cmbHippoInputInterface.addItem(nets[i].name + " (" + nets[i].ip + ")", i + 2);

    // Restore every selection by what it shows, not by its ID.  IDs are
    // list positions: a device or interface plugged in or out moves them,
    // and an ID kept across the repopulate selected another device, which
    // the next flushSettings then saved (AUDIT UI-6).  An interface is
    // found as remapNicSettings finds its setting, so one at a new address
    // stays selected.  One no longer listed leaves its selector empty.
    auto restore = [&](juce::ComboBox& cmb, const Saved& saved, bool isNic)
    {
        if (saved.id <= 0)
            return;
        juce::String label = saved.label;
        if (isNic && previousNicLabels.contains(label))   // not All Interfaces or Localhost
        {
            const int now = findInterfaceLabel(nicLabels, label);
            if (now < 0)
                return;                                    // gone: left empty
            label = nicLabels[now];
        }
        selectComboItemByLabel(cmb, label, saved.id);
    };
    restore(cmbMidiInputDevice,        savedMidiIn,      false);
    restore(cmbMidiOutputDevice,       savedMidiOut,     false);
    restore(cmbArtnetInputInterface,   savedArtIn,       true);
    restore(cmbHippoInputInterface,    savedHippoIn,     true);
    restore(cmbArtnetOutputInterface,  savedArtOut,      true);
    restore(cmbArtnetDmxInterface,     savedArtDmx,      true);
    restore(cmbTcnetInterface,         savedTcnetIf,     true);
    restore(cmbLANetTCInputInterface,  savedLAIn,        true);
    restore(cmbLANetTCOutputInterface, savedLAOut,       true);
    restore(cmbProDJLinkInterface,     savedProDJLinkIf, true);
    restore(cmbStageLinQInterface,     savedStageLinQIf, true);

    // A selector left with no selection shows its setting where it can,
    // so an interface or MIDI device listed again reappears.  One whose
    // interface is still gone stays empty: the fixed default it got here
    // before -- the first interface or All Interfaces -- was then saved
    // over the setting by the next flushSettings (selectNicsFromSettings).
    selectNicsFromSettings(true);
    if (selectedEngine < (int)settings.engines.size())
    {
        const auto& es = settings.engines[(size_t)selectedEngine];
        auto showSaved = [this](juce::ComboBox& cmb, const juce::String& name)
        {
            if (cmb.getSelectedId() > 0)
                return;
            const int idx = findDeviceByName(cmb, name);   // as syncUIFromEngine selects it
            if (idx >= 0)
                cmb.setSelectedId(idx + 1, juce::dontSendNotification);
        };
        showSaved(cmbMidiInputDevice,  es.midiInputDevice);
        showSaved(cmbMidiOutputDevice, es.midiOutputDevice);
    }
}

//==============================================================================
// The selector item ID an interface setting stands for in this session (its
// position followed across list changes, nicSettingNow), as flushSettings
// maps the IDs to the settings: the selected engine's setting, or the
// global one for TCNet, Pro DJ Link and StageLinQ.  A legacy value below
// the first item gives All Interfaces, as syncUIFromEngine always read it;
// 0 when there is no setting to show.  Message thread.
//==============================================================================
int MainComponent::nicSettingComboId(NicField field) const
{
    if (field == kNicTcnet)     return juce::jmax(1, nicSettingNow(nullptr, field, settings.tcnetInterface) + 2);   // -1 -> 1 (All), 0 -> 2...
    if (field == kNicProDJLink) return juce::jmax(0, nicSettingNow(nullptr, field, settings.proDJLinkInterface) + 1);
    if (field == kNicStageLinQ) return juce::jmax(0, nicSettingNow(nullptr, field, settings.stageLinQInterface) + 1);
    if (selectedEngine < 0 || selectedEngine >= (int)settings.engines.size() || selectedEngine >= (int)engines.size())
        return 0;
    const auto& es = settings.engines[(size_t)selectedEngine];
    const void* owner = engines[(size_t)selectedEngine].get();
    switch (field)
    {
        case kNicArtnetIn:  return juce::jmax(1, nicSettingNow(owner, field, es.artnetInputInterface) + 1);      // 1 = All Interfaces
        case kNicLANetIn:   return juce::jmax(1, nicSettingNow(owner, field, es.laNetTCInputInterface) + 1);
        case kNicHippoIn:   return juce::jmax(1, nicSettingNow(owner, field, es.hippotizerInputInterface) + 1);
        case kNicArtnetOut: return juce::jmax(1, nicSettingNow(owner, field, es.artnetOutputInterface) + 1);
        case kNicLANetOut:  return juce::jmax(1, nicSettingNow(owner, field, es.laNetTCOutputInterface) + 1);
        case kNicArtnetDmx: return juce::jmax(1, nicSettingNow(owner, field, es.artnetDmxInterface) + 2);        // -1 -> 1 (All), 0 -> 2...
        case kNicTcnet: case kNicProDJLink: case kNicStageLinQ: break;
    }
    return 0;
}

//==============================================================================
// Select in each interface selector the item its setting stands for
// (nicSettingComboId), and nothing while the setting's interface is gone
// (AUDIT UI-6).  A setting out of the list's range leaves the selector as
// it is.  onlyEmpty (after a repopulate): only the selectors with no
// selection, and one with no setting to show then gets its fixed default;
// the others keep what populateMidiAndNetworkCombos restored, which may be
// the operator's choice not yet flushed to the settings.  Message thread.
//==============================================================================
void MainComponent::selectNicsFromSettings(bool onlyEmpty)
{
    const void* engKey = selectedEngine >= 0 && selectedEngine < (int)engines.size()
                       ? engines[(size_t)selectedEngine].get() : nullptr;
    auto select = [&](juce::ComboBox& cmb, NicField field, const void* owner, int defaultId)
    {
        if (onlyEmpty && cmb.getSelectedId() > 0)
            return;
        const int id = nicSettingComboId(field);
        if (isNicGone(owner, field))
            cmb.setSelectedId(0, juce::dontSendNotification);
        else if (id >= 1 && id <= cmb.getNumItems())
            cmb.setSelectedId(id, juce::dontSendNotification);
        else if (onlyEmpty && defaultId > 0 && cmb.getNumItems() > 0)
            cmb.setSelectedId(defaultId, juce::dontSendNotification);
    };
    select(cmbArtnetInputInterface,   kNicArtnetIn,  engKey,  0);
    select(cmbLANetTCInputInterface,  kNicLANetIn,   engKey,  0);
    select(cmbHippoInputInterface,    kNicHippoIn,   engKey,  1);
    select(cmbArtnetOutputInterface,  kNicArtnetOut, engKey,  0);
    select(cmbLANetTCOutputInterface, kNicLANetOut,  engKey,  0);
    select(cmbArtnetDmxInterface,     kNicArtnetDmx, engKey,  1);
    select(cmbTcnetInterface,         kNicTcnet,     nullptr, 1);   // default: All Interfaces
    select(cmbProDJLinkInterface,     kNicProDJLink, nullptr, 1);
    select(cmbStageLinQInterface,     kNicStageLinQ, nullptr, 1);
}

//==============================================================================
// The selector item ID a component is started from, in the interface list
// as it is NOW.  The item: the selected one, or, with none -- its interface
// is gone (AUDIT UI-6) -- the one its setting stands for in this session
// (nicSettingComboId), as startup starts it from the setting
// (loadAndApplyNonAudioSettings); before, an empty selector started on All
// Interfaces or the first interface.  The selector's items are the list as
// it was when they were filled (nicLabels), and the component enumerates the
// interfaces again when it starts and takes a position in that new list: an
// interface plugged in or out since moved the positions, and the component
// bound another interface than the one shown (a NIC plugged in ahead of it,
// or one listed ahead of it dropping off).
// So the item's interface is looked up by its label in a fresh enumeration
// -- the list the components take, localhost last -- as remapNicSettings
// finds it, also at a new address.  All Interfaces and Localhost keep their
// IDs.  An interface no longer listed keeps its position, where another
// interface may now be listed (AUDIT C13).  `listed`, when given, is set to
// whether the interface the start stands for is in the list now: the shown
// item's, or for an empty selector its setting's -- not one marked gone
// (remapNicSettings), whose position names another interface or none.
// Message thread.
//==============================================================================
int MainComponent::nicIdToStart(const juce::ComboBox& cmb, NicField field, bool* listed) const
{
    if (listed != nullptr)
        *listed = false;
    const int selected = cmb.getSelectedId();
    const int id = selected > 0 ? selected : nicSettingComboId(field);
    // The ID of each selector's first interface item, after All Interfaces
    // (and Localhost for LA-Net out); Pro DJ Link and StageLinQ have neither.
    const int firstId = field == kNicLANetOut ? 3
                      : (field == kNicProDJLink || field == kNicStageLinQ) ? 1 : 2;
    const int pos = id - firstId;
    if (pos < 0 || pos >= nicLabels.size())
        return id;
    juce::StringArray now;
    for (auto& ni : getNetworkInterfaces(true))
        now.add(ni.name + " (" + ni.ip + ")");
    const int index = findInterfaceLabel(now, nicLabels[pos]);
    if (listed != nullptr)
    {
        const bool global = field == kNicTcnet || field == kNicProDJLink || field == kNicStageLinQ;
        *listed = index >= 0
               && (selected > 0 || ! isNicGone(global ? nullptr : engines[(size_t) selectedEngine].get(), field));
    }
    return index >= 0 ? index + firstId : id;
}

void MainComponent::remapNicSettings(const juce::StringArray& newLabels)
{
    // Message thread.  Called with the interface list each time the
    // selectors are filled; on the first call there is nothing to move.
    // Only the in-session positions move (nicFollow); `settings` keeps the
    // loaded ones (MainComponent.h).
    if (nicLabels.isEmpty() || newLabels == nicLabels)
    {
        nicLabels = newLabels;
        return;
    }

    // `value - offset` is a position in nicLabels; values below `offset`
    // are All Interfaces or Localhost and stay.
    auto remap = [&](int saved, int offset, const void* owner, NicField field)
    {
        const auto key = std::make_pair(owner, (int) field);
        const int value = nicSettingNow(owner, field, saved);
        juce::String label;
        if (auto it = goneNics.find(key); it != goneNics.end())
            label = it->second;                       // gone earlier: still its old position
        else if (value - offset >= 0 && value - offset < nicLabels.size())
            label = nicLabels[value - offset];
        else
            return;
        const int index = findInterfaceLabel(newLabels, label);   // also at a new address
        if (index >= 0)
        {
            goneNics.erase(key);
            if (index + offset == saved)
                nicFollow.erase(key);
            else
                nicFollow[key] = index + offset;
        }
        else
        {
            goneNics[key] = label;                    // keeps its position (AUDIT C13)
        }
    };

    // Offsets as the selectors' IDs map to the settings (flushSettings).
    for (size_t i = 0; i < settings.engines.size() && i < engines.size(); ++i)
    {
        auto& es = settings.engines[i];
        const void* owner = engines[i].get();
        remap(es.artnetInputInterface,     1, owner, kNicArtnetIn);
        remap(es.laNetTCInputInterface,    1, owner, kNicLANetIn);
        remap(es.hippotizerInputInterface, 1, owner, kNicHippoIn);
        remap(es.artnetOutputInterface,    1, owner, kNicArtnetOut);
        remap(es.laNetTCOutputInterface,   2, owner, kNicLANetOut);
        remap(es.artnetDmxInterface,       0, owner, kNicArtnetDmx);
    }
    remap(settings.tcnetInterface,     0, nullptr, kNicTcnet);
    remap(settings.proDJLinkInterface, 0, nullptr, kNicProDJLink);
    remap(settings.stageLinQInterface, 0, nullptr, kNicStageLinQ);
    nicLabels = newLabels;
}

//==============================================================================
// Forget the moved and gone marks of one engine (owner), or of every
// setting (nullptr), when its settings are removed or reloaded.  Message
// thread.
//==============================================================================
void MainComponent::forgetNicMoves(const void* owner)
{
    for (auto it = nicFollow.begin(); it != nicFollow.end(); )
        it = (owner == nullptr || it->first.first == owner) ? nicFollow.erase(it) : std::next(it);
    for (auto it = goneNics.begin(); it != goneNics.end(); )
        it = (owner == nullptr || it->first.first == owner) ? goneNics.erase(it) : std::next(it);
}

//==============================================================================
// flushSettings' rule for one interface setting (saved: the setting in
// `settings`, offset: selector ID - setting).  A selector with no selection
// -- its interface is gone -- leaves the saved position as it is.  So does
// one that shows what its setting stands for in this session: if the
// interface has moved in the list, the saved position stays as loaded --
// what a selector that kept its ID across the move saved before -- and the
// next start resolves it again (AUDIT C13).  Anything else shown is the
// operator's choice, or the interface a start fell back to, and is saved,
// as before; the setting is then neither moved nor gone.  Message thread.
//==============================================================================
void MainComponent::saveNicSetting(int& saved, const juce::ComboBox& cmb, int offset,
                                   const void* owner, NicField field)
{
    const int id = cmb.getSelectedId();
    if (id <= 0)
        return;
    if (!isNicGone(owner, field) && id - offset == nicSettingNow(owner, field, saved))
        return;
    saved = id - offset;
    forgetNicMove(owner, field);
}

void MainComponent::populateAudioCombos()
{
    populateTypeFilterCombos();
    populateFilteredInputDeviceCombo();
    populateFilteredOutputDeviceCombos();
}

void MainComponent::repopulateTcnetLayerCombo()
{
    cmbTcnetLayer.clear(juce::dontSendNotification);

    static const char* names[] = { "Layer 1", "Layer 2", "Layer 3", "Layer 4" };

    for (int layer = 0; layer < TCNetOutput::kMaxLayers; ++layer)
    {
        juce::String label(names[layer]);

        // Check if another engine is using this layer
        for (int e = 0; e < (int)engines.size(); ++e)
        {
            if (e == selectedEngine) continue;
            auto& eng = *engines[(size_t)e];
            if (eng.isOutputTcnetEnabled() && eng.getTcnetLayer() == layer)
            {
                label += " [" + eng.getName() + "]";
                break;
            }
        }

        cmbTcnetLayer.addItem(label, layer + 1);
    }

    cmbTcnetLayer.setSelectedId(currentEngine().getTcnetLayer() + 1, juce::dontSendNotification);
}

//==============================================================================
// SETTINGS LOAD / SAVE
//==============================================================================
void MainComponent::loadAndApplyNonAudioSettings()
{
    // Mixer maps (user-editable param -> OSC/MIDI mapping) have files of
    // their own and load whether or not settings.json exists or parses.
    // Loaded only after a good settings.json, they stayed at their defaults
    // when it was missing or quarantined, and the next mixer map edit or
    // backup wrote those defaults over mixermap.json and slq_mixermap.json
    // (AUDIT SET-1; AppSettings::load does the same for the Track Map and
    // the presets).
    sharedMixerMap.load();
    sharedSlqMixerMap.load();

    if (!settings.load())
    {
        settingsLoaded = true;
        syncUIFromEngine();
        return;
    }

    // Ensure we have enough engines
    while (engines.size() < settings.engines.size())
    {
        engines.push_back(std::make_unique<TimecodeEngine>((int)engines.size()));
        engines.back()->setSharedProDJLinkInput(&sharedProDJLinkInput);
        engines.back()->setSharedStageLinQInput(&sharedStageLinQInput);
        engines.back()->setDbServerClient(&sharedDbClient);
        engines.back()->setMixerMap(&sharedMixerMap);
        engines.back()->setSlqMixerMap(&sharedSlqMixerMap);
    }

    // Apply per-engine settings
    for (int i = 0; i < (int)settings.engines.size() && i < (int)engines.size(); i++)
    {
        auto& es = settings.engines[(size_t)i];
        auto& eng = *engines[(size_t)i];

        if (es.engineName.isNotEmpty())
            eng.setName(es.engineName);

        eng.setFrameRate(TimecodeEngine::indexToFps(es.fpsSelection));
        eng.setFpsConvertEnabled(es.fpsConvertEnabled);
        eng.setOutputFrameRate(TimecodeEngine::indexToFps(es.outputFpsSelection));

        eng.setOutputMtcEnabled(es.mtcOutEnabled);
        eng.setOutputArtnetEnabled(es.artnetOutEnabled);
        eng.setOutputLANetTCEnabled(es.laNetTCOutEnabled);
        eng.setOutputLtcEnabled(es.ltcOutEnabled);
        eng.setOutputThruEnabled(es.thruOutEnabled);
        eng.setOutputTcnetEnabled(es.tcnetOutEnabled);
        eng.setTcnetLayer(es.tcnetLayer);
        eng.setOutputHippoEnabled(es.hippoOutEnabled);
        eng.setOnAirGateEnabled(es.onAirGateEnabled);
        eng.setOnAirQuietStep(es.onAirQuiet);

        eng.setMtcOutputOffset(es.mtcOutputOffset);
        eng.setArtnetOutputOffset(es.artnetOutputOffset);
        eng.setLANetTCOutputOffset(es.laNetTCOutputOffset);
        eng.setLtcOutputOffset(es.ltcOutputOffset);
        eng.setLtcUserBitsMode(es.ltcUserBitsMode);
        eng.setInputFreewheelMs(es.inputFreewheelMs);
        eng.setLtcUserBitsReversed(es.ltcUserBitsReversed);
        eng.setLtcUserBitsName(es.ltcUserBitsName);
        eng.setLtcUserBitsHex(es.ltcUserBitsHex);
        eng.setTcnetOutputOffsetMs(es.tcnetOutputOffsetMs);

        eng.getLtcInput().setInputGain((float)es.ltcInputGain / 100.0f);
        eng.getLtcInput().setPassthruGain((float)es.thruInputGain / 100.0f);
        eng.getLtcOutput().setOutputGain((float)es.ltcOutputGain / 100.0f);
        eng.getLtcOutput().setHoldOnPause(es.ltcHoldOnPause);
        if (eng.getAudioThru())
            eng.getAudioThru()->setOutputGain((float)es.thruOutputGain / 100.0f);

        // Set input source (defer actual device start)
        auto src = TimecodeEngine::stringToInputSource(es.inputSource);
        eng.setInputSource(src);

        // Start non-audio protocols
        if (src == SrcType::MTC)
        {
            int idx = findDeviceByName(cmbMidiInputDevice, es.midiInputDevice);
            eng.startMtcInput(idx);
        }
        else if (src == SrcType::ArtNet)
        {
            eng.startArtnetInput(es.artnetInputInterface);
        }
        else if (src == SrcType::ProDJLink)
        {
            sharedProDJLinkInput.setBridgeIdentityProfile(settings.prodjlinkBridgeIdentity);
            sharedProDJLinkInput.setDbKeepaliveMode(settings.prodjlink95bMode);
            if (!sharedProDJLinkInput.getIsRunning())
            {
                sharedProDJLinkInput.refreshNetworkInterfaces();
                sharedProDJLinkInput.start(settings.proDJLinkInterface);
            }
            // Phase 2: start dbClient for metadata queries
            if (!sharedDbClient.getIsRunning())
            {
                DBG("MainComponent: starting DbServerClient (settings restore)");
                sharedDbClient.start();
            }
            eng.startProDJLinkInput(es.proDJLinkPlayer);
        }
        else if (src == SrcType::StageLinQ)
        {
            if (!sharedStageLinQInput.getIsRunning())
            {
                sharedStageLinQInput.refreshNetworkInterfaces();
                sharedStageLinQInput.start(settings.stageLinQInterface);
            }
            eng.startStageLinQInput(es.proDJLinkPlayer);
        }
        else if (src == SrcType::Hippotizer)
        {
            // HippoNet input disabled pending hardware validation -- fall back to Generator
            DBG("MainComponent: HippoNet input disabled, falling back to Generator");
            eng.setInputSource(SrcType::SystemTime);
        }
        else if (src == SrcType::Winamp)
        {
            // Not merged with the Hippotizer branch above: the two are the
            // same only off Windows, and for different reasons.
           #if JUCE_WINDOWS
            // Windows: try to attach to a running Winamp / WACUP instance.
            // If no Winamp window is found right now the thread will keep
            // polling and pick it up the moment one appears, so we always
            // start the input even if Winamp itself is not running yet.
            eng.startWinampInput();
           #else
            // macOS: WinampInput is a stub.  A settings file that was written
            // on a Windows machine and then opened on a Mac (or vice versa)
            // could legitimately end up with inputSource="Winamp" on a
            // platform where the source can never produce data; degrade
            // gracefully to Generator so the engine has something usable.
            DBG("MainComponent: Winamp input not available on this platform, falling back to Generator");
            eng.setInputSource(SrcType::SystemTime);
           #endif
        }
        else if (src == SrcType::LANetTC)
        {
            eng.startLANetTCInput(es.laNetTCInputInterface);
        }

        // The user's 23.976 / 29.97 against a source that cannot tell it from
        // 24 / 30.  Restored after setInputSource(), which clears it: set
        // before, as it was, it never survived a restart, and the first
        // frame put the rate back to 24 or 30 (AUDIT NET-4).
        eng.setUserOverrodeLtcFps(es.ltcFpsUserOverride);

        // Generator start/stop TC (applies regardless of current source)
        eng.setGeneratorClockMode(es.generatorClockMode);
        eng.setGeneratorPresetName(es.generatorPresetName);
        eng.setGeneratorStartMs(es.generatorStartMs);
        eng.setGeneratorStopMs(es.generatorStopMs);
        // Restore A/B loop (programming aid; standard DAW semantics).
        eng.setGeneratorLoopInMs(es.generatorLoopInMs);
        eng.setGeneratorLoopOutMs(es.generatorLoopOutMs);
        eng.setGeneratorLoopEnabled(es.generatorLoopEnabled);

        // TrackMap -- wire pointer and restore enabled state; the per-engine
        // override layer lives in this engine's settings block.
        eng.setTrackMap(&settings.trackMap);
        eng.setTrackMapOverrides(es.trackMapOverrides);
        eng.setTrackMapEnabled(es.trackMapEnabled);

        // Track change triggers -- restore enable state and connect destinations
        eng.getTriggerOutput().setMidiEnabled(es.triggerMidiEnabled);
        eng.getTriggerOutput().setOscEnabled(es.triggerOscEnabled);

        // Open MIDI if any feature needs it (triggers, MIDI clock, or mixer forward)
        if ((es.triggerMidiEnabled || es.midiClockEnabled || es.midiMixerForward) && es.triggerMidiDevice.isNotEmpty())
            eng.getTriggerOutput().startMidiByName(es.triggerMidiDevice);

        // Enable MIDI Clock after device is open
        if (es.midiClockEnabled)
            eng.setMidiClockEnabled(true);

        // OSC BPM forward
        if (es.oscBpmForward)
            eng.setOscForward(true, es.oscBpmAddr, es.oscBpmCmd);

        // Mixer fader forward
        if (es.oscMixerForward)
            eng.setOscMixerForward(true);
        if (es.midiMixerForward)
            eng.setMidiMixerForward(true, es.midiMixerCCChannel, es.midiMixerNoteChannel);
        if (es.artnetMixerForward)
            eng.setArtnetMixerForward(true, es.artnetMixerUniverse);
        eng.setArtnetTriggerUniverse(es.artnetTriggerUniverse);
        eng.setArtnetTriggerEnabled(es.artnetTriggerEnabled);

        // Ableton Link (exclusive: only one engine can have it)
        if (es.linkEnabled)
        {
            bool alreadyOwned = false;
            for (int j = 0; j < i; j++)
                if (engines[(size_t)j]->getLinkBridge().isEnabled())
                { alreadyOwned = true; break; }
            if (!alreadyOwned)
                eng.getLinkBridge().setEnabled(true);
        }

        // Audio BPM detection
        if (es.audioBpmEnabled && !es.audioBpmDevice.isEmpty())
            eng.startAudioBpm(es.audioBpmType, es.audioBpmDevice, es.audioBpmChannel);
        eng.getAudioBpmInput().setSmoothing(es.audioBpmSmoothing);
        eng.getAudioBpmInput().setInputGain((float)es.audioBpmGain / 100.0f);

        // Connect OSC if any feature needs it (triggers, OSC BPM forward, or mixer forward)
        if (es.triggerOscEnabled || es.oscBpmForward || es.oscMixerForward)
        {
            auto ip = es.oscDestIp.isNotEmpty() ? es.oscDestIp : juce::String("127.0.0.1");
            auto port = es.oscDestPort > 0 ? es.oscDestPort : 53000;
            eng.getTriggerOutput().connectOsc(ip, port);
        }

        // Start non-audio outputs
        if (es.mtcOutEnabled)
        {
            int idx = findDeviceByName(cmbMidiOutputDevice, es.midiOutputDevice);

            // Release TriggerOutput's own port if it matches the MTC device.
            // Historical: separate JUCE handles until DESIGN D32; the hub now shares one port.
            bool releasedTriggerPort = false;
            if (eng.getTriggerOutput().hasOwnMidiOpen()
                && es.triggerMidiDevice == es.midiOutputDevice)
            {
                eng.getTriggerOutput().releaseOwnMidi();
                releasedTriggerPort = true;
            }

            eng.startMtcOutput(idx);

            // Share MtcOutput's handle with TriggerOutput if same device
            if (eng.getMtcOutput().getIsRunning()
                && es.triggerMidiDevice == eng.getMtcOutput().getCurrentDeviceName())
            {
                eng.getTriggerOutput().setSharedMidiOutput(
                    eng.getMtcOutput().getMidiOutputPtr());
            }
            else if (releasedTriggerPort && !eng.getMtcOutput().getIsRunning())
            {
                // Refused -- an engine restored earlier already streams MTC on
                // that port (DESIGN D32) -- or failed to open: give the trigger output
                // back the port opened for it above.
                eng.getTriggerOutput().startMidiByName(es.triggerMidiDevice);
            }
        }
        if (es.artnetOutEnabled)
            eng.startArtnetOutput(es.artnetOutputInterface - 1);  // saved as combo-1; ArtnetOutput needs -1=All, 0=firstNIC
        else if ((es.artnetMixerForward || es.artnetTriggerEnabled) && !eng.getArtnetOutput().getIsRunning())
            eng.startArtnetOutput(es.artnetDmxInterface);  // DMX mixer forwarding and triggers need the socket even without timecode output
        // HippoNet output disabled in this version (pending hardware validation)
        // if (es.hippoOutEnabled)
        //     eng.startHippotizerOutput(es.hippotizerDestIp);

        if (es.laNetTCOutEnabled)
            eng.startLANetTCOutput(es.laNetTCOutputInterface - 2);  // saved as combo-1; LANetTCOutput needs -2=All, -1=Localhost, 0=firstNIC (combo ID - 3)
    }

    // Start TCNet output if any engine has it enabled
    {
        // Push the persisted global offset into sharedTcnetOutput before
        // start(): setLayerFromEngine reads globalOffsetMs every time an
        // engine feeds a layer, so the very first frame after TCNet comes
        // up must already see the user's venue offset.  Pushed
        // unconditionally because start() may also be called later (when
        // the user enables TCNet in an engine that was off at boot) and
        // the value should be in place either way.
        sharedTcnetOutput.setGlobalOffsetMs(settings.tcnetGlobalOffsetMs);

        bool anyTcnet = false;
        for (auto& e : engines)
            if (e->isOutputTcnetEnabled()) { anyTcnet = true; break; }
        if (anyTcnet)
        {
            sharedTcnetOutput.refreshNetworkInterfaces();
            sharedTcnetOutput.start(settings.tcnetInterface);
        }
    }

    // OSC Input (global generator remote control)
    txtOscInPort.setText(juce::String(settings.oscInputPort), false);
    cmbOscInputInterface.setSelectedId(settings.oscInputInterface + 1, juce::dontSendNotification);
    if (settings.oscInputEnabled)
        startOscInput();

    // Global settings
    cmbSampleRate.setSelectedId(sampleRateToComboId(settings.preferredSampleRate), juce::dontSendNotification);
    cmbBufferSize.setSelectedId(bufferSizeToComboId(settings.preferredBufferSize), juce::dontSendNotification);
    // Mirror AFTER both source combos hold their loaded values -- doing it
    // before left the output buffer-size combo showing a stale selection.
    cmbSampleRateOut.setSelectedId(cmbSampleRate.getSelectedId(), juce::dontSendNotification);
    cmbBufferSizeOut.setSelectedId(cmbBufferSize.getSelectedId(), juce::dontSendNotification);

    selectedEngine = juce::jlimit(0, (int)engines.size() - 1, settings.selectedEngine);
    rebuildTabButtons();

    // Restore Show Lock visual state
    if (settings.showModeLocked)
    {
        btnShowLock.setButtonText("LOCKED");
        btnShowLock.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFFCC2222));
        btnShowLock.setColour(juce::TextButton::textColourOffId, juce::Colours::white);
    }
    else
    {
        btnShowLock.setButtonText("SHOW LOCK");
        btnShowLock.setColour(juce::TextButton::buttonColourId, juce::Colour(0xFF1A1D23));
        btnShowLock.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFF888888));
    }

    settingsLoaded = true;
    syncUIFromEngine();
}

void MainComponent::applyAudioSettings()
{
    // Apply audio device settings for all engines
    for (int i = 0; i < (int)settings.engines.size() && i < (int)engines.size(); i++)
    {
        auto& es = settings.engines[(size_t)i];
        auto& eng = *engines[(size_t)i];

        // Audio inputs (LTC)
        if (eng.getActiveInput() == SrcType::LTC)
        {
            // Find the device in our scanned list
            int audioInIdx = findFilteredIndex(filteredInputIndices, scannedAudioInputs,
                                                es.audioInputType, es.audioInputDevice);

            if (i == selectedEngine)
            {
                // For selected engine, use combo box path
                if (audioInIdx >= 0) cmbAudioInputDevice.setSelectedId(audioInIdx + 1, juce::dontSendNotification);
                startCurrentLtcInput();
            }
            else if (!es.audioInputDevice.isEmpty())
            {
                // For non-selected engines, start directly
                int thruCh = (eng.isPrimary() && eng.isOutputThruEnabled()) ? es.thruInputChannel : -1;
                eng.startLtcInput(es.audioInputType, es.audioInputDevice,
                                   es.audioInputChannel, thruCh,
                                   getPreferredSampleRate(), getPreferredBufferSize());
            }
        }

        // Audio outputs (LTC)
        if (eng.isOutputLtcEnabled())
        {
            if (i == selectedEngine)
            {
                int audioOutIdx = findFilteredIndex(filteredOutputIndices, scannedAudioOutputs,
                                                     es.audioOutputType, es.audioOutputDevice);
                if (audioOutIdx >= 0) cmbAudioOutputDevice.setSelectedId(audioOutIdx + 1, juce::dontSendNotification);
                startCurrentLtcOutput();
            }
            else if (!es.audioOutputDevice.isEmpty())
            {
                int ch = es.audioOutputStereo ? -1 : es.audioOutputChannel;
                eng.startLtcOutput(es.audioOutputType, es.audioOutputDevice, ch,
                                    getPreferredSampleRate(), getPreferredBufferSize());
            }
        }

        // AudioThru (only engine 0)
        if (eng.isPrimary() && eng.isOutputThruEnabled() && eng.getAudioThru() && !eng.getAudioThru()->getIsRunning())
        {
            if (eng.getLtcInput().getIsRunning())
            {
                if (i == selectedEngine)
                {
                    int thruOutIdx = findFilteredIndex(filteredOutputIndices, scannedAudioOutputs,
                                                        es.thruOutputType, es.thruOutputDevice);
                    if (thruOutIdx >= 0) cmbThruOutputDevice.setSelectedId(thruOutIdx + 1, juce::dontSendNotification);
                    startCurrentThruOutput();
                }
                else if (!es.thruOutputDevice.isEmpty())
                {
                    int ch = es.thruOutputStereo ? -1 : es.thruOutputChannel;
                    eng.startThruOutput(es.thruOutputType, es.thruOutputDevice, ch,
                                         getPreferredSampleRate(), getPreferredBufferSize());
                }
            }
        }

        // Generator audio playback (per-engine, optional)
        if (es.generatorAudioEnabled)
        {
            int ch = es.generatorAudioStereo ? -1 : es.generatorAudioChannel;
            // Global format, like every other audio component (DESIGN D7, DESIGN D23).
            const double sr = getPreferredSampleRate();
            const int    bs = getPreferredBufferSize();
            if (i == selectedEngine)
            {
                int genIdx = findFilteredIndex(filteredOutputIndices, scannedAudioOutputs,
                                                es.generatorAudioType, es.generatorAudioDevice);
                if (genIdx >= 0) cmbGenAudioDevice.setSelectedId(genIdx + 1, juce::dontSendNotification);
                btnGenAudioOut.setToggleState(true, juce::dontSendNotification);

                // Open with channel from settings -- combo isn't populated yet.
                // syncUIFromEngine() (called next) will sync the combo selection.
                eng.startGeneratorAudio(es.generatorAudioType, es.generatorAudioDevice, ch, sr, bs);
                populateGenAudioChannels();
            }
            else if (!es.generatorAudioDevice.isEmpty())
            {
                eng.startGeneratorAudio(es.generatorAudioType, es.generatorAudioDevice, ch, sr, bs);
            }
        }
        // Volume and file channel mode persist across audio-on/off toggles
        // and apply even when the device is closed (they're atomic stores
        // on the player; effect takes hold the moment playback resumes).
        eng.setGeneratorAudioVolume(es.generatorAudioVolume);
        eng.setGeneratorAudioFileChannelMode(es.generatorAudioFileChannelMode);
    }

    updateDeviceSelectorVisibility();
}

void MainComponent::saveSettings()
{
    if (!settingsLoaded) return;
    settingsDirty = true;
    settingsSaveCountdown = kSaveDelayTicks;
}

void MainComponent::flushSettings()
{
    if (!settingsLoaded) return;
    settingsDirty = false;

    settings.selectedEngine = selectedEngine;
    settings.audioInputTypeFilter  = (cmbAudioInputTypeFilter.getSelectedId() <= 1) ? "" : cmbAudioInputTypeFilter.getText();
    settings.audioOutputTypeFilter = (cmbAudioOutputTypeFilter.getSelectedId() <= 1) ? "" : cmbAudioOutputTypeFilter.getText();
    settings.preferredSampleRate = getPreferredSampleRate();
    settings.preferredBufferSize = getPreferredBufferSize();

    settings.engines.resize(engines.size());

    bool audioReady = !scannedAudioInputs.isEmpty() || !scannedAudioOutputs.isEmpty();

    for (int i = 0; i < (int)engines.size(); i++)
    {
        auto& eng = *engines[(size_t)i];
        auto& es = settings.engines[(size_t)i];

        es.engineName = eng.getName();
        es.inputSource = TimecodeEngine::inputSourceToString(eng.getActiveInput());
        es.fpsSelection = TimecodeEngine::fpsToIndex(eng.getCurrentFps());
        es.fpsConvertEnabled = eng.isFpsConvertEnabled();
        es.outputFpsSelection = TimecodeEngine::fpsToIndex(eng.getOutputFps());
        es.ltcFpsUserOverride = eng.getUserOverrodeLtcFps();

        es.mtcOutEnabled = eng.isOutputMtcEnabled();
        es.artnetOutEnabled = eng.isOutputArtnetEnabled();
        es.laNetTCOutEnabled = eng.isOutputLANetTCEnabled();
        es.ltcOutEnabled = eng.isOutputLtcEnabled();
        es.thruOutEnabled = eng.isOutputThruEnabled();
        es.tcnetOutEnabled = eng.isOutputTcnetEnabled();
        es.tcnetLayer = eng.getTcnetLayer();
        es.hippoOutEnabled = eng.isOutputHippoEnabled();
        es.onAirGateEnabled = eng.isOnAirGateEnabled();
        es.onAirQuiet = eng.getOnAirQuietStep();
        es.generatorClockMode = eng.getGeneratorClockMode();
        es.generatorPresetName = eng.getGeneratorPresetName();
        es.generatorStartMs = eng.getGeneratorStartMs();
        es.generatorStopMs  = eng.getGeneratorStopMs();
        es.generatorLoopInMs    = eng.getGeneratorLoopInMs();
        es.generatorLoopOutMs   = eng.getGeneratorLoopOutMs();
        es.generatorLoopEnabled = eng.getGeneratorLoopEnabled();

        es.mtcOutputOffset = eng.getMtcOutputOffset();
        es.artnetOutputOffset = eng.getArtnetOutputOffset();
        es.laNetTCOutputOffset = eng.getLANetTCOutputOffset();
        es.ltcOutputOffset = eng.getLtcOutputOffset();
        es.ltcUserBitsHex = eng.getLtcUserBitsHex();
        es.ltcUserBitsMode = eng.getLtcUserBitsMode();
        es.inputFreewheelMs = eng.getInputFreewheelMs();
        es.ltcUserBitsReversed = eng.isLtcUserBitsReversed();
        es.ltcUserBitsName = eng.getLtcUserBitsName();
        es.tcnetOutputOffsetMs = eng.getTcnetOutputOffsetMs();

        es.ltcInputGain = (int)(eng.getLtcInput().getInputGain() * 100.0f);
        es.thruInputGain = (int)(eng.getLtcInput().getPassthruGain() * 100.0f);
        es.ltcOutputGain = (int)(eng.getLtcOutput().getOutputGain() * 100.0f);
        es.ltcHoldOnPause = eng.getLtcOutput().getHoldOnPause();
        if (eng.getAudioThru())
            es.thruOutputGain = (int)(eng.getAudioThru()->getOutputGain() * 100.0f);

        // For the selected engine, read from combos (may have been changed)
        if (i == selectedEngine)
        {
            // A selector with no selection -- its device or interface is no
            // longer listed (populateMidiAndNetworkCombos) -- leaves the
            // saved one as it is.  The interfaces' rule is saveNicSetting's
            // (AUDIT UI-6).
            auto selected = [](const juce::ComboBox& cmb) { return cmb.getSelectedId() > 0; };
            if (selected(cmbMidiInputDevice))       es.midiInputDevice = stripComboMarker(cmbMidiInputDevice.getText());
            if (selected(cmbMidiOutputDevice))      es.midiOutputDevice = stripComboMarker(cmbMidiOutputDevice.getText());
            saveNicSetting(es.artnetInputInterface,     cmbArtnetInputInterface,  1, &eng, kNicArtnetIn);
            saveNicSetting(es.laNetTCInputInterface,    cmbLANetTCInputInterface, 1, &eng, kNicLANetIn);
            saveNicSetting(es.hippotizerInputInterface, cmbHippoInputInterface,   1, &eng, kNicHippoIn);
            es.hippotizerTcChannel = cmbHippoTcChannel.getSelectedId() - 1;
            // The destination fields are saved from their text, and they can
            // be typed into while Show Lock is on: the edit is reverted only
            // when focus leaves the field.  So while locked the saved
            // destinations stay as they are (AUDIT UI-3); engaging the lock
            // flushes what was applied before it.
            if (!settings.showModeLocked)
            {
                es.hippotizerDestIp = txtHippoDestIp.getText().trim();
                if (es.hippotizerDestIp.isEmpty()) es.hippotizerDestIp = "255.255.255.255";
            }
            es.generatorClockMode = eng.getGeneratorClockMode();
            es.generatorPresetName = eng.getGeneratorPresetName();
        es.generatorPresetName = eng.getGeneratorPresetName();
            es.generatorStartMs = eng.getGeneratorStartMs();
            es.generatorStopMs  = eng.getGeneratorStopMs();
            es.generatorLoopInMs    = eng.getGeneratorLoopInMs();
            es.generatorLoopOutMs   = eng.getGeneratorLoopOutMs();
            es.generatorLoopEnabled = eng.getGeneratorLoopEnabled();
            saveNicSetting(es.artnetOutputInterface,  cmbArtnetOutputInterface,  1, &eng, kNicArtnetOut);
            saveNicSetting(es.laNetTCOutputInterface, cmbLANetTCOutputInterface, 1, &eng, kNicLANetOut);
            es.trackMapEnabled = eng.isTrackMapEnabled();
            es.trackMapOverrides = eng.getTrackMapOverrides();
            es.midiClockEnabled = eng.isMidiClockEnabled();
            es.oscBpmForward    = eng.isOscForwardEnabled();
            es.oscBpmAddr       = eng.getOscFwdBpmAddr();
            es.oscBpmCmd        = eng.getOscFwdBpmCmd();
            es.oscMixerForward  = eng.isOscMixerForwardEnabled();
            es.midiMixerForward = eng.isMidiMixerForwardEnabled();
            es.midiMixerCCChannel   = eng.getMidiMixerCCChannel();
            es.midiMixerNoteChannel = eng.getMidiMixerNoteChannel();
            es.artnetMixerForward  = eng.isArtnetMixerForwardEnabled();
            es.artnetMixerUniverse = eng.getArtnetMixerUniverse();
            es.artnetTriggerUniverse = eng.getArtnetTriggerUniverse();
            saveNicSetting(es.artnetDmxInterface, cmbArtnetDmxInterface, 2, &eng, kNicArtnetDmx);  // combo 1->-1(All), 2->0, 3->1...
            es.linkEnabled = eng.getLinkBridge().isEnabled();

            // Pro DJ Link
            es.proDJLinkPlayer = cmbProDJLinkPlayer.getSelectedId();
            if (es.proDJLinkPlayer < 1) es.proDJLinkPlayer = 1;

            // Track change triggers
            es.triggerMidiEnabled = eng.getTriggerOutput().isMidiEnabled();
            es.triggerOscEnabled  = eng.getTriggerOutput().isOscEnabled();
            es.artnetTriggerEnabled = eng.isArtnetTriggerEnabled();
            if (cmbTriggerMidiDevice.getSelectedId() > 0)
                es.triggerMidiDevice = cmbTriggerMidiDevice.getText();
            else if (eng.getTriggerOutput().isMidiOpen())
                es.triggerMidiDevice = eng.getTriggerOutput().getCurrentMidiDeviceName();
            if (!settings.showModeLocked)   // as the HippoNet destination above
            {
                auto oscIpText = edOscIp.getText().trim();
                es.oscDestIp   = oscIpText.isNotEmpty() ? oscIpText : "127.0.0.1";
                auto oscPortText = edOscPort.getText().trim();
                es.oscDestPort = oscPortText.isNotEmpty() ? juce::jlimit(1, 65535, oscPortText.getIntValue()) : 53000;
            }

            if (audioReady)
            {
                auto inEntry = getSelectedAudioInput();
                if (inEntry.deviceName.isNotEmpty()) { es.audioInputDevice = inEntry.deviceName; es.audioInputType = inEntry.typeName; }
                es.audioInputChannel = cmbAudioInputChannel.getSelectedId() - 1;

                auto outEntry = getSelectedAudioOutput();
                if (outEntry.deviceName.isNotEmpty()) { es.audioOutputDevice = outEntry.deviceName; es.audioOutputType = outEntry.typeName; }
                es.audioOutputStereo = (cmbAudioOutputChannel.getSelectedId() == kStereoItemId);
                es.audioOutputChannel = es.audioOutputStereo ? 0 : (cmbAudioOutputChannel.getSelectedId() - 1);

                auto thruEntry = getSelectedThruOutput();
                if (thruEntry.deviceName.isNotEmpty()) { es.thruOutputDevice = thruEntry.deviceName; es.thruOutputType = thruEntry.typeName; }
                es.thruOutputStereo = (cmbThruOutputChannel.getSelectedId() == kStereoItemId);
                es.thruOutputChannel = es.thruOutputStereo ? 0 : (cmbThruOutputChannel.getSelectedId() - 1);
                es.thruInputChannel = cmbThruInputChannel.getSelectedId() - 1;

                // Generator audio playback device
                es.generatorAudioEnabled = btnGenAudioOut.getToggleState();
                auto genAudioEntry = getSelectedGenAudioOutput();
                if (genAudioEntry.deviceName.isNotEmpty())
                {
                    es.generatorAudioDevice = genAudioEntry.deviceName;
                    es.generatorAudioType   = genAudioEntry.typeName;
                }
                es.generatorAudioStereo  = (cmbGenAudioChannel.getSelectedId() == kStereoItemId);
                es.generatorAudioChannel = es.generatorAudioStereo ? 0 : (cmbGenAudioChannel.getSelectedId() - 1);
                es.generatorAudioVolume  = (float) sldGenAudioVolume.getValue();
                es.generatorAudioFileChannelMode = juce::jlimit(0, 2, cmbGenAudioFileMode.getSelectedId() - 1);
                // Audio BPM device/channel
                es.audioBpmEnabled = eng.isAudioBpmRunning();
                if (eng.isAudioBpmRunning())
                {
                    if (eng.getActiveInput() == SrcType::LTC)
                    {
                        // LTC active: read from separate BPM combos
                        int abSel = cmbAudioBpmDevice.getSelectedId() - 1;
                        if (abSel >= 0 && abSel < scannedAudioInputs.size())
                        {
                            es.audioBpmDevice = scannedAudioInputs[abSel].deviceName;
                            es.audioBpmType   = scannedAudioInputs[abSel].typeName;
                        }
                        es.audioBpmChannel = cmbAudioBpmChannel.getSelectedId() - 2;
                    }
                    else
                    {
                        // Non-LTC: read from shared AUDIO SETTINGS combos
                        auto bpmEntry = getSelectedAudioInput();
                        if (bpmEntry.deviceName.isNotEmpty())
                        {
                            es.audioBpmDevice = bpmEntry.deviceName;
                            es.audioBpmType   = bpmEntry.typeName;
                        }
                        es.audioBpmChannel = cmbAudioInputChannel.getSelectedId() - 1;
                    }
                }
                es.audioBpmSmoothing = (float)sldBpmSmoothing.getValue() / 100.0f;
                // Gain: from separate slider in LTC mode, from shared slider otherwise
                if (eng.getActiveInput() == SrcType::LTC)
                    es.audioBpmGain = (int)sldBpmInputGain.getValue();
                else if (eng.isAudioBpmRunning())
                    es.audioBpmGain = (int)sldLtcInputGain.getValue();
            }
        }
        else
        {
            // For non-selected engines, read device names from the running handler
            // state to keep settings in sync even if devices were reconnected or
            // changed programmatically (e.g., via restartAllAudioDevices).
            if (eng.getMtcInput().getIsRunning())
                es.midiInputDevice = eng.getMtcInput().getCurrentDeviceName();
            if (eng.getMtcOutput().getIsRunning())
                es.midiOutputDevice = eng.getMtcOutput().getCurrentDeviceName();
            if (eng.getLtcInput().getIsRunning())
            {
                es.audioInputDevice  = eng.getLtcInput().getCurrentDeviceName();
                es.audioInputType    = eng.getLtcInput().getCurrentTypeName();
                es.audioInputChannel = eng.getLtcInput().getSelectedChannel();
                if (eng.getLtcInput().hasPassthruChannel())
                    es.thruInputChannel = eng.getLtcInput().getPassthruChannel();
            }
            if (eng.getLtcOutput().getIsRunning())
            {
                es.audioOutputDevice  = eng.getLtcOutput().getCurrentDeviceName();
                es.audioOutputType    = eng.getLtcOutput().getCurrentTypeName();
                int ch = eng.getLtcOutput().getSelectedChannel();
                es.audioOutputStereo  = (ch == -1);
                es.audioOutputChannel = (ch == -1) ? 0 : ch;
            }
            if (eng.getAudioThru() && eng.getAudioThru()->getIsRunning())
            {
                es.thruOutputDevice = eng.getAudioThru()->getCurrentDeviceName();
                es.thruOutputType   = eng.getAudioThru()->getCurrentTypeName();
                int ch = eng.getAudioThru()->getSelectedChannel();
                es.thruOutputStereo  = (ch == -1);
                es.thruOutputChannel = (ch == -1) ? 0 : ch;
            }
            // Generator audio playback (per-engine)
            es.generatorAudioEnabled = eng.isGeneratorAudioRunning();
            if (eng.isGeneratorAudioRunning())
            {
                es.generatorAudioDevice = eng.getGeneratorAudio().getCurrentDeviceName();
                es.generatorAudioType   = eng.getGeneratorAudio().getCurrentTypeName();
                int ch = eng.getGeneratorAudio().getSelectedChannel();
                es.generatorAudioStereo  = (ch == -1);
                es.generatorAudioChannel = (ch == -1) ? 0 : ch;
            }
            // Volume is per-engine and persists even when the audio device
            // is closed, so the user does not lose their setting.
            es.generatorAudioVolume = eng.getGeneratorAudioVolume();
            es.generatorAudioFileChannelMode = eng.getGeneratorAudioFileChannelMode();
            // ArtNet interfaces preserved from last save when engine was selected
            es.trackMapEnabled = eng.isTrackMapEnabled();
            es.trackMapOverrides = eng.getTrackMapOverrides();
            es.midiClockEnabled = eng.isMidiClockEnabled();
            es.oscBpmForward    = eng.isOscForwardEnabled();
            es.oscBpmAddr       = eng.getOscFwdBpmAddr();
            es.oscBpmCmd        = eng.getOscFwdBpmCmd();
            es.oscMixerForward  = eng.isOscMixerForwardEnabled();
            es.midiMixerForward = eng.isMidiMixerForwardEnabled();
            es.midiMixerCCChannel   = eng.getMidiMixerCCChannel();
            es.midiMixerNoteChannel = eng.getMidiMixerNoteChannel();
            es.artnetMixerForward  = eng.isArtnetMixerForwardEnabled();
            es.artnetMixerUniverse = eng.getArtnetMixerUniverse();
            es.artnetTriggerUniverse = eng.getArtnetTriggerUniverse();
            es.linkEnabled = eng.getLinkBridge().isEnabled();

            // Audio BPM
            es.audioBpmEnabled = eng.isAudioBpmRunning();
            if (eng.getAudioBpmInput().getIsRunning())
            {
                es.audioBpmDevice = eng.getAudioBpmInput().getCurrentDeviceName();
                es.audioBpmType   = eng.getAudioBpmInput().getCurrentTypeName();
                es.audioBpmChannel = eng.getAudioBpmInput().getSelectedChannel();
            }
            es.audioBpmSmoothing = eng.getAudioBpmInput().getSmoothing();
            es.audioBpmGain = (int)(eng.getAudioBpmInput().getInputGain() * 100.0f);

            // Pro DJ Link
            es.proDJLinkPlayer = eng.getProDJLinkPlayer();

            // Track change triggers
            es.triggerMidiEnabled = eng.getTriggerOutput().isMidiEnabled();
            es.triggerOscEnabled  = eng.getTriggerOutput().isOscEnabled();
            es.artnetTriggerEnabled = eng.isArtnetTriggerEnabled();
            if (eng.getTriggerOutput().isMidiOpen())
                es.triggerMidiDevice = eng.getTriggerOutput().getCurrentMidiDeviceName();
        }
    }

    // Pro DJ Link global settings (the interface by saveNicSetting's rule,
    // as above)
    saveNicSetting(settings.proDJLinkInterface, cmbProDJLinkInterface, 1, nullptr, kNicProDJLink);
    settings.prodjlinkBridgeIdentity = juce::jlimit(0, 3, cmbPdlBridgeIdentity.getSelectedId() - 1);
    settings.prodjlink95bMode        = juce::jlimit(0, 2, cmbPdl95bMode.getSelectedId() - 1);

    // StageLinQ global settings
    saveNicSetting(settings.stageLinQInterface, cmbStageLinQInterface, 1, nullptr, kNicStageLinQ);

    // Capture window bounds (if windows are open and visible)
    if (proDJLinkViewWindow != nullptr && proDJLinkViewWindow->isVisible())
    {
        auto b = proDJLinkViewWindow->getBounds();
        settings.pdlViewBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                               + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        settings.pdlViewHorizontal = proDJLinkViewWindow->getLayoutHorizontal();
        settings.pdlViewAlternating = proDJLinkViewWindow->getLayoutAlternating();
        settings.pdlViewShowMixer  = proDJLinkViewWindow->getShowMixer();
    }
    if (trackMapWindow != nullptr && trackMapWindow->isVisible())
    {
        auto b = trackMapWindow->getBounds();
        settings.trackMapBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
    }
    if (mixerMapWindow != nullptr && mixerMapWindow->isVisible())
    {
        auto b = mixerMapWindow->getBounds();
        settings.mixerMapBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
    }
    if (cuePointWindow != nullptr && cuePointWindow->isVisible())
    {
        auto b = cuePointWindow->getBounds();
        settings.cuePointBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
    }
    if (genPresetWindow != nullptr && genPresetWindow->isVisible())
    {
        auto b = genPresetWindow->getBounds();
        settings.genPresetBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                 + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
    }

    settings.save();
}

int MainComponent::findDeviceByName(const juce::ComboBox& cmb, const juce::String& name)
{
    if (name.isEmpty()) return -1;
    // Strip any markers that may have been saved in older settings files
    auto cleanName = stripComboMarker(name);
    if (cleanName.isEmpty()) return -1;

    static const juce::String dotSuffix = juce::String(" ") + juce::String::charToString(0x25CF);
    for (int i = 0; i < cmb.getNumItems(); i++)
    {
        auto text = cmb.getItemText(i);
        // Exact match, or match ignoring the " [ENGINE N]" or " *" marker suffix
        if (text == name || text == cleanName || text.startsWith(cleanName + " [") || text == cleanName + dotSuffix)
            return i;
    }
    // Then the item's text stripped as the name is.  A device whose own
    // name ends in a space (Windows' MIDI API cuts names at 31 characters)
    // is saved without it -- flushSettings saves stripComboMarker's text --
    // and matched none of the above: it was not selected, and since AUDIT
    // UI-6 the restore opened nothing for it.
    for (int i = 0; i < cmb.getNumItems(); i++)
        if (stripComboMarker(cmb.getItemText(i)) == cleanName)
            return i;
    return -1;
}

int MainComponent::findFilteredIndex(const juce::Array<int>& filteredIndices,
                                      const juce::Array<AudioDeviceEntry>& entries,
                                      const juce::String& typeName, const juce::String& deviceName)
{
    for (int f = 0; f < filteredIndices.size(); f++)
    {
        int realIdx = filteredIndices[f];
        if (realIdx < entries.size()
            && entries[realIdx].deviceName == deviceName
            && (typeName.isEmpty() || entries[realIdx].typeName == typeName))
            return f;
    }
    return -1;
}

AudioDeviceEntry MainComponent::getSelectedAudioInput() const
{
    int sel = cmbAudioInputDevice.getSelectedId() - 1;
    if (sel >= 0 && sel < filteredInputIndices.size())
    { int realIdx = filteredInputIndices[sel]; if (realIdx < scannedAudioInputs.size()) return scannedAudioInputs[realIdx]; }
    return {};
}

AudioDeviceEntry MainComponent::getSelectedAudioOutput() const
{
    int sel = cmbAudioOutputDevice.getSelectedId() - 1;
    if (sel >= 0 && sel < filteredOutputIndices.size())
    { int realIdx = filteredOutputIndices[sel]; if (realIdx < scannedAudioOutputs.size()) return scannedAudioOutputs[realIdx]; }
    return {};
}

AudioDeviceEntry MainComponent::getSelectedThruOutput() const
{
    int sel = cmbThruOutputDevice.getSelectedId() - 1;
    if (sel >= 0 && sel < filteredOutputIndices.size())
    { int realIdx = filteredOutputIndices[sel]; if (realIdx < scannedAudioOutputs.size()) return scannedAudioOutputs[realIdx]; }
    return {};
}

AudioDeviceEntry MainComponent::getSelectedGenAudioOutput() const
{
    int sel = cmbGenAudioDevice.getSelectedId() - 1;
    if (sel >= 0 && sel < filteredOutputIndices.size())
    { int realIdx = filteredOutputIndices[sel]; if (realIdx < scannedAudioOutputs.size()) return scannedAudioOutputs[realIdx]; }
    return {};
}

//==============================================================================
// CHANNEL HELPERS
//==============================================================================
void MainComponent::populateAudioInputChannels()
{
    auto& eng = currentEngine();
    int prevLtcCh = cmbAudioInputChannel.getSelectedId();
    int prevThru = cmbThruInputChannel.getSelectedId();
    cmbAudioInputChannel.clear(juce::dontSendNotification);
    cmbThruInputChannel.clear(juce::dontSendNotification);

    // Channel count: use whichever audio source is active
    int n = 2;
    if (eng.getLtcInput().getIsRunning())
        n = juce::jmax(2, eng.getLtcInput().getChannelCount());
    else if (eng.isAudioBpmRunning())
        n = juce::jmax(2, eng.getAudioBpmInput().getChannelCount());

    for (int i = 0; i < n; i++)
    {
        auto nm = "Ch " + juce::String(i + 1);
        cmbAudioInputChannel.addItem(nm, i + 1);
        cmbThruInputChannel.addItem(nm, i + 1);
    }

    cmbAudioInputChannel.setSelectedId(
        (prevLtcCh > 0 && prevLtcCh <= n) ? prevLtcCh : 1, juce::dontSendNotification);
    cmbThruInputChannel.setSelectedId(
        (prevThru > 0 && prevThru <= n) ? prevThru : juce::jmin(2, n), juce::dontSendNotification);
}

void MainComponent::populateAudioOutputChannels()
{
    auto& eng = currentEngine();
    int prev = cmbAudioOutputChannel.getSelectedId();
    cmbAudioOutputChannel.clear(juce::dontSendNotification);
    int n = juce::jmax(2, eng.getLtcOutput().getChannelCount());
    if (n >= 2) cmbAudioOutputChannel.addItem("Ch 1 + Ch 2", kStereoItemId);
    for (int i = 0; i < n; i++) cmbAudioOutputChannel.addItem("Ch " + juce::String(i+1), i+1);
    if (prev == kStereoItemId && n >= 2) cmbAudioOutputChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
    else if (prev > 0 && prev <= n) cmbAudioOutputChannel.setSelectedId(prev, juce::dontSendNotification);
    else cmbAudioOutputChannel.setSelectedId(n >= 2 ? kStereoItemId : 1, juce::dontSendNotification);
}

void MainComponent::populateThruOutputChannels()
{
    auto& eng = currentEngine();
    if (!eng.getAudioThru()) return;
    int prev = cmbThruOutputChannel.getSelectedId();
    cmbThruOutputChannel.clear(juce::dontSendNotification);
    int n = juce::jmax(2, eng.getAudioThru()->getChannelCount());
    if (n >= 2) cmbThruOutputChannel.addItem("Ch 1 + Ch 2", kStereoItemId);
    for (int i = 0; i < n; i++) cmbThruOutputChannel.addItem("Ch " + juce::String(i+1), i+1);
    if (prev == kStereoItemId && n >= 2) cmbThruOutputChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
    else if (prev > 0 && prev <= n) cmbThruOutputChannel.setSelectedId(prev, juce::dontSendNotification);
    else cmbThruOutputChannel.setSelectedId(n >= 2 ? kStereoItemId : 1, juce::dontSendNotification);
}

void MainComponent::populateGenAudioChannels()
{
    auto& eng = currentEngine();
    int prev = cmbGenAudioChannel.getSelectedId();
    cmbGenAudioChannel.clear(juce::dontSendNotification);
    int n = juce::jmax(2, eng.getGeneratorAudio().getChannelCount());
    if (n >= 2) cmbGenAudioChannel.addItem("Ch 1 + Ch 2", kStereoItemId);
    for (int i = 0; i < n; i++) cmbGenAudioChannel.addItem("Ch " + juce::String(i+1), i+1);
    if (prev == kStereoItemId && n >= 2) cmbGenAudioChannel.setSelectedId(kStereoItemId, juce::dontSendNotification);
    else if (prev > 0 && prev <= n) cmbGenAudioChannel.setSelectedId(prev, juce::dontSendNotification);
    else cmbGenAudioChannel.setSelectedId(n >= 2 ? kStereoItemId : 1, juce::dontSendNotification);
}

void MainComponent::populateAudioBpmChannels()
{
    int prev = cmbAudioBpmChannel.getSelectedId();
    cmbAudioBpmChannel.clear(juce::dontSendNotification);

    // Use running device channel count if available, else default 2
    auto& eng = currentEngine();
    int numCh = eng.getAudioBpmInput().getIsRunning()
              ? juce::jmax(2, eng.getAudioBpmInput().getChannelCount())
              : 2;

    if (numCh >= 2)
        cmbAudioBpmChannel.addItem("Stereo Mix", 1);  // id 1 -> channel -1
    for (int i = 0; i < numCh; i++)
        cmbAudioBpmChannel.addItem("Ch " + juce::String(i + 1), i + 2);  // id 2..N+1 -> channel 0..N-1

    if (prev >= 1 && prev <= cmbAudioBpmChannel.getNumItems())
        cmbAudioBpmChannel.setSelectedId(prev, juce::dontSendNotification);
    else
        cmbAudioBpmChannel.setSelectedId(numCh >= 2 ? 1 : 2, juce::dontSendNotification);
}

void MainComponent::restartAudioBpm()
{
    auto& eng = currentEngine();
    bool ltcActive = (eng.getActiveInput() == SrcType::LTC);

    juce::String typeName, deviceName;
    int channel = 0;

    if (ltcActive)
    {
        // LTC owns shared AUDIO SETTINGS — read from separate BPM combos
        int devIdx = cmbAudioBpmDevice.getSelectedId() - 1;
        if (devIdx < 0 || devIdx >= scannedAudioInputs.size())
        {
            eng.stopAudioBpm();
            return;
        }
        typeName   = scannedAudioInputs[devIdx].typeName;
        deviceName = scannedAudioInputs[devIdx].deviceName;
        channel = cmbAudioBpmChannel.getSelectedId() - 2;  // id 1->-1(stereo), 2->0, 3->1...
        if (channel < -1) channel = -1;
    }
    else
    {
        // Non-LTC — read from shared AUDIO SETTINGS combos
        auto entry = getSelectedAudioInput();
        if (entry.deviceName.isEmpty() && !filteredInputIndices.isEmpty())
        { cmbAudioInputDevice.setSelectedId(1, juce::dontSendNotification); entry = getSelectedAudioInput(); }
        if (entry.deviceName.isEmpty())
        {
            eng.stopAudioBpm();
            return;
        }
        typeName   = entry.typeName;
        deviceName = entry.deviceName;
        channel = cmbAudioInputChannel.getSelectedId() - 1;
        if (channel < 0) channel = 0;
    }

    double sr = getPreferredSampleRate();
    int bs = getPreferredBufferSize();
    eng.startAudioBpm(typeName, deviceName, channel, sr, bs);
    float gain = ltcActive ? (float)sldBpmInputGain.getValue() / 100.0f
                           : (float)sldLtcInputGain.getValue() / 100.0f;
    eng.getAudioBpmInput().setInputGain(gain);
    if (!ltcActive)
        populateAudioInputChannels();
    else
        populateAudioBpmChannels();
}

int MainComponent::findLinkOwnerOtherThan(int engineIdx) const
{
    for (int i = 0; i < (int)engines.size(); i++)
    {
        if (i == engineIdx) continue;
        if (engines[(size_t)i]->getLinkBridge().isEnabled())
            return i;
    }
    return -1;
}

int MainComponent::getChannelFromCombo(const juce::ComboBox& cmb) const
{
    int id = cmb.getSelectedId();
    if (id == kStereoItemId) return -1;
    return id - 1;
}

int MainComponent::getChannelFromComboOrSettings(const juce::ComboBox& cmb,
                                                 int  settingsChannel,
                                                 bool settingsStereo) const
{
    // id == 0 means "no selection" -- typical right after construction
    // before populate*Channels has added any items.  Anything non-zero
    // means the combo is populated and reflects the user's choice (or
    // the populator's default), so honour it via the existing helper.
    if (cmb.getSelectedId() == 0)
        return settingsStereo ? -1 : settingsChannel;
    return getChannelFromCombo(cmb);
}

//==============================================================================
// VISIBILITY (updated for collapse + engine)
//==============================================================================
void MainComponent::updateOnAirQuietVisibility()
{
    // OFF AIR AT is StageLinQ's alone (Pro DJ Link's on-air comes from the
    // DJM as a flag, with no level), and only means something with ON AIR.
    const bool show = cmbProDJLinkPlayer.isVisible()
                   && currentEngine().getActiveInput() == SrcType::StageLinQ
                   && cmbProDJLinkPlayer.getSelectedId() == 10;
    cmbOnAirQuiet.setVisible(show);
    lblOnAirQuiet.setVisible(show);
}

void MainComponent::updateDeviceSelectorVisibility()
{
    auto& eng = currentEngine();
    auto input = eng.getActiveInput();
    bool showMidiIn   = (input == SrcType::MTC)    && inputConfigExpanded;
    bool showArtnetIn = (input == SrcType::ArtNet)  && inputConfigExpanded;
    bool showLANetTCIn = (input == SrcType::LANetTC)  && inputConfigExpanded;
    bool showHippoIn  = (input == SrcType::Hippotizer) && inputConfigExpanded;
    bool showWinampIn = (input == SrcType::Winamp) && inputConfigExpanded;
    bool showLtcIn    = (input == SrcType::LTC)     && inputConfigExpanded;
    bool showGenerator = (input == SrcType::SystemTime) && inputConfigExpanded;
    bool showProDJLinkIn = (input == SrcType::ProDJLink || input == SrcType::StageLinQ) && inputConfigExpanded;
    // TrackMap is also available for Winamp (the input emits artist + title
    // + duration on track change, which is the same TrackMap key the DJ
    // sources use), so the TrackMap toggle and editor buttons follow a
    // wider condition than the ProDJLink/StageLinQ-specific UI (deck views,
    // mixer map editor) which only make sense for the DJ protocols.
    bool showTrackMapBtns = (input == SrcType::ProDJLink
                          || input == SrcType::StageLinQ
                          || input == SrcType::Winamp) && inputConfigExpanded;
    bool showAudioOut = (eng.isOutputLtcEnabled() || (eng.isPrimary() && eng.isOutputThruEnabled()));
    bool hasInputConfig = true;  // all sources have expandable config now

    btnCollapseInput.setVisible(hasInputConfig);
    updateCollapseButtonText(btnCollapseInput, inputConfigExpanded);

    cmbMidiInputDevice.setVisible(showMidiIn);       lblMidiInputDevice.setVisible(showMidiIn);
    {
        const bool showFreewheel = (showMidiIn || showArtnetIn || showLANetTCIn || showHippoIn || showLtcIn);
        cmbInputFreewheel.setVisible(showFreewheel); lblInputFreewheel.setVisible(showFreewheel);
    }
    cmbArtnetInputInterface.setVisible(showArtnetIn); lblArtnetInputInterface.setVisible(showArtnetIn);
    cmbLANetTCInputInterface.setVisible(showLANetTCIn); lblLANetTCInputInterface.setVisible(showLANetTCIn);
    cmbHippoInputInterface.setVisible(showHippoIn);   lblHippoInputInterface.setVisible(showHippoIn);
    cmbHippoTcChannel.setVisible(showHippoIn);        lblHippoTcChannel.setVisible(showHippoIn);
    lblWinampInfoHeader.setVisible(showWinampIn);     lblWinampInfo.setVisible(showWinampIn);
    btnGenClock.setVisible(showGenerator);
    bool showGenTransport = showGenerator && !eng.getGeneratorClockMode();
    btnGenPlay.setVisible(showGenTransport);   btnGenPause.setVisible(showGenTransport);  btnGenStop.setVisible(showGenTransport);
    txtGenStartTC.setVisible(showGenTransport); lblGenStartTC.setVisible(showGenTransport);
    txtGenStopTC.setVisible(showGenTransport);  lblGenStopTC.setVisible(showGenTransport);
    cmbGenPreset.setVisible(showGenTransport);  lblGenPreset.setVisible(showGenTransport);
    btnGenPrev.setVisible(showGenTransport);    btnGenNext.setVisible(showGenTransport);
    btnGenGo.setVisible(showGenTransport);      btnGenPresetEdit.setVisible(showGenTransport);

    // Generator audio playback (only visible in transport mode)
    btnGenAudioOut.setVisible(showGenTransport);
    bool showGenAudioConfig = showGenTransport && btnGenAudioOut.getToggleState();
    cmbGenAudioDevice.setVisible(showGenAudioConfig);  lblGenAudioDevice.setVisible(showGenAudioConfig);
    cmbGenAudioChannel.setVisible(showGenAudioConfig); lblGenAudioChannel.setVisible(showGenAudioConfig);
    cmbGenAudioFileMode.setVisible(showGenAudioConfig); lblGenAudioFileMode.setVisible(showGenAudioConfig);
    sldGenAudioVolume.setVisible(showGenAudioConfig);  lblGenAudioVolume.setVisible(showGenAudioConfig);
    lblGenAudioStatus.setVisible(showGenAudioConfig);
    miniWaveform.setVisible(showGenAudioConfig);
    btnGenWaveformOpen.setVisible(showGenAudioConfig);
    btnOscIn.setVisible(showGenerator);
    bool showOscInConfig = showGenerator;
    cmbOscInputInterface.setVisible(showOscInConfig);  lblOscInputInterface.setVisible(showOscInConfig);
    lblOscInPort.setVisible(showOscInConfig);           txtOscInPort.setVisible(showOscInConfig);
    lblOscInStatus.setVisible(showOscInConfig && lblOscInStatus.getText().isNotEmpty());
    btnTrackMap.setVisible(showTrackMapBtns);
    btnTrackMapEdit.setVisible(showTrackMapBtns);
    btnProDJLinkView.setVisible(showProDJLinkIn && input == SrcType::ProDJLink);
    btnStageLinQView.setVisible(showProDJLinkIn && input == SrcType::StageLinQ);
    btnMixerMapEdit.setVisible(showProDJLinkIn);
    if (input == SrcType::StageLinQ)
    {
        juce::Colour slqAccent(0xFF00CC66);
        btnMixerMapEdit.setColour(juce::TextButton::buttonColourId, slqAccent.withAlpha(0.15f));
        btnMixerMapEdit.setColour(juce::TextButton::textColourOffId, slqAccent.brighter(0.3f));
    }
    else
    {
        juce::Colour pdl(0xFF00AAFF);
        btnMixerMapEdit.setColour(juce::TextButton::buttonColourId, pdl.withAlpha(0.15f));
        btnMixerMapEdit.setColour(juce::TextButton::textColourOffId, pdl.brighter(0.3f));
    }
    btnBpmOff.setVisible(showProDJLinkIn);
    btnBpmX2.setVisible(showProDJLinkIn);
    btnBpmX4.setVisible(showProDJLinkIn);
    btnBpmD2.setVisible(showProDJLinkIn);
    btnBpmD4.setVisible(showProDJLinkIn);

    // Audio BPM: available for every source but Pro DJ Link and StageLinQ.
    // For SystemTime there is no collapse button, so show unconditionally.
    bool isNonDjSource = (input != SrcType::ProDJLink && input != SrcType::StageLinQ);
    bool showAudioBpmToggle = isNonDjSource
        && (input == SrcType::SystemTime || inputConfigExpanded);
    bool showAudioBpmActive = showAudioBpmToggle && btnAudioBpm.getToggleState();
    btnAudioBpm.setVisible(showAudioBpmToggle);
    lblBpmValue.setVisible(showAudioBpmActive);
    ledBeat.setVisible(showAudioBpmActive);
    sldBpmSmoothing.setVisible(showAudioBpmActive);  lblBpmSmoothing.setVisible(showAudioBpmActive);

    // When LTC is active, Audio BPM uses its OWN separate device/channel combos
    // (the shared AUDIO SETTINGS section belongs to LTC).
    // When NOT LTC, Audio BPM shares the AUDIO SETTINGS section.
    bool bpmUsesSeparateAudio = showAudioBpmActive && showLtcIn;
    bool bpmUsesSharedAudio   = showAudioBpmActive && !showLtcIn;
    cmbAudioBpmDevice.setVisible(bpmUsesSeparateAudio);  lblAudioBpmDevice.setVisible(bpmUsesSeparateAudio);
    cmbAudioBpmChannel.setVisible(bpmUsesSeparateAudio); lblAudioBpmChannel.setVisible(bpmUsesSeparateAudio);
    sldBpmInputGain.setVisible(bpmUsesSeparateAudio);    lblBpmInputGain.setVisible(bpmUsesSeparateAudio);
    mtrAudioBpm.setVisible(bpmUsesSeparateAudio);

    // BPM output controls: visible for DJ sources OR when audio BPM is active
    bool showBpmOutputs = showProDJLinkIn || showAudioBpmActive;
    btnMidiClock.setVisible(showBpmOutputs);
    btnOscFwdBpm.setVisible(showBpmOutputs);
    edOscFwdBpmAddr.setVisible(showBpmOutputs && btnOscFwdBpm.getToggleState());
    lblOscFwdBpmAddr.setVisible(showBpmOutputs && btnOscFwdBpm.getToggleState());
    edOscFwdBpmCmd.setVisible(showBpmOutputs && btnOscFwdBpm.getToggleState());
    lblOscFwdBpmCmd.setVisible(showBpmOutputs && btnOscFwdBpm.getToggleState());
    btnOscMixerFwd.setVisible(showProDJLinkIn);
    btnMidiMixerFwd.setVisible(showProDJLinkIn);
    {
        bool showMidiMix = showProDJLinkIn && btnMidiMixerFwd.getToggleState();
        cmbMidiMixCCCh.setVisible(showMidiMix);
        lblMidiMixCCCh.setVisible(showMidiMix);
        cmbMidiMixNoteCh.setVisible(showMidiMix);
        lblMidiMixNoteCh.setVisible(showMidiMix);
    }
    btnArtnetMixerFwd.setVisible(showProDJLinkIn);
    {
        bool showArtMix = showProDJLinkIn && btnArtnetMixerFwd.getToggleState();
        cmbArtMixNet.setVisible(showArtMix);
        cmbArtMixSub.setVisible(showArtMix);
        cmbArtMixUni.setVisible(showArtMix);
        lblArtMixAddr.setVisible(showArtMix);
    }
    btnLink.setVisible(showBpmOutputs);
    bool linkOwnedElsewhere = findLinkOwnerOtherThan(selectedEngine) >= 0;
    lblLinkStatus.setVisible(showBpmOutputs && (btnLink.getToggleState() || linkOwnedElsewhere));

    // Track-change trigger outputs (MIDI, OSC, Art-Net DMX).
    //
    // These are populated by TrackMap entries (per-track MIDI note / CC,
    // OSC address+args, Art-Net DMX channel/value).  They fire whenever
    // the engine detects a track change, so every source that drives the
    // TrackMap lookup pipeline needs the destination-config controls --
    // ProDJLink + StageLinQ (via showProDJLinkIn), Generator (cue points
    // can fire MIDI/OSC/DMX), and Winamp (per-track triggers on Winamp
    // track change).  LTC / MTC / ArtNet input do not have a TrackMap
    // lookup so they don't expose the trigger destination UI.
    bool showTriggerOutputs = showProDJLinkIn || showGenerator || showWinampIn;

    btnTriggerMidi.setVisible(showTriggerOutputs);
    // Parenthesised explicitly: this is what the operator precedence already
    // produced, but Clang warns about mixing && inside || without saying so.
    cmbTriggerMidiDevice.setVisible(
        (showTriggerOutputs
            && (btnTriggerMidi.getToggleState() || btnMidiClock.getToggleState()
                || btnMidiMixerFwd.getToggleState()))
        || (showAudioBpmActive && btnMidiClock.getToggleState()));
    btnTriggerOsc.setVisible(showTriggerOutputs);
    btnArtnetTrigger.setVisible(showTriggerOutputs);
    {
        bool showArtTrig = showTriggerOutputs && btnArtnetTrigger.getToggleState();
        cmbArtTrigNet.setVisible(showArtTrig);
        cmbArtTrigSub.setVisible(showArtTrig);
        cmbArtTrigUni.setVisible(showArtTrig);
        lblArtTrigAddr.setVisible(showArtTrig);
    }
    {
        bool showArtDmxIface = showTriggerOutputs
            && (btnArtnetMixerFwd.getToggleState() || btnArtnetTrigger.getToggleState());
        cmbArtnetDmxInterface.setVisible(showArtDmxIface);
        lblArtnetDmxInterface.setVisible(showArtDmxIface);
    }
    bool showOscConfig = (showProDJLinkIn || showAudioBpmActive)
        && (btnOscFwdBpm.getToggleState() || btnOscMixerFwd.getToggleState());
    bool showOscConfigFull = showOscConfig
        || (showTriggerOutputs && btnTriggerOsc.getToggleState());
    edOscIp.setVisible(showOscConfigFull);
    edOscPort.setVisible(showOscConfigFull);

    // Pro DJ Link / StageLinQ -- separate interface combos
    bool showPdlIface = showProDJLinkIn && input == SrcType::ProDJLink;
    bool showSlqIface = showProDJLinkIn && input == SrcType::StageLinQ;
    cmbProDJLinkInterface.setVisible(showPdlIface);  lblProDJLinkInterface.setVisible(showPdlIface);
    cmbPdlBridgeIdentity.setVisible(showPdlIface);   lblPdlBridgeIdentity.setVisible(showPdlIface);
    cmbPdl95bMode.setVisible(showPdlIface);          lblPdl95bMode.setVisible(showPdlIface);
    cmbStageLinQInterface.setVisible(showSlqIface);   lblStageLinQInterface.setVisible(showSlqIface);
    cmbProDJLinkPlayer.setVisible(showProDJLinkIn);     lblProDJLinkPlayer.setVisible(showProDJLinkIn);

    // Repopulate player combo based on input source:
    // ProDJLink: players 1-6 + XF-A + XF-B + MASTER + ON AIR
    // StageLinQ: decks 1-4 + XF-A + XF-B + ON AIR
    {
        int prevId = cmbProDJLinkPlayer.getSelectedId();
        cmbProDJLinkPlayer.clear(juce::dontSendNotification);
        if (input == SrcType::StageLinQ)
        {
            for (int i = 1; i <= StageLinQ::kMaxDecks; ++i)
                cmbProDJLinkPlayer.addItem("DECK " + juce::String(i), i);
            cmbProDJLinkPlayer.addItem("XF-A", 7);
            cmbProDJLinkPlayer.addItem("XF-B", 8);
            cmbProDJLinkPlayer.addItem("ON AIR", 10);   // DESIGN D34
            // MASTER is not offered for StageLinQ yet (would need parallel
            // resolveMasterPlayerStageLinQ -- the data is there, just not wired).
            // PLAYER 5-6 and MASTER have no StageLinQ item: back to DECK 1,
            // as the engine does (TimecodeEngine::sanitiseStageLinQPlayer).
            const bool offered = (prevId >= 1 && prevId <= StageLinQ::kMaxDecks)
                              || prevId == 7 || prevId == 8 || prevId == 10;
            if (!offered) prevId = 1;
        }
        else
        {
            for (int i = 1; i <= ProDJLink::kMaxPlayers; ++i)
                cmbProDJLinkPlayer.addItem("PLAYER " + juce::String(i), i);
            cmbProDJLinkPlayer.addItem("XF-A", 7);
            cmbProDJLinkPlayer.addItem("XF-B", 8);
            cmbProDJLinkPlayer.addItem("MASTER", 9);
            cmbProDJLinkPlayer.addItem("ON AIR", 10);   // DESIGN D34
            if (prevId < 1 || prevId > 10) prevId = 1;
        }
        cmbProDJLinkPlayer.setSelectedId(prevId, juce::dontSendNotification);
    }
    updateOnAirQuietVisibility();
    lblProDJLinkMetadata.setVisible(showProDJLinkIn);
    lblNextCue.setVisible(showProDJLinkIn);
    lblProDJLinkTrackInfo.setVisible(showProDJLinkIn);
    lblMixerStatus.setVisible(showProDJLinkIn);
    artworkDisplay.setVisible(showProDJLinkIn);
    waveformDisplay.setVisible(showProDJLinkIn);

    bool showAudioInput = showLtcIn || bpmUsesSharedAudio;
    cmbAudioInputTypeFilter.setVisible(showAudioInput);  lblAudioInputTypeFilter.setVisible(showAudioInput);
    cmbSampleRate.setVisible(showAudioInput);             lblSampleRate.setVisible(showAudioInput);
    cmbBufferSize.setVisible(showAudioInput);             lblBufferSize.setVisible(showAudioInput);
    cmbAudioInputDevice.setVisible(showAudioInput);       lblAudioInputDevice.setVisible(showAudioInput);
    cmbAudioInputChannel.setVisible(showAudioInput);      lblAudioInputChannel.setVisible(showAudioInput);
    sldLtcInputGain.setVisible(showAudioInput);           lblLtcInputGain.setVisible(showAudioInput);
    mtrLtcInput.setVisible(showAudioInput);

    // Dynamic labels: adapt to LTC vs Audio BPM context
    if (bpmUsesSharedAudio)
    {
        lblAudioInputChannel.setText("BPM CHANNEL:", juce::dontSendNotification);
        lblLtcInputGain.setText("BPM INPUT GAIN:", juce::dontSendNotification);
    }
    else
    {
        lblAudioInputChannel.setText("LTC CHANNEL:", juce::dontSendNotification);
        lblLtcInputGain.setText("LTC INPUT GAIN:", juce::dontSendNotification);
    }

    bool showThruInput = showLtcIn && eng.isPrimary() && eng.isOutputThruEnabled();
    cmbThruInputChannel.setVisible(showThruInput);  lblThruInputChannel.setVisible(showThruInput);
    sldThruInputGain.setVisible(showThruInput);     lblThruInputGain.setVisible(showThruInput);
    mtrThruInput.setVisible(showThruInput);
    lblInputStatus.setVisible(true);
    lblLtcInUserBits.setVisible(showLtcIn);

    // FPS Convert: not applicable for ProDJLink/StageLinQ (user selects fps directly)
    bool showFpsConvert = (input != SrcType::ProDJLink && input != SrcType::StageLinQ);
    btnFpsConvert.setVisible(showFpsConvert);
    if (!showFpsConvert && eng.isFpsConvertEnabled())
    {
        eng.setFpsConvertEnabled(false);
        btnFpsConvert.setToggleState(false, juce::dontSendNotification);
    }

    // Close TrackMap / MixerMap editor windows when no engine uses ProDJLink/StageLinQ
    // (these are shared windows -- keep open as long as any engine is on PDL/SLQ)
    {
        bool anyPdl = false;
        for (auto& e : engines)
            if (e->getActiveInput() == SrcType::ProDJLink || e->getActiveInput() == SrcType::StageLinQ) { anyPdl = true; break; }
        if (!anyPdl)
        {
            if (trackMapWindow != nullptr)
                delete trackMapWindow.getComponent();
            if (mixerMapWindow != nullptr)
                delete mixerMapWindow.getComponent();
        }
    }

    // Output sections
    bool showMtcConfig    = eng.isOutputMtcEnabled()    && mtcOutExpanded;
    bool showArtnetConfig = eng.isOutputArtnetEnabled() && artnetOutExpanded;
    bool showLANetTCConfig = eng.isOutputLANetTCEnabled()  && laNetTCOutExpanded;
    bool showLtcConfig    = eng.isOutputLtcEnabled()    && ltcOutExpanded;
    bool showThruConfig   = eng.isPrimary() && eng.isOutputThruEnabled() && thruOutExpanded;

    btnCollapseMtcOut.setVisible(eng.isOutputMtcEnabled());
    btnCollapseArtnetOut.setVisible(eng.isOutputArtnetEnabled());
    btnCollapseLANetTCOut.setVisible(eng.isOutputLANetTCEnabled());
    btnCollapseLtcOut.setVisible(eng.isOutputLtcEnabled());
    btnCollapseThruOut.setVisible(eng.isPrimary() && eng.isOutputThruEnabled());
    updateCollapseButtonText(btnCollapseMtcOut, mtcOutExpanded);
    updateCollapseButtonText(btnCollapseArtnetOut, artnetOutExpanded);
    updateCollapseButtonText(btnCollapseLANetTCOut, laNetTCOutExpanded);
    updateCollapseButtonText(btnCollapseLtcOut, ltcOutExpanded);
    updateCollapseButtonText(btnCollapseThruOut, thruOutExpanded);

    cmbMidiOutputDevice.setVisible(showMtcConfig);       lblMidiOutputDevice.setVisible(showMtcConfig);
    sldMtcOffset.setVisible(showMtcConfig);              lblMtcOffset.setVisible(showMtcConfig);
    lblOutputMtcStatus.setVisible(eng.isOutputMtcEnabled());

    cmbArtnetOutputInterface.setVisible(showArtnetConfig); lblArtnetOutputInterface.setVisible(showArtnetConfig);
    sldArtnetOffset.setVisible(showArtnetConfig);          lblArtnetOffset.setVisible(showArtnetConfig);
    lblOutputArtnetStatus.setVisible(eng.isOutputArtnetEnabled());

    cmbLANetTCOutputInterface.setVisible(showLANetTCConfig);   lblLANetTCOutputInterface.setVisible(showLANetTCConfig);
    sldLANetTCOffset.setVisible(showLANetTCConfig);            lblLANetTCOffset.setVisible(showLANetTCConfig);
    lblOutputLANetTCStatus.setVisible(eng.isOutputLANetTCEnabled());

    cmbAudioOutputTypeFilter.setVisible(showAudioOut && (showLtcConfig || showThruConfig));
    lblAudioOutputTypeFilter.setVisible(showAudioOut && (showLtcConfig || showThruConfig));

    cmbAudioOutputDevice.setVisible(showLtcConfig);  lblAudioOutputDevice.setVisible(showLtcConfig);
    cmbAudioOutputChannel.setVisible(showLtcConfig); lblAudioOutputChannel.setVisible(showLtcConfig);
    sldLtcOutputGain.setVisible(showLtcConfig);      lblLtcOutputGain.setVisible(showLtcConfig);
    btnLtcHoldOnPause.setVisible(showLtcConfig);
    mtrLtcOutput.setVisible(showLtcConfig);
    sldLtcOffset.setVisible(showLtcConfig);            lblLtcOffset.setVisible(showLtcConfig);
    txtLtcUserBits.setVisible(showLtcConfig);          lblLtcUserBits.setVisible(showLtcConfig);
    cmbLtcUserBitsMode.setVisible(showLtcConfig);      lblLtcUserBitsMode.setVisible(showLtcConfig);
    btnLtcUserBitsReverse.setVisible(showLtcConfig && eng.getLtcUserBitsMode() == TimecodeEngine::kUserBitsManual);
    cmbSampleRateOut.setVisible(showLtcConfig);       lblSampleRateOut.setVisible(showLtcConfig);
    cmbBufferSizeOut.setVisible(showLtcConfig);       lblBufferSizeOut.setVisible(showLtcConfig);
    lblOutputLtcStatus.setVisible(eng.isOutputLtcEnabled());

    // AudioThru controls: only visible for primary engine
    bool showThruSection = eng.isPrimary();
    btnThruOut.setVisible(showThruSection);
    cmbThruOutputDevice.setVisible(showThruConfig);  lblThruOutputDevice.setVisible(showThruConfig);
    cmbThruOutputChannel.setVisible(showThruConfig); lblThruOutputChannel.setVisible(showThruConfig);
    sldThruOutputGain.setVisible(showThruConfig);    lblThruOutputGain.setVisible(showThruConfig);
    mtrThruOutput.setVisible(showThruConfig);
    lblOutputThruStatus.setVisible(eng.isPrimary() && eng.isOutputThruEnabled());

    // TCNet interface combo: visible when TCNET OUT is enabled
    bool showTcnetConfig = eng.isOutputTcnetEnabled();
    cmbTcnetInterface.setVisible(showTcnetConfig);  lblTcnetInterface.setVisible(showTcnetConfig);
    cmbTcnetLayer.setVisible(showTcnetConfig);      lblTcnetLayer.setVisible(showTcnetConfig);
    sldTcnetOffset.setVisible(showTcnetConfig);     lblTcnetOffset.setVisible(showTcnetConfig);
    sldTcnetGlobalOffset.setVisible(showTcnetConfig); lblTcnetGlobalOffset.setVisible(showTcnetConfig);
    if (showTcnetConfig) repopulateTcnetLayerCombo();

    // Hippotizer output: disabled in this version (pending hardware validation)
    btnHippoOut.setVisible(false);
    txtHippoDestIp.setVisible(false);      lblHippoDestIp.setVisible(false);
    lblHippoOutStatus.setVisible(false);

    // On-air gate: only relevant for ProDJLink
    btnOnAirGate.setVisible(input == SrcType::ProDJLink);

    bool anyDevice = (input != SrcType::SystemTime) || eng.isOutputMtcEnabled() || eng.isOutputArtnetEnabled() || eng.isOutputLtcEnabled() || (eng.isPrimary() && eng.isOutputThruEnabled()) || eng.isOutputLANetTCEnabled();
    btnRefreshDevices.setVisible(anyDevice);

    resized();
    leftContent.repaint();
    rightContent.repaint();

}

void MainComponent::updateStatusLabels()
{
    auto& eng = currentEngine();

    lblInputStatus.setText(eng.getInputStatusText(), juce::dontSendNotification);
    lblInputStatus.setColour(juce::Label::textColourId,
                             eng.isSourceActive() ? getInputColour(eng.getActiveInput()) : textDim);

    // LTC IN user bits: show the recovered value while an LTC source is
    // active, "--" otherwise.  Cheap enough to update every status tick.
    if (eng.getActiveInput() == SrcType::LTC)
    {
        lblLtcInUserBits.setText(
            eng.isSourceActive()
                ? "USER BITS: " + TimecodeEngine::describeUserBits(
                                      eng.getLtcInput().getUserBits(),
                                      eng.getLtcInput().getBinaryGroupFlags())
                : "USER BITS: --",
            juce::dontSendNotification);
    }

    // In the dynamic user-bits modes the output value is computed, not typed,
    // so mirror the live value into the (read-only) field.  Skipped while the
    // field has focus so we never fight the operator mid-edit.
    if (eng.getLtcUserBitsMode() != TimecodeEngine::kUserBitsManual
        && eng.getLtcUserBitsMode() != TimecodeEngine::kUserBitsName
        && txtLtcUserBits.isVisible() && !txtLtcUserBits.hasKeyboardFocus(true))
    {
        auto live = juce::String::toHexString((juce::int64) eng.getEffectiveLtcUserBits())
                        .paddedLeft('0', 8).toUpperCase();
        if (txtLtcUserBits.getText() != live)
            txtLtcUserBits.setText(live, juce::dontSendNotification);
    }

    if (eng.isOutputMtcEnabled() && eng.getMtcOutput().getIsRunning())
        lblOutputMtcStatus.setText(eng.getMtcOutput().isPaused() ? "PAUSED" : eng.getMtcOutStatusText(), juce::dontSendNotification);
    else
        lblOutputMtcStatus.setText(eng.getMtcOutStatusText(), juce::dontSendNotification);

    if (eng.isOutputArtnetEnabled() && eng.getArtnetOutput().getIsRunning())
        lblOutputArtnetStatus.setText(eng.getArtnetOutput().isPaused() ? "PAUSED" : eng.getArtnetOutStatusText(), juce::dontSendNotification);
    else
        lblOutputArtnetStatus.setText(eng.getArtnetOutStatusText(), juce::dontSendNotification);

    if (eng.isOutputLANetTCEnabled() && eng.getLANetTCOutput().getIsRunning())
        lblOutputLANetTCStatus.setText(eng.getLANetTCOutput().isPaused() ? "PAUSED" : eng.getLANetTCOutStatusText(), juce::dontSendNotification);
    else
        lblOutputLANetTCStatus.setText(eng.getLANetTCOutStatusText(), juce::dontSendNotification);

    if (eng.isOutputLtcEnabled())
    {
        if (eng.getLtcOutput().getIsRunning())
            lblOutputLtcStatus.setText(eng.getLtcOutput().isPaused() ? "PAUSED" : eng.getLtcOutStatusText(), juce::dontSendNotification);
        else
            lblOutputLtcStatus.setText(eng.getLtcOutStatusText(), juce::dontSendNotification);
    }

    if (eng.isPrimary() && eng.isOutputThruEnabled())
    {
        juce::String thruStatus = eng.getThruOutStatusText();
        if (eng.getAudioThru() && eng.getAudioThru()->getIsRunning() && eng.getLtcInput().getIsRunning())
        {
            uint32_t under = eng.getLtcInput().getPassthruUnderruns();
            uint32_t over  = eng.getLtcInput().getPassthruOverruns();
            if (under > 0 || over > 0)
                thruStatus += " [XRUNS: " + juce::String(under + over) + "]";

            double inBuf  = (double)eng.getLtcInput().getActualBufferSize();
            double outBuf = (double)eng.getAudioThru()->getActualBufferSize();
            double sr     = eng.getLtcInput().getActualSampleRate();
            if (sr > 0.0)
            {
                double latencyMs = (inBuf + outBuf) / sr * 1000.0;
                if (latencyMs > 10.0)
                    thruStatus += " [LAT: " + juce::String(latencyMs, 1) + "ms]";
            }
        }
        lblOutputThruStatus.setText(thruStatus, juce::dontSendNotification);
    }

    // Generator audio playback status
    if (btnGenAudioOut.getToggleState())
    {
        juce::String s;
        if (eng.isGeneratorAudioRunning())
        {
            if (eng.hasGeneratorAudioFile())
            {
                auto fname = eng.getGeneratorAudioFile().getFileName();
                if (eng.isGeneratorAudioPlaying())
                    s = "PLAYING " + fname;
                else
                    s = "READY " + fname;
            }
            else
            {
                // Check if the currently selected preset has an audio path set
                // but the file is missing on disk -- distinguish from "no file
                // attached to this preset".  When the player has a load error
                // recorded (e.g. unsupported format), surface that instead.
                auto loadErr = eng.getGeneratorAudio().getLoadError();
                if (loadErr.isNotEmpty())
                {
                    s = loadErr;
                }
                else
                {
                    auto presetName = cmbGenPreset.getText();
                    auto* preset = presetName.isNotEmpty() ? settings.generatorPresets.find(presetName) : nullptr;
                    if (preset != nullptr && preset->audioFilePath.isNotEmpty())
                        s = "FILE NOT FOUND: " + juce::File(preset->audioFilePath).getFileName();
                    else
                        s = "DEVICE OPEN (no audio file)";
                }
            }
        }
        else
        {
            s = "DEVICE NOT OPEN";
        }
        lblGenAudioStatus.setText(s, juce::dontSendNotification);
    }
    else
    {
        lblGenAudioStatus.setText({}, juce::dontSendNotification);
    }

    // Hippotizer output status
    if (eng.isOutputHippoEnabled())
    {
        juce::String hippoStatus;
        if (eng.getHippotizerOutput().getIsRunning())
            hippoStatus = eng.getHippotizerOutput().isPaused() ? "PAUSED" : eng.getHippoOutStatusText();
        else
            hippoStatus = eng.getHippoOutStatusText();

        // Append discovery hint if input detected a Hippotizer on the network
        if (eng.getHippotizerInput().isDiscovered())
        {
            auto discName = eng.getHippotizerInput().getDiscoveredName();
            auto discIp   = eng.getHippotizerInput().getDiscoveredIp();
            if (discName.isNotEmpty())
            {
                if (hippoStatus.isNotEmpty()) hippoStatus += " | ";
                hippoStatus += discName + " @ " + discIp;
            }
        }

        lblHippoOutStatus.setText(hippoStatus, juce::dontSendNotification);
    }
    else
    {
        lblHippoOutStatus.setText("", juce::dontSendNotification);
    }

    // Generator transport button highlighting
    if (btnGenPlay.isVisible())
    {
        auto state = eng.getGeneratorState();
        auto activeCol  = juce::Colour(0xFF22AA44);  // green
        auto pauseCol   = juce::Colour(0xFFCC8800);  // amber
        auto defaultCol = juce::Colour(0xFF444444);

        btnGenPlay .setColour(juce::TextButton::buttonColourId,
            state == TimecodeEngine::GeneratorState::Playing ? activeCol : defaultCol);
        btnGenPause.setColour(juce::TextButton::buttonColourId,
            state == TimecodeEngine::GeneratorState::Paused ? pauseCol : defaultCol);
        btnGenStop .setColour(juce::TextButton::buttonColourId,
            state == TimecodeEngine::GeneratorState::Stopped ? juce::Colour(0xFF666666) : defaultCol);
    }

    // Winamp expandable panel info -- only build the string when the panel
    // is actually visible.  Building it unconditionally would do 60 Hz worth
    // of juce::String concatenation for every engine even when Winamp is
    // not the source.
    if (lblWinampInfo.isVisible())
    {
        auto& wi = eng.getWinampInput();
        juce::String text;
        juce::Colour col = textDim;

        if (!wi.getIsRunning())
        {
            text = "(input not started)";
        }
        else if (!wi.isConnected())
        {
            text = "Winamp not running";
        }
        else
        {
            // State prefix
            const char* statePrefix = "STOPPED";
            switch (wi.getState())
            {
                case WinampInput::State::Playing: statePrefix = "PLAYING"; break;
                case WinampInput::State::Paused:  statePrefix = "PAUSED";  break;
                case WinampInput::State::Stopped: break;   // the initial value
            }

            // Track display
            juce::String artist = wi.getArtist();
            juce::String title  = wi.getTitle();
            juce::String track;
            if (title.isNotEmpty())
            {
                if (artist.isNotEmpty())
                    track = artist + " - " + title;
                else
                    track = title;
            }
            else
            {
                track = "(no track)";
            }

            // Position MM:SS / MM:SS
            auto fmt = [](int totalSec) {
                int m = totalSec / 60;
                int s = totalSec % 60;
                return juce::String::formatted("%d:%02d", m, s);
            };
            int posSec = wi.getPositionMs() / 1000;
            int durSec = wi.getDurationSec();
            juce::String pos = fmt(posSec) + " / " + (durSec > 0 ? fmt(durSec) : juce::String("--:--"));

            text = juce::String(statePrefix) + " | " + track + " | " + pos;

            if (wi.getState() == WinampInput::State::Playing)
                col = getInputColour(SrcType::Winamp);
        }

        lblWinampInfo.setText(text, juce::dontSendNotification);
        lblWinampInfo.setColour(juce::Label::textColourId, col);
    }
}

void MainComponent::updateNextCueLabel(TimecodeEngine& eng)
{
    auto info = eng.getNextCueInfo();
    if (!info.valid || info.remainingMs < 0)
    {
        lblNextCue.setText("", juce::dontSendNotification);
        return;
    }

    // Format remaining time as M:SS
    int totalSec = info.remainingMs / 1000;
    int mins = totalSec / 60;
    int secs = totalSec % 60;

    juce::String cueName = info.name.isNotEmpty() ? info.name : "CUE";
    juce::String countdown = juce::String(mins) + ":"
                           + juce::String(secs).paddedLeft('0', 2);

    juce::String text = juce::String::charToString(0x25B6) + " NEXT: "
                      + cueName + " in " + countdown;

    lblNextCue.setText(text, juce::dontSendNotification);

    // Color: amber normally, red when close (< 10s), flash bright on < 3s
    if (totalSec < 3)
        lblNextCue.setColour(juce::Label::textColourId, juce::Colour(0xFFFF4444));
    else if (totalSec < 10)
        lblNextCue.setColour(juce::Label::textColourId, juce::Colour(0xFFFF6600));
    else
        lblNextCue.setColour(juce::Label::textColourId, juce::Colour(0xFFFFAA00));
}

double MainComponent::parseTimecodeToMs(const juce::String& tc, FrameRate fps)
{
    // One parser for every timecode text field (TimecodeCore): drop-frame
    // aware, so the value the engine then displays is the value typed.
    return parseTimecodeTextToMs(tc, fps);
}

juce::String MainComponent::msToTimecodeString(double ms, FrameRate fps)
{
    return msToTimecodeText(ms, fps);
}

void MainComponent::populateGenPresetCombo()
{
    // The selected preset stays selected, by name, if it still exists: the
    // list is rebuilt after every preset edit and after a restore.
    const juce::String selected = cmbGenPreset.getSelectedId() > 0 ? cmbGenPreset.getText() : juce::String();
    cmbGenPreset.clear(juce::dontSendNotification);
    auto presets = settings.generatorPresets.getAllSorted();
    int id = 1;
    for (auto& p : presets)
        cmbGenPreset.addItem(p.name, id++);
    if (selected.isNotEmpty())
        for (int i = 0; i < cmbGenPreset.getNumItems(); ++i)
            if (cmbGenPreset.getItemText(i) == selected)
            {
                cmbGenPreset.setSelectedItemIndex(i, juce::dontSendNotification);
                break;
            }
}

void MainComponent::cycleGenPreset(int direction)
{
    const int num = cmbGenPreset.getNumItems();
    if (num == 0) return;
    const int sel = cmbGenPreset.getSelectedId();

    // Compute the new combo index with wrap-around in both directions.
    // direction < 0 -> previous (wrap to last when at first); else next.
    int newSel;
    if (direction < 0)
        newSel = (sel <= 1) ? num : sel - 1;
    else
        newSel = (sel >= num) ? 1 : sel + 1;

    auto& eng = currentEngine();
    if (eng.isGeneratorAudioPlaying())
    {
        // Hot-swap path (CDJ deck-flip semantics).  The combo's
        // onChange handler routes to loadGenPresetToFields, which
        // deliberately skips setGeneratorAudioFile while audio is
        // playing so that browse-in-the-combo does not interrupt
        // on-air audio.  PREV/NEXT during playback are a different
        // intent -- the operator IS asking to swap tracks -- so we
        // sidestep onChange (dontSendNotification on setSelectedId
        // to keep the combo visually in sync without re-firing it)
        // and call activateGenPreset directly.  activateGenPreset
        // does generatorStop -> setGeneratorAudioFile (which clears
        // any armed loop in the engine because the file changes) ->
        // generatorPlay, so playback continues against the new
        // preset's track from its startMs.
        cmbGenPreset.setSelectedId(newSel, juce::dontSendNotification);
        const juce::String name = cmbGenPreset.getText();
        if (name.isNotEmpty())
            activateGenPreset(name);
    }
    else
    {
        // Idle: keep browse semantics.  setSelectedId with
        // sendNotificationSync triggers cmbGenPreset.onChange, which
        // calls loadGenPresetToFields -- start/stop TC, cuepoints and
        // (because audio is not playing) the audio file all refresh.
        // Playback is NOT started; the operator hits GO / PLAY when
        // ready.
        cmbGenPreset.setSelectedId(newSel, juce::sendNotificationSync);
    }
}

void MainComponent::activateGenPreset(const juce::String& name)
{
    loadGenPresetToFields(name);

    auto& eng = currentEngine();

    // Switch to transport mode if in clock mode
    if (eng.getGeneratorClockMode())
    {
        eng.setGeneratorClockMode(false);
        btnGenClock.setToggleState(false, juce::dontSendNotification);
        updateDeviceSelectorVisibility();
        resized();
    }

    auto fps = eng.getCurrentFps();
    double startMs = parseTimecodeToMs(txtGenStartTC.getText(), fps);
    double stopMs  = parseTimecodeToMs(txtGenStopTC.getText(), fps);

    eng.generatorStop();
    eng.setGeneratorStartMs(startMs);
    eng.setGeneratorStopMs(stopMs);

    // Push the preset's audio file (or empty for "no audio") to the engine.
    // Done after generatorStop() so the previous file (if any) is cleanly
    // released before the new one is loaded.
    if (auto* preset = settings.generatorPresets.find(name))
    {
        juce::File audioFile = preset->audioFilePath.isNotEmpty()
                                 ? juce::File(preset->audioFilePath) : juce::File();
        eng.setGeneratorAudioFile(audioFile, preset->audioLoop);
    }

    eng.generatorPlay();
    saveSettings();
}

void MainComponent::loadGenPresetToFields(const juce::String& name)
{
    auto* preset = settings.generatorPresets.find(name);
    if (!preset) return;

    auto& eng = currentEngine();
    auto fps = eng.getCurrentFps();
    eng.setGeneratorPresetName(preset->name);   // the preset is the track (TCNet metadata, #20)

    // Fill TC editors with normalized values
    juce::String startNorm = msToTimecodeString(parseTimecodeToMs(preset->startTC, fps), fps);
    juce::String stopNorm  = msToTimecodeString(parseTimecodeToMs(preset->stopTC, fps), fps);
    txtGenStartTC.setText(startNorm, false);
    txtGenStopTC.setText(stopNorm, false);

    // Apply to engine (without starting playback).  Audio file handling:
    // if the engine is currently playing audio, we leave it alone -- changing
    // the selection should not interrupt audio that is on air.  But if the
    // engine is idle, we DO push the new audio file so the waveform view
    // immediately reflects the selected preset (and is ready when the user
    // hits GO).
    eng.setGeneratorStartMs(parseTimecodeToMs(preset->startTC, fps));
    eng.setGeneratorStopMs(parseTimecodeToMs(preset->stopTC, fps));
    // Push cue points into the engine so they fire MIDI / OSC / Art-Net
    // triggers when the generated TC reaches each cue's positionTC.
    // setGeneratorCuePoints converts TC -> ms using the engine's current
    // fps, so it must run after setFrameRate / setGeneratorStartMs above.
    eng.setGeneratorCuePoints(preset->cuePoints);

    if (! eng.isGeneratorAudioPlaying())
    {
        juce::File audioFile = preset->audioFilePath.isNotEmpty()
                                 ? juce::File(preset->audioFilePath) : juce::File();
        eng.setGeneratorAudioFile(audioFile, preset->audioLoop);
    }

    saveSettings();
}

void MainComponent::setupOscInputServer()
{
    // Populate network interface combo
    oscInputServer.refreshNetworkInterfaces();
    cmbOscInputInterface.clear(juce::dontSendNotification);
    auto names = oscInputServer.getInterfaceNames();
    for (int i = 0; i < names.size(); ++i)
        cmbOscInputInterface.addItem(names[i], i + 1);
    cmbOscInputInterface.setSelectedId(settings.oscInputInterface + 1, juce::dontSendNotification);

    // The component may be gone by the time a posted message runs (a packet
    // arriving during shutdown), so it is reached through a SafePointer.
    // That SafePointer is made here, once, on the message thread: making one
    // creates the component's shared weak-reference pointer on first use
    // (WeakReference::Master::getSharedPointer), which is not thread-safe,
    // and the listener thread used to make one per packet (AUDIT C11,
    // UI-11).  The listener thread only copies it, which counts a reference
    // atomically.
    juce::Component::SafePointer<MainComponent> safeThis(this);
    oscInputServer.onMessage = [safeThis](const OscInputServer::Message& msg)
    {
        // Listener thread: dispatch on the message thread.
        juce::MessageManager::callAsync([safeThis, msg]()
        {
            if (auto* self = safeThis.getComponent())
                self->handleOscMessage(msg);
        });
    };
}

void MainComponent::handleOscMessage(const OscInputServer::Message& msg)
{
    auto addr = msg.address.trimEnd();

    // Parse engine number: /stc/N/gen/... (N = 1-8, required)
    int targetEngine = -1;
    juce::String cmd;

    if (addr.startsWith("/stc/") && addr.length() > 6)
    {
        auto afterStc = addr.substring(5);  // "N/gen/play"
        int slashPos = afterStc.indexOf("/");
        if (slashPos > 0)
        {
            auto numPart = afterStc.substring(0, slashPos);
            int n = numPart.getIntValue();
            if (n >= 1 && n <= (int)engines.size())
            {
                targetEngine = n - 1;
                cmd = "/stc/" + afterStc.substring(slashPos + 1);  // "/stc/gen/play"
            }
        }
    }

    if (targetEngine < 0 || targetEngine >= (int)engines.size()) return;
    auto& eng = *engines[(size_t)targetEngine];

    // Show Lock does not gate these commands, the configuration ones
    // included (clock, start, stoptime, preset): it guards the panel
    // against a stray click, and OSC IN is the show's own remote control,
    // where loading a preset or setting Start TC is a cue.  OSC IN itself
    // is switched on and set up (port, interface) only while unlocked
    // (AUDIT UI-3).

    // --- Generator commands ---
    if (cmd == "/stc/gen/play")
    {
        eng.generatorPlay();
    }
    else if (cmd == "/stc/gen/pause")
    {
        eng.generatorPause();
    }
    else if (cmd == "/stc/gen/jog")
    {
        float deltaSec = msg.getFloat(0, 0.0f);
        if (deltaSec != 0.0f)
        {
            double newMs = eng.getGeneratorCurrentMs() + (double)deltaSec * 1000.0;
            eng.setGeneratorPosition(newMs);
        }
    }
    else if (cmd == "/stc/gen/stop")
    {
        eng.generatorStop();
    }
    else if (cmd == "/stc/gen/clock")
    {
        int val = msg.getInt(0, -1);
        if (val >= 0)
        {
            eng.setGeneratorClockMode(val != 0);
            if (targetEngine == selectedEngine)
            {
                btnGenClock.setToggleState(eng.getGeneratorClockMode(), juce::dontSendNotification);
                updateDeviceSelectorVisibility();
                resized();
            }
        }
    }
    else if (cmd == "/stc/gen/start")
    {
        auto tc = msg.getString(0);
        if (tc.isNotEmpty())
        {
            double ms = parseTimecodeToMs(tc, eng.getCurrentFps());
            eng.setGeneratorStartMs(ms);
            if (targetEngine == selectedEngine)
                txtGenStartTC.setText(tc, false);
            saveSettings();
        }
    }
    else if (cmd == "/stc/gen/stoptime")
    {
        auto tc = msg.getString(0);
        if (tc.isNotEmpty())
        {
            double ms = parseTimecodeToMs(tc, eng.getCurrentFps());
            eng.setGeneratorStopMs(ms);
            if (targetEngine == selectedEngine)
                txtGenStopTC.setText(tc, false);
            saveSettings();
        }
    }
    else if (cmd == "/stc/gen/preset")
    {
        auto name = msg.getString(0);
        if (name.isNotEmpty())
        {
            auto* preset = settings.generatorPresets.find(name);
            if (preset)
            {
                auto fps = eng.getCurrentFps();
                if (eng.getGeneratorClockMode())
                    eng.setGeneratorClockMode(false);
                eng.generatorStop();
                eng.setGeneratorStartMs(parseTimecodeToMs(preset->startTC, fps));
                eng.setGeneratorStopMs(parseTimecodeToMs(preset->stopTC, fps));
                // Push cue points into the engine (same as the UI
                // applyGeneratorPreset path).  Without this, OSC-
                // triggered preset loads would inherit no cues from
                // the preset.
                eng.setGeneratorCuePoints(preset->cuePoints);

                // Audio file from the preset (empty path = no audio)
                juce::File audioFile = preset->audioFilePath.isNotEmpty()
                                         ? juce::File(preset->audioFilePath) : juce::File();
                eng.setGeneratorAudioFile(audioFile, preset->audioLoop);

                eng.generatorPlay();

                // Update UI if this is the selected engine
                if (targetEngine == selectedEngine)
                {
                    btnGenClock.setToggleState(false, juce::dontSendNotification);
                    txtGenStartTC.setText(preset->startTC, false);
                    txtGenStopTC.setText(preset->stopTC, false);
                    updateDeviceSelectorVisibility();
                    resized();
                }
                saveSettings();
            }
        }
    }
}

void MainComponent::startOscInput()
{
    int port = settings.oscInputPort;
    int iface = settings.oscInputInterface;
    if (oscInputServer.start(port, iface))
    {
        settings.oscInputEnabled = true;
        btnOscIn.setToggleState(true, juce::dontSendNotification);
        int actualId = oscInputServer.getSelectedInterface() + 1;
        cmbOscInputInterface.setSelectedId(actualId, juce::dontSendNotification);
        lblOscInStatus.setText("LISTENING ON " + oscInputServer.getBindInfo(), juce::dontSendNotification);
        lblOscInStatus.setColour(juce::Label::textColourId, juce::Colour(0xFF44CC44));
    }
    else
    {
        btnOscIn.setToggleState(false, juce::dontSendNotification);
        settings.oscInputEnabled = false;
        lblOscInStatus.setText("BIND FAILED - PORT " + juce::String(port), juce::dontSendNotification);
        lblOscInStatus.setColour(juce::Label::textColourId, juce::Colour(0xFFFF4444));
    }
    updateDeviceSelectorVisibility();
    resized();
}

void MainComponent::stopOscInput()
{
    oscInputServer.stop();
    settings.oscInputEnabled = false;
    btnOscIn.setToggleState(false, juce::dontSendNotification);
    lblOscInStatus.setText("", juce::dontSendNotification);
    updateDeviceSelectorVisibility();
    resized();
}

void MainComponent::openGeneratorPresetEditor()
{
    if (genPresetWindow != nullptr)
    {
        pushFpsToGenPresetEditor();
        genPresetWindow->toFront(true);
        return;
    }

    auto* editor = new GeneratorPresetEditor(settings.generatorPresets);

    // Push the engine's current fps so the cue-point editor (when opened
    // from inside this window) can project cue TC onto the audio strip
    // consistently with what the engine's armedCues uses internally.  It
    // is pushed again when the selected engine or its rate changes
    // (pushFpsToGenPresetEditor).
    editor->setCurrentFpsForCueEditor(frameRateToDouble(currentEngine().getCurrentFps()));

    // Live playback cursor for the cue window's waveform strip: the
    // selected engine's generator position in ms from its own Start TC
    // (getGeneratorStartMs), or -1 unless its input is SystemTime and the
    // generator is Playing.  The loaded preset is not checked, so the
    // cursor also moves while the engine plays a preset other than the one
    // whose cues are open.
    editor->setPlayheadGetter([this]() -> int64_t
    {
        auto& eng = currentEngine();
        if (eng.getActiveInput() != SrcType::SystemTime) return -1;
        if (eng.getGeneratorState() != TimecodeEngine::GeneratorState::Playing) return -1;
        // Subtract startMs so the strip's coord space (0 = beginning of
        // audio file) lines up with the engine's running TC.
        const double curMs   = eng.getGeneratorCurrentMs();
        const double startMs = eng.getGeneratorStartMs();
        const double rel     = curMs - startMs;
        if (rel < 0.0) return -1;
        return (int64_t) rel;
    });

    editor->onChange = [this]
    {
        populateGenPresetCombo();
    };

    struct FloatingWindow : juce::DocumentWindow
    {
        FloatingWindow(const juce::String& t, juce::Colour bg)
            : DocumentWindow(t, bg, DocumentWindow::closeButton | DocumentWindow::maximiseButton) {}
        void closeButtonPressed() override { if (onClose) onClose(); delete this; }
        std::function<void()> onClose;
    };

    auto* win = new FloatingWindow("Generator Presets", juce::Colour(0xFF12141A));
    win->setContentOwned(editor, true);
    win->setUsingNativeTitleBar(false);
    win->setTitleBarHeight(20);
    win->setColour(juce::DocumentWindow::textColourId, juce::Colour(0xFF546E7A));
    win->setResizable(true, true);
    win->centreWithSize(editor->getWidth(), editor->getHeight());
    if (settings.genPresetBounds.isNotEmpty())
    {
        auto parts = juce::StringArray::fromTokens(settings.genPresetBounds, " ", "");
        if (parts.size() == 4)
        {
            auto b = juce::Rectangle<int>(parts[0].getIntValue(), parts[1].getIntValue(),
                                           parts[2].getIntValue(), parts[3].getIntValue());
            if (b.getWidth() >= 200 && b.getHeight() >= 150)
            {
                auto c = b.getCentre();
                for (auto& d : juce::Desktop::getInstance().getDisplays().displays)
                    if (d.logicalBounds.contains(c.toFloat())) { win->setBounds(b); break; }
            }
        }
    }
    win->onClose = [this, win]()
    {
        auto b = win->getBounds();
        settings.genPresetBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                 + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        saveSettings();
    };
    win->setVisible(true);
    genPresetWindow = win;
}

void MainComponent::pushFpsToGenPresetEditor()
{
    // The preset editor normalises typed Start/Stop TC and cue positions at
    // the rate it was given; given only when the window opened, it went
    // stale on an engine switch or a rate change (AUDIT SET-8).  Message
    // thread; the cue editor ignores an unchanged rate.
    if (genPresetWindow != nullptr)
        if (auto* ed = dynamic_cast<GeneratorPresetEditor*>(genPresetWindow->getContentComponent()))
            ed->setCurrentFpsForCueEditor(frameRateToDouble(currentEngine().getCurrentFps()));
}

//==============================================================================
void MainComponent::openGeneratorWaveformWindow()
{
    if (genWaveformWindow != nullptr)
    {
        genWaveformWindow->toFront(true);
        return;
    }

    auto* content = new GeneratorWaveformWindow();
    content->setAudioPlayer(&currentEngine().getGeneratorAudio());
    content->setEngine(&currentEngine());
    content->setLockedFn([this] { return isShowLocked(); });

    // PREV / NEXT route through cycleGenPreset so the panel buttons and
    // the waveform-window buttons share one implementation -- including
    // the hot-swap-during-playback behaviour.  See cycleGenPreset for
    // the browse-vs-swap split.
    content->onPrev = [this] { cycleGenPreset(-1); };
    content->onNext = [this] { cycleGenPreset(+1); };
    content->onEdit = [this] {
        // Match the panel's EDIT button: blocked under Show Lock so a
        // distracted operator cannot reshuffle presets mid-show.
        if (isShowLocked()) return;
        openGeneratorPresetEditor();
    };
    content->onVolumeChanged = [this](float v) {
        // Mirror the panel slider so both UIs always agree.  setValue with
        // dontSendNotification avoids re-firing onValueChange and the
        // engine apply (already done by the window's slider directly).
        sldGenAudioVolume.setValue(v, juce::dontSendNotification);
        saveSettings();
    };
    content->onLoopChanged = [this] {
        // Loop In/Out/enabled are persisted as part of the engine state.
        // No mirror UI to update (panel does not show loop controls); the
        // engine setters were already invoked by the window's buttons.
        saveSettings();
    };

    struct FloatingWindow : juce::DocumentWindow
    {
        FloatingWindow(const juce::String& t, juce::Colour bg)
            : DocumentWindow(t, bg, DocumentWindow::closeButton | DocumentWindow::maximiseButton) {}
        void closeButtonPressed() override { if (onClose) onClose(); delete this; }
        std::function<void()> onClose;
    };

    auto* win = new FloatingWindow("Generator Waveform", juce::Colour(0xFF12141A));
    win->setContentOwned(content, true);
    win->setUsingNativeTitleBar(false);
    win->setTitleBarHeight(20);
    win->setColour(juce::DocumentWindow::textColourId, juce::Colour(0xFF546E7A));
    win->setResizable(true, true);
    win->centreWithSize(content->getWidth(), content->getHeight());
    if (settings.genWaveformBounds.isNotEmpty())
    {
        auto parts = juce::StringArray::fromTokens(settings.genWaveformBounds, " ", "");
        if (parts.size() == 4)
        {
            auto b = juce::Rectangle<int>(parts[0].getIntValue(), parts[1].getIntValue(),
                                           parts[2].getIntValue(), parts[3].getIntValue());
            if (b.getWidth() >= 400 && b.getHeight() >= 180)
            {
                auto c = b.getCentre();
                for (auto& d : juce::Desktop::getInstance().getDisplays().displays)
                    if (d.logicalBounds.contains(c.toFloat())) { win->setBounds(b); break; }
            }
        }
    }
    win->onClose = [this, win]()
    {
        auto b = win->getBounds();
        settings.genWaveformBounds = juce::String(b.getX()) + " " + juce::String(b.getY())
                                   + " " + juce::String(b.getWidth()) + " " + juce::String(b.getHeight());
        saveSettings();
    };
    win->setVisible(true);
    genWaveformWindow = win;
}

//==============================================================================
// MINI STRIP -- compact timecode monitors for non-selected engines
//==============================================================================
int MainComponent::getMiniStripHeight() const
{
    if (engines.size() <= 1) return 0;
    return (int)(engines.size() - 1) * kMiniStripRowH + 8;
}

void MainComponent::paintMiniStrip(juce::Graphics& g)
{
    if (engines.size() <= 1) return;

    int rowY = miniStripArea.getY() + 4;
    int centerX = miniStripArea.getCentreX();
    int counterW = juce::jmin(320, miniStripArea.getWidth() - 20);

    for (int i = 0; i < (int)engines.size(); i++)
    {
        if (i == selectedEngine) continue;

        auto& eng = *engines[(size_t)i];
        auto src = eng.getActiveInput();
        auto tc = eng.getCurrentTimecode();
        bool active = eng.isSourceActive();
        juce::Colour srcColour = getInputColour(src);

        int x = centerX - counterW / 2;
        auto rowRect = juce::Rectangle<int>(x, rowY, counterW, kMiniStripRowH - 4);

        // Background
        g.setColour(juce::Colour(0xFF0D0E12).withAlpha(0.8f));
        g.fillRoundedRectangle(rowRect.toFloat(), 4.0f);

        // Border (subtle, source-colored when active)
        g.setColour(active ? srcColour.withAlpha(0.3f) : borderCol);
        g.drawRoundedRectangle(rowRect.toFloat(), 4.0f, 1.0f);

        int innerX = rowRect.getX() + 8;
        int innerY = rowRect.getY();
        int innerH = rowRect.getHeight();

        // Status dot
        juce::Colour dotCol = active ? srcColour : textDim;
        g.setColour(dotCol);
        g.fillEllipse((float)innerX, (float)(innerY + innerH / 2 - 3), 6.0f, 6.0f);
        innerX += 12;

        // Engine name
        g.setFont(juce::Font(juce::FontOptions(getMonoFontName(), 9.0f, juce::Font::bold)));
        g.setColour(active ? textBright : textMid);
        g.drawText(eng.getName(), innerX, innerY, 80, innerH, juce::Justification::centredLeft);
        innerX += 82;

        // Timecode (big monospace) -- use '.' before frames to match main display
        juce::String tcStr = juce::String(tc.hours).paddedLeft('0', 2) + ":"
                           + juce::String(tc.minutes).paddedLeft('0', 2) + ":"
                           + juce::String(tc.seconds).paddedLeft('0', 2) + "."
                           + juce::String(tc.frames).paddedLeft('0', 2);

        g.setFont(juce::Font(juce::FontOptions(getMonoFontName(), 13.0f, juce::Font::bold)));
        g.setColour(active ? juce::Colour(0xFF00E676) : textDim);
        g.drawText(tcStr, innerX, innerY, 120, innerH, juce::Justification::centredLeft);
        innerX += 122;

        // Source type label
        g.setFont(juce::Font(juce::FontOptions(getMonoFontName(), 8.0f, juce::Font::plain)));
        g.setColour(active ? srcColour.withAlpha(0.7f) : textDim.withAlpha(0.5f));
        g.drawText(TimecodeEngine::getInputName(src), innerX, innerY, 50, innerH, juce::Justification::centredLeft);

        rowY += kMiniStripRowH;
    }
}

void MainComponent::mouseDown(const juce::MouseEvent& e)
{
    if (engines.size() <= 1) return;
    if (!miniStripArea.contains(e.getPosition())) return;

    int rowY = miniStripArea.getY() + 4;

    for (int i = 0; i < (int)engines.size(); i++)
    {
        if (i == selectedEngine) continue;

        auto rowRect = juce::Rectangle<int>(miniStripArea.getX(), rowY,
                                             miniStripArea.getWidth(), kMiniStripRowH);
        if (rowRect.contains(e.getPosition()))
        {
            selectEngine(i);
            return;
        }
        rowY += kMiniStripRowH;
    }
}

//==============================================================================
// PAINT
//==============================================================================
void MainComponent::paint(juce::Graphics& g)
{
    if (engines.empty()) return;  // guard: same as resized()

    g.fillAll(bgDark);
    auto bounds = getLocalBounds();
    int panelWidth = juce::jlimit(240, 290, 240 + (getWidth() - 800) / 8);

    // Left panel background
    auto leftPanel = bounds.removeFromLeft(panelWidth);
    g.setColour(bgPanel); g.fillRect(leftPanel);
    g.setColour(borderCol); g.drawLine((float)leftPanel.getRight(), 0.0f, (float)leftPanel.getRight(), (float)getHeight(), 1.0f);
    g.setColour(textDim); g.setFont(juce::Font(juce::FontOptions(getMonoFontName(), 10.0f, juce::Font::bold)));
    g.drawText(">> SOURCE INPUT", leftPanel.withHeight(40).translated(0, kTabBarHeight).reduced(16, 0), juce::Justification::centredLeft);

    // Right panel background
    auto rightPanel = bounds.removeFromRight(panelWidth);
    g.setColour(bgPanel); g.fillRect(rightPanel);
    g.setColour(borderCol); g.drawLine((float)rightPanel.getX(), 0.0f, (float)rightPanel.getX(), (float)getHeight(), 1.0f);
    g.setColour(textDim); g.drawText(">> OUTPUTS", rightPanel.withHeight(40).translated(0, kTabBarHeight).reduced(16, 0), juce::Justification::centredLeft);

    // Tab bar (top of content area)
    g.setColour(bgDarker); g.fillRect(0, 0, getWidth(), kTabBarHeight);
    g.setColour(borderCol); g.drawLine(0.0f, (float)kTabBarHeight, (float)getWidth(), (float)kTabBarHeight, 1.0f);

    // Bottom bar
    int bbH = 24;
    g.setColour(bgDarker); g.fillRect(0, getHeight() - bbH, getWidth(), bbH);
    g.setColour(borderCol); g.drawLine(0.0f, (float)(getHeight() - bbH), (float)getWidth(), (float)(getHeight() - bbH), 1.0f);
    g.setColour(textDim); g.setFont(juce::Font(juce::FontOptions(getMonoFontName(), 9.0f, juce::Font::plain)));
    juce::String verStr = "STC v" + juce::JUCEApplication::getInstance()->getApplicationVersion()
                        + "  |  Fiverecords " + juce::String::charToString(0x00A9) + " 2026";
    g.drawText(verStr,
               juce::Rectangle<int>(10, getHeight() - bbH, 280, bbH), juce::Justification::centredLeft);

    auto& eng = currentEngine();
    juce::String statusText; juce::Colour statusColour;
    if (eng.isSourceActive()) { statusText = TimecodeEngine::getInputName(eng.getActiveInput()) + " ACTIVE"; statusColour = getInputColour(eng.getActiveInput()); }
    else if (eng.isInputStarted()) { statusText = TimecodeEngine::getInputName(eng.getActiveInput()) + " PAUSED"; statusColour = juce::Colour(0xFFFFAB00); }
    else { statusText = TimecodeEngine::getInputName(eng.getActiveInput()) + " STOPPED"; statusColour = textDim; }

    // Show engine name in status if multiple engines
    if (engines.size() > 1)
        statusText = "[" + eng.getName() + "] " + statusText;

    g.setColour(statusColour); g.drawText(statusText, juce::Rectangle<int>(getWidth() - 420, getHeight() - bbH, 270, bbH), juce::Justification::centredRight);

    // Center area: display background + frame rate labels
    auto centerArea = getLocalBounds().reduced(panelWidth, 0);

    // Subtle background for the timecode display area
    {
        auto displayBg = centerArea;
        displayBg.removeFromTop(kTabBarHeight);
        displayBg.removeFromBottom(bbH);
        // Inner panel with very subtle rounded rect
        auto innerBg = displayBg.reduced(8, 4);
        g.setColour(juce::Colour(0xFF0F1116));
        g.fillRoundedRectangle(innerBg.toFloat(), 6.0f);
        // Very subtle border
        g.setColour(juce::Colour(0xFF1A1D24));
        g.drawRoundedRectangle(innerBg.toFloat(), 6.0f, 1.0f);
    }

    // Frame rate labels
    g.setColour(textDim);
    g.setFont(juce::Font(juce::FontOptions(getMonoFontName(), 10.0f, juce::Font::bold)));

    int fpsLabelBase = getHeight() - bbH - (eng.isFpsConvertEnabled() ? 172 : 90);
    g.drawText(eng.isFpsConvertEnabled() ? "INPUT FPS" : "FRAME RATE", centerArea.getX(), fpsLabelBase, centerArea.getWidth(), 14, juce::Justification::centred);

    if (eng.isFpsConvertEnabled())
    {
        g.setColour(accentCyan);
        g.drawText("OUTPUT FPS", centerArea.getX(), fpsLabelBase + 84, centerArea.getWidth(), 14, juce::Justification::centred);
    }

    // Mini timecode strip for non-selected engines
    paintMiniStrip(g);
}

//==============================================================================
// RESIZED
//==============================================================================
void MainComponent::resized()
{
    if (engines.empty()) return;  // guard: resized() can fire before engines are created

    auto bounds = getLocalBounds();
    // Adaptive panel width: 240px at 800w, scales up to 290px at wider windows
    int panelWidth = juce::jlimit(240, 290, 240 + (getWidth() - 800) / 8);
    int topBar = 0, bottomBar = 24;
    int tabBar = kTabBarHeight;

    // ===== TAB BAR (full window width -- the bar sits above the side panels) =====
    {
        int numTabs = (int)tabButtons.size();
        int addBtnW = 30;
        int tabGap = 4;
        int pad = 8;

        // Backup/Restore buttons on the left edge
        int bkBtnW = juce::jlimit(40, 60, (getWidth() - 400) / 10 + 40);
        btnBackup.setBounds(pad, topBar + 2, bkBtnW, tabBar - 4);
        btnRestore.setBounds(pad + bkBtnW + 2, topBar + 2, bkBtnW, tabBar - 4);
        int leftUsed = pad + bkBtnW * 2 + 2 + tabGap * 2;

        // Show Lock button on the right edge -- reserve space
        int lockBtnW = juce::jlimit(70, 90, (getWidth() - 400) / 10 + 70);
        int rightUsed = pad + lockBtnW + tabGap;

        int availableW = getWidth() - leftUsed - rightUsed;
        int addBtnTotal = tabGap + addBtnW;

        int maxTabW = 120;
        int tabW = maxTabW;
        if (numTabs > 0)
        {
            int spaceForTabs = availableW - addBtnTotal - juce::jmax(0, numTabs - 1) * tabGap;
            tabW = juce::jmin(maxTabW, spaceForTabs / numTabs);
            tabW = juce::jmax(50, tabW);
        }

        int totalTabsW = numTabs * tabW + juce::jmax(0, numTabs - 1) * tabGap + addBtnTotal;

        // Center tabs relative to the full window width (not just remaining space)
        int tabX = (getWidth() - totalTabsW) / 2;
        // Clamp so tabs don't overlap backup/restore or show lock buttons
        tabX = juce::jmax(leftUsed, tabX);
        int maxTabRight = getWidth() - rightUsed;
        if (tabX + totalTabsW > maxTabRight)
            tabX = juce::jmax(leftUsed, maxTabRight - totalTabsW);

        for (int i = 0; i < numTabs; i++)
        {
            tabButtons[(size_t)i]->setBounds(tabX, topBar + 2, tabW, tabBar - 4);
            tabX += tabW + tabGap;
        }
        btnAddEngine.setBounds(tabX, topBar + 2, addBtnW, tabBar - 4);

        // Show Lock button on the right edge of the tab bar
        btnShowLock.setBounds(getWidth() - pad - lockBtnW, topBar + 2, lockBtnW, tabBar - 4);
    }

    // ===== LEFT PANEL (scrollable viewport) =====
    auto leftPanelBounds = bounds.removeFromLeft(panelWidth);
    leftPanelBounds.removeFromTop(topBar + tabBar + 40);
    leftPanelBounds.removeFromBottom(bottomBar);
    leftViewport.setBounds(leftPanelBounds);

    int leftContentW = leftPanelBounds.getWidth();
    int leftScrollW = leftViewport.getScrollBarThickness();
    int leftUsableW = leftContentW - leftScrollW;
    auto leftPanel = juce::Rectangle<int>(12, 0, leftUsableW - 24, 10000);

    leftContent.clearSectionSeparators();

    int btnH = 36, btnG = 4;

    auto layCombo = [](juce::Label& l, juce::ComboBox& c, juce::Rectangle<int>& panel) {
        l.setBounds(panel.removeFromTop(14)); panel.removeFromTop(2);
        c.setBounds(panel.removeFromTop(24)); panel.removeFromTop(3);
    };
    auto laySlider = [](juce::Label& l, GainSlider& s, juce::Rectangle<int>& panel) {
        l.setBounds(panel.removeFromTop(14)); panel.removeFromTop(2);
        s.setBounds(panel.removeFromTop(20)); panel.removeFromTop(3);
    };
    auto layMeter = [](LevelMeter& m, juce::Rectangle<int>& panel) {
        m.setBounds(panel.removeFromTop(6)); panel.removeFromTop(3);
    };
    auto layStatus = [](juce::Label& l, juce::Rectangle<int>& panel) {
        l.setBounds(panel.removeFromTop(13)); panel.removeFromTop(4);
    };
    auto layEditor = [](juce::Label& l, juce::TextEditor& e, juce::Rectangle<int>& panel) {
        l.setBounds(panel.removeFromTop(14)); panel.removeFromTop(2);
        e.setBounds(panel.removeFromTop(22)); panel.removeFromTop(3);
    };

    // Input buttons
    auto& eng = currentEngine();
    struct IBI { juce::TextButton* btn; SrcType src; };
    IBI iBtns[] = { {&btnMtcIn,SrcType::MTC}, {&btnArtnetIn,SrcType::ArtNet}, {&btnHippoIn,SrcType::Hippotizer}, {&btnSysTime,SrcType::SystemTime}, {&btnLtcIn,SrcType::LTC}, {&btnProDJLinkIn,SrcType::ProDJLink}, {&btnStageLinQIn,SrcType::StageLinQ}, {&btnWinampIn,SrcType::Winamp}, {&btnLANetTCIn,SrcType::LANetTC} };
    for (auto& ib : iBtns) { if (!ib.btn->isVisible()) continue; ib.btn->setBounds(leftPanel.removeFromTop(btnH)); leftPanel.removeFromTop(btnG); }

    // Section separator after input source buttons
    leftContent.addSectionSeparator(leftPanel.getY());
    leftPanel.removeFromTop(4);

    if (btnCollapseInput.isVisible())
    { leftPanel.removeFromTop(2); btnCollapseInput.setBounds(leftPanel.removeFromTop(18)); leftPanel.removeFromTop(4); }

    if (cmbMidiInputDevice.isVisible()) layCombo(lblMidiInputDevice, cmbMidiInputDevice, leftPanel);
    if (cmbArtnetInputInterface.isVisible()) layCombo(lblArtnetInputInterface, cmbArtnetInputInterface, leftPanel);
    if (cmbHippoInputInterface.isVisible()) layCombo(lblHippoInputInterface, cmbHippoInputInterface, leftPanel);
    if (cmbHippoTcChannel.isVisible()) layCombo(lblHippoTcChannel, cmbHippoTcChannel, leftPanel);
    if (lblWinampInfo.isVisible())
    {
        // Winamp panel: header label (14px) + status / track / position
        // value label (14px), same vertical rhythm as layCombo so the panel
        // sits flush with the other source-config panels.
        lblWinampInfoHeader.setBounds(leftPanel.removeFromTop(14));
        leftPanel.removeFromTop(2);
        lblWinampInfo.setBounds(leftPanel.removeFromTop(14));
        leftPanel.removeFromTop(3);
    }
    if (cmbLANetTCInputInterface.isVisible()) layCombo(lblLANetTCInputInterface, cmbLANetTCInputInterface, leftPanel);
    if (cmbInputFreewheel.isVisible()) layCombo(lblInputFreewheel, cmbInputFreewheel, leftPanel);

    // Generator clock toggle + transport + start/stop TC
    if (btnGenClock.isVisible())
    {
        leftPanel.removeFromTop(3);
        btnGenClock.setBounds(leftPanel.removeFromTop(22));
    }
    if (btnGenPlay.isVisible())
    {
        leftPanel.removeFromTop(3);
        auto transportRow = leftPanel.removeFromTop(24);
        int btnW = (transportRow.getWidth() - 6) / 3;
        btnGenPlay .setBounds(transportRow.removeFromLeft(btnW));
        transportRow.removeFromLeft(3);
        btnGenPause.setBounds(transportRow.removeFromLeft(btnW));
        transportRow.removeFromLeft(3);
        btnGenStop .setBounds(transportRow);

        leftPanel.removeFromTop(4);
        auto startRow = leftPanel.removeFromTop(20);
        lblGenStartTC.setBounds(startRow.removeFromLeft(80));
        txtGenStartTC.setBounds(startRow);

        leftPanel.removeFromTop(3);
        auto stopRow = leftPanel.removeFromTop(20);
        lblGenStopTC.setBounds(stopRow.removeFromLeft(80));
        txtGenStopTC.setBounds(stopRow);

        leftPanel.removeFromTop(4);
        auto presetRow = leftPanel.removeFromTop(22);
        lblGenPreset.setBounds(presetRow.removeFromLeft(50));
        btnGenPresetEdit.setBounds(presetRow.removeFromRight(36));
        presetRow.removeFromRight(3);
        btnGenGo.setBounds(presetRow.removeFromRight(32));
        presetRow.removeFromRight(3);
        btnGenNext.setBounds(presetRow.removeFromRight(22));
        presetRow.removeFromRight(2);
        btnGenPrev.setBounds(presetRow.removeFromRight(22));
        presetRow.removeFromRight(2);
        cmbGenPreset.setBounds(presetRow);
        leftPanel.removeFromTop(3);
    }

    // Generator audio playback toggle + device + channel
    if (btnGenAudioOut.isVisible())
    {
        leftPanel.removeFromTop(2);
        btnGenAudioOut.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
    }
    if (cmbGenAudioDevice.isVisible())
    {
        layCombo(lblGenAudioDevice,  cmbGenAudioDevice,  leftPanel);
        layCombo(lblGenAudioChannel, cmbGenAudioChannel, leftPanel);
    }
    if (cmbGenAudioFileMode.isVisible())
    {
        layCombo(lblGenAudioFileMode, cmbGenAudioFileMode, leftPanel);
    }
    if (sldGenAudioVolume.isVisible())
    {
        // Single-row layout: small label + slider on the right of the same row.
        auto row = leftPanel.removeFromTop(20);
        lblGenAudioVolume.setBounds(row.removeFromLeft(70));
        sldGenAudioVolume.setBounds(row);
        leftPanel.removeFromTop(2);
    }
    if (lblGenAudioStatus.isVisible())
    {
        layStatus(lblGenAudioStatus, leftPanel);
    }
    if (miniWaveform.isVisible())
    {
        leftPanel.removeFromTop(3);
        miniWaveform.setBounds(leftPanel.removeFromTop(48));
        leftPanel.removeFromTop(3);
        btnGenWaveformOpen.setBounds(leftPanel.removeFromTop(20));
        leftPanel.removeFromTop(3);
    }

    // OSC Input toggle + config
    if (btnOscIn.isVisible())
    {
        leftPanel.removeFromTop(2);
        btnOscIn.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
    }
    if (cmbOscInputInterface.isVisible())
    {
        layCombo(lblOscInputInterface, cmbOscInputInterface, leftPanel);
        auto portRow = leftPanel.removeFromTop(20);
        lblOscInPort.setBounds(portRow.removeFromLeft(70));
        txtOscInPort.setBounds(portRow.removeFromLeft(60));
        leftPanel.removeFromTop(2);
    }
    if (lblOscInStatus.isVisible())
    {
        lblOscInStatus.setBounds(leftPanel.removeFromTop(13));
        leftPanel.removeFromTop(3);
    }

    if (cmbProDJLinkInterface.isVisible())
    {
        layCombo(lblProDJLinkInterface, cmbProDJLinkInterface, leftPanel);
    }
    if (cmbPdlBridgeIdentity.isVisible())
    {
        layCombo(lblPdlBridgeIdentity, cmbPdlBridgeIdentity, leftPanel);
    }
    if (cmbPdl95bMode.isVisible())
    {
        layCombo(lblPdl95bMode, cmbPdl95bMode, leftPanel);
    }
    if (cmbStageLinQInterface.isVisible())
    {
        layCombo(lblStageLinQInterface, cmbStageLinQInterface, leftPanel);
    }
    if (cmbProDJLinkPlayer.isVisible())
    {
        layCombo(lblProDJLinkPlayer, cmbProDJLinkPlayer, leftPanel);

        // OFF AIR AT (StageLinQ, ON AIR selected; DESIGN D34)
        if (cmbOnAirQuiet.isVisible())
            layCombo(lblOnAirQuiet, cmbOnAirQuiet, leftPanel);

        // ON-AIR ONLY toggle (gate engine output by DJM on-air flag)
        if (btnOnAirGate.isVisible())
        {
            btnOnAirGate.setBounds(leftPanel.removeFromTop(22));
            leftPanel.removeFromTop(3);
        }

        // BPM Multiplier row (5 equal buttons: 1x x2 x4 /2 /4)
        if (btnBpmOff.isVisible())
        {
            leftContent.addSectionSeparator(leftPanel.getY(), "BPM MULT");
            leftPanel.removeFromTop(16);
            auto bpmRow = leftPanel.removeFromTop(22);
            int gap = 3;
            int bw = (bpmRow.getWidth() - gap * 4) / 5;
            auto placBtn = [&](juce::TextButton& btn)
            {
                btn.setBounds(bpmRow.removeFromLeft(bw));
                bpmRow.removeFromLeft(gap);
            };
            placBtn(btnBpmD4);
            placBtn(btnBpmD2);
            placBtn(btnBpmOff);
            placBtn(btnBpmX2);
            btnBpmX4.setBounds(bpmRow);  // last button takes remaining width
            leftPanel.removeFromTop(3);
            updateBpmMultButtonStates();
        }

        if (artworkDisplay.isVisible())
        {
            // Side-by-side: artwork (56x56) | track info + metadata stacked
            auto artRow = leftPanel.removeFromTop(56);
            artworkDisplay.setBounds(artRow.removeFromLeft(56));
            artRow.removeFromLeft(6);
            // Stack the two text labels in the remaining space
            auto textArea = artRow;
            lblProDJLinkTrackInfo.setBounds(textArea.removeFromTop(20));
            textArea.removeFromTop(2);
            lblProDJLinkMetadata.setBounds(textArea.removeFromTop(20));
            leftPanel.removeFromTop(3);
        }
        else
        {
            if (lblProDJLinkTrackInfo.isVisible())
            { lblProDJLinkTrackInfo.setBounds(leftPanel.removeFromTop(14)); leftPanel.removeFromTop(1); }
            if (lblProDJLinkMetadata.isVisible())
            { lblProDJLinkMetadata.setBounds(leftPanel.removeFromTop(14)); leftPanel.removeFromTop(3); }
        }

        // --- Waveform display ---
        if (waveformDisplay.isVisible())
        {
            auto wfBounds = leftPanel.removeFromTop(48);
            waveformDisplay.setBounds(wfBounds);
            leftPanel.removeFromTop(3);
        }

        // --- Next cue countdown ---
        if (lblNextCue.isVisible())
        {
            lblNextCue.setBounds(leftPanel.removeFromTop(14));
            leftPanel.removeFromTop(2);
        }

        // --- Mixer fader status ---
        if (lblMixerStatus.isVisible())
        {
            lblMixerStatus.setBounds(leftPanel.removeFromTop(13));
            leftPanel.removeFromTop(3);
        }
    }

    // --- TrackMap row (shared by ProDJLink, StageLinQ, and Winamp) ---
    // Lives outside the cmbProDJLinkPlayer.isVisible() block above because
    // Winamp does not have a player combo but does use the same TrackMap.
    // Self-guarded by btnTrackMap.isVisible(), which updateDeviceSelectorVisibility
    // sets based on showTrackMapBtns = (PDL || StageLinQ || Winamp) && expanded.
    if (btnTrackMap.isVisible())
    {
        leftContent.addSectionSeparator(leftPanel.getY());
        leftPanel.removeFromTop(4);

        // Row 1: Action buttons.  For ProDJLink and StageLinQ the row
        // has three columns (TrackMap edit, MixerMap edit, Deck view).
        // For Winamp only TrackMap edit is visible -- Winamp has no
        // mixer protocol and no per-deck view -- so we give that one
        // button the whole row instead of laying it out at a third of
        // the width with two visually empty columns beside it.
        auto btnRow = leftPanel.removeFromTop(22);
        if (eng.getActiveInput() == SrcType::Winamp)
        {
            btnTrackMapEdit.setBounds(btnRow);
        }
        else
        {
            int thirdW = (btnRow.getWidth() - 8) / 3;
            btnTrackMapEdit.setBounds(btnRow.removeFromLeft(thirdW));
            btnRow.removeFromLeft(4);
            btnMixerMapEdit.setBounds(btnRow.removeFromLeft(thirdW));
            btnRow.removeFromLeft(4);
            btnProDJLinkView.setBounds(btnRow);
            btnStageLinQView.setBounds(btnRow);  // same slot, only one is visible
        }
        leftPanel.removeFromTop(3);

        // Row 2: TrackMap toggle (full width)
        btnTrackMap.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
    }

    // === Feature sections (shared: work for ProDJLink AND Audio BPM) ===

    // --- Audio BPM toggle (non-DJ sources only) ---
    bool bpmDriven = btnAudioBpm.getToggleState() && eng.getActiveInput() != SrcType::LTC;
    bool bpmInline = btnAudioBpm.isVisible() && btnAudioBpm.getToggleState();  // BPM outputs go inline

    if (btnAudioBpm.isVisible())
    {
        leftContent.addSectionSeparator(leftPanel.getY(), "AUDIO BPM");
        leftPanel.removeFromTop(16);
        btnAudioBpm.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);

        // BPM value display + beat LED (same row)
        if (lblBpmValue.isVisible())
        {
            auto bpmRow = leftPanel.removeFromTop(24);
            ledBeat.setBounds(bpmRow.removeFromLeft(20).reduced(2));
            bpmRow.removeFromLeft(2);
            lblBpmValue.setBounds(bpmRow);
            leftPanel.removeFromTop(3);
        }

        if (sldBpmSmoothing.isVisible())
            laySlider(lblBpmSmoothing, sldBpmSmoothing, leftPanel);
        // When LTC is the source, Audio BPM has its own separate device/channel controls
        if (cmbAudioBpmDevice.isVisible())
        {
            layCombo(lblAudioBpmDevice, cmbAudioBpmDevice, leftPanel);
            layCombo(lblAudioBpmChannel, cmbAudioBpmChannel, leftPanel);
            if (sldBpmInputGain.isVisible())
                laySlider(lblBpmInputGain, sldBpmInputGain, leftPanel);
            if (mtrAudioBpm.isVisible()) layMeter(mtrAudioBpm, leftPanel);
        }
    }

    // Shared audio device layout block (used by both LTC and Audio BPM)
    auto layAudioInputSettings = [&]()
    {
        layCombo(lblAudioInputTypeFilter, cmbAudioInputTypeFilter, leftPanel);
        if (cmbSampleRate.isVisible())
        {
            lblSampleRate.setBounds(leftPanel.removeFromTop(14)); leftPanel.removeFromTop(2);
            auto srRow = leftPanel.removeFromTop(24);
            cmbSampleRate.setBounds(srRow.removeFromLeft(srRow.getWidth() / 2 - 2));
            srRow.removeFromLeft(4);
            cmbBufferSize.setBounds(srRow);
            leftPanel.removeFromTop(3);
            lblBufferSize.setBounds(0, 0, 0, 0);
        }
        layCombo(lblAudioInputDevice, cmbAudioInputDevice, leftPanel);
        layCombo(lblAudioInputChannel, cmbAudioInputChannel, leftPanel);
        laySlider(lblLtcInputGain, sldLtcInputGain, leftPanel);
        if (mtrLtcInput.isVisible()) layMeter(mtrLtcInput, leftPanel);
        if (cmbThruInputChannel.isVisible())
        {
            layCombo(lblThruInputChannel, cmbThruInputChannel, leftPanel);
            laySlider(lblThruInputGain, sldThruInputGain, leftPanel);
            if (mtrThruInput.isVisible()) layMeter(mtrThruInput, leftPanel);
        }
    };

    // When Audio BPM is active (non-LTC), audio settings go right here after the toggle
    if (bpmDriven && cmbAudioInputDevice.isVisible())
        layAudioInputSettings();

    // BPM output toggles inline (MIDI Clock, OSC Tempo, Link) — after audio settings
    if (bpmInline)
    {
        if (btnMidiClock.isVisible())
        {
            btnMidiClock.setBounds(leftPanel.removeFromTop(22));
            leftPanel.removeFromTop(3);
        }
        if (btnOscFwdBpm.isVisible())
        {
            btnOscFwdBpm.setBounds(leftPanel.removeFromTop(22));
            if (edOscFwdBpmAddr.isVisible())
            {
                leftPanel.removeFromTop(2);
                auto bpmAddrRow = leftPanel.removeFromTop(22);
                lblOscFwdBpmAddr.setBounds(bpmAddrRow.removeFromLeft(40));
                bpmAddrRow.removeFromLeft(2);
                edOscFwdBpmAddr.setBounds(bpmAddrRow);

                leftPanel.removeFromTop(2);
                auto cmdRow = leftPanel.removeFromTop(22);
                lblOscFwdBpmCmd.setBounds(cmdRow.removeFromLeft(40));
                cmdRow.removeFromLeft(2);
                edOscFwdBpmCmd.setBounds(cmdRow);
            }
            if (edOscIp.isVisible())
            {
                leftPanel.removeFromTop(2);
                auto oscConfRow = leftPanel.removeFromTop(22);
                edOscIp.setBounds(oscConfRow.removeFromLeft(oscConfRow.getWidth() - 58));
                oscConfRow.removeFromLeft(4);
                edOscPort.setBounds(oscConfRow);
            }
            leftPanel.removeFromTop(3);
        }
        if (btnLink.isVisible())
        {
            btnLink.setBounds(leftPanel.removeFromTop(22));
            if (lblLinkStatus.isVisible())
            {
                leftPanel.removeFromTop(2);
                lblLinkStatus.setBounds(leftPanel.removeFromTop(13));
            }
            leftPanel.removeFromTop(3);
        }
    }

    // --- MIDI section (skip BPM-only toggles already placed inline) ---
    bool hasMidiSection = (!bpmInline && btnMidiClock.isVisible())
                       || btnMidiMixerFwd.isVisible()
                       || btnTriggerMidi.isVisible()
                       || cmbTriggerMidiDevice.isVisible();
    if (hasMidiSection)
    {
        leftContent.addSectionSeparator(leftPanel.getY(), "MIDI");
        leftPanel.removeFromTop(16);
    }
    if (!bpmInline && btnMidiClock.isVisible())
    {
        btnMidiClock.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
    }
    if (btnMidiMixerFwd.isVisible())
    {
        btnMidiMixerFwd.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
        if (cmbMidiMixCCCh.isVisible())
        {
            auto chRow = leftPanel.removeFromTop(22);
            int halfW = (chRow.getWidth() - 4) / 2;
            lblMidiMixCCCh.setBounds(chRow.removeFromLeft(42));
            cmbMidiMixCCCh.setBounds(chRow.removeFromLeft(halfW - 42));
            chRow.removeFromLeft(4);
            lblMidiMixNoteCh.setBounds(chRow.removeFromLeft(52));
            cmbMidiMixNoteCh.setBounds(chRow);
            leftPanel.removeFromTop(3);
        }
    }
    if (btnTriggerMidi.isVisible())
    {
        btnTriggerMidi.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
    }
    if (cmbTriggerMidiDevice.isVisible())
    {
        cmbTriggerMidiDevice.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
    }

    // --- OSC section (skip BPM toggle already placed inline) ---
    bool hasOscSection = (!bpmInline && btnOscFwdBpm.isVisible())
                      || btnOscMixerFwd.isVisible()
                      || btnTriggerOsc.isVisible();
    if (hasOscSection)
    {
        leftContent.addSectionSeparator(leftPanel.getY(), "OSC");
        leftPanel.removeFromTop(16);
    }
    if (!bpmInline && btnOscFwdBpm.isVisible())
    {
        btnOscFwdBpm.setBounds(leftPanel.removeFromTop(22));
        if (edOscFwdBpmAddr.isVisible())
        {
            leftPanel.removeFromTop(2);
            auto bpmRow = leftPanel.removeFromTop(22);
            lblOscFwdBpmAddr.setBounds(bpmRow.removeFromLeft(40));
            bpmRow.removeFromLeft(2);
            edOscFwdBpmAddr.setBounds(bpmRow);

            leftPanel.removeFromTop(2);
            auto cmdRow = leftPanel.removeFromTop(22);
            lblOscFwdBpmCmd.setBounds(cmdRow.removeFromLeft(40));
            cmdRow.removeFromLeft(2);
            edOscFwdBpmCmd.setBounds(cmdRow);
        }
        leftPanel.removeFromTop(3);
    }
    if (btnOscMixerFwd.isVisible())
    {
        btnOscMixerFwd.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
    }
    if (btnTriggerOsc.isVisible())
    {
        btnTriggerOsc.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
    }
    if (!bpmInline && edOscIp.isVisible())
    {
        auto oscConfRow = leftPanel.removeFromTop(22);
        edOscIp.setBounds(oscConfRow.removeFromLeft(oscConfRow.getWidth() - 58));
        oscConfRow.removeFromLeft(4);
        edOscPort.setBounds(oscConfRow);
        leftPanel.removeFromTop(3);
    }

    // --- ART-NET DMX section ---
    if (btnArtnetMixerFwd.isVisible() || btnArtnetTrigger.isVisible())
    {
        leftContent.addSectionSeparator(leftPanel.getY(), "ART-NET DMX");
        leftPanel.removeFromTop(16);
    }
    if (btnArtnetMixerFwd.isVisible())
    {
        btnArtnetMixerFwd.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
        if (cmbArtMixNet.isVisible())
        {
            auto addrRow = leftPanel.removeFromTop(22);
            lblArtMixAddr.setBounds(addrRow.removeFromLeft(48));
            addrRow.removeFromLeft(2);
            int cmbW = (addrRow.getWidth() - 4) / 3;
            cmbArtMixNet.setBounds(addrRow.removeFromLeft(cmbW));
            addrRow.removeFromLeft(2);
            cmbArtMixSub.setBounds(addrRow.removeFromLeft(cmbW));
            addrRow.removeFromLeft(2);
            cmbArtMixUni.setBounds(addrRow);
            leftPanel.removeFromTop(3);
        }
    }
    if (btnArtnetTrigger.isVisible())
    {
        btnArtnetTrigger.setBounds(leftPanel.removeFromTop(22));
        leftPanel.removeFromTop(3);
        if (cmbArtTrigNet.isVisible())
        {
            auto addrRow = leftPanel.removeFromTop(22);
            lblArtTrigAddr.setBounds(addrRow.removeFromLeft(48));
            addrRow.removeFromLeft(2);
            int cmbW = (addrRow.getWidth() - 4) / 3;
            cmbArtTrigNet.setBounds(addrRow.removeFromLeft(cmbW));
            addrRow.removeFromLeft(2);
            cmbArtTrigSub.setBounds(addrRow.removeFromLeft(cmbW));
            addrRow.removeFromLeft(2);
            cmbArtTrigUni.setBounds(addrRow);
            leftPanel.removeFromTop(3);
        }
    }
    if (cmbArtnetDmxInterface.isVisible())
        layCombo(lblArtnetDmxInterface, cmbArtnetDmxInterface, leftPanel);

    // --- Ableton Link (skip when already placed inline in Audio BPM section) ---
    if (!bpmInline && btnLink.isVisible())
    {
        leftContent.addSectionSeparator(leftPanel.getY(), "ABLETON LINK");
        leftPanel.removeFromTop(16);
        btnLink.setBounds(leftPanel.removeFromTop(22));
        if (lblLinkStatus.isVisible())
        {
            leftPanel.removeFromTop(2);
            lblLinkStatus.setBounds(leftPanel.removeFromTop(13));
        }
        leftPanel.removeFromTop(3);
    }

    // AUDIO SETTINGS: only rendered here for LTC (Audio BPM renders it inline above)
    if (!bpmDriven && cmbAudioInputDevice.isVisible())
    {
        leftContent.addSectionSeparator(leftPanel.getY(), "AUDIO SETTINGS");
        leftPanel.removeFromTop(16);
        layAudioInputSettings();
    }

    lblInputStatus.setBounds(leftPanel.removeFromTop(14));
    if (lblLtcInUserBits.isVisible())
    { leftPanel.removeFromTop(2); lblLtcInUserBits.setBounds(leftPanel.removeFromTop(12)); }

    // Set content height for left panel scrolling
    int leftUsedHeight = leftPanel.getY() + 8;
    leftContent.setSize(leftContentW, juce::jmax(leftPanelBounds.getHeight(), leftUsedHeight));

    // ===== RIGHT PANEL =====
    auto rightPanelBounds = bounds.removeFromRight(panelWidth);
    rightPanelBounds.removeFromTop(topBar + tabBar + 40);
    rightPanelBounds.removeFromBottom(bottomBar);
    rightViewport.setBounds(rightPanelBounds);

    int contentW = rightPanelBounds.getWidth();
    int scrollW = rightViewport.getScrollBarThickness();
    int usableW = contentW - scrollW;
    auto rp = juce::Rectangle<int>(12, 0, usableW - 24, 10000);
    int colBtnW = 26;

    rightContent.clearSectionSeparators();

    // MTC OUT
    {
        auto row = rp.removeFromTop(btnH);
        if (btnCollapseMtcOut.isVisible()) { btnCollapseMtcOut.setBounds(row.removeFromRight(colBtnW)); row.removeFromRight(3); }
        btnMtcOut.setBounds(row); rp.removeFromTop(2);
        if (cmbMidiOutputDevice.isVisible()) layCombo(lblMidiOutputDevice, cmbMidiOutputDevice, rp);
        if (sldMtcOffset.isVisible()) laySlider(lblMtcOffset, sldMtcOffset, rp);
        if (lblOutputMtcStatus.isVisible()) layStatus(lblOutputMtcStatus, rp);
        rp.removeFromTop(2);
    }

    rightContent.addSectionSeparator(rp.getY());
    rp.removeFromTop(4);

    // ART-NET OUT
    {
        auto row = rp.removeFromTop(btnH);
        if (btnCollapseArtnetOut.isVisible()) { btnCollapseArtnetOut.setBounds(row.removeFromRight(colBtnW)); row.removeFromRight(3); }
        btnArtnetOut.setBounds(row); rp.removeFromTop(2);
        if (cmbArtnetOutputInterface.isVisible()) layCombo(lblArtnetOutputInterface, cmbArtnetOutputInterface, rp);
        if (sldArtnetOffset.isVisible()) laySlider(lblArtnetOffset, sldArtnetOffset, rp);
        if (lblOutputArtnetStatus.isVisible()) layStatus(lblOutputArtnetStatus, rp);
        rp.removeFromTop(2);
    }

    // Shared audio driver filter
    if (cmbAudioOutputTypeFilter.isVisible())
    {
        rightContent.addSectionSeparator(rp.getY());
        rp.removeFromTop(4);
        layCombo(lblAudioOutputTypeFilter, cmbAudioOutputTypeFilter, rp);
    }
    else
    {
        rightContent.addSectionSeparator(rp.getY());
        rp.removeFromTop(4);
    }

    // LTC OUT
    {
        auto row = rp.removeFromTop(btnH);
        if (btnCollapseLtcOut.isVisible()) { btnCollapseLtcOut.setBounds(row.removeFromRight(colBtnW)); row.removeFromRight(3); }
        btnLtcOut.setBounds(row); rp.removeFromTop(2);
        if (cmbAudioOutputDevice.isVisible())
        {
            layCombo(lblAudioOutputDevice, cmbAudioOutputDevice, rp);
            layCombo(lblAudioOutputChannel, cmbAudioOutputChannel, rp);
            if (cmbSampleRateOut.isVisible()) layCombo(lblSampleRateOut, cmbSampleRateOut, rp);
            if (cmbBufferSizeOut.isVisible()) layCombo(lblBufferSizeOut, cmbBufferSizeOut, rp);
            laySlider(lblLtcOutputGain, sldLtcOutputGain, rp);
            if (btnLtcHoldOnPause.isVisible()) btnLtcHoldOnPause.setBounds(rp.removeFromTop(22));
            if (mtrLtcOutput.isVisible()) layMeter(mtrLtcOutput, rp);
            if (sldLtcOffset.isVisible()) laySlider(lblLtcOffset, sldLtcOffset, rp);
            if (cmbLtcUserBitsMode.isVisible()) layCombo(lblLtcUserBitsMode, cmbLtcUserBitsMode, rp);
            if (txtLtcUserBits.isVisible()) layEditor(lblLtcUserBits, txtLtcUserBits, rp);
            if (btnLtcUserBitsReverse.isVisible()) btnLtcUserBitsReverse.setBounds(rp.removeFromTop(22));
        }
        if (lblOutputLtcStatus.isVisible()) layStatus(lblOutputLtcStatus, rp);
        rp.removeFromTop(2);
    }

    // TCNET OUT
    {
        rightContent.addSectionSeparator(rp.getY());
        rp.removeFromTop(4);
        auto row = rp.removeFromTop(btnH);
        btnTcnetOut.setBounds(row); rp.removeFromTop(2);
        if (cmbTcnetInterface.isVisible()) layCombo(lblTcnetInterface, cmbTcnetInterface, rp);
        if (cmbTcnetLayer.isVisible()) layCombo(lblTcnetLayer, cmbTcnetLayer, rp);
        if (sldTcnetOffset.isVisible()) laySlider(lblTcnetOffset, sldTcnetOffset, rp);
        if (sldTcnetGlobalOffset.isVisible()) laySlider(lblTcnetGlobalOffset, sldTcnetGlobalOffset, rp);
        rp.removeFromTop(2);
    }

    // AUDIO THRU (primary engine only)
    if (btnThruOut.isVisible())
    {
        rightContent.addSectionSeparator(rp.getY());
        rp.removeFromTop(4);

        auto row = rp.removeFromTop(btnH);
        if (btnCollapseThruOut.isVisible()) { btnCollapseThruOut.setBounds(row.removeFromRight(colBtnW)); row.removeFromRight(3); }
        btnThruOut.setBounds(row); rp.removeFromTop(2);
        if (cmbThruOutputDevice.isVisible())
        {
            layCombo(lblThruOutputDevice, cmbThruOutputDevice, rp);
            layCombo(lblThruOutputChannel, cmbThruOutputChannel, rp);
            laySlider(lblThruOutputGain, sldThruOutputGain, rp);
            if (mtrThruOutput.isVisible()) layMeter(mtrThruOutput, rp);
        }
        if (lblOutputThruStatus.isVisible()) layStatus(lblOutputThruStatus, rp);
        rp.removeFromTop(2);
    }

    // LaserAnimation Net-Timecode OUT
    {
        auto row = rp.removeFromTop(btnH);
        if (btnCollapseLANetTCOut.isVisible()) { btnCollapseLANetTCOut.setBounds(row.removeFromRight(colBtnW)); row.removeFromRight(3); }
        btnLANetTCOut.setBounds(row); rp.removeFromTop(2);
        if (cmbLANetTCOutputInterface.isVisible()) layCombo(lblLANetTCOutputInterface, cmbLANetTCOutputInterface, rp);
        if (sldLANetTCOffset.isVisible()) laySlider(lblLANetTCOffset, sldLANetTCOffset, rp);
        if (lblOutputLANetTCStatus.isVisible()) layStatus(lblOutputLANetTCStatus, rp);
        rp.removeFromTop(2);
    }

    if (btnRefreshDevices.isVisible())
    { rp.removeFromTop(4); btnRefreshDevices.setBounds(rp.removeFromTop(26)); }

    int usedHeight = rp.getY() + 8;
    rightContent.setSize(contentW, juce::jmax(rightPanelBounds.getHeight(), usedHeight));

    // ===== CENTER =====
    auto centerArea = bounds;
    centerArea.removeFromTop(topBar + tabBar);
    centerArea.removeFromBottom(bottomBar);

    auto fpsArea = centerArea.removeFromBottom(eng.isFpsConvertEnabled() ? 186 : 100);

    // Mini strip for non-selected engines (between display and FPS)
    int miniH = getMiniStripHeight();
    if (miniH > 0)
    {
        miniStripArea = juce::Rectangle<int>(centerArea.getX(), centerArea.getBottom() - miniH,
                                              centerArea.getWidth(), miniH);
        centerArea.removeFromBottom(miniH);
    }
    else
    {
        miniStripArea = {};
    }
    fpsArea.removeFromTop(20);
    int fpsBW = 58, fpsGap = 6, totalW = fpsBW * 5 + fpsGap * 4;
    int fpsX = fpsArea.getCentreX() - totalW / 2, fpsY = fpsArea.getY() + 10;
    juce::TextButton* fB[] = {&btnFps2398,&btnFps24,&btnFps25,&btnFps2997,&btnFps30};
    FrameRate fV[] = {FrameRate::FPS_2398,FrameRate::FPS_24,FrameRate::FPS_25,FrameRate::FPS_2997,FrameRate::FPS_30};
    for (int i = 0; i < 5; i++) { fB[i]->setBounds(fpsX + i * (fpsBW + fpsGap), fpsY, fpsBW, 32); styleFpsButton(*fB[i], eng.getCurrentFps() == fV[i]); }

    int toggleW = 140, toggleH = 24;
    int toggleY = fpsY + 32 + 6;
    btnFpsConvert.setBounds(fpsArea.getCentreX() - toggleW / 2, toggleY, toggleW, toggleH);

    juce::TextButton* oB[] = {&btnOutFps2398,&btnOutFps24,&btnOutFps25,&btnOutFps2997,&btnOutFps30};
    FrameRate effectiveOut = eng.getEffectiveOutputFps();
    if (eng.isFpsConvertEnabled())
    {
        int outLabelY = toggleY + toggleH + 6;
        int outFpsY   = outLabelY + 14 + 6;
        for (int i = 0; i < 5; i++) { oB[i]->setBounds(fpsX + i * (fpsBW + fpsGap), outFpsY, fpsBW, 32); styleFpsButton(*oB[i], effectiveOut == fV[i]); oB[i]->setVisible(true); }
    }
    else
    {
        for (int i = 0; i < 5; i++) oB[i]->setVisible(false);
    }

    timecodeDisplay.setBounds(centerArea);
    btnGitHub.setBounds(getWidth() / 2 - 160, getHeight() - bottomBar, 320, bottomBar);
    btnCheckUpdates.setBounds(getWidth() - 145, getHeight() - bottomBar, 140, bottomBar);

    // Update notification -- replaces check button in bottom bar
    if (btnUpdateAvailable.isVisible())
        btnUpdateAvailable.setBounds(getWidth() - 245, getHeight() - bottomBar, 240, bottomBar);
}

//==============================================================================
// TIMER
//==============================================================================
void MainComponent::timerCallback()
{
    if (engines.empty()) return;  // guard

    // Show Lock flash feedback: reset button color after countdown
    if (showLockFlashCountdown > 0)
    {
        if (--showLockFlashCountdown == 0)
        {
            btnShowLock.setColour(juce::TextButton::buttonColourId,
                                  juce::Colour(0xFFCC2222));  // back to normal locked red
        }
    }

    // Tick ALL engines (not just selected).
    // NOTE: tick() feeds timecode values to the output protocol handlers.
    // MTC and ArtNet and LA Net-Timecode outputs use their own HighResolutionTimers (1ms) for
    // actual transmission timing, so the 60Hz UI timer only updates the
    // target timecode -- it does NOT limit output precision.  LTC output
    // uses its own audio-callback-driven auto-increment, so it's similarly
    // decoupled.  If UI stalls (resize, modal dialog), outputs continue
    // transmitting the last-known timecode until the next tick() updates it.
    for (int i = 0; i < (int)engines.size(); ++i)
    {
        engines[(size_t)i]->setStatusTextVisible(i == selectedEngine);
        engines[(size_t)i]->tick();
    }

    // Feed TCNet output layers from engines.
    // Each engine selects its target layer (1-4) via tcnetLayer.
    // Clear all layers first, then fill from enabled engines (last-write-wins if
    // two engines target the same layer).
    if (sharedTcnetOutput.getIsRunning())
    {
        // Track which layers are assigned by enabled engines
        bool layerUsed[TCNetOutput::kMaxLayers] = {};

        for (int i = 0; i < (int)engines.size(); ++i)
        {
            auto& eng = *engines[(size_t)i];
            if (!eng.isOutputTcnetEnabled()) continue;

            int layer = eng.getTcnetLayer();  // 0-3, user-configured per engine

            auto src = eng.getActiveInput();
            int ep = eng.getEffectivePlayer();

            // Layer assignment: respect the user's per-engine UI choice
            // (cmbTcnetLayer combobox, value 1-4). The user knows their setup
            // best -- they can pick distinct layers for distinct engines so
            // they don't collide. We DO NOT override the layer based on the
            // current source; switching ProDJLink<->Generator on the same
            // engine keeps the same Layer ID, which means MagicQ sees a
            // continuous identity instead of the master jumping around.
            //
            // SyncMaster is computed below from the actual source so that
            // LayerID == SyncMaster (the MagicQ coherence check) holds:
            //   - DJ source: SyncMaster = layer + 1 (matches the chosen layer)
            //   - Non-DJ source: SyncMaster = layer + 1 (engine is its own master)
            layerUsed[layer] = true;

            // Fader for Resolume opacity: real DJM/Denon fader value, 255 for non-DJ sources
            uint8_t onAirFader = 255;
            uint8_t beatInBar = 0;
            uint32_t beatNumber = 0;
            uint32_t durationMs = 0;
            uint32_t bpm100 = 0;

            if (src == SrcType::ProDJLink && sharedProDJLinkInput.getIsRunning())
            {
                if (sharedProDJLinkInput.hasMixerFaderData())
                    onAirFader = sharedProDJLinkInput.getChannelFader(ep);
                beatInBar = sharedProDJLinkInput.getBeatInBar(ep);
                beatNumber = sharedProDJLinkInput.getBeatCount(ep);
                bpm100 = bpmToTimes100(sharedProDJLinkInput.getBPM(ep));
            }
            else if (src == SrcType::StageLinQ && sharedStageLinQInput.getIsRunning())
            {
                if (sharedStageLinQInput.hasMixerData())
                {
                    double faderPos = sharedStageLinQInput.getFaderPosition(ep);
                    onAirFader = (uint8_t)juce::jlimit(0, 255, (int)(faderPos * 255.0));
                }
                beatInBar = sharedStageLinQInput.getBeatInBar(ep);
                bpm100 = bpmToTimes100(sharedStageLinQInput.getBPM(ep));
            }

            // Fallback: for non-DJ sources (MTC / Art-Net / LTC / Generator /
            // HippoNet), if the user has the audio BPM analyser running on
            // this engine, send its detected BPM. Consoles like ChamSys read
            // BPM from TCNet; Resolume ignores it so this is side-effect-free
            // for existing setups. We deliberately don't fall back to audio
            // BPM when src is a DJ source -- a CDJ reporting BPM=0 (paused,
            // no track) should not be papered over with the audio analyser.
            if (src != SrcType::ProDJLink && src != SrcType::StageLinQ
                && eng.hasAudioBpm())
                bpm100 = bpmToTimes100(eng.getAudioBpm());

            // Synthesize beat marker and beat number from playhead + BPM when
            // we don't have native beat info from a CDJ:
            //  - For Pro DJ Link, the CDJ supplies both beatInBar and
            //    beatCount directly, but only when it's actually sending
            //    status packets. Use beatCount (beatNumber) as the signal
            //    that we have real data: beatCount starts at 0 and only
            //    advances on real CDJ packets. beatInBar has a default of
            //    1 even without a connected CDJ, so it can't be trusted
            //    as a "we have real data" check on its own.
            //  - For StageLinQ, beatInBar comes from the deck but there's
            //    no beatCount exposed -- synthesize beatNumber only.
            //  - For non-DJ sources with audio BPM detected (Generator, MTC,
            //    Art-Net, LTC), neither is available; synthesize both.
            //
            // Assumes 4/4 time with the first beat at playhead = 0. This won't
            // align perfectly to the underlying audio (we have no reference)
            // but gives consoles a steady beat pulse to drive effects from.
            const bool haveNativeBeat = (src == SrcType::ProDJLink) && (beatNumber != 0);
            uint32_t playheadForBeat = eng.getSmoothedPlayheadMs();
            if (playheadForBeat == 0)
            {
                // getSmoothedPlayheadMs() only returns a value for DJ sources.
                // For Generator / MTC / Art-Net / LTC, fall back to deriving
                // the playhead from the engine's output timecode, through
                // TimecodeCore (AUDIT C1, DESIGN D13): drop-frame and 23.976
                // aware.  The linear H:M:S:F sum it replaces jumped 66 ms
                // forward at every dropped-frame minute at 29.97 DF, and
                // mixed nominal seconds with real frames at 23.976.
                const double ms = timecodeToMs(eng.getOutputTimecode(), eng.getEffectiveOutputFps());
                playheadForBeat = (uint32_t) juce::jlimit(0.0, 4294967295.0, ms);
            }
            if (bpm100 > 0 && !haveNativeBeat)
            {
                // Anchor-based beat counter. Computing beats as
                // (playhead * bpm) / 60000 directly works but is extremely
                // sensitive to tiny BPM jitter when the playhead is large
                // (a 2-hour playhead with ±0.5 BPM jitter swings beatIdx
                // by thousands, producing random-looking beat marker
                // values). Instead we anchor at the first call and count
                // beats as (elapsed_ms * bpm) / 60000 from that anchor --
                // small BPM changes only affect rate, not absolute position.
                auto& st = tcnetBeatState[layer];
                if (!st.valid || playheadForBeat < st.anchorPlayheadMs)
                {
                    // First call on this layer, or playhead went backwards
                    // (seek/loop). Re-anchor and emit beat 1.
                    st.anchorPlayheadMs = playheadForBeat;
                    st.beatAccum = 0.0;
                    st.valid = true;
                }
                else
                {
                    uint32_t deltaMs = playheadForBeat - st.anchorPlayheadMs;
                    st.anchorPlayheadMs = playheadForBeat;
                    st.beatAccum += (double)deltaMs * (double)bpm100
                                  / (60000.0 * 100.0);
                }
                uint64_t beatIdx = (uint64_t)st.beatAccum;
                beatInBar  = (uint8_t)((beatIdx % 4) + 1);   // 1..4
                beatNumber = (uint32_t)(beatIdx + 1);         // 1-based
            }
            else
            {
                // No BPM or native beat: invalidate anchor so the next time
                // we get a BPM we re-anchor at the current position.
                tcnetBeatState[layer].valid = false;
            }

            auto info = eng.getActiveTrackInfo();
            durationMs = (info.durationSec > 0) ? (uint32_t)info.durationSec * 1000 : 0;

            // SyncMaster always equals LayerID (= layer+1) so the MagicQ
            // coherence check passes. The user's UI Layer choice IS the
            // identity that the receiver tracks; we don't expose internal
            // CDJ player numbering at the TCNet level.
            uint8_t masterPlayerNum = (uint8_t)(layer + 1);

            // Compute Track ID. For real CDJ sources use the rekordbox track
            // ID so MagicQ correctly identifies the song. For non-CDJ sources
            // synthesise an ID that encodes (layer, source type) so it
            // changes when switching between sources -- this invalidates the
            // ChamSys Beat Grid / Waveform cache from any previous source on
            // the same layer (without it, MagicQ would hold onto stale data
            // from a previous CDJ track when you switch to Generator).
            uint32_t trackIdToSend = 0;
            if ((src == SrcType::ProDJLink || src == SrcType::StageLinQ) && info.trackId != 0)
            {
                // The engine's track ID for either DJ source (for StageLinQ,
                // which has no numeric ID, the engine's per-load track count).
                trackIdToSend = info.trackId;
            }
            else
            {
                // Synthesise: high bits encode source type so cache invalidates
                // when source switches. Low bits encode layer so different
                // engines stay distinct.
                uint32_t srcTag = 0;
                switch (src)
                {
                    case SrcType::SystemTime: srcTag = 0x10000000u; break;
                    case SrcType::MTC:        srcTag = 0x20000000u; break;
                    case SrcType::ArtNet:     srcTag = 0x30000000u; break;
                    case SrcType::LTC:        srcTag = 0x40000000u; break;
                    case SrcType::Hippotizer: srcTag = 0x50000000u; break;
                    case SrcType::Winamp:     srcTag = 0x60000000u; break;
                    default: break;
                }
                trackIdToSend = srcTag | (uint32_t)(layer + 1);
            }

            sharedTcnetOutput.setLayerFromEngine(
                layer,
                eng.getOutputTimecode(),
                eng.getEffectiveOutputFps(),
                eng.getSmoothedPlayheadMs(),
                durationMs,
                eng.isSourceActive(),
                onAirFader,
                beatInBar,
                bpm100,
                eng.getTcnetOutputOffsetMs(),
                beatNumber,
                masterPlayerNum,
                trackIdToSend,
                eng.getSourceSpeedRatio());

            // Feed track metadata for Resolume unicast.
            // DJ sources: real artist + title from CDJ/Denon.
            // Non-DJ sources: input name as artist, "STC" as title.
            juce::String artist, title;
            if (info.artist.isNotEmpty() || info.title.isNotEmpty())
            {
                artist = info.artist;
                title  = info.title;
            }
            else
            {
                switch (src)
                {
                    case SrcType::MTC:        artist = "MTC Input";        break;
                    case SrcType::ArtNet:      artist = "Art-Net Input";    break;
                    case SrcType::LTC:         artist = "LTC Input";        break;
                    case SrcType::SystemTime:  artist = "Generator";        break;
                    case SrcType::ProDJLink:   artist = "Pro DJ Link";      break;
                    case SrcType::StageLinQ:   artist = "StageLinQ";        break;
                    case SrcType::Hippotizer:  artist = "HippoNet";       break;
                    case SrcType::Winamp:      artist = "Winamp";           break;
                    case SrcType::LANetTC:     artist = "LA-Net Input";     break;
                    default:                   artist = "STC";              break;
                }
                title = eng.getName();
            }
            sharedTcnetOutput.setLayerMetadata(layer, artist, title);

            // Feed artwork: live source -> disk cache -> STC logo
            if ((src == SrcType::ProDJLink || src == SrcType::StageLinQ) && info.title.isNotEmpty())
            {
                // Build cache key matching TrackMap format
                juce::String artKey = info.artist + "|" + info.title;
                if (info.durationSec > 0)
                    artKey += "|" + juce::String(info.durationSec);
                const bool newTrack = tcnetArtworkKey[layer] != artKey;
                if (newTrack || tcnetArtworkPending[layer])
                {
                    juce::Image artImg;

                    // 1. Try live source (already in memory from metadata fetch)
                    if (src == SrcType::ProDJLink && info.artworkId != 0)
                    {
                        // Artwork IDs are per export: the art of the medium
                        // the track was loaded from (AUDIT META-5).
                        const auto media = getPdlMediaSource(ep);
                        artImg = sharedDbClient.getCachedArtwork(media.ip, media.slot, info.artworkId);
                    }
                    else if (newTrack && src == SrcType::StageLinQ)
                    {
                        auto netPath = sharedStageLinQInput.getTrackNetworkPath(ep);
                        if (netPath.isNotEmpty() && sharedStageLinQDb.isDatabaseReady())
                            artImg = sharedStageLinQDb.getArtworkForTrack(netPath);
                    }

                    // DbServerClient caches the metadata, which the track
                    // key comes from, before it fetches the artwork: until
                    // the artwork is cached, step 1 runs again each tick (a
                    // lookup in memory) and its image replaces what steps 2
                    // and 3 sent, as the waveform is fed when it arrives
                    // (AUDIT META-16).  Steps 2 and 3 run once per track.
                    tcnetArtworkPending[layer] = src == SrcType::ProDJLink && info.artworkId != 0
                                              && ! artImg.isValid();
                    if (newTrack || artImg.isValid())
                    {
                        tcnetArtworkKey[layer] = artKey;

                        // 2. Try disk cache (saved by CuePointEditor)
                        if (!artImg.isValid())
                            artImg = WaveformCache::loadArtwork(artKey.toStdString());
                        if (!artImg.isValid() && info.durationSec > 0)
                            artImg = WaveformCache::loadArtwork((info.artist + "|" + info.title).toStdString());

                        // 3. Convert to JPEG and send, or fall back to STC logo
                        if (artImg.isValid())
                        {
                            juce::MemoryOutputStream mos;
                            juce::JPEGImageFormat fmt;
                            fmt.setQuality(0.7f);
                            if (fmt.writeImageToStream(artImg, mos))
                                sharedTcnetOutput.setLayerArtwork(layer, mos.getData(), mos.getDataSize());
                            else
                                sharedTcnetOutput.setLayerArtwork(layer, nullptr, 0);
                        }
                        else
                            sharedTcnetOutput.setLayerArtwork(layer, nullptr, 0);
                    }
                }
            }
            else
            {
                tcnetArtworkPending[layer] = false;
                if (tcnetArtworkKey[layer].isNotEmpty())
                {
                    tcnetArtworkKey[layer] = {};
                    sharedTcnetOutput.setLayerArtwork(layer, nullptr, 0);  // STC logo
                }
            }
            // Feed waveform and beat grid from DbServer / StageLinQDB caches.
            // ProDJLink uses sharedDbClient (CDJ track ID lookup); StageLinQ
            // uses sharedStageLinQDb (network path lookup into the Engine DJ
            // SQLite database).  Both feed the SAME TCNet APIs, so the only
            // difference is where the bytes come from.
            const bool feedFromProDJLink = (src == SrcType::ProDJLink && info.title.isNotEmpty() && info.trackId != 0);
            const bool feedFromStageLinQ = (src == SrcType::StageLinQ && info.title.isNotEmpty() && sharedStageLinQDb.isDatabaseReady());

            if (feedFromProDJLink)
            {
                juce::String wfKey = info.artist + "|" + info.title + "|wf";
                if (info.durationSec > 0) wfKey += "|" + juce::String(info.durationSec);

                // The cache entry is the one of the player holding the media,
                // keyed by its address, the slot and the ID (AUDIT META-5);
                // the deck's own address found nothing for a track loaded
                // from another player's USB.  The waveform and the beat grid
                // arrive after the metadata, so the layer is fed again each
                // time that entry changes -- a version read, no copy, per tick
                // -- not only once at the track change, when they were
                // usually not there yet and never sent (AUDIT META-16).
                const auto media = getPdlMediaSource(ep);
                const uint32_t mdVersion = sharedDbClient.getMetadataVersion(media.ip, media.slot, info.trackId);
                if (tcnetWaveformKey[layer] != wfKey || tcnetWaveformVersion[layer] != mdVersion)
                {
                    tcnetWaveformKey[layer] = wfKey;
                    tcnetWaveformVersion[layer] = mdVersion;
                    auto md = sharedDbClient.getCachedMetadata(media.ip, media.slot, info.trackId);

                    // Waveform: prefer preview (hasWaveform).  Fallback to detail.
                    // The preview goes out only for a track on a CDJ-3000-class
                    // player, as in 1.9.14-beta2, when only that player's
                    // dbserver gave one.  Any other player's preview comes from
                    // the NFS route since this round (AUDIT META-15), and what
                    // TCNetOutput makes of a PWV4 preview has not been checked
                    // against a TCNet receiver (AUDIT META-11): those decks keep
                    // sending the detail waveform, so what TCNet receives does
                    // not change (DESIGN D2).
                    uint8_t mediaPlayer = sharedProDJLinkInput.getLoadedPlayer(ep);
                    if (mediaPlayer == 0) mediaPlayer = (uint8_t) ep;
                    const bool previewAsBefore =
                        sharedProDJLinkInput.getPlayerModel((int) mediaPlayer).containsIgnoreCase("3000");
                    if (md.hasWaveform() && previewAsBefore)
                    {
                        sharedTcnetOutput.setLayerSmallWaveform(
                            layer, md.waveformData.data(),
                            md.waveformEntryCount, md.waveformBytesPerEntry);
                    }
                    else if (md.hasDetailWaveform())
                    {
                        sharedTcnetOutput.setLayerSmallWaveform(
                            layer, md.detailData.data(),
                            md.detailEntryCount, md.detailBytesPerEntry);
                    }
                    else
                    {
                        sharedTcnetOutput.setLayerSmallWaveform(layer, nullptr, 0, 0);
                    }

                    // Real beat grid if available.
                    if (md.hasBeatGrid())
                    {
                        std::vector<uint16_t> nums;
                        std::vector<uint32_t> times;
                        nums.reserve(md.beatGrid.size());
                        times.reserve(md.beatGrid.size());
                        for (const auto& b : md.beatGrid)
                        {
                            nums.push_back(b.beatNumber);
                            times.push_back(b.timeMs);
                        }
                        sharedTcnetOutput.setLayerBeatGrid(
                            layer, nums.data(), times.data(), (int)nums.size());
                    }
                    else
                    {
                        sharedTcnetOutput.setLayerBeatGrid(layer, nullptr, nullptr, 0);
                    }
                }
            }
            else if (feedFromStageLinQ)
            {
                juce::String wfKey = info.artist + "|" + info.title + "|wf";
                if (info.durationSec > 0) wfKey += "|" + juce::String(info.durationSec);
                if (tcnetWaveformKey[layer] != wfKey)
                {
                    auto netPath = sharedStageLinQInput.getTrackNetworkPath(ep);

                    // Overview waveform: already decoded into Pioneer ThreeBand
                    // order (mid/high/low, 3 bytes per entry) by the StageLinQ
                    // decoder, so the TCNet layer accepts it directly with
                    // bytesPerEntry=3 just like ProDJLink's preview waveform.
                    //
                    // Note: we DO NOT update tcnetWaveformKey[layer] until we
                    // have actually loaded data.  StageLinQ's database query
                    // is asynchronous; if we commit the key on the first
                    // attempt we'd skip retries on subsequent feed iterations
                    // and end up with an empty waveform forever for that
                    // track.  Committing only on success means we keep
                    // retrying at 60Hz until the data arrives (or until the
                    // track changes).
                    bool committedKey = false;

                    if (netPath.isNotEmpty())
                    {
                        auto wf = sharedStageLinQDb.getWaveformForTrack(netPath);
                        auto perf = sharedStageLinQDb.getPerformanceData(netPath);
                        const bool haveAnyData = (wf.valid && wf.entryCount > 0)
                                              || (!perf.beatGrid.empty() && perf.sampleRate > 0.0);

                        if (haveAnyData)
                        {
                            tcnetWaveformKey[layer] = wfKey;
                            committedKey = true;

                            // Apply waveform.
                            if (wf.valid && wf.entryCount > 0)
                            {
                                sharedTcnetOutput.setLayerSmallWaveform(
                                    layer, wf.data.data(), wf.entryCount, 3);
                            }
                            else
                            {
                                sharedTcnetOutput.setLayerSmallWaveform(layer, nullptr, 0, 0);
                            }

                            // Beat grid: Engine DJ stores SPARSE downbeat markers
                            // (sample offset of every 4th beat in 4/4), not a flat
                            // beat list.  Expand to per-beat entries with timestamps
                            // by linearly interpolating between consecutive markers
                            // -- the gap covers `numBeats` beats so each individual
                            // beat sits at offset + (i * (next - offset) / numBeats).
                            // Last marker's tempo is held for any beats after it.
                            if (!perf.beatGrid.empty() && perf.sampleRate > 0.0)
                            {
                                const double sr = perf.sampleRate;
                                std::vector<uint16_t> nums;
                                std::vector<uint32_t> times;
                                nums.reserve(perf.beatGrid.size() * 4);
                                times.reserve(perf.beatGrid.size() * 4);

                                const auto& bg = perf.beatGrid;
                                for (size_t mi = 0; mi < bg.size(); ++mi)
                                {
                                    const auto& m = bg[mi];
                                    // Cap numBeats defensively: typical 4/4 grid is
                                    // 4 per marker, unusual time signatures may use
                                    // 8 or 16; >64 indicates corrupt data.
                                    int n = (m.numBeats > 0 && m.numBeats <= 64) ? m.numBeats : 4;
                                    double startSamp = m.sampleOffset;

                                    // Determine the per-beat sample stride.  If
                                    // there's a next marker, use it; otherwise
                                    // reuse the previous stride (final region).
                                    double stride;
                                    if (mi + 1 < bg.size())
                                        stride = (bg[mi + 1].sampleOffset - startSamp) / (double) n;
                                    else if (mi > 0)
                                    {
                                        int prevN = (bg[mi - 1].numBeats > 0 && bg[mi - 1].numBeats <= 64)
                                                  ? bg[mi - 1].numBeats : 4;
                                        stride = (m.sampleOffset - bg[mi - 1].sampleOffset) / (double) prevN;
                                    }
                                    else
                                        stride = sr * 0.5;   // ~120 BPM fallback

                                    if (stride <= 0.0) continue;

                                    for (int bi = 0; bi < n; ++bi)
                                    {
                                        int64_t beatIdx = m.beatNumber + (int64_t) bi;  // 1-based
                                        if (beatIdx < 1 || beatIdx > 65535) continue;
                                        double samp = startSamp + (double) bi * stride;
                                        if (samp < 0.0) continue;
                                        uint32_t timeMs = (uint32_t) (samp * 1000.0 / sr);
                                        nums.push_back((uint16_t) beatIdx);
                                        times.push_back(timeMs);
                                    }
                                }
                                if (!nums.empty())
                                {
                                    sharedTcnetOutput.setLayerBeatGrid(
                                        layer, nums.data(), times.data(), (int) nums.size());
                                }
                                else
                                {
                                    sharedTcnetOutput.setLayerBeatGrid(layer, nullptr, nullptr, 0);
                                }
                            }
                            else
                            {
                                sharedTcnetOutput.setLayerBeatGrid(layer, nullptr, nullptr, 0);
                            }
                        }
                    }

                    // If we couldn't commit the key (no netPath, or no data
                    // ready yet) AND we previously had data on this layer,
                    // clear it so we don't leave stale waveform/beatgrid from
                    // a previous track.  Subsequent iterations will retry
                    // with the same wfKey until data arrives.
                    if (!committedKey && tcnetWaveformKey[layer].isNotEmpty())
                    {
                        tcnetWaveformKey[layer] = {};
                        sharedTcnetOutput.setLayerSmallWaveform(layer, nullptr, 0, 0);
                        sharedTcnetOutput.setLayerBeatGrid(layer, nullptr, nullptr, 0);
                    }
                }
            }
            else
            {
                if (tcnetWaveformKey[layer].isNotEmpty())
                {
                    tcnetWaveformKey[layer] = {};
                    sharedTcnetOutput.setLayerSmallWaveform(layer, nullptr, 0, 0);
                    sharedTcnetOutput.setLayerBeatGrid(layer, nullptr, nullptr, 0);
                }
            }
        }

        // Clear layers not assigned to any engine
        for (int i = 0; i < TCNetOutput::kMaxLayers; ++i)
            if (!layerUsed[i])
                sharedTcnetOutput.clearLayer(i);
    }

    // Update UI for selected engine
    auto& eng = currentEngine();

    updateStatusLabels();

    if (eng.getActiveInput() == SrcType::ProDJLink && sharedProDJLinkInput.isReceiving())
    {
        int pdlPlayer = eng.getEffectivePlayer();

        // Guard: in XF mode, resolved player can be 0 (no player on this side)
        if (pdlPlayer < 1)
        {
            lblProDJLinkTrackInfo.setText("", juce::dontSendNotification);
            lblProDJLinkMetadata.setText("", juce::dontSendNotification);
            lblNextCue.setText("", juce::dontSendNotification);
            lblMixerStatus.setText("", juce::dontSendNotification);
        }
        else
        {

        // Phase 2: use engine's enriched track info (resolves "Track #12345" via dbClient)
        auto trackInfo = eng.getActiveTrackInfo();
        juce::String pdlTrackStr;
        if (trackInfo.artist.isNotEmpty() && trackInfo.title.isNotEmpty())
            pdlTrackStr = trackInfo.artist + " " + juce::String::charToString(0x2014) + " " + trackInfo.title;
        else if (trackInfo.title.isNotEmpty())
            pdlTrackStr = trackInfo.title;
        if (trackInfo.key.isNotEmpty())
            pdlTrackStr += "  [" + trackInfo.key + "]";
        lblProDJLinkTrackInfo.setText(pdlTrackStr, juce::dontSendNotification);
        lblProDJLinkTrackInfo.setColour(juce::Label::textColourId,
            pdlTrackStr.isNotEmpty() ? juce::Colour(0xFF00AAFF).brighter(0.5f) : textDim);

        double pdlBpm = sharedProDJLinkInput.getBPM(pdlPlayer);
        juce::String pdlMeta;
        if (pdlBpm > 0.0)
        {
            pdlMeta += juce::String(pdlBpm, 1) + " BPM";

            // Show effective (multiplied) BPM if multiplier is active
            int effMult = eng.getEffectiveBpmMultiplier();
            if (effMult != 0)
            {
                double multBpm = TimecodeEngine::applyBpmMultiplier(pdlBpm, effMult);
                juce::String multLabel;
                switch (effMult) {
                    case  1: multLabel = "x2"; break;
                    case  2: multLabel = "x4"; break;
                    case -1: multLabel = "/2"; break;
                    case -2: multLabel = "/4"; break;
                    default: break;
                }
                pdlMeta += "  " + juce::String::charToString(0x2192) + " "
                         + juce::String(multBpm, 1) + " (" + multLabel + ")";
            }
        }
        double pdlPitch = sharedProDJLinkInput.getActualSpeed(pdlPlayer);
        if (pdlPitch > 0.01)
        {
            double pitchPct = (pdlPitch - 1.0) * 100.0;
            pdlMeta += "  " + (pitchPct >= 0.0 ? juce::String("+") : juce::String(""))
                            + juce::String(pitchPct, 2) + "%";
        }
        juce::String pdlModel = sharedProDJLinkInput.getPlayerModel(pdlPlayer);
        if (pdlModel.isNotEmpty())
            pdlMeta += "  | " + pdlModel;

        lblProDJLinkMetadata.setText(pdlMeta, juce::dontSendNotification);
        lblProDJLinkMetadata.setColour(juce::Label::textColourId, juce::Colour(0xFF00AAFF).brighter(0.3f));

        // Next cue countdown
        updateNextCueLabel(eng);

        // Mixer fader status line
        {
            // Pre-computed fader bar strings (avoids per-call charToString allocations)
            static const juce::String kBar3[4] = {
                juce::String::charToString(0x2591) + juce::String::charToString(0x2591) + juce::String::charToString(0x2591),
                juce::String::charToString(0x2588) + juce::String::charToString(0x2591) + juce::String::charToString(0x2591),
                juce::String::charToString(0x2588) + juce::String::charToString(0x2588) + juce::String::charToString(0x2591),
                juce::String::charToString(0x2588) + juce::String::charToString(0x2588) + juce::String::charToString(0x2588)
            };
            static const juce::String kBar2[3] = {
                juce::String::charToString(0x2591) + juce::String::charToString(0x2591),
                juce::String::charToString(0x2588) + juce::String::charToString(0x2591),
                juce::String::charToString(0x2588) + juce::String::charToString(0x2588)
            };
            static const juce::String kCrossSymbol = juce::String::charToString(0x2715);

            auto faderBar = [](uint8_t val, int bars) -> const juce::String&
            {
                int filled = (int)std::round((val / 255.0f) * bars);
                return (bars <= 2) ? kBar2[juce::jlimit(0, 2, filled)]
                                   : kBar3[juce::jlimit(0, 3, filled)];
            };
            if (sharedProDJLinkInput.hasMixerFaderData())
            {
                juce::String djmModel = sharedProDJLinkInput.getDJMModel();
                if (djmModel.isEmpty()) djmModel = "DJM";
                int numCh = sharedProDJLinkInput.getMixerChannelCount();
                // Cap model name and adjust bar width to fit panel
                if (djmModel.length() > 7) djmModel = djmModel.substring(0, 7);
                int bars = (numCh > 4) ? 2 : 3;  // narrower bars for 6-channel DJMs
                auto& pdl = sharedProDJLinkInput;
                juce::String mixStr = djmModel;
                for (int ch = 1; ch <= numCh; ++ch)
                    mixStr += " " + juce::String(ch) + ":" + faderBar(pdl.getChannelFader(ch), bars);
                mixStr += " " + kCrossSymbol + ":" + faderBar(pdl.getCrossfader(), bars)
                        + " M:" + faderBar(pdl.getMasterFader(), bars);
                lblMixerStatus.setText(mixStr, juce::dontSendNotification);
                lblMixerStatus.setColour(juce::Label::textColourId,
                    juce::Colour(0xFF00AAFF).withAlpha(0.7f));
            }
            else
            {
                lblMixerStatus.setText("DJM: waiting for bridge data...",
                    juce::dontSendNotification);
                lblMixerStatus.setColour(juce::Label::textColourId, textDim);
            }
        }

        // Artwork and waveform come from the DbServerClient cache entry of
        // the SOURCE player (the CDJ that holds the media), its slot and the
        // track's ID, as TimecodeEngine::requestDbMetadata keyed the request.
        // When CDJ 2 loads a track from CDJ 1's USB via Link export, CDJ 2's
        // own address finds nothing; and rekordbox IDs are per export, so the
        // same ID from another medium is another track (AUDIT META-5).  A
        // change of medium therefore shows as a new track here, and so does
        // the panel coming from the StageLinQ branch below, which shares the
        // two displays and leaves displayedPdlMedia empty: both displays are
        // cleared, so a track without artwork or waveform does not keep the
        // previous one's.
        const auto media = getPdlMediaSource(pdlPlayer);
        {
            const juce::String mediaKey = media.ip + "/" + juce::String((int) media.slot);
            if (mediaKey != displayedPdlMedia)
            {
                displayedPdlMedia = mediaKey;
                displayedArtworkId = 0;
                displayedWaveformTrackId = 0;
                artworkDisplay.clearImage();
                waveformDisplay.clearWaveform();
            }
        }
        displayedSlqTrackVersion = 0;
        slqPanelClearedFor = 0;

        // Phase 2c: update artwork from DbServerClient cache
        uint32_t artId = trackInfo.artworkId;
        if (artId != 0 && artId != displayedArtworkId)
        {
            auto artImg = sharedDbClient.getCachedArtwork(media.ip, media.slot, artId);
            if (artImg.isValid())
            {
                artworkDisplay.setImage(artImg);
                displayedArtworkId = artId;
            }
        }
        else if (artId == 0 && displayedArtworkId != 0)
        {
            artworkDisplay.clearImage();
            displayedArtworkId = 0;
        }

        // Phase 3: update color waveform from DbServerClient cache.  The
        // waveform arrives after the metadata; until it is there the entry
        // is looked at again only when its version has changed -- a version
        // read, no copy, per tick (AUDIT META-16, which the TCNet feed
        // shares).
        uint32_t wfTrackId = trackInfo.trackId;
        auto showCachedWaveform = [&]
        {
            displayedWaveformVersion = sharedDbClient.getMetadataVersion(media.ip, media.slot, wfTrackId);
            auto meta = sharedDbClient.getCachedMetadata(media.ip, media.slot, wfTrackId);
            if (meta.hasWaveform())
            {
                waveformDisplay.setColorWaveformData(meta.waveformData,
                    meta.waveformEntryCount, meta.waveformBytesPerEntry);
                if (meta.durationSeconds > 0)
                    waveformDisplay.setDurationMs((uint32_t)meta.durationSeconds * 1000);
                if (meta.hasCueList())
                    waveformDisplay.setRekordboxCues(meta.cueList);
                if (meta.hasBeatGrid())
                    waveformDisplay.setBeatGrid(meta.beatGrid);
                // Hand the beat grid to the engine (which also fetches its
                // own, AUDIT ENG-4).  On an NXS2 without absolute position
                // the grid gives the beat-fallback position the timecode
                // outputs send (TCNet's millisecond position is the input's
                // own, AUDIT ENG-14); the PLL nudge it also feeds changes
                // nothing sent (AUDIT ENG-15).
                if (meta.hasBeatGrid())
                    eng.setBeatGrid(meta.beatGrid, wfTrackId);
            }
        };

        if (wfTrackId != 0 && wfTrackId != displayedWaveformTrackId)
        {
            // Track changed -- clear old waveform immediately (avoids stale cursor)
            waveformDisplay.clearWaveform();
            // Mark this track as "attempted" so we don't re-enter this block
            // every frame.  The retry path below uses hasWaveformData() to
            // detect when the async waveform query completes.
            displayedWaveformTrackId = wfTrackId;

            // Try to populate from cache (may not have waveform yet)
            showCachedWaveform();
        }
        else if (wfTrackId != 0 && !waveformDisplay.hasWaveformData()
                 && sharedDbClient.getMetadataVersion(media.ip, media.slot, wfTrackId) != displayedWaveformVersion)
        {
            // Waveform not yet loaded and the entry has changed -- retry
            // from cache (async: arrives after metadata)
            showCachedWaveform();
        }
        else if (wfTrackId == 0 && displayedWaveformTrackId != 0)
        {
            waveformDisplay.clearWaveform();
            displayedWaveformTrackId = 0;
        }

        // Waveform cursor: the input's own position ratio, not the engine's
        // interpolated playhead (getSmoothedPlayPositionRatio: Pro DJ Link
        // and StageLinQ the last packet, Winamp extrapolated from its last
        // poll; AUDIT ENG-14).
        if (waveformDisplay.hasWaveformData())
        {
            float posRatio = eng.getSmoothedPlayPositionRatio();
            waveformDisplay.setPlayPosition(posRatio);
        }

        // Keep BPM multiplier buttons in sync (track load -> cached multiplier changes)
        updateBpmMultButtonStates();
        } // end pdlPlayer >= 1
    }
    else if (eng.getActiveInput() == SrcType::StageLinQ && sharedStageLinQInput.isReceiving())
    {
        int slqDeck = eng.getEffectivePlayer();
        if (slqDeck >= 1 && slqDeck <= StageLinQ::kMaxDecks)
        {
            // Track info from StageLinQ StateMap
            auto trackInfo = eng.getActiveTrackInfo();
            juce::String slqTrackStr;
            if (trackInfo.artist.isNotEmpty() && trackInfo.title.isNotEmpty())
                slqTrackStr = trackInfo.artist + " -- " + trackInfo.title;
            else if (trackInfo.title.isNotEmpty())
                slqTrackStr = trackInfo.title;
            lblProDJLinkTrackInfo.setText(slqTrackStr, juce::dontSendNotification);
            juce::Colour slqAccent(0xFF00CC66);  // Denon green
            lblProDJLinkTrackInfo.setColour(juce::Label::textColourId,
                slqTrackStr.isNotEmpty() ? slqAccent.brighter(0.5f) : textDim);

            double slqBpm = sharedStageLinQInput.getBPM(slqDeck);
            juce::String slqMeta;
            if (slqBpm > 0.0)
            {
                slqMeta += juce::String(slqBpm, 1) + " BPM";
                int effMult = eng.getEffectiveBpmMultiplier();
                if (effMult != 0)
                {
                    double multBpm = TimecodeEngine::applyBpmMultiplier(slqBpm, effMult);
                    juce::String multLabel;
                    switch (effMult) {
                        case  1: multLabel = "x2"; break;
                        case  2: multLabel = "x4"; break;
                        case -1: multLabel = "/2"; break;
                        case -2: multLabel = "/4"; break;
                        default: break;
                    }
                    slqMeta += "  -> " + juce::String(multBpm, 1) + " (" + multLabel + ")";
                }
            }
            // The pitch as the device states it (SpeedState); the speed
            // measured from BeatInfo scatters by 0.3 % a message and made the
            // figure flicker.  The measured one only when SpeedState is absent.
            double pitchPct = 0.0;
            bool havePitch = sharedStageLinQInput.getPitchPercent(slqDeck, pitchPct);
            if (!havePitch)
            {
                const double slqSpeed = sharedStageLinQInput.getActualSpeed(slqDeck);
                havePitch = slqSpeed > 0.01;
                pitchPct = (slqSpeed - 1.0) * 100.0;
            }
            if (havePitch)
            {
                slqMeta += "  " + (pitchPct >= 0.0 ? juce::String("+") : juce::String(""))
                                + juce::String(pitchPct, 2) + "%";
            }
            juce::String slqModel = sharedStageLinQInput.getPlayerModel(slqDeck);
            if (slqModel.isNotEmpty())
                slqMeta += "  | " + slqModel;

            lblProDJLinkMetadata.setText(slqMeta, juce::dontSendNotification);
            lblProDJLinkMetadata.setColour(juce::Label::textColourId, slqAccent.brighter(0.3f));

            // Next cue countdown
            updateNextCueLabel(eng);

            // Artwork + waveform from StageLinQ database.  The panel's
            // StageLinQ state is a track version, kept apart from the Pro DJ
            // Link branch's rekordbox IDs, which the two used to share
            // (AUDIT SLQ-12); each branch resets the other's.  Coming from
            // the Pro DJ Link branch (displayedPdlMedia set), the displays
            // are cleared first: a StageLinQ deck with no track would
            // otherwise keep that branch's artwork and waveform.
            if (displayedPdlMedia.isNotEmpty())
            {
                artworkDisplay.clearImage();
                waveformDisplay.clearWaveform();
                displayedPdlMedia.clear();
            }
            displayedWaveformTrackId = 0;
            displayedArtworkId = 0;
            {
                auto netPath = sharedStageLinQInput.getTrackNetworkPath(slqDeck);
                uint32_t slqTrackVer = sharedStageLinQInput.getTrackVersion(slqDeck);

                // Only update displays on track change (avoid 60Hz cache thrashing)
                if (netPath.isNotEmpty() && slqTrackVer != displayedSlqTrackVersion)
                {
                    auto dbMeta = sharedStageLinQDb.isDatabaseReady()
                                    ? sharedStageLinQDb.getTrackByNetworkPath(netPath) : DenonTrackMeta{};
                    if (!dbMeta.valid && slqPanelClearedFor != slqTrackVer)
                    {
                        // Not in the database (or none loaded yet): clear the
                        // previous track's artwork and waveform rather than
                        // leave them up, and keep looking (AUDIT SLQ-12).
                        slqPanelClearedFor = slqTrackVer;
                        artworkDisplay.clearImage();
                        waveformDisplay.clearWaveform();
                    }
                    if (dbMeta.valid)
                    {
                        displayedSlqTrackVersion = slqTrackVer;

                        auto artImg = sharedStageLinQDb.getArtworkForTrack(netPath);
                        if (artImg.isValid())
                            artworkDisplay.setImage(artImg);
                        else
                            artworkDisplay.clearImage();

                        // The Engine DJ overview, drawn as 1.9.14-beta2 drew
                        // it -- not with rekordbox's PWV6 weighting, which
                        // was never checked on a PRIME (AUDIT META-12).
                        auto wf = sharedStageLinQDb.getWaveformForTrack(netPath);
                        if (wf.valid && wf.entryCount > 0)
                            waveformDisplay.setEngineOverviewData(wf.data, wf.entryCount);
                        else
                            waveformDisplay.clearWaveform();

                        // Set track duration so minute markers and cue markers render
                        uint32_t trackLenMs = sharedStageLinQInput.getTrackLengthSec(slqDeck) * 1000;
                        if (trackLenMs == 0 && dbMeta.length > 0.0)
                            trackLenMs = (uint32_t)(dbMeta.length * 1000.0);
                        if (trackLenMs > 0)
                            waveformDisplay.setDurationMs(trackLenMs);

                        // Fetch performance data (quick cues, loops, beat grid)
                        auto perf = sharedStageLinQDb.getPerformanceData(netPath);
                        if (perf.valid && perf.sampleRate > 0.0 && !perf.quickCues.empty())
                        {
                            // Convert DenonQuickCues → RekordboxCue for waveform display
                            std::vector<TrackMetadata::RekordboxCue> wfCues;
                            for (int ci = 0; ci < (int)perf.quickCues.size(); ++ci)
                            {
                                auto& qc = perf.quickCues[(size_t)ci];
                                if (!qc.isSet()) continue;

                                TrackMetadata::RekordboxCue rc;
                                rc.type = TrackMetadata::RekordboxCue::HotCue;
                                rc.hotCueNumber = (uint8_t)(ci + 1);
                                rc.positionMs = denonCueToMs(qc.sampleOffset, perf.sampleRate);
                                rc.colorR = qc.r;
                                rc.colorG = qc.g;
                                rc.colorB = qc.b;
                                rc.hasColor = true;
                                rc.comment = qc.label;
                                wfCues.push_back(rc);
                            }
                            if (!wfCues.empty())
                                waveformDisplay.setRekordboxCues(wfCues);

                            // Auto-populate TrackMap cue points when the entry
                            // has none (same as the Pro DJ Link path, the PDL
                            // View's autoPopulateRekordboxCues).  Blocked
                            // during Show Lock -- TrackMap is configuration.
                            // The setting is read, not isShowLocked(): the
                            // operator did nothing, so the lock button does
                            // not flash.
                            auto cueTrackInfo = eng.getActiveTrackInfo();
                            if (cueTrackInfo.title.isNotEmpty() && !settings.showModeLocked)
                            {
                                int dur = (int)sharedStageLinQInput.getTrackLengthSec(slqDeck);
                                auto* tmEntry = settings.trackMap.find(cueTrackInfo.artist, cueTrackInfo.title, dur);
                                if (!tmEntry && dur > 0)
                                    tmEntry = settings.trackMap.find(cueTrackInfo.artist, cueTrackInfo.title, 0);
                                if (!tmEntry)
                                    tmEntry = settings.trackMap.findIgnoringDuration(cueTrackInfo.artist, cueTrackInfo.title);
                                if (tmEntry != nullptr && tmEntry->cuePoints.empty())
                                {
                                    for (int ci = 0; ci < (int)perf.quickCues.size(); ++ci)
                                    {
                                        auto& qc = perf.quickCues[(size_t)ci];
                                        if (!qc.isSet()) continue;
                                        uint32_t posMs = denonCueToMs(qc.sampleOffset, perf.sampleRate);
                                        if (posMs == 0) continue;

                                        CuePoint cp;
                                        cp.positionMs = posMs;
                                        // Name: letter + label (e.g. "A DROP")
                                        if (ci < 8)
                                            cp.name = juce::String::charToString((juce::juce_wchar)('A' + ci));
                                        if (qc.label.isNotEmpty())
                                            cp.name += cp.name.isNotEmpty() ? " " + qc.label : qc.label;
                                        if (cp.name.isEmpty())
                                            cp.name = "CUE " + juce::String(ci + 1);

                                        tmEntry->cuePoints.push_back(std::move(cp));
                                    }
                                    tmEntry->sortCuePoints();
                                    // Persist the populated cues now (before,
                                    // they reached the file only with the
                                    // next settings save, at the latest on
                                    // quit, and a crash lost them), let every
                                    // engine's armed list pick them up, and
                                    // show them in the TrackMap editor if it
                                    // is open, as saveBpmMultToTrackMap does
                                    // for its rekordbox cues (AUDIT ENG-18).
                                    // saveAsync: this runs in the 60 Hz
                                    // timer (AUDIT C8).  Only when a cue was
                                    // added: the quick cues list every slot,
                                    // set or not.
                                    if (! tmEntry->cuePoints.empty())
                                    {
                                        settings.trackMap.saveAsync();
                                        for (auto& e : engines)
                                            e->refreshTrackMapLookup();
                                        if (trackMapWindow != nullptr)
                                            if (auto* editor = dynamic_cast<TrackMapEditor*>(trackMapWindow->getContentComponent()))
                                                editor->refresh();
                                    }
                                }
                            }
                        }
                    }
                }
                else if (netPath.isEmpty() && (displayedSlqTrackVersion != 0 || slqPanelClearedFor != 0))
                {
                    artworkDisplay.clearImage();
                    waveformDisplay.clearWaveform();
                    displayedSlqTrackVersion = 0;
                    slqPanelClearedFor = 0;
                }
            }

            // Update waveform cursor position every frame
            if (waveformDisplay.hasWaveformData())
            {
                float posRatio = eng.getSmoothedPlayPositionRatio();
                waveformDisplay.setPlayPosition(posRatio);
            }

            // Mixer fader bars (same visual style as ProDJLink DJM display)
            {
                static const juce::String kBar3[] = {
                    juce::String::charToString(0x2581),   // low
                    juce::String::charToString(0x2584),   // mid-low
                    juce::String::charToString(0x2586),   // mid-high
                    juce::String::charToString(0x2588)    // full
                };
                static const juce::String kCrossSymbol = juce::String::charToString(0x2715);

                auto faderBar3 = [&](double val01) -> const juce::String&
                {
                    int filled = (int)std::round(val01 * 3.0);
                    return kBar3[juce::jlimit(0, 3, filled)];
                };

                juce::String mixStr = "MIX";
                for (int ch = 1; ch <= 4; ++ch)
                    mixStr += " " + juce::String(ch) + ":" + faderBar3(sharedStageLinQInput.getFaderPosition(ch));
                mixStr += " " + kCrossSymbol + ":" + faderBar3(sharedStageLinQInput.getCrossfaderPosition());

                lblMixerStatus.setText(mixStr, juce::dontSendNotification);
                lblMixerStatus.setColour(juce::Label::textColourId, slqAccent.withAlpha(0.7f));
            }

            updateBpmMultButtonStates();
        }
        else
        {
            lblProDJLinkTrackInfo.setText("", juce::dontSendNotification);
            lblProDJLinkMetadata.setText("", juce::dontSendNotification);
            lblNextCue.setText("", juce::dontSendNotification);
            lblMixerStatus.setText("", juce::dontSendNotification);
        }
    }
    else if (eng.getActiveInput() != SrcType::ProDJLink && eng.getActiveInput() != SrcType::StageLinQ)
    {
        lblProDJLinkTrackInfo.setText("", juce::dontSendNotification);
        lblProDJLinkMetadata.setText("", juce::dontSendNotification);
        lblNextCue.setText("", juce::dontSendNotification);
        lblMixerStatus.setText("", juce::dontSendNotification);
        if (displayedArtworkId != 0)
        {
            artworkDisplay.clearImage();
            displayedArtworkId = 0;
        }
        if (displayedWaveformTrackId != 0 || displayedSlqTrackVersion != 0 || slqPanelClearedFor != 0)
        {
            artworkDisplay.clearImage();
            waveformDisplay.clearWaveform();
            displayedWaveformTrackId = 0;
            displayedSlqTrackVersion = 0;
            slqPanelClearedFor = 0;
        }
        displayedPdlMedia.clear();
    }

    // Ableton Link status label
    if (eng.getLinkBridge().isEnabled() && lblLinkStatus.isVisible())
    {
        int peers = eng.getLinkBridge().getNumPeers();
        double linkBpm = eng.getLinkBridge().getTempo();
        juce::String linkText = juce::String(linkBpm, 1) + " BPM";
        if (peers > 0)
            linkText += " | " + juce::String(peers) + (peers == 1 ? " peer" : " peers");
        else
            linkText += " | no peers";
        lblLinkStatus.setText(linkText, juce::dontSendNotification);
        lblLinkStatus.setColour(juce::Label::textColourId,
            peers > 0 ? juce::Colour(0xFF00D084) : juce::Colour(0xFFFF9800));
    }
    else if (lblLinkStatus.isVisible())
    {
        // Show which engine owns Link (if any)
        int owner = findLinkOwnerOtherThan(selectedEngine);
        if (owner >= 0)
        {
            lblLinkStatus.setText("Active on " + engines[(size_t)owner]->getName(),
                                 juce::dontSendNotification);
            lblLinkStatus.setColour(juce::Label::textColourId, juce::Colour(0xFF888888));
        }
        else
        {
            lblLinkStatus.setText("", juce::dontSendNotification);
        }
    }

    // Update TrackMap editor window if open
    if (trackMapWindow != nullptr)
    {
        if (auto* editor = dynamic_cast<TrackMapEditor*>(trackMapWindow->getContentComponent()))
        {
            auto ati = eng.getActiveTrackInfo();
            editor->setActiveTrack(ati.artist, ati.title);

            if (eng.consumeTrackMapAutoFilled())
            {
                editor->refresh();
                updateBpmMultButtonStates();  // TrackMap entry may have a bpmMultiplier
            }
        }
    }

    timecodeDisplay.setTimecode(eng.getCurrentTimecode());
    timecodeDisplay.setFrameRate(eng.getCurrentFps());
    timecodeDisplay.setRunning(eng.isSourceActive());
    timecodeDisplay.setSourceName(TimecodeEngine::getInputName(eng.getActiveInput()));
    timecodeDisplay.setFpsConvertEnabled(eng.isFpsConvertEnabled());
    timecodeDisplay.setOutputTimecode(eng.getOutputTimecode());
    timecodeDisplay.setOutputFrameRate(eng.getEffectiveOutputFps());

    // Update VU meters for selected engine
    if (eng.isAudioBpmRunning() && eng.getActiveInput() != SrcType::LTC)
        mtrLtcInput.setLevel(eng.getAudioBpmPeakLevel());
    else
        mtrLtcInput.setLevel(eng.getSmoothedLtcInLevel());
    // Separate Audio BPM meter (visible when LTC owns shared meter)
    if (mtrAudioBpm.isVisible())
        mtrAudioBpm.setLevel(eng.getAudioBpmPeakLevel());

    // Audio BPM value display + beat LED
    if (lblBpmValue.isVisible())
    {
        double bpm = eng.getAudioBpm();
        double conf = eng.getAudioBpmConfidence();
        if (bpm > 0.0 && conf > 0.15)
        {
            lblBpmValue.setText(juce::String(bpm, 1) + " BPM", juce::dontSendNotification);
            // Color: dim orange at low confidence → bright orange → green at high confidence
            juce::Colour bpmCol;
            if (conf > 0.6)
                bpmCol = juce::Colour(0xFF00DD77);  // green = locked
            else if (conf > 0.3)
                bpmCol = juce::Colour(0xFFFF9900);  // orange = tracking
            else
                bpmCol = juce::Colour(0xFFCC6600);  // dim orange = uncertain
            lblBpmValue.setColour(juce::Label::textColourId, bpmCol);
        }
        else
        {
            lblBpmValue.setText("--- BPM", juce::dontSendNotification);
            lblBpmValue.setColour(juce::Label::textColourId, juce::Colour(0xFF555555));
        }
    }
    if (ledBeat.isVisible())
    {
        double bpm = eng.getAudioBpm();
        if (bpm > 20.0 && eng.isAudioBpmRunning())
        {
            double intervalMs = 60000.0 / bpm;
            beatFlashAccumMs += 1000.0 / 60.0;  // ~16.67ms per tick at 60Hz timer
            if (beatFlashAccumMs >= intervalMs)
            {
                beatFlashAccumMs -= intervalMs;
                // Prevent runaway if BPM changed drastically
                if (beatFlashAccumMs > intervalMs)
                    beatFlashAccumMs = 0.0;
                ledBeat.flash();
            }
            else
            {
                ledBeat.decay(0.15f);
            }
        }
        else
        {
            beatFlashAccumMs = 0.0;
            ledBeat.decay(0.15f);
        }
    }

    mtrThruInput.setLevel(eng.getSmoothedThruInLevel());
    mtrLtcOutput.setLevel(eng.getSmoothedLtcOutLevel());
    mtrThruOutput.setLevel(eng.getSmoothedThruOutLevel());

    // Auto-update FPS button states when the frame rate changes
    // (e.g. from protocol auto-detection in MTC/ArtNet/LTC/LA-Net inputs)
    {
        FrameRate curFps = eng.getCurrentFps();
        FrameRate curOutFps = eng.getEffectiveOutputFps();
        if (curFps != lastDisplayedFps)
        {
            lastDisplayedFps = curFps;
            updateFpsButtonStates();
            pushFpsToGenPresetEditor();
        }
        if (curOutFps != lastDisplayedOutFps)
        {
            lastDisplayedOutFps = curOutFps;
            updateOutputFpsButtonStates();
        }
    }

    // Repaint mini strip so non-selected engine timecodes update live.
    // Skip if no non-selected engine is running (nothing to animate).
    if (engines.size() > 1 && !miniStripArea.isEmpty())
    {
        bool anyOtherActive = false;
        for (int i = 0; i < (int)engines.size(); ++i)
        {
            if (i != selectedEngine && engines[(size_t)i]->isSourceActive())
                { anyOtherActive = true; break; }
        }
        if (anyOtherActive)
            repaint(miniStripArea);
    }

    // Debounced settings save
    if (settingsDirty)
    {
        if (--settingsSaveCountdown <= 0)
            flushSettings();
    }

    // --- Update checker ---
    if (updateCheckDelay > 0)
    {
        if (--updateCheckDelay == 0)
        {
            auto appVer = juce::JUCEApplication::getInstance()->getApplicationVersion();
            updateChecker.checkAsync(appVer);
        }
    }
    else if (!updateNotificationShown && updateChecker.hasResult())
    {
        updateNotificationShown = true;
        if (updateChecker.isUpdateAvailable())
        {
            juce::String label = "Update available: v" + updateChecker.getLatestVersion();
            btnUpdateAvailable.setButtonText(label);
            btnUpdateAvailable.setURL(juce::URL(updateChecker.getReleaseUrl()));
            btnUpdateAvailable.setVisible(true);
            btnCheckUpdates.setVisible(false);
            // Position directly in top bar
            btnUpdateAvailable.setBounds(getWidth() - 245, getHeight() - 24, 240, 24);
        }
        else if (updateChecker.didCheckFail())
        {
            btnCheckUpdates.setButtonText("Check failed - retry?");
            btnCheckUpdates.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFFFF8A65));  // orange
            btnCheckUpdates.setVisible(true);
            // Reset text after ~4 seconds (240 ticks at 60Hz)
            updateResetCountdown = 240;
        }
        else
        {
            btnCheckUpdates.setButtonText("Up to date " + juce::String::charToString(0x2713));
            btnCheckUpdates.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFF66BB6A));  // green
            btnCheckUpdates.setVisible(true);
            // Reset text after ~4 seconds
            updateResetCountdown = 240;
        }
    }

    // Reset "check for updates" button text after countdown
    if (updateResetCountdown > 0)
    {
        if (--updateResetCountdown == 0)
        {
            btnCheckUpdates.setButtonText("Check for updates");
            btnCheckUpdates.setColour(juce::TextButton::textColourOffId, juce::Colour(0xFF546E7A));
        }
    }

    // Bottom bar repaint when state changes
    juce::String currentBottomStatus = TimecodeEngine::getInputName(eng.getActiveInput());
    if (currentBottomStatus != lastBottomBarStatus || eng.isSourceActive() != lastBottomBarActive)
    {
        lastBottomBarStatus = currentBottomStatus;
        lastBottomBarActive = eng.isSourceActive();
        repaint(0, getHeight() - 24, getWidth(), 24);
    }
}

//==============================================================================
// KEYBOARD SHORTCUTS
//==============================================================================
bool MainComponent::keyPressed(const juce::KeyPress& key)
{
    // Ctrl+Shift+E (Cmd+Shift+E on Mac): export full configuration backup.
    // Locked like the Backup button.
    if (key.getModifiers().isCommandDown() && key.getModifiers().isShiftDown()
        && key.getKeyCode() == 'E')
    {
        if (!isShowLocked())
            exportConfig();
        return true;
    }

    // Ctrl+Shift+I (Cmd+Shift+I on Mac): import full configuration backup.
    // Locked like the Restore button (AUDIT UI-2).
    if (key.getModifiers().isCommandDown() && key.getModifiers().isShiftDown()
        && key.getKeyCode() == 'I')
    {
        if (!isShowLocked())
            importConfig();
        return true;
    }

    // Generator A/B loop shortcuts: only fire when the Generator transport
    // is visible (input source = Generator, transport mode = true) and no
    // text editor has keyboard focus (so typing in a TC field is not
    // intercepted).  These mirror the DAW / sample editor convention:
    //   [   set loop In at current playhead
    //   ]   set loop Out at current playhead
    //   L   toggle loop on/off
    // No modifiers required -- these are operational controls, not config.
    // Routed directly to the engine (rather than triggering buttons in the
    // waveform window) so the shortcuts work even when that window is
    // closed.  Validation mirrors what the waveform window's buttons do.
    if (btnGenPlay.isVisible() && ! key.getModifiers().isAnyModifierKeyDown())
    {
        // Skip if a text editor or combo's text edit currently owns focus.
        if (auto* focused = juce::Component::getCurrentlyFocusedComponent())
            if (dynamic_cast<juce::TextEditor*>(focused) != nullptr)
                return false;

        const int code = key.getKeyCode();
        auto& eng = currentEngine();

        // JUCE reports these keys with key code '[' / ']' where the
        // keyboard layout types them without a modifier (on Windows the
        // key code is the key's unmodified character).
        if (code == '[')
        {
            // Loop In is a config-style timestamp-setting gesture; gated
            // by Show Lock for symmetry with Stop TC editing and the
            // waveform click-to-seek (silently refused, but the key is
            // still consumed so it does not propagate to other handlers).
            if (isShowLocked()) return true;
            const double here = eng.getGeneratorCurrentMs();
            const double existingOut = eng.getGeneratorLoopOutMs();
            if (existingOut > 0.0 && here >= existingOut)
                return true;  // refuse silently; the visible button shows a dialog
            eng.setGeneratorLoopInMs(here);
            saveSettings();
            return true;
        }
        if (code == ']')
        {
            // Symmetric with '[' -- Show Lock gates the Out timestamp too.
            if (isShowLocked()) return true;
            const double here = eng.getGeneratorCurrentMs();
            const double existingIn = eng.getGeneratorLoopInMs();
            if (here <= existingIn)
                return true;
            eng.setGeneratorLoopOutMs(here);
            saveSettings();
            return true;
        }
        if (code == 'L')
        {
            // The LOOP toggle stays ungated: toggling an already-armed
            // loop on / off is an operational gesture (performance), not
            // configuration.  Same rationale as the panel's transport
            // controls remaining active during Show Lock.
            eng.setGeneratorLoopEnabled(! eng.getGeneratorLoopEnabled());
            saveSettings();
            return true;
        }
    }

    return false;
}

//==============================================================================
// BUTTON STATE UPDATES
//==============================================================================
void MainComponent::updateBpmMultButtonStates()
{
    auto& eng = currentEngine();
    int eff  = eng.getEffectiveBpmMultiplier();   // 0=1x, 1=x2, 2=x4, -1=/2, -2=/4

    // Get TrackMap value directly for secondary indicator
    auto trackInfo = eng.getActiveTrackInfo();
    int map = 0;
    if (trackInfo.title.isNotEmpty())
    {
        auto* entry = settings.trackMap.find(trackInfo.artist, trackInfo.title,
                                              trackInfo.durationSec);
        if (!entry && trackInfo.durationSec > 0)
            entry = settings.trackMap.find(trackInfo.artist, trackInfo.title, 0);
        if (!entry)
            entry = settings.trackMap.findIgnoringDuration(trackInfo.artist, trackInfo.title);
        if (entry != nullptr) map = entry->bpmMultiplier;
    }

    // Accent colours
    auto lit    = juce::Colour(0xFF00AAFF);   // pdlAccent (active)
    auto amber  = juce::Colour(0xFFFFAB00);   // saved TrackMap indicator
    auto dim    = bgPanel;

    // Helper: style a button with visual distinction for session vs TrackMap.
    // Sets both textColourOffId and textColourOnId (hover) to the same value
    // so the custom L&F doesn't override gold TrackMap text with blue on hover.
    auto styleBtn = [&](juce::TextButton& btn, int mult)
    {
        bool active  = (eff == mult);
        bool isSaved = (map != 0 && map == mult);  // has TrackMap value on this button

        juce::Colour bgCol = active ? lit.withAlpha(0.30f) : dim;
        btn.setColour(juce::TextButton::buttonColourId, bgCol);
        btn.setColour(juce::TextButton::buttonOnColourId, bgCol.brighter(0.15f));  // subtle hover bg

        // Golden text always wins for saved TrackMap value -- both normal and hover
        juce::Colour txtCol = isSaved ? amber
                            : (active ? lit.brighter(0.3f) : textMid);
        btn.setColour(juce::TextButton::textColourOffId, txtCol);
        btn.setColour(juce::TextButton::textColourOnId,  txtCol);
    };

    styleBtn(btnBpmOff,  0);
    styleBtn(btnBpmX2,   1);
    styleBtn(btnBpmX4,   2);
    styleBtn(btnBpmD2,  -1);
    styleBtn(btnBpmD4,  -2);
}

//==============================================================================
// Save BPM multiplier to TrackMap (double-click from engine panel buttons).
// Double-click on 1x clears saved value. Other values save without toggle.
// After saving, session override is cleared (TrackMap = source of truth).
//==============================================================================
void MainComponent::saveBpmMultToTrackMap(int clickedMult)
{
    auto& eng = currentEngine();
    auto info = eng.getActiveTrackInfo();
    if (info.title.isEmpty()) return;

    auto* entry = settings.trackMap.find(info.artist, info.title, info.durationSec);
    if (!entry && info.durationSec > 0)
        entry = settings.trackMap.find(info.artist, info.title, 0);
    if (!entry)
        entry = settings.trackMap.findIgnoringDuration(info.artist, info.title);
    int currentMapValue = (entry != nullptr) ? entry->bpmMultiplier : 0;

    // Double-click on 1x: clear saved value. Otherwise: save (no toggle).
    int newValue;
    if (clickedMult == 0)
        newValue = 0;                           // 1x = clear
    else if (clickedMult == currentMapValue)
        return;                                 // already saved, do nothing
    else
        newValue = clickedMult;                  // save new value

    if (entry != nullptr)
    {
        entry->bpmMultiplier = newValue;
    }
    else if (newValue != 0)
    {
        // Create a new TrackMap entry with basic info + bpmMultiplier
        TrackMapEntry newEntry;
        newEntry.artist  = info.artist;
        newEntry.title   = info.title;
        newEntry.durationSec = info.durationSec;
        newEntry.bpmMultiplier = newValue;

        // Auto-populate cue points from rekordbox if available: the cache
        // entry of the medium the track was loaded from (AUDIT META-5); only
        // a Pro DJ Link engine's track ID is a rekordbox ID.
        if (info.trackId != 0 && eng.getActiveInput() == SrcType::ProDJLink)
        {
            const auto media = getPdlMediaSource(eng.getEffectivePlayer());
            auto meta = sharedDbClient.getCachedMetadata(media.ip, media.slot, info.trackId);
            if (meta.isValid() && !meta.cueList.empty())
            {
                for (auto& rc : meta.cueList)
                {
                    if (rc.positionMs == 0) continue;
                    CuePoint cp;
                    cp.positionMs = rc.positionMs;
                    auto letter = rc.hotCueLetter();
                    if (letter.isNotEmpty())
                        cp.name = letter;
                    if (rc.comment.isNotEmpty())
                        cp.name += cp.name.isNotEmpty()
                            ? " " + rc.comment : rc.comment;
                    if (cp.name.isEmpty())
                    {
                        if (rc.type == TrackMetadata::RekordboxCue::MemoryPoint)
                            cp.name = "MEM";
                        else if (rc.type == TrackMetadata::RekordboxCue::Loop)
                            cp.name = "LOOP";
                    }
                    newEntry.cuePoints.push_back(std::move(cp));
                }
                newEntry.sortCuePoints();
            }
        }

        settings.trackMap.addOrUpdate(newEntry);
    }
    else
    {
        return;  // no entry exists and clearing to 0 = nothing to do
    }

    // Clear session override; TrackMap is now the source of truth
    eng.setBpmPlayerOverride(TimecodeEngine::kBpmNoOverride);
    eng.setCachedBpmMultiplier(newValue);

    // Persist and refresh all engines (other engines on same track benefit too)
    settings.trackMap.save();
    for (auto& e : engines)
        e->refreshTrackMapLookup();
    updateBpmMultButtonStates();

    // Refresh TrackMapEditor if open (entry may have been created/modified)
    if (trackMapWindow != nullptr)
    {
        if (auto* editor = dynamic_cast<TrackMapEditor*>(trackMapWindow->getContentComponent()))
            editor->refresh();
    }
}

void MainComponent::updateInputButtonStates()
{
    auto& eng = currentEngine();
    auto active = eng.getActiveInput();
    struct I { juce::TextButton* b; SrcType s; };
    I bs[] = { {&btnMtcIn,SrcType::MTC}, {&btnArtnetIn,SrcType::ArtNet}, {&btnHippoIn,SrcType::Hippotizer}, {&btnSysTime,SrcType::SystemTime}, {&btnLtcIn,SrcType::LTC}, {&btnProDJLinkIn,SrcType::ProDJLink}, {&btnStageLinQIn,SrcType::StageLinQ}, {&btnWinampIn,SrcType::Winamp}, {&btnLANetTCIn,SrcType::LANetTC} };
    for (auto& i : bs) styleInputButton(*i.b, active == i.s, getInputColour(i.s));

    // Stop shared network inputs when no engine uses them.
    // Without this, StageLinQ keeps broadcasting discovery (~1 pps) and
    // ProDJLink keeps sending keepalives even when all engines switched away.
    bool anySlq = false, anyPdl = false;
    for (auto& e : engines)
    {
        auto src = e->getActiveInput();
        if (src == SrcType::StageLinQ)  anySlq = true;
        if (src == SrcType::ProDJLink)  anyPdl = true;
    }
    if (!anySlq && sharedStageLinQInput.getIsRunning())
    {
        DBG("MainComponent: no engine uses StageLinQ — stopping shared input");
        // Stop the receiver first to join its thread and prevent further
        // onMetadataRequest / onFileTransferAvailable callbacks firing into
        // a stopped StageLinQ db client.
        sharedStageLinQInput.stop();
        sharedStageLinQDb.stop();
    }
    if (!anyPdl && sharedProDJLinkInput.getIsRunning())
    {
        DBG("MainComponent: no engine uses ProDJLink — stopping shared input");
        // Stop ProDJLink first to join its thread and prevent further
        // onPlayerLost callbacks firing into a stopped DbClient.
        sharedProDJLinkInput.stop();
        sharedDbClient.stop();
    }
}

void MainComponent::updateFpsButtonStates()
{
    auto& eng = currentEngine();
    FrameRate v[] = {FrameRate::FPS_2398,FrameRate::FPS_24,FrameRate::FPS_25,FrameRate::FPS_2997,FrameRate::FPS_30};
    juce::TextButton* b[] = {&btnFps2398,&btnFps24,&btnFps25,&btnFps2997,&btnFps30};
    for (int i = 0; i < 5; i++) styleFpsButton(*b[i], eng.getCurrentFps() == v[i]);
}

void MainComponent::updateOutputFpsButtonStates()
{
    auto& eng = currentEngine();
    FrameRate v[] = {FrameRate::FPS_2398, FrameRate::FPS_24, FrameRate::FPS_25, FrameRate::FPS_2997, FrameRate::FPS_30};
    juce::TextButton* b[] = {&btnOutFps2398, &btnOutFps24, &btnOutFps25, &btnOutFps2997, &btnOutFps30};
    FrameRate effective = eng.getEffectiveOutputFps();
    for (int i = 0; i < 5; i++)
    {
        styleFpsButton(*b[i], effective == v[i]);
        b[i]->setEnabled(eng.isFpsConvertEnabled());
        b[i]->setAlpha(eng.isFpsConvertEnabled() ? 1.0f : 0.4f);
    }
}

juce::Colour MainComponent::getInputColour(SrcType s) const
{
    switch (s)
    {
        case SrcType::MTC:        return accentRed;
        case SrcType::ArtNet:     return accentOrange;
        case SrcType::SystemTime: return accentGreen;
        case SrcType::LTC:        return accentPurple;
        case SrcType::ProDJLink:  return juce::Colour(0xFF00AAFF);  // bright blue
        case SrcType::StageLinQ:  return juce::Colour(0xFF00CC66);  // Denon green
        case SrcType::Hippotizer: return juce::Colour(0xFF66BBAA);  // Green Hippo teal
        case SrcType::Winamp:     return juce::Colour(0xFFFFCC33);  // Winamp classic yellow/gold
        case SrcType::LANetTC:    return juce::Colour{0xFF63D8FB};  // LaserAnimation turquois
        default:                      return textMid;
    }
}

//==============================================================================
// STYLING (same as v1.3)
//==============================================================================
void MainComponent::styleInputButton(juce::TextButton& btn, bool active, juce::Colour colour)
{
    btn.setColour(juce::TextButton::buttonColourId, active ? colour.withAlpha(0.15f) : juce::Colour(0xFF1A1D23));
    btn.setColour(juce::TextButton::buttonOnColourId, colour.withAlpha(0.2f));
    btn.setColour(juce::TextButton::textColourOffId, active ? textBright : textMid);
    btn.setColour(juce::TextButton::textColourOnId, textBright);
}

void MainComponent::styleFpsButton(juce::TextButton& btn, bool active)
{
    auto c = getInputColour(currentEngine().getActiveInput());
    btn.setColour(juce::TextButton::buttonColourId, active ? c.withAlpha(0.15f) : juce::Colour(0xFF1A1D23));
    btn.setColour(juce::TextButton::textColourOffId, active ? juce::Colour(0xFFE0F7FA) : textMid);
}

void MainComponent::styleOutputToggle(juce::ToggleButton& btn, juce::Colour colour)
{
    btn.setColour(juce::ToggleButton::textColourId, textBright);
    btn.setColour(juce::ToggleButton::tickColourId, colour);
    btn.setColour(juce::ToggleButton::tickDisabledColourId, textDim);
}

void MainComponent::styleComboBox(juce::ComboBox& cmb)
{
    cmb.setColour(juce::ComboBox::backgroundColourId, juce::Colour(0xFF1A1D23));
    cmb.setColour(juce::ComboBox::textColourId, textBright);
    cmb.setColour(juce::ComboBox::outlineColourId, borderCol);
    cmb.setColour(juce::ComboBox::arrowColourId, textMid);
}

void MainComponent::setupArtNetAddressCombos(juce::ComboBox& cmbNet, juce::ComboBox& cmbSub,
                                              juce::ComboBox& cmbUni, juce::Label& lbl,
                                              const juce::String& labelText,
                                              std::function<void()> onChangeFunc)
{
    leftContent.addAndMakeVisible(lbl);
    lbl.setVisible(false);
    lbl.setText(labelText, juce::dontSendNotification);
    lbl.setFont(juce::Font(juce::FontOptions(10.0f)));
    lbl.setColour(juce::Label::textColourId, textDim);

    for (auto* cmb : { &cmbNet, &cmbSub, &cmbUni })
    {
        leftContent.addAndMakeVisible(*cmb);
        cmb->setVisible(false);
        styleComboBox(*cmb);
    }

    for (int n = 0; n < 128; ++n) cmbNet.addItem("N:" + juce::String(n), n + 1);
    for (int s = 0; s < 16; ++s)  cmbSub.addItem("S:" + juce::String(s), s + 1);
    for (int u = 0; u < 16; ++u)  cmbUni.addItem("U:" + juce::String(u), u + 1);

    cmbNet.setTooltip("Net (0-127)");
    cmbSub.setTooltip("Subnet (0-15)");
    cmbUni.setTooltip("Universe (0-15)");

    cmbNet.setSelectedId(1, juce::dontSendNotification);
    cmbSub.setSelectedId(1, juce::dontSendNotification);
    cmbUni.setSelectedId(1, juce::dontSendNotification);

    auto cb = [onChangeFunc]() { if (onChangeFunc) onChangeFunc(); };
    cmbNet.onChange = cb;
    cmbSub.onChange = cb;
    cmbUni.onChange = cb;
}

void MainComponent::setArtNetCombosFromAddress(juce::ComboBox& cmbNet, juce::ComboBox& cmbSub,
                                                juce::ComboBox& cmbUni, int portAddress)
{
    int net, sub, uni;
    unpackArtNetAddress(portAddress, net, sub, uni);
    cmbNet.setSelectedId(net + 1, juce::dontSendNotification);
    cmbSub.setSelectedId(sub + 1, juce::dontSendNotification);
    cmbUni.setSelectedId(uni + 1, juce::dontSendNotification);
}

int MainComponent::getArtNetAddressFromCombos(const juce::ComboBox& cmbNet, const juce::ComboBox& cmbSub,
                                               const juce::ComboBox& cmbUni)
{
    return packArtNetAddress(cmbNet.getSelectedId() - 1,
                             cmbSub.getSelectedId() - 1,
                             cmbUni.getSelectedId() - 1);
}

void MainComponent::styleLabel(juce::Label& lbl, float fs)
{
    lbl.setFont(juce::Font(juce::FontOptions(getMonoFontName(), fs, juce::Font::plain)));
    lbl.setColour(juce::Label::textColourId, textDim);
    lbl.setJustificationType(juce::Justification::centredLeft);
}

void MainComponent::styleGainSlider(GainSlider& sld)
{
    sld.setSliderStyle(juce::Slider::LinearHorizontal);
    sld.setTextBoxStyle(juce::Slider::TextBoxRight, false, 44, 20);
    sld.setRange(0.0, 200.0, 1.0); sld.setValue(100.0, juce::dontSendNotification);
    sld.setTextValueSuffix("%"); sld.setDoubleClickReturnValue(true, 100.0);
    sld.setColour(juce::Slider::backgroundColourId, juce::Colour(0xFF1A1D23));
    sld.setColour(juce::Slider::trackColourId, juce::Colour(0xFF37474F));
    sld.setColour(juce::Slider::thumbColourId, juce::Colour(0xFF78909C));
    sld.setColour(juce::Slider::textBoxTextColourId, textBright);
    sld.setColour(juce::Slider::textBoxBackgroundColourId, juce::Colour(0xFF1A1D23));
    sld.setColour(juce::Slider::textBoxOutlineColourId, borderCol);
}

void MainComponent::styleOffsetSlider(GainSlider& sld)
{
    sld.setSliderStyle(juce::Slider::LinearHorizontal);
    sld.setTextBoxStyle(juce::Slider::TextBoxRight, false, 44, 20);
    sld.setRange(-30.0, 30.0, 1.0); sld.setValue(0.0, juce::dontSendNotification);
    sld.setTextValueSuffix(" f"); sld.setDoubleClickReturnValue(true, 0.0);
    sld.setColour(juce::Slider::backgroundColourId, juce::Colour(0xFF1A1D23));
    sld.setColour(juce::Slider::trackColourId, juce::Colour(0xFF37474F));
    sld.setColour(juce::Slider::thumbColourId, juce::Colour(0xFF78909C));
    sld.setColour(juce::Slider::textBoxTextColourId, textBright);
    sld.setColour(juce::Slider::textBoxBackgroundColourId, juce::Colour(0xFF1A1D23));
    sld.setColour(juce::Slider::textBoxOutlineColourId, borderCol);
}

void MainComponent::styleCollapseButton(juce::TextButton& btn)
{
    btn.setColour(juce::TextButton::buttonColourId, juce::Colours::transparentBlack);
    btn.setColour(juce::TextButton::buttonOnColourId, juce::Colours::transparentBlack);
    btn.setColour(juce::TextButton::textColourOffId, textMid);
    btn.setColour(juce::TextButton::textColourOnId, textMid);
}

void MainComponent::updateCollapseButtonText(juce::TextButton& btn, bool expanded)
{
    btn.setButtonText(expanded ? juce::String::charToString(0x25BE)
                               : juce::String::charToString(0x25B8));
}