@jeffy-g/live-midi-types 0.8.2 → 0.9.0

package/dist/ableton-colors.js

@@ -28,5 +28,5 @@ export const abletonColorPalette = "#ff94a6:#ffa529:#cc9927:#f7f47c:#bffb00:#1af
  * @returns {string} Hex color code.
  */
 export function getColorFromIndex(colorIndex) {
-  return abletonColorPalette[colorIndex] ?? "#888"; // fallback gray
+  return abletonColorPalette[colorIndex] ?? "#888";
 }

package/dist/index.d.ts

@@ -1,5 +1,15 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file live-midi-types/src/index.ts
+ */
 export * from "./midi-event.js";
 export * from "./midi-clip.js";
 export * from "./project.js";
 export * from "./ableton-colors.js";
-export declare const version = "v0.8.2";
+export declare const version = "v0.9.0";

package/dist/index.js

@@ -1,5 +1,15 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file live-midi-types/src/index.ts
+ */
 export * from "./midi-event.js";
 export * from "./midi-clip.js";
 export * from "./project.js";
 export * from "./ableton-colors.js";
-export const version = "v0.8.2";
+export const version = "v0.9.0";

package/dist/midi-clip.d.ts

@@ -63,7 +63,17 @@ export type TMidiClipData = {
   ccMap: Record<string, ControlChangeEvent[]>;
   /**
    * Array of extracted control change events. (flatten {@link TMidiClipData.ccMap __`ccMap`__}, sort by time)
+   * + use `flattenCCEventMap` (recommended)
    * @version 0.8.0
+   * @see {@link flattenCCEventMap}
    */
-  cc(): ControlChangeEvent[];
+  cc?(): ControlChangeEvent[];
 };
+/**
+ * @param {Record<string, ControlChangeEvent[]>} ccEventMap
+ * @param {number[]} knownCCEvents
+ */
+export declare const flattenCCEventMap: (ccEventMap: Record<string, ControlChangeEvent[]>, knownCCEvents: number[]) => ControlChangeEvent[];
+/**
+ * @import { ControlChangeEvent } from "./midi-event.ts";
+ */

package/dist/midi-clip.js

@@ -1 +1,47 @@
-export {};
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file src/midi-clip.ts
+ * @summary Common MIDI clip data type for Ableton Live and related tools.
+ */
+/**
+ * @param {Record<string, ControlChangeEvent[]>} ccEventMap
+ * @param {number[]} knownCCEvents
+ */
+const getFlattenSize = (ccEventMap, knownCCEvents) => {
+  var total = 0;
+  for (var idx in knownCCEvents) {
+    total += ccEventMap[knownCCEvents[idx]].length;
+  }
+  return total;
+};
+const warn = console.warn;
+/**
+ * @param {Record<string, ControlChangeEvent[]>} ccEventMap
+ * @param {number[]} knownCCEvents
+ */
+export const flattenCCEventMap = (ccEventMap, knownCCEvents) => {
+  var afterFlattenSize = getFlattenSize(ccEventMap, knownCCEvents);
+  /** @type {ControlChangeEvent[]} */
+  var ccBuffer = Array(afterFlattenSize);
+  var bufferIndex = 0;
+  for (let idx = 0, ccEventsLen = knownCCEvents.length; idx < ccEventsLen;) {
+    let ccEvents = ccEventMap[knownCCEvents[idx++]];
+    for (let eventIndex = 0, ccEventsLen = ccEvents.length; eventIndex < ccEventsLen;) {
+      ccBuffer[bufferIndex++] = ccEvents[eventIndex++];
+    }
+  }
+  if (bufferIndex !== afterFlattenSize) {
+    ccBuffer.length = bufferIndex;
+    warn(`⚠️  flattenCCEventMap: afterFlattenSize=${afterFlattenSize} lastSize=${bufferIndex}`);
+  }
+  return ccBuffer.sort((a, b) => a.time - b.time);
+};
+/**
+ * @import { ControlChangeEvent } from "./midi-event.ts";
+ */

package/dist/midi-event.d.ts

@@ -9,6 +9,16 @@
  * @file src/midi-event.ts
  * @summary Common MIDI event types for Ableton Live and related tools.
  */
+export type BaseEvent = {
+  /**
+   * Time relative to the start of the clip.
+   *
+   * **This is a floating point number representing the time in quarter notes. (Ableton Live)**
+   *
+   * + Beat-based timestamps (e.g. 4.5 = 4 beats and an eighth note)
+   */
+  time: number;
+};
 /**
  * ```
  * // Path to `MidiClip` element
@@ -17,11 +27,7 @@
  * `<MidiClip>/Notes/KeyTracks/KeyTrack[]/Notes/MidiNoteEvent[]`
  * ```
  */
-export type NoteEvent = {
-  /**
-   * NOTE: floating number
-   */
-  time: number;
+export type NoteEvent = BaseEvent & {
   /**
    * NOTE: floating number
    * + quarter-note beats
@@ -38,13 +44,7 @@ export type NoteEvent = {
    */
   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;
+export type ControlChangeEvent = BaseEvent & {
   /**
    * MIDI controller number.
    *
@@ -65,17 +65,33 @@ export type ControlChangeEvent = {
   source?: "curve" | "single";
 };
 /**
- * Tempo event object.
+ * @date 2026/09/14 06:21:51
  */
-export type TempoEvent = {
+export type ChannelPressureEvent = BaseEvent & {
   /**
-   * Time in quarter notes.
+   * `0` to `127`
    *
-   * Beat-based timestamps (e.g. 4.5 = 4 beats and an eighth note)
+   * Value of the ChannelPressure (0-127, floating number).
    */
-  time: number;
+  value: number;
+};
+/**
+ * @date 2026/09/14 06:21:51
+ */
+export type PitchBendEvent = BaseEvent & {
+  /**
+   * `-8192 to 8191` (Live)
+   *
+   * Value of the PitchBend (floating number).
+   */
+  value: number;
+};
+/**
+ * Tempo event object.
+ */
+export type TempoEvent = BaseEvent & {
   /**
-   * Tempo in BPM.
+   * Tempo in BPM. (floating number)
    */
   bpm: number;
 };

package/dist/midi-event.js

@@ -33,7 +33,6 @@ export const eventsIs = (events, type) => {
       return typeof e.pitch === "number" && typeof e.velocity === "number";
     case "cc":
       return typeof e.controller === "number" && typeof e.value === "number";
-    // case "tempo":
     default:
       return typeof e.bpm === "number";
   }

package/package.json

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