@jeffy-g/live-midi-types 0.11.1 → 0.11.3

package/dist/index.d.ts

@@ -12,4 +12,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.11.1";
+export declare const version = "v0.11.3";

package/dist/index.js

@@ -12,4 +12,4 @@ export * from "./midi-event.js";
 export * from "./midi-clip.js";
 export * from "./project.js";
 export * from "./ableton-colors.js";
-export const version = "v0.11.1";
+export const version = "v0.11.3";

package/dist/midi-clip.d.ts

@@ -46,6 +46,9 @@ export type TMidiClipData<GRawData = never> = {
    * Time adjustment for tempo mapping (in beats).
    */
   adjustTimeOftempee: number;
+  /**
+   * @since v0.11.1
+   */
   programChange: number;
   /**
    * CC numbers known to this clip, sorted in ascending order.
@@ -59,7 +62,7 @@ export type TMidiClipData<GRawData = never> = {
   notes: NoteEvent[];
   /**
    * Control change event map. (key: cc number, `0..127`)
-   * @version 0.8.0
+   * @since v0.8.0
    */
   ccMap: {
     [ccNumber: `${number}`]: ControlChangeEvent[];
@@ -67,7 +70,7 @@ export type TMidiClipData<GRawData = never> = {
   /**
    * Array of extracted control change events. (flatten {@link TMidiClipData.ccMap __`ccMap`__}, sort by time)
    * + use `flattenCCEventMap` (recommended)
-   * @version 0.8.0
+   * @since v0.8.0
    * @see {@link flattenCCEventMap}
    */
   cc?(): ControlChangeEvent[];

package/dist/midi-clip.js

@@ -20,7 +20,6 @@ const getFlattenSize = (ccEventMap, knownCCEvents) => {
   }
   return total;
 };
-const warn = console.warn;
 /**
  * @param {Record<string, ControlChangeEvent[]>} ccEventMap
  * @param {number[]} knownCCEvents
@@ -28,7 +27,7 @@ const warn = console.warn;
 export const flattenCCEventMap = (ccEventMap, knownCCEvents) => {
   var afterFlattenSize = getFlattenSize(ccEventMap, knownCCEvents);
   /** @type {ControlChangeEvent[]} */
-  var ccBuffer = Array(afterFlattenSize);
+  var ccBuffer = Array(afterFlattenSize).fill(undefined);
   var bufferIndex = 0;
   for (let idx = 0, ccEventsLen = knownCCEvents.length; idx < ccEventsLen;) {
     let ccEvents = ccEventMap[knownCCEvents[idx++]];
@@ -38,7 +37,7 @@ export const flattenCCEventMap = (ccEventMap, knownCCEvents) => {
   }
   if (bufferIndex !== afterFlattenSize) {
     ccBuffer.length = bufferIndex;
-    warn(`⚠️  flattenCCEventMap: afterFlattenSize=${afterFlattenSize} lastSize=${bufferIndex}`);
+    console.warn(`⚠️  flattenCCEventMap: afterFlattenSize=${afterFlattenSize} lastSize=${bufferIndex}`);
   }
   return ccBuffer.sort((a, b) => a.time - b.time);
 };

package/dist/midi10-smf-types.d.ts

@@ -11,12 +11,29 @@
  * @file src/midi10-smf-types.ts
  */
 import type { ESMFEventType } from "./ESMFEventType.ts";
+/**
+ * Standard MIDI File `MThd` header fields.
+ *
+ * Choose either `ticksPerBeat` for musical timing or `framesPerSecond` and
+ * `ticksPerFrame` for SMPTE timing. The optional `timeDivision` supplies the
+ * encoded 16-bit division word directly when writing.
+ *
+ * @see ./midi10-header.md for field details and parser/writer behavior.
+ */
 export interface MidiHeader {
+  /** SMF organization: `0` for one track, `1` for synchronous tracks, or `2` for independent sequences. */
   format: 0 | 1 | 2;
+  /** Number of `MTrk` chunks reported by the header when parsing. */
   numTracks: number;
+  /**
+   * Optional raw, unsigned 16-bit division word; takes precedence when writing. (__`0 - 32767`__)
+   */
   timeDivision?: number;
+  /** SMPTE frames per second; use with `ticksPerFrame`. */
   framesPerSecond?: number;
+  /** Number of ticks in one SMPTE frame; use with `framesPerSecond`. */
   ticksPerFrame?: number;
+  /** Number of ticks in one quarter note (PPQ); alternative to SMPTE timing. */
   ticksPerBeat?: number;
 }
 export type TextEventTypesUnion = ESMFEventType.text | ESMFEventType.copyrightNotice | ESMFEventType.trackName | ESMFEventType.instrumentName | ESMFEventType.lyrics | ESMFEventType.marker | ESMFEventType.cuePoint;

package/dist/project.d.ts

@@ -158,7 +158,7 @@ export type TGeneralTrack<T extends Record<string, any>> = TTrackInfo<T> | TMidi
 /**
  * Parsed data required by the Ableton Live project UI.
  */
-export type TParsedAbletonLiveSet<T extends Record<string, any>> = {
+export type TParsedAbletonLiveSet<GTrackType = TGeneralTrack<Record<string, any>>> = {
   /**
    * Ableton Live project name.
    *
@@ -191,7 +191,7 @@ export type TParsedAbletonLiveSet<T extends Record<string, any>> = {
    * }
    * ```
    */
-  tracks: Array<TGeneralTrack<T>>;
+  tracks: GTrackType[];
   /**
    * Tempo automation events extracted from the master track.
    *

package/package.json

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