musicxml-io 0.2.0 → 0.2.7

package/dist/index-nCaclfqu.d.mts

@@ -1,377 +0,0 @@
-import { S as Score, M as Measure, n as TimeSignature, e as Part, N as NoteEntry, K as KeySignature, P as Pitch, C as Clef } from './types-Dp9zcgIg.mjs';
-
-type ValidationErrorCode = 'MISSING_DIVISIONS' | 'INVALID_DIVISIONS' | 'MEASURE_DURATION_MISMATCH' | 'MEASURE_DURATION_OVERFLOW' | 'MEASURE_DURATION_UNDERFLOW' | 'VOICE_INCOMPLETE' | 'VOICE_GAP' | 'NEGATIVE_POSITION' | 'BACKUP_EXCEEDS_POSITION' | 'TIE_START_WITHOUT_STOP' | 'TIE_STOP_WITHOUT_START' | 'TIE_PITCH_MISMATCH' | 'BEAM_BEGIN_WITHOUT_END' | 'BEAM_END_WITHOUT_BEGIN' | 'SLUR_START_WITHOUT_STOP' | 'SLUR_STOP_WITHOUT_START' | 'TUPLET_START_WITHOUT_STOP' | 'TUPLET_STOP_WITHOUT_START' | 'PART_ID_NOT_IN_PART_LIST' | 'PART_LIST_ID_NOT_IN_PARTS' | 'PART_MEASURE_COUNT_MISMATCH' | 'PART_MEASURE_NUMBER_MISMATCH' | 'PART_GROUP_START_WITHOUT_STOP' | 'PART_GROUP_STOP_WITHOUT_START' | 'DUPLICATE_PART_ID' | 'INVALID_VOICE_NUMBER' | 'INVALID_STAFF_NUMBER' | 'STAFF_EXCEEDS_STAVES' | 'MISSING_STAVES_DECLARATION' | 'STAVES_DECLARATION_MISMATCH' | 'MISSING_CLEF_FOR_STAFF' | 'CLEF_STAFF_EXCEEDS_STAVES' | 'INVALID_DURATION' | 'EMPTY_MEASURE';
-type ValidationLevel = 'error' | 'warning' | 'info';
-interface ValidationLocation {
-    partIndex?: number;
-    partId?: string;
-    measureIndex?: number;
-    measureNumber?: string;
-    entryIndex?: number;
-    voice?: number;
-    staff?: number;
-}
-interface ValidationError {
-    code: ValidationErrorCode;
-    level: ValidationLevel;
-    message: string;
-    location: ValidationLocation;
-    details?: Record<string, unknown>;
-}
-interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-    warnings: ValidationError[];
-    infos: ValidationError[];
-}
-interface ValidateOptions {
-    /** Check divisions consistency (default: true) */
-    checkDivisions?: boolean;
-    /** Check measure durations match time signature (default: true) */
-    checkMeasureDuration?: boolean;
-    /** Check that each voice fills the entire measure (Piano Roll semantics) (default: false) */
-    checkMeasureFullness?: boolean;
-    /** Check backup/forward position consistency (default: true) */
-    checkPosition?: boolean;
-    /** Check tie start/stop pairing (default: true) */
-    checkTies?: boolean;
-    /** Check beam begin/end pairing (default: true) */
-    checkBeams?: boolean;
-    /** Check slur start/stop pairing (default: true) */
-    checkSlurs?: boolean;
-    /** Check tuplet start/stop pairing (default: true) */
-    checkTuplets?: boolean;
-    /** Check part ID references (default: true) */
-    checkPartReferences?: boolean;
-    /** Check part structure (measure count, numbers) (default: true) */
-    checkPartStructure?: boolean;
-    /** Check voice/staff numbers (default: true) */
-    checkVoiceStaff?: boolean;
-    /** Check staff structure (staves declaration, clefs) (default: true) */
-    checkStaffStructure?: boolean;
-    /** Tolerance for measure duration (in divisions, default: 0) */
-    durationTolerance?: number;
-}
-/**
- * Validate a Score for internal consistency
- */
-declare function validate(score: Score, options?: ValidateOptions): ValidationResult;
-/**
- * Validate that divisions are defined and consistent
- */
-declare function validateDivisions(score: Score): ValidationError[];
-/**
- * Validate measure duration matches time signature
- */
-declare function validateMeasureDuration(measure: Measure, divisions: number, time: TimeSignature, location: ValidationLocation, tolerance?: number): ValidationError[];
-/**
- * Validate backup/forward position consistency
- */
-declare function validateBackupForward(measure: Measure, location: ValidationLocation): ValidationError[];
-/**
- * Validate tie start/stop pairing
- */
-declare function validateTies(measure: Measure, location: ValidationLocation): ValidationError[];
-/**
- * Validate beam begin/end pairing
- */
-declare function validateBeams(measure: Measure, location: ValidationLocation): ValidationError[];
-/**
- * Validate slur start/stop pairing
- */
-declare function validateSlurs(measure: Measure, _location: ValidationLocation): ValidationError[];
-/**
- * Validate tuplet start/stop pairing
- */
-declare function validateTuplets(measure: Measure, location: ValidationLocation): ValidationError[];
-/**
- * Validate part ID references between partList and parts
- */
-declare function validatePartReferences(score: Score): ValidationError[];
-/**
- * Validate voice and staff numbers
- */
-declare function validateVoiceStaff(measure: Measure, staves: number, location: ValidationLocation): ValidationError[];
-/**
- * Validate part structure (measure counts and numbers match across parts)
- */
-declare function validatePartStructure(score: Score): ValidationError[];
-/**
- * Validate staff structure within a part
- */
-declare function validateStaffStructure(part: Part, partIndex: number): ValidationError[];
-/**
- * Context needed to validate a single measure
- */
-interface MeasureValidationContext {
-    /** Current divisions value (from previous attributes) */
-    divisions: number;
-    /** Current time signature */
-    time?: TimeSignature;
-    /** Current staves count */
-    staves: number;
-    /** Part index (for error location) */
-    partIndex: number;
-    /** Part ID (for error location) */
-    partId: string;
-    /** Measure index (for error location) */
-    measureIndex: number;
-}
-/**
- * Options for local measure validation
- */
-interface LocalValidateOptions {
-    checkMeasureDuration?: boolean;
-    checkMeasureFullness?: boolean;
-    checkPosition?: boolean;
-    checkBeams?: boolean;
-    checkTuplets?: boolean;
-    checkVoiceStaff?: boolean;
-    durationTolerance?: number;
-}
-/**
- * Validate a single measure with provided context.
- * This is useful for validating after local operations like addNote, deleteNote.
- *
- * @example
- * ```typescript
- * const context = getMeasureContext(score, partIndex, measureIndex);
- * const errors = validateMeasureLocal(measure, context);
- * if (errors.length > 0) {
- *   throw new Error('Operation created invalid state');
- * }
- * ```
- */
-declare function validateMeasureLocal(measure: Measure, context: MeasureValidationContext, options?: LocalValidateOptions): ValidationError[];
-/**
- * Get the validation context for a measure by traversing previous attributes.
- * This collects divisions, time, and staves from measure 0 to the target measure.
- */
-declare function getMeasureContext(score: Score, partIndex: number, measureIndex: number): MeasureValidationContext;
-/**
- * Validate a measure after an operation, throwing if invalid.
- * Convenience wrapper around validateMeasureLocal.
- */
-declare function assertMeasureValid(score: Score, partIndex: number, measureIndex: number, options?: LocalValidateOptions): void;
-/**
- * Check if a score is valid (no errors)
- */
-declare function isValid(score: Score, options?: ValidateOptions): boolean;
-/**
- * Validate and throw if invalid
- */
-declare function assertValid(score: Score, options?: ValidateOptions): void;
-/**
- * Format a validation location for display
- */
-declare function formatLocation(location: ValidationLocation): string;
-/**
- * Validation exception with structured error information
- */
-declare class ValidationException extends Error {
-    readonly errors: ValidationError[];
-    constructor(errors: ValidationError[], message: string);
-}
-/**
- * Validate ties across measures
- * This is more complex as ties can span multiple measures
- */
-declare function validateTiesAcrossMeasures(part: Part): ValidationError[];
-/**
- * Validate slurs across measures
- */
-declare function validateSlursAcrossMeasures(part: Part): ValidationError[];
-
-/**
- * Operation result type - success with data or failure with errors
- */
-type OperationResult<T> = {
-    success: true;
-    data: T;
-    warnings?: ValidationError[];
-} | {
-    success: false;
-    errors: ValidationError[];
-};
-type OperationErrorCode = 'NOTE_CONFLICT' | 'EXCEEDS_MEASURE' | 'INVALID_POSITION' | 'NOTE_NOT_FOUND' | 'PART_NOT_FOUND' | 'MEASURE_NOT_FOUND' | 'INVALID_DURATION' | 'INVALID_STAFF' | 'DUPLICATE_PART_ID';
-interface InsertNoteOptions {
-    partIndex: number;
-    measureIndex: number;
-    voice: number;
-    staff?: number;
-    position: number;
-    pitch: Pitch;
-    duration: number;
-    noteType?: NoteEntry['noteType'];
-    dots?: number;
-}
-/**
- * Insert a note at the specified position in a voice.
- * - If the position has a rest, replaces it with the note
- * - If there's a conflicting note, returns NOTE_CONFLICT error
- * - If the note exceeds measure duration, returns EXCEEDS_MEASURE error
- */
-declare function insertNote(score: Score, options: InsertNoteOptions): OperationResult<Score>;
-/**
- * Remove a note and replace with rest
- */
-declare function removeNote(score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-}): OperationResult<Score>;
-/**
- * Add a chord note to an existing note
- */
-declare function addChord(score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-    pitch: Pitch;
-}): OperationResult<Score>;
-/**
- * Change note duration with proper handling of following notes
- * - If longer: consumes following rests/notes, returns error if would overwrite notes
- * - If shorter: fills remainder with rest
- */
-declare function changeNoteDuration(score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-    newDuration: number;
-    noteType?: NoteEntry['noteType'];
-    dots?: number;
-}): OperationResult<Score>;
-/**
- * Set note pitch (simple pitch change, no validation needed)
- */
-declare function setNotePitch(score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-    pitch: Pitch;
-}): OperationResult<Score>;
-/**
- * Add a new voice to a measure, filled with a whole-measure rest
- */
-declare function addVoice(score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    voice: number;
-    staff?: number;
-}): OperationResult<Score>;
-/**
- * Transpose all notes in the score
- */
-declare function transpose(score: Score, semitones: number): OperationResult<Score>;
-interface AddPartOptions {
-    id: string;
-    name?: string;
-    abbreviation?: string;
-    insertIndex?: number;
-    time?: TimeSignature;
-    key?: KeySignature;
-    clef?: Clef;
-    divisions?: number;
-}
-declare function addPart(score: Score, options: AddPartOptions): OperationResult<Score>;
-declare function removePart(score: Score, partId: string): OperationResult<Score>;
-declare function duplicatePart(score: Score, options: {
-    sourcePartId: string;
-    newPartId: string;
-    newPartName?: string;
-}): OperationResult<Score>;
-declare function setStaves(score: Score, options: {
-    partIndex: number;
-    staves: number;
-    clefs?: Clef[];
-    fromMeasure?: number;
-}): OperationResult<Score>;
-declare function moveNoteToStaff(score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-    targetStaff: number;
-}): OperationResult<Score>;
-declare function changeKey(score: Score, key: KeySignature, options: {
-    fromMeasure: string | number;
-}): Score;
-declare function changeTime(score: Score, time: TimeSignature, options: {
-    fromMeasure: string | number;
-}): Score;
-declare function insertMeasure(score: Score, options: {
-    afterMeasure: string | number;
-    copyAttributes?: boolean;
-}): Score;
-declare function deleteMeasure(score: Score, measureNumber: string | number): Score;
-/** @deprecated Use insertNote instead */
-declare const addNote: (score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    staff?: number;
-    voice: number;
-    position: number;
-    note: Omit<NoteEntry, "type" | "voice" | "staff">;
-}) => Score;
-/** @deprecated Use removeNote instead */
-declare const deleteNote: (score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-}) => Score;
-/** @deprecated Use addChord instead */
-declare const addChordNote: (score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    afterNoteIndex: number;
-    pitch: Pitch;
-}) => Score;
-/** @deprecated Use setNotePitch instead */
-declare const modifyNotePitch: (score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-    pitch: Pitch;
-}) => Score;
-/** @deprecated Use changeNoteDuration instead */
-declare const modifyNoteDuration: (score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-    duration: number;
-    noteType?: NoteEntry["noteType"];
-    dots?: number;
-}) => Score;
-/** @deprecated Use insertNote instead */
-declare const addNoteChecked: (score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    staff?: number;
-    voice: number;
-    position: number;
-    note: Omit<NoteEntry, "type" | "voice" | "staff">;
-}) => OperationResult<Score>;
-/** @deprecated Use removeNote instead */
-declare const deleteNoteChecked: typeof removeNote;
-/** @deprecated Use addChord instead */
-declare const addChordNoteChecked: (score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    afterNoteIndex: number;
-    pitch: Pitch;
-}) => OperationResult<Score>;
-/** @deprecated Use setNotePitch instead */
-declare const modifyNotePitchChecked: typeof setNotePitch;
-/** @deprecated Use changeNoteDuration instead */
-declare const modifyNoteDurationChecked: (score: Score, options: {
-    partIndex: number;
-    measureIndex: number;
-    noteIndex: number;
-    duration: number;
-    noteType?: NoteEntry["noteType"];
-    dots?: number;
-}) => OperationResult<Score>;
-/** @deprecated Use transpose instead */
-declare const transposeChecked: typeof transpose;
-
-export { moveNoteToStaff as $, validateSlursAcrossMeasures as A, formatLocation as B, ValidationException as C, validateMeasureLocal as D, getMeasureContext as E, assertMeasureValid as F, type ValidationError as G, type ValidationLocation as H, type ValidationErrorCode as I, type ValidationLevel as J, type OperationErrorCode as K, type LocalValidateOptions as L, type MeasureValidationContext as M, type InsertNoteOptions as N, type OperationResult as O, insertNote as P, removeNote as Q, addChord as R, changeNoteDuration as S, setNotePitch as T, addVoice as U, type ValidateOptions as V, type AddPartOptions as W, addPart as X, removePart as Y, duplicatePart as Z, setStaves as _, type ValidationResult as a, addNoteChecked as a0, deleteNoteChecked as a1, addChordNoteChecked as a2, modifyNotePitchChecked as a3, modifyNoteDurationChecked as a4, transposeChecked as a5, addNote as b, changeKey as c, deleteNote as d, changeTime as e, deleteMeasure as f, addChordNote as g, modifyNoteDuration as h, insertMeasure as i, isValid as j, assertValid as k, validateDivisions as l, modifyNotePitch as m, validateMeasureDuration as n, validateBackupForward as o, validateTies as p, validateBeams as q, validateSlurs as r, validateTuplets as s, transpose as t, validatePartReferences as u, validate as v, validatePartStructure as w, validateStaffStructure as x, validateVoiceStaff as y, validateTiesAcrossMeasures as z };