/**
 * Base for all valid paths type parameters.
 *
 * @category Internal
 */
export type ValidPathsBase = ReadonlyArray<string>;
/**
 * Base for all valid search type parameters.
 *
 * @category Internal
 */
export type ValidSearchBase = Readonly<Record<string, ReadonlyArray<string>>>;
/**
 * Base for all valid hash type parameters.
 *
 * @category Internal
 */
export type ValidHashBase = string;
/**
 * {@link SpaRoute} but with all properties required.
 *
 * @category Main
 */
export type FullSpaRoute<ValidPaths extends ValidPathsBase = ValidPathsBase, ValidSearch extends ValidSearchBase | undefined = ValidSearchBase | undefined, ValidHash extends ValidHashBase | undefined = ValidHashBase | undefined> = Required<SpaRoute<ValidPaths, ValidSearch, ValidHash>>;
/**
 * A type that contains all route information for a single URL.
 *
 * @category Main
 */
export type SpaRoute<ValidPaths extends ValidPathsBase = ValidPathsBase, ValidSearch extends ValidSearchBase | undefined = ValidSearchBase | undefined, ValidHash extends ValidHashBase | undefined = ValidHashBase | undefined> = {
    /** An array of the URL's paths. */
    paths: ValidPaths;
    /** An object of the URL's search params. */
    search?: ValidSearch;
    /** The URL's hash string, excluding the `#` character. */
    hash?: ValidHash;
};
/**
 * Detects if the input is a `SpaRoute`. Note that this cannot check for type safety for _your_
 * specific route type, use the `sanitizeRoute` constructor param in `SpaRouter` for that purpose.
 *
 * @category Internal
 */
export declare function isSpaRoute(input: unknown): input is SpaRoute;
/**
 * Narrow a route to a specific path.
 *
 * @category Main
 * @example
 *
 * ```ts
 * import {PathTree, FullSpaRoute, SpaRouteByPath} from 'spa-router-vir';
 *
 * const myAppPathTree = new PathTree({
 *     allowBare: true,
 *     children: {
 *         myRoute: {},
 *     },
 * });
 *
 * export type MyAppFullRoute = Readonly<
 *     FullSpaRoute<typeof myAppPathTree.PathsType, undefined, undefined>
 * >;
 *
 * export type MySpecificRoute<Paths extends MyAppFullRoute['paths']> = Readonly<
 *     SpaRouteByPath<Paths, MyAppFullRoute>
 * >;
 *
 * function handleSpecificRoute(
 *     specificRoute: MySpecificRoute<typeof myAppPathTree.paths.children.myRoute.fullPaths>,
 * ) {}
 * ```
 */
export type SpaRouteByPath<Paths extends Readonly<OriginalFullSpaRoute['paths']>, OriginalFullSpaRoute extends Readonly<Pick<FullSpaRoute, 'paths'>>> = OriginalFullSpaRoute & {
    paths: Extract<OriginalFullSpaRoute['paths'], Readonly<[
        ...Paths,
        ...any[]
    ]>>;
};
/**
 * Narrow a path to only the valid children paths of the given path.
 *
 * @category Main
 */
export type ChildPaths<Paths extends OriginalFullSpaRoute['paths'], OriginalFullSpaRoute extends FullSpaRoute> = SpaRouteByPath<Paths, OriginalFullSpaRoute>['paths'] extends Readonly<[
    ...Paths,
    ...infer ChildPaths
]> ? Readonly<ChildPaths> : never;