reaper-osc 0.2.0 → 0.3.0

package/dist/Messages.js

@@ -1,116 +1,116 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FloatMessage = exports.IntegerMessage = exports.ToggleMessage = exports.ActionMessage = exports.BooleanMessage = exports.StringMessage = exports.OscMessage = exports.FloatArgument = exports.BoolArgument = exports.IntArgument = exports.StringArgument = exports.OscArgument = exports.OscArgumentType = void 0;
-var OscArgumentType;
-(function (OscArgumentType) {
-    /** 32-bit Integer */
-    OscArgumentType["INT"] = "i";
-    /** 64-bit Integer */
-    OscArgumentType["LONG"] = "h";
-    /** 32-bit Floating Point */
-    OscArgumentType["FLOAT"] = "f";
-    /** 64-bit Floating Point */
-    OscArgumentType["DOUBLE"] = "d";
-    /** String */
-    OscArgumentType["STRING"] = "s";
-    /** Single Character */
-    OscArgumentType["CHAR"] = "c";
-    /** Binary blob */
-    OscArgumentType["BLOB"] = "b";
-    /** True. No bytes are allocated in the argument data */
-    OscArgumentType["TRUE"] = "T";
-    /** False. No bytes are allocated in the argument data */
-    OscArgumentType["FALSE"] = "F";
-    /** Null. No bytes are allocated in the argument data */
-    OscArgumentType["NULL"] = "N";
-    /** Impulse aka bang. Used for event triggers. No bytes are allocated in the argument data */
-    OscArgumentType["IMPULSE"] = "I";
-    OscArgumentType["COLOR"] = "r";
-    OscArgumentType["MIDI"] = "m";
-})(OscArgumentType = exports.OscArgumentType || (exports.OscArgumentType = {}));
-class OscArgument {
-    constructor(type, value) {
-        this.type = type;
-        this.value = value;
-    }
-}
-exports.OscArgument = OscArgument;
-class StringArgument extends OscArgument {
-    constructor(value) {
-        super(OscArgumentType.STRING, value);
-    }
-}
-exports.StringArgument = StringArgument;
-class IntArgument extends OscArgument {
-    constructor(value) {
-        super(OscArgumentType.INT, value);
-    }
-}
-exports.IntArgument = IntArgument;
-class BoolArgument extends IntArgument {
-    constructor(value) {
-        super(value ? 1 : 0);
-    }
-}
-exports.BoolArgument = BoolArgument;
-class FloatArgument extends OscArgument {
-    constructor(value) {
-        super(OscArgumentType.FLOAT, value);
-    }
-}
-exports.FloatArgument = FloatArgument;
-class OscMessage {
-    constructor(address, args) {
-        this.address = address;
-        this.args = args !== null && args !== void 0 ? args : [];
-        this.addressParts = address.split('/');
-    }
-}
-exports.OscMessage = OscMessage;
-class StringMessage extends OscMessage {
-    constructor(address, value) {
-        super(address, [new StringArgument(value)]);
-    }
-}
-exports.StringMessage = StringMessage;
-class BooleanMessage extends OscMessage {
-    constructor(address, value) {
-        const args = [new BoolArgument(value)];
-        super(address, args);
-    }
-}
-exports.BooleanMessage = BooleanMessage;
-class ActionMessage extends OscMessage {
-    constructor(commandId, value = null) {
-        if (typeof commandId === 'number') {
-            commandId = commandId.toString();
-        }
-        const args = [new StringArgument(commandId)];
-        if (value !== null) {
-            args.push(new FloatArgument(value));
-        }
-        super('/action/str', args);
-    }
-}
-exports.ActionMessage = ActionMessage;
-class ToggleMessage extends OscMessage {
-    constructor(address) {
-        super(address + '/toggle');
-    }
-}
-exports.ToggleMessage = ToggleMessage;
-class IntegerMessage extends OscMessage {
-    constructor(address, value) {
-        const args = [new IntArgument(value)];
-        super(address, args);
-    }
-}
-exports.IntegerMessage = IntegerMessage;
-class FloatMessage extends OscMessage {
-    constructor(address, value) {
-        const args = [new FloatArgument(value)];
-        super(address, args);
-    }
-}
-exports.FloatMessage = FloatMessage;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FloatMessage = exports.IntegerMessage = exports.ToggleMessage = exports.ActionMessage = exports.BooleanMessage = exports.StringMessage = exports.OscMessage = exports.FloatArgument = exports.BoolArgument = exports.IntArgument = exports.StringArgument = exports.OscArgument = exports.OscArgumentType = void 0;
+var OscArgumentType;
+(function (OscArgumentType) {
+    /** 32-bit Integer */
+    OscArgumentType["INT"] = "i";
+    /** 64-bit Integer */
+    OscArgumentType["LONG"] = "h";
+    /** 32-bit Floating Point */
+    OscArgumentType["FLOAT"] = "f";
+    /** 64-bit Floating Point */
+    OscArgumentType["DOUBLE"] = "d";
+    /** String */
+    OscArgumentType["STRING"] = "s";
+    /** Single Character */
+    OscArgumentType["CHAR"] = "c";
+    /** Binary blob */
+    OscArgumentType["BLOB"] = "b";
+    /** True. No bytes are allocated in the argument data */
+    OscArgumentType["TRUE"] = "T";
+    /** False. No bytes are allocated in the argument data */
+    OscArgumentType["FALSE"] = "F";
+    /** Null. No bytes are allocated in the argument data */
+    OscArgumentType["NULL"] = "N";
+    /** Impulse aka bang. Used for event triggers. No bytes are allocated in the argument data */
+    OscArgumentType["IMPULSE"] = "I";
+    OscArgumentType["COLOR"] = "r";
+    OscArgumentType["MIDI"] = "m";
+})(OscArgumentType = exports.OscArgumentType || (exports.OscArgumentType = {}));
+class OscArgument {
+    constructor(type, value) {
+        this.type = type;
+        this.value = value;
+    }
+}
+exports.OscArgument = OscArgument;
+class StringArgument extends OscArgument {
+    constructor(value) {
+        super(OscArgumentType.STRING, value);
+    }
+}
+exports.StringArgument = StringArgument;
+class IntArgument extends OscArgument {
+    constructor(value) {
+        super(OscArgumentType.INT, value);
+    }
+}
+exports.IntArgument = IntArgument;
+class BoolArgument extends IntArgument {
+    constructor(value) {
+        super(value ? 1 : 0);
+    }
+}
+exports.BoolArgument = BoolArgument;
+class FloatArgument extends OscArgument {
+    constructor(value) {
+        super(OscArgumentType.FLOAT, value);
+    }
+}
+exports.FloatArgument = FloatArgument;
+class OscMessage {
+    constructor(address, args) {
+        this.address = address;
+        this.args = args !== null && args !== void 0 ? args : [];
+        this.addressParts = address.split('/');
+    }
+}
+exports.OscMessage = OscMessage;
+class StringMessage extends OscMessage {
+    constructor(address, value) {
+        super(address, [new StringArgument(value)]);
+    }
+}
+exports.StringMessage = StringMessage;
+class BooleanMessage extends OscMessage {
+    constructor(address, value) {
+        const args = [new BoolArgument(value)];
+        super(address, args);
+    }
+}
+exports.BooleanMessage = BooleanMessage;
+class ActionMessage extends OscMessage {
+    constructor(commandId, value = null) {
+        if (typeof commandId === 'number') {
+            commandId = commandId.toString();
+        }
+        const args = [new StringArgument(commandId)];
+        if (value !== null) {
+            args.push(new FloatArgument(value));
+        }
+        super('/action/str', args);
+    }
+}
+exports.ActionMessage = ActionMessage;
+class ToggleMessage extends OscMessage {
+    constructor(address) {
+        super(address + '/toggle');
+    }
+}
+exports.ToggleMessage = ToggleMessage;
+class IntegerMessage extends OscMessage {
+    constructor(address, value) {
+        const args = [new IntArgument(value)];
+        super(address, args);
+    }
+}
+exports.IntegerMessage = IntegerMessage;
+class FloatMessage extends OscMessage {
+    constructor(address, value) {
+        const args = [new FloatArgument(value)];
+        super(address, args);
+    }
+}
+exports.FloatMessage = FloatMessage;
 //# sourceMappingURL=Messages.js.map

package/dist/Notify.d.ts

@@ -1,28 +1,29 @@
-/** Allows a subscriber to be notified of changes to the object's properties */
-export interface INotifyPropertyChanged {
-    /**
-     * An event that can be subscribed to for property change notifications
-     * @param property The name of the property to subscribe to
-     * @param callback A callback to be called when the state of the specified property changes
-     */
-    onPropertyChanged(property: string, callback: () => void): void;
-}
-/**
- * Changes to the property will cause an event containing the name of the property to be fired by {@link INotifyPropertyChanged.onPropertyChanged}.
- * Initializing the property will trigger the event.
- *
- * @remarks
- * Requires {@link notifyOnPropertyChanged} decorator on the class
- *
- * @param overrideName Use to specify a different property name in the event. Useful for notifying changes to a get-only property from a change to a private backing file
- */
-export declare function notify<T>(overrideName?: keyof T): (target: Object, propertyKey: string) => void;
-/**
- * Adds an implementation of {@link INotifyPropertyChanged.onPropertyChanged} to the class.
- *
- * @remarks
- * Use in conjunction with {@link INotifyPropertyChanged} and decorating properties with {@link notify}
- */
-export declare function notifyOnPropertyChanged<T extends {
-    new (...args: any[]): {};
-}>(constructor: T): T;
+/** Allows a subscriber to be notified of changes to the object's properties */
+export interface INotifyPropertyChanged {
+    /**
+     * An event that can be subscribed to for property change notifications
+     * @param property The name of the property to subscribe to
+     * @param callback A callback to be called when the state of the specified property changes
+     * @returns A function that unsubscribes the event handler
+     */
+    onPropertyChanged(property: string, callback: () => void): () => void;
+}
+/**
+ * Changes to the property will cause an event containing the name of the property to be fired by {@link INotifyPropertyChanged.onPropertyChanged}.
+ * Initializing the property will trigger the event.
+ *
+ * @remarks
+ * Requires {@link notifyOnPropertyChanged} decorator on the class
+ *
+ * @param overrideName Use to specify a different property name in the event. Useful for notifying changes to a get-only property from a change to a private backing file
+ */
+export declare function notify<T>(overrideName?: keyof T): (target: Object, propertyKey: string) => void;
+/**
+ * Adds an implementation of {@link INotifyPropertyChanged.onPropertyChanged} to the class.
+ *
+ * @remarks
+ * Use in conjunction with {@link INotifyPropertyChanged} and decorating properties with {@link notify}
+ */
+export declare function notifyOnPropertyChanged<T extends {
+    new (...args: any[]): {};
+}>(constructor: T): T;

package/dist/Notify.js

@@ -1,64 +1,64 @@
-"use strict";
-/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
-/* eslint-disable @typescript-eslint/ban-types */
-/* eslint-disable @typescript-eslint/no-explicit-any */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.notifyOnPropertyChanged = exports.notify = void 0;
-const ste_simple_events_1 = require("ste-simple-events");
-/**
- * Changes to the property will cause an event containing the name of the property to be fired by {@link INotifyPropertyChanged.onPropertyChanged}.
- * Initializing the property will trigger the event.
- *
- * @remarks
- * Requires {@link notifyOnPropertyChanged} decorator on the class
- *
- * @param overrideName Use to specify a different property name in the event. Useful for notifying changes to a get-only property from a change to a private backing file
- */
-function notify(overrideName) {
-    return (target, propertyKey) => {
-        // Create a new prop to hold the value
-        const valueKey = `_${propertyKey}Notify`;
-        // Replace the decorated prop with getter/setter that handles the notifications
-        Object.defineProperty(target, propertyKey, {
-            set(value) {
-                const oldValue = this[propertyKey];
-                if (value === oldValue) {
-                    return;
-                }
-                this[valueKey] = value;
-                if (this._propertyChanged === undefined) {
-                    return;
-                }
-                const propertyName = overrideName ? overrideName : propertyKey;
-                this._propertyChanged.dispatch(propertyName);
-            },
-            get() {
-                return this[valueKey];
-            },
-        });
-    };
-}
-exports.notify = notify;
-/**
- * Adds an implementation of {@link INotifyPropertyChanged.onPropertyChanged} to the class.
- *
- * @remarks
- * Use in conjunction with {@link INotifyPropertyChanged} and decorating properties with {@link notify}
- */
-function notifyOnPropertyChanged(constructor) {
-    return class extends constructor {
-        constructor() {
-            super(...arguments);
-            this._propertyChanged = new ste_simple_events_1.SimpleEventDispatcher();
-        }
-        onPropertyChanged(property, callback) {
-            this._propertyChanged.sub(prop => {
-                if (property === prop) {
-                    callback();
-                }
-            });
-        }
-    };
-}
-exports.notifyOnPropertyChanged = notifyOnPropertyChanged;
+"use strict";
+/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+/* eslint-disable @typescript-eslint/ban-types */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notifyOnPropertyChanged = exports.notify = void 0;
+const ste_simple_events_1 = require("ste-simple-events");
+/**
+ * Changes to the property will cause an event containing the name of the property to be fired by {@link INotifyPropertyChanged.onPropertyChanged}.
+ * Initializing the property will trigger the event.
+ *
+ * @remarks
+ * Requires {@link notifyOnPropertyChanged} decorator on the class
+ *
+ * @param overrideName Use to specify a different property name in the event. Useful for notifying changes to a get-only property from a change to a private backing file
+ */
+function notify(overrideName) {
+    return (target, propertyKey) => {
+        // Create a new prop to hold the value
+        const valueKey = `_${propertyKey}Notify`;
+        // Replace the decorated prop with getter/setter that handles the notifications
+        Object.defineProperty(target, propertyKey, {
+            set(value) {
+                const oldValue = this[propertyKey];
+                if (value === oldValue) {
+                    return;
+                }
+                this[valueKey] = value;
+                if (this._propertyChanged === undefined) {
+                    return;
+                }
+                const propertyName = overrideName ? overrideName : propertyKey;
+                this._propertyChanged.dispatch(propertyName);
+            },
+            get() {
+                return this[valueKey];
+            },
+        });
+    };
+}
+exports.notify = notify;
+/**
+ * Adds an implementation of {@link INotifyPropertyChanged.onPropertyChanged} to the class.
+ *
+ * @remarks
+ * Use in conjunction with {@link INotifyPropertyChanged} and decorating properties with {@link notify}
+ */
+function notifyOnPropertyChanged(constructor) {
+    return class extends constructor {
+        constructor() {
+            super(...arguments);
+            this._propertyChanged = new ste_simple_events_1.SimpleEventDispatcher();
+        }
+        onPropertyChanged(property, callback) {
+            return this._propertyChanged.sub(prop => {
+                if (property === prop) {
+                    callback();
+                }
+            });
+        }
+    };
+}
+exports.notifyOnPropertyChanged = notifyOnPropertyChanged;
 //# sourceMappingURL=Notify.js.map

package/dist/Notify.js.map

@@ -1 +1 @@
-{"version":3,"file":"Notify.js","sourceRoot":"","sources":["../src/Notify.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iDAAiD;AACjD,uDAAuD;;;AAEvD,yDAAwD;AAYxD;;;;;;;;GAQG;AACH,SAAgB,MAAM,CAAI,YAAsB;IAC9C,OAAO,CAAC,MAAc,EAAE,WAAmB,EAAQ,EAAE;QACnD,sCAAsC;QACtC,MAAM,QAAQ,GAAG,IAAI,WAAW,QAAQ,CAAC;QAEzC,+EAA+E;QAC/E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACzC,GAAG,CAAC,KAAK;gBACP,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;gBAEnC,IAAI,KAAK,KAAK,QAAQ,EAAE;oBACtB,OAAO;iBACR;gBAED,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;gBAEvB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE;oBACvC,OAAO;iBACR;gBAED,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;gBAE/D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC/C,CAAC;YACD,GAAG;gBACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AA7BD,wBA6BC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAuC,WAAc;IAC1F,OAAO,KAAM,SAAQ,WAAW;QAAzB;;YACY,qBAAgB,GAAG,IAAI,yCAAqB,EAAU,CAAC;QAS1E,CAAC;QAPQ,iBAAiB,CAAC,QAAgB,EAAE,QAAoB;YAC7D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBAC/B,IAAI,QAAQ,KAAK,IAAI,EAAE;oBACrB,QAAQ,EAAE,CAAC;iBACZ;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAZD,0DAYC"}
+{"version":3,"file":"Notify.js","sourceRoot":"","sources":["../src/Notify.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iDAAiD;AACjD,uDAAuD;;;AAEvD,yDAAwD;AAaxD;;;;;;;;GAQG;AACH,SAAgB,MAAM,CAAI,YAAsB;IAC9C,OAAO,CAAC,MAAc,EAAE,WAAmB,EAAQ,EAAE;QACnD,sCAAsC;QACtC,MAAM,QAAQ,GAAG,IAAI,WAAW,QAAQ,CAAC;QAEzC,+EAA+E;QAC/E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACzC,GAAG,CAAC,KAAK;gBACP,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;gBAEnC,IAAI,KAAK,KAAK,QAAQ,EAAE;oBACtB,OAAO;iBACR;gBAED,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;gBAEvB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE;oBACvC,OAAO;iBACR;gBAED,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;gBAE/D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC/C,CAAC;YACD,GAAG;gBACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AA7BD,wBA6BC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAuC,WAAc;IAC1F,OAAO,KAAM,SAAQ,WAAW;QAAzB;;YACY,qBAAgB,GAAG,IAAI,yCAAqB,EAAU,CAAC;QAS1E,CAAC;QAPQ,iBAAiB,CAAC,QAAgB,EAAE,QAAoB;YAC7D,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACtC,IAAI,QAAQ,KAAK,IAAI,EAAE;oBACrB,QAAQ,EAAE,CAAC;iBACZ;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAZD,0DAYC"}

package/dist/Reaper.d.ts

@@ -1,93 +1,95 @@
-/**
- * Contains classes for controlling Reaper via OSC
- * @module
- */
-import { OscMessage } from './Messages';
-import { Track } from './Tracks';
-import { Transport } from './Transport';
-import { INotifyPropertyChanged } from './Notify';
-/**
- * Allows control of an instance of Reaper via OSC.
- *
- * @example
- * ```typescript
- * // Create an instance of Reaper using default settings
- * const reaper = new Reaper();
- * // Start OSC
- * reaper.startOsc();
- * // Give the port a chance to open, then tell Reaper to start playback
- * setTimeout(() => {reaper.transport.play();}, 100);
- *```
- */
-export declare class Reaper implements INotifyPropertyChanged {
-    private _isMetronomeEnabled;
-    private readonly _afterMessageReceived;
-    private readonly _handlers;
-    private _isReady;
-    private readonly _masterTrack;
-    private readonly _osc;
-    private readonly _readyDispatcher;
-    private readonly _tracks;
-    private readonly _transport;
-    constructor(config?: ReaperConfiguration);
-    /** Indicates whether the metronome is enabled */
-    get isMetronomeEnabled(): boolean;
-    /** Indicates whether OSC is ready to send and receive messages */
-    get isReady(): boolean;
-    /** The master track */
-    get master(): Track;
-    onPropertyChanged(property: string, callback: () => void): void;
-    /** An event that can be subscribed to for notification when OSC is ready */
-    onReady(callback: () => void): void;
-    /**
-     * Triggers the action `Control surface: Refresh all surfaces` (Command ID: 41743)
-     */
-    refreshControlSurfaces(): void;
-    /**
-     * Send a message to Reaper via OSC. Messages may not be sent while {@link Reaper.isReady} is false.
-     * @param message The OSC message to be sent
-     */
-    sendOscMessage(message: OscMessage): void;
-    /** Open the OSC port and start listening for messages */
-    startOsc(): void;
-    /** Stop listening for OSC messages */
-    stopOsc(): void;
-    /** Toggle the metronome on or off */
-    toggleMetronome(): void;
-    /** The current bank of tracks */
-    get tracks(): ReadonlyArray<Track>;
-    /** Transport controls */
-    get transport(): Transport;
-    /**
-     * Trigger a Reaper action
-     * @param commandId The Command ID of the action to be triggered.
-     * @param value The value to send for the action. Note that some actions expect the CC value (0-127) while others expect a decimal value between 0 and 1.
-     * @example
-     * ```typescript
-     * // Trigger action 'Track: Toggle mute for master track'
-     * reaper.triggerAction(14);
-     * // Trigger SWS Extension action 'SWS/S&M: Live Config #1 - Apply config (MIDI/OSC only)' with a CC value of 3, selects config #3
-     * reaper.triggerAction('_S&M_LIVECFG_APPLY1', 3);
-     * // Trigger action 'Track: Set volume for track 01 (MIDI CC/OSC only)' with a value of 0.75, sets volume of track 1 to +0.0dB
-     * reaper.triggerAction(20, 0.7156)
-     * ```
-     */
-    triggerAction(commandId: number | string, value?: number | null): void;
-    private initHandlers;
-    private initOsc;
-}
-export declare class ReaperConfiguration {
-    afterMessageReceived: ((message: OscMessage, handled: boolean) => void) | null;
-    /** The address to listen for Reaper OSC messages on */
-    localAddress: string;
-    /** The port to listen for Reaper OSC messages on */
-    localPort: number;
-    /** Number of FX per track */
-    numberOfFx: number;
-    /** Number of tracks per bank */
-    numberOfTracks: number;
-    /** The address to send Reaper OSC messages to */
-    remoteAddress: string;
-    /** The port to send Reaper OSC messages to */
-    remotePort: number;
-}
+/**
+ * Contains classes for controlling Reaper via OSC
+ * @module
+ */
+import { OscMessage } from './Messages';
+import { Track } from './Tracks';
+import { Transport } from './Transport';
+import { INotifyPropertyChanged } from './Notify';
+/**
+ * Allows control of an instance of Reaper via OSC.
+ *
+ * @example
+ * ```typescript
+ * // Create an instance of Reaper using default settings
+ * const reaper = new Reaper();
+ * // Start OSC
+ * reaper.startOsc();
+ * // Give the port a chance to open, then tell Reaper to start playback
+ * setTimeout(() => {reaper.transport.play();}, 100);
+ *```
+ */
+export declare class Reaper implements INotifyPropertyChanged {
+    private _isMetronomeEnabled;
+    private readonly _afterMessageReceived;
+    private readonly _handlers;
+    private _isReady;
+    private readonly _log;
+    private readonly _masterTrack;
+    private readonly _osc;
+    private readonly _tracks;
+    private readonly _transport;
+    constructor(config?: ReaperConfiguration);
+    /** Indicates whether the metronome is enabled */
+    get isMetronomeEnabled(): boolean;
+    /** Indicates whether OSC is ready to send and receive messages */
+    get isReady(): boolean;
+    /** The master track */
+    get master(): Track;
+    onPropertyChanged(property: string, callback: () => void): () => void;
+    /**
+     * Triggers the action `Control surface: Refresh all surfaces` (Command ID: 41743)
+     */
+    refreshControlSurfaces(): void;
+    /**
+     * Send a message to Reaper via OSC. Messages may not be sent while {@link Reaper.isReady} is false.
+     * @param message The OSC message to be sent
+     */
+    sendOscMessage(message: OscMessage): void;
+    /** Open the OSC port and start listening for messages */
+    start(): Promise<void>;
+    /** Stop listening for OSC messages */
+    stop(): Promise<void>;
+    /** Toggle the metronome on or off */
+    toggleMetronome(): void;
+    /** The current bank of tracks */
+    get tracks(): ReadonlyArray<Track>;
+    /** Transport controls */
+    get transport(): Transport;
+    /**
+     * Trigger a Reaper action
+     * @param commandId The Command ID of the action to be triggered.
+     * @param value The value to send for the action. Note that some actions expect the CC value (0-127) while others expect a decimal value between 0 and 1.
+     * @example
+     * ```typescript
+     * // Trigger action 'Track: Toggle mute for master track'
+     * reaper.triggerAction(14);
+     * // Trigger SWS Extension action 'SWS/S&M: Live Config #1 - Apply config (MIDI/OSC only)' with a CC value of 3, selects config #3
+     * reaper.triggerAction('_S&M_LIVECFG_APPLY1', 3);
+     * // Trigger action 'Track: Set volume for track 01 (MIDI CC/OSC only)' with a value of 0.75, sets volume of track 1 to +0.0dB
+     * reaper.triggerAction(20, 0.7156)
+     * ```
+     */
+    triggerAction(commandId: number | string, value?: number | null): void;
+    private initHandlers;
+    private initOsc;
+}
+export declare class ReaperConfiguration {
+    afterMessageReceived: ((message: OscMessage, handled: boolean) => void) | null;
+    /** The address to listen for Reaper OSC messages on */
+    localAddress: string;
+    /** The port to listen for Reaper OSC messages on */
+    localPort: number;
+    /** Function for logging messages. Defaults to logging to console */
+    log: Logger;
+    /** Number of FX per track */
+    numberOfFx: number;
+    /** Number of tracks per bank */
+    numberOfTracks: number;
+    /** The address to send Reaper OSC messages to */
+    remoteAddress: string;
+    /** The port to send Reaper OSC messages to */
+    remotePort: number;
+}
+export declare type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare type Logger = (level: LogLevel, message: string, ...optionalParams: any[]) => void;