export type Mode = "sort" | "salvage" | "verify" | "keeps";

export const MODES: Mode[] = ["sort", "salvage", "verify", "keeps"];

export function isMode(v: string): v is Mode {
  return (MODES as string[]).includes(v);
}

/** A candidate as mined into cand2/*.json. Times are ABSOLUTE episode seconds. */
export type Candidate = {
  video: string;
  token?: string;
  start: number;
  end: number;
  dur?: number;
  f0?: number;
  spreadCents?: number;
  rms?: number;
  peak?: number;
  marginBefore?: number;
  marginAfter?: number;
  gapPrev?: string;
  gapNext?: string;
  noTrim?: boolean;
  salvagedFrom?: string;
  sortedFrom?: string;
};

/**
 * One ASR token. `conf` is OPTIONAL because this type dropped it, not because
 * the data lacks it -- every word in asr/ carries a parakeet confidence, 70% of
 * them at 0.9 or better and only 1.1% below 0.4. Consumers must read an absent
 * conf as UNKNOWN and never as 1.0: a missing reading is not a perfect one.
 */
export type AsrWord = { start: number; end: number; w: string; conf?: number };

/** What the deck needs to render a queue. No wav is opened to build one. */
export type ClipStub = {
  key: string;
  video: string;
  title: string;
  date: string;
  /** The ASR token. Often wrong -- that is what the word selector is for. */
  token: string;
  candStart: number;
  candEnd: number;
  f0: number;
  /** Why find-risky.mjs flagged it (verify mode). */
  risk: string;
  /** Previously recorded human label, if this clip has been through the tool. */
  word?: string;
  /** keeps mode: the side already recorded, if any. */
  side?: number;
  /** wav48/<video>.wav is genuinely absent -- the only real "needs more context". */
  sourceMissing: boolean;
};

/** One clip, opened. Every time here is ABSOLUTE episode seconds. */
export type Clip = ClipStub & {
  /** The window on offer: hand-set, or the manifest's, or clipWindow()'s. */
  selStart: number;
  selEnd: number;
  /** The same window before any edit this session -- what R and reset go back to. */
  defaultStart: number;
  defaultEnd: number;
  /** Full length of the source episode, so the view can be clamped to it. */
  sourceDuration: number;
  words: AsrWord[];
  /** Nearest word each side, for the word selector's clip-specific offers. */
  adjBefore: string;
  adjAfter: string;
  /** A word that could not be excluded without going under the 140ms floor. */
  wordIn: string;
  /** Trailing pop the stripper would remove, in ms (0 = nothing to strip). */
  stripMs: number;
  stripWhy: string;
};

export type ClipPage = {
  mode: Mode;
  clips: ClipStub[];
  /** How many the mode's pile holds in total, before the limit. */
  total: number;
  orderNote: string;
  counts: { accepted: number; rejected: number; unclean: number; impure: number };
};

export type VerdictBody = {
  key: string;
  mode: Mode;
  /** sort/salvage/verify: 1 good, 2 dirty/unclean, 0 drop. keeps: the side. */
  verdict: number;
  code?: number;
  text?: string;
  word?: string;
  custom?: boolean;
  /** The selection, in ABSOLUTE episode seconds. */
  window?: { from: number; to: number };
  /** The window the card was given, so "did it move?" needs no re-read. */
  defaultWindow?: { from: number; to: number };
  /** Which edge is unreachable, when the source file is missing. */
  needsContext?: "start" | "end" | "both" | null;
};

export type VerdictResult = {
  ok: true;
  key: string;
  /** The key the clip ended up under -- a re-trimmed window makes a new one. */
  finalKey: string;
  counts: { accepted: number; rejected: number; unclean: number; impure: number };
  moved: boolean;
};