@aggreggator-labs/config-eslint

The shared ESLint flat config for aggreggator-labs repositories. index.mjs is the source of truth; a repository spreads it after its own ignores and carries no second copy of a rule.

Usage

bun add -d @aggreggator-labs/config-eslint eslint typescript

Root eslint.config.mjs:

import shared from '@aggreggator-labs/config-eslint';

export default [
  { ignores: ['dist/**', 'coverage/**'] },
  ...shared,
];

Only the rules are shared; ignores are each repository's own. The spread keeps eslint-config-prettier as the last element, so Prettier wins every formatting conflict. The package brings its plugins along as dependencies; a consumer installs eslint (10 or newer) and typescript itself.

Rules

On top of @eslint/js recommended and typescript-eslint recommended - not type-aware, projectService is off - for .js, .mjs, .cjs, .ts, .tsx and .jsx files, with Node globals:

• no-console off
• import-x/order warn - builtin, external, internal, parent, sibling, index, type; a blank line between groups; alphabetised without regard to case
• @typescript-eslint/consistent-type-imports warn - prefer import type
• @typescript-eslint/no-explicit-any off
• @typescript-eslint/no-unused-vars off - the unused-imports pair below reports instead, once
• unused-imports/no-unused-imports warn
• unused-imports/no-unused-vars warn - all variables, arguments after the last used one; names starting with _ are ignored

Browser globals and React rules are not part of this config; either would be a second export, not a change to this one.

Publishing

Releases are staged, never pushed live by a machine. A push to main with a new version in package.json runs .github/workflows/publish-npm.yml in the dotfiles repository, which stages the version on npmjs through trusted publishing (GitHub OIDC, no token; no provenance, which npm attaches only for public source repositories). A maintainer then approves it with two-factor authentication - npm stage approve or the package page - and only then is it on the registry. An unchanged version stages nothing and says so. Bump the version here to release; patch bumps (0.0.x) by default.