@iyulab/router 0.15.1 → 0.15.2

package/dist/react.d.ts

@@ -1,11 +1,172 @@
-import { ULink as ULinkElement } from './components/ULink.js';
-import { UOutlet as UOutletElement } from './components/UOutlet.js';
-import { ReactWebComponent } from '@lit/react';
+import { CSSResult } from 'lit';
+import { LitElement } from 'lit';
+import { PropertyValues } from 'lit';
+import { ReactWebComponent } from '@lit/react';
+import { TemplateResult } from 'lit-html';
+
+/** 렌더링 옵션 */
+declare interface RenderOption {
+    /** 교차 렌더링 방지 ID — 어느 라우트의 콘텐츠인가 */
+    id?: string;
+    /**
+     * 라우트의 식별 키(`RouteConfig.key` 의 결과). 같은 라우트 + 같은 키면 기존 콘텐츠를
+     * 유지한 채 제자리 갱신하고, 바뀌면 내리고 새로 마운트한다.
+     */
+    key?: string;
+}
+
+/**
+ * `u-link` 웹 컴포넌트를 React에서 사용할 수 있도록 래핑한 컴포넌트입니다.
+ */
+export declare const ULink: ReactWebComponent<ULink_2, {}>;
+
+/**
+ * - 클라이언트 라우팅을 지원하는 링크 엘리먼트입니다.
+ * - 내부 링크는 클라이언트 라우팅을 수행하고, 외부 링크는 브라우저 기본 네비게이션을 사용합니다.
+ * - Ctrl/Meta/Shift/Alt, 중클릭/우클릭 등은 브라우저 기본 동작(새 탭, 컨텍스트 메뉴 등)을 그대로 유지합니다.
+ */
+declare class ULink_2 extends LitElement {
+    /** 외부 링크 여부 */
+    private isExternal;
+    /**
+     * 링크 대상 target 속성
+     *
+     * - `_self`: 현재 창에서 링크 열기 (기본값)
+     * - `_blank`: 새 탭/창에서 링크 열기
+     * - `_parent`: 부모 프레임에서 링크 열기
+     * - `_top`: 최상위 프레임에서 링크 열기
+     */
+    target?: string;
+    /**
+     * 링크 관계 rel 속성
+     *
+     * - `noopener`: target이 _blank인 경우 보안 강화 (window.opener 차단)
+     * - `noreferrer`: target이 _blank인 경우 보안 강화 + Referer 헤더 제거
+     * - `external`: 외부 링크임을 명시 (SEO/접근성에 도움)
+     * - `nofollow`: 검색 엔진이 링크를 따라가지 않도록 지시 (SEO에 영향)
+     * - 그 외 rel 값도 그대로 전달됩니다.
+     */
+    rel?: string;
+    /**
+     * 링크 대상 URL, 다음 사항에 따라 SPA 라우팅 또는 브라우저 네비게이션이 결정됩니다.
+     *
+     * - 속성을 정의하지 않으면 설정에서 지정한 `basepath`로 SPA 라우팅합니다.
+     * - http(s)로 시작하면 외부 링크로 간주하고 브라우저 네비게이션을 사용합니다.
+     * - 절대경로(/...)의 경우 `basepath`로 시작하면 SPA 라우팅합니다, 이외 브라우저 네비게이션을 사용합니다.
+     * - 상대경로는 (basepath + 상대경로)로 결합하여 SPA 라우팅합니다.
+     * - ?로 시작하면 현재 경로에 쿼리스트링을 추가하여 SPA 라우팅합니다.
+     * - #으로 시작하면 브라우저 기본 동작을 사용합니다.
+     */
+    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;
+    /**
+     * 호스트에 세팅된 `aria-current`/`aria-label`은 실제 접근 가능한(포커스 대상)
+     * 엘리먼트가 아니라 — 그 안쪽 shadow DOM 의 네이티브 `<a>`다. 섀도우 경계를
+     * 넘지 않으므로 접근성 트리에 자동 반영되지 않는다(실측 — 속성은
+     * 붙어 있는데 접근성 트리의 `aria-current`는 계속 비어 있음). `render()`가 이
+     * 값을 읽어 내부 `<a>`에 직접 옮긴다.
+     *
+     * 둘 다 Lit 리액티브 프로퍼티로 선언돼 있지 않아 `observedAttributes`에 없다 —
+     * 그 목록에 없는 속성은 `attributeChangedCallback` 자체가 호출되지 않는다
+     * (커스텀 엘리먼트 표준 동작). 초기 렌더는 되지만 연결 후 동적 변경은 반영되지
+     * 않았다 — 목록에 명시적으로 추가해야 한다.
+     */
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, old: string | null, value: string | null): void;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    render(): TemplateResult<1>;
+    /** a 태그에 주입할 href 값을 계산합니다. */
+    private compute;
+    /**
+     * 클릭 가로채기 핸들러
+     * - 좌클릭(0) + 보조키 없음(ctrl/meta/shift/alt 없음) + target이 _self일 때만 SPA 라우팅 고려
+     * - 그 외(중클릭/우클릭/보조키/target=_blank 등)는 브라우저 기본 동작 유지
+     */
+    private handleClick;
+    /** 클라이언트 라우팅을 위해 popstate 이벤트를 발생시킵니다. */
+    private dispatchPopstate;
+    /** basepath를 state에서 꺼내는 헬퍼 */
+    private getBasepath;
+    static styles: CSSResult;
+}
+
+/**
+ * `u-outlet` 웹 컴포넌트를 React에서 사용할 수 있도록 래핑한 컴포넌트입니다.
+ */
+export declare const UOutlet: ReactWebComponent<UOutlet_2, {}>;
+
+/**
+ * LitElement 또는 React 컴포넌트를 렌더링해주는 웹컴포넌트 입니다.
+ */
+declare class UOutlet_2 extends HTMLElement {
+    /** 교차 렌더링 방지 id */
+    private routeId?;
+    /** 마지막으로 렌더한 라우트의 식별 키 */
+    private routeKey?;
+    /** 마운트된 콘텐츠의 종류 */
+    private kind?;
+    /** 실제 렌더링 컨텐츠 */
+    private root?;
+    /** 진행 중인 render — 다음 render 는 이것이 끝난 뒤 판정한다 */
+    private pending?;
+    connectedCallback(): void;
+    /**
+     * 주어진 렌더링 옵션에 따라 컨텐츠를 렌더링합니다.
+     *
+     * 같은 라우트(`id`)에 같은 키(`key`)로 다시 불리면 **제자리 갱신**한다 — Lit 템플릿은
+     * 같은 파트에 다시 렌더(요소·상태 유지, 바인딩만 갱신), React 엘리먼트는 같은 root 에 다시
+     * 렌더(컴포넌트 상태 유지), `HTMLElement` 는 기존 인스턴스를 그대로 둔다. 매번 `reset()`
+     * 을 먼저 부르던 종전 동작이 «쿼리스트링만 바뀌어도 페이지가 재마운트되는» 원인이었다
+     * (Lit 의 `render` 도 React 의 `root.render` 도 같은 컨테이너에 다시 부르면 조정한다).
+     */
+    render(value: unknown, options?: RenderOption): Promise<void>;
+    private mount;
+    /**
+     * 기존 DOM을 삭제하여, 초기 상태로 되돌립니다.
+     */
+    reset(): void;
+}
+
+export { }
+
+
+declare global {
+    interface HTMLElementTagNameMap {
+        'u-outlet': UOutlet;
+    }
+}
+
+
 /**
- * `u-link` 웹 컴포넌트를 React에서 사용할 수 있도록 래핑한 컴포넌트입니다.
+ * 전역 WindowEventMap에 라우터 이벤트 타입
  */
-export declare const ULink: ReactWebComponent<ULinkElement, {}>;
-/**
- * `u-outlet` 웹 컴포넌트를 React에서 사용할 수 있도록 래핑한 컴포넌트입니다.
- */
-export declare const UOutlet: ReactWebComponent<UOutletElement, {}>;
+declare global {
+    interface WindowEventMap {
+        'route-begin': RouteBeginEvent;
+        'route-progress': RouteProgressEvent;
+        'route-done': RouteDoneEvent;
+        'route-error': RouteErrorEvent;
+    }
+}

package/dist/react.js

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

package/dist/{share-Cwn-vX3y.js → share-DxyaaBox.js}

@@ -58,6 +58,16 @@ import { ifDefined } from "lit/directives/if-defined.js";
 * 🔴**소비자가 아웃렛을 «줄이려면» `height` 만으로는 부족하고 `min-height: 0` 이 함께 필요하다**
 *   — 0.14.0 대비 유일한 계약 추가이며 README·CHANGELOG·참조 문서에 적혀 있다.
 *
+* ## 가로 — 열 트랙은 아웃렛 폭에 묶는다 (0.15.2)
+*
+* 🔴**grid 는 세로만이 아니라 가로에도 격자 규칙을 들여온다.** 열 트랙을 선언하지 않으면 암묵적
+*   열은 `auto` 이고, 격자 항목(라우트 화면)의 기본 `min-width: auto` 가 자손의 최소 내용 폭을
+*   트랙까지 올려 보낸다 — 넓은 표가 `overflow-x: auto` 상자 안에 있어도 라우트 화면 전체가 표
+*   폭만큼 늘어나 아웃렛을 넘친다(소비자 실측: 아웃렛 972 · 화면 1,945 · 툴바 끝 버튼이 뷰포트 밖).
+*   `block` 이던 시절(0.14.x)에는 없던 부작용이고, `display` 를 바꾼 우리 몫이다.
+* ✅`minmax(0, 1fr)` — 최소 0 이라 내용이 트랙을 밀어 넓히지 못하고, `1fr` 이라 좁은 내용이어도
+*   아웃렛 폭을 채운다(격자 항목의 `min-width: 0` 을 대신 줄 수는 없다 — 항목은 소비자의 요소다).
+*
 * ## 인쇄 매체 — `block` 으로 돌아간다 (0.15.1)
 *
 * 🔴**grid 는 자기 안에서 여백 접힘을 막는다.** 라우트 화면의 마지막 블록이 `margin-bottom` 을
@@ -70,7 +80,7 @@ import { ifDefined } from "lit/directives/if-defined.js";
 *   `min-height: 100%` 도 0 으로 풀린다. ⇒ 인쇄에서 grid 는 **여백을 가두기만** 한다.
 * ⚠같은 `:where()` 라 특이도 0 그대로다 — 소비자 규칙은 인쇄에서도 `!important` 없이 이긴다.
 */
-var OUTLET_DISPLAY_CSS = [":where(u-outlet) { display: grid; min-height: 100%; }", "@media print { :where(u-outlet) { display: block; } }"].join("\n");
+var OUTLET_DISPLAY_CSS = [":where(u-outlet) { display: grid; grid-template-columns: minmax(0, 1fr); min-height: 100%; }", "@media print { :where(u-outlet) { display: block; } }"].join("\n");
 /** 시트를 이미 채택한 트리 — 같은 트리에 두 번 넣지 않는다. */
 var styledRoots = /* @__PURE__ */ new WeakSet();
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/router",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "A modern client-side router for web applications with support for Lit and React components",
   "keywords": [
     "lit",
@@ -71,10 +71,11 @@
     }
   },
   "devDependencies": {
-    "@vitest/browser-playwright": "^5.0.0",
+    "@microsoft/api-extractor": "^7.58.8",
     "@types/node": "^26.1.1",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
+    "@vitest/browser-playwright": "^5.0.0",
     "happy-dom": "^20.10.6",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",

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

@@ -46,7 +46,7 @@ rules on whichever tree it is connected to (the document, or the shadow root if
 one):
 
 ```css
-:where(u-outlet) { display: grid; min-height: 100%; }
+:where(u-outlet) { display: grid; grid-template-columns: minmax(0, 1fr); min-height: 100%; }
 @media print { :where(u-outlet) { display: block; } }
 ```
 
@@ -78,6 +78,13 @@ The rule deliberately omits `align-content`; it relies on the initial `normal`.
 When the parent's own height is `auto`, `min-height: 100%` resolves to `auto` too, so ordinary
 document flow is unaffected.
 
+The column track is bound to the outlet's width with `minmax(0, 1fr)`. Without it the implicit
+column is `auto`, and a grid item's default `min-width: auto` passes its content's minimum width up
+to the track — so a wide table inside a screen widened the whole screen past the outlet, even when
+the table sat in an `overflow-x: auto` box, and anything aligned to the screen's right edge (a
+toolbar's last button) ended up off screen. With the track bound, the screen is exactly as wide as
+the outlet, a narrow screen still fills it, and wide content scrolls inside its own box.
+
 ### Printing
 
 In print media the outlet is a plain block box instead of a grid container. A grid container is
@@ -99,6 +106,7 @@ application writes wins, regardless of sheet order and without `!important`:
 
 ```css
 u-outlet { display: flex; }                    /* wins */
+u-outlet { grid-template-columns: auto; }      /* restores the 0.15.1 column track */
 u-outlet { display: contents; }                /* remove the box entirely */
 u-outlet { display: block; height: 100%; }     /* restores the 0.14.0 behavior */
 u-outlet { display: inline; }                  /* restores the pre-0.14.0 behavior */

package/dist/Router.d.ts

@@ -1,41 +0,0 @@
-import { RouteContext } from './types/RouteContext.js';
-import { RouterConfig } from './types/RouterConfig.js';
-import { RouteConfig } from './types/RouteConfig.js';
-import { NavigateOptions } from './types/NavigateOptions.js';
-/**
- * `lit-element`, `react`를 지원하는 SPA 클라이언트 라우터 객체입니다.
- */
-export declare class Router {
-    private readonly _rootElement;
-    private readonly _basepath;
-    private readonly _routes;
-    private readonly _fallback?;
-    private readonly _enter?;
-    private readonly _tracker;
-    /** 현재 라우팅 요청 ID */
-    private _requestID?;
-    /** 현재 라우팅 정보 */
-    private _context?;
-    constructor(config: RouterConfig);
-    /** 객체를 정리하고 이벤트 리스너를 제거합니다. */
-    destroy(): void;
-    /** 라우터의 기본 경로 반환 */
-    get basepath(): string;
-    /** 등록된 라우트 정보 반환 */
-    get routes(): RouteConfig[];
-    /** 현재 라우팅 정보 반환 */
-    get context(): RouteContext | undefined;
-    /**
-     * 지정한 경로의 클라이언트 라우팅을 수행합니다. 상대경로일 경우 basepath와 조합되어 이동합니다.
-     * @param href 이동할 경로
-     * @param options 네비게이션 옵션
-     * @param routes (internal) 호출자가 이미 계산한 라우트 매칭 결과가 있으면 재사용합니다.
-     *   `handleRootElementClick`이 가로채기 여부 판단을 위해 미리 계산한 결과를 전달해
-     *   동일 pathname에 대한 getRoutes 중복 호출을 피하는 용도입니다. 외부에서 사용하지 마세요.
-     */
-    go(href: string, options?: NavigateOptions, routes?: RouteConfig[]): Promise<undefined>;
-    /** 브라우저 히스토리 이벤트가 발생시 라우팅 처리 */
-    private handleWindowPopstate;
-    /** 클릭 이벤트에서 라우터로 처리할 앵커를 찾아 클라이언트 라우팅 수행 */
-    private handleRootElementClick;
-}

package/dist/components/UErrorPage.d.ts

@@ -1,30 +0,0 @@
-import { LitElement, CSSResult } from 'lit';
-import { RouteError } from '../types/RouteError.js';
-import { TemplateResult } from 'lit-html';
-/**
- * 라우팅 중 발생한 에러 정보를 사용자에게 전달하기 위한 기본 컴포넌트 입니다.
- *
- * `Router`가 `fallback`을 지정하지 않았을 때 내부적으로 그리는 기본 화면이라
- * `src/index.ts`에서 공개 export되지 않는다 — 직접 import해 쓰는 컴포넌트가
- * 아니다. 다만 라우팅 실패 시 실제 DOM에 렌더되므로, 기본 화면의 색만 가볍게
- * 맞추고 싶은 소비자를 위해 세 색상 훅을 남겨 둔다(전체 교체는 `fallback.render`).
- *
- * @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);
-    /** 표시할 에러 정보 */
-    error?: RouteError;
-    render(): TemplateResult<1>;
-    /** 기본 에러 정보 반환 */
-    private getDefaultError;
-    /** 에러 코드에 따른 기본 아이콘 반환 */
-    private getErrorIcon;
-    static styles: CSSResult;
-}

package/dist/components/ULink.d.ts

@@ -1,93 +0,0 @@
-import { LitElement, PropertyValues, CSSResult } from 'lit';
-import { TemplateResult } from 'lit-html';
-/**
- * - 클라이언트 라우팅을 지원하는 링크 엘리먼트입니다.
- * - 내부 링크는 클라이언트 라우팅을 수행하고, 외부 링크는 브라우저 기본 네비게이션을 사용합니다.
- * - Ctrl/Meta/Shift/Alt, 중클릭/우클릭 등은 브라우저 기본 동작(새 탭, 컨텍스트 메뉴 등)을 그대로 유지합니다.
- */
-export declare class ULink extends LitElement {
-    /** 외부 링크 여부 */
-    private isExternal;
-    /**
-     * 링크 대상 target 속성
-     *
-     * - `_self`: 현재 창에서 링크 열기 (기본값)
-     * - `_blank`: 새 탭/창에서 링크 열기
-     * - `_parent`: 부모 프레임에서 링크 열기
-     * - `_top`: 최상위 프레임에서 링크 열기
-     */
-    target?: string;
-    /**
-     * 링크 관계 rel 속성
-     *
-     * - `noopener`: target이 _blank인 경우 보안 강화 (window.opener 차단)
-     * - `noreferrer`: target이 _blank인 경우 보안 강화 + Referer 헤더 제거
-     * - `external`: 외부 링크임을 명시 (SEO/접근성에 도움)
-     * - `nofollow`: 검색 엔진이 링크를 따라가지 않도록 지시 (SEO에 영향)
-     * - 그 외 rel 값도 그대로 전달됩니다.
-     */
-    rel?: string;
-    /**
-     * 링크 대상 URL, 다음 사항에 따라 SPA 라우팅 또는 브라우저 네비게이션이 결정됩니다.
-     *
-     * - 속성을 정의하지 않으면 설정에서 지정한 `basepath`로 SPA 라우팅합니다.
-     * - http(s)로 시작하면 외부 링크로 간주하고 브라우저 네비게이션을 사용합니다.
-     * - 절대경로(/...)의 경우 `basepath`로 시작하면 SPA 라우팅합니다, 이외 브라우저 네비게이션을 사용합니다.
-     * - 상대경로는 (basepath + 상대경로)로 결합하여 SPA 라우팅합니다.
-     * - ?로 시작하면 현재 경로에 쿼리스트링을 추가하여 SPA 라우팅합니다.
-     * - #으로 시작하면 브라우저 기본 동작을 사용합니다.
-     */
-    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;
-    /**
-     * 호스트에 세팅된 `aria-current`/`aria-label`은 실제 접근 가능한(포커스 대상)
-     * 엘리먼트가 아니라 — 그 안쪽 shadow DOM 의 네이티브 `<a>`다. 섀도우 경계를
-     * 넘지 않으므로 접근성 트리에 자동 반영되지 않는다(실측 — 속성은
-     * 붙어 있는데 접근성 트리의 `aria-current`는 계속 비어 있음). `render()`가 이
-     * 값을 읽어 내부 `<a>`에 직접 옮긴다.
-     *
-     * 둘 다 Lit 리액티브 프로퍼티로 선언돼 있지 않아 `observedAttributes`에 없다 —
-     * 그 목록에 없는 속성은 `attributeChangedCallback` 자체가 호출되지 않는다
-     * (커스텀 엘리먼트 표준 동작). 초기 렌더는 되지만 연결 후 동적 변경은 반영되지
-     * 않았다 — 목록에 명시적으로 추가해야 한다.
-     */
-    static get observedAttributes(): string[];
-    attributeChangedCallback(name: string, old: string | null, value: string | null): void;
-    protected willUpdate(changedProperties: PropertyValues): void;
-    render(): TemplateResult<1>;
-    /** a 태그에 주입할 href 값을 계산합니다. */
-    private compute;
-    /**
-     * 클릭 가로채기 핸들러
-     * - 좌클릭(0) + 보조키 없음(ctrl/meta/shift/alt 없음) + target이 _self일 때만 SPA 라우팅 고려
-     * - 그 외(중클릭/우클릭/보조키/target=_blank 등)는 브라우저 기본 동작 유지
-     */
-    private handleClick;
-    /** 클라이언트 라우팅을 위해 popstate 이벤트를 발생시킵니다. */
-    private dispatchPopstate;
-    /** basepath를 state에서 꺼내는 헬퍼 */
-    private getBasepath;
-    static styles: CSSResult;
-}

package/dist/components/UOutlet.d.ts

@@ -1,47 +0,0 @@
-/** 렌더링 옵션 */
-interface RenderOption {
-    /** 교차 렌더링 방지 ID — 어느 라우트의 콘텐츠인가 */
-    id?: string;
-    /**
-     * 라우트의 식별 키(`RouteConfig.key` 의 결과). 같은 라우트 + 같은 키면 기존 콘텐츠를
-     * 유지한 채 제자리 갱신하고, 바뀌면 내리고 새로 마운트한다.
-     */
-    key?: string;
-}
-/**
- * LitElement 또는 React 컴포넌트를 렌더링해주는 웹컴포넌트 입니다.
- */
-declare class UOutlet extends HTMLElement {
-    /** 교차 렌더링 방지 id */
-    private routeId?;
-    /** 마지막으로 렌더한 라우트의 식별 키 */
-    private routeKey?;
-    /** 마운트된 콘텐츠의 종류 */
-    private kind?;
-    /** 실제 렌더링 컨텐츠 */
-    private root?;
-    /** 진행 중인 render — 다음 render 는 이것이 끝난 뒤 판정한다 */
-    private pending?;
-    connectedCallback(): void;
-    /**
-     * 주어진 렌더링 옵션에 따라 컨텐츠를 렌더링합니다.
-     *
-     * 같은 라우트(`id`)에 같은 키(`key`)로 다시 불리면 **제자리 갱신**한다 — Lit 템플릿은
-     * 같은 파트에 다시 렌더(요소·상태 유지, 바인딩만 갱신), React 엘리먼트는 같은 root 에 다시
-     * 렌더(컴포넌트 상태 유지), `HTMLElement` 는 기존 인스턴스를 그대로 둔다. 매번 `reset()`
-     * 을 먼저 부르던 종전 동작이 «쿼리스트링만 바뀌어도 페이지가 재마운트되는» 원인이었다
-     * (Lit 의 `render` 도 React 의 `root.render` 도 같은 컨테이너에 다시 부르면 조정한다).
-     */
-    render(value: unknown, options?: RenderOption): Promise<void>;
-    private mount;
-    /**
-     * 기존 DOM을 삭제하여, 초기 상태로 되돌립니다.
-     */
-    reset(): void;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'u-outlet': UOutlet;
-    }
-}
-export { UOutlet };

package/dist/internals/RouteTracker.d.ts

@@ -1,22 +0,0 @@
-import { RouteConfig } from '../types/RouteConfig.js';
-/**
- * 라우팅 체인 상태를 추적합니다.
- * - 방문한 href를 기록하여 리다이렉트 사이클을 감지합니다.
- * - 이미 실행된 route enter를 기록하여 중복 실행을 방지합니다.
- */
-export declare class RouteTracker {
-    private readonly _history;
-    private readonly _processed;
-    /** 새 네비게이션 시작 시 상태를 초기화합니다. */
-    reset(): void;
-    /**
-     * href 방문을 기록하고 사이클 여부를 반환합니다.
-     * @returns 사이클이 감지되면 true
-     */
-    visit(href: string): boolean;
-    /**
-     * route enter를 아직 실행하지 않았다면 키를 등록하고 true를 반환합니다.
-     * 이미 실행된 route라면 false를 반환합니다 (중첩 라우트 redirect 체인에서 중복 방지).
-     */
-    enter(route: RouteConfig): boolean;
-}

package/dist/internals/crypto-helpers.d.ts

@@ -1,8 +0,0 @@
-/**
- * 브라우저에서 랜덤한 문자열ID를 생성합니다.
- * - https일 경우 crypto.randomUUID()를 사용합니다.
- * - 그 외의 경우 crypto.getRandomValues()를 사용합니다.
- *
- * @return 랜덤한 ID 문자열
- */
-export declare function getRandomID(): string;

package/dist/internals/element-helpers.d.ts

@@ -1,36 +0,0 @@
-import { UOutlet } from '../components/UOutlet';
-/**
- * `u-outlet` 엘리먼트를 찾아 반환합니다.
- *
- * @param element 검색을 시작할 HTMLElement
- * @param skip element 자신을 검사에서 제외할지 여부 (기본값: false)
- * @returns 찾은 UOutlet 엘리먼트 또는 undefined
- */
-export declare function findOutlet(element: HTMLElement, skip?: boolean): UOutlet | undefined;
-/**
- * `u-outlet` 엘리먼트를 찾아 반환합니다. 없으면 에러를 던집니다.
- *
- * @param element 검색을 시작할 HTMLElement
- * @param skip element 자신을 검사에서 제외할지 여부 (기본값: false)
- *
- * @returns 찾은 UOutlet 엘리먼트
- * @throws OutletMissingError `u-outlet` 엘리먼트를 찾지 못한 경우
- */
-export declare function findOutletOrThrow(element: HTMLElement, skip?: boolean): UOutlet;
-/**
- * 주어진 엘리먼트 내에서 `u-outlet`이 준비될 때까지 대기합니다.
- *
- * @param element 대기할 엘리먼트
- * @param timeout 타임아웃 시간(밀리초, 기본값: 10_000ms)
- * @param skip element 자신을 검사에서 제외할지 여부 (기본값: false)
- *
- * @returns 준비된 `u-outlet` 엘리먼트
- */
-export declare function waitOutlet(element: HTMLElement, timeout?: number, skip?: boolean): Promise<UOutlet>;
-/**
- * 이벤트에서 composedPath()/closest를 사용하여 A 태그를 찾아 반환합니다.
- *
- * @param event 이벤트 객체
- * @returns 찾은 A 태그 엘리먼트 또는 null
- */
-export declare function findAnchorFrom(event: Event): HTMLAnchorElement | null;

package/dist/internals/route-helpers.d.ts

@@ -1,21 +0,0 @@
-import { RouteConfig } from '../types/RouteConfig';
-/**
- * 라우트들을 다음 사항에 따라 재귀적으로 재설정합니다.
- * - 각 라우트에 고유 `id`를 랜덤하게 부여합니다.
- * - `path`를 URLPattern 객체로 변환합니다.
- * - 자식 라우트가 있으면 재귀적으로 재설정합니다.
- *
- * @param routes 설정할 라우트 배열
- * @param basepath 기준이 되는 basepath 문자열
- * @returns 재설정된 라우트 배열
- */
-export declare function setRoutes(routes: RouteConfig[], basepath: string): RouteConfig[];
-/**
- * URLPattern을 사용하여 경로와 일치하는 라우트들을 자식 라우트까지 포함하여 반환합니다.
- * 반환된 배열은 상위 라우트부터 하위 라우트 순서로 정렬됩니다.
- *
- * @param routes 검사할 라우트 배열
- * @param pathname 검사할 경로 이름
- * @returns 일치하는 라우트 배열
- */
-export declare function getRoutes(routes: RouteConfig[], pathname: string): RouteConfig[];

package/dist/internals/url-helpers.d.ts

@@ -1,38 +0,0 @@
-import { RouteContext } from '../types/RouteContext';
-/**
- * 주어진 URL이 외부 링크인지 확인합니다.
- *
- * @param url 확인할 URL 문자열
- * @return 외부 링크인 경우 true, 내부 링크인 경우 false
- */
-export declare function isExternalUrl(url: string): boolean;
-/**
- * URL 문자열을 파싱하여 RouteContext 객체로 반환합니다.
- * - http(s)로 시작하는 절대 URL은 외부 링크로 간주됩니다.
- * - 절대경로(/...)는 그대로 사용됩니다.
- * - 상대경로는 basepath를 기준으로 절대경로로 변환됩니다.
- * - 쿼리스트링(?)로 시작하는 쿼리는 현재 경로와 추가됩니다.
- * - 해시(#)로 시작하는 해시는 현재 경로와 추가됩니다.
- *
- * @param url 파싱할 URL 문자열
- * @param basepath 기준이 되는 basepath 문자열
- * @returns 파싱된 RouteContext 객체
- */
-export declare function parseUrl(url: string, basepath: string): RouteContext;
-/**
- * pathname 경로를 조합하여 절대경로를 반환합니다.
- *
- * @param paths 조합할 경로 문자열들
- * @returns 조합된 절대경로 문자열
- */
-export declare function absolutePath(...paths: string[]): string;
-/**
- * basepath가 동적 패턴일 경우(RouteConfig에서 basepath가 :id 등으로 정의된 경우),
- * 현재 경로에서 해당되는 패턴의 basepath를 추출하여 반환합니다.
- *
- * @param basepath 동적 패턴이 포함된 basepath 문자열
- * @return 현재 경로에 매칭되는 basepath 문자열
- * @example
- * catchBasePath('/app/:id') => '/app/123'
- */
-export declare function catchBasepath(basepath: string): string;

package/dist/types/NavigateOptions.d.ts

@@ -1,25 +0,0 @@
-/**
- * go() 메서드에 전달할 네비게이션 옵션
- */
-export interface NavigateOptions {
-    /**
-     * 리다이렉트로 인한 네비게이션 여부.
-     * - `true`이면 히스토리에 새 항목을 추가하지 않고 현재 항목을 교체합니다(replaceState).
-     * - 뒤로가기 버튼이 리다이렉트 경유지를 건너뛰게 됩니다.
-     * - 리다이렉트 사이클 감지에 사용됩니다.
-     * @default false
-     */
-    isRedirect?: boolean;
-    /**
-     * 히스토리에 새 항목을 추가하지 않고 현재 항목을 교체합니다(replaceState).
-     * - `isRedirect`와 달리 리다이렉트 체인 추적에는 영향을 주지 않습니다.
-     * @default false
-     */
-    replace?: boolean;
-    /**
-     * pushState / replaceState 호출 시 함께 저장할 커스텀 상태 객체.
-     * - `history.state`로 다시 읽을 수 있습니다.
-     * @example { from: '/login', referrer: 'email-link' }
-     */
-    state?: Record<string, unknown>;
-}