accessibility-server-mcp 1.0.7 → 1.0.9

package/dist/utils/standard-presets.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Utility for managing standard presets and tag expansion
+ */
+import { StandardTag, StandardPreset } from '../types/accessibility.js';
+/**
+ * Mapping of preset names to their corresponding standard tags
+ */
+export declare const STANDARD_PRESETS: Record<StandardPreset, StandardTag[]>;
+/**
+ * Expand preset strings into their corresponding standard tags
+ *
+ * @param presets - Array of preset names to expand
+ * @returns Array of standard tags
+ */
+export declare function expandStandardPresets(presets: StandardPreset[]): StandardTag[];
+/**
+ * Check if a preset includes ADA context (for generating ADA-specific guidance)
+ *
+ * @param presets - Array of preset names
+ * @returns True if ADA preset is included
+ */
+export declare function shouldGenerateAdaGuidance(presets?: StandardPreset[]): boolean;
+/**
+ * Get default standard tags (WCAG AA fallback)
+ *
+ * @returns Default standard tags array
+ */
+export declare function getDefaultStandards(): StandardTag[];
+/**
+ * Combine explicit standards with preset-expanded standards
+ *
+ * @param standards - Explicit standard tags (if provided)
+ * @param presets - Standard presets (if provided)
+ * @returns Combined and deduplicated array of standard tags
+ */
+export declare function combineStandardsAndPresets(standards?: StandardTag[], presets?: StandardPreset[]): StandardTag[];
+/**
+ * Convert legacy WCAG level to corresponding preset
+ * For backward compatibility
+ *
+ * @param wcagLevel - Legacy WCAG level (A, AA, AAA)
+ * @returns Corresponding preset name
+ */
+export declare function wcagLevelToPreset(wcagLevel: 'A' | 'AA' | 'AAA'): StandardPreset;
+/**
+ * Get all available preset names
+ *
+ * @returns Array of all preset names
+ */
+export declare function getAvailablePresets(): StandardPreset[];
+/**
+ * Get description of a preset
+ *
+ * @param preset - Preset name
+ * @returns Human-readable description
+ */
+export declare function getPresetDescription(preset: StandardPreset): string;
+//# sourceMappingURL=standard-presets.d.ts.map

package/dist/utils/standard-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-presets.d.ts","sourceRoot":"","sources":["../../src/utils/standard-presets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAA0B,MAAM,2BAA2B,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,CAoFlE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CAW9E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,EAAE,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,CAAC,EAAE,WAAW,EAAE,EACzB,OAAO,CAAC,EAAE,cAAc,EAAE,GACzB,WAAW,EAAE,CAoBf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,GAAG,cAAc,CAO/E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAenE"}

package/dist/utils/standard-presets.js

@@ -0,0 +1,188 @@
+/**
+ * Utility for managing standard presets and tag expansion
+ */
+import { STANDARD_TAG_CONSTANTS } from '../types/accessibility.js';
+/**
+ * Mapping of preset names to their corresponding standard tags
+ */
+export const STANDARD_PRESETS = {
+    // WCAG presets
+    'wcag-a': [
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21A,
+    ],
+    'wcag-aa': [
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2AA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21AA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG22AA,
+    ],
+    'wcag-aaa': [
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2AA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2AAA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21AA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG22AA,
+    ],
+    // Section 508 presets
+    'section508': [
+        STANDARD_TAG_CONSTANTS.SECTION_508.BASE,
+    ],
+    'section508-full': [
+        STANDARD_TAG_CONSTANTS.SECTION_508.BASE,
+        STANDARD_TAG_CONSTANTS.SECTION_508.SECTION_22_A,
+        STANDARD_TAG_CONSTANTS.SECTION_508.SECTION_22_F,
+        STANDARD_TAG_CONSTANTS.SECTION_508.SECTION_22_G,
+        STANDARD_TAG_CONSTANTS.SECTION_508.SECTION_22_I,
+    ],
+    // EN 301 549 preset
+    'en301549': [
+        STANDARD_TAG_CONSTANTS.EN_301_549.BASE,
+    ],
+    // Trusted Tester preset
+    'trustedtester': [
+        STANDARD_TAG_CONSTANTS.TRUSTED_TESTER.V5,
+    ],
+    // RGAA preset
+    'rgaa': [
+        STANDARD_TAG_CONSTANTS.RGAA.V4,
+    ],
+    // ADA preset (maps to WCAG 2.1 AA)
+    'ada': [
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2AA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21AA,
+    ],
+    // Best practice preset
+    'best-practice': [
+        STANDARD_TAG_CONSTANTS.SPECIAL.BEST_PRACTICE,
+    ],
+    // All standards preset (comprehensive testing)
+    'all-standards': [
+        // WCAG levels
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2AA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG2AAA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21A,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG21AA,
+        STANDARD_TAG_CONSTANTS.WCAG_LEVELS.WCAG22AA,
+        // Section 508
+        STANDARD_TAG_CONSTANTS.SECTION_508.BASE,
+        // EN 301 549
+        STANDARD_TAG_CONSTANTS.EN_301_549.BASE,
+        // Trusted Tester
+        STANDARD_TAG_CONSTANTS.TRUSTED_TESTER.V5,
+        // RGAA
+        STANDARD_TAG_CONSTANTS.RGAA.V4,
+        // ACT
+        STANDARD_TAG_CONSTANTS.SPECIAL.ACT,
+        // Best practices
+        STANDARD_TAG_CONSTANTS.SPECIAL.BEST_PRACTICE,
+    ],
+};
+/**
+ * Expand preset strings into their corresponding standard tags
+ *
+ * @param presets - Array of preset names to expand
+ * @returns Array of standard tags
+ */
+export function expandStandardPresets(presets) {
+    const expandedTags = new Set();
+    for (const preset of presets) {
+        const tags = STANDARD_PRESETS[preset];
+        if (tags) {
+            tags.forEach(tag => expandedTags.add(tag));
+        }
+    }
+    return Array.from(expandedTags);
+}
+/**
+ * Check if a preset includes ADA context (for generating ADA-specific guidance)
+ *
+ * @param presets - Array of preset names
+ * @returns True if ADA preset is included
+ */
+export function shouldGenerateAdaGuidance(presets) {
+    return presets?.includes('ada') ?? false;
+}
+/**
+ * Get default standard tags (WCAG AA fallback)
+ *
+ * @returns Default standard tags array
+ */
+export function getDefaultStandards() {
+    return STANDARD_PRESETS['wcag-aa'];
+}
+/**
+ * Combine explicit standards with preset-expanded standards
+ *
+ * @param standards - Explicit standard tags (if provided)
+ * @param presets - Standard presets (if provided)
+ * @returns Combined and deduplicated array of standard tags
+ */
+export function combineStandardsAndPresets(standards, presets) {
+    const allStandards = new Set();
+    // Add explicit standards
+    if (standards && standards.length > 0) {
+        standards.forEach(s => allStandards.add(s));
+    }
+    // Add expanded presets
+    if (presets && presets.length > 0) {
+        const expandedPresets = expandStandardPresets(presets);
+        expandedPresets.forEach(s => allStandards.add(s));
+    }
+    // If nothing specified, use default
+    if (allStandards.size === 0) {
+        return getDefaultStandards();
+    }
+    return Array.from(allStandards);
+}
+/**
+ * Convert legacy WCAG level to corresponding preset
+ * For backward compatibility
+ *
+ * @param wcagLevel - Legacy WCAG level (A, AA, AAA)
+ * @returns Corresponding preset name
+ */
+export function wcagLevelToPreset(wcagLevel) {
+    const mapping = {
+        'A': 'wcag-a',
+        'AA': 'wcag-aa',
+        'AAA': 'wcag-aaa',
+    };
+    return mapping[wcagLevel] || 'wcag-aa';
+}
+/**
+ * Get all available preset names
+ *
+ * @returns Array of all preset names
+ */
+export function getAvailablePresets() {
+    return Object.keys(STANDARD_PRESETS);
+}
+/**
+ * Get description of a preset
+ *
+ * @param preset - Preset name
+ * @returns Human-readable description
+ */
+export function getPresetDescription(preset) {
+    const descriptions = {
+        'wcag-a': 'WCAG Level A conformance (2.0, 2.1)',
+        'wcag-aa': 'WCAG Level AA conformance (2.0, 2.1, 2.2) - Default',
+        'wcag-aaa': 'WCAG Level AAA conformance (2.0, 2.1, 2.2)',
+        'section508': 'US Section 508 accessibility standard',
+        'section508-full': 'US Section 508 with all subsection requirements',
+        'en301549': 'European EN 301 549 accessibility standard',
+        'trustedtester': 'DHS Trusted Tester methodology',
+        'rgaa': 'French RGAA accessibility standard',
+        'ada': 'ADA Title III requirements (maps to WCAG 2.1 AA)',
+        'best-practice': 'Industry best practices for accessibility',
+        'all-standards': 'Comprehensive testing across all supported standards',
+    };
+    return descriptions[preset];
+}
+//# sourceMappingURL=standard-presets.js.map

package/dist/utils/standard-presets.js.map

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

package/dist/utils/standard-tag-metadata.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Utility for managing standard tag metadata
+ */
+import { StandardTag, StandardMetadata } from '../types/accessibility.js';
+/**
+ * Metadata map for common standard tags
+ */
+export declare const STANDARD_METADATA_MAP: Record<string, Omit<StandardMetadata, 'tag'>>;
+/**
+ * Get metadata for a standard tag with pattern matching
+ */
+export declare function getStandardMetadata(tag: StandardTag): StandardMetadata;
+/**
+ * Categorize standards by their family for reporting
+ */
+export declare function categorizeStandardsByFamily(standards: StandardTag[]): Record<string, StandardTag[]>;
+/**
+ * Get all unique standard categories from a list of tags
+ */
+export declare function getStandardCategories(standards: StandardTag[]): string[];
+/**
+ * Format standard tags for display
+ */
+/**
+ * Format standards for display with detailed breakdown
+ */
+export declare function formatStandardsForDisplay(standards: StandardTag[]): {
+    summary: string;
+    families: Record<string, StandardTag[]>;
+};
+/**
+ * Format standards as a simple summary string
+ */
+export declare function formatStandardsSummary(standards: StandardTag[]): string;
+//# sourceMappingURL=standard-tag-metadata.d.ts.map

package/dist/utils/standard-tag-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-tag-metadata.d.ts","sourceRoot":"","sources":["../../src/utils/standard-tag-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAwL/E,CAAC;AA2EF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,gBAAgB,CAoFtE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAoBnG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAOxE;AAED;;GAEG;AACH;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;CACzC,CAQA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CA8BvE"}