ZDDC/tests/build-label.spec.js
ZDDC 6dca32b282 chore(build-label): drop three-word slug — use full timestamp + short SHA for alpha/beta cuts
The on-page label for `--release alpha|beta` cuts used to read
`vX.Y.Z-channel · YYYY-MM-DD · word-word-word`. The three-word slug
(derived deterministically from the source SHA via shared/build-words.txt)
was meant to make "is this the same build you emailed about?" a glance
check, but the cute-words layer turned out to be more confusing than
clarifying — testers prefer a real timestamp + short SHA.

New label shape, identical to plain dev builds:

  vX.Y.Z-channel · YYYY-MM-DD HH:MM:SS · <short-source-sha>[-dirty]

Helper renamed from _source_commit_slug to _source_commit_short_sha,
returning the short SHA of the source commit (walking past any
`chore(embedded): cut …` commit at HEAD so a re-cut on unchanged
source produces the same SHA). The wordlist file is no longer
referenced and is removed; tests/build-label.spec.js's regex
simplified to require the full timestamp + SHA form.
2026-05-13 11:14:35 -05:00

74 lines
3.6 KiB
JavaScript

/**
* build-label.spec.js
*
* Verifies that the {{BUILD_LABEL}} placeholder is correctly substituted in all
* four tool dist and website files:
*
* - No placeholder text leaks through
* - The .build-timestamp element is present and visible in the browser
* - The label content is either a timestamp ("Built: 20...") or a version ("v...")
* - website/ files (when present) always show the version format
*
* Note: dist/ files may show either format depending on whether the last build
* was a dev build (timestamp) or a release build (version). Both are valid.
*/
import { test, expect } from '@playwright/test';
import * as path from 'path';
import * as fs from 'fs';
const tools = ['archive', 'transmittal', 'classifier', 'browse'];
for (const tool of tools) {
const distPath = path.resolve(`${tool}/dist/${tool}.html`);
const websitePath = path.resolve(`website/${tool}.html`);
test.describe(`${tool}: build-label`, () => {
test(`dist file: no placeholder text leaks through`, async () => {
const html = fs.readFileSync(distPath, 'utf8');
expect(html).not.toContain('{{BUILD_LABEL}}');
expect(html).not.toContain('{{BUILD_TIMESTAMP}}');
});
test(`dist file: .build-timestamp element is visible in browser`, async ({ page }) => {
// browse may load Toast UI lazily; wait for full load.
const waitUntil = tool === 'browse' ? 'load' : 'domcontentloaded';
await page.goto(`file://${distPath}`, { waitUntil });
const el = page.locator('.build-timestamp');
await expect(el).toBeVisible({ timeout: 10000 });
});
test(`dist file: label is a valid channel or version string`, async () => {
const html = fs.readFileSync(distPath, 'utf8');
// Channel labels (alpha/beta) are wrapped in an inner <span style="color:red...">;
// stable version labels are bare text.
const match = html.match(/class="build-timestamp">(?:<span[^>]*>)?([^<]+?)(?:<\/span>)?</);
expect(match, 'build-timestamp element must have text content').toBeTruthy();
const label = match[1];
// Plain dev builds and --release alpha|beta share one label
// shape — full UTC timestamp + short source SHA (with
// optional -dirty marker on plain dev when the tree is
// uncommitted):
// "v0.0.17-alpha · 2026-04-29 00:50:17 · 714faf6"
// "v0.0.17-alpha · 2026-04-29 00:50:17 · 714faf6-dirty"
// "v0.0.17-beta · 2026-05-13 15:29:05 · e7f6334"
// Stable cuts emit a bare version: "v0.0.17"
const isChannel = /^v\d+\.\d+\.\d+-(?:alpha|beta) · 20\d\d-\d\d-\d\d \d\d:\d\d:\d\d · [0-9a-f]+(?:-dirty)?$/.test(label);
const isVersion = /^v\d+\.\d+\.\d+$/.test(label);
expect(isChannel || isVersion,
`Expected channel or version label, got: "${label}"`
).toBe(true);
});
test(`website file: label shows version format (release build)`, async () => {
if (!fs.existsSync(websitePath)) {
test.skip(true, `website/${tool}.html not present — run sh ${tool}/build.sh --release first`);
return;
}
const html = fs.readFileSync(websitePath, 'utf8');
expect(html).not.toContain('{{BUILD_LABEL}}');
expect(html).not.toContain('{{BUILD_TIMESTAMP}}');
expect(html).toMatch(/class="build-timestamp">(?:<span[^>]*>)?v\d+\.\d+\.\d+( BETA)?(?:<\/span>)?</);
});
});
}