feat(filename): enhance default excepts patterns and improve validation

- Add default excepts patterns for common framework files:
  - Files starting with underscore (_app.tsx, _layout.tsx)
  - Numeric files (404.tsx)
  - Square bracket files ([slug].tsx)
- Improve validation logic to filter non-word/dash characters
- Update documentation with excepts option details
- Add comprehensive test cases for new exception patterns

This enhances the filename rule to be more framework-agnostic and
handles edge cases with special characters in filenames.

Author: Rel1cx

packages/plugins/eslint-plugin-react-naming-convention/src/rules/filename.md

@@ -69,6 +69,11 @@ src/components/example-component.tsx
   2. `camelCase`: camelCase
   3. `kebab-case`: kebab-case
   4. `snake_case`: snake_case
+- `excepts`: An array of regular expressions to ignore specific file names. Default is:
+  - `"/^index$/"`: Ignore `index` files.
+  - `"/^_/"`: Ignore files starting with an underscore (e.g., `_app.tsx`, `_layout.tsx`).
+  - `"/^[0-9]+$/"`: Ignore files with only numbers (e.g., `404.tsx`).
+  - `"/^\[[^\]]+\]$/"`: Ignore files with square brackets (e.g., `[slug].tsx`).
 
 ## Rule Options Examples
 
@@ -103,23 +108,36 @@ export default [
 export default [
   // ...
   {
-    files: ["src/**/*.{ts,tsx}"],
-    ignore: ["**/index.{ts,tsx}"],
+    files: ["src/components/**/*.{ts,tsx}"],
     rules: {
       "@eslint-react/naming-convention/filename": ["warn", "PascalCase"],
     },
   },
   {
-    files: ["src/pages/**/*.{ts,tsx}"],
-    ignore: ["**/index.{ts,tsx}"],
+    files: ["src/hooks/**/use*.{ts,tsx}"],
+    rules: {
+      "@eslint-react/naming-convention/filename": ["warn", "camelCase"],
+    },
+  },
+];
+```
+
+### Opting out of the rule for framework-specific files
+
+```js title="eslint.config.js"
+// ...
+export default [
+  // ...
+  {
+    files: ["**/*.{ts,tsx}"],
     rules: {
       "@eslint-react/naming-convention/filename": ["warn", "kebab-case"],
     },
   },
   {
-    files: ["src/hooks/**/use*.{ts,tsx}"],
+    files: ["app/**/*.{ts,tsx}"], // Opting out of the rule for framework-specific files
     rules: {
-      "@eslint-react/naming-convention/filename": ["warn", "camelCase"],
+      "@eslint-react/naming-convention/filename": "off",
     },
   },
 ];

packages/plugins/eslint-plugin-react-naming-convention/src/rules/filename.spec.ts

@@ -151,5 +151,25 @@ ruleTester.run(RULE_NAME, rule, {
       filename: "snake_case.tsx",
       options: [{ rule: "snake_case" }],
     },
+    {
+      code,
+      filename: "404.tsx",
+      options: [{ rule: "PascalCase" }],
+    },
+    {
+      code,
+      filename: "$.tsx",
+      options: [{ rule: "PascalCase" }],
+    },
+    {
+      code,
+      filename: "_app.tsx",
+      options: [{ rule: "PascalCase" }],
+    },
+    {
+      code,
+      filename: "[slug].tsx",
+      options: [{ rule: "PascalCase" }],
+    },
   ],
 });

packages/plugins/eslint-plugin-react-naming-convention/src/rules/filename.ts

@@ -32,7 +32,12 @@ type Options = readonly [
 
 const defaultOptions = [
   {
-    excepts: ["^index$"],
+    excepts: [
+      "/^_/",
+      "/^index$/",
+      "/^[0-9]+$/",
+      "/^\\[[^\\]]+\\]$/",
+    ],
     rule: "PascalCase",
   },
 ] as const satisfies Options;
@@ -95,15 +100,14 @@ export function create(context: RuleContext<MessageID, Options>): RuleListener {
     : (options.excepts ?? []).map((s) => RE.toRegExp(s));
 
   function validate(name: string, casing: Case = rule, ignores = excepts) {
-    const shouldIgnore = ignores
-      .some((pattern) => pattern.test(name));
-    if (shouldIgnore) return true;
-
+    if (ignores.some((pattern) => pattern.test(name))) return true;
+    const filteredName = name.match(/[\w-]/gu)?.join("") ?? "";
+    if (filteredName.length === 0) return true;
     return match(casing)
-      .with("PascalCase", () => RE.PASCAL_CASE.test(name))
-      .with("camelCase", () => RE.CAMEL_CASE.test(name))
-      .with("kebab-case", () => RE.KEBAB_CASE.test(name))
-      .with("snake_case", () => RE.SNAKE_CASE.test(name))
+      .with("PascalCase", () => RE.PASCAL_CASE.test(filteredName))
+      .with("camelCase", () => RE.CAMEL_CASE.test(filteredName))
+      .with("kebab-case", () => RE.KEBAB_CASE.test(filteredName))
+      .with("snake_case", () => RE.SNAKE_CASE.test(filteredName))
       .exhaustive();
   }