@blibliki/transport 0.5.2 → 0.9.0

package/README.md

@@ -2,6 +2,29 @@
 
 > Musical transport and scheduler on top of the WebAudio API.
 
+A precision timing engine for music applications. Converts musical time (bars, beats, ticks) into sample-accurate Web Audio scheduling using a sliding-window scheduler.
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Key Concepts](#key-concepts)
+- [API Overview](#api-overview)
+- [Documentation](#documentation)
+- [Development](#development)
+
+## Features
+
+- **Precision Scheduling** - Sample-accurate event timing via 200ms lookahead scheduler
+- **Musical Time** - 15,360 ticks per beat with support for any time signature
+- **Tempo Control** - Change BPM mid-playback without losing position
+- **Swing** - Built-in swing/shuffle timing (0.5 to 0.75)
+- **Position Management** - Jump to any bar:beat:sixteenth position
+- **UI Callbacks** - Clock and bar callbacks for visual synchronization
+- **TypeScript** - Fully typed with generic event support
+- **Minimal** - Zero dependencies except `@blibliki/utils`
+
 ## Installation
 
 ```sh
@@ -85,41 +108,95 @@ async function main() {
 main();
 ```
 
-Stop the transport with `transport.stop()`, pause with `transport.stop()` (without resetting) and reset the playhead to the beginning with `transport.reset()`.
+## Key Concepts
+
+### Listener Callbacks
+
+The listener object bridges musical intent and actual audio:
+
+- **`generator(startTicks, endTicks)`** - Returns events in the time window (in ticks)
+- **`consumer(event)`** - Schedules audio nodes using `event.contextTime`
+- **`onStart/onStop/onJump/silence`** - Lifecycle hooks
 
-## Listener Responsibilities
+**Important:** Keep your generator idempotent—the transport may call it with overlapping windows.
 
-The listener that you pass into the constructor bridges musical intent and actual audio nodes:
+### Musical Time
 
-- `generator(startTicks, endTicks)` **must** return every event that occurs in the half-open window `[startTicks, endTicks)`. The transport may call this with overlapping windows when rescheduling, so keep your generator idempotent and avoid emitting duplicate events.
-- `consumer(event)` receives the events produced by the generator with `time` (transport clock) and `contextTime` (AudioContext time) populated. This is where you schedule audio nodes, MIDI messages, etc.
-- `onStart(contextTime)` / `onStop(contextTime)` happen just before the transport starts or stops advancing.
-- `onJump(ticks)` is emitted whenever `transport.position` changes abruptly (for example through manual assignment or `reset()`).
-- `silence(contextTime)` is called whenever playback should be made quiet immediately—useful for clearing envelopes on stop/reset.
+- Transport runs at **15,360 ticks per quarter note**
+- Use `Position` helper for conversions: `new Position("2:1:1", [4, 4])`
+- Control via properties: `bpm`, `timeSignature`, `swingAmount`, `position`
 
-## Working with Musical Time
+### UI Callbacks
 
-- The transport runs at `15360` ticks per quarter note. Use the `Position` helper to convert between ticks, strings (`"bars:beats:sixteenths"`), and object notation, as in `new Position("2:1:1", [4, 4]).ticks`.
-- Control tempo via the `bpm` getter/setter. Updating the tempo while playing keeps the current transport position intact.
-- Change the time signature with the `timeSignature` setter. The default is `4/4`.
-- Apply swing by setting `transport.swingAmount` to a value between `0.5` (straight) and `0.75`.
-- Reach the current musical position with the `position` getter. Assigning to `transport.position` jumps the playhead and invokes `onJump`.
+Register callbacks for UI updates:
 
-## UI-Friendly Clocking
+- `transport.addClockCallback()` - Fires every ~20ms
 
-To keep visual components in sync you can register clock callbacks:
+## API Overview
+
+### Transport Control
 
 ```ts
-transport.addClockCallback((clockTime) => {
-  console.log("transport clock is at", clockTime, "seconds of audio time");
-});
+transport.start(); // Start playback
+transport.stop(); // Stop (pause) playback
+transport.reset(); // Reset to position 0
+transport.state; // "playing" | "stopped" | "paused"
+```
 
-transport.addBarCallback((bar) => {
-  // e.g. update the UI playhead when a new bar begins
-});
+### Properties
+
+```ts
+transport.bpm = 120; // Tempo (beats per minute)
+transport.timeSignature = [4, 4]; // Time signature
+transport.swingAmount = 0.6; // Swing (0.5 = none, 0.75 = max)
+transport.position; // Current position (get/set)
 ```
 
-Clock callbacks fire at roughly 16th-note resolution, intended for UI feedback rather than sample-accurate DSP.
+### Position
+
+```ts
+import { Position } from "@blibliki/transport";
+
+const pos = new Position("2:1:3", [4, 4]); // Bar 2, beat 1, sixteenth 3
+console.log(pos.ticks); // Get ticks
+console.log(pos.toString()); // "2:1:3"
+```
+
+### Utilities
+
+```ts
+import { TPB, divisionToTicks } from "@blibliki/transport";
+
+const sixteenthTicks = TPB / 4; // 3840 ticks
+const eighthTicks = divisionToTicks("1/8"); // 7680 ticks
+```
+
+## Documentation
+
+For comprehensive guides and examples:
+
+- **[DOCUMENTATION.md](./DOCUMENTATION.md)** - Complete architecture guide, API reference, and detailed examples
+- **[SCHEDULER_EXAMPLES.md](./SCHEDULER_EXAMPLES.md)** - Advanced scheduler patterns and use cases
+
+### What's Covered
+
+**DOCUMENTATION.md includes:**
+
+- Three time systems (ticks, clock time, context time)
+- Scheduler deep dive with timing diagrams
+- Complete architecture breakdown
+- Position and tempo management
+- Full API reference
+- Troubleshooting guide
+
+**SCHEDULER_EXAMPLES.md includes:**
+
+- Minimal scheduler implementation
+- Visual scheduler simulation
+- Step sequencer patterns
+- Dynamic event generation
+- Multi-track scheduling
+- Advanced patterns (tempo automation, event modification, MIDI recording)
 
 ## Development
 

package/dist/index.d.ts

@@ -49,32 +49,39 @@ type TimelineEvent = {
     time: ClockTime;
 };
 
+interface SourceEvent extends TransportEvent {
+    eventSourceId: string;
+}
+interface IBaseSource<T extends SourceEvent> {
+    id: string;
+    generator: (start: Ticks, end: Ticks) => readonly Readonly<T>[];
+    consumer: (event: Readonly<T>) => void;
+    onStart: (ticks: Ticks) => void;
+    onStop: (ticks: Ticks) => void;
+    onJump: (ticks: Ticks) => void;
+    onSilence: (ticks: Ticks) => void;
+}
+declare abstract class BaseSource<T extends SourceEvent> implements IBaseSource<T> {
+    readonly id: string;
+    protected transport: Transport;
+    protected startedAt?: Ticks;
+    protected stoppedAt?: Ticks;
+    protected lastGeneratedTick?: Ticks;
+    constructor(transport: Transport);
+    abstract generator(start: Ticks, end: Ticks): readonly Readonly<T>[];
+    abstract consumer(event: Readonly<T>): void;
+    onStart(ticks: Ticks): void;
+    onStop(ticks: Ticks): void;
+    onJump(ticks: Ticks): void;
+    onSilence(_ticks: Ticks): void;
+    protected isPlaying(start: Ticks, end: Ticks): boolean;
+    protected shouldGenerate(eventTick: Ticks): boolean;
+}
+
 interface TransportEvent extends TimelineEvent {
     ticks: Ticks;
     contextTime: ContextTime;
 }
-/**
- * Given a (future) transport time window (in ticks), return all events that should
- * occur within the window. This function is responsible for setting the ticks
- * value for the events returned.
- *
- * IMPORTANT: Subsequent calls to this function may have overlapping time windows.
- * Be careful to not return the same event more than once.
- */
-type TransportEventGenerator<T extends TransportEvent> = (start: Ticks, end: Ticks) => readonly Readonly<T>[];
-/**
- * Schedule the specified event with the audio system. The transport class is
- * responsible for setting the `contextTime` of the events.
- */
-type TransportEventConsumer<T extends TransportEvent> = (event: Readonly<T>) => void;
-type TransportListener<T extends TransportEvent> = {
-    generator: TransportEventGenerator<T>;
-    consumer: TransportEventConsumer<T>;
-    onJump: (ticks: Ticks) => void;
-    onStart: (contextTime: ContextTime) => void;
-    onStop: (contextTime: ContextTime) => void;
-    silence: (contextTime: ContextTime) => void;
-};
 /**
  * Transport callback that gets invoked at (roughly) sixteenth note intervals.
  *
@@ -84,16 +91,28 @@ type TransportListener<T extends TransportEvent> = {
  * It is only accurate up to the precision of the event sheduler rate, and may
  * "jump" if the scheduling is struggling to keep up.
  */
-type TransportClockCallback = (time: ClockTime) => void;
+type TransportClockCallback = (time: ClockTime, contextTime: ContextTime, ticks: Ticks) => void;
+/**
+ * Transport properties that can be observed for changes.
+ */
+type TransportProperty = "bpm" | "timeSignature" | "swingAmount";
+/**
+ * Transport callback that gets invoked when a property changes.
+ */
+type TransportPropertyChangeCallback<T = unknown> = (value: T, contextTime: ContextTime) => void;
 declare enum TransportState {
     playing = "playing",
     stopped = "stopped",
     paused = "paused"
 }
+type TransportParams = {
+    onStart: (ticks: ContextTime) => void;
+    onStop: (ticks: ContextTime) => void;
+};
 /**
  * This class converts (music) transport time into audio clock time.
  */
-declare class Transport<T extends TransportEvent> {
+declare class Transport {
     private _initialized;
     private context;
     private clock;
@@ -103,12 +122,18 @@ declare class Transport<T extends TransportEvent> {
     private tempo;
     private clockTime;
     private _swingAmount;
-    private listener;
+    private sourceManager;
     private _clockCallbacks;
-    constructor(context: Readonly<Context>, listener: Readonly<TransportListener<T>>);
+    private _propertyChangeCallbacks;
+    private onStartCallback;
+    private onStopCallback;
+    constructor(context: Readonly<Context>, params: TransportParams);
     addClockCallback(callback: TransportClockCallback): void;
-    addBarCallback(callback: (bar: number) => void): void;
+    addPropertyChangeCallback(property: TransportProperty, callback: TransportPropertyChangeCallback): void;
+    private triggerPropertyChange;
     get time(): number;
+    getContextTimeAtTicks(ticks: Ticks): ContextTime;
+    getTicksAtContextTime(contextTime: ContextTime): Ticks;
     /**
      * Return the (approximate) current Transport time, in ticks.
      */
@@ -121,15 +146,23 @@ declare class Transport<T extends TransportEvent> {
     /**
      * Start the Transport.
      */
-    start(): void;
+    start(actionAt: ContextTime): void;
     /**
      * Stop the Transport.
      */
-    stop(): void;
+    stop(actionAt: ContextTime): void;
     /**
      * Reset the Transport to zero.
      */
-    reset(): void;
+    reset(actionAt: ContextTime): void;
+    /**
+     * Add a source to the transport
+     */
+    addSource<T extends SourceEvent>(source: BaseSource<T>): void;
+    /**
+     * Remove a source from the transport
+     */
+    removeSource(id: string): void;
     get bpm(): BPM;
     set bpm(bpm: BPM);
     get timeSignature(): TimeSignature;
@@ -142,4 +175,95 @@ declare class Transport<T extends TransportEvent> {
     private consumeEvents;
 }
 
-export { type BPM, type ClockTime, type ContextTime, Position, type Seconds, type Ticks, type TimeSignature, Transport, type TransportEvent, TransportState };
+declare const TPB = 15360;
+type Division = "1/64" | "1/48" | "1/32" | "1/24" | "1/16" | "1/12" | "1/8" | "1/6" | "3/16" | "1/4" | "5/16" | "1/3" | "3/8" | "1/2" | "3/4" | "1" | "1.5" | "2" | "3" | "4" | "6" | "8" | "16" | "32" | "infinity";
+declare function divisionToTicks(division: Division): Ticks;
+declare function divisionToFrequency(division: Division, bpm: BPM): number;
+declare function divisionToMilliseconds(division: Division, bpm: BPM): number;
+
+interface StepSequencerSourceEvent extends SourceEvent {
+    stepNo: number;
+    pageNo: number;
+    patternNo: number;
+    step: IStep;
+}
+type IStepNote = {
+    note: string;
+    velocity: number;
+};
+type IStepCC = {
+    cc: number;
+    value: number;
+};
+type IStep = {
+    active: boolean;
+    notes: IStepNote[];
+    ccMessages: IStepCC[];
+    probability: number;
+    microtimeOffset: number;
+    duration: Division;
+};
+type IPage = {
+    name: string;
+    steps: IStep[];
+};
+type IPattern = {
+    name: string;
+    pages: IPage[];
+};
+declare enum Resolution {
+    thirtysecond = "1/32",
+    sixteenth = "1/16",
+    eighth = "1/8",
+    quarter = "1/4"
+}
+declare enum PlaybackMode {
+    loop = "loop",
+    oneShot = "oneShot"
+}
+interface StepSequencerSourceProps {
+    onEvent: (event: StepSequencerSourceEvent) => void;
+    patterns: IPattern[];
+    stepsPerPage: number;
+    resolution: Resolution;
+    playbackMode: PlaybackMode;
+    patternSequence: string;
+    enableSequence: boolean;
+}
+declare class StepSequencerSource extends BaseSource<StepSequencerSourceEvent> {
+    props: StepSequencerSourceProps;
+    private expandedSequence;
+    private pageMapping;
+    constructor(transport: Transport, props: StepSequencerSourceProps);
+    /**
+     * Build a mapping of absolute pages to (patternNo, pageNo) for one full sequence cycle
+     * Example: sequence "2A1B" with A having 2 pages, B having 1 page produces:
+     * [A0, A1, A0, A1, B0]
+     */
+    private buildPageMapping;
+    get stepResolution(): Ticks;
+    onStart(ticks: Ticks): void;
+    extractStepsTicks(start: Ticks, end: Ticks): Ticks[];
+    private getStep;
+    /**
+     * Calculate ticks per page based on step resolution and steps per page
+     */
+    get ticksPerPage(): Ticks;
+    /**
+     * Calculate absolute page number from tick position
+     */
+    private getAbsolutePageFromTicks;
+    /**
+     * Calculate step number within the current page from tick position
+     */
+    private getStepNoInPage;
+    /**
+     * Map absolute page number to actual pattern and page indices
+     * Takes into account sequence mode and playback mode (loop vs oneShot)
+     */
+    private getPatternAndPageFromAbsolutePage;
+    generator(start: Ticks, end: Ticks): readonly Readonly<StepSequencerSourceEvent>[];
+    consumer(event: Readonly<StepSequencerSourceEvent>): void;
+}
+
+export { type BPM, type ClockTime, type ContextTime, type Division, type IPage, type IPattern, type IStep, type IStepCC, type IStepNote, PlaybackMode, Position, Resolution, type Seconds, StepSequencerSource, type StepSequencerSourceEvent, TPB, type Ticks, type TimeSignature, Transport, type TransportEvent, type TransportProperty, type TransportPropertyChangeCallback, TransportState, divisionToFrequency, divisionToMilliseconds, divisionToTicks };

package/dist/index.js

@@ -1,2 +1,2 @@
-var l=class{context;clockTimeAt;contextTimeAt;audioClockOffset;_isRunning=!1;constructor(t,e){this.context=t,this.audioClockOffset=e,this.clockTimeAt={start:0,stop:0},this.contextTimeAt={start:0,stop:0}}get isRunning(){return this._isRunning}time(){if(!this.isRunning)return this.clockTimeAt.stop;let t=this.context.currentTime;return this.clockTimeAt.start+(t-this.contextTimeAt.start)}start(t){this.contextTimeAt.start=t,this.clockTimeAt.start=this.clockTimeAt.stop,this._isRunning=!0}stop(t){this._isRunning=!1,this.clockTimeAt.stop=this.clockTimeAt.start+(t-this.contextTimeAt.start),this.contextTimeAt.stop=t}jumpTo(t){this.clockTimeAt.stop=t}clockTimeToContextTime(t){let e=this.isRunning?"start":"stop";return this.audioClockOffset+this.contextTimeAt[e]+t-this.clockTimeAt[e]}};import{isNumber as M}from"@blibliki/utils";var c=15360,b=n=>60/n/c,S=n=>n/60*c,_=(n,t,e)=>{let i=n.findIndex(s=>e(t,s)<0);return i===-1?n.length:i};function C(n,t,e){return t+n*(e-t)}function g(n,t,e){return(n-t)/(e-t)}function E(n,t){if(t<.5||t>.75)throw new Error("Invalid swing amount");let e=n/7680,i=Math.floor(e),s=e-i,o=0;return s<=.5?o=C(g(s,0,.5),0,t):o=C(g(s,.5,1),t,1),Math.floor((i+o)*7680)}var a=class{_ticks;timeSignature;constructor(t,e){this.timeSignature=e,M(t)?this._ticks=t:typeof t=="string"?this._ticks=this.parseStringPosition(t):this._ticks=this.convertObjectToTicks(t)}get ticks(){return this._ticks}get bars(){return Math.floor(this.totalBeats/this.timeSignature[0])+1}get beats(){return this.totalBeats%this.timeSignature[0]+1}get sixteenths(){return Math.floor(this.beatFraction*4)+1}get totalBeats(){return Math.floor(this._ticks/c)}get beatFraction(){return this._ticks/c-this.totalBeats}toString(){return`${this.bars}:${this.beats}:${this.sixteenths}`}toObject(){return{bars:this.bars,beats:this.beats,sixteenths:this.sixteenths}}parseStringPosition(t){let e=t.split(":"),[i,s,o]=e,r=Number(i),k=Number(s),B=Number(o),P={bars:r,beats:k,sixteenths:B};return this.convertObjectToTicks(P)}convertObjectToTicks(t){let e=(t.bars-1)*this.timeSignature[0]+(t.beats-1),i=t.sixteenths/16;return(e+i)*c}};var u=class{_events=[];get events(){return this._events}add(t){let e=_(this._events,t,(i,s)=>i.time-s.time);this._events.splice(e,0,t)}find(t,e){return this._events.filter(i=>i.time>=t&&i.time<e)}lastEventBefore(t){for(let e=this._events.length-1;e>=0;e--){let i=this._events[e];if(i&&i.time<=t)return i}}remove(t,e){this._events=this._events.filter(i=>!(i.time>=t&&i.time<e))}removeAllBefore(t){this._events=this._events.filter(e=>e.time>=t)}clear(){this._events=[]}};var T=class{timeline=new u;scheduleAheadTime;consumedTime;generator;consumer;constructor(t,e,i){this.generator=t,this.consumer=e,this.scheduleAheadTime=i,this.consumedTime=-this.scheduleAheadTime}_schedule(t,e){this.generator(t,e).forEach(i=>{this.timeline.add(i)})}runUntil(t){if(t<=this.consumedTime)throw new Error("Scheduling time is <= current time");this._schedule(this.consumedTime+this.scheduleAheadTime,t+this.scheduleAheadTime);let e=this.timeline.find(this.consumedTime,t);this.consumer(e),this.consumedTime=t,this.timeline.removeAllBefore(this.consumedTime)}jumpTo(t){this.timeline.clear(),this.consumedTime=t-this.scheduleAheadTime}};var h=class{clockTimeAtLastTempoChange=0;ticksAtLastTempoChange=0;_bpm=120;get bpm(){return this._bpm}update(t,e){let i=this.getTicks(t);this.clockTimeAtLastTempoChange=t,this.ticksAtLastTempoChange=i,this._bpm=e}getTicks(t){let i=(t-this.clockTimeAtLastTempoChange)*S(this.bpm);return Math.floor(this.ticksAtLastTempoChange+i)}getClockTime(t){let i=Math.floor(t-this.ticksAtLastTempoChange)*b(this.bpm);return this.clockTimeAtLastTempoChange+i}reset(t,e){this.clockTimeAtLastTempoChange=t,this.ticksAtLastTempoChange=e}};import{AudioContext as N,AudioBuffer as D,AudioBufferSourceNode as L}from"@blibliki/utils/web-audio-api";function O(n){let t=1;for(;n.has(t);)t++;return t}var f=class{_audioBuffer=null;_audioContext=null;_sampleDuration=null;get audioContext(){return this._audioContext??=new N,this._audioContext}get audioBuffer(){return this._audioBuffer??=new D({length:2,sampleRate:this.audioContext.sampleRate}),this._audioBuffer}get sampleDuration(){return this._sampleDuration??=2/this.audioContext.sampleRate,this._sampleDuration}},m=new f,A=new Map,p=new Map;var U=(n,t)=>{let e=t==="interval"?p:A;if(e.has(n)){let i=e.get(n);i!==void 0&&(i(),t==="timeout"&&A.delete(n))}},v=(n,t,e)=>{let i=performance.now(),s=new L(m.audioContext,{buffer:m.audioBuffer});s.onended=()=>{let o=performance.now()-i;o>=t?U(n,e):v(n,t-o,e),s.disconnect(m.audioContext.destination)},s.connect(m.audioContext.destination),s.start(Math.max(0,m.audioContext.currentTime+t/1e3-m.sampleDuration))},y=typeof window>"u",j=n=>{p.delete(n)};var z=(n,t)=>{let e=O(p);return p.set(e,()=>{n(),v(e,t,"interval")}),v(e,t,"interval"),e};var R=y?clearInterval:j;var w=y?setInterval:z;var d=class{timerId=void 0;interval;callback;constructor(t,e){this.callback=t,this.interval=e}start(){this.timerId=w(()=>{this.callback()},this.interval)}stop(){this.timerId!==void 0&&(R(this.timerId),this.timerId=void 0)}get isRunning(){return this.timerId!==void 0}};var I=(i=>(i.playing="playing",i.stopped="stopped",i.paused="paused",i))(I||{}),x=class{_initialized=!1;context;clock;timer;scheduler;_timeSignature=[4,4];tempo=new h;clockTime=0;_swingAmount=.5;listener;_clockCallbacks=[];constructor(t,e){this.context=t,this.listener=e,this.clock=new l(this.context,200/1e3),this.scheduler=new T(this.generateEvents,this.consumeEvents,200/1e3),this.timer=new d(()=>{let o=this.clock.time();o<=this.clockTime||(this.clockTime=o,this.scheduler.runUntil(o),this._clockCallbacks.forEach(r=>{r(this.clockTime)}))},20/1e3),this._initialized=!0}addClockCallback(t){this._clockCallbacks.push(t)}addBarCallback(t){let e=1/0;this.addClockCallback(()=>{let i=this.position;i.bars!==e&&(t(i.bars),e=i.bars)})}get time(){return this.clock.time()}get position(){let t=this.clock.time(),e=this.tempo.getTicks(t);return new a(e,this.timeSignature)}set position(t){this.jumpTo(t.ticks)}getPositionOfEvent(t){return new a(t.ticks,this.timeSignature)}start(){if(!this._initialized)throw new Error("Not initialized");if(this.clock.isRunning)return;let t=this.context.currentTime;this.listener.onStart(t),this.clock.start(t),this.timer.start()}stop(){if(!this._initialized)throw new Error("Not initialized");let t=this.context.currentTime;this.listener.silence(t),this.listener.onStop(t),this.clock.stop(t),this.timer.stop()}reset(){if(!this._initialized)throw new Error("Not initialized");let t=this.context.currentTime;this.listener.silence(t),this.jumpTo(0)}get bpm(){return this.tempo.bpm}set bpm(t){this.tempo.update(this.clockTime,t)}get timeSignature(){return this._timeSignature}set timeSignature(t){this._timeSignature=t}get state(){return this.clock.isRunning?"playing":this.time>0?"paused":"stopped"}get swingAmount(){return this._swingAmount}set swingAmount(t){this._swingAmount=t}jumpTo(t){let e=this.tempo.getClockTime(t);this.tempo.reset(e,t),this.clock.jumpTo(e),this.scheduler.jumpTo(e),this.clockTime=e,this.listener.onJump(t),this._clockCallbacks.forEach(i=>{i(this.clockTime)})}generateEvents=(t,e)=>{let i=this.tempo.getTicks(t),s=this.tempo.getTicks(e);return this.listener.generator(i,s).map(o=>({...o,ticks:E(o.ticks,this.swingAmount)})).map(o=>{let r=this.tempo.getClockTime(o.ticks),k=this.clock.clockTimeToContextTime(r);return{...o,time:r,contextTime:k}})};consumeEvents=t=>{t.forEach(e=>{this.listener.consumer(e)})}};export{a as Position,x as Transport,I as TransportState};
+var l=class{context;clockTimeAt;contextTimeAt;audioClockOffset;_isRunning=!1;constructor(t,e){this.context=t,this.audioClockOffset=e,this.clockTimeAt={start:0,stop:0},this.contextTimeAt={start:0,stop:0}}get isRunning(){return this._isRunning}time(){if(!this.isRunning)return this.clockTimeAt.stop;let t=this.context.currentTime;return this.clockTimeAt.start+(t-this.contextTimeAt.start)}start(t){return this.contextTimeAt.start=t,this.clockTimeAt.start=this.clockTimeAt.stop,this._isRunning=!0,this.clockTimeAt.start}stop(t){return this._isRunning=!1,this.clockTimeAt.stop=this.clockTimeAt.start+(t-this.contextTimeAt.start),this.contextTimeAt.stop=t,this.clockTimeAt.stop}jumpTo(t){this.clockTimeAt.stop=t}clockTimeToContextTime(t){let e=this.isRunning?"start":"stop";return this.audioClockOffset+this.contextTimeAt[e]+t-this.clockTimeAt[e]}contextTimeToClockTime(t){let e=this.isRunning?"start":"stop";return t-this.audioClockOffset-this.contextTimeAt[e]+this.clockTimeAt[e]}};import{isNumber as j}from"@blibliki/utils";var s=15360,_=n=>60/n/s,I=n=>n/60*s,M=(n,t,e)=>{let i=n.findIndex(o=>e(t,o)<0);return i===-1?n.length:i};function E(n,t,e){return t+n*(e-t)}function A(n,t,e){return(n-t)/(e-t)}function N(n,t){if(t<.5||t>.75)throw new Error("Invalid swing amount");let e=n/7680,i=Math.floor(e),o=e-i,r=0;return o<=.5?r=E(A(o,0,.5),0,t):r=E(A(o,.5,1),t,1),Math.floor((i+r)*7680)}function x(n){typeof n!="string"&&(console.error('Invalid duration value, using default "8n."'),n="1/8");let t;if(n==="infinity")return 1/0;if(n.match(/\d\/\d/)){let[e,i]=n.split("/").map(Number);if(!e||!i)throw Error(`Note duration parsing error for value: ${n}`);t=s*e/(i/4)}else t=s*Number(n)*4;return Math.round(t)}function U(n,t){return 1/(x(n)/s*(60/t))}function F(n,t){return x(n)/s*(60/t)*1e3}var u=class{_ticks;timeSignature;constructor(t,e){this.timeSignature=e,j(t)?this._ticks=t:typeof t=="string"?this._ticks=this.parseStringPosition(t):this._ticks=this.convertObjectToTicks(t)}get ticks(){return this._ticks}get bars(){return Math.floor(this.totalBeats/this.timeSignature[0])+1}get beats(){return this.totalBeats%this.timeSignature[0]+1}get sixteenths(){return Math.floor(this.beatFraction*4)+1}get totalBeats(){return Math.floor(this._ticks/s)}get beatFraction(){return this._ticks/s-this.totalBeats}toString(){return`${this.bars}:${this.beats}:${this.sixteenths}`}toObject(){return{bars:this.bars,beats:this.beats,sixteenths:this.sixteenths}}parseStringPosition(t){let e=t.split(":"),[i,o,r]=e,c=Number(i),a=Number(o),p=Number(r),v={bars:c,beats:a,sixteenths:p};return this.convertObjectToTicks(v)}convertObjectToTicks(t){let e=(t.bars-1)*this.timeSignature[0]+(t.beats-1),i=t.sixteenths/16;return(e+i)*s}};var h=class{_events=[];get events(){return this._events}add(t){let e=M(this._events,t,(i,o)=>i.time-o.time);this._events.splice(e,0,t)}find(t,e){return this._events.filter(i=>i.time>=t&&i.time<e)}lastEventBefore(t){for(let e=this._events.length-1;e>=0;e--){let i=this._events[e];if(i&&i.time<=t)return i}}remove(t,e){this._events=this._events.filter(i=>!(i.time>=t&&i.time<e))}removeAllBefore(t){this._events=this._events.filter(e=>e.time>=t)}clear(){this._events=[]}};var T=class{timeline=new h;scheduleAheadTime;consumedTime;generator;consumer;constructor(t,e,i){this.generator=t,this.consumer=e,this.scheduleAheadTime=i,this.consumedTime=-this.scheduleAheadTime}_schedule(t,e){this.generator(t,e).forEach(i=>{this.timeline.add(i)})}runUntil(t){if(t<=this.consumedTime)throw new Error("Scheduling time is <= current time");this._schedule(this.consumedTime+this.scheduleAheadTime,t+this.scheduleAheadTime);let e=this.timeline.find(this.consumedTime,t);this.consumer(e),this.consumedTime=t,this.timeline.removeAllBefore(this.consumedTime)}jumpTo(t){this.timeline.clear(),this.consumedTime=t-this.scheduleAheadTime}};var d=class{clockTimeAtLastTempoChange=0;ticksAtLastTempoChange=0;_bpm=120;get bpm(){return this._bpm}update(t,e){let i=this.getTicks(t);this.clockTimeAtLastTempoChange=t,this.ticksAtLastTempoChange=i,this._bpm=e}getTicks(t){let i=(t-this.clockTimeAtLastTempoChange)*I(this.bpm);return Math.floor(this.ticksAtLastTempoChange+i)}getClockTime(t){let i=Math.floor(t-this.ticksAtLastTempoChange)*_(this.bpm);return this.clockTimeAtLastTempoChange+i}reset(t,e){this.clockTimeAtLastTempoChange=t,this.ticksAtLastTempoChange=e}};import{AudioContext as G,AudioBuffer as z,AudioBufferSourceNode as H}from"@blibliki/utils/web-audio-api";function J(n){let t=1;for(;n.has(t);)t++;return t}var C=class{_audioBuffer=null;_audioContext=null;_sampleDuration=null;get audioContext(){return this._audioContext??=new G,this._audioContext}get audioBuffer(){return this._audioBuffer??=new z({length:2,sampleRate:this.audioContext.sampleRate}),this._audioBuffer}get sampleDuration(){return this._sampleDuration??=2/this.audioContext.sampleRate,this._sampleDuration}},m=new C,R=new Map,k=new Map;var V=(n,t)=>{let e=t==="interval"?k:R;if(e.has(n)){let i=e.get(n);i!==void 0&&(i(),t==="timeout"&&R.delete(n))}},b=(n,t,e)=>{let i=performance.now(),o=new H(m.audioContext,{buffer:m.audioBuffer});o.onended=()=>{let r=performance.now()-i;r>=t?V(n,e):b(n,t-r,e),o.disconnect(m.audioContext.destination)},o.connect(m.audioContext.destination),o.start(Math.max(0,m.audioContext.currentTime+t/1e3-m.sampleDuration))},w=typeof window>"u",W=n=>{k.delete(n)};var $=(n,t)=>{let e=J(k);return k.set(e,()=>{n(),b(e,t,"interval")}),b(e,t,"interval"),e};var B=w?clearInterval:W;var D=w?setInterval:$;var g=class{timerId=void 0;interval;callback;constructor(t,e){this.callback=t,this.interval=e}start(){this.timerId=D(()=>{this.callback()},this.interval)}stop(){this.timerId!==void 0&&(B(this.timerId),this.timerId=void 0)}get isRunning(){return this.timerId!==void 0}};var S=class{activeSources=new Map;addSource(t){this.activeSources.set(t.id,t)}removeSource(t){this.activeSources.delete(t)}generator(t,e){let i=[];return this.activeSources.forEach(o=>{i.push(...o.generator(t,e))}),i}consumer(t){t.forEach(e=>{this.activeSources.get(e.eventSourceId)?.consumer(e)})}onStart(t){this.activeSources.forEach(e=>{e.onStart(t)})}onStop(t){this.activeSources.forEach(e=>{e.onStop(t)})}onJump(t){this.activeSources.forEach(e=>{e.onJump(t)})}onSilence(t){this.activeSources.forEach(e=>{e.onSilence(t)})}};var q=(i=>(i.playing="playing",i.stopped="stopped",i.paused="paused",i))(q||{}),P=class{_initialized=!1;context;clock;timer;scheduler;_timeSignature=[4,4];tempo=new d;clockTime=0;_swingAmount=.5;sourceManager;_clockCallbacks=[];_propertyChangeCallbacks=new Map;onStartCallback;onStopCallback;constructor(t,e){this.context=t,this.sourceManager=new S,this.clock=new l(this.context,100/1e3),this.onStartCallback=e.onStart,this.onStopCallback=e.onStop,this.scheduler=new T(this.generateEvents,this.consumeEvents,100/1e3),this.timer=new g(()=>{let r=this.clock.time(),c=this.clock.clockTimeToContextTime(r),a=this.tempo.getTicks(r);r<=this.clockTime||(this.clockTime=r,this.scheduler.runUntil(r),this._clockCallbacks.forEach(p=>{p(this.clockTime,c,a)}))},20/1e3),this._initialized=!0}addClockCallback(t){this._clockCallbacks.push(t)}addPropertyChangeCallback(t,e){this._propertyChangeCallbacks.has(t)||this._propertyChangeCallbacks.set(t,[]),this._propertyChangeCallbacks.get(t).push(e)}triggerPropertyChange(t,e){let i=this._propertyChangeCallbacks.get(t);if(i){let o=this.context.currentTime;i.forEach(r=>{r(e,o)})}}get time(){return this.clock.time()}getContextTimeAtTicks(t){let e=this.tempo.getClockTime(t);return this.clock.clockTimeToContextTime(e)}getTicksAtContextTime(t){let e=this.clock.contextTimeToClockTime(t);return this.tempo.getTicks(e)}get position(){let t=this.clock.time(),e=this.tempo.getTicks(t);return new u(e,this.timeSignature)}set position(t){this.jumpTo(t.ticks)}getPositionOfEvent(t){return new u(t.ticks,this.timeSignature)}start(t){if(!this._initialized)throw new Error("Not initialized");if(this.clock.isRunning)return;let e=this.clock.start(t);this.timer.start();let i=this.tempo.getTicks(e);this.sourceManager.onStart(i),this.onStartCallback(i)}stop(t){if(!this._initialized)throw new Error("Not initialized");let e=this.clock.stop(t);this.timer.stop();let i=this.tempo.getTicks(e);this.sourceManager.onSilence(i),this.sourceManager.onStop(i),this.onStopCallback(i)}reset(t){if(!this._initialized)throw new Error("Not initialized");this.sourceManager.onSilence(t),this.jumpTo(0)}addSource(t){this.sourceManager.addSource(t)}removeSource(t){this.sourceManager.removeSource(t)}get bpm(){return this.tempo.bpm}set bpm(t){let e=this.tempo.bpm;this.tempo.update(this.clockTime,t),e!==t&&this.triggerPropertyChange("bpm",t)}get timeSignature(){return this._timeSignature}set timeSignature(t){let e=this._timeSignature;this._timeSignature=t,(e[0]!==t[0]||e[1]!==t[1])&&this.triggerPropertyChange("timeSignature",t)}get state(){return this.clock.isRunning?"playing":this.time>0?"paused":"stopped"}get swingAmount(){return this._swingAmount}set swingAmount(t){let e=this._swingAmount;this._swingAmount=t,e!==t&&this.triggerPropertyChange("swingAmount",t)}jumpTo(t){let e=this.tempo.getClockTime(t);this.tempo.reset(e,t),this.clock.jumpTo(e),this.scheduler.jumpTo(e),this.clockTime=e,this.sourceManager.onJump(t);let i=this.clock.clockTimeToContextTime(this.clockTime);this._clockCallbacks.forEach(o=>{o(this.clockTime,i,t)})}generateEvents=(t,e)=>{let i=this.tempo.getTicks(t),o=this.tempo.getTicks(e);return this.sourceManager.generator(i,o).map(r=>({...r,ticks:N(r.ticks,this.swingAmount)})).map(r=>{let c=this.tempo.getClockTime(r.ticks),a=this.clock.clockTimeToContextTime(c);return{...r,time:c,contextTime:a}})};consumeEvents=t=>{this.sourceManager.consumer(t)}};import{uuidv4 as Z}from"@blibliki/utils";var f=class{id;transport;startedAt;stoppedAt;lastGeneratedTick;constructor(t){this.id=Z(),this.transport=t}onStart(t){this.startedAt=t,this.stoppedAt=void 0,this.lastGeneratedTick=void 0}onStop(t){this.stoppedAt=t}onJump(t){this.lastGeneratedTick=t}onSilence(t){}isPlaying(t,e){return this.startedAt!==void 0&&this.startedAt<=t?this.stoppedAt===void 0||this.stoppedAt>=e:!1}shouldGenerate(t){return this.lastGeneratedTick===void 0?!0:t>this.lastGeneratedTick}};var L=(o=>(o.thirtysecond="1/32",o.sixteenth="1/16",o.eighth="1/8",o.quarter="1/4",o))(L||{}),O=(e=>(e.loop="loop",e.oneShot="oneShot",e))(O||{}),K={"1/32":s/8,"1/16":s/4,"1/8":s/2,"1/4":s};function Q(n){let t=[],e="";for(let i of n)if(i>="0"&&i<="9")e+=i;else{let o=Number(e);for(let r=0;r<o;r++)t.push(i);e=""}return t.map(i=>i.toUpperCase())}var y=class extends f{props;expandedSequence=[];pageMapping=[];constructor(t,e){super(t),this.props=e,this.expandedSequence=Q(e.patternSequence),this.pageMapping=this.buildPageMapping()}buildPageMapping(){let t=[];if(this.props.enableSequence&&this.expandedSequence.length>0)for(let e of this.expandedSequence){let i=this.props.patterns.findIndex(r=>r.name.toUpperCase()===e);if(i===-1)continue;let o=this.props.patterns[i];if(o)for(let r=0;r<o.pages.length;r++)t.push({patternNo:i,pageNo:r})}else for(let e=0;e<this.props.patterns.length;e++){let i=this.props.patterns[e];if(i)for(let o=0;o<i.pages.length;o++)t.push({patternNo:e,pageNo:o})}return t}get stepResolution(){return K[this.props.resolution]}onStart(t){let e=this.transport.timeSignature,i=s*e[0];if(t%i===0){super.onStart(t);return}let r=(Math.floor(t/i)+1)*i;super.onStart(r)}extractStepsTicks(t,e){let i=[],o=this.stepResolution,r=Math.floor((t-this.startedAt)/o),c=this.startedAt+r*o;for(let a=c;a<=e;a+=o)this.shouldGenerate(a)&&(i.push(a),this.lastGeneratedTick=a);return i}getStep(t,e,i){let o=this.props.patterns[t];if(!o)throw Error("Pattern not found");let r=o.pages[e];if(!r)throw Error("Page not found");let c=r.steps[i];if(!c)throw Error("Step not found");return c}get ticksPerPage(){return this.stepResolution*this.props.stepsPerPage}getAbsolutePageFromTicks(t){if(this.startedAt===void 0)return 0;let e=t-this.startedAt;return Math.floor(e/this.ticksPerPage)}getStepNoInPage(t){if(this.startedAt===void 0)return 0;let i=(t-this.startedAt)%this.ticksPerPage;return Math.floor(i/this.stepResolution)}getPatternAndPageFromAbsolutePage(t){if(this.pageMapping.length===0)return{patternNo:0,pageNo:0};let e;return this.props.playbackMode==="loop"?e=t%this.pageMapping.length:e=Math.min(t,this.pageMapping.length-1),this.pageMapping[e]??{patternNo:0,pageNo:0}}generator(t,e){if(!this.isPlaying(t,e)||this.startedAt===void 0)return[];let i=this.extractStepsTicks(t,e);if(this.props.playbackMode==="oneShot"&&i.length>0){let o=i[i.length-1];if(o!==void 0){let r=this.getAbsolutePageFromTicks(o),c=this.getStepNoInPage(o);r>=this.pageMapping.length-1&&c>=this.props.stepsPerPage-1&&this.onStop(o+this.stepResolution)}}return i.map(o=>{let r=this.getAbsolutePageFromTicks(o),{patternNo:c,pageNo:a}=this.getPatternAndPageFromAbsolutePage(r),p=this.getStepNoInPage(o),v=this.getStep(c,a,p);return{ticks:o,time:0,contextTime:0,eventSourceId:this.id,stepNo:p,pageNo:a,patternNo:c,step:v}})}consumer(t){this.props.onEvent(t)}};export{O as PlaybackMode,u as Position,L as Resolution,y as StepSequencerSource,s as TPB,P as Transport,q as TransportState,U as divisionToFrequency,F as divisionToMilliseconds,x as divisionToTicks};
 //# sourceMappingURL=index.js.map