@accesslint/core 0.1.0

package/dist/rules/types.d.ts

@@ -0,0 +1,87 @@
+export interface Rule {
+    id: string;
+    wcag: string[];
+    level: "A" | "AA";
+    tags?: string[];
+    description: string;
+    /** Generic remediation guidance for the AI to contextualize */
+    guidance?: string;
+    /** Tailored prompt for AI explanation of this specific rule violation */
+    prompt?: string;
+    run(doc: Document): Violation[];
+}
+export interface Violation {
+    ruleId: string;
+    selector: string;
+    html: string;
+    impact: "critical" | "serious" | "moderate" | "minor";
+    message: string;
+    /** Rule-specific surrounding context to help AI understand the issue */
+    context?: string;
+    element?: Element;
+}
+export interface AuditResult {
+    url: string;
+    timestamp: number;
+    violations: Violation[];
+    ruleCount: number;
+}
+export interface SelectorExistsCheck {
+    type: "selector-exists";
+}
+export interface AttributeValueCheck {
+    type: "attribute-value";
+    attribute: string;
+    operator: ">" | "<" | "=" | "!=" | "in" | "not-in";
+    value: number | string | string[];
+}
+export interface AttributeMissingCheck {
+    type: "attribute-missing";
+    attribute: string;
+}
+export interface AttributeRegexCheck {
+    type: "attribute-regex";
+    attribute: string;
+    pattern: string;
+    flags?: string;
+    shouldMatch: boolean;
+}
+export interface ChildRequiredCheck {
+    type: "child-required";
+    childSelector: string;
+}
+export interface ChildInvalidCheck {
+    type: "child-invalid";
+    allowedChildren: string[];
+}
+export type CheckType = SelectorExistsCheck | AttributeValueCheck | AttributeMissingCheck | AttributeRegexCheck | ChildRequiredCheck | ChildInvalidCheck;
+export interface DeclarativeRule {
+    id: string;
+    selector: string;
+    check: CheckType;
+    impact: "critical" | "serious" | "moderate" | "minor";
+    message: string;
+    description: string;
+    wcag: string[];
+    level: "A" | "AA";
+    tags?: string[];
+    guidance?: string;
+    prompt?: string;
+    skipAriaHidden?: boolean;
+    documentOnly?: boolean;
+}
+export interface RemoteRuleMetadata {
+    description?: string;
+    guidance?: string;
+    prompt?: string;
+    wcag?: string[];
+    level?: "A" | "AA";
+    tags?: string[];
+}
+export interface RemoteRuleData {
+    version: number;
+    metadata?: Record<string, RemoteRuleMetadata>;
+    rules?: DeclarativeRule[];
+    disabled?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/rules/utils/aria.d.ts

@@ -0,0 +1,25 @@
+export declare function clearComputedRoleCache(): void;
+/**
+ * Return the implicit ARIA role for a native HTML element, or null if
+ * the element does not map to any role.  Follows the ARIA in HTML spec:
+ * https://www.w3.org/TR/html-aria/#docconformance
+ */
+export declare function getImplicitRole(el: Element): string | null;
+/**
+ * Return the computed ARIA role for an element: the explicit `role`
+ * attribute if present, otherwise the implicit role derived from the
+ * HTML tag name and attributes.  Results are cached per-audit via a
+ * WeakMap (call `clearComputedRoleCache()` between audits).
+ */
+export declare function getComputedRole(el: Element): string | null;
+export declare function getAccessibleName(el: Element): string;
+export declare function isValidRole(role: string): boolean;
+export declare function isValidAriaAttribute(attr: string): boolean;
+export declare function clearAriaHiddenCache(): void;
+export declare function isAriaHidden(el: Element): boolean;
+/**
+ * Get text content from an element, excluding descendants
+ * removed from the accessibility tree.
+ */
+export declare function getAccessibleTextContent(el: Element): string;
+//# sourceMappingURL=aria.d.ts.map

package/dist/rules/utils/aria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria.d.ts","sourceRoot":"","sources":["../../../src/rules/utils/aria.ts"],"names":[],"mappings":"AAMA,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CA0D1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAS1D;AAMD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CA0ErD;AAkBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIjD;AAWD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAID,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAiBjD;AAYD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAiC5D"}

package/dist/rules/utils/selector.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generate a CSS selector for an element.
+ * If the element is inside a shadow root, produces a ` >>> `-delimited
+ * path that crosses shadow boundaries: `host-selector >>> inner-selector`.
+ * If the element is inside an iframe, produces a ` >>>iframe> `-delimited
+ * path that crosses iframe boundaries: `iframe-selector >>>iframe> inner-selector`.
+ */
+export declare function getSelector(el: Element): string;
+/**
+ * Resolve a selector that may contain ` >>> ` (shadow DOM) or
+ * ` >>>iframe> ` (iframe) boundary delimiters.
+ * Falls back to plain querySelector for selectors without boundaries.
+ */
+export declare function querySelectorShadowAware(selector: string): Element | null;
+export declare function getHtmlSnippet(el: Element): string;
+//# sourceMappingURL=selector.d.ts.map

package/dist/rules/utils/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/rules/utils/selector.ts"],"names":[],"mappings":"AAoEA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAwB/C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAgDzE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAGlD"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@accesslint/core",
+  "version": "0.1.0",
+  "description": "Pure accessibility rule engine — WCAG audit with zero browser dependencies",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build --config vite.lib.config.ts && tsc -p tsconfig.lib.json",
+    "test": "vitest run",
+    "bench": "vitest bench",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/accesslint/core.git"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "happy-dom": "^20.4.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vitest": "^3.0.0"
+  }
+}