@sarj/eslint-plugin 16.4.3 → 16.4.5

package/dist/rule-examples.cjs

@@ -38,7 +38,7 @@ var import_node_os = require("os");
 var import_node_path = require("path");
 var parser = __toESM(require("@typescript-eslint/parser"), 1);
 var import_eslint = require("eslint");
-async function verifyRuleExamples(rule) {
+async function verifyRuleExamples(rule, setup = {}) {
   const spec = rule.documentation;
   if (spec === void 0 || !spec.publicExamples.some((item) => item.outcome === "match") || !spec.publicExamples.some((item) => item.outcome === "no-match")) {
     throw new Error("rule requires documented public matching and non-matching examples");
@@ -51,6 +51,15 @@ async function verifyRuleExamples(rule) {
         await (0, import_promises.mkdir)((0, import_node_path.dirname)(path), { recursive: true });
         await (0, import_promises.writeFile)(path, file.source);
       }
+      for (const dependency of example.installedDependencies ?? []) {
+        if (setup.installedDependencyRoot === void 0) throw new Error(`${example.id}: explicit installed dependency root is required`);
+        const packageFile = fixturePath((0, import_node_path.resolve)(setup.installedDependencyRoot), `node_modules/${dependency.module}/package.json`);
+        const metadata = JSON.parse(await (0, import_promises.readFile)(packageFile, "utf8"));
+        if (typeof metadata !== "object" || metadata === null || !("name" in metadata) || !("version" in metadata) || metadata.name !== dependency.module || metadata.version !== dependency.version) throw new Error(`${example.id}: installed dependency identity/version mismatch for ${dependency.module}`);
+        const destination = fixturePath(root, `node_modules/${dependency.module}`);
+        await (0, import_promises.mkdir)((0, import_node_path.dirname)(destination), { recursive: true });
+        await (0, import_promises.symlink)((0, import_node_path.dirname)(packageFile), destination, process.platform === "win32" ? "junction" : "dir");
+      }
       const tsconfig = (0, import_node_path.join)(root, "tsconfig.json");
       if (!example.files.some((file) => file.path === "tsconfig.json")) {
         await (0, import_promises.writeFile)(tsconfig, JSON.stringify({ compilerOptions: {
@@ -68,10 +77,11 @@ async function verifyRuleExamples(rule) {
         files: ["**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"],
         languageOptions: { parser, parserOptions: { project: tsconfig, tsconfigRootDir: root } },
         plugins: { "@sarj": { rules: { [spec.ruleId]: rule } } },
-        rules: { [ruleId]: ["error", ...rule.defaultOptions ?? []] }
+        rules: { [ruleId]: ["error", ...example.ruleOptions ?? rule.defaultOptions ?? []] }
       };
       await verifyExample(new import_eslint.Linter({ cwd: root }), config, example, root, ruleId);
     } finally {
+      parser.clearCaches();
       await (0, import_promises.rm)(root, { recursive: true, force: true });
     }
   }

package/dist/rule-examples.d.cts

@@ -1,7 +1,9 @@
-import { D as DocumentedRule } from './_docs-XCw_6XV9.cjs';
+import { D as DocumentedRule } from './_docs-B9LZ5Out.cjs';
 import '@typescript-eslint/utils';
 
 /** Execute all authored examples, including private regressions, in isolated projects. */
-declare function verifyRuleExamples<Options extends readonly unknown[], MessageIds extends string>(rule: DocumentedRule<Options, MessageIds>): Promise<number>;
+declare function verifyRuleExamples<Options extends readonly unknown[], MessageIds extends string>(rule: DocumentedRule<Options, MessageIds>, setup?: {
+    readonly installedDependencyRoot?: string;
+}): Promise<number>;
 
 export { verifyRuleExamples };

package/dist/rule-examples.d.ts

@@ -1,7 +1,9 @@
-import { D as DocumentedRule } from './_docs-XCw_6XV9.js';
+import { D as DocumentedRule } from './_docs-B9LZ5Out.js';
 import '@typescript-eslint/utils';
 
 /** Execute all authored examples, including private regressions, in isolated projects. */
-declare function verifyRuleExamples<Options extends readonly unknown[], MessageIds extends string>(rule: DocumentedRule<Options, MessageIds>): Promise<number>;
+declare function verifyRuleExamples<Options extends readonly unknown[], MessageIds extends string>(rule: DocumentedRule<Options, MessageIds>, setup?: {
+    readonly installedDependencyRoot?: string;
+}): Promise<number>;
 
 export { verifyRuleExamples };

package/dist/rule-examples.js

@@ -1,10 +1,10 @@
 // src/verify-rule-examples.ts
-import { mkdtemp, mkdir, rm, writeFile } from "fs/promises";
+import { mkdtemp, mkdir, rm, writeFile, readFile, symlink } from "fs/promises";
 import { tmpdir } from "os";
 import { dirname, join, resolve, sep } from "path";
 import * as parser from "@typescript-eslint/parser";
 import { Linter } from "eslint";
-async function verifyRuleExamples(rule) {
+async function verifyRuleExamples(rule, setup = {}) {
   const spec = rule.documentation;
   if (spec === void 0 || !spec.publicExamples.some((item) => item.outcome === "match") || !spec.publicExamples.some((item) => item.outcome === "no-match")) {
     throw new Error("rule requires documented public matching and non-matching examples");
@@ -17,6 +17,15 @@ async function verifyRuleExamples(rule) {
         await mkdir(dirname(path), { recursive: true });
         await writeFile(path, file.source);
       }
+      for (const dependency of example.installedDependencies ?? []) {
+        if (setup.installedDependencyRoot === void 0) throw new Error(`${example.id}: explicit installed dependency root is required`);
+        const packageFile = fixturePath(resolve(setup.installedDependencyRoot), `node_modules/${dependency.module}/package.json`);
+        const metadata = JSON.parse(await readFile(packageFile, "utf8"));
+        if (typeof metadata !== "object" || metadata === null || !("name" in metadata) || !("version" in metadata) || metadata.name !== dependency.module || metadata.version !== dependency.version) throw new Error(`${example.id}: installed dependency identity/version mismatch for ${dependency.module}`);
+        const destination = fixturePath(root, `node_modules/${dependency.module}`);
+        await mkdir(dirname(destination), { recursive: true });
+        await symlink(dirname(packageFile), destination, process.platform === "win32" ? "junction" : "dir");
+      }
       const tsconfig = join(root, "tsconfig.json");
       if (!example.files.some((file) => file.path === "tsconfig.json")) {
         await writeFile(tsconfig, JSON.stringify({ compilerOptions: {
@@ -34,10 +43,11 @@ async function verifyRuleExamples(rule) {
         files: ["**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"],
         languageOptions: { parser, parserOptions: { project: tsconfig, tsconfigRootDir: root } },
         plugins: { "@sarj": { rules: { [spec.ruleId]: rule } } },
-        rules: { [ruleId]: ["error", ...rule.defaultOptions ?? []] }
+        rules: { [ruleId]: ["error", ...example.ruleOptions ?? rule.defaultOptions ?? []] }
       };
       await verifyExample(new Linter({ cwd: root }), config, example, root, ruleId);
     } finally {
+      parser.clearCaches();
       await rm(root, { recursive: true, force: true });
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "16.4.3",
+  "version": "16.4.5",
   "packageManager": "npm@12.1.0",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",
@@ -35,7 +35,7 @@
   "scripts": {
     "build": "tsup",
     "dogfood": "npm run build && npm run dogfood:built",
-    "lint": "eslint . ../../.github/scripts --max-warnings 0",
+    "lint": "eslint . ../../.github/scripts ../standards/src ../standards/eslint.config.mjs --max-warnings 0",
     "prepack": "npm run build && npm run verify-package",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",