export type RNG = (max?: number, min?: number) => number export function random(max: number, min: number = 0, rng?: RNG): number { if (rng) return rng(max, min) return Math.floor(Math.random() * (max - min + 1)) + min } export function pick(items: T[], rng?: RNG) { if (items.length === 0) return null return items[random(items.length - 1, 0, rng)] ?? null } export type WeightItem = [T, number] export function pickWeight(items: WeightItem[], rng?: RNG) { if (items.length === 0) return null const totalWeight = items.reduce((sum, [, weight]) => sum + weight, 0) let mark = random(totalWeight - 1, 0, rng) for (const [item, weight] of items) { if (mark < weight) return item mark -= weight } return null } export function sum(arr: number[]) { return arr.reduce((sum, v) => sum + v, 0) } export function shuffle(array: T[], rng?: RNG): T[] { const result = [...array] for (let i = result.length - 1; i > 0; i--) { const j = random(i, 0, rng) const temp = result[i] result[i] = result[j]! result[j] = temp! } return result } export function keys( obj: T, filter?: K[], ): Exclude[] { const allKeys = Object.keys(obj) as (keyof T)[] if (!filter || filter.length === 0) return allKeys as Exclude[] const filterSet = new Set(filter) return allKeys.filter(key => !filterSet.has(key)) as Exclude[] }