@hominis/fireforge 0.55.0 → 0.60.0

package/dist/src/core/register-browser-test.js

@@ -1,66 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Test manifest registration in browser/base/moz.build.
- */
-import { join } from 'node:path';
-import { GeneralError } from '../errors/base.js';
-import { pathExists, readText, writeText } from '../utils/fs.js';
-import { normalizePathSlashes } from '../utils/paths.js';
-import { insertMozBuildListEntry } from './moz-manifest-helpers.js';
-/**
- * Tokenizer-based implementation for test manifest registration.
- */
-function registerTestManifestTokenized(content, testDir, entry) {
-    return insertMozBuildListEntry(content, entry, {
-        listPattern: /BROWSER_CHROME_MANIFESTS/,
-        sortKey: `content/test/${testDir}/browser.toml`,
-        missingListMessage: 'Could not find BROWSER_CHROME_MANIFESTS in browser/base/moz.build',
-    });
-}
-/**
- * Registers a test manifest (browser.toml) in browser/base/moz.build.
- *
- * Entry format:
- *     "content/test/{dir}/browser.toml",
- */
-export async function registerTestManifest(engineDir, testDir, dryRun = false) {
-    const manifest = 'browser/base/moz.build';
-    const manifestPath = join(engineDir, manifest);
-    if (!(await pathExists(manifestPath))) {
-        throw new GeneralError(`Manifest not found: ${manifest}`);
-    }
-    const entry = normalizePathSlashes(`    "content/test/${testDir}/browser.toml",`);
-    const content = await readText(manifestPath);
-    // Idempotency check
-    if (content.includes(`content/test/${testDir}/browser.toml`)) {
-        return { manifest, entry, skipped: true };
-    }
-    const value = registerTestManifestTokenized(content, testDir, entry);
-    if (!dryRun) {
-        await writeText(manifestPath, value.result);
-    }
-    return { manifest, entry, previousEntry: value.previousEntry, skipped: false };
-}
-/**
- * Deregisters a test manifest (browser.toml) from browser/base/moz.build.
- * @param engineDir - Path to the engine directory
- * @param testDir - Test directory name (e.g. 'mybrowser')
- * @returns Whether the entry was removed
- */
-export async function deregisterTestManifest(engineDir, testDir) {
-    const manifest = 'browser/base/moz.build';
-    const manifestPath = join(engineDir, manifest);
-    if (!(await pathExists(manifestPath))) {
-        return false;
-    }
-    const content = await readText(manifestPath);
-    const entryPattern = `content/test/${testDir}/browser.toml`;
-    if (!content.includes(entryPattern)) {
-        return false;
-    }
-    // Remove the line containing the entry (including trailing newline)
-    const lines = content.split('\n');
-    const filtered = lines.filter((line) => !line.includes(entryPattern));
-    await writeText(manifestPath, filtered.join('\n'));
-    return true;
-}

package/dist/src/core/register-module.d.ts

@@ -1,11 +0,0 @@
-/**
- * Module registration in browser/modules/{binaryName}/moz.build.
- */
-import type { RegisterResult } from './register-result.js';
-/**
- * Registers a module in browser/modules/{binaryName}/moz.build.
- *
- * Entry format:
- *     "{name}.sys.mjs",
- */
-export declare function registerFireForgeModule(engineDir: string, fileName: string, moduleDir: string, dryRun?: boolean, createManifest?: boolean): Promise<RegisterResult>;

package/dist/src/core/register-module.js

@@ -1,56 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Module registration in browser/modules/{binaryName}/moz.build.
- */
-import { join } from 'node:path';
-import { GeneralError } from '../errors/base.js';
-import { pathExists, readText, writeText } from '../utils/fs.js';
-import { normalizePathSlashes } from '../utils/paths.js';
-import { insertMozBuildListEntry } from './moz-manifest-helpers.js';
-import { scaffoldModuleMozBuild } from './register-scaffold.js';
-/**
- * Tokenizer-based implementation for module registration.
- */
-function registerFireForgeModuleTokenized(content, fileName, entry) {
-    return insertMozBuildListEntry(content, entry, {
-        listPattern: /EXTRA_JS_MODULES/,
-        sortKey: fileName,
-        missingListMessage: 'Could not find EXTRA_JS_MODULES in moz.build',
-    });
-}
-/**
- * Registers a module in browser/modules/{binaryName}/moz.build.
- *
- * Entry format:
- *     "{name}.sys.mjs",
- */
-export async function registerFireForgeModule(engineDir, fileName, moduleDir, dryRun = false, createManifest = false) {
-    const manifest = `${moduleDir}/moz.build`;
-    const manifestPath = join(engineDir, manifest);
-    if (!(await pathExists(manifestPath))) {
-        if (createManifest) {
-            // Registering a module under a directory with no moz.build otherwise
-            // fails with "Manifest not found". Scaffold the directory manifest and
-            // wire the parent DIRS chain.
-            const scaffoldActions = await scaffoldModuleMozBuild(engineDir, moduleDir, fileName, dryRun);
-            return {
-                manifest,
-                entry: `    "${fileName}",`,
-                skipped: false,
-                scaffoldActions,
-            };
-        }
-        throw new GeneralError(`Manifest not found: ${manifest}. Pass --create-manifest to scaffold it and wire the parent DIRS entry.`);
-    }
-    const entry = normalizePathSlashes(`    "${fileName}",`);
-    const content = await readText(manifestPath);
-    // Idempotency check
-    if (content.includes(`"${fileName}"`)) {
-        return { manifest, entry, skipped: true };
-    }
-    const value = registerFireForgeModuleTokenized(content, fileName, entry);
-    if (!dryRun) {
-        await writeText(manifestPath, value.result);
-    }
-    return { manifest, entry, previousEntry: value.previousEntry, skipped: false };
-}

package/dist/src/core/register-result.d.ts

@@ -1,30 +0,0 @@
-/**
- * Shared result shape for manifest registration operations, split out of
- * the `manifest-register.ts` barrel so the `register-*` leaf modules can
- * import it without importing the barrel that re-exports them. That
- * type-only back-edge made the registration dependency graph cyclic.
- */
-/**
- * Result of a manifest registration operation.
- */
-export interface RegisterResult {
-    /** The manifest file that was modified */
-    manifest: string;
-    /** The entry that was inserted */
-    entry: string;
-    /** The entry after which the new entry was inserted (for user display) */
-    previousEntry?: string | undefined;
-    /** Whether the entry already existed (skipped) */
-    skipped: boolean;
-    /** Whether --after target was not found and fell back to alphabetical */
-    afterFallback?: boolean | undefined;
-    /**
-     * Manifests created or wired by `--create-manifest` scaffolding
-     * (directory moz.build, parent DIRS chain, XPCSHELL_TESTS_MANIFESTS),
-     * for user display.
-     */
-    scaffoldActions?: {
-        manifest: string;
-        change: string;
-    }[] | undefined;
-}

package/dist/src/core/register-result.js

@@ -1,8 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Shared result shape for manifest registration operations, split out of
- * the `manifest-register.ts` barrel so the `register-*` leaf modules can
- * import it without importing the barrel that re-exports them. That
- * type-only back-edge made the registration dependency graph cyclic.
- */
-export {};

package/dist/src/core/register-scaffold.d.ts

@@ -1,55 +0,0 @@
-/**
- * Manifest scaffolding for `fireforge register --create-manifest`.
- *
- * `register` only inserts into EXISTING manifests, so registering a module
- * under a directory with no moz.build fails with "Manifest not found". This
- * module owns the two scaffolding primitives:
- *
- *  - creating a directory `moz.build` (license header + the requested list
- *    directive) and wiring the parent chain's `DIRS` entries up to the
- *    nearest existing moz.build.
- *  - wiring an `XPCSHELL_TESTS_MANIFESTS` entry for a (possibly freshly
- *    created) `xpcshell.toml` into the nearest existing moz.build.
- *
- * All writers reuse the tokenizer + alphabetical-position helpers the
- * existing register writers use, so inserted entries respect mozbuild's
- * case-insensitive StrictOrderingOnAppendList rule.
- */
-/** One manifest mutation performed (or planned, on dry-run) by a scaffold. */
-export interface ScaffoldAction {
-    /** Engine-relative manifest path that was created or modified. */
-    manifest: string;
-    /** Human-readable description of the change. */
-    change: string;
-}
-/**
- * Inserts `value` into the named moz.build list directive, creating the
- * `NAME += [ ... ]` block at the end of the file when the directive does
- * not exist yet. Returns the updated content, or null when the value is
- * already present.
- */
-export declare function upsertMozBuildListEntry(content: string, directive: string, value: string): string | null;
-/**
- * Ensures every parent directory between `childRelDir` and the nearest
- * existing moz.build carries a `DIRS` entry pointing at the next segment
- * down, creating intermediate moz.build files as needed. Walks upward
- * from the child's parent. Throws when no moz.build exists anywhere up
- * to the engine root (an engine checkout always has one at the root, so
- * this indicates a bogus path).
- */
-export declare function ensureParentDirsWiring(engineDir: string, childRelDir: string, dryRun: boolean): Promise<ScaffoldAction[]>;
-/**
- * Creates `<moduleDir>/moz.build` with an `EXTRA_JS_MODULES.<namespace>`
- * list containing `fileName`, and wires the parent DIRS chain. The
- * namespace is the module directory's basename (the fork's binary name
- * for `browser/modules/<binaryName>/`), matching Firefox's convention of
- * mapping `EXTRA_JS_MODULES.<ns>` into `resource:///modules/<ns>/`.
- */
-export declare function scaffoldModuleMozBuild(engineDir: string, moduleDir: string, fileName: string, dryRun: boolean): Promise<ScaffoldAction[]>;
-/**
- * Wires an `XPCSHELL_TESTS_MANIFESTS` entry for `manifestRelPath` (an
- * engine-relative `.../xpcshell.toml`) into the nearest EXISTING
- * moz.build above it. Returns the performed actions (empty when the
- * entry already exists).
- */
-export declare function ensureXpcshellManifestWiring(engineDir: string, manifestRelPath: string, dryRun: boolean): Promise<ScaffoldAction[]>;

package/dist/src/core/register-scaffold.js

@@ -1,146 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Manifest scaffolding for `fireforge register --create-manifest`.
- *
- * `register` only inserts into EXISTING manifests, so registering a module
- * under a directory with no moz.build fails with "Manifest not found". This
- * module owns the two scaffolding primitives:
- *
- *  - creating a directory `moz.build` (license header + the requested list
- *    directive) and wiring the parent chain's `DIRS` entries up to the
- *    nearest existing moz.build.
- *  - wiring an `XPCSHELL_TESTS_MANIFESTS` entry for a (possibly freshly
- *    created) `xpcshell.toml` into the nearest existing moz.build.
- *
- * All writers reuse the tokenizer + alphabetical-position helpers the
- * existing register writers use, so inserted entries respect mozbuild's
- * case-insensitive StrictOrderingOnAppendList rule.
- */
-import { dirname, join } from 'node:path';
-import { GeneralError } from '../errors/base.js';
-import { pathExists, readText, writeText } from '../utils/fs.js';
-import { normalizePathSlashes } from '../utils/paths.js';
-import { getLicenseHeader } from './license-headers.js';
-import { findAlphabeticalMozBuildPosition } from './moz-manifest-helpers.js';
-import { tokenizeMozBuildList } from './moz-manifest-tokenizers.js';
-/**
- * moz.build files use Firefox's canonical MPL-2.0 hash-comment header
- * regardless of the fork's own project license. They live in the engine
- * tree among upstream MPL files.
- */
-function mozBuildHeader() {
-    return getLicenseHeader('MPL-2.0', 'hash');
-}
-/**
- * Inserts `value` into the named moz.build list directive, creating the
- * `NAME += [ ... ]` block at the end of the file when the directive does
- * not exist yet. Returns the updated content, or null when the value is
- * already present.
- */
-export function upsertMozBuildListEntry(content, directive, value) {
-    if (content.includes(`"${value}"`))
-        return null;
-    const lines = content.split('\n');
-    const listResult = tokenizeMozBuildList(lines, new RegExp(`^${directive}\\b`));
-    if (listResult) {
-        const { insertIndex } = findAlphabeticalMozBuildPosition(listResult.tokens, value);
-        lines.splice(insertIndex, 0, `    "${value}",`);
-        return lines.join('\n');
-    }
-    // No existing list: append a fresh block, keeping exactly one blank
-    // line between the previous content and the new directive.
-    while (lines.length > 0 && (lines.at(-1) ?? '').trim() === '')
-        lines.pop();
-    const block = [`${directive} += [`, `    "${value}",`, `]`];
-    return [...lines, ...(lines.length > 0 ? [''] : []), ...block, ''].join('\n');
-}
-/**
- * Ensures every parent directory between `childRelDir` and the nearest
- * existing moz.build carries a `DIRS` entry pointing at the next segment
- * down, creating intermediate moz.build files as needed. Walks upward
- * from the child's parent. Throws when no moz.build exists anywhere up
- * to the engine root (an engine checkout always has one at the root, so
- * this indicates a bogus path).
- */
-export async function ensureParentDirsWiring(engineDir, childRelDir, dryRun) {
-    const actions = [];
-    let childName = childRelDir.split('/').at(-1) ?? childRelDir;
-    let parentRel = normalizePathSlashes(dirname(childRelDir));
-    for (;;) {
-        if (parentRel === '.' || parentRel === '' || parentRel === '/') {
-            throw new GeneralError(`No moz.build found in any parent of ${childRelDir} up to the engine root; ` +
-                'cannot wire the DIRS chain. Check the path.');
-        }
-        const parentManifestRel = `${parentRel}/moz.build`;
-        const parentManifestPath = join(engineDir, parentManifestRel);
-        if (await pathExists(parentManifestPath)) {
-            const content = await readText(parentManifestPath);
-            const updated = upsertMozBuildListEntry(content, 'DIRS', childName);
-            if (updated !== null) {
-                if (!dryRun)
-                    await writeText(parentManifestPath, updated);
-                actions.push({ manifest: parentManifestRel, change: `DIRS += ["${childName}"]` });
-            }
-            return actions;
-        }
-        // Parent has no moz.build either: scaffold one carrying the DIRS
-        // entry and keep walking up until an existing manifest anchors the
-        // chain.
-        const scaffold = `${mozBuildHeader()}\n\nDIRS += [\n    "${childName}",\n]\n`;
-        if (!dryRun)
-            await writeText(parentManifestPath, scaffold);
-        actions.push({ manifest: parentManifestRel, change: `created with DIRS += ["${childName}"]` });
-        childName = parentRel.split('/').at(-1) ?? parentRel;
-        parentRel = normalizePathSlashes(dirname(parentRel));
-    }
-}
-/**
- * Creates `<moduleDir>/moz.build` with an `EXTRA_JS_MODULES.<namespace>`
- * list containing `fileName`, and wires the parent DIRS chain. The
- * namespace is the module directory's basename (the fork's binary name
- * for `browser/modules/<binaryName>/`), matching Firefox's convention of
- * mapping `EXTRA_JS_MODULES.<ns>` into `resource:///modules/<ns>/`.
- */
-export async function scaffoldModuleMozBuild(engineDir, moduleDir, fileName, dryRun) {
-    const namespace = moduleDir.split('/').at(-1) ?? moduleDir;
-    const manifestRel = `${moduleDir}/moz.build`;
-    const content = `${mozBuildHeader()}\n\nEXTRA_JS_MODULES.${namespace} += [\n    "${fileName}",\n]\n`;
-    if (!dryRun)
-        await writeText(join(engineDir, manifestRel), content);
-    const actions = [
-        {
-            manifest: manifestRel,
-            change: `created with EXTRA_JS_MODULES.${namespace} += ["${fileName}"]`,
-        },
-    ];
-    actions.push(...(await ensureParentDirsWiring(engineDir, moduleDir, dryRun)));
-    return actions;
-}
-/**
- * Wires an `XPCSHELL_TESTS_MANIFESTS` entry for `manifestRelPath` (an
- * engine-relative `.../xpcshell.toml`) into the nearest EXISTING
- * moz.build above it. Returns the performed actions (empty when the
- * entry already exists).
- */
-export async function ensureXpcshellManifestWiring(engineDir, manifestRelPath, dryRun) {
-    let dirRel = normalizePathSlashes(dirname(manifestRelPath));
-    for (;;) {
-        if (dirRel === '.' || dirRel === '' || dirRel === '/') {
-            throw new GeneralError(`No moz.build found in any parent of ${manifestRelPath} up to the engine root; ` +
-                'cannot wire XPCSHELL_TESTS_MANIFESTS. Check the path.');
-        }
-        const mozBuildRel = `${dirRel}/moz.build`;
-        const mozBuildPath = join(engineDir, mozBuildRel);
-        if (await pathExists(mozBuildPath)) {
-            const relEntry = manifestRelPath.slice(dirRel.length + 1);
-            const content = await readText(mozBuildPath);
-            const updated = upsertMozBuildListEntry(content, 'XPCSHELL_TESTS_MANIFESTS', relEntry);
-            if (updated === null)
-                return [];
-            if (!dryRun)
-                await writeText(mozBuildPath, updated);
-            return [{ manifest: mozBuildRel, change: `XPCSHELL_TESTS_MANIFESTS += ["${relEntry}"]` }];
-        }
-        dirRel = normalizePathSlashes(dirname(dirRel));
-    }
-}

package/dist/src/core/register-shared-css.d.ts

@@ -1,36 +0,0 @@
-/**
- * CSS registration in browser/themes/shared/jar.inc.mn.
- */
-import type { RegisterResult } from './register-result.js';
-/**
- * Measures the column at which the `(source)` parenthesis opens in adjacent
- * `skin/classic/browser/<x>.css (...)` entries inside an existing
- * jar.inc.mn body, and returns the maximum so a newly inserted entry can
- * align its source column to match.
- *
- * A fixed four-space gap regardless of the surrounding alignment lands a
- * freshly registered file at the wrong column and produces avoidable
- * formatting churn, since adjacent Firefox entries are typically padded to a
- * wider column. Returns `undefined` when no existing entries provide an
- * alignment signal. Callers fall back to the four-space default.
- */
-export declare function measureSourceColumn(content: string): number | undefined;
-/**
- * Builds a `skin/classic/browser/<name>.css   (../shared/<name>.css)`
- * line padded so the parenthesis lands at {@link sourceColumn} (when
- * supplied) or at the default four-space gap (when {@link sourceColumn}
- * is `undefined` or would force the parenthesis closer to the target
- * than {@link MIN_SOURCE_GAP}).
- */
-export declare function buildEntry(name: string, sourceColumn: number | undefined): string;
-/**
- * Registers a CSS file in browser/themes/shared/jar.inc.mn.
- *
- * Entry format:
- *   skin/classic/browser/{name}.css    (../shared/{name}.css)
- *
- * The gap between target and source is sized to align with adjacent
- * entries when the manifest already uses a wider column. It falls back
- * to a four-space minimum otherwise.
- */
-export declare function registerSharedCSS(engineDir: string, fileName: string, after?: string, dryRun?: boolean): Promise<RegisterResult>;

package/dist/src/core/register-shared-css.js

@@ -1,112 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * CSS registration in browser/themes/shared/jar.inc.mn.
- */
-import { basename, join } from 'node:path';
-import { GeneralError } from '../errors/base.js';
-import { pathExists, readText, writeText } from '../utils/fs.js';
-import { normalizePathSlashes } from '../utils/paths.js';
-import { insertJarMnEntry } from './moz-manifest-helpers.js';
-/**
- * Tokenizer-based implementation for shared CSS registration.
- */
-function registerSharedCSSTokenized(content, name, entry, after) {
-    return insertJarMnEntry(content, entry, {
-        sortPattern: /skin\/classic\/browser\/([^.]+)\.css/,
-        sortKey: name,
-        missingSectionMessage: 'Could not find skin/classic/browser/ section in jar.inc.mn',
-        after,
-    });
-}
-/** Minimum gap between the target path and the source parenthesis. */
-const MIN_SOURCE_GAP = 4;
-/**
- * Measures the column at which the `(source)` parenthesis opens in adjacent
- * `skin/classic/browser/<x>.css (...)` entries inside an existing
- * jar.inc.mn body, and returns the maximum so a newly inserted entry can
- * align its source column to match.
- *
- * A fixed four-space gap regardless of the surrounding alignment lands a
- * freshly registered file at the wrong column and produces avoidable
- * formatting churn, since adjacent Firefox entries are typically padded to a
- * wider column. Returns `undefined` when no existing entries provide an
- * alignment signal. Callers fall back to the four-space default.
- */
-export function measureSourceColumn(content) {
-    const lines = content.split('\n');
-    let maxColumn = 0;
-    let sampled = 0;
-    // The regex guarantees `(` appears in the matched line, so the index
-    // lookup below is always >= 0. The `match` body's leading-whitespace
-    // and target-path captures are likewise guaranteed by the pattern, so
-    // we can take the literal `match[0]` (full match) length minus one to
-    // locate the `(` column without a fragile per-group lookup.
-    const lineRe = /^\s*skin\/classic\/browser\/[^\s()]+\s+\(/;
-    for (const line of lines) {
-        const match = lineRe.exec(line);
-        if (!match)
-            continue;
-        const parenIndex = match[0].length - 1;
-        if (parenIndex > maxColumn)
-            maxColumn = parenIndex;
-        sampled++;
-    }
-    return sampled > 0 ? maxColumn : undefined;
-}
-/**
- * Builds a `skin/classic/browser/<name>.css   (../shared/<name>.css)`
- * line padded so the parenthesis lands at {@link sourceColumn} (when
- * supplied) or at the default four-space gap (when {@link sourceColumn}
- * is `undefined` or would force the parenthesis closer to the target
- * than {@link MIN_SOURCE_GAP}).
- */
-export function buildEntry(name, sourceColumn) {
-    const indent = '  ';
-    const target = `${indent}skin/classic/browser/${name}.css`;
-    const minColumn = target.length + MIN_SOURCE_GAP;
-    const column = sourceColumn !== undefined && sourceColumn >= minColumn ? sourceColumn : minColumn;
-    const padding = ' '.repeat(column - target.length);
-    return normalizePathSlashes(`${target}${padding}(../shared/${name}.css)`);
-}
-/**
- * Registers a CSS file in browser/themes/shared/jar.inc.mn.
- *
- * Entry format:
- *   skin/classic/browser/{name}.css    (../shared/{name}.css)
- *
- * The gap between target and source is sized to align with adjacent
- * entries when the manifest already uses a wider column. It falls back
- * to a four-space minimum otherwise.
- */
-export async function registerSharedCSS(engineDir, fileName, after, dryRun = false) {
-    const manifest = 'browser/themes/shared/jar.inc.mn';
-    const manifestPath = join(engineDir, manifest);
-    if (!(await pathExists(manifestPath))) {
-        throw new GeneralError(`Manifest not found: ${manifest}`);
-    }
-    const name = basename(fileName, '.css');
-    const content = await readText(manifestPath);
-    const sourceColumn = measureSourceColumn(content);
-    const entry = buildEntry(name, sourceColumn);
-    // Idempotency check. `furnace chrome-doc create` writes its CSS as a
-    // `content/browser/<name>.css` entry rather than the canonical
-    // `skin/classic/browser/<name>.css` form `register` produces. Recognise
-    // both shapes so a follow-up `register` invocation against an
-    // already-chrome-doc-registered file reports `skipped` instead of
-    // appending a duplicate `skin/classic/browser/...` row.
-    if (content.includes(`skin/classic/browser/${name}.css`) ||
-        content.includes(`content/browser/${name}.css`)) {
-        return { manifest, entry, skipped: true };
-    }
-    const value = registerSharedCSSTokenized(content, name, entry, after);
-    if (!dryRun) {
-        await writeText(manifestPath, value.result);
-    }
-    return {
-        manifest,
-        entry,
-        previousEntry: value.previousEntry,
-        skipped: false,
-        afterFallback: value.afterFallback,
-    };
-}

package/dist/src/core/register-xpcshell-test.d.ts

@@ -1,50 +0,0 @@
-/**
- * xpcshell test-file registration. Without it, xpcshell test files (e.g.
- * `<module-dir>/test/unit/test_*.js`) are rejected by `fireforge register`
- * as "Unknown file pattern". This writer inserts the `["test_*.js"]` section
- * into the directory's `xpcshell.toml` (alphabetically or after the
- * `--after` entry, idempotently). With
- * `--create-manifest` it also creates the manifest and wires
- * `XPCSHELL_TESTS_MANIFESTS` into the nearest moz.build.
- */
-import type { RegisterResult } from './register-result.js';
-/**
- * Checks whether the test file is listed in its directory's
- * `xpcshell.toml`. Throws a "Manifest not found" error when the manifest
- * does not exist (status catches that prefix and reports the manifest as
- * missing rather than the file as unregistered).
- */
-export declare function isXpcshellTestRegistered(engineDir: string, dirRel: string, fileName: string): Promise<boolean>;
-/** Where a new section goes and what placed it there. */
-export interface XpcshellSectionPlacement {
-    /** The manifest content with the section inserted. */
-    content: string;
-    /** The `["…"]` header of the `--after` entry the section follows. */
-    previousEntry?: string | undefined;
-    /** `--after` named no entry, so the section went in sort order. */
-    afterFallback?: boolean | undefined;
-}
-/**
- * Places the `["<fileName>"]` section in the manifest content.
- *
- * Without `after`, the section goes in mozbuild's case-insensitive sort
- * order relative to the other test sections. With `after`, it goes right
- * after the named entry's whole block (its keys included). Either way it
- * is inserted ahead of the `#` comment lines that introduce the next
- * entry, never between a comment and its entry, keeping one
- * blank line between sections.
- */
-export declare function placeXpcshellManifestSection(content: string, fileName: string, after?: string): XpcshellSectionPlacement;
-/**
- * Inserts the `["<fileName>"]` section into the manifest content; see
- * {@link placeXpcshellManifestSection}. Exported for direct unit testing.
- *
- * @internal
- */
-export declare function insertXpcshellManifestSection(content: string, fileName: string, after?: string): string;
-/**
- * Registers an xpcshell test file in its directory's `xpcshell.toml`.
- * With `createManifest`, a missing manifest is scaffolded and wired into
- * the nearest moz.build via `XPCSHELL_TESTS_MANIFESTS`.
- */
-export declare function registerXpcshellTest(engineDir: string, dirRel: string, fileName: string, dryRun?: boolean, createManifest?: boolean, after?: string): Promise<RegisterResult>;