// Type definitions for soupdraw

export interface SoupDrawOptions {
  /** Where to inject the output <video>. */
  mount?: string | HTMLElement;
  /** Use your own <video> instead of `mount`. */
  video?: HTMLVideoElement;
  color?: string;        // default "#ff2d55"
  size?: number;         // default 6
  palette?: string[];    // preset swatch colours (both toolbars)
  fill?: boolean;        // default false (fill closed shapes with the pen colour)
  toolbar?: boolean;     // default false (in-canvas gesture toolbar: point + dwell)
  bucket?: boolean;      // default false (paint-bucket tool: pinch fills a closed shape)
  mirror?: boolean;      // default true (selfie)
  assist?: boolean;      // default true (snap rough strokes to shapes)
  history?: boolean;     // default true (history strip)
  minimap?: boolean;     // default false
  spotlight?: boolean;   // default false (dim + glow around hands)
  whiteboard?: boolean;  // default false (solid board instead of camera)
  boardColor?: string;   // default "#14151a"
  /** Where to load the runtime + recognizer from. Default: the package's CDN. */
  runtimeBase?: string;
}

export interface SoupDrawStatus {
  gesture: string | null;
  hands: number;
  strokes: number;
  drawing: boolean;
  erasing: boolean;
  transforming: boolean;
  modelReady: boolean;
  modelError: string | null;
  historyMode: boolean;
  selection: number;
  [k: string]: unknown;
}

export interface LegendEntry {
  name: string;
  icon: string;
  how: string;
  bound: string;
  action: string;
}

export class SoupDraw {
  constructor(opts?: SoupDrawOptions);
  /** The augmented output (camera + drawings) as a MediaStream (after start()). */
  readonly stream: MediaStream | undefined;
  readonly legend: LegendEntry[];
  /** Load the runtime, request the camera, and start. Resolves to the augmented stream. */
  start(): Promise<MediaStream>;
  stop(): void;
  setColor(color: string): this;
  setSize(size: number): this;
  /** Set the preset colour palette (used by both toolbars). */
  setPalette(colors: string[]): this;
  /** Fill closed shapes with the pen colour (translucent highlight). */
  setFill(on: boolean): this;
  /** Show the in-canvas gesture toolbar (point + dwell to pick colour, fill, undo, clear). */
  setToolbar(on: boolean): this;
  /** Paint-bucket tool: a pinch fills the closed shape under the fingertip. */
  setBucket(on: boolean): this;
  setMirror(on: boolean): this;
  setAssist(on: boolean): this;
  setHistory(on: boolean): this;
  setMinimap(on: boolean): this;
  setSpotlight(on: boolean): this;
  setWhiteboard(on: boolean): this;
  setBoardColor(color: string): this;
  /** Rebind a gesture to a different action (e.g. setBinding("fivePinch", "clear")). */
  setBinding(gesture: string, action: string): this;
  undo(): this;
  redo(): this;
  clear(): this;
  /** Launch the guided per-user pinch calibration. */
  calibrate(): this;
  on(event: "ready" | "stop", cb: () => void): this;
  on(event: "status", cb: (s: SoupDrawStatus) => void): this;
  on(event: "error", cb: (e: Error) => void): this;
  on(event: "calibrated", cb: (t: { pinchDown: number; pinchUp: number }) => void): this;
  off(event: string, cb: (...args: any[]) => void): this;
  static legend(): LegendEntry[];
}

export default SoupDraw;
export const version: string;