@hatem427/code-guard-ci 1.0.0

package/dist/config/guidelines.config.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * ============================================================================
+ * guidelines.config.ts — Central guidelines configuration
+ * ============================================================================
+ *
+ * Defines the shape of a rule, severity levels, and the shared rule registry.
+ * Each project-type config (angular, react, nextjs) plugs into this registry.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sharedRules = void 0;
+exports.registerRules = registerRules;
+exports.getRulesForProject = getRulesForProject;
+exports.getAllRules = getAllRules;
+// ── Shared rules (framework-agnostic) ───────────────────────────────────────
+exports.sharedRules = [
+    {
+        id: 'no-console-log',
+        label: 'No console.log',
+        description: 'Remove all console.log statements before committing. Use a proper logging service instead.',
+        severity: 'error',
+        fileExtensions: ['ts', 'tsx', 'js', 'jsx'],
+        pattern: /console\.log\s*\(/g,
+        applicableTo: [],
+        category: 'Code Quality',
+    },
+    {
+        id: 'no-any-type',
+        label: 'No `any` type',
+        description: 'Avoid using `any` type. Use proper typing, generics, or `unknown` instead.',
+        severity: 'error',
+        fileExtensions: ['ts', 'tsx'],
+        pattern: /:\s*any\b|<any>|as\s+any\b/g,
+        applicableTo: [],
+        category: 'TypeScript',
+    },
+    {
+        id: 'no-settimeout',
+        label: 'No setTimeout',
+        description: 'Avoid using setTimeout. Use RxJS timer(), delay(), or framework-specific alternatives.',
+        severity: 'warning',
+        fileExtensions: ['ts', 'tsx', 'js', 'jsx'],
+        pattern: /setTimeout\s*\(/g,
+        applicableTo: [],
+        category: 'Async Patterns',
+    },
+    {
+        id: 'max-component-lines',
+        label: 'Component size ≤ 400 lines',
+        description: 'Components should not exceed 400 lines. Split large components into smaller, focused ones.',
+        severity: 'error',
+        fileExtensions: ['ts', 'tsx', 'jsx'],
+        pattern: null,
+        customCheck: (file) => {
+            if (file.lineCount > 400) {
+                return [
+                    {
+                        line: null,
+                        message: `File has ${file.lineCount} lines (max 400). Consider splitting into smaller components.`,
+                    },
+                ];
+            }
+            return [];
+        },
+        applicableTo: [],
+        category: 'Architecture',
+    },
+    {
+        id: 'no-custom-css',
+        label: 'Use Tailwind instead of custom CSS',
+        description: 'Prefer Tailwind utility classes over writing custom CSS. Custom styles should be rare and justified.',
+        severity: 'warning',
+        fileExtensions: ['css', 'scss', 'sass', 'less'],
+        pattern: null,
+        customCheck: (file) => {
+            // Allow Tailwind config files and global resets
+            const allowedFiles = [
+                'tailwind.css',
+                'globals.css',
+                'global.css',
+                'styles.css',
+                'variables.css',
+                'reset.css',
+            ];
+            const basename = file.relativePath.split('/').pop() || '';
+            if (allowedFiles.includes(basename))
+                return [];
+            // Check for custom CSS declarations (property: value patterns)
+            const cssDeclarationRegex = /^\s*[a-z-]+\s*:\s*[^;]+;/gm;
+            const matches = [];
+            const lines = file.lines;
+            for (let i = 0; i < lines.length; i++) {
+                const trimmed = lines[i].trim();
+                // Skip @apply (Tailwind), @import, @tailwind directives, comments, and CSS custom properties
+                if (trimmed.startsWith('@apply') ||
+                    trimmed.startsWith('@import') ||
+                    trimmed.startsWith('@tailwind') ||
+                    trimmed.startsWith('//') ||
+                    trimmed.startsWith('/*') ||
+                    trimmed.startsWith('*') ||
+                    trimmed.startsWith('--') // CSS custom properties
+                ) {
+                    continue;
+                }
+                cssDeclarationRegex.lastIndex = 0;
+                if (cssDeclarationRegex.test(lines[i])) {
+                    matches.push({
+                        line: i + 1,
+                        message: `Custom CSS found: "${trimmed}". Prefer Tailwind utilities.`,
+                    });
+                }
+            }
+            // Only report if there are a meaningful number of custom declarations
+            if (matches.length > 3) {
+                return [
+                    {
+                        line: null,
+                        message: `File contains ${matches.length} custom CSS declarations. Consider using Tailwind utilities instead.`,
+                    },
+                ];
+            }
+            return [];
+        },
+        applicableTo: [],
+        category: 'Styling',
+    },
+];
+// ── Rule registry (populated by project-specific configs) ───────────────────
+const ruleRegistry = new Map();
+/**
+ * Register rules for a specific project type.
+ * Called by angular.config.ts, react.config.ts, nextjs.config.ts.
+ */
+function registerRules(projectType, rules) {
+    const existing = ruleRegistry.get(projectType) || [];
+    ruleRegistry.set(projectType, [...existing, ...rules]);
+}
+/**
+ * Get all applicable rules for a detected project type.
+ * Merges shared rules with project-specific rules.
+ */
+function getRulesForProject(projectType) {
+    const projectRules = ruleRegistry.get(projectType) || [];
+    // Filter shared rules: include if applicableTo is empty (all) or includes this project type
+    const applicableShared = exports.sharedRules.filter((r) => r.applicableTo.length === 0 || r.applicableTo.includes(projectType));
+    return [...applicableShared, ...projectRules];
+}
+/**
+ * Get ALL rules across all project types (used for PR checklist generation).
+ */
+function getAllRules() {
+    const allProjectRules = [];
+    for (const rules of ruleRegistry.values()) {
+        allProjectRules.push(...rules);
+    }
+    // Deduplicate by rule id
+    const seen = new Set();
+    const deduped = [];
+    for (const rule of [...exports.sharedRules, ...allProjectRules]) {
+        if (!seen.has(rule.id)) {
+            seen.add(rule.id);
+            deduped.push(rule);
+        }
+    }
+    return deduped;
+}
+//# sourceMappingURL=guidelines.config.js.map

package/dist/config/guidelines.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidelines.config.js","sourceRoot":"","sources":["../../config/guidelines.config.ts"],"names":[],"mappings":"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"}

package/dist/config/nextjs.config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ============================================================================
+ * nextjs.config.ts — Next.js-specific coding rules
+ * ============================================================================
+ *
+ * Registers rules that only apply to Next.js projects:
+ *   - App Router patterns
+ *   - Server/Client component boundaries
+ *   - Image optimization
+ *   - API route conventions
+ *
+ * Note: Next.js projects also inherit React rules automatically
+ * because the React config registers rules for 'nextjs' too.
+ */
+import { Rule } from './guidelines.config';
+declare const nextjsRules: Rule[];
+export { nextjsRules };
+//# sourceMappingURL=nextjs.config.d.ts.map

package/dist/config/nextjs.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.config.d.ts","sourceRoot":"","sources":["../../config/nextjs.config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiB,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE1D,QAAA,MAAM,WAAW,EAAE,IAAI,EAyItB,CAAC;AAKF,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/config/nextjs.config.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * ============================================================================
+ * nextjs.config.ts — Next.js-specific coding rules
+ * ============================================================================
+ *
+ * Registers rules that only apply to Next.js projects:
+ *   - App Router patterns
+ *   - Server/Client component boundaries
+ *   - Image optimization
+ *   - API route conventions
+ *
+ * Note: Next.js projects also inherit React rules automatically
+ * because the React config registers rules for 'nextjs' too.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nextjsRules = void 0;
+const guidelines_config_1 = require("./guidelines.config");
+const nextjsRules = [
+    // ── App Router ─────────────────────────────────────────────────────────
+    {
+        id: 'nextjs-use-client-directive',
+        label: 'Verify "use client" / "use server" directives',
+        description: 'Components using hooks, event handlers, or browser APIs must have "use client" at the top. Server components must not have it.',
+        severity: 'warning',
+        fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            const hasUseClient = file.content.includes("'use client'") || file.content.includes('"use client"');
+            const hasHooks = /use(State|Effect|Context|Reducer|Callback|Memo|Ref)\s*\(/.test(file.content);
+            const hasEventHandlers = /on(Click|Change|Submit|KeyDown|KeyUp|Focus|Blur)\s*=/.test(file.content);
+            // If file uses hooks or event handlers but lacks "use client"
+            if ((hasHooks || hasEventHandlers) && !hasUseClient) {
+                // Only flag if this looks like a component file (not a utility/hook file)
+                const isComponent = /export\s+(default\s+)?function\s+[A-Z]/.test(file.content) ||
+                    /const\s+[A-Z]\w+\s*[:=]/.test(file.content);
+                if (isComponent) {
+                    violations.push({
+                        line: 1,
+                        message: 'Component uses hooks/events but missing "use client" directive at the top.',
+                    });
+                }
+            }
+            return violations;
+        },
+        applicableTo: ['nextjs'],
+        category: 'Next.js App Router',
+    },
+    // ── Image optimization ─────────────────────────────────────────────────
+    {
+        id: 'nextjs-use-image-component',
+        label: 'Use next/image instead of <img>',
+        description: 'Always use the Next.js <Image> component for automatic optimization, lazy loading, and proper sizing.',
+        severity: 'warning',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: /<img\s/g,
+        applicableTo: ['nextjs'],
+        category: 'Next.js Performance',
+    },
+    // ── Link component ────────────────────────────────────────────────────
+    {
+        id: 'nextjs-use-link-component',
+        label: 'Use next/link instead of <a>',
+        description: 'Use the Next.js <Link> component for client-side navigation. Avoid plain <a> tags for internal links.',
+        severity: 'warning',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: /<a\s+href\s*=\s*["']\/(?!\/)/g,
+        applicableTo: ['nextjs'],
+        category: 'Next.js Navigation',
+    },
+    // ── API routes ─────────────────────────────────────────────────────────
+    {
+        id: 'nextjs-api-error-handling',
+        label: 'API routes must have error handling',
+        description: 'All API route handlers (GET, POST, etc.) must wrap logic in try/catch and return proper error responses.',
+        severity: 'warning',
+        fileExtensions: ['ts', 'js'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            // Only check files in api/ or route.ts/route.js paths
+            if (!file.relativePath.includes('/api/') &&
+                !file.relativePath.includes('route.ts') &&
+                !file.relativePath.includes('route.js')) {
+                return [];
+            }
+            const hasExportedHandler = /export\s+(async\s+)?function\s+(GET|POST|PUT|DELETE|PATCH)/.test(file.content);
+            const hasTryCatch = file.content.includes('try {') || file.content.includes('try{');
+            if (hasExportedHandler && !hasTryCatch) {
+                violations.push({
+                    line: null,
+                    message: 'API route handler missing try/catch error handling. Wrap logic in try/catch.',
+                });
+            }
+            return violations;
+        },
+        applicableTo: ['nextjs'],
+        category: 'Next.js API Routes',
+    },
+    // ── Metadata ──────────────────────────────────────────────────────────
+    {
+        id: 'nextjs-page-metadata',
+        label: 'Pages should export metadata',
+        description: 'Page components should export a metadata object or generateMetadata function for SEO.',
+        severity: 'info',
+        fileExtensions: ['tsx', 'ts'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            // Only check page.tsx files
+            const basename = file.relativePath.split('/').pop() || '';
+            if (basename !== 'page.tsx' && basename !== 'page.ts')
+                return [];
+            const hasMetadata = file.content.includes('export const metadata') ||
+                file.content.includes('export function generateMetadata') ||
+                file.content.includes('export async function generateMetadata');
+            if (!hasMetadata) {
+                violations.push({
+                    line: null,
+                    message: 'Page is missing metadata export. Add `export const metadata` or `export function generateMetadata`.',
+                });
+            }
+            return violations;
+        },
+        applicableTo: ['nextjs'],
+        category: 'Next.js SEO',
+    },
+];
+exports.nextjsRules = nextjsRules;
+// Register all Next.js-specific rules
+(0, guidelines_config_1.registerRules)('nextjs', nextjsRules);
+//# sourceMappingURL=nextjs.config.js.map

package/dist/config/nextjs.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.config.js","sourceRoot":"","sources":["../../config/nextjs.config.ts"],"names":[],"mappings":"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"}

package/dist/config/react.config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ============================================================================
+ * react.config.ts — React-specific coding rules
+ * ============================================================================
+ *
+ * Registers rules that only apply to React projects:
+ *   - Hook usage patterns
+ *   - Props/state typing
+ *   - Component patterns
+ *   - Performance anti-patterns
+ */
+import { Rule } from './guidelines.config';
+declare const reactRules: Rule[];
+export { reactRules };
+//# sourceMappingURL=react.config.d.ts.map

package/dist/config/react.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.config.d.ts","sourceRoot":"","sources":["../../config/react.config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAiB,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE1D,QAAA,MAAM,UAAU,EAAE,IAAI,EAsTrB,CAAC;AAKF,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/config/react.config.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * ============================================================================
+ * react.config.ts — React-specific coding rules
+ * ============================================================================
+ *
+ * Registers rules that only apply to React projects:
+ *   - Hook usage patterns
+ *   - Props/state typing
+ *   - Component patterns
+ *   - Performance anti-patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reactRules = void 0;
+const guidelines_config_1 = require("./guidelines.config");
+const reactRules = [
+    // ── Hooks ──────────────────────────────────────────────────────────────
+    {
+        id: 'react-no-useeffect-no-deps',
+        label: 'useEffect must have dependency array',
+        description: 'Every useEffect must have a dependency array. Missing deps causes infinite re-renders or stale closures.',
+        severity: 'error',
+        fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            const lines = file.lines;
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                // Detect useEffect( without a closing bracket on subsequent lines containing dependency array
+                if (/useEffect\s*\(\s*\(\s*\)\s*=>\s*\{/.test(line)) {
+                    // Look ahead for the closing of useEffect — find , [] or , [deps])
+                    let foundDeps = false;
+                    let parenDepth = 0;
+                    for (let j = i; j < Math.min(i + 50, lines.length); j++) {
+                        for (const ch of lines[j]) {
+                            if (ch === '(')
+                                parenDepth++;
+                            if (ch === ')')
+                                parenDepth--;
+                        }
+                        // Check if the dependency array is present
+                        if (/\]\s*\)\s*;?\s*$/.test(lines[j]) || /,\s*\[/.test(lines[j])) {
+                            foundDeps = true;
+                            break;
+                        }
+                        if (parenDepth <= 0)
+                            break;
+                    }
+                    if (!foundDeps) {
+                        violations.push({
+                            line: i + 1,
+                            message: 'useEffect without dependency array detected. Always specify dependencies.',
+                        });
+                    }
+                }
+            }
+            return violations;
+        },
+        applicableTo: ['react', 'nextjs'],
+        category: 'React Hooks',
+    },
+    {
+        id: 'react-no-inline-styles',
+        label: 'No inline style objects',
+        description: 'Avoid inline style={{ }} in JSX. Use Tailwind classes or CSS modules for consistent styling.',
+        severity: 'warning',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: /style\s*=\s*\{\s*\{/g,
+        applicableTo: ['react', 'nextjs'],
+        category: 'Styling',
+    },
+    {
+        id: 'react-no-direct-dom',
+        label: 'No direct DOM manipulation',
+        description: 'Avoid document.getElementById, querySelector, etc. Use useRef() and React state instead.',
+        severity: 'error',
+        fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+        pattern: /document\.(getElementById|querySelector|querySelectorAll|getElementsBy)/g,
+        applicableTo: ['react', 'nextjs'],
+        category: 'React Patterns',
+    },
+    // ── Component patterns ─────────────────────────────────────────────────
+    {
+        id: 'react-prefer-fc-typing',
+        label: 'Type component props explicitly',
+        description: 'Define a Props interface/type and use it. Avoid React.FC — type props parameter directly.',
+        severity: 'info',
+        fileExtensions: ['tsx'],
+        pattern: /React\.FC/g,
+        applicableTo: ['react', 'nextjs'],
+        category: 'TypeScript',
+    },
+    {
+        id: 'react-no-prop-spreading',
+        label: 'Avoid prop spreading ({...props})',
+        description: 'Spreading props makes component APIs unclear. Explicitly pass required props for better readability and TypeScript safety.',
+        severity: 'info',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: /\{\s*\.\.\.\w+\s*\}/g,
+        applicableTo: ['react', 'nextjs'],
+        category: 'React Patterns',
+    },
+    // ── Security Rules ─────────────────────────────────────────────────────
+    {
+        id: 'react-no-dangerously-set-html',
+        label: 'No dangerouslySetInnerHTML',
+        description: 'Using dangerouslySetInnerHTML opens your app to XSS attacks. Sanitize HTML or use safe alternatives.',
+        severity: 'error',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: /dangerouslySetInnerHTML/g,
+        applicableTo: ['react', 'nextjs'],
+        category: 'Security',
+    },
+    {
+        id: 'no-eval',
+        label: 'No eval() usage',
+        description: 'eval() allows arbitrary code execution and is a major security vulnerability. Use JSON.parse() or other safe alternatives.',
+        severity: 'error',
+        fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+        pattern: /\beval\s*\(/g,
+        applicableTo: ['react', 'nextjs'],
+        category: 'Security',
+    },
+    {
+        id: 'no-hardcoded-credentials',
+        label: 'No hardcoded credentials',
+        description: 'Never hardcode API keys, passwords, or secrets. Use environment variables instead.',
+        severity: 'error',
+        fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            const lines = file.lines;
+            const suspiciousPatterns = [
+                /password\s*[=:]\s*["'`][^"'`]+["'`]/i,
+                /apikey\s*[=:]\s*["'`][^"'`]+["'`]/i,
+                /api_key\s*[=:]\s*["'`][^"'`]+["'`]/i,
+                /secret\s*[=:]\s*["'`][^"'`]+["'`]/i,
+                /token\s*[=:]\s*["'`][^"'`]{20,}["'`]/i,
+            ];
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                for (const pattern of suspiciousPatterns) {
+                    if (pattern.test(line)) {
+                        violations.push({
+                            line: i + 1,
+                            message: `Potential hardcoded credential detected. Use environment variables: process.env.API_KEY`,
+                        });
+                        break;
+                    }
+                }
+            }
+            return violations;
+        },
+        applicableTo: ['react', 'nextjs', 'angular'],
+        category: 'Security',
+    },
+    {
+        id: 'require-https',
+        label: 'Require HTTPS URLs',
+        description: 'HTTP URLs are insecure. Always use HTTPS for API calls and external resources.',
+        severity: 'warning',
+        fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+        pattern: /['"`]http:\/\/(?!localhost|127\.0\.0\.1)/g,
+        applicableTo: ['react', 'nextjs', 'angular'],
+        category: 'Security',
+    },
+    // ── Performance Rules ──────────────────────────────────────────────────
+    {
+        id: 'react-no-anonymous-functions-in-render',
+        label: 'No anonymous functions in JSX',
+        description: 'Anonymous functions in JSX props cause unnecessary re-renders. Use useCallback or define functions outside render.',
+        severity: 'warning',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: /onClick\s*=\s*\{\s*\(\s*\)\s*=>/g,
+        applicableTo: ['react', 'nextjs'],
+        category: 'Performance',
+    },
+    {
+        id: 'react-missing-key-prop',
+        label: 'Missing key prop in list',
+        description: 'When rendering lists with .map(), always provide a unique key prop for optimal reconciliation.',
+        severity: 'error',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            const lines = file.lines;
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                // Detect .map( with JSX but no key prop nearby
+                if (/\.\s*map\s*\(/.test(line)) {
+                    // Look ahead for JSX opening tag
+                    let foundKey = false;
+                    for (let j = i; j < Math.min(i + 10, lines.length); j++) {
+                        if (/key\s*=/.test(lines[j])) {
+                            foundKey = true;
+                            break;
+                        }
+                    }
+                    // Check if there's JSX in the map
+                    let hasJsx = false;
+                    for (let j = i; j < Math.min(i + 10, lines.length); j++) {
+                        if (/<[A-Z]/.test(lines[j]) || /<[a-z]/.test(lines[j])) {
+                            hasJsx = true;
+                            break;
+                        }
+                    }
+                    if (hasJsx && !foundKey) {
+                        violations.push({
+                            line: i + 1,
+                            message: 'List items rendered with .map() must have a key prop',
+                        });
+                    }
+                }
+            }
+            return violations;
+        },
+        applicableTo: ['react', 'nextjs'],
+        category: 'Performance',
+    },
+    {
+        id: 'no-large-bundle-imports',
+        label: 'Avoid large library imports',
+        description: 'Importing entire lodash or moment.js increases bundle size. Use specific imports: import get from "lodash/get"',
+        severity: 'warning',
+        fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+        pattern: /import\s+(?:(?:\*\s+as\s+\w+)|(?:\{\s*[^}]{50,}\s*\}))\s+from\s+['"](?:lodash|moment)['"];?$/gm,
+        applicableTo: ['react', 'nextjs', 'angular'],
+        category: 'Performance',
+    },
+    // ── Accessibility Rules ────────────────────────────────────────────────
+    {
+        id: 'require-alt-text',
+        label: 'Images must have alt text',
+        description: 'All <img> tags must have alt attribute for accessibility. Use empty alt="" for decorative images.',
+        severity: 'error',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            const lines = file.lines;
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                // Match <img without alt or with empty src
+                if (/<img\b/.test(line) && !/alt\s*=/.test(line)) {
+                    violations.push({
+                        line: i + 1,
+                        message: '<img> tag must have alt attribute for accessibility',
+                    });
+                }
+            }
+            return violations;
+        },
+        applicableTo: ['react', 'nextjs'],
+        category: 'Accessibility',
+    },
+    {
+        id: 'require-button-type',
+        label: 'Buttons must have type attribute',
+        description: 'Always specify type="button", type="submit", or type="reset" on <button> elements to avoid unexpected form submissions.',
+        severity: 'warning',
+        fileExtensions: ['tsx', 'jsx'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            const lines = file.lines;
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (/<button\b/.test(line) && !/type\s*=/.test(line)) {
+                    violations.push({
+                        line: i + 1,
+                        message: '<button> should have explicit type attribute',
+                    });
+                }
+            }
+            return violations;
+        },
+        applicableTo: ['react', 'nextjs'],
+        category: 'Accessibility',
+    },
+];
+exports.reactRules = reactRules;
+// Register all React-specific rules
+(0, guidelines_config_1.registerRules)('react', reactRules);
+//# sourceMappingURL=react.config.js.map