mcp-react-toolkit 1.0.0

package/tools/typescript-enforcer/build/rules/generics.js

@@ -0,0 +1,182 @@
+export function checkGenerics(source, filePath) {
+    const violations = [];
+    const lines = source.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*'))
+            continue;
+        const hookNoTypeRegex = /\b(useRef|useMemo|useReducer|useContext)\s*\(/g;
+        let hookMatch;
+        while ((hookMatch = hookNoTypeRegex.exec(line)) !== null) {
+            const hookName = hookMatch[1];
+            const upToHook = line.slice(hookMatch.index);
+            if (upToHook.startsWith(`${hookName}<`))
+                continue;
+            let suggestion = '';
+            let why = '';
+            if (hookName === 'useRef') {
+                suggestion = `useRef<HTMLElement>(null) or useRef<ReturnType<typeof setTimeout>>(null)`;
+                why = 'Untyped useRef defaults to MutableRefObject<null>. Specify the ref target type for proper DOM/timer typing.';
+            }
+            else if (hookName === 'useMemo') {
+                suggestion = `useMemo<ReturnType>(() => ...)`;
+                why = 'Explicit type param on useMemo documents the intended memoized value type and catches computation errors.';
+            }
+            else if (hookName === 'useReducer') {
+                suggestion = `useReducer<State, Action>(reducer, initialState)`;
+                why = 'Typed reducers ensure state transitions are correct and action payloads are validated.';
+            }
+            else {
+                suggestion = `${hookName}<Type>(...)`;
+                why = 'React hooks benefit from explicit type parameters for better type safety and IDE support.';
+            }
+            violations.push({
+                rule: 'generics',
+                severity: 'warning',
+                line: i + 1,
+                column: hookMatch.index + 1,
+                current: `${hookName}(...)`,
+                suggestion,
+                fix: `// Add explicit type parameter:\n// ${suggestion}`,
+                why,
+            });
+        }
+        const castReturnRegex = /function\s+(\w+)\s*\([^)]*\):\s*(any|unknown)\s*\{/;
+        const castMatch = line.match(castReturnRegex);
+        if (castMatch) {
+            violations.push({
+                rule: 'generics',
+                severity: 'warning',
+                line: i + 1,
+                column: 1,
+                current: `function ${castMatch[1]}(...): ${castMatch[2]}`,
+                suggestion: `function ${castMatch[1]}<T>(...): T`,
+                fix: `// Make the function generic: function ${castMatch[1]}<T>(...): T {\n// Then call it with explicit type: ${castMatch[1]}<ReturnType>(...)`,
+                why: 'Generic functions preserve type information through the call chain. Returning any/unknown loses type safety.',
+            });
+        }
+        const assertReturnRegex = /return\s+(\w+)\s+as\s+(\w+)/g;
+        let assertMatch;
+        while ((assertMatch = assertReturnRegex.exec(line)) !== null) {
+            const funcContext = findFunctionContext(lines, i);
+            if (funcContext && !funcContext.includes('<')) {
+                violations.push({
+                    rule: 'generics',
+                    severity: 'info',
+                    line: i + 1,
+                    column: assertMatch.index + 1,
+                    current: `return ${assertMatch[1]} as ${assertMatch[2]}`,
+                    suggestion: `Make the enclosing function generic: <T>(): T`,
+                    fix: `// Consider making the function generic instead of casting:\n// function parseResponse<T>(data: unknown): T { return data as T; }`,
+                    why: 'Type assertions in returns indicate the function could be generic to preserve type information.',
+                });
+            }
+        }
+        const objEntriesRegex = /Object\.(entries|keys|values)\s*\(/g;
+        let objMatch;
+        while ((objMatch = objEntriesRegex.exec(line)) !== null) {
+            if (!line.includes('as ') && !line.includes('<')) {
+                violations.push({
+                    rule: 'generics',
+                    severity: 'info',
+                    line: i + 1,
+                    column: objMatch.index + 1,
+                    current: `Object.${objMatch[1]}(...)`,
+                    suggestion: `Use Object.${objMatch[1]}(obj) with type narrowing or Object.${objMatch[1]}<K extends keyof T>(obj: T)`,
+                    fix: `// Add type parameter: Object.${objMatch[1]}<string, ValueType>(obj)`,
+                    why: `Object.${objMatch[1]} returns string[] or [string, any][] without type information. Use generics or type assertions for type safety.`,
+                });
+            }
+        }
+        const collectionRegex = /new\s+(Array|Map|Set)\s*\(/g;
+        let collMatch;
+        while ((collMatch = collectionRegex.exec(line)) !== null) {
+            if (!line.includes('<')) {
+                violations.push({
+                    rule: 'generics',
+                    severity: 'warning',
+                    line: i + 1,
+                    column: collMatch.index + 1,
+                    current: `new ${collMatch[1]}(...)`,
+                    suggestion: `new ${collMatch[1]}<Type>(...)`,
+                    fix: `// Add type parameter: new ${collMatch[1]}<SpecificType>(...)`,
+                    why: `Untyped collections default to ${collMatch[1]}<any>. Always specify the element type.`,
+                });
+            }
+        }
+        const callbackRegex = /callback:\s*\([^)]*\)\s*=>\s*void/g;
+        let cbMatch;
+        while ((cbMatch = callbackRegex.exec(line)) !== null) {
+            violations.push({
+                rule: 'generics',
+                severity: 'info',
+                line: i + 1,
+                column: cbMatch.index + 1,
+                current: 'callback: (...) => void',
+                suggestion: 'callback: <T>(arg: T) => void or use a generic type parameter',
+                fix: '// Make callback generic: <T>(value: T) => void',
+                why: 'Generic callbacks preserve the type of the argument, enabling better type inference in the caller.',
+            });
+        }
+        const utilityPatterns = [
+            { regex: /function\s+(clone|deepClone|merge|assign|extend)\s*\(/, name: 'clone/merge' },
+            { regex: /function\s+(filter|find|map|reduce)\w*\s*\(/, name: 'collection operation' },
+            { regex: /function\s+(pick|omit|pluck|get|set)\s*\(/, name: 'property access' },
+        ];
+        for (const pattern of utilityPatterns) {
+            const utilMatch = line.match(pattern.regex);
+            if (utilMatch && !line.includes('<')) {
+                violations.push({
+                    rule: 'generics',
+                    severity: 'info',
+                    line: i + 1,
+                    column: 1,
+                    current: line.trim(),
+                    suggestion: `Make ${utilMatch[1]} generic: function ${utilMatch[1]}<T>(...): T`,
+                    fix: `// Add generic type parameter: <T extends Record<string, unknown>>(obj: T)`,
+                    why: `Utility functions like ${pattern.name} should be generic to work with any type while preserving type information.`,
+                });
+            }
+        }
+        const classMatch = line.match(/class\s+(\w+)/);
+        if (classMatch) {
+            const classEnd = findClassEnd(lines, i);
+            const classBody = lines.slice(i, classEnd).join('\n');
+            const assertionCount = (classBody.match(/\bas\s+\w+/g) || []).length;
+            const genericCount = (classBody.match(/<\w+>/g) || []).length;
+            if (assertionCount >= 3 && genericCount === 0) {
+                violations.push({
+                    rule: 'generics',
+                    severity: 'warning',
+                    line: i + 1,
+                    column: 1,
+                    current: `class ${classMatch[1]} (has ${assertionCount} type assertions)`,
+                    suggestion: `class ${classMatch[1]}<T> { ... }`,
+                    fix: `// Consider making the class generic:\n// class ${classMatch[1]}<T> {\n//   private data: T;\n//   constructor(data: T) { this.data = data; }\n// }`,
+                    why: `Class has ${assertionCount} type assertions but no generics. Generic classes avoid repeated assertions by maintaining type information.`,
+                });
+            }
+        }
+    }
+    return { violations };
+}
+function findFunctionContext(lines, currentLine) {
+    for (let i = currentLine; i >= 0; i--) {
+        const match = lines[i].match(/(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*(<[^>]*>)?\s*\(/);
+        if (match)
+            return match[0];
+    }
+    return null;
+}
+function findClassEnd(lines, startLine) {
+    let depth = 0;
+    for (let i = startLine; i < lines.length; i++) {
+        depth += (lines[i].match(/{/g) || []).length;
+        depth -= (lines[i].match(/}/g) || []).length;
+        if (depth === 0 && i > startLine)
+            return i;
+    }
+    return lines.length;
+}
+//# sourceMappingURL=generics.js.map

package/tools/typescript-enforcer/build/rules/generics.js.map

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

package/tools/typescript-enforcer/build/rules/modifiers.d.ts

@@ -0,0 +1,3 @@
+import type { RuleCheckResult } from '../types.js';
+export declare function checkModifiers(source: string, filePath: string): RuleCheckResult;
+//# sourceMappingURL=modifiers.d.ts.map

package/tools/typescript-enforcer/build/rules/modifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifiers.d.ts","sourceRoot":"","sources":["../../src/rules/modifiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CA0NhF"}

package/tools/typescript-enforcer/build/rules/modifiers.js

@@ -0,0 +1,214 @@
+export function checkModifiers(source, filePath) {
+    const violations = [];
+    const lines = source.split('\n');
+    let insideInterface = false;
+    let interfaceName = '';
+    let interfaceDepth = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*'))
+            continue;
+        const ifaceStart = line.match(/^(?:export\s+)?interface\s+(\w+)/);
+        if (ifaceStart) {
+            insideInterface = true;
+            interfaceName = ifaceStart[1];
+            interfaceDepth = 0;
+        }
+        if (insideInterface) {
+            interfaceDepth += (line.match(/\{/g) || []).length;
+            interfaceDepth -= (line.match(/\}/g) || []).length;
+            if (interfaceDepth <= 0 && line.includes('}')) {
+                insideInterface = false;
+                continue;
+            }
+            const propMatch = trimmed.match(/^(\w+)\s*\??\s*:\s*.+/);
+            if (propMatch && !trimmed.startsWith('readonly') && interfaceDepth > 0) {
+                const propName = propMatch[1];
+                violations.push({
+                    rule: 'modifiers',
+                    severity: 'info',
+                    line: i + 1,
+                    column: line.indexOf(propName) + 1,
+                    current: trimmed.slice(0, 60),
+                    suggestion: `readonly ${trimmed.slice(0, 60)}`,
+                    fix: `// Mark interface property as readonly to prevent accidental mutation:\n// readonly ${propName}: ...`,
+                    why: `Interface properties in '${interfaceName}' should be readonly unless they need to be mutated. Readonly props prevent accidental modification and communicate immutability intent.`,
+                });
+            }
+        }
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//'))
+            continue;
+        if (/^\s*return\s*\{/.test(line) && !line.includes('as const')) {
+            let depth = (line.match(/\{/g) || []).length - (line.match(/\}/g) || []).length;
+            let endLine = i;
+            for (let j = i + 1; j < lines.length && depth > 0; j++) {
+                depth += (lines[j].match(/\{/g) || []).length;
+                depth -= (lines[j].match(/\}/g) || []).length;
+                if (depth <= 0) {
+                    endLine = j;
+                    break;
+                }
+            }
+            const closingLine = lines[endLine] || '';
+            if (!closingLine.includes('as const')) {
+                violations.push({
+                    rule: 'modifiers',
+                    severity: 'info',
+                    line: i + 1,
+                    column: line.indexOf('return') + 1,
+                    current: 'return { ... }',
+                    suggestion: 'return { ... } as const',
+                    fix: `// Add 'as const' to preserve literal types:\n// return {\n//   key: 'value',\n// } as const`,
+                    why: "'as const' on returned object literals preserves literal types ('light' instead of string), enabling exhaustive checks and autocomplete.",
+                });
+            }
+        }
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*'))
+            continue;
+        const constArrayRegex = /(?:export\s+)?const\s+(\w+)\s*=\s*\[/g;
+        let match;
+        while ((match = constArrayRegex.exec(line)) !== null) {
+            const restOfLine = line.slice(match.index);
+            if (!restOfLine.includes('(') && !restOfLine.includes('map') && !restOfLine.includes('filter')) {
+                if (!restOfLine.includes('as const')) {
+                    violations.push({
+                        rule: 'modifiers',
+                        severity: 'info',
+                        line: i + 1,
+                        column: match.index + 1,
+                        current: `const ${match[1]} = [...]`,
+                        suggestion: `const ${match[1]} = [...] as const`,
+                        fix: `// Add 'as const' to make the array readonly with literal types:\n// const ${match[1]} = [...] as const`,
+                        why: "'as const' makes the array readonly and infers literal types (e.g., ['a', 'b'] becomes readonly ['a', 'b'] instead of string[]).",
+                    });
+                }
+            }
+        }
+        const constObjectRegex = /(?:export\s+)?const\s+(\w+)\s*=\s*\{/g;
+        while ((match = constObjectRegex.exec(line)) !== null) {
+            const restOfLine = line.slice(match.index);
+            if (!restOfLine.includes('(') && !restOfLine.includes('as const')) {
+                const objectEnd = findObjectEnd(lines, i);
+                const objectBody = lines.slice(i, objectEnd + 1).join('\n');
+                const hasFunctionCall = objectBody.includes('(');
+                const hasSpread = objectBody.includes('...');
+                if (!hasFunctionCall && !hasSpread) {
+                    violations.push({
+                        rule: 'modifiers',
+                        severity: 'info',
+                        line: i + 1,
+                        column: match.index + 1,
+                        current: `const ${match[1]} = { ... }`,
+                        suggestion: `const ${match[1]} = { ... } as const`,
+                        fix: `// Add 'as const' for deeply readonly with literal types:\n// const ${match[1]} = { ... } as const`,
+                        why: "'as const' makes the entire object deeply readonly and preserves literal types for all properties.",
+                    });
+                }
+            }
+        }
+        const interfacePropRegex = /^\s+(\w+)\s*\??\s*:\s*([^;]+);/g;
+        while ((match = interfacePropRegex.exec(line)) !== null) {
+            const propName = match[1];
+            const propType = match[2].trim();
+            if (line.includes('readonly'))
+                continue;
+            if (propName.toLowerCase().endsWith('id') || propName === 'id') {
+                violations.push({
+                    rule: 'modifiers',
+                    severity: 'info',
+                    line: i + 1,
+                    column: 1,
+                    current: `${propName}: ${propType}`,
+                    suggestion: `readonly ${propName}: ${propType}`,
+                    fix: `// Make ID properties readonly - they shouldn't change after creation:\n// readonly ${propName}: ${propType}`,
+                    why: "ID properties should be readonly since they're immutable identifiers set at creation time.",
+                });
+            }
+            if (propName.toLowerCase().includes('created') || propName.toLowerCase().includes('updated')) {
+                if (propType.includes('Date') || propType.includes('number')) {
+                    violations.push({
+                        rule: 'modifiers',
+                        severity: 'info',
+                        line: i + 1,
+                        column: 1,
+                        current: `${propName}: ${propType}`,
+                        suggestion: `readonly ${propName}: ${propType}`,
+                        fix: `// Make timestamp properties readonly:\n// readonly ${propName}: ${propType}`,
+                        why: "Timestamp properties like createdAt/updatedAt should be readonly as they're set by the system.",
+                    });
+                }
+            }
+        }
+        const letVariable = line.match(/let\s+(\w+)\s*=/);
+        if (letVariable) {
+            const varName = letVariable[1];
+            const restOfFile = lines.slice(i + 1).join('\n');
+            const reassignment = restOfFile.match(new RegExp(`${varName}\\s*=`));
+            if (!reassignment) {
+                violations.push({
+                    rule: 'modifiers',
+                    severity: 'warning',
+                    line: i + 1,
+                    column: 1,
+                    current: `let ${varName} = ...`,
+                    suggestion: `const ${varName} = ...`,
+                    fix: `// Use 'const' instead of 'let' - variable is never reassigned:\n// const ${varName} = ...`,
+                    why: "Use 'const' by default. Only use 'let' when the variable needs to be reassigned.",
+                });
+            }
+        }
+        const typeAlias = line.match(/const\s+(\w+)\s*:\s*(\w+)\s*=/);
+        if (typeAlias) {
+            const varName = typeAlias[1];
+            const typeName = typeAlias[2];
+            const nextLines = lines.slice(i + 1, Math.min(i + 10, lines.length)).join('\n');
+            const hasPropertyAccess = nextLines.includes(`${varName}.`);
+            if (hasPropertyAccess && !line.includes('satisfies')) {
+                violations.push({
+                    rule: 'modifiers',
+                    severity: 'info',
+                    line: i + 1,
+                    column: 1,
+                    current: `const ${varName}: ${typeName} = ...`,
+                    suggestion: `const ${varName} = ... satisfies ${typeName}`,
+                    fix: `// Use 'satisfies' instead of type annotation for better inference:\n// const ${varName} = ... satisfies ${typeName}`,
+                    why: "'satisfies' validates the type while preserving the narrower inferred type, enabling better autocomplete.",
+                });
+            }
+        }
+        const enumLike = line.match(/(?:export\s+)?const\s+(\w+_(?:TYPE|STATUS|MODE|STATE|KIND))\s*=\s*['"]([^'"]+)['"]/);
+        if (enumLike) {
+            violations.push({
+                rule: 'modifiers',
+                severity: 'info',
+                line: i + 1,
+                column: 1,
+                current: `const ${enumLike[1]} = '${enumLike[2]}'`,
+                suggestion: `const ${enumLike[1]} = '${enumLike[2]}' as const`,
+                fix: `// Use 'as const' for string literal types:\n// const ${enumLike[1]} = '${enumLike[2]}' as const`,
+                why: "'as const' creates a literal type ('value') instead of widening to string.",
+            });
+        }
+    }
+    return { violations };
+}
+function findObjectEnd(lines, startLine) {
+    let depth = 0;
+    for (let i = startLine; i < lines.length; i++) {
+        depth += (lines[i].match(/{/g) || []).length;
+        depth -= (lines[i].match(/}/g) || []).length;
+        if (depth === 0 && i > startLine)
+            return i;
+    }
+    return Math.min(startLine + 20, lines.length - 1);
+}
+//# sourceMappingURL=modifiers.js.map

package/tools/typescript-enforcer/build/rules/modifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifiers.js","sourceRoot":"","sources":["../../src/rules/modifiers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAgB;IAC7D,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClE,IAAI,UAAU,EAAE,CAAC;YACf,eAAe,GAAG,IAAI,CAAC;YACvB,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC9B,cAAc,GAAG,CAAC,CAAC;QACrB,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,cAAc,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACnD,cAAc,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACnD,IAAI,cAAc,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9C,eAAe,GAAG,KAAK,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACzD,IAAI,SAAS,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;gBACvE,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC9B,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAClC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;oBAC7B,UAAU,EAAE,YAAY,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;oBAC9C,GAAG,EAAE,uFAAuF,QAAQ,OAAO;oBAC3G,GAAG,EAAE,4BAA4B,aAAa,0IAA0I;iBACzL,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAEvC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/D,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAChF,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvD,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC9C,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC9C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;oBAAC,OAAO,GAAG,CAAC,CAAC;oBAAC,MAAM;gBAAC,CAAC;YACzC,CAAC;YACD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtC,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAClC,OAAO,EAAE,gBAAgB;oBACzB,UAAU,EAAE,yBAAyB;oBACrC,GAAG,EAAE,8FAA8F;oBACnG,GAAG,EAAE,0IAA0I;iBAChJ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAE9F,MAAM,eAAe,GAAG,uCAAuC,CAAC;QAChE,IAAI,KAAK,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/F,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrC,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,WAAW;wBACjB,QAAQ,EAAE,MAAM;wBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;wBACX,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC;wBACvB,OAAO,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,UAAU;wBACpC,UAAU,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,mBAAmB;wBAChD,GAAG,EAAE,8EAA8E,KAAK,CAAC,CAAC,CAAC,mBAAmB;wBAC9G,GAAG,EAAE,kIAAkI;qBACxI,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;QACjE,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClE,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5D,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACjD,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAE7C,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnC,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,WAAW;wBACjB,QAAQ,EAAE,MAAM;wBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;wBACX,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC;wBACvB,OAAO,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,YAAY;wBACtC,UAAU,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,qBAAqB;wBAClD,GAAG,EAAE,uEAAuE,KAAK,CAAC,CAAC,CAAC,qBAAqB;wBACzG,GAAG,EAAE,oGAAoG;qBAC1G,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;QAC7D,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEjC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,SAAS;YAExC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC/D,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,GAAG,QAAQ,KAAK,QAAQ,EAAE;oBACnC,UAAU,EAAE,YAAY,QAAQ,KAAK,QAAQ,EAAE;oBAC/C,GAAG,EAAE,uFAAuF,QAAQ,KAAK,QAAQ,EAAE;oBACnH,GAAG,EAAE,4FAA4F;iBAClG,CAAC,CAAC;YACL,CAAC;YAED,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7F,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7D,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,WAAW;wBACjB,QAAQ,EAAE,MAAM;wBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;wBACX,MAAM,EAAE,CAAC;wBACT,OAAO,EAAE,GAAG,QAAQ,KAAK,QAAQ,EAAE;wBACnC,UAAU,EAAE,YAAY,QAAQ,KAAK,QAAQ,EAAE;wBAC/C,GAAG,EAAE,uDAAuD,QAAQ,KAAK,QAAQ,EAAE;wBACnF,GAAG,EAAE,gGAAgG;qBACtG,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAClD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC,CAAC;YAErE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,SAAS;oBACnB,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,OAAO,OAAO,QAAQ;oBAC/B,UAAU,EAAE,SAAS,OAAO,QAAQ;oBACpC,GAAG,EAAE,6EAA6E,OAAO,QAAQ;oBACjG,GAAG,EAAE,kFAAkF;iBACxF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC9D,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChF,MAAM,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;YAE5D,IAAI,iBAAiB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrD,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,SAAS,OAAO,KAAK,QAAQ,QAAQ;oBAC9C,UAAU,EAAE,SAAS,OAAO,oBAAoB,QAAQ,EAAE;oBAC1D,GAAG,EAAE,iFAAiF,OAAO,oBAAoB,QAAQ,EAAE;oBAC3H,GAAG,EAAE,2GAA2G;iBACjH,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,oFAAoF,CAAC,CAAC;QAClH,IAAI,QAAQ,EAAE,CAAC;YACb,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;gBACX,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG;gBAClD,UAAU,EAAE,SAAS,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,YAAY;gBAC9D,GAAG,EAAE,yDAAyD,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,YAAY;gBACvG,GAAG,EAAE,4EAA4E;aAClF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,aAAa,CAAC,KAAe,EAAE,SAAiB;IACvD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC7C,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC7C,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS;YAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/tools/typescript-enforcer/build/rules/no-any.d.ts

@@ -0,0 +1,3 @@
+import type { RuleCheckResult } from '../types.js';
+export declare function checkNoAny(source: string, filePath: string): RuleCheckResult;
+//# sourceMappingURL=no-any.d.ts.map

package/tools/typescript-enforcer/build/rules/no-any.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-any.d.ts","sourceRoot":"","sources":["../../src/rules/no-any.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAsG5E"}

package/tools/typescript-enforcer/build/rules/no-any.js

@@ -0,0 +1,138 @@
+export function checkNoAny(source, filePath) {
+    const violations = [];
+    const lines = source.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*'))
+            continue;
+        const anyTypeRegex = /:\s*any\b/g;
+        let match;
+        while ((match = anyTypeRegex.exec(line)) !== null) {
+            const col = match.index;
+            const beforeColon = line.slice(0, col).trim();
+            const suggestion = suggestTypeForAny(beforeColon, line, lines, i);
+            const fix = generateFix(beforeColon, suggestion);
+            violations.push({
+                rule: 'no-any',
+                severity: 'error',
+                line: i + 1,
+                column: col + 1,
+                current: match[0].trim(),
+                suggestion,
+                fix,
+                why: "Using 'any' disables TypeScript's type checking entirely. This defeats the purpose of TypeScript and allows bugs to pass silently.",
+            });
+        }
+        const asAnyRegex = /\bas\s+any\b/g;
+        while ((match = asAnyRegex.exec(line)) !== null) {
+            violations.push({
+                rule: 'no-any',
+                severity: 'error',
+                line: i + 1,
+                column: match.index + 1,
+                current: 'as any',
+                suggestion: 'Use a proper type assertion or type guard instead',
+                fix: '// Replace with proper type: as SpecificType, or use type guard',
+                why: "'as any' is a type safety escape hatch that hides potential runtime errors.",
+            });
+        }
+        const anyArrayRegex = /(?:unknown\[\]|any\[\])/g;
+        while ((match = anyArrayRegex.exec(line)) !== null) {
+            violations.push({
+                rule: 'no-any',
+                severity: 'error',
+                line: i + 1,
+                column: match.index + 1,
+                current: match[0],
+                suggestion: 'Use Array<SpecificType> or SpecificType[]',
+                fix: '// Replace with proper type: unknown[] for truly unknown, or SpecificType[]',
+                why: "unknown[] allows any value in the array, losing all type safety for collection operations.",
+            });
+        }
+        const promiseAnyRegex = /Promise<unknown>/g;
+        while ((match = promiseAnyRegex.exec(line)) !== null) {
+            violations.push({
+                rule: 'no-any',
+                severity: 'error',
+                line: i + 1,
+                column: match.index + 1,
+                current: 'Promise<unknown>',
+                suggestion: 'Use Promise<SpecificType> or Promise<unknown>',
+                fix: '// Replace with Promise<unknown> if truly unknown, or specific type',
+                why: "Promise<unknown> loses type information for async operations. Use Promise<unknown> as a safer alternative.",
+            });
+        }
+        const recordAnyRegex = /Record<string,\s*any>/g;
+        while ((match = recordAnyRegex.exec(line)) !== null) {
+            violations.push({
+                rule: 'no-any',
+                severity: 'warning',
+                line: i + 1,
+                column: match.index + 1,
+                current: 'Record<string, unknown>',
+                suggestion: 'Use Record<string, unknown> or define a specific interface',
+                fix: '// Replace with Record<string, unknown> or a typed interface',
+                why: "Record<string, unknown> allows any value type. Use unknown for safer type narrowing, or define specific types.",
+            });
+        }
+        const genericAnyRegex = /<any[,\s>]/g;
+        while ((match = genericAnyRegex.exec(line)) !== null) {
+            violations.push({
+                rule: 'no-any',
+                severity: 'error',
+                line: i + 1,
+                column: match.index + 1,
+                current: match[0].trim(),
+                suggestion: 'Use unknown or a specific type parameter',
+                fix: '// Replace <any> with <unknown> or a specific type',
+                why: "Generic 'any' disables type checking for the generic parameter. Use unknown as a safer alternative.",
+            });
+        }
+    }
+    return { violations };
+}
+function suggestTypeForAny(beforeColon, fullLine, allLines, lineIdx) {
+    const context = beforeColon.toLowerCase();
+    if (context.includes('args') || context.includes('params') || context.includes('options')) {
+        return 'Define a specific interface for the parameters';
+    }
+    if (context.includes('error') || context.includes('err')) {
+        return 'Error | unknown';
+    }
+    if (context.includes('event') || context.includes('e)')) {
+        return 'Event | React.SyntheticEvent';
+    }
+    if (context.includes('callback') || context.includes('handler') || context.includes('fn')) {
+        return '(...args: unknown[]) => unknown';
+    }
+    if (context.includes('result') || context.includes('response') || context.includes('data')) {
+        return 'Define a specific type for the response';
+    }
+    if (context.includes('config') || context.includes('options')) {
+        return 'Define a specific config interface';
+    }
+    if (context.includes('props')) {
+        return 'Define a Props interface';
+    }
+    if (context.includes('ref')) {
+        return 'React.RefObject<SpecificElement>';
+    }
+    if (context.includes('children')) {
+        return 'React.ReactNode';
+    }
+    if (context.includes('const ') || context.includes('let ')) {
+        return 'Infer from assignment or define explicit type';
+    }
+    if (fullLine.includes('): unknown') || fullLine.includes('):  any')) {
+        return 'Define specific return type';
+    }
+    return 'unknown (safer than any, requires type narrowing)';
+}
+function generateFix(beforeColon, suggestion) {
+    if (suggestion.includes('Define') || suggestion.includes('Infer')) {
+        return `// ${suggestion}`;
+    }
+    return `// Replace 'any' with '${suggestion}'`;
+}
+//# sourceMappingURL=no-any.js.map

package/tools/typescript-enforcer/build/rules/no-any.js.map

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

package/tools/typescript-enforcer/build/rules/type-guards.d.ts

@@ -0,0 +1,3 @@
+import type { RuleCheckResult } from '../types.js';
+export declare function checkTypeGuards(source: string, filePath: string): RuleCheckResult;
+//# sourceMappingURL=type-guards.d.ts.map

package/tools/typescript-enforcer/build/rules/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/rules/type-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CA+KjF"}