@jeffy-g/live-midi-types 0.7.2 → 0.7.3

package/dist/ableton-colors.d.ts

@@ -14,8 +14,8 @@
  */
 export declare const abletonColorPalette: string[];
 /**
- * Get color code from Ableton color index.
- * @param {number} colorIndex Index of Ableton color palette.
+ * Get color code from Ableton Live color index.
+ * @param {number} colorIndex Index of Ableton Live color palette.
  * @returns {string} Hex color code.
  */
 export declare function getColorFromIndex(colorIndex: number): string;

package/dist/ableton-colors.js

@@ -23,8 +23,8 @@ export const abletonColorPalette = "#ff94a6:#ffa529:#cc9927:#f7f47c:#bffb00:#1af
 #af3333:#a95131:#724f41:#dbc300:#85961f:#539f31:#0a9c8e:\
 #236384:#1a2f96:#2f52a2:#624bad:#a34bad:#cc2e6e:#3c3c3c".split(":");
 /**
- * Get color code from Ableton color index.
- * @param {number} colorIndex Index of Ableton color palette.
+ * Get color code from Ableton Live color index.
+ * @param {number} colorIndex Index of Ableton Live color palette.
  * @returns {string} Hex color code.
  */
 export function getColorFromIndex(colorIndex) {

package/dist/index.d.ts

@@ -2,4 +2,4 @@ export * from "./midi-event.js";
 export * from "./midi-clip.js";
 export * from "./project.js";
 export * from "./ableton-colors.js";
-export declare const version = "v0.7.2";
+export declare const version = "v0.7.3";

package/dist/index.js

@@ -2,4 +2,4 @@ export * from "./midi-event.js";
 export * from "./midi-clip.js";
 export * from "./project.js";
 export * from "./ableton-colors.js";
-export const version = "v0.7.2";
+export const version = "v0.7.3";

package/dist/project.d.ts

@@ -11,6 +11,9 @@
 import type { TempoEvent } from "./midi-event.ts";
 export type TClipSummary<T extends Record<string, any>> = {
   /**
+   * Original MidiClip Id
+   * + This is always a simple number.
+   *
    * ```js
    * // e.g
    * "/Ableton/LiveSet/Tracks/MidiTrack[4]/DeviceChain/MainSequencer/ClipTimeable/ArrangerAutomation/Events/MidiClip[3]/@Id"
@@ -19,20 +22,54 @@ export type TClipSummary<T extends Record<string, any>> = {
    */
   originId: string;
   /**
-   * ID assigned for use in UI etc.
+   * An ID to be assigned for use in UI and other applications.
    *
    * ```
+   * // e.g.
    * "clip-" + crypto.randomUUID()
    * ```
    */
   id: string;
+  /**
+   * Live color palette index
+   * + This value is always the index of the color palette.
+   * ```
+   * // e.g. xpath
+   * "/Ableton/LiveSet/Tracks/MidiTrack/DeviceChain/MainSequencer/ClipTimeable/ArrangerAutomation/Events/MidiClip/Color/@Value"
+   *
+   * // how to actual color
+   * // "0" or "12" to "#ff94a6" / "#e553a0"
+   * const hexColor = getColorFromIndex(+clip.color);
+   * ```
+   *
+   * @see {@link getColorFromIndex}
+   */
   color: string;
   /**
    * Disabled property for the clip.
    */
   disabled: boolean;
+  /**
+   * Original MidiClip name
+   *
+   * ```js
+   * // e.g
+   * "/Ableton/LiveSet/Tracks/MidiTrack/DeviceChain/MainSequencer/ClipTimeable/ArrangerAutomation/Events/MidiClip/Name/@Value"
+   * ```
+   */
   clipName: string;
+  /**
+   * Parent track name
+   */
   trackName: string;
+  /**
+   * Annotation of this MidiClip.
+   * + It seems that any value can be stored if it's a text value.
+   * ```js
+   * // e.g
+   * "/Ableton/LiveSet/Tracks/MidiTrack/DeviceChain/MainSequencer/ClipTimeable/ArrangerAutomation/Events/MidiClip/Annotation/@Value"
+   * ```
+   */
   annotations?: string;
 } & T;
 export type TTrackInfo<T extends Record<string, any>> = {
@@ -44,9 +81,47 @@ export type TTrackInfo<T extends Record<string, any>> = {
    * @date 2026/07/02
    */
   originId: string;
+  /**
+   * An ID to be assigned for use in UI and other applications.
+   *
+   * ```
+   * // e.g.
+   * "clip-" + crypto.randomUUID()
+   * ```
+   */
   id: string;
+  /**
+   * Original Track name
+   *
+   * ```js
+   * // e.g MidiTrack
+   * "/Ableton/LiveSet/Tracks/MidiTrack/Name/EffectiveName/@Value"
+   * ```
+   */
   name: string;
+  /**
+   * Live color palette index
+   * + This value is always the index of the color palette.
+   * ```
+   * // e.g. xpath (MidiTrack)
+   * "/Ableton/LiveSet/Tracks/MidiTrack/Color/@Value"
+   *
+   * // how to actual color
+   * // "0" or "12" to "#ff94a6" / "#e553a0"
+   * const hexColor = getColorFromIndex(+clip.color);
+   * ```
+   *
+   * @see {@link getColorFromIndex}
+   */
   color: string;
+  /**
+   * Annotation of this MidiClip.
+   * + It seems that any value can be stored if it's a text value.
+   * ```js
+   * // e.g (MidiTrack)
+   * "/Ableton/LiveSet/Tracks/MidiTrack/Name/Annotation/@Value"
+   * ```
+   */
   annotations?: string;
   /**
    * ```
@@ -63,6 +138,7 @@ export type TParsedAbletonLiveSet<T extends Record<string, any>> = {
   alsName: string;
   /**
    * ppq (ticks per quarter note)
+   * + This value is not available in `ALS`, but it is set on the application side.
    */
   ticksPerQuarter: number;
   /**
@@ -72,6 +148,11 @@ export type TParsedAbletonLiveSet<T extends Record<string, any>> = {
   tracks: TTrackInfo<T>[];
   /**
    * Tempo automation events.
+   * + Retrieving tempo event data is a bit complicated.
+   * ```
+   * // Specific XPath examples (live 12.x)
+   * "/Ableton/LiveSet/MasterTrack/AutomationEnvelopes/Envelopes/AutomationEnvelope[2]/Automation/Events"
+   * ```
    */
   tempoAutomation: TempoEvent[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeffy-g/live-midi-types",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Common TypeScript types for Ableton Live MIDI clip and event data.",
   "type": "module",
   "main": "dist/index.js",