@atlaskit/ads-mcp 0.20.3 → 0.20.4

package/dist/es2019/tools/plan/index.js

@@ -1,147 +0,0 @@
-/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
-
-import { z } from 'zod';
-import { zodToJsonSchema } from '../../helpers';
-import { searchComponentsTool } from '../search-components';
-import { searchIconsTool } from '../search-icons';
-import { searchTokensTool } from '../search-tokens';
-export const planInputSchema = z.object({
-  tokens: z.array(z.string()).describe('Search terms for ADS design tokens (fuzzy by default). Use `[]` if you only need icons or components. Prefer **at least two** terms per non-empty list when you know what you need.'),
-  icons: z.array(z.string()).describe('Search terms for ADS icons. Use `[]` if you only need tokens or components. Prefer **at least two** terms per non-empty list when known.'),
-  components: z.array(z.string()).describe('Search terms for ADS components. Use `[]` if you only need tokens or icons. Prefer **at least two** terms per non-empty list when known.'),
-  limit: z.number().default(2).describe('Max matches **per term** for each non-empty list (default 2). Same limit applies to tokens, icons, and components searches.').optional()
-});
-export const listPlanTool = {
-  name: 'ads_plan',
-  description: `Runs **ads_search_tokens**, **ads_search_icons**, and **ads_search_components** in one call and returns a single JSON payload (each section only if that list was non-empty). Use this as the default way to discover ADS **tokens**, **icons**, and **components** for a UI task.
-
-WHEN TO USE:
-**Implementing or iterating on a UI**—new screen, feature, or polish—and you need candidate **token** names, **icon** imports, and **component** packages/props in one pass. Also use when exploring ADS building blocks before you write code.
-
-At least one of \`tokens\`, \`icons\`, or \`components\` must contain search terms (use \`[]\` for lists you do not need).
-
-Prefer supplying **multiple** terms per non-empty array when you know them—broader queries improve recall. Some queries return no rows where metadata is thin; try alternate wording.
-
-This is equivalent to calling the individual search tools; there are no extra merge semantics beyond concatenating results.
-
-Example request:
-\`\`\`json
-{
-	"tokens": ["spacing", "inverted text", "background primary", "animation"],
-	"icons": ["search", "folder", "user"],
-	"components": ["button", "input", "select", "heading"]
-}
-\`\`\`
-
-Example token usage:
-\`\`\`tsx
-import { token } from '@atlaskit/tokens';
-const styles = css({ color: token('color.text'), padding: token('space.100') });
-\`\`\`
-
-Example icon usage:
-\`\`\`tsx
-import AddIcon from '@atlaskit/icon/core/add';
-<AddIcon label="Add work item" size="small" />
-\`\`\``,
-  annotations: {
-    title: 'Search ADS tokens, icons, and components to plan what to build',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(planInputSchema)
-};
-export const planTool = async ({
-  tokens: tokens_search,
-  icons: icons_search,
-  components: components_search,
-  limit
-}) => {
-  // Validate that at least one search type is provided
-  if (!(tokens_search !== null && tokens_search !== void 0 && tokens_search.length) && !(icons_search !== null && icons_search !== void 0 && icons_search.length) && !(components_search !== null && components_search !== void 0 && components_search.length)) {
-    return {
-      isError: true,
-      content: [{
-        type: 'text',
-        text: 'Error: At least one search type (tokens_search, icons_search, or components_search) must be provided with search terms'
-      }]
-    };
-  }
-  const results = {};
-
-  // Execute searches in parallel
-  const searchPromises = [];
-  if (tokens_search !== null && tokens_search !== void 0 && tokens_search.length) {
-    searchPromises.push(searchTokensTool({
-      terms: tokens_search,
-      limit
-    }).then(result => {
-      results.tokens = result;
-    }));
-  }
-  if (icons_search !== null && icons_search !== void 0 && icons_search.length) {
-    searchPromises.push(searchIconsTool({
-      terms: icons_search,
-      limit
-    }).then(result => {
-      results.icons = result;
-    }));
-  }
-  if (components_search !== null && components_search !== void 0 && components_search.length) {
-    searchPromises.push(searchComponentsTool({
-      terms: components_search,
-      limit
-    }).then(result => {
-      results.components = result;
-    }));
-  }
-
-  // Wait for all searches to complete
-  await Promise.all(searchPromises);
-
-  // Helper function to safely count results
-  const getResultCount = result => {
-    var _result$content;
-    if (!result || result.isError || !((_result$content = result.content) !== null && _result$content !== void 0 && _result$content[0])) {
-      return 0;
-    }
-    const firstContent = result.content[0];
-    if (firstContent.type !== 'text') {
-      return 0;
-    }
-    try {
-      const parsed = JSON.parse(firstContent.text);
-      return Array.isArray(parsed) ? parsed.length : 0;
-    } catch {
-      return 0;
-    }
-  };
-
-  // Format the consolidated results
-  const consolidatedResult = {
-    searchResults: {
-      ...(results.tokens && {
-        tokens: results.tokens
-      }),
-      ...(results.icons && {
-        icons: results.icons
-      }),
-      ...(results.components && {
-        components: results.components
-      })
-    },
-    summary: {
-      tokensFound: getResultCount(results.tokens),
-      iconsFound: getResultCount(results.icons),
-      componentsFound: getResultCount(results.components)
-    }
-  };
-  return {
-    content: [{
-      type: 'text',
-      text: JSON.stringify(consolidatedResult, null, 2)
-    }]
-  };
-};

package/dist/esm/tools/analyze-a11y/index.js

@@ -1,478 +0,0 @@
-import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import _regeneratorRuntime from "@babel/runtime/regenerator";
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-import { AxePuppeteer } from '@axe-core/puppeteer';
-/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
-
-import axe from 'axe-core';
-import puppeteer from 'puppeteer';
-import { z } from 'zod';
-import { zodToJsonSchema } from '../../helpers';
-export var analyzeA11yInputSchema = z.object({
-  code: z.string().describe('Source code of a React component or JSX snippet to analyze (string content only—no file path).'),
-  componentName: z.string().optional().describe('Optional label for the component under review (for summaries and reports).'),
-  context: z.string().optional().describe('Optional: how the component is used (e.g. in a form, modal) to improve suggestions.'),
-  includePatternAnalysis: z.boolean().default(true).describe('When true (default), runs regex-based heuristics on the code string (e.g. unlabeled buttons, missing alt) in addition to other analysis.').optional()
-});
-export var listAnalyzeA11yTool = {
-  name: 'ads_analyze_a11y',
-  description: "Analyzes a **string of React/JSX** code for likely accessibility issues (heuristics and/or axe-related paths) and returns hints that often **point to** `ads_suggest_a11y_fixes` or generic axe/WCAG-style context\u2014not every finding maps to a specific ADS component fix.\n\nWHEN TO USE:\nYou have component source as text and want automated checks or heuristics before or during a code review.\n\nLIMITATIONS:\n- Does not replace testing in a real browser with assistive technologies or full keyboard traversal.\n- For rendered UI, `ads_analyze_localhost_a11y` (live URL + axe) is preferable when available\u2014it is **only exposed when this MCP runs locally**, not in the remote MCP deployment.",
-  annotations: {
-    title: 'Analyze accessibility (code string)',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(analyzeA11yInputSchema)
-};
-export var analyzeA11yLocalhostInputSchema = z.object({
-  url: z.string().describe('Fully qualified page URL to load (e.g. `http://localhost:9000` or a dev URL). Must be reachable from this MCP process.'),
-  componentName: z.string().optional().describe('Optional label for reporting (e.g. feature or component under test).'),
-  context: z.string().optional().describe('Optional: route, user flow, or feature context for the analyzed page.'),
-  selector: z.string().optional().describe('Optional CSS selector to scope axe analysis to a subtree (e.g. `#my-form`, `[data-testid="panel"]`). Omit to analyze the whole document.')
-});
-export var listAnalyzeLocalhostA11yTool = {
-  name: 'ads_analyze_localhost_a11y',
-  description: "Loads a **live URL** in a headless browser, runs **axe-core**, and returns violations with follow-up hints (often suggesting `ads_suggest_a11y_fixes`). Output is anchored in **axe** rule text; remediation may be generic or ADS-biased depending on the violation.\n\n**Availability:** This tool is only registered when the ADS MCP runs **on your machine** (local MCP). It is **not** available in the **remote** MCP offering\u2014use `ads_analyze_a11y` on source text there instead.\n\nWHEN TO USE:\nYou have a running app or storybook page and need automated accessibility results on **rendered** UI\u2014especially local or staging URLs.\n\nLIMITATIONS:\n- Does not replace manual testing with assistive technologies or keyboard-only navigation.\n- Requires network access to the URL from the environment running the MCP.",
-  annotations: {
-    title: 'Analyze accessibility (live URL)',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(analyzeA11yLocalhostInputSchema)
-};
-
-// Common accessibility patterns to detect in code
-var accessibilityPatterns = [{
-  pattern: /<button[^>]*>(?!.*aria-label|.*>.*<\/button>)/g,
-  violation: 'Button without accessible text',
-  severity: 'error',
-  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Button solutions. Describe the issue as "button missing label", "empty button", or "button needs text".'
-}, {
-  pattern: /<img[^>]*>(?!.*alt=)/g,
-  violation: 'Image without alt text',
-  severity: 'error',
-  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Image solutions. Describe the issue as "image missing alt", "missing alt text", or "image accessibility".'
-}, {
-  pattern: /<div[^>]*onClick[^>]*>/g,
-  violation: 'Clickable div without accessibility',
-  severity: 'warning',
-  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS solutions. Describe the issue as "clickable div", "interactive div", or "div with click handler".'
-}, {
-  pattern: /color:\s*['"]#[0-9a-fA-F]{3,6}['"]/g,
-  violation: 'Hardcoded color values',
-  severity: 'warning',
-  suggestion: 'Use the ads_suggest_a11y_fixes tool for design token solutions. Describe the issue as "hardcoded colors", "hex colors", or "design tokens".'
-}, {
-  pattern: /<input[^>]*>(?!.*id=)/g,
-  violation: 'Input without associated label',
-  severity: 'error',
-  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS form solutions. Describe the issue as "input missing label", "form field without label", or "unlabeled input".'
-}, {
-  pattern: /<div[^>]*role="button"[^>]*>/g,
-  violation: 'Custom button without full accessibility',
-  severity: 'warning',
-  suggestion: 'Use the ads_suggest_a11y_fixes tool for ADS Button/Focusable solutions. Describe the issue as "custom button", "div with button role", or "interactive element".'
-}, {
-  pattern: /style=\{[^}]*color[^}]*\}/g,
-  violation: 'Inline color styles',
-  severity: 'warning',
-  suggestion: 'Use the ads_suggest_a11y_fixes tool for design token solutions. Describe the issue as "inline styles", "hardcoded colors", or "color tokens".'
-}];
-
-// ADS accessibility guidelines reference
-var adsGuidelines = {
-  buttons: {
-    title: 'Button Accessibility',
-    guidelines: ['Always provide accessible labels for buttons', 'Use Button component for standard interactions', 'Use Focusable component for custom interactive elements', 'Avoid disabled buttons with tooltips', 'Ensure focus indicators are visible']
-  },
-  forms: {
-    title: 'Form Accessibility',
-    guidelines: ['Use TextField component for consistent labeling', 'Associate labels with inputs using id and htmlFor', 'Provide clear error messages with aria-describedby', 'Use MessageWrapper for form validation announcements']
-  },
-  images: {
-    title: 'Image Accessibility',
-    guidelines: ['Use Image component with proper alt text', 'Keep alt text under 125 characters', 'Leave alt="" for decorative images', 'Describe the purpose, not just the content']
-  },
-  colors: {
-    title: 'Color and Contrast',
-    guidelines: ['Use design tokens for consistent contrast ratios', 'Never rely on color alone for information', 'Use color.text tokens for proper contrast', 'Test with high contrast mode']
-  }
-};
-
-// Helper function to map axe-core violations to ADS-specific fixes
-function mapAxeViolationsToADSFixes(violations) {
-  return violations.map(function (violation) {
-    var adsFix = generateADSFixForViolation(violation);
-    return _objectSpread(_objectSpread({}, violation), {}, {
-      type: adsFix.title,
-      // Use the specific fix key that matches fixes.ts
-      adsFix: adsFix,
-      severity: violation.impact === 'critical' || violation.impact === 'serious' ? 'error' : 'warning'
-    });
-  });
-}
-
-// Helper function to provide ADS-specific guidance for axe-core violations
-function generateADSFixForViolation(violation) {
-  var id = violation.id,
-    description = violation.description,
-    help = violation.help,
-    tags = violation.tags;
-
-  // Provide general guidance without trying to map to specific fixes.ts keys
-  var adsFix = "Use the ads_suggest_a11y_fixes tool to get specific ADS component solutions. Describe the issue using the violation details: \"".concat(help, "\" or in your own words (e.g., \"button has no text\", \"missing alt text\", \"form field needs label\").");
-  return {
-    title: help,
-    // Use axe-core's human-readable description
-    description: description,
-    adsFix: adsFix,
-    example: 'The ads_suggest_a11y_fixes tool provides detailed code examples and ADS component solutions',
-    violationId: id,
-    axeHelp: help,
-    tags: tags,
-    wcagTags: tags.filter(function (tag) {
-      return tag.startsWith('wcag');
-    }),
-    // Extract WCAG compliance info
-    reference: "https://atlassian.design/llms-a11y.txt",
-    recommendations: ['Use ADS components for better accessibility out of the box', 'Reference the ads_suggest_a11y_fixes tool for specific solutions', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
-  };
-}
-export var analyzeA11yTool = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
-    var code, componentName, context, _params$includePatter, includePatternAnalysis, violations, suggestions, axeResults, _axeResults$violation, _axeResults$passes, _axeResults$incomplet, results, adsViolations, relevantGuidelines, summary;
-    return _regeneratorRuntime.wrap(function _callee$(_context) {
-      while (1) switch (_context.prev = _context.next) {
-        case 0:
-          code = params.code, componentName = params.componentName, context = params.context, _params$includePatter = params.includePatternAnalysis, includePatternAnalysis = _params$includePatter === void 0 ? true : _params$includePatter;
-          violations = [];
-          suggestions = [];
-          axeResults = {};
-          _context.prev = 4;
-          _context.next = 7;
-          return axe.run({
-            fromFrames: ['iframe', 'html']
-          });
-        case 7:
-          results = _context.sent;
-          // Process axe-core results
-          if (results.violations && results.violations.length > 0) {
-            adsViolations = mapAxeViolationsToADSFixes(results.violations);
-            violations.push.apply(violations, _toConsumableArray(adsViolations));
-            axeResults.violations = results.violations;
-            axeResults.passes = results.passes;
-            axeResults.incomplete = results.incomplete;
-          }
-
-          // Include pattern-based analysis if requested
-          if (includePatternAnalysis) {
-            accessibilityPatterns.forEach(function (pattern) {
-              var matches = code.match(pattern.pattern);
-              if (matches) {
-                violations.push({
-                  type: pattern.violation,
-                  severity: pattern.severity,
-                  count: matches.length,
-                  suggestion: pattern.suggestion,
-                  adsFix: 'Use the ads_suggest_a11y_fixes tool for specific ADS component solutions',
-                  example: 'The ads_suggest_a11y_fixes tool provides detailed code examples',
-                  source: 'pattern-analysis'
-                });
-              }
-            });
-          }
-
-          // Generate ADS-specific suggestions
-          if (violations.length > 0) {
-            suggestions.push({
-              title: 'Accessibility Improvements Needed',
-              description: "Found ".concat(violations.length, " accessibility issues in your code."),
-              violations: violations,
-              nextSteps: ['Review each violation and apply the suggested fixes', 'Use ADS components instead of custom implementations', 'Test with screen readers and keyboard navigation', 'Run automated accessibility tests']
-            });
-          }
-
-          // Provide relevant ADS guidelines
-          relevantGuidelines = [];
-          if (code.includes('button') || code.includes('onClick')) {
-            relevantGuidelines.push(adsGuidelines.buttons);
-          }
-          if (code.includes('input') || code.includes('form')) {
-            relevantGuidelines.push(adsGuidelines.forms);
-          }
-          if (code.includes('img') || code.includes('image')) {
-            relevantGuidelines.push(adsGuidelines.images);
-          }
-          if (code.includes('color') || code.includes('style')) {
-            relevantGuidelines.push(adsGuidelines.colors);
-          }
-
-          // Generate summary
-          summary = {
-            componentName: componentName || 'Unknown component',
-            totalViolations: violations.length,
-            severityBreakdown: {
-              error: violations.filter(function (v) {
-                return v.severity === 'error';
-              }).length,
-              warning: violations.filter(function (v) {
-                return v.severity === 'warning';
-              }).length
-            },
-            context: context || 'No additional context provided',
-            axeResults: {
-              violations: ((_axeResults$violation = axeResults.violations) === null || _axeResults$violation === void 0 ? void 0 : _axeResults$violation.length) || 0,
-              passes: ((_axeResults$passes = axeResults.passes) === null || _axeResults$passes === void 0 ? void 0 : _axeResults$passes.length) || 0,
-              incomplete: ((_axeResults$incomplet = axeResults.incomplete) === null || _axeResults$incomplet === void 0 ? void 0 : _axeResults$incomplet.length) || 0
-            }
-          };
-          return _context.abrupt("return", {
-            content: [{
-              type: 'text',
-              text: JSON.stringify({
-                summary: summary,
-                violations: violations,
-                suggestions: suggestions,
-                relevantGuidelines: relevantGuidelines,
-                axeResults: axeResults,
-                recommendations: ['Use ADS components for better accessibility out of the box', 'Reference https://atlassian.design/llms-a11y.txt for detailed guidelines', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
-              }, null, 2)
-            }]
-          });
-        case 20:
-          _context.prev = 20;
-          _context.t0 = _context["catch"](4);
-          // Fallback to pattern-based analysis if axe-core fails
-          // console.warn('Axe-core analysis failed, falling back to pattern analysis:', error);
-
-          // Run pattern analysis as fallback
-          accessibilityPatterns.forEach(function (pattern) {
-            var matches = code.match(pattern.pattern);
-            if (matches) {
-              violations.push({
-                type: pattern.violation,
-                severity: pattern.severity,
-                count: matches.length,
-                suggestion: pattern.suggestion,
-                adsFix: 'Use the ads_suggest_a11y_fixes tool for specific ADS component solutions',
-                example: 'The ads_suggest_a11y_fixes tool provides detailed code examples',
-                source: 'pattern-analysis-fallback'
-              });
-            }
-          });
-          return _context.abrupt("return", {
-            content: [{
-              type: 'text',
-              text: JSON.stringify({
-                summary: {
-                  componentName: componentName || 'Unknown component',
-                  totalViolations: violations.length,
-                  severityBreakdown: {
-                    error: violations.filter(function (v) {
-                      return v.severity === 'error';
-                    }).length,
-                    warning: violations.filter(function (v) {
-                      return v.severity === 'warning';
-                    }).length
-                  },
-                  context: context || 'No additional context provided',
-                  note: 'Analysis completed using pattern matching (axe-core analysis failed)'
-                },
-                violations: violations,
-                suggestions: violations.length > 0 ? [{
-                  title: 'Accessibility Improvements Needed',
-                  description: "Found ".concat(violations.length, " accessibility issues in your code."),
-                  violations: violations,
-                  nextSteps: ['Review each violation and apply the suggested fixes', 'Use ADS components instead of custom implementations', 'Test with screen readers and keyboard navigation', 'Run automated accessibility tests']
-                }] : [],
-                error: 'Axe-core analysis failed, used pattern-based analysis as fallback',
-                recommendations: ['Use ADS components for better accessibility out of the box', 'Reference https://atlassian.design/llms-a11y.txt for detailed guidelines', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
-              }, null, 2)
-            }]
-          });
-        case 24:
-        case "end":
-          return _context.stop();
-      }
-    }, _callee, null, [[4, 20]]);
-  }));
-  return function analyzeA11yTool(_x) {
-    return _ref.apply(this, arguments);
-  };
-}();
-export var analyzeLocalhostA11yTool = /*#__PURE__*/function () {
-  var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(params) {
-    var url, componentName, context, selector, violations, suggestions, axeResults, browser, page, _axeResults$violation2, _axeResults$passes2, _axeResults$incomplet2, elementExists, availableElements, axePuppeteer, results, adsViolations, relevantGuidelines, summary;
-    return _regeneratorRuntime.wrap(function _callee2$(_context2) {
-      while (1) switch (_context2.prev = _context2.next) {
-        case 0:
-          url = params.url, componentName = params.componentName, context = params.context, selector = params.selector;
-          violations = [];
-          suggestions = [];
-          axeResults = {};
-          _context2.next = 6;
-          return puppeteer.launch();
-        case 6:
-          browser = _context2.sent;
-          _context2.next = 9;
-          return browser.newPage();
-        case 9:
-          page = _context2.sent;
-          _context2.prev = 10;
-          _context2.next = 13;
-          return page.goto(url, {
-            waitUntil: 'networkidle0'
-          });
-        case 13:
-          if (!selector) {
-            _context2.next = 22;
-            break;
-          }
-          _context2.next = 16;
-          return page.$(selector);
-        case 16:
-          elementExists = _context2.sent;
-          if (elementExists) {
-            _context2.next = 22;
-            break;
-          }
-          _context2.next = 20;
-          return page.evaluate(function () {
-            var elements = Array.from(document.querySelectorAll('[id]'));
-            return elements.map(function (el) {
-              return "#".concat(el.id);
-            });
-          });
-        case 20:
-          availableElements = _context2.sent;
-          throw new Error("Element with selector \"".concat(selector, "\" not found on the page after waiting. Available elements: ").concat(availableElements.join(', ')));
-        case 22:
-          // Run axe-core accessibility analysis
-          axePuppeteer = new AxePuppeteer(page); // If selector is provided, analyze only that element
-          if (selector) {
-            axePuppeteer.include(selector);
-          }
-          _context2.next = 26;
-          return axePuppeteer.analyze();
-        case 26:
-          results = _context2.sent;
-          if (results.violations && results.violations.length > 0) {
-            adsViolations = mapAxeViolationsToADSFixes(results.violations);
-            violations.push.apply(violations, _toConsumableArray(adsViolations));
-            axeResults.violations = results.violations;
-            axeResults.passes = results.passes;
-            axeResults.incomplete = results.incomplete;
-          }
-
-          // Generate ADS-specific suggestions
-          if (violations.length > 0) {
-            suggestions.push({
-              title: 'Accessibility Improvements Needed',
-              description: "Found ".concat(violations.length, " accessibility issues in your code."),
-              violations: violations,
-              nextSteps: ['Review each violation and apply the suggested fixes', 'Use ADS components instead of custom implementations', 'Test with screen readers and keyboard navigation', 'Run automated accessibility tests']
-            });
-          }
-
-          // Provide relevant ADS guidelines
-          relevantGuidelines = [];
-          if (url.includes('button') || url.includes('onClick')) {
-            relevantGuidelines.push(adsGuidelines.buttons);
-          }
-          if (url.includes('input') || url.includes('form')) {
-            relevantGuidelines.push(adsGuidelines.forms);
-          }
-          if (url.includes('img') || url.includes('image')) {
-            relevantGuidelines.push(adsGuidelines.images);
-          }
-          if (url.includes('color') || url.includes('style')) {
-            relevantGuidelines.push(adsGuidelines.colors);
-          }
-
-          // Generate summary
-          summary = {
-            url: url,
-            selector: selector || 'Entire page analyzed',
-            componentName: componentName || 'Unknown component',
-            totalViolations: violations.length,
-            severityBreakdown: {
-              error: violations.filter(function (v) {
-                return v.severity === 'error';
-              }).length,
-              warning: violations.filter(function (v) {
-                return v.severity === 'warning';
-              }).length
-            },
-            context: context || 'No additional context provided',
-            axeResults: {
-              violations: ((_axeResults$violation2 = axeResults.violations) === null || _axeResults$violation2 === void 0 ? void 0 : _axeResults$violation2.length) || 0,
-              passes: ((_axeResults$passes2 = axeResults.passes) === null || _axeResults$passes2 === void 0 ? void 0 : _axeResults$passes2.length) || 0,
-              incomplete: ((_axeResults$incomplet2 = axeResults.incomplete) === null || _axeResults$incomplet2 === void 0 ? void 0 : _axeResults$incomplet2.length) || 0
-            }
-          };
-          _context2.next = 37;
-          return browser.close();
-        case 37:
-          return _context2.abrupt("return", {
-            content: [{
-              type: 'text',
-              text: JSON.stringify({
-                summary: summary,
-                violations: violations,
-                suggestions: suggestions,
-                relevantGuidelines: relevantGuidelines,
-                axeResults: axeResults,
-                recommendations: ['Use ADS components for better accessibility out of the box', 'Reference https://atlassian.design/llms-a11y.txt for detailed guidelines', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
-              }, null, 2)
-            }]
-          });
-        case 40:
-          _context2.prev = 40;
-          _context2.t0 = _context2["catch"](10);
-          _context2.next = 44;
-          return browser.close();
-        case 44:
-          return _context2.abrupt("return", {
-            content: [{
-              type: 'text',
-              text: JSON.stringify({
-                summary: {
-                  url: url,
-                  selector: selector || 'Entire page analyzed',
-                  componentName: componentName || 'Unknown component',
-                  totalViolations: violations.length,
-                  severityBreakdown: {
-                    error: violations.filter(function (v) {
-                      return v.severity === 'error';
-                    }).length,
-                    warning: violations.filter(function (v) {
-                      return v.severity === 'warning';
-                    }).length
-                  },
-                  context: context || 'No additional context provided',
-                  note: 'Analysis failed to run on the provided URL'
-                },
-                violations: violations,
-                suggestions: [],
-                error: String(_context2.t0),
-                recommendations: ['Use ADS components for better accessibility out of the box', 'Reference https://atlassian.design/llms-a11y.txt for detailed guidelines', 'Test with keyboard navigation and screen readers', 'Use automated accessibility testing tools']
-              }, null, 2)
-            }]
-          });
-        case 45:
-        case "end":
-          return _context2.stop();
-      }
-    }, _callee2, null, [[10, 40]]);
-  }));
-  return function analyzeLocalhostA11yTool(_x2) {
-    return _ref2.apply(this, arguments);
-  };
-}();