import type { PathPattern } from "../types";
/**
 * The result of parsing a path against a pattern.
 */
export type ParseParamsResult = {
    /** The extracted parameters. */
    params: Readonly<Array<unknown>>;
    /** The portion of the path that remains unmatched. */
    remainingPath: string;
    /** The portion of the path that was matched. */
    matchedPath: string;
};
/**
 * Parses a URL path against a defined path pattern to extract parameters.
 *
 * @remarks
 * This function iterates through the pattern segments. Static strings must match exactly.
 * Dynamic segments (schemas) consume parts of the path until the next static segment or the end.
 *
 * @param pattern - The path pattern definition.
 * @param path - The URL path to parse.
 * @returns A `ParseParamsResult` object.
 * @throws {@link Error} if the pattern structure is invalid.
 */
export declare function parseParams(pattern: PathPattern, path: string): ParseParamsResult;