mogged

Tiny, extremely fast score-comparison utilities.

mogged is a lightweight TypeScript library for checking whether one score is decisively outclassed ("mogged") by another score.

Install

bun add mogged

Usage

import { isMogged, mog, mogMany } from "mogged";

isMogged(95, 100); // true
mog(95, 100); // { mogged: true, gap: 5 }
mogMany([75, 110, 99], 100); // Uint8Array([1, 0, 1])

API

• mogDiff(subjectScore, opponentScore): number
• isMogged(subjectScore, opponentScore, threshold?): boolean
• mog(subjectScore, opponentScore, threshold?): { mogged: boolean; gap: number }
• mogMany(subjectScores, opponentScore, threshold?): Uint8Array

Development

bun install
bun run typecheck
bun test
bun run build
bun run bench

Publish To npm

1. Authenticate once: bunx npm login
2. Set token in your shell: setx NPM_TOKEN "your_token_here" (new terminal required)
3. Update package version: bunx npm version patch (or minor/major)
4. Build and verify: bun run build && bun test
5. Dry run package: bunx npm pack --dry-run
6. Publish: bunx npm publish --access public

Notes

• .npmrc is configured to use NPM_TOKEN for secure publishing.
• Output includes ESM, CJS, and TypeScript declarations in dist/.