Added new immediate mode for Ziffers evaluation using Ctrl+Shift+Enter.

src/API.ts

@@ -800,18 +800,27 @@ export class UserAPI {
 
       if (typeof input === "string" &&
         player.input !== input &&
-        player.atTheBeginning()) {
-        replace = true;
+        (player.atTheBeginning() || this.forceEvaluator)) {
+          replace = true;
       }
     }
 
     if ((typeof input !== "string" || validSyntax) && (!player || replace)) {
-      const newPlayer = new Player(input, options, this.app, zid);
-      if (newPlayer.isValid()) {
-        player = newPlayer
-        this.patternCache.set(key, player);
-      } else if (typeof input === "string") {
-        this.invalidPatterns[input] = true;
+      if(typeof input === "string" && player && this.forceEvaluator) {
+        // If pattern change is forced in the middle of the cycle
+        if(!player.updatePattern(input, options)) {
+          this.logOnce(`Invalid syntax: ${input}`);
+        };
+        this.forceEvaluator = false;
+      } else {
+        // If pattern is not in cache or is to be replaced
+        const newPlayer = player ? new Player(input, options, this.app, zid, player.nextEndTime()) : new Player(input, options, this.app, zid);
+        if (newPlayer.isValid()) {
+           player = newPlayer
+          this.patternCache.set(key, player);
+        } else if (typeof input === "string") {
+          this.invalidPatterns[input] = true;
+        }
       }
     }
 

src/classes/ZPlayer.ts

@@ -7,6 +7,7 @@ import { MidiEvent, MidiParams } from "./MidiEvent";
 import { RestEvent } from "./RestEvent";
 import { arrayOfObjectsToObjectWithArrays, isGenerator } from "../Utils/Generic";
 import { TonnetzSpaces } from "zifferjs/src/tonnetz";
+import { safeMod } from "zifferjs/src/utils";
 
 export type InputOptions = { [key: string]: string | number };
 
@@ -31,6 +32,7 @@ export class Player extends AbstractEvent {
     options: InputOptions,
     public app: Editor,
     zid: string = "",
+    waitTime: number = 0,
   ) {
     super(app);
     this.options = options;
@@ -46,9 +48,24 @@ export class Player extends AbstractEvent {
     } else {
       throw new Error("Invalid input");
     }
+    if(waitTime) this.waitTime = waitTime;
     this.zid = zid;
   }
 
+  updatePattern(input: string, options: InputOptions): boolean {
+    const oldIndex = this.ziffers.index;
+    const newPattern = new Ziffers(input, options);
+    if(newPattern.values.length > 0) {
+      this.ziffers = newPattern;
+      this.ziffers.update();
+      this.ziffers.index = oldIndex;
+      this.input = input;
+      this.options = options;
+      return true;
+    }
+    return false;
+  }
+
   isValid() {
     return this.ziffers.values.length > 0;
   }
@@ -417,10 +434,8 @@ export class Player extends AbstractEvent {
   }
 
   rotate(amount: number = 1) {
-    // TODO: Only works for evaluated patterns (setRedo). Fix this for generative patterns. Mod by current cycle?
     if (this.atTheBeginning()) {
-      this.ziffers.setRedo(0);
-      this.ziffers.rotate(amount);
+      this.ziffers.rotate(amount+safeMod(this.ziffers.cycleIndex,this.ziffers.evaluated.length));
     }
     return this;
   }

src/documentation/patterns/ziffers/ziffers_algorithmic.ts

@@ -85,6 +85,7 @@ z1("s A=(0 (1,4)) B~(2 (3,8)) A B A B A")
   * <ic>deal(amount: number): Shuffle the generated pattern and deal given number of elements
   * <ic>retrograde()</ic> Reverse the generated pattern
   * <ic>invert()</ic> Invert the generated pattern
+  * <ic>rotate(amount: number)</ic> Rotate the generated pattern by given amount
   * <ic>between(start: number, end: number)</ic> Select a range of elements from the generated pattern
   * <ic>from(start: number)</ic> Select a range of elements from the start index to the end of the pattern
   * <ic>to(end: number)</ic> Select a range of elements from the beginning of the pattern to the end index

src/documentation/patterns/ziffers/ziffers_basics.ts

@@ -32,6 +32,10 @@ z4('1/4 kick kick snare kick').sound().gain(1).cutoff(osci).out()
   true,
 )}
 
+## Evaluation
+
+Evaluation of live coded Ziffers patterns can be done in 3 different ways. Normal evaluation using <ic>Ctrl+Enter</ic> updates the pattern after the current cycle is finished. Evaluation using <ic>Ctrl+Shift+Enter</ic> updates the pattern immediately keeping the current position, which enables to modify future events even within the current cycle. Evaluation using <ic>Ctrl+Shift+Backspace</ic> resets the current pattern and starts from the beginning immediately.
+
 ## Notation
 
 The basic Ziffer notation is entirely written in JavaScript strings (_e.g_ <ic>"0 1 2"</ic>). It consists mostly of numbers and letters. The whitespace character is used as a separator. Instead of note names, Ziffer is using numbers to represent musical pitch and letters to represent musical durations. Alternatively, _floating point numbers_ can also be used to represent durations.