@libraz/libsonare 1.7.2 → 1.8.0

package/dist/project_internal.d.ts

@@ -0,0 +1,194 @@
+import type { BuiltinSynthBinding, SampleDesc, SampleZoneDesc, Sf2InstrumentConfig, Sf2ProgramStatus, SynthEnumTables, SynthPatch } from './instrument_types';
+import type { AlignTakeToReferenceRequest, AlignTakeToReferenceResult, ProjectAssistSidecar, ProjectAutomationLaneDesc, ProjectAutomationPoint, ProjectAutomationTargetKind, ProjectBounceOptions, ProjectChordSymbol, ProjectClip, ProjectClipCompSegment, ProjectClipDesc, ProjectClipFade, ProjectClipTake, ProjectCompileResult, ProjectKeySegment, ProjectLoopMode, ProjectLoopRecordingDesc, ProjectLoopRecordingResult, ProjectMarker, ProjectMidiCcBinding, ProjectMidiClipResult, ProjectMidiEvent, ProjectMidiRouteConfig, ProjectMidiRouteResult, ProjectNotePairValidation, ProjectSource, ProjectTempoCandidate, ProjectTempoOptions, ProjectTempoSegment, ProjectTimeSignatureSegment, ProjectTrack, ProjectTrackKind, ProjectWarpMapDesc, ProjectWarpMode, TranscribeOptions, TranscribeResult } from './project_types';
+/**
+ * A synth binding as the embind layer takes it: the public `sampleBank` handle
+ * has already been resolved to the id the native registry looks the bank up by,
+ * because an embind class instance cannot travel inside a plain JS object the
+ * C++ side reads field by field.
+ */
+export type NativeSynthBinding = Omit<SynthPatch, 'sampleBank'> & {
+    sampleBankId?: number;
+};
+export interface WasmSampleBank {
+    readonly id: number;
+    addSample: (data: Float32Array, desc: SampleDesc) => number;
+    addZone: (setIndex: number, zone: Omit<SampleZoneDesc, 'setIndex'>) => void;
+    sampleCount: () => number;
+    setCount: () => number;
+    delete: () => void;
+}
+/**
+ * Swaps a facade {@link SampleBank} in a synth patch descriptor for the id the
+ * embind layer looks the native bank up by, leaving every other field alone.
+ *
+ * Shared by the offline bounce and the realtime engine so `sampleBank` means
+ * the same thing on both. It lives in this internal module rather than beside
+ * the class because it hands out an internal identity that no caller has a use
+ * for, and the entry point must not re-export it: a facade symbol with no C
+ * counterpart is an active parity finding.
+ *
+ * The cast is the only one of its kind: `released` is private, and TypeScript's
+ * private is a compile-time rule, so reading it once here beats widening the
+ * class with a method the parity tool would then read as a facade op.
+ */
+export declare function normalizeSynthInstrument(patch: unknown): NativeSynthBinding | string;
+export interface WasmProject {
+    toJson: () => string;
+    setSampleRate: (sampleRate: number) => void;
+    addTrack: (desc: {
+        kind?: number | string;
+        name?: string;
+    }) => number;
+    addClip: (desc: ProjectClipDesc) => number;
+    importExternalStems: (request: unknown) => {
+        trackIds: number[];
+        clipIds: number[];
+    };
+    addLoopRecordingTakes: (desc: ProjectLoopRecordingDesc) => ProjectLoopRecordingResult;
+    addMidiClip: (startPpq: number, lengthPpq: number) => ProjectMidiClipResult;
+    splitClip: (clipId: number, splitPpq: number) => number;
+    trimClip: (clipId: number, newStartPpq: number, newLengthPpq: number) => void;
+    moveClip: (clipId: number, newStartPpq: number, newTrackId: number) => void;
+    setTrackKind: (trackId: number, kind: number) => void;
+    setClipWarpRef: (clipId: number, warpRefId: number) => void;
+    setClipWarpMode: (clipId: number, mode: number) => void;
+    setWarpMap: (map: ProjectWarpMapDesc) => void;
+    removeWarpMap: (warpRefId: number) => void;
+    setTrackMidiDestination: (trackId: number, destinationId: number) => void;
+    setTrackGain: (trackId: number, gain: number) => void;
+    setTrackMute: (trackId: number, mute: boolean) => void;
+    setTrackSolo: (trackId: number, solo: boolean) => void;
+    setTrackPan: (trackId: number, pan: number) => void;
+    undo: () => void;
+    redo: () => void;
+    clearHistory: () => void;
+    setMaxUndoDepth: (depth: number) => void;
+    setMaxHistoryBytes: (bytes: number) => void;
+    setMidiEvents: (clipId: number, events: ReadonlyArray<ProjectMidiEvent | readonly [number, number, number]>) => void;
+    importSmf: (data: Uint8Array) => number;
+    exportSmf: () => Uint8Array<ArrayBuffer>;
+    importClipFile: (data: Uint8Array) => number;
+    exportClipFile: () => Uint8Array<ArrayBuffer>;
+    setProgram: (clipId: number, program: number, bank: number) => void;
+    setProgramOnChannel: (clipId: number, group: number, channel: number, program: number, bank: number) => void;
+    bakeMidiFx: (clipId: number, configJson: string) => void;
+    bakeMidiFxWithSourceIndex: (clipId: number, configJson: string) => Int32Array;
+    previewMidiFxCount: (clipId: number, configJson: string) => number;
+    setMidiFx: (clipId: number, configJson: string) => void;
+    validateMidiNotes: (clipId: number) => ProjectNotePairValidation;
+    transcribeToClip: (clipId: number, samples: Float32Array, sampleRate: number, config: TranscribeOptions) => number;
+    analyzeTempo: (audio: Float32Array, sampleRate: number, options: ProjectTempoOptions | undefined) => ProjectTempoCandidate[];
+    autoTempo: (audio: Float32Array, sampleRate: number, candidateIndex: number, applyTimeSignatures: boolean, options: ProjectTempoOptions | undefined) => number;
+    snapToGrid: (ppq: number, strength: number, division: number) => number;
+    compile: () => ProjectCompileResult;
+    bounce: (options: ProjectBounceOptions) => Float32Array;
+    bounceWithBuiltinInstrument: (bindings: BuiltinSynthBinding | ReadonlyArray<BuiltinSynthBinding> | undefined, options: ProjectBounceOptions) => Float32Array;
+    bounceWithSynthInstrument: (bindings: NativeSynthBinding | string | ReadonlyArray<NativeSynthBinding | string> | undefined, options: ProjectBounceOptions) => Float32Array;
+    loadSoundFont: (data: Uint8Array) => void;
+    clearSoundFont: () => void;
+    soundFontPresetCount: () => number;
+    soundFontManifest: () => Sf2ProgramStatus[];
+    bounceWithSf2Instrument: (bindings: Sf2InstrumentConfig | ReadonlyArray<Sf2InstrumentConfig> | undefined, options: ProjectBounceOptions) => Float32Array;
+    removeClip: (clipId: number) => void;
+    setClipGain: (clipId: number, gain: number) => void;
+    setClipFade: (clipId: number, fadeIn: ProjectClipFade, fadeOut: ProjectClipFade) => void;
+    unresolvedAudioSourceIds: () => number[];
+    setSourceAudio: (sourceId: number, audio: Float32Array, channels: number, sampleRate: number) => void;
+    setAudioSourceMetadata: (sourceId: number, contentHash: string, externalStemRole: string) => void;
+    setClipTakes: (clipId: number, takes: ReadonlyArray<ProjectClipTake>, activeTakeId: number) => void;
+    setClipCompSegments: (clipId: number, segments: ReadonlyArray<ProjectClipCompSegment>) => void;
+    setClipLoop: (clipId: number, loopMode: number, loopLengthPpq: number, loopCrossfadePpq: number) => void;
+    setClipSource: (clipId: number, sourceId: number) => void;
+    duplicateClip: (clipId: number, newStartPpq: number) => number;
+    removeTrack: (trackId: number) => void;
+    renameTrack: (trackId: number, name: string) => void;
+    setTrackRoute: (trackId: number, channelStripRef: string, outputTarget: string) => void;
+    addAutomationLane: (trackId: number, desc: ProjectAutomationLaneDesc) => number;
+    editAutomationLane: (trackId: number, targetParamId: number, desc: ProjectAutomationLaneDesc) => void;
+    removeAutomationLane: (trackId: number, targetParamId: number) => void;
+    annotateKeys: (keys: ReadonlyArray<ProjectKeySegment>) => void;
+    annotateChords: (chords: ReadonlyArray<ProjectChordSymbol>) => void;
+    setAssistSidecar: (moduleId: string, schemaVersion: number, targetTrackId: number, regionStartPpq: number, regionEndPpq: number, payload: Uint8Array) => void;
+    assistSidecarCount: () => number;
+    getAssistSidecar: (index: number) => ProjectAssistSidecar;
+    setOverlapPolicy: (policy: number) => void;
+    getOverlapPolicy: () => number;
+    getSampleRate: () => number;
+    setMixerSceneJson: (sceneJson: string) => void;
+    setMarker: (markerId: number, ppq: number, name: string) => number;
+    setMarkerEx: (marker: ProjectMarker) => number;
+    markerByIndex: (index: number) => ProjectMarker;
+    trackByIndex: (index: number) => ProjectTrack;
+    clipByIndex: (index: number) => ProjectClip;
+    sourceByIndex: (index: number) => ProjectSource;
+    markerCount: () => number;
+    trackCount: () => number;
+    clipCount: () => number;
+    sourceCount: () => number;
+    tempoSegmentCount: () => number;
+    tempoSegmentByIndex: (index: number) => ProjectTempoSegment;
+    timeSignatureByIndex: (index: number) => ProjectTimeSignatureSegment;
+    timeSignatureCount: () => number;
+    setTempoSegments: (segments: ReadonlyArray<ProjectTempoSegment>) => void;
+    setTimeSignatures: (segments: ReadonlyArray<ProjectTimeSignatureSegment>) => void;
+    lastBounceCompileResult: () => ProjectCompileResult;
+    delete: () => void;
+}
+export interface ProjectModule {
+    Project: {
+        new (): WasmProject;
+        fromJson: (json: string) => WasmProject;
+        fromJsonWithDiagnostics: (json: string) => {
+            project: WasmProject;
+            diagnostics: string;
+        };
+    };
+    SampleBank: {
+        new (): WasmSampleBank;
+    };
+    projectAbiVersion: () => number;
+    synthPresetNames: () => string[];
+    synthPresetPatch: (name: string) => SynthPatch;
+    synthGsDrumKitName: (program: number) => string | null;
+    synthGsDrumKitIsVoicedApart: (program: number) => number;
+    synthGsVariationIsVoicedApart: (bank: number, program: number) => number;
+    controllerProfileNames: () => string[];
+    _synthEnumTables: () => SynthEnumTables;
+    _synthPatchRoundTrip: (patch: SynthPatch) => SynthPatch;
+    midiGmInstrumentName: (program: number) => string | null;
+    midiGmProgramForName: (name: string) => number;
+    midiGmFamilyName: (family: number) => string | null;
+    midiGmFamilyFirstProgram: (family: number) => number;
+    midiGm2InstrumentName: (bankLsb: number, program: number) => string | null;
+    midiGmDrumName: (note: number) => string | null;
+    midiGmDrumNoteForName: (name: string) => number;
+    midiGm2DrumSetName: (bankLsb: number) => string | null;
+    midiGm2DrumName: (bankLsb: number, note: number) => string | null;
+    midiCcName: (controller: number) => string | null;
+    midiCcIndexForName: (name: string) => number;
+    midiPerNoteControllerName: (index: number) => string | null;
+    midiBankProgram: (ppq: number, group: number, channel: number, bankMsb: number, bankLsb: number, program: number) => ProjectMidiEvent[];
+    midiRouteEvents: (events: ReadonlyArray<ProjectMidiEvent>, config: ProjectMidiRouteConfig) => ProjectMidiRouteResult;
+    midiCcLearn: (events: ReadonlyArray<ProjectMidiEvent>, paramId: number, minValue: number, maxValue: number, minMovement: number) => ProjectMidiCcBinding | null;
+    midiCcToBreakpoint: (bindings: ReadonlyArray<ProjectMidiCcBinding>, event: ProjectMidiEvent) => ProjectAutomationPoint | null;
+    midiParamToCc: (bindings: ReadonlyArray<ProjectMidiCcBinding>, paramId: number, unitValue: number, group: number, ppq: number) => ProjectMidiEvent | null;
+    transcribe: (samples: Float32Array, sampleRate: number, tempoBpm: number | undefined, config: TranscribeOptions) => TranscribeResult;
+    alignTakeToReference: (reference: Float32Array, take: Float32Array, sampleRate: number, config: AlignTakeToReferenceRequest) => AlignTakeToReferenceResult;
+}
+export declare function projectModule(): ProjectModule;
+export declare function projectMidi1Event(fnName: string, ppq: number, group: number, status: number, channel: number, data1: number, data2?: number): ProjectMidiEvent;
+export declare function assertProjectMidiEvents(fnName: string, events: ReadonlyArray<ProjectMidiEvent | readonly [number, number, number]>): void;
+export declare function projectTrackKindValue(kind: ProjectTrackKind | undefined): number;
+/**
+ * Resolve a breakpoint's curve spelling to its ordinal before it crosses into
+ * embind, and fold the `curveToNext` alias onto `curve`.
+ *
+ * Mirrors the Node facade's `projectAutomationPointValue`: resolving here means
+ * an unknown spelling is a `RangeError` from the same table both packages
+ * declare, rather than a curve one binding renders and the other rejects.
+ */
+export declare function projectAutomationPointValue(point: ProjectAutomationPoint): ProjectAutomationPoint;
+export declare function projectAutomationTargetKindValue(kind: ProjectAutomationTargetKind): number;
+export declare function projectWarpModeValue(mode: ProjectWarpMode | undefined): number;
+export declare function projectLoopModeValue(mode: ProjectLoopMode | undefined): number;
+//# sourceMappingURL=project_internal.d.ts.map

package/dist/project_internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_internal.d.ts","sourceRoot":"","sources":["../src/project_internal.ts"],"names":[],"mappings":"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"}

package/dist/project_synth.d.ts

@@ -0,0 +1,74 @@
+import type { SynthEnumTables, SynthPatch } from './instrument_types';
+/**
+ * Runtime ABI version of the flat project POD layout exposed by this WASM
+ * build. Equals {@link EXPECTED_PROJECT_ABI_VERSION} when the arrangement
+ * subsystem is compiled in. Mirrors the C-ABI `sonare_project_abi_version`.
+ */
+export declare function projectAbiVersion(): number;
+/**
+ * NativeSynth preset catalog names (`'sine'`, `'saw-lead'`, `'e-piano'`,
+ * `'drum-kit'`, ...). Use these to discover valid {@link SynthPatch} preset
+ * names instead of hardcoding magic strings.
+ */
+export declare function synthPresetNames(): string[];
+/**
+ * GS rhythm-set name a rhythm part's `program` selects (`'Standard'`,
+ * `'Room'`, `'Jazz'`, ...), or `null` when the module's own tone map defines
+ * no set there.
+ *
+ * @remarks
+ * The answer is the module's own map, which is the newest one and reaches
+ * every set this build voices; a file selecting an older map reaches fewer.
+ */
+export declare function synthGsDrumKitName(program: number): string | null;
+/**
+ * Whether the GS rhythm set at `program` is voiced apart from Standard: `true`
+ * when at least one drum note differs, `false` when the set renders exactly as
+ * Standard, `null` when no set sits at `program`.
+ *
+ * @remarks
+ * Derived by applying the set to every note's resolved patch and comparing, so
+ * the answer follows the voicing rather than a list that has to be kept in step
+ * with it. Four sets GS fills with one-shots share the Standard voicing
+ * deliberately, so a picker built from the set list alone offers four choices
+ * that change nothing — annotate or disable them with this.
+ *
+ * @example
+ * ```ts
+ * const kits = Array.from({ length: 128 }, (_, program) => ({ program, name: synthGsDrumKitName(program) }))
+ *   .filter((kit): kit is { program: number; name: string } => kit.name !== null)
+ *   .map((kit) => ({ ...kit, placeholder: synthGsDrumKitIsVoicedApart(kit.program) === false }));
+ * ```
+ */
+export declare function synthGsDrumKitIsVoicedApart(program: number): boolean | null;
+/**
+ * Whether melodic Bank Select `bank` on `program` is voiced apart from the
+ * capital tone: `true` when the bank has a patch of its own, `false` when it
+ * resolves to the capital, `null` when either argument is outside `[0, 127]` —
+ * both are seven-bit MIDI values, so `128` is out of range rather than the drum
+ * bank here.
+ *
+ * @remarks
+ * Resolving an unvoiced variation to its capital is what GS specifies, so a
+ * `false` is correct behaviour rather than a gap — but only this query
+ * separates it from a bank that is voiced, which otherwise takes rendering both
+ * and comparing. Accepts the GS Bank Select MSB and the GM2 LSB alike, since
+ * both address the same variation.
+ */
+export declare function synthGsVariationIsVoicedApart(bank: number, program: number): boolean | null;
+/**
+ * Controller-profile preset names (`'gm'`, `'breath'`, `'breath-aftertouch'`,
+ * `'mpe'`). These are the names {@link RealtimeEngine.setControllerProfile}
+ * accepts; an unknown one throws rather than resolving to a default.
+ */
+export declare function controllerProfileNames(): string[];
+/**
+ * Fetch a named catalog preset as a {@link SynthPatch} (the preset name plus
+ * the wrapper-section values), so hosts can inspect a preset and tweak fields
+ * before binding it. A `"va:"` routing prefix is accepted; unknown names
+ * throw.
+ */
+export declare function synthPresetPatch(name: string): SynthPatch;
+export declare function synthEnumTables(): SynthEnumTables;
+export declare function synthPatchRoundTripForTest(patch: SynthPatch): SynthPatch;
+//# sourceMappingURL=project_synth.d.ts.map

package/dist/project_synth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_synth.d.ts","sourceRoot":"","sources":["../src/project_synth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGtE;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAG3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAG3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAG3F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAGjD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAMzD;AAED,wBAAgB,eAAe,IAAI,eAAe,CAEjD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAExE"}