@hominis/fireforge 0.55.0 → 0.60.0

package/dist/src/core/build-audit-resolve.d.ts

@@ -1,78 +0,0 @@
-/**
- * Heuristic test for "this looks like a packaged-test source file". The
- * audit routes such paths to `_tests/` instead of `dist/`. Matches
- * mochitest / xpcshell / browser-chrome conventions: any source under a
- * `/test/` or `/tests/` directory, anywhere under a `testing/` subtree
- * (which holds mochitest / marionette / xpcshell harness sources), or
- * with a `browser_` / `test_` prefix on a `.js`/`.toml` basename. Test
- * manifests (`*.toml`, `*.list`, `*.ini`) under those directories also
- * qualify.
- *
- * @param sourcePath Engine-relative POSIX path
- * @returns True when the file belongs to the test tree, not the bundle
- */
-export declare function isTestPath(sourcePath: string): boolean;
-/**
- * Counts how many trailing segments two paths share. Used to score
- * candidate dist artifacts against a source path so that
- * `branding/<name>/content/aboutDialog.css` prefers a candidate at
- * `…/content/branding/aboutDialog.css` over one at
- * `…/content/browser/aboutDialog.css`.
- *
- * @param a First path
- * @param b Second path
- * @returns Count of matching trailing segments (basename always counts as 1)
- */
-export declare function countTrailingSegmentMatches(a: string, b: string): number;
-/**
- * Path segments too common to identify an artifact on their own.
- *
- * Shared on purpose: this set governs two halves of one decision,
- * `scoreCandidate` (selection) and `isConfidentMatch` (confirmation, in
- * `build-audit.ts`). Separate copies would disagree, so a source path
- * could earn a selection bonus for a segment that confirmation then
- * rejected as meaningless, leaving the chosen artifact unconfirmable. One
- * set makes every addition apply to both halves.
- */
-export declare const GENERIC_PATH_SEGMENTS: ReadonlySet<string>;
-/**
- * Computes a score for `candidatePath` relative to `sourcePath`. Higher
- * scores win. Score = trailing-segment match count, with a bonus when the
- * candidate's path contains a meaningful intermediate segment from the
- * source (e.g. `branding`, or the branding dir name itself).
- *
- * The bonus exists because Firefox packaging often re-roots files: a source
- * `branding/<name>/content/aboutDialog.css` lands at
- * `chrome/browser/content/branding/aboutDialog.css`. Only the basename
- * trails-match, but the `branding` segment moved into the middle of the
- * candidate path. Without the bonus that candidate ties with the unrelated
- * `chrome/browser/content/browser/aboutDialog.css`.
- *
- * @param sourcePath Engine-relative POSIX path
- * @param candidatePath Absolute path under the dist tree
- * @returns Numeric score, where higher means better match
- */
-export declare function scoreCandidate(sourcePath: string, candidatePath: string): number;
-/**
- * Walks a tree under `root` and returns every file whose basename equals
- * `name`. Skips dotfile / hidden directories so the symlinked
- * `.mozbuild` cache (a full upstream copy) does not dominate the scan
- * on macOS.
- *
- * @param root Tree root to search
- * @param name Basename to match
- * @param maxDepth Optional traversal cap (default 12)
- * @returns All matching absolute paths
- */
-export declare function findAllByBasename(root: string, name: string, maxDepth?: number): Promise<string[]>;
-/**
- * Resolves the best-matching artifact for a source path under one or
- * more search roots. Returns the highest-scoring candidate by trailing
- * segment overlap. Ties go to the first-found path (deterministic via
- * the directory-walk order). Returns undefined when no candidate exists.
- *
- * @param sourcePath Engine-relative POSIX source path
- * @param searchRoots Absolute roots to scan (e.g. dist/, _tests/)
- * @returns Best-matching artifact path, or undefined
- */
-export declare function resolveBestArtifact(sourcePath: string, searchRoots: readonly string[]): Promise<string | undefined>;

package/dist/src/core/build-audit-resolve.js

@@ -1,240 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/*
- * Path-resolution helpers for the post-build dist-tree audit.
- *
- * Resolves the expected on-disk artifact location for a given engine source
- * path. Matching purely by basename produces three classes of false
- * positive, each of which these helpers exist to avoid:
- *
- *   1. A branding override (`engine/browser/branding/<name>/content/
- *      aboutDialog.css`, shipped at `chrome/browser/content/branding/
- *      aboutDialog.css`) matching the unrelated upstream
- *      `chrome/browser/content/browser/aboutDialog.css`. Handled by ranking
- *      same-basename candidates on shared trailing path segments.
- *   2. Test files (`browser_*.js`, `test_*.js`) living under `_tests/`, not
- *      `dist/`. Handled by routing test paths to a separate resolver.
- *   3. Build inputs (`jar.mn`, `moz.build`, `Makefile.in`, `moz.configure`)
- *      that are consumed rather than packaged. Handled in `build-audit.ts`
- *      via `isPackageablePath`.
- */
-import { readdir } from 'node:fs/promises';
-import { basename, join } from 'node:path';
-import { pathExists } from '../utils/fs.js';
-import { normalizePathSlashes } from '../utils/paths.js';
-/** Maximum directory depth to traverse when scanning a tree root. */
-const MAX_SCAN_DEPTH = 12;
-/**
- * Heuristic test for "this looks like a packaged-test source file". The
- * audit routes such paths to `_tests/` instead of `dist/`. Matches
- * mochitest / xpcshell / browser-chrome conventions: any source under a
- * `/test/` or `/tests/` directory, anywhere under a `testing/` subtree
- * (which holds mochitest / marionette / xpcshell harness sources), or
- * with a `browser_` / `test_` prefix on a `.js`/`.toml` basename. Test
- * manifests (`*.toml`, `*.list`, `*.ini`) under those directories also
- * qualify.
- *
- * @param sourcePath Engine-relative POSIX path
- * @returns True when the file belongs to the test tree, not the bundle
- */
-export function isTestPath(sourcePath) {
-    if (sourcePath.includes('/test/') || sourcePath.includes('/tests/')) {
-        return true;
-    }
-    // `testing/{mochitest,marionette,xpcshell,...}` are test-infrastructure
-    // trees that ship under `_tests/`, not `dist/`. Match both as a root
-    // segment (e.g. `testing/mochitest/api.js`) and as an interior segment
-    // (e.g. a vendored harness under `third_party/.../testing/...`).
-    if (sourcePath.startsWith('testing/') || sourcePath.includes('/testing/')) {
-        return true;
-    }
-    const name = basename(sourcePath);
-    if (/^browser_.+\.(js|toml|ini)$/.test(name))
-        return true;
-    if (/^test_.+\.(js|toml|ini)$/.test(name))
-        return true;
-    return false;
-}
-/**
- * Splits a path into segments, dropping empties.
- *
- * Separators are normalized first because the candidates come from `join()`
- * over a `readdir` walk of the dist tree: on Windows those carry backslashes,
- * which a `/`-only split collapses into a single segment. Every candidate then
- * scores the same, so the trailing-overlap heuristic that disambiguates
- * same-basename artifacts (`branding/…/aboutDialog.css` versus
- * `browser/…/aboutDialog.css`) silently picks an arbitrary one.
- *
- * @param path Path in either separator style
- */
-function pathSegments(path) {
-    return normalizePathSlashes(path).split('/').filter(Boolean);
-}
-/**
- * Counts how many trailing segments two paths share. Used to score
- * candidate dist artifacts against a source path so that
- * `branding/<name>/content/aboutDialog.css` prefers a candidate at
- * `…/content/branding/aboutDialog.css` over one at
- * `…/content/browser/aboutDialog.css`.
- *
- * @param a First path
- * @param b Second path
- * @returns Count of matching trailing segments (basename always counts as 1)
- */
-export function countTrailingSegmentMatches(a, b) {
-    const aSegs = pathSegments(a);
-    const bSegs = pathSegments(b);
-    let matches = 0;
-    while (matches < aSegs.length &&
-        matches < bSegs.length &&
-        aSegs[aSegs.length - 1 - matches] === bSegs[bSegs.length - 1 - matches]) {
-        matches += 1;
-    }
-    return matches;
-}
-/**
- * Path segments too common to identify an artifact on their own.
- *
- * Shared on purpose: this set governs two halves of one decision,
- * `scoreCandidate` (selection) and `isConfidentMatch` (confirmation, in
- * `build-audit.ts`). Separate copies would disagree, so a source path
- * could earn a selection bonus for a segment that confirmation then
- * rejected as meaningless, leaving the chosen artifact unconfirmable. One
- * set makes every addition apply to both halves.
- */
-export const GENERIC_PATH_SEGMENTS = new Set([
-    'content',
-    'chrome',
-    'bin',
-    'browser',
-    'toolkit',
-    'modules',
-    'base',
-    'app',
-    'profile',
-    'shared',
-    'themes',
-    'test',
-    'tests',
-    'unit',
-    'common',
-    'xpcshell',
-    'mochitest',
-]);
-/**
- * Computes a score for `candidatePath` relative to `sourcePath`. Higher
- * scores win. Score = trailing-segment match count, with a bonus when the
- * candidate's path contains a meaningful intermediate segment from the
- * source (e.g. `branding`, or the branding dir name itself).
- *
- * The bonus exists because Firefox packaging often re-roots files: a source
- * `branding/<name>/content/aboutDialog.css` lands at
- * `chrome/browser/content/branding/aboutDialog.css`. Only the basename
- * trails-match, but the `branding` segment moved into the middle of the
- * candidate path. Without the bonus that candidate ties with the unrelated
- * `chrome/browser/content/browser/aboutDialog.css`.
- *
- * @param sourcePath Engine-relative POSIX path
- * @param candidatePath Absolute path under the dist tree
- * @returns Numeric score, where higher means better match
- */
-export function scoreCandidate(sourcePath, candidatePath) {
-    const trailing = countTrailingSegmentMatches(sourcePath, candidatePath);
-    const sourceSegs = pathSegments(sourcePath);
-    const candSegs = pathSegments(candidatePath);
-    // Look for source segments that appear anywhere in the candidate path
-    // but are not part of the trailing match. Each unique mid-path hit on
-    // a meaningful (>2-char, not generic like 'content'/'chrome'/'bin')
-    // segment adds 1 to the score.
-    const generic = GENERIC_PATH_SEGMENTS;
-    const trailingSet = new Set(sourceSegs.slice(sourceSegs.length - trailing));
-    let bonus = 0;
-    for (const seg of sourceSegs) {
-        if (seg.length <= 2)
-            continue;
-        if (generic.has(seg))
-            continue;
-        if (trailingSet.has(seg))
-            continue;
-        if (candSegs.includes(seg))
-            bonus += 1;
-    }
-    return trailing * 10 + bonus;
-}
-/**
- * Walks a tree under `root` and returns every file whose basename equals
- * `name`. Skips dotfile / hidden directories so the symlinked
- * `.mozbuild` cache (a full upstream copy) does not dominate the scan
- * on macOS.
- *
- * @param root Tree root to search
- * @param name Basename to match
- * @param maxDepth Optional traversal cap (default 12)
- * @returns All matching absolute paths
- */
-export async function findAllByBasename(root, name, maxDepth = MAX_SCAN_DEPTH) {
-    const results = [];
-    if (!(await pathExists(root)))
-        return results;
-    const stack = [{ dir: root, depth: 0 }];
-    while (stack.length > 0) {
-        const entry = stack.pop();
-        if (!entry)
-            break;
-        if (entry.depth > maxDepth)
-            continue;
-        let children;
-        try {
-            children = await readdir(entry.dir, { withFileTypes: true });
-        }
-        catch {
-            // An unreadable subdirectory yields no candidates. Skip it and keep
-            // scoring the rest rather than abandoning the whole resolution.
-            continue;
-        }
-        for (const child of children) {
-            const fullPath = join(entry.dir, child.name);
-            if (child.isDirectory()) {
-                if (child.name.startsWith('.'))
-                    continue;
-                stack.push({ dir: fullPath, depth: entry.depth + 1 });
-                continue;
-            }
-            if (child.name === name) {
-                results.push(fullPath);
-            }
-        }
-    }
-    return results;
-}
-/**
- * Resolves the best-matching artifact for a source path under one or
- * more search roots. Returns the highest-scoring candidate by trailing
- * segment overlap. Ties go to the first-found path (deterministic via
- * the directory-walk order). Returns undefined when no candidate exists.
- *
- * @param sourcePath Engine-relative POSIX source path
- * @param searchRoots Absolute roots to scan (e.g. dist/, _tests/)
- * @returns Best-matching artifact path, or undefined
- */
-export async function resolveBestArtifact(sourcePath, searchRoots) {
-    const name = basename(sourcePath);
-    const allCandidates = [];
-    for (const root of searchRoots) {
-        const found = await findAllByBasename(root, name);
-        allCandidates.push(...found);
-    }
-    if (allCandidates.length === 0)
-        return undefined;
-    if (allCandidates.length === 1)
-        return allCandidates[0];
-    let bestScore = -1;
-    let best;
-    for (const candidate of allCandidates) {
-        const score = scoreCandidate(sourcePath, candidate);
-        if (score > bestScore) {
-            bestScore = score;
-            best = candidate;
-        }
-    }
-    return best;
-}

package/dist/src/core/build-audit-skip.d.ts

@@ -1,57 +0,0 @@
-/**
- * Why a changed engine path was not audited.
- *
- * Each reason is structured so summaries and machine output can count
- * skips by cause instead of reading verbose log strings.
- */
-export type AuditSkipReason = 'not-packageable' | 'platform-gated' | 'platform-gated-ancestor' | 'tests-not-packaged' | 'source-unreadable' | 'branding-not-selected' | 'storybook-story' | 'declared-unpackaged';
-/** Render order for the `Packaged:` summary's per-class breakdown. */
-export declare const AUDIT_SKIP_REASONS: readonly AuditSkipReason[];
-/** True for a Storybook story module. */
-export declare function isStorybookStoryPath(sourcePath: string): boolean;
-/**
- * Reads the branding directory this objdir was configured with.
- *
- * FireForge generates `engine/mozconfig` and writes the
- * `ac_add_options --with-branding=…` line into it, so the selected branding
- * is knowable from the tree. Returns undefined when the mozconfig cannot be
- * read or carries no directive. The caller must then keep warning, because
- * a skip that cannot name its evidence is a masked warning.
- *
- * @param engineDir - Absolute path to the engine root
- * @returns Engine-relative branding path, or undefined
- */
-export declare function resolveSelectedBranding(engineDir: string): Promise<string | undefined>;
-/**
- * True when `sourcePath` lives under a branding tree that is not the one
- * this objdir was configured with.
- *
- * An unselected branding directory is not an input to this build at all, so
- * its files can never appear in `dist/`. Worse, the basename walker matched
- * them against the selected branding's same-named artifact and reported the
- * unselected file as "newer than its packaged artifact", a stale warning
- * about a comparison that has no meaning.
- *
- * @param sourcePath - Engine-relative POSIX path
- * @param selectedBranding - Engine-relative selected branding path
- */
-export declare function isUnselectedBrandingPath(sourcePath: string, selectedBranding: string | undefined): boolean;
-/** One `buildAudit.unpackaged` carve-out from `fireforge.json`. */
-export interface UnpackagedDeclaration {
-    /** Engine-relative path or glob. */
-    path: string;
-    /** Why this file is deliberately never packaged. Required, non-empty. */
-    reason: string;
-}
-/**
- * Finds the declaration admitting `sourcePath`, if any.
- *
- * Exact match or a `*`-within-one-segment glob, matching the
- * `support-files` matcher's narrowness: `**` and other cross-directory
- * shapes are not accepted, because a carve-out that silently widens is the
- * failure this feature is warned against.
- *
- * @param sourcePath - Engine-relative POSIX path
- * @param declarations - The project's `buildAudit.unpackaged` entries
- */
-export declare function matchUnpackagedDeclaration(sourcePath: string, declarations: readonly UnpackagedDeclaration[]): UnpackagedDeclaration | undefined;

package/dist/src/core/build-audit-skip.js

@@ -1,112 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Skip classification for the post-build packaging audit.
- *
- * The audit is warn-only, which makes a false positive cheap individually
- * and expensive in aggregate: an operator who learns that `Audit:` lines are
- * usually wrong stops reading the one that is right. Every classifier here
- * exists to remove a warning whose "missing packaged artifact" claim is
- * structurally impossible, and each carries its own reason so the
- * `Packaged:` summary can say what it skipped and why. This replaces a run
- * reporting `4 missing` with zero real misses.
- */
-import { readText } from '../utils/fs.js';
-import { normalizePathSlashes } from '../utils/paths.js';
-import { escapeRegex } from '../utils/regex.js';
-import { extractWithBrandingPath } from './mach-mozconfig.js';
-/** Render order for the `Packaged:` summary's per-class breakdown. */
-export const AUDIT_SKIP_REASONS = [
-    'not-packageable',
-    'platform-gated',
-    'platform-gated-ancestor',
-    'tests-not-packaged',
-    'source-unreadable',
-    'branding-not-selected',
-    'storybook-story',
-    'declared-unpackaged',
-];
-/**
- * Suffixes of Storybook story modules.
- *
- * Firefox's in-tree Storybook renders these through its own Vite config.
- * No `jar.mn` or `moz.build` entry packages one, so "no packaged artifact"
- * is the expected state rather than a missing registration. Kept as a
- * closed list on purpose: generalising to "anything with a dotted infix"
- * would swallow `*.worker.js` and `*.sys.mjs`, which are packaged.
- */
-const STORYBOOK_SUFFIXES = ['.stories.mjs', '.stories.js'];
-/** True for a Storybook story module. */
-export function isStorybookStoryPath(sourcePath) {
-    const normalised = normalizePathSlashes(sourcePath);
-    return STORYBOOK_SUFFIXES.some((suffix) => normalised.endsWith(suffix));
-}
-/** Prefix under which every branding tree lives. */
-const BRANDING_ROOT = 'browser/branding/';
-/**
- * Reads the branding directory this objdir was configured with.
- *
- * FireForge generates `engine/mozconfig` and writes the
- * `ac_add_options --with-branding=…` line into it, so the selected branding
- * is knowable from the tree. Returns undefined when the mozconfig cannot be
- * read or carries no directive. The caller must then keep warning, because
- * a skip that cannot name its evidence is a masked warning.
- *
- * @param engineDir - Absolute path to the engine root
- * @returns Engine-relative branding path, or undefined
- */
-export async function resolveSelectedBranding(engineDir) {
-    try {
-        const content = await readText(`${engineDir.replace(/[/\\]+$/, '')}/mozconfig`);
-        const selected = extractWithBrandingPath(content);
-        return selected === undefined ? undefined : normalizePathSlashes(selected).replace(/\/+$/, '');
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * True when `sourcePath` lives under a branding tree that is not the one
- * this objdir was configured with.
- *
- * An unselected branding directory is not an input to this build at all, so
- * its files can never appear in `dist/`. Worse, the basename walker matched
- * them against the selected branding's same-named artifact and reported the
- * unselected file as "newer than its packaged artifact", a stale warning
- * about a comparison that has no meaning.
- *
- * @param sourcePath - Engine-relative POSIX path
- * @param selectedBranding - Engine-relative selected branding path
- */
-export function isUnselectedBrandingPath(sourcePath, selectedBranding) {
-    if (selectedBranding === undefined)
-        return false;
-    const normalised = normalizePathSlashes(sourcePath);
-    if (!normalised.startsWith(BRANDING_ROOT))
-        return false;
-    const selected = `${selectedBranding}/`;
-    return !normalised.startsWith(selected);
-}
-/**
- * Finds the declaration admitting `sourcePath`, if any.
- *
- * Exact match or a `*`-within-one-segment glob, matching the
- * `support-files` matcher's narrowness: `**` and other cross-directory
- * shapes are not accepted, because a carve-out that silently widens is the
- * failure this feature is warned against.
- *
- * @param sourcePath - Engine-relative POSIX path
- * @param declarations - The project's `buildAudit.unpackaged` entries
- */
-export function matchUnpackagedDeclaration(sourcePath, declarations) {
-    const normalised = normalizePathSlashes(sourcePath);
-    return declarations.find((declaration) => {
-        const pattern = normalizePathSlashes(declaration.path);
-        if (!pattern.includes('*'))
-            return pattern === normalised;
-        const regex = new RegExp(`^${pattern
-            .split('*')
-            .map((part) => escapeRegex(part))
-            .join('[^/]*')}$`);
-        return regex.test(normalised);
-    });
-}

package/dist/src/core/build-audit-transforms.d.ts

@@ -1,23 +0,0 @@
-/**
- * Returns the expected chrome-tree suffix for an engine-relative POSIX
- * source path when the path falls under a known transform prefix.
- * Returns undefined otherwise.
- *
- * @param source Engine-relative POSIX source path.
- */
-export declare function expectedChromeSuffix(source: string): string | undefined;
-/**
- * Probes the dist tree for the artifact implied by a known
- * source→chrome transform. Returns the first absolute candidate whose
- * POSIX path ends with the expected chrome suffix, or undefined when
- * no transform applies or no candidate matches.
- *
- * The transform check is treated as high-confidence by `build-audit.ts`
- * (callers pass `{ registered: true }` to `evaluateArtifactMtime`), so
- * a match bypasses the structural-relation check that rejects generic
- * basename collisions.
- *
- * @param source Engine-relative POSIX source path.
- * @param searchRoots Absolute roots to probe (dist/, _tests/).
- */
-export declare function resolveArtifactByKnownTransform(source: string, searchRoots: readonly string[]): Promise<string | undefined>;

package/dist/src/core/build-audit-transforms.js

@@ -1,92 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/*
- * Known source→packaging path transforms for the post-build dist-tree audit.
- *
- * A source at `engine/browser/base/content/foo.js` ships under
- * `chrome/browser/content/browser/foo.js`. If an unrelated patch registers a
- * different `foo.js` elsewhere (say a pref file under
- * `browser/defaults/preferences/`), the basename walker surfaces both, and
- * `scoreCandidate` awards them an identical trailing-overlap score because
- * every intermediate segment is in the generic list. The heuristic then
- * declares the winner "not structurally related" and reports the
- * correctly-packaged chrome resource as missing.
- *
- * The transforms below anchor resolution to the subtree→chrome conventions
- * upstream mozilla-central jar.mn uses. A candidate whose path ends with the
- * implied chrome suffix is a confident match: the scorer never runs and the
- * structural-relation check is bypassed.
- *
- * Scope is narrow: only subtrees whose packaging target is
- * stable across forks. A fork that reroutes a known subtree can still win by
- * adding `(source)` annotations in its own `jar.mn`, which
- * `resolveArtifactByRegistration` consults first.
- */
-import { basename, sep } from 'node:path';
-import { findAllByBasename } from './build-audit-resolve.js';
-import { WIDGETS_DIR } from './furnace-constants.js';
-/**
- * Table of `prefix → chrome-suffix` transforms. Each rule names an
- * engine-relative subtree prefix and produces the expected dist-tree
- * suffix for a file under it. Rules are evaluated in array order and
- * the first-matching prefix wins, so `toolkit/content/widgets/` must
- * precede the looser `toolkit/content/`.
- */
-const KNOWN_TRANSFORMS = [
-    {
-        prefix: 'browser/base/content/',
-        build: (rest) => `chrome/browser/content/browser/${rest}`,
-    },
-    {
-        prefix: `${WIDGETS_DIR}/`,
-        build: (rest) => `chrome/toolkit/content/global/elements/${rest}`,
-    },
-    {
-        prefix: 'toolkit/content/',
-        build: (rest) => `chrome/toolkit/content/global/${rest}`,
-    },
-];
-/**
- * Returns the expected chrome-tree suffix for an engine-relative POSIX
- * source path when the path falls under a known transform prefix.
- * Returns undefined otherwise.
- *
- * @param source Engine-relative POSIX source path.
- */
-export function expectedChromeSuffix(source) {
-    for (const rule of KNOWN_TRANSFORMS) {
-        if (source.startsWith(rule.prefix)) {
-            return rule.build(source.slice(rule.prefix.length));
-        }
-    }
-    return undefined;
-}
-/**
- * Probes the dist tree for the artifact implied by a known
- * source→chrome transform. Returns the first absolute candidate whose
- * POSIX path ends with the expected chrome suffix, or undefined when
- * no transform applies or no candidate matches.
- *
- * The transform check is treated as high-confidence by `build-audit.ts`
- * (callers pass `{ registered: true }` to `evaluateArtifactMtime`), so
- * a match bypasses the structural-relation check that rejects generic
- * basename collisions.
- *
- * @param source Engine-relative POSIX source path.
- * @param searchRoots Absolute roots to probe (dist/, _tests/).
- */
-export async function resolveArtifactByKnownTransform(source, searchRoots) {
-    const suffix = expectedChromeSuffix(source);
-    if (!suffix)
-        return undefined;
-    const name = basename(source);
-    const suffixWithSlash = `/${suffix}`;
-    for (const root of searchRoots) {
-        const candidates = await findAllByBasename(root, name);
-        for (const candidate of candidates) {
-            if (candidate.split(sep).join('/').endsWith(suffixWithSlash)) {
-                return candidate;
-            }
-        }
-    }
-    return undefined;
-}