@k-l-lambda/lilylet 0.1.37 → 0.1.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.d.ts CHANGED
@@ -4,4 +4,5 @@ export * from "./serializer";
4
4
  import * as meiEncoder from "./meiEncoder";
5
5
  import * as musicXmlDecoder from "./musicXmlDecoder";
6
6
  import * as lilypondEncoder from "./lilypondEncoder";
7
- export { meiEncoder, musicXmlDecoder, lilypondEncoder, };
7
+ import * as musicXmlEncoder from "./musicXmlEncoder";
8
+ export { meiEncoder, musicXmlDecoder, lilypondEncoder, musicXmlEncoder, };
package/lib/index.js CHANGED
@@ -4,4 +4,5 @@ export * from "./serializer.js";
4
4
  import * as meiEncoder from "./meiEncoder.js";
5
5
  import * as musicXmlDecoder from "./musicXmlDecoder.js";
6
6
  import * as lilypondEncoder from "./lilypondEncoder.js";
7
- export { meiEncoder, musicXmlDecoder, lilypondEncoder, };
7
+ import * as musicXmlEncoder from "./musicXmlEncoder.js";
8
+ export { meiEncoder, musicXmlDecoder, lilypondEncoder, musicXmlEncoder, };
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Lilylet to MusicXML Encoder
3
+ *
4
+ * Converts LilyletDoc to MusicXML format.
5
+ * Produces valid MusicXML 4.0 partwise documents.
6
+ */
7
+ import { LilyletDoc } from "./types";
8
+ /**
9
+ * Encode complete LilyletDoc to MusicXML
10
+ */
11
+ export declare const encode: (doc: LilyletDoc) => string;
12
+ declare const _default: {
13
+ encode: (doc: LilyletDoc) => string;
14
+ };
15
+ export default _default;
@@ -0,0 +1,666 @@
1
+ /**
2
+ * Lilylet to MusicXML Encoder
3
+ *
4
+ * Converts LilyletDoc to MusicXML format.
5
+ * Produces valid MusicXML 4.0 partwise documents.
6
+ */
7
+ import { StemDirection, Accidental, HairpinType, PedalType, } from "./types.js";
8
+ // === Constants and Reverse Mappings ===
9
+ // Standard divisions per quarter note
10
+ const DIVISIONS = 4;
11
+ // Phonet to MusicXML step
12
+ const PHONET_TO_STEP = {
13
+ c: 'C',
14
+ d: 'D',
15
+ e: 'E',
16
+ f: 'F',
17
+ g: 'G',
18
+ a: 'A',
19
+ b: 'B',
20
+ };
21
+ // Accidental to MusicXML alter
22
+ const ACCIDENTAL_TO_ALTER = {
23
+ sharp: 1,
24
+ flat: -1,
25
+ doubleSharp: 2,
26
+ doubleFlat: -2,
27
+ natural: 0,
28
+ };
29
+ // Division to MusicXML note type
30
+ const DIVISION_TO_TYPE = {
31
+ 0.5: 'breve',
32
+ 1: 'whole',
33
+ 2: 'half',
34
+ 4: 'quarter',
35
+ 8: 'eighth',
36
+ 16: '16th',
37
+ 32: '32nd',
38
+ 64: '64th',
39
+ 128: '128th',
40
+ };
41
+ // Key signature to fifths (major keys)
42
+ const KEY_TO_FIFTHS = {
43
+ 'c': 0,
44
+ 'g': 1,
45
+ 'd': 2,
46
+ 'a': 3,
47
+ 'e': 4,
48
+ 'b': 5,
49
+ 'f#': 6, 'fs': 6,
50
+ 'c#': 7, 'cs': 7,
51
+ 'f': -1,
52
+ 'bb': -2, 'bf': -2,
53
+ 'eb': -3, 'ef': -3,
54
+ 'ab': -4, 'af': -4,
55
+ 'db': -5, 'df': -5,
56
+ 'gb': -6, 'gf': -6,
57
+ 'cb': -7, 'cf': -7,
58
+ };
59
+ // Clef to MusicXML sign
60
+ const CLEF_TO_SIGN = {
61
+ treble: { sign: 'G', line: 2 },
62
+ bass: { sign: 'F', line: 4 },
63
+ alto: { sign: 'C', line: 3 },
64
+ };
65
+ // Articulation to MusicXML element name
66
+ const ARTICULATION_TO_XML = {
67
+ staccato: 'staccato',
68
+ staccatissimo: 'staccatissimo',
69
+ tenuto: 'tenuto',
70
+ accent: 'accent',
71
+ marcato: 'strong-accent',
72
+ portato: 'detached-legato',
73
+ };
74
+ // Ornament to MusicXML element name
75
+ const ORNAMENT_TO_XML = {
76
+ trill: 'trill-mark',
77
+ turn: 'turn',
78
+ mordent: 'mordent',
79
+ prall: 'inverted-mordent',
80
+ };
81
+ // Dynamic to MusicXML element name
82
+ const DYNAMIC_TO_XML = {
83
+ ppp: 'ppp',
84
+ pp: 'pp',
85
+ p: 'p',
86
+ mp: 'mp',
87
+ mf: 'mf',
88
+ f: 'f',
89
+ ff: 'ff',
90
+ fff: 'fff',
91
+ sfz: 'sfz',
92
+ rfz: 'rfz',
93
+ };
94
+ // Barline style to MusicXML
95
+ const BARLINE_TO_XML = {
96
+ '|': { barStyle: 'regular' },
97
+ '||': { barStyle: 'light-light' },
98
+ '|.': { barStyle: 'light-heavy' },
99
+ '.|:': { barStyle: 'heavy-light', repeat: 'forward' },
100
+ ':|.': { barStyle: 'light-heavy', repeat: 'backward' },
101
+ ':..:': { barStyle: 'light-heavy', repeat: 'backward' }, // Will need special handling
102
+ };
103
+ // === XML Helper Functions ===
104
+ const escapeXml = (text) => {
105
+ return text
106
+ .replace(/&/g, '&')
107
+ .replace(/</g, '&lt;')
108
+ .replace(/>/g, '&gt;')
109
+ .replace(/"/g, '&quot;')
110
+ .replace(/'/g, '&apos;');
111
+ };
112
+ const indent = (level) => ' '.repeat(level);
113
+ // === Encoding Functions ===
114
+ /**
115
+ * Calculate duration in MusicXML divisions
116
+ */
117
+ const calculateDuration = (duration) => {
118
+ // Base duration: DIVISIONS * (4 / division)
119
+ // e.g., quarter (4) = DIVISIONS * 1 = 4
120
+ // half (2) = DIVISIONS * 2 = 8
121
+ // eighth (8) = DIVISIONS * 0.5 = 2
122
+ let dur = DIVISIONS * (4 / duration.division);
123
+ // Apply dots
124
+ if (duration.dots) {
125
+ let dotValue = dur / 2;
126
+ for (let i = 0; i < duration.dots; i++) {
127
+ dur += dotValue;
128
+ dotValue /= 2;
129
+ }
130
+ }
131
+ // Apply tuplet ratio
132
+ if (duration.tuplet) {
133
+ dur = dur * duration.tuplet.denominator / duration.tuplet.numerator;
134
+ }
135
+ return Math.round(dur);
136
+ };
137
+ /**
138
+ * Encode pitch to MusicXML
139
+ */
140
+ const encodePitch = (pitch, level) => {
141
+ const step = PHONET_TO_STEP[pitch.phonet] || 'C';
142
+ const octave = pitch.octave + 4; // Lilylet octave 0 = MusicXML octave 4
143
+ const alter = pitch.accidental ? ACCIDENTAL_TO_ALTER[pitch.accidental] : undefined;
144
+ let xml = `${indent(level)}<pitch>\n`;
145
+ xml += `${indent(level + 1)}<step>${step}</step>\n`;
146
+ if (alter !== undefined && alter !== 0) {
147
+ xml += `${indent(level + 1)}<alter>${alter}</alter>\n`;
148
+ }
149
+ xml += `${indent(level + 1)}<octave>${octave}</octave>\n`;
150
+ xml += `${indent(level)}</pitch>\n`;
151
+ return xml;
152
+ };
153
+ /**
154
+ * Encode duration elements
155
+ */
156
+ const encodeDuration = (duration, level) => {
157
+ const dur = calculateDuration(duration);
158
+ const type = DIVISION_TO_TYPE[duration.division] || 'quarter';
159
+ let xml = `${indent(level)}<duration>${dur}</duration>\n`;
160
+ xml += `${indent(level)}<type>${type}</type>\n`;
161
+ for (let i = 0; i < duration.dots; i++) {
162
+ xml += `${indent(level)}<dot/>\n`;
163
+ }
164
+ if (duration.tuplet) {
165
+ xml += `${indent(level)}<time-modification>\n`;
166
+ xml += `${indent(level + 1)}<actual-notes>${duration.tuplet.numerator}</actual-notes>\n`;
167
+ xml += `${indent(level + 1)}<normal-notes>${duration.tuplet.denominator}</normal-notes>\n`;
168
+ xml += `${indent(level)}</time-modification>\n`;
169
+ }
170
+ return xml;
171
+ };
172
+ /**
173
+ * Encode key signature to fifths
174
+ */
175
+ const getKeyFifths = (key) => {
176
+ let keyStr = key.pitch;
177
+ if (key.accidental === Accidental.sharp) {
178
+ keyStr += 's';
179
+ }
180
+ else if (key.accidental === Accidental.flat) {
181
+ keyStr += 'f';
182
+ }
183
+ let fifths = KEY_TO_FIFTHS[keyStr.toLowerCase()] ?? 0;
184
+ // Adjust for minor mode (relative minor is 3 fifths down)
185
+ if (key.mode === 'minor') {
186
+ // Minor keys have same fifths as their relative major
187
+ // e.g., A minor = C major = 0 fifths
188
+ }
189
+ return fifths;
190
+ };
191
+ /**
192
+ * Encode attributes element (key, time, clef, divisions)
193
+ */
194
+ const encodeAttributes = (level, options) => {
195
+ let xml = `${indent(level)}<attributes>\n`;
196
+ if (options.divisions) {
197
+ xml += `${indent(level + 1)}<divisions>${DIVISIONS}</divisions>\n`;
198
+ }
199
+ if (options.key) {
200
+ const fifths = getKeyFifths(options.key);
201
+ xml += `${indent(level + 1)}<key>\n`;
202
+ xml += `${indent(level + 2)}<fifths>${fifths}</fifths>\n`;
203
+ xml += `${indent(level + 2)}<mode>${options.key.mode}</mode>\n`;
204
+ xml += `${indent(level + 1)}</key>\n`;
205
+ }
206
+ if (options.time) {
207
+ xml += `${indent(level + 1)}<time>\n`;
208
+ xml += `${indent(level + 2)}<beats>${options.time.numerator}</beats>\n`;
209
+ xml += `${indent(level + 2)}<beat-type>${options.time.denominator}</beat-type>\n`;
210
+ xml += `${indent(level + 1)}</time>\n`;
211
+ }
212
+ if (options.staves && options.staves > 1) {
213
+ xml += `${indent(level + 1)}<staves>${options.staves}</staves>\n`;
214
+ }
215
+ if (options.clef) {
216
+ const clefInfo = CLEF_TO_SIGN[options.clef];
217
+ if (clefInfo) {
218
+ xml += `${indent(level + 1)}<clef>\n`;
219
+ xml += `${indent(level + 2)}<sign>${clefInfo.sign}</sign>\n`;
220
+ xml += `${indent(level + 2)}<line>${clefInfo.line}</line>\n`;
221
+ xml += `${indent(level + 1)}</clef>\n`;
222
+ }
223
+ }
224
+ xml += `${indent(level)}</attributes>\n`;
225
+ return xml;
226
+ };
227
+ /**
228
+ * Encode notations (articulations, ornaments, ties, slurs, etc.)
229
+ */
230
+ const encodeNotations = (marks, level) => {
231
+ const articulations = [];
232
+ const ornaments = [];
233
+ const otherNotations = [];
234
+ for (const mark of marks) {
235
+ switch (mark.markType) {
236
+ case 'articulation':
237
+ const artXml = ARTICULATION_TO_XML[mark.type];
238
+ if (artXml) {
239
+ articulations.push(`<${artXml}/>`);
240
+ }
241
+ break;
242
+ case 'ornament':
243
+ const ornXml = ORNAMENT_TO_XML[mark.type];
244
+ if (ornXml) {
245
+ if (mark.type === 'fermata') {
246
+ otherNotations.push('<fermata/>');
247
+ }
248
+ else if (mark.type === 'arpeggio') {
249
+ otherNotations.push('<arpeggiate/>');
250
+ }
251
+ else {
252
+ ornaments.push(`<${ornXml}/>`);
253
+ }
254
+ }
255
+ break;
256
+ case 'tie':
257
+ otherNotations.push(`<tied type="${mark.start ? 'start' : 'stop'}"/>`);
258
+ break;
259
+ case 'slur':
260
+ otherNotations.push(`<slur type="${mark.start ? 'start' : 'stop'}" number="1"/>`);
261
+ break;
262
+ case 'fingering':
263
+ // Fingering goes in technical
264
+ break;
265
+ }
266
+ }
267
+ if (articulations.length === 0 && ornaments.length === 0 && otherNotations.length === 0) {
268
+ return '';
269
+ }
270
+ let xml = `${indent(level)}<notations>\n`;
271
+ for (const notation of otherNotations) {
272
+ xml += `${indent(level + 1)}${notation}\n`;
273
+ }
274
+ if (articulations.length > 0) {
275
+ xml += `${indent(level + 1)}<articulations>\n`;
276
+ for (const art of articulations) {
277
+ xml += `${indent(level + 2)}${art}\n`;
278
+ }
279
+ xml += `${indent(level + 1)}</articulations>\n`;
280
+ }
281
+ if (ornaments.length > 0) {
282
+ xml += `${indent(level + 1)}<ornaments>\n`;
283
+ for (const orn of ornaments) {
284
+ xml += `${indent(level + 2)}${orn}\n`;
285
+ }
286
+ xml += `${indent(level + 1)}</ornaments>\n`;
287
+ }
288
+ xml += `${indent(level)}</notations>\n`;
289
+ return xml;
290
+ };
291
+ /**
292
+ * Encode a note event
293
+ */
294
+ const encodeNote = (event, voice, staff, level, isChord = false) => {
295
+ let xml = `${indent(level)}<note>\n`;
296
+ if (isChord) {
297
+ xml += `${indent(level + 1)}<chord/>\n`;
298
+ }
299
+ if (event.grace) {
300
+ xml += `${indent(level + 1)}<grace/>\n`;
301
+ }
302
+ // Pitch (use first pitch, additional pitches become chord notes)
303
+ const pitch = isChord ? event.pitches[0] : event.pitches[0];
304
+ xml += encodePitch(pitch, level + 1);
305
+ // Duration (not for grace notes)
306
+ if (!event.grace) {
307
+ xml += encodeDuration(event.duration, level + 1);
308
+ }
309
+ else {
310
+ // Grace notes still need type
311
+ const type = DIVISION_TO_TYPE[event.duration.division] || 'eighth';
312
+ xml += `${indent(level + 1)}<type>${type}</type>\n`;
313
+ }
314
+ // Tie notation in note element
315
+ const hasTieStart = event.marks?.some(m => m.markType === 'tie' && m.start);
316
+ const hasTieStop = event.marks?.some(m => m.markType === 'tie' && !m.start);
317
+ if (hasTieStart) {
318
+ xml += `${indent(level + 1)}<tie type="start"/>\n`;
319
+ }
320
+ if (hasTieStop) {
321
+ xml += `${indent(level + 1)}<tie type="stop"/>\n`;
322
+ }
323
+ // Voice
324
+ xml += `${indent(level + 1)}<voice>${voice}</voice>\n`;
325
+ // Staff (for grand staff)
326
+ if (staff > 0) {
327
+ xml += `${indent(level + 1)}<staff>${staff}</staff>\n`;
328
+ }
329
+ // Stem direction
330
+ if (event.stemDirection && event.stemDirection !== StemDirection.auto) {
331
+ xml += `${indent(level + 1)}<stem>${event.stemDirection}</stem>\n`;
332
+ }
333
+ // Beam marks
334
+ const beamStart = event.marks?.find(m => m.markType === 'beam' && m.start);
335
+ const beamEnd = event.marks?.find(m => m.markType === 'beam' && !m.start);
336
+ if (beamStart) {
337
+ xml += `${indent(level + 1)}<beam number="1">begin</beam>\n`;
338
+ }
339
+ else if (beamEnd) {
340
+ xml += `${indent(level + 1)}<beam number="1">end</beam>\n`;
341
+ }
342
+ // Notations
343
+ if (event.marks && event.marks.length > 0) {
344
+ xml += encodeNotations(event.marks, level + 1);
345
+ }
346
+ xml += `${indent(level)}</note>\n`;
347
+ return xml;
348
+ };
349
+ /**
350
+ * Encode a rest event
351
+ */
352
+ const encodeRest = (event, voice, staff, level) => {
353
+ let xml = `${indent(level)}<note>\n`;
354
+ xml += `${indent(level + 1)}<rest`;
355
+ if (event.fullMeasure) {
356
+ xml += ' measure="yes"';
357
+ }
358
+ xml += '/>\n';
359
+ xml += encodeDuration(event.duration, level + 1);
360
+ xml += `${indent(level + 1)}<voice>${voice}</voice>\n`;
361
+ if (staff > 0) {
362
+ xml += `${indent(level + 1)}<staff>${staff}</staff>\n`;
363
+ }
364
+ xml += `${indent(level)}</note>\n`;
365
+ return xml;
366
+ };
367
+ /**
368
+ * Encode direction element (dynamics, tempo, etc.)
369
+ */
370
+ const encodeDirection = (marks, level) => {
371
+ let xml = '';
372
+ for (const mark of marks) {
373
+ if (mark.markType === 'dynamic') {
374
+ const dynXml = DYNAMIC_TO_XML[mark.type];
375
+ if (dynXml) {
376
+ xml += `${indent(level)}<direction placement="below">\n`;
377
+ xml += `${indent(level + 1)}<direction-type>\n`;
378
+ xml += `${indent(level + 2)}<dynamics>\n`;
379
+ xml += `${indent(level + 3)}<${dynXml}/>\n`;
380
+ xml += `${indent(level + 2)}</dynamics>\n`;
381
+ xml += `${indent(level + 1)}</direction-type>\n`;
382
+ xml += `${indent(level)}</direction>\n`;
383
+ }
384
+ }
385
+ else if (mark.markType === 'hairpin') {
386
+ let wedgeType = '';
387
+ if (mark.type === HairpinType.crescendoStart) {
388
+ wedgeType = 'crescendo';
389
+ }
390
+ else if (mark.type === HairpinType.diminuendoStart) {
391
+ wedgeType = 'diminuendo';
392
+ }
393
+ else if (mark.type === HairpinType.crescendoEnd || mark.type === HairpinType.diminuendoEnd) {
394
+ wedgeType = 'stop';
395
+ }
396
+ if (wedgeType) {
397
+ xml += `${indent(level)}<direction>\n`;
398
+ xml += `${indent(level + 1)}<direction-type>\n`;
399
+ xml += `${indent(level + 2)}<wedge type="${wedgeType}"/>\n`;
400
+ xml += `${indent(level + 1)}</direction-type>\n`;
401
+ xml += `${indent(level)}</direction>\n`;
402
+ }
403
+ }
404
+ else if (mark.markType === 'pedal') {
405
+ let pedalType = '';
406
+ if (mark.type === PedalType.sustainOn) {
407
+ pedalType = 'start';
408
+ }
409
+ else if (mark.type === PedalType.sustainOff) {
410
+ pedalType = 'stop';
411
+ }
412
+ if (pedalType) {
413
+ xml += `${indent(level)}<direction>\n`;
414
+ xml += `${indent(level + 1)}<direction-type>\n`;
415
+ xml += `${indent(level + 2)}<pedal type="${pedalType}"/>\n`;
416
+ xml += `${indent(level + 1)}</direction-type>\n`;
417
+ xml += `${indent(level)}</direction>\n`;
418
+ }
419
+ }
420
+ }
421
+ return xml;
422
+ };
423
+ /**
424
+ * Encode tempo marking
425
+ */
426
+ const encodeTempo = (tempo, level) => {
427
+ let xml = `${indent(level)}<direction placement="above">\n`;
428
+ xml += `${indent(level + 1)}<direction-type>\n`;
429
+ if (tempo.beat && tempo.bpm) {
430
+ xml += `${indent(level + 2)}<metronome>\n`;
431
+ const beatUnit = DIVISION_TO_TYPE[tempo.beat.division] || 'quarter';
432
+ xml += `${indent(level + 3)}<beat-unit>${beatUnit}</beat-unit>\n`;
433
+ if (tempo.beat.dots) {
434
+ for (let i = 0; i < tempo.beat.dots; i++) {
435
+ xml += `${indent(level + 3)}<beat-unit-dot/>\n`;
436
+ }
437
+ }
438
+ xml += `${indent(level + 3)}<per-minute>${tempo.bpm}</per-minute>\n`;
439
+ xml += `${indent(level + 2)}</metronome>\n`;
440
+ }
441
+ if (tempo.text) {
442
+ xml += `${indent(level + 2)}<words>${escapeXml(tempo.text)}</words>\n`;
443
+ }
444
+ xml += `${indent(level + 1)}</direction-type>\n`;
445
+ if (tempo.bpm) {
446
+ xml += `${indent(level + 1)}<sound tempo="${tempo.bpm}"/>\n`;
447
+ }
448
+ xml += `${indent(level)}</direction>\n`;
449
+ return xml;
450
+ };
451
+ /**
452
+ * Encode barline
453
+ */
454
+ const encodeBarline = (event, level) => {
455
+ const barInfo = BARLINE_TO_XML[event.style];
456
+ if (!barInfo || event.style === '|') {
457
+ return ''; // Regular barline, no need to encode
458
+ }
459
+ let xml = `${indent(level)}<barline location="right">\n`;
460
+ xml += `${indent(level + 1)}<bar-style>${barInfo.barStyle}</bar-style>\n`;
461
+ if (barInfo.repeat) {
462
+ xml += `${indent(level + 1)}<repeat direction="${barInfo.repeat}"/>\n`;
463
+ }
464
+ xml += `${indent(level)}</barline>\n`;
465
+ return xml;
466
+ };
467
+ /**
468
+ * Encode harmony (chord symbol)
469
+ */
470
+ const encodeHarmony = (event, level) => {
471
+ // Simple text-based harmony for now
472
+ let xml = `${indent(level)}<harmony>\n`;
473
+ xml += `${indent(level + 1)}<root>\n`;
474
+ xml += `${indent(level + 2)}<root-step>C</root-step>\n`; // Placeholder
475
+ xml += `${indent(level + 1)}</root>\n`;
476
+ xml += `${indent(level + 1)}<kind text="${escapeXml(event.text)}">major</kind>\n`;
477
+ xml += `${indent(level)}</harmony>\n`;
478
+ return xml;
479
+ };
480
+ /**
481
+ * Encode a complete measure
482
+ */
483
+ const encodeMeasure = (measure, measureNumber, isFirst, prevKey, prevTime, level) => {
484
+ let xml = `${indent(level)}<measure number="${measureNumber}">\n`;
485
+ // Determine if we need attributes
486
+ const needAttributes = isFirst ||
487
+ (measure.key && JSON.stringify(measure.key) !== JSON.stringify(prevKey)) ||
488
+ (measure.timeSig && JSON.stringify(measure.timeSig) !== JSON.stringify(prevTime));
489
+ // Find max staff number
490
+ let maxStaff = 1;
491
+ for (const part of measure.parts) {
492
+ for (const voice of part.voices) {
493
+ maxStaff = Math.max(maxStaff, voice.staff || 1);
494
+ }
495
+ }
496
+ // Encode attributes if needed
497
+ if (needAttributes) {
498
+ // Find clef from first voice
499
+ let clef;
500
+ for (const part of measure.parts) {
501
+ for (const voice of part.voices) {
502
+ for (const event of voice.events) {
503
+ if (event.type === 'context' && event.clef) {
504
+ clef = event.clef;
505
+ break;
506
+ }
507
+ }
508
+ if (clef)
509
+ break;
510
+ }
511
+ if (clef)
512
+ break;
513
+ }
514
+ xml += encodeAttributes(level + 1, {
515
+ divisions: isFirst,
516
+ key: measure.key || prevKey,
517
+ time: measure.timeSig || prevTime,
518
+ clef: clef,
519
+ staves: maxStaff > 1 ? maxStaff : undefined,
520
+ });
521
+ }
522
+ // Encode voices
523
+ let voiceNum = 1;
524
+ let currentPosition = 0;
525
+ for (const part of measure.parts) {
526
+ for (const voice of part.voices) {
527
+ const staff = voice.staff || 1;
528
+ let voicePosition = 0;
529
+ // Backup if needed
530
+ if (currentPosition > 0 && voiceNum > 1) {
531
+ xml += `${indent(level + 1)}<backup>\n`;
532
+ xml += `${indent(level + 2)}<duration>${currentPosition}</duration>\n`;
533
+ xml += `${indent(level + 1)}</backup>\n`;
534
+ voicePosition = 0;
535
+ }
536
+ for (const event of voice.events) {
537
+ switch (event.type) {
538
+ case 'note': {
539
+ // Check for direction marks (dynamics, hairpins, pedals)
540
+ const directionMarks = event.marks?.filter(m => m.markType === 'dynamic' || m.markType === 'hairpin' || m.markType === 'pedal') || [];
541
+ if (directionMarks.length > 0) {
542
+ xml += encodeDirection(directionMarks, level + 1);
543
+ }
544
+ // Encode main note
545
+ xml += encodeNote(event, voiceNum, staff, level + 1);
546
+ const dur = calculateDuration(event.duration);
547
+ voicePosition += dur;
548
+ // Encode chord notes
549
+ for (let i = 1; i < event.pitches.length; i++) {
550
+ const chordEvent = {
551
+ ...event,
552
+ pitches: [event.pitches[i]],
553
+ };
554
+ xml += encodeNote(chordEvent, voiceNum, staff, level + 1, true);
555
+ }
556
+ break;
557
+ }
558
+ case 'rest': {
559
+ xml += encodeRest(event, voiceNum, staff, level + 1);
560
+ const dur = calculateDuration(event.duration);
561
+ voicePosition += dur;
562
+ break;
563
+ }
564
+ case 'context': {
565
+ if (event.tempo) {
566
+ xml += encodeTempo(event.tempo, level + 1);
567
+ }
568
+ // Other context changes are handled in attributes
569
+ break;
570
+ }
571
+ case 'tuplet': {
572
+ for (const subEvent of event.events) {
573
+ if (subEvent.type === 'note') {
574
+ xml += encodeNote(subEvent, voiceNum, staff, level + 1);
575
+ const dur = calculateDuration(subEvent.duration);
576
+ voicePosition += dur;
577
+ }
578
+ else if (subEvent.type === 'rest') {
579
+ xml += encodeRest(subEvent, voiceNum, staff, level + 1);
580
+ const dur = calculateDuration(subEvent.duration);
581
+ voicePosition += dur;
582
+ }
583
+ }
584
+ break;
585
+ }
586
+ case 'barline': {
587
+ xml += encodeBarline(event, level + 1);
588
+ break;
589
+ }
590
+ case 'harmony': {
591
+ xml += encodeHarmony(event, level + 1);
592
+ break;
593
+ }
594
+ }
595
+ }
596
+ currentPosition = Math.max(currentPosition, voicePosition);
597
+ voiceNum++;
598
+ }
599
+ }
600
+ xml += `${indent(level)}</measure>\n`;
601
+ return xml;
602
+ };
603
+ /**
604
+ * Encode metadata to MusicXML elements
605
+ */
606
+ const encodeMetadata = (metadata, level) => {
607
+ let xml = '';
608
+ if (metadata.title) {
609
+ xml += `${indent(level)}<work>\n`;
610
+ xml += `${indent(level + 1)}<work-title>${escapeXml(metadata.title)}</work-title>\n`;
611
+ xml += `${indent(level)}</work>\n`;
612
+ }
613
+ xml += `${indent(level)}<identification>\n`;
614
+ if (metadata.composer) {
615
+ xml += `${indent(level + 1)}<creator type="composer">${escapeXml(metadata.composer)}</creator>\n`;
616
+ }
617
+ if (metadata.arranger) {
618
+ xml += `${indent(level + 1)}<creator type="arranger">${escapeXml(metadata.arranger)}</creator>\n`;
619
+ }
620
+ if (metadata.lyricist) {
621
+ xml += `${indent(level + 1)}<creator type="lyricist">${escapeXml(metadata.lyricist)}</creator>\n`;
622
+ }
623
+ xml += `${indent(level + 1)}<encoding>\n`;
624
+ xml += `${indent(level + 2)}<software>Lilylet</software>\n`;
625
+ xml += `${indent(level + 2)}<encoding-date>${new Date().toISOString().split('T')[0]}</encoding-date>\n`;
626
+ xml += `${indent(level + 1)}</encoding>\n`;
627
+ xml += `${indent(level)}</identification>\n`;
628
+ return xml;
629
+ };
630
+ /**
631
+ * Encode complete LilyletDoc to MusicXML
632
+ */
633
+ export const encode = (doc) => {
634
+ let xml = '<?xml version="1.0" encoding="UTF-8"?>\n';
635
+ xml += '<!DOCTYPE score-partwise PUBLIC "-//Recordare//DTD MusicXML 4.0 Partwise//EN" "http://www.musicxml.org/dtds/partwise.dtd">\n';
636
+ xml += '<score-partwise version="4.0">\n';
637
+ // Metadata
638
+ if (doc.metadata) {
639
+ xml += encodeMetadata(doc.metadata, 1);
640
+ }
641
+ // Part list (single part for now)
642
+ xml += `${indent(1)}<part-list>\n`;
643
+ xml += `${indent(2)}<score-part id="P1">\n`;
644
+ xml += `${indent(3)}<part-name>${doc.metadata?.title ? escapeXml(doc.metadata.title) : 'Music'}</part-name>\n`;
645
+ xml += `${indent(2)}</score-part>\n`;
646
+ xml += `${indent(1)}</part-list>\n`;
647
+ // Part content
648
+ xml += `${indent(1)}<part id="P1">\n`;
649
+ let prevKey;
650
+ let prevTime;
651
+ for (let i = 0; i < doc.measures.length; i++) {
652
+ const measure = doc.measures[i];
653
+ const isFirst = i === 0;
654
+ xml += encodeMeasure(measure, i + 1, isFirst, prevKey, prevTime, 2);
655
+ if (measure.key)
656
+ prevKey = measure.key;
657
+ if (measure.timeSig)
658
+ prevTime = measure.timeSig;
659
+ }
660
+ xml += `${indent(1)}</part>\n`;
661
+ xml += '</score-partwise>\n';
662
+ return xml;
663
+ };
664
+ export default {
665
+ encode,
666
+ };