@sarj/eslint-plugin 16.38.54 → 16.39.0

package/dist/rule-examples.cjs

@@ -201,7 +201,7 @@ async function verifyRuleExamples(rule, setup = {}) {
           plugins: { "@sarj": { rules: { [spec.ruleId]: rule } } },
           rules: { [ruleId]: ["error", ...example.ruleOptions ?? rule.defaultOptions ?? []] }
         };
-        await verifyExample(new import_eslint.Linter({ cwd: root }), config, example, root, ruleId);
+        await verifyExample(new import_eslint.Linter({ cwd: root }), config, example, root, ruleId, setup.formatFixedSource);
       } finally {
         parser2.clearCaches();
         await (0, import_promises.rm)(root, { recursive: true, force: true });
@@ -225,7 +225,7 @@ function validateFixtureSyntax(exampleId, file, path) {
     throw new Error(`${exampleId}: invalid fixture ${file.path}`, { cause: error });
   }
 }
-async function verifyExample(linter, config, example, root, ruleId) {
+async function verifyExample(linter, config, example, root, ruleId, formatFixedSource) {
   const focus = example.files.find((file) => file.path === example.focusPath);
   if (focus === void 0) throw new Error(`${example.id}: focus file is missing`);
   const filename = fixturePath(root, focus.path);
@@ -257,12 +257,15 @@ async function verifyExample(linter, config, example, root, ruleId) {
     if (input === void 0) throw new Error(`${example.id}: fixed file has no original`);
     const options = { filename: fixturePath(root, input.path) };
     const fixed = linter.verifyAndFix(input.source, config, options);
-    if (fixed.output !== expected.source) throw new Error(`${example.id}: unexpected fixed source`);
+    if (formatFixedSource === void 0 && fixed.output !== expected.source) throw new Error(`${example.id}: unexpected fixed source`);
     await (0, import_promises.writeFile)(options.filename, fixed.output);
     const repeated = linter.verifyAndFix(fixed.output, config, options);
     if (repeated.fixed || repeated.output !== fixed.output || repeated.messages.length > 0) {
       throw new Error(`${example.id}: fix is not clean and idempotent`);
     }
+    if (formatFixedSource !== void 0 && await formatFixedSource({ path: input.path, source: fixed.output }, example) !== expected.source) {
+      throw new Error(`${example.id}: unexpected fixed source`);
+    }
   }
 }
 function verifyExpectedDiagnostics(example, messages, source, lines) {

package/dist/rule-examples.d.cts

@@ -1,9 +1,13 @@
+import { E as ExampleFile, R as RuleExample } from './_docs-_eXGTNOq.cjs';
 import { DocumentedRule } from './index.cjs';
 import '@typescript-eslint/utils';
 
+type FixedSourceFormatter = (file: ExampleFile, example: RuleExample) => string | Promise<string>;
 /** Execute all authored examples, including private regressions, in isolated projects. */
 declare function verifyRuleExamples<Options extends readonly unknown[], MessageIds extends string>(rule: DocumentedRule<Options, MessageIds>, setup?: {
     readonly installedDependencyRoot?: string;
+    readonly formatFixedSource?: FixedSourceFormatter;
 }): Promise<number>;
 
-export { verifyRuleExamples };
+export { ExampleFile, RuleExample, verifyRuleExamples };
+export type { FixedSourceFormatter };

package/dist/rule-examples.d.ts

@@ -1,9 +1,13 @@
+import { E as ExampleFile, R as RuleExample } from './_docs-_eXGTNOq.js';
 import { DocumentedRule } from './index.js';
 import '@typescript-eslint/utils';
 
+type FixedSourceFormatter = (file: ExampleFile, example: RuleExample) => string | Promise<string>;
 /** Execute all authored examples, including private regressions, in isolated projects. */
 declare function verifyRuleExamples<Options extends readonly unknown[], MessageIds extends string>(rule: DocumentedRule<Options, MessageIds>, setup?: {
     readonly installedDependencyRoot?: string;
+    readonly formatFixedSource?: FixedSourceFormatter;
 }): Promise<number>;
 
-export { verifyRuleExamples };
+export { ExampleFile, RuleExample, verifyRuleExamples };
+export type { FixedSourceFormatter };

package/dist/rule-examples.js

@@ -167,7 +167,7 @@ async function verifyRuleExamples(rule, setup = {}) {
           plugins: { "@sarj": { rules: { [spec.ruleId]: rule } } },
           rules: { [ruleId]: ["error", ...example.ruleOptions ?? rule.defaultOptions ?? []] }
         };
-        await verifyExample(new Linter({ cwd: root }), config, example, root, ruleId);
+        await verifyExample(new Linter({ cwd: root }), config, example, root, ruleId, setup.formatFixedSource);
       } finally {
         parser2.clearCaches();
         await rm(root, { recursive: true, force: true });
@@ -191,7 +191,7 @@ function validateFixtureSyntax(exampleId, file, path) {
     throw new Error(`${exampleId}: invalid fixture ${file.path}`, { cause: error });
   }
 }
-async function verifyExample(linter, config, example, root, ruleId) {
+async function verifyExample(linter, config, example, root, ruleId, formatFixedSource) {
   const focus = example.files.find((file) => file.path === example.focusPath);
   if (focus === void 0) throw new Error(`${example.id}: focus file is missing`);
   const filename = fixturePath(root, focus.path);
@@ -223,12 +223,15 @@ async function verifyExample(linter, config, example, root, ruleId) {
     if (input === void 0) throw new Error(`${example.id}: fixed file has no original`);
     const options = { filename: fixturePath(root, input.path) };
     const fixed = linter.verifyAndFix(input.source, config, options);
-    if (fixed.output !== expected.source) throw new Error(`${example.id}: unexpected fixed source`);
+    if (formatFixedSource === void 0 && fixed.output !== expected.source) throw new Error(`${example.id}: unexpected fixed source`);
     await writeFile(options.filename, fixed.output);
     const repeated = linter.verifyAndFix(fixed.output, config, options);
     if (repeated.fixed || repeated.output !== fixed.output || repeated.messages.length > 0) {
       throw new Error(`${example.id}: fix is not clean and idempotent`);
     }
+    if (formatFixedSource !== void 0 && await formatFixedSource({ path: input.path, source: fixed.output }, example) !== expected.source) {
+      throw new Error(`${example.id}: unexpected fixed source`);
+    }
   }
 }
 function verifyExpectedDiagnostics(example, messages, source, lines) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "16.38.54",
+  "version": "16.39.0",
   "packageManager": "npm@12.2.1",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",
@@ -88,6 +88,7 @@
     "eslint-plugin-zod": "^5.2.2",
     "globals": "17.13.0",
     "jiti": "2.7.0",
+    "prettier": "3.9.10",
     "tsup": "9.0.0",
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "typescript-eslint": "^8.72.0",