@blumintinc/eslint-plugin-blumint 1.20.131 → 1.20.132

package/lib/index.js

@@ -223,7 +223,7 @@ function noFrontendImportsFromFunctionsPatterns(pattern) {
 module.exports = {
     meta: {
         name: '@blumintinc/eslint-plugin-blumint',
-        version: '1.20.131',
+        version: '1.20.132',
     },
     parseOptions: {
         ecmaVersion: 2020,

package/lib/rules/prefer-type-over-interface.d.ts

@@ -1,2 +1,4 @@
 import { TSESLint } from '@typescript-eslint/utils';
-export declare const preferTypeOverInterface: TSESLint.RuleModule<'preferType', never[]>;
+type MessageIds = 'preferType' | 'preferTypeDefaultExport';
+export declare const preferTypeOverInterface: TSESLint.RuleModule<MessageIds, never[]>;
+export {};

package/lib/rules/prefer-type-over-interface.js

@@ -47,6 +47,21 @@ function isInsideModuleAugmentation(node) {
     }
     return false;
 }
+/**
+ * `export default interface X {…}` is the only spelling TypeScript has for a
+ * default-exported type: `export default type X = …` is a syntax error in every
+ * form, so the keyword swap has no landing site. It lands there anyway because
+ * the `TSInterfaceDeclaration`'s range starts at `interface` while
+ * `export default` belongs to the parent node, which made `eslint --fix` write
+ * a file that no longer parses (#1850).
+ *
+ * The conversion is still available to the author, as a two-statement
+ * restructure a keyword swap cannot express, so the report stands and carries
+ * that remedy instead of a fix.
+ */
+function isDefaultExported(node) {
+    return node.parent?.type === utils_1.AST_NODE_TYPES.ExportDefaultDeclaration;
+}
 /**
  * Declaration merging is what `interface` can do and `type` cannot, so a name
  * carrying more than one declaration is not a stylistic choice: rewriting one
@@ -92,6 +107,10 @@ exports.preferTypeOverInterface = (0, createRule_1.createRule)({
             preferType: 'Interface "{{interfaceName}}" should be declared as a type alias. ' +
                 'Interfaces can merge across declarations and extend in chains, which fragments the resulting shape across files and makes composition harder to predict and trace. ' +
                 'Replace `interface` with `type` and use intersections (for example, `type {{interfaceName}} = Base & { field: string }`) to keep the contract closed and predictable.',
+            preferTypeDefaultExport: 'Interface "{{interfaceName}}" should be declared as a type alias, but a default-exported interface has no in-place conversion, so no autofix is offered here. ' +
+                'Interfaces can merge across declarations and extend in chains, which fragments the resulting shape across files and makes composition harder to predict and trace. ' +
+                'TypeScript has no default-exported type alias — `export default type {{interfaceName}} = ...` is a syntax error — so the conversion takes two statements: `type {{interfaceName}} = { field: string };` followed by `export type { {{interfaceName}} as default };`, which keeps every existing `import {{interfaceName}} from ...` working. ' +
+                'A named `export type {{interfaceName}} = ...` works too, once the import sites are switched to `import type { {{interfaceName}} }`.',
         },
         fixable: 'code',
     },
@@ -108,6 +127,22 @@ exports.preferTypeOverInterface = (0, createRule_1.createRule)({
                 if (isMergedDeclaration(context, node)) {
                     return;
                 }
+                // Withholding the fix rather than emitting a broken one: every rewrite
+                // below assumes the `interface` keyword can become `type` where it
+                // stands, and under `export default` that position accepts no
+                // declaration at all. The report is kept because the author *can* act
+                // on it — unlike a merge, the shape converts by hand — and the remedy
+                // travels in the message.
+                if (isDefaultExported(node)) {
+                    context.report({
+                        node,
+                        messageId: 'preferTypeDefaultExport',
+                        data: {
+                            interfaceName: node.id.name,
+                        },
+                    });
+                    return;
+                }
                 context.report({
                     node,
                     messageId: 'preferType',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blumintinc/eslint-plugin-blumint",
-  "version": "1.20.131",
+  "version": "1.20.132",
   "description": "Custom eslint rules for use within BluMint",
   "author": {
     "name": "Brodie McGuire",

package/release-manifest.json

@@ -1,4 +1,18 @@
 [
+  {
+    "version": "1.20.132",
+    "date": "2026-08-07T12:26:09.881Z",
+    "rules": [
+      {
+        "name": "prefer-type-over-interface",
+        "changeType": "fix",
+        "issues": [
+          1850
+        ],
+        "summary": "decline the fix for a default-exported interface (closes #1850)"
+      }
+    ]
+  },
   {
     "version": "1.20.131",
     "date": "2026-08-07T10:28:22.079Z",