@iyulab/router 0.10.4 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [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-BaGC5VOl.js";
 import { LitElement, css, html } from "lit";
 import { customElement, property } from "lit/decorators.js";
 //#region src/types/RouteError.ts
@@ -401,6 +401,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-BaGC5VOl.js";
 import React from "react";
 import { createComponent } from "@lit/react";
 //#region src/react.ts

package/dist/{share-CZzCH0Yf.js → share-BaGC5VOl.js}

@@ -126,12 +126,12 @@ function catchBasepath(basepath) {
 	return basepath;
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.143.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.142.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.143.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);
@@ -149,6 +149,7 @@ var ULink = class ULink extends LitElement {
 			if (event.button !== 0) return;
 			if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;
 			if (this.target && this.target.toLowerCase() !== "_self") return;
+			if (this.navigate === "document") return;
 			const basepath = this.getBasepath();
 			if (!this.href) {
 				event.preventDefault();
@@ -193,6 +194,7 @@ var ULink = class ULink extends LitElement {
         href=${this.compute(this.href)}
         target=${ifDefined(this.target)}
         rel=${ifDefined(this.rel)}
+        data-navigate=${ifDefined(this.navigate)}
       >
         <slot></slot>
       </a>
@@ -237,6 +239,7 @@ var ULink = class ULink extends LitElement {
 __decorate([property({ type: String }), __decorateMetadata("design:type", String)], ULink.prototype, "target", void 0);
 __decorate([property({ type: String }), __decorateMetadata("design:type", String)], ULink.prototype, "rel", void 0);
 __decorate([property({ type: String }), __decorateMetadata("design:type", String)], ULink.prototype, "href", void 0);
+__decorate([property({ type: String }), __decorateMetadata("design:type", String)], ULink.prototype, "navigate", void 0);
 ULink = __decorate([customElement("u-link")], ULink);
 //#endregion
 export { isExternalUrl as a, absolutePath as i, __decorate as n, parseUrl as o, __decorateMetadata as r, UOutlet as s, ULink as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/router",
-  "version": "0.10.4",
+  "version": "0.11.0",
   "description": "A modern client-side router for web applications with support for Lit and React components",
   "keywords": [
     "lit",
@@ -27,6 +27,15 @@
   ],
   "type": "module",
   "types": "dist/index.d.ts",
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": [
+    "./dist/*.js",
+    "./src/components/*.ts",
+    "./src/index.ts",
+    "./src/react.ts"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -39,8 +48,9 @@
   },
   "scripts": {
     "test": "vitest run",
-    "build": "vite build",
-    "test:watch": "vitest"
+    "build": "npm run typecheck && vite build",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@lit/react": "^1.0.8",