feat: add parsers

Author: OrionFable

src/router/link.tsx

@@ -5,6 +5,7 @@ import type { QueryString } from "../types/query-string";
 import { AnyJson } from "../types";
 import { Paths } from "../types/paths";
 import { TextFragment } from "../utils/text-fragment";
+import { QueryStringMapper } from "../utils/mappers";
 
 const isLeftClick = (e: React.MouseEvent) => e.button === 0;
 
@@ -16,24 +17,25 @@ type QueryAndPaths<Path extends string> = (Paths.Has<Path> extends true ? { path
     (QueryString.Has<Path> extends true ? { query: NonNullable<QueryString.Parse<Path>> } : { query?: never });
 
 export type LinkProps<Path extends string> = Omit<AnchorProps, "href" | "onClick"> & {
-    href: Path;
-    state?: AnyJson;
-    replace?: boolean;
     fragments?: TextFragment[];
+    href: Path;
     onClick?: (event: Parameters<NonNullable<AnchorProps["onClick"]>>[0], pathAndQuery: QueryAndPaths<Path>) => void;
+    parsers?: Partial<QueryStringMapper<string>>;
+    replace?: boolean;
+    state?: AnyJson;
 } & QueryAndPaths<Path>;
 
 const httpRegex = /^https?:\/\//;
 
 export const Link: <TPath extends string>(props: LinkProps<TPath>) => React.ReactElement = forwardRef(
     <TPath extends string>(
-        { href, state, replace = false, onClick, query, paths, fragments, ...props }: LinkProps<TPath>,
+        { href, state, replace = false, onClick, parsers, query, paths, fragments, ...props }: LinkProps<TPath>,
         ref: React.Ref<HTMLAnchorElement>
     ) => {
         const { push, replace: _replace } = useNavigation();
         const contextHref = useHref();
         const basename = useBasename();
-        const _href = httpRegex.test(href) ? href : join(basename, mergeUrlEntities(href, paths, query, undefined, fragments));
+        const _href = httpRegex.test(href) ? href : join(basename, mergeUrlEntities(href, paths, query, parsers, fragments));
         const _onClick: NonNullable<AnchorProps["onClick"]> = (event) => {
             if (props.target === undefined && props.target !== "_self") event.preventDefault();
             if (_href === contextHref) return;