entangled-worlds-orbiters-shared 2.14.0 → 2.15.0

package/dist/faust/recipes.d.ts

@@ -33,7 +33,7 @@ export declare function readRecipes(value: unknown): Recipes | null;
  * How this package composes a program from a shape. Raise it when the same shape would compose to
  * different text: a test keeps a fingerprint of the composed text beside it and fails until then.
  */
-export declare const COMPOSER_VERSION = 1;
+export declare const COMPOSER_VERSION = 2;
 /**
  * Where a build's compiled programs are filed: the recipes, the shrink step and the composer
  * together. A file under it is never replaced, so a release keeps the programs it was given.

package/dist/faust/recipes.js

@@ -41,7 +41,7 @@ export function readRecipes(value) {
  * How this package composes a program from a shape. Raise it when the same shape would compose to
  * different text: a test keeps a fingerprint of the composed text beside it and fails until then.
  */
-export const COMPOSER_VERSION = 1;
+export const COMPOSER_VERSION = 2;
 /**
  * Where a build's compiled programs are filed: the recipes, the shrink step and the composer
  * together. A file under it is never replaced, so a release keeps the programs it was given.

package/dist/faust/voiceProgram.d.ts

@@ -30,9 +30,10 @@
  *
  * A head rack that plays notes composes as lanes (`lib/ps_notes.lib`):
  *
- *     process = nt.entry(8)                                            // the lanes the allocator writes
+ *     process = nt.chainEntry(8)                                       // the lanes the allocator writes
  *       : hgroup("s0", nt.bypass(8, 1, library("pitch.dsp")[SLOT=0;].notes(8)))
  *       : hgroup("tap0", nt.tap(8))                                    // the notes leaving s0
+ *       : nt.toPlay(8)                                                 // the beats stay behind
  *       : hgroup("s1", library("synth.dsp")[SLOT=1;].play(8))          // a note voice per lane
  *       : hgroup("s2", component("filter.dsp"));
  *
@@ -41,6 +42,11 @@
  * instrument plays every lane that reaches it. `SLOT` is the module's place, its part of the seed;
  * a module that adds lanes (a structural `lanesOut`) also gets `LANES_OUT`, its lanes out per lane in,
  * since `notes(n)` is told only n.
+ *
+ * Between the note modules a lane carries a fourth signal, the beat its note started on (what Random
+ * and Velocity draw from): `nt.chainEntry` writes it, `nt.toPlay` drops it, so an instrument takes
+ * three signals a lane whether or not anything sits in front of it. An instrument alone keeps the
+ * plain `nt.entry`.
  */
 /** The most note lanes one head plays: what reaches the instrument after every note module has multiplied them. */
 export declare const MAX_NOTE_LANES = 16;

package/dist/faust/voiceProgram.js

@@ -30,9 +30,10 @@
  *
  * A head rack that plays notes composes as lanes (`lib/ps_notes.lib`):
  *
- *     process = nt.entry(8)                                            // the lanes the allocator writes
+ *     process = nt.chainEntry(8)                                       // the lanes the allocator writes
  *       : hgroup("s0", nt.bypass(8, 1, library("pitch.dsp")[SLOT=0;].notes(8)))
  *       : hgroup("tap0", nt.tap(8))                                    // the notes leaving s0
+ *       : nt.toPlay(8)                                                 // the beats stay behind
  *       : hgroup("s1", library("synth.dsp")[SLOT=1;].play(8))          // a note voice per lane
  *       : hgroup("s2", component("filter.dsp"));
  *
@@ -41,6 +42,11 @@
  * instrument plays every lane that reaches it. `SLOT` is the module's place, its part of the seed;
  * a module that adds lanes (a structural `lanesOut`) also gets `LANES_OUT`, its lanes out per lane in,
  * since `notes(n)` is told only n.
+ *
+ * Between the note modules a lane carries a fourth signal, the beat its note started on (what Random
+ * and Velocity draw from): `nt.chainEntry` writes it, `nt.toPlay` drops it, so an instrument takes
+ * three signals a lane whether or not anything sits in front of it. An instrument alone keeps the
+ * plain `nt.entry`.
  */
 /** The most note lanes one head plays: what reaches the instrument after every note module has multiplied them. */
 export const MAX_NOTE_LANES = 16;
@@ -100,7 +106,10 @@ function noteModules(slots, head) {
     let lanes = wholeAtLeastOne(instrument.polyphony, `slot ${head}: polyphony`);
     // A tap after every note module: the notes leaving it, for the meters and screens. The entry has
     // none: the main thread knows what it sends in (the keys, MIDI in, the clip's notes reported back).
-    const parts = [`nt.entry(${lanes})`];
+    // Note modules in front: lanes carry their beats up to the instrument. An instrument alone takes the
+    // plain entry, its committed program unchanged.
+    const chain = head > 0;
+    const parts = [chain ? `nt.chainEntry(${lanes})` : `nt.entry(${lanes})`];
     slots.slice(0, head).forEach((slot, index) => {
         const notes = slot.notes;
         if (!notes || notes.kind === 'instrument') {
@@ -117,6 +126,8 @@ function noteModules(slots, head) {
     if (lanes > MAX_NOTE_LANES) {
         throw new Error(`[voiceProgram] ${lanes} note lanes reach the instrument; it plays at most ${MAX_NOTE_LANES}`);
     }
+    if (chain)
+        parts.push(`nt.toPlay(${lanes})`);
     return { parts, lanes };
 }
 /** The instrument at `head`, playing `lanes` lanes: the last part of a note chain. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "entangled-worlds-orbiters-shared",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "Shared library for entangled worlds orbiters - contains core world rendering, moons system, and UI components",
   "type": "module",
   "main": "src/index.js",

package/src/faust/recipes.ts

@@ -59,7 +59,7 @@ export function readRecipes(value: unknown): Recipes | null {
  * How this package composes a program from a shape. Raise it when the same shape would compose to
  * different text: a test keeps a fingerprint of the composed text beside it and fails until then.
  */
-export const COMPOSER_VERSION = 1;
+export const COMPOSER_VERSION = 2;
 
 /**
  * Where a build's compiled programs are filed: the recipes, the shrink step and the composer

package/src/faust/voiceProgram.ts

@@ -30,9 +30,10 @@
  *
  * A head rack that plays notes composes as lanes (`lib/ps_notes.lib`):
  *
- *     process = nt.entry(8)                                            // the lanes the allocator writes
+ *     process = nt.chainEntry(8)                                       // the lanes the allocator writes
  *       : hgroup("s0", nt.bypass(8, 1, library("pitch.dsp")[SLOT=0;].notes(8)))
  *       : hgroup("tap0", nt.tap(8))                                    // the notes leaving s0
+ *       : nt.toPlay(8)                                                 // the beats stay behind
  *       : hgroup("s1", library("synth.dsp")[SLOT=1;].play(8))          // a note voice per lane
  *       : hgroup("s2", component("filter.dsp"));
  *
@@ -41,6 +42,11 @@
  * instrument plays every lane that reaches it. `SLOT` is the module's place, its part of the seed;
  * a module that adds lanes (a structural `lanesOut`) also gets `LANES_OUT`, its lanes out per lane in,
  * since `notes(n)` is told only n.
+ *
+ * Between the note modules a lane carries a fourth signal, the beat its note started on (what Random
+ * and Velocity draw from): `nt.chainEntry` writes it, `nt.toPlay` drops it, so an instrument takes
+ * three signals a lane whether or not anything sits in front of it. An instrument alone keeps the
+ * plain `nt.entry`.
  */
 /** The most note lanes one head plays: what reaches the instrument after every note module has multiplied them. */
 export const MAX_NOTE_LANES = 16;
@@ -126,7 +132,10 @@ function noteModules(slots: readonly VoiceSlot[], head: number): { parts: string
   let lanes = wholeAtLeastOne(instrument.polyphony, `slot ${head}: polyphony`);
   // A tap after every note module: the notes leaving it, for the meters and screens. The entry has
   // none: the main thread knows what it sends in (the keys, MIDI in, the clip's notes reported back).
-  const parts = [`nt.entry(${lanes})`];
+  // Note modules in front: lanes carry their beats up to the instrument. An instrument alone takes the
+  // plain entry, its committed program unchanged.
+  const chain = head > 0;
+  const parts = [chain ? `nt.chainEntry(${lanes})` : `nt.entry(${lanes})`];
   slots.slice(0, head).forEach((slot, index) => {
     const notes = slot.notes;
     if (!notes || notes.kind === 'instrument') {
@@ -143,6 +152,7 @@ function noteModules(slots: readonly VoiceSlot[], head: number): { parts: string
   if (lanes > MAX_NOTE_LANES) {
     throw new Error(`[voiceProgram] ${lanes} note lanes reach the instrument; it plays at most ${MAX_NOTE_LANES}`);
   }
+  if (chain) parts.push(`nt.toPlay(${lanes})`);
   return { parts, lanes };
 }