el-diatonico-models 0.0.8 → 1.0.1

package/README.md

@@ -1,3 +1,3 @@
-# el-diatonico-models
-
-Models used inside the el-diatonico site.
+# el-diatonico-models
+
+Models used inside the el-diatonico site.

package/dist/Accordion/Accordion.d.ts

@@ -2,11 +2,36 @@ import type { IAccordion } from "@Accordion";
 import type { AccordionTuning } from "@Enums";
 import type { IKeyBoard } from "@Keyboard";
 import type { ITonality } from "@Tonality";
+/**
+ * Represents a physical accordion instrument.
+ *
+ * An accordion consists of two keyboards (opening and closing bellows directions),
+ * a specific tuning system, and a collection of available tonalities.
+ *
+ * @example
+ * ```typescript
+ * const accordion = AccordionFactory.createAccordion(AccordionTuning.FA);
+ * console.log(accordion.tuning);        // AccordionTuning.FA
+ * console.log(accordion.tones.length);  // List of available tonalities
+ * ```
+ */
 export declare class Accordion implements IAccordion {
-    tuning: AccordionTuning;
-    keyboardClosing: IKeyBoard;
-    keyboardOpening: IKeyBoard;
-    tones: ITonality[];
+    /** The tuning system of this accordion */
+    readonly tuning: AccordionTuning;
+    /** The keyboard for closing bellows (Cerrando) */
+    readonly keyboardClosing: IKeyBoard;
+    /** The keyboard for opening bellows (Abriendo) */
+    readonly keyboardOpening: IKeyBoard;
+    /** The available tonalities for this accordion */
+    readonly tones: ITonality[];
+    /**
+     * Creates a new Accordion instance.
+     *
+     * @param tuning - The accordion tuning (FA, SOL)
+     * @param keyboardClosing - The closing bellows keyboard
+     * @param keyboardOpening - The opening bellows keyboard
+     * @param tones - Available tonalities
+     */
     constructor(tuning: AccordionTuning, keyboardClosing: IKeyBoard, keyboardOpening: IKeyBoard, tones: ITonality[]);
 }
 //# sourceMappingURL=Accordion.d.ts.map

package/dist/Accordion/Accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../src/Accordion/Accordion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,qBAAa,SAAU,YAAW,UAAU;IAC1C,MAAM,EAAE,eAAe,CAAC;IACxB,eAAe,EAAE,SAAS,CAAC;IAC3B,eAAe,EAAE,SAAS,CAAC;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;gBAGjB,MAAM,EAAE,eAAe,EACvB,eAAe,EAAE,SAAS,EAC1B,eAAe,EAAE,SAAS,EAC1B,KAAK,EAAE,SAAS,EAAE;CAOrB"}
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../src/Accordion/Accordion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,kDAAkD;IAClD,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAE5B;;;;;;;OAOG;gBAED,MAAM,EAAE,eAAe,EACvB,eAAe,EAAE,SAAS,EAC1B,eAAe,EAAE,SAAS,EAC1B,KAAK,EAAE,SAAS,EAAE;CAOrB"}

package/dist/Accordion/Accordion.js

@@ -1,8 +1,25 @@
+/**
+ * Represents a physical accordion instrument.
+ *
+ * An accordion consists of two keyboards (opening and closing bellows directions),
+ * a specific tuning system, and a collection of available tonalities.
+ *
+ * @example
+ * ```typescript
+ * const accordion = AccordionFactory.createAccordion(AccordionTuning.FA);
+ * console.log(accordion.tuning);        // AccordionTuning.FA
+ * console.log(accordion.tones.length);  // List of available tonalities
+ * ```
+ */
 export class Accordion {
-    tuning;
-    keyboardClosing;
-    keyboardOpening;
-    tones;
+    /**
+     * Creates a new Accordion instance.
+     *
+     * @param tuning - The accordion tuning (FA, SOL)
+     * @param keyboardClosing - The closing bellows keyboard
+     * @param keyboardOpening - The opening bellows keyboard
+     * @param tones - Available tonalities
+     */
     constructor(tuning, keyboardClosing, keyboardOpening, tones) {
         this.tuning = tuning;
         this.keyboardClosing = keyboardClosing;

package/dist/Accordion/Accordion.js.map

@@ -1 +1 @@
-{"version":3,"file":"Accordion.js","sourceRoot":"","sources":["../../src/Accordion/Accordion.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,SAAS;IACpB,MAAM,CAAkB;IACxB,eAAe,CAAY;IAC3B,eAAe,CAAY;IAC3B,KAAK,CAAc;IAEnB,YACE,MAAuB,EACvB,eAA0B,EAC1B,eAA0B,EAC1B,KAAkB;QAElB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"Accordion.js","sourceRoot":"","sources":["../../src/Accordion/Accordion.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,SAAS;IAUpB;;;;;;;OAOG;IACH,YACE,MAAuB,EACvB,eAA0B,EAC1B,eAA0B,EAC1B,KAAkB;QAElB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/Accordion/AccordionFactory.d.ts

@@ -1,6 +1,25 @@
 import { Accordion } from "@Accordion";
 import { type AccordionTuning } from "@Enums";
+/**
+ * Factory for creating Accordion instances.
+ *
+ * Handles the creation of complete accordion objects with all required keyboards
+ * (closing/cerrando and opening/abriendo) and tonalities for a given tuning.
+ */
 export declare class AccordionFactory {
+    private static tonalitiesLoader;
+    /**
+     * Creates an Accordion with both keyboard configurations.
+     *
+     * @param tuning - The accordion tuning (e.g., FA, SOL)
+     * @returns A fully initialized Accordion instance
+     * @throws {ConfigurationError} If no tonalities are found for the specified tuning
+     *
+     * @example
+     * ```typescript
+     * const accordion = AccordionFactory.createAccordion(AccordionTuning.FA);
+     * ```
+     */
     static createAccordion(tuning: AccordionTuning): Accordion;
 }
 //# sourceMappingURL=AccordionFactory.d.ts.map

package/dist/Accordion/AccordionFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccordionFactory.d.ts","sourceRoot":"","sources":["../../src/Accordion/AccordionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AAIvD,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe;CAgB/C"}
+{"version":3,"file":"AccordionFactory.d.ts","sourceRoot":"","sources":["../../src/Accordion/AccordionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AAKvD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA0B;IAEzD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS;CAmB3D"}

package/dist/Accordion/AccordionFactory.js

@@ -1,13 +1,35 @@
 import { Accordion } from "@Accordion";
 import { Bellows } from "@Enums";
-import { tonalities as TonalitiesCollection } from "@Tonality";
-import { KeyboardFactory } from "../Keyboard/KeyboardFactory";
+import { TonalitiesLoader } from "@Loaders";
+import { KeyboardFactory } from "@Keyboard";
+import { ConfigurationError } from "@Core";
+/**
+ * Factory for creating Accordion instances.
+ *
+ * Handles the creation of complete accordion objects with all required keyboards
+ * (closing/cerrando and opening/abriendo) and tonalities for a given tuning.
+ */
 export class AccordionFactory {
+    /**
+     * Creates an Accordion with both keyboard configurations.
+     *
+     * @param tuning - The accordion tuning (e.g., FA, SOL)
+     * @returns A fully initialized Accordion instance
+     * @throws {ConfigurationError} If no tonalities are found for the specified tuning
+     *
+     * @example
+     * ```typescript
+     * const accordion = AccordionFactory.createAccordion(AccordionTuning.FA);
+     * ```
+     */
     static createAccordion(tuning) {
-        const tonalities = TonalitiesCollection.filter((tonality) => tonality.accordionTuning == tuning) || [];
-        const keyboarClosing = KeyboardFactory.createKeyboard(tuning, Bellows.CERRANDO);
-        const keyboarOpening = KeyboardFactory.createKeyboard(tuning, Bellows.ABRIENDO);
-        return new Accordion(tuning, keyboarClosing, keyboarOpening, tonalities);
+        const tonalities = this.tonalitiesLoader.loadByTuning(tuning);
+        if (tonalities.length == 0)
+            throw new ConfigurationError(`No tonalities found for accordion tuning: ${tuning}`);
+        const keyboardClosing = KeyboardFactory.createKeyboard(tuning, Bellows.CERRANDO);
+        const keyboardOpening = KeyboardFactory.createKeyboard(tuning, Bellows.ABRIENDO);
+        return new Accordion(tuning, keyboardClosing, keyboardOpening, tonalities);
     }
 }
+AccordionFactory.tonalitiesLoader = new TonalitiesLoader();
 //# sourceMappingURL=AccordionFactory.js.map

package/dist/Accordion/AccordionFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"AccordionFactory.js","sourceRoot":"","sources":["../../src/Accordion/AccordionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAwB,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,UAAU,IAAI,oBAAoB,EAAkB,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAC,eAAe,CAAC,MAAuB;QAC5C,MAAM,UAAU,GACd,oBAAoB,CAAC,MAAM,CACzB,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,eAAe,IAAI,MAAM,CACjD,IAAK,EAAkB,CAAC;QAC3B,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,CACnD,MAAM,EACN,OAAO,CAAC,QAAQ,CACjB,CAAC;QACF,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,CACnD,MAAM,EACN,OAAO,CAAC,QAAQ,CACjB,CAAC;QAEF,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;IAC3E,CAAC;CACF"}
+{"version":3,"file":"AccordionFactory.js","sourceRoot":"","sources":["../../src/Accordion/AccordionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAwB,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAG3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe,CAAC,MAAuB;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAE9D,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC;YACxB,MAAM,IAAI,kBAAkB,CAC1B,6CAA6C,MAAM,EAAE,CACtD,CAAC;QAEJ,MAAM,eAAe,GAAG,eAAe,CAAC,cAAc,CACpD,MAAM,EACN,OAAO,CAAC,QAAQ,CACjB,CAAC;QACF,MAAM,eAAe,GAAG,eAAe,CAAC,cAAc,CACpD,MAAM,EACN,OAAO,CAAC,QAAQ,CACjB,CAAC;QAEF,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IAC7E,CAAC;;AAhCc,iCAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/Accordion/Accordions.d.ts

@@ -1,2 +1,4 @@
-export declare const accordions: import("@Accordion").Accordion[];
+import { Accordion } from "@Accordion";
+import { AccordionTuning } from "@Enums";
+export declare const accordions: Record<AccordionTuning, Accordion>;
 //# sourceMappingURL=Accordions.d.ts.map

package/dist/Accordion/Accordions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Accordions.d.ts","sourceRoot":"","sources":["../../src/Accordion/Accordions.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,UAAU,kCAA2B,CAAC"}
+{"version":3,"file":"Accordions.d.ts","sourceRoot":"","sources":["../../src/Accordion/Accordions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE,SAAS,CAGzD,CAAC"}

package/dist/Accordion/Accordions.js

@@ -1,6 +1,7 @@
-import { AccordionFactory } from "@Accordion";
+import { Accordion, AccordionFactory } from "@Accordion";
 import { AccordionTuning } from "@Enums";
-const fAccordion = AccordionFactory.createAccordion(AccordionTuning.FA);
-const gAccordion = AccordionFactory.createAccordion(AccordionTuning.SOL);
-export const accordions = [fAccordion, gAccordion];
+export const accordions = {
+    [AccordionTuning.FA]: AccordionFactory.createAccordion(AccordionTuning.FA),
+    [AccordionTuning.SOL]: AccordionFactory.createAccordion(AccordionTuning.SOL),
+};
 //# sourceMappingURL=Accordions.js.map

package/dist/Accordion/Accordions.js.map

@@ -1 +1 @@
-{"version":3,"file":"Accordions.js","sourceRoot":"","sources":["../../src/Accordion/Accordions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,MAAM,UAAU,GAAG,gBAAgB,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AACxE,MAAM,UAAU,GAAG,gBAAgB,CAAC,eAAe,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC"}
+{"version":3,"file":"Accordions.js","sourceRoot":"","sources":["../../src/Accordion/Accordions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,MAAM,CAAC,MAAM,UAAU,GAAuC;IAC5D,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;IAC1E,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,eAAe,CAAC,GAAG,CAAC;CAC7E,CAAC"}

package/dist/Basses/Bass.d.ts

@@ -0,0 +1,41 @@
+import type { AccordionTuning, BassType, Bellows } from "@Enums";
+import type { IPosition } from "@Position";
+/**
+ * Abstract base class representing a bass button on a diatonic accordion.
+ *
+ * Bass buttons produce different sounds depending on bellows direction and provide
+ * the harmonic foundation for accordion music. This class defines the common properties
+ * and behavior that all bass types must implement.
+ */
+export declare abstract class Bass {
+    /** The bellows direction (opening or closing) for this bass button */
+    bellows: Bellows;
+    /** The accordion tuning system (e.g., GCF, ADG) that defines this bass */
+    accordionTunning: AccordionTuning;
+    /** The type of bass button (fundamental note or chord) */
+    type: BassType;
+    /** The physical position of the bass button on the accordion */
+    position: IPosition;
+    /**
+     * Creates a new Bass instance.
+     *
+     * @param bellows - The bellows direction for this bass button
+     * @param accordionTunning - The accordion tuning system
+     * @param type - The type of bass (note or chord)
+     * @param position - The physical position on the accordion
+     */
+    constructor(bellows: Bellows, accordionTunning: AccordionTuning, type: BassType, position: IPosition);
+    /**
+     * Gets the English notation representation of this bass.
+     *
+     * @returns The bass notation using English music theory conventions
+     */
+    abstract get englishMetric(): string;
+    /**
+     * Gets the Spanish notation representation of this bass.
+     *
+     * @returns The bass notation using Spanish music theory conventions
+     */
+    abstract get spanishMetric(): string;
+}
+//# sourceMappingURL=Bass.d.ts.map

package/dist/Basses/Bass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bass.d.ts","sourceRoot":"","sources":["../../src/Basses/Bass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,8BAAsB,IAAI;IACxB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IAEjB,0EAA0E;IAC1E,gBAAgB,EAAE,eAAe,CAAC;IAElC,0DAA0D;IAC1D,IAAI,EAAE,QAAQ,CAAC;IAEf,gEAAgE;IAChE,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;OAOG;gBAED,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,eAAe,EACjC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,SAAS;IAQrB;;;;OAIG;IACH,QAAQ,KAAK,aAAa,IAAI,MAAM,CAAC;IAErC;;;;OAIG;IACH,QAAQ,KAAK,aAAa,IAAI,MAAM,CAAC;CACtC"}

package/dist/Basses/Bass.js

@@ -0,0 +1,24 @@
+/**
+ * Abstract base class representing a bass button on a diatonic accordion.
+ *
+ * Bass buttons produce different sounds depending on bellows direction and provide
+ * the harmonic foundation for accordion music. This class defines the common properties
+ * and behavior that all bass types must implement.
+ */
+export class Bass {
+    /**
+     * Creates a new Bass instance.
+     *
+     * @param bellows - The bellows direction for this bass button
+     * @param accordionTunning - The accordion tuning system
+     * @param type - The type of bass (note or chord)
+     * @param position - The physical position on the accordion
+     */
+    constructor(bellows, accordionTunning, type, position) {
+        this.bellows = bellows;
+        this.accordionTunning = accordionTunning;
+        this.type = type;
+        this.position = position;
+    }
+}
+//# sourceMappingURL=Bass.js.map

package/dist/Basses/Bass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bass.js","sourceRoot":"","sources":["../../src/Basses/Bass.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAgB,IAAI;IAaxB;;;;;;;OAOG;IACH,YACE,OAAgB,EAChB,gBAAiC,EACjC,IAAc,EACd,QAAmB;QAEnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CAeF"}

package/dist/Basses/BassChord.d.ts

@@ -0,0 +1,32 @@
+import { type AccordionTuning, type Bellows } from "@Enums";
+import type { IPosition } from "@Position";
+import type { EnglishBassChordMetric, SpanishBassChordMetric } from "@Types";
+import { Bass } from "./Bass";
+/**
+ * Represents a bass chord button on an accordion.
+ * Extends the Bass class to provide chord-specific functionality with both English and Spanish metric notations.
+ */
+export declare class BassChord extends Bass {
+    private _englishMetric;
+    private _spanishMetric;
+    /**
+     * Creates a new BassChord instance.
+     * @param bellows - The bellows direction (opening or closing) for this bass chord.
+     * @param accordionTuning - The tuning system of the accordion.
+     * @param position - The physical position of the bass chord button on the accordion.
+     * @param englishMetric - The English notation for the chord metric.
+     * @param spanishMetric - The Spanish notation for the chord metric.
+     */
+    constructor(bellows: Bellows, accordionTuning: AccordionTuning, position: IPosition, englishMetric: EnglishBassChordMetric, spanishMetric: SpanishBassChordMetric);
+    /**
+     * Gets the English metric notation for this bass chord.
+     * @returns The English metric notation string.
+     */
+    get englishMetric(): string;
+    /**
+     * Gets the Spanish metric notation for this bass chord.
+     * @returns The Spanish metric notation string.
+     */
+    get spanishMetric(): string;
+}
+//# sourceMappingURL=BassChord.d.ts.map

package/dist/Basses/BassChord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BassChord.d.ts","sourceRoot":"","sources":["../../src/Basses/BassChord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;GAGG;AACH,qBAAa,SAAU,SAAQ,IAAI;IACjC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;;;;OAOG;gBAED,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,SAAS,EACnB,aAAa,EAAE,sBAAsB,EACrC,aAAa,EAAE,sBAAsB;IAOvC;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;CACF"}

package/dist/Basses/BassChord.js

@@ -0,0 +1,36 @@
+import { BassType } from "@Enums";
+import { Bass } from "./Bass";
+/**
+ * Represents a bass chord button on an accordion.
+ * Extends the Bass class to provide chord-specific functionality with both English and Spanish metric notations.
+ */
+export class BassChord extends Bass {
+    /**
+     * Creates a new BassChord instance.
+     * @param bellows - The bellows direction (opening or closing) for this bass chord.
+     * @param accordionTuning - The tuning system of the accordion.
+     * @param position - The physical position of the bass chord button on the accordion.
+     * @param englishMetric - The English notation for the chord metric.
+     * @param spanishMetric - The Spanish notation for the chord metric.
+     */
+    constructor(bellows, accordionTuning, position, englishMetric, spanishMetric) {
+        super(bellows, accordionTuning, BassType.Chord, position);
+        this._englishMetric = englishMetric;
+        this._spanishMetric = spanishMetric;
+    }
+    /**
+     * Gets the English metric notation for this bass chord.
+     * @returns The English metric notation string.
+     */
+    get englishMetric() {
+        return this._englishMetric;
+    }
+    /**
+     * Gets the Spanish metric notation for this bass chord.
+     * @returns The Spanish metric notation string.
+     */
+    get spanishMetric() {
+        return this._spanishMetric;
+    }
+}
+//# sourceMappingURL=BassChord.js.map

package/dist/Basses/BassChord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BassChord.js","sourceRoot":"","sources":["../../src/Basses/BassChord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsC,MAAM,QAAQ,CAAC;AAGtE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,IAAI;IAIjC;;;;;;;OAOG;IACH,YACE,OAAgB,EAChB,eAAgC,EAChC,QAAmB,EACnB,aAAqC,EACrC,aAAqC;QAErC,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC1D,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/Basses/BassNote.d.ts

@@ -0,0 +1,37 @@
+import { Bass } from "./Bass";
+import { type AccordionTuning, type Bellows } from "@Enums";
+import type { INote } from "@Notes";
+import type { IPosition } from "@Position";
+/**
+ * Represents a bass note on a diatonic accordion.
+ *
+ * A bass note is a single note played on the bass side of the accordion,
+ * as opposed to a bass chord which plays multiple notes simultaneously.
+ *
+ * @extends Bass
+ */
+export declare class BassNote extends Bass {
+    private _note;
+    /**
+     * Creates a new bass note instance.
+     *
+     * @param bellows - The bellows direction (push or pull) for this bass note
+     * @param accordionTuning - The tuning system of the accordion
+     * @param position - The physical position of this bass note on the keyboard
+     * @param note - The musical note that this bass note represents
+     */
+    constructor(bellows: Bellows, accordionTuning: AccordionTuning, position: IPosition, note: INote);
+    /**
+     * Gets the English metric notation for this bass note.
+     *
+     * @returns The English notation representation of the note
+     */
+    get englishMetric(): string;
+    /**
+     * Gets the Spanish metric notation for this bass note.
+     *
+     * @returns The Spanish notation representation of the note
+     */
+    get spanishMetric(): string;
+}
+//# sourceMappingURL=BassNote.d.ts.map

package/dist/Basses/BassNote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BassNote.d.ts","sourceRoot":"","sources":["../../src/Basses/BassNote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;GAOG;AACH,qBAAa,QAAS,SAAQ,IAAI;IAChC,OAAO,CAAC,KAAK,CAAQ;IAErB;;;;;;;OAOG;gBAED,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK;IAMb;;;;OAIG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;CACF"}

package/dist/Basses/BassNote.js

@@ -0,0 +1,41 @@
+import { Bass } from "./Bass"; //Avoid circular dependency by importing only the base class
+import { BassType } from "@Enums";
+/**
+ * Represents a bass note on a diatonic accordion.
+ *
+ * A bass note is a single note played on the bass side of the accordion,
+ * as opposed to a bass chord which plays multiple notes simultaneously.
+ *
+ * @extends Bass
+ */
+export class BassNote extends Bass {
+    /**
+     * Creates a new bass note instance.
+     *
+     * @param bellows - The bellows direction (push or pull) for this bass note
+     * @param accordionTuning - The tuning system of the accordion
+     * @param position - The physical position of this bass note on the keyboard
+     * @param note - The musical note that this bass note represents
+     */
+    constructor(bellows, accordionTuning, position, note) {
+        super(bellows, accordionTuning, BassType.Note, position);
+        this._note = note;
+    }
+    /**
+     * Gets the English metric notation for this bass note.
+     *
+     * @returns The English notation representation of the note
+     */
+    get englishMetric() {
+        return this._note.englishMetric;
+    }
+    /**
+     * Gets the Spanish metric notation for this bass note.
+     *
+     * @returns The Spanish notation representation of the note
+     */
+    get spanishMetric() {
+        return this._note.spanishMetric;
+    }
+}
+//# sourceMappingURL=BassNote.js.map

package/dist/Basses/BassNote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BassNote.js","sourceRoot":"","sources":["../../src/Basses/BassNote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC,CAAC,4DAA4D;AAC3F,OAAO,EAAE,QAAQ,EAAsC,MAAM,QAAQ,CAAC;AAItE;;;;;;;GAOG;AACH,MAAM,OAAO,QAAS,SAAQ,IAAI;IAGhC;;;;;;;OAOG;IACH,YACE,OAAgB,EAChB,eAAgC,EAChC,QAAmB,EACnB,IAAW;QAEX,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;IAClC,CAAC;CACF"}

package/dist/Basses/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./Bass";
+export * from "./BassChord";
+export * from "./BassNote";
+//# sourceMappingURL=index.d.ts.map

package/dist/Basses/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Basses/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/Basses/index.js

@@ -0,0 +1,4 @@
+export * from "./Bass";
+export * from "./BassChord";
+export * from "./BassNote";
+//# sourceMappingURL=index.js.map

package/dist/Basses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Basses/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/Core/Errors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Custom error types for the diatonico models library.
+ * Enables precise error handling and better error categorization.
+ */
+/**
+ * Base error class for all domain-specific errors.
+ * Extends Error to maintain stack traces and standard error behavior.
+ */
+export declare class DiatonicoError extends Error {
+    /**
+     * Creates a new DiatonicoError instance.
+     * @param message - The error message
+     */
+    constructor(message: string);
+}
+/**
+ * Thrown when a requested resource (note, scale, tonality) cannot be found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const note = findNote(tuning, bellows, position);
+ * } catch (error) {
+ *   if (error instanceof NotFoundError) {
+ *     console.log("Note not available for this configuration");
+ *   }
+ * }
+ * ```
+ */
+export declare class NotFoundError extends DiatonicoError {
+    /**
+     * Creates a new NotFoundError instance.
+     * @param resourceType - The type of resource that wasn't found (e.g., "Note", "Scale")
+     * @param details - Additional context about what was being searched for
+     */
+    constructor(resourceType: string, details: string);
+}
+/**
+ * Thrown when an operation cannot be completed due to missing or incompatible configuration.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const keyboard = KeyboardFactory.createKeyboard(tuning, bellows);
+ * } catch (error) {
+ *   if (error instanceof ConfigurationError) {
+ *     console.log("Configuration not available");
+ *   }
+ * }
+ * ```
+ */
+export declare class ConfigurationError extends DiatonicoError {
+    /**
+     * Creates a new ConfigurationError instance.
+     * @param message - Description of the configuration problem
+     */
+    constructor(message: string);
+}
+//# sourceMappingURL=Errors.d.ts.map

package/dist/Core/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../src/Core/Errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC;;;OAGG;gBACS,OAAO,EAAE,MAAM;CAK5B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C;;;;OAIG;gBACS,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKlD;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD;;;OAGG;gBACS,OAAO,EAAE,MAAM;CAK5B"}

package/dist/Core/Errors.js

@@ -0,0 +1,71 @@
+/**
+ * Custom error types for the diatonico models library.
+ * Enables precise error handling and better error categorization.
+ */
+/**
+ * Base error class for all domain-specific errors.
+ * Extends Error to maintain stack traces and standard error behavior.
+ */
+export class DiatonicoError extends Error {
+    /**
+     * Creates a new DiatonicoError instance.
+     * @param message - The error message
+     */
+    constructor(message) {
+        super(message);
+        this.name = "DiatonicoError";
+        Object.setPrototypeOf(this, DiatonicoError.prototype);
+    }
+}
+/**
+ * Thrown when a requested resource (note, scale, tonality) cannot be found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const note = findNote(tuning, bellows, position);
+ * } catch (error) {
+ *   if (error instanceof NotFoundError) {
+ *     console.log("Note not available for this configuration");
+ *   }
+ * }
+ * ```
+ */
+export class NotFoundError extends DiatonicoError {
+    /**
+     * Creates a new NotFoundError instance.
+     * @param resourceType - The type of resource that wasn't found (e.g., "Note", "Scale")
+     * @param details - Additional context about what was being searched for
+     */
+    constructor(resourceType, details) {
+        super(`${resourceType} not found: ${details}`);
+        this.name = "NotFoundError";
+        Object.setPrototypeOf(this, NotFoundError.prototype);
+    }
+}
+/**
+ * Thrown when an operation cannot be completed due to missing or incompatible configuration.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const keyboard = KeyboardFactory.createKeyboard(tuning, bellows);
+ * } catch (error) {
+ *   if (error instanceof ConfigurationError) {
+ *     console.log("Configuration not available");
+ *   }
+ * }
+ * ```
+ */
+export class ConfigurationError extends DiatonicoError {
+    /**
+     * Creates a new ConfigurationError instance.
+     * @param message - Description of the configuration problem
+     */
+    constructor(message) {
+        super(message);
+        this.name = "ConfigurationError";
+        Object.setPrototypeOf(this, ConfigurationError.prototype);
+    }
+}
+//# sourceMappingURL=Errors.js.map

package/dist/Core/Errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.js","sourceRoot":"","sources":["../../src/Core/Errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC;;;OAGG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C;;;;OAIG;IACH,YAAY,YAAoB,EAAE,OAAe;QAC/C,KAAK,CAAC,GAAG,YAAY,eAAe,OAAO,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD;;;OAGG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/Core/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Core module providing shared utilities, patterns, and type definitions
+ * used throughout the diatonico models library.
+ */
+export * from "./Errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/Core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,UAAU,CAAC"}

package/dist/Core/index.js

@@ -0,0 +1,6 @@
+/**
+ * Core module providing shared utilities, patterns, and type definitions
+ * used throughout the diatonico models library.
+ */
+export * from "./Errors";
+//# sourceMappingURL=index.js.map

package/dist/Core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,UAAU,CAAC"}

package/dist/Data/BassesData.d.ts

@@ -0,0 +1,7 @@
+import { type Bass } from "@Basses";
+import { AccordionTuning, Bellows } from "@Enums";
+type BassesByBellows = Record<Bellows, Bass[]>;
+type BassesByTuning = Record<AccordionTuning, BassesByBellows>;
+export declare const BassesData: BassesByTuning;
+export {};
+//# sourceMappingURL=BassesData.d.ts.map