import type { ScoreFormat, ScoreRender, ScoreRenderOptions } from './types.js';
export declare function isMusicReady(): boolean;
export declare function onMusicReady(fn: () => void): () => void;
/**
 * Load Verovio and start the score engraver. Await it before laying out a
 * document with scores on the main thread (the layout worker calls it
 * itself): until it resolves, every score is set as a grey placeholder box.
 * Idempotent; a failed start can be retried.
 */
export declare function initMusicEngine(): Promise<void>;
/** Called when the layout sets a score with no engine running. Warns once,
 *  and only when nobody asked for the engine. */
export declare function noteMusicWithoutEngine(): void;
export declare function clearMusicCache(): void;
/**
 * Engrave a score at a measure `widthPx` wide. Returns one slice per system;
 * an empty list (with `error`) when the source does not load or the engine
 * is not running.
 */
export declare function renderScore(source: string, format: ScoreFormat, widthPx: number, options: ScoreRenderOptions): ScoreRender;
//# sourceMappingURL=engine.d.ts.map