ember-testem 0.2.0 → 0.3.0

package/README.md

@@ -1,11 +1,11 @@
 # ember-testem
 
-_Forward- and backward-compatible testing for Ember projects_
+_Backward- and forward-compatible testing for Ember projects_
 
 
 ## Quickstart
 
-1\. Install `ember-testem` as a development dependency.
+1\. Install `ember-testem` as a development dependency. The package provides an executable named `ember-test`.
 
 ```sh
 pnpm add -D ember-testem
@@ -46,13 +46,17 @@ export default {
 +     "build:test": "...",
 -     "test": "ember test"
 +     "test": "pnpm build:test && ember-test"
++     "test:watch": "concurrently \"pnpm build:test --watch\" && \"pnpm ember-test --server\" --names build,test"
   },
   "devDependencies": {
+    "concurrently": "...",
 +     "ember-testem": "..."
   }
 }
 ```
 
+Note, `test:watch` can encounter race conditions. Once the test build is complete, refresh the test browser to see the latest results.
+
 <details>
 
 <summary>V1 addons</summary>
@@ -99,7 +103,7 @@ For brevity, additional file changes aren't shown below. For example, you will n
 {
   "scripts": {
     "build": "rollup --config",
-    "build:test": "NODE_ENV=development vite build --config \"vite.test.config.mts\" --mode development"
+    "build:test": "NODE_ENV=development vite build --config vite.test.config.mts --mode development"
   }
 }
 ```
@@ -125,6 +129,7 @@ export default defineConfig({
     babel({
       babelHelpers: 'inline',
       extensions,
+      parallel: true,
     }),
   ],
 });
@@ -142,24 +147,24 @@ See [my-v2-app](../../tests/my-v2-app) for an example.
 {
   "scripts": {
     "build": "vite build",
-    "build:test": "NODE_ENV=development vite build --config \"vite.test.config.mts\" --mode development"
+    "build:test": "NODE_ENV=development vite build --config vite.test.config.mts --mode development"
   }
 }
 ```
 
 ```ts
 /* vite.test.config.mts */
-import type { UserConfig } from 'vite';
+import { defineConfig } from 'vite';
 
 import baseConfiguration from './vite.config.mts';
 
-export default {
+export default defineConfig({
   ...baseConfiguration,
   build: {
     minify: false,
     sourcemap: true,
   },
-} satisfies UserConfig;
+});
 ```
 
 </details>
@@ -209,7 +214,7 @@ By default, `ember-testem` assumes `dist` to be the path to the test build.
 Pass `--path` to indicate otherwise. This may be useful if you want to create the production and test builds in different locations.
 
 ```sh
-ember-test --path "dist-for-testing"
+ember-test --path dist-for-testing
 ```
 
 </details>
@@ -220,10 +225,10 @@ ember-test --path "dist-for-testing"
 
 By default, `ember-testem` runs tests on port `7357`.
 
-Pass `--test-port` to pick a different port. You can pass `0` to pick any available port (useful for testing multiple projects in parallel).
+Pass `--port` (or `--test-port`, currently supported for backward compatibility) to pick a different port. You can pass `0` to pick any available port (useful for testing multiple projects in parallel).
 
 ```sh
-ember-test --test-port 0
+ember-test --port 0
 ```
 
 </details>

package/dist/bin/ember-test.js

@@ -18,11 +18,16 @@ const argv = yargs(hideBin(process.argv))
     type: 'string',
 })
     .option('path', {
+    default: 'dist',
     describe: 'Relative path to the test build',
     type: 'string',
+})
+    .option('port', {
+    describe: 'Port for running tests. Pass 0 to automatically pick an available port.',
+    type: 'number',
 })
     .option('root', {
-    describe: 'Where to run the codemod',
+    describe: 'Project root',
     type: 'string',
 })
     .option('server', {
@@ -34,15 +39,16 @@ const argv = yargs(hideBin(process.argv))
     describe: 'Port for running tests. Pass 0 to automatically pick an available port.',
     type: 'number',
 })
+    .deprecateOption('test-port', 'Use --port instead.')
     .parseSync();
 const codemodOptions = {
-    buildPath: argv['path'] ?? 'dist',
+    buildPath: argv['path'],
     filters: {
         filter: argv['filter'],
         module: argv['module'],
     },
+    port: argv['test-port'] ?? argv['port'],
     projectRoot: argv['root'] ?? process.cwd(),
     server: argv['server'],
-    testPort: argv['test-port'],
 };
 void run(codemodOptions);

package/dist/src/steps/create-options.js

@@ -1,10 +1,10 @@
 export function createOptions(codemodOptions) {
-    const { buildPath, filters, projectRoot, server, testPort } = codemodOptions;
+    const { buildPath, filters, port, projectRoot, server } = codemodOptions;
     return {
         buildPath,
         filters,
         launchBrowser: Boolean(server),
+        port,
         projectRoot,
-        testPort,
     };
 }

package/dist/src/steps/run-tests/run-tests-in-ci.js

@@ -2,11 +2,11 @@ import { join } from 'node:path';
 import Testem from 'testem';
 import { getQueryParams } from '../../utils/run-tests/get-query-params.js';
 export async function runTestsInCI(options) {
-    const { buildPath, filters, projectRoot, testPort } = options;
+    const { buildPath, filters, port, projectRoot } = options;
     const testemInstance = new Testem();
     const startOptions = {
         launch: false,
-        port: testPort,
+        port,
     };
     testemInstance.setDefaultOptions({
         ...startOptions,

package/dist/src/steps/run-tests/run-tests-in-dev.js

@@ -3,11 +3,11 @@ import { watch } from 'chokidar';
 import Testem from 'testem';
 import { getQueryParams } from '../../utils/run-tests/get-query-params.js';
 export async function runTestsInDev(options) {
-    const { buildPath, filters, projectRoot, testPort } = options;
+    const { buildPath, filters, port, projectRoot } = options;
     const testemInstance = new Testem();
     const startOptions = {
         launch: false,
-        port: testPort,
+        port,
     };
     testemInstance.setDefaultOptions({
         ...startOptions,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ember-testem",
-  "version": "0.2.0",
-  "description": "Forward- and backward-compatible testing for Ember projects",
+  "version": "0.3.0",
+  "description": "Backward- and forward-compatible testing for Ember projects",
   "keywords": [
     "ci",
     "ember",