@larose-ui/accessibility 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 laRose contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+type A11ySeverity = 'error' | 'warning';
+interface A11yViolation {
+    severity: A11ySeverity;
+    rule: string;
+    message: string;
+    file?: string;
+    line?: number;
+    fix?: string;
+}
+interface A11yScanResult {
+    passed: boolean;
+    violations: A11yViolation[];
+}
+declare function scanComponentSource(source: string, filePath?: string): A11yScanResult;
+declare function formatA11yReport(result: A11yScanResult): string;
+/** Recommended CSP for apps using laRose runtime tokens. */
+declare const RECOMMENDED_CSP: string;
+
+export { type A11yScanResult, type A11ySeverity, type A11yViolation, RECOMMENDED_CSP, formatA11yReport, scanComponentSource };

package/dist/index.js

@@ -0,0 +1,96 @@
+// src/index.ts
+var RULES = [
+  {
+    id: "dialog-label",
+    pattern: /role=["']dialog["']/,
+    missing: /aria-labelledby|aria-label/,
+    message: "Dialog/Modal may be missing accessible label",
+    fix: "Add title prop or aria-labelledby",
+    severity: "error"
+  },
+  {
+    id: "empty-button",
+    pattern: /<button[^>]*>\s*<\/button>/,
+    missing: /aria-label/,
+    message: "Empty button without aria-label",
+    fix: "Add aria-label or visible text",
+    severity: "warning"
+  },
+  {
+    id: "img-alt",
+    pattern: /<img(?![^>]*\balt=)/,
+    message: "Image missing alt attribute",
+    fix: 'Add alt="" for decorative or descriptive alt text',
+    severity: "error"
+  },
+  {
+    id: "input-label",
+    pattern: /<input[^>]*\bid=["']([^"']+)["']/,
+    requiresLabelFor: true,
+    message: "Input with id may be missing associated label",
+    fix: 'Use <label htmlFor="..."> or aria-label',
+    severity: "warning"
+  }
+];
+function scanComponentSource(source, filePath) {
+  const violations = [];
+  const lines = source.split("\n");
+  for (const rule of RULES) {
+    if (rule.id === "input-label") {
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const idMatch = line.match(/<input[^>]*\bid=["']([^"']+)["']/);
+        if (!idMatch) continue;
+        const id = idMatch[1];
+        const hasLabel = source.includes(`htmlFor="${id}"`) || source.includes(`htmlFor='${id}'`) || line.includes("aria-label");
+        if (!hasLabel) {
+          violations.push({
+            severity: rule.severity,
+            rule: rule.id,
+            message: rule.message,
+            file: filePath,
+            line: i + 1,
+            fix: rule.fix
+          });
+        }
+      }
+      continue;
+    }
+    if (!rule.pattern.test(source)) continue;
+    if ("missing" in rule && rule.missing && rule.missing.test(source)) continue;
+    violations.push({
+      severity: rule.severity,
+      rule: rule.id,
+      message: rule.message,
+      file: filePath,
+      fix: rule.fix
+    });
+  }
+  return {
+    passed: violations.filter((v) => v.severity === "error").length === 0,
+    violations
+  };
+}
+function formatA11yReport(result) {
+  if (result.violations.length === 0) return "Accessibility scan passed.";
+  const lines = ["Accessibility scan report:", ""];
+  for (const v of result.violations) {
+    lines.push(`[${v.severity.toUpperCase()}] ${v.rule}: ${v.message}`);
+    if (v.file) lines.push(`  File: ${v.file}${v.line ? `:${v.line}` : ""}`);
+    if (v.fix) lines.push(`  Fix: ${v.fix}`);
+    lines.push("");
+  }
+  lines.push(result.passed ? "Result: PASS (warnings only)" : "Result: FAIL");
+  return lines.join("\n");
+}
+var RECOMMENDED_CSP = [
+  "default-src 'self'",
+  "script-src 'self'",
+  "style-src 'self' 'unsafe-inline'",
+  "img-src 'self' data: https:"
+].join("; ");
+export {
+  RECOMMENDED_CSP,
+  formatA11yReport,
+  scanComponentSource
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@larose-ui/accessibility",
+  "version": "0.1.0",
+  "description": "Accessibility utilities and source scanners for laRose",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@larose-ui/core": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/larose-ui/larose.git",
+    "directory": "packages/accessibility"
+  },
+  "keywords": [
+    "larose",
+    "react",
+    "ui-platform",
+    "design-system",
+    "saas"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}