2022-06-21 05:18:06 +00:00
|
|
|
// NIRAX --- A lightweight router
|
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
import { EventEmitter } from "eventemitter3";
|
|
|
|
import { Ref, Component, ref, shallowRef, ShallowRef } from "vue";
|
|
|
|
import { pleaseLogin } from "@/scripts/please-login";
|
|
|
|
import { safeURIDecode } from "@/scripts/safe-uri-decode";
|
2022-06-20 08:38:49 +00:00
|
|
|
|
|
|
|
type RouteDef = {
|
|
|
|
path: string;
|
|
|
|
component: Component;
|
|
|
|
query?: Record<string, string>;
|
2022-06-29 09:26:06 +00:00
|
|
|
loginRequired?: boolean;
|
2022-06-20 08:38:49 +00:00
|
|
|
name?: string;
|
2022-06-29 07:00:00 +00:00
|
|
|
hash?: string;
|
2022-06-20 08:38:49 +00:00
|
|
|
globalCacheKey?: string;
|
2022-07-20 10:59:27 +00:00
|
|
|
children?: RouteDef[];
|
2022-06-20 08:38:49 +00:00
|
|
|
};
|
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
type ParsedPath = (
|
|
|
|
| string
|
|
|
|
| {
|
|
|
|
name: string;
|
|
|
|
startsWith?: string;
|
|
|
|
wildcard?: boolean;
|
|
|
|
optional?: boolean;
|
|
|
|
}
|
|
|
|
)[];
|
|
|
|
|
|
|
|
export type Resolved = {
|
|
|
|
route: RouteDef;
|
|
|
|
props: Map<string, string>;
|
|
|
|
child?: Resolved;
|
|
|
|
};
|
2022-07-20 10:59:27 +00:00
|
|
|
|
2022-06-20 08:38:49 +00:00
|
|
|
function parsePath(path: string): ParsedPath {
|
|
|
|
const res = [] as ParsedPath;
|
|
|
|
|
|
|
|
path = path.substring(1);
|
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
for (const part of path.split("/")) {
|
|
|
|
if (part.includes(":")) {
|
|
|
|
const prefix = part.substring(0, part.indexOf(":"));
|
|
|
|
const placeholder = part.substring(part.indexOf(":") + 1);
|
|
|
|
const wildcard = placeholder.includes("(*)");
|
|
|
|
const optional = placeholder.endsWith("?");
|
2022-06-20 08:38:49 +00:00
|
|
|
res.push({
|
2023-01-13 04:40:33 +00:00
|
|
|
name: placeholder.replace("(*)", "").replace("?", ""),
|
|
|
|
startsWith: prefix !== "" ? prefix : undefined,
|
2022-06-20 08:38:49 +00:00
|
|
|
wildcard,
|
|
|
|
optional,
|
|
|
|
});
|
2022-06-23 16:26:15 +00:00
|
|
|
} else if (part.length !== 0) {
|
2022-06-20 08:38:49 +00:00
|
|
|
res.push(part);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return res;
|
|
|
|
}
|
|
|
|
|
|
|
|
export class Router extends EventEmitter<{
|
|
|
|
change: (ctx: {
|
|
|
|
beforePath: string;
|
|
|
|
path: string;
|
2022-07-20 10:59:27 +00:00
|
|
|
resolved: Resolved;
|
|
|
|
key: string;
|
|
|
|
}) => void;
|
|
|
|
replace: (ctx: {
|
|
|
|
path: string;
|
2022-06-20 08:38:49 +00:00
|
|
|
key: string;
|
|
|
|
}) => void;
|
|
|
|
push: (ctx: {
|
|
|
|
beforePath: string;
|
|
|
|
path: string;
|
|
|
|
route: RouteDef | null;
|
|
|
|
props: Map<string, string> | null;
|
|
|
|
key: string;
|
|
|
|
}) => void;
|
2022-07-05 13:25:27 +00:00
|
|
|
same: () => void;
|
2022-06-20 08:38:49 +00:00
|
|
|
}> {
|
|
|
|
private routes: RouteDef[];
|
2022-07-20 10:59:27 +00:00
|
|
|
public current: Resolved;
|
|
|
|
public currentRef: ShallowRef<Resolved> = shallowRef();
|
|
|
|
public currentRoute: ShallowRef<RouteDef> = shallowRef();
|
2022-06-20 08:38:49 +00:00
|
|
|
private currentPath: string;
|
|
|
|
private currentKey = Date.now().toString();
|
|
|
|
|
2022-07-16 20:12:22 +00:00
|
|
|
public navHook: ((path: string, flag?: any) => boolean) | null = null;
|
2022-06-20 08:38:49 +00:00
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
constructor(routes: Router["routes"], currentPath: Router["currentPath"]) {
|
2022-06-20 08:38:49 +00:00
|
|
|
super();
|
|
|
|
|
|
|
|
this.routes = routes;
|
|
|
|
this.currentPath = currentPath;
|
2022-07-20 10:59:27 +00:00
|
|
|
this.navigate(currentPath, null, false);
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
public resolve(path: string): Resolved | null {
|
2022-06-20 08:38:49 +00:00
|
|
|
let queryString: string | null = null;
|
2022-06-29 07:00:00 +00:00
|
|
|
let hash: string | null = null;
|
2023-01-13 04:40:33 +00:00
|
|
|
if (path[0] === "/") path = path.substring(1);
|
|
|
|
if (path.includes("#")) {
|
|
|
|
hash = path.substring(path.indexOf("#") + 1);
|
|
|
|
path = path.substring(0, path.indexOf("#"));
|
2022-06-29 07:00:00 +00:00
|
|
|
}
|
2023-01-13 04:40:33 +00:00
|
|
|
if (path.includes("?")) {
|
|
|
|
queryString = path.substring(path.indexOf("?") + 1);
|
|
|
|
path = path.substring(0, path.indexOf("?"));
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
if (_DEV_) console.log("Routing: ", path, queryString);
|
2022-06-20 08:38:49 +00:00
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
function check(routes: RouteDef[], _parts: string[]): Resolved | null {
|
2023-01-13 04:40:33 +00:00
|
|
|
forEachRouteLoop: for (const route of routes) {
|
|
|
|
let parts = [..._parts];
|
2022-07-20 10:59:27 +00:00
|
|
|
const props = new Map<string, string>();
|
2022-06-20 08:38:49 +00:00
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
pathMatchLoop: for (const p of parsePath(route.path)) {
|
|
|
|
if (typeof p === "string") {
|
2022-07-20 10:59:27 +00:00
|
|
|
if (p === parts[0]) {
|
|
|
|
parts.shift();
|
|
|
|
} else {
|
|
|
|
continue forEachRouteLoop;
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
} else {
|
2022-07-20 10:59:27 +00:00
|
|
|
if (parts[0] == null && !p.optional) {
|
|
|
|
continue forEachRouteLoop;
|
|
|
|
}
|
|
|
|
if (p.wildcard) {
|
|
|
|
if (parts.length !== 0) {
|
2023-01-13 04:40:33 +00:00
|
|
|
props.set(p.name, safeURIDecode(parts.join("/")));
|
2022-07-20 10:59:27 +00:00
|
|
|
parts = [];
|
|
|
|
}
|
|
|
|
break pathMatchLoop;
|
2022-06-21 05:12:39 +00:00
|
|
|
} else {
|
2022-07-20 10:59:27 +00:00
|
|
|
if (p.startsWith) {
|
2023-01-13 04:40:33 +00:00
|
|
|
if (parts[0] == null || !parts[0].startsWith(p.startsWith))
|
|
|
|
continue forEachRouteLoop;
|
2022-07-20 10:59:27 +00:00
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
props.set(
|
|
|
|
p.name,
|
|
|
|
safeURIDecode(parts[0].substring(p.startsWith.length)),
|
|
|
|
);
|
2022-07-20 10:59:27 +00:00
|
|
|
parts.shift();
|
|
|
|
} else {
|
|
|
|
if (parts[0]) {
|
|
|
|
props.set(p.name, safeURIDecode(parts[0]));
|
|
|
|
}
|
|
|
|
parts.shift();
|
2022-07-13 09:28:04 +00:00
|
|
|
}
|
2022-06-21 05:12:39 +00:00
|
|
|
}
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
if (parts.length === 0) {
|
|
|
|
if (route.children) {
|
|
|
|
const child = check(route.children, []);
|
|
|
|
if (child) {
|
|
|
|
return {
|
|
|
|
route,
|
|
|
|
props,
|
|
|
|
child,
|
|
|
|
};
|
|
|
|
} else {
|
|
|
|
continue forEachRouteLoop;
|
|
|
|
}
|
|
|
|
}
|
2022-06-20 08:38:49 +00:00
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
if (route.hash != null && hash != null) {
|
|
|
|
props.set(route.hash, safeURIDecode(hash));
|
|
|
|
}
|
2023-01-13 04:40:33 +00:00
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
if (route.query != null && queryString != null) {
|
2023-01-13 04:40:33 +00:00
|
|
|
const queryObject = [
|
|
|
|
...new URLSearchParams(queryString).entries(),
|
|
|
|
].reduce((obj, entry) => ({ ...obj, [entry[0]]: entry[1] }), {});
|
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
for (const q in route.query) {
|
|
|
|
const as = route.query[q];
|
|
|
|
if (queryObject[q]) {
|
|
|
|
props.set(as, safeURIDecode(queryObject[q]));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2023-01-13 04:40:33 +00:00
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
return {
|
|
|
|
route,
|
|
|
|
props,
|
|
|
|
};
|
|
|
|
} else {
|
|
|
|
if (route.children) {
|
|
|
|
const child = check(route.children, parts);
|
|
|
|
if (child) {
|
|
|
|
return {
|
|
|
|
route,
|
|
|
|
props,
|
|
|
|
child,
|
|
|
|
};
|
|
|
|
} else {
|
|
|
|
}
|
|
|
|
} else {
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2022-06-29 07:00:00 +00:00
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
return null;
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
const _parts = path.split("/").filter((part) => part.length !== 0);
|
2022-07-20 10:59:27 +00:00
|
|
|
|
|
|
|
return check(this.routes, _parts);
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
|
2023-01-13 04:40:33 +00:00
|
|
|
private navigate(
|
|
|
|
path: string,
|
|
|
|
key: string | null | undefined,
|
|
|
|
emitChange = true,
|
|
|
|
) {
|
2022-06-20 08:38:49 +00:00
|
|
|
const beforePath = this.currentPath;
|
|
|
|
this.currentPath = path;
|
|
|
|
|
|
|
|
const res = this.resolve(this.currentPath);
|
|
|
|
|
|
|
|
if (res == null) {
|
2023-01-13 04:40:33 +00:00
|
|
|
throw new Error(`no route found for: ${path}`);
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
|
2022-06-29 09:26:06 +00:00
|
|
|
if (res.route.loginRequired) {
|
2023-01-13 04:40:33 +00:00
|
|
|
pleaseLogin("/");
|
2022-06-29 09:26:06 +00:00
|
|
|
}
|
|
|
|
|
2022-06-20 08:38:49 +00:00
|
|
|
const isSamePath = beforePath === path;
|
|
|
|
if (isSamePath && key == null) key = this.currentKey;
|
2022-07-20 10:59:27 +00:00
|
|
|
this.current = res;
|
|
|
|
this.currentRef.value = res;
|
2022-06-20 08:38:49 +00:00
|
|
|
this.currentRoute.value = res.route;
|
2022-07-20 10:59:27 +00:00
|
|
|
this.currentKey = res.route.globalCacheKey ?? key ?? path;
|
2022-06-20 08:38:49 +00:00
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
if (emitChange) {
|
2023-01-13 04:40:33 +00:00
|
|
|
this.emit("change", {
|
2022-06-20 08:38:49 +00:00
|
|
|
beforePath,
|
|
|
|
path,
|
2022-07-20 10:59:27 +00:00
|
|
|
resolved: res,
|
2022-06-20 08:38:49 +00:00
|
|
|
key: this.currentKey,
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
return res;
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
public getCurrentPath() {
|
|
|
|
return this.currentPath;
|
|
|
|
}
|
|
|
|
|
|
|
|
public getCurrentKey() {
|
|
|
|
return this.currentKey;
|
|
|
|
}
|
|
|
|
|
2022-07-16 20:12:22 +00:00
|
|
|
public push(path: string, flag?: any) {
|
2022-07-05 13:25:27 +00:00
|
|
|
const beforePath = this.currentPath;
|
|
|
|
if (path === beforePath) {
|
2023-01-13 04:40:33 +00:00
|
|
|
this.emit("same");
|
2022-07-05 13:25:27 +00:00
|
|
|
return;
|
|
|
|
}
|
2022-06-28 08:59:23 +00:00
|
|
|
if (this.navHook) {
|
2022-07-16 20:12:22 +00:00
|
|
|
const cancel = this.navHook(path, flag);
|
2022-06-28 08:59:23 +00:00
|
|
|
if (cancel) return;
|
|
|
|
}
|
2022-07-20 10:59:27 +00:00
|
|
|
const res = this.navigate(path, null);
|
2023-01-13 04:40:33 +00:00
|
|
|
this.emit("push", {
|
2022-06-20 08:38:49 +00:00
|
|
|
beforePath,
|
|
|
|
path,
|
2022-07-20 10:59:27 +00:00
|
|
|
route: res.route,
|
|
|
|
props: res.props,
|
2022-06-20 08:38:49 +00:00
|
|
|
key: this.currentKey,
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
2022-07-20 10:59:27 +00:00
|
|
|
public replace(path: string, key?: string | null, emitEvent = true) {
|
2022-06-20 08:38:49 +00:00
|
|
|
this.navigate(path, key);
|
2022-07-20 10:59:27 +00:00
|
|
|
if (emitEvent) {
|
2023-01-13 04:40:33 +00:00
|
|
|
this.emit("replace", {
|
2022-07-20 10:59:27 +00:00
|
|
|
path,
|
|
|
|
key: this.currentKey,
|
|
|
|
});
|
|
|
|
}
|
2022-06-20 08:38:49 +00:00
|
|
|
}
|
|
|
|
}
|