@libraz/libcantus 0.9.5 → 1.0.0

package/dist/index-DRtIhlJj.d.ts

@@ -1,152 +0,0 @@
-import { T as TimeSignature } from './index-DXd9JikN.js';
-import { K as KeyScale, N as NoteEvent } from './types-BN6_Q9Kl.js';
-import { C as Chord, b as ChordSegment, c as ChordSpan } from './index-COw1Ky9g.js';
-import { C as Cadence } from './function-DTCt675z.js';
-
-/**
- * A beat-indexed sequence of chord segments.
- *
- * @category Arrangement & Analysis
- */
-type ChordTimeline = {
-    /** The chord sounding at a beat, or null when no segment covers it. */
-    at: (beat: number) => Chord | null;
-    segments: ChordSegment[];
-};
-/**
- * Build a chord timeline from placed chords.
- *
- * Each chord spans from its `startBeat` to the next chord's `startBeat`; the last
- * chord runs to `totalBeats`. Segments with no positive length (from duplicate
- * onsets or a last chord at or past `totalBeats`) are dropped. `at(beat)` returns
- * the covering segment's chord, or null when the beat lies outside every segment.
- *
- * @param chords Placed chords in time order.
- * @param totalBeats End of the timeline in beats.
- * @returns A queryable chord timeline.
- * @category Arrangement & Analysis
- */
-declare function chordTimelineFromChords(chords: readonly ChordSpan[], totalBeats: number): ChordTimeline;
-/**
- * Options controlling {@link chordTimelineFromNotes}.
- *
- * @category Arrangement & Analysis
- */
-type ChordTimelineOptions = {
-    /** Key context; inferred from the notes with {@link detectKeyFromNotes} when omitted. */
-    key?: KeyScale;
-    /**
-     * Time signature used for metric accents; defaults to 4/4.
-     *
-     * @defaultValue `4/4`
-     */
-    ts?: TimeSignature;
-    /**
-     * Window length in beats per chord slot; defaults to one bar of `ts`.
-     *
-     * @defaultValue one bar of `ts`
-     */
-    harmonicRhythm?: number;
-    /**
-     * End of the analyzed span in beats; defaults to the end of the last note.
-     *
-     * @defaultValue the end of the last note
-     */
-    totalBeats?: number;
-    /**
-     * Upper bound on the work this call may do — note counts, windows, and
-     * candidate counts are each checked against it before anything is allocated.
-     *
-     * Raise it to analyse a piece larger than the default allows; the default is
-     * {@link DEFAULT_GENERATION_BUDGET}, chosen so a runaway input fails fast
-     * rather than blocking the thread.
-     *
-     * @defaultValue {@link DEFAULT_GENERATION_BUDGET}
-     */
-    budget?: number;
-};
-/**
- * The result of {@link chordTimelineFromNotes}.
- *
- * @category Arrangement & Analysis
- */
-type ChordTimelineResult = {
-    /** The inferred timeline, with adjacent identical chords merged. */
-    timeline: ChordTimeline;
-    /** The key used for the analysis (given or inferred). */
-    key: KeyScale;
-    /** One confidence value in [0, 1] per segment, in segment order. */
-    segmentConfidence: number[];
-};
-/**
- * Infer a chord timeline from raw multi-track notes.
- *
- * The span `[0, totalBeats)` is sliced into `harmonicRhythm`-beat windows; each
- * window's chord is inferred from a pitch-class weight histogram of the notes
- * overlapping it (weight = overlap duration x velocity x metric-accent bonus
- * for onsets in the window). Adjacent windows carrying the identical chord are
- * merged into one segment; windows with no notes produce no segment, so
- * `at(beat)` returns null there. Each segment carries a confidence in [0, 1]:
- * the fraction of the window weight explained by chord tones, reduced when the
- * match is inexact, and duration-weighted across merged windows.
- *
- * Notes with a zero or negative duration never sound, so they are dropped at
- * ingest: they contribute to neither the key inference, the span, nor any
- * window's histogram.
- *
- * @param notes The notes to analyze (any number of tracks, flattened).
- * @param opts Analysis options; see {@link ChordTimelineOptions}.
- * @returns The inferred timeline, the key used, and per-segment confidences.
- * @throws If `harmonicRhythm` is not positive.
- * @example
- * ```ts
- * import { chordTimelineFromNotes } from '@libraz/libcantus';
- * const notes = [
- *   { pitch: 60, startBeat: 0, durationBeat: 2 }, // C
- *   { pitch: 64, startBeat: 0, durationBeat: 2 }, // E
- *   { pitch: 67, startBeat: 0, durationBeat: 2 }, // G
- * ];
- * const { timeline, key } = chordTimelineFromNotes(notes);
- * timeline.at(0); // the chord inferred over beat 0, or null
- * ```
- * @category Arrangement & Analysis
- */
-declare function chordTimelineFromNotes(notes: NoteEvent[], opts?: ChordTimelineOptions): ChordTimelineResult;
-/**
- * A cadence found between two consecutive timeline segments.
- *
- * @category Arrangement & Analysis
- */
-type CadenceHit = {
-    /** The beat where the cadence arrives (the second chord's onset). */
-    atBeat: number;
-    type: Exclude<Cadence, null>;
-    from: Chord;
-    to: Chord;
-};
-/**
- * Find cadences between consecutive segments of a chord timeline.
- *
- * Each temporally adjacent segment pair is classified with
- * {@link detectCadence}; pairs forming no cadence are skipped. Segments
- * separated by a gap (a rest in the timeline) are not a chord-to-chord
- * progression, so they are never paired.
- *
- * @param timeline The chord timeline to scan.
- * @param key The prevailing key.
- * @returns The cadences found, in time order.
- * @example
- * ```ts
- * import { chordTimelineFromNotes, detectCadences } from '@libraz/libcantus';
- * const notes = [
- *   { pitch: 67, startBeat: 0, durationBeat: 4 }, // G, a dominant
- *   { pitch: 60, startBeat: 4, durationBeat: 4 }, // C, the tonic
- * ];
- * const { timeline, key } = chordTimelineFromNotes(notes);
- * const cadences = detectCadences(timeline, key);
- * ```
- * @category Arrangement & Analysis
- */
-declare function detectCadences(timeline: ChordTimeline, key: KeyScale): CadenceHit[];
-
-export { type CadenceHit as C, type ChordTimeline as a, type ChordTimelineOptions as b, type ChordTimelineResult as c, chordTimelineFromChords as d, chordTimelineFromNotes as e, detectCadences as f };

package/dist/index-DXd9JikN.d.cts

@@ -1,246 +0,0 @@
-/**
- * Meter and time signatures: bar/beat arithmetic, simple vs. compound meters,
- * metric-accent hierarchy, and tuplet subdivision.
- *
- * Positions and durations are measured in quarter-note beats, matching the rest
- * of the library's beat convention (four quarter-note beats per bar in 4/4).
- */
-/**
- * A time signature as a numerator over a note-value denominator.
- *
- * @category Rhythm & Meter
- */
-type TimeSignature = {
-    numerator: number;
-    denominator: number;
-    /**
-     * Optional additive grouping of the bar's main pulses, as the felt-beat
-     * lengths in pulses — e.g. `[2, 2, 3]` for a 2+2+3 reading of 7/8, or
-     * `[3, 2]` for 5/8. The entries must be positive integers summing to the
-     * numerator.
-     *
-     * A compound numerator accepts both readings. 9/8 groups its three dotted
-     * pulses as `[1, 1, 1]`, or reads additively as `[2, 2, 2, 3]` quavers; a
-     * grouping that sums to the numerator selects the additive reading, so
-     * aksak and other additive metres are expressible. {@link pulsesPerBar}
-     * and {@link isCompound} follow whichever reading the grouping selects.
-     *
-     * When present, the head pulse of each group (other than the downbeat) is
-     * treated as a secondary strong pulse by
-     * {@link metricWeight}/{@link isStrongBeat}; when absent, all main pulses
-     * are weighted equally as flat, evenly divided pulses.
-     */
-    grouping?: number[];
-};
-/**
- * A position expressed as a bar index and a quarter-note offset within the bar.
- *
- * @category Rhythm & Meter
- */
-type BarPosition = {
-    /** 0-based bar index. {@link formatBarPosition} renders it 1-based. */
-    bar: number;
-    /**
-     * Quarter-note offset from the start of the bar — not the felt beat. In 6/8
-     * the second felt beat is at `beat: 1.5`; {@link barPositionToPulse} converts
-     * to felt-beat numbering.
-     */
-    beat: number;
-};
-/**
- * Parse a time signature such as `"4/4"` or `"6/8"`.
- *
- * @param text The signature text.
- * @returns The parsed time signature.
- * @throws If the text is not `n/d` with positive integers.
- * @example
- * ```ts
- * import { parseTimeSignature } from '@libraz/libcantus';
- * parseTimeSignature('6/8'); // { numerator: 6, denominator: 8 }
- * ```
- * @category Rhythm & Meter
- */
-declare function parseTimeSignature(text: string): TimeSignature;
-/**
- * Render a time signature as `"n/d"`, or as `"a+b+c/d"` when it carries an
- * additive grouping and `grouping` is requested.
- *
- * The plain form drops the grouping, so a round trip through it reads 7/8 as
- * flat rather than as 2+2+3; ask for the additive form to keep it.
- *
- * @param ts The time signature.
- * @param opts Set `grouping: true` to render an additive grouping.
- * @returns The formatted signature.
- * @example
- * ```ts
- * import { formatTimeSignature } from '@libraz/libcantus';
- * const aksak = { numerator: 7, denominator: 8, grouping: [2, 2, 3] };
- * formatTimeSignature(aksak); // '7/8'
- * formatTimeSignature(aksak, { grouping: true }); // '2+2+3/8'
- * ```
- * @category Rhythm & Meter
- */
-declare function formatTimeSignature(ts: TimeSignature, opts?: {
-    grouping?: boolean;
-}): string;
-/**
- * Whether a meter is compound: its main pulses each divide into three, as in
- * 6/8, 9/8, 12/8, or 6/4. Compound meters are those whose numerator is a
- * multiple of three greater than three, independent of the denominator. Meters
- * like 3/8 and 3/4 (simple triples, numerator 3) are not compound, and neither
- * is a signature whose {@link TimeSignature.grouping} selects the additive
- * reading (9/8 as 2+2+2+3).
- *
- * @param ts The time signature.
- * @returns True for compound meters.
- * @category Rhythm & Meter
- */
-declare function isCompound(ts: TimeSignature): boolean;
-/**
- * Length of a bar in quarter-note beats.
- *
- * @param ts The time signature.
- * @returns The bar length in quarter notes.
- * @category Rhythm & Meter
- */
-declare function beatsPerBar(ts: TimeSignature): number;
-/**
- * Number of main pulses (felt beats) per bar: the numerator for simple meters,
- * a third of it for compound meters.
- *
- * For additive/irregular meters such as 7/8 or 5/8 this counts the raw pulses
- * (7 and 5 respectively), which are otherwise felt as flat, evenly divided and
- * equally accented pulses. To recover a 2+2+3 or 3+2 felt-beat grouping, set
- * {@link TimeSignature.grouping}; {@link metricWeight} then accents each
- * group's head pulse.
- *
- * @param ts The time signature.
- * @returns The pulse count per bar.
- * @category Rhythm & Meter
- */
-declare function pulsesPerBar(ts: TimeSignature): number;
-/**
- * Convert an absolute quarter-note position to a bar index and in-bar offset.
- *
- * @param beatInQuarters Absolute position in quarter-note beats.
- * @param ts The time signature.
- * @returns The bar and in-bar quarter-note offset.
- * @example
- * ```ts
- * import { parseTimeSignature, beatToBarPosition } from '@libraz/libcantus';
- * const ts = parseTimeSignature('4/4');
- * beatToBarPosition(5, ts); // { bar: 1, beat: 1 }
- * ```
- * @category Rhythm & Meter
- */
-declare function beatToBarPosition(beatInQuarters: number, ts: TimeSignature): BarPosition;
-/**
- * Length of one felt beat (main pulse) in quarter-note beats.
- *
- * A quarter note in simple meters, a dotted quarter in compound ones, and one
- * denominator unit in an additive metre. Position displays, click tracks, and
- * score export are all written against this length.
- *
- * @param ts The time signature.
- * @returns The pulse length in quarter-note beats.
- * @example
- * ```ts
- * import { parseTimeSignature, pulseBeats } from '@libraz/libcantus';
- * pulseBeats(parseTimeSignature('6/8')); // 1.5
- * ```
- * @category Rhythm & Meter
- */
-declare function pulseBeats(ts: TimeSignature): number;
-/**
- * The felt-beat number of a bar position, 1-based.
- *
- * {@link BarPosition.beat} is a quarter-note offset, so in 6/8 the second felt
- * beat reads as 1.5. This is the number a musician says and a position display
- * shows.
- *
- * @param pos The bar position.
- * @param ts The time signature.
- * @returns The 1-based felt-beat number, fractional between pulses.
- * @example
- * ```ts
- * import { barPositionToPulse, parseTimeSignature } from '@libraz/libcantus';
- * barPositionToPulse({ bar: 0, beat: 1.5 }, parseTimeSignature('6/8')); // 2
- * ```
- * @category Rhythm & Meter
- */
-declare function barPositionToPulse(pos: BarPosition, ts: TimeSignature): number;
-/**
- * Render an absolute position as the `bar.beat` a DAW or a score shows:
- * 1-based bar, 1-based felt beat.
- *
- * @param beatInQuarters Absolute position in quarter-note beats.
- * @param ts The time signature.
- * @param decimals Digits of the fractional beat to keep.
- * @returns The formatted position, e.g. `'3.2'` for bar 3, felt beat 2.
- * @example
- * ```ts
- * import { formatBarPosition, parseTimeSignature } from '@libraz/libcantus';
- * formatBarPosition(7.5, parseTimeSignature('6/8')); // '3.2'
- * ```
- * @category Rhythm & Meter
- */
-declare function formatBarPosition(beatInQuarters: number, ts: TimeSignature, decimals?: number): string;
-/**
- * Convert a bar index and in-bar offset back to an absolute quarter-note
- * position.
- *
- * @param pos The bar position.
- * @param ts The time signature.
- * @returns The absolute position in quarter-note beats.
- * @category Rhythm & Meter
- */
-declare function barPositionToBeat(pos: BarPosition, ts: TimeSignature): number;
-/**
- * Metric weight of a position within its bar, on a 0–3 scale:
- * 3 the downbeat, 2 a secondary strong pulse, 1 any other main pulse, and 0 an
- * off-pulse subdivision.
- *
- * The secondary strong pulse is the bar's midpoint in even simple/compound
- * meters. For an additive/irregular meter with {@link TimeSignature.grouping}
- * set (e.g. `[2, 2, 3]` for 7/8), each group's head pulse other than the
- * downbeat is the secondary strong pulse instead; without a grouping every
- * non-downbeat main pulse of such a meter weighs 1 (flat, evenly divided
- * pulses).
- *
- * @param beatInQuarters Absolute or in-bar quarter-note position.
- * @param ts The time signature.
- * @returns The metric weight (0–3).
- * @throws If the time signature is malformed, including a grouping that is not
- *   a positive-integer list summing to the pulse count or the numerator.
- * @example
- * ```ts
- * import { parseTimeSignature, metricWeight } from '@libraz/libcantus';
- * const ts = parseTimeSignature('4/4');
- * metricWeight(0, ts); // 3 (the downbeat)
- * ```
- * @category Rhythm & Meter
- */
-declare function metricWeight(beatInQuarters: number, ts: TimeSignature): number;
-/**
- * Whether a position is metrically accented (weight 2 or more — a downbeat or a
- * secondary strong pulse).
- *
- * @param beatInQuarters Absolute or in-bar quarter-note position.
- * @param ts The time signature.
- * @returns True on strong beats.
- * @category Rhythm & Meter
- */
-declare function isStrongBeat(beatInQuarters: number, ts: TimeSignature): boolean;
-/**
- * Subdivide a span into `count` equal tuplet durations (e.g. an eighth-note
- * triplet is `tuplet(1, 3)`).
- *
- * @param totalBeats Total span in quarter-note beats.
- * @param count Number of equal parts.
- * @returns `count` equal durations summing to `totalBeats`.
- * @throws If `count` is not a positive integer.
- * @category Rhythm & Meter
- */
-declare function tuplet(totalBeats: number, count: number): number[];
-
-export { type BarPosition as B, type TimeSignature as T, barPositionToPulse as a, barPositionToBeat as b, beatToBarPosition as c, beatsPerBar as d, formatTimeSignature as e, formatBarPosition as f, isStrongBeat as g, pulseBeats as h, isCompound as i, pulsesPerBar as j, metricWeight as m, parseTimeSignature as p, tuplet as t };

package/dist/index-DXd9JikN.d.ts

@@ -1,246 +0,0 @@
-/**
- * Meter and time signatures: bar/beat arithmetic, simple vs. compound meters,
- * metric-accent hierarchy, and tuplet subdivision.
- *
- * Positions and durations are measured in quarter-note beats, matching the rest
- * of the library's beat convention (four quarter-note beats per bar in 4/4).
- */
-/**
- * A time signature as a numerator over a note-value denominator.
- *
- * @category Rhythm & Meter
- */
-type TimeSignature = {
-    numerator: number;
-    denominator: number;
-    /**
-     * Optional additive grouping of the bar's main pulses, as the felt-beat
-     * lengths in pulses — e.g. `[2, 2, 3]` for a 2+2+3 reading of 7/8, or
-     * `[3, 2]` for 5/8. The entries must be positive integers summing to the
-     * numerator.
-     *
-     * A compound numerator accepts both readings. 9/8 groups its three dotted
-     * pulses as `[1, 1, 1]`, or reads additively as `[2, 2, 2, 3]` quavers; a
-     * grouping that sums to the numerator selects the additive reading, so
-     * aksak and other additive metres are expressible. {@link pulsesPerBar}
-     * and {@link isCompound} follow whichever reading the grouping selects.
-     *
-     * When present, the head pulse of each group (other than the downbeat) is
-     * treated as a secondary strong pulse by
-     * {@link metricWeight}/{@link isStrongBeat}; when absent, all main pulses
-     * are weighted equally as flat, evenly divided pulses.
-     */
-    grouping?: number[];
-};
-/**
- * A position expressed as a bar index and a quarter-note offset within the bar.
- *
- * @category Rhythm & Meter
- */
-type BarPosition = {
-    /** 0-based bar index. {@link formatBarPosition} renders it 1-based. */
-    bar: number;
-    /**
-     * Quarter-note offset from the start of the bar — not the felt beat. In 6/8
-     * the second felt beat is at `beat: 1.5`; {@link barPositionToPulse} converts
-     * to felt-beat numbering.
-     */
-    beat: number;
-};
-/**
- * Parse a time signature such as `"4/4"` or `"6/8"`.
- *
- * @param text The signature text.
- * @returns The parsed time signature.
- * @throws If the text is not `n/d` with positive integers.
- * @example
- * ```ts
- * import { parseTimeSignature } from '@libraz/libcantus';
- * parseTimeSignature('6/8'); // { numerator: 6, denominator: 8 }
- * ```
- * @category Rhythm & Meter
- */
-declare function parseTimeSignature(text: string): TimeSignature;
-/**
- * Render a time signature as `"n/d"`, or as `"a+b+c/d"` when it carries an
- * additive grouping and `grouping` is requested.
- *
- * The plain form drops the grouping, so a round trip through it reads 7/8 as
- * flat rather than as 2+2+3; ask for the additive form to keep it.
- *
- * @param ts The time signature.
- * @param opts Set `grouping: true` to render an additive grouping.
- * @returns The formatted signature.
- * @example
- * ```ts
- * import { formatTimeSignature } from '@libraz/libcantus';
- * const aksak = { numerator: 7, denominator: 8, grouping: [2, 2, 3] };
- * formatTimeSignature(aksak); // '7/8'
- * formatTimeSignature(aksak, { grouping: true }); // '2+2+3/8'
- * ```
- * @category Rhythm & Meter
- */
-declare function formatTimeSignature(ts: TimeSignature, opts?: {
-    grouping?: boolean;
-}): string;
-/**
- * Whether a meter is compound: its main pulses each divide into three, as in
- * 6/8, 9/8, 12/8, or 6/4. Compound meters are those whose numerator is a
- * multiple of three greater than three, independent of the denominator. Meters
- * like 3/8 and 3/4 (simple triples, numerator 3) are not compound, and neither
- * is a signature whose {@link TimeSignature.grouping} selects the additive
- * reading (9/8 as 2+2+2+3).
- *
- * @param ts The time signature.
- * @returns True for compound meters.
- * @category Rhythm & Meter
- */
-declare function isCompound(ts: TimeSignature): boolean;
-/**
- * Length of a bar in quarter-note beats.
- *
- * @param ts The time signature.
- * @returns The bar length in quarter notes.
- * @category Rhythm & Meter
- */
-declare function beatsPerBar(ts: TimeSignature): number;
-/**
- * Number of main pulses (felt beats) per bar: the numerator for simple meters,
- * a third of it for compound meters.
- *
- * For additive/irregular meters such as 7/8 or 5/8 this counts the raw pulses
- * (7 and 5 respectively), which are otherwise felt as flat, evenly divided and
- * equally accented pulses. To recover a 2+2+3 or 3+2 felt-beat grouping, set
- * {@link TimeSignature.grouping}; {@link metricWeight} then accents each
- * group's head pulse.
- *
- * @param ts The time signature.
- * @returns The pulse count per bar.
- * @category Rhythm & Meter
- */
-declare function pulsesPerBar(ts: TimeSignature): number;
-/**
- * Convert an absolute quarter-note position to a bar index and in-bar offset.
- *
- * @param beatInQuarters Absolute position in quarter-note beats.
- * @param ts The time signature.
- * @returns The bar and in-bar quarter-note offset.
- * @example
- * ```ts
- * import { parseTimeSignature, beatToBarPosition } from '@libraz/libcantus';
- * const ts = parseTimeSignature('4/4');
- * beatToBarPosition(5, ts); // { bar: 1, beat: 1 }
- * ```
- * @category Rhythm & Meter
- */
-declare function beatToBarPosition(beatInQuarters: number, ts: TimeSignature): BarPosition;
-/**
- * Length of one felt beat (main pulse) in quarter-note beats.
- *
- * A quarter note in simple meters, a dotted quarter in compound ones, and one
- * denominator unit in an additive metre. Position displays, click tracks, and
- * score export are all written against this length.
- *
- * @param ts The time signature.
- * @returns The pulse length in quarter-note beats.
- * @example
- * ```ts
- * import { parseTimeSignature, pulseBeats } from '@libraz/libcantus';
- * pulseBeats(parseTimeSignature('6/8')); // 1.5
- * ```
- * @category Rhythm & Meter
- */
-declare function pulseBeats(ts: TimeSignature): number;
-/**
- * The felt-beat number of a bar position, 1-based.
- *
- * {@link BarPosition.beat} is a quarter-note offset, so in 6/8 the second felt
- * beat reads as 1.5. This is the number a musician says and a position display
- * shows.
- *
- * @param pos The bar position.
- * @param ts The time signature.
- * @returns The 1-based felt-beat number, fractional between pulses.
- * @example
- * ```ts
- * import { barPositionToPulse, parseTimeSignature } from '@libraz/libcantus';
- * barPositionToPulse({ bar: 0, beat: 1.5 }, parseTimeSignature('6/8')); // 2
- * ```
- * @category Rhythm & Meter
- */
-declare function barPositionToPulse(pos: BarPosition, ts: TimeSignature): number;
-/**
- * Render an absolute position as the `bar.beat` a DAW or a score shows:
- * 1-based bar, 1-based felt beat.
- *
- * @param beatInQuarters Absolute position in quarter-note beats.
- * @param ts The time signature.
- * @param decimals Digits of the fractional beat to keep.
- * @returns The formatted position, e.g. `'3.2'` for bar 3, felt beat 2.
- * @example
- * ```ts
- * import { formatBarPosition, parseTimeSignature } from '@libraz/libcantus';
- * formatBarPosition(7.5, parseTimeSignature('6/8')); // '3.2'
- * ```
- * @category Rhythm & Meter
- */
-declare function formatBarPosition(beatInQuarters: number, ts: TimeSignature, decimals?: number): string;
-/**
- * Convert a bar index and in-bar offset back to an absolute quarter-note
- * position.
- *
- * @param pos The bar position.
- * @param ts The time signature.
- * @returns The absolute position in quarter-note beats.
- * @category Rhythm & Meter
- */
-declare function barPositionToBeat(pos: BarPosition, ts: TimeSignature): number;
-/**
- * Metric weight of a position within its bar, on a 0–3 scale:
- * 3 the downbeat, 2 a secondary strong pulse, 1 any other main pulse, and 0 an
- * off-pulse subdivision.
- *
- * The secondary strong pulse is the bar's midpoint in even simple/compound
- * meters. For an additive/irregular meter with {@link TimeSignature.grouping}
- * set (e.g. `[2, 2, 3]` for 7/8), each group's head pulse other than the
- * downbeat is the secondary strong pulse instead; without a grouping every
- * non-downbeat main pulse of such a meter weighs 1 (flat, evenly divided
- * pulses).
- *
- * @param beatInQuarters Absolute or in-bar quarter-note position.
- * @param ts The time signature.
- * @returns The metric weight (0–3).
- * @throws If the time signature is malformed, including a grouping that is not
- *   a positive-integer list summing to the pulse count or the numerator.
- * @example
- * ```ts
- * import { parseTimeSignature, metricWeight } from '@libraz/libcantus';
- * const ts = parseTimeSignature('4/4');
- * metricWeight(0, ts); // 3 (the downbeat)
- * ```
- * @category Rhythm & Meter
- */
-declare function metricWeight(beatInQuarters: number, ts: TimeSignature): number;
-/**
- * Whether a position is metrically accented (weight 2 or more — a downbeat or a
- * secondary strong pulse).
- *
- * @param beatInQuarters Absolute or in-bar quarter-note position.
- * @param ts The time signature.
- * @returns True on strong beats.
- * @category Rhythm & Meter
- */
-declare function isStrongBeat(beatInQuarters: number, ts: TimeSignature): boolean;
-/**
- * Subdivide a span into `count` equal tuplet durations (e.g. an eighth-note
- * triplet is `tuplet(1, 3)`).
- *
- * @param totalBeats Total span in quarter-note beats.
- * @param count Number of equal parts.
- * @returns `count` equal durations summing to `totalBeats`.
- * @throws If `count` is not a positive integer.
- * @category Rhythm & Meter
- */
-declare function tuplet(totalBeats: number, count: number): number[];
-
-export { type BarPosition as B, type TimeSignature as T, barPositionToPulse as a, barPositionToBeat as b, beatToBarPosition as c, beatsPerBar as d, formatTimeSignature as e, formatBarPosition as f, isStrongBeat as g, pulseBeats as h, isCompound as i, pulsesPerBar as j, metricWeight as m, parseTimeSignature as p, tuplet as t };