moontide-mcp 2.2.0 → 2.4.1

package/page/ask-view.js

@@ -13,6 +13,8 @@ import {
   ASK_COPY,
   BOX_GAP_REM,
   MAX_ASK_TEXT_LENGTH,
+  MAX_MOTIF_PHRASE_LENGTH,
+  MAX_REQUEST_LINE_BYTES,
   PAGE_REQUESTS_COPY,
   pageRequestsText,
   askMessage,
@@ -21,11 +23,13 @@ import {
   describeContext,
   fitGestureToLine,
   fitMomentToLine,
+  motifChip,
   newAskId,
   partsAskState,
   placeBox,
   refusalText,
   requestFitsLine,
+  requestLineBytes,
 } from './ask.js';
 
 /**
@@ -34,9 +38,11 @@ import {
  * sends one JSON-able message to the server; `reportError` and `clearError` write and clear the
  * top-bar error line; `setTimer`, `clearTimer` and `now` are the page's clock. `requests` is the per-request tracker
  * of page/request-status.js: every request sent is handed to it, and so is every server answer to one. The tracker
- * tells the page (main.js) when a request was never confirmed; the page then calls `notConfirmed(id)` here.
+ * tells the page (main.js) when a request was never confirmed; the page then calls `notConfirmed(id)` here. `onMotifResult` is
+ * called with what became of the Scratchpad's motif request (`{ status: 'received' }` once Claude has it, `{ status: 'waiting' }` once the
+ * server holds it for Claude's next call); the motif request has its own pending id, so nothing it meets ever reaches the Ask box or its draft.
  */
-export function createAskView({ document, send, reportError, clearError, setTimer, clearTimer, now, requests }) {
+export function createAskView({ document, send, reportError, clearError, setTimer, clearTimer, now, requests, onMotifResult = () => {} }) {
   const askBox = document.getElementById('ask-box');
   const askContextChip = document.getElementById('ask-context-chip');
   const askCurrentChip = document.getElementById('ask-current-chip');
@@ -136,6 +142,8 @@ export function createAskView({ document, send, reportError, clearError, setTime
   // request while it waits for Claude to take it.
   let partsAvailable = false;
   let partsPendingId = null;
+  // The Scratchpad's motif request, the same way: the id of the one on its way, so its refusal never arms the Ask box.
+  let motifPendingId = null;
 
   /** The fields of the request the box would send for `text` (trimmed), the id measured with the next one's shape. */
   function requestFields(text) {
@@ -430,6 +438,46 @@ export function createAskView({ document, send, reportError, clearError, setTime
     renderPartsAsk();
   });
 
+  /**
+   * Sends the Scratchpad's motif as a page request: `words` are the user's own (trimmed) and `motif` is the motif field of
+   * page/scratch-model.js's motifRequest. The request has its own pending id, goes to the tracker like any other and never
+   * touches the Ask box. Returns `{ id }` once it is sent, or `{ refused: word, ...numbers }` and sends nothing: 'disconnected',
+   * 'pending' (the last motif request has not reached the server: the server has not answered it yet), 'empty-words', 'words-too-long' (`length`, `max`) or 'too-big'
+   * (`bytes` and `max`, measured on the exact frame, id included; a phrase over MAX_MOTIF_PHRASE_LENGTH characters is refused the same way). The
+   * phrase is never cut: a motif that does not fit is refused whole.
+   */
+  function sendMotif({ words, motif }) {
+    if (!connected) return { refused: 'disconnected' };
+    if (motifPendingId !== null) return { refused: 'pending' };
+    const text = words.trim();
+    if (text === '') return { refused: 'empty-words' };
+    if (text.length > MAX_ASK_TEXT_LENGTH) return { refused: 'words-too-long', length: text.length, max: MAX_ASK_TEXT_LENGTH };
+    const id = newAskId(counter + 1, now());
+    // A phrase longer than the server takes is refused like any motif too big for the line, before describeContext (which throws on it)
+    // checks the motif. The bytes are those of the line it would make; the rest of the request always puts that line over its bound.
+    if (motif !== null && typeof motif === 'object' && typeof motif.phrase === 'string' && motif.phrase.length > MAX_MOTIF_PHRASE_LENGTH) {
+      const bytes = requestLineBytes({ id, text, context: { kind: 'motif' }, chip: motifChip(motif), current: currentVersion, motif });
+      return { refused: 'too-big', bytes, max: MAX_REQUEST_LINE_BYTES };
+    }
+    const described = describeContext({ kind: 'motif', motif });
+    const frame = { type: 'ask', id, text, context: described.context, chip: described.chip, current: currentVersion, motif: described.motif };
+    const bytes = requestLineBytes(frame);
+    if (bytes > MAX_REQUEST_LINE_BYTES) return { refused: 'too-big', bytes, max: MAX_REQUEST_LINE_BYTES };
+    counter += 1;
+    send(frame);
+    // While the token is refused the line stays: the server's 'token' refusal writes it again, so it never blinks off.
+    if (!authRefused) clearError();
+    requests.sent(frame.id, { text, chip: described.chip });
+    motifPendingId = frame.id;
+    return { id: frame.id };
+  }
+
+  /** The server has the motif request: it is no longer on its way, and the page is told. */
+  function arrivedMotif() {
+    motifPendingId = null;
+    onMotifResult({ status: 'received' });
+  }
+
   /** The server's answers: token result, one result per request, and hand-overs of waiting requests. */
   function onServerMessage(msg) {
     if (msg.type === 'ask-auth') {
@@ -455,11 +503,26 @@ export function createAskView({ document, send, reportError, clearError, setTime
     if (msg.type === 'ask-received') {
       requests.serverMessage(msg);
       if (partsPendingId !== null && msg.ids.includes(partsPendingId)) partsPendingId = null;
+      if (motifPendingId !== null && msg.ids.includes(motifPendingId)) arrivedMotif();
       renderPartsAsk();
       return;
     }
     if (msg.type !== 'ask-result') return;
     requests.serverMessage(msg);
+    if (msg.id === motifPendingId) {
+      // The Scratchpad's request is answered in its own strip: nothing of it reaches the Ask box, its draft or its not-sent message.
+      if (msg.status === 'received') {
+        arrivedMotif();
+      } else if (msg.status === 'waiting') {
+        // The server holds it until Claude's next Moontide call: it is no longer on its way, so the next motif may go, and the strip says it waits.
+        motifPendingId = null;
+        onMotifResult({ status: 'waiting' });
+      } else if (msg.status === 'refused') {
+        motifPendingId = null;
+        onMotifResult({ status: 'refused', text: refusalText(msg.reason, msg.detail) });
+      }
+      return;
+    }
     const fromParts = msg.id === partsPendingId;
     if (msg.status === 'refused') {
       reportError(refusalText(msg.reason, msg.detail));
@@ -485,6 +548,12 @@ export function createAskView({ document, send, reportError, clearError, setTime
    * says so, and the draft comes back (or, for the Parts button's canned request, the button is released).
    */
   function notConfirmed(id) {
+    if (id === motifPendingId) {
+      // The Scratchpad's strip says it; the Ask box and its draft are not involved.
+      motifPendingId = null;
+      onMotifResult({ status: 'not-confirmed' });
+      return;
+    }
     reportError(ASK_COPY.didNotConfirm);
     if (id === partsPendingId) {
       // The canned request needs no draft: the button just comes back.
@@ -500,6 +569,7 @@ export function createAskView({ document, send, reportError, clearError, setTime
     connected = state === 'connected';
     if (state === 'disconnected') {
       partsPendingId = null;
+      motifPendingId = null;
       // The state is unknown once the socket is gone (the page does not reconnect by itself).
       pageRequests.hidden = true;
       closeHelp();
@@ -531,6 +601,11 @@ export function createAskView({ document, send, reportError, clearError, setTime
     contains: (node) => askBox.contains(node),
     setConnected,
     setCurrentVersion,
+    sendMotif,
+    /** True while a motif request is on its way to the server. */
+    motifPending: () => motifPendingId !== null,
+    /** True while the page is connected to the server. */
+    isConnected: () => connected,
     setPartsAvailable,
     onServerMessage,
     notConfirmed,

package/page/ask.js

@@ -6,6 +6,7 @@
 import { BEATS_PER_CYCLE } from './change-timing.js';
 import { MAX_MOMENT_NOTES, MAX_RANGE_CYCLES } from './timeline.js';
 import { cleanText } from './structure.js';
+import { GRIDS, MAX_CYCLES, MIN_CYCLES, MOTIF_SOURCES, assertPhraseCode, cyclesText, notesText } from './scratch-model.js';
 
 /** Mirrors src/protocol.ts's MAX_ASK_TEXT_LENGTH by hand (test/ask.test.js checks both are 2000). */
 export const MAX_ASK_TEXT_LENGTH = 2000;
@@ -13,6 +14,12 @@ export const MAX_ASK_TEXT_LENGTH = 2000;
 /** Mirrors src/protocol.ts's MAX_REQUEST_LINE_BYTES by hand (test/ask.test.js checks both are 8192). */
 export const MAX_REQUEST_LINE_BYTES = 8192;
 
+/**
+ * Mirrors src/protocol.ts's MAX_MOTIF_PHRASE_LENGTH by hand (test/ask.test.js checks both are 8000). The motif's sources, grid ids, cycle bounds and
+ * phrase shape come from page/scratch-model.js, which src/protocol.ts mirrors by hand (the same test checks them).
+ */
+export const MAX_MOTIF_PHRASE_LENGTH = 8000;
+
 /** Mirrors src/ask.ts's REQUEST_LINE_PREFIX by hand (test/ask.test.js checks both). */
 export const REQUEST_LINE_PREFIX = 'Request from the Moontide page:';
 
@@ -379,14 +386,50 @@ function checkedMoment(kind, moment) {
   return { cycle: moment.cycle, beat: moment.beat, at: moment.at, version: moment.version, notes, more: moment.more };
 }
 
+/**
+ * A motif of a motif descriptor checked by the schema's rules (src/protocol.ts's askMotifShape) and copied field by field: the source, the cycle
+ * when there is one (a whole number of at least 0), the cycles, the grid, the notes count and the phrase, which must have the phrase shape. The
+ * phrase is never cut. A wrong value throws like every other context, so a bug is loud.
+ */
+function checkedMotif(motif) {
+  const bad = (field) => missing('motif', field);
+  if (motif === null || typeof motif !== 'object') throw bad('a motif');
+  const { source, cycle, cycles, grid, notes, phrase } = motif;
+  if (!MOTIF_SOURCES.includes(source)) throw bad(`a source of ${MOTIF_SOURCES.join(', ')}`);
+  if (cycle !== undefined && !isNonNegativeInteger(cycle)) throw bad('a whole number cycle of at least 0, or no cycle');
+  if (!Number.isInteger(cycles) || cycles < MIN_CYCLES || cycles > MAX_CYCLES) throw bad(`cycles as a whole number from ${MIN_CYCLES} to ${MAX_CYCLES}`);
+  if (!GRIDS.some((candidate) => candidate.id === grid)) throw bad(`a grid of ${GRIDS.map((candidate) => candidate.id).join(', ')}`);
+  if (!Number.isInteger(notes) || notes < 1) throw bad('a notes count of at least 1');
+  if (typeof phrase !== 'string' || phrase === '' || phrase.length > MAX_MOTIF_PHRASE_LENGTH) throw bad(`a phrase of 1 to ${MAX_MOTIF_PHRASE_LENGTH} characters`);
+  assertPhraseCode(phrase);
+  return { source, ...(cycle === undefined ? {} : { cycle }), cycles, grid, notes, phrase };
+}
+
+/**
+ * The chip of a motif context: the source, the cycles, the notes and, when there is a moment, its cycle, cut to the context limit. The
+ * motif is not checked here (describeContext checks it); the Ask view also uses this to measure the line of a motif it refuses.
+ */
+export function motifChip(motif) {
+  return cutText(`Motif${SEPARATOR}${motif.source}${SEPARATOR}${cyclesText(motif.cycles)}${SEPARATOR}${notesText(motif.notes)}${motif.cycle === undefined ? '' : `${SEPARATOR}at cycle ${motif.cycle}`}`);
+}
+
 /**
  * The size in bytes (UTF-8) of the line the server builds from one request: src/ask.ts's requestLine, the
  * prefix, a space and the JSON of the fields in the same order (U+2028 and U+2029 escaped), so the page can
  * tell before it sends whether the server will take the line.
  */
-export function requestLineBytes({ id, text, context, chip, current, moment, gesture }) {
-  // The moment, then the gesture, each only when there is one (the order of src/ask.ts's requestLine).
-  const fields = { id, text, context, chip, current, ...(moment === undefined ? {} : { moment }), ...(gesture === undefined ? {} : { gesture }) };
+export function requestLineBytes({ id, text, context, chip, current, moment, gesture, motif }) {
+  // The moment, then the gesture, then the motif, each only when there is one (the order of src/ask.ts's requestLine).
+  const fields = {
+    id,
+    text,
+    context,
+    chip,
+    current,
+    ...(moment === undefined ? {} : { moment }),
+    ...(gesture === undefined ? {} : { gesture }),
+    ...(motif === undefined ? {} : { motif }),
+  };
   const json = JSON.stringify(fields).replaceAll('\u2028', '\\u2028').replaceAll('\u2029', '\\u2029');
   return new TextEncoder().encode(`${REQUEST_LINE_PREFIX} ${json}`).length;
 }
@@ -504,6 +547,8 @@ export function describeContext(descriptor) {
   const kind = descriptor && descriptor.kind;
   let moment = descriptor ? descriptor.moment : undefined;
   let gesture = descriptor ? descriptor.gesture : undefined;
+  let motif;
+  if (kind !== 'motif' && descriptor && descriptor.motif !== undefined) throw new Error(`Moontide: ask context ${kind} cannot carry a motif`);
   // A moment is the Timeline's facts at the pointer: a lane, a part header over the lanes and the rest of the
   // Timeline (a session descriptor) carry one; nothing else does.
   if (moment !== undefined && kind !== 'lane' && kind !== 'part' && kind !== 'session') throw new Error(`Moontide: ask context ${kind} cannot carry a moment`);
@@ -743,9 +788,17 @@ export function describeContext(descriptor) {
       chip = `Group "${name}"${parent === undefined ? '' : `${SEPARATOR}in "${parent}"`}`;
       break;
     }
+    case 'motif': {
+      // A motif sent from the Scratchpad: the context is only the kind, the motif rides next to it and carries its own moment.
+      motif = checkedMotif(descriptor.motif);
+      context = { kind };
+      chip = motifChip(motif);
+      break;
+    }
     default:
       throw new Error(`Moontide: unknown ask context kind ${kind}`);
   }
+
   // A gesture is about one note of a lane: it rides only on a lane that carries a moment (the range gesture is the range
   // context's own and is checked in its case above).
   if (gesture !== undefined) {
@@ -753,7 +806,7 @@ export function describeContext(descriptor) {
     gesture = checkedGesture(gesture);
     if (gesture.kind === 'range') throw new Error('Moontide: a range gesture goes only with a range context');
   }
-  return { context, chip: cutText(chip), ...(moment === undefined ? {} : { moment }), ...(gesture === undefined ? {} : { gesture }) };
+  return { context, chip: cutText(chip), ...(moment === undefined ? {} : { moment }), ...(gesture === undefined ? {} : { gesture }), ...(motif === undefined ? {} : { motif }) };
 }
 
 /**

package/page/bar-model.js

@@ -30,6 +30,7 @@ export const BAR_COPY = Object.freeze({
   cardChange: 'Last change',
   rightClickHint: 'Right-click anything to ask Claude.',
   rightClickHintTitle: ASK_COPY.shiftRightClickTitle,
+  earlyNote: 'Early: Moontide is young and has known bugs.',
   midiHint: 'Instruments view: key 6.',
   settingsLabel: 'Your edits take over',
   timingNote: "Claude's changes say their own timing.",

package/page/index.html

@@ -63,6 +63,7 @@
         <span id="build-mismatch" class="bar-text" hidden></span>
         <span id="midi-takeover" class="bar-text" hidden><span id="midi-takeover-text"></span><button type="button" id="take-back"></button></span>
         <p class="session-hint" data-copy="rightClickHint"></p>
+        <p class="session-hint" data-copy="earlyNote"></p>
       </section>
       <section id="session-card-midi" class="session-card">
         <h2 class="session-card-title" data-copy="cardMidi"></h2>
@@ -108,6 +109,7 @@
       <div id="parts-view" hidden><p id="parts-message"></p><button type="button" id="parts-ask" hidden></button><p id="parts-ask-status" hidden></p><div id="song-notes" hidden></div><div id="song-bar" hidden><span id="song-launch-label"></span><div id="song-launch" role="group" aria-labelledby="song-launch-label"></div><p id="song-now" hidden></p></div><p id="song-line" hidden role="status" aria-live="polite"></p><div id="parts-rows"></div><div id="song-cell-list" hidden role="listbox" tabindex="-1"></div></div>
       <div id="jam-view" hidden><div id="jam-message" hidden><p id="jam-message-text"></p><p id="jam-message-sub" hidden></p></div><div id="jam-body" hidden><div id="jam-info"><p id="jam-declared" hidden><span id="jam-declared-label"></span><span id="jam-declared-value"></span><span id="jam-declared-section" hidden></span></p><div id="jam-scale"><span id="jam-scale-label" hidden></span><h2 id="jam-scale-name"></h2><p id="jam-scale-sub"></p></div><p id="jam-reason" aria-live="polite" hidden><strong id="jam-reason-lead"></strong><span id="jam-reason-rest"></span></p><div id="jam-candidates" role="group" aria-labelledby="jam-candidates-label" hidden><span id="jam-candidates-label"></span><div id="jam-candidate-list"></div><span id="jam-candidates-more" hidden></span></div><div id="jam-degrees" role="list"></div><div id="jam-status" role="status" aria-live="polite" hidden><p id="jam-status-text"><strong id="jam-status-lead"></strong><span id="jam-status-rest"></span></p><span id="jam-status-time" aria-hidden="true"></span><span id="jam-status-spoken"></span></div><p id="jam-paused" hidden></p><div id="jam-coming"><p id="jam-coming-caption"></p><div id="jam-rows"></div></div></div><div id="jam-instrument"><div id="jam-controls"><div id="jam-instrument-switch" role="group"><button type="button" id="jam-instrument-piano">Piano</button><button type="button" id="jam-instrument-guitar">Guitar</button></div><label id="jam-chord-tones-label"><input type="checkbox" id="jam-chord-tones"> <span id="jam-chord-tones-text"></span></label><div id="jam-legend"><span id="jam-legend-chord" class="jam-legend-entry" hidden></span></div></div><p id="jam-chord" hidden></p><div id="jam-board"><div id="jam-piano" role="img"></div><div id="jam-guitar" role="img" hidden></div></div></div></div></div>
       <div id="instruments-view" hidden tabindex="-1"><p id="instruments-notice" hidden></p><div id="instruments-message" hidden><p id="instruments-message-text"></p><code id="instruments-folder" hidden></code><p id="instruments-message-sub" hidden></p><ul id="instruments-problems" hidden></ul><p id="instruments-message-closing" hidden></p></div><div id="instruments-body" hidden><ul id="instruments-list" role="list" aria-label="Instruments"></ul><p id="instruments-footer"></p></div><span id="instruments-status" role="status" aria-live="polite"></span></div>
+      <div id="scratch-view" hidden role="region" aria-label="Scratchpad"><div id="scratch-controls" role="toolbar" aria-label="Scratchpad controls"><div id="scratch-grids" role="group" aria-label="Grid"><button type="button" id="scratch-grid-quarter" class="tl-btn" data-grid="quarter"></button><button type="button" id="scratch-grid-eighth" class="tl-btn" data-grid="eighth"></button><button type="button" id="scratch-grid-sixteenth" class="tl-btn" data-grid="sixteenth"></button><button type="button" id="scratch-grid-eighth-triplet" class="tl-btn" data-grid="eighth-triplet"></button><button type="button" id="scratch-grid-sixteenth-triplet" class="tl-btn" data-grid="sixteenth-triplet"></button></div><div id="scratch-length" role="group" aria-label="Length of the motif"><button type="button" id="scratch-fewer" class="tl-btn"></button><span id="scratch-cycles" class="sp-readout"></span><button type="button" id="scratch-more" class="tl-btn"></button></div><div id="scratch-pitch" role="group" aria-label="Pitch"><button type="button" id="scratch-lower" class="tl-btn"></button><span id="scratch-window" class="sp-readout" role="img"></span><button type="button" id="scratch-higher" class="tl-btn"></button></div><div id="scratch-mode" role="group" aria-label="Mode"><button type="button" id="scratch-draw" class="tl-btn" aria-pressed="false"></button><button type="button" id="scratch-tap" class="tl-btn" aria-pressed="false"></button></div><div id="scratch-edit" role="group" aria-label="Edit"><button type="button" id="scratch-earlier" class="tl-btn"></button><button type="button" id="scratch-later" class="tl-btn"></button><button type="button" id="scratch-align" class="tl-btn"></button><button type="button" id="scratch-clear" class="tl-btn"></button></div><div id="scratch-history" role="group" aria-label="Undo and redo"><button type="button" id="scratch-undo" class="tl-btn"></button><button type="button" id="scratch-redo" class="tl-btn"></button></div><div id="scratch-record-group" role="group" aria-label="Keyboard"><button type="button" id="scratch-record" class="tl-btn"></button></div><span id="scratch-early"></span></div><div id="scratch-scroll"><div id="scratch-ruler" aria-hidden="true"></div><div id="scratch-roll" tabindex="0" role="group" aria-label="Scratchpad piano roll" aria-describedby="scratch-hint"><div id="scratch-gutter" aria-hidden="true"></div><div id="scratch-grid"><div id="scratch-hover-cell" hidden></div><div id="scratch-select-rect" hidden aria-hidden="true"></div><div id="scratch-notes"></div><div id="scratch-live" aria-hidden="true"></div><div id="scratch-preview" hidden></div><div id="scratch-cursor" hidden></div><div id="scratch-now" hidden></div><div id="scratch-playhead" hidden aria-hidden="true"></div></div></div><div id="scratch-lane" tabindex="0" role="group" aria-label="Velocity of the notes" aria-describedby="scratch-hint"><div id="scratch-lane-label" aria-hidden="true"></div><div id="scratch-bars"></div></div></div><div id="scratch-note"><p id="scratch-note-line" role="status" aria-live="polite"><span id="scratch-note-shown" aria-hidden="true"><span id="scratch-note-name"></span><span id="scratch-note-rest"></span></span><span id="scratch-note-spoken"></span></p><p id="scratch-note-hover" hidden aria-hidden="true"></p><p id="scratch-hint"></p></div><div id="scratch-listen"><p id="scratch-listen-state" role="status" aria-live="polite"></p><button type="button" id="scratch-allow" class="tl-btn" hidden></button><p id="scratch-heard"></p></div><div id="scratch-play" role="group" aria-label="Hear the motif"><select id="scratch-play-output" aria-label="Instrument and channel"></select><div id="scratch-play-start" role="group" aria-label="Start"><button type="button" id="scratch-play-music" class="tl-btn" aria-pressed="true"></button><button type="button" id="scratch-play-now" class="tl-btn" aria-pressed="false"></button></div><button type="button" id="scratch-play-loop" class="tl-btn" aria-pressed="false"></button><button type="button" id="scratch-play-listen" class="tl-btn"></button><button type="button" id="scratch-play-stop" class="tl-btn"></button><p id="scratch-play-note" role="status" aria-live="polite"></p></div><div id="scratch-send"><code id="scratch-phrase" tabindex="0"></code><div id="scratch-send-row"><input type="text" id="scratch-words" autocomplete="off" spellcheck="false" /><button type="button" id="scratch-send-button" class="tl-btn"></button></div><p id="scratch-send-status" role="status" aria-live="polite"></p></div></div>
     </section>
   </div>
   <div id="ask-box" role="dialog" hidden><div id="ask-chips"><span id="ask-context-chip"></span><span id="ask-current-chip" hidden></span></div><textarea id="ask-field" rows="1" aria-describedby="ask-context-chip ask-hint"></textarea><p id="ask-message" hidden></p><p id="ask-hint"></p></div>

package/page/instruments-model.js

@@ -5,7 +5,7 @@
 // CONNECTION_LABELS (read at use time, so the popover, the top bar and this view never disagree). The DOM
 // side is page/instruments-view.js; page/main.js feeds the inputs.
 
-import { ACCESS_STATES, MIDI_COPY, fill, listNames, readMidiCalls } from './midi-plan.js';
+import { ACCESS_STATES, MIDI_COPY, fill, listNames, readMidiCalls, readMidiSetup } from './midi-plan.js';
 import { BUILD_MISMATCH_COPY, CONNECTION_LABELS } from './ui-state.js';
 import { midiTag, readMidiTracks } from './midi-controls.js';
 import { drumMapFor, soundKey } from './midi-rig.js';
@@ -59,6 +59,15 @@ export const INSTRUMENTS_COPY = Object.freeze({
   labelControlsHint: 'default values',
   labelCatalog: 'Catalog',
   labelInUse: 'In use',
+  // The Synth settings row of an instrument whose model describes settings: what the playing code writes, never stored.
+  labelSynthSettings: 'Synth settings',
+  synthTone: 'tone, ch {channel}: {values}',
+  synthPart: 'part, ch {channel}: {values}',
+  synthScene: 'scene: {values}, reaches every part',
+  synthValue: '{name} {value}',
+  synthValuesJoin: ', ',
+  synthNone: 'none in the code',
+  synthStays: 'A setting taken out of the code is not sent again: the instrument keeps its value until the instrument itself changes it, and a tone setting until the instrument loads the tone again. Moontide stores no setting.',
   clockFollows: 'follows the clock',
   controlsNone: 'none',
   catalogOne: '1 sound',
@@ -303,8 +312,9 @@ function readUse(code, parse, rig) {
   if (typeof parse !== 'function') return { kind: 'unreadable' };
   const tracks = readMidiTracks(code, { parse, rig });
   const calls = readMidiCalls(code, { parse });
-  if (!tracks.ok || !calls.ok) return { kind: 'unreadable' };
-  return { kind: 'read', tracks: [...tracks.tracks.values()], calls: calls.calls };
+  const setup = readMidiSetup(code, { parse });
+  if (!tracks.ok || !calls.ok || !setup.ok) return { kind: 'unreadable' };
+  return { kind: 'read', tracks: [...tracks.tracks.values()], calls: calls.calls, setups: setup.calls };
 }
 
 /**
@@ -337,6 +347,40 @@ function inUseOf(instrument, use) {
   return { lead: instrument.enabled === false ? INSTRUMENTS_COPY.silentWhileOff : null, lines, muted: false };
 }
 
+/**
+ * The Synth settings row of one instrument: null when its model describes no settings, else `{ lines: [{ text, muted }] }`
+ * read from the playing code. The lines are the tone and part settings per channel ascending (tone first), then the scene
+ * settings, taken from the calls whose port is exactly the instrument's port; the values stay in the order written and a
+ * later equal value merges. Without any, or without readable code, one muted line says so. The standing rule about a
+ * setting taken out of the code comes last. Nothing is stored: the row is the code.
+ */
+function synthSettingsOf(instrument, use) {
+  if (instrument.settings === null || instrument.settings === undefined) return null;
+  const staying = { text: INSTRUMENTS_COPY.synthStays, muted: true };
+  if (use.kind === 'unreadable') return { lines: [{ text: INSTRUMENTS_COPY.unreadableCode, muted: true }, staying] };
+  if (use.kind === 'empty') return { lines: [{ text: MIDI_COPY.rowNotUsed, muted: true }, staying] };
+  const channels = new Map();
+  const scene = new Map();
+  for (const call of use.setups) {
+    if (call.port !== instrument.port) continue;
+    if (!channels.has(call.channel)) channels.set(call.channel, { tone: new Map(), part: new Map() });
+    const level = channels.get(call.channel);
+    for (const [name, value] of call.settings.tone) level.tone.set(name, value);
+    for (const [name, value] of call.settings.part) level.part.set(name, value);
+    for (const [name, value] of call.settings.scene) scene.set(name, value);
+  }
+  const valuesOf = (map) => Array.from(map, ([name, value]) => fill(INSTRUMENTS_COPY.synthValue, { name, value: String(value) })).join(INSTRUMENTS_COPY.synthValuesJoin);
+  const lines = [];
+  for (const channel of [...channels.keys()].sort((a, b) => a - b)) {
+    const { tone, part } = channels.get(channel);
+    if (tone.size > 0) lines.push({ text: fill(INSTRUMENTS_COPY.synthTone, { channel: String(channel), values: valuesOf(tone) }), muted: false });
+    if (part.size > 0) lines.push({ text: fill(INSTRUMENTS_COPY.synthPart, { channel: String(channel), values: valuesOf(part) }), muted: false });
+  }
+  if (scene.size > 0) lines.push({ text: fill(INSTRUMENTS_COPY.synthScene, { values: valuesOf(scene) }), muted: false });
+  if (lines.length === 0) lines.push({ text: INSTRUMENTS_COPY.synthNone, muted: true });
+  return { lines: [...lines, staying] };
+}
+
 /** True when the instrument declares at least one channel with the rhythm role (the Drum kit row and Drum map line only exist then). */
 function hasRhythmChannel(instrument) {
   return instrument.channels.some((entry) => entry.role === 'rhythm');
@@ -558,6 +602,7 @@ function cardOf(instrument, liveInstruments, use) {
     modelChannels: modelChannelsOf(instrument),
     usedChannels: usedChannelsOf(instrument, use),
     inUse: inUseOf(instrument, use),
+    synthSettings: synthSettingsOf(instrument, use),
     drumKit: drumKitOf(instrument, use),
     drumMaps: drumMapsOf(instrument, use),
     drumDeclared: drumDeclaredOf(instrument),
@@ -717,6 +762,8 @@ function declaredFacts(card) {
     drumDeclared: card.drumDeclared,
     settings: card.settings,
     modelChannels: card.modelChannels,
+    // Whether the model describes settings decides whether the Synth settings row exists; its lines are live.
+    hasSynthSettings: card.synthSettings !== null,
   });
 }
 

package/page/instruments-view.js

@@ -208,6 +208,11 @@ export function createInstrumentsView({ document, onInstrumentSwitch, onInstrume
     return lines;
   }
 
+  /** The children of the Synth settings value: one line element per model line, the muted ones with the muted class. */
+  function synthSettingsLines(synthSettings) {
+    return synthSettings.lines.map((line) => element('span', line.muted ? 'instrument-inuse-line instrument-muted' : 'instrument-inuse-line', line.text));
+  }
+
   /** The lines of the Drum kit row: one span per line, muted when the model says so, with its hover title when it has one. */
   function drumKitLines(drumKit) {
     return drumKit.lines.map((line) => {
@@ -262,7 +267,7 @@ export function createInstrumentsView({ document, onInstrumentSwitch, onInstrume
 
   /** One card and the nodes a live redraw updates. The generated ids come from the index, never from user text. */
   function cardNode(card, index) {
-    const refs = { id: card.id, index, item: null, dot: null, words: null, inUse: null, drumKit: null, maps: null, opens: [], enabled: card.enabled, switchNodes: null, head: null, errorNode: null, editButton: null, editor: null };
+    const refs = { id: card.id, index, item: null, dot: null, words: null, inUse: null, synthSettings: null, drumKit: null, maps: null, opens: [], enabled: card.enabled, switchNodes: null, head: null, errorNode: null, editButton: null, editor: null };
     const item = element('li', 'instrument-card');
     refs.item = item;
     item.tabIndex = 0;
@@ -300,6 +305,12 @@ export function createInstrumentsView({ document, onInstrumentSwitch, onInstrume
     inUse.append(...inUseLines(card.inUse));
     refs.inUse = inUse;
     rows.append(row(INSTRUMENTS_COPY.labelInUse, inUse));
+    if (card.synthSettings !== null) {
+      const synth = element('div', 'instrument-lines');
+      synth.append(...synthSettingsLines(card.synthSettings));
+      refs.synthSettings = synth;
+      rows.append(row(INSTRUMENTS_COPY.labelSynthSettings, synth));
+    }
     item.append(head, rows, editButtonNode(card, refs));
     drawError(refs);
     // An editor that was open (a draft kept in memory) comes back with the card.
@@ -766,7 +777,7 @@ export function createInstrumentsView({ document, onInstrumentSwitch, onInstrume
     instrumentsBody.scrollTop = scrollTop;
   }
 
-  /** Updates the changed parts of each card in place: the dot, the state words, the Drum kit lines, the In use lines and the Drum map lines. */
+  /** Updates the changed parts of each card in place: the dot, the state words, the Drum kit lines, the In use lines, the Synth settings lines and the Drum map lines. */
   function updateCards(previous, model, skip = []) {
     model.cards.forEach((card, index) => {
       if (skip.includes(index)) return;
@@ -786,6 +797,7 @@ export function createInstrumentsView({ document, onInstrumentSwitch, onInstrume
       setText(refs.words, card.port.words);
       if (card.port.attention !== before.port.attention) refs.words.dataset.attention = String(card.port.attention);
       if (JSON.stringify(card.inUse) !== JSON.stringify(before.inUse)) refs.inUse.replaceChildren(...inUseLines(card.inUse));
+      if (card.synthSettings !== null && JSON.stringify(card.synthSettings) !== JSON.stringify(before.synthSettings)) refs.synthSettings.replaceChildren(...synthSettingsLines(card.synthSettings));
       if (card.drumKit !== null && JSON.stringify(card.drumKit) !== JSON.stringify(before.drumKit)) refs.drumKit.replaceChildren(...drumKitLines(card.drumKit));
       if (card.drumMaps !== null && JSON.stringify(card.drumMaps) !== JSON.stringify(before.drumMaps)) {
         // The drawn flags are read first and the focus noted, because the nodes are replaced: a map that stays keeps its state.