Дефолтный flat-config пресет, поставляемый @triggery/eslint-plugin. Включает семь из восьми правил со степенями, ловящими реальные проблемы, но не топящими диф. prefer-named-hook в recommended отключено — это стилистический намёк, доступный в более строгом пресете.

Для проектов, которым нужен максимальный сигнал, см. пресет strict, поднимающий всё до уровня error и добавляющий более жёсткие лимиты на размер обработчика/портов.

Импорт

import triggery from '@triggery/eslint-plugin';

// or, named:
import { recommended } from '@triggery/eslint-plugin';

Использование

// eslint.config.js (flat config — ESLint 9.x)
import triggery from '@triggery/eslint-plugin';

export default [
  // … your other configs
  triggery.configs.recommended,
];

Выбор отдельных правил вместо распыления пресета тоже работает:

// eslint.config.js
import triggery from '@triggery/eslint-plugin';

export default [
  {
    plugins: { '@triggery': triggery },
    rules: {
      '@triggery/no-dynamic-id': 'error',
      '@triggery/hook-rules': 'error',
    },
  },
];

Правила в `recommended`

Правило	Степень	Что ловит
`@triggery/no-dynamic-id`	`error`	`createTrigger({ id: someVariable })` — id должен быть строковым литералом, чтобы статический анализ (devtools, CLI `triggery graph`) мог его резолвить.
`@triggery/no-event-cascade`	`error`	Обработчик триггера, зовущий `runtime.fire` (или хелпер зажигания), запрещён; эмить через `actions.<name>?.(payload)` либо прими, что каскад намеренный, и отключи правило построчно.
`@triggery/hook-rules`	`error`	`useEvent / useCondition / useAction / useInlineTrigger` вне React-функции — тот же смысл, что у `react-hooks/rules-of-hooks`, но применительно к хукам Triggery.
`@triggery/exhaustive-conditions`	`warn`	Условие, перечисленное в схеме, но не зарегистрированное ни на одной достижимой ветке кода. Выявляет мёртвую surface area.
`@triggery/exhaustive-required`	`warn`	Условию, объявленному в `required`, не хватает дефолтной регистрации (и оно всегда будет short-circuit’ить).
`@triggery/max-handler-size`	`warn`	Тело функции-обработчика превышает порог (по умолчанию 50 строк). Намёк вынести работу в действия.
`@triggery/max-ports-per-trigger`	`warn`	У схемы триггера слишком много событий / условий / суммарных портов. Намёк разбить на несколько триггеров.

Оставшееся правило, @triggery/prefer-named-hook, в recommended не включено — адоптеры обычно предпочитают универсальную форму useEvent(trigger, 'x'), пока у порта не больше пары мест вызова. Включай его в пресете strict или поправилу.

Примеры

Переопределить одну степень

// eslint.config.js
import triggery from '@triggery/eslint-plugin';

export default [
  triggery.configs.recommended,
  {
    rules: {
      '@triggery/exhaustive-conditions': 'error',
      '@triggery/max-handler-size': ['error', { max: 40 }],
    },
  },
];

Отключить для legacy-папок

// eslint.config.js
import triggery from '@triggery/eslint-plugin';

export default [
  triggery.configs.recommended,
  {
    files: ['legacy/**/*.ts'],
    rules: {
      '@triggery/no-dynamic-id': 'off',
      '@triggery/hook-rules': 'off',
    },
  },
];

Накатить strict-пресет сверху

// eslint.config.js
import triggery from '@triggery/eslint-plugin';

export default [
  triggery.configs.recommended,
  triggery.configs.strict, // overrides previous severities with stricter values
];

Замечания

См. также

createTrigger Конструктор, который анализирует большинство правил.

useEvent / useCondition / useAction Хуки, которые принуждает `hook-rules`.

createNamedHooks Включай `prefer-named-hook`, когда внедряешь этот хелпер.

Руководство по линтингу Интеграция с редактором, настройка CI, ignore-паттерны.