@triggery/eslint-plugin 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @triggery/eslint-plugin
+
+## 0.1.0
+
+First public preview release.
+
+ESLint plugin for Triggery — catches mis-use of createTrigger / useEvent / useCondition / useAction, suggests named hooks, enforces handler size budgets.
+
+See the [repository-level CHANGELOG](../../CHANGELOG.md#010--2026-05-16) for the full set of packages and the umbrella feature list. Future entries on this file are appended automatically by changesets.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aleksey Skhomenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# @triggery/eslint-plugin
+
+ESLint plugin for Triggery: catches mis-use of `createTrigger` and the hook-API, enforces conventions, and keeps trigger files readable as specs.
+
+```bash
+pnpm add -D @triggery/eslint-plugin
+```
+
+## Rules
+
+| Rule                       | Recommended | Strict        | Auto-fix |
+|---------------------------|:-----------:|:-------------:|:--------:|
+| `no-dynamic-id`            | error       | error         | —        |
+| `no-event-cascade`         | error       | error         | —        |
+| `hook-rules`               | error       | error         | —        |
+| `exhaustive-conditions`    | warn        | error         | —        |
+| `exhaustive-required`      | warn        | error         | —        |
+| `max-handler-size`         | warn (≤50)  | error (≤30)   | —        |
+| `max-ports-per-trigger`    | warn (≤12)  | error (≤8)    | —        |
+| `prefer-named-hook`        | off         | warn (≥3)     | —        |
+
+## Flat config (ESLint 9.x)
+
+```js
+// eslint.config.js
+import triggery from '@triggery/eslint-plugin';
+
+export default [
+  triggery.configs.recommended,
+  // Or, if you want everything dialled up:
+  // triggery.configs.strict,
+];
+```
+
+## Cherry-picking individual rules
+
+```js
+import triggery from '@triggery/eslint-plugin';
+
+export default [
+  {
+    plugins: { '@triggery': triggery },
+    rules: {
+      '@triggery/no-dynamic-id': 'error',
+      '@triggery/no-event-cascade': 'error',
+      '@triggery/max-handler-size': ['warn', { max: 40 }],
+    },
+  },
+];
+```
+
+## Per-rule
+
+### `no-dynamic-id`
+
+`createTrigger({ id })` must be a string literal. Trigger ids are runtime registry keys, devtools action labels and graph-output anchors — they must be deterministic.
+
+### `no-event-cascade`
+
+Disallows calling `useEvent(...)` inside a `useAction(...)` handler. Cascades are allowed at runtime (up to `maxCascadeDepth`), but writing them inline hides cross-trigger control flow.
+
+### `hook-rules`
+
+Framework-neutral rules-of-hooks: `useEvent` / `useCondition` / `useAction` / `useInlineTrigger` must be called from a component (function whose name starts with an uppercase letter) or a custom hook (function whose name starts with `use[A-Z]`).
+
+### `exhaustive-conditions`
+
+If a trigger declares `required: ['user','settings']`, the same file must contain at least one `useCondition(<trigger>, 'user', ...)` and one `useCondition(<trigger>, 'settings', ...)`. Cross-file checks are intentionally out of scope to keep the rule fast and predictable.
+
+### `exhaustive-required`
+
+Every `createTrigger({...})` call must include an explicit `required:` key (use `required: []` if no conditions are required). Catches the common mistake of "I forgot the gate, the handler will run on every fire even when the world isn't ready".
+
+### `max-handler-size` (configurable, default 50)
+
+```js
+'@triggery/max-handler-size': ['warn', { max: 50 }]
+```
+
+Counts top-level statements in the handler body. If you hit the limit, consider the `extract-trigger` codemod from `@triggery/codemod`.
+
+### `max-ports-per-trigger` (configurable)
+
+```js
+'@triggery/max-ports-per-trigger': ['warn', { maxEvents: 8, maxConditions: 8, maxTotal: 12 }]
+```
+
+Caps the per-trigger port count to keep scenarios spec-like.
+
+### `prefer-named-hook` (configurable, off by default)
+
+```js
+'@triggery/prefer-named-hook': ['warn', { threshold: 4 }]
+```
+
+Once a file has `threshold` or more port calls, suggests switching from `useEvent(trigger, 'new-message')` to the named hook `useNewMessageEvent` (available via `trigger.namedHooks()`).

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import * as _typescript_eslint_utils_ts_eslint from '@typescript-eslint/utils/ts-eslint';
+import { ESLint, Linter } from 'eslint';
+
+declare const rules: {
+    'exhaustive-conditions': _typescript_eslint_utils_ts_eslint.RuleModule<"missing", [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    'exhaustive-required': _typescript_eslint_utils_ts_eslint.RuleModule<"missing", [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    'hook-rules': _typescript_eslint_utils_ts_eslint.RuleModule<"outside", [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    'max-handler-size': _typescript_eslint_utils_ts_eslint.RuleModule<"tooLarge", [{
+        max?: number;
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    'max-ports-per-trigger': _typescript_eslint_utils_ts_eslint.RuleModule<"tooManyTotal" | "tooManyEvents" | "tooManyConditions", [{
+        maxEvents?: number;
+        maxConditions?: number;
+        maxTotal?: number;
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    'no-dynamic-id': _typescript_eslint_utils_ts_eslint.RuleModule<"dynamic", [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    'no-event-cascade': _typescript_eslint_utils_ts_eslint.RuleModule<"cascade", [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    'prefer-named-hook': _typescript_eslint_utils_ts_eslint.RuleModule<"prefer", [{
+        threshold?: number;
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+};
+declare const recommended: Linter.Config;
+declare const strict: Linter.Config;
+declare const finalPlugin: ESLint.Plugin;
+
+export { finalPlugin as default, recommended, rules, strict };

package/dist/index.js

@@ -0,0 +1,530 @@
+import { ESLintUtils, AST_NODE_TYPES } from '@typescript-eslint/utils';
+
+// src/rules/exhaustive-conditions.ts
+var TRIGGERY_HOOK_NAMES = /* @__PURE__ */ new Set([
+  "useEvent",
+  "useCondition",
+  "useAction",
+  "useInlineTrigger"
+]);
+function isCreateTriggerCall(node) {
+  const callee = node.callee;
+  if (callee.type === AST_NODE_TYPES.Identifier && callee.name === "createTrigger") return true;
+  if (callee.type === AST_NODE_TYPES.MemberExpression && callee.property.type === AST_NODE_TYPES.Identifier && callee.property.name === "createTrigger") {
+    return true;
+  }
+  return false;
+}
+function getStringLiteralValue(node) {
+  if (!node) return null;
+  if (node.type === AST_NODE_TYPES.Literal && typeof node.value === "string") {
+    return node.value;
+  }
+  if (node.type === AST_NODE_TYPES.TemplateLiteral && node.expressions.length === 0 && node.quasis.length === 1 && node.quasis[0]) {
+    return node.quasis[0].value.cooked;
+  }
+  return null;
+}
+function toPascalCase(name) {
+  return name.split(/[-_\s]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+function findEnclosingFunction(node) {
+  let current = node.parent;
+  while (current) {
+    if (current.type === AST_NODE_TYPES.FunctionDeclaration || current.type === AST_NODE_TYPES.FunctionExpression || current.type === AST_NODE_TYPES.ArrowFunctionExpression) {
+      return current;
+    }
+    current = current.parent;
+  }
+  return null;
+}
+function isComponentOrHookFunction(fn) {
+  const name = getFunctionName(fn);
+  if (!name) return false;
+  return /^[A-Z]/.test(name) || /^use[A-Z]/.test(name);
+}
+function getFunctionName(fn) {
+  if (fn.type === AST_NODE_TYPES.FunctionDeclaration && fn.id) return fn.id.name;
+  if (fn.type === AST_NODE_TYPES.FunctionExpression && fn.id) return fn.id.name;
+  const parent = fn.parent;
+  if (parent && parent.type === AST_NODE_TYPES.VariableDeclarator) {
+    const id = parent.id;
+    if (id.type === AST_NODE_TYPES.Identifier) return id.name;
+  }
+  if (parent && parent.type === AST_NODE_TYPES.Property) {
+    const key = parent.key;
+    if (key.type === AST_NODE_TYPES.Identifier) return key.name;
+  }
+  return null;
+}
+
+// src/rules/exhaustive-conditions.ts
+var createRule = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`
+);
+var exhaustiveConditions = createRule({
+  name: "exhaustive-conditions",
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Ensure every `required` condition of a trigger has at least one `useCondition` registration in the same file."
+    },
+    messages: {
+      missing: "Trigger `{{trigger}}` declares `required: [..., '{{name}}', ...]`, but this file has no `useCondition({{trigger}}, '{{name}}', ...)`. The handler will always skip with `missing-required`."
+    },
+    schema: []
+  },
+  defaultOptions: [],
+  create(context) {
+    const triggers = [];
+    const provided = /* @__PURE__ */ new Map();
+    function record(triggerVar, conditionName) {
+      let set = provided.get(triggerVar);
+      if (!set) {
+        set = /* @__PURE__ */ new Set();
+        provided.set(triggerVar, set);
+      }
+      set.add(conditionName);
+    }
+    return {
+      CallExpression(node) {
+        if (isCreateTriggerCall(node)) {
+          const parent = node.parent;
+          if (!parent || parent.type !== AST_NODE_TYPES.VariableDeclarator) return;
+          if (parent.id.type !== AST_NODE_TYPES.Identifier) return;
+          const varName = parent.id.name;
+          const config = node.arguments[0];
+          if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;
+          const requiredProp = config.properties.find(
+            (p) => p.type === AST_NODE_TYPES.Property && p.key.type === AST_NODE_TYPES.Identifier && p.key.name === "required"
+          );
+          if (!requiredProp) return;
+          if (requiredProp.value.type !== AST_NODE_TYPES.ArrayExpression) return;
+          const required = [];
+          for (const el of requiredProp.value.elements) {
+            const name = getStringLiteralValue(el ?? void 0);
+            if (name) required.push(name);
+          }
+          if (required.length > 0) triggers.push({ varName, required, node: requiredProp.value });
+          return;
+        }
+        if (node.callee.type === AST_NODE_TYPES.Identifier && node.callee.name === "useCondition" && node.arguments[0] && node.arguments[0].type === AST_NODE_TYPES.Identifier && node.arguments[1]) {
+          const triggerVar = node.arguments[0].name;
+          const conditionName = getStringLiteralValue(node.arguments[1]);
+          if (conditionName) record(triggerVar, conditionName);
+        }
+      },
+      "Program:exit"() {
+        for (const trigger of triggers) {
+          const set = provided.get(trigger.varName) ?? /* @__PURE__ */ new Set();
+          for (const name of trigger.required) {
+            if (!set.has(name)) {
+              context.report({
+                node: trigger.node,
+                messageId: "missing",
+                data: { trigger: trigger.varName, name }
+              });
+            }
+          }
+        }
+      }
+    };
+  }
+});
+var createRule2 = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`
+);
+var exhaustiveRequired = createRule2({
+  name: "exhaustive-required",
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "Require an explicit `required` array on every createTrigger call (use `required: []` to opt out)."
+    },
+    messages: {
+      missing: "Trigger config is missing `required: [...]`. Add it explicitly so the runtime gate is unambiguous (use `required: []` if no conditions are required)."
+    },
+    schema: []
+  },
+  defaultOptions: [],
+  create(context) {
+    return {
+      CallExpression(node) {
+        if (!isCreateTriggerCall(node)) return;
+        const config = node.arguments[0];
+        if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;
+        const hasRequired = config.properties.some(
+          (p) => p.type === AST_NODE_TYPES.Property && p.key.type === AST_NODE_TYPES.Identifier && p.key.name === "required"
+        );
+        if (!hasRequired) context.report({ node: config, messageId: "missing" });
+      }
+    };
+  }
+});
+var createRule3 = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`
+);
+var hookRules = createRule3({
+  name: "hook-rules",
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Allow Triggery hooks (useEvent/useCondition/useAction) only inside components or other hooks."
+    },
+    messages: {
+      outside: "`{{hook}}` may only be called from a component or a custom hook (function name starting with an uppercase letter or with `use[A-Z]`)."
+    },
+    schema: []
+  },
+  defaultOptions: [],
+  create(context) {
+    return {
+      CallExpression(node) {
+        if (node.callee.type !== AST_NODE_TYPES.Identifier) return;
+        const hook = node.callee.name;
+        if (!TRIGGERY_HOOK_NAMES.has(hook)) return;
+        const fn = findEnclosingFunction(node);
+        if (!fn || !isComponentOrHookFunction(fn)) {
+          context.report({ node, messageId: "outside", data: { hook } });
+        }
+      }
+    };
+  }
+});
+var createRule4 = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`
+);
+var maxHandlerSize = createRule4({
+  name: "max-handler-size",
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "Limit the size of a trigger handler body (default 50 statements)."
+    },
+    messages: {
+      tooLarge: "Trigger handler has {{count}} top-level statements, which exceeds the limit of {{max}}. Consider splitting it (see the `extract-trigger` codemod) or moving logic into smaller actions."
+    },
+    schema: [
+      {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          max: { type: "integer", minimum: 1 }
+        }
+      }
+    ]
+  },
+  defaultOptions: [{ max: 50 }],
+  create(context, [options]) {
+    const max = options.max ?? 50;
+    return {
+      CallExpression(node) {
+        if (!isCreateTriggerCall(node)) return;
+        const config = node.arguments[0];
+        if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;
+        for (const prop of config.properties) {
+          if (prop.type !== AST_NODE_TYPES.Property) continue;
+          if (prop.key.type !== AST_NODE_TYPES.Identifier || prop.key.name !== "handler") continue;
+          const handler = prop.value;
+          let body = null;
+          if (handler.type === AST_NODE_TYPES.FunctionExpression || handler.type === AST_NODE_TYPES.ArrowFunctionExpression) {
+            if (handler.body.type === AST_NODE_TYPES.BlockStatement) body = handler.body;
+          }
+          if (!body) return;
+          const count = body.body.length;
+          if (count > max) {
+            context.report({
+              node: handler,
+              messageId: "tooLarge",
+              data: { count, max }
+            });
+          }
+          return;
+        }
+      }
+    };
+  }
+});
+var createRule5 = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`
+);
+var maxPortsPerTrigger = createRule5({
+  name: "max-ports-per-trigger",
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "Cap the number of events / required-conditions per trigger to keep scenarios spec-like."
+    },
+    messages: {
+      tooManyTotal: "Trigger has {{count}} ports declared in its config (limit: {{max}}). Consider splitting it.",
+      tooManyEvents: "Trigger lists {{count}} events (limit: {{max}}). Split scenarios that fire on different events.",
+      tooManyConditions: "Trigger requires {{count}} conditions (limit: {{max}}). Consider whether all are truly required, or move some to opt-in checks via `check.is()`."
+    },
+    schema: [
+      {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          maxEvents: { type: "integer", minimum: 1 },
+          maxConditions: { type: "integer", minimum: 1 },
+          maxTotal: { type: "integer", minimum: 1 }
+        }
+      }
+    ]
+  },
+  defaultOptions: [{ maxEvents: 8, maxConditions: 8, maxTotal: 12 }],
+  create(context, [options]) {
+    const maxEvents = options.maxEvents ?? 8;
+    const maxConditions = options.maxConditions ?? 8;
+    const maxTotal = options.maxTotal ?? 12;
+    function countStringArrayProp(config, propName) {
+      const prop = config.properties.find(
+        (p) => p.type === AST_NODE_TYPES.Property && p.key.type === AST_NODE_TYPES.Identifier && p.key.name === propName
+      );
+      if (!prop) return 0;
+      if (prop.value.type !== AST_NODE_TYPES.ArrayExpression) return 0;
+      return prop.value.elements.length;
+    }
+    return {
+      CallExpression(node) {
+        if (!isCreateTriggerCall(node)) return;
+        const config = node.arguments[0];
+        if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;
+        const events = countStringArrayProp(config, "events");
+        const required = countStringArrayProp(config, "required");
+        const total = events + required;
+        if (events > maxEvents) {
+          context.report({
+            node: config,
+            messageId: "tooManyEvents",
+            data: { count: events, max: maxEvents }
+          });
+        }
+        if (required > maxConditions) {
+          context.report({
+            node: config,
+            messageId: "tooManyConditions",
+            data: { count: required, max: maxConditions }
+          });
+        }
+        if (total > maxTotal) {
+          context.report({
+            node: config,
+            messageId: "tooManyTotal",
+            data: { count: total, max: maxTotal }
+          });
+        }
+      }
+    };
+  }
+});
+var createRule6 = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`
+);
+var noDynamicId = createRule6({
+  name: "no-dynamic-id",
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require createTrigger({ id }) to be a string literal."
+    },
+    messages: {
+      dynamic: "`createTrigger` id must be a string literal, not a dynamic expression. The id is used as a registry key, in devtools and in graph(), and must be deterministic."
+    },
+    schema: []
+  },
+  defaultOptions: [],
+  create(context) {
+    return {
+      CallExpression(node) {
+        if (!isCreateTriggerCall(node)) return;
+        const config = node.arguments[0];
+        if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;
+        for (const prop of config.properties) {
+          if (prop.type !== AST_NODE_TYPES.Property) continue;
+          if (prop.key.type !== AST_NODE_TYPES.Identifier || prop.key.name !== "id") continue;
+          if (getStringLiteralValue(prop.value) === null) {
+            context.report({ node: prop.value, messageId: "dynamic" });
+          }
+          return;
+        }
+      }
+    };
+  }
+});
+var createRule7 = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`
+);
+var noEventCascade = createRule7({
+  name: "no-event-cascade",
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow calling useEvent inside a useAction handler (implicit cascade)."
+    },
+    messages: {
+      cascade: "Avoid calling `{{callee}}` inside a `useAction` handler \u2014 this creates an implicit cascade. Compose triggers explicitly instead."
+    },
+    schema: []
+  },
+  defaultOptions: [],
+  create(context) {
+    const useActionHandlers = [];
+    function isUseActionHandlerArgument(node) {
+      const parent = node.parent;
+      if (!parent || parent.type !== AST_NODE_TYPES.CallExpression) return false;
+      if (parent.arguments[2] !== node) return false;
+      const callee = parent.callee;
+      return callee.type === AST_NODE_TYPES.Identifier && callee.name === "useAction";
+    }
+    function enterFn(node) {
+      if (isUseActionHandlerArgument(node)) useActionHandlers.push(node);
+    }
+    function exitFn(node) {
+      if (useActionHandlers[useActionHandlers.length - 1] === node) useActionHandlers.pop();
+    }
+    return {
+      FunctionExpression: enterFn,
+      ArrowFunctionExpression: enterFn,
+      FunctionDeclaration: enterFn,
+      "FunctionExpression:exit": exitFn,
+      "ArrowFunctionExpression:exit": exitFn,
+      "FunctionDeclaration:exit": exitFn,
+      CallExpression(node) {
+        if (useActionHandlers.length === 0) return;
+        if (node.callee.type !== AST_NODE_TYPES.Identifier) return;
+        if (node.callee.name !== "useEvent") return;
+        context.report({
+          node,
+          messageId: "cascade",
+          data: { callee: node.callee.name }
+        });
+      }
+    };
+  }
+});
+var createRule8 = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`
+);
+var preferNamedHook = createRule8({
+  name: "prefer-named-hook",
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: 'In files with many port calls, prefer named hooks (useFooEvent) over generic useEvent("foo").'
+    },
+    messages: {
+      prefer: "Consider using `{{suggestion}}` instead of `{{generic}}` once a file has many ({{count}} \u2265 {{threshold}}) port calls."
+    },
+    schema: [
+      {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          threshold: { type: "integer", minimum: 1 }
+        }
+      }
+    ]
+  },
+  defaultOptions: [{ threshold: 4 }],
+  create(context, [options]) {
+    const threshold = options.threshold ?? 4;
+    const portCalls = [];
+    function suffixFor(kind) {
+      switch (kind) {
+        case "useEvent":
+          return "Event";
+        case "useCondition":
+          return "Condition";
+        case "useAction":
+          return "Action";
+        default:
+          return "";
+      }
+    }
+    return {
+      CallExpression(node) {
+        if (node.callee.type !== AST_NODE_TYPES.Identifier) return;
+        const name = node.callee.name;
+        if (!["useEvent", "useCondition", "useAction"].includes(name)) return;
+        const portArg = node.arguments[1];
+        const portName = getStringLiteralValue(portArg);
+        if (!portName) return;
+        portCalls.push({ node, kind: name, name: portName });
+      },
+      "Program:exit"() {
+        if (portCalls.length < threshold) return;
+        for (const call of portCalls) {
+          const suggestion = `use${toPascalCase(call.name)}${suffixFor(call.kind)}`;
+          context.report({
+            node: call.node,
+            messageId: "prefer",
+            data: {
+              suggestion,
+              generic: `${call.kind}(\u2026, '${call.name}', \u2026)`,
+              count: portCalls.length,
+              threshold
+            }
+          });
+        }
+      }
+    };
+  }
+});
+
+// src/index.ts
+var rules = {
+  "exhaustive-conditions": exhaustiveConditions,
+  "exhaustive-required": exhaustiveRequired,
+  "hook-rules": hookRules,
+  "max-handler-size": maxHandlerSize,
+  "max-ports-per-trigger": maxPortsPerTrigger,
+  "no-dynamic-id": noDynamicId,
+  "no-event-cascade": noEventCascade,
+  "prefer-named-hook": preferNamedHook
+};
+var meta = {
+  name: "@triggery/eslint-plugin",
+  version: "0.0.0"
+};
+var plugin = {
+  meta,
+  rules
+};
+var recommended = {
+  plugins: { "@triggery": plugin },
+  rules: {
+    "@triggery/no-dynamic-id": "error",
+    "@triggery/no-event-cascade": "error",
+    "@triggery/hook-rules": "error",
+    "@triggery/exhaustive-conditions": "warn",
+    "@triggery/exhaustive-required": "warn",
+    "@triggery/max-handler-size": "warn",
+    "@triggery/max-ports-per-trigger": "warn"
+  }
+};
+var strict = {
+  plugins: { "@triggery": plugin },
+  rules: {
+    "@triggery/no-dynamic-id": "error",
+    "@triggery/no-event-cascade": "error",
+    "@triggery/hook-rules": "error",
+    "@triggery/exhaustive-conditions": "error",
+    "@triggery/exhaustive-required": "error",
+    "@triggery/max-handler-size": ["error", { max: 30 }],
+    "@triggery/max-ports-per-trigger": ["error", { maxEvents: 5, maxConditions: 5, maxTotal: 8 }],
+    "@triggery/prefer-named-hook": ["warn", { threshold: 3 }]
+  }
+};
+var finalPlugin = {
+  ...plugin,
+  configs: {
+    recommended,
+    strict
+  }
+};
+var index_default = finalPlugin;
+
+export { index_default as default, recommended, rules, strict };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/triggery-call.ts","../src/rules/exhaustive-conditions.ts","../src/rules/exhaustive-required.ts","../src/rules/hook-rules.ts","../src/rules/max-handler-size.ts","../src/rules/max-ports-per-trigger.ts","../src/rules/no-dynamic-id.ts","../src/rules/no-event-cascade.ts","../src/rules/prefer-named-hook.ts","../src/index.ts"],"names":["AST_NODE_TYPES","createRule","ESLintUtils"],"mappings":"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","file":"index.js","sourcesContent":["import { AST_NODE_TYPES, type TSESTree } from '@typescript-eslint/utils';\n\n/**\n * Detect calls of the form `useEvent(trigger, 'event-name')`,\n * `useCondition(trigger, 'name', ...)`, `useAction(trigger, 'name', handler)`,\n * etc. The first positional argument is always the trigger reference,\n * the second is the port name as a string literal (or template literal).\n *\n * We match on the callee name only — adopters import these hooks under their\n * canonical names (and the `no-restricted-imports` rule in our recommended\n * config keeps it that way).\n */\nexport const TRIGGERY_HOOK_NAMES = new Set([\n  'useEvent',\n  'useCondition',\n  'useAction',\n  'useInlineTrigger',\n]);\n\nexport function isTriggeryHookCall(node: TSESTree.CallExpression): boolean {\n  return (\n    node.callee.type === AST_NODE_TYPES.Identifier && TRIGGERY_HOOK_NAMES.has(node.callee.name)\n  );\n}\n\nexport function isCreateTriggerCall(node: TSESTree.CallExpression): boolean {\n  const callee = node.callee;\n  if (callee.type === AST_NODE_TYPES.Identifier && callee.name === 'createTrigger') return true;\n  // Allow `triggery.createTrigger(...)` style.\n  if (\n    callee.type === AST_NODE_TYPES.MemberExpression &&\n    callee.property.type === AST_NODE_TYPES.Identifier &&\n    callee.property.name === 'createTrigger'\n  ) {\n    return true;\n  }\n  return false;\n}\n\nexport function getStringLiteralValue(node: TSESTree.Node | undefined): string | null {\n  if (!node) return null;\n  if (node.type === AST_NODE_TYPES.Literal && typeof node.value === 'string') {\n    return node.value;\n  }\n  if (\n    node.type === AST_NODE_TYPES.TemplateLiteral &&\n    node.expressions.length === 0 &&\n    node.quasis.length === 1 &&\n    node.quasis[0]\n  ) {\n    return node.quasis[0].value.cooked;\n  }\n  return null;\n}\n\n/**\n * Convert `'new-message'` → `'NewMessage'` so we can suggest\n * `useNewMessageEvent` etc.\n */\nexport function toPascalCase(name: string): string {\n  return name\n    .split(/[-_\\s]+/)\n    .filter(Boolean)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join('');\n}\n\n/**\n * Walks up the AST looking for the enclosing function (declaration, expression\n * or arrow). Returns the function node, or `null` if the call is at module top\n * level.\n */\nexport function findEnclosingFunction(\n  node: TSESTree.Node,\n):\n  | TSESTree.FunctionDeclaration\n  | TSESTree.FunctionExpression\n  | TSESTree.ArrowFunctionExpression\n  | null {\n  let current: TSESTree.Node | undefined = node.parent;\n  while (current) {\n    if (\n      current.type === AST_NODE_TYPES.FunctionDeclaration ||\n      current.type === AST_NODE_TYPES.FunctionExpression ||\n      current.type === AST_NODE_TYPES.ArrowFunctionExpression\n    ) {\n      return current;\n    }\n    current = current.parent;\n  }\n  return null;\n}\n\n/**\n * Heuristic — a function \"looks like a React/Solid/Vue component or hook\" if\n * its name starts with an uppercase letter (Component) or with `use`\n * (custom hook). For anonymous arrows we fall back to looking at the\n * variable declarator name.\n */\nexport function isComponentOrHookFunction(\n  fn: TSESTree.FunctionDeclaration | TSESTree.FunctionExpression | TSESTree.ArrowFunctionExpression,\n): boolean {\n  const name = getFunctionName(fn);\n  if (!name) return false;\n  return /^[A-Z]/.test(name) || /^use[A-Z]/.test(name);\n}\n\nexport function getFunctionName(\n  fn: TSESTree.FunctionDeclaration | TSESTree.FunctionExpression | TSESTree.ArrowFunctionExpression,\n): string | null {\n  if (fn.type === AST_NODE_TYPES.FunctionDeclaration && fn.id) return fn.id.name;\n  if (fn.type === AST_NODE_TYPES.FunctionExpression && fn.id) return fn.id.name;\n  const parent = fn.parent;\n  if (parent && parent.type === AST_NODE_TYPES.VariableDeclarator) {\n    const id = parent.id;\n    if (id.type === AST_NODE_TYPES.Identifier) return id.name;\n  }\n  if (parent && parent.type === AST_NODE_TYPES.Property) {\n    const key = parent.key;\n    if (key.type === AST_NODE_TYPES.Identifier) return key.name;\n  }\n  return null;\n}\n","import { AST_NODE_TYPES, ESLintUtils, type TSESTree } from '@typescript-eslint/utils';\nimport { getStringLiteralValue, isCreateTriggerCall } from '../utils/triggery-call.ts';\n\nconst createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`,\n);\n\ninterface TriggerInfo {\n  readonly varName: string;\n  readonly required: readonly string[];\n  readonly node: TSESTree.Node;\n}\n\n/**\n * Cross-checks `required` against `useCondition` registrations *within the\n * same file*. If the trigger declares `required: ['user', 'settings']` and\n * the file never calls `useCondition(thisTrigger, 'user', ...)` for one of\n * them, the handler will always skip with `missing-required` — which is\n * almost certainly not what the author intended.\n *\n * File-local scope by design: cross-file analysis is significantly more\n * expensive and the file-local heuristic catches ~80% of real mistakes (a\n * trigger and its first provider almost always sit in the same module\n * during initial wiring).\n */\nexport const exhaustiveConditions = createRule({\n  name: 'exhaustive-conditions',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Ensure every `required` condition of a trigger has at least one `useCondition` registration in the same file.',\n    },\n    messages: {\n      missing:\n        \"Trigger `{{trigger}}` declares `required: [..., '{{name}}', ...]`, but this file has no `useCondition({{trigger}}, '{{name}}', ...)`. The handler will always skip with `missing-required`.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    const triggers: TriggerInfo[] = [];\n    const provided = new Map<string, Set<string>>(); // trigger var → set of condition names\n\n    function record(triggerVar: string, conditionName: string): void {\n      let set = provided.get(triggerVar);\n      if (!set) {\n        set = new Set();\n        provided.set(triggerVar, set);\n      }\n      set.add(conditionName);\n    }\n\n    return {\n      CallExpression(node) {\n        if (isCreateTriggerCall(node)) {\n          // Find the variable being assigned: `export const foo = createTrigger({...})`.\n          const parent = node.parent;\n          if (!parent || parent.type !== AST_NODE_TYPES.VariableDeclarator) return;\n          if (parent.id.type !== AST_NODE_TYPES.Identifier) return;\n          const varName = parent.id.name;\n\n          const config = node.arguments[0];\n          if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;\n          const requiredProp = config.properties.find(\n            (p): p is TSESTree.Property =>\n              p.type === AST_NODE_TYPES.Property &&\n              p.key.type === AST_NODE_TYPES.Identifier &&\n              p.key.name === 'required',\n          );\n          if (!requiredProp) return;\n          if (requiredProp.value.type !== AST_NODE_TYPES.ArrayExpression) return;\n          const required: string[] = [];\n          for (const el of requiredProp.value.elements) {\n            const name = getStringLiteralValue(el ?? undefined);\n            if (name) required.push(name);\n          }\n          if (required.length > 0) triggers.push({ varName, required, node: requiredProp.value });\n          return;\n        }\n\n        if (\n          node.callee.type === AST_NODE_TYPES.Identifier &&\n          node.callee.name === 'useCondition' &&\n          node.arguments[0] &&\n          node.arguments[0].type === AST_NODE_TYPES.Identifier &&\n          node.arguments[1]\n        ) {\n          const triggerVar = node.arguments[0].name;\n          const conditionName = getStringLiteralValue(node.arguments[1]);\n          if (conditionName) record(triggerVar, conditionName);\n        }\n      },\n      'Program:exit'() {\n        for (const trigger of triggers) {\n          const set = provided.get(trigger.varName) ?? new Set<string>();\n          for (const name of trigger.required) {\n            if (!set.has(name)) {\n              context.report({\n                node: trigger.node,\n                messageId: 'missing',\n                data: { trigger: trigger.varName, name },\n              });\n            }\n          }\n        }\n      },\n    };\n  },\n});\n","import { AST_NODE_TYPES, ESLintUtils, type TSESTree } from '@typescript-eslint/utils';\nimport { isCreateTriggerCall } from '../utils/triggery-call.ts';\n\nconst createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`,\n);\n\n/**\n * If a trigger declares conditions in its schema generic but no `required`\n * array, the handler must do explicit `if (!conditions.x) return` for every\n * one — easy to forget. We can't read the type generic from the AST without\n * type info, but we can warn when `required` is missing on a trigger that\n * has a non-trivial handler with `conditions.*` accesses.\n *\n * Heuristic: any `createTrigger({...})` without a `required:` key — flagged\n * with severity `suggestion`. If you genuinely want no required conditions\n * (e.g. a trigger with only events and actions, or a pure analytics\n * pipeline), add `required: []` explicitly.\n */\nexport const exhaustiveRequired = createRule({\n  name: 'exhaustive-required',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Require an explicit `required` array on every createTrigger call (use `required: []` to opt out).',\n    },\n    messages: {\n      missing:\n        'Trigger config is missing `required: [...]`. Add it explicitly so the runtime gate is unambiguous (use `required: []` if no conditions are required).',\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      CallExpression(node) {\n        if (!isCreateTriggerCall(node)) return;\n        const config = node.arguments[0];\n        if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;\n        const hasRequired = config.properties.some(\n          (p: TSESTree.ObjectLiteralElement) =>\n            p.type === AST_NODE_TYPES.Property &&\n            p.key.type === AST_NODE_TYPES.Identifier &&\n            p.key.name === 'required',\n        );\n        if (!hasRequired) context.report({ node: config, messageId: 'missing' });\n      },\n    };\n  },\n});\n","import { AST_NODE_TYPES, ESLintUtils } from '@typescript-eslint/utils';\nimport {\n  findEnclosingFunction,\n  isComponentOrHookFunction,\n  TRIGGERY_HOOK_NAMES,\n} from '../utils/triggery-call.ts';\n\nconst createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`,\n);\n\n/**\n * Triggery hooks (`useEvent`, `useCondition`, `useAction`, `useInlineTrigger`)\n * obey React's rules-of-hooks contract: they may only be called from the\n * top level of a component / hook, never inside conditionals, loops, or\n * regular functions.\n *\n * `react-hooks/rules-of-hooks` covers React; this rule is framework-neutral\n * (Solid + Vue setup() also rely on stable invocation order).\n *\n * Heuristic: the enclosing function name must start with an uppercase\n * letter (a component) or with `use` followed by an uppercase letter (a\n * custom hook). Calls at module scope are also flagged.\n */\nexport const hookRules = createRule({\n  name: 'hook-rules',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Allow Triggery hooks (useEvent/useCondition/useAction) only inside components or other hooks.',\n    },\n    messages: {\n      outside:\n        '`{{hook}}` may only be called from a component or a custom hook (function name starting with an uppercase letter or with `use[A-Z]`).',\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      CallExpression(node) {\n        if (node.callee.type !== AST_NODE_TYPES.Identifier) return;\n        const hook = node.callee.name;\n        if (!TRIGGERY_HOOK_NAMES.has(hook)) return;\n        const fn = findEnclosingFunction(node);\n        if (!fn || !isComponentOrHookFunction(fn)) {\n          context.report({ node, messageId: 'outside', data: { hook } });\n        }\n      },\n    };\n  },\n});\n","import { AST_NODE_TYPES, ESLintUtils, type TSESTree } from '@typescript-eslint/utils';\nimport { isCreateTriggerCall } from '../utils/triggery-call.ts';\n\nconst createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`,\n);\n\n/**\n * Limits the size of a trigger's `handler` body. A 200-line handler is a\n * smell: the file no longer reads like a spec. The escape hatch is the\n * `extract-trigger` codemod (decompose into sub-triggers) or a refactor of\n * actions into smaller, more focused ones.\n *\n * The rule counts top-level statements in the handler body, not characters\n * or AST nodes — matches the way humans skim code.\n */\nexport const maxHandlerSize = createRule<[{ max?: number }], 'tooLarge'>({\n  name: 'max-handler-size',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description: 'Limit the size of a trigger handler body (default 50 statements).',\n    },\n    messages: {\n      tooLarge:\n        'Trigger handler has {{count}} top-level statements, which exceeds the limit of {{max}}. Consider splitting it (see the `extract-trigger` codemod) or moving logic into smaller actions.',\n    },\n    schema: [\n      {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          max: { type: 'integer', minimum: 1 },\n        },\n      },\n    ],\n  },\n  defaultOptions: [{ max: 50 }],\n  create(context, [options]) {\n    const max = options.max ?? 50;\n    return {\n      CallExpression(node) {\n        if (!isCreateTriggerCall(node)) return;\n        const config = node.arguments[0];\n        if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;\n        for (const prop of config.properties) {\n          if (prop.type !== AST_NODE_TYPES.Property) continue;\n          if (prop.key.type !== AST_NODE_TYPES.Identifier || prop.key.name !== 'handler') continue;\n          const handler = prop.value;\n          let body: TSESTree.BlockStatement | null = null;\n          if (\n            handler.type === AST_NODE_TYPES.FunctionExpression ||\n            handler.type === AST_NODE_TYPES.ArrowFunctionExpression\n          ) {\n            if (handler.body.type === AST_NODE_TYPES.BlockStatement) body = handler.body;\n          }\n          if (!body) return;\n          const count = body.body.length;\n          if (count > max) {\n            context.report({\n              node: handler,\n              messageId: 'tooLarge',\n              data: { count, max },\n            });\n          }\n          return;\n        }\n      },\n    };\n  },\n});\n","import { AST_NODE_TYPES, ESLintUtils, type TSESTree } from '@typescript-eslint/utils';\nimport { isCreateTriggerCall } from '../utils/triggery-call.ts';\n\nconst createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`,\n);\n\n/**\n * A trigger with 15 events × 12 conditions × 8 actions is a god-trigger.\n * The \"scenario reads like a spec\" property is lost.\n *\n * We approximate the port count from the runtime-visible config:\n *\n *   - `events`         — count of strings in the array\n *   - `required`       — count of strings in the array\n *   - + the generic schema's `actions` keys we can see (TypeScript type\n *     args aren't AST-visible without type info; we count what's in the\n *     config instead, which is a fair lower bound).\n *\n * Configurable per-port via options: { maxEvents, maxConditions, maxTotal }.\n */\nexport const maxPortsPerTrigger = createRule<\n  [{ maxEvents?: number; maxConditions?: number; maxTotal?: number }],\n  'tooManyTotal' | 'tooManyEvents' | 'tooManyConditions'\n>({\n  name: 'max-ports-per-trigger',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'Cap the number of events / required-conditions per trigger to keep scenarios spec-like.',\n    },\n    messages: {\n      tooManyTotal:\n        'Trigger has {{count}} ports declared in its config (limit: {{max}}). Consider splitting it.',\n      tooManyEvents:\n        'Trigger lists {{count}} events (limit: {{max}}). Split scenarios that fire on different events.',\n      tooManyConditions:\n        'Trigger requires {{count}} conditions (limit: {{max}}). Consider whether all are truly required, or move some to opt-in checks via `check.is()`.',\n    },\n    schema: [\n      {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          maxEvents: { type: 'integer', minimum: 1 },\n          maxConditions: { type: 'integer', minimum: 1 },\n          maxTotal: { type: 'integer', minimum: 1 },\n        },\n      },\n    ],\n  },\n  defaultOptions: [{ maxEvents: 8, maxConditions: 8, maxTotal: 12 }],\n  create(context, [options]) {\n    const maxEvents = options.maxEvents ?? 8;\n    const maxConditions = options.maxConditions ?? 8;\n    const maxTotal = options.maxTotal ?? 12;\n\n    function countStringArrayProp(config: TSESTree.ObjectExpression, propName: string): number {\n      const prop = config.properties.find(\n        (p): p is TSESTree.Property =>\n          p.type === AST_NODE_TYPES.Property &&\n          p.key.type === AST_NODE_TYPES.Identifier &&\n          p.key.name === propName,\n      );\n      if (!prop) return 0;\n      if (prop.value.type !== AST_NODE_TYPES.ArrayExpression) return 0;\n      return prop.value.elements.length;\n    }\n\n    return {\n      CallExpression(node) {\n        if (!isCreateTriggerCall(node)) return;\n        const config = node.arguments[0];\n        if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;\n        const events = countStringArrayProp(config, 'events');\n        const required = countStringArrayProp(config, 'required');\n        const total = events + required;\n\n        if (events > maxEvents) {\n          context.report({\n            node: config,\n            messageId: 'tooManyEvents',\n            data: { count: events, max: maxEvents },\n          });\n        }\n        if (required > maxConditions) {\n          context.report({\n            node: config,\n            messageId: 'tooManyConditions',\n            data: { count: required, max: maxConditions },\n          });\n        }\n        if (total > maxTotal) {\n          context.report({\n            node: config,\n            messageId: 'tooManyTotal',\n            data: { count: total, max: maxTotal },\n          });\n        }\n      },\n    };\n  },\n});\n","import { AST_NODE_TYPES, ESLintUtils } from '@typescript-eslint/utils';\nimport { getStringLiteralValue, isCreateTriggerCall } from '../utils/triggery-call.ts';\n\nconst createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`,\n);\n\n/**\n * Trigger ids are used as keys in the runtime registry, in the inspector and\n * in devtools/Redux action labels. They MUST be string literals so that:\n *\n *   - Auto-discovery (`@triggery/vite`) can produce a stable virtual module.\n *   - The inspector and devtools UI can group runs by id deterministically.\n *   - `triggery graph` / `triggery scaffold` can detect collisions.\n */\nexport const noDynamicId = createRule({\n  name: 'no-dynamic-id',\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Require createTrigger({ id }) to be a string literal.',\n    },\n    messages: {\n      dynamic:\n        '`createTrigger` id must be a string literal, not a dynamic expression. The id is used as a registry key, in devtools and in graph(), and must be deterministic.',\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      CallExpression(node) {\n        if (!isCreateTriggerCall(node)) return;\n        const config = node.arguments[0];\n        if (!config || config.type !== AST_NODE_TYPES.ObjectExpression) return;\n        for (const prop of config.properties) {\n          if (prop.type !== AST_NODE_TYPES.Property) continue;\n          if (prop.key.type !== AST_NODE_TYPES.Identifier || prop.key.name !== 'id') continue;\n          if (getStringLiteralValue(prop.value) === null) {\n            context.report({ node: prop.value, messageId: 'dynamic' });\n          }\n          return;\n        }\n      },\n    };\n  },\n});\n","import { AST_NODE_TYPES, ESLintUtils, type TSESTree } from '@typescript-eslint/utils';\n\nconst createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`,\n);\n\n/**\n * Calling `useEvent(...)` inside a `useAction(...)` handler creates an\n * implicit \"action → fireEvent\" cascade. Runtime allows cascades up to\n * `maxCascadeDepth` (default 3), but in source they should be explicit,\n * because debugging a hidden cascade across files is painful.\n *\n * If a cascade is *intentional*, the recommended pattern is to expose the\n * downstream event by passing the fire-fn down explicitly, or by composing\n * triggers via a higher-level orchestrator.\n */\nexport const noEventCascade = createRule({\n  name: 'no-event-cascade',\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Disallow calling useEvent inside a useAction handler (implicit cascade).',\n    },\n    messages: {\n      cascade:\n        'Avoid calling `{{callee}}` inside a `useAction` handler — this creates an implicit cascade. Compose triggers explicitly instead.',\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    // Stack of CallExpression nodes representing the currently-open\n    // `useAction(...)` handlers. We push when entering the handler argument\n    // and pop on exit.\n    const useActionHandlers: TSESTree.Node[] = [];\n\n    function isUseActionHandlerArgument(node: TSESTree.Node): boolean {\n      const parent = node.parent;\n      if (!parent || parent.type !== AST_NODE_TYPES.CallExpression) return false;\n      // Third positional argument is the handler.\n      if (parent.arguments[2] !== node) return false;\n      const callee = parent.callee;\n      return callee.type === AST_NODE_TYPES.Identifier && callee.name === 'useAction';\n    }\n\n    function enterFn(\n      node:\n        | TSESTree.FunctionDeclaration\n        | TSESTree.FunctionExpression\n        | TSESTree.ArrowFunctionExpression,\n    ): void {\n      if (isUseActionHandlerArgument(node)) useActionHandlers.push(node);\n    }\n\n    function exitFn(\n      node:\n        | TSESTree.FunctionDeclaration\n        | TSESTree.FunctionExpression\n        | TSESTree.ArrowFunctionExpression,\n    ): void {\n      if (useActionHandlers[useActionHandlers.length - 1] === node) useActionHandlers.pop();\n    }\n\n    return {\n      FunctionExpression: enterFn,\n      ArrowFunctionExpression: enterFn,\n      FunctionDeclaration: enterFn,\n      'FunctionExpression:exit': exitFn,\n      'ArrowFunctionExpression:exit': exitFn,\n      'FunctionDeclaration:exit': exitFn,\n      CallExpression(node) {\n        if (useActionHandlers.length === 0) return;\n        if (node.callee.type !== AST_NODE_TYPES.Identifier) return;\n        if (node.callee.name !== 'useEvent') return;\n        context.report({\n          node,\n          messageId: 'cascade',\n          data: { callee: node.callee.name },\n        });\n      },\n    };\n  },\n});\n","import { AST_NODE_TYPES, ESLintUtils, type TSESTree } from '@typescript-eslint/utils';\nimport { getStringLiteralValue, toPascalCase } from '../utils/triggery-call.ts';\n\nconst createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/triggeryjs/triggery/blob/main/packages/eslint-plugin/docs/rules/${name}.md`,\n);\n\n/**\n * In files with many `useEvent/useCondition/useAction` calls, the named\n * variants (`useNewMessageEvent`, `useUserCondition`, …) read much better.\n * The runtime exposes them via `messageTrigger.namedHooks()`; this rule\n * suggests the switch once a file has enough port calls to benefit.\n */\nexport const preferNamedHook = createRule<[{ threshold?: number }], 'prefer'>({\n  name: 'prefer-named-hook',\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description:\n        'In files with many port calls, prefer named hooks (useFooEvent) over generic useEvent(\"foo\").',\n    },\n    messages: {\n      prefer:\n        'Consider using `{{suggestion}}` instead of `{{generic}}` once a file has many ({{count}} ≥ {{threshold}}) port calls.',\n    },\n    schema: [\n      {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          threshold: { type: 'integer', minimum: 1 },\n        },\n      },\n    ],\n  },\n  defaultOptions: [{ threshold: 4 }],\n  create(context, [options]) {\n    const threshold = options.threshold ?? 4;\n    const portCalls: Array<{ node: TSESTree.CallExpression; kind: string; name: string }> = [];\n\n    function suffixFor(kind: string): string {\n      switch (kind) {\n        case 'useEvent':\n          return 'Event';\n        case 'useCondition':\n          return 'Condition';\n        case 'useAction':\n          return 'Action';\n        default:\n          return '';\n      }\n    }\n\n    return {\n      CallExpression(node) {\n        if (node.callee.type !== AST_NODE_TYPES.Identifier) return;\n        const name = node.callee.name;\n        if (!['useEvent', 'useCondition', 'useAction'].includes(name)) return;\n        const portArg = node.arguments[1];\n        const portName = getStringLiteralValue(portArg);\n        if (!portName) return;\n        portCalls.push({ node, kind: name, name: portName });\n      },\n      'Program:exit'() {\n        if (portCalls.length < threshold) return;\n        for (const call of portCalls) {\n          const suggestion = `use${toPascalCase(call.name)}${suffixFor(call.kind)}`;\n          context.report({\n            node: call.node,\n            messageId: 'prefer',\n            data: {\n              suggestion,\n              generic: `${call.kind}(…, '${call.name}', …)`,\n              count: portCalls.length,\n              threshold,\n            },\n          });\n        }\n      },\n    };\n  },\n});\n","import type { ESLint, Linter } from 'eslint';\nimport { exhaustiveConditions } from './rules/exhaustive-conditions.ts';\nimport { exhaustiveRequired } from './rules/exhaustive-required.ts';\nimport { hookRules } from './rules/hook-rules.ts';\nimport { maxHandlerSize } from './rules/max-handler-size.ts';\nimport { maxPortsPerTrigger } from './rules/max-ports-per-trigger.ts';\nimport { noDynamicId } from './rules/no-dynamic-id.ts';\nimport { noEventCascade } from './rules/no-event-cascade.ts';\nimport { preferNamedHook } from './rules/prefer-named-hook.ts';\n\nconst rules = {\n  'exhaustive-conditions': exhaustiveConditions,\n  'exhaustive-required': exhaustiveRequired,\n  'hook-rules': hookRules,\n  'max-handler-size': maxHandlerSize,\n  'max-ports-per-trigger': maxPortsPerTrigger,\n  'no-dynamic-id': noDynamicId,\n  'no-event-cascade': noEventCascade,\n  'prefer-named-hook': preferNamedHook,\n};\n\nconst meta = {\n  name: '@triggery/eslint-plugin',\n  version: '0.0.0',\n};\n\n/**\n * Drop-in flat config presets. Adopters either spread our preset or pick the\n * individual rule keys they want — both work with ESLint 9.x flat config.\n *\n * @example\n * ```js\n * import triggery from '@triggery/eslint-plugin';\n *\n * export default [\n *   triggery.configs.recommended,\n *   triggery.configs.strict, // optionally on top\n * ];\n * ```\n */\nconst plugin: ESLint.Plugin = {\n  meta,\n  rules: rules as unknown as ESLint.Plugin['rules'],\n};\n\nconst recommended: Linter.Config = {\n  plugins: { '@triggery': plugin },\n  rules: {\n    '@triggery/no-dynamic-id': 'error',\n    '@triggery/no-event-cascade': 'error',\n    '@triggery/hook-rules': 'error',\n    '@triggery/exhaustive-conditions': 'warn',\n    '@triggery/exhaustive-required': 'warn',\n    '@triggery/max-handler-size': 'warn',\n    '@triggery/max-ports-per-trigger': 'warn',\n  },\n};\n\nconst strict: Linter.Config = {\n  plugins: { '@triggery': plugin },\n  rules: {\n    '@triggery/no-dynamic-id': 'error',\n    '@triggery/no-event-cascade': 'error',\n    '@triggery/hook-rules': 'error',\n    '@triggery/exhaustive-conditions': 'error',\n    '@triggery/exhaustive-required': 'error',\n    '@triggery/max-handler-size': ['error', { max: 30 }],\n    '@triggery/max-ports-per-trigger': ['error', { maxEvents: 5, maxConditions: 5, maxTotal: 8 }],\n    '@triggery/prefer-named-hook': ['warn', { threshold: 3 }],\n  },\n};\n\nconst finalPlugin: ESLint.Plugin = {\n  ...plugin,\n  configs: {\n    recommended,\n    strict,\n  },\n};\n\nexport default finalPlugin;\nexport { recommended, rules, strict };\n"]}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@triggery/eslint-plugin",
+  "version": "0.1.0",
+  "description": "ESLint plugin for Triggery — catches mis-use of createTrigger / useEvent / useCondition / useAction, suggests named hooks, enforces handler size budgets.",
+  "license": "MIT",
+  "author": "Aleksey Skhomenko",
+  "homepage": "https://triggeryjs.github.io/triggery",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/triggeryjs/triggery.git",
+    "directory": "packages/eslint-plugin"
+  },
+  "bugs": "https://github.com/triggeryjs/triggery/issues",
+  "funding": [
+    {
+      "type": "patreon",
+      "url": "https://www.patreon.com/triggery"
+    },
+    {
+      "type": "boosty",
+      "url": "https://boosty.to/triggery"
+    }
+  ],
+  "keywords": [
+    "triggery",
+    "eslint",
+    "eslint-plugin",
+    "lint",
+    "rules",
+    "flat-config",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0",
+    "typescript": ">=5.0.0"
+  },
+  "dependencies": {
+    "@typescript-eslint/utils": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/estree": "^1.0.6",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@typescript-eslint/rule-tester": "^8.0.0",
+    "eslint": "^9.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}