@yoyaflow/yoya-ui 0.3.2 → 0.4.0

package/dist/yoya.router.js

@@ -0,0 +1,1330 @@
+import { A as themeBorder, Di as applyElementOptions, E as replaceChildren, Ei as ViewNode, Mi as registerChildFactories, Pi as vText, _i as bindDocumentEvent, a as parseState, b as normalizeChildren, c as resolveLocale, i as mount, j as themeValue, ji as normalizeSetupArguments, l as serializeState, n as hydrate, o as renderPage, r as hydrateOrMount, s as renderToString, t as PageDocumentNode, vi as bindWindowEvent, wi as ElementNode, yi as injectDocumentStyle } from "./yoya.core.chunk.js";
+
+//#region src/router/router.js
+const maxVisibleTitles = 8;
+let scrollbarStyle = null;
+function ensureScrollbarStyle() {
+	if (scrollbarStyle) return;
+	scrollbarStyle = injectDocumentStyle(`.yoya-vrouter-views-titlebar,
+.yoya-vrouter-views-popup {
+  -ms-overflow-style: none;
+  scrollbar-width: none;
+}
+.yoya-vrouter-views-titlebar::-webkit-scrollbar,
+.yoya-vrouter-views-popup::-webkit-scrollbar {
+  display: none;
+  height: 0;
+  width: 0;
+}
+.yoya-vrouter-views-popup-item:hover {
+  background: var(--yoya-color-surface-hover, #eef3f9);
+}
+.yoya-vrouter-views-popup-item[aria-current='true'] {
+  background: var(--yoya-color-primary-subtle, #e8f0fe);
+  color: var(--yoya-color-primary, #1f6feb);
+}
+.yoya-vrouter-views-popup-close {
+  color: var(--yoya-color-text-secondary, #57606a);
+  opacity: 0.65;
+}
+.yoya-vrouter-views-popup-item:hover .yoya-vrouter-views-popup-close,
+.yoya-vrouter-views-popup-close:hover {
+  color: var(--yoya-color-text-danger, #b91c1c);
+  opacity: 1;
+}
+.yoya-vrouter-views-context-item:hover {
+  background: var(--yoya-color-surface-hover, #f6f8fa);
+}
+.yoya-vrouter-views-context-separator {
+  background: var(--yoya-color-border, #d0d7de);
+  height: 1px;
+  margin: 4px 6px;
+}`, "data-yoya-vrouter-views-popup-style");
+}
+function createRouterViewsStorageKey(routerInstance) {
+	const source = [routerInstance._defaultPath || "/", routerInstance._routes.map((route) => route.pattern).join("|")].join("::");
+	let hash = 0;
+	for (let index = 0; index < source.length; index += 1) hash = hash * 31 + source.charCodeAt(index) | 0;
+	return `yoya-ui:router-views:${(hash >>> 0).toString(36)}`;
+}
+function readSavedTabs(storageKey) {
+	if (typeof localStorage === "undefined") return null;
+	try {
+		const saved = JSON.parse(localStorage.getItem(storageKey) || "null");
+		return Array.isArray(saved?.paths) ? saved : null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Router 是一个很轻的 hash 路由出口。
+* 它负责路径匹配、参数提取、守卫和把路由视图渲染到自身节点内。
+*/
+var Router = class extends ElementNode {
+	constructor(setup = null) {
+		super("div");
+		this._routes = [];
+		this._defaultPath = null;
+		this._notFoundView = null;
+		this._beforeEach = null;
+		this._currentPath = "/";
+		this._currentParams = {};
+		this._currentQuery = {};
+		this._currentRoute = null;
+		this._currentView = null;
+		this._loadingView = null;
+		this._errorView = null;
+		this._navigationGeneration = 0;
+		this._outlet = this;
+		this._subscribers = /* @__PURE__ */ new Set();
+		this._ignoreNextHashPath = null;
+		this._mode = "hash";
+		this._started = false;
+		this._onHashChange = () => this._handleHashChange();
+		this._onPopState = () => this._handlePopState();
+		this.attr("data-yoya-router", "");
+		if (setup !== null) this.setup(setup);
+	}
+	setup(setup) {
+		if (typeof setup === "function") {
+			setup(this);
+			return this;
+		}
+		return super.setup(setup);
+	}
+	/**
+	* 设置无 hash 时进入的默认路径。
+	*/
+	default(path) {
+		this._defaultPath = normalizePath(path);
+		return this;
+	}
+	mode(value) {
+		if (value === void 0) return this._mode;
+		const nextMode = value === "history" ? "history" : "hash";
+		if (nextMode === this._mode) return this;
+		const wasStarted = this._started;
+		if (wasStarted) this.stop();
+		this._mode = nextMode;
+		if (wasStarted) this.start();
+		return this;
+	}
+	/**
+	* 添加路由。config 可以是视图函数，也可以是 { view/component, beforeEnter }。
+	*/
+	route(pattern, config) {
+		const route = normalizeRoute(pattern, config);
+		this._routes.push(route);
+		return this;
+	}
+	/**
+	* 设置未匹配路由的视图函数。
+	*/
+	notFound(view) {
+		this._notFoundView = view;
+		return this;
+	}
+	/**
+	* 设置异步路由视图加载中的默认视图。支持 ViewNode、文本或 (context) => view 函数。
+	*/
+	loading(view) {
+		this._loadingView = view;
+		return this;
+	}
+	/**
+	* 设置异步路由视图加载失败的默认视图。支持 ViewNode、文本或 (error, context) => view 函数。
+	*/
+	error(view) {
+		this._errorView = view;
+		return this;
+	}
+	/**
+	* 设置全局前置守卫，返回 false 时阻止导航。
+	*/
+	beforeEach(guard) {
+		this._beforeEach = guard;
+		return this;
+	}
+	start() {
+		if (!this._started) {
+			if (this._mode === "history") this._stopListening = bindWindowEvent("popstate", this._onPopState);
+			else this._stopListening = bindWindowEvent("hashchange", this._onHashChange);
+			this._started = true;
+		}
+		const currentPath = readPath(this._mode);
+		if ((this._mode === "history" ? currentPath === "/" || currentPath === "/index.html" : !window.location.hash) && this._defaultPath) return this.navigate(this._defaultPath, { replace: true });
+		return this.refresh();
+	}
+	stop() {
+		if (this._started) {
+			this._stopListening?.();
+			this._stopListening = null;
+			this._started = false;
+		}
+		return this;
+	}
+	/**
+	* 导航到指定路径。replace 为 true 时不新增浏览器历史记录。
+	*/
+	navigate(path, options = {}) {
+		const nextPath = normalizePath(path);
+		const resolved = this._resolve(nextPath);
+		if (!this._canEnter(resolved.context)) return this;
+		if (writePath(nextPath, options, this._mode) && !options.replace && this._mode === "hash") this._ignoreNextHashPath = nextPath;
+		this._renderResolved(resolved);
+		return this;
+	}
+	refresh() {
+		const nextPath = readPath(this._mode);
+		const resolved = this._resolve(nextPath);
+		if (!this._canEnter(resolved.context)) return this;
+		this._renderResolved(resolved);
+		return this;
+	}
+	/**
+	* 服务端渲染入口：按路径解析并渲染匹配视图到自身节点，不依赖 window。
+	* 守卫返回 false 时不提交；异步视图在服务端序列化其 loading 视图。
+	*/
+	renderPath(path) {
+		const resolved = this._resolve(path);
+		if (!this._canEnter(resolved.context)) return this;
+		this._renderResolved(resolved);
+		return this;
+	}
+	currentPath() {
+		return this._currentPath;
+	}
+	currentParams() {
+		return { ...this._currentParams };
+	}
+	currentQuery() {
+		return { ...this._currentQuery };
+	}
+	currentRoute() {
+		return this._currentRoute;
+	}
+	currentView() {
+		return this._currentView;
+	}
+	outlet(value) {
+		if (value === void 0) return this._outlet;
+		if (!(value instanceof ElementNode)) throw new TypeError("Router outlet must be an ElementNode");
+		this._outlet = value;
+		return this;
+	}
+	subscribe(listener) {
+		if (typeof listener !== "function") throw new TypeError("Router subscriber must be a function");
+		this._subscribers.add(listener);
+		return () => this._subscribers.delete(listener);
+	}
+	go(delta) {
+		window.history.go(delta);
+		return this;
+	}
+	back() {
+		return this.go(-1);
+	}
+	forward() {
+		return this.go(1);
+	}
+	destroy() {
+		this.stop();
+		this._navigationGeneration += 1;
+		this._destroyCurrentView();
+		this._subscribers.clear();
+		return super.destroy();
+	}
+	_resolve(path) {
+		const routeMatch = this._routes.map((route) => ({
+			route,
+			match: matchRoute(route.pattern, path)
+		})).find(({ match }) => match);
+		if (routeMatch) return {
+			context: createRouteContext(this, path, routeMatch.route, routeMatch.match),
+			route: routeMatch.route,
+			view: routeMatch.route.view
+		};
+		const parsed = parsePath(path);
+		return {
+			context: createRouteContext(this, path, null, {
+				params: {},
+				pathname: parsed.pathname,
+				query: parsed.query
+			}),
+			route: null,
+			view: this._notFoundView
+		};
+	}
+	_handleHashChange() {
+		const nextPath = readHashPath();
+		if (this._ignoreNextHashPath === nextPath) {
+			this._ignoreNextHashPath = null;
+			return this;
+		}
+		this._ignoreNextHashPath = null;
+		if (nextPath === this._currentPath) return this;
+		return this.refresh();
+	}
+	_handlePopState() {
+		this._ignoreNextHashPath = null;
+		return this.refresh();
+	}
+	_canEnter(to) {
+		const from = {
+			params: this.currentParams(),
+			path: this._currentPath,
+			query: this.currentQuery(),
+			route: this._currentRoute
+		};
+		if (this._beforeEach && this._beforeEach(to, from, this) === false) return false;
+		if (to.route?.beforeEnter && to.route.beforeEnter(to, from, this) === false) return false;
+		return true;
+	}
+	_renderResolved(resolved) {
+		const { context, route, view } = resolved;
+		const result = typeof view === "function" ? view(context) : view;
+		this._navigationGeneration += 1;
+		if (!isPromiseLike(result)) {
+			this._commitView(resolved, normalizeRouteView(result, context));
+			return;
+		}
+		const generation = this._navigationGeneration;
+		this._commitView(resolved, this._buildLoadingView(route, context));
+		Promise.resolve(result).then((value) => {
+			if (generation !== this._navigationGeneration || this._deleted) return value;
+			let nextView;
+			try {
+				nextView = normalizeRouteView(value, context);
+			} catch (error) {
+				this._commitView(resolved, this._buildErrorView(route, context, error));
+				return value;
+			}
+			this._commitView(resolved, nextView);
+			return value;
+		}, (error) => {
+			if (generation !== this._navigationGeneration || this._deleted) return error;
+			this._commitView(resolved, this._buildErrorView(route, context, error));
+			return error;
+		});
+	}
+	_commitView(resolved, nextView) {
+		const { context, route } = resolved;
+		const outlet = this._outlet;
+		this._destroyCurrentView();
+		outlet._children = [];
+		if (outlet._el) outlet._el.replaceChildren();
+		outlet.child(nextView);
+		this._currentPath = context.path;
+		this._currentParams = context.params;
+		this._currentQuery = context.query;
+		this._currentRoute = route;
+		this._currentView = nextView;
+		this._subscribers.forEach((listener) => listener(context, this));
+	}
+	_buildLoadingView(route, context) {
+		return resolveRouteEntry(route?.loading ?? this._loadingView ?? defaultLoadingView, [context]);
+	}
+	_buildErrorView(route, context, error) {
+		return resolveRouteEntry(route?.error ?? this._errorView ?? defaultErrorView, [error, context]);
+	}
+	_destroyCurrentView() {
+		if (this._currentView?.destroy) this._currentView.destroy();
+		this._currentView = null;
+	}
+};
+function createRouter(first = null, second = null, third = null) {
+	const args = normalizeSetupArguments(first, second, third);
+	const node = new Router(args.first);
+	applyElementOptions(node, args.options);
+	if (typeof args.callback === "function") args.callback(node);
+	return node;
+}
+const router = createRouter;
+function vRoute(pattern, config) {
+	return {
+		config,
+		pattern
+	};
+}
+function vRouter(first = null, second = null, third = null) {
+	const args = normalizeSetupArguments(first, second, third);
+	const node = new Router();
+	node.vRoute = (pattern, config) => {
+		node.route(pattern, config);
+		return node;
+	};
+	applyDeclarativeRouterSetup(node, args.first);
+	applyElementOptions(node, args.options);
+	if (typeof args.callback === "function") args.callback(node);
+	return node;
+}
+function vLink(routerInstance, setup = null, callback = null) {
+	assertRouter(routerInstance);
+	const node = new ElementNode("a");
+	const state = {
+		exact: true,
+		label: null,
+		params: {},
+		query: {},
+		replace: false,
+		to: "/"
+	};
+	const labelNode = new ElementNode("span").className("yoya-vlink-label");
+	node.className("yoya-vlink");
+	node.attr("data-router-link", "true");
+	node.child(labelNode);
+	node.to = (value) => updateLinkValue(node, state, "to", value);
+	node.params = (value) => updateLinkValue(node, state, "params", value || {});
+	node.query = (value) => updateLinkValue(node, state, "query", value || {});
+	node.replace = (value) => updateLinkValue(node, state, "replace", Boolean(value));
+	node.exact = (value) => updateLinkValue(node, state, "exact", Boolean(value));
+	node.label = (value) => {
+		if (value === void 0) return state.label;
+		state.label = value;
+		replaceChildren(labelNode, normalizeChildren(value));
+		return node;
+	};
+	applyLinkSetup(node, state, setup);
+	updateLink(node, state, routerInstance);
+	node.on("click", (event) => {
+		if (!shouldHandleLinkClick(event, node)) return;
+		event.preventDefault();
+		routerInstance.navigate(buildLinkPath(state.to, state.params, state.query), { replace: state.replace });
+	});
+	const unsubscribe = routerInstance.subscribe(() => updateLink(node, state, routerInstance));
+	const destroy = node.destroy.bind(node);
+	node.destroy = () => {
+		unsubscribe();
+		return destroy();
+	};
+	if (typeof callback === "function") callback(node);
+	return node;
+}
+function vRouterView(routerInstance, setup = null, callback = null) {
+	assertRouter(routerInstance);
+	const node = new ElementNode("div");
+	node.className("yoya-vrouter-view");
+	node.attr("data-router-view", "true");
+	if (typeof setup === "function") setup(node);
+	else if (setup) node.setup(setup);
+	routerInstance.outlet(node);
+	const destroy = node.destroy.bind(node);
+	node.destroy = () => {
+		if (routerInstance.outlet() === node) routerInstance.outlet(routerInstance);
+		return destroy();
+	};
+	if (typeof callback === "function") callback(node);
+	return node;
+}
+function vRouterViews(routerInstance, setup = null, callback = null) {
+	assertRouter(routerInstance);
+	const node = new ElementNode("div");
+	const titleNode = new ElementNode("header").className("yoya-vrouter-views-titlebar").attr({
+		role: "tablist",
+		"aria-label": "已打开页面"
+	});
+	const contentNode = new ElementNode("div").className("yoya-vrouter-views-content");
+	const moreButtonText = vText("⋯");
+	const moreButton = new ElementNode("button").className("yoya-vrouter-views-expand").attr({
+		type: "button",
+		"aria-expanded": "false",
+		"aria-label": "展开全部标签"
+	}).styles({
+		alignItems: "center",
+		background: "transparent",
+		border: "0",
+		color: themeValue("color-text-secondary", "#57606a"),
+		cursor: "pointer",
+		display: "none",
+		flexShrink: "0",
+		font: "inherit",
+		gap: "6px",
+		height: "24px",
+		justifyContent: "center",
+		lineHeight: "1",
+		marginBottom: "0",
+		marginLeft: "auto",
+		minWidth: "24px",
+		padding: "0",
+		position: "sticky",
+		right: "8px",
+		zIndex: "2"
+	}).child(moreButtonText);
+	const popup = new ElementNode("div").className("yoya-vrouter-views-popup").attr({
+		role: "menu",
+		"aria-label": "已打开页面"
+	}).styles({
+		background: themeValue("color-surface", "#ffffff"),
+		border: themeBorder("color-border", "#d0d7de"),
+		borderRadius: "8px",
+		boxShadow: "0 12px 28px rgba(15, 23, 42, 0.18)",
+		display: "none",
+		maxHeight: "280px",
+		maxWidth: "260px",
+		minWidth: "180px",
+		msOverflowStyle: "none",
+		overflowY: "auto",
+		padding: "6px",
+		position: "fixed",
+		scrollbarWidth: "none",
+		zIndex: "100"
+	});
+	const state = {
+		lockTitle: false,
+		overflow: false,
+		persist: true,
+		popupOpen: false,
+		storageKey: createRouterViewsStorageKey(routerInstance),
+		suppressPersist: false,
+		tabs: /* @__PURE__ */ new Map(),
+		title: "工作区",
+		titleResolver: null,
+		titlePosition: "top"
+	};
+	node.className("yoya-vrouter-views");
+	node.styles({
+		border: themeBorder("color-border", "#d0d7de"),
+		boxSizing: "border-box",
+		overflow: "hidden"
+	});
+	titleNode.styles({
+		background: themeValue("color-surface-hover", "#f6f8fa"),
+		borderBottom: themeBorder("color-border", "#d0d7de"),
+		boxSizing: "border-box",
+		color: themeValue("color-text-secondary", "#57606a"),
+		display: "flex",
+		flexWrap: "nowrap",
+		fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+		fontSize: "13px",
+		gap: "0px",
+		msOverflowStyle: "none",
+		overflowX: "auto",
+		overflowY: "hidden",
+		padding: "0px 0px",
+		scrollbarWidth: "none",
+		width: "100%"
+	});
+	contentNode.className("yoya-vrouter-views-content");
+	contentNode.styles({
+		minHeight: "120px",
+		padding: "16px"
+	});
+	node.child(titleNode, contentNode, popup);
+	const applyLockedTitle = () => {
+		const vertical = state.titlePosition !== "top";
+		if (state.lockTitle) {
+			node.styles({
+				display: "flex",
+				flexDirection: vertical ? "row" : "column",
+				height: "100%",
+				minHeight: "0",
+				overflow: "hidden"
+			});
+			titleNode.style("flex", "0 0 auto");
+			contentNode.styles({
+				flex: "1 1 auto",
+				minHeight: "0",
+				minWidth: "0",
+				overflow: "auto"
+			});
+			return;
+		}
+		node.styles({
+			flexDirection: null,
+			height: null,
+			minHeight: null,
+			overflow: "hidden"
+		});
+		titleNode.style("flex", null);
+		contentNode.styles({
+			flex: vertical ? "1 1 auto" : null,
+			minHeight: "120px",
+			minWidth: vertical ? "0" : null,
+			overflow: null
+		});
+	};
+	const applyTitlePosition = (position) => {
+		const vertical = position !== "top";
+		node.styles({
+			alignItems: vertical ? "stretch" : null,
+			display: vertical ? "flex" : null
+		});
+		titleNode.styles({
+			background: themeValue("color-surface-hover", "#f6f8fa"),
+			borderBottom: vertical ? null : themeBorder("color-border", "#d0d7de"),
+			borderLeft: position === "right" ? "1px solid" : null,
+			borderLeftColor: position === "right" ? themeValue("color-border", "#d0d7de") : null,
+			borderLeftStyle: position === "right" ? "solid" : null,
+			borderLeftWidth: position === "right" ? "1px" : null,
+			borderRight: position === "left" ? "1px solid" : null,
+			borderRightColor: position === "left" ? themeValue("color-border", "#d0d7de") : null,
+			borderRightStyle: position === "left" ? "solid" : null,
+			borderRightWidth: position === "left" ? "1px" : null,
+			boxSizing: "border-box",
+			color: themeValue("color-text-secondary", "#57606a"),
+			display: "flex",
+			flexDirection: vertical ? "column" : "row",
+			flexShrink: vertical ? "0" : null,
+			flexWrap: "nowrap",
+			fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+			fontSize: "13px",
+			gap: "0px",
+			msOverflowStyle: "none",
+			overflowX: vertical ? "hidden" : "auto",
+			overflowY: vertical ? "auto" : "hidden",
+			padding: vertical ? "10px 8px" : "0px 0px",
+			scrollbarWidth: "none",
+			width: vertical ? null : "100%"
+		});
+		contentNode.styles({
+			flex: vertical ? "1 1 auto" : null,
+			minWidth: vertical ? "0" : null
+		});
+		const orderedChildren = position === "right" ? [
+			contentNode,
+			titleNode,
+			popup
+		] : [
+			titleNode,
+			contentNode,
+			popup
+		];
+		node.clearChildren().child(orderedChildren);
+		if (node._el) orderedChildren.forEach((child) => {
+			const childElement = child.renderDom();
+			if (childElement) node._el.appendChild(childElement);
+		});
+		applyLockedTitle();
+	};
+	const resolveTitle = (context = {}) => {
+		let title = state.title;
+		const routeTitle = context.route?.title;
+		if (routeTitle !== void 0) title = typeof routeTitle === "function" ? routeTitle(context) : routeTitle;
+		if (state.titleResolver) {
+			const resolved = state.titleResolver(context);
+			if (resolved !== void 0 && resolved !== null) title = typeof resolved === "function" ? resolved(context) : resolved;
+		}
+		return title ?? "";
+	};
+	const styleTitleTab = (entry, active) => {
+		const tab = entry.tab;
+		const position = state.titlePosition;
+		const vertical = position !== "top";
+		entry.label.attr("aria-selected", String(active));
+		tab.styles({
+			background: active ? themeValue("color-surface", "#ffffff") : themeValue("color-surface-active", "#eaeef2"),
+			border: themeBorder("color-border", "#d0d7de"),
+			borderBottomColor: position === "top" ? active ? themeValue("color-surface", "#ffffff") : themeValue("color-border", "#d0d7de") : themeValue("color-border", "#d0d7de"),
+			borderLeftColor: "transparent",
+			borderRightColor: position === "left" ? active ? themeValue("color-surface", "#ffffff") : themeValue("color-border", "#d0d7de") : themeValue("color-border", "#d0d7de"),
+			color: active ? themeValue("color-text", "#24292f") : themeValue("color-text-secondary", "#57606a"),
+			fontWeight: active ? "600" : "400",
+			marginBottom: position === "top" ? "-9px" : "0",
+			marginLeft: position === "right" ? "-9px" : "0",
+			marginRight: position === "left" ? "-9px" : "0",
+			padding: vertical ? "8px 10px" : "7px 14px 8px"
+		});
+	};
+	const setOverflowButtonVisible = (visible) => {
+		state.overflow = Boolean(visible);
+		node.attr("data-title-overflow", state.overflow ? "true" : null);
+		moreButton.style("display", state.overflow ? "inline-flex" : "none");
+	};
+	const updateOverflow = () => {
+		if (state.titlePosition !== "top" || state.tabs.size <= maxVisibleTitles) {
+			setOverflowButtonVisible(false);
+			return;
+		}
+		setOverflowButtonVisible(true);
+	};
+	const syncMoreButton = () => {
+		const tabEntries = Array.from(state.tabs.entries());
+		const children = tabEntries.slice(0, maxVisibleTitles).map(([, entry]) => entry.tab).filter((child) => child !== moreButton);
+		if (!(tabEntries.length > maxVisibleTitles && state.titlePosition === "top")) {
+			if (state.popupOpen) closePopup();
+			titleNode._children = children;
+			titleNode._childrenDirty = true;
+			if (titleNode._el) titleNode._el.replaceChildren(...children.map((child) => child.renderDom()).filter(Boolean));
+			else moreButton._el?.remove();
+			setOverflowButtonVisible(false);
+			return;
+		}
+		titleNode._children = [...children, moreButton];
+		titleNode._childrenDirty = true;
+		if (titleNode._el) {
+			const childElements = children.map((child) => child.renderDom()).filter(Boolean);
+			titleNode._el.replaceChildren(...childElements, moreButton.renderDom());
+		}
+		updateOverflow();
+	};
+	const persistTabs = () => {
+		if (!state.persist || state.suppressPersist || typeof localStorage === "undefined") return;
+		try {
+			localStorage.setItem(state.storageKey, JSON.stringify({
+				activePath: routerInstance.currentPath(),
+				paths: Array.from(state.tabs.keys())
+			}));
+		} catch {}
+	};
+	let popupCleanup = null;
+	const closePopup = () => {
+		state.popupOpen = false;
+		node.attr("data-title-popup", null);
+		moreButton.attr("aria-expanded", "false");
+		popup.style("display", "none");
+		if (popupCleanup) {
+			popupCleanup();
+			popupCleanup = null;
+		}
+	};
+	const buildPopup = () => {
+		popup.clearChildren();
+		if (popup._el) popup._el.replaceChildren();
+		Array.from(state.tabs.entries()).slice(maxVisibleTitles).forEach(([path, entry]) => {
+			const title = entry.text.textContent();
+			const item = new ElementNode("div").className("yoya-vrouter-views-popup-item").attr({
+				role: "menuitem",
+				tabIndex: "0",
+				"data-router-view-path": path
+			}).styles({
+				alignItems: "center",
+				borderRadius: "6px",
+				color: themeValue("color-text", "#24292f"),
+				cursor: "pointer",
+				display: "flex",
+				fontSize: "13px",
+				gap: "8px",
+				padding: "7px 8px",
+				width: "100%"
+			});
+			const titleSpan = new ElementNode("span").className("yoya-vrouter-views-popup-title").styles({
+				flex: "1",
+				minWidth: "0",
+				overflow: "hidden",
+				textOverflow: "ellipsis",
+				whiteSpace: "nowrap"
+			}).text(title);
+			const closeButton = new ElementNode("button").className("yoya-vrouter-views-popup-close").attr({
+				type: "button",
+				"aria-label": `关闭 ${title}`
+			}).styles({
+				background: "transparent",
+				border: "0",
+				color: "inherit",
+				cursor: "pointer",
+				flexShrink: "0",
+				font: "inherit",
+				lineHeight: "1",
+				padding: "2px 4px"
+			}).text("×");
+			if (path === routerInstance.currentPath()) {
+				item.attr("aria-current", "true");
+				item.styles({
+					background: themeValue("color-primary-subtle", "#e8f0fe"),
+					color: themeValue("color-primary", "#1f6feb")
+				});
+			}
+			const activate = () => {
+				closePopup();
+				routerInstance.navigate(path);
+			};
+			item.on("click", activate);
+			item.on("keydown", (event) => {
+				if (event.key === "Enter" || event.key === " ") {
+					event.preventDefault();
+					activate();
+				}
+			});
+			closeButton.on("click", (event) => {
+				event.stopPropagation();
+				closeTitleTab(path, event);
+				if (state.popupOpen) buildPopup();
+			});
+			item.child(titleSpan, closeButton);
+			popup.child(item);
+		});
+	};
+	const openPopup = () => {
+		if (state.tabs.size === 0) return;
+		ensureScrollbarStyle();
+		buildPopup();
+		state.popupOpen = true;
+		node.attr("data-title-popup", "true");
+		moreButton.attr("aria-expanded", "true");
+		popup.styles({ display: "block" });
+		placePopup();
+		const handleDocumentClick = (event) => {
+			if (!popup._el?.contains(event.target) && !moreButton._el?.contains(event.target)) closePopup();
+		};
+		const handleKeydown = (event) => {
+			if (event.key === "Escape") closePopup();
+		};
+		const handleScroll = () => placePopup();
+		const handleResize = () => placePopup();
+		const unbindClick = bindDocumentEvent("click", handleDocumentClick);
+		const unbindKeydown = bindDocumentEvent("keydown", handleKeydown);
+		const unbindScroll = bindWindowEvent("scroll", handleScroll, true);
+		const unbindResize = bindWindowEvent("resize", handleResize);
+		popupCleanup = () => {
+			unbindClick();
+			unbindKeydown();
+			unbindScroll();
+			unbindResize();
+		};
+		function placePopup() {
+			const buttonRect = moreButton._el?.getBoundingClientRect();
+			const popupRect = popup._el?.getBoundingClientRect();
+			if (!buttonRect || !popupRect) return;
+			const viewportWidth = window.innerWidth || document.documentElement?.clientWidth || 0;
+			const viewportHeight = window.innerHeight || document.documentElement?.clientHeight || 0;
+			const edge = 8;
+			let left = buttonRect.right - popupRect.width;
+			left = Math.max(edge, Math.min(left, viewportWidth - popupRect.width - edge));
+			let top = buttonRect.bottom + 4;
+			if (top + popupRect.height + edge > viewportHeight) top = Math.max(edge, buttonRect.top - popupRect.height - 4);
+			popup.styles({
+				left: `${left}px`,
+				top: `${top}px`
+			});
+		}
+	};
+	moreButton.on("click", () => {
+		if (state.popupOpen) closePopup();
+		else openPopup();
+	});
+	const renderDom = node.renderDom.bind(node);
+	node.renderDom = () => {
+		ensureScrollbarStyle();
+		const element = renderDom();
+		updateOverflow();
+		return element;
+	};
+	node.updateOverflow = updateOverflow;
+	node.titlePosition = (value) => {
+		if (value === void 0) return state.titlePosition;
+		const next = normalizeTitlePosition(value);
+		state.titlePosition = next;
+		if (next !== "top" && state.popupOpen) closePopup();
+		node.attr("data-title-position", state.titlePosition);
+		titleNode.attr("aria-orientation", state.titlePosition === "top" ? "horizontal" : "vertical");
+		applyTitlePosition(state.titlePosition);
+		syncMoreButton();
+		state.tabs.forEach((entry, path) => {
+			styleTitleTab(entry, path === routerInstance.currentPath());
+		});
+		updateOverflow();
+		return node;
+	};
+	node.titlePosition(state.titlePosition);
+	node.lockTitle = (value = true) => {
+		if (value === void 0) return state.lockTitle;
+		state.lockTitle = Boolean(value);
+		node.attr("data-title-locked", state.lockTitle ? "true" : null);
+		applyTitlePosition(state.titlePosition);
+		updateOverflow();
+		return node;
+	};
+	node.titleLocked = node.lockTitle;
+	const closeTitleTab = (path, event = null) => {
+		if (event) event.stopPropagation();
+		const closingIndex = Array.from(state.tabs.entries()).findIndex(([tabPath]) => tabPath === path);
+		const entry = state.tabs.get(path);
+		if (!entry) return;
+		const wasActive = entry.label.attr("aria-selected") === "true";
+		state.tabs.delete(path);
+		titleNode._children = titleNode.children().filter((child) => child !== entry.tab);
+		titleNode._childrenDirty = true;
+		entry.tab.destroy();
+		syncMoreButton();
+		persistTabs();
+		if (!wasActive) return;
+		const remainingPaths = Array.from(state.tabs.keys());
+		if (remainingPaths.length > 0) {
+			const nextPath = remainingPaths[Math.min(closingIndex, remainingPaths.length - 1)];
+			routerInstance.navigate(nextPath, { replace: true });
+			return;
+		}
+		contentNode.clearChildren().commit();
+		routerInstance._navigationGeneration += 1;
+		routerInstance._currentView = null;
+	};
+	const titleContextMenu = new ElementNode("div").className("yoya-vrouter-views-context").attr({
+		role: "menu",
+		"aria-label": "标签页操作"
+	}).styles({
+		background: themeValue("color-surface", "#ffffff"),
+		border: themeBorder("color-border", "#d0d7de"),
+		borderRadius: "8px",
+		boxShadow: "0 12px 28px rgba(15, 23, 42, 0.18)",
+		display: "none",
+		minWidth: "180px",
+		padding: "6px",
+		position: "fixed",
+		zIndex: "100"
+	});
+	let contextMenuCleanup = null;
+	const closeTabContextMenu = () => {
+		titleContextMenu.styles({ display: "none" });
+		titleContextMenu.clearChildren();
+		titleContextMenu._el?.remove();
+		if (contextMenuCleanup) {
+			contextMenuCleanup();
+			contextMenuCleanup = null;
+		}
+	};
+	const closeTabs = (pathsToClose, activatePath = null) => {
+		const closing = new Set(pathsToClose);
+		const entries = Array.from(state.tabs.entries());
+		const closingIndex = entries.findIndex(([tabPath]) => closing.has(tabPath));
+		entries.forEach(([tabPath, entry]) => {
+			if (!closing.has(tabPath)) return;
+			state.tabs.delete(tabPath);
+			titleNode._children = titleNode.children().filter((child) => child !== entry.tab);
+			titleNode._childrenDirty = true;
+			entry.tab.destroy();
+		});
+		syncMoreButton();
+		persistTabs();
+		if (state.popupOpen) buildPopup();
+		if (!closing.has(routerInstance.currentPath())) return;
+		const remaining = Array.from(state.tabs.keys());
+		if (remaining.length === 0) {
+			contentNode.clearChildren().commit();
+			routerInstance._navigationGeneration += 1;
+			routerInstance._currentView = null;
+			return;
+		}
+		const target = activatePath && state.tabs.has(activatePath) ? activatePath : remaining[Math.min(Math.max(closingIndex, 0), remaining.length - 1)];
+		routerInstance.navigate(target, { replace: true });
+	};
+	const copyTabUrl = (path) => {
+		if (typeof navigator === "undefined" || !navigator.clipboard) return;
+		const origin = typeof window === "undefined" ? "" : window.location.origin;
+		const pathname = typeof window === "undefined" ? "" : window.location.pathname;
+		const url = routerInstance.mode() === "history" ? `${origin}${pathname}${path}` : `${origin}${pathname}#${path}`;
+		navigator.clipboard.writeText(url).catch(() => {});
+	};
+	const openTabContextMenu = (path, event) => {
+		if (state.popupOpen) closePopup();
+		closeTabContextMenu();
+		const entries = Array.from(state.tabs.entries());
+		const clickedIndex = entries.findIndex(([tabPath]) => tabPath === path);
+		const closeOthers = () => closeTabs(entries.filter(([tabPath]) => tabPath !== path).map(([tabPath]) => tabPath), path);
+		const closeLeft = () => closeTabs(entries.slice(0, clickedIndex).map(([tabPath]) => tabPath), path);
+		const closeRight = () => closeTabs(entries.slice(clickedIndex + 1).map(([tabPath]) => tabPath), path);
+		const closeAll = () => closeTabs(entries.map(([tabPath]) => tabPath));
+		const addItem = (label, action, danger = false, disabled = false) => {
+			const item = new ElementNode("div").className("yoya-vrouter-views-context-item").attr({
+				role: "menuitem",
+				tabIndex: "0"
+			}).text(label).styles({
+				alignItems: "center",
+				borderRadius: "6px",
+				color: danger ? themeValue("color-text-danger", "#b91c1c") : themeValue("color-text", "#24292f"),
+				cursor: disabled ? "default" : "pointer",
+				display: "flex",
+				fontSize: "13px",
+				gap: "8px",
+				padding: "7px 10px",
+				width: "100%"
+			});
+			if (disabled) {
+				item.attr("aria-disabled", "true");
+				item.styles({ opacity: "0.4" });
+			} else item.on("click", () => {
+				closeTabContextMenu();
+				action();
+			});
+			titleContextMenu.child(item);
+			return item;
+		};
+		const addSeparator = () => titleContextMenu.child(new ElementNode("div").className("yoya-vrouter-views-context-separator"));
+		addItem("刷新", () => routerInstance.navigate(path, { replace: true }));
+		addItem("复制链接", () => copyTabUrl(path));
+		addSeparator();
+		addItem("关闭", () => closeTitleTab(path), true);
+		addItem("关闭其他", closeOthers, false, entries.length <= 1);
+		addItem("关闭左侧", closeLeft, false, clickedIndex <= 0);
+		addItem("关闭右侧", closeRight, false, clickedIndex === entries.length - 1);
+		addSeparator();
+		addItem("关闭全部", closeAll, true, entries.length === 0);
+		titleContextMenu.bindTo(document.body);
+		titleContextMenu.styles({ display: "block" });
+		const rect = titleContextMenu._el.getBoundingClientRect();
+		const viewportWidth = typeof window === "undefined" ? 0 : window.innerWidth || 0;
+		const viewportHeight = typeof window === "undefined" ? 0 : window.innerHeight || 0;
+		const edge = 8;
+		const left = Math.max(edge, Math.min(event.clientX || 0, viewportWidth - rect.width - edge));
+		const top = Math.max(edge, Math.min(event.clientY || 0, viewportHeight - rect.height - edge));
+		titleContextMenu.styles({
+			left: `${left}px`,
+			top: `${top}px`
+		});
+		const handlePointerDown = (pointerEvent) => {
+			if (!titleContextMenu._el?.contains(pointerEvent.target)) closeTabContextMenu();
+		};
+		const handleKeydown = (keyEvent) => {
+			if (keyEvent.key === "Escape") closeTabContextMenu();
+		};
+		const handleScroll = () => closeTabContextMenu();
+		const unbindPointerDown = bindDocumentEvent("mousedown", handlePointerDown);
+		const unbindKeydown = bindDocumentEvent("keydown", handleKeydown);
+		const unbindScroll = bindWindowEvent("scroll", handleScroll, true);
+		const unbindResize = bindWindowEvent("resize", handleScroll);
+		contextMenuCleanup = () => {
+			unbindPointerDown();
+			unbindKeydown();
+			unbindScroll();
+			unbindResize();
+		};
+	};
+	const updateTitle = (context = {}) => {
+		const path = context.path || routerInstance.currentPath();
+		const visiblePaths = new Set(state.titlePosition === "top" ? Array.from(state.tabs.keys()).slice(0, maxVisibleTitles) : Array.from(state.tabs.keys()));
+		let entry = state.tabs.get(path);
+		if (!entry) {
+			const tab = new ElementNode("div").className("yoya-vrouter-views-title");
+			const text = vText(resolveTitle(context));
+			const label = new ElementNode("button").className("yoya-vrouter-views-label").child(text);
+			const closeButton = new ElementNode("button").className("yoya-vrouter-views-close");
+			tab.attr({ "data-router-view-path": path });
+			tab.styles({
+				alignItems: "center",
+				cursor: "pointer",
+				display: "inline-flex",
+				font: "inherit",
+				gap: "8px",
+				whiteSpace: "nowrap"
+			});
+			label.attr({
+				role: "tab",
+				type: "button"
+			});
+			label.styles({
+				background: "transparent",
+				border: "0",
+				color: "inherit",
+				cursor: "pointer",
+				font: "inherit",
+				padding: "0"
+			});
+			label.on("click", () => routerInstance.navigate(path));
+			closeButton.attr({
+				type: "button",
+				"aria-label": `关闭 ${resolveTitle(context)}`
+			});
+			closeButton.styles({
+				background: "transparent",
+				border: "0",
+				color: "inherit",
+				cursor: "pointer",
+				font: "inherit",
+				lineHeight: "1",
+				padding: "0"
+			});
+			closeButton.text("×");
+			closeButton.on("click", (event) => closeTitleTab(path, event));
+			tab.on("contextmenu", (event) => {
+				event.preventDefault();
+				event.stopPropagation();
+				openTabContextMenu(path, event);
+			});
+			tab.child(label, closeButton);
+			titleNode.child(tab);
+			entry = {
+				closeButton,
+				label,
+				tab,
+				text
+			};
+			state.tabs.set(path, entry);
+			styleTitleTab(entry, false);
+		} else {
+			const title = resolveTitle(context);
+			entry.text.textContent(title);
+			entry.closeButton.attr("aria-label", `关闭 ${title}`);
+		}
+		if (!visiblePaths.has(path)) {
+			state.tabs.delete(path);
+			state.tabs = new Map([[path, entry], ...state.tabs]);
+		}
+		state.tabs.forEach((entry, tabPath) => styleTitleTab(entry, tabPath === path));
+		syncMoreButton();
+		if (state.popupOpen) buildPopup();
+		persistTabs();
+	};
+	const restoreTabs = () => {
+		if (!state.persist) return;
+		const saved = readSavedTabs(state.storageKey);
+		if (!saved) return;
+		state.suppressPersist = true;
+		try {
+			saved.paths.slice().reverse().forEach((path) => {
+				const resolved = routerInstance._resolve(path);
+				updateTitle({
+					...resolved.context,
+					path
+				});
+			});
+		} finally {
+			state.suppressPersist = false;
+			persistTabs();
+		}
+	};
+	if (typeof setup === "function") setup(node);
+	else if (setup && typeof setup === "object") {
+		const { persist, storageKey, title, titlePosition, titleResolver, ...elementConfig } = setup;
+		if (title !== void 0) state.title = title;
+		if (persist !== void 0) state.persist = Boolean(persist);
+		if (storageKey !== void 0) state.storageKey = storageKey;
+		if (titlePosition !== void 0) node.titlePosition(titlePosition);
+		if (typeof titleResolver === "function") state.titleResolver = titleResolver;
+		if (Object.keys(elementConfig).length > 0) node.setup(elementConfig);
+	}
+	routerInstance.outlet(contentNode);
+	restoreTabs();
+	if (routerInstance.currentRoute() || routerInstance.currentPath() !== "/") updateTitle({
+		params: routerInstance.currentParams(),
+		path: routerInstance.currentPath(),
+		query: routerInstance.currentQuery(),
+		route: routerInstance.currentRoute(),
+		router: routerInstance
+	});
+	const unsubscribe = routerInstance.subscribe((context) => updateTitle(context));
+	const handleResize = () => updateOverflow();
+	const unbindResize = bindWindowEvent("resize", handleResize);
+	const destroy = node.destroy.bind(node);
+	node.destroy = () => {
+		if (state.popupOpen) closePopup();
+		closeTabContextMenu();
+		unbindResize();
+		unsubscribe();
+		if (routerInstance.outlet() === contentNode) routerInstance.outlet(routerInstance);
+		return destroy();
+	};
+	if (typeof callback === "function") callback(node);
+	return node;
+}
+registerChildFactories(ElementNode, {
+	vLink,
+	vRouter,
+	vRouterView,
+	vRouterViews
+});
+function normalizeRoute(pattern, config) {
+	const route = {
+		beforeEnter: null,
+		error: null,
+		loading: null,
+		pattern: normalizePattern(pattern),
+		title: null,
+		view: null
+	};
+	if (typeof config === "function" || config instanceof ViewNode || isTextLike(config)) {
+		route.view = config;
+		return route;
+	}
+	if (config && typeof config === "object") {
+		route.beforeEnter = config.beforeEnter || null;
+		route.error = config.error ?? null;
+		route.loading = config.loading ?? null;
+		route.title = config.title ?? null;
+		route.view = config.view || config.component || null;
+	}
+	return route;
+}
+function assertRouter(routerInstance) {
+	if (!(routerInstance instanceof Router)) throw new TypeError("vLink and vRouterView require a Router instance");
+}
+function normalizeTitlePosition(value) {
+	return value === "left" || value === "right" ? value : "top";
+}
+function applyDeclarativeRouterSetup(node, setup) {
+	if (typeof setup === "function") {
+		setup(node);
+		return node;
+	}
+	if (!setup || typeof setup !== "object") return node;
+	const { beforeEach, default: defaultPath, error, loading, notFound, routes = [], ...elementConfig } = setup;
+	if (Object.keys(elementConfig).length) node.setup(elementConfig);
+	if (defaultPath !== void 0) node.default(defaultPath);
+	if (beforeEach) node.beforeEach(beforeEach);
+	if (loading !== void 0) node.loading(loading);
+	if (error !== void 0) node.error(error);
+	routes.forEach((declaration) => {
+		if (declaration?.pattern !== void 0) node.vRoute(declaration.pattern, declaration.config);
+	});
+	if (notFound !== void 0) node.notFound(notFound);
+	return node;
+}
+function applyLinkSetup(node, state, setup) {
+	if (typeof setup === "function") {
+		setup(node);
+		return;
+	}
+	if (typeof setup === "string") {
+		node.to(setup);
+		node.label(setup);
+		return;
+	}
+	if (!setup) return;
+	const { exact, label, params, query, replace, to, ...elementConfig } = setup;
+	if (Object.keys(elementConfig).length) node.setup(elementConfig);
+	if (to !== void 0) state.to = to;
+	if (params !== void 0) state.params = params || {};
+	if (query !== void 0) state.query = query || {};
+	if (replace !== void 0) state.replace = Boolean(replace);
+	if (exact !== void 0) state.exact = Boolean(exact);
+	state.label = label ?? state.to;
+	node.label(state.label);
+}
+function updateLinkValue(node, state, key, value) {
+	if (value === void 0) return state[key];
+	state[key] = value;
+	if (key === "to" && state.label === null) replaceChildren(node.children()[0], normalizeChildren(value));
+	const routerInstance = node._routerInstance;
+	if (routerInstance) updateLink(node, state, routerInstance);
+	return node;
+}
+function updateLink(node, state, routerInstance) {
+	node._routerInstance = routerInstance;
+	const target = buildLinkPath(state.to, state.params, state.query);
+	const active = isLinkActive(routerInstance.currentPath(), target, state.exact);
+	const classes = new Set(String(node.attr("class") || "").split(/\s+/).filter(Boolean));
+	classes.add("yoya-vlink");
+	if (active) classes.add("is-active");
+	else classes.delete("is-active");
+	node.attr({
+		"aria-current": active ? "page" : null,
+		class: [...classes].join(" "),
+		href: routerInstance.mode() === "history" ? target : `#${target}`
+	});
+	return node;
+}
+function buildLinkPath(to, params, query) {
+	const [pathTemplate, existingQuery = ""] = normalizePath(to).split("?");
+	const pathname = pathTemplate.replace(/:([A-Za-z0-9_]+)/g, (match, name) => params[name] === void 0 ? match : encodeURIComponent(params[name]));
+	const search = new URLSearchParams(existingQuery);
+	Object.entries(query || {}).forEach(([name, value]) => {
+		search.delete(name);
+		if (Array.isArray(value)) value.forEach((item) => search.append(name, item));
+		else if (value !== null && value !== void 0) search.set(name, value);
+	});
+	const queryString = search.toString();
+	return queryString ? `${pathname}?${queryString}` : pathname;
+}
+function isLinkActive(currentPath, targetPath, exact) {
+	const current = normalizePath(currentPath);
+	const target = normalizePath(targetPath);
+	if (exact) return current === target;
+	const currentPathname = parsePath(current).pathname;
+	const targetPathname = parsePath(target).pathname;
+	return currentPathname === targetPathname || currentPathname.startsWith(`${targetPathname}/`);
+}
+function shouldHandleLinkClick(event, node) {
+	return !event.defaultPrevented && event.button === 0 && !event.metaKey && !event.ctrlKey && !event.shiftKey && !event.altKey && (!node.attr("target") || node.attr("target") === "_self");
+}
+function normalizeRouteView(view, context) {
+	if (view instanceof ViewNode) return view;
+	if (view === null || view === void 0) return vText("");
+	if (isTextLike(view)) return vText(view);
+	if (view !== null && typeof view === "object" && typeof view.default !== "undefined" && typeof view.render !== "function") return normalizeRouteView(view.default, context);
+	if (typeof view === "function") return normalizeRouteView(view(context), context);
+	if (typeof view === "object" && typeof view.render === "function") return normalizeRouteView(view.render(), context);
+	throw new TypeError("Router route view must be a ViewNode, string, number, null, undefined, a render() component object, a factory returning one, or a module with a default export");
+}
+const defaultLoadingView = () => "加载中…";
+const defaultErrorView = (error) => `加载失败：${error?.message ?? String(error)}`;
+function isPromiseLike(value) {
+	return value !== null && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";
+}
+function resolveRouteEntry(entry, args) {
+	return normalizeRouteView(typeof entry === "function" ? entry(...args) : entry, args[args.length - 1]);
+}
+function matchRoute(pattern, path) {
+	const parsedPattern = parsePath(pattern);
+	const parsedPath = parsePath(path);
+	const patternParts = splitPath(parsedPattern.pathname);
+	const pathParts = splitPath(parsedPath.pathname);
+	if (patternParts.length !== pathParts.length) return null;
+	const params = {};
+	for (let index = 0; index < patternParts.length; index += 1) {
+		const patternPart = patternParts[index];
+		const pathPart = pathParts[index];
+		if (patternPart.startsWith(":")) {
+			params[patternPart.slice(1)] = decodeURIComponent(pathPart);
+			continue;
+		}
+		if (patternPart !== pathPart) return null;
+	}
+	return {
+		params,
+		pathname: parsedPath.pathname,
+		query: parsedPath.query
+	};
+}
+function createRouteContext(routerInstance, path, route, match) {
+	return {
+		params: { ...match.params },
+		path,
+		pathname: match.pathname,
+		query: { ...match.query },
+		route,
+		router: routerInstance
+	};
+}
+function readHashPath() {
+	if (typeof window === "undefined") return "/";
+	return normalizePath(window.location.hash.replace(/^#/, "") || "/");
+}
+function readPath(mode = "hash") {
+	if (typeof window === "undefined") return "/";
+	if (mode === "history") return normalizePath(`${window.location.pathname}${window.location.search}`);
+	return readHashPath();
+}
+function writeHashPath(path, options = {}) {
+	if (typeof window === "undefined") return false;
+	const hash = `#${path}`;
+	if (options.replace) {
+		window.history.replaceState(null, "", hash);
+		return true;
+	}
+	if (window.location.hash === hash) return false;
+	window.location.hash = hash;
+	return true;
+}
+function writePath(path, options = {}, mode = "hash") {
+	if (typeof window === "undefined") return false;
+	if (mode !== "history") return writeHashPath(path, options);
+	const target = normalizePath(path);
+	const currentPath = readPath("history");
+	if (!options.replace && currentPath === target) return false;
+	if (options.replace) window.history.replaceState(null, "", target);
+	else window.history.pushState(null, "", target);
+	return true;
+}
+function normalizePattern(pattern) {
+	return normalizePath(pattern).split("?")[0] || "/";
+}
+function normalizePath(path) {
+	const [pathname, query = ""] = String(path || "/").replace(/^#/, "").split("?");
+	const withSlash = pathname.startsWith("/") ? pathname : `/${pathname}`;
+	const cleanPathname = withSlash.length > 1 ? withSlash.replace(/\/+$/, "") : withSlash;
+	return query ? `${cleanPathname}?${query}` : cleanPathname;
+}
+function parsePath(path) {
+	const [pathname, queryString = ""] = normalizePath(path).split("?");
+	return {
+		pathname,
+		query: Object.fromEntries(new URLSearchParams(queryString))
+	};
+}
+function splitPath(pathname) {
+	return pathname.split("/").filter(Boolean);
+}
+function isTextLike(value) {
+	return typeof value === "string" || typeof value === "number";
+}
+
+//#endregion
+export { PageDocumentNode, Router, createRouter, hydrate, hydrateOrMount, mount, parseState, renderPage, renderToString, resolveLocale, router, serializeState, vLink, vRoute, vRouter, vRouterView, vRouterViews };