@jeffy-g/live-midi-types 0.1.0 → 0.2.0

package/dist/ableton-colors.js

@@ -13,16 +13,76 @@
  * @date 2025/6/27 4:51:48
  */
 export const abletonColorPalette = [
-    "#ff94a6", "#ffa529", "#cc9927", "#f7f47c", "#bffb00", "#1aff2f", "#25ffa8",
-    "#5cffe8", "#8bc5ff", "#5480e4", "#92a7ff", "#d86ce4", "#e553a0", "#ffffff",
-    "#ff3636", "#f66c03", "#99724b", "#fff034", "#87ff67", "#3dc300", "#00bfaf",
-    "#19e9ff", "#10a4ee", "#007dc0", "#886ce4", "#b677c6", "#ff39d4", "#d0d0d0",
-    "#e2675a", "#ffa374", "#d3ad71", "#edffae", "#d2e498", "#bad074", "#9bc48d",
-    "#d4fde1", "#cdf1f8", "#b9c1e3", "#cdbbe4", "#ae98e5", "#e5dce1", "#a9a9a9",
-    "#c6928b", "#b78256", "#99836a", "#bfba69", "#a6be00", "#7db04d", "#88c2ba",
-    "#9bb3c4", "#85a5c2", "#8393cc", "#a595b5", "#bf9fbe", "#bc7196", "#7b7b7b",
-    "#af3333", "#a95131", "#724f41", "#dbc300", "#85961f", "#539f31", "#0a9c8e",
-    "#236384", "#1a2f96", "#2f52a2", "#624bad", "#a34bad", "#cc2e6e", "#3c3c3c"
+  "#ff94a6",
+  "#ffa529",
+  "#cc9927",
+  "#f7f47c",
+  "#bffb00",
+  "#1aff2f",
+  "#25ffa8",
+  "#5cffe8",
+  "#8bc5ff",
+  "#5480e4",
+  "#92a7ff",
+  "#d86ce4",
+  "#e553a0",
+  "#ffffff",
+  "#ff3636",
+  "#f66c03",
+  "#99724b",
+  "#fff034",
+  "#87ff67",
+  "#3dc300",
+  "#00bfaf",
+  "#19e9ff",
+  "#10a4ee",
+  "#007dc0",
+  "#886ce4",
+  "#b677c6",
+  "#ff39d4",
+  "#d0d0d0",
+  "#e2675a",
+  "#ffa374",
+  "#d3ad71",
+  "#edffae",
+  "#d2e498",
+  "#bad074",
+  "#9bc48d",
+  "#d4fde1",
+  "#cdf1f8",
+  "#b9c1e3",
+  "#cdbbe4",
+  "#ae98e5",
+  "#e5dce1",
+  "#a9a9a9",
+  "#c6928b",
+  "#b78256",
+  "#99836a",
+  "#bfba69",
+  "#a6be00",
+  "#7db04d",
+  "#88c2ba",
+  "#9bb3c4",
+  "#85a5c2",
+  "#8393cc",
+  "#a595b5",
+  "#bf9fbe",
+  "#bc7196",
+  "#7b7b7b",
+  "#af3333",
+  "#a95131",
+  "#724f41",
+  "#dbc300",
+  "#85961f",
+  "#539f31",
+  "#0a9c8e",
+  "#236384",
+  "#1a2f96",
+  "#2f52a2",
+  "#624bad",
+  "#a34bad",
+  "#cc2e6e",
+  "#3c3c3c",
 ];
 /**
  * Get color code from Ableton color index.
@@ -30,5 +90,5 @@ export const abletonColorPalette = [
  * @returns {string} Hex color code.
  */
 export function getColorFromIndex(colorIndex) {
-    return abletonColorPalette[colorIndex] ?? "#888"; // fallback gray
+  return abletonColorPalette[colorIndex] ?? "#888"; // fallback gray
 }

package/dist/midi-clip.d.ts

@@ -22,32 +22,24 @@ import type { NoteEvent, ControlChangeEvent } from "./midi-event";
  * ```
  */
 export type TMidiClipData = {
-    /**
-     * Start position of the clip on the Live MidiTrack (in beats).
-     */
-    clipStartInBeats: number;
-    /**
-     * Length of the clip (in beats).
-     */
-    clipLength: number;
-    /**
-     * Time adjustment for tempo mapping (in beats).
-     */
-    adjustTimeOftempee: number;
-    /**
-     * color for visualization (Color table index)
-     */
-    color: string;
-    /**
-     * Disabled property for the clip.
-     */
-    disabled: boolean;
-    /**
-     * Array of extracted note events.
-     */
-    notes: NoteEvent[];
-    /**
-     * Array of extracted control change events.
-     */
-    cc: ControlChangeEvent[];
+  /**
+   * Start position of the clip on the Live MidiTrack (in beats).
+   */
+  clipStartInBeats: number;
+  /**
+   * Length of the clip (in beats). Usually `CurrentEnd.Value - CurrentStart.Value`.
+   */
+  clipLength: number;
+  /**
+   * Time adjustment for tempo mapping (in beats).
+   */
+  adjustTimeOftempee: number;
+  /**
+   * Array of extracted note events.
+   */
+  notes: NoteEvent[];
+  /**
+   * Array of extracted control change events.
+   */
+  cc: ControlChangeEvent[];
 };

package/dist/midi-event.d.ts

@@ -10,57 +10,57 @@
  * @summary Common MIDI event types for Ableton Live and related tools.
  */
 export type NoteEvent = {
-    /**
-     * NOTE: floating number
-     */
-    time: number;
-    /**
-     * NOTE: floating number
-     */
-    duration: number;
-    pitch: number;
-    /**
-     * `0` to `127`
-     * NOTE: floating number
-     */
-    velocity: number;
+  /**
+   * NOTE: floating number
+   */
+  time: number;
+  /**
+   * NOTE: floating number
+   */
+  duration: number;
+  pitch: number;
+  /**
+   * `0` to `127`
+   * NOTE: floating number
+   */
+  velocity: number;
 };
 export type ControlChangeEvent = {
-    /**
-     * Time relative to the start of the clip.
-     *
-     * **This is a floating point number representing the time in quarter notes. (Ableton Live)**
-     */
-    time: number;
-    /**
-     * MIDI controller number.
-     */
-    controller: number;
-    /**
-     * `0` to `127`
-     *
-     * Value of the controller (0-127, may be float).
-     */
-    value: number;
-    /**
-     * Source type: "curve" for interpolated, "single" for discrete.
-     */
-    source?: "curve" | "single";
+  /**
+   * Time relative to the start of the clip.
+   *
+   * **This is a floating point number representing the time in quarter notes. (Ableton Live)**
+   */
+  time: number;
+  /**
+   * MIDI controller number.
+   */
+  controller: number;
+  /**
+   * `0` to `127`
+   *
+   * Value of the controller (0-127, may be float).
+   */
+  value: number;
+  /**
+   * Source type: "curve" for interpolated, "single" for discrete.
+   */
+  source?: "curve" | "single";
 };
 /**
  * Tempo event object.
  */
 export type TempoEvent = {
-    /**
-     * Time in quarter notes.
-     *
-     * 拍ベースのタイムスタンプ（例：4.5 = 4拍と8分音符）
-     */
-    time: number;
-    /**
-     * Tempo in BPM.
-     *
-     * この地点でのテンポ（BPM）
-     */
-    bpm: number;
+  /**
+   * Time in quarter notes.
+   *
+   * 拍ベースのタイムスタンプ（例：4.5 = 4拍と8分音符）
+   */
+  time: number;
+  /**
+   * Tempo in BPM.
+   *
+   * この地点でのテンポ（BPM）
+   */
+  bpm: number;
 };

package/dist/project.d.ts

@@ -8,29 +8,48 @@
 /**
  * @file src/project.ts
  */
-export type TMidiClipSummary<T extends Record<string, any>> = {
-    /**
-     * UI などで使用する時のために付与される ID
-     *
-     * ```
-     * "clip-" + createUUID().toUpperCase()
-     * ```
-     */
-    id: string;
-    clipName: string;
-    trackName: string;
+export type TClipSummary<T extends Record<string, any>> = {
+  /**
+   * UI などで使用する時のために付与される ID
+   *
+   * ```
+   * "clip-" + createUUID().toUpperCase()
+   * ```
+   */
+  id: string;
+  color: string;
+  /**
+   * Disabled property for the clip.
+   */
+  disabled: boolean;
+  clipName: string;
+  trackName: string;
+  annotations?: string;
 } & T;
 export type TTrackInfo<T extends Record<string, any>> = {
-    name: string;
-    color: string;
-    /**
-     * ```
-     * Record<"clipName", TMidiClipSummary>
-     * ```
-     */
-    clips: Record<string, TMidiClipSummary<T>>;
+  name: string;
+  color: string;
+  annotations?: string;
+  /**
+   * ```
+   * Record<"clipName", TMidiClipSummary>
+   * ```
+   */
+  clips: Record<string, TClipSummary<T>>;
 };
 export type TParsedLiveAlsProject<T extends Record<string, any>> = {
-    ticksPerQuarter: number;
-    tracks: TTrackInfo<T>[];
+  /**
+   * Ableton Live のプロジェクト名
+   * 通常、拡張子を除いた als file name.
+   */
+  alsName: string;
+  /**
+   * ppq (ticks per quarter note)
+   */
+  ticksPerQuarter: number;
+  /**
+   * Tracks in the project.
+   * NOTE: currently, this is a Midi tracks only.
+   */
+  tracks: TTrackInfo<T>[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeffy-g/live-midi-types",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Common TypeScript types for Ableton Live MIDI clip and event data.",
   "type": "module",
   "main": "dist/index.js",
@@ -30,6 +30,7 @@
   ],
   "scripts": {
     "prebuild": "rimraf -g ./dist/*",
+    "format": "prettier --tab-width 2 -w \"./dist/**/*\"",
     "build": "tsc",
     "watch": "tsc -w"
   }