@scorelabs/core 1.0.10 → 1.0.13

package/dist/models/index.d.ts

@@ -1,10 +1,10 @@
-export * from './types';
-export * from './Pitch';
-export * from './Note';
-export * from './NoteSet';
-export * from './Measure';
-export * from './Staff';
-export * from './Part';
-export * from './Score';
-export * from './Instrument';
-export * from './PreMeasure';
+export * from './types.js';
+export * from './Pitch.js';
+export * from './Note.js';
+export * from './NoteSet.js';
+export * from './Measure.js';
+export * from './Staff.js';
+export * from './Part.js';
+export * from './Score.js';
+export * from './Instrument.js';
+export * from './PreMeasure.js';

package/dist/models/index.js

@@ -1,10 +1,10 @@
-export * from './types';
-export * from './Pitch';
-export * from './Note';
-export * from './NoteSet';
-export * from './Measure';
-export * from './Staff';
-export * from './Part';
-export * from './Score';
-export * from './Instrument';
-export * from './PreMeasure';
+export * from './types.js';
+export * from './Pitch.js';
+export * from './Note.js';
+export * from './NoteSet.js';
+export * from './Measure.js';
+export * from './Staff.js';
+export * from './Part.js';
+export * from './Score.js';
+export * from './Instrument.js';
+export * from './PreMeasure.js';

package/dist/types/AccidentalDisplay.d.ts

@@ -0,0 +1,6 @@
+export interface AccidentalDisplay {
+    cautionary?: boolean;
+    editorial?: boolean;
+    parenthesized?: boolean;
+    bracketed?: boolean;
+}

package/dist/types/AccidentalDisplay.js

@@ -0,0 +1 @@
+export {};

package/dist/types/Arpeggio.d.ts

@@ -1,5 +1,6 @@
 export declare enum Arpeggio {
     Normal = "normal",
     Up = "up",
-    Down = "down"
+    Down = "down",
+    NonArpeggiate = "non-arpeggiate"
 }

package/dist/types/Arpeggio.js

@@ -3,4 +3,5 @@ export var Arpeggio;
     Arpeggio["Normal"] = "normal";
     Arpeggio["Up"] = "up";
     Arpeggio["Down"] = "down";
+    Arpeggio["NonArpeggiate"] = "non-arpeggiate";
 })(Arpeggio || (Arpeggio = {}));

package/dist/types/Articulation.d.ts

@@ -6,5 +6,7 @@ export declare enum Articulation {
     Fermata = "fermata",
     Staccatissimo = "staccatissimo",
     Caesura = "caesura",
-    BreathMark = "breath-mark"
+    BreathMark = "breath-mark",
+    Legato = "legato",
+    Portato = "portato"
 }

package/dist/types/Articulation.js

@@ -8,4 +8,6 @@ export var Articulation;
     Articulation["Staccatissimo"] = "staccatissimo";
     Articulation["Caesura"] = "caesura";
     Articulation["BreathMark"] = "breath-mark";
+    Articulation["Legato"] = "legato";
+    Articulation["Portato"] = "portato";
 })(Articulation || (Articulation = {}));

package/dist/types/Beam.d.ts

@@ -0,0 +1,4 @@
+export type BeamValue = 'begin' | 'continue' | 'end' | 'forward hook' | 'backward hook';
+export interface BeamLevels {
+    [level: number]: BeamValue;
+}

package/dist/types/Beam.js

@@ -0,0 +1 @@
+export {};

package/dist/types/Duration.d.ts

@@ -10,11 +10,15 @@ export declare enum Duration {
     TwoHundredFiftySixth = "two-hundred-fifty-sixth"
 }
 export declare const DURATION_VALUES: Record<Duration, number>;
+/**
+ * Calculates the numeric duration value (quarter = 1) for a given duration and dot count.
+ */
+export declare function calculateDurationValue(duration: Duration, dotCount?: number): number;
 /**
  * Decomposes a duration value (quarter = 1) into a list of duration/dot pairs.
  */
 export declare function decomposeDuration(value: number): {
     duration: Duration;
-    isDotted: boolean;
+    dotCount: number;
     val: number;
 }[];

package/dist/types/Duration.js

@@ -22,6 +22,19 @@ export const DURATION_VALUES = {
     [Duration.OneHundredTwentyEighth]: 0.03125,
     [Duration.TwoHundredFiftySixth]: 0.015625,
 };
+/**
+ * Calculates the numeric duration value (quarter = 1) for a given duration and dot count.
+ */
+export function calculateDurationValue(duration, dotCount = 0) {
+    const base = DURATION_VALUES[duration];
+    let multiplier = 1;
+    let dotValue = 0.5;
+    for (let i = 0; i < dotCount; i++) {
+        multiplier += dotValue;
+        dotValue /= 2;
+    }
+    return base * multiplier;
+}
 /**
  * Decomposes a duration value (quarter = 1) into a list of duration/dot pairs.
  */
@@ -29,26 +42,26 @@ export function decomposeDuration(value) {
     const result = [];
     let remaining = value;
     const options = [
-        { val: 4, dur: Duration.Whole, dot: false },
-        { val: 3, dur: Duration.Half, dot: true },
-        { val: 2, dur: Duration.Half, dot: false },
-        { val: 1.5, dur: Duration.Quarter, dot: true },
-        { val: 1, dur: Duration.Quarter, dot: false },
-        { val: 0.75, dur: Duration.Eighth, dot: true },
-        { val: 0.5, dur: Duration.Eighth, dot: false },
-        { val: 0.375, dur: Duration.Sixteenth, dot: true },
-        { val: 0.25, dur: Duration.Sixteenth, dot: false },
-        { val: 0.1875, dur: Duration.ThirtySecond, dot: true },
-        { val: 0.125, dur: Duration.ThirtySecond, dot: false },
-        { val: 0.09375, dur: Duration.SixtyFourth, dot: true },
-        { val: 0.0625, dur: Duration.SixtyFourth, dot: false },
+        { val: 4, dur: Duration.Whole, dot: 0 },
+        { val: 3, dur: Duration.Half, dot: 1 },
+        { val: 2, dur: Duration.Half, dot: 0 },
+        { val: 1.5, dur: Duration.Quarter, dot: 1 },
+        { val: 1, dur: Duration.Quarter, dot: 0 },
+        { val: 0.75, dur: Duration.Eighth, dot: 1 },
+        { val: 0.5, dur: Duration.Eighth, dot: 0 },
+        { val: 0.375, dur: Duration.Sixteenth, dot: 1 },
+        { val: 0.25, dur: Duration.Sixteenth, dot: 0 },
+        { val: 0.1875, dur: Duration.ThirtySecond, dot: 1 },
+        { val: 0.125, dur: Duration.ThirtySecond, dot: 0 },
+        { val: 0.09375, dur: Duration.SixtyFourth, dot: 1 },
+        { val: 0.0625, dur: Duration.SixtyFourth, dot: 0 },
     ];
     // Protect against infinite loop with max iterations
     let loops = 0;
     while (remaining > 0.001 && loops < 100) {
         const match = options.find((o) => o.val <= remaining + 0.001);
         if (match) {
-            result.push({ duration: match.dur, isDotted: match.dot, val: match.val });
+            result.push({ duration: match.dur, dotCount: match.dot, val: match.val });
             remaining -= match.val;
         }
         else {

package/dist/types/Grace.d.ts

@@ -0,0 +1,7 @@
+export interface GraceNote {
+    slash?: boolean;
+    stealTimePrevious?: number;
+    stealTimeFollowing?: number;
+    makeTime?: number;
+    cueSize?: boolean;
+}

package/dist/types/Grace.js

@@ -0,0 +1 @@
+export {};

package/dist/types/Hairpin.d.ts

@@ -1,8 +1,9 @@
+import { Placement } from './Placement.js';
 export declare enum HairpinType {
     Crescendo = "crescendo",
     Decrescendo = "decrescendo"
 }
-export interface Hairpin {
+export interface Hairpin extends Placement {
     type: HairpinType;
     placement: 'start' | 'stop';
 }

package/dist/types/Language.d.ts

@@ -0,0 +1,6 @@
+export declare enum Language {
+    EN = "en",
+    CA = "ca",
+    ES = "es",
+    DE = "de"
+}

package/dist/types/Language.js

@@ -0,0 +1,7 @@
+export var Language;
+(function (Language) {
+    Language["EN"] = "en";
+    Language["CA"] = "ca";
+    Language["ES"] = "es";
+    Language["DE"] = "de";
+})(Language || (Language = {}));

package/dist/types/Lyric.d.ts

@@ -1,3 +1,4 @@
+import { Placement } from './Placement.js';
 export declare enum Syllabic {
     Single = "single",
     Begin = "begin",
@@ -8,4 +9,5 @@ export interface Lyric {
     text: string;
     syllabic?: Syllabic;
     isExtension?: boolean;
+    placement?: Placement;
 }

package/dist/types/Ornament.d.ts

@@ -1,8 +1,30 @@
+import { Accidental } from './Accidental.js';
 export declare enum Ornament {
     Trill = "trill",
     Mordent = "mordent",
     InvertedMordent = "inverted-mordent",
     Turn = "turn",
     InvertedTurn = "inverted-turn",
-    Tremolo = "tremolo"
+    DelayedTurn = "delayed-turn",
+    Tremolo = "tremolo",
+    Tremolo1 = "tremolo-1",
+    Tremolo2 = "tremolo-2",
+    Tremolo3 = "tremolo-3",
+    Tremolo4 = "tremolo-4",
+    TremoloMeasured1 = "tremolo-measured-1",
+    TremoloMeasured2 = "tremolo-measured-2",
+    TremoloMeasured3 = "tremolo-measured-3",
+    TremoloMeasured4 = "tremolo-measured-4"
+}
+export interface OrnamentAccidentalMark {
+    accidental: Accidental;
+    placement?: 'above' | 'below';
+}
+export interface OrnamentWavyLine {
+    type: 'start' | 'stop' | 'continue';
+    number?: number;
+}
+export interface OrnamentDetails {
+    wavyLine?: OrnamentWavyLine;
+    accidentalMarks?: OrnamentAccidentalMark[];
 }

package/dist/types/Ornament.js

@@ -5,5 +5,14 @@ export var Ornament;
     Ornament["InvertedMordent"] = "inverted-mordent";
     Ornament["Turn"] = "turn";
     Ornament["InvertedTurn"] = "inverted-turn";
+    Ornament["DelayedTurn"] = "delayed-turn";
     Ornament["Tremolo"] = "tremolo";
+    Ornament["Tremolo1"] = "tremolo-1";
+    Ornament["Tremolo2"] = "tremolo-2";
+    Ornament["Tremolo3"] = "tremolo-3";
+    Ornament["Tremolo4"] = "tremolo-4";
+    Ornament["TremoloMeasured1"] = "tremolo-measured-1";
+    Ornament["TremoloMeasured2"] = "tremolo-measured-2";
+    Ornament["TremoloMeasured3"] = "tremolo-measured-3";
+    Ornament["TremoloMeasured4"] = "tremolo-measured-4";
 })(Ornament || (Ornament = {}));

package/dist/types/Pedal.d.ts

@@ -1,4 +1,5 @@
 export interface Pedal {
-    type: 'sustain' | 'una-corda';
-    placement: 'start' | 'stop';
+    type: 'sustain' | 'una-corda' | 'sostenuto';
+    placement: 'start' | 'stop' | 'change' | 'continue';
+    style?: 'text' | 'bracket' | 'mixed';
 }

package/dist/types/Placement.d.ts

@@ -0,0 +1,7 @@
+export interface Placement {
+    defaultX?: number;
+    defaultY?: number;
+    relativeX?: number;
+    relativeY?: number;
+    aboveBelow?: 'above' | 'below';
+}

package/dist/types/Placement.js

@@ -0,0 +1 @@
+export {};

package/dist/types/Repeat.d.ts

@@ -5,4 +5,5 @@ export interface Repeat {
 export interface Volta {
     type: 'start' | 'stop' | 'both';
     numbers: number[];
+    placement?: 'above' | 'below';
 }

package/dist/types/RestDisplay.d.ts

@@ -0,0 +1,6 @@
+export interface RestDisplay {
+    displayStep?: number;
+    displayOctave?: number;
+    defaultY?: number;
+    relativeY?: number;
+}

package/dist/types/RestDisplay.js

@@ -0,0 +1 @@
+export {};

package/dist/types/Slur.d.ts

@@ -1,4 +1,5 @@
 export interface Slur {
     placement: 'start' | 'stop';
     direction?: 'up' | 'down';
+    number?: number;
 }

package/dist/types/Technical.d.ts

@@ -0,0 +1,20 @@
+export declare enum HarmonicType {
+    Natural = "natural",
+    Artificial = "artificial"
+}
+export interface Harmonic {
+    type: HarmonicType;
+    printObject?: boolean;
+}
+export interface Bend {
+    alter: number;
+    release?: boolean;
+    preBend?: boolean;
+}
+export interface Technical {
+    harmonic?: Harmonic;
+    bend?: Bend;
+    tap?: boolean;
+    vibrato?: 'start' | 'stop' | boolean;
+    handVibrato?: boolean;
+}

package/dist/types/Technical.js

@@ -0,0 +1,5 @@
+export var HarmonicType;
+(function (HarmonicType) {
+    HarmonicType["Natural"] = "natural";
+    HarmonicType["Artificial"] = "artificial";
+})(HarmonicType || (HarmonicType = {}));

package/dist/types/Tempo.d.ts

@@ -2,7 +2,7 @@ import { Duration } from './Duration.js';
 export interface Tempo {
     bpm: number;
     duration: Duration;
-    isDotted: boolean;
+    dotCount?: number;
     text?: string;
     gradual?: 'ritardando' | 'accelerando';
 }

package/dist/types/Tie.d.ts

@@ -0,0 +1,4 @@
+export interface TieSpan {
+    placement: 'start' | 'stop' | 'continue';
+    number?: number;
+}

package/dist/types/Tie.js

@@ -0,0 +1 @@
+export {};

package/dist/types/Tuplet.d.ts

@@ -2,4 +2,10 @@ export interface Tuplet {
     actual: number;
     normal: number;
     type: 'start' | 'stop' | 'middle';
+    number?: number;
+    placement?: 'above' | 'below';
+    bracket?: 'yes' | 'no' | 'auto';
+    showNumber?: 'none' | 'actual' | 'both';
+    actualDisplay?: number;
+    normalDisplay?: number;
 }

package/dist/types/User.d.ts

@@ -1,10 +1,12 @@
-/**
- * WARNING: DO NOT ADD SENSITIVE LOGIC OR PRIVATE CONSTANTS TO THIS FILE.
- * This package (@scorelabs/core) is used in public-facing frontend applications
- * and could be exposed. Keep all token generation, verification, and encryption
- * logic in the 'backend' or 'website' utilities.
- */
-export type UserTier = 'free' | 'premium';
+export type UserTier = 'free' | 'premium' | 'school';
+export declare enum SubscriptionStatus {
+    ACTIVE = "active",
+    TRIALING = "trialing",
+    CANCELED = "canceled",
+    PAST_DUE = "past_due",
+    UNPAID = "unpaid",
+    INCOMPLETE = "incomplete"
+}
 export interface UserData {
     accessToken?: string;
     access_token?: string;
@@ -18,4 +20,8 @@ export interface UserData {
     id?: string | number;
     tier?: UserTier | string;
     picture?: string;
+    language?: string;
+    subscription_status?: SubscriptionStatus | string | null;
+    subscription_end_date?: string | null;
+    available_schools_counter?: number;
 }

package/dist/types/User.js

@@ -1,7 +1,9 @@
-/**
- * WARNING: DO NOT ADD SENSITIVE LOGIC OR PRIVATE CONSTANTS TO THIS FILE.
- * This package (@scorelabs/core) is used in public-facing frontend applications
- * and could be exposed. Keep all token generation, verification, and encryption
- * logic in the 'backend' or 'website' utilities.
- */
-export {};
+export var SubscriptionStatus;
+(function (SubscriptionStatus) {
+    SubscriptionStatus["ACTIVE"] = "active";
+    SubscriptionStatus["TRIALING"] = "trialing";
+    SubscriptionStatus["CANCELED"] = "canceled";
+    SubscriptionStatus["PAST_DUE"] = "past_due";
+    SubscriptionStatus["UNPAID"] = "unpaid";
+    SubscriptionStatus["INCOMPLETE"] = "incomplete";
+})(SubscriptionStatus || (SubscriptionStatus = {}));

package/dist/types/index.d.ts

@@ -3,7 +3,9 @@ export * from './InstrumentType.js';
 export * from './StemDirection.js';
 export * from './Clef.js';
 export * from './Duration.js';
+export * from './Beam.js';
 export * from './Accidental.js';
+export * from './AccidentalDisplay.js';
 export * from './Articulation.js';
 export * from './Dynamic.js';
 export * from './Genre.js';
@@ -22,6 +24,12 @@ export * from './Arpeggio.js';
 export * from './Glissando.js';
 export * from './Pedal.js';
 export * from './Slur.js';
+export * from './Tie.js';
 export * from './Tuplet.js';
+export * from './Grace.js';
+export * from './RestDisplay.js';
 export * from './Repeat.js';
 export * from './User.js';
+export * from './Language.js';
+export * from './Technical.js';
+export * from './Placement.js';

package/dist/types/index.js

@@ -3,7 +3,9 @@ export * from './InstrumentType.js';
 export * from './StemDirection.js';
 export * from './Clef.js';
 export * from './Duration.js';
+export * from './Beam.js';
 export * from './Accidental.js';
+export * from './AccidentalDisplay.js';
 export * from './Articulation.js';
 export * from './Dynamic.js';
 export * from './Genre.js';
@@ -22,6 +24,12 @@ export * from './Arpeggio.js';
 export * from './Glissando.js';
 export * from './Pedal.js';
 export * from './Slur.js';
+export * from './Tie.js';
 export * from './Tuplet.js';
+export * from './Grace.js';
+export * from './RestDisplay.js';
 export * from './Repeat.js';
 export * from './User.js';
+export * from './Language.js';
+export * from './Technical.js';
+export * from './Placement.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scorelabs/core",
-  "version": "1.0.10",
+  "version": "1.0.13",
   "description": "Core logic and models for ScoreLabs music notation",
   "type": "module",
   "files": [
@@ -34,6 +34,7 @@
     "@types/jszip": "^3.4.0",
     "@types/node": "^25.2.3",
     "@vitest/coverage-v8": "^4.0.18",
+    "@xmldom/xmldom": "^0.8.11",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   }