react-native-accessibility-scanner 0.1.0

package/dist/utils/ast.js

@@ -0,0 +1,170 @@
+"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.CRITICAL_ACTION_KEYWORDS = exports.TOUCHABLE_COMPONENTS = exports.INTERACTIVE_COMPONENTS = void 0;
+exports.getComponentName = getComponentName;
+exports.getJSXAttributes = getJSXAttributes;
+exports.findAttribute = findAttribute;
+exports.hasNonEmptyAttribute = hasNonEmptyAttribute;
+exports.getStringAttributeValue = getStringAttributeValue;
+exports.hasTextChild = hasTextChild;
+exports.extractStyleDimension = extractStyleDimension;
+exports.getSnippet = getSnippet;
+const t = __importStar(require("@babel/types"));
+/** Interactive RN component names that must have accessibility props */
+exports.INTERACTIVE_COMPONENTS = new Set([
+    "TouchableOpacity",
+    "TouchableHighlight",
+    "TouchableNativeFeedback",
+    "TouchableWithoutFeedback",
+    "Pressable",
+    "Button",
+]);
+/** Components where touch-target rules apply */
+exports.TOUCHABLE_COMPONENTS = new Set([
+    "TouchableOpacity",
+    "TouchableHighlight",
+    "TouchableNativeFeedback",
+    "TouchableWithoutFeedback",
+    "Pressable",
+]);
+/** Critical action keywords that should have accessibilityHint */
+exports.CRITICAL_ACTION_KEYWORDS = [
+    "delete",
+    "remove",
+    "purchase",
+    "checkout",
+    "submit",
+    "payment",
+    "pay",
+    "buy",
+    "confirm",
+    "cancel",
+];
+// ─── JSX Helpers ──────────────────────────────────────────────────────────────
+/** Get the component name from a JSXOpeningElement */
+function getComponentName(node) {
+    const { name } = node;
+    if (t.isJSXIdentifier(name))
+        return name.name;
+    if (t.isJSXMemberExpression(name)) {
+        return `${name.object.name}.${name.property.name}`;
+    }
+    return null;
+}
+/** Return all JSX attributes from an opening element */
+function getJSXAttributes(node) {
+    return node.attributes.filter((a) => t.isJSXAttribute(a));
+}
+/** Find a specific named attribute, or return undefined */
+function findAttribute(node, attrName) {
+    return getJSXAttributes(node).find((a) => t.isJSXIdentifier(a.name) && a.name.name === attrName);
+}
+/** Check if an attribute is present AND has a non-empty value */
+function hasNonEmptyAttribute(node, attrName) {
+    const attr = findAttribute(node, attrName);
+    if (!attr)
+        return false;
+    const val = attr.value;
+    if (!val)
+        return true; // bare prop = true (e.g. accessible)
+    if (t.isStringLiteral(val))
+        return val.value.trim().length > 0;
+    if (t.isJSXExpressionContainer(val)) {
+        const expr = val.expression;
+        if (t.isStringLiteral(expr))
+            return expr.value.trim().length > 0;
+        if (t.isTemplateLiteral(expr)) {
+            return expr.quasis.some((q) => q.value.raw.trim().length > 0) ||
+                expr.expressions.length > 0;
+        }
+        // Dynamic expression — assume it's populated
+        return !t.isNullLiteral(expr);
+    }
+    return false;
+}
+/** Get the string value of an attribute, or null if dynamic/missing */
+function getStringAttributeValue(node, attrName) {
+    const attr = findAttribute(node, attrName);
+    if (!attr || !attr.value)
+        return null;
+    if (t.isStringLiteral(attr.value))
+        return attr.value.value;
+    if (t.isJSXExpressionContainer(attr.value) &&
+        t.isStringLiteral(attr.value.expression)) {
+        return attr.value.expression.value;
+    }
+    return null;
+}
+/** Check if a JSXElement has any direct Text children */
+function hasTextChild(node) {
+    return node.children.some((child) => {
+        if (t.isJSXText(child))
+            return child.value.trim().length > 0;
+        if (t.isJSXElement(child)) {
+            const name = getComponentName(child.openingElement);
+            return name === "Text";
+        }
+        return false;
+    });
+}
+/** Extract a style value (width/height) from a style prop — best-effort static analysis */
+function extractStyleDimension(node, dimension) {
+    const styleAttr = findAttribute(node, "style");
+    if (!styleAttr || !styleAttr.value)
+        return null;
+    const extractFromObject = (obj) => {
+        const prop = obj.properties.find((p) => t.isObjectProperty(p) &&
+            ((t.isIdentifier(p.key) && p.key.name === dimension) ||
+                (t.isStringLiteral(p.key) && p.key.value === dimension)));
+        if (!prop)
+            return null;
+        if (t.isNumericLiteral(prop.value))
+            return prop.value.value;
+        return null;
+    };
+    // style={{ width: 30, height: 30 }}
+    if (t.isJSXExpressionContainer(styleAttr.value) &&
+        t.isObjectExpression(styleAttr.value.expression)) {
+        return extractFromObject(styleAttr.value.expression);
+    }
+    return null;
+}
+/** Get a short code snippet for an issue (the line of source) */
+function getSnippet(source, line) {
+    const lines = source.split("\n");
+    return (lines[line - 1] || "").trim();
+}
+//# sourceMappingURL=ast.js.map

package/dist/utils/ast.js.map

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "react-native-accessibility-scanner",
+  "version": "0.1.0",
+  "description": "Accessibility auditing for React Native apps — CLI, ESLint plugin, GitHub Action, and programmatic API.",
+  "keywords": [
+    "react-native",
+    "accessibility",
+    "a11y",
+    "eslint",
+    "scanner",
+    "linting",
+    "audit"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "react-native-accessibility-scan": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./eslint": "./dist/eslint/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.23.0",
+    "@babel/traverse": "^7.23.0",
+    "@babel/types": "^7.23.0",
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "cosmiconfig": "^9.0.0",
+    "glob": "^10.3.10"
+  },
+  "devDependencies": {
+    "@types/babel__traverse": "^7.20.5",
+    "@types/eslint": "^9.6.1",
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_USERNAME/react-native-accessibility-scanner"
+  },
+  "bugs": {
+    "url": "https://github.com/YOUR_USERNAME/react-native-accessibility-scanner/issues"
+  },
+  "homepage": "https://github.com/YOUR_USERNAME/react-native-accessibility-scanner#readme"
+}