slim down doc comments, tidy inline notes

src/lib/utils/sounds.ts

@@ -1,8 +1,3 @@
-/**
- * Synthesized notification sounds using the Web Audio API.
- * No external audio files needed — all sounds are generated programmatically.
- */
-
 let audioCtx: AudioContext | null = null;
 
 function getAudioContext(): AudioContext {
@@ -14,11 +9,6 @@ function getAudioContext(): AudioContext {
 
 type SoundPreset = "bell" | "chime" | "soft" | "digital" | "harp" | "bowl" | "rain" | "whistle";
 
-/**
- * Play a notification sound with the given preset and volume.
- * @param preset - One of: "bell", "chime", "soft", "digital"
- * @param volume - 0 to 100
- */
 export function playSound(preset: SoundPreset, volume: number): void {
   const ctx = getAudioContext();
   const gain = ctx.createGain();
@@ -53,7 +43,7 @@ export function playSound(preset: SoundPreset, volume: number): void {
   }
 }
 
-/** Warm bell — two sine tones with harmonics and slow decay */
+/** Warm bell -- two sine tones with harmonics and slow decay */
 function playBell(ctx: AudioContext, destination: GainNode, vol: number) {
   const now = ctx.currentTime;
 
@@ -103,7 +93,7 @@ function playChime(ctx: AudioContext, destination: GainNode, vol: number) {
   });
 }
 
-/** Gentle soft ping — filtered triangle wave */
+/** Gentle soft ping -- filtered triangle wave */
 function playSoft(ctx: AudioContext, destination: GainNode, vol: number) {
   const now = ctx.currentTime;
 
@@ -129,7 +119,7 @@ function playSoft(ctx: AudioContext, destination: GainNode, vol: number) {
   osc.stop(now + 1.2);
 }
 
-/** Digital blip — short square wave burst */
+/** Digital blip -- short square wave burst */
 function playDigital(ctx: AudioContext, destination: GainNode, vol: number) {
   const now = ctx.currentTime;
 
@@ -149,7 +139,7 @@ function playDigital(ctx: AudioContext, destination: GainNode, vol: number) {
   }
 }
 
-/** Harp — cascading arpeggiated sine tones (C5-E5-G5-C6) */
+/** Harp -- cascading arpeggiated sine tones (C5-E5-G5-C6) */
 function playHarp(ctx: AudioContext, destination: GainNode, vol: number) {
   const now = ctx.currentTime;
   const notes = [523.25, 659.25, 783.99, 1046.5]; // C5, E5, G5, C6
@@ -170,7 +160,7 @@ function playHarp(ctx: AudioContext, destination: GainNode, vol: number) {
   });
 }
 
-/** Singing bowl — low sine with slow beating from detuned pair */
+/** Singing bowl -- low sine with slow beating from detuned pair */
 function playBowl(ctx: AudioContext, destination: GainNode, vol: number) {
   const now = ctx.currentTime;
 
@@ -201,7 +191,7 @@ function playBowl(ctx: AudioContext, destination: GainNode, vol: number) {
   osc3.stop(now + 1.5);
 }
 
-/** Rain — filtered noise burst with gentle decay */
+/** Rain -- filtered noise burst with gentle decay */
 function playRain(ctx: AudioContext, destination: GainNode, vol: number) {
   const now = ctx.currentTime;
   const bufferSize = ctx.sampleRate * 1;
@@ -233,7 +223,7 @@ function playRain(ctx: AudioContext, destination: GainNode, vol: number) {
   noise.stop(now + 1.0);
 }
 
-/** Whistle — gentle two-note sine glide */
+/** Whistle -- gentle two-note sine glide */
 function playWhistle(ctx: AudioContext, destination: GainNode, vol: number) {
   const now = ctx.currentTime;
 
@@ -256,7 +246,6 @@ function playWhistle(ctx: AudioContext, destination: GainNode, vol: number) {
   osc.stop(now + 1.0);
 }
 
-/** Play a completion sound — slightly different from start (descending) */
 export function playBreakEndSound(preset: SoundPreset, volume: number): void {
   const ctx = getAudioContext();
   const gain = ctx.createGain();