Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { useCallback, useLayoutEffect, useState } from 'react';
import useChordPlayer from '../../hooks/useChordPlayer.js';
import useWakeLock from '../../hooks/useWakeLock.js';
import ChordTransportBar from './ChordTransportBar.jsx';
import TabSheetView from './TabSheetView.jsx';
/**
* Audible chord-sheet preview — the transport bar plus the rendered sheet with
* the sounding chord lit. The chord-sheet counterpart of `<DrumPreview>`, shared
* by the SongBook editor's live preview and the importer's.
*
* Playback uses a snapshot captured when Play is pressed. The live source can
* therefore keep changing without tearing down the schedule mid-run, and the
* sheet stays on the sounding snapshot too so the highlight keeps pointing at
* the chord you're actually hearing.
*
* `settingsMirror` is a SECOND `useChordPlayer` (the viewer's play-mode one)
* that should follow the practice settings changed here. Both transports read
* the per-song tempo/beats from storage at MOUNT, so without the mirror a tempo
* set in the editor wouldn't reach the already-mounted play-mode bar until a
* reload. Same contract as `<DrumPreview>`'s.
*/
export default function ChordPreview({
text,
songId,
format = 'tab',
fontSizeRem,
instrumentView,
sheetClassName = '',
settingsMirror,
}) {
const [snapshot, setSnapshot] = useState(text);
// `plain` is the sheet's explicit opt-out of ALL notation UI, chord tokens
// included — so it opts out of the play-along too rather than sounding chords
// the sheet is deliberately not highlighting.
const player = useChordPlayer(format === 'plain' ? '' : snapshot, { songId });
const chartChanged = text !== snapshot;
useWakeLock(player.playing);
// Keep the idle player current before the browser can paint another
// interaction target. Play can then start directly from its trusted click
// (required by Safari/iOS) while edits made during playback stay frozen.
useLayoutEffect(() => {
if (!player.playing && snapshot !== text) setSnapshot(text);
}, [player.playing, snapshot, text]);
const setBpm = useCallback((next) => {
player.setBpm(next);
settingsMirror?.setBpm(next);
}, [player.setBpm, settingsMirror]);
const setBpmPercent = useCallback((percent) => {
player.setBpmPercent(percent);
settingsMirror?.setBpmPercent(percent);
}, [player.setBpmPercent, settingsMirror]);
const setBeatsPerBar = useCallback((next) => {
player.setBeatsPerBar(next);
settingsMirror?.setBeatsPerBar(next);
}, [player.setBeatsPerBar, settingsMirror]);
const setCountInBars = useCallback((next) => {
player.setCountInBars(next);
settingsMirror?.setCountInBars(next);
}, [player.setCountInBars, settingsMirror]);
// The click persists globally, but the viewer's transport already read it at
// mount — mirror the change so the two don't disagree until a reload.
const setClickEnabled = useCallback((enabled) => {
player.setClickEnabled(enabled);
settingsMirror?.setClickEnabled(enabled);
}, [player.setClickEnabled, settingsMirror]);
const displayedText = player.playing ? snapshot : text;
return (
<div className="min-w-0">
{/* No bar at all for a sheet with nothing to play — a lyrics-only draft
shouldn't grow a dead transport above it. */}
{player.chordCount > 0 && (
<ChordTransportBar
playing={player.playing}
onToggle={player.toggle}
hasChords={player.hasChords}
bpm={player.bpm}
onBpmChange={setBpm}
onPercent={setBpmPercent}
writtenTempo={player.writtenTempo}
beatsPerBar={player.beatsPerBar}
onBeatsPerBarChange={setBeatsPerBar}
countInBars={player.countInBars}
onCountInChange={setCountInBars}
clickEnabled={player.clickEnabled}
onClickToggle={setClickEnabled}
chordCount={player.chordCount}
pulse={player.pulse}
/>
)}
{/* Only ever true while playing — the layout effect above resyncs the
snapshot the moment the player goes idle. */}
{chartChanged && (
<p className="px-3 py-1.5 text-xs text-port-warning bg-port-warning/10" role="status">
Sheet changed — press Play to reload.
</p>
)}
<div className={sheetClassName}>
<TabSheetView
text={displayedText}
format={format}
fontSizeRem={fontSizeRem}
instrumentView={instrumentView}
soundingChord={player.sounding}
/>
</div>
</div>
);
}