@browserstack/mcp-server 1.2.3 → 1.2.4

package/dist/tools/sdk-utils/percy-bstack/handler.js

@@ -0,0 +1,99 @@
+import { getBrowserStackAuth } from "../../../lib/get-auth.js";
+import { getSDKPrefixCommand } from "../bstack/commands.js";
+import { generateBrowserStackYMLInstructions } from "../bstack/configUtils.js";
+import { getInstructionsForProjectConfiguration } from "../common/instructionUtils.js";
+import { formatPercyInstructions, getPercyInstructions, } from "./instructions.js";
+export function runPercyWithBrowserstackSDK(input, config) {
+    const steps = [];
+    const authString = getBrowserStackAuth(config);
+    const [username, accessKey] = authString.split(":");
+    // Check if Percy is supported for this configuration
+    const percyResult = getPercyInstructions(input.detectedLanguage, input.detectedBrowserAutomationFramework, input.detectedTestingFramework);
+    if (!percyResult) {
+        // Percy not supported for this configuration
+        return {
+            steps: [
+                {
+                    type: "error",
+                    title: "Percy Not Supported",
+                    content: `Percy is not supported for this ${input.detectedBrowserAutomationFramework} framework configuration. Please use BrowserStack SDK only mode or try a different framework combination.`,
+                    isError: true,
+                },
+            ],
+            requiresPercy: true,
+            shouldSkipFormatting: true,
+            missingDependencies: [],
+        };
+    }
+    // Handle frameworks with unique setup instructions that don't use browserstack.yml
+    if (input.detectedBrowserAutomationFramework === "cypress" ||
+        input.detectedTestingFramework === "webdriverio") {
+        const frameworkInstructions = getInstructionsForProjectConfiguration(input.detectedBrowserAutomationFramework, input.detectedTestingFramework, input.detectedLanguage, username, accessKey);
+        if (frameworkInstructions && frameworkInstructions.setup) {
+            steps.push({
+                type: "instruction",
+                title: "Framework-Specific Setup",
+                content: frameworkInstructions.setup,
+            });
+        }
+        steps.push({
+            type: "instruction",
+            title: "Percy Setup (BrowserStack SDK + Percy)",
+            content: formatPercyInstructions(percyResult),
+        });
+        if (frameworkInstructions && frameworkInstructions.run) {
+            steps.push({
+                type: "instruction",
+                title: "Run the tests",
+                content: frameworkInstructions.run,
+            });
+        }
+        return {
+            steps,
+            requiresPercy: true,
+            missingDependencies: [],
+        };
+    }
+    // Default flow using browserstack.yml with Percy
+    const sdkSetupCommand = getSDKPrefixCommand(input.detectedLanguage, input.detectedTestingFramework, username, accessKey);
+    if (sdkSetupCommand) {
+        steps.push({
+            type: "instruction",
+            title: "Install BrowserStack SDK",
+            content: sdkSetupCommand,
+        });
+    }
+    const ymlInstructions = generateBrowserStackYMLInstructions(input.desiredPlatforms, true, input.projectName);
+    if (ymlInstructions) {
+        steps.push({
+            type: "instruction",
+            title: "Configure browserstack.yml",
+            content: ymlInstructions,
+        });
+    }
+    const frameworkInstructions = getInstructionsForProjectConfiguration(input.detectedBrowserAutomationFramework, input.detectedTestingFramework, input.detectedLanguage, username, accessKey);
+    if (frameworkInstructions && frameworkInstructions.setup) {
+        steps.push({
+            type: "instruction",
+            title: "Framework-Specific Setup",
+            content: frameworkInstructions.setup,
+        });
+    }
+    steps.push({
+        type: "instruction",
+        title: "Percy Setup (BrowserStack SDK + Percy)",
+        content: formatPercyInstructions(percyResult),
+    });
+    if (frameworkInstructions && frameworkInstructions.run) {
+        steps.push({
+            type: "instruction",
+            title: "Run the tests",
+            content: frameworkInstructions.run,
+        });
+    }
+    return {
+        steps,
+        requiresPercy: true,
+        missingDependencies: [],
+    };
+}

package/dist/tools/sdk-utils/percy-bstack/index.d.ts

@@ -0,0 +1,4 @@
+export { runPercyWithBrowserstackSDK } from "./handler.js";
+export { getPercyInstructions, formatPercyInstructions, } from "./instructions.js";
+export { PERCY_INSTRUCTIONS } from "./frameworks.js";
+export type { ConfigMapping } from "./types.js";

package/dist/tools/sdk-utils/percy-bstack/index.js

@@ -0,0 +1,4 @@
+// Percy + BrowserStack SDK utilities
+export { runPercyWithBrowserstackSDK } from "./handler.js";
+export { getPercyInstructions, formatPercyInstructions, } from "./instructions.js";
+export { PERCY_INSTRUCTIONS } from "./frameworks.js";

package/dist/tools/sdk-utils/percy-bstack/instructions.d.ts

@@ -0,0 +1,7 @@
+import { SDKSupportedBrowserAutomationFramework, SDKSupportedLanguage, SDKSupportedTestingFramework } from "../common/types.js";
+export declare function getPercyInstructions(language: SDKSupportedLanguage, automationFramework: SDKSupportedBrowserAutomationFramework, testingFramework: SDKSupportedTestingFramework): {
+    instructions: string;
+} | null;
+export declare function formatPercyInstructions(instructions: {
+    instructions: string;
+}): string;

package/dist/tools/sdk-utils/{percy → percy-bstack}/instructions.js

@@ -1,7 +1,5 @@
-import { PERCY_INSTRUCTIONS } from "./constants.js";
-/**
- * Retrieves Percy-specific instructions for a given language and framework.
- */
+import { PERCY_INSTRUCTIONS } from "./frameworks.js";
+// Retrieves Percy-specific instructions for a given language and framework
 export function getPercyInstructions(language, automationFramework, testingFramework) {
     const langConfig = PERCY_INSTRUCTIONS[language];
     if (!langConfig) {
@@ -17,12 +15,10 @@ export function getPercyInstructions(language, automationFramework, testingFrame
     }
     return percyInstructions;
 }
-/**
- * Formats the retrieved Percy instructions into a user-friendly string.
- */
+// Formats the retrieved Percy instructions into a user-friendly string
 export function formatPercyInstructions(instructions) {
-    return `\n\n## Percy Visual Testing Setup
+    return `---STEP--- Percy Visual Testing Setup
 To enable visual testing with Percy, you need to make the following changes to your project configuration and test scripts.
-${instructions.script_updates}
+${instructions.instructions}
 `;
 }

package/dist/tools/sdk-utils/percy-bstack/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type for Percy + BrowserStack SDK configuration mapping.
+ * Structure: language -> automationFramework -> testingFramework -> { instructions: (bsdkToken: string) => string }
+ */
+export type ConfigMapping = {
+    [language: string]: {
+        [automationFramework: string]: {
+            [testingFramework: string]: {
+                instructions: string;
+            };
+        };
+    };
+};

package/dist/tools/sdk-utils/percy-bstack/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type for Percy + BrowserStack SDK configuration mapping.
+ * Structure: language -> automationFramework -> testingFramework -> { instructions: (bsdkToken: string) => string }
+ */
+export {};

package/dist/tools/sdk-utils/percy-web/constants.d.ts

@@ -0,0 +1,41 @@
+export declare const percyReviewSnapshotsStep = "\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n";
+export declare const pythonInstructionsSnapshot = "\nExample:\n```python\n- Import the Percy snapshot helper:\nfrom selenium import webdriver\nfrom percy import percy_snapshot\n\ndriver = webdriver.Chrome()\ndriver.get('http://localhost:8000')\npercy_snapshot(driver, 'Home page')\n# ... more test steps ...\npercy_snapshot(driver, 'After login')\n```\n";
+export declare const nodejsInstructionsSnapshot = "\n- Import the Percy snapshot helper:\n    const { percySnapshot } = require('@percy/selenium-js');\n  - In your test, take snapshots like this:\n    await percySnapshot(driver, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { Builder } = require('selenium-webdriver');\nconst percySnapshot = require('@percy/selenium-webdriver');\n\nconst driver = await new Builder().forBrowser('chrome').build();\nawait driver.get('http://localhost:8000');\nawait percySnapshot(driver, 'Home page');\n```\n";
+export declare const javaInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    import io.percy.selenium.Percy;\n  - In your test, take snapshots like this:\n    Percy percy = new Percy(driver);\n    percy.snapshot(\"Your snapshot name\");\n  Example:\n```java\nimport org.openqa.selenium.WebDriver;\nimport org.openqa.selenium.chrome.ChromeDriver;\nimport io.percy.selenium.Percy;\n\npublic class PercyExample {\n  public static void main(String[] args) {\n    WebDriver driver = new ChromeDriver();\n    driver.get(\"http://localhost:8000\");\n    Percy percy = new Percy(driver);\n    percy.snapshot(\"Home page\");\n    driver.quit();\n  }\n}\n```";
+export declare const rubyInstructionsSnapshot = "\n  - Require the Percy snapshot helper:\n    require 'percy'\n  - In your test, take snapshots like this:\n    Percy.snapshot(page, 'Your snapshot name')\n\nExample:\n```ruby\nrequire 'selenium-webdriver'\nrequire 'percy'\n\ndriver = Selenium::WebDriver.for :chrome\ndriver.get('http://localhost:8000')\nPercy.snapshot(driver, 'Your snapshot name')\ndriver.quit\n```\n";
+export declare const rubyCapybaraInstructionsSnapshot = "\n  - In your test setup file, require percy/capybara:\n    require 'percy/capybara'\n  - In your test, take snapshots like this:\n    page.percy_snapshot('Capybara snapshot')\n\nExample:\n```ruby\nrequire 'percy/capybara'\n\ndescribe 'my feature', type: :feature do\n  it 'renders the page' do\n    visit 'https://example.com'\n    page.percy_snapshot('Capybara snapshot')\n  end\nend\n```\n\n  - The snapshot method arguments are:\n    page.percy_snapshot(name[, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n";
+export declare const csharpInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    using PercyIO.Selenium;\n  - In your test, take snapshots like this:\n    Percy.Snapshot(driver,\"Your snapshot name\");\n\nExample:\n```csharp\nusing OpenQA.Selenium;\nusing OpenQA.Selenium.Chrome;\nusing PercyIO.Selenium;\n\nclass PercyExample\n{\n    static void Main()\n    {\n        IWebDriver driver = new ChromeDriver();\n        driver.Navigate().GoToUrl(\"http://localhost:8000\");\n        Percy.Snapshot(driver,\"Empty Todo State\");\n        driver.Quit();\n    }\n}\n```\n";
+export declare const javaPlaywrightInstructionsSnapshot = "\n  - Import the Percy library and use the snapshot method:\n    percy.snapshot(\"snapshot_1\");\n  - You can also pass options:\n    Map<String, Object> options = new HashMap<>();\n    options.put(\"testCase\", \"Should add product to cart\");\n    percy.snapshot(\"snapshot_2\", options);\n\nExample:\n```java\nimport com.microsoft.playwright.*;\nimport io.percy.playwright.*;\n\npublic class PercyPlaywrightExample {\n  public static void main(String[] args) {\n    try (Playwright playwright = Playwright.create()) {\n      Browser browser = playwright.chromium().launch();\n      Page page = browser.newPage();\n      Percy percy = new Percy(page);\n\n      page.navigate(\"http://localhost:8000\");\n      percy.snapshot(\"Home page\");\n\n      // ... more test steps ...\n      percy.snapshot(\"After login\");\n\n      browser.close();\n    }\n  }\n}\n```\n";
+export declare const nodejsPlaywrightInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/playwright');\n  - In your test, take snapshots like this:\n    await percySnapshot(page, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { chromium } = require('playwright');\nconst percySnapshot = require('@percy/playwright');\n\n(async () => {\n  const browser = await chromium.launch();\n  const page = await browser.newPage();\n  await page.goto('http://example.com/', { waitUntil: 'networkidle' });\n  await percySnapshot(page, 'Example Site');\n  await browser.close();\n})();\n```\n";
+export declare const nodejsWebdriverioInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/selenium-webdriver');\n  - In your test, take snapshots like this:\n    await percySnapshot(driver, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { remote } = require('webdriverio');\nconst percySnapshot = require('@percy/selenium-webdriver');\n\n(async () => {\n  const browser = await remote({\n    logLevel: 'error',\n    capabilities: { browserName: 'chrome' }\n  });\n\n  await browser.url('https://example.com');\n  await percySnapshot(browser, 'WebdriverIO example');\n  await browser.deleteSession();\n})();\n```\n";
+export declare const nodejsEmberInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/ember';\n  - In your test, take snapshots like this:\n    await percySnapshot('My Snapshot');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/ember';\ndescribe('My ppp', () => {\n  // ...app setup\n  it('about page should look good', async () => {\n    await visit('/about');\n    await percySnapshot('My Snapshot');\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n";
+export declare const nodejsCypressInstructionsSnapshot = "\n  - Import the Percy snapshot helper in your cypress/support/e2e.js file:\n    import '@percy/cypress';\n  - If you\u2019re using TypeScript, include \"types\": [\"cypress\", \"@percy/cypress\"] in your tsconfig.json file.\n  - In your test, take snapshots like this:\n    cy.percySnapshot();\n\nExample:\n```javascript\nimport '@percy/cypress';\n\ndescribe('Integration test with visual testing', function() {\n  it('Loads the homepage', function() {\n    // Load the page or perform any other interactions with the app.\n    cy.visit('<URL under test>');\n    // Take a snapshot for visual diffing\n    cy.percySnapshot();\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    cy.percySnapshot([name][, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n  - For example:\n    cy.percySnapshot();\n    cy.percySnapshot('Homepage test');\n    cy.percySnapshot('Homepage responsive test', { widths: [768, 992, 1200] });\n";
+export declare const nodejsPuppeteerInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/puppeteer');\n  - In your test, take snapshots like this:\n    await percySnapshot(page, 'Snapshot name');\n\nExample:\n```javascript\nconst puppeteer = require('puppeteer');\nconst percySnapshot = require('@percy/puppeteer');\n\ndescribe('Integration test with visual testing', function() {\n  it('Loads the homepage', async function() {\n    const browser = await puppeteer.launch();\n    const page = await browser.newPage();\n    await page.goto('https://example.com');\n    await percySnapshot(page, this.test.fullTitle());\n    await browser.close();\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(page, name[, options])\n    page (required) - A puppeteer page instance\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n  - For example:\n    percySnapshot(page, 'Homepage test');\n    percySnapshot(page, 'Homepage responsive test', { widths: [768, 992, 1200] });\n";
+export declare const nodejsNightmareInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    const Nightmare = require('nightmare');\n    const percySnapshot = require('@percy/nightmare');\n  - In your test, take snapshots like this:\n    .use(percySnapshot('Snapshot name'))\n\nExample:\n```javascript\nconst Nightmare = require('nightmare');\nconst percySnapshot = require('@percy/nightmare');\n\nNightmare()\n  .goto('http://example.com')\n  // ... other actions ...\n  .use(percySnapshot('Example Snapshot'))\n  // ... more actions ...\n  .end()\n  .then(() => {\n    // ...\n  });\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n";
+export declare const nodejsNightwatchInstructionsSnapshot = "\n  - Import the Percy library and add the path exported by @percy/nightwatch to your Nightwatch configuration\u2019s custom_commands_path property:\n    const percy = require('@percy/nightwatch');\n    module.exports = {\n      // ...\n      custom_commands_path: [percy.path],\n      // ...\n    };\n  - In your test, take snapshots like this:\n    browser.percySnapshot('Snapshot name');\n\nExample:\n```javascript\nconst percy = require('@percy/nightwatch');\nmodule.exports = {\n  // ...\n  custom_commands_path: [percy.path],\n  // ...\n};\n\n// Example test\nmodule.exports = {\n  'Snapshots pages': function(browser) {\n    browser\n      .url('http://example.com')\n      .assert.containsText('h1', 'Example Domain')\n      .percySnapshot('Example snapshot');\n    browser\n      .url('http://google.com')\n      .assert.elementPresent('img[alt=\"Google\"]')\n      .percySnapshot('Google homepage');\n    browser.end();\n  }\n};\n```\n\n  - The snapshot method arguments are:\n    percySnapshot([name][, options])\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n";
+export declare const nodejsProtractorInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/protractor';\n  - In your test, take snapshots like this:\n    await percySnapshot('Snapshot name');\n    // or\n    await percySnapshot(browser, 'Snapshot name');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/protractor';\ndescribe('angularjs homepage', function() {\n  it('should greet the named user', async function() {\n    await browser.get('https://www.angularjs.org');\n    await percySnapshot('AngularJS homepage');\n    await element(by.model('yourName')).sendKeys('Percy');\n    var greeting = element(by.binding('yourName'));\n    expect(await greeting.getText()).toEqual('Hello Percy!');\n    await percySnapshot('AngularJS homepage greeting');\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    Standalone mode:\n    percySnapshot(browser, name[, options])\n    browser (required) - The Protractor browser object\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n";
+export declare const nodejsTestcafeInstructionsSnapshot = "\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/testcafe';\n  - In your test, take snapshots like this:\n    await percySnapshot(t, 'Snapshot name');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/testcafe';\nfixture('MyFixture')\n  .page('https://devexpress.github.io/testcafe/example');\ntest('Test1', async t => {\n  await t.typeText('#developer-name', 'John Doe');\n  await percySnapshot(t, 'TestCafe Example');\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(t, name[, options])\n    t (required) - The test controller instance passed from test\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n";
+export declare const nodejsGatsbyInstructionsSnapshot = "\n  - Add the Percy plugin to your gatsby-config.js file:\n    module.exports = {\n      plugins: [`gatsby-plugin-percy`]\n    }\n\n  - The plugin will take snapshots of discovered pages during the build process.\n\n  - Example gatsby-config.js with options:\n```javascript\nmodule.exports = {\n  plugins: [{\n    resolve: `gatsby-plugin-percy`,\n    options: {\n      // gatsby specific options\n      query: `{\n        allSitePage { nodes { path } }\n        allOtherPage { nodes { path } }\n      }`,\n      resolvePages: ({\n        allSitePage: { nodes: allPages },\n        allOtherPage: { nodes: otherPages }\n      }) => {\n        return [...allPages, ...otherPages]\n          .map(({ path }) => path);\n      },\n      // percy static snapshot options\n      exclude: [\n        '/dev-404-page/',\n        '/offline-plugin-app-shell-fallback/'\n      ],\n      overrides: [{\n        include: '/foobar/',\n        waitForSelector: '.done-loading',\n        additionalSnapshots: [{\n          suffix: ' - after btn click',\n          execute: () => document.querySelector('.btn').click()\n        }]\n      }]\n    }\n  }]\n}\n```\n";
+export declare const nodejsStorybookInstructionsSnapshot = "\n  - Add Percy parameters to your stories to customize snapshots:\n```js\nMyStory.parameters = {\n  percy: {\n    name: 'My snapshot',\n    additionalSnapshots: [\n      { prefix: '[Dark mode] ', args: { colorScheme: 'dark' } },\n      { suffix: ' with globals', globals: { textDirection: 'rtl' } },\n      { name: 'Search snapshot', queryParams: { search: 'foobar' } }\n    ]\n  }\n};\n```\n  - Use argument names and values defined in your codebase.\n";
+export declare const pythonPlaywrightInstructionsSnapshot = "\n  - Import the Percy snapshot helper and use the snapshot method:\n    percy_snapshot(page, name=\"Your snapshot name\")\n  - You can also use:\n    percy_screenshot(page, name=\"Your snapshot name\", options={})\n\nExample:\n```python\nfrom playwright.sync_api import sync_playwright\nfrom percy import percy_snapshot\n\nwith sync_playwright() as p:\n    browser = p.chromium.launch()\n    page = browser.new_page()\n    page.goto(\"http://localhost:8000\")\n    percy_snapshot(page, name=\"Home page\")\n\n    # ... more test steps ...\n    percy_snapshot(page, name=\"After login\")\n\n    browser.close()\n```\n";
+export declare const csharpPlaywrightInstructionsSnapshot = "\n  - Import the Percy snapshot helper and use the snapshot method:\n    Percy.Snapshot(page, \"Your snapshot name\");\n  - You can also pass options:\n    Percy.Snapshot(page, \"Your snapshot name\", options);\n\nExample:\n```csharp\nusing Microsoft.Playwright;\nusing PercyIO.Playwright;\n\nclass PercyPlaywrightExample\n{\n    public static async Task Main()\n    {\n        using var playwright = await Playwright.CreateAsync();\n        var browser = await playwright.Chromium.LaunchAsync();\n        var page = await browser.NewPageAsync();\n\n        await page.GotoAsync(\"http://localhost:8000\");\n        Percy.Snapshot(page, \"Home page\");\n\n        // ... more test steps ...\n        Percy.Snapshot(page, \"After login\");\n\n        await browser.CloseAsync();\n    }\n}\n```\n";
+export declare const pythonInstructions = "\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Selenium Python package:\n    pip install percy-selenium\nIf faced any issue create a virtual environment and proceed.\nUpdate your Python Selenium script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\nExample:\n```python\n- Import the Percy snapshot helper:\nfrom selenium import webdriver\nfrom percy import percy_snapshot\n\ndriver = webdriver.Chrome()\ndriver.get('http://localhost:8000')\npercy_snapshot(driver, 'Home page')\n# ... more test steps ...\npercy_snapshot(driver, 'After login')\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- python tests.py').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy SDK for Node.js:\n    npm install @percy/selenium-webdriver\n---STEP---\nUpdate your Node.js Selenium script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n- Import the Percy snapshot helper:\n    const { percySnapshot } = require('@percy/selenium-js');\n  - In your test, take snapshots like this:\n    await percySnapshot(driver, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { Builder } = require('selenium-webdriver');\nconst percySnapshot = require('@percy/selenium-webdriver');\n\nconst driver = await new Builder().forBrowser('chrome').build();\nawait driver.get('http://localhost:8000');\nawait percySnapshot(driver, 'Home page');\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- node script.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const javaInstructions = "\n---STEP---\nAdd Percy dependencies to your project\n  - For Maven, add to your pom.xml:\n    <dependency>\n      <groupId>io.percy</groupId>\n      <artifactId>percy-java-selenium</artifactId>\n      <version>1.0.0</version>\n    </dependency>\n  - For Gradle, add to your build.gradle:\n    implementation 'io.percy:percy-java-selenium:1.0.0'\n  - For CLI usage, install Percy CLI:\n    npm install --save-dev @percy/cli\n\n---STEP---\nUpdate your Java Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import io.percy.selenium.Percy;\n  - In your test, take snapshots like this:\n    Percy percy = new Percy(driver);\n    percy.snapshot(\"Your snapshot name\");\n  Example:\n```java\nimport org.openqa.selenium.WebDriver;\nimport org.openqa.selenium.chrome.ChromeDriver;\nimport io.percy.selenium.Percy;\n\npublic class PercyExample {\n  public static void main(String[] args) {\n    WebDriver driver = new ChromeDriver();\n    driver.get(\"http://localhost:8000\");\n    Percy percy = new Percy(driver);\n    percy.snapshot(\"Home page\");\n    driver.quit();\n  }\n}\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- mvn test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const rubyInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Ruby Selenium gem:\n    gem install percy-selenium\n\n---STEP---\nUpdate your Ruby Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Require the Percy snapshot helper:\n    require 'percy'\n  - In your test, take snapshots like this:\n    Percy.snapshot(page, 'Your snapshot name')\n\nExample:\n```ruby\nrequire 'selenium-webdriver'\nrequire 'percy'\n\ndriver = Selenium::WebDriver.for :chrome\ndriver.get('http://localhost:8000')\nPercy.snapshot(driver, 'Your snapshot name')\ndriver.quit\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- bundle exec rspec').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const rubyCapybaraInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Capybara gem:\n    gem install percy-capybara\n\n---STEP---\nUpdate your Capybara or Rails test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - In your test setup file, require percy/capybara:\n    require 'percy/capybara'\n  - In your test, take snapshots like this:\n    page.percy_snapshot('Capybara snapshot')\n\nExample:\n```ruby\nrequire 'percy/capybara'\n\ndescribe 'my feature', type: :feature do\n  it 'renders the page' do\n    visit 'https://example.com'\n    page.percy_snapshot('Capybara snapshot')\n  end\nend\n```\n\n  - The snapshot method arguments are:\n    page.percy_snapshot(name[, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- bundle exec rspec').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const csharpInstructions = "\nInstall Percy CLI by running the following command:\nnpm install --save-dev @percy/cli\n\n---STEP---\nAdd Percy dependencies to your project\n  - Add the Percy .NET Selenium NuGet package:\n    dotnet add package PercyIO.Selenium\n\n---STEP---\nUpdate your C# Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    using PercyIO.Selenium;\n  - In your test, take snapshots like this:\n    Percy.Snapshot(driver,\"Your snapshot name\");\n\nExample:\n```csharp\nusing OpenQA.Selenium;\nusing OpenQA.Selenium.Chrome;\nusing PercyIO.Selenium;\n\nclass PercyExample\n{\n    static void Main()\n    {\n        IWebDriver driver = new ChromeDriver();\n        driver.Navigate().GoToUrl(\"http://localhost:8000\");\n        Percy.Snapshot(driver,\"Empty Todo State\");\n        driver.Quit();\n    }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- dotnet test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const javaPlaywrightInstructions = "\nInstall Percy dependencies\n  - For Maven, add to your pom.xml:\n    <dependency>\n      <groupId>io.percy</groupId>\n      <artifactId>percy-playwright-java</artifactId>\n      <version>1.0.0</version>\n    </dependency>\n\n---STEP---\nUpdate your Java Playwright test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy library and use the snapshot method:\n    percy.snapshot(\"snapshot_1\");\n  - You can also pass options:\n    Map<String, Object> options = new HashMap<>();\n    options.put(\"testCase\", \"Should add product to cart\");\n    percy.snapshot(\"snapshot_2\", options);\n\nExample:\n```java\nimport com.microsoft.playwright.*;\nimport io.percy.playwright.*;\n\npublic class PercyPlaywrightExample {\n  public static void main(String[] args) {\n    try (Playwright playwright = Playwright.create()) {\n      Browser browser = playwright.chromium().launch();\n      Page page = browser.newPage();\n      Percy percy = new Percy(page);\n\n      page.navigate(\"http://localhost:8000\");\n      percy.snapshot(\"Home page\");\n\n      // ... more test steps ...\n      percy.snapshot(\"After login\");\n\n      browser.close();\n    }\n  }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsPlaywrightInstructions = "\nInstall Percy dependencies\n  - Install Percy Playwright SDK:\n    npm install @percy/playwright\n\n---STEP---\nUpdate your Playwright JavaScript test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/playwright');\n  - In your test, take snapshots like this:\n    await percySnapshot(page, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { chromium } = require('playwright');\nconst percySnapshot = require('@percy/playwright');\n\n(async () => {\n  const browser = await chromium.launch();\n  const page = await browser.newPage();\n  await page.goto('http://example.com/', { waitUntil: 'networkidle' });\n  await percySnapshot(page, 'Example Site');\n  await browser.close();\n})();\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsWebdriverioInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Selenium Webdriver package:\n    npm install --save-dev @percy/selenium-webdriver\n\n---STEP---\nUpdate your WebdriverIO test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/selenium-webdriver');\n  - In your test, take snapshots like this:\n    await percySnapshot(driver, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { remote } = require('webdriverio');\nconst percySnapshot = require('@percy/selenium-webdriver');\n\n(async () => {\n  const browser = await remote({\n    logLevel: 'error',\n    capabilities: { browserName: 'chrome' }\n  });\n\n  await browser.url('https://example.com');\n  await percySnapshot(browser, 'WebdriverIO example');\n  await browser.deleteSession();\n})();\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- wdio run wdio.conf.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsEmberInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Ember SDK:\n    npm install --save-dev @percy/cli @percy/ember\n\n---STEP---\nUpdate your Ember test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/ember';\n  - In your test, take snapshots like this:\n    await percySnapshot('My Snapshot');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/ember';\ndescribe('My ppp', () => {\n  // ...app setup\n  it('about page should look good', async () => {\n    await visit('/about');\n    await percySnapshot('My Snapshot');\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- ember test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsCypressInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Cypress SDK:\n    npm install --save-dev @percy/cli @percy/cypress\n\n---STEP---\nUpdate your Cypress test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper in your cypress/support/e2e.js file:\n    import '@percy/cypress';\n  - If you\u2019re using TypeScript, include \"types\": [\"cypress\", \"@percy/cypress\"] in your tsconfig.json file.\n  - In your test, take snapshots like this:\n    cy.percySnapshot();\n\nExample:\n```javascript\nimport '@percy/cypress';\n\ndescribe('Integration test with visual testing', function() {\n  it('Loads the homepage', function() {\n    // Load the page or perform any other interactions with the app.\n    cy.visit('<URL under test>');\n    // Take a snapshot for visual diffing\n    cy.percySnapshot();\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    cy.percySnapshot([name][, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n  - For example:\n    cy.percySnapshot();\n    cy.percySnapshot('Homepage test');\n    cy.percySnapshot('Homepage responsive test', { widths: [768, 992, 1200] });\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- cypress run').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsPuppeteerInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Puppeteer SDK:\n    npm install --save-dev @percy/cli @percy/puppeteer\n\n---STEP---\nUpdate your Puppeteer test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/puppeteer');\n  - In your test, take snapshots like this:\n    await percySnapshot(page, 'Snapshot name');\n\nExample:\n```javascript\nconst puppeteer = require('puppeteer');\nconst percySnapshot = require('@percy/puppeteer');\n\ndescribe('Integration test with visual testing', function() {\n  it('Loads the homepage', async function() {\n    const browser = await puppeteer.launch();\n    const page = await browser.newPage();\n    await page.goto('https://example.com');\n    await percySnapshot(page, this.test.fullTitle());\n    await browser.close();\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(page, name[, options])\n    page (required) - A puppeteer page instance\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n  - For example:\n    percySnapshot(page, 'Homepage test');\n    percySnapshot(page, 'Homepage responsive test', { widths: [768, 992, 1200] });\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the test script file>').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsNightmareInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Nightmare SDK:\n    npm install --save-dev @percy/cli @percy/nightmare\n\n---STEP---\nUpdate your Nightmare test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const Nightmare = require('nightmare');\n    const percySnapshot = require('@percy/nightmare');\n  - In your test, take snapshots like this:\n    .use(percySnapshot('Snapshot name'))\n\nExample:\n```javascript\nconst Nightmare = require('nightmare');\nconst percySnapshot = require('@percy/nightmare');\n\nNightmare()\n  .goto('http://example.com')\n  // ... other actions ...\n  .use(percySnapshot('Example Snapshot'))\n  // ... more actions ...\n  .end()\n  .then(() => {\n    // ...\n  });\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- node script.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsNightwatchInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Nightwatch SDK:\n    npm install --save-dev @percy/cli @percy/nightwatch\n\n---STEP---\nUpdate your Nightwatch configuration and test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy library and add the path exported by @percy/nightwatch to your Nightwatch configuration\u2019s custom_commands_path property:\n    const percy = require('@percy/nightwatch');\n    module.exports = {\n      // ...\n      custom_commands_path: [percy.path],\n      // ...\n    };\n  - In your test, take snapshots like this:\n    browser.percySnapshot('Snapshot name');\n\nExample:\n```javascript\nconst percy = require('@percy/nightwatch');\nmodule.exports = {\n  // ...\n  custom_commands_path: [percy.path],\n  // ...\n};\n\n// Example test\nmodule.exports = {\n  'Snapshots pages': function(browser) {\n    browser\n      .url('http://example.com')\n      .assert.containsText('h1', 'Example Domain')\n      .percySnapshot('Example snapshot');\n    browser\n      .url('http://google.com')\n      .assert.elementPresent('img[alt=\"Google\"]')\n      .percySnapshot('Google homepage');\n    browser.end();\n  }\n};\n```\n\n  - The snapshot method arguments are:\n    percySnapshot([name][, options])\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- nightwatch').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsProtractorInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Protractor SDK:\n    npm install --save-dev @percy/cli @percy/protractor\n\n---STEP---\nUpdate your Protractor test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/protractor';\n  - In your test, take snapshots like this:\n    await percySnapshot('Snapshot name');\n    // or\n    await percySnapshot(browser, 'Snapshot name');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/protractor';\ndescribe('angularjs homepage', function() {\n  it('should greet the named user', async function() {\n    await browser.get('https://www.angularjs.org');\n    await percySnapshot('AngularJS homepage');\n    await element(by.model('yourName')).sendKeys('Percy');\n    var greeting = element(by.binding('yourName'));\n    expect(await greeting.getText()).toEqual('Hello Percy!');\n    await percySnapshot('AngularJS homepage greeting');\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    Standalone mode:\n    percySnapshot(browser, name[, options])\n    browser (required) - The Protractor browser object\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- protractor conf.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsTestcafeInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and TestCafe SDK:\n    npm install --save-dev @percy/cli @percy/testcafe\n\n---STEP---\nUpdate your TestCafe test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/testcafe';\n  - In your test, take snapshots like this:\n    await percySnapshot(t, 'Snapshot name');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/testcafe';\nfixture('MyFixture')\n  .page('https://devexpress.github.io/testcafe/example');\ntest('Test1', async t => {\n  await t.typeText('#developer-name', 'John Doe');\n  await percySnapshot(t, 'TestCafe Example');\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(t, name[, options])\n    t (required) - The test controller instance passed from test\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- testcafe chrome:headless tests').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsGatsbyInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Gatsby plugin:\n    npm install --save @percy/cli gatsby-plugin-percy\n\n---STEP---\nUpdate your Gatsby configuration\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Add the Percy plugin to your gatsby-config.js file:\n    module.exports = {\n      plugins: [`gatsby-plugin-percy`]\n    }\n\n  - The plugin will take snapshots of discovered pages during the build process.\n\n  - Example gatsby-config.js with options:\n```javascript\nmodule.exports = {\n  plugins: [{\n    resolve: `gatsby-plugin-percy`,\n    options: {\n      // gatsby specific options\n      query: `{\n        allSitePage { nodes { path } }\n        allOtherPage { nodes { path } }\n      }`,\n      resolvePages: ({\n        allSitePage: { nodes: allPages },\n        allOtherPage: { nodes: otherPages }\n      }) => {\n        return [...allPages, ...otherPages]\n          .map(({ path }) => path);\n      },\n      // percy static snapshot options\n      exclude: [\n        '/dev-404-page/',\n        '/offline-plugin-app-shell-fallback/'\n      ],\n      overrides: [{\n        include: '/foobar/',\n        waitForSelector: '.done-loading',\n        additionalSnapshots: [{\n          suffix: ' - after btn click',\n          execute: () => document.querySelector('.btn').click()\n        }]\n      }]\n    }\n  }]\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- gatsby build').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsStorybookInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Storybook SDK:\n    npm install --save-dev @percy/cli @percy/storybook\n\n---STEP---\nUpdate your Storybook stories\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Add Percy parameters to your stories to customize snapshots:\n```js\nMyStory.parameters = {\n  percy: {\n    name: 'My snapshot',\n    additionalSnapshots: [\n      { prefix: '[Dark mode] ', args: { colorScheme: 'dark' } },\n      { suffix: ' with globals', globals: { textDirection: 'rtl' } },\n      { name: 'Search snapshot', queryParams: { search: 'foobar' } }\n    ]\n  }\n};\n```\n  - Use argument names and values defined in your codebase.\n\n\n---STEP---\nRun Percy with your Storybook\n  - With a static Storybook build:\n    percy storybook ./storybook-build\n  - With a local or live Storybook URL:\n    percy storybook http://localhost:9009\n    percy storybook https://storybook.foobar.com\n  - Automatically run start-storybook:\n    Run this scan using tool runPercyScan with 'npx percy exec -- percy storybook:start --port=9009'.\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const pythonPlaywrightInstructions = "\n---STEP---\nCreate a Percy project\n  - Sign in to Percy and create a project of type \"Web\". Name the project and note the generated token.\n\n---STEP---\nSet the project token as an environment variable\n  - On macOS/Linux:\n    export PERCY_TOKEN=\"<your token here>\"\n  - On Windows PowerShell:\n    $env:PERCY_TOKEN=\"<your token here>\"\n  - On Windows CMD:\n    set PERCY_TOKEN=<your token here>\n\n---STEP---\nInstall Percy dependencies\n  - Install Percy Playwright SDK:\n    pip install percy-playwright\n\n---STEP---\nUpdate your Playwright Python test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper and use the snapshot method:\n    percy_snapshot(page, name=\"Your snapshot name\")\n  - You can also use:\n    percy_screenshot(page, name=\"Your snapshot name\", options={})\n\nExample:\n```python\nfrom playwright.sync_api import sync_playwright\nfrom percy import percy_snapshot\n\nwith sync_playwright() as p:\n    browser = p.chromium.launch()\n    page = browser.new_page()\n    page.goto(\"http://localhost:8000\")\n    percy_snapshot(page, name=\"Home page\")\n\n    # ... more test steps ...\n    percy_snapshot(page, name=\"After login\")\n\n    browser.close()\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const csharpPlaywrightInstructions = "\nInstall Percy dependencies\n  - Add the Percy Playwright NuGet package:\n    <PackageReference Include=\"PercyIO.Playwright\" Version=\"1.0.0\" />\n\n---STEP---\nUpdate your Playwright .NET test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper and use the snapshot method:\n    Percy.Snapshot(page, \"Your snapshot name\");\n  - You can also pass options:\n    Percy.Snapshot(page, \"Your snapshot name\", options);\n\nExample:\n```csharp\nusing Microsoft.Playwright;\nusing PercyIO.Playwright;\n\nclass PercyPlaywrightExample\n{\n    public static async Task Main()\n    {\n        using var playwright = await Playwright.CreateAsync();\n        var browser = await playwright.Chromium.LaunchAsync();\n        var page = await browser.NewPageAsync();\n\n        await page.GotoAsync(\"http://localhost:8000\");\n        Percy.Snapshot(page, \"Home page\");\n\n        // ... more test steps ...\n        Percy.Snapshot(page, \"After login\");\n\n        await browser.CloseAsync();\n    }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";