@real-router/svelte 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +355 -0
- package/dist/RouterProvider.svelte +51 -0
- package/dist/RouterProvider.svelte.d.ts +10 -0
- package/dist/actions/link.svelte.d.ts +26 -0
- package/dist/actions/link.svelte.js +61 -0
- package/dist/components/Lazy.svelte +47 -0
- package/dist/components/Lazy.svelte.d.ts +10 -0
- package/dist/components/Link.svelte +69 -0
- package/dist/components/Link.svelte.d.ts +18 -0
- package/dist/components/RouteView.svelte +46 -0
- package/dist/components/RouteView.svelte.d.ts +9 -0
- package/dist/composables/useIsActiveRoute.svelte.d.ts +4 -0
- package/dist/composables/useIsActiveRoute.svelte.js +11 -0
- package/dist/composables/useNavigator.svelte.d.ts +2 -0
- package/dist/composables/useNavigator.svelte.js +9 -0
- package/dist/composables/useRoute.svelte.d.ts +2 -0
- package/dist/composables/useRoute.svelte.js +9 -0
- package/dist/composables/useRouteNode.svelte.d.ts +2 -0
- package/dist/composables/useRouteNode.svelte.js +27 -0
- package/dist/composables/useRouteUtils.svelte.d.ts +2 -0
- package/dist/composables/useRouteUtils.svelte.js +7 -0
- package/dist/composables/useRouter.svelte.d.ts +2 -0
- package/dist/composables/useRouter.svelte.js +9 -0
- package/dist/composables/useRouterTransition.svelte.d.ts +4 -0
- package/dist/composables/useRouterTransition.svelte.js +8 -0
- package/dist/context.d.ts +3 -0
- package/dist/context.js +3 -0
- package/dist/createReactiveSource.svelte.d.ts +4 -0
- package/dist/createReactiveSource.svelte.js +14 -0
- package/dist/index.d.ts +17 -0
- package/dist/index.js +18 -0
- package/dist/types.d.ts +20 -0
- package/dist/types.js +1 -0
- package/package.json +74 -0
- package/src/RouterProvider.svelte +51 -0
- package/src/actions/link.svelte.ts +90 -0
- package/src/components/Lazy.svelte +47 -0
- package/src/components/Link.svelte +69 -0
- package/src/components/RouteView.svelte +46 -0
- package/src/composables/useIsActiveRoute.svelte.ts +22 -0
- package/src/composables/useNavigator.svelte.ts +15 -0
- package/src/composables/useRoute.svelte.ts +15 -0
- package/src/composables/useRouteNode.svelte.ts +33 -0
- package/src/composables/useRouteUtils.svelte.ts +12 -0
- package/src/composables/useRouter.svelte.ts +15 -0
- package/src/composables/useRouterTransition.svelte.ts +16 -0
- package/src/context.ts +5 -0
- package/src/createReactiveSource.svelte.ts +21 -0
- package/src/index.ts +39 -0
- package/src/types.ts +23 -0
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { createActiveRouteSource } from "@real-router/sources";
|
|
2
|
+
|
|
3
|
+
import { createReactiveSource } from "../createReactiveSource.svelte";
|
|
4
|
+
import { useRouter } from "./useRouter.svelte";
|
|
5
|
+
|
|
6
|
+
import type { Params } from "@real-router/core";
|
|
7
|
+
|
|
8
|
+
export function useIsActiveRoute(
|
|
9
|
+
routeName: string,
|
|
10
|
+
params?: Params,
|
|
11
|
+
strict = false,
|
|
12
|
+
ignoreQueryParams = true,
|
|
13
|
+
): { readonly current: boolean } {
|
|
14
|
+
const router = useRouter();
|
|
15
|
+
|
|
16
|
+
const source = createActiveRouteSource(router, routeName, params, {
|
|
17
|
+
strict,
|
|
18
|
+
ignoreQueryParams,
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
return createReactiveSource(source);
|
|
22
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { getContext } from "svelte";
|
|
2
|
+
|
|
3
|
+
import { NAVIGATOR_KEY } from "../context";
|
|
4
|
+
|
|
5
|
+
import type { Navigator } from "@real-router/core";
|
|
6
|
+
|
|
7
|
+
export const useNavigator = (): Navigator => {
|
|
8
|
+
const navigator = getContext<Navigator | undefined>(NAVIGATOR_KEY);
|
|
9
|
+
|
|
10
|
+
if (!navigator) {
|
|
11
|
+
throw new Error("useNavigator must be used within a RouterProvider");
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
return navigator;
|
|
15
|
+
};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { getContext } from "svelte";
|
|
2
|
+
|
|
3
|
+
import { ROUTE_KEY } from "../context";
|
|
4
|
+
|
|
5
|
+
import type { RouteContext } from "../types";
|
|
6
|
+
|
|
7
|
+
export const useRoute = (): RouteContext => {
|
|
8
|
+
const routeContext = getContext<RouteContext | undefined>(ROUTE_KEY);
|
|
9
|
+
|
|
10
|
+
if (!routeContext) {
|
|
11
|
+
throw new Error("useRoute must be used within a RouterProvider");
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
return routeContext;
|
|
15
|
+
};
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { getNavigator } from "@real-router/core";
|
|
2
|
+
import { createRouteNodeSource } from "@real-router/sources";
|
|
3
|
+
|
|
4
|
+
import { createReactiveSource } from "../createReactiveSource.svelte";
|
|
5
|
+
import { useRouter } from "./useRouter.svelte";
|
|
6
|
+
|
|
7
|
+
import type { RouteContext } from "../types";
|
|
8
|
+
|
|
9
|
+
export function useRouteNode(nodeName: string): RouteContext {
|
|
10
|
+
const router = useRouter();
|
|
11
|
+
const navigator = getNavigator(router);
|
|
12
|
+
|
|
13
|
+
const source = createRouteNodeSource(router, nodeName);
|
|
14
|
+
const reactive = createReactiveSource(source);
|
|
15
|
+
|
|
16
|
+
return {
|
|
17
|
+
navigator,
|
|
18
|
+
get route() {
|
|
19
|
+
return {
|
|
20
|
+
get current() {
|
|
21
|
+
return reactive.current.route;
|
|
22
|
+
},
|
|
23
|
+
};
|
|
24
|
+
},
|
|
25
|
+
get previousRoute() {
|
|
26
|
+
return {
|
|
27
|
+
get current() {
|
|
28
|
+
return reactive.current.previousRoute;
|
|
29
|
+
},
|
|
30
|
+
};
|
|
31
|
+
},
|
|
32
|
+
};
|
|
33
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { getPluginApi } from "@real-router/core/api";
|
|
2
|
+
import { getRouteUtils } from "@real-router/route-utils";
|
|
3
|
+
|
|
4
|
+
import { useRouter } from "./useRouter.svelte";
|
|
5
|
+
|
|
6
|
+
import type { RouteUtils } from "@real-router/route-utils";
|
|
7
|
+
|
|
8
|
+
export const useRouteUtils = (): RouteUtils => {
|
|
9
|
+
const router = useRouter();
|
|
10
|
+
|
|
11
|
+
return getRouteUtils(getPluginApi(router).getTree());
|
|
12
|
+
};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { getContext } from "svelte";
|
|
2
|
+
|
|
3
|
+
import { ROUTER_KEY } from "../context";
|
|
4
|
+
|
|
5
|
+
import type { Router } from "@real-router/core";
|
|
6
|
+
|
|
7
|
+
export const useRouter = (): Router => {
|
|
8
|
+
const router = getContext<Router | undefined>(ROUTER_KEY);
|
|
9
|
+
|
|
10
|
+
if (!router) {
|
|
11
|
+
throw new Error("useRouter must be used within a RouterProvider");
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
return router;
|
|
15
|
+
};
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { createTransitionSource } from "@real-router/sources";
|
|
2
|
+
|
|
3
|
+
import { createReactiveSource } from "../createReactiveSource.svelte";
|
|
4
|
+
import { useRouter } from "./useRouter.svelte";
|
|
5
|
+
|
|
6
|
+
import type { RouterTransitionSnapshot } from "@real-router/sources";
|
|
7
|
+
|
|
8
|
+
export function useRouterTransition(): {
|
|
9
|
+
readonly current: RouterTransitionSnapshot;
|
|
10
|
+
} {
|
|
11
|
+
const router = useRouter();
|
|
12
|
+
|
|
13
|
+
const source = createTransitionSource(router);
|
|
14
|
+
|
|
15
|
+
return createReactiveSource(source);
|
|
16
|
+
}
|
package/src/context.ts
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { createSubscriber } from "svelte/reactivity";
|
|
2
|
+
|
|
3
|
+
import type { RouterSource } from "@real-router/sources";
|
|
4
|
+
|
|
5
|
+
export function createReactiveSource<T>(source: RouterSource<T>): {
|
|
6
|
+
readonly current: T;
|
|
7
|
+
} {
|
|
8
|
+
const subscribe = createSubscriber((update) => {
|
|
9
|
+
return source.subscribe(() => {
|
|
10
|
+
update();
|
|
11
|
+
});
|
|
12
|
+
});
|
|
13
|
+
|
|
14
|
+
return {
|
|
15
|
+
get current(): T {
|
|
16
|
+
subscribe();
|
|
17
|
+
|
|
18
|
+
return source.getSnapshot();
|
|
19
|
+
},
|
|
20
|
+
};
|
|
21
|
+
}
|
package/src/index.ts
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
// Components
|
|
2
|
+
export { default as RouteView } from "./components/RouteView.svelte";
|
|
3
|
+
|
|
4
|
+
export { default as Link } from "./components/Link.svelte";
|
|
5
|
+
|
|
6
|
+
export { default as Lazy } from "./components/Lazy.svelte";
|
|
7
|
+
|
|
8
|
+
// Reactive Primitives
|
|
9
|
+
export { createReactiveSource } from "./createReactiveSource.svelte";
|
|
10
|
+
|
|
11
|
+
// Composables
|
|
12
|
+
export { useRouter } from "./composables/useRouter.svelte";
|
|
13
|
+
|
|
14
|
+
export { useNavigator } from "./composables/useNavigator.svelte";
|
|
15
|
+
|
|
16
|
+
export { useRouteUtils } from "./composables/useRouteUtils.svelte";
|
|
17
|
+
|
|
18
|
+
export { useRoute } from "./composables/useRoute.svelte";
|
|
19
|
+
|
|
20
|
+
export { useRouteNode } from "./composables/useRouteNode.svelte";
|
|
21
|
+
|
|
22
|
+
export { useRouterTransition } from "./composables/useRouterTransition.svelte";
|
|
23
|
+
|
|
24
|
+
// Actions
|
|
25
|
+
export { createLinkAction } from "./actions/link.svelte";
|
|
26
|
+
|
|
27
|
+
export type { LinkActionParams } from "./actions/link.svelte";
|
|
28
|
+
|
|
29
|
+
// Context
|
|
30
|
+
export { default as RouterProvider } from "./RouterProvider.svelte";
|
|
31
|
+
|
|
32
|
+
export { ROUTER_KEY, NAVIGATOR_KEY, ROUTE_KEY } from "./context";
|
|
33
|
+
|
|
34
|
+
// Types
|
|
35
|
+
export type { LinkProps, RouteContext } from "./types";
|
|
36
|
+
|
|
37
|
+
export type { Navigator } from "@real-router/core";
|
|
38
|
+
|
|
39
|
+
export type { RouterTransitionSnapshot } from "@real-router/sources";
|
package/src/types.ts
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
NavigationOptions,
|
|
3
|
+
Navigator,
|
|
4
|
+
Params,
|
|
5
|
+
State,
|
|
6
|
+
} from "@real-router/core";
|
|
7
|
+
|
|
8
|
+
export interface RouteContext {
|
|
9
|
+
readonly navigator: Navigator;
|
|
10
|
+
readonly route: { readonly current: State | undefined };
|
|
11
|
+
readonly previousRoute: { readonly current: State | undefined };
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export interface LinkProps<P extends Params = Params> {
|
|
15
|
+
readonly routeName: string;
|
|
16
|
+
readonly routeParams?: P;
|
|
17
|
+
readonly routeOptions?: NavigationOptions;
|
|
18
|
+
readonly class?: string;
|
|
19
|
+
readonly activeClassName?: string;
|
|
20
|
+
readonly activeStrict?: boolean;
|
|
21
|
+
readonly ignoreQueryParams?: boolean;
|
|
22
|
+
readonly target?: string;
|
|
23
|
+
}
|