♻️ Rename snapshot → screenshot for consistency

- Rename vizzlySnapshot → vizzlyScreenshot
- Rename snapshot-server → screenshot-server
- Rename /snapshot endpoint → /screenshot
- Rename __VIZZLY_SNAPSHOT_URL__ → __VIZZLY_SCREENSHOT_URL__
- Update all docs and comments

Author: Robdel12

clients/ember/CHANGELOG.md

@@ -13,17 +13,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial beta release of Vizzly Ember SDK for visual testing with Testem
 - Custom Testem launcher using Playwright for browser control (Chromium, Firefox, WebKit)
-- `vizzlySnapshot()` helper for capturing screenshots in acceptance tests
+- `vizzlyScreenshot()` helper for capturing screenshots in acceptance tests
 - Automatic viewport sizing and `#ember-testing` container expansion
 - TDD server auto-discovery via `.vizzly/server.json`
 - Mobile viewport testing with customizable dimensions
 - Support for both TDD mode (local comparison) and cloud mode
 
 ### Architecture
 
-The SDK uses a snapshot server pattern:
-- Browser tests call `vizzlySnapshot()` which sends requests to a local snapshot server
-- Snapshot server uses Playwright to capture screenshots
+The SDK uses a screenshot server pattern:
+- Browser tests call `vizzlyScreenshot()` which sends requests to a local screenshot server
+- Screenshot server uses Playwright to capture screenshots
 - Screenshots are forwarded to the Vizzly TDD server for comparison
 
 **Full Changelog**: https://github.com/vizzly-testing/cli/commits/ember/v0.0.1-beta.0

clients/ember/README.md

@@ -35,16 +35,16 @@ The `configure()` function replaces standard browser launchers (Chrome, Firefox,
 
 > **Note for Ember + Vite projects**: The `cwd: 'dist'` option is required because Vite builds test files into the `dist/` directory. Without this, Testem won't find your test assets.
 
-### 2. Write Tests with Snapshots
+### 2. Write Tests with Screenshots
 
-Import `vizzlySnapshot` in your test files:
+Import `vizzlyScreenshot` in your test files:
 
 ```javascript
 // tests/acceptance/dashboard-test.js
 import { module, test } from 'qunit';
 import { visit } from '@ember/test-helpers';
 import { setupApplicationTest } from 'ember-qunit';
-import { vizzlySnapshot } from '@vizzly-testing/ember/test-support';
+import { vizzlyScreenshot } from '@vizzly-testing/ember/test-support';
 
 module('Acceptance | Dashboard', function(hooks) {
   setupApplicationTest(hooks);
@@ -53,7 +53,7 @@ module('Acceptance | Dashboard', function(hooks) {
     await visit('/dashboard');
 
     // Capture screenshot
-    await vizzlySnapshot('dashboard-empty');
+    await vizzlyScreenshot('dashboard-empty');
 
     assert.dom('[data-test-empty-state]').exists();
   });
@@ -63,7 +63,7 @@ module('Acceptance | Dashboard', function(hooks) {
     await visit('/dashboard');
 
     // Capture specific element
-    await vizzlySnapshot('dashboard-table', {
+    await vizzlyScreenshot('dashboard-table', {
       selector: '[data-test-data-table]'
     });
 
@@ -142,29 +142,29 @@ The second argument accepts [Playwright browserType.launch() options](https://pl
 - `Firefox` → Uses Playwright Firefox
 - `Safari` / `WebKit` → Uses Playwright WebKit
 
-### `vizzlySnapshot(name, options?)`
+### `vizzlyScreenshot(name, options?)`
 
 Captures a screenshot and sends it to Vizzly for comparison. By default, captures just the `#ember-testing` container (your app), not the QUnit test runner UI.
 
 ```javascript
-import { vizzlySnapshot } from '@vizzly-testing/ember/test-support';
+import { vizzlyScreenshot } from '@vizzly-testing/ember/test-support';
 
 // Basic usage - captures app at 1280x720
-await vizzlySnapshot('homepage');
+await vizzlyScreenshot('homepage');
 
 // Mobile viewport
-await vizzlySnapshot('homepage-mobile', {
+await vizzlyScreenshot('homepage-mobile', {
   width: 375,
   height: 667
 });
 
 // Capture specific element within the app
-await vizzlySnapshot('login-form', {
+await vizzlyScreenshot('login-form', {
   selector: '[data-test-login-form]'
 });
 
 // Full options
-await vizzlySnapshot('screenshot-name', {
+await vizzlyScreenshot('screenshot-name', {
   // Viewport dimensions (default: 1280x720)
   width: 1280,
   height: 720,
@@ -198,7 +198,7 @@ await vizzlySnapshot('screenshot-name', {
 | `selector` | string | null | CSS selector to capture specific element |
 | `scope` | string | 'app' | What to capture: `'app'` (just #ember-testing), `'container'`, or `'page'` (full page including QUnit) |
 | `fullPage` | boolean | false | Capture full scrollable content |
-| `properties` | object | {} | Custom metadata attached to the snapshot |
+| `properties` | object | {} | Custom metadata attached to the screenshot |
 | `failOnDiff` | boolean | null | Fail the test when visual diff is detected. `null` uses the `--fail-on-diff` CLI flag. |
 
 The function automatically:
@@ -214,7 +214,7 @@ Check if Vizzly is available in the current test environment.
 import { isVizzlyAvailable } from '@vizzly-testing/ember/test-support';
 
 if (isVizzlyAvailable()) {
-  await vizzlySnapshot('conditional-snapshot');
+  await vizzlyScreenshot('conditional-screenshot');
 }
 ```
 
@@ -239,7 +239,7 @@ npx playwright install webkit
 1. **Testem Configuration**: The `configure()` wrapper replaces standard browser launchers with custom Vizzly launchers
 2. **Custom Launcher**: When Testem starts, it spawns `vizzly-testem-launcher` which uses Playwright
 3. **Playwright Integration**: The launcher uses Playwright to control the browser and capture screenshots
-4. **Snapshot Server**: A local HTTP server receives screenshot requests from test code
+4. **Screenshot Server**: A local HTTP server receives screenshot requests from test code
 5. **Vizzly Integration**: Screenshots are forwarded to the Vizzly TDD server for comparison
 
 ## CI/CD
@@ -268,15 +268,15 @@ By default, visual differences don't fail tests (similar to Percy). To fail test
 # Via CLI flag
 vizzly tdd start --fail-on-diff
 
-# Or per-snapshot in your test
-await vizzlySnapshot('critical-ui', { failOnDiff: true });
+# Or per-screenshot in your test
+await vizzlyScreenshot('critical-ui', { failOnDiff: true });
 ```
 
-The priority order is: per-snapshot option > `--fail-on-diff` CLI flag > default (no failure).
+The priority order is: per-screenshot option > `--fail-on-diff` CLI flag > default (no failure).
 
 ## Troubleshooting
 
-### "No snapshot server available"
+### "No screenshot server available"
 
 Tests must be run through Testem with the Vizzly-configured launchers. Ensure:
 - `testem.js` uses `configure()` wrapper

clients/ember/bin/vizzly-testem-launcher.js

@@ -23,9 +23,9 @@ import { closeBrowser, launchBrowser } from '../src/launcher/browser.js';
 import {
   getServerInfo,
   setPage,
-  startSnapshotServer,
-  stopSnapshotServer,
-} from '../src/launcher/snapshot-server.js';
+  startScreenshotServer,
+  stopScreenshotServer,
+} from '../src/launcher/screenshot-server.js';
 
 // Parse arguments - format: vizzly-testem-launcher <browser> <url>
 // Testem appends the URL as the last argument
@@ -56,7 +56,7 @@ if (existsSync(configPath)) {
 }
 
 let browserInstance = null;
-let snapshotServer = null;
+let screenshotServer = null;
 let isShuttingDown = false;
 
 /**
@@ -75,8 +75,8 @@ async function cleanup() {
   }
 
   try {
-    if (snapshotServer) {
-      await stopSnapshotServer(snapshotServer);
+    if (screenshotServer) {
+      await stopScreenshotServer(screenshotServer);
     }
   } catch {
     // Ignore cleanup errors
@@ -90,9 +90,9 @@ async function cleanup() {
  */
 async function main() {
   try {
-    // 1. Start snapshot server first (this also discovers the TDD server and caches its config)
-    snapshotServer = await startSnapshotServer();
-    let snapshotUrl = `http://127.0.0.1:${snapshotServer.port}`;
+    // 1. Start screenshot server first (this also discovers the TDD server and caches its config)
+    screenshotServer = await startScreenshotServer();
+    let screenshotUrl = `http://127.0.0.1:${screenshotServer.port}`;
 
     // 2. Determine failOnDiff: env var > server.json > default (false)
     let failOnDiff = false;
@@ -107,7 +107,7 @@ async function main() {
 
     // 3. Launch browser with Playwright
     browserInstance = await launchBrowser(browserType, testUrl, {
-      snapshotUrl,
+      screenshotUrl,
       failOnDiff,
       playwrightOptions,
       onPageCreated: page => {
@@ -165,8 +165,8 @@ async function main() {
   } catch (error) {
     console.error('[vizzly-testem-launcher] Failed to start:', error.message);
 
-    if (snapshotServer) {
-      await stopSnapshotServer(snapshotServer).catch(() => {});
+    if (screenshotServer) {
+      await stopScreenshotServer(screenshotServer).catch(() => {});
     }
 
     process.exit(1);

clients/ember/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizzly-testing/ember",
-  "version": "0.0.1-beta.3",
+  "version": "0.0.1-beta.4",
   "description": "Visual testing SDK for Ember.js projects using Testem",
   "keywords": [
     "vizzly",

clients/ember/src/index.js

@@ -18,11 +18,11 @@
  *
  * @example
  * // tests/acceptance/my-test.js
- * import { vizzlySnapshot } from '@vizzly-testing/ember/test-support';
+ * import { vizzlyScreenshot } from '@vizzly-testing/ember/test-support';
  *
  * test('renders correctly', async function(assert) {
  *   await visit('/');
- *   await vizzlySnapshot('homepage');
+ *   await vizzlyScreenshot('homepage');
  *   assert.ok(true);
  * });
  */

clients/ember/src/launcher/browser.js

@@ -2,7 +2,7 @@
  * Playwright browser lifecycle management
  *
  * Handles launching, configuring, and closing browsers via Playwright-core.
- * Injects the snapshot server URL into page context for test code access.
+ * Injects the screenshot server URL into page context for test code access.
  *
  * @module @vizzly-testing/ember/launcher/browser
  */
@@ -59,15 +59,15 @@ function getDefaultChromiumArgs() {
  * @param {string} browserType - Browser type: chromium, firefox, webkit
  * @param {string} testUrl - URL to navigate to (provided by Testem)
  * @param {Object} options - Launch options
- * @param {string} options.snapshotUrl - URL of the snapshot HTTP server
+ * @param {string} options.screenshotUrl - URL of the screenshot HTTP server
  * @param {boolean} [options.failOnDiff] - Whether tests should fail on visual diffs
  * @param {Object} [options.playwrightOptions] - Playwright launch options (headless, slowMo, timeout, etc.)
  * @param {Function} [options.onPageCreated] - Callback when page is created (before navigation)
  * @returns {Promise<Object>} Browser instance with page reference
  */
 export async function launchBrowser(browserType, testUrl, options = {}) {
   let {
-    snapshotUrl,
+    screenshotUrl,
     failOnDiff,
     playwrightOptions = {},
     onPageCreated,
@@ -106,11 +106,11 @@ export async function launchBrowser(browserType, testUrl, options = {}) {
 
   // Inject Vizzly config into page context BEFORE navigation
   await page.addInitScript(
-    ({ snapshotUrl, failOnDiff }) => {
-      window.__VIZZLY_SNAPSHOT_URL__ = snapshotUrl;
+    ({ screenshotUrl, failOnDiff }) => {
+      window.__VIZZLY_SCREENSHOT_URL__ = screenshotUrl;
       window.__VIZZLY_FAIL_ON_DIFF__ = failOnDiff;
     },
-    { snapshotUrl, failOnDiff }
+    { screenshotUrl, failOnDiff }
   );
 
   // Call onPageCreated callback BEFORE navigation

clients/ember/src/launcher/index.js

@@ -8,6 +8,6 @@ export { closeBrowser, launchBrowser } from './browser.js';
 export {
   getPage,
   setPage,
-  startSnapshotServer,
-  stopSnapshotServer,
-} from './snapshot-server.js';
+  startScreenshotServer,
+  stopScreenshotServer,
+} from './screenshot-server.js';

…ts/ember/src/launcher/snapshot-server.js …/ember/src/launcher/screenshot-server.jsclients/ember/src/launcher/snapshot-server.js renamed to clients/ember/src/launcher/screenshot-server.js clients/ember/src/launcher/snapshot-server.js renamed to clients/ember/src/launcher/screenshot-server.js

@@ -1,10 +1,10 @@
 /**
- * HTTP server for receiving snapshot requests from browser context
+ * HTTP server for receiving screenshot requests from browser context
  *
  * This server receives POST requests from test code running in the browser,
  * captures screenshots via Playwright, and forwards them to the Vizzly TDD server.
  *
- * @module @vizzly-testing/ember/launcher/snapshot-server
+ * @module @vizzly-testing/ember/launcher/screenshot-server
  */
 
 import { existsSync, readFileSync } from 'node:fs';
@@ -186,11 +186,11 @@ function httpPost(url, data) {
 }
 
 /**
- * Handle incoming snapshot request
+ * Handle incoming screenshot request
  * @param {Object} req - HTTP request
  * @param {Object} res - HTTP response
  */
-async function handleSnapshot(req, res) {
+async function handleScreenshot(req, res) {
   let body = '';
 
   req.on('data', chunk => {
@@ -253,10 +253,10 @@ async function handleSnapshot(req, res) {
 }
 
 /**
- * Start the snapshot HTTP server
+ * Start the screenshot HTTP server
  * @returns {Promise<Object>} Server info with port
  */
-export async function startSnapshotServer() {
+export async function startScreenshotServer() {
   return new Promise((resolve, reject) => {
     let server = createServer(async (req, res) => {
       // CORS headers for browser requests
@@ -272,8 +272,8 @@ export async function startSnapshotServer() {
         return;
       }
 
-      if (req.method === 'POST' && req.url === '/snapshot') {
-        await handleSnapshot(req, res);
+      if (req.method === 'POST' && req.url === '/screenshot') {
+        await handleScreenshot(req, res);
         return;
       }
 
@@ -298,11 +298,11 @@ export async function startSnapshotServer() {
 }
 
 /**
- * Stop the snapshot server
- * @param {Object} serverInfo - Server info returned by startSnapshotServer
+ * Stop the screenshot server
+ * @param {Object} serverInfo - Server info returned by startScreenshotServer
  * @returns {Promise<void>}
  */
-export async function stopSnapshotServer(serverInfo) {
+export async function stopScreenshotServer(serverInfo) {
   return new Promise(resolve => {
     if (serverInfo?.server) {
       // Force close all keep-alive connections (Node 18.2+)