@hydranium/core 1.0.0-next.10

package/lib/testing/playwright/server-log-capture.js

@@ -0,0 +1,336 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { appendFileSync, existsSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_LOG_FILE_ENV, DEFAULT_LOG_LEVEL_ENV } from '@hydranium/protocol';
+import { toLogFileWorkspaceToken } from '../../langium/diagnostics/log-file-token.js';
+/**
+ * Default env var naming the per-test server-log capture directory. Its presence
+ * is the opt-in: set it to a directory to enable capture, leave it unset for a
+ * normal (no-capture) run. Read by both {@link captureServerLog} and
+ * {@link attachServerLog}.
+ */
+export const DEFAULT_SERVER_LOG_DIR_ENV = 'HYDRANIUM_SERVER_LOG_DIR';
+/**
+ * Default env var providing a central {@link AttachServerLogOptions.attachOn}
+ * policy (`'failure' | 'always' | 'never'`) for a whole run, so a debugging
+ * session can flip it once on the CLI without touching any spec. An explicit
+ * `attachOn` option still wins; an unset/invalid value falls back to `'failure'`.
+ */
+export const DEFAULT_SERVER_LOG_ATTACH_ENV = 'HYDRANIUM_SERVER_LOG_ATTACH';
+/**
+ * Default env var naming which browser console levels {@link forwardBrowserConsole}
+ * forwards — a comma-separated list (e.g. `error,warning,info`). Lets a run widen or
+ * narrow the forwarded set without touching the spec. An explicit `levels` option
+ * wins; an unset value falls back to {@link DEFAULT_BROWSER_LOG_LEVELS}.
+ */
+export const DEFAULT_BROWSER_LOG_LEVELS_ENV = 'HYDRANIUM_BROWSER_LOG_LEVELS';
+/** Console levels {@link forwardBrowserConsole} forwards by default — errors + warnings only (tiny volume). */
+export const DEFAULT_BROWSER_LOG_LEVELS = ['error', 'warning'];
+function parseAttachOn(value) {
+    return value === 'failure' || value === 'always' || value === 'never' ? value : undefined;
+}
+/** Parse a comma-separated console-level list, or `undefined` when empty/unset. */
+function parseBrowserLogLevels(value) {
+    if (!value) {
+        return undefined;
+    }
+    const levels = value
+        .split(',')
+        .map(level => level.trim())
+        .filter(level => level.length > 0);
+    return levels.length > 0 ? levels : undefined;
+}
+/** The `{workspace}` placeholder the file-tee expands once the workspace is known. */
+const WORKSPACE_PLACEHOLDER = '{workspace}';
+/**
+ * Build the environment to inject into the server process (e.g. a Playwright
+ * `webServer.env`) so it writes one per-workspace log file under the capture dir,
+ * plus the reporter entry that renames those files to spec names once the run
+ * ends. Returns an **empty env, and no reporter, when no dir is configured**, so a
+ * normal run is untouched. The `{workspace}` token is expanded server-side once
+ * the workspace is known.
+ *
+ * **Publishes a resolved `options.dir` onto {@link DEFAULT_SERVER_LOG_DIR_ENV} in
+ * the CALLING process, and that mutation is load-bearing rather than a
+ * convenience.** The returned env reaches the server child only, while
+ * {@link markServerLog} / {@link attachServerLog} — the halves that write the
+ * per-test boundary markers and do the attaching — run in the runner process and
+ * resolve their directory from that env var, which a fixture typically calls with
+ * no options at all. Passing the option without publishing it produces a captured
+ * log with no markers in it and nothing attached to the failing test, which is
+ * worse than capture being off. A config-time caller runs before any worker forks,
+ * so the workers inherit it.
+ */
+export function captureServerLog(options = {}) {
+    const dir = options.dir ?? process.env[DEFAULT_SERVER_LOG_DIR_ENV];
+    if (!dir) {
+        return { env: {} };
+    }
+    process.env[DEFAULT_SERVER_LOG_DIR_ENV] = dir;
+    const env = {
+        [DEFAULT_LOG_FILE_ENV]: join(dir, `${WORKSPACE_PLACEHOLDER}.log`)
+    };
+    env[DEFAULT_LOG_LEVEL_ENV] = options.level ?? process.env[DEFAULT_LOG_LEVEL_ENV] ?? 'debug';
+    const reporterModule = fileURLToPath(new URL('./server-log-rename-reporter.js', import.meta.url));
+    return { env, reporter: [reporterModule, { dir }] };
+}
+/**
+ * Derive a stable, filename-safe per-suite log name from a spec's absolute path:
+ * the path below the last `tests/` segment (or the basename), minus the
+ * `.spec.ts(x)` suffix, with separators flattened. The server names logs by an
+ * opaque workspace token; {@link renameServerLogs} uses this to rename them to
+ * spec names once the run ends.
+ *
+ * `.mts` / `.cts` are stripped too: an ESM Playwright project names its specs
+ * `.spec.mts`, and a `.ts`-only strip leaves that inside the log's file name.
+ */
+export function serverLogSpecName(file) {
+    const norm = file.replace(/\\/g, '/');
+    const idx = norm.lastIndexOf('/tests/');
+    const relative = idx >= 0 ? norm.slice(idx + '/tests/'.length) : norm.slice(norm.lastIndexOf('/') + 1);
+    return relative.replace(/\.spec\.[cm]?tsx?$/, '').replace(/[^A-Za-z0-9._-]/g, '_');
+}
+/**
+ * Rename each `<token>.log` (backend) and `<token>.browser.log` (forwarded
+ * browser console) to the spec name recorded in its `<token>.spec` sidecar
+ * (written by {@link markServerLog}), then delete the sidecar. Colliding names —
+ * a spec that opened more than one workspace — get a `-2`, `-3`, … suffix. Token
+ * logs without a sidecar are left untouched. Run once, after all server processes
+ * have exited (e.g. a reporter's `onEnd`). Best-effort.
+ */
+export function renameServerLogs(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    // Per suffix (`.log`, `.browser.log`) a `taken` set guards collisions, so the
+    // backend and browser logs for one spec share the same friendly base name.
+    const taken = { '.log': new Set(), '.browser.log': new Set() };
+    const rename = (token, name, suffix) => {
+        const source = join(dir, `${token}${suffix}`);
+        if (!existsSync(source)) {
+            return;
+        }
+        let target = `${name}${suffix}`;
+        for (let n = 2; taken[suffix].has(target) || existsSync(join(dir, target)); n++) {
+            target = `${name}-${n}${suffix}`;
+        }
+        taken[suffix].add(target);
+        try {
+            renameSync(source, join(dir, target));
+        }
+        catch {
+            // ignore
+        }
+    };
+    for (const entry of entries) {
+        if (!entry.endsWith('.spec')) {
+            continue;
+        }
+        const sidecar = join(dir, entry);
+        const token = entry.slice(0, -'.spec'.length);
+        let name;
+        try {
+            name = readFileSync(sidecar, 'utf-8').trim();
+        }
+        catch {
+            continue;
+        }
+        try {
+            unlinkSync(sidecar);
+        }
+        catch {
+            // ignore
+        }
+        if (!name) {
+            continue;
+        }
+        rename(token, name, '.log');
+        rename(token, name, '.browser.log');
+    }
+}
+/**
+ * Resolve the per-workspace server-log file the {@link captureServerLog} tee
+ * writes for `workspacePath` — the `<token>.log` under the capture dir — or
+ * `undefined` when no capture dir is configured (`options.dir` / the default env
+ * var both unset). Lets a harness locate the log to fold elsewhere (e.g. the e2e
+ * profiling fixture folding `server.log` into a bundle). Does NOT check the file
+ * exists — it names where the tee would write.
+ */
+export function resolveServerLogPath(workspacePath, options = {}) {
+    const dir = options.dir ?? process.env[DEFAULT_SERVER_LOG_DIR_ENV];
+    if (!dir) {
+        return undefined;
+    }
+    return join(dir, `${toLogFileWorkspaceToken(workspacePath)}.log`);
+}
+/**
+ * Resolve the per-workspace **browser-console** log file {@link forwardBrowserConsole}
+ * writes for `workspacePath` — the `<token>.browser.log` under the capture dir —
+ * or `undefined` when no capture dir is configured. The browser console is kept in
+ * its OWN file (not interleaved into `server.log`): the two streams use different
+ * clocks, so a merged order would misrepresent timing. Does NOT check the file exists.
+ */
+export function resolveBrowserConsoleLogPath(workspacePath, options = {}) {
+    const dir = options.dir ?? process.env[DEFAULT_SERVER_LOG_DIR_ENV];
+    if (!dir) {
+        return undefined;
+    }
+    return join(dir, `${toLogFileWorkspaceToken(workspacePath)}.browser.log`);
+}
+/**
+ * Write a start-of-test boundary marker to the workspace's (per-suite) server
+ * log, so the test's lines follow it in natural reading order. Call from a
+ * spec's `beforeEach` (or a fixture's setup) with the test's workspace path.
+ * No-op when no capture dir is configured. Best-effort; never throws.
+ */
+export function markServerLog(testInfo, workspacePath, options = {}) {
+    const dir = options.dir ?? process.env[DEFAULT_SERVER_LOG_DIR_ENV];
+    if (!dir) {
+        return;
+    }
+    const token = toLogFileWorkspaceToken(workspacePath);
+    try {
+        appendFileSync(join(dir, `${token}.log`), `\n===== START: ${testInfo.title} =====\n`);
+    }
+    catch {
+        // Best-effort marker; a failing log sink must not break the test run.
+    }
+    // Record token -> spec name so `renameServerLogs` can give the per-suite log a
+    // friendly name after the run (the server itself only knows the workspace token).
+    if (testInfo.file) {
+        try {
+            writeFileSync(join(dir, `${token}.spec`), serverLogSpecName(testInfo.file));
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+/**
+ * Append a raw line to the workspace's (per-suite) server-log file — the same
+ * `<token>.log` {@link markServerLog} / {@link attachServerLog} write to. Lets a
+ * harness interleave its own observations (e.g. forwarded browser-console lines)
+ * into the backend stream so they correlate by timestamp/order. A trailing
+ * newline is added if the line lacks one.
+ *
+ * **No-op when no capture dir is configured** (`opts.dir` / the default env var
+ * both unset), so a normal run is untouched. Best-effort; never throws.
+ */
+export function appendServerLog(workspacePath, line, options = {}) {
+    const dir = options.dir ?? process.env[DEFAULT_SERVER_LOG_DIR_ENV];
+    if (!dir) {
+        return;
+    }
+    const file = join(dir, `${toLogFileWorkspaceToken(workspacePath)}.log`);
+    try {
+        appendFileSync(file, line.endsWith('\n') ? line : `${line}\n`);
+    }
+    catch {
+        // Best-effort; a failing log sink must not break the test run.
+    }
+}
+/**
+ * Forward the browser tab's `error` / `warning` console messages into the
+ * workspace's (per-suite) **browser-console** log — `<token>.browser.log`, its own
+ * file BESIDE the backend `server.log`, NOT interleaved into it. The two streams
+ * use different clocks (the backend logger vs the forwarder's arrival time), so a
+ * merged order would misrepresent timing; keeping them separate is honest and a
+ * consumer can still merge deliberately by each line's own timestamp. Playwright
+ * has both page access and fs access, so no renderer→backend transport is needed.
+ * Which levels are forwarded is configurable — `options.levels`, else the
+ * comma-separated {@link DEFAULT_BROWSER_LOG_LEVELS_ENV} env, else
+ * {@link DEFAULT_BROWSER_LOG_LEVELS} (`error` + `warning`, tiny volume; the
+ * production frontend logger strips info/debug/log anyway). Each line keeps the
+ * frontend logger's own timestamp (embedded in the text); a `[browser]` tag marks
+ * the origin.
+ *
+ * Call once after the page exists (e.g. right after the Theia app starts), with
+ * the test's workspace path. **No-op — and no listener attached — when no capture
+ * dir is configured** (`options.dir` / the default env var both unset), so a
+ * normal run is untouched. Best-effort; forwarding never throws.
+ */
+export function forwardBrowserConsole(page, workspacePath, options = {}) {
+    const dir = options.dir ?? process.env[DEFAULT_SERVER_LOG_DIR_ENV];
+    if (!dir) {
+        return;
+    }
+    const levels = new Set(options.levels ?? parseBrowserLogLevels(process.env[DEFAULT_BROWSER_LOG_LEVELS_ENV]) ?? DEFAULT_BROWSER_LOG_LEVELS);
+    const file = join(dir, `${toLogFileWorkspaceToken(workspacePath)}.browser.log`);
+    page.on('console', message => {
+        const type = message.type();
+        if (!levels.has(type)) {
+            return;
+        }
+        try {
+            appendFileSync(file, `[browser] [${type}] ${message.text()}\n`);
+        }
+        catch {
+            // Best-effort; a failing log sink must not break the test run.
+        }
+    });
+}
+/**
+ * Per-test server-log capture, called from a spec's `afterEach` with the test's
+ * workspace path:
+ *
+ * - appends an end-of-test **boundary marker** to the workspace's (per-suite)
+ *   server log, so each test's region is delimited within the shared stream;
+ * - attaches that log — and the separate browser-console log, when one exists —
+ *   to the test, so it shows in the HTML report alongside the trace + screenshot.
+ *   Which outcomes attach is {@link AttachServerLogOptions.attachOn}, failure-only
+ *   by default.
+ *
+ * **No-op when no capture dir is configured** (`options.dir` and the default env
+ * var both unset), so a normal run is untouched — no per-spec guard needed.
+ * Markers and writes are best-effort; failures never propagate.
+ */
+export async function attachServerLog(testInfo, workspacePath, options = {}) {
+    const dir = options.dir ?? process.env[DEFAULT_SERVER_LOG_DIR_ENV];
+    if (!dir) {
+        return;
+    }
+    const file = join(dir, `${toLogFileWorkspaceToken(workspacePath)}.log`);
+    const status = testInfo.status ?? 'unknown';
+    try {
+        appendFileSync(file, `\n===== END: ${testInfo.title} — ${status} =====\n`);
+    }
+    catch {
+        // Best-effort marker; a failing log sink must not break the test run.
+    }
+    const failed = status !== (testInfo.expectedStatus ?? 'passed');
+    const attachOn = options.attachOn ?? parseAttachOn(process.env[DEFAULT_SERVER_LOG_ATTACH_ENV]) ?? 'failure';
+    const shouldAttach = attachOn === 'always' || (attachOn === 'failure' && failed);
+    if (!shouldAttach) {
+        return;
+    }
+    // Attach both streams: the backend server log and (when present) the separate
+    // browser-console log, so a failing test carries the frontend side too.
+    const attachments = [
+        { name: 'server-log', path: file },
+        { name: 'browser-console-log', path: join(dir, `${toLogFileWorkspaceToken(workspacePath)}.browser.log`) }
+    ];
+    for (const attachment of attachments) {
+        if (!existsSync(attachment.path)) {
+            continue;
+        }
+        try {
+            await testInfo.attach(attachment.name, { path: attachment.path, contentType: 'text/plain' });
+        }
+        catch {
+            // Attaching must not break the test run.
+        }
+    }
+}
+//# sourceMappingURL=server-log-capture.js.map

package/lib/testing/playwright/server-log-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log-capture.js","sourceRoot":"","sources":["../../../src/testing/playwright/server-log-capture.ts"],"names":[],"mappings":"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"}

package/lib/testing/playwright/server-log-fixture.d.ts

@@ -0,0 +1,36 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { type Fixtures, type PlaywrightTestArgs, type PlaywrightTestOptions } from '@playwright/test';
+export interface ServerLogFixtures {
+    /**
+     * Workspace path for the current test. Defaults to `''` (capture skipped);
+     * adopters override it with a fixture deriving from their app.
+     * Requires a **per-test app fixture** — a per-spec `beforeAll` app lives in a
+     * closure a fixture cannot read, so those suites use `markServerLog` /
+     * `attachServerLog` in `beforeEach` / `afterEach` instead.
+     */
+    serverLogWorkspace: string;
+}
+/** Full fixture set including the internal side-effect-only auto fixture. */
+interface ServerLogTestFixtures extends ServerLogFixtures {
+    /** Internal auto fixture: marks on setup, attaches on teardown. Provides no value. */
+    serverLogCapture: void;
+}
+/**
+ * Composable fixtures for per-test server-log capture: writes the start marker
+ * before each test (setup) and attaches the log on failure after each test
+ * (teardown) — i.e. the `beforeEach` + `afterEach` pair fused into one auto
+ * fixture. Compose onto any test base, or use the pre-extended {@link test}.
+ * Override `serverLogWorkspace` to wire the workspace; otherwise it's inert.
+ */
+export declare const serverLogFixtures: Fixtures<ServerLogTestFixtures, object, PlaywrightTestArgs & PlaywrightTestOptions>;
+/** Pre-extended test with {@link serverLogFixtures} applied, for adopters on the plain base. */
+export declare const test: import("@playwright/test").TestType<PlaywrightTestArgs & PlaywrightTestOptions & ServerLogTestFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export {};
+//# sourceMappingURL=server-log-fixture.d.ts.map

package/lib/testing/playwright/server-log-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log-fixture.d.ts","sourceRoot":"","sources":["../../../src/testing/playwright/server-log-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAKlF,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGpH,MAAM,WAAW,iBAAiB;IAC/B;;;;;;OAMG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC7B;AAED,6EAA6E;AAC7E,UAAU,qBAAsB,SAAQ,iBAAiB;IACtD,sFAAsF;IACtF,gBAAgB,EAAE,IAAI,CAAC;CACzB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,qBAAqB,EAAE,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAcjH,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,IAAI,+MAAwD,CAAC"}

package/lib/testing/playwright/server-log-fixture.js

@@ -0,0 +1,38 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+// This module imports `@playwright/test` (an OPTIONAL peer) to compose a fixture.
+// The plain functions in `server-log-capture.ts` stay playwright-free; only
+// adopters that use this fixture need `@playwright/test` installed.
+import { test as base } from '@playwright/test';
+import { attachServerLog, markServerLog } from './server-log-capture.js';
+/**
+ * Composable fixtures for per-test server-log capture: writes the start marker
+ * before each test (setup) and attaches the log on failure after each test
+ * (teardown) — i.e. the `beforeEach` + `afterEach` pair fused into one auto
+ * fixture. Compose onto any test base, or use the pre-extended {@link test}.
+ * Override `serverLogWorkspace` to wire the workspace; otherwise it's inert.
+ */
+export const serverLogFixtures = {
+    serverLogWorkspace: ['', { option: true }],
+    serverLogCapture: [
+        async ({ serverLogWorkspace }, use) => {
+            if (serverLogWorkspace) {
+                markServerLog(base.info(), serverLogWorkspace);
+            }
+            await use(undefined);
+            if (serverLogWorkspace) {
+                await attachServerLog(base.info(), serverLogWorkspace);
+            }
+        },
+        { auto: true }
+    ]
+};
+/** Pre-extended test with {@link serverLogFixtures} applied, for adopters on the plain base. */
+export const test = base.extend(serverLogFixtures);
+//# sourceMappingURL=server-log-fixture.js.map

package/lib/testing/playwright/server-log-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log-fixture.js","sourceRoot":"","sources":["../../../src/testing/playwright/server-log-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,kFAAkF;AAClF,4EAA4E;AAC5E,oEAAoE;AACpE,OAAO,EAAE,IAAI,IAAI,IAAI,EAAsE,MAAM,kBAAkB,CAAC;AACpH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAmBzE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwF;IACnH,kBAAkB,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1C,gBAAgB,EAAE;QACf,KAAK,EAAE,EAAE,kBAAkB,EAAE,EAAE,GAAG,EAAiB,EAAE;YAClD,IAAI,kBAAkB,EAAE,CAAC;gBACtB,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC;YACrB,IAAI,kBAAkB,EAAE,CAAC;gBACtB,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC1D,CAAC;QACJ,CAAC;QACD,EAAE,IAAI,EAAE,IAAI,EAAE;KAChB;CACH,CAAC;AAEF,gGAAgG;AAChG,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAwB,iBAAiB,CAAC,CAAC"}

package/lib/testing/playwright/server-log-rename-reporter.d.ts

@@ -0,0 +1,22 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { type ServerLogRenameReporterOptions } from './server-log-capture.js';
+/**
+ * Playwright reporter (registered by path via `captureServerLog`) that, at
+ * the end of the run — once every per-frontend server has exited — renames the
+ * opaque `<workspace-token>.log` files to spec names via {@link renameServerLogs}.
+ * Implements only `onEnd`; declared structurally so this module imports nothing
+ * from `@playwright/test`.
+ */
+export default class ServerLogRenameReporter {
+    protected readonly dir: string;
+    constructor(options: ServerLogRenameReporterOptions);
+    onEnd(): void;
+}
+//# sourceMappingURL=server-log-rename-reporter.d.ts.map

package/lib/testing/playwright/server-log-rename-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log-rename-reporter.d.ts","sourceRoot":"","sources":["../../../src/testing/playwright/server-log-rename-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAoB,KAAK,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IACzC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,8BAA8B;IAInD,KAAK,IAAI,IAAI;CAGf"}

package/lib/testing/playwright/server-log-rename-reporter.js

@@ -0,0 +1,26 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { renameServerLogs } from './server-log-capture.js';
+/**
+ * Playwright reporter (registered by path via `captureServerLog`) that, at
+ * the end of the run — once every per-frontend server has exited — renames the
+ * opaque `<workspace-token>.log` files to spec names via {@link renameServerLogs}.
+ * Implements only `onEnd`; declared structurally so this module imports nothing
+ * from `@playwright/test`.
+ */
+export default class ServerLogRenameReporter {
+    dir;
+    constructor(options) {
+        this.dir = options.dir;
+    }
+    onEnd() {
+        renameServerLogs(this.dir);
+    }
+}
+//# sourceMappingURL=server-log-rename-reporter.js.map

package/lib/testing/playwright/server-log-rename-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-log-rename-reporter.js","sourceRoot":"","sources":["../../../src/testing/playwright/server-log-rename-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,gBAAgB,EAAuC,MAAM,yBAAyB,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IACtB,GAAG,CAAS;IAE/B,YAAY,OAAuC;QAChD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED,KAAK;QACF,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;CACH"}

package/lib/testing/run-update-pipeline.d.ts

@@ -0,0 +1,99 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+/**
+ * Driver for the structured-write transform chain — the rewrite registry plus
+ * the serializer — run the way `ModelService.update` runs it.
+ *
+ * # Why a driver and not a documented recipe
+ *
+ * The chain is short enough that a test can chain it by hand, and that is
+ * exactly the failure this exists to prevent. A hand-copied chain names each
+ * rewrite as a function call, so it is a SNAPSHOT of the registry taken on the
+ * day it was written: a newly registered rewrite, a changed priority or a
+ * withdrawn one leaves the copy compiling and passing while production runs
+ * something else. Nothing fails, because the drift only matters for the
+ * fixtures the missing rewrite would have touched — and a test whose fixture it
+ * does not touch keeps asserting against a pipeline that stopped existing.
+ * Reading the order from the registry is the only version of this that cannot
+ * fall behind.
+ *
+ * # Resolved per URI, not per language handle
+ *
+ * Both slots are resolved through `ServiceRegistry.getServices(uri)`, which is
+ * what `ModelService.serialize` and `ModelService.rewriteModel` do. Taking a
+ * language-services handle instead would be shorter, but it re-hardcodes the
+ * language at the call site and so cannot witness a multi-grammar workspace
+ * routing a write to the wrong language's rewrite set or serializer — the one
+ * defect that only shows up when more than one grammar is registered.
+ *
+ * # Scope: the transform chain, not the document lifecycle
+ *
+ * This runs rewrite → serialize and stops. It does NOT open the document, push
+ * text into the multi-client store, drive a build or return an
+ * {@link AstDocument}: those need a live workspace, and a test that wants them
+ * should call `ModelService.update` itself rather than a driver standing in for
+ * it. What is left is the part with no observable of its own — the text and the
+ * rewritten model — which is why it needed lifting.
+ *
+ * A textual payload is likewise out of scope. `ModelService.modelToText`
+ * returns a string payload untouched, so there is no chain to drive and nothing
+ * a driver could add.
+ */
+import type { AstNode } from '@hydranium/langium';
+import type { TransferElement } from '@hydranium/protocol';
+import type { CancellationToken } from 'vscode-languageserver';
+import type { ServerSharedServices } from '../langium/module.js';
+/** Inputs to {@link runUpdatePipeline}. */
+export interface UpdatePipelineArgs<TTransfer extends TransferElement = TransferElement, TAst extends AstNode = AstNode> {
+    /**
+     * URI the write is for. Selects the language whose rewrite set and
+     * serializer run, so in a multi-grammar workspace it decides the answer
+     * rather than merely labelling it.
+     */
+    readonly uri: string;
+    /** Transfer-model payload, as an adopter caller would hand it to `ModelService.update`. */
+    readonly model: TTransfer;
+    /**
+     * Previous AST root threaded into every rewrite, so a diff-based rewrite can
+     * tell a real user change from a stale echo.
+     *
+     * Omit it to take the same value production takes — the current document's
+     * `parseResult.value`, or `undefined` for a document that has never been
+     * built. Pass it explicitly when the test constructs both sides itself and
+     * has no built document to read from.
+     */
+    readonly previous?: TAst;
+    /** Honoured between rewrites, as `UpdateRewriteService.apply` honours it. */
+    readonly cancelToken?: CancellationToken;
+}
+/** What {@link runUpdatePipeline} produced, at both stages. */
+export interface UpdatePipelineResult<TTransfer extends TransferElement = TransferElement> {
+    /**
+     * The model after the rewrite chain and before serialisation.
+     *
+     * Exposed rather than discarded because the chain is what drifts, and a test
+     * that can only see `text` has to assert the chain's effect THROUGH the
+     * serializer — which turns a model assertion into a substring match on the
+     * concrete syntax, sensitive to formatting that has nothing to do with the
+     * rewrite. Returning a bare string was the alternative; it is a smaller
+     * surface but it makes the precise assertion unavailable.
+     */
+    readonly rewritten: TTransfer;
+    /** The serialized text, which is what `ModelService.update` applies to the store. */
+    readonly text: string;
+}
+/**
+ * Run the rewrite chain registered for `args.uri`'s language, then serialise
+ * the result with that language's `Serializer`.
+ *
+ * Both slots are read from the registry at call time, so a rewrite registered
+ * after this driver was written still runs.
+ */
+export declare function runUpdatePipeline<TTransfer extends TransferElement = TransferElement, TAst extends AstNode = AstNode>(services: ServerSharedServices, args: UpdatePipelineArgs<TTransfer, TAst>): Promise<UpdatePipelineResult<TTransfer>>;
+//# sourceMappingURL=run-update-pipeline.d.ts.map

package/lib/testing/run-update-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-update-pipeline.d.ts","sourceRoot":"","sources":["../../src/testing/run-update-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB,CAAC,SAAS,SAAS,eAAe,GAAG,eAAe,EAAE,IAAI,SAAS,OAAO,GAAG,OAAO;IACpH;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAC3C;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,eAAe,GAAG,eAAe;IACtF;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,SAAS,eAAe,GAAG,eAAe,EAAE,IAAI,SAAS,OAAO,GAAG,OAAO,EACxH,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,GACzC,OAAO,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAM1C"}

package/lib/testing/run-update-pipeline.js

@@ -0,0 +1,24 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { UriUtils } from '@hydranium/langium';
+/**
+ * Run the rewrite chain registered for `args.uri`'s language, then serialise
+ * the result with that language's `Serializer`.
+ *
+ * Both slots are read from the registry at call time, so a rewrite registered
+ * after this driver was written still runs.
+ */
+export async function runUpdatePipeline(services, args) {
+    const languageServices = services.ServiceRegistry.getServices(UriUtils.toUri(args.uri));
+    const previous = args.previous ?? services.workspace.AstDocumentManager.getDocument(args.uri)?.parseResult.value;
+    const rewritten = (await languageServices.updateRewrite.UpdateRewriteService.apply(args.model, previous, args.cancelToken));
+    const text = await languageServices.serializer.Serializer.serializeTransfer(rewritten);
+    return { rewritten, text };
+}
+//# sourceMappingURL=run-update-pipeline.js.map

package/lib/testing/run-update-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-update-pipeline.js","sourceRoot":"","sources":["../../src/testing/run-update-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AA2ClF,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AA8C9C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACpC,QAA8B,EAC9B,IAAyC;IAEzC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAK,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,KAA0B,CAAC;IACvI,MAAM,SAAS,GAAG,CAAC,MAAM,gBAAgB,CAAC,aAAa,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAc,CAAC;IACzI,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,UAAU,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACvF,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC9B,CAAC"}