@kitbag/router 0.7.2 → 0.8.0

package/dist/kitbag-router.d.ts

@@ -18,6 +18,10 @@ declare type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
 
 declare type __VLS_NonUndefinedable_2<T> = T extends undefined ? never : T;
 
+declare type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
 declare type __VLS_TypePropsToRuntimeProps<T> = {
     [K in keyof T]-?: {} extends Pick<T, K> ? {
         type: PropType<__VLS_NonUndefinedable<T[K]>>;
@@ -36,6 +40,12 @@ declare type __VLS_TypePropsToRuntimeProps_2<T> = {
     };
 };
 
+declare type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+
 declare type __VLS_WithTemplateSlots<T, S> = T & {
     new (): {
         $slots: S;
@@ -208,6 +218,10 @@ export declare type CreateRouteOptions<TName extends string | undefined = string
      * Represents additional metadata associated with a route, customizable via declaration merging.
      */
     meta?: TMeta;
+    /**
+     * Determines what assets are prefetched when router-link is rendered for this route. Overrides router level prefetch.
+     */
+    prefetch?: PrefetchConfig;
 };
 
 /**
@@ -515,6 +529,19 @@ declare type PathParamsWithParamNameExtracted<TPath extends string> = {
     [K in keyof ExtractParamsFromPathString<TPath> as ExtractParamName<K>]?: Param;
 };
 
+/**
+ * Determines what assets are prefetched. A boolean enables or disables all prefetching.
+ */
+declare type PrefetchConfig = boolean | PrefetchConfigOptions;
+
+declare type PrefetchConfigOptions = {
+    /**
+     * When true any component that is wrapped in vue's defineAsyncComponent will be prefetched
+     * @default true
+     */
+    components?: boolean;
+};
+
 declare type Query<TQuery extends string = string, TQueryParams extends QueryParamsWithParamNameExtracted<TQuery> = Record<string, Param | undefined>> = {
     query: TQuery;
     params: string extends TQuery ? Record<string, Param> : Identity<ExtractQueryParamsFromQueryString<TQuery, TQueryParams>>;
@@ -695,7 +722,11 @@ export declare type Route<TName extends string = string, THost extends Host = Ho
      * Represents the schema of the route state, combined with any parents.
      */
     state: TState;
-    depth: number;
+    /**
+     * Determines what assets are prefetched when router-link is rendered for this route. Overrides router level prefetch.
+     */
+    prefetch?: PrefetchConfig;
+    /* Excluded from this release type: depth */
 };
 
 declare type RouteGetByKey<TRoutes extends Routes, TKey extends RoutesName<TRoutes>> = RoutesMap<TRoutes>[TKey];
@@ -851,6 +882,10 @@ export declare type Router<TRoutes extends Routes = any> = Plugin_2 & {
      * Given a URL, returns true if host does not match host stored on router instance
      */
     isExternal: (url: string) => boolean;
+    /**
+     * Determines what assets are prefetched.
+     */
+    prefetch?: PrefetchConfig;
 };
 
 declare type RouterFind<TRoutes extends Routes> = {
@@ -864,11 +899,13 @@ declare type RouterHistoryMode = 'auto' | 'browser' | 'memory' | 'hash';
 
 export declare const routerInjectionKey: InjectionKey<RegisteredRouter>;
 
-export declare const RouterLink: __VLS_WithTemplateSlots_2<DefineComponent<__VLS_TypePropsToRuntimeProps_2<{
-to: Url | ToCallback;
-} & RouterPushOptions>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_2<{
-to: Url | ToCallback;
-} & RouterPushOptions>>>, {}, {}>, Readonly<{
+export declare const RouterLink: __VLS_WithTemplateSlots_2<DefineComponent<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps_2<RouterLinkProps & RouterPushOptions>, {
+prefetch: undefined;
+}>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps_2<RouterLinkProps & RouterPushOptions>, {
+prefetch: undefined;
+}>>>, {
+prefetch: PrefetchConfig;
+}, {}>, Readonly<{
     default?: ((props: {
         resolved: string;
         isMatch: boolean;
@@ -884,6 +921,17 @@ to: Url | ToCallback;
     }) => unknown) | undefined;
 }>;
 
+declare type RouterLinkProps = {
+    /**
+     * The url string to navigate to or a callback that returns a url string
+     */
+    to: Url | ToCallback;
+    /**
+     * Determines what assets are prefetched when router-link is rendered for this route. Overrides route level prefetch.
+     */
+    prefetch?: PrefetchConfig;
+};
+
 /**
  * An error thrown when an attempt is made to use routing functionality before the router has been installed.
  */
@@ -912,6 +960,10 @@ export declare type RouterOptions = {
      * For example having `base` of `/foo` would assume all routes should start with `your.domain.com/foo`.
      */
     base?: string;
+    /**
+     * Determines what assets are prefetched when router-link is rendered for a specific route
+     */
+    prefetch?: PrefetchConfig;
 } & RouterRejectionComponents;
 
 declare type RouterPush<TRoutes extends Routes = any> = {
@@ -1133,9 +1185,13 @@ export declare type UseLink = {
  */
 export declare function useLink<TRouteKey extends RegisteredRoutesName>(name: MaybeRefOrGetter<TRouteKey>, ...args: UseLinkArgs<TRouteKey>): UseLink;
 
-export declare function useLink(url: MaybeRefOrGetter<Url>): UseLink;
+export declare function useLink(url: MaybeRefOrGetter<Url>, options?: MaybeRefOrGetter<UseLinkOptions>): UseLink;
+
+declare type UseLinkArgs<TSource extends RegisteredRoutesName, TParams = RouteParamsByKey<RegisteredRoutes, TSource>> = AllPropertiesAreOptional<TParams> extends true ? [params?: MaybeRefOrGetter<TParams>, options?: MaybeRefOrGetter<UseLinkOptions>] : [params: MaybeRefOrGetter<TParams>, options?: MaybeRefOrGetter<UseLinkOptions>];
 
-declare type UseLinkArgs<TSource extends RegisteredRoutesName, TParams = RouteParamsByKey<RegisteredRoutes, TSource>> = AllPropertiesAreOptional<TParams> extends true ? [params?: MaybeRefOrGetter<TParams>, options?: MaybeRefOrGetter<RouterResolveOptions>] : [params: MaybeRefOrGetter<TParams>, options?: MaybeRefOrGetter<RouterResolveOptions>];
+export declare type UseLinkOptions = RouterResolveOptions & {
+    prefetch?: PrefetchConfig;
+};
 
 /**
  * A composition to access the router's rejection state.