mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-10 22:47:14 +01:00
Krzysztof kuhy Rudnicki
c5b3fceeae
The two shared packages are the first repos on the preset (link:../ts_config inside the monorepo; consumers outside use the git tag). Each eslint.config.js is now the defineConfig() call plus one override with its reason: a public API name (`nextChance`, `fuzzyMatch`) the boolean-prefix rule would rename, which is a breaking change for the three repos importing it. Everything else the preset flagged is fixed in code, not disabled: key order (perfectionist), hex casing, sort compare functions in tests, Iterator#map().toArray(), explicit returns on multiline arrows. web_ui: react-refresh/only-export-components was a real finding -- range-slider.tsx exported `steppedValue` next to the component, which breaks Vite HMR for the module. The keyboard contract moves to stepped-value.ts as `steppedValue` + a new pure `keyTarget(key, values, current)`, which also resolves unicorn/no-late-event-control: the handler now decides the target first and calls preventDefault() only when it owns the key. Its tests move with it (the 250-line gate caught the combined file). Minor bump for the new export. dist/ rebuilt in both packages. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DnAYyNH1Sm4iJNidfYbrZJ
79 lines
2.9 KiB
TypeScript
79 lines
2.9 KiB
TypeScript
/**
|
|
* Distribution-aware slider maths.
|
|
*
|
|
* A linear min..max track is useless on skewed data, which is the normal case
|
|
* in both consumers: dufs-cloud's file sizes span bytes to gigabytes, and
|
|
* awesome-mcp-explorer's star counts run 0..166,785 with a median of 8, so a
|
|
* linear midpoint sits above 99.9% of all rows. Mapping the track through the
|
|
* actual distribution puts the middle of the track at the median, which makes
|
|
* equal track distance mean roughly equal numbers of items.
|
|
*
|
|
* This was duplicated in dufs-cloud and awesome-mcp-explorer before it moved
|
|
* here; both now import it.
|
|
*/
|
|
|
|
/**
|
|
* Bounds-checked array access (callers guarantee the index is valid). Keeps the
|
|
* quantile helpers free of scattered non-null assertions or dead undefined
|
|
* guards while still satisfying `noUncheckedIndexedAccess`.
|
|
*/
|
|
export function nth(values: readonly number[], index: number): number {
|
|
const value = values[index];
|
|
if (value === undefined) {
|
|
throw new RangeError(`index ${String(index)} out of range`);
|
|
}
|
|
return value;
|
|
}
|
|
|
|
/** Clamp to the unit interval. */
|
|
export function clamp01(x: number): number {
|
|
return Math.min(1, Math.max(0, x));
|
|
}
|
|
|
|
/**
|
|
* The value at quantile `f` (0..1) of an ascending, non-empty array, with linear
|
|
* interpolation between the two straddling samples. This is what makes the
|
|
* sliders distribution-aware: f = 0.5 returns the *median*, so the middle of the
|
|
* track sits where half the items are — not the arithmetic midpoint of the
|
|
* range. Empty input yields 0 (callers hide the slider in that case).
|
|
*/
|
|
export function quantileValue(sorted: readonly number[], f: number): number {
|
|
const n = sorted.length;
|
|
if (n === 0) return 0;
|
|
const pos = clamp01(f) * (n - 1);
|
|
const lo = Math.floor(pos);
|
|
const hi = Math.ceil(pos);
|
|
const a = nth(sorted, lo);
|
|
const b = nth(sorted, hi);
|
|
return Math.round(a + (b - a) * (pos - lo));
|
|
}
|
|
|
|
/**
|
|
* The quantile (0..1) of `value` within `sorted` — the inverse of
|
|
* {@link quantileValue}, used to place a thumb at the right spot on the track.
|
|
* Values at or beyond the ends map to 0/1.
|
|
*/
|
|
export function valueQuantile(sorted: readonly number[], value: number): number {
|
|
const n = sorted.length;
|
|
if ((n <= 1) || (value <= nth(sorted, 0))) return 0;
|
|
if (value >= nth(sorted, n - 1)) return 1;
|
|
// value strictly inside the range, so there is an index hi >= 1 with
|
|
// sorted[hi] >= value and sorted[hi - 1] < value.
|
|
const hi = sorted.findIndex((v) => v >= value);
|
|
const lo = hi - 1;
|
|
const a = nth(sorted, lo);
|
|
const b = nth(sorted, hi);
|
|
// a < value <= b here, so b - a > 0 (no divide-by-zero).
|
|
return (lo + (value - a) / (b - a)) / (n - 1);
|
|
}
|
|
|
|
/**
|
|
* Pointer x to a 0..1 fraction of a track.
|
|
*
|
|
* Extracted as pure geometry so slider behaviour is testable without layout,
|
|
* which jsdom does not implement.
|
|
*/
|
|
export function fractionFromPointer(rect: DOMRect, clientX: number): number {
|
|
return rect.width === 0 ? 0 : clamp01((clientX - rect.left) / rect.width);
|
|
}
|