feat(linter/plugins): add createOnce API

[overlookmotel]

Add createOnce method for rules. This is the "alternative API" mentioned in #9905 (comment).

export default {
  meta: { /* ... */ },
  // `createOnce`, not `create`. Called only once, NOT once per file.
  createOnce(context) {
    let classCount;
    return {
      before() {
        classCount = 0;
      },
      ClassDeclaration(klass) {
        classCount++;
      },
      after() {
        if (classCount > 5) {
          context.report({
            message: 'files should not contain more than 5 class declarations, '
              + `found ${classCount}`,
            node: { start: 0, end: 0 },
          });
        }
      },
    };
  }
};

If before method returns false, the rule is skipped for the current file. This is equivalent to the following pattern in ESLint:

export default {
  meta: { /* ... */ },
  create(context) {
    if (shouldSkip(context)) return {}; // Skip
    return { /* visitor */ };
  }
};

Currently we don't capitalize on the potential perf benefits of this alternative API, but plugin authors can use it now, and once we do implement the perf optimizations this API enables, they'll get a speed boost just by upgrading Oxlint, without needing to change their plugin code.

[overlookmotel]

• feat(linter/plugins): add defineRule API #13945
• feat(linter/plugins): add createOnce API #13944 👈 (View in Graphite)
• feat(linter/plugins): ESTree-compatible AST for JS plugins #13942
• feat(napi/parser): add deserializeProgramOnly deserializer function #13940
• feat(napi/parser): add AST walker #13930
• feat(napi/parser): export visitor keys #13927
• fix(napi/parser): raw transfer preserveParens option apply to TSParenthesizedType #13964
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[camc314]

@overlookmotel i haven't added the merge tag on these two because there are prs lower in the stack that're assigned to you.

but both of these look ok to me to merge

[overlookmotel]

Merge activity

• Sep 22, 11:08 AM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Sep 22, 11:28 AM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Sep 22, 11:29 AM UTC: The Graphite merge queue couldn't merge this PR because it was not satisfying all requirements (Failed CI: 'Test NAPI').
• Sep 22, 11:32 AM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Sep 22, 11:36 AM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Sep 22, 11:36 AM UTC: Merged by the Graphite merge queue.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.