//#region src/types.d.ts
type VrtStatus = 'passed' | 'changed' | 'added' | 'removed' | 'skipped' | 'carried';
/**
 * Statuses that can make `svrt compare` exit 1. `skipped` and `carried` are
 * deliberately excluded — they mean "not verified this run", never a failure.
 */
type VrtFailOn = 'changed' | 'added' | 'removed';
/**
 * How much of the suite a run covered. Decides how a baseline without a
 * screenshot is classified: `removed` (a full run, so the story is gone) vs
 * `carried` (a `--changed` run simply did not select it).
 */
type VrtRunMode = 'full' | 'changed';
/** Why a story that ran produced no screenshot (written by the capture hook). */
type VrtUncapturedReason = 'vrt-skip' | 'test-skipped' | 'test-failed';
/** Machine-readable reason attached to every non-`passed` item. */
type VrtStatusReason = VrtUncapturedReason | 'not-selected' | 'no-capture' | 'pixel-diff' | 'dimension-diff' | 'new-story';
type VrtStabilityOptions = {
  /**
   * How many screenshots are taken at most until two consecutive ones
   * have the same hash.
   * @default 5
   */
  retries?: number;
  /**
   * Milliseconds to wait between two stability screenshots.
   * @default 100
   */
  interval?: number;
  /**
   * Inject a stylesheet that disables CSS animations, transitions and the
   * text caret while capturing.
   * @default true
   */
  disableAnimations?: boolean;
};
type VrtOptions = {
  /**
   * Whether the capture hook is injected into the Vitest project.
   * Disabled runs add zero overhead to a normal `vitest run`.
   * @default !!process.env.VRT
   */
  enabled?: boolean;
  /**
   * Base directory for all VRT artifacts, relative to the Vitest project
   * root. `expectedDir`, `actualDir` and `diffDir` are derived from it
   * unless set explicitly.
   * @default '.vrt'
   */
  baseDir?: string;
  /** @default `${baseDir}/expected` */
  expectedDir?: string;
  /** @default `${baseDir}/actual` */
  actualDir?: string;
  /** @default `${baseDir}/diff` */
  diffDir?: string;
  /**
   * Append the browser name (e.g. `.chromium`) to every screenshot key.
   * Required when the Vitest project runs multiple browser instances,
   * otherwise they would overwrite each other.
   * @default false
   */
  browserNameSuffix?: boolean;
  stability?: VrtStabilityOptions;
  /**
   * Per-pixel color difference threshold passed to pixelmatch (0-1).
   * @default 0.1
   */
  threshold?: number;
  /**
   * Number of mismatched pixels tolerated before a pair counts as changed.
   * @default 0
   */
  allowedMismatchedPixels?: number;
  /**
   * Ratio (0-1) of mismatched pixels tolerated before a pair counts as
   * changed. When both limits are set the stricter one wins.
   * @default 0
   */
  allowedMismatchedPixelRatio?: number;
  /**
   * Which categories make `svrt compare` exit with code 1.
   * @default ['changed', 'added', 'removed']
   */
  failOn?: VrtFailOn[];
  /**
   * Glob patterns whose change forces a full run even under `--changed`,
   * for dependencies Vitest's module graph cannot see (Storybook config,
   * global CSS/tokens, lockfiles, static assets). Matched against both
   * repo-root-relative and project-relative forms of each changed path.
   * @default ['**\/.storybook/**']
   */
  fullRunTriggers?: string[];
  /**
   * Vitest `--project` name that `svrt run` passes when spawning Vitest.
   * Set to `false` to pass no project filter.
   * @default 'storybook'
   */
  project?: string | false;
};
/** Story-level overrides, read from `parameters.vrt` of a story. */
type VrtStoryParameters = {
  /** Skip capturing this story (the Vitest test itself still runs). */
  skip?: boolean;
  /** Extra milliseconds to wait before the stability checks. */
  delay?: number;
  /** CSS selector(s) whose elements are covered by an opaque overlay. */
  mask?: string | string[];
  /** CSS selector(s) whose elements are removed from layout (`display: none`). */
  remove?: string | string[];
  /**
   * What to capture: the whole viewport (default) or the first element
   * matching a CSS selector.
   * @default 'viewport'
   */
  capture?: 'viewport' | (string & {});
};
type ResolvedVrtConfig = {
  enabled: boolean;
  root: string;
  baseDir: string;
  expectedDir: string;
  actualDir: string;
  diffDir: string;
  /** Markers for stories that ran but were intentionally not captured. */
  uncapturedDir: string;
  browserNameSuffix: boolean;
  stability: Required<VrtStabilityOptions>;
  threshold: number;
  allowedMismatchedPixels: number | undefined;
  allowedMismatchedPixelRatio: number | undefined;
  failOn: VrtFailOn[];
  fullRunTriggers: string[];
  project: string | false;
};
/** Options serialized into `test.env` for the browser-side capture hook. */
type VrtRuntimeOptions = {
  root: string;
  baseDir: string;
  actualDir: string;
  diffDir: string;
  uncapturedDir: string;
  browserNameSuffix: boolean;
  stability: Required<VrtStabilityOptions>;
};
type VrtReportItem = {
  key: string;
  status: VrtStatus;
  /** Machine-readable reason; present on every non-`passed` item. */
  reason?: VrtStatusReason;
  paths: {
    expected: string | null;
    actual: string | null;
    diff: string | null;
  };
  mismatchedPixels?: number;
  mismatchRatio?: number;
  dimensions?: {
    expected: [width: number, height: number];
    actual: [width: number, height: number];
  };
};
type VrtReportSummary = {
  total: number;
  passed: number;
  changed: number;
  added: number;
  removed: number;
  skipped: number;
  carried: number;
  failed: boolean;
};
type VrtReport = {
  version: 2;
  createdAt: string;
  /** Honest scope of the run, so consumers never read a partial run as full. */
  run: {
    mode: VrtRunMode;
    /** `--changed` base ref, when a changed run was requested. */
    ref?: string | null;
    /** Set when `--changed` was escalated to a full run by a trigger. */
    escalation?: {
      file: string;
      trigger: string;
    } | null;
  };
  options: {
    threshold: number;
    allowedMismatchedPixels?: number;
    allowedMismatchedPixelRatio?: number;
    failOn: VrtFailOn[];
  };
  dirs: {
    expected: string;
    actual: string;
    diff: string;
  };
  summary: VrtReportSummary;
  items: VrtReportItem[];
};
//#endregion
export { ResolvedVrtConfig, VrtFailOn, VrtOptions, VrtReport, VrtReportItem, VrtReportSummary, VrtRunMode, VrtRuntimeOptions, VrtStabilityOptions, VrtStatus, VrtStatusReason, VrtStoryParameters, VrtUncapturedReason };