@k-l-lambda/lilylet 0.1.73 → 0.1.75

package/lib/lilylet/musicXmlDecoder.d.ts

@@ -8,13 +8,23 @@ import { LilyletDoc } from './types';
 /**
  * Decode MusicXML string to LilyletDoc
  */
-export declare const decode: (xmlString: string) => LilyletDoc;
+/**
+ * Decode raw MusicXML bytes (or a string) into a clean UTF-8/UTF-16-correct
+ * JS string. MuseScore/Finale/Sibelius frequently export `.xml` as UTF-16 LE
+ * with a BOM; reading those as UTF-8 yields mojibake and a failed parse.
+ *
+ * Detection order: byte-order mark → declared `encoding="..."` in the XML
+ * prolog → default UTF-8. A leading BOM is always stripped (xmldom chokes on a
+ * U+FEFF before `<?xml`).
+ */
+export declare const readXmlString: (input: string | Uint8Array) => string;
+export declare const decode: (input: string | Uint8Array) => LilyletDoc;
 /**
  * Decode MusicXML file to LilyletDoc
  */
 export declare const decodeFile: (filePath: string) => Promise<LilyletDoc>;
 declare const _default: {
-    decode: (xmlString: string) => LilyletDoc;
+    decode: (input: string | Uint8Array) => LilyletDoc;
     decodeFile: (filePath: string) => Promise<LilyletDoc>;
 };
 export default _default;