qualm-a11y 1.0.0

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAmB/E"}

package/dist/parser.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTSX = parseTSX;
+const typescript_estree_1 = require("@typescript-eslint/typescript-estree");
+const types_1 = require("./types");
+function parseTSX(sourceCode, filePath) {
+    try {
+        return (0, typescript_estree_1.parse)(sourceCode, {
+            jsx: true,
+            loc: true,
+            range: true,
+            tokens: false,
+            comment: false,
+            errorOnUnknownASTType: false,
+            filePath,
+        });
+    }
+    catch (err) {
+        throw new types_1.QualmParserError(`Failed to parse ${filePath}: ${err.message}`, err.lineNumber ?? 0, err.column ?? 0, filePath);
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":";;AAIA,4BAmBC;AAvBD,4EAA6D;AAE7D,mCAA2C;AAE3C,SAAgB,QAAQ,CAAC,UAAkB,EAAE,QAAgB;IAC3D,IAAI,CAAC;QACH,OAAO,IAAA,yBAAK,EAAC,UAAU,EAAE;YACvB,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,IAAI;YACT,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,KAAK;YACd,qBAAqB,EAAE,KAAK;YAC5B,QAAQ;SACT,CAAqB,CAAC;IACzB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,wBAAgB,CACxB,mBAAmB,QAAQ,KAAK,GAAG,CAAC,OAAO,EAAE,EAC7C,GAAG,CAAC,UAAU,IAAI,CAAC,EACnB,GAAG,CAAC,MAAM,IAAI,CAAC,EACf,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/reporters/json.d.ts

@@ -0,0 +1,4 @@
+import { FileAnalysisResult, DiffResult } from '../types';
+export declare function renderJSON(results: FileAnalysisResult[]): string;
+export declare function renderDiffJSON(diff: DiffResult): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/reporters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/reporters/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE1D,wBAAgB,UAAU,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAWhE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEvD"}

package/dist/reporters/json.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderJSON = renderJSON;
+exports.renderDiffJSON = renderDiffJSON;
+function renderJSON(results) {
+    return JSON.stringify({
+        summary: {
+            scannedFiles: results.length,
+            totalViolations: results.reduce((a, r) => a + r.violations.length, 0),
+            globalSemanticScore: results.length > 0
+                ? results.reduce((a, r) => a + r.semanticScore, 0) / results.length
+                : 1.0
+        },
+        results
+    }, null, 2);
+}
+function renderDiffJSON(diff) {
+    return JSON.stringify(diff, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/reporters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/reporters/json.ts"],"names":[],"mappings":";;AAEA,gCAWC;AAED,wCAEC;AAfD,SAAgB,UAAU,CAAC,OAA6B;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,EAAE;YACP,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,mBAAmB,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;gBACrC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM;gBACnE,CAAC,CAAC,GAAG;SACR;QACD,OAAO;KACR,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,cAAc,CAAC,IAAgB;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/reporters/sarif.d.ts

@@ -0,0 +1,3 @@
+import { FileAnalysisResult } from '../types';
+export declare function renderSARIF(results: FileAnalysisResult[]): string;
+//# sourceMappingURL=sarif.d.ts.map

package/dist/reporters/sarif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../src/reporters/sarif.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAqCjE"}

package/dist/reporters/sarif.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSARIF = renderSARIF;
+const index_1 = require("../rules/index");
+function renderSARIF(results) {
+    const sarif = {
+        $schema: 'https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json',
+        version: '2.1.0',
+        runs: [{
+                tool: {
+                    driver: {
+                        name: 'qualm',
+                        version: '1.0.0',
+                        informationUri: 'https://doi.org/10.5281/zenodo.20482307',
+                        rules: index_1.activeRules.map(r => ({
+                            id: r.id,
+                            shortDescription: { text: r.meta.description },
+                            helpUri: r.meta.docsUrl ?? 'https://doi.org/10.5281/zenodo.20482307'
+                        }))
+                    }
+                },
+                results: results.flatMap(result => result.violations.map(v => ({
+                    ruleId: v.ruleId,
+                    level: v.severity === 'error' ? 'error' : v.severity === 'warning' ? 'warning' : 'note',
+                    message: { text: v.message },
+                    locations: [{
+                            physicalLocation: {
+                                artifactLocation: { uri: result.filePath },
+                                region: {
+                                    startLine: v.location.line,
+                                    startColumn: v.location.column + 1
+                                }
+                            }
+                        }]
+                })))
+            }]
+    };
+    return JSON.stringify(sarif, null, 2);
+}
+//# sourceMappingURL=sarif.js.map

package/dist/reporters/sarif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.js","sourceRoot":"","sources":["../../src/reporters/sarif.ts"],"names":[],"mappings":";;AAGA,kCAqCC;AAvCD,0CAA6C;AAE7C,SAAgB,WAAW,CAAC,OAA6B;IACvD,MAAM,KAAK,GAAG;QACZ,OAAO,EAAE,gGAAgG;QACzG,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,CAAC;gBACL,IAAI,EAAE;oBACJ,MAAM,EAAE;wBACN,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE,OAAO;wBAChB,cAAc,EAAE,yCAAyC;wBACzD,KAAK,EAAE,mBAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BAC3B,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;4BAC9C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,yCAAyC;yBACrE,CAAC,CAAC;qBACJ;iBACF;gBACD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAChC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;oBACvF,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;oBAC5B,SAAS,EAAE,CAAC;4BACV,gBAAgB,EAAE;gCAChB,gBAAgB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE;gCAC1C,MAAM,EAAE;oCACN,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;oCAC1B,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;iCACnC;6BACF;yBACF,CAAC;iBACH,CAAC,CAAC,CACJ;aACF,CAAC;KACH,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/reporters/terminal.d.ts

@@ -0,0 +1,5 @@
+import { FileAnalysisResult, DiffResult } from '../types';
+export declare function renderTerminal(results: FileAnalysisResult[]): void;
+export declare function renderDiffTerminal(diff: DiffResult): void;
+export declare function renderResearchMode(results: FileAnalysisResult[]): void;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/reporters/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/reporters/terminal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAA8C,MAAM,UAAU,CAAC;AAEtG,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI,CA+BlE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAqBzD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAiCtE"}

package/dist/reporters/terminal.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTerminal = renderTerminal;
+exports.renderDiffTerminal = renderDiffTerminal;
+exports.renderResearchMode = renderResearchMode;
+const chalk_1 = __importDefault(require("chalk"));
+const types_1 = require("../types");
+function renderTerminal(results) {
+    const totalViolations = results.reduce((a, r) => a + r.violations.length, 0);
+    const avgScore = results.length > 0
+        ? results.reduce((a, r) => a + r.semanticScore, 0) / results.length
+        : 1.0;
+    console.log(chalk_1.default.bold.cyan('\n qualm — Static Quality Analysis\n'));
+    console.log(`Scanned ${chalk_1.default.bold(String(results.length))} file(s) · ${chalk_1.default.bold(String(totalViolations))} violation(s) found\n`);
+    for (const result of results) {
+        if (result.violations.length === 0) {
+            console.log(chalk_1.default.green(`✓ ${result.filePath}`));
+            continue;
+        }
+        console.log(chalk_1.default.bold.white(`\n${result.filePath}`));
+        for (const v of result.violations) {
+            const icon = v.severity === 'error' ? chalk_1.default.red('✗') : chalk_1.default.yellow('⚠');
+            const loc = chalk_1.default.dim(`[${v.location.line}:${v.location.column}]`);
+            const cat = chalk_1.default.dim(`[${v.category}]`);
+            const sev = v.severity === 'error' ? chalk_1.default.red(v.severity) : chalk_1.default.yellow(v.severity);
+            console.log(`  ${icon} ${loc} ${cat} ${sev}: ${v.message}`);
+            console.log(`     ${chalk_1.default.cyan('→')} ${v.fixSuggestion}`);
+            if (v.snippet)
+                console.log(`     ${chalk_1.default.dim(v.snippet.trim().slice(0, 120))}`);
+        }
+    }
+    console.log(chalk_1.default.bold('\n📊 Summary — Sharma (2026) Taxonomy'));
+    console.log('─'.repeat(60));
+    console.log(`Mean Semantic Score    : ${chalk_1.default.bold(avgScore.toFixed(4))} ${chalk_1.default.dim('(paper baseline: treated-pre=0.989, treated-post=0.983)')}`);
+}
+function renderDiffTerminal(diff) {
+    const icon = diff.regressionDetected
+        ? chalk_1.default.red('REGRESSION DETECTED')
+        : chalk_1.default.green('✓ No regression');
+    console.log(`\n${icon} · ${diff.filePath}`);
+    console.log(`  Semantic Score: ${diff.before?.semanticScore.toFixed(4) ?? 'N/A'} → ${diff.after.semanticScore.toFixed(4)} (Δ ${diff.deltaSemanticScore.toFixed(4)})`);
+    console.log(`  Violations: ${diff.before?.violationsCount ?? 0} → ${diff.after.violationsCount}`);
+    if (diff.addedViolations.length > 0) {
+        console.log(chalk_1.default.red(`\n  Added violations (${diff.addedViolations.length}):`));
+        for (const v of diff.addedViolations) {
+            console.log(`    + [${v.category}] ${v.message}`);
+        }
+    }
+    if (diff.removedViolations.length > 0) {
+        console.log(chalk_1.default.green(`\n  Removed violations (${diff.removedViolations.length}):`));
+        for (const v of diff.removedViolations) {
+            console.log(`    - [${v.category}] ${v.message}`);
+        }
+    }
+}
+function renderResearchMode(results) {
+    console.log(chalk_1.default.bold.cyan('\nqualm Research Mode — Sharma (2026) Taxonomy\n'));
+    console.log('─'.repeat(80));
+    console.log(`${'Category'.padEnd(28)} | ${'Violations'.padEnd(12)} | ${'β (paper)'.padEnd(12)} | Weighted Score`);
+    console.log('─'.repeat(80));
+    const allViolations = results.flatMap(r => r.violations);
+    const totalBeta = Object.values(types_1.PAPER_BETA_COEFFICIENTS).reduce((a, b) => a + b, 0);
+    let compositeScore = 0;
+    for (const [category, beta] of Object.entries(types_1.PAPER_BETA_COEFFICIENTS)) {
+        const count = allViolations.filter(v => v.category === category).length;
+        const weight = beta / totalBeta;
+        const weighted = weight * count * 0.05;
+        compositeScore += weighted;
+        const betaStr = (beta >= 0 ? '+' : '') + beta.toFixed(3);
+        console.log(`${category.padEnd(28)} | ${String(count).padEnd(12)} | ${betaStr.padEnd(12)} | ${weighted.toFixed(4)}`);
+    }
+    console.log('─'.repeat(80));
+    const avgBaseline = results.length > 0
+        ? results.reduce((a, r) => a + r.semanticScore, 0) / results.length
+        : 1.0;
+    console.log(`${'Composite Regression Score'.padEnd(28)} | ${compositeScore.toFixed(4).padEnd(12)} | ${'Baseline'.padEnd(12)} | ${avgBaseline.toFixed(4)}`);
+    console.log('─'.repeat(80));
+    console.log(chalk_1.default.dim('Paper baseline (Table A1): treated-pre AST score = 0.989, treated-post = 0.983'));
+}
+//# sourceMappingURL=terminal.js.map

package/dist/reporters/terminal.js.map

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

package/dist/rules/aria-correctness.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types';
+export declare const ariaCorrectnessRule: Rule;
+//# sourceMappingURL=aria-correctness.d.ts.map

package/dist/rules/aria-correctness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-correctness.d.ts","sourceRoot":"","sources":["../../src/rules/aria-correctness.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAWhC,eAAO,MAAM,mBAAmB,EAAE,IA4CjC,CAAC"}

package/dist/rules/aria-correctness.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ariaCorrectnessRule = void 0;
+const BOOLEAN_ARIA_ATTRS = new Set([
+    'aria-expanded', 'aria-hidden', 'aria-checked', 'aria-selected',
+    'aria-pressed', 'aria-disabled', 'aria-invalid', 'aria-required',
+    'aria-multiselectable', 'aria-readonly', 'aria-busy', 'aria-modal',
+    'aria-atomic', 'aria-grabbed'
+]);
+const VALID_BOOLEAN_VALUES = new Set(['true', 'false']);
+exports.ariaCorrectnessRule = {
+    id: 'aria-correctness',
+    category: 'aria_correctness',
+    severity: 'error',
+    meta: {
+        description: 'Enforce valid ARIA attribute values per WAI-ARIA specification'
+    },
+    create(context) {
+        return {
+            JSXAttribute(node) {
+                const attrName = node.name.type === 'JSXIdentifier' ? node.name.name : null;
+                if (!attrName || !attrName.startsWith('aria-'))
+                    return;
+                if (!BOOLEAN_ARIA_ATTRS.has(attrName))
+                    return;
+                // Bare boolean attribute (e.g. aria-disabled with no value) is invalid —
+                // WAI-ARIA requires an explicit "true" or "false" string.
+                if (!node.value) {
+                    context.report({
+                        message: `${attrName} used as a bare boolean attribute. WAI-ARIA requires an explicit string value: "true" or "false".`,
+                        fixSuggestion: `Change to ${attrName}="true" to make the intent explicit and ensure assistive technology reads it correctly.`,
+                        location: context.getLoc(node),
+                        snippet: context.getSourceCode(node)
+                    });
+                    return;
+                }
+                if (node.value.type === 'Literal' &&
+                    typeof node.value.value === 'string') {
+                    if (!VALID_BOOLEAN_VALUES.has(node.value.value)) {
+                        context.report({
+                            message: `Invalid value "${node.value.value}" for ${attrName}. Boolean ARIA attributes only accept "true" or "false".`,
+                            fixSuggestion: `Change to ${attrName}="true" or ${attrName}="false", or use a dynamic expression like ${attrName}={isOpen ? "true" : "false"}.`,
+                            location: context.getLoc(node),
+                            snippet: context.getSourceCode(node)
+                        });
+                    }
+                }
+            }
+        };
+    }
+};
+//# sourceMappingURL=aria-correctness.js.map

package/dist/rules/aria-correctness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-correctness.js","sourceRoot":"","sources":["../../src/rules/aria-correctness.ts"],"names":[],"mappings":";;;AAGA,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe;IAC/D,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe;IAChE,sBAAsB,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY;IAClE,aAAa,EAAE,cAAc;CAC9B,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3C,QAAA,mBAAmB,GAAS;IACvC,EAAE,EAAE,kBAAkB;IACtB,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE;QACJ,WAAW,EAAE,gEAAgE;KAC9E;IACD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,YAAY,CAAC,IAA2B;gBACtC,MAAM,QAAQ,GACZ,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC7D,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;oBAAE,OAAO;gBAEvD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAAE,OAAO;gBAE9C,yEAAyE;gBACzE,0DAA0D;gBAC1D,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;oBAChB,OAAO,CAAC,MAAM,CAAC;wBACb,OAAO,EAAE,GAAG,QAAQ,mGAAmG;wBACvH,aAAa,EAAE,aAAa,QAAQ,yFAAyF;wBAC7H,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;wBAC9B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;qBACrC,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,IACE,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;oBAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EACpC,CAAC;oBACD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;wBAChD,OAAO,CAAC,MAAM,CAAC;4BACb,OAAO,EAAE,kBAAkB,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,QAAQ,0DAA0D;4BACtH,aAAa,EAAE,aAAa,QAAQ,cAAc,QAAQ,8CAA8C,QAAQ,+BAA+B;4BAC/I,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;4BAC9B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;yBACrC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/rules/complexity.d.ts

@@ -0,0 +1,4 @@
+import { TSESTree } from '@typescript-eslint/utils';
+import { ComplexityMetrics } from '../types';
+export declare function calculateComplexityMetrics(ast: TSESTree.Program, sourceCode: string): ComplexityMetrics;
+//# sourceMappingURL=complexity.d.ts.map

package/dist/rules/complexity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity.d.ts","sourceRoot":"","sources":["../../src/rules/complexity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAmC7C,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,QAAQ,CAAC,OAAO,EACrB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAwDnB"}

package/dist/rules/complexity.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateComplexityMetrics = calculateComplexityMetrics;
+const typescript_estree_1 = require("@typescript-eslint/typescript-estree");
+const CYCLOMATIC_NODES = new Set([
+    'IfStatement', 'ConditionalExpression', 'SwitchCase',
+    'ForStatement', 'ForInStatement', 'ForOfStatement',
+    'WhileStatement', 'DoWhileStatement', 'LogicalExpression',
+    'CatchClause'
+]);
+// Recursively compute max JSX nesting depth
+function jsxDepth(node) {
+    if (node.type === 'JSXElement') {
+        const childDepths = node.children.map(c => jsxDepth(c));
+        return 1 + (childDepths.length > 0 ? Math.max(...childDepths) : 0);
+    }
+    let max = 0;
+    for (const key of Object.keys(node)) {
+        const child = node[key];
+        if (child && typeof child === 'object') {
+            if (Array.isArray(child)) {
+                for (const item of child) {
+                    if (item && typeof item === 'object' && 'type' in item) {
+                        const d = jsxDepth(item);
+                        if (d > max)
+                            max = d;
+                    }
+                }
+            }
+            else if ('type' in child) {
+                const d = jsxDepth(child);
+                if (d > max)
+                    max = d;
+            }
+        }
+    }
+    return max;
+}
+function calculateComplexityMetrics(ast, sourceCode) {
+    let cyclomaticComplexity = 1;
+    let cognitiveComplexity = 0;
+    let nestingDepth = 0;
+    let nodeCount = 0;
+    let propsCount = 0;
+    // Track nesting via parent stack — simpleTraverse is enter-only, so we
+    // increment nesting when entering control flow nodes and use node.range
+    // to determine when we've "exited" them.
+    // Simpler: count nesting depth by tracking enter-only and resetting on
+    // function/component boundaries.
+    const nestingStack = [];
+    (0, typescript_estree_1.simpleTraverse)(ast, {
+        enter(node) {
+            nodeCount++;
+            if (CYCLOMATIC_NODES.has(node.type)) {
+                cyclomaticComplexity++;
+            }
+            // Cognitive complexity: add (1 + current nesting level) for control flow
+            if (node.type === 'IfStatement' ||
+                node.type === 'ForStatement' ||
+                node.type === 'WhileStatement' ||
+                node.type === 'ForOfStatement' ||
+                node.type === 'ForInStatement' ||
+                node.type === 'DoWhileStatement') {
+                cognitiveComplexity += 1 + nestingStack.length;
+                nestingStack.push(node.type);
+            }
+            if (node.type === 'JSXAttribute') {
+                propsCount++;
+            }
+        }
+    });
+    const linesOfCode = sourceCode.split('\n').length;
+    // Compute max JSX nesting depth via recursive walk
+    const maxJsxNestingDepth = jsxDepth(ast);
+    const propDrillingDepth = Math.max(0, maxJsxNestingDepth - 3);
+    return {
+        cyclomaticComplexity,
+        cognitiveComplexity,
+        maxJsxNestingDepth,
+        linesOfCode,
+        nodeCount,
+        propsCount,
+        propDrillingDepth
+    };
+}
+//# sourceMappingURL=complexity.js.map

package/dist/rules/complexity.js.map

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

package/dist/rules/document-structure.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types';
+export declare const documentStructureRule: Rule;
+//# sourceMappingURL=document-structure.d.ts.map

package/dist/rules/document-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-structure.d.ts","sourceRoot":"","sources":["../../src/rules/document-structure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAOhC,eAAO,MAAM,qBAAqB,EAAE,IA4CnC,CAAC"}

package/dist/rules/document-structure.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.documentStructureRule = void 0;
+const INTERACTIVE_EVENT_HANDLERS = new Set([
+    'onClick', 'onKeyDown', 'onKeyUp', 'onKeyPress',
+    'onFocus', 'onBlur', 'onMouseDown', 'onMouseUp'
+]);
+exports.documentStructureRule = {
+    id: 'document-structure',
+    category: 'document_structure',
+    severity: 'error',
+    meta: {
+        description: 'Enforce semantic HTML elements over generic containers with interactive handlers',
+        docsUrl: 'https://doi.org/10.5281/zenodo.20482307'
+    },
+    create(context) {
+        return {
+            JSXOpeningElement(node) {
+                const elementName = node.name.type === 'JSXIdentifier' ? node.name.name : null;
+                if (!elementName)
+                    return;
+                if (elementName !== 'div' && elementName !== 'span')
+                    return;
+                const attrs = node.attributes;
+                const hasInteractiveHandler = attrs.some(attr => {
+                    if (attr.type !== 'JSXAttribute')
+                        return false;
+                    const name = attr.name.type === 'JSXIdentifier' ? attr.name.name : null;
+                    return name !== null && INTERACTIVE_EVENT_HANDLERS.has(name);
+                });
+                if (!hasInteractiveHandler)
+                    return;
+                const hasRoleAttr = attrs.some(attr => {
+                    if (attr.type !== 'JSXAttribute')
+                        return false;
+                    const name = attr.name.type === 'JSXIdentifier' ? attr.name.name : null;
+                    return name === 'role';
+                });
+                if (hasRoleAttr)
+                    return;
+                context.report({
+                    message: `Generic <${elementName}> element has interactive event handler without semantic element or explicit role. This is the dominant AI-generated code quality failure mode identified in Sharma (2026).`,
+                    fixSuggestion: `Replace <${elementName}> with a semantic element like <button> for click handlers, or add role="button" with tabIndex={0} as a minimum. Prefer semantic HTML over role overrides.`,
+                    location: context.getLoc(node),
+                    snippet: context.getSourceCode(node)
+                });
+            }
+        };
+    }
+};
+//# sourceMappingURL=document-structure.js.map

package/dist/rules/document-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-structure.js","sourceRoot":"","sources":["../../src/rules/document-structure.ts"],"names":[],"mappings":";;;AAGA,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY;IAC/C,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW;CAChD,CAAC,CAAC;AAEU,QAAA,qBAAqB,GAAS;IACzC,EAAE,EAAE,oBAAoB;IACxB,QAAQ,EAAE,oBAAoB;IAC9B,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE;QACJ,WAAW,EAAE,kFAAkF;QAC/F,OAAO,EAAE,yCAAyC;KACnD;IACD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,iBAAiB,CAAC,IAAgC;gBAChD,MAAM,WAAW,GACf,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBAE7D,IAAI,CAAC,WAAW;oBAAE,OAAO;gBACzB,IAAI,WAAW,KAAK,KAAK,IAAI,WAAW,KAAK,MAAM;oBAAE,OAAO;gBAE5D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;gBAE9B,MAAM,qBAAqB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;wBAAE,OAAO,KAAK,CAAC;oBAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBACxE,OAAO,IAAI,KAAK,IAAI,IAAI,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC/D,CAAC,CAAC,CAAC;gBAEH,IAAI,CAAC,qBAAqB;oBAAE,OAAO;gBAEnC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACpC,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;wBAAE,OAAO,KAAK,CAAC;oBAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBACxE,OAAO,IAAI,KAAK,MAAM,CAAC;gBACzB,CAAC,CAAC,CAAC;gBAEH,IAAI,WAAW;oBAAE,OAAO;gBAExB,OAAO,CAAC,MAAM,CAAC;oBACb,OAAO,EAAE,YAAY,WAAW,6KAA6K;oBAC7M,aAAa,EAAE,YAAY,WAAW,4JAA4J;oBAClM,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;oBAC9B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;iBACrC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/rules/form-semantics.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types';
+export declare const formSemanticsRule: Rule;
+//# sourceMappingURL=form-semantics.d.ts.map

package/dist/rules/form-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-semantics.d.ts","sourceRoot":"","sources":["../../src/rules/form-semantics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAoBhC,eAAO,MAAM,iBAAiB,EAAE,IA8F/B,CAAC"}

package/dist/rules/form-semantics.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formSemanticsRule = void 0;
+const FORM_CONTROLS = new Set(['input', 'select', 'textarea']);
+// Walk up the parent chain to detect implicit label wrapping.
+// simpleTraverse doesn't set parent pointers, so we track the JSXElement
+// ancestor stack ourselves via JSXElement enter/exit using a set of range starts.
+function isInsideLabelElement(node, labelRanges) {
+    // We stored range[0] of every open <label> JSXElement that is currently open
+    // on the stack. If any open label's range contains this node's range, it's wrapped.
+    // Since simpleTraverse is single-pass enter-only in our analyser context, we
+    // instead record all label JSXElement ranges and check containment by range.
+    for (const labelStart of labelRanges) {
+        if (node.range && node.range[0] > labelStart) {
+            return true;
+        }
+    }
+    return false;
+}
+exports.formSemanticsRule = {
+    id: 'form-semantics',
+    category: 'form_semantics',
+    severity: 'error',
+    meta: {
+        description: 'Ensure form controls have associated label elements'
+    },
+    create(context) {
+        const labelHtmlFors = new Set();
+        const inputsWithIds = [];
+        // Track range[0] of every <label> JSXElement opening tag seen in the file.
+        // Used to detect implicit label wrapping (input inside <label>...</label>).
+        const labelElementRanges = [];
+        return {
+            JSXElement(node) {
+                const openingName = node.openingElement.name.type === 'JSXIdentifier'
+                    ? node.openingElement.name.name : null;
+                if (openingName === 'label' && node.range) {
+                    labelElementRanges.push({ start: node.range[0], end: node.range[1] });
+                }
+            },
+            JSXAttribute(node) {
+                const attrName = node.name.type === 'JSXIdentifier' ? node.name.name : null;
+                if (attrName !== 'htmlFor')
+                    return;
+                if (node.value?.type === 'Literal' &&
+                    typeof node.value.value === 'string') {
+                    labelHtmlFors.add(node.value.value);
+                }
+            },
+            JSXOpeningElement(node) {
+                const name = node.name.type === 'JSXIdentifier' ? node.name.name : null;
+                if (!name || !FORM_CONTROLS.has(name))
+                    return;
+                const hasAriaLabel = node.attributes.some(attr => {
+                    if (attr.type !== 'JSXAttribute')
+                        return false;
+                    const n = attr.name.type === 'JSXIdentifier' ? attr.name.name : null;
+                    return n === 'aria-label' || n === 'aria-labelledby';
+                });
+                if (hasAriaLabel)
+                    return;
+                // Implicit label: input is wrapped inside a <label> element
+                const isImplicitlyLabelled = node.range
+                    ? labelElementRanges.some(l => node.range[0] > l.start && node.range[0] < l.end)
+                    : false;
+                if (isImplicitlyLabelled)
+                    return;
+                const idAttr = node.attributes.find(attr => {
+                    if (attr.type !== 'JSXAttribute')
+                        return false;
+                    return attr.name.type === 'JSXIdentifier' && attr.name.name === 'id';
+                });
+                const idValue = idAttr?.value?.type === 'Literal' &&
+                    typeof idAttr.value.value === 'string'
+                    ? idAttr.value.value
+                    : null;
+                if (idValue) {
+                    inputsWithIds.push({ id: idValue, node });
+                }
+                else {
+                    context.report({
+                        message: `<${name}> has no associated label. Add a <label htmlFor="..."> or aria-label attribute.`,
+                        fixSuggestion: `Add an id to the <${name}> and a matching <label htmlFor="id"> element, or use aria-label="Description".`,
+                        location: context.getLoc(node),
+                        snippet: context.getSourceCode(node)
+                    });
+                }
+            },
+            'Program:exit'() {
+                for (const { id, node } of inputsWithIds) {
+                    if (!labelHtmlFors.has(id)) {
+                        const name = node.name.type === 'JSXIdentifier' ? node.name.name : 'input';
+                        context.report({
+                            message: `<${name} id="${id}"> has no associated <label htmlFor="${id}">. Form controls must be programmatically associated with labels.`,
+                            fixSuggestion: `Add <label htmlFor="${id}">Label text</label> before or after the form control.`,
+                            location: context.getLoc(node),
+                            snippet: context.getSourceCode(node)
+                        });
+                    }
+                }
+            }
+        };
+    }
+};
+//# sourceMappingURL=form-semantics.js.map

package/dist/rules/form-semantics.js.map

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

package/dist/rules/heading-hierarchy.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types';
+export declare const headingHierarchyRule: Rule;
+//# sourceMappingURL=heading-hierarchy.d.ts.map

package/dist/rules/heading-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-hierarchy.d.ts","sourceRoot":"","sources":["../../src/rules/heading-hierarchy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAIhC,eAAO,MAAM,oBAAoB,EAAE,IAkClC,CAAC"}