@iyulab/router 0.9.1 → 0.9.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.9.3] - 2026-04-24
+
+### Fixed
+- Document click handler now scopes interception to the router's `_rootElement` instead of `document`, preventing accidental capture of clicks outside the router's DOM subtree
+- Click handler no longer intercepts same-origin anchors pointing outside `basepath` — when `basepath` is not `/`, links targeting paths outside the basepath are passed through to browser navigation instead of falling through to the fallback route
+
+## [0.9.2] - 2026-04-13
+
+### Fixed
+- Nested route rendering now waits for child outlet readiness after parent render, preventing children from being rendered into the previous outlet when the next `<u-outlet>` is created inside a component shadow root
+- `Router.go()` now awaits `UOutlet.render()` before resolving the next outlet in the matched route chain
+- `waitOutlet()` now prefers component lifecycle-aware readiness checks (`customElements.whenDefined`, `updateComplete`, next animation frame) during outlet discovery
+
 ## [0.9.1] - 2026-04-08
 
 ### Fixed

package/dist/index.d.ts

@@ -382,7 +382,7 @@ export declare class Router {
     /** 브라우저 히스토리 이벤트가 발생시 라우팅 처리 */
     private handleWindowPopstate;
     /** 클릭 이벤트에서 라우터로 처리할 앵커를 찾아 클라이언트 라우팅 수행 */
-    private handleDocumentClick;
+    private handleRootElementClick;
 }
 
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as isExternalUrl, i as absolutePath, n as __decorate, o as parseUrl, r as __decorateMetadata, s as UOutlet, t as ULink } from "./share-CUGwxZKa.js";
+import { a as isExternalUrl, i as absolutePath, n as __decorate, o as parseUrl, r as __decorateMetadata, s as UOutlet, t as ULink } from "./share-DC0R4F2d.js";
 import { LitElement, css, html } from "lit";
 import { customElement, property } from "lit/decorators.js";
 //#region src/types/RouteError.ts
@@ -240,11 +240,13 @@ function findOutlet(element, skip = false) {
 * `u-outlet` 엘리먼트를 찾아 반환합니다. 없으면 에러를 던집니다. 
 * 
 * @param element 검색을 시작할 HTMLElement
+* @param skip element 자신을 검사에서 제외할지 여부 (기본값: false)
+* 
 * @returns 찾은 UOutlet 엘리먼트
 * @throws OutletMissingError `u-outlet` 엘리먼트를 찾지 못한 경우
 */
-function findOutletOrThrow(element) {
-	const outlet = findOutlet(element);
+function findOutletOrThrow(element, skip = false) {
+	const outlet = findOutlet(element, skip);
 	if (!outlet) throw new OutletMissingError();
 	return outlet;
 }
@@ -253,14 +255,18 @@ function findOutletOrThrow(element) {
 * 
 * @param element 대기할 엘리먼트
 * @param timeout 타임아웃 시간(밀리초, 기본값: 10_000ms)
+* @param skip element 자신을 검사에서 제외할지 여부 (기본값: false)
+* 
 * @returns 준비된 `u-outlet` 엘리먼트
 */
-async function waitOutlet(element, timeout = 1e4) {
+async function waitOutlet(element, timeout = 1e4, skip = false) {
 	const start = performance.now();
 	while (performance.now() - start < timeout) {
-		const outlet = findOutlet(element);
+		const outlet = findOutlet(element, skip);
 		if (outlet) return outlet;
-		await new Promise((r) => setTimeout(r, 50));
+		if (element.localName.includes("-")) await customElements.whenDefined(element.localName);
+		if ("updateComplete" in element) await element.updateComplete;
+		await new Promise((resolve) => requestAnimationFrame(() => resolve()));
 	}
 	throw new Error(`Timed out waiting for <u-outlet> inside <${element.tagName.toLowerCase()}>. Ensure that the router root element contains a <u-outlet> child.`);
 }
@@ -384,7 +390,7 @@ var Router = class {
 		this.handleWindowPopstate = async (_) => {
 			await this.go(window.location.href);
 		};
-		this.handleDocumentClick = async (e) => {
+		this.handleRootElementClick = async (e) => {
 			try {
 				if (e.defaultPrevented) return;
 				if (e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey) return;
@@ -396,6 +402,7 @@ var Router = class {
 				if (anchor.hasAttribute("download")) return;
 				if (anchor.getAttribute("rel") === "external") return;
 				if (anchor.target && anchor.target !== "") return;
+				if (this._basepath !== "/" && !new URL(anchor.href).pathname.startsWith(this._basepath)) return;
 				e.preventDefault();
 				await this.go(anchor.href);
 			} catch {}
@@ -407,7 +414,7 @@ var Router = class {
 		this._fallback = config.fallback;
 		this._enter = config.enter;
 		window.addEventListener("popstate", this.handleWindowPopstate);
-		if (config.useIntercept !== false) document.addEventListener("click", this.handleDocumentClick);
+		if (config.useIntercept !== false) this._rootElement.addEventListener("click", this.handleRootElementClick);
 		if (config.initialLoad !== false) waitOutlet(this._rootElement).then(() => {
 			this.go(window.location.href);
 		});
@@ -415,7 +422,7 @@ var Router = class {
 	/** 객체를 정리하고 이벤트 리스너를 제거합니다. */
 	destroy() {
 		window.removeEventListener("popstate", this.handleWindowPopstate);
-		document.removeEventListener("click", this.handleDocumentClick);
+		this._rootElement?.removeEventListener("click", this.handleRootElementClick);
 		this._requestID = void 0;
 		this._context = void 0;
 	}
@@ -491,14 +498,15 @@ var Router = class {
 					throw new ContentLoadError(e);
 				}
 				try {
-					outlet.render(content, {
+					await outlet.render(content, {
 						id: route.id,
 						force: route.force
 					});
 				} catch (e) {
 					throw new ContentRenderError(e);
 				}
-				outlet = findOutlet(outlet, true) || outlet;
+				if ("children" in route && route.children && route.children.length > 0) outlet = await waitOutlet(outlet, 2e3, true);
+				else outlet = findOutlet(outlet, true) || outlet;
 				title = route.title || title;
 			}
 			window.dispatchEvent(new RouteDoneEvent(context));

package/dist/react.js

@@ -1,4 +1,4 @@
-import { s as UOutlet$1, t as ULink$1 } from "./share-CUGwxZKa.js";
+import { s as UOutlet$1, t as ULink$1 } from "./share-DC0R4F2d.js";
 import React from "react";
 import { createComponent } from "@lit/react";
 //#region src/react.ts

package/dist/{share-CUGwxZKa.js → share-DC0R4F2d.js}

@@ -126,12 +126,12 @@ function catchBasepath(basepath) {
 	return basepath;
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.123.0/helpers/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.127.0/helpers/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.123.0/helpers/decorate.js
+//#region \0@oxc-project+runtime@0.127.0/helpers/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/router",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "A modern client-side router for web applications with support for Lit and React components",
   "keywords": [
     "lit",
@@ -58,11 +58,11 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "typescript": "^5.9.3",
-    "vite": "^8.0.3",
+    "vite": "^8.0.8",
     "vite-plugin-dts": "^4.5.4"
   }
 }

package/skills/iyulab-router/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: Browser environments only (requires URLPattern and History API)
 metadata:
   author: iyulab
-  version: "0.9.1"
+  version: "0.9.3"
 ---
 
 # @iyulab/router