export type Summary = { count: number; mean: number; median: number; min: number; max: number };export type StatsErrorKind = "empty" | "not_finite" | "invalid_percentile";export class StatsError extends Error { readonly index?: number; constructor( public readonly kind: StatsErrorKind, detail: { index?: number } = {}, ) { super(kind); Object.assign(this, detail); }}const sortedCopy = (values: number[]): number[] => { if (values.length === 0) throw new StatsError("empty"); const bad = values.findIndex((v) => !Number.isFinite(v)); if (bad >= 0) throw new StatsError("not_finite", { index: bad }); return [...values].sort((a, b) => a - b);};/** Throws StatsError. */export function summarize(values: number[]): Summary { const s = sortedCopy(values); const n = s.length; const sum = s.reduce((a, b) => a + b, 0); const mid = Math.floor(n / 2); const median = n % 2 === 1 ? s[mid] : (s[mid - 1] + s[mid]) / 2; return { count: n, mean: sum / n, median, min: s[0], max: s[n - 1] };}/** Nearest-rank percentile. Throws StatsError. */export function percentile(values: number[], p: number): number { const s = sortedCopy(values); if (typeof p !== "number" || !Number.isFinite(p) || p < 0 || p > 100) { throw new StatsError("invalid_percentile"); } const rank = Math.max(1, Math.ceil((p / 100) * s.length)); return s[rank - 1];}