@iyulab/router 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.13.0] - 2026-09-13
+
+### Removed
+
+- **`RouteConfig.force`** — deprecated in 0.12.0, removed as announced. It only ever expressed
+  the two values `key` already covers: `force: false` is `key: () => ''` (keep the mounted
+  content across every navigation that matches the route), `force: true` is the default
+  (`ctx => ctx.href` — remount when the URL changes at all). Replace one with the other; a
+  route that never set `force` is unaffected. The property is gone from the type, so a stale
+  usage fails at compile time rather than silently doing nothing.
+
 ## [0.12.0] - 2026-09-13
 
 ### Added

package/dist/components/ULink.d.ts

@@ -64,7 +64,7 @@ export declare class ULink extends LitElement {
     /**
      * 호스트에 세팅된 `aria-current`/`aria-label`은 실제 접근 가능한(포커스 대상)
      * 엘리먼트가 아니라 — 그 안쪽 shadow DOM 의 네이티브 `<a>`다. 섀도우 경계를
-     * 넘지 않으므로 접근성 트리에 자동 반영되지 않는다(docket #45 실측 — 속성은
+     * 넘지 않으므로 접근성 트리에 자동 반영되지 않는다(실측 — 속성은
      * 붙어 있는데 접근성 트리의 `aria-current`는 계속 비어 있음). `render()`가 이
      * 값을 읽어 내부 `<a>`에 직접 옮긴다.
      *

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-ByPkeTq1.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-A3Fla8oW.js";
 import { LitElement, css, html } from "lit";
 import { customElement, property } from "lit/decorators.js";
 //#region src/types/RouteError.ts
@@ -302,13 +302,12 @@ var createURLPattern = URLPattern;
 * `key` 가 없을 때의 기본 식별 키 — «언제 새로 만드는가» 의 기본 규칙.
 *
 * 자식이 없는 라우트는 URL(`href`) 이 조금이라도 바뀌면 새로 마운트하고, 자식을 가진 라우트
-* (레이아웃)는 상수 키로 유지된다 — 종전의 `force` 기본값(leaf true · parent false)과 같은
-* 결과다. 다만 종전 코드는 `route.force ||= true` 라서 소비자가 leaf 에 `force: false` 를
-* 명시해도 `true` 로 덮였다(`false || true`). `force` 는 deprecate 됐지만 이 판에서는
-* 존중한다: `false` 는 «유지», `true` 는 «새로».
+* (레이아웃)는 상수 키로 유지된다. 그 밖의 규칙은 소비자가 `key` 로 직접 준다 — 예전의
+* `force` 불리언은 이 두 값(«유지»·«새로»)밖에 표현하지 못해 `key` 로 대체됐고 0.13.0 에서
+* 제거됐다(`force: false` ≡ `key: () => ''` · `force: true` ≡ 기본값).
 */
-function defaultKey(route, hasChildren) {
-	return route.force === false || hasChildren && route.force !== true ? () => "" : (ctx) => ctx.href;
+function defaultKey(hasChildren) {
+	return hasChildren ? () => "" : (ctx) => ctx.href;
 }
 /**
 * 라우트들을 다음 사항에 따라 재귀적으로 재설정합니다.
@@ -326,15 +325,15 @@ function setRoutes(routes, basepath) {
 		route.ignoreCase ||= false;
 		if (route.index === true) {
 			route.path = new createURLPattern({ pathname: `${basepath}{/}?` }, { ignoreCase: route.ignoreCase });
-			route.key ??= defaultKey(route, false);
+			route.key ??= defaultKey(false);
 		} else {
 			if (typeof route.path === "string") route.path = new createURLPattern({ pathname: `${absolutePath(basepath, route.path)}{/}?` }, { ignoreCase: route.ignoreCase });
 			else if (route.path instanceof URLPattern) {} else route.path = new createURLPattern({ pathname: `${basepath}{/}?` }, { ignoreCase: route.ignoreCase });
 			if (route.children && route.children.length > 0) {
 				const childBasepath = route.path.pathname.replace("{/}?", "");
 				route.children = setRoutes(route.children, childBasepath);
-				route.key ??= defaultKey(route, true);
-			} else route.key ??= defaultKey(route, false);
+				route.key ??= defaultKey(true);
+			} else route.key ??= defaultKey(false);
 		}
 	}
 	return routes;

package/dist/react.js

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

package/dist/{share-ByPkeTq1.js → share-A3Fla8oW.js}

@@ -1120,7 +1120,7 @@ var ULink = class ULink extends LitElement {
 	/**
 	* 호스트에 세팅된 `aria-current`/`aria-label`은 실제 접근 가능한(포커스 대상)
 	* 엘리먼트가 아니라 — 그 안쪽 shadow DOM 의 네이티브 `<a>`다. 섀도우 경계를
-	* 넘지 않으므로 접근성 트리에 자동 반영되지 않는다(docket #45 실측 — 속성은
+	* 넘지 않으므로 접근성 트리에 자동 반영되지 않는다(실측 — 속성은
 	* 붙어 있는데 접근성 트리의 `aria-current`는 계속 비어 있음). `render()`가 이
 	* 값을 읽어 내부 `<a>`에 직접 옮긴다.
 	*

package/dist/types/RouteConfig.d.ts

@@ -90,13 +90,6 @@ interface BaseRouteConfig {
      * ```
      */
     key?: (ctx: RouteContext) => string;
-    /**
-     * @deprecated `key`로 표현하세요 — `force: false`는 `key: () => ''`(상수 키)와 같고 `force: true`는
-     * 기본값과 같습니다. 이 판에서는 동작을 유지하며, 다음 minor에서 제거됩니다.
-     * ⚠이전 판에서는 자식이 없는 라우트에 `force: false`를 줘도 무시됐습니다(기본값 적용 순서의 결함).
-     * 이제 `force: false`는 모든 라우트에서 «유지»를 뜻합니다.
-     */
-    force?: boolean;
     /**
      * 경로 매칭시 대소문자 구분 여부
      * @default false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/router",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "A modern client-side router for web applications with support for Lit and React components",
   "keywords": [
     "lit",
@@ -75,6 +75,8 @@
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "happy-dom": "^20.10.6",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "typescript": "^6.0.2",
     "vite": "^8.1.4",
     "vite-plugin-dts": "^5.0.3",

package/skills/iyulab-router/SKILL.md

@@ -72,7 +72,6 @@ const router = new Router({
 | `title` | `string` | Sets `document.title` on match |
 | `metadata` | `Record<string, unknown>` | Arbitrary metadata (auth, layout, analytics) |
 | `key` | `(ctx) => string` | When to remount: content is kept and re-rendered in place while the key is unchanged (Lit: same part, React: same root, `HTMLElement`: instance kept). Default `ctx => ctx.href` for leaf routes, a constant for routes with `children`. `key: ctx => ctx.pathname` keeps a page across query-string changes |
-| `force` | `boolean` | **Deprecated** — use `key`. `false` ≡ constant key (keep), `true` ≡ default |
 
 ## RouteContext Fields