mcp-react-toolkit 1.0.0

package/tools/typescript-enforcer/build/rules/type-guards.js

@@ -0,0 +1,176 @@
+export function checkTypeGuards(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 objectAssertRegex = /\bconst\s+(\w+)\s*=\s*(\w+)\s+as\s+\{/;
+        const objAssertMatch = line.match(objectAssertRegex);
+        if (objAssertMatch) {
+            violations.push({
+                rule: 'type-guards',
+                severity: 'warning',
+                line: i + 1,
+                column: line.indexOf('as {') + 1,
+                current: `const ${objAssertMatch[1]} = ${objAssertMatch[2]} as { ... }`,
+                suggestion: `Use a type guard: function is${objAssertMatch[1].charAt(0).toUpperCase() + objAssertMatch[1].slice(1)}(v: unknown): v is { ... }`,
+                fix: `// Replace type assertion with a type guard function:\n// function is${objAssertMatch[1].charAt(0).toUpperCase() + objAssertMatch[1].slice(1)}(v: unknown): v is { ... } {\n//   return typeof v === 'object' && v !== null && '...' in v;\n// }`,
+                why: "Type assertions ('as') bypass TypeScript's type checking. Type guards validate the shape at runtime and narrow the type safely.",
+            });
+        }
+        const funcAssertion = line.match(/(\w+)\s+as\s+(\w[\w<>, ]*)\s*[;,)]/);
+        if (funcAssertion && !line.includes('//') && !objAssertMatch) {
+            const castTarget = funcAssertion[2].trim();
+            if (!['string', 'number', 'boolean', 'never', 'unknown', 'any', 'object'].includes(castTarget) && !castTarget.startsWith('typeof')) {
+                const isInsideFunc = lines.slice(Math.max(0, i - 20), i).some(l => /(?:function|=>)\s*\{/.test(l) || /=>\s*$/.test(l));
+                if (isInsideFunc) {
+                    violations.push({
+                        rule: 'type-guards',
+                        severity: 'info',
+                        line: i + 1,
+                        column: line.indexOf(' as ') + 1,
+                        current: `${funcAssertion[1]} as ${castTarget}`,
+                        suggestion: `Create a type guard: function is${castTarget}(v: unknown): v is ${castTarget}`,
+                        fix: `// Use a type guard instead of 'as' cast:\n// function is${castTarget}(v: unknown): v is ${castTarget} {\n//   return typeof v === 'object' && v !== null && '...' in v;\n// }`,
+                        why: "'as' assertions silence TypeScript without validating the actual shape. Type guards enforce correctness at runtime.",
+                    });
+                }
+            }
+        }
+        const typeofCheck = line.match(/function\s+(is\w+)\s*\(\s*(\w+)\s*:\s*(\w+)\s*\)\s*:\s*boolean\s*\{/);
+        if (typeofCheck) {
+            const funcName = typeofCheck[1];
+            const paramName = typeofCheck[2];
+            const paramType = typeofCheck[3];
+            const funcEnd = findFunctionEnd(lines, i);
+            const funcBody = lines.slice(i, funcEnd + 1).join('\n');
+            const hasTypeof = funcBody.includes('typeof');
+            const hasInstanceof = funcBody.includes('instanceof');
+            const hasPropertyCheck = funcBody.includes('in ');
+            if (hasTypeof || hasInstanceof || hasPropertyCheck) {
+                let targetType = 'unknown';
+                if (funcBody.includes("=== 'string'"))
+                    targetType = 'string';
+                else if (funcBody.includes("=== 'number'"))
+                    targetType = 'number';
+                else if (funcBody.includes("=== 'boolean'"))
+                    targetType = 'boolean';
+                else if (funcBody.includes("=== 'object'"))
+                    targetType = 'object';
+                else if (funcBody.includes('instanceof')) {
+                    const instanceofMatch = funcBody.match(/instanceof\s+(\w+)/);
+                    if (instanceofMatch)
+                        targetType = instanceofMatch[1];
+                }
+                violations.push({
+                    rule: 'type-guards',
+                    severity: 'info',
+                    line: i + 1,
+                    column: 1,
+                    current: `function ${funcName}(...): boolean`,
+                    suggestion: `function ${funcName}(...): value is ${targetType}`,
+                    fix: `// Use type predicate instead of boolean return:\n// function ${funcName}(${paramName}: ${paramType}): ${paramName} is ${targetType} {\n//   return typeof ${paramName} === '${targetType.toLowerCase()}';\n// }`,
+                    why: "Type predicates ('is' keyword) let TypeScript narrow the type automatically after the check, instead of just returning boolean.",
+                });
+            }
+        }
+        const arrowTypeCheck = line.match(/const\s+(is\w+)\s*=\s*\(\s*(\w+)\s*:\s*(\w+)\s*\)\s*:\s*boolean\s*=>/);
+        if (arrowTypeCheck) {
+            violations.push({
+                rule: 'type-guards',
+                severity: 'info',
+                line: i + 1,
+                column: 1,
+                current: `const ${arrowTypeCheck[1]} = (...): boolean =>`,
+                suggestion: `const ${arrowTypeCheck[1]} = (...): param is Type =>`,
+                fix: `// Use type predicate:\n// const ${arrowTypeCheck[1]} = (${arrowTypeCheck[2]}: ${arrowTypeCheck[3]}): ${arrowTypeCheck[2]} is TargetType => typeof ${arrowTypeCheck[2]} === 'string'`,
+                why: "Type predicates enable automatic type narrowing in if/else blocks.",
+            });
+        }
+        const inlineTypeof = line.match(/if\s*\(\s*typeof\s+(\w+)\s*===?\s*['"](\w+)['"]\s*\)/);
+        if (inlineTypeof) {
+            const varName = inlineTypeof[1];
+            const checkType = inlineTypeof[2];
+            const nextLines = lines.slice(i, Math.min(i + 10, lines.length)).join('\n');
+            const hasCast = nextLines.includes(`as ${checkType.charAt(0).toUpperCase() + checkType.slice(1)}`) ||
+                nextLines.includes(`as ${checkType}`);
+            if (hasCast) {
+                violations.push({
+                    rule: 'type-guards',
+                    severity: 'warning',
+                    line: i + 1,
+                    column: 1,
+                    current: `if (typeof ${varName} === '${checkType}') { ... as ${checkType} }`,
+                    suggestion: `Create a type guard function: function is${checkType.charAt(0).toUpperCase() + checkType.slice(1)}(v: unknown): v is ${checkType}`,
+                    fix: `// Extract to type guard to eliminate casts:\n// function is${checkType.charAt(0).toUpperCase() + checkType.slice(1)}(v: unknown): v is ${checkType} {\n//   return typeof v === '${checkType}';\n// }`,
+                    why: "Type guards eliminate the need for type assertions ('as') inside conditional blocks, making code safer.",
+                });
+            }
+        }
+        const instanceofCheck = line.match(/if\s*\(\s*(\w+)\s+instanceof\s+(\w+)\s*\)/);
+        if (instanceofCheck) {
+            const varName = instanceofCheck[1];
+            const className = instanceofCheck[2];
+            const nextLines = lines.slice(i, Math.min(i + 10, lines.length)).join('\n');
+            const hasCast = nextLines.includes(`as ${className}`);
+            if (hasCast) {
+                violations.push({
+                    rule: 'type-guards',
+                    severity: 'warning',
+                    line: i + 1,
+                    column: 1,
+                    current: `if (${varName} instanceof ${className}) { ... as ${className} }`,
+                    suggestion: `Create a type guard: function is${className}(v: unknown): v is ${className}`,
+                    fix: `// Extract to type guard:\n// function is${className}(v: unknown): v is ${className} {\n//   return v instanceof ${className};\n// }`,
+                    why: "After instanceof, TypeScript should narrow the type automatically. If you still need 'as', use a type guard instead.",
+                });
+            }
+        }
+        const propertyCheck = line.match(/if\s*\(\s*['"](\w+)['"]\s+in\s+(\w+)\s*\)/);
+        if (propertyCheck) {
+            const propName = propertyCheck[1];
+            const varName = propertyCheck[2];
+            const nextLines = lines.slice(i, Math.min(i + 10, lines.length)).join('\n');
+            const hasCast = nextLines.includes('as ');
+            if (hasCast) {
+                violations.push({
+                    rule: 'type-guards',
+                    severity: 'info',
+                    line: i + 1,
+                    column: 1,
+                    current: `if ('${propName}' in ${varName}) { ... as ... }`,
+                    suggestion: `Create a type guard for the property check`,
+                    fix: `// Create a type guard:\n// function has${propName.charAt(0).toUpperCase() + propName.slice(1)}(obj: unknown): obj is { ${propName}: unknown } {\n//   return typeof obj === 'object' && obj !== null && '${propName}' in obj;\n// }`,
+                    why: 'Type guards for property checks enable safe access without casts.',
+                });
+            }
+        }
+        const nullCheck = line.match(/function\s+(isNotNull|isNonNull|isDefined|isPresent)\s*\(\s*(\w+)\s*:\s*(\w+)\s*\)\s*:\s*boolean/);
+        if (nullCheck) {
+            violations.push({
+                rule: 'type-guards',
+                severity: 'info',
+                line: i + 1,
+                column: 1,
+                current: `function ${nullCheck[1]}(...): boolean`,
+                suggestion: `function ${nullCheck[1]}<T>(value: T | null | undefined): value is T`,
+                fix: `// Use generic type predicate for null checks:\n// function ${nullCheck[1]}<T>(value: T | null | undefined): value is T {\n//   return value !== null && value !== undefined;\n// }`,
+                why: "Generic type predicates preserve the non-null type through the type system.",
+            });
+        }
+    }
+    return { violations };
+}
+function findFunctionEnd(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 - 1;
+}
+//# sourceMappingURL=type-guards.js.map

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

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

package/tools/typescript-enforcer/build/rules/utility-types.d.ts

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

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

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

package/tools/typescript-enforcer/build/rules/utility-types.js

@@ -0,0 +1,101 @@
+export function checkUtilityTypes(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 allOptionalRegex = /interface\s+(\w+)\s*\{([^}]*)\}/g;
+        let match;
+        while ((match = allOptionalRegex.exec(line)) !== null) {
+            const body = match[2];
+            const props = body.split(';').filter(p => p.trim());
+            const allOptional = props.every(p => p.includes('?:'));
+            if (allOptional && props.length >= 3) {
+                violations.push({
+                    rule: 'utility-types',
+                    severity: 'info',
+                    line: i + 1,
+                    column: 1,
+                    current: `interface ${match[1]} (all properties optional)`,
+                    suggestion: `type ${match[1]} = Partial<FullInterface>`,
+                    fix: `// Use Partial<T> instead of manually making all properties optional:\n// type ${match[1]} = Partial<${match[1].replace(/Options|Config/, '')}>`,
+                    why: 'Partial<T> is more maintainable - when the base interface changes, Partial automatically includes new properties.',
+                });
+            }
+        }
+        const pickPattern = /interface\s+(\w+)\s*\{\s*(\w+):\s*(\w+);\s*(\w+):\s*(\w+);\s*\}/g;
+        while ((match = pickPattern.exec(line)) !== null) {
+            if (match[1].includes('Pick') || match[1].includes('Selected')) {
+                violations.push({
+                    rule: 'utility-types',
+                    severity: 'info',
+                    line: i + 1,
+                    column: 1,
+                    current: `interface ${match[1]} { ${match[2]}: ${match[3]}; ${match[4]}: ${match[5]} }`,
+                    suggestion: `type ${match[1]} = Pick<BaseInterface, '${match[2]}' | '${match[4]}'>`,
+                    fix: `// Use Pick<T, K> to select specific properties from an existing type:\n// type ${match[1]} = Pick<BaseType, '${match[2]}' | '${match[4]}'>`,
+                    why: 'Pick<T, K> keeps types DRY - if the base type changes, the picked type automatically updates.',
+                });
+            }
+        }
+        const recordPattern = /\{\s*\[key:\s*string\]:\s*(\w+)\s*\}/g;
+        while ((match = recordPattern.exec(line)) !== null) {
+            violations.push({
+                rule: 'utility-types',
+                severity: 'info',
+                line: i + 1,
+                column: match.index + 1,
+                current: `{ [key: string]: ${match[1]} }`,
+                suggestion: `Record<string, ${match[1]}>`,
+                fix: `// Use Record<K, V> for cleaner object type definitions:\n// type MyMap = Record<string, ${match[1]}>`,
+                why: 'Record<string, T> is more readable and idiomatic than manual index signatures.',
+            });
+        }
+        const nullableUnion = line.match(/type\s+(\w+)\s*=\s*(\w+)\s*\|\s*null\s*\|\s*undefined/);
+        if (nullableUnion) {
+            violations.push({
+                rule: 'utility-types',
+                severity: 'info',
+                line: i + 1,
+                column: 1,
+                current: `type ${nullableUnion[1]} = ${nullableUnion[2]} | null | undefined`,
+                suggestion: `type ${nullableUnion[1]} = NonNullable<${nullableUnion[2]}>`,
+                fix: `// Use NonNullable<T> to remove null and undefined:\n// type ${nullableUnion[1]} = NonNullable<SomeNullableType>`,
+                why: 'NonNullable<T> clearly communicates intent and automatically handles new nullable additions to the base type.',
+            });
+        }
+        const awaitedPattern = line.match(/type\s+(\w+)\s*=\s*(\w+)\s*extends\s*Promise<infer\s+(\w+)>\s*\?\s*\3\s*:\s*never/);
+        if (awaitedPattern) {
+            violations.push({
+                rule: 'utility-types',
+                severity: 'info',
+                line: i + 1,
+                column: 1,
+                current: line.trim(),
+                suggestion: `type ${awaitedPattern[1]} = Awaited<${awaitedPattern[2]}>`,
+                fix: `// Use Awaited<T> to unwrap Promise types:\n// type ${awaitedPattern[1]} = Awaited<PromiseType>`,
+                why: 'Awaited<T> is built-in and handles nested Promises correctly.',
+            });
+        }
+        const typeAssertion = line.match(/const\s+(\w+)\s*:\s*(\w+)\s*=/);
+        if (typeAssertion && !line.includes('satisfies')) {
+            const nextLines = lines.slice(i, Math.min(i + 5, lines.length)).join('\n');
+            if (nextLines.includes('as ') || nextLines.includes(typeAssertion[1] + '.')) {
+                violations.push({
+                    rule: 'utility-types',
+                    severity: 'info',
+                    line: i + 1,
+                    column: 1,
+                    current: `const ${typeAssertion[1]}: ${typeAssertion[2]} = ...`,
+                    suggestion: `const ${typeAssertion[1]} = ... satisfies ${typeAssertion[2]}`,
+                    fix: `// Use 'satisfies' to validate type while preserving narrower inference:\n// const ${typeAssertion[1]} = { ... } satisfies ${typeAssertion[2]}`,
+                    why: "'satisfies' validates the type without widening, preserving autocomplete and literal types.",
+                });
+            }
+        }
+    }
+    return { violations };
+}
+//# sourceMappingURL=utility-types.js.map

package/tools/typescript-enforcer/build/rules/utility-types.js.map

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

package/tools/typescript-enforcer/build/scanner.d.ts

@@ -0,0 +1,4 @@
+import type { FileScanResult, DirectoryScanResult, ScanOptions } from './types.js';
+export declare function scanFile(filePath: string, options?: ScanOptions): FileScanResult;
+export declare function scanDirectory(dir: string, options?: ScanOptions): DirectoryScanResult;
+//# sourceMappingURL=scanner.d.ts.map

package/tools/typescript-enforcer/build/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAa,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAY,MAAM,YAAY,CAAC;AAqBxG,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,cAAc,CAyCpF;AAwBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,mBAAmB,CA6CzF"}

package/tools/typescript-enforcer/build/scanner.js

@@ -0,0 +1,114 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { checkNoAny } from './rules/no-any.js';
+import { checkGenerics } from './rules/generics.js';
+import { checkUtilityTypes } from './rules/utility-types.js';
+import { checkModifiers } from './rules/modifiers.js';
+import { checkTypeGuards } from './rules/type-guards.js';
+import { checkDiscriminatedUnions } from './rules/discriminated-unions.js';
+import { checkBrandedTypes } from './rules/branded-types.js';
+const RULES = {
+    'no-any': checkNoAny,
+    'generics': checkGenerics,
+    'utility-types': checkUtilityTypes,
+    'modifiers': checkModifiers,
+    'type-guards': checkTypeGuards,
+    'discriminated-unions': checkDiscriminatedUnions,
+    'branded-types': checkBrandedTypes,
+};
+export function scanFile(filePath, options = {}) {
+    const source = fs.readFileSync(filePath, 'utf-8');
+    const rulesToRun = options.rules || Object.keys(RULES);
+    const minSeverity = options.severity || 'info';
+    const severityOrder = { error: 0, warning: 1, info: 2 };
+    const minSeverityLevel = severityOrder[minSeverity] ?? 2;
+    const allViolations = [];
+    for (const ruleName of rulesToRun) {
+        const checker = RULES[ruleName];
+        if (checker) {
+            try {
+                const result = checker(source, filePath);
+                allViolations.push(...result.violations);
+            }
+            catch {
+                // Skip rules that fail on this file
+            }
+        }
+    }
+    const filtered = allViolations.filter(v => severityOrder[v.severity] <= minSeverityLevel);
+    filtered.sort((a, b) => a.line - b.line);
+    const errors = filtered.filter(v => v.severity === 'error').length;
+    const warnings = filtered.filter(v => v.severity === 'warning').length;
+    const infos = filtered.filter(v => v.severity === 'info').length;
+    let score = 10;
+    score -= errors * 2;
+    score -= warnings * 1;
+    score -= infos * 0.25;
+    score = Math.max(0, Math.round(score * 10) / 10);
+    return {
+        file: filePath,
+        violations: filtered,
+        summary: { errors, warnings, infos, total: filtered.length },
+        score,
+    };
+}
+function scanDirectoryRecursive(dir, options = {}) {
+    const files = [];
+    const ignorePatterns = options.ignore || ['node_modules', 'build', 'dist', '.next', '.git', '__tests__', '.test.', '.spec.', '.stories.'];
+    if (!fs.existsSync(dir))
+        return files;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (ignorePatterns.some(pattern => entry.name.includes(pattern)))
+            continue;
+        if (entry.isDirectory()) {
+            files.push(...scanDirectoryRecursive(fullPath, options));
+        }
+        else if (entry.name.match(/\.(ts|tsx|js|jsx)$/)) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+export function scanDirectory(dir, options = {}) {
+    let files = scanDirectoryRecursive(dir, options);
+    if (options.maxFiles && files.length > options.maxFiles) {
+        files = files.slice(0, options.maxFiles);
+    }
+    const results = [];
+    for (const file of files) {
+        try {
+            const result = scanFile(file, options);
+            if (result.summary.total > 0 || options.severity === undefined) {
+                results.push(result);
+            }
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    results.sort((a, b) => a.score - b.score);
+    const totalViolations = results.reduce((sum, r) => sum + r.summary.total, 0);
+    const totalErrors = results.reduce((sum, r) => sum + r.summary.errors, 0);
+    const totalWarnings = results.reduce((sum, r) => sum + r.summary.warnings, 0);
+    const totalInfos = results.reduce((sum, r) => sum + r.summary.infos, 0);
+    const byRule = {};
+    for (const result of results) {
+        for (const v of result.violations) {
+            byRule[v.rule] = (byRule[v.rule] || 0) + 1;
+        }
+    }
+    const sorted = [...results].sort((a, b) => a.score - b.score);
+    return {
+        directory: dir,
+        filesScanned: files.length,
+        totalViolations,
+        results,
+        worstFiles: sorted.slice(0, 10).map(r => ({ file: r.file, score: r.score, violations: r.summary.total })),
+        bestFiles: sorted.slice(-5).reverse().map(r => ({ file: r.file, score: r.score, violations: r.summary.total })),
+        byRule,
+        summary: { errors: totalErrors, warnings: totalWarnings, infos: totalInfos },
+    };
+}
+//# sourceMappingURL=scanner.js.map

package/tools/typescript-enforcer/build/scanner.js.map

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

package/tools/typescript-enforcer/build/scanner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scanner.test.d.ts.map

package/tools/typescript-enforcer/build/scanner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.test.d.ts","sourceRoot":"","sources":["../src/scanner.test.ts"],"names":[],"mappings":""}

package/tools/typescript-enforcer/build/scanner.test.js.map

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

package/tools/typescript-enforcer/build/types.d.ts

@@ -0,0 +1,55 @@
+export type RuleName = 'no-any' | 'generics' | 'utility-types' | 'modifiers' | 'type-guards' | 'discriminated-unions' | 'branded-types';
+export type Severity = 'error' | 'warning' | 'info';
+export interface Violation {
+    rule: RuleName;
+    severity: Severity;
+    line: number;
+    column: number;
+    current: string;
+    suggestion: string;
+    fix: string;
+    why: string;
+}
+export interface FileScanResult {
+    file: string;
+    violations: Violation[];
+    summary: {
+        errors: number;
+        warnings: number;
+        infos: number;
+        total: number;
+    };
+    score: number;
+}
+export interface DirectoryScanResult {
+    directory: string;
+    filesScanned: number;
+    totalViolations: number;
+    results: FileScanResult[];
+    worstFiles: {
+        file: string;
+        score: number;
+        violations: number;
+    }[];
+    bestFiles: {
+        file: string;
+        score: number;
+        violations: number;
+    }[];
+    byRule: Record<RuleName, number>;
+    summary: {
+        errors: number;
+        warnings: number;
+        infos: number;
+    };
+}
+export interface ScanOptions {
+    rules?: RuleName[];
+    severity?: Severity;
+    ignore?: string[];
+    maxFiles?: number;
+}
+export interface RuleCheckResult {
+    violations: Violation[];
+}
+//# sourceMappingURL=types.d.ts.map

package/tools/typescript-enforcer/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,UAAU,GACV,eAAe,GACf,WAAW,GACX,aAAa,GACb,sBAAsB,GACtB,eAAe,CAAC;AAEpB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB"}

package/tools/typescript-enforcer/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/tools/typescript-enforcer/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/tools/typescript-enforcer/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@mcp-showcase/typescript-enforcer",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./build/index.js",
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@mcp-showcase/shared": "*",
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  }
+}