qualm-a11y 1.0.0

package/dist/rules/heading-hierarchy.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.headingHierarchyRule = void 0;
+const HEADING_TAGS = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6']);
+exports.headingHierarchyRule = {
+    id: 'heading-hierarchy',
+    category: 'heading_hierarchy',
+    severity: 'warning',
+    meta: {
+        description: 'Enforce sequential heading levels without skipping ranks'
+    },
+    create(context) {
+        const headings = [];
+        return {
+            JSXOpeningElement(node) {
+                const name = node.name.type === 'JSXIdentifier' ? node.name.name : null;
+                if (!name || !HEADING_TAGS.has(name))
+                    return;
+                const level = parseInt(name[1], 10);
+                headings.push({ level, node });
+                if (headings.length < 2)
+                    return;
+                const prev = headings[headings.length - 2];
+                const curr = headings[headings.length - 1];
+                if (curr.level > prev.level + 1) {
+                    context.report({
+                        message: `Heading level skipped: <h${prev.level}> followed by <h${curr.level}>. Screen readers rely on sequential heading structure for navigation.`,
+                        fixSuggestion: `Change <h${curr.level}> to <h${prev.level + 1}> to maintain sequential hierarchy.`,
+                        location: context.getLoc(node),
+                        snippet: context.getSourceCode(node)
+                    });
+                }
+            }
+        };
+    }
+};
+//# sourceMappingURL=heading-hierarchy.js.map

package/dist/rules/heading-hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-hierarchy.js","sourceRoot":"","sources":["../../src/rules/heading-hierarchy.ts"],"names":[],"mappings":";;;AAGA,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEtD,QAAA,oBAAoB,GAAS;IACxC,EAAE,EAAE,mBAAmB;IACvB,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE;QACJ,WAAW,EAAE,0DAA0D;KACxE;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,QAAQ,GAA0D,EAAE,CAAC;QAE3E,OAAO;YACL,iBAAiB,CAAC,IAAgC;gBAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBACxE,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,OAAO;gBAE7C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAE/B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO;gBAEhC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAE3C,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;oBAChC,OAAO,CAAC,MAAM,CAAC;wBACb,OAAO,EAAE,4BAA4B,IAAI,CAAC,KAAK,mBAAmB,IAAI,CAAC,KAAK,wEAAwE;wBACpJ,aAAa,EAAE,YAAY,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,GAAG,CAAC,qCAAqC;wBAClG,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;wBAC9B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;qBACrC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/rules/index.d.ts

@@ -0,0 +1,4 @@
+import { Rule } from '../types';
+export declare const activeRules: Rule[];
+export { calculateComplexityMetrics } from './complexity';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAQhC,eAAO,MAAM,WAAW,EAAE,IAAI,EAO7B,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC"}

package/dist/rules/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateComplexityMetrics = exports.activeRules = void 0;
+const document_structure_1 = require("./document-structure");
+const heading_hierarchy_1 = require("./heading-hierarchy");
+const landmark_structure_1 = require("./landmark-structure");
+const interactive_semantics_1 = require("./interactive-semantics");
+const aria_correctness_1 = require("./aria-correctness");
+const form_semantics_1 = require("./form-semantics");
+exports.activeRules = [
+    document_structure_1.documentStructureRule,
+    heading_hierarchy_1.headingHierarchyRule,
+    landmark_structure_1.landmarkStructureRule,
+    interactive_semantics_1.interactiveSemanticsRule,
+    aria_correctness_1.ariaCorrectnessRule,
+    form_semantics_1.formSemanticsRule
+];
+var complexity_1 = require("./complexity");
+Object.defineProperty(exports, "calculateComplexityMetrics", { enumerable: true, get: function () { return complexity_1.calculateComplexityMetrics; } });
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":";;;AACA,6DAA6D;AAC7D,2DAA2D;AAC3D,6DAA6D;AAC7D,mEAAmE;AACnE,yDAAyD;AACzD,qDAAqD;AAExC,QAAA,WAAW,GAAW;IACjC,0CAAqB;IACrB,wCAAoB;IACpB,0CAAqB;IACrB,gDAAwB;IACxB,sCAAmB;IACnB,kCAAiB;CAClB,CAAC;AAEF,2CAA0D;AAAjD,wHAAA,0BAA0B,OAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-semantics.d.ts","sourceRoot":"","sources":["../../src/rules/interactive-semantics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,eAAO,MAAM,wBAAwB,EAAE,IAoEtC,CAAC"}

package/dist/rules/interactive-semantics.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.interactiveSemanticsRule = void 0;
+exports.interactiveSemanticsRule = {
+    id: 'interactive-semantics',
+    category: 'interactive_semantics',
+    severity: 'error',
+    meta: {
+        description: 'Ensure interactive and media elements have accessible names'
+    },
+    create(context) {
+        return {
+            JSXOpeningElement(node) {
+                const name = node.name.type === 'JSXIdentifier' ? node.name.name : null;
+                if (!name)
+                    return;
+                if (name === 'img') {
+                    const hasAlt = node.attributes.some(attr => {
+                        if (attr.type !== 'JSXAttribute')
+                            return false;
+                        return attr.name.type === 'JSXIdentifier' && attr.name.name === 'alt';
+                    });
+                    if (!hasAlt) {
+                        context.report({
+                            message: 'Image element is missing an alt attribute. Screen readers cannot describe this image to users.',
+                            fixSuggestion: 'Add alt="descriptive text" for informative images, or alt="" for decorative images.',
+                            location: context.getLoc(node),
+                            snippet: context.getSourceCode(node)
+                        });
+                    }
+                }
+            },
+            JSXElement(node) {
+                const opening = node.openingElement;
+                const name = opening.name.type === 'JSXIdentifier' ? opening.name.name : null;
+                if (name !== 'button')
+                    return;
+                const hasAriaLabel = opening.attributes.some(attr => {
+                    if (attr.type !== 'JSXAttribute')
+                        return false;
+                    const attrName = attr.name.type === 'JSXIdentifier' ? attr.name.name : null;
+                    return attrName === 'aria-label' || attrName === 'aria-labelledby';
+                });
+                if (hasAriaLabel)
+                    return;
+                const hasTextChild = node.children.some(child => child.type === 'JSXText' && child.value.trim().length > 0);
+                if (hasTextChild)
+                    return;
+                const hasOnlyNonTextChildren = node.children.length > 0 &&
+                    node.children.every(child => child.type === 'JSXElement' ||
+                        child.type === 'JSXExpressionContainer' ||
+                        (child.type === 'JSXText' && child.value.trim() === ''));
+                if (hasOnlyNonTextChildren) {
+                    context.report({
+                        message: 'Button appears to contain only icon components without visible text. Add aria-label to describe the button action.',
+                        fixSuggestion: 'Add aria-label="Description of action" to the button element.',
+                        location: context.getLoc(opening),
+                        snippet: context.getSourceCode(opening)
+                    });
+                }
+            }
+        };
+    }
+};
+//# sourceMappingURL=interactive-semantics.js.map

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

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

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

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

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

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

package/dist/rules/landmark-structure.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.landmarkStructureRule = void 0;
+const LANDMARK_PATTERNS = [
+    { pattern: /\bnav(igation|bar)?\b/i, suggestion: '<nav>' },
+    { pattern: /\b(header|masthead|banner)\b/i, suggestion: '<header>' },
+    { pattern: /\b(footer|foot)\b/i, suggestion: '<footer>' },
+    { pattern: /\b(main|primary-content|page-content)\b/i, suggestion: '<main>' },
+    { pattern: /\b(aside|sidebar|complementary)\b/i, suggestion: '<aside>' },
+    { pattern: /\b(article|post|entry|blog-post)\b/i, suggestion: '<article>' },
+];
+function getAttrStringValue(attr) {
+    if (!attr.value)
+        return null;
+    if (attr.value.type === 'Literal' && typeof attr.value.value === 'string') {
+        return attr.value.value;
+    }
+    return null;
+}
+exports.landmarkStructureRule = {
+    id: 'landmark-structure',
+    category: 'landmark_structure',
+    severity: 'warning',
+    meta: {
+        description: 'Replace generic containers that serve landmark roles with semantic HTML5 elements'
+    },
+    create(context) {
+        return {
+            JSXOpeningElement(node) {
+                const name = node.name.type === 'JSXIdentifier' ? node.name.name : null;
+                if (name !== 'div' && name !== 'span')
+                    return;
+                for (const attr of node.attributes) {
+                    if (attr.type !== 'JSXAttribute')
+                        continue;
+                    const attrName = attr.name.type === 'JSXIdentifier' ? attr.name.name : null;
+                    // Only match className — id values are too often scroll anchors or JS hooks
+                    // (e.g. id="onboarding-checklist-header") and produce false positives.
+                    if (attrName !== 'className')
+                        continue;
+                    const value = getAttrStringValue(attr);
+                    if (!value)
+                        continue;
+                    for (const { pattern, suggestion } of LANDMARK_PATTERNS) {
+                        if (pattern.test(value)) {
+                            context.report({
+                                message: `<${name} ${attrName}="${value}"> appears to serve a landmark role. Use the semantic element ${suggestion} instead.`,
+                                fixSuggestion: `Replace <${name}> with ${suggestion} to provide explicit landmark navigation for assistive technology users.`,
+                                location: context.getLoc(node),
+                                snippet: context.getSourceCode(node)
+                            });
+                            return;
+                        }
+                    }
+                }
+            }
+        };
+    }
+};
+//# sourceMappingURL=landmark-structure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"landmark-structure.js","sourceRoot":"","sources":["../../src/rules/landmark-structure.ts"],"names":[],"mappings":";;;AAGA,MAAM,iBAAiB,GAA8C;IACnE,EAAE,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,OAAO,EAAE;IAC1D,EAAE,OAAO,EAAE,+BAA+B,EAAE,UAAU,EAAE,UAAU,EAAE;IACpE,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,EAAE;IACzD,EAAE,OAAO,EAAE,0CAA0C,EAAE,UAAU,EAAE,QAAQ,EAAE;IAC7E,EAAE,OAAO,EAAE,oCAAoC,EAAE,UAAU,EAAE,SAAS,EAAE;IACxE,EAAE,OAAO,EAAE,qCAAqC,EAAE,UAAU,EAAE,WAAW,EAAE;CAC5E,CAAC;AAEF,SAAS,kBAAkB,CAAC,IAA2B;IACrD,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAEY,QAAA,qBAAqB,GAAS;IACzC,EAAE,EAAE,oBAAoB;IACxB,QAAQ,EAAE,oBAAoB;IAC9B,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE;QACJ,WAAW,EAAE,mFAAmF;KACjG;IACD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,iBAAiB,CAAC,IAAgC;gBAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBACxE,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM;oBAAE,OAAO;gBAE9C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACnC,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;wBAAE,SAAS;oBAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC5E,4EAA4E;oBAC5E,uEAAuE;oBACvE,IAAI,QAAQ,KAAK,WAAW;wBAAE,SAAS;oBAEvC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;oBACvC,IAAI,CAAC,KAAK;wBAAE,SAAS;oBAErB,KAAK,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,iBAAiB,EAAE,CAAC;wBACxD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;4BACxB,OAAO,CAAC,MAAM,CAAC;gCACb,OAAO,EAAE,IAAI,IAAI,IAAI,QAAQ,KAAK,KAAK,iEAAiE,UAAU,WAAW;gCAC7H,aAAa,EAAE,YAAY,IAAI,UAAU,UAAU,0EAA0E;gCAC7H,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gCAC9B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;6BACrC,CAAC,CAAC;4BACH,OAAO;wBACT,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+export type Severity = 'error' | 'warning' | 'info';
+export type ViolationCategory = 'document_structure' | 'heading_hierarchy' | 'landmark_structure' | 'interactive_semantics' | 'aria_correctness' | 'form_semantics';
+export interface Location {
+    line: number;
+    column: number;
+    lineEnd?: number;
+    columnEnd?: number;
+}
+export interface Violation {
+    ruleId: string;
+    category: ViolationCategory;
+    severity: Severity;
+    message: string;
+    fixSuggestion: string;
+    location: Location;
+    snippet?: string;
+}
+export interface ComplexityMetrics {
+    cyclomaticComplexity: number;
+    cognitiveComplexity: number;
+    maxJsxNestingDepth: number;
+    linesOfCode: number;
+    nodeCount: number;
+    propsCount: number;
+    propDrillingDepth: number;
+}
+export interface FileAnalysisResult {
+    filePath: string;
+    violations: Violation[];
+    metrics: ComplexityMetrics;
+    semanticScore: number;
+}
+export interface DiffResult {
+    filePath: string;
+    before: {
+        violationsCount: number;
+        semanticScore: number;
+        metrics: ComplexityMetrics;
+    } | null;
+    after: {
+        violationsCount: number;
+        semanticScore: number;
+        metrics: ComplexityMetrics;
+    };
+    deltaSemanticScore: number;
+    addedViolations: Violation[];
+    removedViolations: Violation[];
+    regressionDetected: boolean;
+    regressionCategories: ViolationCategory[];
+}
+export interface Rule {
+    id: string;
+    category: ViolationCategory;
+    severity: Severity;
+    meta: {
+        description: string;
+        docsUrl?: string;
+    };
+    create(context: RuleContext): Record<string, (node: any) => void>;
+}
+export interface RuleContext {
+    report(violation: Omit<Violation, 'ruleId' | 'category' | 'severity'>): void;
+    getSourceCode(node: any): string;
+    getLoc(node: any): Location;
+}
+export declare class QualmParserError extends Error {
+    readonly line: number;
+    readonly column: number;
+    readonly filePath: string;
+    constructor(message: string, line: number, column: number, filePath: string);
+}
+export declare const PAPER_BETA_COEFFICIENTS: Record<ViolationCategory, number>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAPER_BETA_COEFFICIENTS = exports.QualmParserError = void 0;
+class QualmParserError extends Error {
+    constructor(message, line, column, filePath) {
+        super(message);
+        this.line = line;
+        this.column = column;
+        this.filePath = filePath;
+        this.name = 'QualmParserError';
+    }
+}
+exports.QualmParserError = QualmParserError;
+// β coefficients from Sharma (2026) Table 5 — DiD estimates by axe-core violation category.
+// The paper reports three direct categories. The remaining three (heading_hierarchy,
+// landmark_structure, form_semantics) are derived from the semantic_naming β split
+// and the document_structure finding. Weights are normalised so total β sums to a
+// meaningful composite. See RESEARCH.md for derivation.
+//
+// Direct from Table 5:
+//   document_structure:   β = +0.007  (largest point estimate — dominant AI-gen failure mode)
+//   aria_correctness:     β = +0.002  (aria_specific in paper taxonomy)
+//   interactive_semantics: β = −0.003 (semantic_naming in paper; negative = AI may IMPROVE naming)
+//
+// Derived (no individual paper estimate; set to plausible midpoints):
+//   heading_hierarchy:    β = +0.003
+//   landmark_structure:   β = +0.004  (structural, close to document_structure)
+//   form_semantics:       β = +0.002  (similar to aria_correctness)
+exports.PAPER_BETA_COEFFICIENTS = {
+    document_structure: 0.007,
+    landmark_structure: 0.004,
+    heading_hierarchy: 0.003,
+    interactive_semantics: 0.003,
+    aria_correctness: 0.002,
+    form_semantics: 0.002,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAwEA,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YACE,OAAe,EACC,IAAY,EACZ,MAAc,EACd,QAAgB;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAQ;QAGhC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAVD,4CAUC;AAED,4FAA4F;AAC5F,qFAAqF;AACrF,mFAAmF;AACnF,kFAAkF;AAClF,wDAAwD;AACxD,EAAE;AACF,uBAAuB;AACvB,8FAA8F;AAC9F,wEAAwE;AACxE,mGAAmG;AACnG,EAAE;AACF,sEAAsE;AACtE,qCAAqC;AACrC,gFAAgF;AAChF,oEAAoE;AACvD,QAAA,uBAAuB,GAAsC;IACxE,kBAAkB,EAAI,KAAK;IAC3B,kBAAkB,EAAI,KAAK;IAC3B,iBAAiB,EAAK,KAAK;IAC3B,qBAAqB,EAAE,KAAK;IAC5B,gBAAgB,EAAM,KAAK;IAC3B,cAAc,EAAQ,KAAK;CAC5B,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "qualm-a11y",
+  "version": "1.0.0",
+  "description": "Static AST-level quality analyser for LLM-generated React/TypeScript code. Operationalises findings from Sharma (2026).",
+  "bin": {
+    "qualm-a11y": "./dist/cli.js"
+  },
+  "main": "./dist/analyser.js",
+  "types": "./dist/types.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "RESEARCH.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli.js",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@typescript-eslint/parser": "^7.0.0",
+    "@typescript-eslint/typescript-estree": "^7.0.0",
+    "@typescript-eslint/utils": "^7.0.0",
+    "chalk": "^5.0.0",
+    "commander": "^12.0.0",
+    "glob": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "accessibility",
+    "static-analysis",
+    "react",
+    "typescript",
+    "llm",
+    "code-quality",
+    "ast"
+  ],
+  "license": "MIT",
+  "author": "Somil Sharma <iamsomilsharma@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SomilKSharma/qualm.git"
+  },
+  "homepage": "https://github.com/SomilKSharma/qualm#readme",
+  "bugs": {
+    "url": "https://github.com/SomilKSharma/qualm/issues"
+  }
+}