@open-xchange/linter-presets 1.2.9 → 1.2.10

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## `1.2.10` – 2025-Feb-14
+
+- fix: (ESLint) missing `env/tsconfig.*` in package
+
 ## `1.2.9` – 2025-Feb-14
 
 - chore: (ESLint) add plugin `eslint-plugin-jest-extended` to `env.jest` and `env.vitest`

package/dist/eslint/env/tsconfig.d.ts

@@ -0,0 +1,21 @@
+import type { Linter } from "eslint";
+import type { EnvBaseOptions } from "../shared/env-utils.js";
+/**
+ * Configuration options for the environment preset "env.tsconfig".
+ */
+export interface EnvTSConfigOptions extends EnvBaseOptions {
+    /**
+     * The path to the TypeScript project configuration file (`tsconfig.json`).
+     */
+    project: string;
+}
+/**
+ * Creates configuration objects for TypeScript projects.
+ *
+ * @param envOptions
+ *  Configuration options for the environment.
+ *
+ * @returns
+ *  An array of configuration objects to be added to the flat configuration.
+ */
+export default function tsconfig(envOptions: EnvTSConfigOptions): Linter.Config[];

package/dist/eslint/env/tsconfig.js

@@ -0,0 +1,25 @@
+import { concatConfigs, createConfig, customRules } from "../shared/env-utils.js";
+// functions ==================================================================
+/**
+ * Creates configuration objects for TypeScript projects.
+ *
+ * @param envOptions
+ *  Configuration options for the environment.
+ *
+ * @returns
+ *  An array of configuration objects to be added to the flat configuration.
+ */
+export default function tsconfig(envOptions) {
+    return concatConfigs(
+    // path to project configuration file
+    createConfig(envOptions, {
+        languageOptions: {
+            parserOptions: {
+                projectService: false,
+                project: envOptions.project,
+            },
+        },
+    }), 
+    // custom rules
+    customRules(envOptions));
+}

package/doc/eslint/env/tsconfig.md

@@ -0,0 +1,36 @@
+# Environment `env.tsconfig`
+
+Creates configuration objects for TypeScript projects (registers a `tsconfig.json` file in the project).
+
+Usually, this environment preset should not be necessary, as the new [project service](https://typescript-eslint.io/blog/announcing-typescript-eslint-v8#project-service) of `typescript-eslint` is enabled by default. However, the ESLint plugin of VSCode sometimes fails to lint files in certain subdirectories and complains about the project service not covering the file to be linted. In these cases, manually setting up this environment preset will help.
+
+## Signature
+
+```ts
+function tsconfig(options: EnvTSConfigOptions): Linter.Config[]
+```
+
+## 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 absolute path to the TypeScript project configuration file (`tsconfig.json`). |
+| `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
+
+## 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"),
+  }),
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-xchange/linter-presets",
-  "version": "1.2.9",
+  "version": "1.2.10",
   "description": "Configuration presets for ESLint and StyleLint",
   "repository": {
     "type": "git",