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

package/dist/measure.js

@@ -0,0 +1,269 @@
+/**
+ * Launch an app and measure it over cold and warm rounds on a throwaway profile.
+ *
+ * @module
+ */
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { NOOP_LOGGER, createServer } from '@electron-stagewright/core';
+import { DEFAULT_WINDOW_MS } from './probe.js';
+import { createRun } from './run.js';
+import { measureSession, heavierMemory, sampleMemory, startWindow, } from './session.js';
+export const DEFAULT_ROUNDS = 3;
+export const DEFAULT_SETTLE_MS = 3_000;
+export const DEFAULT_WORKLOAD_TIMEOUT_MS = 120_000;
+export const DEFAULT_MEMORY_SAMPLE_MS = 1_000;
+const LOAD_TIMEOUT_MS = 30_000;
+// loadEventEnd is only set once the load event has finished.
+const LOADED_BODY = `
+await new Promise((resolve) => {
+  if (document.readyState === 'complete') resolve();
+  else addEventListener('load', resolve, { once: true });
+});
+await new Promise((resolve) => setTimeout(resolve, 0));
+return true;
+`;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function withTimeout(work, ms, what) {
+    let timer;
+    try {
+        return await Promise.race([
+            work,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`${what} timed out after ${ms} ms`)), ms);
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Why main eval is unavailable on this session, or undefined when it works. */
+async function mainEvalUnavailable(session) {
+    try {
+        await session.evaluate('main', 'return true');
+        return undefined;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        return `main eval is unavailable (${reason})`;
+    }
+}
+function memorySampleMs(options) {
+    if (options.memorySampleMs !== undefined)
+        return options.memorySampleMs;
+    const platform = process.platform;
+    return options.budget?.memory?.[platform]?.aggregate === 'peak'
+        ? DEFAULT_MEMORY_SAMPLE_MS
+        : undefined;
+}
+/** Bounds the wait for a sample still running when the window closes. */
+const SAMPLER_STOP_MS = 5_000;
+/**
+ * Samples memory until stopped; `peak` keeps the heaviest sample outside the GPU, or returns
+ * undefined when no sample during the window succeeded.
+ */
+export function startSampler(session, source, intervalMs) {
+    if (intervalMs === undefined) {
+        return { stop: () => Promise.resolve(), peak: () => undefined };
+    }
+    let best;
+    let sampled = false;
+    let running = true;
+    let wake = () => undefined;
+    const keep = (sample) => {
+        if (sample !== undefined && (best === undefined || heavierMemory(sample, best)))
+            best = sample;
+    };
+    const loop = (async () => {
+        while (running) {
+            const sample = await sampleMemory(session, source);
+            if (!running)
+                break;
+            sampled ||= sample !== undefined;
+            keep(sample);
+            await new Promise((resolve) => {
+                const timer = setTimeout(resolve, intervalMs);
+                wake = () => {
+                    clearTimeout(timer);
+                    resolve();
+                };
+            });
+        }
+    })();
+    return {
+        stop: async () => {
+            running = false;
+            wake();
+            await withTimeout(loop, SAMPLER_STOP_MS, 'memory sampler').catch(() => undefined);
+        },
+        peak: (end) => {
+            if (!sampled)
+                return undefined;
+            keep(end);
+            return best;
+        },
+    };
+}
+function checkSetup(setup) {
+    if (setup === undefined)
+        return {};
+    const strings = (value) => Array.isArray(value) && value.every((item) => typeof item === 'string');
+    const env = setup.env;
+    if (typeof setup !== 'object' ||
+        (setup.args !== undefined && !strings(setup.args)) ||
+        (env !== undefined && (typeof env !== 'object' || env === null || !strings(Object.values(env))))) {
+        throw new TypeError('beforeRound must return { env?: Record<string, string>, args?: string[] }');
+    }
+    return setup;
+}
+/** Launch once on `profile` and, when `measure` is set, take one measurement. */
+async function launchOnce(options, setup, profile, phase, measure) {
+    const server = await createServer({ allowEval: true, logger: NOOP_LOGGER });
+    const dispatch = (tool, args = {}) => server.dispatcher.dispatch(tool, args);
+    try {
+        const launched = await dispatch('electron_launch', {
+            ...options.launch,
+            ...(options.launch.env === undefined && setup.env === undefined
+                ? {}
+                : { env: { ...options.launch.env, ...setup.env } }),
+            args: [...(options.launch.args ?? []), ...(setup.args ?? []), `--user-data-dir=${profile}`],
+        });
+        if (launched['ok'] !== true) {
+            throw new Error(`could not launch the app: ${String(launched['error'] ?? launched['code'])}`);
+        }
+        const managed = server.sessions.resolve();
+        try {
+            const session = managed.session;
+            await withTimeout(session.evaluate('renderer', LOADED_BODY), LOAD_TIMEOUT_MS, 'window load');
+            await sleep(options.settleMs ?? DEFAULT_SETTLE_MS);
+            // A priming launch still loads and settles, so it leaves the profile a measured cold one would.
+            if (!measure)
+                return {};
+            const probe = options.budget?.ipc;
+            const ipc = probe === undefined
+                ? undefined
+                : {
+                    probe: probe.probe,
+                    ...(probe.intervalMs === undefined ? {} : { intervalMs: probe.intervalMs }),
+                };
+            // A build with the EnableNodeCliInspectArguments fuse off launches over CDP alone.
+            const mainUnavailable = await mainEvalUnavailable(session);
+            const open = await startWindow(session, {
+                allowRenderer: true,
+                ...(ipc === undefined ? {} : { ipc }),
+                ...(mainUnavailable === undefined ? {} : { mainUnavailable }),
+            });
+            const memoryProbe = options.budget?.memoryProbe;
+            const source = {
+                allowRenderer: true,
+                ...(mainUnavailable === undefined ? {} : { mainUnavailable }),
+                ...(memoryProbe === undefined ? {} : { memoryProbe }),
+            };
+            const sampler = startSampler(session, source, memorySampleMs(options));
+            const windowMs = options.windowMs ?? options.budget?.mainThread?.windowMs ?? DEFAULT_WINDOW_MS;
+            try {
+                if (options.workload === undefined)
+                    await sleep(windowMs);
+                else {
+                    // A timed-out workload keeps running; once the window closes its dispatch rejects, so a
+                    // polling loop ends instead of keeping the process alive.
+                    let ended = false;
+                    const workloadDispatch = (tool, args) => ended
+                        ? Promise.reject(new Error('the measurement window has closed'))
+                        : dispatch(tool, args);
+                    try {
+                        await withTimeout(options.workload({ sessionId: managed.id, phase, dispatch: workloadDispatch }), options.workloadTimeoutMs ?? DEFAULT_WORKLOAD_TIMEOUT_MS, 'workload');
+                    }
+                    finally {
+                        ended = true;
+                    }
+                }
+            }
+            finally {
+                await sampler.stop();
+            }
+            const measured = await measureSession(session, {
+                allowRenderer: true,
+                open,
+                windowMs,
+                ...(mainUnavailable === undefined ? {} : { mainUnavailable }),
+                ...(memoryProbe === undefined ? {} : { memoryProbe }),
+            });
+            const sampleMs = memorySampleMs(options);
+            const peak = sampler.peak(measured.measurement.memory);
+            const unavailable = sampleMs !== undefined && peak === undefined
+                ? {
+                    unavailable: {
+                        ...measured.measurement.unavailable,
+                        memoryPeak: 'no memory sample succeeded during the window',
+                    },
+                }
+                : {};
+            return {
+                measurement: {
+                    ...measured.measurement,
+                    ...unavailable,
+                    ...(peak === undefined ? {} : { memoryPeak: peak }),
+                },
+                ...(measured.electronVersion === undefined
+                    ? {}
+                    : { electronVersion: measured.electronVersion }),
+            };
+        }
+        finally {
+            await dispatch('electron_stop', { sessionId: managed.id }).catch(() => undefined);
+        }
+    }
+    finally {
+        await server.close().catch(() => 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 async function measureApp(options) {
+    const phases = options.phases ?? ['cold', 'warm'];
+    const rounds = [];
+    let electronVersion;
+    let firstFailure;
+    for (let round = 1; round <= (options.rounds ?? DEFAULT_ROUNDS); round += 1) {
+        const profile = await mkdtemp(path.join(tmpdir(), 'sw-budget-profile-'));
+        try {
+            const setup = checkSetup(await options.beforeRound?.({ round, profile }));
+            for (const phase of ['cold', 'warm']) {
+                const measure = phases.includes(phase);
+                if (!measure && !(phase === 'cold' && phases.includes('warm')))
+                    continue;
+                options.onProgress?.(`round ${round}: ${phase}${measure ? '' : ' (priming, unmeasured)'}`);
+                const result = await launchOnce(options, setup, profile, phase, measure);
+                electronVersion ??= result.electronVersion;
+                if (result.measurement !== undefined) {
+                    rounds.push({ round, phase, measurement: result.measurement });
+                }
+            }
+        }
+        catch (error) {
+            if (options.failedRounds !== 'skip')
+                throw error;
+            firstFailure ??= error;
+            // A warm launch shares the cold one's state, so the rest of the round is dropped too.
+            options.onProgress?.(`round ${round} failed and was skipped: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            // A process that outlives the app can hold the profile; that must not discard the rounds.
+            await rm(profile, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 }).catch((error) => options.onProgress?.(`could not remove ${profile}: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    // Every round failing is a setup problem (a wrong path, a broken script), not a budget verdict.
+    if (rounds.length === 0 && firstFailure !== undefined)
+        throw firstFailure;
+    return createRun({
+        rounds,
+        ...(electronVersion === undefined ? {} : { electronVersion }),
+        ...(options.label === undefined ? {} : { label: options.label }),
+    });
+}
+//# sourceMappingURL=measure.js.map

package/dist/measure.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Per-process memory in the platform's own metric, read from the host by pid.
+ *
+ * `app.getAppMetrics()` supplies the pids, their types, and working set; the OS supplies the
+ * number a user sees: footprint on macOS, Pss on Linux, private bytes on Windows.
+ *
+ * @module
+ */
+import type { MemoryMetric, ProcessType } from './budget.js';
+import type { MemoryMeasurement } from './run.js';
+/** One entry of `app.getAppMetrics()`, reduced to what the budget reads. */
+export interface AppProcessMetric {
+    readonly pid: number;
+    readonly type: string;
+    readonly name?: string | null;
+    readonly workingSetKb: number;
+    /** Windows only. */
+    readonly privateKb?: number | null;
+}
+/** Map Electron's process type (`Browser`, `Tab`, `GPU`, `Utility`, ...) to a budget bucket. */
+export declare function classifyProcess(type: string): ProcessType;
+export declare function platformMetric(platform: string): MemoryMetric;
+/** Bytes per pid from `footprint -j` output. Pids that already exited are simply absent. */
+export declare function parseFootprintJson(text: string): Map<number, number>;
+/** Pss in bytes from `/proc/<pid>/smaps_rollup`, or undefined when the line is missing. */
+export declare function parseSmapsRollup(text: string): number | undefined;
+/** Reads the OS metric for a set of pids. Injected so tests never touch the host. */
+export type OsMemoryReader = (pids: readonly number[]) => Promise<Map<number, number>>;
+/** Epoch ms a host pid started, `missing` when no such pid exists, undefined when unknown. */
+export type HostStartTimeReader = (pid: number) => Promise<number | 'missing' | undefined>;
+/** Boot time plus the pid's start ticks: how Chromium computes `process.getCreationTime()`. */
+export declare function readProcStartTime(pid: number, read?: (file: string) => Promise<string>): Promise<number | 'missing' | undefined>;
+export declare function hostStartTimeReader(platform: string): HostStartTimeReader | undefined;
+export declare function osMemoryReader(platform: string): OsMemoryReader | undefined;
+/**
+ * Build the memory sample for one moment. `error` explains an OS reader that failed; the sample
+ * then still carries working set, and its `metric` values are absent rather than guessed.
+ */
+export declare function measureMemory(processes: readonly AppProcessMetric[], platform: string, reader?: OsMemoryReader | undefined): Promise<{
+    memory: MemoryMeasurement;
+    error?: string;
+}>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,oBAAoB;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAKD,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAazD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAK7D;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAapE;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGjE;AAED,qFAAqF;AACrF,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAmCtF,8FAA8F;AAC9F,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAAA;AAK1F,+FAA+F;AAC/F,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAoC,GACzE,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CASzC;AAqBD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAIrF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAI3E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAAc,GAAG,SAAoC,GAC5D,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BxD"}

package/dist/memory.js

@@ -0,0 +1,159 @@
+/**
+ * Per-process memory in the platform's own metric, read from the host by pid.
+ *
+ * `app.getAppMetrics()` supplies the pids, their types, and working set; the OS supplies the
+ * number a user sees: footprint on macOS, Pss on Linux, private bytes on Windows.
+ *
+ * @module
+ */
+import { execFile } from 'node:child_process';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+const MB = 1024 * 1024;
+const round1 = (value) => Math.round(value * 10) / 10;
+/** Map Electron's process type (`Browser`, `Tab`, `GPU`, `Utility`, ...) to a budget bucket. */
+export function classifyProcess(type) {
+    switch (type) {
+        case 'Browser':
+            return 'main';
+        case 'Tab':
+            return 'renderer';
+        case 'GPU':
+            return 'gpu';
+        case 'Utility':
+            return 'utility';
+        default:
+            return 'other';
+    }
+}
+export function platformMetric(platform) {
+    if (platform === 'darwin')
+        return 'footprint';
+    if (platform === 'linux')
+        return 'pss';
+    if (platform === 'win32')
+        return 'privateBytes';
+    return 'workingSet';
+}
+/** Bytes per pid from `footprint -j` output. Pids that already exited are simply absent. */
+export function parseFootprintJson(text) {
+    const parsed = JSON.parse(text);
+    const unit = parsed['bytes per unit'] ?? 1;
+    const bytes = new Map();
+    for (const entry of parsed.processes ?? []) {
+        if (typeof entry.pid === 'number' && typeof entry.footprint === 'number') {
+            bytes.set(entry.pid, entry.footprint * unit);
+        }
+    }
+    return bytes;
+}
+/** Pss in bytes from `/proc/<pid>/smaps_rollup`, or undefined when the line is missing. */
+export function parseSmapsRollup(text) {
+    const match = /^Pss:\s+(\d+)\s+kB/m.exec(text);
+    return match?.[1] === undefined ? undefined : Number(match[1]) * 1024;
+}
+const FOOTPRINT_TIMEOUT_MS = 15_000;
+async function readFootprint(pids) {
+    // footprint only writes JSON to a regular file.
+    const dir = await mkdtemp(path.join(tmpdir(), 'sw-budget-fp-'));
+    const file = path.join(dir, 'footprint.json');
+    try {
+        await new Promise((resolve, reject) => {
+            execFile('/usr/bin/footprint', ['-j', file, ...pids.map(String)], { timeout: FOOTPRINT_TIMEOUT_MS, maxBuffer: 16 * MB }, (error) => (error === null ? resolve() : reject(error)));
+        });
+        return parseFootprintJson(await readFile(file, 'utf8'));
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+async function readPss(pids) {
+    const bytes = new Map();
+    await Promise.all(pids.map(async (pid) => {
+        const text = await readFile(`/proc/${pid}/smaps_rollup`, 'utf8').catch(() => undefined);
+        const pss = text === undefined ? undefined : parseSmapsRollup(text);
+        if (pss !== undefined)
+            bytes.set(pid, pss);
+    }));
+    return bytes;
+}
+/** Linux exposes start times in clock ticks; USER_HZ is 100 on every supported architecture. */
+const CLOCK_TICKS_PER_SECOND = 100;
+/** Boot time plus the pid's start ticks: how Chromium computes `process.getCreationTime()`. */
+export async function readProcStartTime(pid, read = (file) => readFile(file, 'utf8')) {
+    const stat = await read(`/proc/${pid}/stat`).catch(() => undefined);
+    if (stat === undefined)
+        return 'missing';
+    const procStat = await read('/proc/stat').catch(() => '');
+    // The command name may hold spaces and parentheses; fields resume after the last ')'.
+    const ticks = Number(stat.slice(stat.lastIndexOf(')') + 2).split(' ')[19]);
+    const bootSeconds = Number(/^btime (\d+)$/m.exec(procStat)?.[1]);
+    if (!Number.isFinite(ticks) || !Number.isFinite(bootSeconds))
+        return undefined;
+    return bootSeconds * 1000 + (ticks / CLOCK_TICKS_PER_SECOND) * 1000;
+}
+function readPsStartTime(pid) {
+    return new Promise((resolve) => {
+        execFile('ps', ['-o', 'lstart=', '-p', String(pid)], 
+        // lstart follows the locale; only the C locale is one Date.parse reads.
+        { timeout: 5_000, env: { ...process.env, LC_ALL: 'C' } }, (error, stdout, stderr) => {
+            // ps exits 1 silently for an unknown pid; a ps that rejects the flags says why on stderr.
+            if (error !== null) {
+                return resolve(error.code === 1 && stderr.trim() === '' ? 'missing' : undefined);
+            }
+            const started = Date.parse(stdout.trim());
+            resolve(Number.isNaN(started) ? undefined : started);
+        });
+    });
+}
+export function hostStartTimeReader(platform) {
+    if (platform === 'linux')
+        return (pid) => readProcStartTime(pid);
+    if (platform === 'darwin')
+        return readPsStartTime;
+    return undefined;
+}
+export function osMemoryReader(platform) {
+    if (platform === 'darwin')
+        return readFootprint;
+    if (platform === 'linux')
+        return readPss;
+    return undefined;
+}
+/**
+ * Build the memory sample for one moment. `error` explains an OS reader that failed; the sample
+ * then still carries working set, and its `metric` values are absent rather than guessed.
+ */
+export async function measureMemory(processes, platform, reader = osMemoryReader(platform)) {
+    const metric = platformMetric(platform);
+    let osBytes = new Map();
+    let error;
+    if (reader !== undefined) {
+        try {
+            osBytes = await reader(processes.map((entry) => entry.pid));
+        }
+        catch (cause) {
+            error = `could not read ${metric}: ${cause instanceof Error ? cause.message : String(cause)}`;
+        }
+    }
+    const memory = {
+        metric,
+        processes: processes.map((entry) => {
+            const bytes = metric === 'privateBytes'
+                ? typeof entry.privateKb === 'number'
+                    ? entry.privateKb * 1024
+                    : undefined
+                : osBytes.get(entry.pid);
+            return {
+                pid: entry.pid,
+                type: classifyProcess(entry.type),
+                ...(typeof entry.name === 'string' && entry.name.length > 0 ? { name: entry.name } : {}),
+                ...(bytes === undefined ? {} : { mb: round1(bytes / MB) }),
+                workingSetMb: round1(entry.workingSetKb / 1024),
+            };
+        }),
+    };
+    return { memory, ...(error === undefined ? {} : { error }) };
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The MCP face of the budget: `budget_start`, `budget_measure`, `budget_check`.
+ *
+ * Runtime metrics run fixed bodies in the app's main process, so they need the main eval grant;
+ * the IPC probe and startup timing also need the renderer. Bundle size needs neither, nor a session.
+ *
+ * @module
+ */
+import { type StagewrightPlugin } from '@electron-stagewright/core';
+export declare function createBudgetPlugin(): StagewrightPlugin;
+/** Load with `--plugin budget` or `createServer({ plugins: [budgetPlugin] })`. */
+export declare const budgetPlugin: StagewrightPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAQL,KAAK,iBAAiB,EAIvB,MAAM,4BAA4B,CAAA;AA2EnC,wBAAgB,kBAAkB,IAAI,iBAAiB,CAubtD;AAED,kFAAkF;AAClF,eAAO,MAAM,YAAY,EAAE,iBAe1B,CAAA"}