@libraz/libsonare 1.3.1 → 1.3.3

package/src/realtime_engine.ts

@@ -1,5 +1,7 @@
+import { ErrorCode, SonareError } from './errors';
 import { getSonareModule } from './module_state';
 import type { SynthPatch } from './project';
+import type { EqBand } from './public_types';
 import type {
   WasmClipPageRequest,
   WasmEngineAutomationPoint,
@@ -16,6 +18,8 @@ import type {
   WasmEngineParameterInfo,
   WasmEngineProcessWithMonitorResult,
   WasmEngineTelemetry,
+  WasmEngineTempoSegment,
+  WasmEngineTimeSignatureSegment,
   WasmEngineTransportState,
   WasmRealtimeEngine,
 } from './sonare.js';
@@ -35,6 +39,49 @@ export type EngineFreezeResult = WasmEngineFreezeResult;
 export type EngineTelemetry = WasmEngineTelemetry;
 export type EngineMeterTelemetry = WasmEngineMeterTelemetry;
 export type EngineTransportState = WasmEngineTransportState;
+export type EngineTempoSegment = WasmEngineTempoSegment;
+export type EngineTimeSignatureSegment = WasmEngineTimeSignatureSegment;
+
+export interface EngineTrackSend {
+  busId: number;
+  levelDb?: number;
+  enabled?: boolean;
+}
+
+export interface EngineTrackLane {
+  trackId: number;
+  sends?: EngineTrackSend[];
+}
+
+export interface EngineBus {
+  busId: number;
+  gainDb?: number;
+}
+
+export interface EngineMidiEvent {
+  renderFrame: number;
+  word0?: number;
+  word1?: number;
+  word2?: number;
+  word3?: number;
+  wordCount?: number;
+  group?: number;
+  sysexHandle?: number;
+  data0?: number;
+  data1?: number;
+}
+
+export interface EngineMidiClipSchedule {
+  id?: number;
+  trackId?: number;
+  destinationId?: number;
+  startSample?: number;
+  startPpq?: number;
+  lengthSamples?: number;
+  loop?: boolean;
+  loopLengthSamples?: number;
+  events: EngineMidiEvent[];
+}
 
 export const EXPECTED_ENGINE_ABI_VERSION = 3;
 
@@ -75,91 +122,9 @@ export function engineCapabilities(): EngineCapabilities {
   };
 }
 
-// Methods added to the embind RealtimeEngine that the generated `sonare.js`
-// declarations only gain after a WASM rebuild. The native handle is cast to this
-// shape so the wrapper can reach them without a stale type error.
-interface WasmRealtimeEngineExt {
-  setBuiltinInstrument: (destinationId: number, config: object) => void;
-  setSynthInstrument: (destinationId: number, patch: object | string) => void;
-  loadSoundFont: (data: Uint8Array) => void;
-  setSf2Instrument: (destinationId: number, config: object) => void;
-  clearMidiInstrument: (destinationId: number) => void;
-  midiInstrumentCount: () => number;
-  bindMidiCc: (
-    channel: number,
-    controller: number,
-    paramId: number,
-    minValue: number,
-    maxValue: number,
-  ) => void;
-  clearMidiCcBindings: () => void;
-  midiCcBindingCount: () => number;
-  setMidiFx: (destinationId: number, configJson: string) => void;
-  clearMidiFx: (destinationId: number) => void;
-  setMidiInputSource: (destinationId: number) => void;
-  clearMidiInputSource: () => void;
-  midiInputPendingCount: () => number;
-  createClipPageProvider: (numChannels: number, numSamples: number, pageFrames: number) => number;
-  supplyClipPage: (providerId: number, pageIndex: number, channels: Float32Array[]) => void;
-  clearClipPage: (providerId: number, pageIndex: number) => void;
-  destroyClipPageProvider: (providerId: number) => void;
-  popClipPageRequest: () => ClipPageRequest | null;
-  pushMidiInputNoteOn: (
-    group: number,
-    channel: number,
-    note: number,
-    velocity: number,
-    portTimeSamples: number,
-  ) => void;
-  pushMidiInputNoteOff: (
-    group: number,
-    channel: number,
-    note: number,
-    velocity: number,
-    portTimeSamples: number,
-  ) => void;
-  pushMidiInputCc: (
-    group: number,
-    channel: number,
-    controller: number,
-    value: number,
-    portTimeSamples: number,
-  ) => void;
-  pushMidiNoteOn: (
-    destinationId: number,
-    group: number,
-    channel: number,
-    note: number,
-    velocity: number,
-    renderFrame: number,
-  ) => void;
-  pushMidiNoteOff: (
-    destinationId: number,
-    group: number,
-    channel: number,
-    note: number,
-    velocity: number,
-    renderFrame: number,
-  ) => void;
-  pushMidiCc: (
-    destinationId: number,
-    group: number,
-    channel: number,
-    controller: number,
-    value: number,
-    renderFrame: number,
-  ) => void;
-  pushMidiPanic: (renderFrame: number) => void;
-  clearParameters: () => void;
-}
-
 export class RealtimeEngine {
   private native: WasmRealtimeEngine;
 
-  private nativeExt(): WasmRealtimeEngineExt {
-    return this.native as unknown as WasmRealtimeEngineExt;
-  }
-
   constructor(
     sampleRate = 48000,
     maxBlockSize = 128,
@@ -200,11 +165,19 @@ export class RealtimeEngine {
     this.native.setParameterSmoothed(paramId, value, renderFrame);
   }
 
+  setSoloMute(laneIndex: number, solo: boolean, mute: boolean, renderFrame = -1): void {
+    this.native.setSoloMute(laneIndex, solo, mute, renderFrame);
+  }
+
+  setMidiClips(clips: readonly EngineMidiClipSchedule[]): void {
+    this.native.setMidiClips(clips);
+  }
+
   setBuiltinInstrument(
     config: { destinationId?: number } & Record<string, unknown> = {},
     destinationId = config.destinationId ?? 0,
   ): void {
-    this.nativeExt().setBuiltinInstrument(destinationId, config);
+    this.native.setBuiltinInstrument(destinationId, config);
   }
 
   /**
@@ -220,7 +193,7 @@ export class RealtimeEngine {
     patch: SynthPatch | string = {},
     destinationId = (typeof patch === 'object' ? patch.destinationId : undefined) ?? 0,
   ): void {
-    this.nativeExt().setSynthInstrument(destinationId, patch);
+    this.native.setSynthInstrument(destinationId, patch);
   }
 
   /**
@@ -230,7 +203,7 @@ export class RealtimeEngine {
    * not referenced afterwards. Replaces any previously loaded SoundFont.
    */
   loadSoundFont(data: Uint8Array): void {
-    this.nativeExt().loadSoundFont(data);
+    this.native.loadSoundFont(data);
   }
 
   /**
@@ -246,15 +219,15 @@ export class RealtimeEngine {
     config: { destinationId?: number; gain?: number; polyphony?: number } = {},
     destinationId = config.destinationId ?? 0,
   ): void {
-    this.nativeExt().setSf2Instrument(destinationId, config);
+    this.native.setSf2Instrument(destinationId, config);
   }
 
   clearMidiInstrument(destinationId = 0): void {
-    this.nativeExt().clearMidiInstrument(destinationId);
+    this.native.clearMidiInstrument(destinationId);
   }
 
   midiInstrumentCount(): number {
-    return this.nativeExt().midiInstrumentCount();
+    return this.native.midiInstrumentCount();
   }
 
   /**
@@ -268,7 +241,7 @@ export class RealtimeEngine {
     paramId: number,
     options: MidiCcBindOptions = {},
   ): void {
-    this.nativeExt().bindMidiCc(
+    this.native.bindMidiCc(
       channel,
       controller,
       paramId,
@@ -278,33 +251,33 @@ export class RealtimeEngine {
   }
 
   clearMidiCcBindings(): void {
-    this.nativeExt().clearMidiCcBindings();
+    this.native.clearMidiCcBindings();
   }
 
   midiCcBindingCount(): number {
-    return this.nativeExt().midiCcBindingCount();
+    return this.native.midiCcBindingCount();
   }
 
   /** Install/replace a live non-destructive MIDI-FX insert for one destination. */
   setMidiFx(destinationId: number, configJson: string): void {
-    this.nativeExt().setMidiFx(destinationId, configJson);
+    this.native.setMidiFx(destinationId, configJson);
   }
 
   clearMidiFx(destinationId = 0): void {
-    this.nativeExt().clearMidiFx(destinationId);
+    this.native.clearMidiFx(destinationId);
   }
 
   /** Enable the engine-owned live MIDI input source for a destination. */
   setMidiInputSource(destinationId = 0): void {
-    this.nativeExt().setMidiInputSource(destinationId);
+    this.native.setMidiInputSource(destinationId);
   }
 
   clearMidiInputSource(): void {
-    this.nativeExt().clearMidiInputSource();
+    this.native.clearMidiInputSource();
   }
 
   midiInputPendingCount(): number {
-    return this.nativeExt().midiInputPendingCount();
+    return this.native.midiInputPendingCount();
   }
 
   pushMidiInputNoteOn(
@@ -314,7 +287,7 @@ export class RealtimeEngine {
     velocity: number,
     portTimeSamples = 0,
   ): void {
-    this.nativeExt().pushMidiInputNoteOn(group, channel, note, velocity, portTimeSamples);
+    this.native.pushMidiInputNoteOn(group, channel, note, velocity, portTimeSamples);
   }
 
   pushMidiInputNoteOff(
@@ -324,7 +297,7 @@ export class RealtimeEngine {
     velocity = 0,
     portTimeSamples = 0,
   ): void {
-    this.nativeExt().pushMidiInputNoteOff(group, channel, note, velocity, portTimeSamples);
+    this.native.pushMidiInputNoteOff(group, channel, note, velocity, portTimeSamples);
   }
 
   pushMidiInputCc(
@@ -334,7 +307,7 @@ export class RealtimeEngine {
     value: number,
     portTimeSamples = 0,
   ): void {
-    this.nativeExt().pushMidiInputCc(group, channel, controller, value, portTimeSamples);
+    this.native.pushMidiInputCc(group, channel, controller, value, portTimeSamples);
   }
 
   pushMidiNoteOn(
@@ -345,7 +318,7 @@ export class RealtimeEngine {
     velocity: number,
     renderFrame = -1,
   ): void {
-    this.nativeExt().pushMidiNoteOn(destinationId, group, channel, note, velocity, renderFrame);
+    this.native.pushMidiNoteOn(destinationId, group, channel, note, velocity, renderFrame);
   }
 
   pushMidiNoteOff(
@@ -356,7 +329,7 @@ export class RealtimeEngine {
     velocity = 0,
     renderFrame = -1,
   ): void {
-    this.nativeExt().pushMidiNoteOff(destinationId, group, channel, note, velocity, renderFrame);
+    this.native.pushMidiNoteOff(destinationId, group, channel, note, velocity, renderFrame);
   }
 
   /**
@@ -373,7 +346,7 @@ export class RealtimeEngine {
     value: number,
     renderFrame = -1,
   ): void {
-    this.nativeExt().pushMidiCc(destinationId, group, channel, controller, value, renderFrame);
+    this.native.pushMidiCc(destinationId, group, channel, controller, value, renderFrame);
   }
 
   /**
@@ -381,7 +354,7 @@ export class RealtimeEngine {
    * `renderFrame` (-1 = immediate). Mirrors the C-ABI `pushMidiPanic`.
    */
   pushMidiPanic(renderFrame = -1): void {
-    this.nativeExt().pushMidiPanic(renderFrame);
+    this.native.pushMidiPanic(renderFrame);
   }
 
   /**
@@ -389,7 +362,7 @@ export class RealtimeEngine {
    * only; not realtime-safe. Mirrors the C-ABI `clearParameters`.
    */
   clearParameters(): void {
-    this.nativeExt().clearParameters();
+    this.native.clearParameters();
   }
 
   /** Read back the current transport state snapshot. */
@@ -417,10 +390,22 @@ export class RealtimeEngine {
     this.native.setTempo(bpm);
   }
 
+  setTempoSegments(segments: readonly EngineTempoSegment[]): void {
+    this.native.setTempoSegments([...segments]);
+  }
+
   setTimeSignature(numerator: number, denominator: number): void {
     this.native.setTimeSignature(numerator, denominator);
   }
 
+  setTimeSignatureSegments(segments: readonly EngineTimeSignatureSegment[]): void {
+    this.native.setTimeSignatureSegments([...segments]);
+  }
+
+  sampleAtPpq(ppq: number): number {
+    return Number(this.native.sampleAtPpq(ppq));
+  }
+
   setLoop(startPpq: number, endPpq: number, enabled = true): void {
     this.native.setLoop(startPpq, endPpq, enabled);
   }
@@ -513,29 +498,109 @@ export class RealtimeEngine {
     return this.native.clipCount();
   }
 
+  setTrackLanes(lanes: Array<number | EngineTrackLane>): void {
+    this.native.setTrackLanes(
+      lanes.map((lane) => (typeof lane === 'number' ? { trackId: lane } : lane)),
+    );
+  }
+
+  setTrackBuses(buses: EngineBus[]): void {
+    this.native.setTrackBuses(buses);
+  }
+
+  setBusStripJson(busId: number, sceneJson: string): void {
+    try {
+      JSON.parse(sceneJson);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'invalid bus strip JSON';
+      throw new SonareError(ErrorCode.InvalidFormat, 'InvalidFormat', message);
+    }
+    this.native.setBusStripJson(busId, sceneJson);
+  }
+
+  setTrackStripJson(trackId: number, sceneJson: string): void {
+    try {
+      JSON.parse(sceneJson);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'invalid track strip JSON';
+      throw new SonareError(ErrorCode.InvalidFormat, 'InvalidFormat', message);
+    }
+    this.native.setTrackStripJson(trackId, sceneJson);
+  }
+
+  setTrackStripEqBand(trackId: number, bandIndex: number, band: EqBand | string): void {
+    this.native.setTrackStripEqBandJson(
+      trackId,
+      bandIndex,
+      typeof band === 'string' ? band : JSON.stringify(band),
+    );
+  }
+
+  setTrackStripEqBandJson(trackId: number, bandIndex: number, bandJson: string): void {
+    this.native.setTrackStripEqBandJson(trackId, bandIndex, bandJson);
+  }
+
+  setTrackStripInsertBypassed(
+    trackId: number,
+    insertIndex: number,
+    bypassed: boolean,
+    resetOnBypass = false,
+  ): void {
+    this.native.setTrackStripInsertBypassed(trackId, insertIndex, bypassed, resetOnBypass);
+  }
+
+  setMasterStripJson(sceneJson: string): void {
+    try {
+      JSON.parse(sceneJson);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'invalid master strip JSON';
+      throw new SonareError(ErrorCode.InvalidFormat, 'InvalidFormat', message);
+    }
+    this.native.setMasterStripJson(sceneJson);
+  }
+
+  setMasterStripEqBand(bandIndex: number, band: EqBand | string): void {
+    this.native.setMasterStripEqBandJson(
+      bandIndex,
+      typeof band === 'string' ? band : JSON.stringify(band),
+    );
+  }
+
+  setMasterStripEqBandJson(bandIndex: number, bandJson: string): void {
+    this.native.setMasterStripEqBandJson(bandIndex, bandJson);
+  }
+
+  setMasterStripInsertBypassed(
+    insertIndex: number,
+    bypassed: boolean,
+    resetOnBypass = false,
+  ): void {
+    this.native.setMasterStripInsertBypassed(insertIndex, bypassed, resetOnBypass);
+  }
+
   createClipPageProvider(
     numChannels: number,
     numSamples: number,
     pageFrames: number,
   ): ClipPageProvider {
-    const id = this.nativeExt().createClipPageProvider(numChannels, numSamples, pageFrames);
+    const id = this.native.createClipPageProvider(numChannels, numSamples, pageFrames);
     return new ClipPageProvider(this, id);
   }
 
   supplyClipPage(providerId: number, pageIndex: number, channels: Float32Array[]): void {
-    this.nativeExt().supplyClipPage(providerId, pageIndex, channels);
+    this.native.supplyClipPage(providerId, pageIndex, channels);
   }
 
   clearClipPage(providerId: number, pageIndex: number): void {
-    this.nativeExt().clearClipPage(providerId, pageIndex);
+    this.native.clearClipPage(providerId, pageIndex);
   }
 
   destroyClipPageProvider(providerId: number): void {
-    this.nativeExt().destroyClipPageProvider(providerId);
+    this.native.destroyClipPageProvider(providerId);
   }
 
   popClipPageRequest(): ClipPageRequest | null {
-    return this.nativeExt().popClipPageRequest();
+    return this.native.popClipPageRequest();
   }
 
   setCaptureBuffer(numChannels: number, capacityFrames: number): void {

package/src/sonare.js.d.ts

@@ -4,6 +4,7 @@
 
 export interface SonareModuleOptions {
   locateFile?: (path: string, prefix: string) => string;
+  wasmBinary?: ArrayBuffer | Uint8Array;
   onRuntimeInitialized?: () => void;
   print?: (text: string) => void;
   printErr?: (text: string) => void;
@@ -518,6 +519,7 @@ export interface WasmMixResult {
 
 export interface WasmEngineClip {
   id?: number;
+  trackId?: number;
   channels?: Float32Array[];
   startPpq: number;
   lengthSamples?: number;
@@ -531,6 +533,22 @@ export interface WasmEngineClip {
   pageProvider?: number | { readonly id: number };
 }
 
+export interface WasmEngineTrackSend {
+  busId: number;
+  levelDb?: number;
+  enabled?: boolean;
+}
+
+export interface WasmEngineTrackLane {
+  trackId: number;
+  sends?: WasmEngineTrackSend[];
+}
+
+export interface WasmEngineBus {
+  busId: number;
+  gainDb?: number;
+}
+
 export interface WasmClipPageRequest {
   clipId: number;
   channel: number;
@@ -696,6 +714,18 @@ export interface WasmEngineProcessWithMonitorResult {
   monitor: Float32Array[];
 }
 
+export interface WasmEngineTempoSegment {
+  startPpq: number;
+  bpm: number;
+  endBpm?: number;
+}
+
+export interface WasmEngineTimeSignatureSegment {
+  startPpq: number;
+  numerator: number;
+  denominator: number;
+}
+
 export interface WasmRealtimeEngine {
   prepare: (
     sampleRate: number,
@@ -705,13 +735,17 @@ export interface WasmRealtimeEngine {
   ) => void;
   setParameter: (paramId: number, value: number, renderFrame: number) => void;
   setParameterSmoothed: (paramId: number, value: number, renderFrame: number) => void;
+  setSoloMute: (laneIndex: number, solo: boolean, mute: boolean, renderFrame: number) => void;
   getTransportState: () => WasmEngineTransportState;
   play: (renderFrame: number) => void;
   stop: (renderFrame: number) => void;
   seekSample: (timelineSample: number, renderFrame: number) => void;
   seekPpq: (ppq: number, renderFrame: number) => void;
   setTempo: (bpm: number) => void;
+  setTempoSegments: (segments: WasmEngineTempoSegment[]) => void;
   setTimeSignature: (numerator: number, denominator: number) => void;
+  setTimeSignatureSegments: (segments: WasmEngineTimeSignatureSegment[]) => void;
+  sampleAtPpq: (ppq: number) => number;
   setLoop: (startPpq: number, endPpq: number, enabled: boolean) => void;
   addParameter: (info: WasmEngineParameterInfo) => void;
   parameterCount: () => number;
@@ -733,6 +767,24 @@ export interface WasmRealtimeEngine {
   graphConnectionCount: () => number;
   setClips: (clips: WasmEngineClip[]) => void;
   clipCount: () => number;
+  setTrackLanes: (lanes: Array<number | WasmEngineTrackLane>) => void;
+  setTrackBuses: (buses: WasmEngineBus[]) => void;
+  setBusStripJson: (busId: number, sceneJson: string) => void;
+  setTrackStripJson: (trackId: number, sceneJson: string) => void;
+  setTrackStripEqBandJson: (trackId: number, bandIndex: number, bandJson: string) => void;
+  setTrackStripInsertBypassed: (
+    trackId: number,
+    insertIndex: number,
+    bypassed: boolean,
+    resetOnBypass: boolean,
+  ) => void;
+  setMasterStripJson: (sceneJson: string) => void;
+  setMasterStripEqBandJson: (bandIndex: number, bandJson: string) => void;
+  setMasterStripInsertBypassed: (
+    insertIndex: number,
+    bypassed: boolean,
+    resetOnBypass: boolean,
+  ) => void;
   createClipPageProvider: (numChannels: number, numSamples: number, pageFrames: number) => number;
   supplyClipPage: (providerId: number, pageIndex: number, channels: Float32Array[]) => void;
   clearClipPage: (providerId: number, pageIndex: number) => void;
@@ -747,7 +799,11 @@ export interface WasmRealtimeEngine {
   resetCapture: () => void;
   captureStatus: () => WasmEngineCaptureStatus;
   capturedAudio: () => Float32Array[];
+  setMidiClips: (clips: readonly object[]) => void;
   setBuiltinInstrument: (destinationId: number, config: object) => void;
+  setSynthInstrument: (destinationId: number, patch: object | string) => void;
+  loadSoundFont: (data: Uint8Array) => void;
+  setSf2Instrument: (destinationId: number, config: object) => void;
   clearMidiInstrument: (destinationId: number) => void;
   midiInstrumentCount: () => number;
   bindMidiCc: (
@@ -759,6 +815,8 @@ export interface WasmRealtimeEngine {
   ) => void;
   clearMidiCcBindings: () => void;
   midiCcBindingCount: () => number;
+  setMidiFx: (destinationId: number, configJson: string) => void;
+  clearMidiFx: (destinationId: number) => void;
   setMidiInputSource: (destinationId: number) => void;
   clearMidiInputSource: () => void;
   midiInputPendingCount: () => number;
@@ -808,6 +866,7 @@ export interface WasmRealtimeEngine {
     renderFrame: number,
   ) => void;
   pushMidiPanic: (renderFrame: number) => void;
+  clearParameters: () => void;
   process: (channels: Float32Array[]) => Float32Array[];
   prepareChannels: (numChannels: number, maxFrames: number) => void;
   getChannelBuffer: (channel: number, numFrames: number) => Float32Array;
@@ -1845,6 +1904,11 @@ export interface SonareModule {
 
   // Mixing - scene-based Mixer
   createMixerFromSceneJson: (json: string, sampleRate: number, blockSize: number) => WasmMixer;
+
+  // Decodes a thrown native exception-object pointer (emscripten classic EH
+  // surfaces a C++ throw as the raw pointer number) into a structured error.
+  // Consumed by the module-error wrapper in module_state.ts.
+  sonareExceptionInfo: (ptr: number) => { code: number; codeName: string; message: string };
 }
 
 export interface WasmStreamingMasteringChain {
@@ -1947,6 +2011,7 @@ export interface WasmMixer {
   outputRightView: () => Float32Array;
   processPreparedStereo: (numSamples: number) => void;
   stripCount: () => number;
+  sceneWarnings: () => string[];
   scheduleInsertAutomation: (
     stripIndex: number,
     insertIndex: number,

package/src/web_midi.ts

@@ -93,6 +93,7 @@ export interface WebMidiBinding {
 type BoundInput = {
   input: MidiInputLike;
   listener: (event: MidiMessageEventLike) => void;
+  runningStatus: number;
 };
 
 export function isWebMidiAvailable(): boolean {
@@ -128,7 +129,6 @@ export async function bindWebMidi(
 
   const bound = new Map<string, BoundInput>();
   let closed = false;
-  let runningStatus = 0;
 
   const shouldBind = (input: MidiInputLike) =>
     input.state !== 'disconnected' && (selectedIds.size === 0 || selectedIds.has(input.id));
@@ -147,22 +147,26 @@ export async function bindWebMidi(
     if (bound.has(input.id) || !shouldBind(input)) {
       return;
     }
-    const listener = (event: MidiMessageEventLike) => {
-      const status = dispatchMidiMessage(
-        engine,
-        event,
-        group,
-        runningStatus,
-        options.timestampToSamples,
-      );
-      runningStatus = status;
+    const entry: BoundInput = {
+      input,
+      listener: (event: MidiMessageEventLike) => {
+        entry.runningStatus = dispatchMidiMessage(
+          engine,
+          event,
+          group,
+          entry.runningStatus,
+          options.timestampToSamples,
+        );
+      },
+      runningStatus: 0,
     };
+    const listener = entry.listener;
     if (input.addEventListener) {
       input.addEventListener('midimessage', listener);
     } else {
       input.onmidimessage = listener;
     }
-    bound.set(input.id, { input, listener });
+    bound.set(input.id, entry);
   };
 
   const unbindInput = (input: MidiInputLike) => {