@ocavue/eslint-config 2.19.0 → 2.20.0

package/README.md

@@ -17,24 +17,60 @@ $ npm install -D eslint prettier @ocavue/eslint-config
 
 ### Config ESLint
 
-You will need to use the new ["flat" ESLint configuration](https://eslint.org/docs/latest/use/configure/configuration-files-new) (i.e. `eslint.config.js`).
-
-In your `eslint.config.js` file, add the following to extend the basic config:
+Create `eslint.config.mjs` in your project root with the following content:
 
 ```js
-// eslint.config.js
+// eslint.config.mjs
 import { defineESLintConfig } from '@ocavue/eslint-config'
 
 export default defineESLintConfig()
 ```
 
-You can pass an optional object to the `defineESLintConfig` function to enable or disable the configs. For example, if you want to enable the React config, you can do the following:
+### Add script for package.json
+
+```json
+{
+  "scripts": {
+    "lint": "eslint .",
+    "check": "prettier --check .",
+    "fix": "eslint --fix . && prettier --write ."
+  }
+}
+```
+
+### Add `.prettierignore`
+
+Add a [`.prettierignore`](https://prettier.io/docs/en/ignore.html#ignoring-files-prettierignore) file in the root of your project. You can copy the `.prettierignore` file from this project.
+
+### VS Code integration
+
+If you are using VS Code, you and install [ESLint extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) and [Prettier extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode), then add the following to your VS Code settings:
+
+```json
+// .vscode/settings.json
+{
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  }
+}
+```
+
+## Customization
+
+You can pass an optional object to the `defineESLintConfig` function to enable or disable the configs. Here is an example:
 
 ```js
-// eslint.config.js
+// eslint.config.mjs
 import { defineESLintConfig } from '@ocavue/eslint-config'
 
-export default defineESLintConfig({ react: true })
+export default defineESLintConfig({
+  // Enable React config and only apply for files under `src/react` directory.
+  react: { files: ['src/react/**/*.tsx'] },
+  // Enable Vue config.
+  vue: true,
+})
 ```
 
 The full type definition for the options is as follows:
@@ -60,42 +96,49 @@ export interface ESLintConfigOptions {
    *
    * @default false
    */
-  vue?: boolean
-}
-```
+  vue?: boolean | VueOptions
 
-### Add script for package.json
+  /**
+   * Whether to enable UnoCSS configuration.
+   *
+   * @default false
+   */
+  unocss?: boolean
 
-```json
-{
-  "scripts": {
-    "lint": "eslint .",
-    "check": "prettier --check .",
-    "fix": "eslint --fix . && prettier --write ."
-  }
+  /**
+   * Whether to enable [eslint-plugin-command](https://www.npmjs.com/package/eslint-plugin-command) configuration.
+   *
+   * @default false
+   */
+  command?: boolean
 }
 ```
 
-### Add `.prettierignore`
-
-Add a [`.prettierignore`](https://prettier.io/docs/en/ignore.html#ignoring-files-prettierignore) file in the root of your project. You can copy the `.prettierignore` file from this project.
-
-### VS Code integration
+You can pass the second and following arguments to the `defineESLintConfig` function to extend the config.
 
-If you are using VS Code, you and install [ESLint extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) and [Prettier extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode), then add the following to your VS Code settings:
+```js
+// eslint.config.mjs
+import { defineESLintConfig } from '@ocavue/eslint-config'
 
-```json
-// .vscode/settings.json
-{
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "editor.formatOnSave": true,
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit"
-  }
-}
+export default defineESLintConfig(
+  {
+    // Your options here
+  },
+  // More configs here:
+  {
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+    },
+  },
+  {
+    rules: {
+      'no-console': ['warn', { allow: ['warn', 'error', 'assert'] }],
+    },
+  },
+)
 ```
 
-## Alternative solutions
+## Related projects
 
 - https://github.com/antfu/eslint-config
 - https://github.com/sxzz/eslint-config

package/dist/command.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from './types.js';
+export declare function command(): Config[];

package/dist/command.js

@@ -0,0 +1,4 @@
+import commandConfig from 'eslint-plugin-command/config';
+export function command() {
+    return [commandConfig()];
+}

package/dist/index.d.ts

@@ -7,4 +7,4 @@ export * from './react.js';
 export * from './typescript.js';
 export * from './vue.js';
 export type { Config, ESLintConfigOptions };
-export declare function defineESLintConfig(options?: ESLintConfigOptions): Config[];
+export declare function defineESLintConfig(options?: ESLintConfigOptions, ...userConfigs: Config[]): Promise<Config[]>;

package/dist/index.js

@@ -1,28 +1,37 @@
 import { defineConfig } from 'eslint/config';
 import { basic } from './basic.js';
-import { markdown } from './markdown.js';
 import { resolveOptions } from './options.js';
-import { react } from './react.js';
-import { vue } from './vue.js';
 export * from './basic.js';
 export * from './markdown.js';
 export * from './prettier.js';
 export * from './react.js';
 export * from './typescript.js';
 export * from './vue.js';
-export function defineESLintConfig(options) {
+export async function defineESLintConfig(options, ...userConfigs) {
     const resolvedOptions = resolveOptions(options);
     const configs = [];
     configs.push(...basic());
     if (resolvedOptions.markdown) {
+        const { markdown } = await import('./markdown.js');
         configs.push(...markdown());
     }
     if (resolvedOptions.react) {
+        const { react } = await import('./react.js');
         configs.push(...react(trueToUndefined(resolvedOptions.react)));
     }
     if (resolvedOptions.vue) {
+        const { vue } = await import('./vue.js');
         configs.push(...vue(trueToUndefined(resolvedOptions.vue)));
     }
+    if (resolvedOptions.unocss) {
+        const { unocss } = await import('./unocss.js');
+        configs.push(...unocss());
+    }
+    if (resolvedOptions.command) {
+        const { command } = await import('./command.js');
+        configs.push(...command());
+    }
+    configs.push(...userConfigs);
     return defineConfig(configs);
 }
 function trueToUndefined(value) {

package/dist/options.d.ts

@@ -18,8 +18,20 @@ export interface ESLintConfigOptions {
      * @default false
      */
     vue?: boolean | VueOptions;
+    /**
+     * Whether to enable UnoCSS configuration.
+     *
+     * @default false
+     */
+    unocss?: boolean;
+    /**
+     * Whether to enable [eslint-plugin-command](https://www.npmjs.com/package/eslint-plugin-command) configuration.
+     *
+     * @default false
+     */
+    command?: boolean;
 }
-export declare function resolveOptions({ markdown, react, vue, }?: ESLintConfigOptions): Required<ESLintConfigOptions>;
+export declare function resolveOptions({ markdown, react, vue, unocss, command, }?: ESLintConfigOptions): Required<ESLintConfigOptions>;
 export interface ReactOptions {
     /**
      * The default files to lint.

package/dist/options.js

@@ -1,9 +1,11 @@
 import { GLOB_TS, GLOB_TSX, GLOB_VUE } from './shared.js';
-export function resolveOptions({ markdown = true, react = false, vue = false, } = {}) {
+export function resolveOptions({ markdown = true, react = false, vue = false, unocss = false, command = false, } = {}) {
     return {
         markdown,
         react,
         vue,
+        unocss,
+        command,
     };
 }
 export function resolveReactOptions({ files = [GLOB_TS, GLOB_TSX], } = {}) {

package/dist/unocss.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from './types.js';
+export declare function unocss(): Config[];

package/dist/unocss.js

@@ -0,0 +1,5 @@
+import unocssConfig from '@unocss/eslint-config/flat';
+export function unocss() {
+    // @ts-expect-error: unmatched types
+    return [unocssConfig];
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ocavue/eslint-config",
   "type": "module",
-  "version": "2.19.0",
+  "version": "2.20.0",
   "description": "",
   "author": "ocavue <ocavue@gmail.com>",
   "license": "MIT",
@@ -30,10 +30,12 @@
   "dependencies": {
     "@eslint/js": "^9.26.0",
     "@eslint/markdown": "^6.4.0",
+    "@unocss/eslint-config": "^66.1.2",
     "eslint-config-flat-gitignore": "^2.1.0",
     "eslint-config-prettier": "^10.1.5",
     "eslint-import-resolver-typescript": "^4.3.5",
     "eslint-plugin-antfu": "^3.1.1",
+    "eslint-plugin-command": "^3.2.0",
     "eslint-plugin-import-x": "^4.12.2",
     "eslint-plugin-no-only-tests": "^3.3.0",
     "eslint-plugin-package-json": "^0.31.0",