export interface NellozPort {
  port: number;
  exposure: string;
  service: string;
}

export type NellozProfile = 'core' | 'minicpm' | 'tools' | 'video' | 'image' | string;

export interface OpenBrowserOptions {
  platform?: 'aix' | 'android' | 'darwin' | 'freebsd' | 'haiku' | 'linux' | 'openbsd' | 'sunos' | 'win32' | string;
  spawnImpl?: (
    command: string,
    args: readonly string[],
    options: Record<string, unknown>,
  ) => { unref?: () => void };
}

/** Opens a URL with the operating system's default browser. */
export function openBrowser(url: string, options?: OpenBrowserOptions): boolean;

/** Runs the Nelloz command-line interface and resolves to its process exit code. */
export function run(args: readonly string[]): Promise<number>;

/** Returns the runtime profiles selected by CLI arguments. */
export function profilesFromArgs(args: readonly string[]): NellozProfile[];

/** Returns the environment/configuration keys required by the selected profiles. */
export function requiredForProfiles(profiles: readonly NellozProfile[]): string[];

export const PORTS: readonly NellozPort[];