zemdomu 1.0.1 → 1.1.0

package/README.md

@@ -1,112 +1,112 @@
-ZemDomu
-
-Semantic HTML linting engine for clean, accessible, and SEO-friendly markup. This package provides the shared core logic used by the ZemDomu VS Code extension and upcoming GitHub Action.
-
-
-
-🧠 What is ZemDomu Core?
-
-ZemDomu is a semantic-first linter that helps developers write better HTML and JSX by catching accessibility and structural issues. This package contains the framework-agnostic linting engine used by other tools in the ZemDomu ecosystem.
-
-It parses .html, .jsx, and .tsx content and exposes a simple lint() function that returns semantic violations.
-
-🚀 Installation
-
-npm install zemdomu
-# or
-yarn add zemdomu
-
-✨ Features
-
-✅ Lint semantic issues in HTML, JSX, and TSX
-
-📦 Works in Node.js, CI, or any JS runtime
-
-⚙️ Extensible rule system
-
-📚 Shared by extension and GitHub Action
-
-🧪 Simple API: lint(content, options)
-
-⚙️ Usage Example
-
-import { lint } from 'zemdomu';
-
-const html = '<img>';
-const results = lint(html, { rules: { requireAltText: true } });
-
-console.log(results);
-// [
-//   {
-//     line: 0,
-//     column: 0,
-//     message: '<img> tag missing alt attribute',
-//     rule: 'requireAltText'
-//   }
-// ]
-
-// Custom rules can be supplied via the `customRules` option
-// const myRule = { name: 'demo', checkHtml: () => [] };
-// lint(html, { customRules: [myRule] });
-
-📖 API
-
-lint(content: string, options?: LinterOptions): LintResult[]
-
-Parameters:
-
-content — HTML, JSX, or TSX string input
-
-options.rules — toggles for built-in rules
-options.customRules — array of additional rules
-
-Example LinterOptions
-
-interface LinterOptions {
-  rules: {
-    requireAltText: boolean;
-    // ...more rules to come
-  };
-  customRules?: Rule[];
-}
-
-Example LintResult
-
-interface LintResult {
-  line: number;
-  column: number;
-  message: string;
-  rule: string;
-}
-
-🔗 Related Tools
-
-ZemDomu VS Code Extension
-
-ZemDomu GitHub Action (coming soon)
-
-🛠 Development
-
-git clone https://github.com/Zemdomu/ZemDomu-core.git
-cd ZemDomu-core
-npm install
-npm run build
-
-Tests and coverage support coming soon.
-
-🤝 Contributing
-
-We welcome contributions! If you'd like to add rules, improve parsing, or integrate new consumers:
-
-Fork this repo
-
-Add your logic inside src/rules or src/linter.ts
-
-Write or update tests (if applicable)
-
-Submit a pull request!
-
-📄 License
-
-MIT © 2025 Zacharias Eryd Berlin
-
+ZemDomu
+
+Semantic HTML linting engine for clean, accessible, and SEO-friendly markup. This package provides the shared core logic used by the ZemDomu VS Code extension and upcoming GitHub Action.
+
+
+
+🧠 What is ZemDomu Core?
+
+ZemDomu is a semantic-first linter that helps developers write better HTML and JSX by catching accessibility and structural issues. This package contains the framework-agnostic linting engine used by other tools in the ZemDomu ecosystem.
+
+It parses .html, .jsx, and .tsx content and exposes a simple lint() function that returns semantic violations.
+
+🚀 Installation
+
+npm install zemdomu
+# or
+yarn add zemdomu
+
+✨ Features
+
+✅ Lint semantic issues in HTML, JSX, and TSX
+
+📦 Works in Node.js, CI, or any JS runtime
+
+⚙️ Extensible rule system
+
+📚 Shared by extension and GitHub Action
+
+🧪 Simple API: lint(content, options)
+
+⚙️ Usage Example
+
+import { lint } from 'zemdomu';
+
+const html = '<img>';
+const results = lint(html, { rules: { requireAltText: true } });
+
+console.log(results);
+// [
+//   {
+//     line: 0,
+//     column: 0,
+//     message: '<img> tag missing alt attribute',
+//     rule: 'requireAltText'
+//   }
+// ]
+
+// Custom rules can be supplied via the `customRules` option
+// const myRule = { name: 'demo', checkHtml: () => [] };
+// lint(html, { customRules: [myRule] });
+
+📖 API
+
+lint(content: string, options?: LinterOptions): LintResult[]
+
+Parameters:
+
+content — HTML, JSX, or TSX string input
+
+options.rules — toggles for built-in rules
+options.customRules — array of additional rules
+
+Example LinterOptions
+
+interface LinterOptions {
+  rules: {
+    requireAltText: boolean;
+    // ...more rules to come
+  };
+  customRules?: Rule[];
+}
+
+Example LintResult
+
+interface LintResult {
+  line: number;
+  column: number;
+  message: string;
+  rule: string;
+}
+
+🔗 Related Tools
+
+ZemDomu VS Code Extension
+
+ZemDomu GitHub Action (coming soon)
+
+🛠 Development
+
+git clone https://github.com/Zemdomu/ZemDomu-core.git
+cd ZemDomu-core
+npm install
+npm run build
+
+Tests and coverage support coming soon.
+
+🤝 Contributing
+
+We welcome contributions! If you'd like to add rules, improve parsing, or integrate new consumers:
+
+Fork this repo
+
+Add your logic inside src/rules or src/linter.ts
+
+Write or update tests (if applicable)
+
+Submit a pull request!
+
+📄 License
+
+MIT © 2025 Zacharias Eryd Berlin
+

package/out/index.js

@@ -1,10 +1,12 @@
 "use strict";
 // Exposes the core lint function and types
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ComponentPathResolver = exports.ComponentAnalyzer = exports.lint = void 0;
+exports.ProjectLinter = exports.ComponentPathResolver = exports.ComponentAnalyzer = exports.lint = void 0;
 var linter_1 = require("./linter");
 Object.defineProperty(exports, "lint", { enumerable: true, get: function () { return linter_1.lint; } });
 var component_analyzer_1 = require("./component-analyzer");
 Object.defineProperty(exports, "ComponentAnalyzer", { enumerable: true, get: function () { return component_analyzer_1.ComponentAnalyzer; } });
 var component_path_resolver_1 = require("./component-path-resolver");
 Object.defineProperty(exports, "ComponentPathResolver", { enumerable: true, get: function () { return component_path_resolver_1.ComponentPathResolver; } });
+var project_linter_1 = require("./project-linter");
+Object.defineProperty(exports, "ProjectLinter", { enumerable: true, get: function () { return project_linter_1.ProjectLinter; } });

package/out/project-linter.js

@@ -0,0 +1,87 @@
+"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.ProjectLinter = void 0;
+const fs = __importStar(require("fs/promises"));
+const linter_1 = require("./linter");
+const component_analyzer_1 = require("./component-analyzer");
+class ProjectLinter {
+    constructor(options = {}) {
+        this.opts = options;
+        this.analyzer = new component_analyzer_1.ComponentAnalyzer(this.opts);
+    }
+    clear() {
+        this.analyzer = new component_analyzer_1.ComponentAnalyzer(this.opts);
+    }
+    async lintFile(filePath, content) {
+        if (!content) {
+            content = await fs.readFile(filePath, 'utf8');
+        }
+        const results = (0, linter_1.lint)(content, this.opts);
+        const byFile = new Map();
+        byFile.set(filePath, [...results]);
+        const xmlMode = /\.(jsx|tsx)$/.test(filePath);
+        if (xmlMode) {
+            const component = await this.analyzer.analyzeFile(filePath);
+            if (component) {
+                this.analyzer.registerComponent(component, results);
+            }
+            if (this.opts.crossComponentAnalysis) {
+                const cross = this.analyzer.analyzeComponentTree();
+                for (const r of cross) {
+                    if (!r.filePath)
+                        continue;
+                    if (!byFile.has(r.filePath))
+                        byFile.set(r.filePath, []);
+                    byFile.get(r.filePath).push(r);
+                }
+            }
+        }
+        return byFile;
+    }
+    async lintFiles(filePaths) {
+        const aggregated = new Map();
+        for (const filePath of filePaths) {
+            const fileMap = await this.lintFile(filePath);
+            for (const [fp, res] of fileMap.entries()) {
+                if (!aggregated.has(fp))
+                    aggregated.set(fp, []);
+                aggregated.get(fp).push(...res);
+            }
+        }
+        return aggregated;
+    }
+}
+exports.ProjectLinter = ProjectLinter;

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "zemdomu",
-  "version": "1.0.1",
-  "description": "Hello",
-  "main": "./out/index.js",
-  "files": [
-    "out"
-  ],
-  "private": false,
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "compile": "tsc -p tsconfig.json",
-    "test": "npm run compile && node tests/linter-labels.test.js && node tests/unique-ids.test.js"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "devDependencies": {
-    "@types/babel__traverse": "^7.20.7",
-    "@types/babel-traverse": "^6.25.10",
-    "@types/babel-types": "^7.0.16",
-    "typescript": "^5.8.2",
-    "@types/node": "^22.15.17",
-    "@types/jest": "^29.5.3",
-    "esbuild": "^0.25.5",
-    "jest": "^29.7.0"
-  },
-  "dependencies": {
-    "@babel/parser": "^7.27.0",
-    "@babel/traverse": "^7.27.0",
-    "@babel/types": "^7.27.0",
-    "glob": "^7.2.3"
-  }
-}
+{
+  "name": "zemdomu",
+  "version": "1.1.0",
+  "description": "Hello",
+  "main": "./out/index.js",
+  "files": [
+    "out"
+  ],
+  "private": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "compile": "tsc -p tsconfig.json",
+    "test": "npm run compile && node tests/unique-ids.test.js && node tests/label-form-control.test.js && node tests/cross-component.test.js && node tests/heading-order.test.js && node tests/prevent-empty-inline.test.js && node tests/section-heading.test.js && node tests/img-alt.test.js && node tests/button-accessibility.test.js && node tests/html-lang.test.js && node tests/table-caption.test.js && node tests/all-rules.test.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/babel__traverse": "^7.20.7",
+    "@types/babel-traverse": "^6.25.10",
+    "@types/babel-types": "^7.0.16",
+    "typescript": "^5.8.2",
+    "@types/node": "^22.15.17",
+    "@types/jest": "^29.5.3",
+    "esbuild": "^0.25.5",
+    "jest": "^29.7.0"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.27.0",
+    "@babel/traverse": "^7.27.0",
+    "@babel/types": "^7.27.0",
+    "glob": "^7.2.3"
+  }
+}