export interface RunLifecycleScriptOptions {
    /** When true, do not throw on missing scripts — return `false` instead. */
    optional?: boolean;
    /**
     * Stdio inheritance for the spawned script. Default `'inherit'` so output
     * appears in the parent's terminal. Pass `'inherit-stderr'` to mirror
     * inheritance but redirect the child's stdout → parent's stderr — used by
     * `gjsify pack --json` and `gjsify publish` so the parent's stdout stays
     * a clean JSON stream (script log lines would otherwise corrupt the
     * machine-readable output that callers `JSON.parse`).
     */
    stdio?: 'inherit' | 'inherit-stderr' | 'pipe' | 'ignore';
    /** Extra environment variables layered on top of the defaults. */
    env?: Record<string, string>;
}
/**
 * Run a lifecycle script defined in `pkg.scripts[name]` from `wsDir`.
 * Returns `true` if the script existed and exited 0. Returns `false` if
 * `optional: true` and the script is missing. Throws on non-zero exit.
 */
export declare function runLifecycleScript(wsDir: string, pkg: Record<string, unknown>, name: string, opts?: RunLifecycleScriptOptions): Promise<boolean>;
