eslint-plugin-zod 4.1.0 → 4.2.0

package/README.md

@@ -42,6 +42,7 @@ Find out more about [Oxlint's `jsPLugins`](https://oxc.rs/docs/guide/usage/linte
 | [consistent-schema-var-name](docs/rules/consistent-schema-var-name.md)                           | Enforce a consistent naming convention for Zod schema variables                                                                | ✅  |     |     |     |
 | [no-any-schema](docs/rules/no-any-schema.md)                                                     | Disallow usage of `z.any()` in Zod schemas                                                                                     | ✅  |     | 💡  |     |
 | [no-empty-custom-schema](docs/rules/no-empty-custom-schema.md)                                   | Disallow usage of `z.custom()` without arguments                                                                               | ✅  |     |     |     |
+| [no-native-enum](docs/rules/no-native-enum.md)                                                   | Disallow deprecated `z.nativeEnum()` in favor of `z.enum()`.                                                                   | ✅  | 🔧  |     |     |
 | [no-number-schema-with-finite](docs/rules/no-number-schema-with-finite.md)                       | Disallow deprecated `z.number().finite()`. In Zod 4+ number schemas do not allow infinite values by default, so it is a no-op. | ✅  | 🔧  |     |     |
 | [no-number-schema-with-int](docs/rules/no-number-schema-with-int.md)                             | Disallow usage of `z.number().int()` as it is considered legacy                                                                | ✅  | 🔧  |     |     |
 | [no-number-schema-with-is-finite](docs/rules/no-number-schema-with-is-finite.md)                 | Disallow using deprecated `isFinite` on a Zod number schema; in v4+ it is always `true`.                                       | ✅  |     |     |     |

package/dist/index.cjs

@@ -7,6 +7,7 @@ const require_consistent_schema_output_type_style = require("./rules/consistent-
 const require_consistent_schema_var_name = require("./rules/consistent-schema-var-name.cjs");
 const require_no_any_schema = require("./rules/no-any-schema.cjs");
 const require_no_empty_custom_schema = require("./rules/no-empty-custom-schema.cjs");
+const require_no_native_enum = require("./rules/no-native-enum.cjs");
 const require_no_number_schema_with_finite = require("./rules/no-number-schema-with-finite.cjs");
 const require_no_number_schema_with_int = require("./rules/no-number-schema-with-int.cjs");
 const require_no_number_schema_with_is_finite = require("./rules/no-number-schema-with-is-finite.cjs");
@@ -42,6 +43,7 @@ const eslintPluginZod = {
 		"consistent-schema-output-type-style": require_consistent_schema_output_type_style.consistentSchemaOutputTypeStyle,
 		"no-any-schema": require_no_any_schema.noAnySchema,
 		"no-empty-custom-schema": require_no_empty_custom_schema.noEmptyCustomSchema,
+		"no-native-enum": require_no_native_enum.noNativeEnum,
 		"no-number-schema-with-finite": require_no_number_schema_with_finite.noNumberSchemaWithFinite,
 		"no-number-schema-with-int": require_no_number_schema_with_int.noNumberSchemaWithInt,
 		"no-number-schema-with-is-finite": require_no_number_schema_with_is_finite.noNumberSchemaWithIsFinite,
@@ -74,6 +76,7 @@ const recommendedConfig = {
 		"zod/consistent-schema-var-name": "error",
 		"zod/no-any-schema": "error",
 		"zod/no-empty-custom-schema": "error",
+		"zod/no-native-enum": "error",
 		"zod/no-number-schema-with-finite": "error",
 		"zod/no-number-schema-with-int": "error",
 		"zod/no-number-schema-with-is-finite": "error",

package/dist/index.mjs

@@ -7,6 +7,7 @@ import { consistentSchemaOutputTypeStyle } from "./rules/consistent-schema-outpu
 import { consistentSchemaVarName } from "./rules/consistent-schema-var-name.mjs";
 import { noAnySchema } from "./rules/no-any-schema.mjs";
 import { noEmptyCustomSchema } from "./rules/no-empty-custom-schema.mjs";
+import { noNativeEnum } from "./rules/no-native-enum.mjs";
 import { noNumberSchemaWithFinite } from "./rules/no-number-schema-with-finite.mjs";
 import { noNumberSchemaWithInt } from "./rules/no-number-schema-with-int.mjs";
 import { noNumberSchemaWithIsFinite } from "./rules/no-number-schema-with-is-finite.mjs";
@@ -42,6 +43,7 @@ const eslintPluginZod = {
 		"consistent-schema-output-type-style": consistentSchemaOutputTypeStyle,
 		"no-any-schema": noAnySchema,
 		"no-empty-custom-schema": noEmptyCustomSchema,
+		"no-native-enum": noNativeEnum,
 		"no-number-schema-with-finite": noNumberSchemaWithFinite,
 		"no-number-schema-with-int": noNumberSchemaWithInt,
 		"no-number-schema-with-is-finite": noNumberSchemaWithIsFinite,
@@ -74,6 +76,7 @@ const recommendedConfig = {
 		"zod/consistent-schema-var-name": "error",
 		"zod/no-any-schema": "error",
 		"zod/no-empty-custom-schema": "error",
+		"zod/no-native-enum": "error",
 		"zod/no-number-schema-with-finite": "error",
 		"zod/no-number-schema-with-int": "error",
 		"zod/no-number-schema-with-is-finite": "error",

package/dist/rules/no-native-enum.cjs

@@ -0,0 +1,46 @@
+require("../_virtual/_rolldown/runtime.cjs");
+const require_create_plugin_rule = require("../utils/create-plugin-rule.cjs");
+let _eslint_zod_utils = require("@eslint-zod/utils");
+let _typescript_eslint_utils = require("@typescript-eslint/utils");
+//#region src/rules/no-native-enum.ts
+const { trackZodSchemaImports } = (0, _eslint_zod_utils.createZodSchemaImportTrack)(_eslint_zod_utils.zodImportScope);
+const noNativeEnum = require_create_plugin_rule.createZodPluginRule({
+	name: "no-native-enum",
+	meta: {
+		type: "problem",
+		fixable: "code",
+		docs: { description: "Disallow deprecated `z.nativeEnum()` in favor of `z.enum()`." },
+		messages: { useEnum: "`z.nativeEnum()` is deprecated in Zod 4. Use `z.enum()` instead." },
+		schema: []
+	},
+	defaultOptions: [],
+	create(context) {
+		const { importDeclarationListener, detectZodSchemaRootNode, collectZodChainMethods, getNamedImportOriginal } = trackZodSchemaImports();
+		return {
+			ImportDeclaration: importDeclarationListener,
+			CallExpression(node) {
+				const zodSchema = detectZodSchemaRootNode(node);
+				const rootMethod = (zodSchema ? collectZodChainMethods(zodSchema.node) : void 0)?.[0];
+				const isNativeEnumRoot = zodSchema?.schemaDecl === "namespace" ? rootMethod?.name === "nativeEnum" : getNamedImportOriginal(rootMethod?.name ?? "") === "nativeEnum";
+				if (!zodSchema || !isNativeEnumRoot) return;
+				if (zodSchema.schemaDecl === "named") {
+					context.report({
+						node,
+						messageId: "useEnum"
+					});
+					return;
+				}
+				context.report({
+					node,
+					messageId: "useEnum",
+					fix(fixer) {
+						if (rootMethod?.node.callee.type !== _typescript_eslint_utils.AST_NODE_TYPES.MemberExpression || rootMethod.node.callee.property.type !== _typescript_eslint_utils.AST_NODE_TYPES.Identifier) return null;
+						return fixer.replaceText(rootMethod.node.callee.property, "enum");
+					}
+				});
+			}
+		};
+	}
+});
+//#endregion
+exports.noNativeEnum = noNativeEnum;

package/dist/rules/no-native-enum.mjs

@@ -0,0 +1,45 @@
+import { createZodPluginRule } from "../utils/create-plugin-rule.mjs";
+import { createZodSchemaImportTrack, zodImportScope } from "@eslint-zod/utils";
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+//#region src/rules/no-native-enum.ts
+const { trackZodSchemaImports } = createZodSchemaImportTrack(zodImportScope);
+const noNativeEnum = createZodPluginRule({
+	name: "no-native-enum",
+	meta: {
+		type: "problem",
+		fixable: "code",
+		docs: { description: "Disallow deprecated `z.nativeEnum()` in favor of `z.enum()`." },
+		messages: { useEnum: "`z.nativeEnum()` is deprecated in Zod 4. Use `z.enum()` instead." },
+		schema: []
+	},
+	defaultOptions: [],
+	create(context) {
+		const { importDeclarationListener, detectZodSchemaRootNode, collectZodChainMethods, getNamedImportOriginal } = trackZodSchemaImports();
+		return {
+			ImportDeclaration: importDeclarationListener,
+			CallExpression(node) {
+				const zodSchema = detectZodSchemaRootNode(node);
+				const rootMethod = (zodSchema ? collectZodChainMethods(zodSchema.node) : void 0)?.[0];
+				const isNativeEnumRoot = zodSchema?.schemaDecl === "namespace" ? rootMethod?.name === "nativeEnum" : getNamedImportOriginal(rootMethod?.name ?? "") === "nativeEnum";
+				if (!zodSchema || !isNativeEnumRoot) return;
+				if (zodSchema.schemaDecl === "named") {
+					context.report({
+						node,
+						messageId: "useEnum"
+					});
+					return;
+				}
+				context.report({
+					node,
+					messageId: "useEnum",
+					fix(fixer) {
+						if (rootMethod?.node.callee.type !== AST_NODE_TYPES.MemberExpression || rootMethod.node.callee.property.type !== AST_NODE_TYPES.Identifier) return null;
+						return fixer.replaceText(rootMethod.node.callee.property, "enum");
+					}
+				});
+			}
+		};
+	}
+});
+//#endregion
+export { noNativeEnum };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-zod",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "type": "module",
   "description": "ESLint plugin that adds custom linting rules to enforce best practices when using Zod",
   "engines": {