Skip to content

VoiceStudio is the open-source, fully-local ElevenLabs alternative — voice cloning, voice design, video dubbing, dictation, transcription & audiobook creation in 646 languages.

1.7 KB
Raw Blame
/**
 * Cast helpers for the Stories Editor.
 *
 * Effective voice for a track resolves: per-line override → the character's
 * cast voice → null (the /generate default). Pure + testable.
 */

// Gruvbox-ish palette cycled when adding new cast members.
export const CAST_COLORS = [
  '#fabd2f',
  '#d3869b',
  '#83a598',
  '#b8bb26',
  '#fe8019',
  '#8ec07c',
  '#fb4934',
  '#458588',
];

/** Pick the first unused palette color (wraps by count when all are used). */
export function nextCastColor(cast) {
  const used = new Set((cast || []).map((c) => c.color));
  return (
    CAST_COLORS.find((c) => !used.has(c)) || CAST_COLORS[(cast?.length || 0) % CAST_COLORS.length]
  );
}

/** Resolve the profile id a track should speak in. */
export function effectiveProfile(track, cast) {
  if (track && track.profileId) return track.profileId;
  const member = (cast || []).find((c) => c.id === (track && track.character));
  return (member && member.profileId) || null;
}

/**
 * Resolve the reading speed a track should use: per-line override → the global
 * Stories speed (#415) → null (the /generate engine default of 1.0×). Mirrors
 * the span-speed resolution in storyToSpans (`tk.speed || gspeed || null`) so
 * preview, stem export, and longform export all agree on one speed. A global
 * of 1 counts as "at rest" → null, matching the export path.
 */
export function effectiveSpeed(track, globalSpeed) {
  if (track && track.speed) return track.speed;
  return globalSpeed && globalSpeed !== 1 ? globalSpeed : null;
}

/** Find a cast member by id (falls back to the first member). */
export function castMember(cast, id) {
  return (cast || []).find((c) => c.id === id) || (cast || [])[0] || null;
}