refactor(linter/plugins): rename `oxlint/plugin` to `oxlint/plugins` by overlookmotel · Pull Request #18792 · oxc-project/oxc

overlookmotel · 2026-01-31T23:50:14Z

Part of #18610.

Our intent is to move definePlugin, defineRule, and eslintCompatPlugin to a separate package @oxlint/plugins (plural to avoid confusion with naming convention for plugins oxlint-plugin-xxx).

So rename the current entry point which exports these functions from oxlint/plugin to oxlint/plugins (plural).

overlookmotel · 2026-01-31T23:50:30Z

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.

Copilot

Pull request overview

Renames the linter plugin helper entrypoint from oxlint/plugin to oxlint/plugins as a step toward extracting plugin-author APIs into a dedicated @oxlint/plugins package.

Changes:

Rename package export/import subpath from plugin → plugins (including build entrypoints).
Update internal tests, conformance harness, and fixtures to import from #oxlint/plugins.
Adjust apps/oxlint/src-js/plugins.ts type re-export path for ESTree types.

Reviewed changes

Copilot reviewed 73 out of 73 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
npm/oxlint/package.json	Renames published subpath export `./plugin` → `./plugins`.
apps/oxlint/tsdown.config.ts	Updates build entry list to emit `plugins` entry instead of `plugin`.
apps/oxlint/test/rule_tester.test.ts	Updates type import to reference `plugins.ts`.
apps/oxlint/test/fixtures/utf16_offsets/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/unicode_comments/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/tokens/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/sourceCode_token_methods/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/sourceCode_scope_methods/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/sourceCode_late_access/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/sourceCode/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/settings/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/selector/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/scope_manager/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/plugin_outside_cwd/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/plugin_name_reserved/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/plugin_name_missing/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/plugin_name_alias_reserved/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/plugin_name_alias_invalid/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/plugin_name/plugins/no_name.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/plugin_name/plugins/jsdoc.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/parser_services/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/parent/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/overrides_missing_rule/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/overrides/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/options_invalid/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/options/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/nested_config_duplicate/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/nested_config/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/missing_rule/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/message_interpolation/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/message_id_plugin/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/message_id_interpolation/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/message_id_error/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/load_paths/plugins/plugin6.mts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/load_paths/plugins/plugin5.cts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/load_paths/plugins/plugin4.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/lint_visit_error/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/lint_visit_cfg_error/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/lint_fix_error/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/lint_create_error/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/lint_createOnce_error/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/lint_before_hook_error/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/lint_after_hook_error/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/languageOptions/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/isSpaceBetween/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/globals/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/getNodeByRangeIndex/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/fixes/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/fixable_boolean/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/estree/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/eslintCompat/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/disable_directives/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/diagnostic_loc/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/defineRule/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/definePlugin/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/createOnce/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/context_wrapping/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/context_properties/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/comments/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/cfg/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/bom/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/basic_warn_severity/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/basic_no_errors/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/basic_multiple_rules/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/basic_many_files/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/test/fixtures/basic/plugin.ts	Updates fixture imports to `#oxlint/plugins`.
apps/oxlint/src-js/plugins.ts	Defines the new `plugins` entrypoint and re-exports plugin-author API/types.
apps/oxlint/src-js/index.ts	Updates deprecation guidance to point to `oxlint/plugins`.
apps/oxlint/package.json	Renames internal `imports`/`exports` from `plugin` → `plugins`.
apps/oxlint/conformance/tester.ts	Updates conformance harness import types to `#oxlint/plugins`.
apps/oxlint/conformance/src/rule_tester.ts	Updates conformance RuleTester import types to `#oxlint/plugins`.
apps/oxlint/conformance/src/groups/stylistic.ts	Updates conformance group import types to `#oxlint/plugins`.
apps/oxlint/conformance/src/groups/sonarjs.ts	Updates conformance group import types to `#oxlint/plugins`.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

npm/oxlint/package.json

apps/oxlint/package.json

camc314 · 2026-02-01T12:37:53Z

Merge activity

Feb 1, 12:37 PM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
Feb 1, 12:38 PM UTC: camc314 added this pull request to the Graphite merge queue.
Feb 1, 12:46 PM UTC: The Graphite merge queue couldn't merge this PR because it had merge conflicts.
Feb 1, 1:16 PM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
Feb 1, 1:24 PM UTC: camc314 added this pull request to the Graphite merge queue.
Feb 1, 1:29 PM UTC: Merged by the Graphite merge queue.

…18792) Part of #18610. Our intent is to move `definePlugin`, `defineRule`, and `eslintCompatPlugin` to a separate package `@oxlint/plugins` (plural to avoid confusion with naming convention for plugins `oxlint-plugin-xxx`). So rename the current entry point which exports these functions from `oxlint/plugin` to `oxlint/plugins` (plural).

github-actions bot added A-linter Area - Linter A-cli Area - CLI A-linter-plugins Area - Linter JS plugins C-cleanup Category - technical debt or refactoring. Solution not expected to change behavior labels Jan 31, 2026

This was referenced Jan 31, 2026

feat(linter/plugins): move eslint compatible plugin conversion to eslintCompatPlugin function #18791

Merged

refactor(linter/plugins): rename oxlint/rule-tester to oxlint/plugins-dev #18793

Merged

overlookmotel marked this pull request as ready for review January 31, 2026 23:54

Copilot AI review requested due to automatic review settings January 31, 2026 23:54

overlookmotel requested a review from camc314 as a code owner January 31, 2026 23:54

Copilot started reviewing on behalf of overlookmotel January 31, 2026 23:54 View session

Copilot AI reviewed Jan 31, 2026

View reviewed changes

npm/oxlint/package.json Show resolved Hide resolved

apps/oxlint/package.json Show resolved Hide resolved

overlookmotel assigned camc314 Feb 1, 2026

overlookmotel mentioned this pull request Feb 1, 2026

feat(linter/plugins): create @oxlint/plugins and @oxlint/plugins-dev NPM packages #18796

Closed

camc314 approved these changes Feb 1, 2026

View reviewed changes

camc314 added the 0-merge Merge with Graphite Merge Queue label Feb 1, 2026

graphite-app bot changed the base branch from om/02-01-feat_linter_plugins_move_eslint_compatible_plugin_conversion_to_eslintcompatplugin_function to graphite-base/18792 February 1, 2026 12:37

graphite-app bot changed the base branch from graphite-base/18792 to main February 1, 2026 12:45

graphite-app bot removed the 0-merge Merge with Graphite Merge Queue label Feb 1, 2026

camc314 force-pushed the om/02-01-refactor_linter_plugins_rename_oxlint_plugin_to_oxlint_plugins_ branch from 95414cb to 0c382c4 Compare February 1, 2026 13:16

camc314 added the 0-merge Merge with Graphite Merge Queue label Feb 1, 2026

graphite-app bot force-pushed the om/02-01-refactor_linter_plugins_rename_oxlint_plugin_to_oxlint_plugins_ branch from 0c382c4 to 9de9385 Compare February 1, 2026 13:23

graphite-app bot merged commit 9de9385 into main Feb 1, 2026
20 checks passed

graphite-app bot deleted the om/02-01-refactor_linter_plugins_rename_oxlint_plugin_to_oxlint_plugins_ branch February 1, 2026 13:29

graphite-app bot removed the 0-merge Merge with Graphite Merge Queue label Feb 1, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

refactor(linter/plugins): rename `oxlint/plugin` to `oxlint/plugins`#18792

refactor(linter/plugins): rename `oxlint/plugin` to `oxlint/plugins`#18792
graphite-app[bot] merged 1 commit intomainfrom
om/02-01-refactor_linter_plugins_rename_oxlint_plugin_to_oxlint_plugins_

overlookmotel commented Jan 31, 2026 •

edited

Loading

Uh oh!

overlookmotel commented Jan 31, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

camc314 commented Feb 1, 2026 •

edited by graphite-app bot

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Comments

Uh oh!

Conversation

overlookmotel commented Jan 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

overlookmotel commented Jan 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

How to use the Graphite Merge Queue

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

camc314 commented Feb 1, 2026 • edited by graphite-app bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merge activity

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Comments

overlookmotel commented Jan 31, 2026 •

edited

Loading

overlookmotel commented Jan 31, 2026 •

edited

Loading

camc314 commented Feb 1, 2026 •

edited by graphite-app bot

Loading