import { OptionalUrlParam, UrlQueryPart, ToUrlQueryPart, RequiredUrlParam, ToUrlPart, UrlParams, UrlPart } from '../services/withParams';
import { ExtractParamType } from './params';
import { AllPropertiesAreOptional, Identity } from './utilities';
import { UrlString } from './urlString';
import { ParamGetSet } from './paramTypes';
import { MakeOptional } from '../utilities/makeOptional';
export declare const IS_URL_SYMBOL: unique symbol;
export type UrlInternal = {
    [IS_URL_SYMBOL]: true;
    schema: Record<string, UrlPart>;
    params: {};
};
export type CreateUrlOptions = {
    host?: string | UrlPart | undefined;
    path?: string | UrlPart | undefined;
    query?: string | UrlQueryPart | undefined;
    hash?: string | UrlPart | undefined;
};
export type ToUrl<TOptions extends CreateUrlOptions> = Url<Identity<ToUrlPart<TOptions['host']>['params'] & ToUrlPart<TOptions['path']>['params'] & ToUrlQueryPart<TOptions['query']>['params'] & ToUrlPart<TOptions['hash']>['params']>>;
export declare function isUrl(url: unknown): url is Url & UrlInternal;
export type ParseUrlOptions = {
    /**
     * Whether to remove trailing slashes from the path. When true, trailing slashes will be removed from the path.
     * @default true
     */
    removeTrailingSlashes?: boolean;
};
/**
 * Represents the structure of a url parts. Can be used to create a url with support for params.
 */
export type Url<TParams extends UrlParams = UrlParams> = {
    /**
     * @internal
     * The parameters type for the url. Non functional and undefined at runtime.
     */
    params: TParams;
    /**
     * Converts the url parts to a full url.
     */
    stringify(...params: UrlParamsArgs<TParams>): UrlString;
    /**
     * Parses the url supplied and returns any params found.
     */
    parse(url: string, options?: ParseUrlOptions): ToUrlParamsReading<TParams>;
    /**
     * Parses the url supplied and returns any params found.
     */
    tryParse(url: string, options?: ParseUrlOptions): {
        success: true;
        params: ToUrlParamsReading<TParams>;
    } | {
        success: false;
        params: {};
        error: Error;
    };
    /**
     * True if the url is relative. False if the url is absolute.
     */
    isRelative: boolean;
};
type UrlParamsArgs<TParams extends UrlParams> = AllPropertiesAreOptional<ToUrlParamsWriting<TParams>> extends true ? [params?: ToUrlParamsWriting<TParams>] : [params: ToUrlParamsWriting<TParams>];
/**
* Extracts combined types of path and query parameters for a given url, creating a unified parameter object.
* @template TUrl - The url type from which to extract and merge parameter types.
* @returns A record of parameter names to their respective types, extracted and merged from both path and query parameters.
*/
export type UrlParamsReading<TUrl extends Url> = ToUrlParamsReading<TUrl['params']>;
type ToUrlParamsReading<TParams extends UrlParams> = Identity<MakeOptional<{
    [K in keyof TParams]: TParams[K] extends OptionalUrlParam<infer TParam> ? TParam extends Required<ParamGetSet> ? ExtractParamType<TParam> : ExtractParamType<TParam> | undefined : TParams[K] extends RequiredUrlParam<infer TParam> ? ExtractParamType<TParam> : unknown;
}>>;
/**
* Extracts combined types of path and query parameters for a given url, creating a unified parameter object.
* Differs from ExtractRouteParamTypesReading in that optional params with defaults will remain optional.
* @template TUrl - The url type from which to extract and merge parameter types.
* @returns A record of parameter names to their respective types, extracted and merged from both path and query parameters.
*/
export type UrlParamsWriting<TUrl extends Url> = ToUrlParamsWriting<TUrl['params']>;
type ToUrlParamsWriting<TParams extends UrlParams> = Identity<MakeOptional<{
    [K in keyof TParams]: TParams[K] extends OptionalUrlParam<infer TParam> ? ExtractParamType<TParam> | undefined : TParams[K] extends RequiredUrlParam<infer TParam> ? ExtractParamType<TParam> : unknown;
}>>;
export {};