import { Client, Dependency, Maintainer, Package, ParsedPURL, URLBuilder, Version } from "./client.mjs";
import { Registry } from "./registry.mjs";
import "./index2.mjs";
/**
 * Parse a package URL into normalized components.
 *
 * @param purlStr - Package URL to parse.
 * @returns {ParsedPURL} The normalized components.
 * @see https://github.com/package-url/purl-spec (ECMA-427)
 */
export declare function parsePURL(purlStr: string): ParsedPURL;
/**
 * Build a registry package name from PURL components.
 *
 * @param parsed - Parsed package URL components.
 * @returns {string} The namespace-qualified package name.
 */
export declare function fullName(parsed: ParsedPURL): string;
/**
 * Create a registry from a package URL.
 *
 * @param purlStr - Package URL to resolve.
 * @param client - Optional HTTP client.
 * @returns {Promise<[Registry, string, string]>} The registry, package name, and version.
 */
export declare function createFromPURL(purlStr: string, client?: Client): Promise<[Registry, string, string]>;
/**
 * Build a package URL from normalized components.
 *
 * @param parts - Package URL components.
 * @returns {string} The canonical package URL.
 */
export declare function buildPURL(parts: Readonly<{
  type: string;
  name: string;
  version?: string;
  namespace?: string;
  qualifiers?: Readonly<Record<string, string>>;
  subpath?: string;
}>): string;
/**
 * Normalize common license names to SPDX expressions.
 *
 * @param raw - License name or SPDX expression.
 * @returns {string} The normalized SPDX expression, or an empty string.
 */
export declare function normalizeLicense(raw: string | null | undefined): string;
/**
 * Combine license strings into one SPDX expression.
 *
 * @param licenses - License names or expressions to normalize.
 * @param operator - SPDX operator joining multiple licenses.
 * @returns {string} The combined SPDX expression, or an empty string.
 */
export declare function combineLicenses(licenses: readonly (string | null | undefined)[], operator?: "OR" | "AND"): string;
/**
 * Normalize repository shorthands and Git transports to HTTPS.
 *
 * @param raw - Repository URL string or object with a URL field.
 * @returns {string} The normalized URL, or an empty string.
 */
export declare function normalizeRepositoryURL(raw: unknown): string;
/** Custom error types for registry operations. */
export declare class PkioError extends Error {
  constructor(message: string, options?: ErrorOptions);
}
export declare class HTTPError extends PkioError {
  readonly statusCode: number;
  readonly url: string;
  readonly body: string;
  constructor(statusCode: number, url: string, body: string);
  isNotFound(): boolean;
  isRateLimit(): boolean;
  isServerError(): boolean;
}
export declare class NotFoundError extends PkioError {
  readonly ecosystem: string;
  readonly packageName: string;
  readonly version: string;
  constructor(ecosystem: string, packageName: string, version?: string);
}
export declare class RateLimitError extends PkioError {
  readonly retryAfter: number;
  constructor(retryAfter: number);
}
export declare class UnknownEcosystemError extends PkioError {
  readonly ecosystem: string;
  constructor(ecosystem: string);
}
export declare class InvalidPURLError extends PkioError {
  readonly purl: string;
  constructor(purl: string, reason: string);
}
/**
 * Fetch normalized package metadata from a package URL.
 *
 * @param purl - Package URL.
 * @param signal - Optional cancellation signal.
 * @param client - Optional HTTP client.
 * @returns {Promise<Package>} Normalized package metadata.
 */
export declare function fetchPackageFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Package>;
/**
 * Fetch all versions from a package URL.
 *
 * @param purl - Package URL.
 * @param signal - Optional cancellation signal.
 * @param client - Optional HTTP client.
 * @returns {Promise<Version[]>} Normalized versions.
 */
export declare function fetchVersionsFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Version[]>;
/**
 * Fetch dependencies for a versioned package URL.
 *
 * @param purl - Versioned package URL.
 * @param signal - Optional cancellation signal.
 * @param client - Optional HTTP client.
 * @returns {Promise<Dependency[]>} Normalized dependencies.
 */
export declare function fetchDependenciesFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Dependency[]>;
/**
 * Fetch maintainers from a package URL.
 *
 * @param purl - Package URL.
 * @param signal - Optional cancellation signal.
 * @param client - Optional HTTP client.
 * @returns {Promise<Maintainer[]>} Normalized maintainers.
 */
export declare function fetchMaintainersFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Maintainer[]>;
/**
 * Fetch packages concurrently, skipping failed lookups.
 *
 * @param purls - Package URLs to fetch.
 * @param options - Optional concurrency, cancellation, and client settings.
 * @returns {Promise<Map<string, Package>>} Results keyed by package URL.
 */
export declare function bulkFetchPackages(purls: readonly string[], options?: Readonly<{
  concurrency?: number;
  signal?: AbortSignal;
  client?: Client;
}>): Promise<Map<string, Package>>;
/**
 * Select an exact requested or latest version, then the newest usable one.
 *
 * @param versions - Candidate versions.
 * @param options - Optional requested and latest version numbers.
 * @returns {Version | null} The selected version, or null.
 */
export declare function selectVersion(versions: readonly Version[], options?: Readonly<{
  requested?: string;
  latest?: string;
}>): Version | null;
/**
 * Resolve the best documentation URL for a package.
 *
 * @param pkg - Package metadata.
 * @param urls - Ecosystem URL builder.
 * @param version - Optional package version.
 * @returns {string} The explicit, homepage, or ecosystem documentation URL.
 */
export declare function resolveDocsUrl(pkg: Package, urls: URLBuilder, version?: string): string;
/**
 * Resolve the ecosystem README URL for a package.
 *
 * @param pkg - Package metadata.
 * @param urls - Ecosystem URL builder.
 * @param version - Optional package version.
 * @returns {string} The README URL.
 */
export declare function resolveReadmeUrl(pkg: Package, urls: URLBuilder, version?: string): string;
//# sourceMappingURL=index.d.mts.map