@cosmicdrift/kumiko-testing 0.310.0 → 0.312.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-testing",
-  "version": "0.310.0",
+  "version": "0.312.0",
   "description": "Test template for Kumiko apps: per-flow seedTenant, app test stack, canonical test preloads, bunfig generator and integration runner.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -63,9 +63,9 @@
     "kumiko-testing": "./bin/kumiko-testing.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.310.0",
-    "@cosmicdrift/kumiko-dev-server": "0.310.0",
-    "@cosmicdrift/kumiko-framework": "0.310.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.312.0",
+    "@cosmicdrift/kumiko-dev-server": "0.312.0",
+    "@cosmicdrift/kumiko-framework": "0.312.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {

package/src/changes.json

@@ -1,4 +1,11 @@
 [
+  {
+    "version": "0.311.0",
+    "type": "breaking",
+    "title": "defineAppE2eConfig's chromium project renders screenshot runs at deviceScaleFactor 2",
+    "detail": "With SCREENSHOT_DIR set, the chromium project renders at 2x so runMatrix and\ncaptureScreenshot images stay sharp on HiDPI displays (desktop files are\n3840×2160). Plain e2e runs stay at 1x. Device projects keep their own scale.",
+    "migration": "Drop app-level deviceScaleFactor overrides (test.use or project use).\nCommitted screenshots taken in the chromium project regenerate at 2x."
+  },
   {
     "version": "0.310.0",
     "type": "improvement",

package/src/e2e/constants.ts

@@ -48,3 +48,7 @@ export const SEED_ROUTES = {
 // Chrome" device ships 1280×720: handbook and doc shots at 1280 visibly soften
 // on a HiDPI display, and a list next to a reading pane looks cramped.
 export const DESKTOP_VIEWPORT = { width: 1920, height: 1080 } as const;
+
+// Screenshot runs (SCREENSHOT_DIR set) render at 2x so doc images stay sharp
+// on HiDPI displays; plain e2e runs keep 1x. Device projects keep their own.
+export const SCREENSHOT_DEVICE_SCALE_FACTOR = 2;

package/src/e2e/define-app-e2e-config.ts

@@ -15,11 +15,12 @@ import {
   isRealProviderRun,
   PLAYWRIGHT_DEMO_ENV,
   PROD_BUNDLES_ENV,
+  SCREENSHOT_DEVICE_SCALE_FACTOR,
   SEED_ENABLE_ENV,
   SEED_TOKEN_ENV,
   STYLESHEET_WATCH_ENV,
 } from "./constants";
-import { screenshotSpecsIgnore } from "./screenshot-dir";
+import { isScreenshotRun, screenshotSpecsIgnore } from "./screenshot-dir";
 import { E2E_TIMEOUT_MS } from "./timeouts";
 
 // Apps pick Meilisearch over their in-memory search adapter just because
@@ -170,7 +171,14 @@ export function defineAppE2eConfig(input: AppE2eConfigInput): PlaywrightTestConf
       navigationTimeout: E2E_TIMEOUT_MS.navigation,
     },
     projects: [
-      { name: "chromium", use: { ...devices["Desktop Chrome"], viewport: DESKTOP_VIEWPORT } },
+      {
+        name: "chromium",
+        use: {
+          ...devices["Desktop Chrome"],
+          viewport: DESKTOP_VIEWPORT,
+          deviceScaleFactor: isScreenshotRun() ? SCREENSHOT_DEVICE_SCALE_FACTOR : 1,
+        },
+      },
       ...projects,
     ],
     webServer: {

package/src/e2e/screenshot-dir.ts

@@ -8,7 +8,7 @@ const NORMAL_RUN_IGNORE: readonly string[] = [
 
 type Env = Readonly<Record<string, string | undefined>>;
 
-function isScreenshotRun(env: Env): boolean {
+export function isScreenshotRun(env: Env = process.env): boolean {
   const dir = env[SCREENSHOT_DIR_ENV];
   return dir !== undefined && dir !== "";
 }

package/src/scaffold.ts

@@ -36,6 +36,7 @@ const RULES_MARKDOWN = [
   "- Tests run in parallel by default. Timeouts, retries and workers live in the scripts, the bunfig files and `playwright.config.ts`; never raise them inside a test. The only exception carries a marker: `// @timeout-exception: #<issue> <reason>`.",
   "- Every flow seeds its own tenant: `seedTenant(stack)` in integration tests, the `seedTenant` fixture in e2e. No shared tenant, no widened seed helper.",
   "- Red or flaky? Diagnose the cause first (https://github.com/CosmicDriftGameStudio/kumiko-framework/blob/main/docs/guides/test-failures.md). A longer timeout, a retry or `serial` is not a fix.",
+  "- Why the setup looks this way, and the old-pattern → new-pattern table: https://github.com/CosmicDriftGameStudio/kumiko-framework/blob/main/docs/guides/testing-standard.md.",
   "- Run Playwright as `bunx --bun playwright`, as the scripts do.",
   `- Playwright configs and e2e files start with \`${TEST_RUNTIME_DIRECTIVE}\`; without it the runtime-isolation guard flags their import of the test package.`,
   "",