@iyulab/router 0.11.3 → 0.11.5

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.11.5] - 2026-09-10
+
+### Fixed
+
+- **`u-error-page`'s three colour hooks were documented as having no default.** They were
+  described as falling back to the inherited colour, when the host block in fact declares a
+  concrete colour for each — `--error-icon-color` `#4a5568` (dark `#a0aec0`),
+  `--error-code-color` `#1a202c` (dark `#f7fafc`), `--error-message-color` `#718096`
+  (dark `#cbd5e0`). A consumer reading the old text would expect the page to pick up the
+  surrounding colour and find that it does not. The documentation now also states the
+  consequence those literals carry: this page does not follow the host application's design
+  tokens, and replacing it wholesale is what `fallback.render` is for. No behaviour changed.
+
+## [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

package/dist/components/UErrorPage.d.ts

@@ -9,9 +9,13 @@ import { TemplateResult } from 'lit-html';
  * 아니다. 다만 라우팅 실패 시 실제 DOM에 렌더되므로, 기본 화면의 색만 가볍게
  * 맞추고 싶은 소비자를 위해 세 색상 훅을 남겨 둔다(전체 교체는 `fallback.render`).
  *
- * @cssprop --error-icon-color - 아이콘 색. 기본값 없음(미지정 시 상속된 색 사용)
- * @cssprop --error-code-color - 에러 코드 텍스트 색. 기본값 없음(미지정 시 상속된 색 사용)
- * @cssprop --error-message-color - 에러 메시지 텍스트 색. 기본값 없음(미지정 시 상속된 색 사용)
+ * @cssprop --error-icon-color - 아이콘 색. 기본값 `#4a5568`(다크 `#a0aec0`)
+ * @cssprop --error-code-color - 에러 코드 텍스트 색. 기본값 `#1a202c`(다크 `#f7fafc`)
+ * @cssprop --error-message-color - 에러 메시지 텍스트 색. 기본값 `#718096`(다크 `#cbd5e0`)
+ *
+ * ⚠세 값은 아래 `static styles` 의 `:host` 에서 **구체적인 색으로 선언된다** — 지정하지
+ * 않으면 주변 색을 상속하는 것이 아니라 위 기본값이 적용된다. 리터럴이므로 이 페이지는
+ * 호스트 앱의 디자인 토큰을 따르지 않는다.
  */
 export declare class UErrorPage extends LitElement {
     constructor(error?: RouteError);

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-iJLbxFbJ.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-DyVUteH9.js";
 import { LitElement, css, html } from "lit";
 import { customElement, property } from "lit/decorators.js";
 //#region src/types/RouteError.ts
@@ -343,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 [];
 }
@@ -510,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-iJLbxFbJ.js";
+import { s as UOutlet$1, t as ULink$1 } from "./share-DyVUteH9.js";
 import React from "react";
 import { createComponent } from "@lit/react";
 //#region src/react.ts

package/dist/{share-iJLbxFbJ.js → share-DyVUteH9.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.147.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.149.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.147.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.149.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.3",
+  "version": "0.11.5",
   "description": "A modern client-side router for web applications with support for Lit and React components",
   "keywords": [
     "lit",
@@ -47,7 +47,7 @@
     }
   },
   "scripts": {
-    "preversion": "node ../../scripts/preversion-check.mjs",
+    "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",
@@ -75,7 +75,7 @@
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "happy-dom": "^20.10.6",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "vite": "^8.1.4",
     "vite-plugin-dts": "^5.0.3",
     "vitest": "^4.1.10"

package/skills/iyulab-router/references/components.md

@@ -49,11 +49,16 @@ A parent route must render `<u-outlet>` to host child route content.
 custom properties are available to lightly restyle it without replacing
 `fallback.render` entirely:
 
-| Custom Property | Description | Default |
-| --- | --- | --- |
-| `--error-icon-color` | Icon color | none — inherits the ambient text color |
-| `--error-code-color` | Error code text color | none — inherits the ambient text color |
-| `--error-message-color` | Error message text color | none — inherits the ambient text color |
+| Custom Property | Description | Default (light) | Default (dark) |
+| --- | --- | --- | --- |
+| `--error-icon-color` | Icon color | `#4a5568` | `#a0aec0` |
+| `--error-code-color` | Error code text color | `#1a202c` | `#f7fafc` |
+| `--error-message-color` | Error message text color | `#718096` | `#cbd5e0` |
+
+The defaults are concrete colors set on `:host`, not inherited — the dark column applies
+under `prefers-color-scheme: dark`. Because they are literals rather than design tokens,
+this page does not follow a host application's theme; set the three properties (or supply
+your own `fallback.render`) if it has to.
 
 ```css
 u-error-page {