@ai-ecoverse/slicc-shared-web 1.11.0 → 1.12.1

package/README.md

@@ -20,7 +20,7 @@ Install it from npm, and pin the reusable workflow to the matching `vX.Y.Z` tag.
 npm install --save-dev --save-exact @ai-ecoverse/slicc-shared-web
 ```
 
-The hooks expect two scripts in each repo: `test:unit`, which writes `coverage/unit/lcov.info` (unit tests stay out of git), and, in TypeScript repos, `typecheck`. The reusable workflow expects `lint`, plus `test` for the integration tests, with a `pretest` that installs Chromium (`playwright-core install --no-shell chromium`). The diff-coverage hook runs `diff-cover` through `uvx`, so install [uv](https://docs.astral.sh/uv/) once.
+The hooks expect two scripts in each repo: `test:unit`, which writes `coverage/unit/lcov.info` (unit tests stay out of git), and, in TypeScript repos, `typecheck`. The reusable workflow expects `lint`, plus `test` for the integration tests, with a `pretest` that installs Chromium (`playwright-core install --no-shell chromium`). Its inputs `lint`, `test`, `chromium` and `node-version` override those, and `timeout-minutes` (20 by default) gives a long job, such as a background-tab measurement, more time. The diff-coverage hook runs `diff-cover` through `uvx`, so install [uv](https://docs.astral.sh/uv/) once.
 
 ## Rules every repo follows
 
@@ -67,6 +67,7 @@ test('boots', async (t) => {
 | `timeout` | How long `page.until` polls and `page.evaluate` waits, in ms | `30000` |
 | `stallAfter` | How long one evaluation may run before the harness probes the test's targets, in ms | `30000` |
 | `profile` | Record a CPU profile of every target, sampled every 100 µs | `true` if `SLICC_PROFILE=1`, else `false` |
+| `realistic` | Run Chrome as a user would: headed, and without `--disable-background-timer-throttling`, `--disable-backgrounding-occluded-windows` and `--disable-renderer-backgrounding`, so a tab behind another one is hidden and throttled. For measuring background tabs. It needs a display: on CI, run the tests under `xvfb-run -a` | `false` |
 
 `chrome.page(t)` opens a tab and returns the page API: `goto(path)`, `reload()`, `evaluate(fn, ...args)`, `until(fn, ...args)`, `press(key, ...modifiers)` (a key name like `Enter` or `F5`, or a single character typed with its US-layout key code), `type(text)`, `insert(text)`, `enter()`, `init(fn)` (runs in every new document), `expose(name, handler)` (a binding the page calls with a JSON string), `screenshot(file)`, `tab()` (another tab in the same context), `close()`, `send(method, params, ms)` (a raw CDP call in the tab's session), `errors`, `responses` and `dir` (the test's artifact directory). `chrome.pid` is the browser's process id and `chrome.profile` its `slicc-harness-*` profile directory in `$TMPDIR`. `goto` and `reload` wait until the new document is complete and no longer `about:blank`, and retry the navigation once if that never happens. `until` polls until the function returns a truthy value (not only strict `true`) and resolves with that value; the timeout error names the last result. `within(ms, fn, ...args)` is `until` with its own deadline, for a stage that should take a known time. Both stop at the deadline even if one evaluation never answers. Every CDP call has a deadline: `connect(url).send(method, params, sessionId, ms)` rejects with `<method>: no answer in <ms> ms` (60 s unless given), so a stuck page fails its test instead of hanging the run. A crash fails it at once instead:
 - when the browser dies, every pending and later call rejects with `<method>: browser exited with <signal>` (or `with code <n>`);

package/bin/slicc-lint-comments.sh

@@ -1,6 +1,6 @@
 #!/bin/sh
 set -eu
-sha=9cc7617c94c24b84c4d6fd8edf92441378257d07
+sha=e795cea178fb2e7accab9cfc7018d2aeb181db7a
 dir="node_modules/.cache/slicc-no-comment-$sha"
 if [ ! -f "$dir/check.mjs" ]; then
   mkdir -p "$dir"

package/harness/chrome.mjs

@@ -32,9 +32,20 @@ export const flags = [
   '--window-size=1280,800',
 ];
 
-export function commandLine(profile, extensions = [], extra = []) {
+export const unrealistic = [
+  '--headless',
+  '--disable-background-timer-throttling',
+  '--disable-backgrounding-occluded-windows',
+  '--disable-renderer-backgrounding',
+];
+
+export function commandLine(profile, extensions = [], extra = [], realistic = false) {
   const loaded = extensions.length > 0;
-  const base = loaded ? flags.filter((flag) => flag !== '--disable-extensions') : flags;
+  const dropped = new Set([
+    ...(loaded ? ['--disable-extensions'] : []),
+    ...(realistic ? unrealistic : []),
+  ]);
+  const base = flags.filter((flag) => !dropped.has(flag));
   const load = loaded ? ['--enable-unsafe-extension-debugging'] : [];
   return [...base, ...load, ...extra, `--user-data-dir=${profile}`, 'about:blank'];
 }
@@ -225,6 +236,7 @@ export async function launch({
   timeout,
   stallAfter,
   profile = inherited.SLICC_PROFILE === '1',
+  realistic = false,
 } = {}) {
   pruning ??= prune();
   await pruning;
@@ -238,7 +250,7 @@ export async function launch({
   const dumps = await crashpad();
   const { child, exited, stderr } = await start(
     userData,
-    commandLine(userData, loaded, args),
+    commandLine(userData, loaded, args, realistic),
     chromium.executablePath(),
     dumps.env
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-shared-web",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "Shared Renovate, Biome, TypeScript, lefthook and GitHub Actions configuration, plus the CDP integration-test harness, for SLICC's web repos",
   "type": "module",
   "license": "Apache-2.0",