@electron-stagewright/plugin-budget 0.0.0-stage → 0.2.0

package/dist/cli.js

@@ -0,0 +1,464 @@
+#!/usr/bin/env node
+/**
+ * `electron-stagewright-budget`: the CI face of the budget plugin.
+ *
+ * Exit codes: 0 within budget, 1 over budget or nothing measured, 2 usage, unreadable input, or any
+ * other error.
+ *
+ * @module
+ */
+import { realpathSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { BudgetFileError, PHASES, loadBudget } from './budget.js';
+import { measureBundle } from './bundle.js';
+import { checkRun } from './check.js';
+import { DEFAULT_ROUNDS, measureApp, } from './measure.js';
+import { compareRuns, renderCheckReport, renderComparison } from './render.js';
+import { RunFileError, createRun, loadRun, mergeRuns } from './run.js';
+export const BUDGET_EXIT_CODES = { SUCCESS: 0, OVER_BUDGET: 1, USAGE: 2 };
+const PROCESS_IO = {
+    stdout: (text) => process.stdout.write(text),
+    stderr: (text) => process.stderr.write(text),
+};
+class UsageError extends Error {
+}
+export function formatBudgetCliHelp() {
+    return [
+        'Usage:',
+        '  electron-stagewright-budget measure (--main <main.js> | --executable <path>) [--arg <v>]...',
+        '                              [--env K=V]... [--budget <file>] [--rounds 3]',
+        '                              [--phases cold,warm] [--settle-ms 3000] [--window-ms 2000]',
+        '                              [--workload <script.mjs> [--workload-timeout-ms 120000]]',
+        '                              [--before-round <script.mjs>] [--skip-failed-rounds]',
+        '                              [--memory-sample-ms 1000]',
+        '                              [--label <text>] [--out <run.json>] [--json]',
+        '                              [--check [--no-tolerance] [--require-measurement]',
+        '                              [--phase cold|warm] [--min-samples N]]',
+        '  electron-stagewright-budget check <run.json>... --budget <file> [--no-tolerance]',
+        '                              [--require-measurement] [--phase cold|warm|live]',
+        '                              [--min-samples N] [--json]',
+        '  electron-stagewright-budget compare <before.json> <after.json> [--json]',
+        '  electron-stagewright-budget bundle --budget <file> [--root <dir>] [--out <run.json>]',
+        '                              [--no-tolerance] [--json]',
+        '',
+        'measure   Launch the app on a throwaway profile and measure cold and warm rounds.',
+        '          --workload is an ES module whose default export, async ({ dispatch, sessionId,',
+        '          phase }), drives the app inside the measurement window. Without --out or',
+        '          --check the run document goes to stdout. --phase reads every metric from',
+        '          that phase; a metric whose phase was not measured is unmeasured.',
+        '          --before-round is an ES module whose default export, async ({ round, profile }),',
+        '          prepares each round and may return { env, args } for its launches.',
+        '          --memory-sample-ms samples memory during the window for a peak; a budget whose',
+        '          memory aggregate is peak turns it on.',
+        'check     Compare measured runs to a budget file; several runs are merged first.',
+        'compare   Print a before/after table of two runs.',
+        'bundle    Measure the bundle entries of a budget and gate them; needs no Electron.',
+        '',
+        '--no-tolerance         Ignore thresholdPercent; the limit itself gates.',
+        '                       (--strict is a deprecated alias.)',
+        '--require-measurement  Fail when a budgeted metric was not measured.',
+        '--min-samples N        A runtime metric needs N measured rounds, or it is unmeasured.',
+        '',
+        'Exit codes: 0 within budget, 1 over budget or nothing measured,',
+        '            2 usage, unreadable input, or any other error.',
+    ].join('\n');
+}
+function positiveInt(flag, value, min = 1) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < min) {
+        throw new UsageError(`${flag} expects an integer of at least ${min}`);
+    }
+    return parsed;
+}
+function parseMeasureArgs(rest) {
+    const single = new Map();
+    const args = [];
+    const env = {};
+    const flags = new Set();
+    const valueFlags = [
+        '--main',
+        '--executable',
+        '--budget',
+        '--rounds',
+        '--phases',
+        '--settle-ms',
+        '--window-ms',
+        '--workload',
+        '--workload-timeout-ms',
+        '--before-round',
+        '--memory-sample-ms',
+        '--min-samples',
+        '--phase',
+        '--label',
+        '--out',
+    ];
+    const booleanFlags = [
+        '--check',
+        '--no-tolerance',
+        '--strict',
+        '--require-measurement',
+        '--skip-failed-rounds',
+        '--json',
+    ];
+    for (let index = 0; index < rest.length; index += 1) {
+        const token = rest[index];
+        // Scanned here, not over all of argv, so `--arg --help` is forwarded to the app.
+        if (token === '--help' || token === '-h')
+            return { command: 'help' };
+        if (booleanFlags.includes(token)) {
+            flags.add(token);
+            continue;
+        }
+        if (token !== '--arg' && token !== '--env' && !valueFlags.includes(token)) {
+            throw new UsageError(`Unknown option for measure: ${token}`);
+        }
+        const value = rest[index + 1];
+        // --arg forwards anything, including empty values and values that start with dashes.
+        if (value === undefined ||
+            (token !== '--arg' && (value.length === 0 || value.startsWith('--')))) {
+            throw new UsageError(`${token} expects a value`);
+        }
+        index += 1;
+        if (token === '--arg') {
+            args.push(value);
+        }
+        else if (token === '--env') {
+            const separator = value.indexOf('=');
+            if (separator <= 0)
+                throw new UsageError('--env expects KEY=VALUE');
+            env[value.slice(0, separator)] = value.slice(separator + 1);
+        }
+        else {
+            if (single.has(token))
+                throw new UsageError(`${token} may be given only once`);
+            single.set(token, value);
+        }
+    }
+    const main = single.get('--main');
+    const executablePath = single.get('--executable');
+    if (main === undefined && executablePath === undefined) {
+        throw new UsageError('measure requires --main <main.js> or --executable <path>');
+    }
+    const phases = [
+        ...new Set((single.get('--phases') ?? 'cold,warm').split(',').map((phase) => phase.trim())),
+    ];
+    if (phases.some((phase) => phase !== 'cold' && phase !== 'warm')) {
+        throw new UsageError('--phases expects cold, warm, or cold,warm');
+    }
+    const phase = single.get('--phase');
+    if (phase !== undefined && !phases.includes(phase)) {
+        throw new UsageError('--phase must name a measured phase: cold or warm');
+    }
+    const check = flags.has('--check');
+    const budgetPath = single.get('--budget');
+    if (check && budgetPath === undefined)
+        throw new UsageError('--check requires --budget <file>');
+    const noTolerance = flags.has('--no-tolerance') || flags.has('--strict');
+    if (!check &&
+        (noTolerance || flags.has('--require-measurement') || phase || single.has('--min-samples'))) {
+        throw new UsageError('--no-tolerance, --require-measurement, --min-samples, and --phase apply only with --check');
+    }
+    const optional = (key, value) => value === undefined ? {} : { [key]: value };
+    const number = (flag, min) => {
+        const value = single.get(flag);
+        return value === undefined ? undefined : positiveInt(flag, value, min);
+    };
+    const rounds = number('--rounds', 1) ?? DEFAULT_ROUNDS;
+    const minSamples = number('--min-samples', 1);
+    if (minSamples !== undefined && minSamples > rounds) {
+        throw new UsageError(`--min-samples ${minSamples} can never be met by --rounds ${rounds}`);
+    }
+    return {
+        command: 'measure',
+        ...optional('main', main === undefined ? undefined : path.resolve(main)),
+        ...optional('executablePath', executablePath === undefined ? undefined : path.resolve(executablePath)),
+        args,
+        env,
+        ...optional('budgetPath', budgetPath),
+        rounds,
+        phases: phases,
+        ...optional('settleMs', number('--settle-ms', 0)),
+        ...optional('windowMs', number('--window-ms', 250)),
+        ...optional('workloadPath', single.get('--workload')),
+        ...optional('workloadTimeoutMs', number('--workload-timeout-ms', 1000)),
+        ...optional('beforeRoundPath', single.get('--before-round')),
+        ...optional('memorySampleMs', number('--memory-sample-ms', 100)),
+        skipFailedRounds: flags.has('--skip-failed-rounds'),
+        ...optional('minSamples', minSamples),
+        ...optional('phase', phase),
+        ...optional('label', single.get('--label')),
+        ...optional('outPath', single.get('--out')),
+        check,
+        noTolerance,
+        requireMeasurement: flags.has('--require-measurement'),
+        json: flags.has('--json'),
+        ...(flags.has('--strict') ? { deprecatedStrict: true } : {}),
+    };
+}
+/** Strict parser: an unknown flag or a missing value is a usage error. */
+export function parseBudgetCliArgs(argv) {
+    const [command, ...rest] = argv;
+    if (command === undefined || command === 'help' || command === '--help' || command === '-h') {
+        if (command === undefined)
+            throw new UsageError('Expected a subcommand: measure, check, compare, bundle');
+        return { command: 'help' };
+    }
+    if (command === 'measure')
+        return parseMeasureArgs(rest);
+    if (command !== 'check' && command !== 'compare' && command !== 'bundle') {
+        throw new UsageError(`Unknown subcommand: ${command}`);
+    }
+    if (rest.includes('--help') || rest.includes('-h'))
+        return { command: 'help' };
+    const valueFlags = {
+        check: ['--budget', '--phase', '--min-samples'],
+        compare: [],
+        bundle: ['--budget', '--root', '--out'],
+    };
+    const booleanFlags = {
+        check: ['--no-tolerance', '--strict', '--require-measurement', '--json'],
+        compare: ['--json'],
+        bundle: ['--no-tolerance', '--strict', '--json'],
+    };
+    const values = new Map();
+    const flags = new Set();
+    const positional = [];
+    for (let index = 0; index < rest.length; index += 1) {
+        const token = rest[index];
+        if (valueFlags[command].includes(token)) {
+            const value = rest[index + 1];
+            if (value === undefined || value.length === 0 || value.startsWith('--')) {
+                throw new UsageError(`${token} expects a value`);
+            }
+            values.set(token, value);
+            index += 1;
+        }
+        else if (booleanFlags[command].includes(token)) {
+            flags.add(token);
+        }
+        else if (token.startsWith('-')) {
+            throw new UsageError(`Unknown option for ${command}: ${token}`);
+        }
+        else {
+            positional.push(token);
+        }
+    }
+    const requireBudget = () => {
+        const budgetPath = values.get('--budget');
+        if (budgetPath === undefined)
+            throw new UsageError(`${command} requires --budget <file>`);
+        return budgetPath;
+    };
+    const json = flags.has('--json');
+    const noTolerance = flags.has('--no-tolerance') || flags.has('--strict');
+    const deprecatedStrict = flags.has('--strict') ? { deprecatedStrict: true } : {};
+    if (command === 'compare') {
+        const [beforePath, afterPath, extra] = positional;
+        if (beforePath === undefined || afterPath === undefined || extra !== undefined) {
+            throw new UsageError('compare expects exactly two run files');
+        }
+        return { command, beforePath, afterPath, json };
+    }
+    if (command === 'bundle') {
+        if (positional.length > 0)
+            throw new UsageError(`Unexpected argument: ${positional[0]}`);
+        const root = values.get('--root');
+        const outPath = values.get('--out');
+        return {
+            command,
+            budgetPath: requireBudget(),
+            ...(root === undefined ? {} : { root }),
+            ...(outPath === undefined ? {} : { outPath }),
+            noTolerance,
+            json,
+            ...deprecatedStrict,
+        };
+    }
+    if (positional.length === 0)
+        throw new UsageError('check expects at least one run file');
+    if (new Set(positional.map((file) => path.resolve(file))).size !== positional.length) {
+        throw new UsageError('check lists the same run file twice');
+    }
+    const minSamples = values.get('--min-samples');
+    const phase = values.get('--phase');
+    if (phase !== undefined && !PHASES.includes(phase)) {
+        throw new UsageError(`--phase expects one of ${PHASES.join(', ')}`);
+    }
+    return {
+        command,
+        runPaths: positional,
+        budgetPath: requireBudget(),
+        ...(minSamples === undefined ? {} : { minSamples: positiveInt('--min-samples', minSamples) }),
+        noTolerance,
+        requireMeasurement: flags.has('--require-measurement'),
+        ...(phase === undefined ? {} : { phase: phase }),
+        json,
+        ...deprecatedStrict,
+    };
+}
+function emitReport(report, json, io) {
+    io.stdout(`${json ? JSON.stringify(report) : renderCheckReport(report)}\n`);
+    return report.passed ? BUDGET_EXIT_CODES.SUCCESS : BUDGET_EXIT_CODES.OVER_BUDGET;
+}
+async function writeRun(outPath, run) {
+    await mkdir(path.dirname(path.resolve(outPath)), { recursive: true });
+    await writeFile(outPath, `${JSON.stringify(run, null, 2)}\n`);
+}
+async function loadScript(what, scriptPath) {
+    let module;
+    try {
+        module = (await import(pathToFileURL(path.resolve(scriptPath)).href));
+    }
+    catch (error) {
+        throw new UsageError(`Cannot load ${what} ${scriptPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (typeof module.default !== 'function') {
+        throw new UsageError(`${what} ${scriptPath} must default-export an async function`);
+    }
+    return module.default;
+}
+async function runMeasure(options, io, deps) {
+    const budget = options.budgetPath === undefined ? undefined : await loadBudget(options.budgetPath);
+    const workload = options.workloadPath === undefined
+        ? undefined
+        : await loadScript('workload', options.workloadPath);
+    const beforeRound = options.beforeRoundPath === undefined
+        ? undefined
+        : await loadScript('before-round script', options.beforeRoundPath);
+    let run = await deps.measureApp({
+        launch: {
+            ...(options.main === undefined ? {} : { main: options.main }),
+            ...(options.executablePath === undefined ? {} : { executablePath: options.executablePath }),
+            args: options.args,
+            env: options.env,
+        },
+        rounds: options.rounds,
+        phases: options.phases,
+        ...(options.settleMs === undefined ? {} : { settleMs: options.settleMs }),
+        ...(options.windowMs === undefined ? {} : { windowMs: options.windowMs }),
+        ...(budget === undefined ? {} : { budget }),
+        ...(workload === undefined ? {} : { workload }),
+        ...(options.workloadTimeoutMs === undefined
+            ? {}
+            : { workloadTimeoutMs: options.workloadTimeoutMs }),
+        ...(options.label === undefined ? {} : { label: options.label }),
+        ...(beforeRound === undefined ? {} : { beforeRound }),
+        ...(options.memorySampleMs === undefined ? {} : { memorySampleMs: options.memorySampleMs }),
+        ...(options.skipFailedRounds ? { failedRounds: 'skip' } : {}),
+        onProgress: (message) => io.stderr(`${message}\n`),
+    });
+    // A run with no round would later read as "nothing over budget"; never write one.
+    if (run.rounds.length === 0) {
+        io.stderr('No round produced a measurement; no run was written.\n');
+        return BUDGET_EXIT_CODES.OVER_BUDGET;
+    }
+    if (budget?.bundle !== undefined && options.budgetPath !== undefined) {
+        const root = path.dirname(path.resolve(options.budgetPath));
+        run = { ...run, bundle: await measureBundle(root, budget.bundle.entries) };
+    }
+    if (options.outPath !== undefined)
+        await writeRun(options.outPath, run);
+    if (options.check && budget !== undefined) {
+        const report = checkRun(run, budget, {
+            ignoreThreshold: options.noTolerance,
+            requireMeasurement: options.requireMeasurement,
+            ...(options.phase === undefined ? {} : { phase: options.phase }),
+            ...(options.minSamples === undefined ? {} : { minSamples: options.minSamples }),
+        });
+        return emitReport(report, options.json, io);
+    }
+    if (options.outPath === undefined)
+        io.stdout(`${JSON.stringify(run, null, 2)}\n`);
+    else
+        io.stderr(`Wrote ${options.outPath}\n`);
+    return BUDGET_EXIT_CODES.SUCCESS;
+}
+/** Execute already-parsed options. Throws the typed file errors; the caller maps them to exit 2. */
+export async function runBudgetCli(options, io = PROCESS_IO, deps = { measureApp }) {
+    if (options.command === 'help') {
+        io.stdout(`${formatBudgetCliHelp()}\n`);
+        return BUDGET_EXIT_CODES.SUCCESS;
+    }
+    if ('deprecatedStrict' in options && options.deprecatedStrict) {
+        io.stderr('--strict is deprecated: it drops thresholdPercent and never meant "fail instead of warn". Use --no-tolerance.\n');
+    }
+    if (options.command === 'measure')
+        return runMeasure(options, io, deps);
+    if (options.command === 'compare') {
+        const rows = compareRuns(await loadRun(options.beforePath), await loadRun(options.afterPath));
+        if (rows.length === 0) {
+            io.stderr('Neither run holds a measurement; nothing to compare.\n');
+            return BUDGET_EXIT_CODES.OVER_BUDGET;
+        }
+        io.stdout(`${options.json ? JSON.stringify({ rows }) : renderComparison(rows)}\n`);
+        return BUDGET_EXIT_CODES.SUCCESS;
+    }
+    const budget = await loadBudget(options.budgetPath);
+    if (options.command === 'check') {
+        const runs = await Promise.all(options.runPaths.map((runPath) => loadRun(runPath)));
+        let run;
+        try {
+            run = mergeRuns(runs);
+        }
+        catch (error) {
+            throw new UsageError(error instanceof Error ? error.message : String(error));
+        }
+        const report = checkRun(run, budget, {
+            ignoreThreshold: options.noTolerance,
+            requireMeasurement: options.requireMeasurement,
+            ...(options.phase === undefined ? {} : { phase: options.phase }),
+            ...(options.minSamples === undefined ? {} : { minSamples: options.minSamples }),
+        });
+        return emitReport(report, options.json, io);
+    }
+    if (budget.bundle === undefined) {
+        throw new UsageError(`${options.budgetPath} has no "bundle" section to measure`);
+    }
+    const root = path.resolve(options.root ?? path.dirname(options.budgetPath));
+    const run = createRun({ rounds: [], bundle: await measureBundle(root, budget.bundle.entries) });
+    if (options.outPath !== undefined)
+        await writeRun(options.outPath, run);
+    const bundleOnly = {
+        ...(budget.thresholdPercent === undefined ? {} : { thresholdPercent: budget.thresholdPercent }),
+        bundle: budget.bundle,
+    };
+    // Every entry was asked for by name here, so one that matched nothing fails the command.
+    const report = checkRun(run, bundleOnly, {
+        ignoreThreshold: options.noTolerance,
+        requireMeasurement: true,
+    });
+    return emitReport(report, options.json, io);
+}
+/** Parse and execute; never throws. */
+export async function runBudgetCliCommand(argv, io = PROCESS_IO, deps = { measureApp }) {
+    try {
+        return await runBudgetCli(parseBudgetCliArgs(argv), io, deps);
+    }
+    catch (error) {
+        const known = error instanceof UsageError ||
+            error instanceof BudgetFileError ||
+            error instanceof RunFileError;
+        const message = error instanceof Error ? error.message : String(error);
+        io.stderr(`${known ? 'usage' : 'fatal'}: ${message}\n`);
+        if (error instanceof UsageError)
+            io.stderr(`\n${formatBudgetCliHelp()}\n`);
+        // Exit 1 means over budget; a crash must never read as a measured verdict.
+        return BUDGET_EXIT_CODES.USAGE;
+    }
+}
+function isMainEntryPoint(moduleUrl, entryPath) {
+    if (entryPath === undefined)
+        return false;
+    try {
+        return moduleUrl === pathToFileURL(realpathSync(entryPath)).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainEntryPoint(import.meta.url, process.argv[1])) {
+    process.exitCode = await runBudgetCliCommand(process.argv.slice(2));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `@electron-stagewright/plugin-budget`: performance budgets for Electron apps.
+ *
+ * @module
+ */
+import { budgetPlugin } from './plugin.js';
+export default budgetPlugin;
+export { budgetPlugin, createBudgetPlugin } from './plugin.js';
+export { BUDGET_PLATFORMS, BudgetFileError, MEMORY_METRICS, PHASES, PROCESS_TYPES, budgetSchema, loadBudget, parseBudget, } from './budget.js';
+export type { Budget, BudgetPlatform, BundleEntryBudget, MemoryMetric, MemoryPlatformBudget, Phase, ProcessType, } from './budget.js';
+export { measureBundle } from './bundle.js';
+export { checkRun } from './check.js';
+export type { CheckOptions, CheckReport, CheckResult, CheckStatus } from './check.js';
+export { compareRuns, renderCheckReport, renderComparison } from './render.js';
+export type { ComparisonRow } from './render.js';
+export { RUN_FORMAT, RUN_SCHEMA_VERSION, RunFileError, createRun, loadRun, memoryByType, mergeRuns, runSchema, summarizeLatencies, summarizeRun, } from './run.js';
+export type { BudgetRun, BundleEntryMeasurement, LatencySummary, Measurement, MemoryMeasurement, ProcessMemory, StallSummary, SummaryRow, } from './run.js';
+export { classifyProcess, measureMemory, platformMetric } from './memory.js';
+export type { AppProcessMetric, OsMemoryReader } from './memory.js';
+export { measureSession, startWindow } from './session.js';
+export type { EvaluatingSession, IpcProbe, MeasureOptions, SessionMeasurement } from './session.js';
+export { measureApp } from './measure.js';
+export type { BeforeRound, LaunchPhase, MeasureAppOptions, RoundSetup, Workload, WorkloadContext, } from './measure.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,eAAe,YAAY,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,MAAM,EACN,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,WAAW,GACZ,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,OAAO,EACP,YAAY,EACZ,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,GACb,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,SAAS,EACT,sBAAsB,EACtB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5E,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1D,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,YAAY,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,eAAe,GAChB,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@electron-stagewright/plugin-budget`: performance budgets for Electron apps.
+ *
+ * @module
+ */
+import { budgetPlugin } from './plugin.js';
+export default budgetPlugin;
+export { budgetPlugin, createBudgetPlugin } from './plugin.js';
+export { BUDGET_PLATFORMS, BudgetFileError, MEMORY_METRICS, PHASES, PROCESS_TYPES, budgetSchema, loadBudget, parseBudget, } from './budget.js';
+export { measureBundle } from './bundle.js';
+export { checkRun } from './check.js';
+export { compareRuns, renderCheckReport, renderComparison } from './render.js';
+export { RUN_FORMAT, RUN_SCHEMA_VERSION, RunFileError, createRun, loadRun, memoryByType, mergeRuns, runSchema, summarizeLatencies, summarizeRun, } from './run.js';
+export { classifyProcess, measureMemory, platformMetric } from './memory.js';
+export { measureSession, startWindow } from './session.js';
+export { measureApp } from './measure.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,eAAe,YAAY,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,MAAM,EACN,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAA;AAUpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9E,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,OAAO,EACP,YAAY,EACZ,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,GACb,MAAM,UAAU,CAAA;AAWjB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}

package/dist/measure.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Launch an app and measure it over cold and warm rounds on a throwaway profile.
+ *
+ * @module
+ */
+import type { Budget } from './budget.js';
+import { type BudgetRun, type MemoryMeasurement } from './run.js';
+import { sampleMemory, type MemorySource } from './session.js';
+export type LaunchPhase = 'cold' | 'warm';
+/** What a workload script receives: the tool dispatcher of the server driving the app. */
+export interface WorkloadContext {
+    readonly sessionId: string;
+    readonly phase: LaunchPhase;
+    dispatch(tool: string, args?: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+export type Workload = (context: WorkloadContext) => Promise<void>;
+/** What `beforeRound` may add to the launches of one round. */
+export interface RoundSetup {
+    readonly env?: Readonly<Record<string, string>>;
+    readonly args?: readonly string[];
+}
+/**
+ * Runs before each round's first launch, to hand it fresh state (a database copy, a seeded
+ * fixture). `profile` is the round's empty user-data directory.
+ */
+export type BeforeRound = (context: {
+    readonly round: number;
+    readonly profile: string;
+}) => RoundSetup | void | Promise<RoundSetup | void>;
+export interface MeasureAppOptions {
+    /** `electron_launch` arguments: `main` and/or `executablePath`, plus `args`, `env`, `cwd`. */
+    readonly launch: {
+        readonly main?: string;
+        readonly executablePath?: string;
+        readonly args?: readonly string[];
+        readonly env?: Readonly<Record<string, string>>;
+        readonly cwd?: string;
+    };
+    readonly rounds?: number;
+    readonly phases?: readonly LaunchPhase[];
+    /** Wait after the window loads before the measurement window opens. */
+    readonly settleMs?: number;
+    readonly windowMs?: number;
+    /** Supplies the IPC probe and the default window length. */
+    readonly budget?: Budget;
+    /** Runs inside the measurement window instead of idling for `windowMs`. */
+    readonly workload?: Workload;
+    /** A workload still running after this fails the measurement. */
+    readonly workloadTimeoutMs?: number;
+    readonly label?: string;
+    readonly onProgress?: (message: string) => void;
+    readonly beforeRound?: BeforeRound;
+    /**
+     * Sample memory this often during the window and record the highest sample outside the GPU as
+     * `memoryPeak`. Defaults to 1000 when the budget's memory block for this platform reads `peak`.
+     */
+    readonly memorySampleMs?: number;
+    /**
+     * `skip` reports a round whose launch or measurement failed and goes on to the next one; pair
+     * it with `checkRun`'s `minSamples`. Default `throw`.
+     */
+    readonly failedRounds?: 'throw' | 'skip';
+}
+export declare const DEFAULT_ROUNDS = 3;
+export declare const DEFAULT_SETTLE_MS = 3000;
+export declare const DEFAULT_WORKLOAD_TIMEOUT_MS = 120000;
+export declare const DEFAULT_MEMORY_SAMPLE_MS = 1000;
+/**
+ * Samples memory until stopped; `peak` keeps the heaviest sample outside the GPU, or returns
+ * undefined when no sample during the window succeeded.
+ */
+export declare function startSampler(session: Parameters<typeof sampleMemory>[0], source: MemorySource, intervalMs: number | undefined): {
+    stop(): Promise<void>;
+    peak(end: MemoryMeasurement | undefined): MemoryMeasurement | undefined;
+};
+/**
+ * Measure `rounds` rounds. Each round gets an empty profile: the first launch on it is `cold`,
+ * the relaunch `warm`. Asking only for `warm` still does the cold launch, unmeasured.
+ */
+export declare function measureApp(options: MeasureAppOptions): Promise<BudgetRun>;
+//# sourceMappingURL=measure.d.ts.map

package/dist/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../src/measure.ts"],"names":[],"mappings":"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"}