.oxlintrc.json

{
    "plugins": ["import", "promise", "unicorn"],
    "categories": {
        "correctness": "error",
        "pedantic": "warn",
        "perf": "warn",
        "restriction": "error",
        "style": "warn",
        "suspicious": "warn"
    },
    "rules": {
        "import/no-cycle": "error",
        "import/no-duplicates": "error",
        "import/no-self-import": "error",
        "import/prefer-default-export": "off", // Conflicts with no-default-export
        "import/max-dependencies": [
            "warn",
            {
                "max": 10,
                "ignoreTypeImports": true
            }
        ],
        "id-length": "off",
        "max-lines-per-function": [
            "warn",
            {
                "max": 100,
                "skipBlankLines": true,
                "skipComments": true
            }
        ],
        "max-lines": [
            "warn",
            {
                "max": 350,
                "skipBlankLines": true,
                "skipComments": true
            }
        ],
        "no-magic-numbers": [
            "warn",
            {
                "ignore": [-1, 0, 1, 2], // Universal programming constants
                "ignoreArrayIndexes": true, // array[0] is self-documenting
                "ignoreEnums": true // Enum values are often self-documenting sequences
            }
        ],
        "sort-keys": "off",
        "sort-imports": "off",
        "no-ternary": "off",
        "func-style": "off",
        "unicorn/no-null": "off", // Vue.js ecosystem uses null extensively - keep both null and undefined for semantic clarity
        "no-eq-null": "off", // Vue.js community standard - != null is widely accepted for null/undefined checks
        "no-undefined": "off", // Vue.js apps commonly check for undefined explicitly (props, refs, route params)
        "unicorn/filename-case": [
            "warn",
            {
                "cases": {
                    "kebabCase": true
                }
            }
        ],
        "unicorn/catch-error-name": [
            "warn",
            {
                "ignore": ["^(err|error)$"]
            }
        ],
        "import/no-relative-parent-imports": "off", // Standard practice in Vue/TS - stores, services, composables all import from parent dirs
        "no-use-before-define": [
            "error",
            {
                "functions": false,
                "classes": false
            }
        ], // Function/class hoisting is fine in JS/TS
        "no-inline-comments": "off", // Inline comments are more readable next to the code they explain
        "max-statements": "off", // Redundant with max-lines-per-function (100 lines)
        "unicorn/numeric-separators-style": "off", // Our numeric literals are IDs and term codes (YYYYMM), not quantities
        "capitalized-comments": [
            "warn",
            "always",
            {
                "line": {
                    "ignoreConsecutiveComments": true
                }
            }
        ]
    },
    "overrides": [
        {
            "files": ["scripts/**/*"],
            "plugins": ["node"],
            "rules": {
                "no-console": "off",
                "no-void": "off",
                "import/no-commonjs": "off",
                "import/no-nodejs-modules": "off",
                "import/unambiguous": "off",
                "import/no-default-export": "off",
                "unicorn/prefer-module": "off",
                "unicorn/prefer-top-level-await": "off",
                "unicorn/no-process-exit": "off",
                "max-lines": "off",
                "max-params": "off",
                "promise/avoid-new": "off",
                "promise/prefer-await-to-callbacks": "off"
            }
        },
        {
            "files": ["**/__tests__/**/*"],
            "plugins": ["vitest"],
            "rules": {
                "no-console": "off",
                "no-magic-numbers": "off",
                "import/max-dependencies": "off",
                "import/unambiguous": "off", // Vitest always runs test files as modules
                "max-lines-per-function": [
                    "warn",
                    {
                        "max": 200
                    }
                ],
                "max-lines": [
                    "warn",
                    {
                        "max": 500
                    }
                ],
                "vitest/prefer-called-times": "off", // Conflicts with prefer-called-once; toHaveBeenCalledOnce() is more readable
                "vitest/prefer-import-in-mock": "off", // import() form in vi.mock causes TS errors with partial class mocks
                "vitest/prefer-strict-boolean-matchers": "off", // Conflicts with prefer-to-be-truthy; we use .toBeTruthy()/.toBeFalsy()
                "vitest/require-test-timeout": "off" // Disabled intentionally; test files are not required to declare per-test timeouts
            }
        },
        {
            "files": ["VueApp/src/**/*"],
            "rules": {
                "no-console": "error"
            }
        },
        {
            "files": ["VueApp/**/*.config.*", "VueApp/vite-watch.js"],
            "rules": {
                "import/no-default-export": "off", // Config files often require default exports
                "no-console": "off",
                "import/max-dependencies": "off", // Build scripts may need multiple dependencies
                "max-lines-per-function": "off", // Build scripts may have longer functions
                "promise/prefer-await-to-callbacks": "off", // Callback pattern needed for tree-kill integration
                "import/unambiguous": "off", // Node.js scripts don't need module indicators
                "import/no-nodejs-modules": "off" // Config files run in Node, not the browser
            }
        },
        {
            "files": ["VueApp/**/*"],
            "rules": {
                "no-duplicate-imports": "off", // Allow separate type-only imports for better tree-shaking in Vue 3 TypeScript projects
                "import/no-named-export": "off" // Vue ecosystem uses named exports for composables, stores, and utilities
            }
        },
        {
            "files": [
                "VueApp/src/main.ts",
                "VueApp/src/**/computing.ts",
                "VueApp/src/**/students.ts",
                "VueApp/src/**/cms.ts",
                "VueApp/src/**/cts.ts",
                "VueApp/src/**/effort.ts",
                "VueApp/src/**/clinicalscheduler.ts",
                "VueApp/src/**/cahfs.ts"
            ],
            "rules": {
                "import/no-unassigned-import": "off" // CSS imports are side-effect only (they apply styles without exports)
            }
        },
        {
            "files": ["**/stores/**/*", "**/store/**/*"],
            "rules": {
                "import/max-dependencies": "off" // Store files naturally coordinate between many modules and services
            }
        },
        {
            "files": ["**/*.d.ts"],
            "rules": {
                "import/unambiguous": "off" // TypeScript declaration files are ambient, not modules
            }
        },
        {
            "files": [
                "VueApp/src/**/composables/use-schedule-operations.ts",
                "VueApp/src/**/composables/use-schedule-crud.ts",
                "VueApp/src/**/composables/use-schedule-dialogs.ts",
                "VueApp/src/**/utils/confirmation-dialog.ts",
                "VueApp/src/composables/use-unsaved-changes.ts"
            ],
            "rules": {
                "promise/avoid-new": "off" // Quasar dialogs require Promise wrapper for async/await
            }
        },
        {
            "files": [
                "VueApp/src/composables/ViperFetch.ts",
                "VueApp/src/composables/RequireLogin.ts",
                "VueApp/src/composables/QuasarConfig.ts",
                "VueApp/src/composables/QuasarTableUtilities.ts",
                "VueApp/src/composables/ErrorHandler.ts",
                "VueApp/src/composables/DateFunctions.ts",
                "VueApp/src/composables/CheckPagePermission.ts",
                "VueApp/src/store/ErrorStore.ts",
                "VueApp/src/store/UserStore.ts"
            ],
            "rules": {
                "unicorn/filename-case": "off" // Legacy core files - keep PascalCase naming for backwards compatibility
            }
        },
        {
            "files": ["web/wwwroot/js/**"],
            "rules": {
                "no-unused-vars": "off", // Functions are called from Razor views via <script> tags
                "import/unambiguous": "off" // These are <script> tag files, not ES modules
            }
        }
    ],
    "ignorePatterns": [
        "node_modules/**",
        "bin/**",
        "obj/**",
        "dist/**",
        "web/wwwroot/vue/**",
        "web/wwwroot/lib/**",
        "*.min.js",
        "*.bundle.js",
        "**/*.vue"
    ]
}