@heyq02/rslint-config 0.0.2 → 0.0.3-beta.1

package/README.md

@@ -1,8 +1,12 @@
 # @heyq02/rslint-config
 
-[![npm version][npm-version-src]][npm-version-href]
-[![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![Unit Test][unit-test-src]][unit-test-href]
+<!-- automd:badges license -->
+
+[![npm version](https://img.shields.io/npm/v/@heyq02/rslint-config)](https://npmjs.com/package/@heyq02/rslint-config)
+[![npm downloads](https://img.shields.io/npm/dm/@heyq02/rslint-config)](https://npm.chart.dev/@heyq02/rslint-config)
+[![license](https://img.shields.io/github/license/heyq02/rslint-config)](https://github.com/heyq02/rslint-config/blob/main/LICENSE)
+
+<!-- /automd -->
 
 Opinionated [Rslint](https://rslint.rs/) flat-config preset, structured like [`@sxzz/eslint-config`](https://github.com/sxzz/eslint-config) and built on `@rslint/core` native presets.
 
@@ -11,6 +15,8 @@ Opinionated [Rslint](https://rslint.rs/) flat-config preset, structured like [`@
 - One-line config via `heyq02()`
 - JavaScript + TypeScript presets (`recommended` / `strict` / type-checked / stylistic)
 - Built-in Unicorn, import, Node, and Promise rules
+- Import sorting via `import/order` with an [Oxfmt `sortImports`](https://oxc.rs/docs/guide/usage/formatter/sorting.html)-shaped API
+- Community plugins (Rslint-compatible): unused-imports, regexp, de-morgan, eslint-comments
 - Optional React, React Hooks, JSX a11y, Jest, and Rstest (auto-detected)
 - Ignores common build artifacts (`dist`, `coverage`, lockfiles, …)
 - Special-case overrides for CLIs, tests, config files, and components
@@ -52,28 +58,72 @@ export default heyq02(
 
 ### Options
 
-| Option       | Default             | Description                                                             |
-| ------------ | ------------------- | ----------------------------------------------------------------------- |
-| `typescript` | auto (`typescript`) | `true` / `false` / `{ typeChecked, strict, stylistic, projectService }` |
-| `javascript` | `true`              | JavaScript recommended + opinionated rules                              |
-| `unicorn`    | `true`              | Unicorn recommended + overrides                                         |
-| `imports`    | `true`              | Import recommended + no-default-export, etc.                            |
-| `node`       | `true` (`module`)   | `true` / `'module'` / `'script'` / `'mixed'`                            |
-| `promise`    | `true`              | Promise recommended (relaxed for async/await)                           |
-| `react`      | auto (`react`)      | React + React Hooks (+ jsx-a11y)                                        |
-| `jsxA11y`    | with react          | JSX accessibility rules                                                 |
-| `jest`       | auto (`jest`)       | Jest recommended + style                                                |
-| `rstest`     | auto (`rstest`)     | Rstest recommended                                                      |
-| `ignores`    | `[]`                | Extra global ignore patterns                                            |
+| Option           | Default             | Description                                                                                   |
+| ---------------- | ------------------- | --------------------------------------------------------------------------------------------- |
+| `typescript`     | auto (`typescript`) | `true` / `false` / `{ typeChecked, strict, stylistic, projectService }`                       |
+| `javascript`     | `true`              | JavaScript recommended + opinionated rules                                                    |
+| `unicorn`        | `true`              | Unicorn recommended + overrides                                                               |
+| `imports`        | `true`              | Import recommended + no-default-export, etc.                                                  |
+| `sortImports`    | `true`              | `true` / `false` / Oxfmt-like `{ groups, newlinesBetween, customGroups, … }` → `import/order` |
+| `node`           | `true` (`module`)   | `true` / `'module'` / `'script'` / `'mixed'`                                                  |
+| `promise`        | `true`              | Promise recommended (relaxed for async/await)                                                 |
+| `react`          | auto (`react`)      | React + React Hooks (+ jsx-a11y)                                                              |
+| `jsxA11y`        | with react          | JSX accessibility rules                                                                       |
+| `jest`           | auto (`jest`)       | Jest recommended + style                                                                      |
+| `rstest`         | auto (`rstest`)     | Rstest recommended                                                                            |
+| `unusedImports`  | `true`              | `eslint-plugin-unused-imports` (autofix unused imports)                                       |
+| `regexp`         | `true`              | `eslint-plugin-regexp`                                                                        |
+| `deMorgan`       | `true`              | `eslint-plugin-de-morgan`                                                                     |
+| `eslintComments` | `true`              | `@eslint-community/eslint-plugin-eslint-comments`                                             |
+| `ignores`        | `[]`                | Extra global ignore patterns                                                                  |
+
+### Sort imports
+
+Enabled by default (when `imports` is on). Options mirror Oxfmt [`sortImports`](https://oxc.rs/docs/guide/usage/formatter/sorting.html) where Rslint can enforce them via [`import/order`](https://rslint.rs/rules/import/order):
+
+```ts
+export default heyq02({
+  sortImports: {
+    groups: [
+      'type',
+      ['builtin', 'external'],
+      'internal',
+      ['parent', 'sibling', 'index'],
+      'unknown',
+    ],
+    newlinesBetween: true,
+    internalPattern: ['~/', '@/', '#'],
+    customGroups: [
+      {
+        groupName: 'react-libs',
+        elementNamePattern: ['react', 'react-**'],
+        group: 'external',
+        position: 'before',
+      },
+    ],
+    order: 'asc',
+    ignoreCase: true,
+    named: true,
+  },
+});
+```
+
+| Oxfmt option                                | This package      | Notes                                                                                               |
+| ------------------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------- |
+| `groups`                                    | `groups`          | Uses `import/order` names (`builtin`, `type`, …), not perfectionist selectors (`value-builtin`)     |
+| `newlinesBetween`                           | `newlinesBetween` | `boolean` → `always` / `never`; per-group `{ newlinesBetween }` markers unsupported                 |
+| `customGroups`                              | `customGroups`    | Mapped to `pathGroups` (`group` + `position` required conceptually; defaults `external` / `before`) |
+| `internalPattern`                           | `internalPattern` | Glob-like prefixes → `import/internal-regex`                                                        |
+| `order` / `ignoreCase`                      | same              | → `alphabetize`                                                                                     |
+| `sortSideEffects`                           | `sortSideEffects` | → `warnOnUnassignedImports`                                                                         |
+| `partitionByComment` / `partitionByNewline` | —                 | Not supported by `import/order`                                                                     |
+
+If Oxfmt already sorts imports, set `sortImports: false` to avoid fighting the formatter.
 
 ### Presets
 
 ```ts
-import {
-  presetJavaScript,
-  presetBasic,
-  presetAll,
-} from '@heyq02/rslint-config';
+import { presetJavaScript, presetBasic, presetAll } from '@heyq02/rslint-config';
 
 export default presetBasic();
 ```
@@ -85,18 +135,28 @@ pnpm install
 pnpm run build
 pnpm run lint
 pnpm run typecheck
-pnpm release   # bumpp → tag v* → GitHub Release + npm publish
+pnpm run format   # automd + vp fmt (Oxfmt via Vite+)
+pnpm run check    # format:check + rslint + tsc
+pnpm release      # bumpp → tag v* → GitHub Release + npm publish
 ```
 
 ## License
 
-[MIT](./LICENSE) © Ari
+<!-- automd:contributors license=MIT author="heyq02" -->
+
+Published under the [MIT](https://github.com/heyq02/rslint-config/blob/main/LICENSE) license.
+Made by [@heyq02](https://github.com/heyq02) and [community](https://github.com/heyq02/rslint-config/graphs/contributors) 💛
+<br><br>
+<a href="https://github.com/heyq02/rslint-config/graphs/contributors">
+<img src="https://contrib.rocks/image?repo=heyq02/rslint-config" />
+</a>
+
+<!-- /automd -->
+
+<!-- automd:with-automd -->
+
+---
 
-<!-- Badges -->
+_🤖 auto updated with [automd](https://automd.unjs.io)_
 
-[npm-version-src]: https://img.shields.io/npm/v/@heyq02/rslint-config.svg
-[npm-version-href]: https://npmjs.com/package/@heyq02/rslint-config
-[npm-downloads-src]: https://img.shields.io/npm/dm/@heyq02/rslint-config
-[npm-downloads-href]: https://www.npmcharts.com/compare/@heyq02/rslint-config?interval=30
-[unit-test-src]: https://github.com/heyq02/rslint-config/actions/workflows/unit-test.yml/badge.svg
-[unit-test-href]: https://github.com/heyq02/rslint-config/actions/workflows/unit-test.yml
+<!-- /automd -->

package/dist/configs/de-morgan.d.ts

@@ -0,0 +1,5 @@
+import type { TypedFlatConfig } from '../types.js';
+/**
+ * De Morgan rewrites via `eslint-plugin-de-morgan` (Rslint community plugin).
+ */
+export declare const deMorgan: () => TypedFlatConfig[];

package/dist/configs/eslint-comments.d.ts

@@ -0,0 +1,5 @@
+import type { TypedFlatConfig } from '../types.js';
+/**
+ * `eslint-disable` hygiene via `@eslint-community/eslint-plugin-eslint-comments`.
+ */
+export declare const eslintComments: () => TypedFlatConfig[];

package/dist/configs/imports.d.ts

@@ -1,4 +1,10 @@
-import type { TypedFlatConfig } from '../types.js';
-export declare const imports: (options?: {
+import type { SortImportsOptions, TypedFlatConfig } from '../types.js';
+export interface ImportsOptions {
     typescript?: boolean;
-}) => TypedFlatConfig[];
+    /**
+     * Enable Oxfmt-shaped import sorting via `import/order`.
+     * @default true
+     */
+    sortImports?: boolean | SortImportsOptions;
+}
+export declare const imports: (options?: ImportsOptions) => TypedFlatConfig[];

package/dist/configs/index.d.ts

@@ -1,3 +1,5 @@
+export * from './de-morgan.js';
+export * from './eslint-comments.js';
 export * from './ignores.js';
 export * from './imports.js';
 export * from './javascript.js';
@@ -5,7 +7,10 @@ export * from './jest.js';
 export * from './node.js';
 export * from './promise.js';
 export * from './react.js';
+export * from './regexp.js';
 export * from './rstest.js';
+export * from './sort-imports.js';
 export * from './special-cases.js';
 export * from './typescript.js';
 export * from './unicorn.js';
+export * from './unused-imports.js';

package/dist/configs/regexp.d.ts

@@ -0,0 +1,5 @@
+import type { TypedFlatConfig } from '../types.js';
+/**
+ * RegExp quality rules via `eslint-plugin-regexp` (Rslint community plugin).
+ */
+export declare const regexp: () => TypedFlatConfig[];

package/dist/configs/sort-imports.d.ts

@@ -0,0 +1,42 @@
+import type { ImportOrderOptions } from '@rslint/core';
+import type { SortImportsCustomGroup, SortImportsOptions } from '../types.js';
+/** eslint-plugin-import / Rslint `import/order` group names. */
+export type ImportOrderGroup = 'builtin' | 'external' | 'internal' | 'unknown' | 'parent' | 'sibling' | 'index' | 'object' | 'type';
+type ImportOrderConfig = NonNullable<ImportOrderOptions[0]>;
+/**
+ * Default group order inspired by Oxfmt / perfectionist `sort-imports`
+ * (type-first, then builtin+external, internal, relative, unknown).
+ *
+ * Mapped onto `import/order` groups — modifier-selectors like
+ * `value-builtin` / `type-internal` are not expressible 1:1, so types are
+ * collected via the dedicated `type` group.
+ *
+ * @see https://oxc.rs/docs/guide/usage/formatter/sorting.html
+ */
+export declare const DEFAULT_SORT_IMPORT_GROUPS: (ImportOrderGroup | ImportOrderGroup[])[];
+/** Oxfmt default prefixes for internal modules. */
+export declare const DEFAULT_INTERNAL_PATTERN: string[];
+/**
+ * Convert Oxfmt-style glob prefixes (`~/`, `@/`, `#`) into a single
+ * `import/internal-regex` source string.
+ */
+export declare function internalPatternToRegex(patterns: string[]): string;
+/**
+ * Map Oxfmt-like `customGroups` onto `import/order` `pathGroups`.
+ *
+ * Custom group names are not first-class in `import/order`; each entry must
+ * attach to a real group via `group` / `position` (defaults: `external` /
+ * `before`), matching the common “react before other externals” pattern.
+ */
+export declare function customGroupsToPathGroups(customGroups: SortImportsCustomGroup[]): Exclude<ImportOrderConfig['pathGroups'], undefined>;
+/**
+ * Translate Oxfmt-shaped `sortImports` options into `import/order` options +
+ * settings. Options that cannot be honored (per-group `newlinesBetween`
+ * markers, `partitionByComment`, perfectionist modifier-selectors, etc.) are
+ * intentionally omitted — see README.
+ */
+export declare function resolveSortImports(options?: true | SortImportsOptions): {
+    rule: ImportOrderConfig;
+    settings: Record<string, unknown>;
+};
+export {};

package/dist/configs/unused-imports.d.ts

@@ -0,0 +1,5 @@
+import type { TypedFlatConfig } from '../types.js';
+/**
+ * Autofix unused imports via `eslint-plugin-unused-imports` (Rslint community plugin).
+ */
+export declare const unusedImports: () => TypedFlatConfig[];

package/dist/index.js

@@ -1,5 +1,9 @@
+import eslint_plugin_de_morgan from "eslint-plugin-de-morgan";
+import eslint_plugin_eslint_comments from "@eslint-community/eslint-plugin-eslint-comments";
 import { globalIgnores, globals, importPlugin, jestPlugin, js, jsxA11yPlugin, nodePlugin, promisePlugin, reactHooksPlugin, reactPlugin, rstestPlugin, ts, unicornPlugin } from "@rslint/core";
-import { createRequire } from "node:module";
+import eslint_plugin_regexp from "eslint-plugin-regexp";
+import eslint_plugin_unused_imports from "eslint-plugin-unused-imports";
+import { isPackageExists } from "local-pkg";
 import node_process from "node:process";
 const GLOB_SRC_EXT = '?([cm])[jt]s?(x)';
 const GLOB_SRC = `**/*.${GLOB_SRC_EXT}`;
@@ -49,6 +53,47 @@ const GLOB_EXCLUDE = [
     '**/auto-import?(s).d.ts',
     '**/components.d.ts'
 ];
+function asESLintPlugin(plugin) {
+    return plugin;
+}
+const deMorgan = ()=>[
+        {
+            files: [
+                GLOB_SRC
+            ],
+            name: 'heyq02/de-morgan',
+            plugins: {
+                'de-morgan': asESLintPlugin(eslint_plugin_de_morgan)
+            },
+            rules: {
+                'de-morgan/no-negated-conjunction': 'error',
+                'de-morgan/no-negated-disjunction': 'error'
+            }
+        }
+    ];
+const eslintComments = ()=>[
+        {
+            files: [
+                GLOB_SRC
+            ],
+            name: 'heyq02/eslint-comments',
+            plugins: {
+                '@eslint-community/eslint-comments': asESLintPlugin(eslint_plugin_eslint_comments)
+            },
+            rules: {
+                '@eslint-community/eslint-comments/disable-enable-pair': [
+                    'error',
+                    {
+                        allowWholeFile: true
+                    }
+                ],
+                '@eslint-community/eslint-comments/no-aggregating-enable': 'error',
+                '@eslint-community/eslint-comments/no-duplicate-disable': 'error',
+                '@eslint-community/eslint-comments/no-unlimited-disable': 'error',
+                '@eslint-community/eslint-comments/no-unused-enable': 'error'
+            }
+        }
+    ];
 const ignores = (extra = [])=>[
         {
             ...globalIgnores([
@@ -58,7 +103,96 @@ const ignores = (extra = [])=>[
             name: 'heyq02/global-ignores'
         }
     ];
-const imports = (options = {})=>[
+const DEFAULT_SORT_IMPORT_GROUPS = [
+    'type',
+    [
+        'builtin',
+        'external'
+    ],
+    'internal',
+    [
+        'parent',
+        'sibling',
+        'index'
+    ],
+    'unknown'
+];
+const DEFAULT_INTERNAL_PATTERN = [
+    '~/',
+    '@/',
+    '#'
+];
+const PREDEFINED_GROUPS = new Set([
+    'builtin',
+    'external',
+    'internal',
+    'unknown',
+    'parent',
+    'sibling',
+    'index',
+    'object',
+    'type'
+]);
+function internalPatternToRegex(patterns) {
+    const escaped = patterns.map((pattern)=>pattern.replaceAll(/[.*+?^${}()|[\]\\]/g, '\\$&')).filter(Boolean);
+    if (0 === escaped.length) return '';
+    return `^(?:${escaped.join('|')})`;
+}
+function toPatterns(value) {
+    return Array.isArray(value) ? value : [
+        value
+    ];
+}
+function customGroupsToPathGroups(customGroups) {
+    return customGroups.flatMap((entry)=>{
+        const group = entry.group ?? 'external';
+        const position = entry.position ?? 'before';
+        return toPatterns(entry.elementNamePattern).map((pattern)=>({
+                pattern,
+                group,
+                position
+            }));
+    });
+}
+function resolveSortImports(options = true) {
+    const opts = true === options ? {} : options;
+    const { groups = DEFAULT_SORT_IMPORT_GROUPS, newlinesBetween = true, customGroups = [], internalPattern = DEFAULT_INTERNAL_PATTERN, order = 'asc', ignoreCase = true, named = true, sortSideEffects = false } = opts;
+    const pathGroups = customGroupsToPathGroups(customGroups);
+    const normalizedGroups = groups.map((item)=>{
+        if (Array.isArray(item)) {
+            const filtered = item.filter((g)=>PREDEFINED_GROUPS.has(g));
+            return filtered.length > 0 ? filtered : null;
+        }
+        return PREDEFINED_GROUPS.has(item) ? item : null;
+    }).filter((item)=>Boolean(item));
+    const rule = {
+        groups: normalizedGroups.length > 0 ? normalizedGroups : DEFAULT_SORT_IMPORT_GROUPS,
+        'newlines-between': newlinesBetween ? 'always' : 'never',
+        alphabetize: {
+            order,
+            caseInsensitive: ignoreCase
+        },
+        named,
+        warnOnUnassignedImports: sortSideEffects,
+        ...pathGroups.length > 0 ? {
+            pathGroups,
+            pathGroupsExcludedImportTypes: [
+                'builtin',
+                'object'
+            ]
+        } : {}
+    };
+    const settings = {};
+    const internalRegex = internalPatternToRegex(internalPattern);
+    if (internalRegex) settings['import/internal-regex'] = internalRegex;
+    return {
+        rule,
+        settings
+    };
+}
+const imports = (options = {})=>{
+    const { typescript = false, sortImports: sortImportsOption = true } = options;
+    const configs = [
         {
             ...importPlugin.configs.recommended,
             files: [
@@ -82,7 +216,7 @@ const imports = (options = {})=>[
                 ],
                 'import/no-mutable-exports': 'error',
                 'import/no-named-default': 'error',
-                ...options.typescript ? {
+                ...typescript ? {
                     'import/default': 'off',
                     'import/named': 'off',
                     'import/namespace': 'off',
@@ -91,6 +225,26 @@ const imports = (options = {})=>[
             }
         }
     ];
+    if (sortImportsOption) {
+        const { rule, settings } = resolveSortImports(sortImportsOption);
+        configs.push({
+            files: [
+                GLOB_SRC
+            ],
+            name: 'heyq02/imports/sort',
+            ...Object.keys(settings).length > 0 ? {
+                settings
+            } : {},
+            rules: {
+                'import/order': [
+                    'error',
+                    rule
+                ]
+            }
+        });
+    }
+    return configs;
+};
 const restrictedSyntaxJs = [
     'ForInStatement',
     'LabeledStatement'
@@ -354,6 +508,21 @@ const react = (options = {})=>{
     if (false !== options.jsxA11y) configs.push(...jsxA11y());
     return configs;
 };
+const regexp = ()=>{
+    const recommended = eslint_plugin_regexp.configs["flat/recommended"];
+    return [
+        {
+            files: [
+                GLOB_SRC
+            ],
+            name: 'heyq02/regexp',
+            plugins: {
+                regexp: asESLintPlugin(eslint_plugin_regexp)
+            },
+            rules: recommended.rules
+        }
+    ];
+};
 const rstest = ()=>[
         {
             ...rstestPlugin.configs.recommended,
@@ -391,7 +560,9 @@ const specialCases = ()=>[
                 `**/{views,pages,routes,middleware,plugins,api,modules}/${GLOB_SRC}`,
                 `**/{index,vite,esbuild,rollup,rolldown,webpack,rspack,farm,unloader,nuxt,rslint}.${GLOB_SRC_EXT}`,
                 '**/*.d.ts',
-                '**/.prettierrc*'
+                '**/.prettierrc*',
+                '**/.oxfmtrc*',
+                '**/oxfmt.config.*'
             ],
             name: 'heyq02/special/allow-default-export',
             rules: {
@@ -432,7 +603,7 @@ function resolveTypeScriptOptions(options) {
         projectService: options.projectService
     };
 }
-const typescript = (options = true)=>{
+const typescript_typescript = (options = true)=>{
     const opts = resolveTypeScriptOptions(options);
     const baseline = opts.strict && opts.typeChecked ? ts.configs.strictTypeChecked : opts.strict ? ts.configs.strict : opts.typeChecked ? ts.configs.recommendedTypeChecked : ts.configs.recommended;
     const stylistic = opts.stylistic ? opts.typeChecked ? ts.configs.stylisticTypeChecked : ts.configs.stylistic : [];
@@ -568,20 +739,34 @@ const unicorn = ()=>[
             }
         }
     ];
-const env_require = createRequire(import.meta.url);
-const cwd = node_process.cwd();
-function isPackageExists(name) {
-    try {
-        env_require.resolve(name, {
-            paths: [
-                cwd
-            ]
-        });
-        return true;
-    } catch  {
-        return false;
-    }
-}
+const unusedVarsOptions = {
+    args: 'after-used',
+    argsIgnorePattern: '^_',
+    ignoreRestSiblings: true,
+    varsIgnorePattern: '^_'
+};
+const unusedImports = ()=>[
+        {
+            files: [
+                GLOB_SRC
+            ],
+            name: 'heyq02/unused-imports',
+            plugins: {
+                'unused-imports': asESLintPlugin(eslint_plugin_unused_imports)
+            },
+            rules: {
+                'no-unused-vars': 'off',
+                "@typescript-eslint/no-unused-vars": 'off',
+                'unused-imports/no-unused-imports': 'error',
+                'unused-imports/no-unused-vars': [
+                    'error',
+                    {
+                        ...unusedVarsOptions
+                    }
+                ]
+            }
+        }
+    ];
 const hasTypeScript = ()=>isPackageExists("typescript");
 const hasReact = ()=>isPackageExists('react') || isPackageExists('react-dom') || isPackageExists('next') || isPackageExists('preact') || isPackageExists('@remix-run/react');
 const hasJest = ()=>isPackageExists('jest') || isPackageExists('@jest/globals');
@@ -614,22 +799,32 @@ const presetJavaScript = ()=>[
         ...ignores(),
         ...javascript(),
         ...imports({
-            typescript: false
+            typescript: false,
+            sortImports: true
         }),
         ...unicorn(),
         ...node(),
-        ...promise()
+        ...promise(),
+        ...unusedImports(),
+        ...regexp(),
+        ...deMorgan(),
+        ...eslintComments()
     ];
 const presetBasic = (typescriptOptions = true)=>[
         ...ignores(),
         ...javascript(),
-        ...typescript(typescriptOptions),
+        ...typescript_typescript(typescriptOptions),
         ...imports({
-            typescript: true
+            typescript: true,
+            sortImports: true
         }),
         ...unicorn(),
         ...node(),
-        ...promise()
+        ...promise(),
+        ...unusedImports(),
+        ...regexp(),
+        ...deMorgan(),
+        ...eslintComments()
     ];
 const presetAll = ()=>heyq02({
         typescript: true,
@@ -639,14 +834,15 @@ const presetAll = ()=>heyq02({
         jsxA11y: true
     });
 function heyq02(options = {}, ...userConfigs) {
-    const { ignores: extraIgnores = [], javascript: enableJavaScript = true, typescript: enableTypeScript = hasTypeScript(), unicorn: enableUnicorn = true, imports: enableImports = true, node: enableNode = true, promise: enablePromise = true, react: enableReact = hasReact(), jsxA11y: enableJsxA11y, jest: enableJest = hasJest(), rstest: enableRstest = hasRstest() } = options;
+    const { ignores: extraIgnores = [], javascript: enableJavaScript = true, typescript: enableTypeScript = hasTypeScript(), unicorn: enableUnicorn = true, imports: enableImports = true, sortImports: sortImportsOption = true, node: enableNode = true, promise: enablePromise = true, react: enableReact = hasReact(), jsxA11y: enableJsxA11y, jest: enableJest = hasJest(), rstest: enableRstest = hasRstest(), unusedImports: enableUnusedImports = true, regexp: enableRegexp = true, deMorgan: enableDeMorgan = true, eslintComments: enableEslintComments = true } = options;
     const configs = [
         ...ignores(extraIgnores)
     ];
     if (enableJavaScript) configs.push(...javascript());
-    if (enableTypeScript) configs.push(...typescript(true === enableTypeScript ? true : enableTypeScript));
+    if (enableTypeScript) configs.push(...typescript_typescript(true === enableTypeScript ? true : enableTypeScript));
     if (enableImports) configs.push(...imports({
-        typescript: Boolean(enableTypeScript)
+        typescript: Boolean(enableTypeScript),
+        sortImports: sortImportsOption
     }));
     if (enableUnicorn) configs.push(...unicorn());
     if (enableNode) configs.push(...node(true === enableNode ? 'module' : enableNode));
@@ -657,9 +853,13 @@ function heyq02(options = {}, ...userConfigs) {
     else if (enableJsxA11y) configs.push(...jsxA11y());
     if (enableJest) configs.push(...jest());
     if (enableRstest) configs.push(...rstest());
+    if (enableUnusedImports) configs.push(...unusedImports());
+    if (enableRegexp) configs.push(...regexp());
+    if (enableDeMorgan) configs.push(...deMorgan());
+    if (enableEslintComments) configs.push(...eslintComments());
     configs.push(...specialCases());
     configs.push(...flattenConfigs(...userConfigs));
     return configs;
 }
 const rslintConfig = heyq02;
-export { GLOB_DIST, GLOB_EXCLUDE, GLOB_JS, GLOB_JSX, GLOB_LOCKFILE, GLOB_NODE_MODULES, GLOB_SRC, GLOB_SRC_EXT, GLOB_TESTS, GLOB_TS, GLOB_TSX, flattenConfigs, hasJest, hasReact, hasRstest, hasTypeScript, heyq02, ignores, imports, isInEditorEnv, isInGitHooksOrLintStaged, javascript, jest, jsxA11y, node, presetAll, presetBasic, presetJavaScript, promise, react, restrictedSyntaxJs, rslintConfig, rstest, specialCases, toArray, typescript, unicorn };
+export { DEFAULT_INTERNAL_PATTERN, DEFAULT_SORT_IMPORT_GROUPS, GLOB_DIST, GLOB_EXCLUDE, GLOB_JS, GLOB_JSX, GLOB_LOCKFILE, GLOB_NODE_MODULES, GLOB_SRC, GLOB_SRC_EXT, GLOB_TESTS, GLOB_TS, GLOB_TSX, customGroupsToPathGroups, deMorgan, eslintComments, flattenConfigs, hasJest, hasReact, hasRstest, hasTypeScript, heyq02, ignores, imports, internalPatternToRegex, isInEditorEnv, isInGitHooksOrLintStaged, javascript, jest, jsxA11y, node, presetAll, presetBasic, presetJavaScript, promise, react, regexp, resolveSortImports, restrictedSyntaxJs, rslintConfig, rstest, specialCases, toArray, typescript_typescript as typescript, unicorn, unusedImports };

package/dist/plugin-utils.d.ts

@@ -0,0 +1,3 @@
+import type { ESLintPlugin } from '@rslint/core';
+/** Cast community ESLint plugin objects into Rslint's `ESLintPlugin` shape. */
+export declare function asESLintPlugin(plugin: unknown): ESLintPlugin;

package/dist/types.d.ts

@@ -27,6 +27,91 @@ export interface TypeScriptOptions {
     projectService?: boolean;
 }
 export type NodePreset = boolean | 'module' | 'script' | 'mixed';
+/**
+ * `import/order` group names (Rslint / eslint-plugin-import).
+ * Closest enforceable equivalent of Oxfmt perfectionist selectors.
+ */
+export type SortImportsGroup = 'builtin' | 'external' | 'internal' | 'unknown' | 'parent' | 'sibling' | 'index' | 'object' | 'type';
+/**
+ * Oxfmt-like custom group → mapped to `import/order` `pathGroups`.
+ *
+ * @see https://oxc.rs/docs/guide/usage/formatter/sorting.html
+ */
+export interface SortImportsCustomGroup {
+    /**
+     * Display / documentation name (Oxfmt `groupName`).
+     * Not a first-class `import/order` group — attach via {@link group}.
+     */
+    groupName?: string;
+    /**
+     * Glob patterns matched against the import source (Oxfmt `elementNamePattern`).
+     */
+    elementNamePattern: string | string[];
+    /**
+     * Target `import/order` group to attach to.
+     * @default 'external'
+     */
+    group?: SortImportsGroup;
+    /**
+     * Position relative to {@link group}.
+     * @default 'before'
+     */
+    position?: 'before' | 'after';
+}
+/**
+ * Import sorting options, shaped like Oxfmt `sortImports` and implemented via
+ * Rslint `import/order`.
+ *
+ * Unsupported Oxfmt knobs (no-op / not exposed): per-group `{ newlinesBetween }`,
+ * `partitionByComment`, `partitionByNewline`, perfectionist modifier-selectors
+ * (`value-builtin`, `type-import`, …).
+ *
+ * @see https://oxc.rs/docs/guide/usage/formatter/sorting.html
+ */
+export interface SortImportsOptions {
+    /**
+     * Relative order of import groups.
+     * @default `['type', ['builtin', 'external'], 'internal', ['parent', 'sibling', 'index'], 'unknown']`
+     */
+    groups?: (SortImportsGroup | SortImportsGroup[])[];
+    /**
+     * Insert a blank line between groups.
+     * Maps to `newlines-between: 'always' | 'never'`.
+     * @default true
+     */
+    newlinesBetween?: boolean;
+    /**
+     * Custom path-based groups (Oxfmt `customGroups` → `pathGroups`).
+     */
+    customGroups?: SortImportsCustomGroup[];
+    /**
+     * Prefixes treated as internal imports (Oxfmt `internalPattern`).
+     * Converted to `settings['import/internal-regex']`.
+     * @default `['~/', '@/', '#']`
+     */
+    internalPattern?: string[];
+    /**
+     * Alphabetical order within each group.
+     * @default 'asc'
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Case-insensitive alphabetical sort.
+     * @default true
+     */
+    ignoreCase?: boolean;
+    /**
+     * Sort named import / export members.
+     * @default true
+     */
+    named?: boolean;
+    /**
+     * Whether side-effect imports participate in ordering
+     * (`warnOnUnassignedImports`).
+     * @default false
+     */
+    sortSideEffects?: boolean;
+}
 export interface Options {
     /**
      * Global ignore patterns. Merged with the built-in excludes.
@@ -50,6 +135,13 @@ export interface Options {
      * Import rules. @default true
      */
     imports?: boolean;
+    /**
+     * Sort imports via `import/order`, with an Oxfmt-like options surface.
+     * Enabled by default when {@link imports} is on.
+     * Set `false` if Oxfmt `sortImports` already owns ordering.
+     * @default true
+     */
+    sortImports?: boolean | SortImportsOptions;
     /**
      * Node.js rules.
      * - `true` / `'module'` — ESM-oriented Node rules (default)
@@ -82,4 +174,24 @@ export interface Options {
      * @default auto
      */
     rstest?: boolean;
+    /**
+     * Autofix unused imports (`eslint-plugin-unused-imports`).
+     * @default true
+     */
+    unusedImports?: boolean;
+    /**
+     * RegExp rules (`eslint-plugin-regexp`).
+     * @default true
+     */
+    regexp?: boolean;
+    /**
+     * De Morgan rewrites (`eslint-plugin-de-morgan`).
+     * @default true
+     */
+    deMorgan?: boolean;
+    /**
+     * `eslint-disable` hygiene (`@eslint-community/eslint-plugin-eslint-comments`).
+     * @default true
+     */
+    eslintComments?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyq02/rslint-config",
-  "version": "0.0.2",
+  "version": "0.0.3-beta.1",
   "description": "Opinionated Rslint flat-config preset.",
   "keywords": [
     "flat-config",
@@ -23,6 +23,8 @@
     "dist"
   ],
   "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -30,25 +32,30 @@
     },
     "./package.json": "./package.json"
   },
-  "types": "./dist/index.d.ts",
-  "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
-  "peerDependencies": {
-    "@rslint/core": "^0.9.0"
+  "dependencies": {
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.8.1",
+    "eslint-plugin-de-morgan": "^2.2.0",
+    "eslint-plugin-regexp": "^3.3.1",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "local-pkg": "^1.2.1"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
     "@heyq02/rslib-config": "^1.0.1",
     "@rslib/core": "^1.0.3",
     "@rslint/core": "^0.9.4",
     "@types/node": "^26.1.1",
+    "automd": "^0.4.3",
     "bumpp": "^11.1.0",
-    "prettier": "^3.9.6",
-    "typescript": "^7.0.2"
+    "publint": "^0.3.25",
+    "typescript": "^7.0.2",
+    "vite-plus": "^1.1.0"
   },
-  "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+  "peerDependencies": {
+    "@rslint/core": "^0.9.0"
   },
   "devEngines": {
     "packageManager": {
@@ -57,14 +64,23 @@
       "onFail": "download"
     }
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
   "scripts": {
     "build": "rslib",
     "dev": "rslib --watch",
-    "test": "echo Skip",
+    "test": "vp test",
     "lint": "rslint .",
     "lint:fix": "rslint --fix .",
-    "format": "prettier --write .",
+    "automd": "automd",
+    "format": "pnpm automd && vp fmt",
+    "format:check": "vp fmt --check",
     "typecheck": "tsc --noEmit",
+    "check": "pnpm run format:check && pnpm run lint && pnpm run typecheck",
+    "publint": "publint",
+    "attw": "pnpm pack && attw heyq02-rslint-config-*.tgz --profile esm-only && rm -f heyq02-rslint-config-*.tgz",
+    "check:package": "pnpm run build && pnpm run publint && pnpm run attw",
     "release": "bumpp"
   }
 }