zemdomu 1.3.3 → 1.3.5

package/out/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/out/component-analyzer.d.ts

@@ -0,0 +1,89 @@
+import { LintResult, LinterOptions } from './linter';
+interface PerformanceRecorder {
+    record(filePath: string, timings: Record<string, number>): void;
+}
+interface ComponentReference {
+    name: string;
+    path: string | null;
+    rawImportPath: string | null;
+    sourceLocation: {
+        line: number;
+        column: number;
+    };
+    usageLocations: Array<{
+        line: number;
+        column: number;
+    }>;
+}
+interface HeadingInfo {
+    level: number;
+    line: number;
+    column: number;
+    filePath: string;
+}
+interface IdInfo {
+    id: string;
+    line: number;
+    column: number;
+    filePath: string;
+}
+interface NavInfo {
+    filePath: string;
+    line: number;
+    column: number;
+    hasLocalLink: boolean;
+    childComponents: ComponentReference[];
+}
+interface ComponentDefinition {
+    name: string;
+    filePath: string;
+    issues: Map<string, LintResult[]>;
+    usesComponents: ComponentReference[];
+    headings: HeadingInfo[];
+    ids: IdInfo[];
+    navs: NavInfo[];
+    hasLocalAnchor: boolean;
+}
+export declare class ComponentAnalyzer {
+    private componentRegistry;
+    private importToComponentMap;
+    private options;
+    private processingComponentStack;
+    private perf?;
+    private resolver;
+    private maxDepth;
+    constructor(options: LinterOptions & {
+        crossComponentAnalysis?: boolean;
+        crossComponentDepth?: number;
+    }, perf?: PerformanceRecorder);
+    analyzeFile(filePath: string): Promise<ComponentDefinition | null>;
+    private extractComponentInfo;
+    private resolveComponentPath;
+    registerComponent(component: ComponentDefinition, issues: LintResult[]): void;
+    private getRuleType;
+    analyzeComponentTree(): LintResult[];
+    private findCrossComponentH1Issues;
+    private findReferenceForComp;
+    /**
+     * Improved implementation to find heading order issues across components
+     */
+    private findCrossComponentHeadingOrderIssues;
+    /**
+     * Collects all headings from a component and its children in document order
+     * and checks for heading level issues
+     */
+    private analyzeHeadingHierarchy;
+    /**
+     * Collects all headings from a component and its children in document order
+     */
+    private collectHeadingsInDocumentOrder;
+    private findCrossComponentDuplicateIds;
+    private collectIds;
+    private findCrossComponentNavLinks;
+    private checkNavs;
+    private navHasLink;
+    private componentHasAnchor;
+    private findEntryPoints;
+    private findComponentsWithRule;
+}
+export {};

package/out/component-path-resolver.d.ts

@@ -0,0 +1,19 @@
+export declare class ComponentPathResolver {
+    private static resolveCache;
+    private static statCache;
+    private static aliasCache;
+    private static unresolved;
+    private static devMode;
+    private static tsconfigLoaded;
+    private static tsAliases;
+    private static readonly aliasFileLimit;
+    private static rootDir;
+    static setRootDir(dir: string): void;
+    static updateDevMode(dev: boolean): void;
+    private static loadTsconfig;
+    private tryExtensions;
+    private resolveWithTsconfig;
+    private static normalizeKey;
+    private fileExists;
+    resolve(importPath: string, currentPath: string): Promise<string | null>;
+}

package/out/html-visitor.d.ts

@@ -0,0 +1,5 @@
+export interface HtmlVisitor {
+    enter?(node: import('./simpleHtmlParser').Node): void;
+    exit?(node: import('./simpleHtmlParser').Node): void;
+}
+export declare function visitHtml(node: import('./simpleHtmlParser').Node, visitor: HtmlVisitor): void;

package/out/index.d.ts

@@ -0,0 +1,14 @@
+export { lint } from "./linter";
+export type { LinterOptions, LintResult, Rule } from "./linter";
+export { ComponentAnalyzer } from "./component-analyzer";
+export { ComponentPathResolver } from "./component-path-resolver";
+export { ProjectLinter } from "./project-linter";
+export type { ProjectLinterOptions } from "./project-linter";
+export { PerformanceDiagnostics } from "./performance-diagnostics";
+export type { Node, ElementNode, TextNode, CommentNode, } from "./simpleHtmlParser";
+export { parse as parseHtml } from "./simpleHtmlParser";
+export { getAttr, getJsxAttr, getTag } from "./rules/utils";
+export type { HtmlVisitor } from "./html-visitor";
+export { visitHtml } from "./html-visitor";
+export { resultsToSarif, RULE_DOCS_BASE } from "./sarif";
+export type { SarifLog } from "./sarif";

package/out/linter.d.ts

@@ -0,0 +1,38 @@
+import { Node } from "./simpleHtmlParser";
+import { NodePath } from "@babel/traverse";
+import * as t from "@babel/types";
+import type { PerformanceRecorder } from "./performance-diagnostics";
+export type RuleSeverity = "error" | "warning" | "off";
+export interface LinterOptions {
+    rules?: Record<string, RuleSeverity>;
+    customRules?: Rule[];
+    /** Optional file path for better error messages */
+    filePath?: string;
+    /** Optional performance recorder */
+    perf?: PerformanceRecorder;
+}
+export interface LintResult {
+    line: number;
+    column: number;
+    message: string;
+    rule: string;
+    severity?: RuleSeverity;
+    filePath?: string;
+}
+export interface Rule {
+    name: string;
+    /** Called before traversal begins */
+    init?: () => void;
+    enterHtml?: (node: Node) => LintResult[];
+    exitHtml?: (node: Node) => LintResult[];
+    enterJsx?: (path: NodePath<t.JSXElement>) => LintResult[];
+    exitJsx?: (path: NodePath<t.JSXElement>) => LintResult[];
+    /** Called after traversal finishes */
+    end?: () => LintResult[];
+    test?: (node: Node | t.Node) => boolean;
+    message?: string;
+}
+/**
+ * Lint HTML/JSX/TSX content.
+ */
+export declare function lint(content: string, options?: LinterOptions): LintResult[];

package/out/performance-diagnostics.d.ts

@@ -0,0 +1,14 @@
+export interface PerformanceRecorder {
+    record(filePath: string, timings: Record<string, number>): void;
+}
+export declare class PerformanceDiagnostics implements PerformanceRecorder {
+    private static latestMetrics;
+    static getLatestMetrics(): Map<string, Record<string, number>>;
+    static resetMetrics(): void;
+    record(filePath: string, timings: Record<string, number>): void;
+    getAsJSON(): string;
+    /**
+     * Log slowest file and phase to console for debugging.
+     */
+    logSlowest(): void;
+}

package/out/project-linter.d.ts

@@ -0,0 +1,16 @@
+import { LintResult, LinterOptions } from "./linter";
+import type { PerformanceRecorder } from "./performance-diagnostics";
+export interface ProjectLinterOptions extends LinterOptions {
+    crossComponentAnalysis?: boolean;
+    crossComponentDepth?: number;
+    perf?: PerformanceRecorder;
+    rootDir?: string;
+}
+export declare class ProjectLinter {
+    private analyzer;
+    private opts;
+    constructor(options?: ProjectLinterOptions);
+    clear(): void;
+    lintFile(filePath: string, content?: string): Promise<Map<string, LintResult[]>>;
+    lintFiles(filePaths: string[]): Promise<Map<string, LintResult[]>>;
+}

package/out/rules/enforceHeadingOrder.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function enforceHeadingOrder(): Rule;

package/out/rules/enforceListNesting.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function enforceListNesting(): Rule;

package/out/rules/noTabindexGreaterThanZero.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function noTabindexGreaterThanZero(): Rule;

package/out/rules/preventEmptyInlineTags.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function preventEmptyInlineTags(): Rule;

package/out/rules/requireAltText.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireAltText(): Rule;

package/out/rules/requireAltTextJSX.d.ts

@@ -0,0 +1,4 @@
+import { NodePath } from '@babel/traverse';
+import * as t from '@babel/types';
+import { LintResult } from '../linter';
+export default function requireAltTextJSX(path: NodePath<t.JSXElement>): LintResult[];

package/out/rules/requireButtonText.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireButtonText(): Rule;

package/out/rules/requireHrefOnAnchors.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireHrefOnAnchors(): Rule;

package/out/rules/requireHtmlLang.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireHtmlLang(): Rule;

package/out/rules/requireIframeTitle.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireIframeTitle(): Rule;

package/out/rules/requireImageInputAlt.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireImageInputAlt(): Rule;

package/out/rules/requireLabelForFormControls.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireLabelForFormControls(): Rule;

package/out/rules/requireLinkText.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from "../linter";
+export default function requireLinkText(): Rule;

package/out/rules/requireNavLinks.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireNavLinks(): Rule;

package/out/rules/requireSectionHeading.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireSectionHeading(): Rule;

package/out/rules/requireTableCaption.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function requireTableCaption(): Rule;

package/out/rules/singleH1.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function singleH1(): Rule;

package/out/rules/uniqueIds.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '../linter';
+export default function uniqueIds(): Rule;

package/out/rules/utils.d.ts

@@ -0,0 +1,6 @@
+import * as t from '@babel/types';
+import { NodePath } from '@babel/traverse';
+import { ElementNode } from '../simpleHtmlParser';
+export declare function getAttr(node: ElementNode, name: string): string | undefined;
+export declare function getJsxAttr(opening: t.JSXOpeningElement, name: string): string | undefined;
+export declare function getTag(path: NodePath<t.JSXElement>): string;

package/out/sarif.d.ts

@@ -0,0 +1,38 @@
+export interface SarifLog {
+    version: string;
+    runs: Array<{
+        tool: {
+            driver: {
+                name: string;
+                informationUri?: string;
+                rules: Array<{
+                    id: string;
+                    name: string;
+                    helpUri: string;
+                }>;
+            };
+        };
+        results: Array<{
+            ruleId: string;
+            message: {
+                text: string;
+            };
+            locations: Array<{
+                physicalLocation: {
+                    artifactLocation: {
+                        uri: string;
+                    };
+                    region: {
+                        startLine: number;
+                        startColumn: number;
+                    };
+                };
+            }>;
+            level: string;
+        }>;
+    }>;
+}
+import { LintResult } from './linter';
+declare const RULE_DOCS_BASE = "https://github.com/ZemDomu/docs/blob/main/rules/";
+export declare function resultsToSarif(results: Map<string, LintResult[]>): SarifLog;
+export { RULE_DOCS_BASE };

package/out/simpleHtmlParser.d.ts

@@ -0,0 +1,20 @@
+export type Node = ElementNode | TextNode | CommentNode;
+export interface ElementNode {
+    type: 'element';
+    tagName: string;
+    attrs: Record<string, string>;
+    children: Node[];
+    startIndex: number;
+    selfClosing?: boolean;
+}
+export interface TextNode {
+    type: 'text';
+    text: string;
+    startIndex: number;
+}
+export interface CommentNode {
+    type: 'comment';
+    text: string;
+    startIndex: number;
+}
+export declare function parse(html: string): ElementNode;

package/out/utils/collectLocalDeps.d.ts

@@ -0,0 +1,7 @@
+export type ResolveCtx = {
+    rootDir: string;
+    baseUrl?: string;
+    paths?: Record<string, string[]>;
+    maxDepth?: number;
+};
+export declare function collectLocalDeps(entries: string[], ctx: ResolveCtx): string[];

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "zemdomu",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Semantic HTML linter for HTML, JSX, and TSX. Detects accessibility, SEO, and structure issues before deployment.",
   "main": "./out/index.js",
   "types": "./out/index.d.ts",
   "bin": {
     "zemdomu": "./out/cli.js"
   },
+  "exports": {
+    ".": {
+      "types": "./out/index.d.ts",
+      "default": "./out/index.js"
+    },
+    "./*": "./out/*"
+  },
   "files": [
     "out",
     "README.md",