@open-xchange/linter-presets 0.0.1 → 0.0.3

package/lib/stylelint/index.js

@@ -0,0 +1,106 @@
+
+// functions ==================================================================
+
+/**
+ * Generates standard configuration objects targeting the source files in the
+ * entire project.
+ *
+ * @param {import("./types").ConfigureOptions} [options]
+ *  Plugin configuration options.
+ *
+ * @returns {import("stylelint").Config}
+ *  The configuration object to be exported from `stylelint.config.js`.
+ */
+export function configure(options) {
+
+    // resolve stylistic configuration options
+    const stylistic = {
+        indent: 2,
+        quotes: "single",
+        ...options?.stylistic,
+    };
+
+    // group custom rules by language plugins
+    const rules = { base: {}, scss: {}, less: {} };
+    for (const [rule, value] of Object.entries(options?.rules ?? {})) {
+        (rules[rule.split("/")[0]] ?? rules.base)[rule] = value;
+    }
+
+    return {
+
+        // ignore certain files and folders
+        ignoreFiles: options?.ignores ?? [],
+
+        // add the stylistic plugin
+        plugins: [
+            "stylelint-plugin-license-header",
+            "@stylistic/stylelint-plugin",
+        ],
+
+        // add recommended configurations
+        extends: [
+            "@stylistic/stylelint-config",
+        ],
+
+        // check inline directives
+        reportDescriptionlessDisables: null,
+        reportInvalidScopeDisables: true,
+        reportNeedlessDisables: true,
+
+        // reconfigure linter rules
+        rules: {
+
+            // core rules
+            "at-rule-empty-line-before": null,
+            "color-function-notation": ["modern", { ignore: ["with-var-inside"] }],
+            "color-hex-length": null,
+            "comment-empty-line-before": null,
+            "custom-property-empty-line-before": null,
+            "declaration-block-no-redundant-longhand-properties": [true, { ignoreShorthands: ["inset"] }], // Safari does not support "inset"
+            "declaration-block-single-line-max-declarations": null,
+            "declaration-empty-line-before": null,
+            "function-url-no-scheme-relative": true,
+            "function-url-scheme-allowed-list": ["data"],
+            "media-feature-range-notation": "prefix", // Safari 16.3 does not work with this notation
+            "no-descending-specificity": null,
+            "no-unknown-animations": true,
+            "rule-empty-line-before": null,
+
+            // license-header plugin
+            ...(options?.license ? { "plugin/license-header": [true, { license: options.license }] } : null),
+
+            // stylistic plugin
+            "@stylistic/declaration-colon-newline-after": null,
+            "@stylistic/indentation": [stylistic.indent, { ignore: ["inside-parens"] }],
+            "@stylistic/max-line-length": null,
+            "@stylistic/selector-list-comma-newline-after": null,
+            "@stylistic/string-quotes": (stylistic.quotes === "off") ? null : [stylistic.quotes, { avoidEscape: true }],
+
+            // custom rules
+            ...rules.base,
+        },
+
+        // overrides for custom languages
+        overrides: [
+
+            // SCSS files
+            {
+                files: ["**/*.scss"],
+                extends: ["stylelint-config-standard-scss"],
+                rules: {
+                    "scss/double-slash-comment-empty-line-before": null,
+                    ...rules.scss,
+                },
+            },
+
+            // LESS files
+            {
+                files: ["**/*.less"],
+                extends: ["stylelint-config-standard-less"],
+                rules: {
+                    ...rules.less,
+                },
+            },
+        ],
+    };
+}

package/lib/stylelint/types.d.ts

@@ -0,0 +1,44 @@
+
+import { Config } from "stylelint";
+
+// types ======================================================================
+
+/**
+ * Configuration options for code style.
+ */
+export interface StylisticOptions {
+
+    /**
+     * Default indentation size (number of space characters). Default value is
+     * `2`.
+     */
+    indent?: number;
+
+    /**
+     * The type of the string delimiter character. Default value is "single".
+     */
+    quotes?: "single" | "double" | "off";
+}
+
+// ----------------------------------------------------------------------------
+
+/**
+ * Configuration options for linting the entire project.
+ */
+export interface ConfigureOptions {
+
+    /**
+     * Glob patterns with all files and folders to be ignored by StyleLint.
+     */
+    ignores?: readonly string[];
+
+    /**
+     * Configuration options for code style.
+     */
+    stylistic?: StylisticOptions;
+
+    /**
+     * Additional linter rules to be added to the global configuration.
+     */
+    rules?: Config["rules"];
+}

package/package.json

@@ -1,61 +1,90 @@
 {
-  "name": "@open-xchange/linter-presets",
-  "version": "0.0.1",
-  "description": "Configuration presets for ESLint and StyleLint",
-  "repository": "https://gitlab.open-xchange.com/fspd/npm-packages/linter-presets",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18"
-  },
-  "packageManager": "yarn@4.3.1",
-  "type": "module",
-  "exports": "./lib/index.js",
-  "scripts": {
-    "prepare": "husky",
-    "lint": "eslint ."
-  },
-  "lint-staged": {
-    "*.{js,ts,json}": "yarn lint"
-  },
-  "dependencies": {
-    "@eslint-community/eslint-plugin-eslint-comments": "4.3.0",
-    "@eslint/compat": "1.1.0",
-    "@eslint/js": "9.6.0",
-    "@stylistic/eslint-plugin": "2.3.0",
-    "@stylistic/eslint-plugin-migrate": "2.3.0",
-    "confusing-browser-globals": "1.0.11",
-    "eslint-plugin-chai-expect": "3.1.0",
-    "eslint-plugin-codeceptjs": "1.3.0",
-    "eslint-plugin-eslint-plugin": "6.2.0",
-    "eslint-plugin-jest": "28.6.0",
-    "eslint-plugin-jest-dom": "5.4.0",
-    "eslint-plugin-jsdoc": "48.5.0",
-    "eslint-plugin-jsonc": "2.16.0",
-    "eslint-plugin-jsx-a11y": "6.9.0",
-    "eslint-plugin-jsx-expressions": "1.3.2",
-    "eslint-plugin-license-header": "0.6.1",
-    "eslint-plugin-n": "17.9.0",
-    "eslint-plugin-promise": "6.4.0",
-    "eslint-plugin-react": "7.34.3",
-    "eslint-plugin-react-hooks": "4.6.2",
-    "eslint-plugin-react-hooks-static-deps": "1.0.7",
-    "eslint-plugin-react-refresh": "0.4.7",
-    "eslint-plugin-testing-library": "6.2.2",
-    "eslint-plugin-vitest": "0.5.4",
-    "eslint-plugin-yml": "1.14.0",
-    "globals": "15.8.0",
-    "typescript-eslint": "7.15.0"
-  },
-  "devDependencies": {
-    "eslint": "9.6.0",
-    "husky": "9.0.11",
-    "typescript": "5.5.3"
-  },
-  "peerDependencies": {
-    "eslint": "^9.6.0",
-    "typescript": "^5.5.3"
-  },
-  "resolutions": {
-    "semver": "^7.6.2"
-  }
-}
+    "name": "@open-xchange/linter-presets",
+    "version": "0.0.3",
+    "description": "Configuration presets for ESLint and StyleLint",
+    "repository": "https://gitlab.open-xchange.com/fspd/npm-packages/linter-presets",
+    "license": "MIT",
+    "engines": {
+        "node": ">=18"
+    },
+    "packageManager": "yarn@4.3.1",
+    "type": "module",
+    "exports": "./lib/index.js",
+    "scripts": {
+        "prepare": "husky",
+        "lint": "eslint ."
+    },
+    "lint-staged": {
+        "*.{js,ts,json}": "yarn lint"
+    },
+    "dependencies": {
+        "@eslint-community/eslint-plugin-eslint-comments": "4.3.0",
+        "@eslint/compat": "1.1.0",
+        "@eslint/js": "9.6.0",
+        "@stylistic/eslint-plugin": "2.3.0",
+        "@stylistic/eslint-plugin-migrate": "2.3.0",
+        "@stylistic/stylelint-config": "1.0.1",
+        "@stylistic/stylelint-plugin": "2.1.2",
+        "confusing-browser-globals": "1.0.11",
+        "eslint-plugin-chai-expect": "3.1.0",
+        "eslint-plugin-codeceptjs": "1.3.0",
+        "eslint-plugin-eslint-plugin": "6.2.0",
+        "eslint-plugin-import": "2.29.1",
+        "eslint-plugin-jest": "28.6.0",
+        "eslint-plugin-jest-dom": "5.4.0",
+        "eslint-plugin-jsdoc": "48.5.2",
+        "eslint-plugin-jsonc": "2.16.0",
+        "eslint-plugin-jsx-a11y": "6.9.0",
+        "eslint-plugin-jsx-expressions": "1.3.2",
+        "eslint-plugin-license-header": "0.6.1",
+        "eslint-plugin-n": "17.9.0",
+        "eslint-plugin-promise": "6.4.0",
+        "eslint-plugin-react": "7.34.3",
+        "eslint-plugin-react-hooks": "4.6.2",
+        "eslint-plugin-react-hooks-static-deps": "1.0.7",
+        "eslint-plugin-react-refresh": "0.4.7",
+        "eslint-plugin-testing-library": "6.2.2",
+        "eslint-plugin-vitest": "0.5.4",
+        "eslint-plugin-yml": "1.14.0",
+        "globals": "15.8.0",
+        "package-up": "5.0.0",
+        "picomatch": "4.0.2",
+        "stylelint-config-standard": "36.0.1",
+        "stylelint-config-standard-less": "3.0.1",
+        "stylelint-config-standard-scss": "13.1.0",
+        "stylelint-plugin-license-header": "1.0.3",
+        "typescript-eslint": "7.16.0"
+    },
+    "devDependencies": {
+        "@types/acorn": "6.0.0",
+        "eslint": "9.6.0",
+        "husky": "9.0.11",
+        "jest": "29.7.0",
+        "stylelint": "16.6.1",
+        "typescript": "5.5.3"
+    },
+    "peerDependencies": {
+        "eslint": "^9.6",
+        "jest": "^29.7",
+        "stylelint": "^16.6",
+        "typescript": "^5.5",
+        "vitest": "^2.0"
+    },
+    "peerDependenciesMeta": {
+        "jest": {
+            "optional": true
+        },
+        "stylelint": {
+            "optional": true
+        },
+        "typescript": {
+            "optional": true
+        },
+        "vitest": {
+            "optional": true
+        }
+    },
+    "resolutions": {
+        "semver": "^7.6.2"
+    }
+}

package/doc/eslint.md

@@ -1,343 +0,0 @@
-# ESLint Presets
-
-The module `eslint` provides a `configure` function for project-wide ESLint configuration (e.g. TypeScript files, JSON files, license headers, etc.), and a set of environment presets that apply more ESLint plugins and rules to a specific subset of the project (e.g. browser code, unit test code, etc.).
-
-## Functions
-
-### Function `configure`
-
-Generates standard configuration targeting the source files in the entire project. Internally, various ESLint plugins will be included and configured to use their recommended rule sets.
-
-| Target | ESLint Plugin |
-| - | - |
-| JavaScript and TypeScript files (including `.jsx` and `.tsx`) | ESLint core rules |
-| JavaScript files only (including `.jsx`) | ESLint core rules |
-| TypeScript files with type-aware rules (including `.tsx`) | [typescript-eslint](https://typescript-eslint.io/) |
-| JSON files | [eslint-plugin-jsonc](https://ota-meshi.github.io/eslint-plugin-jsonc/) |
-| YAML files | [eslint-plugin-yml](https://ota-meshi.github.io/eslint-plugin-yml/) |
-| License headers | [eslint-plugin-license-header](https://github.com/nikku/eslint-plugin-license-header) |
-| ESLint inline directives | [@eslint-community/eslint-plugin-eslint-comments](https://github.com/eslint-community/eslint-plugin-eslint-comments) |
-| Native ES6 promises | [eslint-plugin-promise](https://github.com/eslint-community/eslint-plugin-promise) |
-| JSDoc source documentation | [eslint-plugin-jsdoc](https://github.com/gajus/eslint-plugin-jsdoc) |
-| Source code formatting | [@stylistic/eslint-plugin](https://eslint.style/packages/default) |
-
-#### `configure` Signature
-
-`function configure(options?: ESLintPresetsOptions): Linter.FlatConfig[]`
-
-#### `configure` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `ignores` | `string[]` | `[]` | Glob patterns with all files and folders to be ignored by ESlint. |
-| `license` | `string` | `""` | Full path to the template file containing the license header to be used in all source files. |
-| `language` | `LanguageOptions` | | Configuration options for language and project setup. |
-| `language.ecmaVersion` | `number` | `2022` | The ECMAScript version to be used in the project (version or year). |
-| `language.sourceType` | `"module"\|"commonjs"` | `"module"` | Specifies how to treat `.js`, `.jsx`, `.ts`, and `.tsx` files. |
-| `stylistic` | `StylisticOptions` | | Configuration options for code style. |
-| `stylistic.indent` | `number` | `2` | Default indentation size (number of space characters). Will be applied to JavaScript, TypeScript, JSON, and YAML files, as well as JSX markup. |
-| `stylistic.semi` | `boolean` | `false` | Specifies whether to require semicolons following all statements (`true`), or to force to omit semicolons if possible according to ASI rules (`false`). |
-| `stylistic.quotes` | `"single"\|"double"\|"off"` | `"single"` | The type of the string delimiter character. |
-| `stylistic.dangle` | `"always"\|"never"\|"off"` | `"always"` | Specifies how to treat dangling commas in multiline lists. |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the global configuration. |
-
-#### `configure` Example
-
-```js
-// eslint.config.js
-import { utils, eslint } from "@open-xchange/linter-presets"
-
-const resolve = utils.resolver(import.meta.url)
-
-export default [
-  ...eslint.configure({
-    ignores: ["dist/*", "external/**/*.yaml"],
-    language: { ecmaVersion: 2024, sourceType: "commonjs" },
-    license: resolve("./license.txt"),
-    stylistic: { quotes: "double", semi: true },
-  }),
-]
-```
-
-## Environment Presets
-
-Environment presets will be applied to specific subsets of the project. Usually, they import one or more external ESLint plugins, apply their recommended rule set, and add or modify a few of their rules to establish the default setup for the project.
-
-### Overview
-
-| Name | Target | ESLint Plugins |
-| - | - | - |
-| `env.tsconfig` | TypeScript project setup (per `tsconfig.json` file) | |
-| `env.node` | NodeJS modules | [eslint-plugin-n](https://github.com/eslint-community/eslint-plugin-n) |
-| `env.browser` | Modules running in browsers | [globals](https://github.com/sindresorhus/globals), [confusing-browser-globals](https://github.com/facebook/create-react-app/tree/main/packages/confusing-browser-globals) |
-| `env.react` | Source modules using [React](https://react.dev/) library | [eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react) (and others) |
-| `env.jest` | Unit tests with [Jest](https://jestjs.io/) | [eslint-plugin-jest](https://github.com/jest-community/eslint-plugin-jest) |
-| `env.vitest` | Unit tests with [Vitest](https://vitest.dev/) | [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest) (and others) |
-| `env.codecept` | E2E tests with [CodeceptJS](https://codecept.io/) | [eslint-plugin-codeceptjs](https://github.com/poenneby/eslint-plugin-codeceptjs) (and others) |
-| `env.plugin` | Implementation of custom ESLint plugins | [eslint-plugin-eslint-plugin](https://github.com/eslint-community/eslint-plugin-eslint-plugin) |
-
-### Environment `env.tsconfig`
-
-Creates configuration objects for TypeScript projects (registers a `tsconfig.json` file in the project).
-
-#### `env.tsconfig` Signature
-
-`function tsconfig(options: EnvTSConfigOptions): Linter.FlatConfig[]`
-
-#### `env.tsconfig` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
-| `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
-| `project` | `string` | _required_ | The path to the TypeScript project configuration file (`tsconfig.json`). |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
-
-#### `env.tsconfig` Example
-
-```js
-// eslint.config.js
-import { utils, eslint } from "@open-xchange/linter-presets"
-
-const resolve = utils.resolver(import.meta.url)
-
-export default [
-  ...eslint.configure({ /* ... */ }),
-  ...eslint.env.tsconfig({
-    files: ["src/**/*.ts"],
-    project: resolve("src/tsconfig.json"),
-  }),
-]
-```
-
-### Environment `env.node`
-
-Creates configuration objects with global symbols and linter rules for NodeJS modules. Adds the plugin [eslint-plugin-n](https://github.com/eslint-community/eslint-plugin-n) and its recommended rules.
-
-#### `env.node` Signature
-
-`function node(options: EnvNodeOptions): Linter.FlatConfig[]`
-
-#### `env.node` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
-| `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
-| `sourceType` | `"module"\|"commonjs"` | `"module"` | Specifies how to treat `.js`, `.jsx`, `.ts`, and `.tsx`. |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
-
-#### `env.node` Example
-
-```js
-// eslint.config.js
-import { utils, eslint } from "@open-xchange/linter-presets"
-
-export default [
-  ...configure({ /* ... */ }),
-  ...env.node({
-    files: ["*.config.{js,ts}", "scripts/**/*.js"],
-    rules: { /* ... */ },
-  }),
-]
-```
-
-### Environment `env.browser`
-
-Creates configuration objects with global symbols and linter rules for modules running in the browser. Adds well-known [browser globals](https://github.com/sindresorhus/globals), and forbids [confusing browser globals](https://github.com/facebook/create-react-app/tree/main/packages/confusing-browser-globals).
-
-#### `env.browser` Signature
-
-`function browser(options: EnvBrowserOptions): Linter.FlatConfig[]`
-
-#### `env.browser` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
-| `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
-
-#### `env.browser` Example
-
-```js
-// eslint.config.js
-import { eslint } from "@open-xchange/linter-presets"
-
-export default [
-  ...eslint.configure({ /* ... */ }),
-  ...eslint.env.browser({
-    files: ["src/**/*.{js,ts}"],
-    rules: { /* ... */ },
-  }),
-]
-```
-
-### Environment `env.react`
-
-Creates configuration objects with linter rules for ReactJS. Adds the following plugins and their recommended rules:
-
-- [eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react)
-- [eslint-plugin-react-hooks](https://github.com/facebook/react/tree/main/packages/eslint-plugin-react-hooks)
-- [eslint-plugin-react-hooks-static-deps](https://github.com/stoikio/eslint-plugin-react-hooks-static-deps)
-- [eslint-plugin-react-refresh](https://github.com/ArnaudBarre/eslint-plugin-react-refresh)
-- [eslint-plugin-jsx-expressions](https://github.com/hluisson/eslint-plugin-jsx-expressions)
-- [eslint-plugin-jsx-a11y](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y)
-
-#### `env.react` Signature
-
-`function react(options: EnvReactOptions): Linter.FlatConfig[]`
-
-#### `env.react` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
-| `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
-
-#### `env.react` Example
-
-```js
-// eslint.config.js
-import { eslint } from "@open-xchange/linter-presets"
-
-export default [
-  ...eslint.configure({ /* ... */ }),
-  ...eslint.env.react({
-    files: ["src/**/*.{js,ts}"],
-    rules: { /* ... */ },
-  }),
-]
-```
-
-### Environment `env.jest`
-
-Creates configuration objects with global symbols and linter rules for unit tests using Jest. Adds the plugin [eslint-plugin-jest](https://github.com/jest-community/eslint-plugin-jest) and its recommended rules.
-
-#### `env.jest` Signature
-
-`function jest(options: EnvJestOptions): Linter.FlatConfig[]`
-
-#### `env.jest` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
-| `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
-
-#### `env.jest` Example
-
-```js
-// eslint.config.js
-import { eslint } from "@open-xchange/linter-presets"
-
-export default [
-  ...eslint.configure({ /* ... */ }),
-  ...eslint.env.jest({
-    files: ["test/**/*.{js,ts}"],
-    rules: { /* ... */ },
-  }),
-]
-```
-
-### Environment `env.vitest`
-
-Creates configuration objects with global symbols and linter rules for unit tests using Vitest. Adds the following plugins and their recommended rules:
-
-- [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest)
-- [eslint-plugin-testing-library](https://github.com/testing-library/eslint-plugin-testing-library)
-- [eslint-plugin-jest-dom](https://github.com/testing-library/eslint-plugin-jest-dom)
-
-#### `env.vitest` Signature
-
-`function vitest(options: EnvVitestOptions): Linter.FlatConfig[]`
-
-#### `env.vitest` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
-| `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
-
-#### `env.vitest` Example
-
-```js
-// eslint.config.js
-import { eslint } from "@open-xchange/linter-presets"
-
-export default [
-  ...eslint.configure({ /* ... */ }),
-  ...eslint.env.vitest({
-    files: ["test/**/*.{js,ts}"],
-    rules: { /* ... */ },
-  }),
-]
-```
-
-### Environment `env.codecept`
-
-Creates configuration objects with global symbols and linter rules for E2E tests using CodeceptJS. Adds the following plugins and their recommended rules:
-
-- [eslint-plugin-codeceptjs](https://github.com/poenneby/eslint-plugin-codeceptjs)
-- [eslint-plugin-chai-expect](https://github.com/turbo87/eslint-plugin-chai-expect)
-
-#### `env.codecept` Signature
-
-`function codecept(options: EnvCodeceptOptions): Linter.FlatConfig[]`
-
-#### `env.codecept` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
-| `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
-
-#### `env.codecept` Example
-
-```js
-// eslint.config.js
-import { eslint } from "@open-xchange/linter-presets"
-
-export default [
-  ...eslint.configure({ /* ... */ }),
-  ...eslint.env.codecept({
-    files: ["e2e/**/*.{js,ts}"],
-    rules: { /* ... */ },
-  }),
-]
-```
-
-### Environment `env.plugin`
-
-Creates configuration objects with linter rules for implementing custom ESlint plugins. Adds the plugin [eslint-plugin-eslint-plugin](https://github.com/eslint-community/eslint-plugin-eslint-plugin) and its recommended rules.
-
-#### `env.plugin` Signature
-
-`function plugin(options: EnvPluginOptions): Linter.FlatConfig[]`
-
-#### `env.plugin` Options
-
-| Name | Type | Default | Description |
-| - | - | - | - |
-| `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
-| `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
-| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
-
-#### `env.plugin` Example
-
-```js
-// eslint.config.js
-import { eslint } from "@open-xchange/linter-presets"
-
-export default [
-  ...eslint.configure({ /* ... */ }),
-  ...eslint.env.plugin({
-    files: ["rules/**/*.{js,ts}"],
-    rules: { /* ... */ },
-  }),
-]
-```

package/doc/stylelint.md

@@ -1,3 +0,0 @@
-# StyleLint Presets
-
-The module `stylelint` provides a `configure` function for project-wide StyleLint configuration.

package/lib/eslint/env/plugin.d.ts

@@ -1,13 +0,0 @@
-
-import { FlatConfigArray, EnvBaseOptions } from "../shared/types.js";
-
-// types ======================================================================
-
-/**
- * Configuration options for the environment preset "env.plugin".
- */
-export interface EnvPluginOptions extends EnvBaseOptions { }
-
-// functions ==================================================================
-
-export default function plugin(options: EnvPluginOptions): FlatConfigArray;