pepperscore 0.4.0 → 0.4.1

package/dist/lib/asset-fonts.d.ts

@@ -3,3 +3,7 @@
  * base instead of hardcoded CSS. Font family names are page-global, so the first instance's base wins.
  */
 export declare function ensureMusicFonts(base: string, onError?: (failed: string) => void): void;
+/** Start downloading a notation font's faces now (after ensureMusicFonts declared them), rather than on first use. */
+export declare function preloadMusicFont(font: string | undefined): void;
+/** Resolves when a notation font's faces have loaded (or failed), or after `timeoutMs`, whichever is first; never rejects. */
+export declare function musicFontsReady(font: string | undefined, timeoutMs: number): Promise<void>;

package/dist/lib/verovio-protocol.d.ts

@@ -60,7 +60,7 @@ export type VerovioFiles = {
     module: string;
     toolkit: string;
 };
-/** Sent once by the runtime right after it starts a worker, before any request. */
+/** Sent once by the runtime right after it starts a worker, before any request; the worker then starts loading Verovio. */
 export type VerovioConfigure = {
     kind: 'configure';
     files: VerovioFiles;

package/dist/lib/verovio-runtime.d.ts

@@ -32,6 +32,18 @@ export declare function verovioFilesAt(base: string, page?: string): VerovioFile
  * a restart); a blank `base` changes nothing.
  */
 export declare function setVerovioBaseUrl(base: string | undefined): void;
+/**
+ * Start the shared Verovio worker now and have it fetch, compile and instantiate Verovio, so the first engraving does
+ * not wait for that after the score's import. Readers call it on mount when they have a score to show; the worker
+ * still goes when the last reader channel closes. Uses the current `setVerovioBaseUrl` (set it first).
+ */
+export declare function warmVerovio(): void;
+/**
+ * Start loading Verovio before any reader mounts (for example from a page script, before React hydrates), so the
+ * first score engraves sooner. `base` is the same directory as PepperScoreProps.verovioBaseUrl (pass the same value);
+ * omitted, the copy shipped with pepperscore loads. Safe to call more than once and on the server (it does nothing).
+ */
+export declare function preloadVerovio(base?: string): void;
 export declare function verovioRevision(document: SourceDocument): number;
 /** A reader mounted: a channel of its own, so its imports and renders never supersede another reader's. */
 export declare function openVerovioChannel(): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pepperscore",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "An embeddable, browser-only music score reader for React: MusicXML, MXL, MIDI, MEI and ABC, engraved by Verovio, with playback.",
   "license": "MIT AND LGPL-3.0-or-later",
   "type": "module",