@waveform-playlist/core 12.6.0 → 12.6.1

package/dist/index.d.mts

@@ -476,6 +476,10 @@ interface AnnotationData {
     end: number;
     lines: string[];
     language?: string;
+    /** Musical position (ticks). Authoritative when BOTH tick fields are set —
+     * start/end seconds are then a derived cache (clip startTick pattern). */
+    startTick?: number;
+    endTick?: number;
 }
 /**
  * Annotation format definition for parsing/serializing
@@ -775,6 +779,21 @@ declare const MIN_PIXELS_PER_UNIT = 8;
  * correct across meter changes.
  */
 declare function computeMusicalTicks(params: MusicalTickParams): MusicalTickData;
+/**
+ * Convert an absolute tick to a 1-based bar.beat position, honoring meter
+ * changes. Bars/beats are counted per meter segment (the same walk
+ * `computeMusicalTicks` uses to build its `barOffset` accumulator). Beat is
+ * the integer beat the tick falls WITHIN (floor, 1-based) — a tick exactly on
+ * a bar line is beat 1.
+ *
+ * Guards: empty `meterEntries` → treat as 4/4 from tick 0. `ppqn <= 0` →
+ * returns `{ bar: 1, beat: 1 }` (division-by-zero guard, matches
+ * `computeMusicalTicks`'s ppqn guard).
+ */
+declare function ticksToBarBeat(tick: number, meterEntries: MeterEntry[], ppqn: number): {
+    bar: number;
+    beat: number;
+};
 /**
  * Snaps a tick position to the nearest grid boundary defined by `snapTo`.
  *
@@ -1025,6 +1044,13 @@ interface KeyboardShortcut {
     description?: string;
     preventDefault?: boolean;
 }
+/** A key + modifier combination, without an action. Used for remapping maps. */
+type KeyBinding = Pick<KeyboardShortcut, 'key' | 'ctrlKey' | 'shiftKey' | 'metaKey' | 'altKey'>;
+/**
+ * Does a keyboard event match a key binding?
+ * `undefined` modifier = match any state; `false` = must NOT be pressed.
+ */
+declare function matchesKeyBinding(event: KeyboardEvent, binding: KeyBinding): boolean;
 /**
  * Handle a keyboard event against a list of shortcuts.
  * Pure function, no framework dependency.
@@ -1114,4 +1140,57 @@ declare function enumerateMicrophones(mediaDevices?: MediaDevices): Promise<Micr
  */
 declare function watchMicrophoneDevices(listener: (enumeration: MicrophoneEnumeration) => void, mediaDevices?: MediaDevices): () => void;
 
-export { type AnnotationAction, type AnnotationActionOptions, type AnnotationData, type AnnotationEventMap, type AnnotationFormat, type AnnotationListOptions, type AudioBuffer$1 as AudioBuffer, type AudioClip, type Bits, type ClipTrack, type ColorMapEntry, type ColorMapName, type ColorMapValue, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateClipOptionsTicks, type CreateTrackOptions, DEFAULT_SPECTROGRAM_COLOR_MAP, type FFTSize, type Fade, type FadeConfig, type FadeType, type Gap, InteractionState, type KeyboardShortcut, MAX_CANVAS_WIDTH, MIN_PIXELS_PER_UNIT, type MeterEntry, type MicrophoneDeviceInfo, type MicrophoneEnumeration, type MidiNoteData, type MusicalTick, type MusicalTickData, type MusicalTickParams, PPQN, type PeakData, type Peaks, type PlaylistConfig, type PlayoutState, type RangeSupport, type RenderAnnotationItemProps, type RenderMode, SPECTROGRAM_DEFAULTS, type SnapTo, type SpectrogramCanvasIdParts, type SpectrogramComputeConfig, type SpectrogramConfig, type SpectrogramData, type SpectrogramDisplayConfig, type TickType, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type TrackSpectrogramOverrides, type WaveformConfig, type WaveformDataObject, type ZoomLevel, appendPeaks, appendToAudioBuffer, applyFadeIn, applyFadeOut, audibleLatencySamples, buildSpectrogramCanvasId, calculateDuration, carveClipRange, clipDurationTime, clipEndTime, clipOffsetTime, clipPixelWidth, clipStartTime, clipsOverlap, computeMusicalTicks, concatenateAudioData, createAudioBuffer, createClip, createClipFromSeconds, createClipFromTicks, createTimeline, createTrack, dBToNormalized, detectMeterChanges, enumerateMicrophones, exponentialCurve, findGaps, gainToDb, gainToNormalized, generateCurve, generatePeaks, getClipsAtSample, getClipsInRange, getShortcutLabel, handleKeyboardEvent, linearCurve, logarithmicCurve, normalizedToDb, parseSpectrogramCanvasId, pixelsToSamples, pixelsToSeconds, probeRangeSupport, resolveRecordingOffsetSamples, sCurveCurve, samplesToPixels, samplesToSeconds, samplesToTicks, secondsToPixels, secondsToSamples, snapTickToGrid, snapToGrid, snapToTicks, sortClipsByTime, ticksPerBar, ticksPerBeat, ticksToSamples, trackChannelCount, watchMicrophoneDevices };
+/** Edges within this distance (seconds) are considered "linked". */
+declare const LINK_THRESHOLD = 0.01;
+/** Minimum annotation duration (seconds) enforced by boundary edits. */
+declare const MIN_ANNOTATION_DURATION = 0.1;
+/** Link threshold for INTEGER TICK positions — closer than half a tick means equal. */
+declare const ANNOTATION_LINK_THRESHOLD_TICKS = 0.5;
+/** Minimum tick-annotation duration: a 128th note, floored at 1 tick. */
+declare function annotationMinDurationTicks(ppqn: number): number;
+/** Unit constants for a boundary-math run. Defaults are the seconds-domain values. */
+interface AnnotationBoundaryOptions {
+    linkThreshold?: number;
+    minDuration?: number;
+}
+interface AnnotationBoundaryUpdate {
+    annotationIndex: number;
+    newTime: number;
+    isDraggingStart: boolean;
+    annotations: AnnotationData[];
+    duration: number;
+    linkEndpoints: boolean;
+}
+/**
+ * Pure boundary-update logic shared by the React annotations package and the
+ * dawcore annotation web components. Handles linked endpoints (moving one edge
+ * drags the linked neighbor edge, with cascade) and collision push-back.
+ * Returns a NEW array; never mutates inputs.
+ */
+declare function updateAnnotationBoundaries(params: AnnotationBoundaryUpdate, options?: AnnotationBoundaryOptions): AnnotationData[];
+
+type AnnotationShortcutAction = 'selectPrevious' | 'selectNext' | 'selectFirst' | 'selectLast' | 'clearSelection' | 'moveStartEarlier' | 'moveStartLater' | 'moveEndEarlier' | 'moveEndLater' | 'playActive';
+/** Key remapping map — null on the consumer means "use defaults". */
+interface AnnotationShortcutMap {
+    selectPrevious?: KeyBinding;
+    selectNext?: KeyBinding;
+    selectFirst?: KeyBinding;
+    selectLast?: KeyBinding;
+    clearSelection?: KeyBinding;
+    moveStartEarlier?: KeyBinding;
+    moveStartLater?: KeyBinding;
+    moveEndEarlier?: KeyBinding;
+    moveEndLater?: KeyBinding;
+    playActive?: KeyBinding;
+}
+declare const DEFAULT_ANNOTATION_SHORTCUTS: Record<AnnotationShortcutAction, KeyBinding[]>;
+/**
+ * Flatten defaults + remap into a matchable list. A remapped action replaces
+ * ALL of its default bindings with the single provided binding.
+ */
+declare function resolveAnnotationShortcuts(remap: AnnotationShortcutMap | null): Array<{
+    action: AnnotationShortcutAction;
+    binding: KeyBinding;
+}>;
+
+export { ANNOTATION_LINK_THRESHOLD_TICKS, type AnnotationAction, type AnnotationActionOptions, type AnnotationBoundaryOptions, type AnnotationBoundaryUpdate, type AnnotationData, type AnnotationEventMap, type AnnotationFormat, type AnnotationListOptions, type AnnotationShortcutAction, type AnnotationShortcutMap, type AudioBuffer$1 as AudioBuffer, type AudioClip, type Bits, type ClipTrack, type ColorMapEntry, type ColorMapName, type ColorMapValue, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateClipOptionsTicks, type CreateTrackOptions, DEFAULT_ANNOTATION_SHORTCUTS, DEFAULT_SPECTROGRAM_COLOR_MAP, type FFTSize, type Fade, type FadeConfig, type FadeType, type Gap, InteractionState, type KeyBinding, type KeyboardShortcut, LINK_THRESHOLD, MAX_CANVAS_WIDTH, MIN_ANNOTATION_DURATION, MIN_PIXELS_PER_UNIT, type MeterEntry, type MicrophoneDeviceInfo, type MicrophoneEnumeration, type MidiNoteData, type MusicalTick, type MusicalTickData, type MusicalTickParams, PPQN, type PeakData, type Peaks, type PlaylistConfig, type PlayoutState, type RangeSupport, type RenderAnnotationItemProps, type RenderMode, SPECTROGRAM_DEFAULTS, type SnapTo, type SpectrogramCanvasIdParts, type SpectrogramComputeConfig, type SpectrogramConfig, type SpectrogramData, type SpectrogramDisplayConfig, type TickType, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type TrackSpectrogramOverrides, type WaveformConfig, type WaveformDataObject, type ZoomLevel, annotationMinDurationTicks, appendPeaks, appendToAudioBuffer, applyFadeIn, applyFadeOut, audibleLatencySamples, buildSpectrogramCanvasId, calculateDuration, carveClipRange, clipDurationTime, clipEndTime, clipOffsetTime, clipPixelWidth, clipStartTime, clipsOverlap, computeMusicalTicks, concatenateAudioData, createAudioBuffer, createClip, createClipFromSeconds, createClipFromTicks, createTimeline, createTrack, dBToNormalized, detectMeterChanges, enumerateMicrophones, exponentialCurve, findGaps, gainToDb, gainToNormalized, generateCurve, generatePeaks, getClipsAtSample, getClipsInRange, getShortcutLabel, handleKeyboardEvent, linearCurve, logarithmicCurve, matchesKeyBinding, normalizedToDb, parseSpectrogramCanvasId, pixelsToSamples, pixelsToSeconds, probeRangeSupport, resolveAnnotationShortcuts, resolveRecordingOffsetSamples, sCurveCurve, samplesToPixels, samplesToSeconds, samplesToTicks, secondsToPixels, secondsToSamples, snapTickToGrid, snapToGrid, snapToTicks, sortClipsByTime, ticksPerBar, ticksPerBeat, ticksToBarBeat, ticksToSamples, trackChannelCount, updateAnnotationBoundaries, watchMicrophoneDevices };

package/dist/index.d.ts

@@ -476,6 +476,10 @@ interface AnnotationData {
     end: number;
     lines: string[];
     language?: string;
+    /** Musical position (ticks). Authoritative when BOTH tick fields are set —
+     * start/end seconds are then a derived cache (clip startTick pattern). */
+    startTick?: number;
+    endTick?: number;
 }
 /**
  * Annotation format definition for parsing/serializing
@@ -775,6 +779,21 @@ declare const MIN_PIXELS_PER_UNIT = 8;
  * correct across meter changes.
  */
 declare function computeMusicalTicks(params: MusicalTickParams): MusicalTickData;
+/**
+ * Convert an absolute tick to a 1-based bar.beat position, honoring meter
+ * changes. Bars/beats are counted per meter segment (the same walk
+ * `computeMusicalTicks` uses to build its `barOffset` accumulator). Beat is
+ * the integer beat the tick falls WITHIN (floor, 1-based) — a tick exactly on
+ * a bar line is beat 1.
+ *
+ * Guards: empty `meterEntries` → treat as 4/4 from tick 0. `ppqn <= 0` →
+ * returns `{ bar: 1, beat: 1 }` (division-by-zero guard, matches
+ * `computeMusicalTicks`'s ppqn guard).
+ */
+declare function ticksToBarBeat(tick: number, meterEntries: MeterEntry[], ppqn: number): {
+    bar: number;
+    beat: number;
+};
 /**
  * Snaps a tick position to the nearest grid boundary defined by `snapTo`.
  *
@@ -1025,6 +1044,13 @@ interface KeyboardShortcut {
     description?: string;
     preventDefault?: boolean;
 }
+/** A key + modifier combination, without an action. Used for remapping maps. */
+type KeyBinding = Pick<KeyboardShortcut, 'key' | 'ctrlKey' | 'shiftKey' | 'metaKey' | 'altKey'>;
+/**
+ * Does a keyboard event match a key binding?
+ * `undefined` modifier = match any state; `false` = must NOT be pressed.
+ */
+declare function matchesKeyBinding(event: KeyboardEvent, binding: KeyBinding): boolean;
 /**
  * Handle a keyboard event against a list of shortcuts.
  * Pure function, no framework dependency.
@@ -1114,4 +1140,57 @@ declare function enumerateMicrophones(mediaDevices?: MediaDevices): Promise<Micr
  */
 declare function watchMicrophoneDevices(listener: (enumeration: MicrophoneEnumeration) => void, mediaDevices?: MediaDevices): () => void;
 
-export { type AnnotationAction, type AnnotationActionOptions, type AnnotationData, type AnnotationEventMap, type AnnotationFormat, type AnnotationListOptions, type AudioBuffer$1 as AudioBuffer, type AudioClip, type Bits, type ClipTrack, type ColorMapEntry, type ColorMapName, type ColorMapValue, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateClipOptionsTicks, type CreateTrackOptions, DEFAULT_SPECTROGRAM_COLOR_MAP, type FFTSize, type Fade, type FadeConfig, type FadeType, type Gap, InteractionState, type KeyboardShortcut, MAX_CANVAS_WIDTH, MIN_PIXELS_PER_UNIT, type MeterEntry, type MicrophoneDeviceInfo, type MicrophoneEnumeration, type MidiNoteData, type MusicalTick, type MusicalTickData, type MusicalTickParams, PPQN, type PeakData, type Peaks, type PlaylistConfig, type PlayoutState, type RangeSupport, type RenderAnnotationItemProps, type RenderMode, SPECTROGRAM_DEFAULTS, type SnapTo, type SpectrogramCanvasIdParts, type SpectrogramComputeConfig, type SpectrogramConfig, type SpectrogramData, type SpectrogramDisplayConfig, type TickType, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type TrackSpectrogramOverrides, type WaveformConfig, type WaveformDataObject, type ZoomLevel, appendPeaks, appendToAudioBuffer, applyFadeIn, applyFadeOut, audibleLatencySamples, buildSpectrogramCanvasId, calculateDuration, carveClipRange, clipDurationTime, clipEndTime, clipOffsetTime, clipPixelWidth, clipStartTime, clipsOverlap, computeMusicalTicks, concatenateAudioData, createAudioBuffer, createClip, createClipFromSeconds, createClipFromTicks, createTimeline, createTrack, dBToNormalized, detectMeterChanges, enumerateMicrophones, exponentialCurve, findGaps, gainToDb, gainToNormalized, generateCurve, generatePeaks, getClipsAtSample, getClipsInRange, getShortcutLabel, handleKeyboardEvent, linearCurve, logarithmicCurve, normalizedToDb, parseSpectrogramCanvasId, pixelsToSamples, pixelsToSeconds, probeRangeSupport, resolveRecordingOffsetSamples, sCurveCurve, samplesToPixels, samplesToSeconds, samplesToTicks, secondsToPixels, secondsToSamples, snapTickToGrid, snapToGrid, snapToTicks, sortClipsByTime, ticksPerBar, ticksPerBeat, ticksToSamples, trackChannelCount, watchMicrophoneDevices };
+/** Edges within this distance (seconds) are considered "linked". */
+declare const LINK_THRESHOLD = 0.01;
+/** Minimum annotation duration (seconds) enforced by boundary edits. */
+declare const MIN_ANNOTATION_DURATION = 0.1;
+/** Link threshold for INTEGER TICK positions — closer than half a tick means equal. */
+declare const ANNOTATION_LINK_THRESHOLD_TICKS = 0.5;
+/** Minimum tick-annotation duration: a 128th note, floored at 1 tick. */
+declare function annotationMinDurationTicks(ppqn: number): number;
+/** Unit constants for a boundary-math run. Defaults are the seconds-domain values. */
+interface AnnotationBoundaryOptions {
+    linkThreshold?: number;
+    minDuration?: number;
+}
+interface AnnotationBoundaryUpdate {
+    annotationIndex: number;
+    newTime: number;
+    isDraggingStart: boolean;
+    annotations: AnnotationData[];
+    duration: number;
+    linkEndpoints: boolean;
+}
+/**
+ * Pure boundary-update logic shared by the React annotations package and the
+ * dawcore annotation web components. Handles linked endpoints (moving one edge
+ * drags the linked neighbor edge, with cascade) and collision push-back.
+ * Returns a NEW array; never mutates inputs.
+ */
+declare function updateAnnotationBoundaries(params: AnnotationBoundaryUpdate, options?: AnnotationBoundaryOptions): AnnotationData[];
+
+type AnnotationShortcutAction = 'selectPrevious' | 'selectNext' | 'selectFirst' | 'selectLast' | 'clearSelection' | 'moveStartEarlier' | 'moveStartLater' | 'moveEndEarlier' | 'moveEndLater' | 'playActive';
+/** Key remapping map — null on the consumer means "use defaults". */
+interface AnnotationShortcutMap {
+    selectPrevious?: KeyBinding;
+    selectNext?: KeyBinding;
+    selectFirst?: KeyBinding;
+    selectLast?: KeyBinding;
+    clearSelection?: KeyBinding;
+    moveStartEarlier?: KeyBinding;
+    moveStartLater?: KeyBinding;
+    moveEndEarlier?: KeyBinding;
+    moveEndLater?: KeyBinding;
+    playActive?: KeyBinding;
+}
+declare const DEFAULT_ANNOTATION_SHORTCUTS: Record<AnnotationShortcutAction, KeyBinding[]>;
+/**
+ * Flatten defaults + remap into a matchable list. A remapped action replaces
+ * ALL of its default bindings with the single provided binding.
+ */
+declare function resolveAnnotationShortcuts(remap: AnnotationShortcutMap | null): Array<{
+    action: AnnotationShortcutAction;
+    binding: KeyBinding;
+}>;
+
+export { ANNOTATION_LINK_THRESHOLD_TICKS, type AnnotationAction, type AnnotationActionOptions, type AnnotationBoundaryOptions, type AnnotationBoundaryUpdate, type AnnotationData, type AnnotationEventMap, type AnnotationFormat, type AnnotationListOptions, type AnnotationShortcutAction, type AnnotationShortcutMap, type AudioBuffer$1 as AudioBuffer, type AudioClip, type Bits, type ClipTrack, type ColorMapEntry, type ColorMapName, type ColorMapValue, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateClipOptionsTicks, type CreateTrackOptions, DEFAULT_ANNOTATION_SHORTCUTS, DEFAULT_SPECTROGRAM_COLOR_MAP, type FFTSize, type Fade, type FadeConfig, type FadeType, type Gap, InteractionState, type KeyBinding, type KeyboardShortcut, LINK_THRESHOLD, MAX_CANVAS_WIDTH, MIN_ANNOTATION_DURATION, MIN_PIXELS_PER_UNIT, type MeterEntry, type MicrophoneDeviceInfo, type MicrophoneEnumeration, type MidiNoteData, type MusicalTick, type MusicalTickData, type MusicalTickParams, PPQN, type PeakData, type Peaks, type PlaylistConfig, type PlayoutState, type RangeSupport, type RenderAnnotationItemProps, type RenderMode, SPECTROGRAM_DEFAULTS, type SnapTo, type SpectrogramCanvasIdParts, type SpectrogramComputeConfig, type SpectrogramConfig, type SpectrogramData, type SpectrogramDisplayConfig, type TickType, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type TrackSpectrogramOverrides, type WaveformConfig, type WaveformDataObject, type ZoomLevel, annotationMinDurationTicks, appendPeaks, appendToAudioBuffer, applyFadeIn, applyFadeOut, audibleLatencySamples, buildSpectrogramCanvasId, calculateDuration, carveClipRange, clipDurationTime, clipEndTime, clipOffsetTime, clipPixelWidth, clipStartTime, clipsOverlap, computeMusicalTicks, concatenateAudioData, createAudioBuffer, createClip, createClipFromSeconds, createClipFromTicks, createTimeline, createTrack, dBToNormalized, detectMeterChanges, enumerateMicrophones, exponentialCurve, findGaps, gainToDb, gainToNormalized, generateCurve, generatePeaks, getClipsAtSample, getClipsInRange, getShortcutLabel, handleKeyboardEvent, linearCurve, logarithmicCurve, matchesKeyBinding, normalizedToDb, parseSpectrogramCanvasId, pixelsToSamples, pixelsToSeconds, probeRangeSupport, resolveAnnotationShortcuts, resolveRecordingOffsetSamples, sCurveCurve, samplesToPixels, samplesToSeconds, samplesToTicks, secondsToPixels, secondsToSamples, snapTickToGrid, snapToGrid, snapToTicks, sortClipsByTime, ticksPerBar, ticksPerBeat, ticksToBarBeat, ticksToSamples, trackChannelCount, updateAnnotationBoundaries, watchMicrophoneDevices };

package/dist/index.js

@@ -20,12 +20,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ANNOTATION_LINK_THRESHOLD_TICKS: () => ANNOTATION_LINK_THRESHOLD_TICKS,
+  DEFAULT_ANNOTATION_SHORTCUTS: () => DEFAULT_ANNOTATION_SHORTCUTS,
   DEFAULT_SPECTROGRAM_COLOR_MAP: () => DEFAULT_SPECTROGRAM_COLOR_MAP,
   InteractionState: () => InteractionState,
+  LINK_THRESHOLD: () => LINK_THRESHOLD,
   MAX_CANVAS_WIDTH: () => MAX_CANVAS_WIDTH,
+  MIN_ANNOTATION_DURATION: () => MIN_ANNOTATION_DURATION,
   MIN_PIXELS_PER_UNIT: () => MIN_PIXELS_PER_UNIT,
   PPQN: () => PPQN,
   SPECTROGRAM_DEFAULTS: () => SPECTROGRAM_DEFAULTS,
+  annotationMinDurationTicks: () => annotationMinDurationTicks,
   appendPeaks: () => appendPeaks,
   appendToAudioBuffer: () => appendToAudioBuffer,
   applyFadeIn: () => applyFadeIn,
@@ -63,11 +68,13 @@ __export(index_exports, {
   handleKeyboardEvent: () => handleKeyboardEvent,
   linearCurve: () => linearCurve,
   logarithmicCurve: () => logarithmicCurve,
+  matchesKeyBinding: () => matchesKeyBinding,
   normalizedToDb: () => normalizedToDb,
   parseSpectrogramCanvasId: () => parseSpectrogramCanvasId,
   pixelsToSamples: () => pixelsToSamples,
   pixelsToSeconds: () => pixelsToSeconds,
   probeRangeSupport: () => probeRangeSupport,
+  resolveAnnotationShortcuts: () => resolveAnnotationShortcuts,
   resolveRecordingOffsetSamples: () => resolveRecordingOffsetSamples,
   sCurveCurve: () => sCurveCurve,
   samplesToPixels: () => samplesToPixels,
@@ -81,8 +88,10 @@ __export(index_exports, {
   sortClipsByTime: () => sortClipsByTime,
   ticksPerBar: () => ticksPerBar,
   ticksPerBeat: () => ticksPerBeat,
+  ticksToBarBeat: () => ticksToBarBeat,
   ticksToSamples: () => ticksToSamples,
   trackChannelCount: () => trackChannelCount,
+  updateAnnotationBoundaries: () => updateAnnotationBoundaries,
   watchMicrophoneDevices: () => watchMicrophoneDevices
 });
 module.exports = __toCommonJS(index_exports);
@@ -545,6 +554,37 @@ function computeMusicalTicks(params) {
   };
   return result;
 }
+function ticksToBarBeat(tick, meterEntries, ppqn) {
+  if (ppqn <= 0) return { bar: 1, beat: 1 };
+  const entries = meterEntries.length > 0 ? meterEntries : [{ tick: 0, numerator: 4, denominator: 4 }];
+  let barOffset = 0;
+  for (let i = 0; i < entries.length; i++) {
+    const meter = entries[i];
+    const segmentStart = meter.tick;
+    const segmentEnd = i + 1 < entries.length ? entries[i + 1].tick : Number.MAX_SAFE_INTEGER;
+    const ts2 = [meter.numerator, meter.denominator];
+    const tpBar2 = ticksPerBar(ts2, ppqn);
+    const tpBeat2 = ticksPerBeat(ts2, ppqn);
+    if (tick >= segmentStart && tick < segmentEnd) {
+      const offset2 = tick - segmentStart;
+      const barIndexInSegment2 = Math.floor(offset2 / tpBar2);
+      const beatInBar2 = Math.floor(offset2 % tpBar2 / tpBeat2);
+      return { bar: barOffset + barIndexInSegment2 + 1, beat: beatInBar2 + 1 };
+    }
+    if (segmentEnd !== Number.MAX_SAFE_INTEGER) {
+      const segmentLen = segmentEnd - segmentStart;
+      barOffset += Math.floor(segmentLen / tpBar2);
+    }
+  }
+  const first = entries[0];
+  const ts = [first.numerator, first.denominator];
+  const tpBar = ticksPerBar(ts, ppqn);
+  const tpBeat = ticksPerBeat(ts, ppqn);
+  const offset = tick - first.tick;
+  const barIndexInSegment = Math.floor(offset / tpBar);
+  const beatInBar = Math.floor(offset % tpBar / tpBeat);
+  return { bar: barIndexInSegment + 1, beat: beatInBar + 1 };
+}
 function snapTickToGrid(tick, snapTo, meterEntries, ppqn = 960) {
   if (snapTo === "off") return tick;
   let meter = meterEntries[0] ?? { tick: 0, numerator: 4, denominator: 4 };
@@ -889,6 +929,14 @@ function applyFadeOut(param, startTime, duration, type = "linear", startValue =
 }
 
 // src/keyboard.ts
+function matchesKeyBinding(event, binding) {
+  const keyMatch = event.key.toLowerCase() === binding.key.toLowerCase() || event.key === binding.key;
+  const ctrlMatch = binding.ctrlKey === void 0 || event.ctrlKey === binding.ctrlKey;
+  const shiftMatch = binding.shiftKey === void 0 || event.shiftKey === binding.shiftKey;
+  const metaMatch = binding.metaKey === void 0 || event.metaKey === binding.metaKey;
+  const altMatch = binding.altKey === void 0 || event.altKey === binding.altKey;
+  return keyMatch && ctrlMatch && shiftMatch && metaMatch && altMatch;
+}
 function handleKeyboardEvent(event, shortcuts, enabled) {
   if (!enabled) return;
   if (event.repeat) return;
@@ -896,14 +944,7 @@ function handleKeyboardEvent(event, shortcuts, enabled) {
   if (target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.isContentEditable) {
     return;
   }
-  const matchingShortcut = shortcuts.find((shortcut) => {
-    const keyMatch = event.key.toLowerCase() === shortcut.key.toLowerCase() || event.key === shortcut.key;
-    const ctrlMatch = shortcut.ctrlKey === void 0 || event.ctrlKey === shortcut.ctrlKey;
-    const shiftMatch = shortcut.shiftKey === void 0 || event.shiftKey === shortcut.shiftKey;
-    const metaMatch = shortcut.metaKey === void 0 || event.metaKey === shortcut.metaKey;
-    const altMatch = shortcut.altKey === void 0 || event.altKey === shortcut.altKey;
-    return keyMatch && ctrlMatch && shiftMatch && metaMatch && altMatch;
-  });
+  const matchingShortcut = shortcuts.find((shortcut) => matchesKeyBinding(event, shortcut));
   if (matchingShortcut) {
     if (matchingShortcut.preventDefault !== false) {
       event.preventDefault();
@@ -1004,14 +1045,138 @@ function watchMicrophoneDevices(listener, mediaDevices) {
     md.removeEventListener("devicechange", deliver);
   };
 }
+
+// src/annotations/boundaries.ts
+var LINK_THRESHOLD = 0.01;
+var MIN_ANNOTATION_DURATION = 0.1;
+var ANNOTATION_LINK_THRESHOLD_TICKS = 0.5;
+function annotationMinDurationTicks(ppqn) {
+  return Math.max(1, Math.round(ppqn / 32));
+}
+function updateAnnotationBoundaries(params, options = {}) {
+  const { annotationIndex, newTime, isDraggingStart, annotations, duration, linkEndpoints } = params;
+  const linkThreshold = options.linkThreshold ?? LINK_THRESHOLD;
+  const minDuration = options.minDuration ?? MIN_ANNOTATION_DURATION;
+  const updatedAnnotations = [...annotations];
+  const annotation = annotations[annotationIndex];
+  if (isDraggingStart) {
+    const constrainedStart = Math.min(annotation.end - minDuration, Math.max(0, newTime));
+    const delta = constrainedStart - annotation.start;
+    updatedAnnotations[annotationIndex] = { ...annotation, start: constrainedStart };
+    if (linkEndpoints && annotationIndex > 0) {
+      const prevAnnotation = updatedAnnotations[annotationIndex - 1];
+      if (Math.abs(prevAnnotation.end - annotation.start) < linkThreshold) {
+        updatedAnnotations[annotationIndex - 1] = {
+          ...prevAnnotation,
+          end: Math.max(prevAnnotation.start + minDuration, prevAnnotation.end + delta)
+        };
+      } else if (constrainedStart <= prevAnnotation.end) {
+        updatedAnnotations[annotationIndex] = {
+          ...updatedAnnotations[annotationIndex],
+          start: prevAnnotation.end
+        };
+      }
+    } else if (!linkEndpoints && annotationIndex > 0 && constrainedStart < updatedAnnotations[annotationIndex - 1].end) {
+      updatedAnnotations[annotationIndex - 1] = {
+        ...updatedAnnotations[annotationIndex - 1],
+        end: constrainedStart
+      };
+    }
+  } else {
+    const constrainedEnd = Math.max(annotation.start + minDuration, Math.min(newTime, duration));
+    const delta = constrainedEnd - annotation.end;
+    updatedAnnotations[annotationIndex] = { ...annotation, end: constrainedEnd };
+    if (linkEndpoints && annotationIndex < updatedAnnotations.length - 1) {
+      const nextAnnotation = updatedAnnotations[annotationIndex + 1];
+      if (Math.abs(nextAnnotation.start - annotation.end) < linkThreshold) {
+        const newStart = nextAnnotation.start + delta;
+        updatedAnnotations[annotationIndex + 1] = {
+          ...nextAnnotation,
+          start: Math.min(nextAnnotation.end - minDuration, newStart)
+        };
+        let currentIndex = annotationIndex + 1;
+        while (currentIndex < updatedAnnotations.length - 1) {
+          const current = updatedAnnotations[currentIndex];
+          const next = updatedAnnotations[currentIndex + 1];
+          if (Math.abs(next.start - current.end) < linkThreshold) {
+            const nextDelta = current.end - annotations[currentIndex].end;
+            updatedAnnotations[currentIndex + 1] = {
+              ...next,
+              start: Math.min(next.end - minDuration, next.start + nextDelta)
+            };
+            currentIndex++;
+          } else {
+            break;
+          }
+        }
+      } else if (constrainedEnd >= nextAnnotation.start) {
+        updatedAnnotations[annotationIndex] = {
+          ...updatedAnnotations[annotationIndex],
+          end: nextAnnotation.start
+        };
+      }
+    } else if (!linkEndpoints && annotationIndex < updatedAnnotations.length - 1 && constrainedEnd > updatedAnnotations[annotationIndex + 1].start) {
+      const nextAnnotation = updatedAnnotations[annotationIndex + 1];
+      updatedAnnotations[annotationIndex + 1] = { ...nextAnnotation, start: constrainedEnd };
+      let currentIndex = annotationIndex + 1;
+      while (currentIndex < updatedAnnotations.length - 1) {
+        const current = updatedAnnotations[currentIndex];
+        const next = updatedAnnotations[currentIndex + 1];
+        if (current.end > next.start) {
+          updatedAnnotations[currentIndex + 1] = { ...next, start: current.end };
+          currentIndex++;
+        } else {
+          break;
+        }
+      }
+    }
+  }
+  return updatedAnnotations;
+}
+
+// src/annotations/shortcuts.ts
+var noMods = { ctrlKey: false, metaKey: false };
+var DEFAULT_ANNOTATION_SHORTCUTS = {
+  selectPrevious: [
+    { key: "ArrowUp", ...noMods },
+    { key: "ArrowLeft", ...noMods }
+  ],
+  selectNext: [
+    { key: "ArrowDown", ...noMods },
+    { key: "ArrowRight", ...noMods }
+  ],
+  selectFirst: [{ key: "Home", ...noMods }],
+  selectLast: [{ key: "End", ...noMods }],
+  clearSelection: [{ key: "Escape", ...noMods }],
+  moveStartEarlier: [{ key: "[", ...noMods }],
+  moveStartLater: [{ key: "]", ...noMods }],
+  // '{' / '}' are what event.key reports for Shift+[ / Shift+] — no explicit
+  // shiftKey needed; the key value itself encodes it.
+  moveEndEarlier: [{ key: "{", ...noMods }],
+  moveEndLater: [{ key: "}", ...noMods }],
+  playActive: [{ key: "Enter", ...noMods }]
+};
+var ALL_ACTIONS = Object.keys(DEFAULT_ANNOTATION_SHORTCUTS);
+function resolveAnnotationShortcuts(remap) {
+  return ALL_ACTIONS.flatMap((action) => {
+    const override = remap?.[action];
+    const bindings = override ? [override] : DEFAULT_ANNOTATION_SHORTCUTS[action];
+    return bindings.map((binding) => ({ action, binding }));
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ANNOTATION_LINK_THRESHOLD_TICKS,
+  DEFAULT_ANNOTATION_SHORTCUTS,
   DEFAULT_SPECTROGRAM_COLOR_MAP,
   InteractionState,
+  LINK_THRESHOLD,
   MAX_CANVAS_WIDTH,
+  MIN_ANNOTATION_DURATION,
   MIN_PIXELS_PER_UNIT,
   PPQN,
   SPECTROGRAM_DEFAULTS,
+  annotationMinDurationTicks,
   appendPeaks,
   appendToAudioBuffer,
   applyFadeIn,
@@ -1049,11 +1214,13 @@ function watchMicrophoneDevices(listener, mediaDevices) {
   handleKeyboardEvent,
   linearCurve,
   logarithmicCurve,
+  matchesKeyBinding,
   normalizedToDb,
   parseSpectrogramCanvasId,
   pixelsToSamples,
   pixelsToSeconds,
   probeRangeSupport,
+  resolveAnnotationShortcuts,
   resolveRecordingOffsetSamples,
   sCurveCurve,
   samplesToPixels,
@@ -1067,8 +1234,10 @@ function watchMicrophoneDevices(listener, mediaDevices) {
   sortClipsByTime,
   ticksPerBar,
   ticksPerBeat,
+  ticksToBarBeat,
   ticksToSamples,
   trackChannelCount,
+  updateAnnotationBoundaries,
   watchMicrophoneDevices
 });
 //# sourceMappingURL=index.js.map