@iyulab/router 0.10.4 → 0.11.1

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## [0.11.1] - 2026-08-20
+
+### Fixed
+
+- **Route matching threw `ReferenceError: URLPattern is not defined` on browsers that ship
+  without the URL Pattern API.** The router constructs routes with the global `URLPattern`
+  constructor directly; browsers that have not yet shipped it (older Safari and Firefox
+  releases are still common in the field) failed synchronously in `new Router(...)`, before
+  any route could render. A guarded polyfill (`urlpattern-polyfill`, self-installs only when
+  `globalThis.URLPattern` is absent) is now imported by the router's internals, so browsers
+  without native support get a working fallback and browsers with native support are
+  unaffected at runtime.
+
+### Internal
+
+- Router's own `URLPattern` construction now runs through a small local type shim — the
+  polyfill package's bundled types have not yet caught up to the constructor's `options`
+  argument (`ignoreCase`), even though its runtime implementation already supports it.
+
+## [0.11.0] - 2026-08-07
+
+### Added
+
+- **`<u-link navigate="document">` — link to a same-origin path the router does not own.**
+  Whether a link was "external" was decided by an origin comparison alone, so there was no way to
+  point at a same-origin path that is not a SPA route: a static docs site, a server-rendered page,
+  a download endpoint, an auth redirect. The router intercepted the click and, with no matching
+  route, the screen fell through to not-found.
+
+  The three available escapes all meant something else: a different origin (the requirement is the
+  *same* origin — cookies, session, reverse proxy), `target="_blank"` (forces a new tab; same-tab
+  navigation was unexpressible), and a `#` fragment (not another document).
+
+  `navigate` defaults to `router`, so existing behaviour is unchanged. The rendered anchor carries
+  `data-navigate="document"`, which the router's global anchor delegation also honours — the
+  element handler alone is not enough, since a link pointing at a *registered* route would
+  otherwise be intercepted there instead.
+
+  The name is deliberately not `external`: this module already uses `isExternalUrl`/`isExternal`
+  with origin semantics, and the question here is about the document, not the origin.
+
+### Fixed
+
+- **`sideEffects` omitted the source-resolved entry barrel.** The allowlist covered the built
+  artifacts with a directory-wide glob, but the source-form barrel and the `react` wrapper entry
+  were outside it. The published artifacts
+  were unaffected — the shipped allowlist already covered them — but a consumer resolving this
+  package from source (a workspace sibling) could have the barrel elided, dropping the element
+  registrations it pulls in. The failure is silent: no error, and unregistered custom elements
+  render nothing. The source-form entry points are now declared alongside the artifact ones.
+
 ## [0.10.4] - 2026-08-01
 
 ### Documentation

package/README.md

@@ -141,13 +141,32 @@ const routes = [
 - `<u-link>`: SPA-aware anchor element
 - `<u-outlet>`: render target for matched route output
 
-`<u-link>` supports `href`, `target`, and `rel`.
+`<u-link>` supports `href`, `target`, `rel`, and `navigate`.
 
 ```html
 <u-link href="/docs">Docs</u-link>
 <u-link href="https://example.com" target="_blank" rel="noopener noreferrer">External</u-link>
 ```
 
+### Linking to a path the router does not own
+
+Not every path on your origin is a SPA route. A static docs site, a server-rendered
+page, a report endpoint, an auth redirect — these live alongside your routes and must
+open as documents, in the same tab. Declare that with `navigate="document"`:
+
+```html
+<u-link href="/help/" navigate="document">Help</u-link>
+```
+
+The router leaves the click alone and the browser navigates normally. The same works
+on a plain anchor via `data-navigate="document"`, which is what the element renders.
+
+`navigate` defaults to `router`: same-origin links are handled as SPA navigation, as
+before. Note that `navigate` asks a different question than the automatic origin check
+— not *"is this another origin?"* but *"is this another document?"* Without it the only
+escapes were a different origin, `target="_blank"` (which forces a new tab), or a `#`
+fragment (which is not another document at all).
+
 React wrappers:
 
 ```tsx

package/dist/components/ULink.d.ts

@@ -38,6 +38,27 @@ export declare class ULink extends LitElement {
      * - #으로 시작하면 브라우저 기본 동작을 사용합니다.
      */
     href?: string;
+    /**
+     * 이 링크를 라우터가 처리할지, 브라우저의 문서 이동에 맡길지.
+     *
+     * - `router`(기본): 종전 동작 그대로 — 같은 오리진이면 SPA 이동, 아니면 브라우저에 맡긴다.
+     * - `document`: 라우터가 **가로채지 않는다.** 같은 오리진이지만 SPA 라우트가 아닌 경로
+     *   (정적 문서 사이트, 서버 렌더 페이지, 파일 다운로드 엔드포인트, 인증 리다이렉트)를 가리킬 때 쓴다.
+     *
+     * ⚠**「외부 오리진」이 아니라 「다른 문서」다.** 종전에는 이 구분이 **오리진 비교 하나**로만
+     * 결정돼서, 같은 오리진의 비-SPA 경로를 가리킬 수단이 없었다 — 라우터가 클릭을 가로채고
+     * 등록되지 않은 라우트이므로 화면이 not-found 로 떨어졌다. 빠져나갈 길이 셋뿐이었고
+     * (다른 오리진 · `target="_blank"` · `#` 프래그먼트) 셋 다 요구와 다르다:
+     * 같은 오리진이어야 하고(쿠키·세션·역방향 프록시), **같은 탭**이어야 하며, 다른 문서다.
+     *
+     * ```html
+     * <u-link href="/help/" navigate="document">Help</u-link>
+     * ```
+     *
+     * ⚠**자동 판정을 넓히지 않는다.** 「등록된 라우트와 대조해 미등록이면 문서 이동」도 가능하지만
+     * 라우트가 늦게 등록되면 판정이 **시점에 의존**하게 된다. 명시 선언이 예측 가능하다.
+     */
+    navigate?: "router" | "document";
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected willUpdate(changedProperties: PropertyValues): void;

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-CZzCH0Yf.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-Dl02vMhW.js";
 import { LitElement, css, html } from "lit";
 import { customElement, property } from "lit/decorators.js";
 //#region src/types/RouteError.ts
@@ -289,6 +289,12 @@ function findAnchorFrom(event) {
 //#endregion
 //#region src/internals/route-helpers.ts
 /**
+* `urlpattern-polyfill`의 번들 타입 선언이 `options` 인자를 아직 반영하지 않는다(런타임
+* 구현은 WHATWG 스펙대로 `ignoreCase`를 지원한다 — `dist/index.js`의 3항 생성자 실측
+* 확인됨). 그 타입 공백만 좁혀서 캐스트한다.
+*/
+var createURLPattern = URLPattern;
+/**
 * 라우트들을 다음 사항에 따라 재귀적으로 재설정합니다.
 * - 각 라우트에 고유 `id`를 랜덤하게 부여합니다.
 * - `path`를 URLPattern 객체로 변환합니다.
@@ -303,13 +309,11 @@ function setRoutes(routes, basepath) {
 		route.id ||= getRandomID();
 		route.ignoreCase ||= false;
 		if (route.index === true) {
-			route.path = new URLPattern({ pathname: `${basepath}{/}?` }, { ignoreCase: route.ignoreCase });
+			route.path = new createURLPattern({ pathname: `${basepath}{/}?` }, { ignoreCase: route.ignoreCase });
 			route.force ||= true;
 		} else {
-			if (typeof route.path === "string") {
-				const absolutePathStr = absolutePath(basepath, route.path);
-				route.path = new URLPattern({ pathname: `${absolutePathStr}{/}?` }, { ignoreCase: route.ignoreCase });
-			} else if (route.path instanceof URLPattern) {} else route.path = new URLPattern({ pathname: `${basepath}{/}?` }, { ignoreCase: route.ignoreCase });
+			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);
@@ -401,6 +405,7 @@ var Router = class {
 				if (isExternalUrl(href)) return;
 				if (anchor.hasAttribute("download")) return;
 				if (anchor.getAttribute("rel") === "external") return;
+				if (anchor.getAttribute("data-navigate") === "document") return;
 				if (anchor.target && anchor.target !== "") return;
 				const pathname = new URL(anchor.href).pathname;
 				if (this._basepath !== "/" && !pathname.startsWith(this._basepath)) return;

package/dist/react.js

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