@unotest/eslint-plugin 0.18.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# @unotest/eslint-plugin
+
+## [0.18.0] - 2026-08-23
+
+### Minor Changes
+
+- a088bac: New package `@unotest/eslint-plugin` — unotest DSL scenarios as
+  first-class ESLint citizens. One rule (`@unotest/dsl`) delegates every
+  check to the validator inside the installed `@unotest/web` (parser,
+  vocabulary, linter rules, `linter.rules` severities from
+  unotest.config), so `npx eslint unotest/e2e` and `unotest-web lint`
+  report identical diagnostics; a new validator rule needs zero plugin
+  changes. `configs.recommended()` (async factory, flat config) wires
+  `unotest/e2e/**/*.js`, turns `no-undef` off (implicit globals are the
+  DSL's design; unknown names are the engine's job) and declares globals
+  for the vocabulary, your helpers and your `.env`/`.secrets` variable
+  names.
+
+  `@unotest/web`: the `@unotest/web/dsl` subpath now exports
+  `loadLintProjectContext()` (config severities + helper discovery +
+  variable names) and `linterRulesToSeverity()` — the same loader the CLI
+  `lint` command now uses, so the two frontends cannot drift.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ivan Volkov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @unotest/eslint-plugin
+
+ESLint plugin for [unotest web](https://docs.unotest.com) DSL scenarios.
+
+One rule — `@unotest/dsl` — runs your scenarios through the exact same
+validator as `unotest-web lint` and the viewer's live editor: parser,
+vocabulary checks, linter rules, and the severity overrides from your
+`unotest.config.mjs`. ESLint and the CLI can never disagree, and a new
+validator rule needs zero plugin updates.
+
+## Setup
+
+```sh
+npm install --save-dev eslint @unotest/eslint-plugin
+```
+
+`@unotest/web` must be installed in the project (it usually already is —
+the plugin delegates all checking to it).
+
+```js
+// eslint.config.mjs
+import unotest from "@unotest/eslint-plugin";
+
+export default [...(await unotest.configs.recommended())];
+```
+
+The factory is async because it loads your `unotest.config.{js,mjs,ts}`
+(severity overrides), discovers helper names from `unotest/e2e/_helpers/`
+and your variable names from `unotest/.env` / `.secrets` (names only —
+values are never read into the config).
+
+Then:
+
+```sh
+npx eslint unotest/e2e
+```
+
+## What `recommended` wires
+
+- `files: ["unotest/e2e/**/*.js"]` — scenarios and helpers only.
+- `@unotest/dsl: "error"` — every engine diagnostic is reported at its
+  line/column; the engine's own rule id and severity ride in the message
+  (`[warning lint:pause-explicit] …`), since an ESLint rule has a single
+  configured severity.
+- `no-undef: "off"` — in-scenario bindings are implicit globals by
+  design; unknown names are the engine's `unknown-function` job.
+- Globals for the DSL vocabulary, your helpers and your `UPPER_SNAKE`
+  variables, so other plugins' rules don't trip on them.
+
+## Severity
+
+Rule severities come from `linter.rules` in `unotest.config.mjs` — the
+same source the CLI uses. `"off"` there removes the diagnostic entirely;
+there is nothing to configure on the ESLint side.
+
+## License
+
+MIT © Ivan Volkov

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import * as eslint from 'eslint';
+import { Rule, Linter } from 'eslint';
+
+declare const dslRule: Rule.RuleModule;
+
+interface RecommendedOptions {
+    /** Project root holding unotest.config.* and unotest/ (default cwd). */
+    cwd?: string;
+}
+declare const basePlugin: {
+    meta: {
+        name: string;
+    };
+    rules: {
+        dsl: eslint.Rule.RuleModule;
+    };
+};
+declare const plugin: typeof basePlugin & {
+    configs: {
+        recommended: typeof recommended;
+    };
+};
+declare function recommended(opts?: RecommendedOptions): Promise<Linter.Config[]>;
+
+export { type RecommendedOptions, plugin as default, dslRule };

package/dist/index.js

@@ -0,0 +1,114 @@
+// src/index.ts
+import { createWebDslLanguageService as createWebDslLanguageService2, loadLintProjectContext } from "@unotest/web/dsl";
+
+// src/rules/dsl.ts
+import {
+  createWebDslLanguageService,
+  linterRulesToSeverity
+} from "@unotest/web/dsl";
+var dslRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Validate a unotest DSL scenario with the same engine as `unotest-web lint`"
+    },
+    schema: [
+      {
+        type: "object",
+        properties: {
+          linterRules: {
+            type: "object",
+            additionalProperties: { type: "string" }
+          },
+          helperNames: {
+            type: "array",
+            items: { type: "string" }
+          }
+        },
+        additionalProperties: false
+      }
+    ]
+  },
+  create(context) {
+    const opts = context.options[0] ?? {};
+    const service = createWebDslLanguageService(
+      opts.linterRules ? linterRulesToSeverity(opts.linterRules) : void 0
+    );
+    const diagnostics = service.validate(context.sourceCode.text, {
+      helperNames: opts.helperNames
+    });
+    return {
+      Program() {
+        for (const d of diagnostics) {
+          context.report({
+            // The DSL severity (error/warning/info) cannot vary per report
+            // in ESLint — it rides in the message; the rule id of the
+            // ENGINE rule too, since ESLint's own ruleId is always ours.
+            message: `[${d.severity} ${d.rule}] ${d.message}`,
+            loc: {
+              // DslDiagnostic is 1-based for both; ESLint loc columns are
+              // 0-based.
+              start: { line: d.line, column: d.column - 1 },
+              end: {
+                line: d.endLine ?? d.line,
+                column: (d.endColumn ?? d.column + 1) - 1
+              }
+            }
+          });
+        }
+      }
+    };
+  }
+};
+
+// src/index.ts
+var basePlugin = {
+  meta: {
+    name: "@unotest/eslint-plugin"
+  },
+  rules: {
+    dsl: dslRule
+  }
+};
+var plugin = {
+  ...basePlugin,
+  configs: {
+    recommended
+  }
+};
+async function recommended(opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const ctx = await loadLintProjectContext(cwd);
+  const vocabNames = createWebDslLanguageService2().getVocab().filter((e) => e.category !== "keyword" || e.name === "step").map((e) => e.name);
+  const globals = Object.fromEntries(
+    [...vocabNames, ...ctx.envVarNames, ...ctx.helpers.names].map((n) => [n, "readonly"])
+  );
+  return [
+    {
+      name: "@unotest/recommended",
+      files: ["unotest/e2e/**/*.js"],
+      plugins: { "@unotest": basePlugin },
+      languageOptions: {
+        ecmaVersion: 2022,
+        sourceType: "script",
+        globals
+      },
+      rules: {
+        "no-undef": "off",
+        "@unotest/dsl": [
+          "error",
+          {
+            linterRules: { ...ctx.linterRules },
+            helperNames: [...ctx.helpers.names]
+          }
+        ]
+      }
+    }
+  ];
+}
+var src_default = plugin;
+export {
+  src_default as default,
+  dslRule
+};
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@unotest/eslint-plugin",
+  "version": "0.18.0",
+  "description": "ESLint plugin for unotest web DSL scenarios: one `dsl` rule that runs the exact same validator as `unotest-web lint` (parser, vocabulary, linter rules, config severities) and reports its diagnostics through ESLint, plus a flat `recommended` config wired for unotest/e2e/**.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Ivan Volkov <ivan@volkov.io>",
+  "homepage": "https://www.npmjs.com/package/@unotest/eslint-plugin",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@unotest/web": ">=0.18.0",
+    "eslint": ">=9"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "eslint": "^9.15.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "@unotest/web": "^0.18.0"
+  }
+}