@octoseq/mir 0.1.0-main.994cb4e → 0.1.0-main.9ea6d2e

package/dist/{runMir-CWsxri61.d.ts → runMir-D4t7WsN0.d.ts}

@@ -1,4 +1,4 @@
-import { x as MirAudioPayload, w as MirRunRequest, u as MirResult } from './types-D6eBRofe.js';
+import { D as MirAudioPayload, A as MirRunRequest, y as MirResult } from './types-ifqndzu7.js';
 
 /**
  * WebGPU context wrapper for MIR computations.

package/dist/runner/runMir.d.ts

@@ -1,2 +1,2 @@
-export { b as RunMirBackendOptions, R as RunMirOptions, r as runMir } from '../runMir-CWsxri61.js';
-import '../types-D6eBRofe.js';
+export { b as RunMirBackendOptions, R as RunMirOptions, r as runMir } from '../runMir-D4t7WsN0.js';
+import '../types-ifqndzu7.js';

package/dist/runner/runMir.js

@@ -1,3 +1,3 @@
-export { runMir } from '../chunk-OLIDGECY.js';
+export { runMir } from '../chunk-CI7QGWP7.js';
 //# sourceMappingURL=runMir.js.map
 //# sourceMappingURL=runMir.js.map

package/dist/runner/workerProtocol.d.ts

@@ -1,4 +1,4 @@
-import { w as MirRunRequest, u as MirResult, B as BeatCandidate, T as TempoHypothesis, x as MirAudioPayload } from '../types-D6eBRofe.js';
+import { A as MirRunRequest, y as MirResult, B as BeatCandidate, T as TempoHypothesis, D as MirAudioPayload } from '../types-ifqndzu7.js';
 
 type MirWorkerInitMessage = {
     type: "INIT";

package/dist/{types-D6eBRofe.d.ts → types-ifqndzu7.d.ts}

@@ -314,6 +314,8 @@ type FrequencyBand = {
     id: string;
     /** Human-readable label (editable). */
     label: string;
+    /** The audio source this band belongs to ("mixdown" or stem ID). */
+    sourceId: string;
     /** Whether the band is currently active for processing. */
     enabled: boolean;
     /** Time scope for this band. */
@@ -339,7 +341,7 @@ type FrequencyBand = {
  */
 type FrequencyBandStructure = {
     /** Schema version for future migrations. */
-    version: 1;
+    version: 2;
     /** Ordered list of frequency bands (by sortOrder). */
     bands: FrequencyBand[];
     /** ISO timestamp when the structure was created. */
@@ -381,9 +383,17 @@ type FrequencyKeyframe = {
     edge: "start" | "end";
 };
 /**
- * Band MIR function identifiers.
+ * Band MIR function identifiers (STFT-based).
+ */
+type BandMirFunctionId = "bandAmplitudeEnvelope" | "bandOnsetStrength" | "bandSpectralFlux" | "bandSpectralCentroid";
+/**
+ * Band CQT function identifiers (CQT-based).
+ */
+type BandCqtFunctionId = "bandCqtHarmonicEnergy" | "bandCqtBassPitchMotion" | "bandCqtTonalStability";
+/**
+ * Band event function identifiers (derived from 1D signals).
  */
-type BandMirFunctionId = "bandAmplitudeEnvelope" | "bandOnsetStrength" | "bandSpectralFlux";
+type BandEventFunctionId = "bandOnsetPeaks" | "bandBeatCandidates";
 /**
  * Diagnostics for band MIR computation.
  * Provides information about energy retention and potential issues.
@@ -401,7 +411,7 @@ type BandMirDiagnostics = {
     warnings: string[];
 };
 /**
- * Result of a band-scoped MIR computation.
+ * Result of a band-scoped MIR computation (STFT-based).
  */
 type BandMir1DResult = {
     kind: "bandMir1d";
@@ -420,7 +430,75 @@ type BandMir1DResult = {
     /** Diagnostics about energy retention and potential issues. */
     diagnostics: BandMirDiagnostics;
 };
-type MirFunctionId = "spectralCentroid" | "spectralFlux" | "melSpectrogram" | "onsetEnvelope" | "onsetPeaks" | "beatCandidates" | "tempoHypotheses" | "hpssHarmonic" | "hpssPercussive" | "mfcc" | "mfccDelta" | "mfccDeltaDelta" | "cqtHarmonicEnergy" | "cqtBassPitchMotion" | "cqtTonalStability";
+/**
+ * Result of a band-scoped CQT computation.
+ */
+type BandCqt1DResult = {
+    kind: "bandCqt1d";
+    /** ID of the band this result is for. */
+    bandId: string;
+    /** Label of the band (for display). */
+    bandLabel: string;
+    /** The CQT function that produced this result. */
+    fn: BandCqtFunctionId;
+    /** Frame times aligned to CQT timebase. */
+    times: Float32Array;
+    /** Signal values per frame. */
+    values: Float32Array;
+    /** Execution metadata. */
+    meta: MirRunMeta;
+    /** Diagnostics about energy retention and potential issues. */
+    diagnostics: BandMirDiagnostics;
+};
+/**
+ * A band event (onset peak or beat candidate within a band).
+ */
+type BandMirEvent = {
+    /** Time in seconds. */
+    time: number;
+    /** Relative weight/strength (0-1 normalized). */
+    weight: number;
+    /** Optional beat position if beat grid exists. */
+    beatPosition?: number;
+    /** Optional beat phase if beat grid exists. */
+    beatPhase?: number;
+};
+/**
+ * Diagnostics for band event extraction.
+ */
+type BandEventDiagnostics = {
+    /** Total number of events extracted. */
+    eventCount: number;
+    /** Events per second (density). */
+    eventsPerSecond: number;
+    /** Warning messages (e.g., too sparse or too dense). */
+    warnings: string[];
+};
+/**
+ * Result of band event extraction.
+ */
+type BandEventsResult = {
+    kind: "bandEvents";
+    /** ID of the band this result is for. */
+    bandId: string;
+    /** Label of the band (for display). */
+    bandLabel: string;
+    /** The event function that produced this result. */
+    fn: BandEventFunctionId;
+    /** Extracted events. */
+    events: BandMirEvent[];
+    /** Source signal used for extraction (for debugging). */
+    sourceSignal?: {
+        fn: BandMirFunctionId;
+        times: Float32Array;
+        values: Float32Array;
+    };
+    /** Execution metadata. */
+    meta: MirRunMeta;
+    /** Diagnostics about extraction quality. */
+    diagnostics: BandEventDiagnostics;
+};
+type MirFunctionId = "amplitudeEnvelope" | "spectralCentroid" | "spectralFlux" | "melSpectrogram" | "onsetEnvelope" | "onsetPeaks" | "beatCandidates" | "tempoHypotheses" | "hpssHarmonic" | "hpssPercussive" | "mfcc" | "mfccDelta" | "mfccDeltaDelta" | "cqtHarmonicEnergy" | "cqtBassPitchMotion" | "cqtTonalStability";
 type MirRunRequest = {
     fn: MirFunctionId;
     spectrogram?: {
@@ -605,6 +683,8 @@ type BandProposalConfig = {
     minSalience?: number;
     /** Minimum separation in octaves between proposals. Default: 0.5. */
     minSeparationOctaves?: number;
+    /** Minimum band width (Hz). Prevents implausibly narrow proposals. Default: 20. */
+    minBandwidthHz?: number;
     /** Time window for analysis in seconds (0 = full track). Default: 0. */
     analysisWindow?: number;
 };
@@ -617,4 +697,4 @@ type BandProposalResult = {
     meta: MirRunMeta;
 };
 
-export type { TempoHypothesisEvidence as A, BeatCandidate as B, CqtConfig as C, TempoHypothesesResult as D, MusicalTimeProvenance as E, FrequencySegment as F, FrequencyBandTimeScope as G, FrequencyBandProvenance as H, BandMirDiagnostics as I, BandProposalSource as J, BandProposal as K, MusicalTimeSegment as M, PhaseAlignmentConfig as P, TempoHypothesis as T, PhaseHypothesis as a, BeatPosition as b, MusicalTimeStructure as c, BeatGrid as d, FrequencyBand as e, FrequencyBandStructure as f, FrequencyBoundsAtTime as g, FrequencyKeyframe as h, BandMirFunctionId as i, BandMir1DResult as j, CqtSpectrogram as k, MirRunMeta as l, CqtSignalResult as m, CqtSignalId as n, BandProposalConfig as o, BandProposalResult as p, MirBackend as q, MirRunTimings as r, Mir1DResult as s, Mir2DResult as t, MirResult as u, MirFunctionId as v, MirRunRequest as w, MirAudioPayload as x, BeatCandidateSource as y, BeatCandidatesResult as z };
+export type { MirRunRequest as A, BeatCandidate as B, CqtConfig as C, MirAudioPayload as D, BeatCandidateSource as E, FrequencySegment as F, BeatCandidatesResult as G, TempoHypothesisEvidence as H, TempoHypothesesResult as I, MusicalTimeProvenance as J, FrequencyBandTimeScope as K, FrequencyBandProvenance as L, MusicalTimeSegment as M, BandMirDiagnostics as N, BandMirEvent as O, PhaseAlignmentConfig as P, BandEventDiagnostics as Q, BandProposalSource as R, BandProposal as S, TempoHypothesis as T, PhaseHypothesis as a, BeatPosition as b, MusicalTimeStructure as c, BeatGrid as d, FrequencyBand as e, FrequencyBandStructure as f, FrequencyBoundsAtTime as g, FrequencyKeyframe as h, BandMirFunctionId as i, BandMir1DResult as j, BandEventFunctionId as k, BandEventsResult as l, BandCqtFunctionId as m, BandCqt1DResult as n, CqtSpectrogram as o, MirRunMeta as p, CqtSignalResult as q, CqtSignalId as r, BandProposalConfig as s, BandProposalResult as t, MirBackend as u, MirRunTimings as v, Mir1DResult as w, Mir2DResult as x, MirResult as y, MirFunctionId as z };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@octoseq/mir",
-    "version": "0.1.0-main.994cb4e",
+    "version": "0.1.0-main.9ea6d2e",
     "description": "WebGPU-accelerated Music Information Retrieval (MIR) library (skeleton)",
     "license": "MIT",
     "private": false,