Audio

project.transaction(() => {
  project.dispatch({ type: "track/add", payload: { id: "music", kind: "audio", name: "Music" } });
  project.dispatch({
    type: "asset/add",
    payload: { id: "song", kind: "audio", src: "/media/song.mp3", durationUs: 92_000_000 },
  });
  project.dispatch({
    type: "clip/add",
    payload: {
      kind: "audio",
      id: "bed",
      trackId: "music",
      assetId: "song",
      startUs: 0,
      durationUs: 30_000_000,
      volume: 0.35,
      fadeInUs: 1_000_000,
      fadeOutUs: 2_000_000,
    },
  });
});

project.dispatch({ type: "clip/set-property", payload: { clipId: "bed", volume: 0.5, fadeOutUs: null } }); // null removes the fade

project.dispatch({ type: "keyframe/set", payload: { clipId: "bed", property: "volume", timeUs: 2_000_000, value: 0.35 } });
project.dispatch({ type: "keyframe/set", payload: { clipId: "bed", property: "volume", timeUs: 2_400_000, value: 0.1 } });
project.dispatch({ type: "keyframe/set", payload: { clipId: "bed", property: "volume", timeUs: 8_000_000, value: 0.1 } });
project.dispatch({ type: "keyframe/set", payload: { clipId: "bed", property: "volume", timeUs: 8_400_000, value: 0.35 } });

project.dispatch({ type: "track/set-property", payload: { trackId: "music", muted: true } });
project.dispatch({ type: "track/set-property", payload: { trackId: "voice", solo: true } });

import { createAudioLibrary, importAudio, openverseProvider, staticProvider } from "@miraiclip/audio-sources";

declare function copyToMyStorage(url: string): Promise<string>;

const library = createAudioLibrary([
  staticProvider({
    id: "house",
    label: "Our library",
    entries: [
      {
        id: "calm",
        title: "Calm Piano",
        src: "https://cdn.example.com/calm.mp3",
        kind: "music",
        durationUs: 92_000_000,
        creator: "Jane Doe",
        license: { id: "CC-BY-4.0", commercial: true, attributionRequired: true },
        attribution: "“Calm Piano” by Jane Doe, CC BY 4.0",
      },
    ],
  }),
  openverseProvider({ baseUrl: "/api/openverse" }), // your proxy to https://api.openverse.org
]);

const results = await library.searchAll({ query: "calm piano", kind: "music", commercialOnly: true });
const item = results.find((r) => r.result?.items.length)?.result?.items[0];

if (item) {
  const resolved = await library.resolve(item);
  const src = await copyToMyStorage(resolved.src); // stable URL with Range and CORS support
  importAudio(project, { ...resolved, src }, { atUs: 0, volume: 0.35, fadeInUs: 1_000_000 });
}

GET  {endpoint}/search?q=&kind=&commercialOnly=&minDurationS=&maxDurationS=&page=&pageSize=  → AudioSearchResult
GET  {endpoint}/items/{id}                                                                  → AudioItem | 404
POST {endpoint}/resolve   { item }                                                          → ResolvedAudio

import { createAudioLibrary, elevenLabsGenerator, importAudio } from "@miraiclip/audio-sources";

declare function storeFile(file: Blob, name: string): Promise<string>;

const library = createAudioLibrary([], {
  generators: [elevenLabsGenerator({ baseUrl: "/api/elevenlabs", plan: "paid" })],
});

const job = library.generate(
  "elevenlabs",
  { kind: "sfx", prompt: "glass shattering", durationS: 2 },
  { storeFile },
);
job.onChange((j) => console.log(j.status, j.progress));

const { resolved } = await job.result;
importAudio(project, resolved, { volume: 0.9 });

import { creditsFor, licenseReport } from "@miraiclip/core";

const doc = project.getState().doc;
creditsFor(doc); // credit lines for an end card or description
licenseReport(doc, { commercial: true }); // non-commercial, unknown or uncredited assets