audio_waveform_kit

Fixes

• AudioRecordingBloc — PCM с платформенного канала читался как chunk.buffer.asInt16List(): от начала буфера сообщения и на всю его длину, мимо offsetInBytes и длины самого чанка. В визуализацию и спектр уходили служебные байты сообщения и соседние куски, а при нечётном смещении PCM16 разъезжался на байт — любой звук превращался в шум почти полной громкости, одинаковый и в тишине, и под речь. На записанный файл это не влияло: сервис пишет чанк сам. Теперь Int16List.sublistView(chunk), с копией при нечётном смещении
• AudioUtils.wavToSamples — та же ошибка в wavBytes.buffer.asInt16List(44): для вью читались чужие байты
• StringSnapshotPainter — размах «струны» не зависел от громкости: каждый кадр нормировался на собственный пик (scale = 1 / peak), поэтому и тихий шум, и громкая речь рисовались во всю высоту. Теперь размах задаётся уровнем сигнала (RMS) по логарифмической шкале floorDb…ceilingDb: тишина — прямая линия, шум комнаты — мелкая дрожь, речь — полный размах. Линейного усиления нет: между шумом и речью 30–40 дБ, одним множителем оба конца шкалы не показать
• StringSnapshotPainter — форма волны нормируется отдельно от размаха, поэтому кривая больше не срезается по границе бокса
• StringSnapshotPainter — сырые сэмплы рисовались точка-в-сэмпл (2048 точек на ~360 px), на экране это полоса шума. Теперь усредняются до одной точки на pointSpacing логических пикселей; усреднение работает как ФНЧ
• StringSnapshotPainter — окно снапшота съезжало по фазе на каждый чанк, волна ползла по горизонтали. Добавлен триггер по переходу через ноль снизу вверх (alignToZeroCrossing); сдвиг берётся из запаса точек, поэтому горизонтальный масштаб не меняется от кадра к кадру
• StringSnapshotPainter — контрольной точкой квадратичной кривой брался предыдущий сэмпл вместо текущего: кривая шла на шаг позади данных, а последний сегмент проходил прямой хордой мимо предпоследней точки
• StringSnapshotPainter.shouldRepaint — сравнивал только samples и stringColor; смена остальных параметров не перерисовывала холст
• AudioRecordingBloc.waveformSamples — точки брались мгновенным отсчётом (каждый 441-й сэмпл): на самом громком слоге могла попасться фаза перехода через ноль и дать 0. Теперь это RMS-энергия по окнам ~10 мс — честная огибающая, неотрицательные значения. Окно RMS также было захардкожено под 44100 Гц (441 сэмпл); теперь считается от spectrumConfig.sampleRate, а остаток окна переносится через границу чанка вместо того, чтобы теряться
• RecordingLevelPainter — высота столбика бралась из мгновенного отсчёта линейно; после смены семантики waveformSamples (см. выше) индикатор всегда выглядел почти пустым на речи (−22 dBFS RMS = 8% высоты). Теперь высота — по той же логарифмической шкале floorDb/ceilingDb, что и у струны
• RecordingLevelPainter.shouldRepaint — сравнивал только samples и barColor; barSpacing, minBarHeightFraction и новые floorDb/ceilingDb не перерисовывали холст
• WaveformPainter (WaveformStyle.envelope) — каждый кадр нормировался на собственный пик (scale = 1 / peak), та же болезнь, что была у струны: тишина и речь рисовались во всю высоту. Теперь размах — по логарифмической шкале floorDb/ceilingDb
• WaveformDisplay (WaveformStyle.string) — рисовал дубль струны на 56 децимированных, после смены семантики waveformSamples уже неотрицательных (знака нет) отсчётах. Теперь при style: WaveformStyle.string рендерится StringSnapshotDisplay — он читает полные snapshotSamples и уже умеет форму, размах и триггер по нулю
• MessengerWaveformDisplay (живой виджет) — дефолт logarithmic: false (нормировка на глобальный пик) на скроллящемся окне прыгал на каждом кадре, а без окна один громкий всплеск пережимал всё, что было до него. Дефолт изменён на logarithmic: true. StaticMessengerWaveformDisplay (весь клип целиком) не тронут — пиковая нормировка там осознанный «телеграмный» вид
• MessengerWaveformPainter.shouldRepaint — не сравнивал silenceThreshold, minDbThreshold, barSpacing

Changes

• StringSnapshotDisplay, StaticStringSnapshotDisplay, StringSnapshotPainter — новые параметры floorDb, ceilingDb, autoGain, maxGain, pointSpacing, alignToZeroCrossing. Сигнатуры совместимы, но вид по умолчанию изменился. Прежний возвращается комбинацией autoGain: true, pointSpacing: 0, alignToZeroCrossing: false
• RecordingLevelDisplay, StaticLevelDisplay, RecordingLevelPainter — новые параметры floorDb (-55.0), ceilingDb (-15.0)
• WaveformDisplay, WaveformPainter — новые параметры floorDb (-55.0), ceilingDb (-15.0) для WaveformStyle.envelope; для WaveformStyle.string игнорируются
• MessengerWaveformDisplay — дефолт logarithmic изменён с false на true (см. Fixes)
• dB-математика (rmsOf, amplitudeForRms) вынесена в один файл lib/src/utils/level_scale.dart — раньше жила отдельно в StringSnapshotPainter и дублировалась бы в MessengerWaveformPainter. Не экспортируется из audio_waveform_kit.dart, публичный API не растёт