@k-l-lambda/lilylet 0.1.58 → 0.1.59

package/lib/lilylet/lilypondDecoder.js

@@ -451,7 +451,8 @@ const parseLilyDocument = (lilyDocument) => {
                 // Update key/time from context on music events
                 if (term instanceof lilyParser.MusicEvent ||
                     term instanceof lilyParser.LilyTerms.StemDirection ||
-                    term instanceof lilyParser.LilyTerms.OctaveShift) {
+                    term instanceof lilyParser.LilyTerms.OctaveShift ||
+                    term instanceof lilyParser.LilyTerms.Change) {
                     if (context.key && measure.key === null) {
                         measure.key = context.key.key;
                     }
@@ -626,10 +627,21 @@ const parseLilyDocument = (lilyDocument) => {
                         lastOttava = term.value;
                     }
                 }
-                // Handle staff change
+                // Handle staff change (\change Staff = "N")
+                // args[0] is Assignment { key: "Staff", value: { exp: '"N"' } }
                 else if (term instanceof lilyParser.LilyTerms.Change) {
-                    // Ignore \change Staff commands - staff is fixed per track
-                    // (Cross-staff notation is not supported in this decoder)
+                    const assignment = term.args?.[0];
+                    if (assignment?.key === 'Staff') {
+                        // exp is like '"2"' — strip surrounding quotes then parse strictly
+                        const exp = assignment?.value?.exp ?? '';
+                        const raw = exp.replace(/^"|"$/g, '');
+                        // Only accept pure integer staff names (e.g. "1", "2")
+                        // Reject compound names like "1_2", "RH", "LH"
+                        const staffNum = /^\d+$/.test(raw) ? parseInt(raw, 10) : NaN;
+                        if (!isNaN(staffNum)) {
+                            voice.events.push({ type: 'context', staff: staffNum });
+                        }
+                    }
                 }
                 // Handle tempo
                 else if (term instanceof lilyParser.LilyTerms.Tempo) {

package/lib/lilylet/serializer.js

@@ -439,10 +439,13 @@ const serializeEvent = (event, env, prevDuration) => {
 };
 // Find first clef in voice events
 const findVoiceClef = (voice) => {
+    let activeStaff = voice.staff;
     for (const event of voice.events) {
         if (event.type === 'context') {
             const ctx = event;
-            if (ctx.clef) {
+            if (ctx.staff)
+                activeStaff = ctx.staff;
+            if (ctx.clef && activeStaff === voice.staff) {
                 return ctx.clef;
             }
         }
@@ -504,10 +507,17 @@ const serializeVoice = (voice, currentStaff, isGrandStaff = false, measureContex
             if (ctx.staff && ctx.staff !== activeStaff) {
                 activeStaff = ctx.staff;
                 parts.push('\\staff "' + activeStaff + '"');
+                // Emit target staff clef if the event carries one or allStaffClefs knows it
+                const ctxClef = ctx.clef || allStaffClefs?.[activeStaff];
+                if (ctxClef && emittedClefs?.[activeStaff] !== ctxClef) {
+                    parts.push('\\clef "' + CLEF_MAP[ctxClef] + '"');
+                    if (emittedClefs)
+                        emittedClefs[activeStaff] = ctxClef;
+                }
                 continue;
             }
             if (ctx.staff)
-                continue; // same staff, no-op
+                continue; // same staff, no-op for staff field; clef handled below
             // Skip clef-only context events if clef already established for this staff
             if (clefOutputted && ctx.clef && !ctx.key && !ctx.time && !ctx.ottava && !ctx.stemDirection && !ctx.tempo) {
                 continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-l-lambda/lilylet",
-  "version": "0.1.58",
+  "version": "0.1.59",
   "description": "Lilylet is a lilyopnd-like sheet music language designed for Markdown rendering and symbolic music representation in AIGC applications.",
   "type": "module",
   "main": "lib/index.js",

package/source/lilylet/lilypondDecoder.ts

@@ -556,7 +556,8 @@ const parseLilyDocument = (lilyDocument: lilyParser.LilyDocument): ParsedMeasure
 				// Update key/time from context on music events
 				if (term instanceof lilyParser.MusicEvent ||
 					term instanceof lilyParser.LilyTerms.StemDirection ||
-					term instanceof lilyParser.LilyTerms.OctaveShift) {
+					term instanceof lilyParser.LilyTerms.OctaveShift ||
+					term instanceof lilyParser.LilyTerms.Change) {
 
 					if (context.key && measure.key === null) {
 						measure.key = context.key.key;
@@ -750,10 +751,21 @@ const parseLilyDocument = (lilyDocument: lilyParser.LilyDocument): ParsedMeasure
 						lastOttava = term.value;
 					}
 				}
-				// Handle staff change
+				// Handle staff change (\change Staff = "N")
+				// args[0] is Assignment { key: "Staff", value: { exp: '"N"' } }
 				else if (term instanceof lilyParser.LilyTerms.Change) {
-					// Ignore \change Staff commands - staff is fixed per track
-					// (Cross-staff notation is not supported in this decoder)
+					const assignment = (term as any).args?.[0];
+					if (assignment?.key === 'Staff') {
+						// exp is like '"2"' — strip surrounding quotes then parse strictly
+						const exp: string = assignment?.value?.exp ?? '';
+						const raw = exp.replace(/^"|"$/g, '');
+						// Only accept pure integer staff names (e.g. "1", "2")
+						// Reject compound names like "1_2", "RH", "LH"
+						const staffNum = /^\d+$/.test(raw) ? parseInt(raw, 10) : NaN;
+						if (!isNaN(staffNum)) {
+							voice.events.push({ type: 'context', staff: staffNum } as any);
+						}
+					}
 				}
 				// Handle tempo
 				else if (term instanceof lilyParser.LilyTerms.Tempo) {

package/source/lilylet/serializer.ts

@@ -574,10 +574,12 @@ interface MeasureContext {
 
 // Find first clef in voice events
 const findVoiceClef = (voice: Voice): Clef | undefined => {
+	let activeStaff = voice.staff;
 	for (const event of voice.events) {
 		if (event.type === 'context') {
 			const ctx = event as ContextChange;
-			if (ctx.clef) {
+			if (ctx.staff) activeStaff = ctx.staff;
+			if (ctx.clef && activeStaff === voice.staff) {
 				return ctx.clef;
 			}
 		}
@@ -652,9 +654,15 @@ const serializeVoice = (
 			if (ctx.staff && ctx.staff !== activeStaff) {
 				activeStaff = ctx.staff;
 				parts.push('\\staff "' + activeStaff + '"');
+				// Emit target staff clef if the event carries one or allStaffClefs knows it
+				const ctxClef = ctx.clef || allStaffClefs?.[activeStaff];
+				if (ctxClef && emittedClefs?.[activeStaff] !== ctxClef) {
+					parts.push('\\clef "' + CLEF_MAP[ctxClef] + '"');
+					if (emittedClefs) emittedClefs[activeStaff] = ctxClef;
+				}
 				continue;
 			}
-			if (ctx.staff) continue;  // same staff, no-op
+			if (ctx.staff) continue;  // same staff, no-op for staff field; clef handled below
 			// Skip clef-only context events if clef already established for this staff
 			if (clefOutputted && ctx.clef && !ctx.key && !ctx.time && !ctx.ottava && !ctx.stemDirection && !ctx.tempo) {
 				continue;