@zylem/game-lib 0.8.9 → 0.9.1

package/dist/song-definition-rEKksP0B.d.ts

@@ -0,0 +1,263 @@
+import * as _sinclair_typebox from '@sinclair/typebox';
+import { Static } from '@sinclair/typebox';
+
+/**
+ * TypeBox schema for a song the audio module can play: instruments (Tone.js
+ * presets with an effects chain), tracks (one instrument or audio lane each)
+ * and clips placed on those tracks. All positions and lengths are in beats at
+ * the song's tempo; audio clips reference a URL the runtime can fetch.
+ *
+ * Creator's Music mode authors `.song.json` documents that strip down to this
+ * shape (`toRuntimeSong` in `@zylem-creator/shared`).
+ */
+declare const InstrumentPresetSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"synth">, _sinclair_typebox.TLiteral<"polySynth">, _sinclair_typebox.TLiteral<"fmSynth">, _sinclair_typebox.TLiteral<"amSynth">, _sinclair_typebox.TLiteral<"membraneSynth">, _sinclair_typebox.TLiteral<"metalSynth">, _sinclair_typebox.TLiteral<"noiseSynth">, _sinclair_typebox.TLiteral<"pluckSynth">]>;
+type InstrumentPreset = Static<typeof InstrumentPresetSchema>;
+declare const OscillatorTypeSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"sine">, _sinclair_typebox.TLiteral<"square">, _sinclair_typebox.TLiteral<"sawtooth">, _sinclair_typebox.TLiteral<"triangle">]>;
+type OscillatorType = Static<typeof OscillatorTypeSchema>;
+declare const EnvelopeSchema: _sinclair_typebox.TObject<{
+    attack: _sinclair_typebox.TNumber;
+    decay: _sinclair_typebox.TNumber;
+    sustain: _sinclair_typebox.TNumber;
+    release: _sinclair_typebox.TNumber;
+}>;
+type Envelope = Static<typeof EnvelopeSchema>;
+declare const EffectTypeSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"reverb">, _sinclair_typebox.TLiteral<"delay">, _sinclair_typebox.TLiteral<"distortion">, _sinclair_typebox.TLiteral<"filter">]>;
+type EffectType = Static<typeof EffectTypeSchema>;
+declare const InstrumentEffectSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    type: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"reverb">, _sinclair_typebox.TLiteral<"delay">, _sinclair_typebox.TLiteral<"distortion">, _sinclair_typebox.TLiteral<"filter">]>;
+    /** Dry/wet mix, 0–1. */
+    wet: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    /** Effect-specific settings forwarded to the Tone.js constructor. */
+    options: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnion<[_sinclair_typebox.TNumber, _sinclair_typebox.TString, _sinclair_typebox.TBoolean]>>>;
+}>;
+type InstrumentEffect = Static<typeof InstrumentEffectSchema>;
+declare const InstrumentDefinitionSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    preset: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"synth">, _sinclair_typebox.TLiteral<"polySynth">, _sinclair_typebox.TLiteral<"fmSynth">, _sinclair_typebox.TLiteral<"amSynth">, _sinclair_typebox.TLiteral<"membraneSynth">, _sinclair_typebox.TLiteral<"metalSynth">, _sinclair_typebox.TLiteral<"noiseSynth">, _sinclair_typebox.TLiteral<"pluckSynth">]>;
+    oscillator: _sinclair_typebox.TOptional<_sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"sine">, _sinclair_typebox.TLiteral<"square">, _sinclair_typebox.TLiteral<"sawtooth">, _sinclair_typebox.TLiteral<"triangle">]>>;
+    envelope: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+        attack: _sinclair_typebox.TNumber;
+        decay: _sinclair_typebox.TNumber;
+        sustain: _sinclair_typebox.TNumber;
+        release: _sinclair_typebox.TNumber;
+    }>>;
+    /** Output trim in dB. */
+    volume: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    effects: _sinclair_typebox.TOptional<_sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        type: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"reverb">, _sinclair_typebox.TLiteral<"delay">, _sinclair_typebox.TLiteral<"distortion">, _sinclair_typebox.TLiteral<"filter">]>;
+        /** Dry/wet mix, 0–1. */
+        wet: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        /** Effect-specific settings forwarded to the Tone.js constructor. */
+        options: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnion<[_sinclair_typebox.TNumber, _sinclair_typebox.TString, _sinclair_typebox.TBoolean]>>>;
+    }>>>;
+}>;
+type InstrumentDefinition = Static<typeof InstrumentDefinitionSchema>;
+declare const SongNoteSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    /** MIDI pitch, 0–127. */
+    pitch: _sinclair_typebox.TInteger;
+    /** Beats from the clip start. */
+    start: _sinclair_typebox.TNumber;
+    /** Beats. */
+    duration: _sinclair_typebox.TNumber;
+    /** 0–1; defaults to 0.8. */
+    velocity: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+}>;
+type SongNote = Static<typeof SongNoteSchema>;
+declare const SongTrackSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    kind: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"instrument">, _sinclair_typebox.TLiteral<"audio">]>;
+    instrumentId: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    color: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    /** Fader in dB. */
+    volume: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    /** -1 (left) … 1 (right). */
+    pan: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    mute: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
+    solo: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
+}>;
+type SongTrack = Static<typeof SongTrackSchema>;
+declare const NoteClipSchema: _sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"notes">;
+    id: _sinclair_typebox.TString;
+    trackId: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    /** Beats from the song start. */
+    start: _sinclair_typebox.TNumber;
+    /** Beats; notes past the end are not played. */
+    length: _sinclair_typebox.TNumber;
+    notes: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        /** MIDI pitch, 0–127. */
+        pitch: _sinclair_typebox.TInteger;
+        /** Beats from the clip start. */
+        start: _sinclair_typebox.TNumber;
+        /** Beats. */
+        duration: _sinclair_typebox.TNumber;
+        /** 0–1; defaults to 0.8. */
+        velocity: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    }>>;
+}>;
+type NoteClip = Static<typeof NoteClipSchema>;
+declare const AudioClipSchema: _sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"audio">;
+    id: _sinclair_typebox.TString;
+    trackId: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    /** URL of the audio file. */
+    url: _sinclair_typebox.TString;
+    /** Beats from the song start. */
+    start: _sinclair_typebox.TNumber;
+    /** Seconds trimmed from the start of the file. */
+    offset: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    /** Beats. */
+    length: _sinclair_typebox.TNumber;
+    /** Clip gain in dB. */
+    gain: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+}>;
+type AudioClip = Static<typeof AudioClipSchema>;
+declare const SongClipSchema: _sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"notes">;
+    id: _sinclair_typebox.TString;
+    trackId: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    /** Beats from the song start. */
+    start: _sinclair_typebox.TNumber;
+    /** Beats; notes past the end are not played. */
+    length: _sinclair_typebox.TNumber;
+    notes: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        /** MIDI pitch, 0–127. */
+        pitch: _sinclair_typebox.TInteger;
+        /** Beats from the clip start. */
+        start: _sinclair_typebox.TNumber;
+        /** Beats. */
+        duration: _sinclair_typebox.TNumber;
+        /** 0–1; defaults to 0.8. */
+        velocity: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    }>>;
+}>, _sinclair_typebox.TObject<{
+    kind: _sinclair_typebox.TLiteral<"audio">;
+    id: _sinclair_typebox.TString;
+    trackId: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+    /** URL of the audio file. */
+    url: _sinclair_typebox.TString;
+    /** Beats from the song start. */
+    start: _sinclair_typebox.TNumber;
+    /** Seconds trimmed from the start of the file. */
+    offset: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    /** Beats. */
+    length: _sinclair_typebox.TNumber;
+    /** Clip gain in dB. */
+    gain: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+}>]>;
+type SongClip = Static<typeof SongClipSchema>;
+declare const TimeSignatureSchema: _sinclair_typebox.TObject<{
+    numerator: _sinclair_typebox.TInteger;
+    denominator: _sinclair_typebox.TInteger;
+}>;
+type TimeSignature = Static<typeof TimeSignatureSchema>;
+declare const SongLoopSchema: _sinclair_typebox.TObject<{
+    enabled: _sinclair_typebox.TBoolean;
+    /** Beats. */
+    start: _sinclair_typebox.TNumber;
+    end: _sinclair_typebox.TNumber;
+}>;
+type SongLoop = Static<typeof SongLoopSchema>;
+declare const SongDefinitionSchema: _sinclair_typebox.TObject<{
+    id: _sinclair_typebox.TString;
+    name: _sinclair_typebox.TString;
+    bpm: _sinclair_typebox.TNumber;
+    timeSignature: _sinclair_typebox.TObject<{
+        numerator: _sinclair_typebox.TInteger;
+        denominator: _sinclair_typebox.TInteger;
+    }>;
+    lengthBars: _sinclair_typebox.TInteger;
+    loop: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+        enabled: _sinclair_typebox.TBoolean;
+        /** Beats. */
+        start: _sinclair_typebox.TNumber;
+        end: _sinclair_typebox.TNumber;
+    }>>;
+    instruments: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TString;
+        preset: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"synth">, _sinclair_typebox.TLiteral<"polySynth">, _sinclair_typebox.TLiteral<"fmSynth">, _sinclair_typebox.TLiteral<"amSynth">, _sinclair_typebox.TLiteral<"membraneSynth">, _sinclair_typebox.TLiteral<"metalSynth">, _sinclair_typebox.TLiteral<"noiseSynth">, _sinclair_typebox.TLiteral<"pluckSynth">]>;
+        oscillator: _sinclair_typebox.TOptional<_sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"sine">, _sinclair_typebox.TLiteral<"square">, _sinclair_typebox.TLiteral<"sawtooth">, _sinclair_typebox.TLiteral<"triangle">]>>;
+        envelope: _sinclair_typebox.TOptional<_sinclair_typebox.TObject<{
+            attack: _sinclair_typebox.TNumber;
+            decay: _sinclair_typebox.TNumber;
+            sustain: _sinclair_typebox.TNumber;
+            release: _sinclair_typebox.TNumber;
+        }>>;
+        /** Output trim in dB. */
+        volume: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        effects: _sinclair_typebox.TOptional<_sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TString;
+            type: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"reverb">, _sinclair_typebox.TLiteral<"delay">, _sinclair_typebox.TLiteral<"distortion">, _sinclair_typebox.TLiteral<"filter">]>;
+            /** Dry/wet mix, 0–1. */
+            wet: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+            /** Effect-specific settings forwarded to the Tone.js constructor. */
+            options: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TUnion<[_sinclair_typebox.TNumber, _sinclair_typebox.TString, _sinclair_typebox.TBoolean]>>>;
+        }>>>;
+    }>>;
+    tracks: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+        id: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TString;
+        kind: _sinclair_typebox.TUnion<[_sinclair_typebox.TLiteral<"instrument">, _sinclair_typebox.TLiteral<"audio">]>;
+        instrumentId: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        color: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        /** Fader in dB. */
+        volume: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        /** -1 (left) … 1 (right). */
+        pan: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        mute: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
+        solo: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
+    }>>;
+    clips: _sinclair_typebox.TArray<_sinclair_typebox.TUnion<[_sinclair_typebox.TObject<{
+        kind: _sinclair_typebox.TLiteral<"notes">;
+        id: _sinclair_typebox.TString;
+        trackId: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        /** Beats from the song start. */
+        start: _sinclair_typebox.TNumber;
+        /** Beats; notes past the end are not played. */
+        length: _sinclair_typebox.TNumber;
+        notes: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{
+            id: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            /** MIDI pitch, 0–127. */
+            pitch: _sinclair_typebox.TInteger;
+            /** Beats from the clip start. */
+            start: _sinclair_typebox.TNumber;
+            /** Beats. */
+            duration: _sinclair_typebox.TNumber;
+            /** 0–1; defaults to 0.8. */
+            velocity: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        }>>;
+    }>, _sinclair_typebox.TObject<{
+        kind: _sinclair_typebox.TLiteral<"audio">;
+        id: _sinclair_typebox.TString;
+        trackId: _sinclair_typebox.TString;
+        name: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+        /** URL of the audio file. */
+        url: _sinclair_typebox.TString;
+        /** Beats from the song start. */
+        start: _sinclair_typebox.TNumber;
+        /** Seconds trimmed from the start of the file. */
+        offset: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+        /** Beats. */
+        length: _sinclair_typebox.TNumber;
+        /** Clip gain in dB. */
+        gain: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+    }>]>>;
+    /** Master fader in dB. */
+    masterVolume: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
+}>;
+type SongDefinition = Static<typeof SongDefinitionSchema>;
+
+export { AudioClipSchema as A, type Envelope as E, InstrumentDefinitionSchema as I, NoteClipSchema as N, type OscillatorType as O, SongDefinitionSchema as S, TimeSignatureSchema as T, InstrumentEffectSchema as a, InstrumentPresetSchema as b, SongTrackSchema as c, SongClipSchema as d, SongNoteSchema as e, SongLoopSchema as f, type SongDefinition as g, type InstrumentDefinition as h, type InstrumentEffect as i, type InstrumentPreset as j, type EffectType as k, type SongTrack as l, type SongClip as m, type NoteClip as n, type AudioClip as o, type SongNote as p, type TimeSignature as q, type SongLoop as r };

package/dist/song-player-7QPLFLAS.js

@@ -0,0 +1 @@
+import{f as a,g as b}from"./chunk-2PFNNGTV.js";import"./chunk-QGIYILYI.js";import"./chunk-WOT6VMZA.js";export{a as createSongPlayer,b as getActiveSongPlayer};