@skip-ai/scanner 0.2.0 → 0.5.0

package/dist/scanner/history.js

@@ -0,0 +1,38 @@
+import fs from 'fs';
+import path from 'path';
+export const HISTORY_FILE = '.skip-history.json';
+const MAX_ENTRIES = 100;
+/**
+ * Lê o histórico local do projeto (.skip-history.json).
+ * Retorna [] se não existir ou for inválido.
+ */
+export function readHistory(rootDir) {
+    const file = path.join(rootDir, HISTORY_FILE);
+    if (!fs.existsSync(file))
+        return [];
+    try {
+        const data = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        return Array.isArray(data) ? data : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Adiciona uma entrada ao histórico local e retorna o histórico atualizado.
+ * Mantém apenas as últimas MAX_ENTRIES entradas.
+ */
+export function appendHistory(rootDir, entry) {
+    const history = readHistory(rootDir);
+    history.push(entry);
+    const trimmed = history.slice(-MAX_ENTRIES);
+    const file = path.join(rootDir, HISTORY_FILE);
+    try {
+        fs.writeFileSync(file, JSON.stringify(trimmed, null, 2), 'utf-8');
+    }
+    catch {
+        // Falha ao salvar histórico não deve quebrar o scan.
+    }
+    return trimmed;
+}
+//# sourceMappingURL=history.js.map

package/dist/scanner/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/scanner/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAcxB,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AACjD,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,KAAmB;IAChE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;IAE5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/scanner/score.d.ts

@@ -0,0 +1,19 @@
+import type { Severity, WcagLevel, WcagViolation } from './wcag.js';
+/** Penalização por severidade (multiplicada pela contagem). */
+export declare const SEVERITY_WEIGHT: Record<Severity, number>;
+export interface ScoreResult {
+    /** 0–100 */
+    score: number;
+    /** Nível WCAG alcançável: A, AA ou AAA. */
+    level: WcagLevel;
+    /** Total de violações consideradas. */
+    total: number;
+}
+/**
+ * Calcula o score de acessibilidade (0–100).
+ * Começa em 100 e desconta por severidade, com floor em 0.
+ */
+export declare function calculateScore(violations: WcagViolation[]): ScoreResult;
+/** Cor sugerida para o score (pra usar no dashboard/terminal). */
+export declare function scoreColor(score: number): string;
+//# sourceMappingURL=score.d.ts.map

package/dist/scanner/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/scanner/score.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEpE,+DAA+D;AAC/D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAMpD,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,SAAS,CAAC;IACjB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,WAAW,CAcvE;AAmBD,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/scanner/score.js

@@ -0,0 +1,50 @@
+/** Penalização por severidade (multiplicada pela contagem). */
+export const SEVERITY_WEIGHT = {
+    critical: 12,
+    serious: 6,
+    moderate: 3,
+    minor: 1,
+    unknown: 0, // indeterminado (ex.: contraste sem cálculo) não penaliza o score
+};
+/**
+ * Calcula o score de acessibilidade (0–100).
+ * Começa em 100 e desconta por severidade, com floor em 0.
+ */
+export function calculateScore(violations) {
+    let penalty = 0;
+    let total = violations.length;
+    for (const v of violations) {
+        penalty += SEVERITY_WEIGHT[v.severity];
+    }
+    // Cada tela sem violações ameniza o desconto (evita score punitivo em projetos grandes)
+    const score = Math.max(0, Math.round(100 - penalty));
+    const level = determineLevel(violations);
+    return { score, level, total };
+}
+/**
+ * Determina o nível WCAG alcançável.
+ * Ignora violações `unknown` (indeterminadas), pois não são falhas confirmadas.
+ */
+function determineLevel(violations) {
+    const confirmed = violations.filter((v) => v.severity !== 'unknown');
+    if (confirmed.length === 0)
+        return 'AAA';
+    const hasA = confirmed.some((v) => v.level === 'A');
+    if (hasA)
+        return 'A';
+    const hasAA = confirmed.some((v) => v.level === 'AA');
+    if (hasAA)
+        return 'AA';
+    return 'AA';
+}
+/** Cor sugerida para o score (pra usar no dashboard/terminal). */
+export function scoreColor(score) {
+    if (score >= 90)
+        return 'green';
+    if (score >= 70)
+        return 'yellow';
+    if (score >= 50)
+        return 'magenta';
+    return 'red';
+}
+//# sourceMappingURL=score.js.map

package/dist/scanner/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/scanner/score.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC,EAAE,kEAAkE;CAC/E,CAAC;AAWF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAA2B;IACxD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,wFAAwF;IACxF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAEzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,UAA2B;IACjD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACrE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEzC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC;IACpD,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC;IAErB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACtD,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IAEvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,OAAO,CAAC;IAChC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/scanner/wcag.d.ts

@@ -0,0 +1,94 @@
+import type { ScreenMap } from './navigation.js';
+export type Severity = 'critical' | 'serious' | 'moderate' | 'minor' | 'unknown';
+export type WcagLevel = 'A' | 'AA' | 'AAA';
+export interface WcagSourceLocation {
+    filePath: string;
+    line: number;
+    column: number;
+}
+export interface WcagViolation {
+    /** Fingerprint estável: hash(ruleId + normalizedFilePath + normalizedSelector). */
+    fingerprint: string;
+    id: string;
+    ruleId: string;
+    rule: string;
+    level: WcagLevel;
+    severity: Severity;
+    impact: string;
+    title: string;
+    description: string;
+    /** Tela onde ocorre (para a ocorrência primária). */
+    screen: string;
+    filePath: string;
+    selector: string;
+    fix: string;
+    wcagUrl: string;
+    /** Localização no código-fonte (linha/coluna). */
+    source: WcagSourceLocation;
+    /** Telas afetadas por esse mesmo problema (deduplicação). */
+    affectedScreens: string[];
+    /** Quantas ocorrências do mesmo problema foram consolidadas. */
+    occurrenceCount: number;
+}
+export interface WcagSummary {
+    critical: number;
+    serious: number;
+    moderate: number;
+    minor: number;
+    unknown: number;
+}
+export interface WcagChecks {
+    total: number;
+    passed: number;
+    failed: number;
+    /** Verificações indeterminadas (ex.: contraste sem cálculo real). */
+    needsReview: number;
+}
+export interface WcagReport {
+    score: number;
+    level: WcagLevel;
+    violations: WcagViolation[];
+    summary: WcagSummary;
+    checks: WcagChecks;
+    auditedAt: string;
+    rulesVersion: string;
+}
+export declare const WCAG_RULES_VERSION = "1.1.0";
+export interface AuditContext {
+    screen: ScreenMap;
+    /** Conteúdo do arquivo da tela (lido localmente; NUNCA enviado ao servidor). */
+    content: string;
+}
+/** Resultado interno de uma regra: violações + contagem de elementos verificados. */
+interface RuleResult {
+    violations: WcagViolation[];
+    /** Elementos verificados por essa regra (para contar checks aprovados). */
+    elementsChecked: number;
+}
+export interface RuleDef {
+    id: string;
+    rule: string;
+    level: WcagLevel;
+    severity: Severity;
+    impact: string;
+    title: string;
+    wcagUrl: string;
+    defaultFix: string;
+    /** Extrai as violações desta regra no contexto. Recebe a própria regra. */
+    check: (ctx: AuditContext, rule: RuleDef) => RuleResult;
+}
+export declare const RULES: RuleDef[];
+/**
+ * Aplica todas as regras WCAG a um conjunto de telas.
+ * Os conteúdos dos arquivos são lidos localmente e NÃO são enviados ao servidor.
+ * Realiza deduplicação por fingerprint: o mesmo problema em N telas vira 1 violação
+ * com occurrenceCount = N e affectedScreens = [...].
+ */
+export declare function auditWcag(screens: ScreenMap[], contentsByFile: Record<string, string>): {
+    violations: WcagViolation[];
+    checks: WcagChecks;
+};
+/** Conta violações por severidade (após deduplicação). */
+export declare function summarize(violations: WcagViolation[]): WcagSummary;
+export {};
+//# sourceMappingURL=wcag.d.ts.map

package/dist/scanner/wcag.d.ts.map

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