feat(linter/plugins): add defineRule API

[overlookmotel]

Add defineRule method for defining rules. This is the 2nd part of the "alternative API" mentioned in #9905 (comment).

import { defineRule } from 'oxlint';

export default defineRule({
  meta: { /* ... */ },
  create(context) {
    // Rule implementation
  }
});

or, using the alternative createOnce API:

export default defineRule({
  meta: { /* ... */ },
  createOnce(context) {
    // Rule implementation
  }
});

When using createOnce, defineRule creates a create method and adds it to the rule object. So the rule remains ESLint-compatible, while getting a potential speed boost when the rule is used with Oxlint. This PR includes a test that runs an Oxlint plugin that uses defineRule + createOnce in ESLint.

Not done yet: We need to export TS type defs, so the type checking benefit of defineRule is realized. I'll do that in a later PR.

---

defineRule is intended to be used when defining JS plugins, so we should move it into a separate NPM package (oxlint-tools?), so that someone publishing a plugin to NPM doesn't need their plugin to have a dependency on oxlint itself, which includes large binaries.

But for now, for simplicity, just include it in oxlint package.

[overlookmotel]

• feat(linter/plugins): add definePlugin API #14008
• feat(linter/plugins): add defineRule API #13945 👈 (View in Graphite)
• fix(linter/plugins): pin tsdown dependency to 0.15.1 #14005
• 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.

[codspeed-hq]

CodSpeed Instrumentation Performance Report

Merging #13945 will not alter performance

_{Comparing 09-20-feat_linter_plugins_add_definerule_api (96ef735) with main (2e9ae3f)¹}

Summary

✅ 37 untouched

Footnotes

1. No successful run was found on 09-22-fix_linter_plugins_pin_tsdown_dependency_to_0.15.1 (5d678f1) during the generation of this report, so main (2e9ae3f) was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

[graphite-app]

Merge activity

• Sep 22, 8:22 PM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Sep 22, 8:28 PM UTC: Merged by the Graphite merge queue.