tone 14.8.46 → 14.8.48

package/README.md

@@ -12,22 +12,24 @@ Tone.js is a Web Audio framework for creating interactive music in the browser.
 
 # Installation
 
-To install the latest stable version.
+There are two ways to incorporate Tone.js into a proejct. First, it can be installed locally into a project using `npm`:
 
 ```bash
-npm install tone
+npm install tone      // Install the latest stable version
+npm install tone@next // Or, alternatively, use the 'next' version
 ```
 
-Or to install the 'next' version
+Add Tone.js to a project using the JavaScript `import` syntax:
 
-```bash
-npm install tone@next
+```js
+import * as Tone from 'tone';
 ```
 
-To import Tone.js:
+Tone.js is also hosted at unpkg.com. It can be added directly within an HTML document, as long as it precedes any project scripts. [See the example here](https://github.com/Tonejs/Tone.js/blob/master/examples/simpleHtml.html) for more details.
 
-```js
-import * as Tone from 'tone'
+```html
+<script src="http://unpkg.com/tone"></script>
+<script src="myScript.js"></script>
 ```
 
 # Hello Tone

package/Tone/component/analysis/DCMeter.ts

@@ -4,7 +4,7 @@ import { MeterBase, MeterBaseOptions } from "./MeterBase";
 export type DCMeterOptions = MeterBaseOptions;
 
 /**
- * DCMeter gets the raw value of the input signal at the current time.
+ * DCMeter gets the raw value of the input signal at the current time. See also {@link Meter}.
  *
  * @example
  * const meter = new Tone.DCMeter();

package/Tone/component/analysis/Meter.ts

@@ -14,6 +14,9 @@ export interface MeterOptions extends MeterBaseOptions {
 /**
  * Meter gets the [RMS](https://en.wikipedia.org/wiki/Root_mean_square)
  * of an input signal. It can also get the raw value of the input signal.
+ * Setting `normalRange` to `true` will covert the output to a range of
+ * 0-1. See an example using a graphical display 
+ * [here](https://tonejs.github.io/examples/meter). See also {@link DCMeter}.
  *
  * @example
  * const meter = new Tone.Meter();

package/Tone/core/context/Context.test.ts

@@ -120,8 +120,7 @@ describe("Context", () => {
 			await context.resume();
 			await new Promise<void>((done) => setTimeout(() => done(), 10));
 			expect(triggerChange).to.equal(true);
-			context.dispose();
-			return ac.close();
+			return context.dispose();
 		});
 	});
 

package/Tone/core/context/Context.ts

@@ -94,6 +94,11 @@ export class Context extends BaseContext {
 	 */
 	private _initialized = false;
 
+	/**
+	 * Private indicator if a close() has been called on the context, since close is async
+	 */
+	private _closeStarted = false;
+
 	/**
 	 * Indicates if the context is an OfflineAudioContext or an AudioContext
 	 */
@@ -485,7 +490,8 @@ export class Context extends BaseContext {
 	 * any AudioNodes created from the context will be silent.
 	 */
 	async close(): Promise<void> {
-		if (isAudioContext(this._context)) {
+		if (isAudioContext(this._context) && (this.state !== "closed") && !this._closeStarted) {
+			this._closeStarted = true;
 			await this._context.close();
 		}
 		if (this._initialized) {
@@ -530,6 +536,7 @@ export class Context extends BaseContext {
 		Object.keys(this._constants).map((val) =>
 			this._constants[val].disconnect()
 		);
+		this.close();
 		return this;
 	}
 

package/Tone/version.ts

@@ -1 +1 @@
-export const version: string = "14.8.46";
+export const version: string = "14.8.48";