a11ylens 0.1.0

package/dist/scanner/fileWalker.js

@@ -0,0 +1,126 @@
+"use strict";
+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.defaultWalkOptions = exports.fileSystemWalker = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const fileSystemWalker = (rootDirs, options) => {
+    const results = [];
+    for (const root of rootDirs) {
+        if (!fs.existsSync(root))
+            continue;
+        let stat;
+        try {
+            stat = fs.statSync(root);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        const resolvedPath = path.resolve(root);
+        walkDirectory(resolvedPath, options, results);
+    }
+    return results;
+};
+exports.fileSystemWalker = fileSystemWalker;
+const defaultWalkOptions = (config) => ({
+    includePatterns: config.includePatterns,
+    ignoreDirs: config.ignoreDirs,
+    ignorePatterns: config.ignorePatterns
+});
+exports.defaultWalkOptions = defaultWalkOptions;
+const walkDirectory = (currentDir, options, results) => {
+    if (shouldIgnorePath(currentDir, options))
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(currentDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(currentDir, entry.name);
+        if (entry.isDirectory()) {
+            walkDirectory(fullPath, options, results);
+        }
+        else if (entry.isFile()) {
+            if (matchesPattern(entry.name, options.includePatterns) &&
+                !shouldIgnorePath(fullPath, options)) {
+                results.push(fullPath);
+            }
+        }
+    }
+};
+const shouldIgnorePath = (p, options) => {
+    const normalized = path.resolve(p);
+    const parts = normalized.split(path.sep);
+    for (const dirName of options.ignoreDirs) {
+        if (parts.includes(dirName))
+            return true;
+    }
+    if (options.ignorePatterns.length > 0) {
+        const normalizedPath = normalized.replace(/\\/g, "/");
+        for (const pattern of options.ignorePatterns) {
+            if (simpleMatch(normalizedPath, pattern) || simpleMatch(path.basename(normalized), pattern)) {
+                return true;
+            }
+        }
+    }
+    return false;
+};
+const matchesPattern = (fileName, patterns) => {
+    for (const pattern of patterns) {
+        if (simpleMatch(fileName, pattern))
+            return true;
+    }
+    return false;
+};
+const simpleMatch = (value, pattern) => {
+    if (pattern === "*")
+        return true;
+    const starIndex = pattern.indexOf("*");
+    if (starIndex === -1) {
+        return value === pattern || value.endsWith(pattern);
+    }
+    const first = pattern.slice(0, starIndex);
+    const last = pattern.slice(starIndex + 1);
+    if (first.length > 0 && !value.startsWith(first))
+        return false;
+    if (last.length > 0 && !value.endsWith(last))
+        return false;
+    return true;
+};

package/dist/scanner/styleExtractor.d.ts

@@ -0,0 +1,13 @@
+import type { Issue } from "../types/results";
+export interface StyleSource {
+    id: string;
+    filePath: string;
+    content: string;
+    kind: "external" | "inline";
+    originFilePath: string;
+}
+export interface StyleExtractionResult {
+    styles: StyleSource[];
+    issues: Issue[];
+}
+export declare const extractStyles: (filePath: string, content: string) => StyleExtractionResult;

package/dist/scanner/styleExtractor.js

@@ -0,0 +1,95 @@
+"use strict";
+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.extractStyles = void 0;
+const path = __importStar(require("path"));
+const fileAnalyzer_1 = require("./fileAnalyzer");
+const extractStringLiterals = (value) => {
+    const matches = [];
+    const regex = /([`'"])([\s\S]*?)\1/g;
+    let match = null;
+    while ((match = regex.exec(value)) !== null) {
+        matches.push(match[2]);
+    }
+    return matches;
+};
+const extractStyles = (filePath, content) => {
+    const styles = [];
+    const issues = [];
+    if (!filePath.endsWith(".component.ts")) {
+        return { styles, issues };
+    }
+    const styleUrlsMatch = content.match(/styleUrls\s*:\s*\[([\s\S]*?)\]/);
+    if (styleUrlsMatch) {
+        const paths = extractStringLiterals(styleUrlsMatch[1]);
+        for (const stylePath of paths) {
+            const resolved = path.resolve(path.dirname(filePath), stylePath);
+            const styleContent = (0, fileAnalyzer_1.readFileContent)(resolved);
+            if (!styleContent) {
+                issues.push({
+                    ruleId: "style-extraction",
+                    message: `Unable to read styleUrl file: ${resolved}`,
+                    filePath,
+                    severity: "warn"
+                });
+                continue;
+            }
+            styles.push({
+                id: resolved,
+                filePath: resolved,
+                content: styleContent,
+                kind: "external",
+                originFilePath: filePath
+            });
+        }
+    }
+    const stylesMatch = content.match(/styles\s*:\s*\[([\s\S]*?)\]/);
+    if (stylesMatch) {
+        const inlineStyles = extractStringLiterals(stylesMatch[1]);
+        let index = 0;
+        for (const inline of inlineStyles) {
+            styles.push({
+                id: `${filePath}#inline-style-${index}`,
+                filePath,
+                content: inline,
+                kind: "inline",
+                originFilePath: filePath
+            });
+            index += 1;
+        }
+    }
+    return { styles, issues };
+};
+exports.extractStyles = extractStyles;

package/dist/scanner/templateExtractor.d.ts

@@ -0,0 +1,13 @@
+import type { Issue } from "../types/results";
+export interface TemplateSource {
+    id: string;
+    filePath: string;
+    content: string;
+    kind: "external" | "inline";
+    originFilePath: string;
+}
+export interface TemplateExtractionResult {
+    templates: TemplateSource[];
+    issues: Issue[];
+}
+export declare const extractTemplates: (filePath: string, content: string) => TemplateExtractionResult;

package/dist/scanner/templateExtractor.js

@@ -0,0 +1,101 @@
+"use strict";
+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.extractTemplates = void 0;
+const path = __importStar(require("path"));
+const fileAnalyzer_1 = require("./fileAnalyzer");
+const extractTemplates = (filePath, content) => {
+    const templates = [];
+    const issues = [];
+    if (filePath.endsWith(".component.html")) {
+        templates.push({
+            id: filePath,
+            filePath,
+            content,
+            kind: "external",
+            originFilePath: filePath
+        });
+        return { templates, issues };
+    }
+    if (!filePath.endsWith(".component.ts")) {
+        return { templates, issues };
+    }
+    const templateRegex = /template\s*:\s*([`'"])([\s\S]*?)\1/g;
+    let match = null;
+    let inlineIndex = 0;
+    while ((match = templateRegex.exec(content)) !== null) {
+        const inlineContent = match[2];
+        templates.push({
+            id: `${filePath}#inline-${inlineIndex}`,
+            filePath,
+            content: inlineContent,
+            kind: "inline",
+            originFilePath: filePath
+        });
+        inlineIndex += 1;
+    }
+    const templateUrlRegex = /templateUrl\s*:\s*([`'"])([^`'"]+)\1/g;
+    while ((match = templateUrlRegex.exec(content)) !== null) {
+        const templateUrl = match[2];
+        const resolved = path.resolve(path.dirname(filePath), templateUrl);
+        const externalContent = (0, fileAnalyzer_1.readFileContent)(resolved);
+        if (!externalContent) {
+            issues.push({
+                ruleId: "template-extraction",
+                message: `Unable to read templateUrl file: ${resolved}`,
+                filePath,
+                severity: "warn"
+            });
+            continue;
+        }
+        templates.push({
+            id: resolved,
+            filePath: resolved,
+            content: externalContent,
+            kind: "external",
+            originFilePath: filePath
+        });
+    }
+    if (templates.length === 0) {
+        issues.push({
+            ruleId: "template-extraction",
+            message: "No Angular templates found in component file.",
+            filePath,
+            severity: "info"
+        });
+    }
+    return { templates, issues };
+};
+exports.extractTemplates = extractTemplates;

package/dist/types/config.d.ts

@@ -0,0 +1,9 @@
+export type OutputFormat = "console" | "json" | "sarif";
+export interface A11yLensConfig {
+    includePatterns: string[];
+    ignoreDirs: string[];
+    ignorePatterns: string[];
+    styleFiles: string[];
+    minScore?: number;
+}
+export type A11yLensConfigOverrides = Partial<A11yLensConfig>;

package/dist/types/config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/results.d.ts

@@ -0,0 +1,22 @@
+export type Severity = "info" | "warn" | "error";
+export interface Issue {
+    ruleId: string;
+    message: string;
+    filePath: string;
+    line?: number;
+    column?: number;
+    severity: Severity;
+}
+export interface FileScanResult {
+    filePath: string;
+    issues: Issue[];
+}
+export interface ProjectScanResult {
+    files: FileScanResult[];
+    score: number;
+    totals: {
+        error: number;
+        warn: number;
+        info: number;
+    };
+}

package/dist/types/results.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/rules.d.ts

@@ -0,0 +1,14 @@
+import type { Issue, Severity } from "./results";
+import type { RootNode } from "../parser/ast";
+import type { StyleLookup } from "./style";
+export interface RuleContext {
+    filePath: string;
+    source: string;
+    styleLookup?: StyleLookup;
+}
+export interface Rule {
+    id: string;
+    description: string;
+    severity: Severity;
+    check: (ast: RootNode, context: RuleContext) => Issue[];
+}

package/dist/types/rules.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/style.d.ts

@@ -0,0 +1,9 @@
+export interface StyleDeclaration {
+    color?: string;
+    backgroundColor?: string;
+    fontSize?: string;
+    fontWeight?: string;
+}
+export interface StyleLookup {
+    getStyleFor: (node: import("../parser/ast").ElementNode) => StyleDeclaration;
+}

package/dist/types/style.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "a11ylens",
+  "version": "0.1.0",
+  "description": "Static accessibility scanner for Angular component templates.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "bin": {
+    "a11ylens": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "npm run build -- --watch",
+    "test": "npm run build",
+    "lint": "echo \"No lint configured\""
+  },
+  "keywords": [
+    "accessibility",
+    "a11y",
+    "scanner",
+    "audit",
+    "angular",
+    "html",
+    "static-analysis",
+    "cli"
+  ],
+  "author": "Madhan Monish Jayakumar",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/madhanmonishj/a11ylens.git"
+  },
+  "bugs": {
+    "url": "https://github.com/madhanmonishj/a11ylens/issues"
+  },
+  "homepage": "https://github.com/madhanmonishj/a11ylens#readme",
+  "files": [
+    "dist/index.js",
+    "dist/index.d.ts",
+    "dist/cli/",
+    "dist/config/",
+    "dist/engine/",
+    "dist/parser/",
+    "dist/reporters/",
+    "dist/rules/",
+    "dist/scanner/",
+    "dist/types/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.2",
+    "typescript": "^5.9.3"
+  }
+}