Feat: documentation, UI/UX

docs/tutorials/randomness.md

@@ -94,37 +94,6 @@ Kick plays 50% of the time, snare 30%, hat 20%. Weights don't need to sum to 1 -
 
 Combined with `note`, this gives you a random permutation of a chord every time the step runs.
 
-## Cycling
-
-Cycling steps through values deterministically. No randomness -- pure rotation.
-
-`cycle` selects based on how many times this step has played (its `runs` count):
-
-```forth
-60 64 67 3 cycle note sine s .    ;; 60, 64, 67, 60, 64, 67, ...
-```
-
-`pcycle` selects based on the pattern iteration count (`iter`):
-
-```forth
-kick snare 2 pcycle s .    ;; kick on even iterations, snare on odd
-```
-
-The difference matters when patterns have different lengths. `cycle` counts per-step, `pcycle` counts per-pattern.
-
-Quotations work here too:
-
-```forth
-( c4 note ) ( e4 note ) ( g4 note ) 3 cycle
-sine s .
-```
-
-`bounce` ping-pongs instead of wrapping around:
-
-```forth
-60 64 67 72 4 bounce note sine s .    ;; 60, 64, 67, 72, 67, 64, 60, 64, ...
-```
-
 ## Periodic Execution
 
 `every` runs a quotation once every n pattern iterations:
@@ -139,6 +108,20 @@ sine s .
 ( 2 distort ) 4 except    ;; distort on all iterations except every 4th
 ```
 
+`every+` and `except+` take an extra offset argument to shift the phase:
+
+```forth
+( snare s . ) 4 2 every+     ;; fires at iter 2, 6, 10, 14...
+( snare s . ) 4 2 except+    ;; skips at iter 2, 6, 10, 14...
+```
+
+Without the offset, `every` fires at 0, 4, 8... The offset shifts that by 2, so it fires at 2, 6, 10... This lets you interleave patterns that share the same period:
+
+```forth
+( kick s . ) 4 every         ;; kick at 0, 4, 8...
+( snare s . ) 4 2 every+     ;; snare at 2, 6, 10...
+```
+
 `bjork` and `pbjork` use Bjorklund's algorithm to distribute k hits across n positions as evenly as possible. Classic Euclidean rhythms:
 
 ```forth