add note calls everywhere

packages/core/pattern.mjs

@@ -472,7 +472,7 @@ export class Pattern {
    * @memberof Pattern
    * @returns Pattern
    * @example
-   * "0.5 1.5 2.5".round().scale('C major')
+   * "0.5 1.5 2.5".round().scale('C major').note()
    */
   round() {
     return this._asNumber().fmap((v) => Math.round(v));
@@ -704,7 +704,7 @@ export class Pattern {
    * @name apply
    * @memberof Pattern
    * @example
-   * "<c3 eb3 g3>".scale('C minor').apply(scaleTranspose("0,2,4"))
+   * "<c3 eb3 g3>".scale('C minor').apply(scaleTranspose("0,2,4")).note()
    */
   _apply(func) {
     return func(this);
@@ -925,9 +925,9 @@ export class Pattern {
    * @memberof Pattern
    * @returns Pattern
    * @example
-   * "c3,eb3,g3"
+   * note("c3,eb3,g3")
    *   .struct("x ~ x ~ ~ x ~ x ~ ~ ~ x ~ x ~ ~")
-   *   .slow(4).note()
+   *   .slow(4)
    */
   // struct(...binary_pats) {
   //   // Re structure the pattern according to a binary pattern (false values are dropped)
@@ -984,7 +984,7 @@ export class Pattern {
    * @param {function} func
    * @returns Pattern
    * @example
-   * "c3 eb3 g3".when("<0 1>/2", x=>x.sub(5))
+   * "c3 eb3 g3".when("<0 1>/2", x=>x.sub(5)).note()
    */
   when(binary_pat, func) {
     //binary_pat = sequence(binary_pat)
@@ -1003,7 +1003,7 @@ export class Pattern {
    * @param {function} func function to apply
    * @returns Pattern
    * @example
-   * "c3 eb3 g3".off(1/8, x=>x.add(7))
+   * "c3 eb3 g3".off(1/8, x=>x.add(7)).note()
    */
   off(time_pat, func) {
     return stack(this, func(this.late(time_pat)));
@@ -1077,7 +1077,7 @@ export class Pattern {
    * @memberof Pattern
    * @returns Pattern
    * @example
-   * "c3 d3 e3 g3".rev()
+   * note("c3 d3 e3 g3").rev()
    */
   rev() {
     const pat = this;
@@ -1297,7 +1297,7 @@ export class Pattern {
    * @name legato
    * @memberof Pattern
    * @example
-   * n("c3 eb3 g3 c4").legato("<.25 .5 1 2>")
+   * note("c3 eb3 g3 c4").legato("<.25 .5 1 2>")
    */
   _legato(value) {
     return this.withHapSpan((span) => new TimeSpan(span.begin, span.begin.add(span.end.sub(span.begin).mul(value))));
@@ -1387,14 +1387,14 @@ function _composeOp(a, b, func) {
      * @memberof Pattern
      * @example
      * // Here, the triad 0, 2, 4 is shifted by different amounts
-     * "0 2 4".add("<0 3 4 0>").scale('C major')
+     * "0 2 4".add("<0 3 4 0>").scale('C major').note()
      * // Without add, the equivalent would be:
-     * // "<[0 2 4] [3 5 7] [4 6 8] [0 2 4]>".scale('C major')
+     * // "<[0 2 4] [3 5 7] [4 6 8] [0 2 4]>".scale('C major').note()
      * @example
      * // You can also use add with notes:
-     * "c3 e3 g3".add("<0 5 7 0>")
+     * "c3 e3 g3".add("<0 5 7 0>").note()
      * // Behind the scenes, the notes are converted to midi numbers:
-     * // "48 52 55".add("<0 5 7 0>")
+     * // "48 52 55".add("<0 5 7 0>").note()
      */
     add: [(a, b) => a + b, numOrString], // support string concatenation
     /**
@@ -1403,7 +1403,7 @@ function _composeOp(a, b, func) {
      * @name sub
      * @memberof Pattern
      * @example
-     * "0 2 4".sub("<0 1 2 3>").scale('C4 minor')
+     * "0 2 4".sub("<0 1 2 3>").scale('C4 minor').note()
      * // See add for more information.
      */
     sub: [(a, b) => a - b, num],
@@ -1579,7 +1579,7 @@ export function reify(thing) {
  *
  * @return {Pattern}
  * @example
- * stack(g3, b3, [e4, d4]) // "g3,b3,[e4,d4]"
+ * stack(g3, b3, [e4, d4]).note() // "g3,b3,[e4,d4]".note()
  */
 export function stack(...pats) {
   // Array test here is to avoid infinite recursions..
@@ -1652,7 +1652,7 @@ export function fastcat(...pats) {
  * @param {...any} items - The items to concatenate
  * @return {Pattern}
  * @example
- * cat(e5, b4, [d5, c5]) // "<e5 b4 [d5 c5]>"
+ * cat(e5, b4, [d5, c5]).note() // "<e5 b4 [d5 c5]>".note()
  *
  */
 export function cat(...pats) {
@@ -1662,7 +1662,7 @@ export function cat(...pats) {
 /** Like {@link seq}, but each step has a length, relative to the whole.
  * @return {Pattern}
  * @example
- * timeCat([3,e3],[1, g3]) // "e3@3 g3"
+ * timeCat([3,e3],[1, g3]).note() // "e3@3 g3".note()
  */
 export function timeCat(...timepats) {
   const total = timepats.map((a) => a[0]).reduce((a, b) => a.add(b), Fraction(0));
@@ -1683,7 +1683,7 @@ export function sequence(...pats) {
 
 /** Like **cat**, but the items are crammed into one cycle. Synonyms: fastcat, sequence
  * @example
- * seq(e5, b4, [d5, c5]) // "e5 b4 [d5 c5]"
+ * seq(e5, b4, [d5, c5]).note() // "e5 b4 [d5 c5]".note()
  *
  */
 export function seq(...pats) {