@iyulab/router 0.11.2 → 0.11.4

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.11.4] - 2026-09-01
+
+### Fixed
+
+- **Three error messages gave no way to act on the failure.** `UOutlet.render()`
+  threw a generic "not supported content type" without saying what type it
+  actually received or what's supported; `getRoutes()` threw a garbled,
+  comma-spliced message that leaked an internal function name
+  (`setRoutes`) instead of the actual `path` value; and a route whose
+  `render()` returned a non-renderable value threw "Failed to load content
+  for the route." with no route path or id to identify which route failed.
+  All three now interpolate the actual value/route and name the expected
+  shape.
+
+## [0.11.3] - 2026-08-31
+
+### Fixed
+
+- **`waitOutlet()` could hang forever in a backgrounded tab.** The wait loop
+  only re-checked for the outlet after each `requestAnimationFrame`
+  resolved, and a fully suspended tab can stop firing `rAF` entirely (not
+  just throttle it), so the loop never exited. It now races each `rAF`
+  wait against a `setTimeout` for the remaining budget, and does one more
+  outlet check immediately before throwing — the deadline can pass in the
+  exact frame the outlet became ready, and without that final check that
+  read as a false timeout.
+
 ## [0.11.2] - 2026-08-25
 
 ### Fixed

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-Ds0NYHr-.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-BOhUKwJL.js";
 import { LitElement, css, html } from "lit";
 import { customElement, property } from "lit/decorators.js";
 //#region src/types/RouteError.ts
@@ -260,14 +260,18 @@ function findOutletOrThrow(element, skip = false) {
 * @returns 준비된 `u-outlet` 엘리먼트
 */
 async function waitOutlet(element, timeout = 1e4, skip = false) {
-	const start = performance.now();
-	while (performance.now() - start < timeout) {
+	const deadline = performance.now() + timeout;
+	while (performance.now() < deadline) {
 		const outlet = findOutlet(element, skip);
 		if (outlet) return outlet;
 		if (element.localName.includes("-")) await customElements.whenDefined(element.localName);
 		if ("updateComplete" in element) await element.updateComplete;
-		await new Promise((resolve) => requestAnimationFrame(() => resolve()));
+		const remaining = deadline - performance.now();
+		if (remaining <= 0) break;
+		await Promise.race([new Promise((resolve) => requestAnimationFrame(() => resolve())), new Promise((resolve) => setTimeout(resolve, remaining))]);
 	}
+	const outlet = findOutlet(element, skip);
+	if (outlet) return outlet;
 	throw new Error(`Timed out waiting for <u-outlet> inside <${element.tagName.toLowerCase()}>. Ensure that the router root element contains a <u-outlet> child.`);
 }
 /** 
@@ -339,7 +343,7 @@ function getRoutes(routes, pathname) {
 		}
 		if (route.path instanceof URLPattern) {
 			if (route.path.test({ pathname })) return [route];
-		} else throw new Error("Route path must be an instance of URLPattern, Something wrong in setRoutes function.");
+		} else throw new Error(`Route "path" must be a URLPattern, but got ${JSON.stringify(route.path)}. Routes passed to the Router must go through its normal config flow (new Router({ routes: [...] })), which normalizes string paths into URLPattern before matching — a route object was matched before that step ran.`);
 	}
 	return [];
 }
@@ -506,7 +510,7 @@ var Router = class {
 				let content;
 				try {
 					content = await route.render(context);
-					if (content === false || content === void 0 || content === null) throw new Error("Failed to load content for the route.");
+					if (content === false || content === void 0 || content === null) throw new Error(`Route render() returned ${content === false ? "false" : String(content)} for "${context.pathname}"${route.id ? ` (route id: "${route.id}")` : ""} — a route's render() must return an HTMLElement, a Lit TemplateResult, or a React element.`);
 				} catch (e) {
 					throw new ContentLoadError(e);
 				}

package/dist/react.js

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

package/dist/{share-Ds0NYHr-.js → share-BOhUKwJL.js}

@@ -23,7 +23,10 @@ var UOutlet = class extends HTMLElement {
 			const { createRoot } = await import("react-dom/client");
 			this.root = createRoot(this);
 			this.root.render(value);
-		} else throw new Error("not supported content type for Outlet rendering.");
+		} else {
+			const receivedType = value?.constructor?.name ?? typeof value;
+			throw new Error(`Unsupported content type for Outlet rendering: received ${receivedType}. Expected an HTMLElement, a Lit TemplateResult, or a React element.`);
+		}
 	}
 	/**
 	* 기존 DOM을 삭제하여, 초기 상태로 되돌립니다.
@@ -1023,12 +1026,12 @@ function catchBasepath(basepath) {
 	return basepath;
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.146.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.148.0/helpers/esm/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.146.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.148.0/helpers/esm/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.11.2",
+  "version": "0.11.4",
   "description": "A modern client-side router for web applications with support for Lit and React components",
   "keywords": [
     "lit",
@@ -47,6 +47,7 @@
     }
   },
   "scripts": {
+    "preversion": "node -e \"if(require('fs').existsSync('../../scripts/preversion-check.mjs'))require('child_process').execFileSync('node',['../../scripts/preversion-check.mjs'],{stdio:'inherit'})\"",
     "test": "vitest run",
     "build": "npm run typecheck && vite build",
     "test:watch": "vitest",