@dawcore/components 0.0.1 → 0.0.3

package/dist/index.js

@@ -39,8 +39,10 @@ var __decorateClass = (decorators, target, key, kind) => {
 var index_exports = {};
 __export(index_exports, {
   AudioResumeController: () => AudioResumeController,
+  ClipPointerHandler: () => ClipPointerHandler,
   DawClipElement: () => DawClipElement,
   DawEditorElement: () => DawEditorElement,
+  DawKeyboardShortcutsElement: () => DawKeyboardShortcutsElement,
   DawPauseButtonElement: () => DawPauseButtonElement,
   DawPlayButtonElement: () => DawPlayButtonElement,
   DawPlayheadElement: () => DawPlayheadElement,
@@ -53,7 +55,8 @@ __export(index_exports, {
   DawTransportButton: () => DawTransportButton,
   DawTransportElement: () => DawTransportElement,
   DawWaveformElement: () => DawWaveformElement,
-  RecordingController: () => RecordingController
+  RecordingController: () => RecordingController,
+  splitAtPlayhead: () => splitAtPlayhead
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -629,9 +632,40 @@ DawTransportButton.styles = import_lit6.css`
 
 // src/elements/daw-play-button.ts
 var DawPlayButtonElement = class extends DawTransportButton {
+  constructor() {
+    super(...arguments);
+    this._isRecording = false;
+    this._targetRef = null;
+    this._onRecStart = () => {
+      this._isRecording = true;
+    };
+    this._onRecEnd = () => {
+      this._isRecording = false;
+    };
+  }
+  connectedCallback() {
+    super.connectedCallback();
+    requestAnimationFrame(() => {
+      const target = this.target;
+      if (!target) return;
+      this._targetRef = target;
+      target.addEventListener("daw-recording-start", this._onRecStart);
+      target.addEventListener("daw-recording-complete", this._onRecEnd);
+      target.addEventListener("daw-recording-error", this._onRecEnd);
+    });
+  }
+  disconnectedCallback() {
+    super.disconnectedCallback();
+    if (this._targetRef) {
+      this._targetRef.removeEventListener("daw-recording-start", this._onRecStart);
+      this._targetRef.removeEventListener("daw-recording-complete", this._onRecEnd);
+      this._targetRef.removeEventListener("daw-recording-error", this._onRecEnd);
+      this._targetRef = null;
+    }
+  }
   render() {
     return import_lit7.html`
-      <button part="button" @click=${this._onClick}>
+      <button part="button" ?disabled=${this._isRecording} @click=${this._onClick}>
         <slot>Play</slot>
       </button>
     `;
@@ -647,6 +681,9 @@ var DawPlayButtonElement = class extends DawTransportButton {
     target.play();
   }
 };
+__decorateClass([
+  (0, import_decorators6.state)()
+], DawPlayButtonElement.prototype, "_isRecording", 2);
 DawPlayButtonElement = __decorateClass([
   (0, import_decorators6.customElement)("daw-play-button")
 ], DawPlayButtonElement);
@@ -655,9 +692,42 @@ DawPlayButtonElement = __decorateClass([
 var import_lit8 = require("lit");
 var import_decorators7 = require("lit/decorators.js");
 var DawPauseButtonElement = class extends DawTransportButton {
+  constructor() {
+    super(...arguments);
+    this._isPaused = false;
+    this._isRecording = false;
+    this._targetRef = null;
+    this._onRecStart = () => {
+      this._isRecording = true;
+    };
+    this._onRecEnd = () => {
+      this._isRecording = false;
+      this._isPaused = false;
+    };
+  }
+  connectedCallback() {
+    super.connectedCallback();
+    requestAnimationFrame(() => {
+      const target = this.target;
+      if (!target) return;
+      this._targetRef = target;
+      target.addEventListener("daw-recording-start", this._onRecStart);
+      target.addEventListener("daw-recording-complete", this._onRecEnd);
+      target.addEventListener("daw-recording-error", this._onRecEnd);
+    });
+  }
+  disconnectedCallback() {
+    super.disconnectedCallback();
+    if (this._targetRef) {
+      this._targetRef.removeEventListener("daw-recording-start", this._onRecStart);
+      this._targetRef.removeEventListener("daw-recording-complete", this._onRecEnd);
+      this._targetRef.removeEventListener("daw-recording-error", this._onRecEnd);
+      this._targetRef = null;
+    }
+  }
   render() {
     return import_lit8.html`
-      <button part="button" @click=${this._onClick}>
+      <button part="button" ?data-paused=${this._isPaused} @click=${this._onClick}>
         <slot>Pause</slot>
       </button>
     `;
@@ -670,9 +740,36 @@ var DawPauseButtonElement = class extends DawTransportButton {
       );
       return;
     }
-    target.pause();
+    if (this._isRecording) {
+      if (this._isPaused) {
+        target.resumeRecording();
+        target.play(target.currentTime);
+        this._isPaused = false;
+      } else {
+        target.pauseRecording();
+        target.pause();
+        this._isPaused = true;
+      }
+    } else {
+      target.pause();
+    }
   }
 };
+DawPauseButtonElement.styles = [
+  DawTransportButton.styles,
+  import_lit8.css`
+      button[data-paused] {
+        background: rgba(255, 255, 255, 0.1);
+        border-color: var(--daw-controls-text, #e0d4c8);
+      }
+    `
+];
+__decorateClass([
+  (0, import_decorators7.state)()
+], DawPauseButtonElement.prototype, "_isPaused", 2);
+__decorateClass([
+  (0, import_decorators7.state)()
+], DawPauseButtonElement.prototype, "_isRecording", 2);
 DawPauseButtonElement = __decorateClass([
   (0, import_decorators7.customElement)("daw-pause-button")
 ], DawPauseButtonElement);
@@ -696,6 +793,9 @@ var DawStopButtonElement = class extends DawTransportButton {
       );
       return;
     }
+    if (target.isRecording) {
+      target.stopRecording();
+    }
     target.stop();
   }
 };
@@ -1027,20 +1127,22 @@ function extractPeaks(waveformData, samplesPerPixel, isMono, offsetSamples, dura
 
 // src/workers/peakPipeline.ts
 var PeakPipeline = class {
-  constructor() {
+  constructor(baseScale = 128, bits = 16) {
     this._worker = null;
     this._cache = /* @__PURE__ */ new WeakMap();
     this._inflight = /* @__PURE__ */ new WeakMap();
+    this._baseScale = baseScale;
+    this._bits = bits;
   }
   /**
    * Generate PeakData for a clip from its AudioBuffer.
    * Uses cached WaveformData when available; otherwise generates via worker.
-   * The worker generates at `scale` (= samplesPerPixel) for exact rendering.
+   * Worker generates at baseScale (default 128); extractPeaks resamples to the requested zoom.
    */
-  async generatePeaks(audioBuffer, samplesPerPixel, isMono) {
-    const waveformData = await this._getWaveformData(audioBuffer, samplesPerPixel);
+  async generatePeaks(audioBuffer, samplesPerPixel, isMono, offsetSamples, durationSamples) {
+    const waveformData = await this._getWaveformData(audioBuffer);
     try {
-      return extractPeaks(waveformData, samplesPerPixel, isMono);
+      return extractPeaks(waveformData, samplesPerPixel, isMono, offsetSamples, durationSamples);
     } catch (err) {
       console.warn("[dawcore] extractPeaks failed: " + String(err));
       throw err;
@@ -1052,14 +1154,24 @@ var PeakPipeline = class {
    * Returns a new Map of clipId → PeakData. Clips without cached data or where
    * the target scale is finer than the cached base are skipped.
    */
-  reextractPeaks(clipBuffers, samplesPerPixel, isMono) {
+  reextractPeaks(clipBuffers, samplesPerPixel, isMono, clipOffsets) {
     const result = /* @__PURE__ */ new Map();
     for (const [clipId, audioBuffer] of clipBuffers) {
       const cached = this._cache.get(audioBuffer);
       if (cached) {
         if (samplesPerPixel < cached.scale) continue;
         try {
-          result.set(clipId, extractPeaks(cached, samplesPerPixel, isMono));
+          const offsets = clipOffsets?.get(clipId);
+          result.set(
+            clipId,
+            extractPeaks(
+              cached,
+              samplesPerPixel,
+              isMono,
+              offsets?.offsetSamples,
+              offsets?.durationSamples
+            )
+          );
         } catch (err) {
           console.warn("[dawcore] reextractPeaks failed for clip " + clipId + ": " + String(err));
         }
@@ -1071,9 +1183,9 @@ var PeakPipeline = class {
     this._worker?.terminate();
     this._worker = null;
   }
-  async _getWaveformData(audioBuffer, samplesPerPixel) {
+  async _getWaveformData(audioBuffer) {
     const cached = this._cache.get(audioBuffer);
-    if (cached && cached.scale <= samplesPerPixel) return cached;
+    if (cached) return cached;
     const inflight = this._inflight.get(audioBuffer);
     if (inflight) return inflight;
     if (!this._worker) {
@@ -1087,8 +1199,8 @@ var PeakPipeline = class {
       channels,
       length: audioBuffer.length,
       sampleRate: audioBuffer.sampleRate,
-      scale: samplesPerPixel,
-      bits: 16,
+      scale: this._baseScale,
+      bits: this._bits,
       splitChannels: true
     }).then((waveformData) => {
       this._cache.set(audioBuffer, waveformData);
@@ -1209,7 +1321,7 @@ DawTrackControlsElement.styles = import_lit10.css`
     :host {
       display: flex;
       flex-direction: column;
-      justify-content: center;
+      justify-content: flex-start;
       box-sizing: border-box;
       padding: 6px 8px;
       background: var(--daw-controls-background, #0f0f1a);
@@ -1217,13 +1329,14 @@ DawTrackControlsElement.styles = import_lit10.css`
       border-bottom: 1px solid rgba(255, 255, 255, 0.05);
       font-family: system-ui, sans-serif;
       font-size: 11px;
+      overflow: hidden;
     }
     .header {
       display: flex;
       align-items: center;
       justify-content: space-between;
       gap: 4px;
-      margin-bottom: 6px;
+      margin-bottom: 3px;
     }
     .name {
       flex: 1;
@@ -1250,7 +1363,7 @@ DawTrackControlsElement.styles = import_lit10.css`
     .buttons {
       display: flex;
       gap: 3px;
-      margin-bottom: 6px;
+      margin-bottom: 3px;
     }
     .btn {
       background: rgba(255, 255, 255, 0.06);
@@ -1280,7 +1393,7 @@ DawTrackControlsElement.styles = import_lit10.css`
       display: flex;
       align-items: center;
       gap: 4px;
-      height: 20px;
+      height: 16px;
     }
     .slider-label {
       width: 50px;
@@ -1377,6 +1490,77 @@ var hostStyles = import_lit11.css`
     --daw-clip-header-text: #e0d4c8;
   }
 `;
+var clipStyles = import_lit11.css`
+  .clip-container {
+    position: absolute;
+    overflow: hidden;
+  }
+  .clip-header {
+    position: relative;
+    z-index: 1;
+    height: 20px;
+    background: var(--daw-clip-header-background, rgba(0, 0, 0, 0.4));
+    border-bottom: 1px solid rgba(255, 255, 255, 0.08);
+    display: flex;
+    align-items: center;
+    padding: 0 6px;
+    user-select: none;
+    -webkit-user-drag: none;
+  }
+  .clip-header span {
+    font-size: 10px;
+    font-weight: 500;
+    letter-spacing: 0.02em;
+    font-family: system-ui, sans-serif;
+    color: var(--daw-clip-header-text, #e0d4c8);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    opacity: 0.8;
+  }
+  .clip-boundary {
+    position: absolute;
+    top: 0;
+    width: 8px;
+    height: 100%;
+    z-index: 2;
+    cursor: col-resize;
+    background: transparent;
+    border: none;
+    touch-action: none;
+    user-select: none;
+    -webkit-user-drag: none;
+    transition: background 0.1s, border-color 0.1s;
+  }
+  .clip-boundary[data-boundary-edge='left'] {
+    left: 0;
+  }
+  .clip-boundary[data-boundary-edge='right'] {
+    right: 0;
+  }
+  .clip-boundary[data-boundary-edge='left']:hover {
+    background: rgba(255, 255, 255, 0.2);
+    border-left: 2px solid rgba(255, 255, 255, 0.5);
+  }
+  .clip-boundary[data-boundary-edge='right']:hover {
+    background: rgba(255, 255, 255, 0.2);
+    border-right: 2px solid rgba(255, 255, 255, 0.5);
+  }
+  .clip-boundary[data-boundary-edge='left'].dragging {
+    background: rgba(255, 255, 255, 0.4);
+    border-left: 2px solid rgba(255, 255, 255, 0.8);
+  }
+  .clip-boundary[data-boundary-edge='right'].dragging {
+    background: rgba(255, 255, 255, 0.4);
+    border-right: 2px solid rgba(255, 255, 255, 0.8);
+  }
+  .clip-header[data-interactive] {
+    cursor: grab;
+  }
+  .clip-header[data-interactive]:active {
+    cursor: grabbing;
+  }
+`;
 
 // src/controllers/viewport-controller.ts
 var OVERSCAN_MULTIPLIER = 1.5;
@@ -1559,6 +1743,9 @@ var RecordingController = class {
       }
       const channelCount = stream.getAudioTracks()[0]?.getSettings()?.channelCount ?? 1;
       const startSample = options.startSample ?? Math.floor(this._host._currentTime * this._host.effectiveSampleRate);
+      const outputLatency = rawCtx.outputLatency ?? 0;
+      const lookAhead = context.lookAhead ?? 0;
+      const latencySamples = Math.floor((outputLatency + lookAhead) * rawCtx.sampleRate);
       const source = context.createMediaStreamSource(stream);
       const workletNode = context.createAudioWorkletNode("recording-processor", {
         channelCount,
@@ -1585,6 +1772,8 @@ var RecordingController = class {
         channelCount,
         bits,
         isFirstMessage: true,
+        latencySamples,
+        wasOverdub: options.overdub ?? false,
         _onTrackEnded: onTrackEnded,
         _audioTrack: audioTrack
       };
@@ -1605,6 +1794,9 @@ var RecordingController = class {
         })
       );
       this._host.requestUpdate();
+      if (options.overdub && typeof this._host.play === "function") {
+        await this._host.play(this._host._currentTime);
+      }
     } catch (err) {
       this._cleanupSession(trackId);
       console.warn("[dawcore] RecordingController: Failed to start recording: " + String(err));
@@ -1617,11 +1809,28 @@ var RecordingController = class {
       );
     }
   }
+  pauseRecording(trackId) {
+    const id = trackId ?? [...this._sessions.keys()][0];
+    if (!id) return;
+    const session = this._sessions.get(id);
+    if (!session) return;
+    session.workletNode.port.postMessage({ command: "pause" });
+  }
+  resumeRecording(trackId) {
+    const id = trackId ?? [...this._sessions.keys()][0];
+    if (!id) return;
+    const session = this._sessions.get(id);
+    if (!session) return;
+    session.workletNode.port.postMessage({ command: "resume" });
+  }
   stopRecording(trackId) {
     const id = trackId ?? [...this._sessions.keys()][0];
     if (!id) return;
     const session = this._sessions.get(id);
     if (!session) return;
+    if (session.wasOverdub && typeof this._host.stop === "function") {
+      this._host.stop();
+    }
     session.workletNode.port.postMessage({ command: "stop" });
     session.source.disconnect();
     session.workletNode.disconnect();
@@ -1639,7 +1848,8 @@ var RecordingController = class {
       );
       return;
     }
-    const stopCtx = (0, import_playout2.getGlobalContext)().rawContext;
+    const context = (0, import_playout2.getGlobalContext)();
+    const stopCtx = context.rawContext;
     const channelData = session.chunks.map((chunkArr) => (0, import_recording.concatenateAudioData)(chunkArr));
     const audioBuffer = (0, import_recording.createAudioBuffer)(
       stopCtx,
@@ -1647,7 +1857,21 @@ var RecordingController = class {
       this._host.effectiveSampleRate,
       session.channelCount
     );
-    const durationSamples = audioBuffer.length;
+    const latencyOffsetSamples = session.latencySamples;
+    const effectiveDuration = Math.max(0, audioBuffer.length - latencyOffsetSamples);
+    if (effectiveDuration === 0) {
+      console.warn("[dawcore] RecordingController: Recording too short for latency compensation");
+      this._sessions.delete(id);
+      this._host.requestUpdate();
+      this._host.dispatchEvent(
+        new CustomEvent("daw-recording-error", {
+          bubbles: true,
+          composed: true,
+          detail: { trackId: id, error: new Error("Recording too short to save") }
+        })
+      );
+      return;
+    }
     const event = new CustomEvent("daw-recording-complete", {
       bubbles: true,
       composed: true,
@@ -1656,14 +1880,21 @@ var RecordingController = class {
         trackId: id,
         audioBuffer,
         startSample: session.startSample,
-        durationSamples
+        durationSamples: effectiveDuration,
+        offsetSamples: latencyOffsetSamples
       }
     });
     const notPrevented = this._host.dispatchEvent(event);
     this._sessions.delete(id);
     this._host.requestUpdate();
     if (notPrevented) {
-      this._createClipFromRecording(id, audioBuffer, session.startSample, durationSamples);
+      this._createClipFromRecording(
+        id,
+        audioBuffer,
+        session.startSample,
+        effectiveDuration,
+        latencyOffsetSamples
+      );
     }
   }
   // Session fields are mutated in place on the hot path (~60fps worklet messages).
@@ -1694,7 +1925,9 @@ var RecordingController = class {
       );
       const newPeakCount = Math.floor(session.peaks[ch].length / 2);
       const waveformSelector = `daw-waveform[data-recording-track="${trackId}"][data-recording-channel="${ch}"]`;
-      const waveformEl = this._host.shadowRoot?.querySelector(waveformSelector);
+      const waveformEl = this._host.shadowRoot?.querySelector(
+        waveformSelector
+      );
       if (waveformEl) {
         if (session.isFirstMessage) {
           waveformEl.peaks = session.peaks[ch];
@@ -1713,9 +1946,15 @@ var RecordingController = class {
       this._host.requestUpdate();
     }
   }
-  _createClipFromRecording(trackId, audioBuffer, startSample, durationSamples) {
+  _createClipFromRecording(trackId, audioBuffer, startSample, durationSamples, offsetSamples = 0) {
     if (typeof this._host._addRecordedClip === "function") {
-      this._host._addRecordedClip(trackId, audioBuffer, startSample, durationSamples);
+      this._host._addRecordedClip(
+        trackId,
+        audioBuffer,
+        startSample,
+        durationSamples,
+        offsetSamples
+      );
     } else {
       console.warn(
         '[dawcore] RecordingController: host does not implement _addRecordedClip \u2014 clip not created for track "' + trackId + '"'
@@ -1746,6 +1985,11 @@ var RecordingController = class {
 
 // src/interactions/pointer-handler.ts
 var import_core = require("@waveform-playlist/core");
+
+// src/interactions/constants.ts
+var DRAG_THRESHOLD = 3;
+
+// src/interactions/pointer-handler.ts
 var PointerHandler = class {
   constructor(host) {
     this._isDragging = false;
@@ -1754,6 +1998,34 @@ var PointerHandler = class {
     // Cached from onPointerDown to avoid forced layout reflows at 60fps during drag
     this._timelineRect = null;
     this.onPointerDown = (e) => {
+      const clipHandler = this._host._clipHandler;
+      if (clipHandler) {
+        const target = e.composedPath()[0];
+        if (target && clipHandler.tryHandle(target, e)) {
+          e.preventDefault();
+          this._timeline = this._host.shadowRoot?.querySelector(".timeline");
+          if (this._timeline) {
+            this._timeline.setPointerCapture(e.pointerId);
+            const onMove = (me) => clipHandler.onPointerMove(me);
+            const onUp = (ue) => {
+              clipHandler.onPointerUp(ue);
+              this._timeline?.removeEventListener("pointermove", onMove);
+              this._timeline?.removeEventListener("pointerup", onUp);
+              try {
+                this._timeline?.releasePointerCapture(ue.pointerId);
+              } catch (err) {
+                console.warn(
+                  "[dawcore] releasePointerCapture failed (may already be released): " + String(err)
+                );
+              }
+              this._timeline = null;
+            };
+            this._timeline.addEventListener("pointermove", onMove);
+            this._timeline.addEventListener("pointerup", onUp);
+          }
+          return;
+        }
+      }
       this._timeline = this._host.shadowRoot?.querySelector(".timeline");
       if (!this._timeline) return;
       this._timelineRect = this._timeline.getBoundingClientRect();
@@ -1766,7 +2038,7 @@ var PointerHandler = class {
     this._onPointerMove = (e) => {
       if (!this._timeline) return;
       const currentPx = this._pxFromPointer(e);
-      if (!this._isDragging && Math.abs(currentPx - this._dragStartPx) > 3) {
+      if (!this._isDragging && Math.abs(currentPx - this._dragStartPx) > DRAG_THRESHOLD) {
         this._isDragging = true;
       }
       if (this._isDragging) {
@@ -1901,6 +2173,261 @@ var PointerHandler = class {
   }
 };
 
+// src/interactions/clip-pointer-handler.ts
+var ClipPointerHandler = class {
+  constructor(host) {
+    this._mode = null;
+    this._clipId = "";
+    this._trackId = "";
+    this._startPx = 0;
+    this._isDragging = false;
+    this._lastDeltaPx = 0;
+    this._cumulativeDeltaSamples = 0;
+    // Trim visual feedback: snapshot of original clip state
+    this._clipContainer = null;
+    this._boundaryEl = null;
+    this._originalLeft = 0;
+    this._originalWidth = 0;
+    this._originalOffsetSamples = 0;
+    this._originalDurationSamples = 0;
+    this._host = host;
+  }
+  /** Returns true if a drag interaction is currently in progress. */
+  get isActive() {
+    return this._mode !== null;
+  }
+  /**
+   * Attempts to handle a pointerdown event on the given target element.
+   * Returns true if the target is a recognized clip interaction element.
+   */
+  tryHandle(target, e) {
+    if (!this._host.interactiveClips) return false;
+    const boundary = target.closest?.(".clip-boundary");
+    const header = target.closest?.(".clip-header");
+    if (boundary && boundary.dataset.boundaryEdge !== void 0) {
+      const clipId = boundary.dataset.clipId;
+      const trackId = boundary.dataset.trackId;
+      const edge = boundary.dataset.boundaryEdge;
+      if (!clipId || !trackId || edge !== "left" && edge !== "right") return false;
+      this._beginDrag(edge === "left" ? "trim-left" : "trim-right", clipId, trackId, e);
+      this._boundaryEl = boundary;
+      return true;
+    }
+    if (header && header.dataset.interactive !== void 0) {
+      const clipId = header.dataset.clipId;
+      const trackId = header.dataset.trackId;
+      if (!clipId || !trackId) return false;
+      this._beginDrag("move", clipId, trackId, e);
+      return true;
+    }
+    return false;
+  }
+  _beginDrag(mode, clipId, trackId, e) {
+    this._mode = mode;
+    this._clipId = clipId;
+    this._trackId = trackId;
+    this._startPx = e.clientX;
+    this._isDragging = false;
+    this._lastDeltaPx = 0;
+    this._cumulativeDeltaSamples = 0;
+    if (this._host.engine) {
+      this._host.engine.beginTransaction();
+    } else {
+      console.warn(
+        "[dawcore] beginDrag: engine unavailable, drag mutations will not be grouped for undo"
+      );
+    }
+    if (mode === "trim-left" || mode === "trim-right") {
+      const container = this._host.shadowRoot?.querySelector(
+        `.clip-container[data-clip-id="${clipId}"]`
+      );
+      if (container) {
+        this._clipContainer = container;
+        this._originalLeft = parseFloat(container.style.left) || 0;
+        this._originalWidth = parseFloat(container.style.width) || 0;
+      } else {
+        console.warn("[dawcore] clip container not found for trim visual feedback: " + clipId);
+      }
+      const engine = this._host.engine;
+      if (engine) {
+        const bounds = engine.getClipBounds(trackId, clipId);
+        if (bounds) {
+          this._originalOffsetSamples = bounds.offsetSamples;
+          this._originalDurationSamples = bounds.durationSamples;
+        }
+      }
+    }
+  }
+  /** Processes pointermove events during an active drag. */
+  onPointerMove(e) {
+    if (this._mode === null) return;
+    const totalDeltaPx = e.clientX - this._startPx;
+    if (!this._isDragging && Math.abs(totalDeltaPx) > DRAG_THRESHOLD) {
+      this._isDragging = true;
+      if (this._boundaryEl) {
+        this._boundaryEl.classList.add("dragging");
+      }
+    }
+    if (!this._isDragging) return;
+    const engine = this._host.engine;
+    if (!engine) return;
+    if (this._mode === "move") {
+      const incrementalDeltaPx = totalDeltaPx - this._lastDeltaPx;
+      this._lastDeltaPx = totalDeltaPx;
+      const incrementalDeltaSamples = Math.round(incrementalDeltaPx * this._host.samplesPerPixel);
+      const applied = engine.moveClip(this._trackId, this._clipId, incrementalDeltaSamples, true);
+      this._cumulativeDeltaSamples += applied;
+    } else {
+      const boundary = this._mode === "trim-left" ? "left" : "right";
+      const rawDeltaSamples = Math.round(totalDeltaPx * this._host.samplesPerPixel);
+      const deltaSamples = engine.constrainTrimDelta(
+        this._trackId,
+        this._clipId,
+        boundary,
+        rawDeltaSamples
+      );
+      const deltaPx = Math.round(deltaSamples / this._host.samplesPerPixel);
+      this._cumulativeDeltaSamples = deltaSamples;
+      if (this._clipContainer) {
+        if (this._mode === "trim-left") {
+          const newLeft = this._originalLeft + deltaPx;
+          const newWidth = this._originalWidth - deltaPx;
+          if (newWidth > 0) {
+            this._clipContainer.style.left = newLeft + "px";
+            this._clipContainer.style.width = newWidth + "px";
+            const newOffset = this._originalOffsetSamples + deltaSamples;
+            const newDuration = this._originalDurationSamples - deltaSamples;
+            if (this._updateWaveformPeaks(newOffset, newDuration)) {
+              const waveforms = this._clipContainer.querySelectorAll("daw-waveform");
+              for (const wf of waveforms) {
+                wf.style.left = "0px";
+              }
+            } else {
+              const waveforms = this._clipContainer.querySelectorAll("daw-waveform");
+              for (const wf of waveforms) {
+                wf.style.left = -deltaPx + "px";
+              }
+            }
+          }
+        } else {
+          const newWidth = this._originalWidth + deltaPx;
+          if (newWidth > 0) {
+            this._clipContainer.style.width = newWidth + "px";
+            const newDuration = this._originalDurationSamples + deltaSamples;
+            this._updateWaveformPeaks(this._originalOffsetSamples, newDuration);
+          }
+        }
+      }
+    }
+  }
+  /** Processes pointerup events to finalize and dispatch result events. */
+  onPointerUp(_e) {
+    if (this._mode === null) return;
+    try {
+      if (!this._isDragging || this._cumulativeDeltaSamples === 0) {
+        this._restoreTrimVisual();
+        return;
+      }
+      const engine = this._host.engine;
+      if (this._mode === "move") {
+        if (engine) {
+          engine.updateTrack(this._trackId);
+          this._host.dispatchEvent(
+            new CustomEvent("daw-clip-move", {
+              bubbles: true,
+              composed: true,
+              detail: {
+                trackId: this._trackId,
+                clipId: this._clipId,
+                deltaSamples: this._cumulativeDeltaSamples
+              }
+            })
+          );
+        } else {
+          console.warn(
+            "[dawcore] engine unavailable at move drop \u2014 audio may be out of sync for track " + this._trackId
+          );
+        }
+      } else {
+        this._restoreTrimVisual();
+        const boundary = this._mode === "trim-left" ? "left" : "right";
+        if (engine) {
+          engine.trimClip(this._trackId, this._clipId, boundary, this._cumulativeDeltaSamples);
+          this._host.dispatchEvent(
+            new CustomEvent("daw-clip-trim", {
+              bubbles: true,
+              composed: true,
+              detail: {
+                trackId: this._trackId,
+                clipId: this._clipId,
+                boundary,
+                deltaSamples: this._cumulativeDeltaSamples
+              }
+            })
+          );
+        } else {
+          console.warn(
+            "[dawcore] engine unavailable at trim drop \u2014 trim not applied for clip " + this._clipId
+          );
+        }
+      }
+    } finally {
+      if (this._isDragging && this._cumulativeDeltaSamples !== 0) {
+        this._host.engine?.commitTransaction();
+      } else {
+        this._host.engine?.abortTransaction();
+      }
+      this._reset();
+    }
+  }
+  /** Re-extract peaks from cache and set on waveform elements during trim drag.
+   *  Returns true if peaks were successfully updated. */
+  _updateWaveformPeaks(offsetSamples, durationSamples) {
+    if (!this._clipContainer || durationSamples <= 0) return false;
+    const peakSlice = this._host.reextractClipPeaks(this._clipId, offsetSamples, durationSamples);
+    if (!peakSlice) return false;
+    const waveforms = this._clipContainer.querySelectorAll("daw-waveform");
+    for (let i = 0; i < waveforms.length; i++) {
+      const wf = waveforms[i];
+      const channelPeaks = peakSlice.data[i];
+      if (channelPeaks) {
+        wf.peaks = channelPeaks;
+        wf.length = peakSlice.length;
+      }
+    }
+    return true;
+  }
+  /** Restore clip container CSS to original values after trim visual preview. */
+  _restoreTrimVisual() {
+    if (this._clipContainer) {
+      this._clipContainer.style.left = this._originalLeft + "px";
+      this._clipContainer.style.width = this._originalWidth + "px";
+      const waveforms = this._clipContainer.querySelectorAll("daw-waveform");
+      for (const wf of waveforms) {
+        wf.style.left = "0px";
+      }
+    }
+  }
+  _reset() {
+    if (this._boundaryEl) {
+      this._boundaryEl.classList.remove("dragging");
+      this._boundaryEl = null;
+    }
+    this._mode = null;
+    this._clipId = "";
+    this._trackId = "";
+    this._startPx = 0;
+    this._isDragging = false;
+    this._lastDeltaPx = 0;
+    this._cumulativeDeltaSamples = 0;
+    this._clipContainer = null;
+    this._originalLeft = 0;
+    this._originalWidth = 0;
+    this._originalOffsetSamples = 0;
+    this._originalDurationSamples = 0;
+  }
+};
+
 // src/interactions/file-loader.ts
 var import_core2 = require("@waveform-playlist/core");
 async function loadFiles(host, files) {
@@ -1935,10 +2462,16 @@ async function loadFiles(host, files) {
         sourceDuration: audioBuffer.duration
       });
       host._clipBuffers = new Map(host._clipBuffers).set(clip.id, audioBuffer);
+      host._clipOffsets.set(clip.id, {
+        offsetSamples: clip.offsetSamples,
+        durationSamples: clip.durationSamples
+      });
       const peakData = await host._peakPipeline.generatePeaks(
         audioBuffer,
         host.samplesPerPixel,
-        host.mono
+        host.mono,
+        clip.offsetSamples,
+        clip.durationSamples
       );
       host._peaksData = new Map(host._peaksData).set(clip.id, peakData);
       const trackId = crypto.randomUUID();
@@ -1997,17 +2530,31 @@ async function loadFiles(host, files) {
 
 // src/interactions/recording-clip.ts
 var import_core3 = require("@waveform-playlist/core");
-function addRecordedClip(host, trackId, buf, startSample, durSamples) {
+function addRecordedClip(host, trackId, buf, startSample, durSamples, offsetSamples = 0) {
+  let trimmedBuf = buf;
+  if (offsetSamples > 0 && offsetSamples < buf.length) {
+    const trimmed = new AudioBuffer({
+      numberOfChannels: buf.numberOfChannels,
+      length: durSamples,
+      sampleRate: buf.sampleRate
+    });
+    for (let ch = 0; ch < buf.numberOfChannels; ch++) {
+      const source = buf.getChannelData(ch);
+      trimmed.copyToChannel(source.subarray(offsetSamples, offsetSamples + durSamples), ch);
+    }
+    trimmedBuf = trimmed;
+  }
   const clip = (0, import_core3.createClip)({
-    audioBuffer: buf,
+    audioBuffer: trimmedBuf,
     startSample,
     durationSamples: durSamples,
     offsetSamples: 0,
+    // offset already applied by slicing
     gain: 1,
     name: "Recording"
   });
-  host._clipBuffers = new Map(host._clipBuffers).set(clip.id, buf);
-  host._peakPipeline.generatePeaks(buf, host.samplesPerPixel, host.mono).then((pd) => {
+  host._clipBuffers = new Map(host._clipBuffers).set(clip.id, trimmedBuf);
+  host._peakPipeline.generatePeaks(trimmedBuf, host.samplesPerPixel, host.mono).then((pd) => {
     host._peaksData = new Map(host._peaksData).set(clip.id, pd);
     const t = host._engineTracks.get(trackId);
     if (!t) {
@@ -2040,7 +2587,12 @@ function addRecordedClip(host, trackId, buf, startSample, durSamples) {
       });
     }
     host._recomputeDuration();
-    host._engine?.setTracks([...host._engineTracks.values()]);
+    const updatedTrack = host._engineTracks.get(trackId);
+    if (host._engine?.updateTrack && updatedTrack) {
+      host._engine.updateTrack(trackId, updatedTrack);
+    } else {
+      host._engine?.setTracks([...host._engineTracks.values()]);
+    }
   }).catch((err) => {
     console.warn("[dawcore] Failed to generate peaks for recorded clip: " + String(err));
     const next = new Map(host._clipBuffers);
@@ -2058,6 +2610,169 @@ function addRecordedClip(host, trackId, buf, startSample, durSamples) {
   });
 }
 
+// src/interactions/split-handler.ts
+function splitAtPlayhead(host) {
+  const wasPlaying = host.isPlaying;
+  const time = host.currentTime;
+  if (!canSplitAtTime(host, time)) return false;
+  if (wasPlaying) {
+    host.stop();
+  }
+  let result;
+  try {
+    result = performSplit(host, time);
+  } catch (err) {
+    console.warn("[dawcore] splitAtPlayhead failed: " + String(err));
+    result = false;
+  }
+  if (wasPlaying) {
+    host.play(time);
+  }
+  return result;
+}
+function canSplitAtTime(host, time) {
+  const { engine } = host;
+  if (!engine) return false;
+  const state5 = engine.getState();
+  if (!state5.selectedTrackId) return false;
+  const track = state5.tracks.find((t) => t.id === state5.selectedTrackId);
+  if (!track) return false;
+  const atSample = Math.round(time * host.effectiveSampleRate);
+  return !!findClipAtSample(track.clips, atSample);
+}
+function performSplit(host, time) {
+  const { engine } = host;
+  if (!engine) return false;
+  const stateBefore = engine.getState();
+  const { selectedTrackId, tracks } = stateBefore;
+  if (!selectedTrackId) return false;
+  const track = tracks.find((t) => t.id === selectedTrackId);
+  if (!track) return false;
+  const atSample = Math.round(time * host.effectiveSampleRate);
+  const clip = findClipAtSample(track.clips, atSample);
+  if (!clip) return false;
+  const originalClipId = clip.id;
+  const clipIdsBefore = new Set(track.clips.map((c) => c.id));
+  engine.splitClip(selectedTrackId, originalClipId, atSample);
+  const stateAfter = engine.getState();
+  const trackAfter = stateAfter.tracks.find((t) => t.id === selectedTrackId);
+  if (!trackAfter) {
+    console.warn(
+      '[dawcore] splitAtPlayhead: track "' + selectedTrackId + '" disappeared after split'
+    );
+    return false;
+  }
+  const newClips = trackAfter.clips.filter((c) => !clipIdsBefore.has(c.id));
+  if (newClips.length !== 2) {
+    if (newClips.length > 0) {
+      console.warn(
+        "[dawcore] splitAtPlayhead: expected 2 new clips after split but got " + newClips.length
+      );
+    }
+    return false;
+  }
+  const sorted = [...newClips].sort((a, b) => a.startSample - b.startSample);
+  const leftClipId = sorted[0].id;
+  const rightClipId = sorted[1].id;
+  host.dispatchEvent(
+    new CustomEvent("daw-clip-split", {
+      bubbles: true,
+      composed: true,
+      detail: {
+        trackId: selectedTrackId,
+        originalClipId,
+        leftClipId,
+        rightClipId
+      }
+    })
+  );
+  return true;
+}
+function findClipAtSample(clips, atSample) {
+  return clips.find(
+    (c) => atSample > c.startSample && atSample < c.startSample + c.durationSamples
+  );
+}
+
+// src/interactions/clip-peak-sync.ts
+function syncPeaksForChangedClips(host, tracks) {
+  const currentClipIds = /* @__PURE__ */ new Set();
+  for (const track of tracks) {
+    for (const clip of track.clips) {
+      currentClipIds.add(clip.id);
+      const cached = host._clipOffsets.get(clip.id);
+      const needsPeaks = !host._peaksData.has(clip.id) || !cached || cached.offsetSamples !== clip.offsetSamples || cached.durationSamples !== clip.durationSamples;
+      if (!needsPeaks) continue;
+      const audioBuffer = clip.audioBuffer ?? host._clipBuffers.get(clip.id) ?? findAudioBufferForClip(host, clip, track);
+      if (!audioBuffer) {
+        console.warn(
+          "[dawcore] syncPeaksForChangedClips: no AudioBuffer for clip " + clip.id + " \u2014 waveform will be blank"
+        );
+        continue;
+      }
+      host._clipBuffers = new Map(host._clipBuffers).set(clip.id, audioBuffer);
+      host._clipOffsets.set(clip.id, {
+        offsetSamples: clip.offsetSamples,
+        durationSamples: clip.durationSamples
+      });
+      host._peakPipeline.generatePeaks(
+        audioBuffer,
+        host.samplesPerPixel,
+        host.mono,
+        clip.offsetSamples,
+        clip.durationSamples
+      ).then((peakData) => {
+        host._peaksData = new Map(host._peaksData).set(clip.id, peakData);
+      }).catch((err) => {
+        console.warn(
+          "[dawcore] Failed to generate peaks for clip " + clip.id + ": " + String(err)
+        );
+      });
+    }
+  }
+  cleanupOrphanedClipData(host, currentClipIds);
+}
+function cleanupOrphanedClipData(host, currentClipIds) {
+  let buffersChanged = false;
+  let peaksChanged = false;
+  for (const id of host._clipBuffers.keys()) {
+    if (!currentClipIds.has(id)) {
+      host._clipBuffers.delete(id);
+      buffersChanged = true;
+    }
+  }
+  let offsetsChanged = false;
+  for (const id of host._clipOffsets.keys()) {
+    if (!currentClipIds.has(id)) {
+      host._clipOffsets.delete(id);
+      offsetsChanged = true;
+    }
+  }
+  for (const id of host._peaksData.keys()) {
+    if (!currentClipIds.has(id)) {
+      host._peaksData.delete(id);
+      peaksChanged = true;
+    }
+  }
+  if (buffersChanged) {
+    host._clipBuffers = new Map(host._clipBuffers);
+  }
+  if (offsetsChanged) {
+    host._clipOffsets = new Map(host._clipOffsets);
+  }
+  if (peaksChanged) {
+    host._peaksData = new Map(host._peaksData);
+  }
+}
+function findAudioBufferForClip(host, clip, track) {
+  for (const sibling of track.clips) {
+    if (sibling.id === clip.id) continue;
+    const buf = host._clipBuffers.get(sibling.id);
+    if (buf) return buf;
+  }
+  return null;
+}
+
 // src/elements/daw-editor.ts
 var DawEditorElement = class extends import_lit12.LitElement {
   constructor() {
@@ -2069,6 +2784,9 @@ var DawEditorElement = class extends import_lit12.LitElement {
     this.barWidth = 1;
     this.barGap = 0;
     this.fileDrop = false;
+    this.clipHeaders = false;
+    this.clipHeaderHeight = 20;
+    this.interactiveClips = false;
     this.sampleRate = 48e3;
     /** Resolved sample rate — falls back to sampleRate property until first audio decode. */
     this._resolvedSampleRate = null;
@@ -2085,14 +2803,15 @@ var DawEditorElement = class extends import_lit12.LitElement {
     this._currentTime = 0;
     this._engine = null;
     this._enginePromise = null;
-    this._audioInitialized = false;
     this._audioCache = /* @__PURE__ */ new Map();
     this._clipBuffers = /* @__PURE__ */ new Map();
+    this._clipOffsets = /* @__PURE__ */ new Map();
     this._peakPipeline = new PeakPipeline();
     this._trackElements = /* @__PURE__ */ new Map();
     this._childObserver = null;
     this._audioResume = new AudioResumeController(this);
     this._recordingController = new RecordingController(this);
+    this._clipPointer = new ClipPointerHandler(this);
     this._pointer = new PointerHandler(this);
     this._viewport = (() => {
       const v = new ViewportController(this);
@@ -2136,6 +2855,19 @@ var DawEditorElement = class extends import_lit12.LitElement {
     this._onTrackControl = (e) => {
       const { trackId, prop, value } = e.detail ?? {};
       if (!trackId || !prop || !DawEditorElement._CONTROL_PROPS.has(prop)) return;
+      if (this._selectedTrackId !== trackId) {
+        this._setSelectedTrackId(trackId);
+        if (this._engine) {
+          this._engine.selectTrack(trackId);
+        }
+        this.dispatchEvent(
+          new CustomEvent("daw-track-select", {
+            bubbles: true,
+            composed: true,
+            detail: { trackId }
+          })
+        );
+      }
       const oldDescriptor = this._tracks.get(trackId);
       if (oldDescriptor) {
         const descriptor = { ...oldDescriptor, [prop]: value };
@@ -2196,6 +2928,28 @@ var DawEditorElement = class extends import_lit12.LitElement {
     // --- Recording ---
     this.recordingStream = null;
   }
+  get _clipHandler() {
+    return this.interactiveClips ? this._clipPointer : null;
+  }
+  get engine() {
+    return this._engine;
+  }
+  /** Re-extract peaks for a clip at new offset/duration from cached WaveformData. */
+  reextractClipPeaks(clipId, offsetSamples, durationSamples) {
+    const buf = this._clipBuffers.get(clipId);
+    if (!buf) return null;
+    const singleClipBuffers = /* @__PURE__ */ new Map([[clipId, buf]]);
+    const singleClipOffsets = /* @__PURE__ */ new Map([[clipId, { offsetSamples, durationSamples }]]);
+    const result = this._peakPipeline.reextractPeaks(
+      singleClipBuffers,
+      this.samplesPerPixel,
+      this.mono,
+      singleClipOffsets
+    );
+    const peakData = result.get(clipId);
+    if (!peakData) return null;
+    return { data: peakData.data, length: peakData.length };
+  }
   get effectiveSampleRate() {
     return this._resolvedSampleRate ?? this.sampleRate;
   }
@@ -2270,6 +3024,7 @@ var DawEditorElement = class extends import_lit12.LitElement {
     this._trackElements.clear();
     this._audioCache.clear();
     this._clipBuffers.clear();
+    this._clipOffsets.clear();
     this._peakPipeline.terminate();
     try {
       this._disposeEngine();
@@ -2281,17 +3036,19 @@ var DawEditorElement = class extends import_lit12.LitElement {
     if (changedProperties.has("eagerResume")) {
       this._audioResume.target = this.eagerResume;
     }
+    if (changedProperties.has("samplesPerPixel") && this._isPlaying) {
+      this._startPlayhead();
+    }
     if (changedProperties.has("samplesPerPixel") && this._clipBuffers.size > 0) {
-      const reextracted = this._peakPipeline.reextractPeaks(
+      const re = this._peakPipeline.reextractPeaks(
         this._clipBuffers,
         this.samplesPerPixel,
-        this.mono
+        this.mono,
+        this._clipOffsets
       );
-      if (reextracted.size > 0) {
+      if (re.size > 0) {
         const next = new Map(this._peaksData);
-        for (const [clipId, peakData] of reextracted) {
-          next.set(clipId, peakData);
-        }
+        for (const [id, pd] of re) next.set(id, pd);
         this._peaksData = next;
       }
     }
@@ -2303,6 +3060,7 @@ var DawEditorElement = class extends import_lit12.LitElement {
       const nextPeaks = new Map(this._peaksData);
       for (const clip of removedTrack.clips) {
         this._clipBuffers.delete(clip.id);
+        this._clipOffsets.delete(clip.id);
         nextPeaks.delete(clip.id);
       }
       this._peaksData = nextPeaks;
@@ -2381,10 +3139,16 @@ var DawEditorElement = class extends import_lit12.LitElement {
           sourceDuration: audioBuffer.duration
         });
         this._clipBuffers = new Map(this._clipBuffers).set(clip.id, audioBuffer);
+        this._clipOffsets.set(clip.id, {
+          offsetSamples: clip.offsetSamples,
+          durationSamples: clip.durationSamples
+        });
         const peakData = await this._peakPipeline.generatePeaks(
           audioBuffer,
           this.samplesPerPixel,
-          this.mono
+          this.mono,
+          clip.offsetSamples,
+          clip.durationSamples
         );
         this._peaksData = new Map(this._peaksData).set(clip.id, peakData);
         clips.push(clip);
@@ -2476,10 +3240,20 @@ var DawEditorElement = class extends import_lit12.LitElement {
       samplesPerPixel: this.samplesPerPixel,
       zoomLevels: [256, 512, 1024, 2048, 4096, 8192, this.samplesPerPixel].filter((v, i, a) => a.indexOf(v) === i).sort((a, b) => a - b)
     });
+    let lastTracksVersion = -1;
     engine.on("statechange", (engineState) => {
       this._isPlaying = engineState.isPlaying;
       this._duration = engineState.duration;
       this._selectedTrackId = engineState.selectedTrackId;
+      if (engineState.tracksVersion !== lastTracksVersion) {
+        lastTracksVersion = engineState.tracksVersion;
+        const nextTracks = /* @__PURE__ */ new Map();
+        for (const track of engineState.tracks) {
+          nextTracks.set(track.id, track);
+        }
+        this._engineTracks = nextTracks;
+        syncPeaksForChangedClips(this, engineState.tracks);
+      }
     });
     engine.on("timeupdate", (time) => {
       this._currentTime = time;
@@ -2502,14 +3276,11 @@ var DawEditorElement = class extends import_lit12.LitElement {
     return loadFiles(this, files);
   }
   // --- Playback ---
-  async play() {
+  async play(startTime) {
     try {
       const engine = await this._ensureEngine();
-      if (!this._audioInitialized) {
-        await engine.init();
-        this._audioInitialized = true;
-      }
-      engine.play();
+      await engine.init();
+      engine.play(startTime);
       this._startPlayhead();
       this.dispatchEvent(new CustomEvent("daw-play", { bubbles: true, composed: true }));
     } catch (err) {
@@ -2535,19 +3306,90 @@ var DawEditorElement = class extends import_lit12.LitElement {
     this._stopPlayhead();
     this.dispatchEvent(new CustomEvent("daw-stop", { bubbles: true, composed: true }));
   }
+  /** Toggle between play and pause. */
+  togglePlayPause() {
+    if (this._isPlaying) {
+      this.pause();
+    } else {
+      this.play();
+    }
+  }
   seekTo(time) {
-    if (!this._engine) return;
-    this._engine.seek(time);
-    this._currentTime = time;
+    if (!this._engine) {
+      console.warn("[dawcore] seekTo: engine not ready, call ignored");
+      return;
+    }
+    if (this._isPlaying) {
+      this.stop();
+      this.play(time);
+    } else {
+      this._engine.seek(time);
+      this._currentTime = time;
+      this._stopPlayhead();
+    }
+  }
+  /** Undo the last structural edit. */
+  undo() {
+    if (!this._engine) {
+      console.warn("[dawcore] undo: engine not ready, call ignored");
+      return;
+    }
+    this._engine.undo();
+  }
+  /** Redo the last undone edit. */
+  redo() {
+    if (!this._engine) {
+      console.warn("[dawcore] redo: engine not ready, call ignored");
+      return;
+    }
+    this._engine.redo();
+  }
+  /** Whether undo is available. */
+  get canUndo() {
+    return this._engine?.canUndo ?? false;
+  }
+  /** Whether redo is available. */
+  get canRedo() {
+    return this._engine?.canRedo ?? false;
+  }
+  /** Split the clip under the playhead on the selected track. */
+  splitAtPlayhead() {
+    return splitAtPlayhead({
+      effectiveSampleRate: this.effectiveSampleRate,
+      currentTime: this._currentTime,
+      isPlaying: this._isPlaying,
+      engine: this._engine,
+      dispatchEvent: (e) => this.dispatchEvent(e),
+      stop: () => {
+        this._engine?.stop();
+        this._stopPlayhead();
+      },
+      // Call engine.play directly (synchronous) — not the async editor play()
+      // which yields to microtask queue via await engine.init(). Engine is
+      // already initialized at split time; the async gap causes audio desync.
+      play: (time) => {
+        this._engine?.play(time);
+        this._startPlayhead();
+      }
+    });
+  }
+  get currentTime() {
+    return this._currentTime;
   }
   get isRecording() {
     return this._recordingController.isRecording;
   }
+  pauseRecording() {
+    this._recordingController.pauseRecording();
+  }
+  resumeRecording() {
+    this._recordingController.resumeRecording();
+  }
   stopRecording() {
     this._recordingController.stopRecording();
   }
-  _addRecordedClip(trackId, buf, startSample, durSamples) {
-    addRecordedClip(this, trackId, buf, startSample, durSamples);
+  _addRecordedClip(trackId, buf, startSample, durSamples, offsetSamples = 0) {
+    addRecordedClip(this, trackId, buf, startSample, durSamples, offsetSamples);
   }
   async startRecording(stream, options) {
     const s = stream ?? this.recordingStream;
@@ -2560,15 +3402,19 @@ var DawEditorElement = class extends import_lit12.LitElement {
   _renderRecordingPreview(trackId, chH) {
     const rs = this._recordingController.getSession(trackId);
     if (!rs) return "";
+    const audibleSamples = Math.max(0, rs.totalSamples - rs.latencySamples);
+    if (audibleSamples === 0) return "";
+    const latencyPixels = Math.floor(rs.latencySamples / this.samplesPerPixel);
     const left = Math.floor(rs.startSample / this.samplesPerPixel);
-    const w = Math.floor(rs.totalSamples / this.samplesPerPixel);
-    return rs.peaks.map(
-      (chPeaks, ch) => import_lit12.html`
+    const w = Math.floor(audibleSamples / this.samplesPerPixel);
+    return rs.peaks.map((chPeaks, ch) => {
+      const slicedPeaks = latencyPixels > 0 ? chPeaks.slice(latencyPixels * 2) : chPeaks;
+      return import_lit12.html`
         <daw-waveform
           data-recording-track=${trackId}
           data-recording-channel=${ch}
           style="position:absolute;left:${left}px;top:${ch * chH}px;"
-          .peaks=${chPeaks}
+          .peaks=${slicedPeaks}
           .length=${w}
           .waveHeight=${chH}
           .barWidth=${this.barWidth}
@@ -2577,8 +3423,8 @@ var DawEditorElement = class extends import_lit12.LitElement {
           .visibleEnd=${this._viewport.visibleEnd}
           .originX=${left}
         ></daw-waveform>
-      `
-    );
+      `;
+    });
   }
   // --- Playhead ---
   _startPlayhead() {
@@ -2620,13 +3466,14 @@ var DawEditorElement = class extends import_lit12.LitElement {
     const orderedTracks = this._getOrderedTracks().map(([trackId, track]) => {
       const descriptor = this._tracks.get(trackId);
       const firstPeaks = track.clips.map((c) => this._peaksData.get(c.id)).find((p) => p && p.data.length > 0);
-      const numChannels = firstPeaks ? firstPeaks.data.length : 1;
+      const recSession = this._recordingController.getSession(trackId);
+      const numChannels = firstPeaks ? firstPeaks.data.length : recSession ? recSession.channelCount : 1;
       return {
         trackId,
         track,
         descriptor,
         numChannels,
-        trackHeight: this.waveHeight * numChannels
+        trackHeight: this.waveHeight * numChannels + (this.clipHeaders ? this.clipHeaderHeight : 0)
       };
     });
     return import_lit12.html`
@@ -2680,21 +3527,47 @@ var DawEditorElement = class extends import_lit12.LitElement {
         );
         const clipLeft = Math.floor(clip.startSample / this.samplesPerPixel);
         const channels = peakData?.data ?? [new Int16Array(0)];
-        return channels.map(
-          (channelPeaks, chIdx) => import_lit12.html`
-                      <daw-waveform
-                        style="position: absolute; left: ${clipLeft}px; top: ${chIdx * channelHeight}px;"
-                        .peaks=${channelPeaks}
-                        .length=${peakData?.length ?? width}
-                        .waveHeight=${channelHeight}
-                        .barWidth=${this.barWidth}
-                        .barGap=${this.barGap}
-                        .visibleStart=${this._viewport.visibleStart}
-                        .visibleEnd=${this._viewport.visibleEnd}
-                        .originX=${clipLeft}
-                      ></daw-waveform>
-                    `
-        );
+        const hdrH = this.clipHeaders ? this.clipHeaderHeight : 0;
+        const chH = this.waveHeight;
+        return import_lit12.html` <div
+                    class="clip-container"
+                    style="left:${clipLeft}px;top:0;width:${width}px;height:${t.trackHeight}px;"
+                    data-clip-id=${clip.id}
+                  >
+                    ${hdrH > 0 ? import_lit12.html`<div
+                          class="clip-header"
+                          data-clip-id=${clip.id}
+                          data-track-id=${t.trackId}
+                          ?data-interactive=${this.interactiveClips}
+                        >
+                          <span>${clip.name || t.descriptor?.name || ""}</span>
+                        </div>` : ""}
+                    ${channels.map(
+          (chPeaks, chIdx) => import_lit12.html` <daw-waveform
+                          style="position:absolute;left:0;top:${hdrH + chIdx * chH}px;"
+                          .peaks=${chPeaks}
+                          .length=${peakData?.length ?? width}
+                          .waveHeight=${chH}
+                          .barWidth=${this.barWidth}
+                          .barGap=${this.barGap}
+                          .visibleStart=${this._viewport.visibleStart}
+                          .visibleEnd=${this._viewport.visibleEnd}
+                          .originX=${clipLeft}
+                        ></daw-waveform>`
+        )}
+                    ${this.interactiveClips ? import_lit12.html` <div
+                            class="clip-boundary"
+                            data-boundary-edge="left"
+                            data-clip-id=${clip.id}
+                            data-track-id=${t.trackId}
+                          ></div>
+                          <div
+                            class="clip-boundary"
+                            data-boundary-edge="right"
+                            data-clip-id=${clip.id}
+                            data-track-id=${t.trackId}
+                          ></div>` : ""}
+                  </div>`;
       })}
                 ${this._renderRecordingPreview(t.trackId, channelHeight)}
               </div>
@@ -2742,7 +3615,8 @@ DawEditorElement.styles = [
         outline: 2px dashed var(--daw-selection-color, rgba(99, 199, 95, 0.3));
         outline-offset: -2px;
       }
-    `
+    `,
+  clipStyles
 ];
 DawEditorElement._CONTROL_PROPS = /* @__PURE__ */ new Set(["volume", "pan", "muted", "soloed"]);
 __decorateClass([
@@ -2766,6 +3640,15 @@ __decorateClass([
 __decorateClass([
   (0, import_decorators10.property)({ type: Boolean, attribute: "file-drop" })
 ], DawEditorElement.prototype, "fileDrop", 2);
+__decorateClass([
+  (0, import_decorators10.property)({ type: Boolean, attribute: "clip-headers" })
+], DawEditorElement.prototype, "clipHeaders", 2);
+__decorateClass([
+  (0, import_decorators10.property)({ type: Number, attribute: "clip-header-height" })
+], DawEditorElement.prototype, "clipHeaderHeight", 2);
+__decorateClass([
+  (0, import_decorators10.property)({ type: Boolean, attribute: "interactive-clips" })
+], DawEditorElement.prototype, "interactiveClips", 2);
 __decorateClass([
   (0, import_decorators10.property)({ type: Number, attribute: "sample-rate" })
 ], DawEditorElement.prototype, "sampleRate", 2);
@@ -3030,7 +3913,7 @@ var DawRecordButtonElement = class extends DawTransportButton {
   }
   connectedCallback() {
     super.connectedCallback();
-    this._listenToTarget();
+    requestAnimationFrame(() => this._listenToTarget());
   }
   disconnectedCallback() {
     super.disconnectedCallback();
@@ -3055,11 +3938,12 @@ var DawRecordButtonElement = class extends DawTransportButton {
   render() {
     return import_lit15.html`
       <button part="button" ?data-recording=${this._isRecording} @click=${this._onClick}>
-        <slot>${this._isRecording ? "Stop Rec" : "Record"}</slot>
+        <slot>Record</slot>
       </button>
     `;
   }
   _onClick() {
+    if (this._isRecording) return;
     const target = this.target;
     if (!target) {
       console.warn(
@@ -3067,11 +3951,7 @@ var DawRecordButtonElement = class extends DawTransportButton {
       );
       return;
     }
-    if (this._isRecording) {
-      target.stopRecording();
-    } else {
-      target.startRecording(target.recordingStream);
-    }
+    target.startRecording(target.recordingStream);
   }
 };
 DawRecordButtonElement.styles = [
@@ -3080,6 +3960,7 @@ DawRecordButtonElement.styles = [
       button[data-recording] {
         color: #d08070;
         border-color: #d08070;
+        background: rgba(208, 128, 112, 0.15);
       }
     `
 ];
@@ -3089,11 +3970,183 @@ __decorateClass([
 DawRecordButtonElement = __decorateClass([
   (0, import_decorators13.customElement)("daw-record-button")
 ], DawRecordButtonElement);
+
+// src/elements/daw-keyboard-shortcuts.ts
+var import_lit16 = require("lit");
+var import_decorators14 = require("lit/decorators.js");
+var import_core5 = require("@waveform-playlist/core");
+var DawKeyboardShortcutsElement = class extends import_lit16.LitElement {
+  constructor() {
+    super(...arguments);
+    this.playback = false;
+    this.splitting = false;
+    this.undo = false;
+    // --- JS properties for remapping ---
+    this.playbackShortcuts = null;
+    this.splittingShortcuts = null;
+    this.undoShortcuts = null;
+    /** Additional custom shortcuts. */
+    this.customShortcuts = [];
+    this._editor = null;
+    this._cachedShortcuts = null;
+    // --- Event handler ---
+    this._onKeyDown = (e) => {
+      const shortcuts = this.shortcuts;
+      if (shortcuts.length === 0) return;
+      try {
+        (0, import_core5.handleKeyboardEvent)(e, shortcuts, true);
+      } catch (err) {
+        console.warn("[dawcore] Keyboard shortcut failed (key=" + e.key + "): " + String(err));
+        const target = this._editor ?? this;
+        target.dispatchEvent(
+          new CustomEvent("daw-error", {
+            bubbles: true,
+            composed: true,
+            detail: { operation: "keyboard-shortcut", key: e.key, error: err }
+          })
+        );
+      }
+    };
+  }
+  /** All active shortcuts (read-only, cached). */
+  get shortcuts() {
+    if (!this._cachedShortcuts) {
+      this._cachedShortcuts = this._buildShortcuts();
+    }
+    return this._cachedShortcuts;
+  }
+  /** Invalidate cached shortcuts when Lit properties change. */
+  updated() {
+    this._cachedShortcuts = null;
+  }
+  // --- Lifecycle ---
+  connectedCallback() {
+    super.connectedCallback();
+    this._editor = this.closest("daw-editor");
+    if (!this._editor) {
+      console.warn(
+        "[dawcore] <daw-keyboard-shortcuts> must be placed inside a <daw-editor>. Preset shortcuts (playback, splitting, undo) will be inactive; only customShortcuts will fire."
+      );
+    }
+    document.addEventListener("keydown", this._onKeyDown);
+  }
+  disconnectedCallback() {
+    super.disconnectedCallback();
+    document.removeEventListener("keydown", this._onKeyDown);
+    this._editor = null;
+  }
+  // No shadow DOM — render-less element
+  createRenderRoot() {
+    return this;
+  }
+  // --- Shortcut building ---
+  _buildShortcuts() {
+    const editor = this._editor;
+    if (!editor) return this.customShortcuts;
+    const result = [];
+    if (this.playback) {
+      const map = this.playbackShortcuts;
+      result.push(
+        this._makeShortcut(
+          map?.playPause ?? { key: " ", ctrlKey: false, metaKey: false },
+          () => editor.togglePlayPause(),
+          "Play/Pause"
+        ),
+        this._makeShortcut(
+          map?.stop ?? { key: "Escape", ctrlKey: false, metaKey: false },
+          () => editor.stop(),
+          "Stop"
+        ),
+        this._makeShortcut(
+          map?.rewindToStart ?? { key: "0", ctrlKey: false, metaKey: false },
+          () => editor.seekTo(0),
+          "Rewind to start"
+        )
+      );
+    }
+    if (this.splitting) {
+      const map = this.splittingShortcuts;
+      const binding = map?.splitAtPlayhead ?? {
+        key: "s",
+        ctrlKey: false,
+        metaKey: false,
+        altKey: false
+      };
+      result.push(this._makeShortcut(binding, () => editor.splitAtPlayhead(), "Split at playhead"));
+    }
+    if (this.undo) {
+      const map = this.undoShortcuts;
+      const undoBinding = map?.undo ?? { key: "z" };
+      const redoBinding = map?.redo ?? { key: "z", shiftKey: true };
+      if (undoBinding.ctrlKey === void 0 && undoBinding.metaKey === void 0) {
+        const undoShift = undoBinding.shiftKey === void 0 ? { shiftKey: false } : {};
+        result.push(
+          this._makeShortcut(
+            { ...undoBinding, ctrlKey: true, ...undoShift },
+            () => editor.undo(),
+            "Undo"
+          ),
+          this._makeShortcut(
+            { ...undoBinding, metaKey: true, ...undoShift },
+            () => editor.undo(),
+            "Undo"
+          )
+        );
+      } else {
+        result.push(this._makeShortcut(undoBinding, () => editor.undo(), "Undo"));
+      }
+      if (redoBinding.ctrlKey === void 0 && redoBinding.metaKey === void 0) {
+        const redoShift = redoBinding.shiftKey === void 0 ? { shiftKey: true } : {};
+        result.push(
+          this._makeShortcut(
+            { ...redoBinding, ctrlKey: true, ...redoShift },
+            () => editor.redo(),
+            "Redo"
+          ),
+          this._makeShortcut(
+            { ...redoBinding, metaKey: true, ...redoShift },
+            () => editor.redo(),
+            "Redo"
+          )
+        );
+      } else {
+        result.push(this._makeShortcut(redoBinding, () => editor.redo(), "Redo"));
+      }
+    }
+    result.push(...this.customShortcuts);
+    return result;
+  }
+  _makeShortcut(binding, action, description) {
+    return {
+      key: binding.key,
+      ...binding.ctrlKey !== void 0 && { ctrlKey: binding.ctrlKey },
+      ...binding.shiftKey !== void 0 && { shiftKey: binding.shiftKey },
+      ...binding.metaKey !== void 0 && { metaKey: binding.metaKey },
+      ...binding.altKey !== void 0 && { altKey: binding.altKey },
+      action,
+      description
+    };
+  }
+};
+__decorateClass([
+  (0, import_decorators14.property)({ type: Boolean })
+], DawKeyboardShortcutsElement.prototype, "playback", 2);
+__decorateClass([
+  (0, import_decorators14.property)({ type: Boolean })
+], DawKeyboardShortcutsElement.prototype, "splitting", 2);
+__decorateClass([
+  (0, import_decorators14.property)({ type: Boolean })
+], DawKeyboardShortcutsElement.prototype, "undo", 2);
+DawKeyboardShortcutsElement = __decorateClass([
+  (0, import_decorators14.customElement)("daw-keyboard-shortcuts")
+], DawKeyboardShortcutsElement);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AudioResumeController,
+  ClipPointerHandler,
   DawClipElement,
   DawEditorElement,
+  DawKeyboardShortcutsElement,
   DawPauseButtonElement,
   DawPlayButtonElement,
   DawPlayheadElement,
@@ -3106,6 +4159,7 @@ DawRecordButtonElement = __decorateClass([
   DawTransportButton,
   DawTransportElement,
   DawWaveformElement,
-  RecordingController
+  RecordingController,
+  splitAtPlayhead
 });
 //# sourceMappingURL=index.js.map