utils/ts_config/eslint/require.js
Krzysztof kuhy Rudnicki 128ede438e ts_config: @kuhyx/ts-config, the one lint/TS bar every TypeScript repo extends
Evil Martians' "ten anti-AI-slop moves" as a package: strict tsconfig base
(noUncheckedIndexedAccess, exactOptionalPropertyTypes), type-checked
typescript-eslint strict+stylistic, unicorn/sonarjs/perfectionist, behaviour
rules for tests (expect-expect, no-focused-tests), React (hooks, @eslint-react,
jsx-a11y strict, you-might-not-need-an-effect), Playwright, and layer
boundaries via eslint-plugin-boundaries 7 with the article's default policies.
Knip / jscpd / Stryker bases; Stryker carries no break threshold on purpose.

Plugins are dependencies, not devDependencies: a flat config imports them from
this package's own node_modules, so a consumer installing from the git tag
gets them or the lint cannot run. No build step, so the tag needs no prepare.

test/fixture is a mini repo with one planted violation per rule family;
test/expected.js names the rule that must catch each, and the suite runs the
real CLI over it (in a child process -- v8 coverage merges natively-loaded
and transformed copies of the same module into "uncovered"). 35 tests, 100%
branch coverage on the factories.

eslint/fast.js is the type-free subset for a per-edit hook: 0.52 s cold on
one file, measured against 1.28 s for base() without types -- importing a
plugin is the cost, so it loads none, nor base.js which imports them.

Probed under ESLint 10: jsx-a11y 6.10.2 (peer says <=9) and boundaries 7.2.0
both run; the fixture pins that.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DnAYyNH1Sm4iJNidfYbrZJ
2026-09-16 21:40:08 +02:00

31 lines
912 B
JavaScript

// Argument guards for the factories. A preset that silently accepts a missing
// repo root lints with the wrong project and reports nothing -- the worst
// failure mode for a gate -- so the factories refuse loudly instead.
/**
* @param {unknown} value
* @param {string} what Name used in the error message.
* @returns {string}
*/
export function requireNonEmptyString(value, what) {
const isPresent = typeof value === "string" && value !== "";
if (!isPresent) {
throw new TypeError(`@kuhyx/ts-config: ${what} is required (pass import.meta.dirname)`);
}
return value;
}
/**
* @template T
* @param {unknown} value
* @param {string} what
* @returns {T[]}
*/
export function requireNonEmptyArray(value, what) {
const isPresent = Array.isArray(value) && value.length > 0;
if (!isPresent) {
throw new TypeError(`@kuhyx/ts-config: ${what} needs a non-empty list`);
}
return value;
}