webmcp-cli 1.2.2 → 1.2.3

package/dist/recon/sitemap.js

@@ -0,0 +1,177 @@
+/**
+ * Sitemap Parser
+ *
+ * Fetches and parses sitemap.xml and sitemap index files.
+ * Uses native fetch. Handles missing/malformed sitemaps gracefully.
+ */
+/** Maximum number of sitemap index children to follow */
+const MAX_SITEMAP_INDEX_CHILDREN = 10;
+/** Maximum entries to collect across all sitemaps */
+const MAX_ENTRIES = 500;
+/** Fetch timeout for each sitemap request (ms) */
+const FETCH_TIMEOUT_MS = 10_000;
+/**
+ * Fetch with timeout using AbortController
+ */
+async function fetchWithTimeout(url, timeoutMs = FETCH_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, {
+            signal: controller.signal,
+            headers: { 'User-Agent': 'WebMCP-CLI/1.0 (sitemap-parser)' },
+            redirect: 'follow',
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Naive XML tag content extractor (avoids needing an XML parser dependency).
+ * Returns all text content between <tagName> and </tagName>.
+ */
+function extractTagValues(xml, tagName) {
+    const results = [];
+    const openTag = `<${tagName}`;
+    const closeTag = `</${tagName}>`;
+    let start = 0;
+    while (true) {
+        const openIdx = xml.indexOf(openTag, start);
+        if (openIdx === -1)
+            break;
+        // Find the end of the opening tag (handles attributes)
+        const openEnd = xml.indexOf('>', openIdx);
+        if (openEnd === -1)
+            break;
+        const closeIdx = xml.indexOf(closeTag, openEnd);
+        if (closeIdx === -1)
+            break;
+        const content = xml.substring(openEnd + 1, closeIdx).trim();
+        if (content) {
+            results.push(content);
+        }
+        start = closeIdx + closeTag.length;
+    }
+    return results;
+}
+/**
+ * Extract sitemap entries from XML content
+ */
+function parseSitemapXml(xml) {
+    const entries = [];
+    // Split by <url> blocks
+    const urlBlocks = xml.split(/<url\b[^>]*>/i).slice(1);
+    for (const block of urlBlocks) {
+        const endIdx = block.indexOf('</url>');
+        const urlBlock = endIdx !== -1 ? block.substring(0, endIdx) : block;
+        const locs = extractTagValues(urlBlock, 'loc');
+        const loc = locs[0];
+        if (!loc)
+            continue;
+        const lastmods = extractTagValues(urlBlock, 'lastmod');
+        const changefreqs = extractTagValues(urlBlock, 'changefreq');
+        const priorities = extractTagValues(urlBlock, 'priority');
+        entries.push({
+            loc,
+            lastmod: lastmods[0],
+            changefreq: changefreqs[0],
+            priority: priorities[0] ? parseFloat(priorities[0]) : undefined,
+        });
+        if (entries.length >= MAX_ENTRIES)
+            break;
+    }
+    return entries;
+}
+/**
+ * Check if XML content is a sitemap index
+ */
+function isSitemapIndex(xml) {
+    return xml.includes('<sitemapindex') || xml.includes('<sitemapindex>');
+}
+/**
+ * Extract child sitemap URLs from a sitemap index
+ */
+function extractIndexUrls(xml) {
+    // Split by <sitemap> blocks and extract <loc> from each
+    const sitemapBlocks = xml.split(/<sitemap\b[^>]*>/i).slice(1);
+    const urls = [];
+    for (const block of sitemapBlocks) {
+        const locs = extractTagValues(block, 'loc');
+        if (locs[0]) {
+            urls.push(locs[0]);
+        }
+        if (urls.length >= MAX_SITEMAP_INDEX_CHILDREN)
+            break;
+    }
+    return urls;
+}
+/**
+ * Fetch and parse a sitemap from a URL.
+ * Handles sitemap index files by recursively fetching children.
+ */
+export async function parseSitemap(baseUrl, sitemapUrl) {
+    const url = sitemapUrl ?? new URL('/sitemap.xml', baseUrl).href;
+    try {
+        const response = await fetchWithTimeout(url);
+        if (!response.ok) {
+            return {
+                found: false,
+                entries: [],
+                source: url,
+                isIndex: false,
+                error: `HTTP ${response.status}`,
+            };
+        }
+        const xml = await response.text();
+        if (isSitemapIndex(xml)) {
+            // Parse sitemap index — fetch children
+            const childUrls = extractIndexUrls(xml);
+            const allEntries = [];
+            const childResults = await Promise.allSettled(childUrls.map(async (childUrl) => {
+                try {
+                    const childResp = await fetchWithTimeout(childUrl);
+                    if (!childResp.ok)
+                        return [];
+                    const childXml = await childResp.text();
+                    return parseSitemapXml(childXml);
+                }
+                catch {
+                    return [];
+                }
+            }));
+            for (const result of childResults) {
+                if (result.status === 'fulfilled') {
+                    allEntries.push(...result.value);
+                    if (allEntries.length >= MAX_ENTRIES)
+                        break;
+                }
+            }
+            return {
+                found: true,
+                entries: allEntries.slice(0, MAX_ENTRIES),
+                source: url,
+                isIndex: true,
+            };
+        }
+        // Regular sitemap
+        const entries = parseSitemapXml(xml);
+        return {
+            found: entries.length > 0,
+            entries,
+            source: url,
+            isIndex: false,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            found: false,
+            entries: [],
+            source: url,
+            isIndex: false,
+            error: message,
+        };
+    }
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/recon/sitemap.js.map

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

package/dist/rules/accessibility/AXE-001.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AXE-001: Declarative Label Quality
+ *
+ * Checks that declarative form tools have good toolparamdescription
+ * values derived from labels. Labels should be descriptive enough
+ * for agents to understand what each parameter expects.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const AXE_001: Rule;

package/dist/rules/accessibility/AXE-001.js

@@ -0,0 +1,109 @@
+/**
+ * AXE-001: Declarative Label Quality
+ *
+ * Checks that declarative form tools have good toolparamdescription
+ * values derived from labels. Labels should be descriptive enough
+ * for agents to understand what each parameter expects.
+ */
+import { createRuleResult } from '../runner.js';
+const MIN_LABEL_LENGTH = 3;
+const VAGUE_LABELS = [
+    /^input$/i,
+    /^field$/i,
+    /^value$/i,
+    /^text$/i,
+    /^data$/i,
+    /^enter$/i,
+    /^type$/i,
+    /^here$/i,
+    /^\*$/,
+    /^\.+$/,
+];
+export const AXE_001 = {
+    id: 'AXE-001',
+    category: 'accessibility',
+    name: 'Declarative Label Quality',
+    description: 'Form labels should provide good toolparamdescription values for agent understanding',
+    severity: 'warning',
+    maxScore: 8,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative');
+        if (declarativeTools.length === 0) {
+            return createRuleResult('AXE-001', 8, {
+                passed: true,
+                score: 8,
+                message: 'No declarative tools detected (rule not applicable)',
+            });
+        }
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('AXE-001', 8, {
+                passed: true,
+                score: 8,
+                message: 'No HTML available for analysis',
+            });
+        }
+        const violations = [];
+        // Parse form fields from HTML
+        const formRegex = /<form[^>]*toolname\s*=\s*["']([^"']+)["'][^>]*>([\s\S]*?)<\/form>/gi;
+        let formMatch;
+        while ((formMatch = formRegex.exec(html)) !== null) {
+            const toolname = formMatch[1] ?? '';
+            const formBody = formMatch[2] ?? '';
+            // Find inputs without toolparamdescription
+            const inputRegex = /<(?:input|select|textarea)[^>]*name\s*=\s*["']([^"']+)["'][^>]*>/gi;
+            let inputMatch;
+            while ((inputMatch = inputRegex.exec(formBody)) !== null) {
+                const paramName = inputMatch[1] ?? '';
+                const inputTag = inputMatch[0];
+                // Skip hidden inputs
+                if (/type\s*=\s*["']hidden["']/i.test(inputTag))
+                    continue;
+                // Check for toolparamdescription
+                const descMatch = inputTag.match(/toolparamdescription\s*=\s*["']([^"']*?)["']/i);
+                const desc = descMatch?.[1] ?? '';
+                // Check label text as fallback
+                const labelRegex = new RegExp(`<label[^>]*for\\s*=\\s*["']${paramName}["'][^>]*>([^<]*)</label>`, 'i');
+                const labelMatch = formBody.match(labelRegex);
+                const labelText = labelMatch?.[1]?.trim() ?? '';
+                const effectiveDesc = desc || labelText;
+                if (effectiveDesc.length < MIN_LABEL_LENGTH) {
+                    violations.push({
+                        tool: toolname,
+                        param: paramName,
+                        issue: `No description or label (length: ${effectiveDesc.length})`,
+                    });
+                }
+                else if (VAGUE_LABELS.some((p) => p.test(effectiveDesc))) {
+                    violations.push({
+                        tool: toolname,
+                        param: paramName,
+                        issue: `Label "${effectiveDesc}" is too vague`,
+                    });
+                }
+            }
+        }
+        if (violations.length === 0) {
+            return createRuleResult('AXE-001', 8, {
+                passed: true,
+                score: 8,
+                message: 'All declarative form parameters have good labels',
+            });
+        }
+        const penalty = Math.min(violations.length * 2, 8);
+        const score = Math.max(0, 8 - penalty);
+        return createRuleResult('AXE-001', 8, {
+            passed: false,
+            score,
+            message: `${violations.length} form parameter(s) have poor label quality`,
+            details: violations.map((v) => `Tool "${v.tool}" param "${v.param}": ${v.issue}`),
+            suggestions: [
+                'Add toolparamdescription attributes to form inputs for clear agent guidance',
+                'Use descriptive labels that explain what the field expects',
+                'Example: <input name="email" toolparamdescription="User email address for account recovery">',
+            ],
+            affectedTools: [...new Set(violations.map((v) => v.tool))],
+        });
+    },
+};
+//# sourceMappingURL=AXE-001.js.map

package/dist/rules/accessibility/AXE-001.js.map

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

package/dist/rules/accessibility/AXE-002.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AXE-002: ARIA Descriptions Used
+ *
+ * Checks if ARIA descriptions on form fields enhance the
+ * toolparamdescription values provided to agents.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const AXE_002: Rule;

package/dist/rules/accessibility/AXE-002.js

@@ -0,0 +1,85 @@
+/**
+ * AXE-002: ARIA Descriptions Used
+ *
+ * Checks if ARIA descriptions on form fields enhance the
+ * toolparamdescription values provided to agents.
+ */
+import { createRuleResult } from '../runner.js';
+export const AXE_002 = {
+    id: 'AXE-002',
+    category: 'accessibility',
+    name: 'ARIA Descriptions Used',
+    description: 'ARIA descriptions on form fields should enhance parameter descriptions',
+    severity: 'info',
+    maxScore: 5,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative');
+        if (declarativeTools.length === 0) {
+            return createRuleResult('AXE-002', 5, {
+                passed: true,
+                score: 5,
+                message: 'No declarative tools detected (rule not applicable)',
+            });
+        }
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('AXE-002', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML available for analysis',
+            });
+        }
+        // Count fields with and without ARIA descriptions in toolname forms
+        const formRegex = /<form[^>]*toolname\s*=\s*["'][^"']+["'][^>]*>([\s\S]*?)<\/form>/gi;
+        let totalFields = 0;
+        let fieldsWithAria = 0;
+        let formMatch;
+        while ((formMatch = formRegex.exec(html)) !== null) {
+            const formBody = formMatch[1] ?? '';
+            const inputRegex = /<(?:input|select|textarea)[^>]*name\s*=\s*["'][^"']+["'][^>]*>/gi;
+            let inputMatch;
+            while ((inputMatch = inputRegex.exec(formBody)) !== null) {
+                const tag = inputMatch[0];
+                if (/type\s*=\s*["']hidden["']/i.test(tag))
+                    continue;
+                totalFields++;
+                if (/aria-description\s*=\s*["'][^"']+["']/i.test(tag) ||
+                    /aria-describedby\s*=\s*["'][^"']+["']/i.test(tag)) {
+                    fieldsWithAria++;
+                }
+            }
+        }
+        if (totalFields === 0) {
+            return createRuleResult('AXE-002', 5, {
+                passed: true,
+                score: 5,
+                message: 'No form fields found in declarative tools',
+            });
+        }
+        const ariaRatio = fieldsWithAria / totalFields;
+        if (ariaRatio >= 0.5) {
+            return createRuleResult('AXE-002', 5, {
+                passed: true,
+                score: 5,
+                message: `${fieldsWithAria}/${totalFields} fields use ARIA descriptions`,
+            });
+        }
+        const score = Math.round(ariaRatio * 5);
+        const fieldsWithout = totalFields - fieldsWithAria;
+        return createRuleResult('AXE-002', 5, {
+            passed: false,
+            score,
+            message: `${fieldsWithout}/${totalFields} form fields lack ARIA descriptions`,
+            details: [
+                `Only ${fieldsWithAria} of ${totalFields} fields have aria-description or aria-describedby`,
+                'ARIA descriptions enhance agent understanding of field purpose',
+            ],
+            suggestions: [
+                'Add aria-description to form fields for richer parameter descriptions',
+                'Example: <input aria-description="Enter a valid email address">',
+                'ARIA descriptions are used as fallback when toolparamdescription is absent',
+            ],
+        });
+    },
+};
+//# sourceMappingURL=AXE-002.js.map

package/dist/rules/accessibility/AXE-002.js.map

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

package/dist/rules/accessibility/AXE-003.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AXE-003: Select Option Descriptions
+ *
+ * Checks that <select> options have meaningful text content,
+ * not just values, so agents can understand available choices.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const AXE_003: Rule;

package/dist/rules/accessibility/AXE-003.js

@@ -0,0 +1,94 @@
+/**
+ * AXE-003: Select Option Descriptions
+ *
+ * Checks that <select> options have meaningful text content,
+ * not just values, so agents can understand available choices.
+ */
+import { createRuleResult } from '../runner.js';
+export const AXE_003 = {
+    id: 'AXE-003',
+    category: 'accessibility',
+    name: 'Select Option Descriptions',
+    description: 'Select options should have meaningful text content for agent understanding',
+    severity: 'info',
+    maxScore: 5,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative');
+        if (declarativeTools.length === 0) {
+            return createRuleResult('AXE-003', 5, {
+                passed: true,
+                score: 5,
+                message: 'No declarative tools detected (rule not applicable)',
+            });
+        }
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('AXE-003', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML available for analysis',
+            });
+        }
+        // Find select elements inside toolname forms
+        const formRegex = /<form[^>]*toolname\s*=\s*["']([^"']+)["'][^>]*>([\s\S]*?)<\/form>/gi;
+        const poorSelects = [];
+        let formMatch;
+        while ((formMatch = formRegex.exec(html)) !== null) {
+            const toolname = formMatch[1] ?? '';
+            const formBody = formMatch[2] ?? '';
+            const selectRegex = /<select[^>]*name\s*=\s*["']([^"']+)["'][^>]*>([\s\S]*?)<\/select>/gi;
+            let selectMatch;
+            while ((selectMatch = selectRegex.exec(formBody)) !== null) {
+                const selectName = selectMatch[1] ?? '';
+                const selectBody = selectMatch[2] ?? '';
+                // Extract options
+                const optionRegex = /<option[^>]*value\s*=\s*["']([^"']*)["'][^>]*>([^<]*)<\/option>/gi;
+                let optionMatch;
+                let totalOptions = 0;
+                let poorOptions = 0;
+                while ((optionMatch = optionRegex.exec(selectBody)) !== null) {
+                    const value = optionMatch[1] ?? '';
+                    const text = (optionMatch[2] ?? '').trim();
+                    if (!value && !text)
+                        continue; // skip empty placeholder options
+                    totalOptions++;
+                    // Check if text is just the value repeated or very short
+                    if (text.length === 0 ||
+                        text === value ||
+                        /^\d+$/.test(text)) {
+                        poorOptions++;
+                    }
+                }
+                if (totalOptions > 0 && poorOptions > totalOptions / 2) {
+                    poorSelects.push({
+                        tool: toolname,
+                        select: selectName,
+                        issue: `${poorOptions}/${totalOptions} options have poor or missing text`,
+                    });
+                }
+            }
+        }
+        if (poorSelects.length === 0) {
+            return createRuleResult('AXE-003', 5, {
+                passed: true,
+                score: 5,
+                message: 'All select options have meaningful text content',
+            });
+        }
+        const penalty = Math.min(poorSelects.length * 2, 5);
+        const score = Math.max(0, 5 - penalty);
+        return createRuleResult('AXE-003', 5, {
+            passed: false,
+            score,
+            message: `${poorSelects.length} select element(s) have poor option descriptions`,
+            details: poorSelects.map((s) => `Tool "${s.tool}" select "${s.select}": ${s.issue}`),
+            suggestions: [
+                'Ensure <option> elements have descriptive text, not just value attributes',
+                'Use human-readable text: <option value="us">United States</option>',
+                'Agents use option text to understand available choices',
+            ],
+            affectedTools: [...new Set(poorSelects.map((s) => s.tool))],
+        });
+    },
+};
+//# sourceMappingURL=AXE-003.js.map

package/dist/rules/accessibility/AXE-003.js.map

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

package/dist/rules/accessibility/AXE-004.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AXE-004: Radio Group Descriptions
+ *
+ * Checks that radio button groups have a toolparamdescription
+ * on the first input, so agents understand what the group represents.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const AXE_004: Rule;

package/dist/rules/accessibility/AXE-004.js

@@ -0,0 +1,101 @@
+/**
+ * AXE-004: Radio Group Descriptions
+ *
+ * Checks that radio button groups have a toolparamdescription
+ * on the first input, so agents understand what the group represents.
+ */
+import { createRuleResult } from '../runner.js';
+export const AXE_004 = {
+    id: 'AXE-004',
+    category: 'accessibility',
+    name: 'Radio Group Descriptions',
+    description: 'Radio groups should have toolparamdescription on the first input',
+    severity: 'info',
+    maxScore: 5,
+    async check(context) {
+        const declarativeTools = context.tools.filter((t) => t.source === 'declarative');
+        if (declarativeTools.length === 0) {
+            return createRuleResult('AXE-004', 5, {
+                passed: true,
+                score: 5,
+                message: 'No declarative tools detected (rule not applicable)',
+            });
+        }
+        const html = context.html ?? '';
+        if (html.length === 0) {
+            return createRuleResult('AXE-004', 5, {
+                passed: true,
+                score: 5,
+                message: 'No HTML available for analysis',
+            });
+        }
+        const formRegex = /<form[^>]*toolname\s*=\s*["']([^"']+)["'][^>]*>([\s\S]*?)<\/form>/gi;
+        const violations = [];
+        let formMatch;
+        while ((formMatch = formRegex.exec(html)) !== null) {
+            const toolname = formMatch[1] ?? '';
+            const formBody = formMatch[2] ?? '';
+            // Find radio inputs grouped by name
+            const radioRegex = /<input[^>]*type\s*=\s*["']radio["'][^>]*name\s*=\s*["']([^"']+)["'][^>]*>/gi;
+            const radioGroups = new Map();
+            let radioMatch;
+            while ((radioMatch = radioRegex.exec(formBody)) !== null) {
+                const name = radioMatch[1] ?? '';
+                const tag = radioMatch[0];
+                if (!radioGroups.has(name)) {
+                    radioGroups.set(name, []);
+                }
+                radioGroups.get(name).push(tag);
+            }
+            // Also check reverse attribute order (type after name)
+            const radioRegex2 = /<input[^>]*name\s*=\s*["']([^"']+)["'][^>]*type\s*=\s*["']radio["'][^>]*>/gi;
+            while ((radioMatch = radioRegex2.exec(formBody)) !== null) {
+                const name = radioMatch[1] ?? '';
+                const tag = radioMatch[0];
+                if (!radioGroups.has(name)) {
+                    radioGroups.set(name, []);
+                }
+                const existing = radioGroups.get(name);
+                if (!existing.includes(tag)) {
+                    existing.push(tag);
+                }
+            }
+            for (const [groupName, tags] of radioGroups) {
+                if (tags.length < 2)
+                    continue;
+                // Check if the first radio in the group has toolparamdescription
+                const firstTag = tags[0] ?? '';
+                const hasDesc = /toolparamdescription\s*=\s*["'][^"']+["']/i.test(firstTag);
+                // Also check if any radio has it
+                const anyHasDesc = tags.some((t) => /toolparamdescription\s*=\s*["'][^"']+["']/i.test(t));
+                // Also check for a fieldset/legend or associated label
+                const hasFieldset = new RegExp(`<fieldset[^>]*>[\\s\\S]*?${groupName}[\\s\\S]*?<legend[^>]*>([^<]+)</legend>`, 'i').test(formBody);
+                if (!hasDesc && !anyHasDesc && !hasFieldset) {
+                    violations.push({ tool: toolname, group: groupName });
+                }
+            }
+        }
+        if (violations.length === 0) {
+            return createRuleResult('AXE-004', 5, {
+                passed: true,
+                score: 5,
+                message: 'All radio groups have adequate descriptions',
+            });
+        }
+        const penalty = Math.min(violations.length * 2, 5);
+        const score = Math.max(0, 5 - penalty);
+        return createRuleResult('AXE-004', 5, {
+            passed: false,
+            score,
+            message: `${violations.length} radio group(s) lack descriptions`,
+            details: violations.map((v) => `Tool "${v.tool}" radio group "${v.group}" has no toolparamdescription or fieldset legend`),
+            suggestions: [
+                'Add toolparamdescription to the first radio input in each group',
+                'Or wrap radio groups in <fieldset> with a descriptive <legend>',
+                'Example: <input type="radio" name="size" toolparamdescription="Product size selection">',
+            ],
+            affectedTools: [...new Set(violations.map((v) => v.tool))],
+        });
+    },
+};
+//# sourceMappingURL=AXE-004.js.map

package/dist/rules/accessibility/AXE-004.js.map

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