@hatem427/code-guard-ci 1.0.0

package/dist/scripts/utils/code-analyzer.js

@@ -0,0 +1,323 @@
+"use strict";
+/**
+ * ============================================================================
+ * code-analyzer.ts — Automatic documentation from TypeScript/React code
+ * ============================================================================
+ *
+ * Analyzes TypeScript/React components and extracts:
+ *   - Component props and their types
+ *   - JSDoc comments
+ *   - Default values
+ *   - Event handlers
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeComponent = analyzeComponent;
+exports.findComponentFile = findComponentFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ts_morph_1 = require("ts-morph");
+/**
+ * Analyze a TypeScript/React component file
+ */
+function analyzeComponent(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    const project = new ts_morph_1.Project({
+        compilerOptions: {
+            jsx: 1, // React JSX
+            target: 99, // ESNext
+            module: 99, // ESNext
+        },
+    });
+    const sourceFile = project.addSourceFileAtPath(filePath);
+    const fileName = path.basename(filePath, path.extname(filePath));
+    // Try to find component name and props
+    const componentInfo = extractComponentInfo(sourceFile, fileName);
+    if (!componentInfo) {
+        return null;
+    }
+    return {
+        name: componentInfo.name,
+        description: componentInfo.description,
+        props: componentInfo.props,
+        filePath,
+        isReactComponent: componentInfo.isReactComponent,
+    };
+}
+/**
+ * Extract component information from source file
+ */
+function extractComponentInfo(sourceFile, defaultName) {
+    let componentName = toPascalCase(defaultName);
+    let props = [];
+    let description;
+    let isReactComponent = false;
+    // Look for React component (function or arrow function)
+    const functionDeclarations = sourceFile.getFunctions();
+    const variableStatements = sourceFile.getVariableStatements();
+    // Check function declarations
+    for (const func of functionDeclarations) {
+        const name = func.getName();
+        if (name && /^[A-Z]/.test(name)) {
+            componentName = name;
+            isReactComponent = true;
+            description = extractJsDocComment(func);
+            // Extract props from parameters
+            const params = func.getParameters();
+            if (params.length > 0) {
+                const propsParam = params[0];
+                const typeNode = propsParam.getTypeNode();
+                if (typeNode) {
+                    props = extractPropsFromType(sourceFile, typeNode.getText());
+                }
+            }
+            break;
+        }
+    }
+    // Check variable declarations (arrow functions)
+    if (!isReactComponent) {
+        for (const statement of variableStatements) {
+            const declarations = statement.getDeclarations();
+            for (const decl of declarations) {
+                const name = decl.getName();
+                if (/^[A-Z]/.test(name)) {
+                    const initializer = decl.getInitializer();
+                    if (initializer && (initializer.getKindName() === 'ArrowFunction' || initializer.getKindName() === 'FunctionExpression')) {
+                        componentName = name;
+                        isReactComponent = true;
+                        description = extractJsDocComment(decl);
+                        // Extract props from arrow function parameters
+                        const arrowFunc = initializer.asKind(218); // ArrowFunction kind
+                        if (arrowFunc) {
+                            const params = arrowFunc.getParameters();
+                            if (params.length > 0) {
+                                const propsParam = params[0];
+                                const typeNode = propsParam.getTypeNode();
+                                if (typeNode) {
+                                    props = extractPropsFromType(sourceFile, typeNode.getText());
+                                }
+                            }
+                        }
+                        break;
+                    }
+                }
+            }
+            if (isReactComponent)
+                break;
+        }
+    }
+    // If still not found, look for props interface/type
+    if (props.length === 0) {
+        props = findPropsInterface(sourceFile, componentName);
+    }
+    return {
+        name: componentName,
+        description,
+        props,
+        isReactComponent,
+        filePath: sourceFile.getFilePath(),
+    };
+}
+/**
+ * Find props interface or type alias
+ */
+function findPropsInterface(sourceFile, componentName) {
+    const possibleNames = [
+        `${componentName}Props`,
+        `I${componentName}Props`,
+        `${componentName}Properties`,
+    ];
+    // Check interfaces
+    for (const interfaceDecl of sourceFile.getInterfaces()) {
+        const name = interfaceDecl.getName();
+        if (possibleNames.includes(name) || name.toLowerCase().includes('props')) {
+            return extractPropsFromInterface(interfaceDecl);
+        }
+    }
+    // Check type aliases
+    for (const typeAlias of sourceFile.getTypeAliases()) {
+        const name = typeAlias.getName();
+        if (possibleNames.includes(name) || name.toLowerCase().includes('props')) {
+            return extractPropsFromTypeAlias(typeAlias);
+        }
+    }
+    return [];
+}
+/**
+ * Extract props from interface declaration
+ */
+function extractPropsFromInterface(interfaceDecl) {
+    const props = [];
+    for (const prop of interfaceDecl.getProperties()) {
+        props.push(extractPropInfo(prop));
+    }
+    return props;
+}
+/**
+ * Extract props from type alias
+ */
+function extractPropsFromTypeAlias(typeAlias) {
+    const props = [];
+    const typeNode = typeAlias.getTypeNode();
+    if (typeNode && typeNode.getKindName() === 'TypeLiteral') {
+        const members = typeNode.getMembers();
+        for (const member of members) {
+            if (member.getKindName() === 'PropertySignature') {
+                props.push(extractPropInfo(member));
+            }
+        }
+    }
+    return props;
+}
+/**
+ * Extract props from type reference string
+ */
+function extractPropsFromType(sourceFile, typeName) {
+    // Remove generic brackets and get base type name
+    const baseType = typeName.replace(/<.*>/, '').trim();
+    // Find the interface or type
+    const interfaceDecl = sourceFile.getInterface(baseType);
+    if (interfaceDecl) {
+        return extractPropsFromInterface(interfaceDecl);
+    }
+    const typeAlias = sourceFile.getTypeAlias(baseType);
+    if (typeAlias) {
+        return extractPropsFromTypeAlias(typeAlias);
+    }
+    return [];
+}
+/**
+ * Extract individual prop information
+ */
+function extractPropInfo(prop) {
+    const name = prop.getName();
+    const type = prop.getType().getText();
+    const required = !prop.hasQuestionToken();
+    const description = extractJsDocComment(prop);
+    // Try to get default value
+    let defaultValue;
+    const initializer = prop.getInitializer();
+    if (initializer) {
+        defaultValue = initializer.getText();
+    }
+    return {
+        name,
+        type: simplifyType(type),
+        required,
+        defaultValue,
+        description,
+    };
+}
+/**
+ * Extract JSDoc comment
+ */
+function extractJsDocComment(node) {
+    try {
+        if (typeof node.getJsDocs !== 'function') {
+            return undefined;
+        }
+        const jsDocs = node.getJsDocs();
+        if (jsDocs && jsDocs.length > 0) {
+            const comment = jsDocs[0].getDescription().trim();
+            return comment || undefined;
+        }
+    }
+    catch (err) {
+        // Silently fail
+    }
+    return undefined;
+}
+/**
+ * Simplify complex type names for documentation
+ */
+function simplifyType(type) {
+    // Remove 'import("...")' wrapper
+    type = type.replace(/import\([^)]+\)\./g, '');
+    // Simplify React types
+    type = type.replace(/React\./g, '');
+    type = type.replace(/MouseEvent<.*?>/g, 'MouseEvent');
+    type = type.replace(/ChangeEvent<.*?>/g, 'ChangeEvent');
+    // Shorten long union types
+    if (type.length > 50 && type.includes('|')) {
+        const parts = type.split('|');
+        if (parts.length > 3) {
+            return `${parts.slice(0, 3).join(' | ')} | ...`;
+        }
+    }
+    return type;
+}
+/**
+ * Convert kebab-case or snake_case to PascalCase
+ */
+function toPascalCase(str) {
+    return str
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Search for component files in directory
+ */
+function findComponentFile(componentName, searchDir = process.cwd()) {
+    const possibleNames = [
+        componentName,
+        componentName.toLowerCase(),
+        componentName.replace(/([A-Z])/g, '-$1').toLowerCase().replace(/^-/, ''),
+    ];
+    const possibleExtensions = ['.tsx', '.ts', '.jsx', '.js'];
+    const possibleDirs = [
+        'src/components',
+        'components',
+        'src',
+        '.',
+    ];
+    for (const dir of possibleDirs) {
+        const fullDir = path.join(searchDir, dir);
+        if (!fs.existsSync(fullDir))
+            continue;
+        for (const name of possibleNames) {
+            for (const ext of possibleExtensions) {
+                const filePath = path.join(fullDir, name + ext);
+                if (fs.existsSync(filePath)) {
+                    return filePath;
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=code-analyzer.js.map

package/dist/scripts/utils/code-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-analyzer.js","sourceRoot":"","sources":["../../../scripts/utils/code-analyzer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBH,4CA8BC;AAqPD,8CA8BC;AAxUD,uCAAyB;AACzB,2CAA6B;AAC7B,uCAA8G;AAkB9G;;GAEG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,kBAAO,CAAC;QAC1B,eAAe,EAAE;YACf,GAAG,EAAE,CAAC,EAAE,YAAY;YACpB,MAAM,EAAE,EAAE,EAAE,SAAS;YACrB,MAAM,EAAE,EAAE,EAAE,SAAS;SACtB;KACF,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjE,uCAAuC;IACvC,MAAM,aAAa,GAAG,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEjE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,WAAW,EAAE,aAAa,CAAC,WAAW;QACtC,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,QAAQ;QACR,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,UAAsB,EAAE,WAAmB;IACvE,IAAI,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,KAAK,GAAe,EAAE,CAAC;IAC3B,IAAI,WAA+B,CAAC;IACpC,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,wDAAwD;IACxD,MAAM,oBAAoB,GAAG,UAAU,CAAC,YAAY,EAAE,CAAC;IACvD,MAAM,kBAAkB,GAAG,UAAU,CAAC,qBAAqB,EAAE,CAAC;IAE9D,8BAA8B;IAC9B,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,aAAa,GAAG,IAAI,CAAC;YACrB,gBAAgB,GAAG,IAAI,CAAC;YACxB,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAExC,gCAAgC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACpC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC7B,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC1C,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,GAAG,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;YAC3C,MAAM,YAAY,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC;YACjD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5B,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;oBAC1C,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,eAAe,IAAI,WAAW,CAAC,WAAW,EAAE,KAAK,oBAAoB,CAAC,EAAE,CAAC;wBACzH,aAAa,GAAG,IAAI,CAAC;wBACrB,gBAAgB,GAAG,IAAI,CAAC;wBACxB,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;wBAExC,+CAA+C;wBAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB;wBAChE,IAAI,SAAS,EAAE,CAAC;4BACd,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC;4BACzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gCACtB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gCAC7B,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;gCAC1C,IAAI,QAAQ,EAAE,CAAC;oCACb,KAAK,GAAG,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;gCAC/D,CAAC;4BACH,CAAC;wBACH,CAAC;wBACD,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,gBAAgB;gBAAE,MAAM;QAC9B,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,GAAG,kBAAkB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACxD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW;QACX,KAAK;QACL,gBAAgB;QAChB,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE;KACnC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,UAAsB,EAAE,aAAqB;IACvE,MAAM,aAAa,GAAG;QACpB,GAAG,aAAa,OAAO;QACvB,IAAI,aAAa,OAAO;QACxB,GAAG,aAAa,YAAY;KAC7B,CAAC;IAEF,mBAAmB;IACnB,KAAK,MAAM,aAAa,IAAI,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACzE,OAAO,yBAAyB,CAAC,aAAa,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACzE,OAAO,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,aAAmC;IACpE,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,aAAa,EAAE,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,SAA+B;IAChE,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAEzC,IAAI,QAAQ,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,aAAa,EAAE,CAAC;QACzD,MAAM,OAAO,GAAI,QAAgB,CAAC,UAAU,EAAE,CAAC;QAC/C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,UAAsB,EAAE,QAAgB;IACpE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAErD,6BAA6B;IAC7B,MAAM,aAAa,GAAG,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAuB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1C,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAE9C,2BAA2B;IAC3B,IAAI,YAAgC,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IAC1C,IAAI,WAAW,EAAE,CAAC;QAChB,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAED,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC;QACxB,QAAQ;QACR,YAAY;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAS;IACpC,IAAI,CAAC;QACH,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,CAAC;YAClD,OAAO,OAAO,IAAI,SAAS,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gBAAgB;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,iCAAiC;IACjC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAE9C,uBAAuB;IACvB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IACtD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;IAExD,2BAA2B;IAC3B,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG;SACP,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACzE,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,aAAqB,EAAE,YAAoB,OAAO,CAAC,GAAG,EAAE;IACxF,MAAM,aAAa,GAAG;QACpB,aAAa;QACb,aAAa,CAAC,WAAW,EAAE;QAC3B,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;KACzE,CAAC;IAEF,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG;QACnB,gBAAgB;QAChB,YAAY;QACZ,KAAK;QACL,GAAG;KACJ,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAEtC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;gBACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;gBAChD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5B,OAAO,QAAQ,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/scripts/utils/file-checker.d.ts

@@ -0,0 +1,93 @@
+/**
+ * ============================================================================
+ * file-checker.ts — Low-level file analysis utilities
+ * ============================================================================
+ *
+ * Provides helpers for reading staged files, counting lines, extracting
+ * template content, and running regex-based checks against source code.
+ * Used by the rule engine to apply individual lint rules.
+ */
+export interface FileInfo {
+    /** Absolute path to the file */
+    absolutePath: string;
+    /** Path relative to repo root */
+    relativePath: string;
+    /** File extension without the leading dot (e.g. "ts", "tsx", "html") */
+    extension: string;
+    /** Full file content (UTF-8) */
+    content: string;
+    /** Individual lines (1-indexed access via lines[lineNumber - 1]) */
+    lines: string[];
+    /** Total line count */
+    lineCount: number;
+}
+export interface CheckMatch {
+    /** 1-based line number where the match was found */
+    line: number;
+    /** The content of the matched line (trimmed) */
+    text: string;
+    /** Column offset (0-based) within the line */
+    column: number;
+}
+/**
+ * Returns the list of staged files (relative paths) using `git diff --cached`.
+ * Filters out deleted files (status "D") so we only check files that exist.
+ */
+export declare function getStagedFiles(): string[];
+/**
+ * Returns the current commit message from `.git/COMMIT_EDITMSG`.
+ * Falls back to empty string if unavailable.
+ */
+export declare function getCommitMessage(): string;
+/**
+ * Returns the current branch name.
+ */
+export declare function getCurrentBranch(): string;
+/**
+ * Read a single file and return a structured `FileInfo` object.
+ */
+export declare function readFileInfo(relativePath: string): FileInfo | null;
+/**
+ * Read multiple staged files, filtering by allowed extensions.
+ */
+export declare function readStagedFiles(extensions?: string[]): FileInfo[];
+/**
+ * Search a file's content for all matches of the given regex.
+ * Returns an array of matches with line numbers and text.
+ */
+export declare function findMatches(file: FileInfo, pattern: RegExp): CheckMatch[];
+/**
+ * Check if a file exceeds the maximum allowed line count.
+ */
+export declare function exceedsMaxLines(file: FileInfo, maxLines: number): boolean;
+/**
+ * Extract Angular inline template content from a component file.
+ * Looks for `template: \`...\`` blocks.
+ */
+export declare function extractInlineTemplate(file: FileInfo): {
+    content: string;
+    startLine: number;
+} | null;
+/**
+ * Extract content from Angular HTML template files.
+ * Returns the full file content for .html files associated with Angular components.
+ */
+export declare function extractExternalTemplate(file: FileInfo): string | null;
+/**
+ * Check if a file has a specific inline suppression comment.
+ * Supports: // code-guardian-disable <rule-id>
+ */
+export declare function hasInlineSuppression(file: FileInfo, ruleId: string, lineNumber: number): boolean;
+/**
+ * Detect whether a file contains JSX/TSX content (React templates).
+ */
+export declare function isJsxFile(file: FileInfo): boolean;
+/**
+ * Detect whether a file is an Angular component.
+ */
+export declare function isAngularComponent(file: FileInfo): boolean;
+/**
+ * Detect whether a file is a style file.
+ */
+export declare function isStyleFile(file: FileInfo): boolean;
+//# sourceMappingURL=file-checker.d.ts.map

package/dist/scripts/utils/file-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-checker.d.ts","sourceRoot":"","sources":["../../../scripts/utils/file-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAWzC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAczC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAoBlE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAiBjE;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CA0BzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAcnG;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAGrE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAkBhG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEnD"}

package/dist/scripts/utils/file-checker.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * ============================================================================
+ * file-checker.ts — Low-level file analysis utilities
+ * ============================================================================
+ *
+ * Provides helpers for reading staged files, counting lines, extracting
+ * template content, and running regex-based checks against source code.
+ * Used by the rule engine to apply individual lint rules.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStagedFiles = getStagedFiles;
+exports.getCommitMessage = getCommitMessage;
+exports.getCurrentBranch = getCurrentBranch;
+exports.readFileInfo = readFileInfo;
+exports.readStagedFiles = readStagedFiles;
+exports.findMatches = findMatches;
+exports.exceedsMaxLines = exceedsMaxLines;
+exports.extractInlineTemplate = extractInlineTemplate;
+exports.extractExternalTemplate = extractExternalTemplate;
+exports.hasInlineSuppression = hasInlineSuppression;
+exports.isJsxFile = isJsxFile;
+exports.isAngularComponent = isAngularComponent;
+exports.isStyleFile = isStyleFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+// ── Git helpers ─────────────────────────────────────────────────────────────
+/**
+ * Returns the list of staged files (relative paths) using `git diff --cached`.
+ * Filters out deleted files (status "D") so we only check files that exist.
+ */
+function getStagedFiles() {
+    try {
+        const output = (0, child_process_1.execSync)('git diff --cached --name-only --diff-filter=d', {
+            encoding: 'utf-8',
+        }).trim();
+        if (!output)
+            return [];
+        return output.split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Returns the current commit message from `.git/COMMIT_EDITMSG`.
+ * Falls back to empty string if unavailable.
+ */
+function getCommitMessage() {
+    try {
+        // During a pre-commit hook the message file may not exist yet.
+        // We also support reading from the HUSKY_GIT_PARAMS env.
+        const msgFile = path.join(process.cwd(), '.git', 'COMMIT_EDITMSG');
+        if (fs.existsSync(msgFile)) {
+            return fs.readFileSync(msgFile, 'utf-8').trim();
+        }
+        // Fallback: try getting the last commit message (for post-commit uses)
+        return (0, child_process_1.execSync)('git log -1 --pretty=%B 2>/dev/null', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Returns the current branch name.
+ */
+function getCurrentBranch() {
+    try {
+        return (0, child_process_1.execSync)('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+// ── File reading ────────────────────────────────────────────────────────────
+/**
+ * Read a single file and return a structured `FileInfo` object.
+ */
+function readFileInfo(relativePath) {
+    const absolutePath = path.resolve(process.cwd(), relativePath);
+    if (!fs.existsSync(absolutePath))
+        return null;
+    try {
+        const content = fs.readFileSync(absolutePath, 'utf-8');
+        const lines = content.split('\n');
+        return {
+            absolutePath,
+            relativePath,
+            extension: path.extname(relativePath).replace(/^\./, ''),
+            content,
+            lines,
+            lineCount: lines.length,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read multiple staged files, filtering by allowed extensions.
+ */
+function readStagedFiles(extensions) {
+    const staged = getStagedFiles();
+    const files = [];
+    for (const rel of staged) {
+        const ext = path.extname(rel).replace(/^\./, '');
+        // Skip files that don't match the allowed extensions
+        if (extensions && extensions.length > 0 && !extensions.includes(ext)) {
+            continue;
+        }
+        const info = readFileInfo(rel);
+        if (info)
+            files.push(info);
+    }
+    return files;
+}
+// ── Content checks ──────────────────────────────────────────────────────────
+/**
+ * Search a file's content for all matches of the given regex.
+ * Returns an array of matches with line numbers and text.
+ */
+function findMatches(file, pattern) {
+    const matches = [];
+    for (let i = 0; i < file.lines.length; i++) {
+        const line = file.lines[i];
+        // Skip lines that are comments
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*')) {
+            continue;
+        }
+        // Reset lastIndex for global regexps
+        pattern.lastIndex = 0;
+        const match = pattern.exec(line);
+        if (match) {
+            matches.push({
+                line: i + 1, // 1-based
+                text: trimmed,
+                column: match.index,
+            });
+        }
+    }
+    return matches;
+}
+/**
+ * Check if a file exceeds the maximum allowed line count.
+ */
+function exceedsMaxLines(file, maxLines) {
+    return file.lineCount > maxLines;
+}
+/**
+ * Extract Angular inline template content from a component file.
+ * Looks for `template: \`...\`` blocks.
+ */
+function extractInlineTemplate(file) {
+    const templateRegex = /template\s*:\s*`([\s\S]*?)`/;
+    const match = templateRegex.exec(file.content);
+    if (!match)
+        return null;
+    // Find the line number where the template starts
+    const before = file.content.substring(0, match.index);
+    const startLine = before.split('\n').length;
+    return {
+        content: match[1],
+        startLine,
+    };
+}
+/**
+ * Extract content from Angular HTML template files.
+ * Returns the full file content for .html files associated with Angular components.
+ */
+function extractExternalTemplate(file) {
+    if (file.extension !== 'html')
+        return null;
+    return file.content;
+}
+/**
+ * Check if a file has a specific inline suppression comment.
+ * Supports: // code-guardian-disable <rule-id>
+ */
+function hasInlineSuppression(file, ruleId, lineNumber) {
+    // Check the line itself
+    if (file.lines[lineNumber - 1]?.includes(`code-guardian-disable ${ruleId}`)) {
+        return true;
+    }
+    // Check the line above
+    if (lineNumber > 1 && file.lines[lineNumber - 2]?.includes(`code-guardian-disable ${ruleId}`)) {
+        return true;
+    }
+    // Check file-level suppression at the top of the file
+    const firstLines = file.lines.slice(0, 5).join('\n');
+    if (firstLines.includes(`code-guardian-disable-file ${ruleId}`)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Detect whether a file contains JSX/TSX content (React templates).
+ */
+function isJsxFile(file) {
+    return ['jsx', 'tsx'].includes(file.extension);
+}
+/**
+ * Detect whether a file is an Angular component.
+ */
+function isAngularComponent(file) {
+    return file.content.includes('@Component') && ['ts'].includes(file.extension);
+}
+/**
+ * Detect whether a file is a style file.
+ */
+function isStyleFile(file) {
+    return ['css', 'scss', 'sass', 'less'].includes(file.extension);
+}
+//# sourceMappingURL=file-checker.js.map