@dawcore/components 0.0.16 → 0.0.17

package/dist/index.d.mts

@@ -1,8 +1,9 @@
 import * as lit from 'lit';
 import { LitElement, PropertyValues, ReactiveController, ReactiveControllerHost } from 'lit';
-import { MidiNoteData, FadeType, Peaks, Bits, PeakData, MeterEntry, SnapTo, ClipTrack, KeyboardShortcut } from '@waveform-playlist/core';
+import { MidiNoteData, SpectrogramConfig, FadeType, Peaks, Bits, PeakData, MeterEntry, SnapTo, ColorMapValue, ClipTrack, KeyboardShortcut } from '@waveform-playlist/core';
 import WaveformData from 'waveform-data';
 import { PlayoutAdapter, PlaylistEngine } from '@waveform-playlist/engine';
+import { ClipRegistration, CanvasRegistration, ViewportState } from '@dawcore/spectrogram';
 
 declare class DawClipElement extends LitElement {
     src: string;
@@ -38,7 +39,7 @@ declare global {
     }
 }
 
-type TrackRenderMode = 'waveform' | 'piano-roll';
+type TrackRenderMode = 'waveform' | 'piano-roll' | 'spectrogram';
 interface TrackDescriptor {
     name: string;
     src: string;
@@ -47,6 +48,7 @@ interface TrackDescriptor {
     muted: boolean;
     soloed: boolean;
     renderMode: TrackRenderMode;
+    spectrogramConfig?: SpectrogramConfig | null;
     clips: ClipDescriptor[];
 }
 /**
@@ -104,6 +106,7 @@ interface TrackConfig {
     muted?: boolean;
     soloed?: boolean;
     renderMode?: TrackRenderMode;
+    spectrogramConfig?: SpectrogramConfig | null;
     clips?: ClipConfig[];
     /**
      * Convenience: creates a single piano-roll `<daw-clip>` child with these
@@ -151,6 +154,7 @@ declare class DawTrackElement extends LitElement {
     muted: boolean;
     soloed: boolean;
     renderMode: TrackRenderMode;
+    spectrogramConfig: SpectrogramConfig | null;
     readonly trackId: `${string}-${string}-${string}-${string}-${string}`;
     createRenderRoot(): this;
     connectedCallback(): void;
@@ -779,6 +783,9 @@ interface DawClipSplitDetail {
     readonly leftClipId: string;
     readonly rightClipId: string;
 }
+interface DawSpectrogramReadyDetail {
+    trackId: string;
+}
 interface DawEventMap {
     'daw-selection': CustomEvent<DawSelectionDetail>;
     'daw-seek': CustomEvent<DawSeekDetail>;
@@ -806,6 +813,7 @@ interface DawEventMap {
     'daw-clip-move': CustomEvent<DawClipMoveDetail>;
     'daw-clip-trim': CustomEvent<DawClipTrimDetail>;
     'daw-clip-split': CustomEvent<DawClipSplitDetail>;
+    'daw-spectrogram-ready': CustomEvent<DawSpectrogramReadyDetail>;
 }
 type DawEvent<K extends keyof DawEventMap> = DawEventMap[K];
 interface LoadFilesResult {
@@ -836,6 +844,44 @@ declare class DawEditorElement extends LitElement {
      * floor already provides this; this attribute controls the temporal mode.
      */
     indefinitePlayback: boolean;
+    /**
+     * Default spectrogram FFT/render config inherited by tracks with
+     * `render-mode="spectrogram"` that do not set their own. Wired into the
+     * orchestrator by `SpectrogramController` in Task 14.
+     */
+    get spectrogramConfig(): SpectrogramConfig | null;
+    set spectrogramConfig(value: SpectrogramConfig | null);
+    private _spectrogramConfig;
+    /**
+     * Default color map for spectrogram tracks. Tracks may override via
+     * their own per-track property in a future iteration. Separate from
+     * `spectrogramConfig` because `ColorMapValue` is not part of the
+     * `SpectrogramConfig` shape.
+     */
+    get spectrogramColorMap(): ColorMapValue | null;
+    set spectrogramColorMap(value: ColorMapValue | null);
+    private _spectrogramColorMap;
+    private _ensureSpectrogramController;
+    /** Called by <daw-spectrogram> after transferControlToOffscreen. */
+    _spectrogramRegisterCanvas(reg: {
+        canvasId: string;
+        canvas: OffscreenCanvas;
+        clipId: string;
+        trackId: string;
+        channelIndex: number;
+        chunkIndex: number;
+        globalPixelOffset: number;
+        widthPx: number;
+        heightPx: number;
+    }): void;
+    /** Called by <daw-spectrogram> on chunk unmount / element disconnect. */
+    _spectrogramUnregisterCanvas(canvasId: string): void;
+    /**
+     * Push a clip's decoded audio into the spectrogram controller. No-op
+     * unless the track is in spectrogram render-mode and the controller
+     * already exists (it bootstraps from canvas registration).
+     */
+    private _maybeRegisterSpectrogramClipAudio;
     scaleMode: 'temporal' | 'beats';
     get ticksPerPixel(): number;
     set ticksPerPixel(value: number);
@@ -892,6 +938,7 @@ declare class DawEditorElement extends LitElement {
     private _audioResume;
     eagerResume?: string;
     private _recordingController;
+    private _spectrogramController;
     private _clipPointer;
     get _clipHandler(): ClipPointerHandler | null;
     get engine(): PlaylistEngine | null;
@@ -932,9 +979,12 @@ declare class DawEditorElement extends LitElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     willUpdate(changedProperties: Map<string, unknown>): void;
+    protected updated(_changed: Map<string, unknown>): void;
     private _onTrackConnected;
     private _onTrackRemoved;
     private _onTrackUpdate;
+    /** Drop the controller when no spectrogram tracks remain. */
+    private _disposeSpectrogramControllerIfEmpty;
     private static _CONTROL_PROPS;
     private _onTrackControl;
     private _onTrackRemoveRequest;
@@ -1228,6 +1278,89 @@ declare global {
     }
 }
 
+declare class DawSpectrogramElement extends LitElement {
+    clipId: string;
+    trackId: string;
+    channelIndex: number;
+    length: number;
+    waveHeight: number;
+    get samplesPerPixel(): number;
+    set samplesPerPixel(value: number);
+    private _samplesPerPixel;
+    get sampleRate(): number;
+    set sampleRate(value: number);
+    private _sampleRate;
+    clipOffsetSeconds: number;
+    visibleStart: number;
+    visibleEnd: number;
+    originX: number;
+    static styles: lit.CSSResult;
+    private _canvases;
+    private _registeredCanvasIds;
+    /**
+     * Walk up to the editor host. `closest('daw-editor')` does NOT cross
+     * shadow boundaries — and this element lives inside the editor's shadow
+     * DOM — so use getRootNode().host to step out.
+     */
+    private _findHostEditor;
+    willUpdate(changed: PropertyValues): void;
+    private _rebuildChunks;
+    protected updated(_changed: PropertyValues): void;
+    private _registerCanvases;
+    private _unregisterAllCanvases;
+    disconnectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'daw-spectrogram': DawSpectrogramElement;
+    }
+}
+
+interface SpectrogramControllerHost extends ReactiveControllerHost {
+    dispatchEvent(event: Event): boolean;
+}
+/**
+ * Lit reactive controller that owns a `SpectrogramOrchestrator` for the
+ * `<daw-editor>` host. Creates the orchestrator lazily on first canvas
+ * registration so editors without spectrogram tracks pay nothing.
+ *
+ * Holds editor-level defaults and per-track overrides separately; merges
+ * them down to a single (config, colorMap) pair for the orchestrator on
+ * each change.
+ *
+ * v1 limitation: orchestrator accepts ONE config / colorMap at a time, so
+ * the "first registered track wins" rule applies when multiple tracks are
+ * in spectrogram mode with different overrides. Multi-track per-clip
+ * configs are deferred to a follow-up.
+ */
+declare class SpectrogramController implements ReactiveController {
+    private host;
+    private workerFactory;
+    private orchestrator;
+    private editorConfig;
+    private editorColorMap;
+    private trackConfigs;
+    private trackColorMaps;
+    constructor(host: SpectrogramControllerHost, workerFactory: () => Worker);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    setEditorConfig(config: SpectrogramConfig | null): void;
+    setEditorColorMap(colorMap: ColorMapValue | null): void;
+    setTrackConfig(trackId: string, config: SpectrogramConfig | null): void;
+    setTrackColorMap(trackId: string, colorMap: ColorMapValue | null): void;
+    registerClipAudio(reg: ClipRegistration): void;
+    unregisterClipAudio(clipId: string): void;
+    registerCanvas(reg: CanvasRegistration): void;
+    unregisterCanvas(canvasId: string): void;
+    setViewport(state: ViewportState): void;
+    dispose(): void;
+    private ensureOrchestrator;
+    private reapply;
+    private mergedConfig;
+    private mergedColorMap;
+}
+
 interface AudioResumeHost extends ReactiveControllerHost, HTMLElement {
     /** Returns the AudioContext to resume on user gesture */
     readonly audioContext: AudioContext;
@@ -1284,4 +1417,4 @@ interface SplitHost {
  */
 declare function splitAtPlayhead(host: SplitHost): boolean;
 
-export { AudioResumeController, type ClipConfig, type ClipDescriptor, type ClipEngineContract, ClipPointerHandler, type ClipPointerHost, type DawClipConnectedDetail, DawClipElement, type DawClipErrorDetail, type DawClipIdDetail, type DawClipMoveDetail, type DawClipSplitDetail, type DawClipTrimDetail, type DawClipUpdateDetail, DawEditorElement, type DawErrorDetail, type DawEvent, type DawEventMap, type DawFilesLoadErrorDetail, DawGridElement, DawKeyboardShortcutsElement, DawPauseButtonElement, DawPianoRollElement, DawPlayButtonElement, DawPlayheadElement, DawRecordButtonElement, type DawRecordingCompleteDetail, type DawRecordingErrorDetail, type DawRecordingStartDetail, DawRulerElement, type DawSeekDetail, type DawSelectionDetail, DawSelectionElement, DawStopButtonElement, type DawTrackConnectedDetail, type DawTrackControlDetail, DawTrackControlsElement, DawTrackElement, type DawTrackErrorDetail, type DawTrackIdDetail, type DawTrackRemoveDetail, type DawTrackSelectDetail, DawTransportButton, DawTransportElement, DawWaveformElement, type DomClipDescriptor, type DropClipDescriptor, type KeyBinding, type LoadFilesResult, type PlaybackShortcutMap, type PointerEngineContract, RecordingController, type RecordingOptions, type RecordingSession, type SplitEngineContract, type SplitHost, type SplittingShortcutMap, type TrackConfig, type TrackDescriptor, type TrackRenderMode, type UndoShortcutMap, type WaveformSegment, isDomClip, splitAtPlayhead };
+export { AudioResumeController, type ClipConfig, type ClipDescriptor, type ClipEngineContract, ClipPointerHandler, type ClipPointerHost, type DawClipConnectedDetail, DawClipElement, type DawClipErrorDetail, type DawClipIdDetail, type DawClipMoveDetail, type DawClipSplitDetail, type DawClipTrimDetail, type DawClipUpdateDetail, DawEditorElement, type DawErrorDetail, type DawEvent, type DawEventMap, type DawFilesLoadErrorDetail, DawGridElement, DawKeyboardShortcutsElement, DawPauseButtonElement, DawPianoRollElement, DawPlayButtonElement, DawPlayheadElement, DawRecordButtonElement, type DawRecordingCompleteDetail, type DawRecordingErrorDetail, type DawRecordingStartDetail, DawRulerElement, type DawSeekDetail, type DawSelectionDetail, DawSelectionElement, DawSpectrogramElement, DawStopButtonElement, type DawTrackConnectedDetail, type DawTrackControlDetail, DawTrackControlsElement, DawTrackElement, type DawTrackErrorDetail, type DawTrackIdDetail, type DawTrackRemoveDetail, type DawTrackSelectDetail, DawTransportButton, DawTransportElement, DawWaveformElement, type DomClipDescriptor, type DropClipDescriptor, type KeyBinding, type LoadFilesResult, type PlaybackShortcutMap, type PointerEngineContract, RecordingController, type RecordingOptions, type RecordingSession, SpectrogramController, type SplitEngineContract, type SplitHost, type SplittingShortcutMap, type TrackConfig, type TrackDescriptor, type TrackRenderMode, type UndoShortcutMap, type WaveformSegment, isDomClip, splitAtPlayhead };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import * as lit from 'lit';
 import { LitElement, PropertyValues, ReactiveController, ReactiveControllerHost } from 'lit';
-import { MidiNoteData, FadeType, Peaks, Bits, PeakData, MeterEntry, SnapTo, ClipTrack, KeyboardShortcut } from '@waveform-playlist/core';
+import { MidiNoteData, SpectrogramConfig, FadeType, Peaks, Bits, PeakData, MeterEntry, SnapTo, ColorMapValue, ClipTrack, KeyboardShortcut } from '@waveform-playlist/core';
 import WaveformData from 'waveform-data';
 import { PlayoutAdapter, PlaylistEngine } from '@waveform-playlist/engine';
+import { ClipRegistration, CanvasRegistration, ViewportState } from '@dawcore/spectrogram';
 
 declare class DawClipElement extends LitElement {
     src: string;
@@ -38,7 +39,7 @@ declare global {
     }
 }
 
-type TrackRenderMode = 'waveform' | 'piano-roll';
+type TrackRenderMode = 'waveform' | 'piano-roll' | 'spectrogram';
 interface TrackDescriptor {
     name: string;
     src: string;
@@ -47,6 +48,7 @@ interface TrackDescriptor {
     muted: boolean;
     soloed: boolean;
     renderMode: TrackRenderMode;
+    spectrogramConfig?: SpectrogramConfig | null;
     clips: ClipDescriptor[];
 }
 /**
@@ -104,6 +106,7 @@ interface TrackConfig {
     muted?: boolean;
     soloed?: boolean;
     renderMode?: TrackRenderMode;
+    spectrogramConfig?: SpectrogramConfig | null;
     clips?: ClipConfig[];
     /**
      * Convenience: creates a single piano-roll `<daw-clip>` child with these
@@ -151,6 +154,7 @@ declare class DawTrackElement extends LitElement {
     muted: boolean;
     soloed: boolean;
     renderMode: TrackRenderMode;
+    spectrogramConfig: SpectrogramConfig | null;
     readonly trackId: `${string}-${string}-${string}-${string}-${string}`;
     createRenderRoot(): this;
     connectedCallback(): void;
@@ -779,6 +783,9 @@ interface DawClipSplitDetail {
     readonly leftClipId: string;
     readonly rightClipId: string;
 }
+interface DawSpectrogramReadyDetail {
+    trackId: string;
+}
 interface DawEventMap {
     'daw-selection': CustomEvent<DawSelectionDetail>;
     'daw-seek': CustomEvent<DawSeekDetail>;
@@ -806,6 +813,7 @@ interface DawEventMap {
     'daw-clip-move': CustomEvent<DawClipMoveDetail>;
     'daw-clip-trim': CustomEvent<DawClipTrimDetail>;
     'daw-clip-split': CustomEvent<DawClipSplitDetail>;
+    'daw-spectrogram-ready': CustomEvent<DawSpectrogramReadyDetail>;
 }
 type DawEvent<K extends keyof DawEventMap> = DawEventMap[K];
 interface LoadFilesResult {
@@ -836,6 +844,44 @@ declare class DawEditorElement extends LitElement {
      * floor already provides this; this attribute controls the temporal mode.
      */
     indefinitePlayback: boolean;
+    /**
+     * Default spectrogram FFT/render config inherited by tracks with
+     * `render-mode="spectrogram"` that do not set their own. Wired into the
+     * orchestrator by `SpectrogramController` in Task 14.
+     */
+    get spectrogramConfig(): SpectrogramConfig | null;
+    set spectrogramConfig(value: SpectrogramConfig | null);
+    private _spectrogramConfig;
+    /**
+     * Default color map for spectrogram tracks. Tracks may override via
+     * their own per-track property in a future iteration. Separate from
+     * `spectrogramConfig` because `ColorMapValue` is not part of the
+     * `SpectrogramConfig` shape.
+     */
+    get spectrogramColorMap(): ColorMapValue | null;
+    set spectrogramColorMap(value: ColorMapValue | null);
+    private _spectrogramColorMap;
+    private _ensureSpectrogramController;
+    /** Called by <daw-spectrogram> after transferControlToOffscreen. */
+    _spectrogramRegisterCanvas(reg: {
+        canvasId: string;
+        canvas: OffscreenCanvas;
+        clipId: string;
+        trackId: string;
+        channelIndex: number;
+        chunkIndex: number;
+        globalPixelOffset: number;
+        widthPx: number;
+        heightPx: number;
+    }): void;
+    /** Called by <daw-spectrogram> on chunk unmount / element disconnect. */
+    _spectrogramUnregisterCanvas(canvasId: string): void;
+    /**
+     * Push a clip's decoded audio into the spectrogram controller. No-op
+     * unless the track is in spectrogram render-mode and the controller
+     * already exists (it bootstraps from canvas registration).
+     */
+    private _maybeRegisterSpectrogramClipAudio;
     scaleMode: 'temporal' | 'beats';
     get ticksPerPixel(): number;
     set ticksPerPixel(value: number);
@@ -892,6 +938,7 @@ declare class DawEditorElement extends LitElement {
     private _audioResume;
     eagerResume?: string;
     private _recordingController;
+    private _spectrogramController;
     private _clipPointer;
     get _clipHandler(): ClipPointerHandler | null;
     get engine(): PlaylistEngine | null;
@@ -932,9 +979,12 @@ declare class DawEditorElement extends LitElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     willUpdate(changedProperties: Map<string, unknown>): void;
+    protected updated(_changed: Map<string, unknown>): void;
     private _onTrackConnected;
     private _onTrackRemoved;
     private _onTrackUpdate;
+    /** Drop the controller when no spectrogram tracks remain. */
+    private _disposeSpectrogramControllerIfEmpty;
     private static _CONTROL_PROPS;
     private _onTrackControl;
     private _onTrackRemoveRequest;
@@ -1228,6 +1278,89 @@ declare global {
     }
 }
 
+declare class DawSpectrogramElement extends LitElement {
+    clipId: string;
+    trackId: string;
+    channelIndex: number;
+    length: number;
+    waveHeight: number;
+    get samplesPerPixel(): number;
+    set samplesPerPixel(value: number);
+    private _samplesPerPixel;
+    get sampleRate(): number;
+    set sampleRate(value: number);
+    private _sampleRate;
+    clipOffsetSeconds: number;
+    visibleStart: number;
+    visibleEnd: number;
+    originX: number;
+    static styles: lit.CSSResult;
+    private _canvases;
+    private _registeredCanvasIds;
+    /**
+     * Walk up to the editor host. `closest('daw-editor')` does NOT cross
+     * shadow boundaries — and this element lives inside the editor's shadow
+     * DOM — so use getRootNode().host to step out.
+     */
+    private _findHostEditor;
+    willUpdate(changed: PropertyValues): void;
+    private _rebuildChunks;
+    protected updated(_changed: PropertyValues): void;
+    private _registerCanvases;
+    private _unregisterAllCanvases;
+    disconnectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'daw-spectrogram': DawSpectrogramElement;
+    }
+}
+
+interface SpectrogramControllerHost extends ReactiveControllerHost {
+    dispatchEvent(event: Event): boolean;
+}
+/**
+ * Lit reactive controller that owns a `SpectrogramOrchestrator` for the
+ * `<daw-editor>` host. Creates the orchestrator lazily on first canvas
+ * registration so editors without spectrogram tracks pay nothing.
+ *
+ * Holds editor-level defaults and per-track overrides separately; merges
+ * them down to a single (config, colorMap) pair for the orchestrator on
+ * each change.
+ *
+ * v1 limitation: orchestrator accepts ONE config / colorMap at a time, so
+ * the "first registered track wins" rule applies when multiple tracks are
+ * in spectrogram mode with different overrides. Multi-track per-clip
+ * configs are deferred to a follow-up.
+ */
+declare class SpectrogramController implements ReactiveController {
+    private host;
+    private workerFactory;
+    private orchestrator;
+    private editorConfig;
+    private editorColorMap;
+    private trackConfigs;
+    private trackColorMaps;
+    constructor(host: SpectrogramControllerHost, workerFactory: () => Worker);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    setEditorConfig(config: SpectrogramConfig | null): void;
+    setEditorColorMap(colorMap: ColorMapValue | null): void;
+    setTrackConfig(trackId: string, config: SpectrogramConfig | null): void;
+    setTrackColorMap(trackId: string, colorMap: ColorMapValue | null): void;
+    registerClipAudio(reg: ClipRegistration): void;
+    unregisterClipAudio(clipId: string): void;
+    registerCanvas(reg: CanvasRegistration): void;
+    unregisterCanvas(canvasId: string): void;
+    setViewport(state: ViewportState): void;
+    dispose(): void;
+    private ensureOrchestrator;
+    private reapply;
+    private mergedConfig;
+    private mergedColorMap;
+}
+
 interface AudioResumeHost extends ReactiveControllerHost, HTMLElement {
     /** Returns the AudioContext to resume on user gesture */
     readonly audioContext: AudioContext;
@@ -1284,4 +1417,4 @@ interface SplitHost {
  */
 declare function splitAtPlayhead(host: SplitHost): boolean;
 
-export { AudioResumeController, type ClipConfig, type ClipDescriptor, type ClipEngineContract, ClipPointerHandler, type ClipPointerHost, type DawClipConnectedDetail, DawClipElement, type DawClipErrorDetail, type DawClipIdDetail, type DawClipMoveDetail, type DawClipSplitDetail, type DawClipTrimDetail, type DawClipUpdateDetail, DawEditorElement, type DawErrorDetail, type DawEvent, type DawEventMap, type DawFilesLoadErrorDetail, DawGridElement, DawKeyboardShortcutsElement, DawPauseButtonElement, DawPianoRollElement, DawPlayButtonElement, DawPlayheadElement, DawRecordButtonElement, type DawRecordingCompleteDetail, type DawRecordingErrorDetail, type DawRecordingStartDetail, DawRulerElement, type DawSeekDetail, type DawSelectionDetail, DawSelectionElement, DawStopButtonElement, type DawTrackConnectedDetail, type DawTrackControlDetail, DawTrackControlsElement, DawTrackElement, type DawTrackErrorDetail, type DawTrackIdDetail, type DawTrackRemoveDetail, type DawTrackSelectDetail, DawTransportButton, DawTransportElement, DawWaveformElement, type DomClipDescriptor, type DropClipDescriptor, type KeyBinding, type LoadFilesResult, type PlaybackShortcutMap, type PointerEngineContract, RecordingController, type RecordingOptions, type RecordingSession, type SplitEngineContract, type SplitHost, type SplittingShortcutMap, type TrackConfig, type TrackDescriptor, type TrackRenderMode, type UndoShortcutMap, type WaveformSegment, isDomClip, splitAtPlayhead };
+export { AudioResumeController, type ClipConfig, type ClipDescriptor, type ClipEngineContract, ClipPointerHandler, type ClipPointerHost, type DawClipConnectedDetail, DawClipElement, type DawClipErrorDetail, type DawClipIdDetail, type DawClipMoveDetail, type DawClipSplitDetail, type DawClipTrimDetail, type DawClipUpdateDetail, DawEditorElement, type DawErrorDetail, type DawEvent, type DawEventMap, type DawFilesLoadErrorDetail, DawGridElement, DawKeyboardShortcutsElement, DawPauseButtonElement, DawPianoRollElement, DawPlayButtonElement, DawPlayheadElement, DawRecordButtonElement, type DawRecordingCompleteDetail, type DawRecordingErrorDetail, type DawRecordingStartDetail, DawRulerElement, type DawSeekDetail, type DawSelectionDetail, DawSelectionElement, DawSpectrogramElement, DawStopButtonElement, type DawTrackConnectedDetail, type DawTrackControlDetail, DawTrackControlsElement, DawTrackElement, type DawTrackErrorDetail, type DawTrackIdDetail, type DawTrackRemoveDetail, type DawTrackSelectDetail, DawTransportButton, DawTransportElement, DawWaveformElement, type DomClipDescriptor, type DropClipDescriptor, type KeyBinding, type LoadFilesResult, type PlaybackShortcutMap, type PointerEngineContract, RecordingController, type RecordingOptions, type RecordingSession, SpectrogramController, type SplitEngineContract, type SplitHost, type SplittingShortcutMap, type TrackConfig, type TrackDescriptor, type TrackRenderMode, type UndoShortcutMap, type WaveformSegment, isDomClip, splitAtPlayhead };