菜单
Number utilities from @mongez/reinforcements — rounding, clamping, range helpers, safe arithmetic (safeDivide, percentage, parseNumber), and formatting (formatBytes, formatNumber).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
High-level orientation to @mongez/reinforcements — a ~130-function TypeScript utility belt covering objects, strings, numbers, async, randomness, and functional composition.
@mongez/reinforcements array helpers — chunking, ranges, unique/dedupe, pluck, groupBy, countBy, stats (sum/avg/median/min/max), even/odd parity filters, and mutating pushUnique/unshiftUnique. One function per section: description, signature, example.
Async/Promise utilities from @mongez/reinforcements — sleep, retry with backoff, timeout racing, pProps/pAll/pMap/pSeries/pFilter for concurrent work, defer, and debounceAsync.
Function utilities from @mongez/reinforcements — debounce, throttle, memoize, once/after/before call-count gating, pipe/compose composition, curry/partial application, and FP primitives.
Deep path-aware object utilities from @mongez/reinforcements — get/set/has/unset, pick/omit, compact, merge, clone, flatten, walk, diff, and more.
Memoised deferred values via lazy() from @mongez/reinforcements — the primary tool for breaking ES-module circular imports and deferring expensive computation until first use.
| name | mongez-reinforcements-numbers |
| description | Number utilities from @mongez/reinforcements — rounding, clamping, range helpers, safe arithmetic (safeDivide, percentage, parseNumber), and formatting (formatBytes, formatNumber). |
Rounding, clamping, formatting, safe arithmetic. Import from @mongez/reinforcements.
round(value: number, precision?: number): number // default 2; rounds half-up
floor(value: number, precision?: number): number // default 0
ceil(value: number, precision?: number): number // default 0
toFixed(value: number, precision?: number): number // returns number, not string
round(1.235, 2); // 1.24
round(1.5, 0); // 2 (true rounding, not floor)
floor(1.99, 1); // 1.9
ceil(1.01, 1); // 1.1
toFixed(1.236, 2); // 1.24 (number, not "1.24")
clamp(value: number, min: number, max: number): number
inRange(value: number, min: number, max: number, options?: { inclusive?: boolean }): boolean
lerp(a: number, b: number, t: number): number
clamp normalizes swapped bounds. inRange defaults to inclusive: true.
clamp(15, 0, 10); // 10
clamp(-3, 0, 10); // 0
inRange(5, 0, 10); // true
inRange(10, 0, 10, { inclusive: false }); // false
lerp(0, 100, 0.25); // 25
safeDividesafeDivide<F = number>(a: number, b: number, fallback?: F): number | F
Returns fallback (default 0) when b === 0 or the result isn't finite.
safeDivide(10, 2); // 5
safeDivide(10, 0); // 0
safeDivide(10, 0, null); // null
percentagepercentage(value: number, total: number, decimals?: number): number // default 2
percentage(25, 200); // 12.5
percentage(7, 9, 1); // 77.8
percentage(1, 0); // 0 (safe on divide-by-zero)
parseNumberparseNumber<F = number>(value: unknown, fallback?: F): number | F
Returns fallback (default 0) for null / undefined / "" / non-numeric input.
parseNumber("42"); // 42
parseNumber("abc", -1); // -1
parseNumber(null, 0); // 0
formatBytesformatBytes(bytes: number, options?: {
decimals?: number; // default 2
binary?: boolean; // default false (use 1000-based units)
}): string
formatBytes(1500); // "1.50 KB"
formatBytes(1024, { binary: true, decimals: 0 }); // "1 KiB"
formatBytes(-1500, { decimals: 0 }); // "-2 KB"
formatBytes(0); // "0 B"
formatNumberformatNumber(value: number, options?: Intl.NumberFormatOptions & {
locale?: string | string[];
}): string
Thin wrapper around Intl.NumberFormat.
formatNumber(1234.5); // "1,234.5"
formatNumber(0.42, { style: "percent" }); // "42%"
formatNumber(99, { style: "currency", currency: "USD" }); // "$99.00"
formatNumber(1234, { locale: "ar-EG" }); // "١٬٢٣٤"
formatDurationformatDuration(ms: number, options?: {
units?: number; // max unit parts, largest-first; default Infinity
long?: boolean; // "1 hour 2 minutes" vs "1h 2m"; default false
separator?: string; // default " "
}): string
Human-readable duration from milliseconds (days → ms). Shows every non-zero unit by default; cap with units.
formatDuration(3661000); // "1h 1m 1s"
formatDuration(3661000, { units: 2 }); // "1h 1m"
formatDuration(90000, { long: true }); // "1 minute 30 seconds"
ordinalordinal(value: number, options?: { withNumber?: boolean }): string // withNumber default true
English ordinal for an integer; handles the 11–13 exception and negatives. The fraction is truncated.
ordinal(1); // "1st"
ordinal(22); // "22nd"
ordinal(113); // "113th"
ordinal(2, { withNumber: false }); // "nd"