@gfdelarue/testkit 0.6.1 → 0.6.3

package/bin/testkit.mjs

@@ -32,11 +32,13 @@ if (!hostNodeIsSupported(process.versions.node)) {
   const versionMismatch = versionDrift.checkCliVersionDrift(effectiveArgs, {
     binUrl: import.meta.url,
   });
-  if (
-    !versionDrift.emitCliVersionDriftAndExit(versionMismatch, {
-      json: versionDrift.isJsonMode(effectiveArgs),
-    })
-  ) {
+  const json = versionDrift.isJsonMode(effectiveArgs);
+  let handedOff = false;
+  if (versionMismatch) {
+    const { handOffToProductCli } = await import("../dist/cli/product-handoff.js");
+    handedOff = await handOffToProductCli(versionMismatch, process.argv.slice(2), { json });
+  }
+  if (!handedOff && !versionDrift.emitCliVersionDriftAndExit(versionMismatch, { json })) {
     const { executeCli } = await import("../dist/cli/index.js");
     await executeCli(
       effectiveArgs,

package/dist/app/product-handoff.js

@@ -0,0 +1 @@
+import o from"node:fs";import e from"node:path";import{isUnknownRecord as l}from"../kernel/unknown-values.js";import{runProductCli as u}from"../process/product-cli.js";export async function runInstalledProductCli(r,n,{onStart:i}){const t=s(r);return t===null?!1:(i(),await u(t,n),!0)}function s(r){let n;try{n=JSON.parse(o.readFileSync(e.join(r,"package.json"),"utf8"))}catch{return null}if(!l(n))return null;const i=l(n.bin)?n.bin.testkit:n.bin;if(typeof i!="string")return null;const t=e.resolve(r,i);return o.statSync(t,{throwIfNoEntry:!1})?.isFile()?t:null}

package/dist/cli/product-handoff.js

@@ -0,0 +1,2 @@
+import{runInstalledProductCli as i}from"../app/product-handoff.js";export async function handOffToProductCli(t,e,{json:n=!1}={}){const{packageRoot:r,version:o}=t.product;return r===null?!1:await i(r,e,{onStart:()=>{n||process.stderr.write(`Using the product's @gfdelarue/testkit ${String(o)} (${r}) instead of ${t.current.version}
+`)}})}

package/dist/engines/playwright/runtime/index.js

@@ -1 +1 @@
-export*from"@playwright/test";export{readPlaywrightContext}from"./runtime-input.js";export{defineTestkitConfig}from"./config.js";export{emulateCpu,emulateNetwork}from"./emulation.js";export{browserRequests}from"./browser-traffic.js";export{assertSafeUiTarget,assertSafeUiTargets,createAuthedApiClient,createSandboxId,createUiSandbox,resolveBackendBaseUrl,resolveFrontendBaseUrl,waitForAnimationFrames,waitForElementStable,waitForImagesLoaded,waitForNetworkIdle,waitForUiSettled}from"./sandbox.js";
+import{_android as e,_baseTest as r,_electron as t,chromium as o,defineConfig as a,devices as s,errors as i,expect as m,firefox as d,mergeExpects as n,mergeTests as f,request as l,selectors as x,test as p,webkit as c}from"@playwright/test";export{e as _android,r as _baseTest,t as _electron,o as chromium,a as defineConfig,s as devices,i as errors,m as expect,d as firefox,n as mergeExpects,f as mergeTests,l as request,x as selectors,p as test,c as webkit};export{readPlaywrightContext}from"./runtime-input.js";export{defineTestkitConfig}from"./config.js";export{emulateCpu,emulateNetwork}from"./emulation.js";export{browserRequests}from"./browser-traffic.js";export{assertSafeUiTarget,assertSafeUiTargets,createAuthedApiClient,createSandboxId,createUiSandbox,resolveBackendBaseUrl,resolveFrontendBaseUrl,waitForAnimationFrames,waitForElementStable,waitForImagesLoaded,waitForNetworkIdle,waitForUiSettled}from"./sandbox.js";

package/dist/process/execa-bundle.json

@@ -3,7 +3,7 @@
   "entrypoint": "dist/process/process.js",
   "sourceSha256": "e7301ca010796bb92d983c039db47f36e155c26ccfb42ff2d057d47addab3121",
   "bundleSha256": "db5da25a23e4577451c0c047360de70af8abbd63be686dd7b97d65486cbba3b8",
-  "packageLockSha256": "0b4351d48801de63d0a5ceb85a7eac01fc24259d3cc3537f18ee0cd5db5101be",
+  "packageLockSha256": "baeb7a46d3a7c0a092ff04f5a5d82115ff9ed748bb9563fdda2e154aa9ab19e3",
   "esbuildVersion": "0.28.1",
   "options": {
     "format": "esm",

package/dist/process/product-cli.js

@@ -0,0 +1 @@
+import{spawn as f}from"node:child_process";const i=process.platform==="win32"?["SIGINT","SIGBREAK"]:["SIGINT","SIGTERM","SIGHUP"];export async function runProductCli(c,n){const e=f(process.execPath,[...process.execArgv,c,...n],{stdio:"inherit"}),r=o=>{process.platform!=="win32"&&e.kill(o)};for(const o of i)process.on(o,r);let s;try{s=await new Promise((o,t)=>{e.once("error",t),e.once("exit",(l,p)=>{o({code:l,signal:p})})})}finally{for(const o of i)process.off(o,r)}s.signal?process.kill(process.pid,s.signal):process.exitCode=s.code??1}

package/dist/types/playwright.d.ts

@@ -1,4 +1,4 @@
-import { APIRequest, APIRequestContext, Page, PlaywrightTestConfig } from '@playwright/test';
+import { APIRequest, APIRequestContext, Page, PlaywrightTestConfig, _android, _baseTest, _electron, chromium, defineConfig, devices, errors, expect, firefox, mergeExpects, mergeTests, request, selectors, test, webkit } from '@playwright/test';
 
 export type JsonPrimitive = boolean | null | number | string;
 export type JsonValue = JsonPrimitive | readonly JsonValue[] | JsonObject;
@@ -139,13 +139,28 @@ export declare function waitForElementStable(page: UiStableElementPage, selector
 	timeout?: number;
 }): Promise<void>;
 export declare function waitForImagesLoaded(page: UiImagesPage, containerSelector?: string | null): Promise<void>;
-export * from "@playwright/test";
+export type * from "@playwright/test";
 
 export {
 	APIRequest,
 	APIRequestContext,
 	Page,
 	PlaywrightTestConfig,
+	_android,
+	_baseTest,
+	_electron,
+	chromium,
+	defineConfig,
+	devices,
+	errors,
+	expect,
+	firefox,
+	mergeExpects,
+	mergeTests,
+	request,
+	selectors,
+	test,
+	webkit,
 };
 
 export {};

package/docs/release-notes.md

@@ -1,3 +1,40 @@
+# 0.6.3
+
+## A global Testkit runs the product's own install
+
+When you start the CLI in a product that installs a different version of
+`@gfdelarue/testkit`, the CLI now runs the product's install with the same
+arguments. That covers a global install, a Homebrew, Scoop, AUR, or Chocolatey
+package, and `npx @gfdelarue/testkit@latest`. Before, the CLI stopped with
+`testkit_cli_version_mismatch` and printed the command to run the product's
+install instead.
+
+The CLI names the install it runs in one line on stderr, except in `--json`
+mode. The exit code comes from the product's install. On Linux and macOS, a
+stop signal sent to the CLI reaches the product's install, and the CLI ends
+with the signal that ended it. A product that declares a version of
+`@gfdelarue/testkit` but doesn't install one still gets
+`testkit_cli_version_mismatch`.
+
+# 0.6.2
+
+## Static imports from `@gfdelarue/testkit/playwright` work in a CommonJS product
+
+In a product whose `package.json` doesn't set `"type": "module"`, a `ui` test
+that imported a Testkit helper from `@gfdelarue/testkit/playwright` got
+`undefined`, and threw a `TypeError` when it called it
+([gfdelarue/testkit#505](https://github.com/gfdelarue/testkit/issues/505)).
+Every helper was affected, from `browserRequests` and `emulateNetwork` to
+`waitForUiSettled`. `test`, `expect`, and Playwright's other exports still
+worked. Static imports now get every helper, as they do in an ES module product.
+
+Playwright compiles such a test to CommonJS, so each static import becomes a
+`require()`. The entry re-exported Playwright with `export *`, which also passed
+on the `"module.exports"` export of Testkit's managed `@playwright/test`. Node's
+`require()` returns that export in place of the module, so it returned the
+managed `test`. The entry now names each of Playwright's runtime exports.
+`require("@playwright/test")` in a test still returns the managed `test`.
+
 # 0.6.1
 
 ## Each `ui` test's browser traffic is in the run evidence

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gfdelarue/testkit",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Test orchestration platform for product acceptance and QA workflows",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -96,9 +96,9 @@
   ],
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@gfdelarue/code-budget": "0.1.2",
     "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
     "@kitschpatrol/tokei": "2.0.2",
+    "@moontern-labs/code-budget": "0.1.3",
     "@types/picomatch": "4.0.3",
     "@types/yauzl": "3.4.0",
     "dts-bundle-generator": "9.5.1",