@iyulab/router 0.9.2 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.10.0] - 2026-06-11
+
+### Changed
+- Click interception now checks route matching before `preventDefault()`: same-origin anchors that do not match any registered route are passed through to native browser navigation instead of rendering the fallback (soft-404). This fixes apps with `basepath: '/'` greedily intercepting every same-origin link — e.g. cross-app links on a shared host (ISSUE-1781049600-router-basepath-root-greedy-intercept)
+
+### Added
+- Vitest-based test infrastructure (`npm test`) with coverage for anchor click interception behavior
+
+## [0.9.3] - 2026-04-24
+
+### Fixed
+- Document click handler now scopes interception to the router's `_rootElement` instead of `document`, preventing accidental capture of clicks outside the router's DOM subtree
+- Click handler no longer intercepts same-origin anchors pointing outside `basepath` — when `basepath` is not `/`, links targeting paths outside the basepath are passed through to browser navigation instead of falling through to the fallback route
+
 ## [0.9.2] - 2026-04-13
 
 ### Fixed

package/dist/Router.d.ts

@@ -0,0 +1,38 @@
+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 네비게이션 옵션
+     */
+    go(href: string, options?: NavigateOptions): Promise<undefined>;
+    /** 브라우저 히스토리 이벤트가 발생시 라우팅 처리 */
+    private handleWindowPopstate;
+    /** 클릭 이벤트에서 라우터로 처리할 앵커를 찾아 클라이언트 라우팅 수행 */
+    private handleRootElementClick;
+}

package/dist/components/UErrorPage.d.ts

@@ -0,0 +1,16 @@
+import { LitElement } from 'lit';
+import { RouteError } from '../types/RouteError.js';
+/**
+ * 라우팅 중 발생한 에러 정보를 사용자에게 전달하기 위한 기본 컴포넌트 입니다.
+ */
+export declare class UErrorPage extends LitElement {
+    constructor(error?: RouteError);
+    /** 표시할 에러 정보 */
+    error?: RouteError;
+    render(): import('lit-html').TemplateResult<1>;
+    /** 기본 에러 정보 반환 */
+    private getDefaultError;
+    /** 에러 코드에 따른 기본 아이콘 반환 */
+    private getErrorIcon;
+    static styles: import('lit').CSSResult;
+}

package/dist/components/ULink.d.ts

@@ -0,0 +1,57 @@
+import { LitElement, PropertyValues } from 'lit';
+/**
+ * - 클라이언트 라우팅을 지원하는 링크 엘리먼트입니다.
+ * - 내부 링크는 클라이언트 라우팅을 수행하고, 외부 링크는 브라우저 기본 네비게이션을 사용합니다.
+ * - 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;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    render(): import('lit-html').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: import('lit').CSSResult;
+}

package/dist/components/UOutlet.d.ts

@@ -0,0 +1,30 @@
+/** 렌더링 옵션 */
+interface RenderOption {
+    /** 교차 렌더링 방지 ID */
+    id?: string;
+    /** 강제 렌더링 여부 */
+    force?: boolean;
+}
+/**
+ * LitElement 또는 React 컴포넌트를 렌더링해주는 웹컴포넌트 입니다.
+ */
+declare class UOutlet extends HTMLElement {
+    /** 교차 렌더링 방지 id */
+    private routeId?;
+    /** 실제 렌더링 컨텐츠 */
+    private root?;
+    /**
+     * 주어진 렌더링 옵션에 따라 컨텐츠를 렌더링합니다.
+     */
+    render(value: unknown, options?: RenderOption): Promise<void>;
+    /**
+     * 기존 DOM을 삭제하여, 초기 상태로 되돌립니다.
+     */
+    reset(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'u-outlet': UOutlet;
+    }
+}
+export { UOutlet };

package/dist/index.d.ts

@@ -1,517 +1,12 @@
-import { CSSResult } from 'lit';
-import { LitElement } from 'lit';
-import { PropertyValues } from 'lit';
-import { TemplateResult } from 'lit-html';
-
-/**
- * enter 가드가 false를 반환하여 접근이 거부되었을 때 발생하는 에러
- */
-export declare class AccessDeniedError extends RouteError {
-    constructor(path: string);
-}
-
-/**
- * 공통 라우트 속성
- */
-declare interface BaseRouteConfig {
-    /**
-     * 라우터에서 사용하는 식별자
-     */
-    id?: string;
-    /**
-     * 브라우저의 타이틀이 설정에 따라 변경됩니다.
-     */
-    title?: string;
-    /**
-     * 라우터 경로는 string 또는 URLPattern을 사용할 수 있습니다.
-     * string일 경우 자동으로 URLPattern으로 변환됩니다.
-     * @default '/'
-     * @example
-     * - "/user/:id/:name"
-     * - "/user/:id/:name?"
-     * - "/user/:id/:name*"
-     * - "/user/:id/:name+"
-     * @link
-     * https://developer.mozilla.org/en-US/docs/Web/API/URLPattern
-     */
-    path?: string | URLPattern;
-    /**
-     * 라우트 정보를 받아 렌더링 결과를 반환합니다.
-     * @param ctx 현재 라우팅 정보 및, 진행 상태 콜백을 포함하는 Context 객체가 인자로 전달됩니다.
-     * @example
-     * ```typescript
-     * const route = {
-     *    path: '/user:id',
-     *    render: async (ctx) => {
-     *      // 사용자 정보를 비동기로 가져오는 예시
-     *      const userId = ctx.params.id;
-     *      ctx.progress(30);
-     *      const userData = await fetchUserData(userId);
-     *      ctx.progress(70);
-     *      return html`<user-profile .data=${userData}></user-profile>`;
-     *   }
-     * }
-     * ```
-     */
-    render?: (ctx: RouteContext) => Promise<unknown> | unknown;
-    /**
-     * 이 라우트 진입 전에 호출되는 enter 함수입니다.
-     * - `string` 반환: 해당 경로로 redirect
-     * - `false` 반환: 네비게이션 취소
-     * - `true` 반환: 통과
-     * @example
-     * ```typescript
-     * { path: '/admin', enter: (ctx) => ctx.metadata.role === 'admin' || '/forbidden' }
-     * ```
-     */
-    enter?: (ctx: RouteContext) => Promise<string | boolean> | string | boolean;
-    /**
-     * 라우터 URL 변경시 렌더링을 강제할지 여부
-     * - 기본값으로 children을 가질때 false로 설정되며, children이 없을 경우 true로 설정됩니다.
-     * - true로 설정하면 기존 렌더링을 무시하고 새로 렌더링합니다.
-     */
-    force?: boolean;
-    /**
-     * 경로 매칭시 대소문자 구분 여부
-     * @default false
-     */
-    ignoreCase?: boolean;
-    /**
-     * 라우트에 연결할 메타데이터
-     * - 인증, SEO, 분석 등의 용도로 사용할 수 있습니다.
-     * @example
-     * ```typescript
-     * { path: '/admin', metadata: { requiresAuth: true, role: 'admin' } }
-     * ```
-     */
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * 컨텐츠 로드시 나타나는 에러
- */
-export declare class ContentLoadError extends RouteError {
-    constructor(original?: Error | any);
-}
-
-/**
- * 컨텐츠 렌더링시 발생하는 에러
- */
-export declare class ContentRenderError extends RouteError {
-    constructor(original?: Error | any);
-}
-
-export declare interface FallbackRouteConfig {
-    /**
-     * 브라우저의 타이틀이 설정에 따라 변경됩니다.
-     */
-    title?: string;
-    /**
-     * 라우팅 실패 시 표시할 렌더링 결과를 반환합니다.
-     * - 오류가 발생할 경우 또는 렌더링 결과가 false일 경우 호출됩니다.
-     * @param ctx 현재 라우팅 정보 및 오류 정보를 포함하는 Context 객체가 인자로 전달됩니다.
-     * @example
-     * ```typescript
-     * const fallbackRoute = {
-     *    title: 'Not Found',
-     *    render: (ctx) => {
-     *      if (ctx.error) {
-     *        return html`<error-page .error=${ctx.error}></error-page>`;
-     *      }
-     *      return html`<not-found-page></not-found-page>`;
-     *    }
-     * }
-     * ```
-     */
-    render?: (ctx: FallbackRouteContext) => Promise<unknown> | unknown;
-}
-
-export declare interface FallbackRouteContext extends RouteContext {
-    /**
-     * 라우팅 에러 정보
-     * - 라우팅 중 발생한 에러 정보를 포함합니다.
-     */
-    error: RouteError;
-}
-
-declare interface IndexRouteConfig extends BaseRouteConfig {
-    /**
-     * 현재 경로의 인덱스 라우트임을 나타냅니다.
-     * - 인덱스 라우트는 부모 경로와 동일한 경로를 가지며, path는 자동으로 설정됩니다.
-     */
-    index: true;
-}
-
-/**
- * go() 메서드에 전달할 네비게이션 옵션
- */
-export declare 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>;
-}
-
-declare interface NonIndexRouteConfig extends BaseRouteConfig {
-    /**
-     * 인덱스 라우트가 아님을 나타냅니다.
-     */
-    index?: false;
-    /**
-     * 하위 라우트 설정, 재귀적으로 RouteConfig 배열을 가질 수 있습니다.
-     * - 하위 라우트가 있는 경우, 부모 라우트의 경로를 기준으로 매칭됩니다.
-     */
-    children?: RouteConfig[];
-}
-
-/**
- * 페이지를 찾을 수 없을 때 발생하는 에러
- */
-export declare class NotFoundError extends RouteError {
-    constructor(path: string, original?: Error | any);
-}
-
-/**
- * u-outlet 요소를 찾을 수 없을 때 발생하는 에러
- */
-export declare class OutletMissingError extends RouteError {
-    constructor();
-}
-
-/** 렌더링 옵션 */
-declare interface RenderOption {
-    /** 교차 렌더링 방지 ID */
-    id?: string;
-    /** 강제 렌더링 여부 */
-    force?: boolean;
-}
-
-/**
- * 라우트 시작 이벤트
- */
-export declare class RouteBeginEvent extends RouteEvent {
-    constructor(context: RouteContext);
-}
-
-export declare type RouteConfig = IndexRouteConfig | NonIndexRouteConfig;
-
-/**
- * 라우터 정보
- */
-export declare interface RouteContext {
-    /**
-     * 전체 URL 정보
-     * - 도메인 이름을 포함한 URL의 전체 경로입니다.
-     * @example https://www.iyulab.com/home/user/1?name=iyu#profile
-     */
-    href: string;
-    /**
-     * URL 도메인 이름
-     * - URL의 도메인 이름입니다.
-     * @example https://www.iyulab.com
-     */
-    origin: string;
-    /**
-     * 라우터 URL 기본 경로
-     * - 라우터의 현재 basepath입니다.
-     * @example
-     * if basepath is /app/:id
-     * set basepath to /app/123
-     */
-    basepath: string;
-    /**
-     * 라우터 URL 전체 경로
-     * - 도메인 이름을 제외한 URL의 전체 경로입니다.
-     * @example /home/user/1?name=iyu#profile
-     */
-    path: string;
-    /**
-     * 라우터 URL 절대 경로
-     * - 쿼리스트링과 해시를 제외한 URL 경로입니다.
-     * @example /home/user/1
-     */
-    pathname: string;
-    /**
-     * 라우터 URL 파라미터
-     * - URLPattern을 사용하여 파싱된 파라미터입니다.
-     * @example 만약 URL이 /user/:id/:name 일경우
-     * ```typescript
-     * const id = params.id;
-     * const name = params.name;
-     * ```
-     */
-    params: {
-        [key: string]: string | undefined;
-    };
-    /**
-     * 라우터 URL 쿼리스트링
-     * - URLSearchParams를 사용하여 파싱된 쿼리스트링입니다.
-     * @example 만약 URL이 ?page=1&size=10 일경우
-     * ```typescript
-     * const page = query.get('page');
-     * const size = query.get('size');
-     * ```
-     */
-    query: URLSearchParams;
-    /**
-     * 라우터 URL 해시
-     * - URL의 해시값입니다. 해시값은 하나만 사용할 수 있습니다.
-     * - #profile#user 두개 이상의 해시값은 하나로 취급합니다.
-     * @example #profile
-     */
-    hash?: string;
-    /**
-     * 현재 라우팅의 진행 상태를 업데이트하여, window 객체의 'route-progress' 이벤트를 트리거합니다.
-     * 여러 라우팅이 호출되는 경우, 가장 최근의 라우팅의 진행 상태만 반영되며, 나머지는 무시됩니다.
-     * @param value 진행 상태 값 (0~100)
-     */
-    progress: (value: number) => void;
-    /**
-     * 매칭된 라우트 체인의 병합된 메타데이터
-     * - 부모 라우트에서 자식 라우트 순서로 병합됩니다.
-     */
-    metadata: Record<string, unknown>;
-}
-
-/**
- * 라우트 완료 이벤트
- */
-export declare class RouteDoneEvent extends RouteEvent {
-    constructor(context: RouteContext);
-}
-
-/**
- * 라우팅 에러 정보
- */
-export declare class RouteError extends Error {
-    /**
-     * 에러 코드
-     * - HTTP 상태 코드 또는 커스텀 에러 코드
-     * @example 404, 500, 'ROUTE_NOT_FOUND'
-     */
-    code: number | string;
-    /**
-     * 원본 에러 객체
-     * - 원본 Error 객체 또는 예외 정보
-     */
-    original?: Error | any;
-    /**
-     * 에러 발생 시간
-     * - 에러가 발생한 시간 (ISO 8601 형식)
-     */
-    timestamp: string;
-    constructor(code: number | string, message: string, original?: Error | any);
-}
-
-/**
- * 라우트 에러 이벤트
- */
-export declare class RouteErrorEvent extends RouteEvent {
-    /** 에러 정보 */
-    readonly error: RouteError;
-    constructor(context: RouteContext, error: RouteError);
-}
-
-/** 라우터 이벤트 기본 클래스 */
-declare abstract class RouteEvent extends Event {
-    /** 라우팅 정보 */
-    readonly context: RouteContext;
-    /** 이벤트 발생 시간 */
-    readonly timestamp: string;
-    constructor(type: string, context: RouteContext, cancelable?: boolean);
-    /** 이벤트가 취소되었는지 확인 */
-    get cancelled(): boolean;
-    /** 이벤트 취소 */
-    cancel(): void;
-}
-
-/**
- * 라우트 진행 이벤트
- */
-export declare class RouteProgressEvent extends RouteEvent {
-    /** 진행 상태 값 (0~100) */
-    readonly progress: number;
-    constructor(context: RouteContext, progress: number);
-}
-
-/**
- * `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 네비게이션 옵션
-     */
-    go(href: string, options?: NavigateOptions): Promise<undefined>;
-    /** 브라우저 히스토리 이벤트가 발생시 라우팅 처리 */
-    private handleWindowPopstate;
-    /** 클릭 이벤트에서 라우터로 처리할 앵커를 찾아 클라이언트 라우팅 수행 */
-    private handleDocumentClick;
-}
-
-/**
- * 라우터 설정
- */
-export declare interface RouterConfig {
-    /**
-     * 라우터가 연결될 최상위 엘리먼트
-     */
-    root: HTMLElement;
-    /**
-     * 라우터의 기본 경로
-     * - 라우터의 기본 경로는 URL의 시작점입니다.
-     * - URLPattern을 사용하여 경로를 탐색합니다.
-     * @default  '/'
-     */
-    basepath?: string;
-    /**
-     * 라우트 설정
-     * - 라우트는 URLPattern을 사용하여 경로를 탐색합니다.
-     * - 라우트는 렌더링할 엘리먼트 또는 컴포넌트를 지정합니다.
-     */
-    routes?: RouteConfig[];
-    /**
-     * 모든 라우트 전환 전에 호출되는 글로벌 enter 함수입니다.
-     * - `string` 반환: 해당 경로로 redirect
-     * - `false` 반환: 네비게이션 취소
-     * - `true` 반환: 통과
-     * @example
-     * ```typescript
-     * enter: async (ctx) => {
-     *   if (!isAuthenticated() && ctx.pathname !== '/login') return '/login';
-     * }
-     * ```
-     */
-    enter?: (ctx: RouteContext) => Promise<string | boolean> | string | boolean;
-    /**
-     * 라우트 매칭 실패 또는 오류 발생 시 대체 라우트 설정
-     * - 지정된 설정이 없을 경우, 기본 오류 페이지가 렌더링됩니다.
-     */
-    fallback?: FallbackRouteConfig;
-    /**
-     * `a` 태그 클릭 시 클라이언트 라우팅을 수행할지 여부를 설정합니다.
-     * @default true
-     */
-    useIntercept?: boolean;
-    /**
-     * 초기 로드 시 현재 URL로 라우팅을 자동으로 수행할지 여부를 설정합니다.
-     * @default true
-     */
-    initialLoad?: boolean;
-}
-
-/**
- * - 클라이언트 라우팅을 지원하는 링크 엘리먼트입니다.
- * - 내부 링크는 클라이언트 라우팅을 수행하고, 외부 링크는 브라우저 기본 네비게이션을 사용합니다.
- * - 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;
-    connectedCallback(): void;
-    disconnectedCallback(): 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;
-}
-
-/**
- * LitElement 또는 React 컴포넌트를 렌더링해주는 웹컴포넌트 입니다.
- */
-export declare class UOutlet extends HTMLElement {
-    /** 교차 렌더링 방지 id */
-    private routeId?;
-    /** 실제 렌더링 컨텐츠 */
-    private root?;
-    /**
-     * 주어진 렌더링 옵션에 따라 컨텐츠를 렌더링합니다.
-     */
-    render(value: unknown, options?: RenderOption): Promise<void>;
-    /**
-     * 기존 DOM을 삭제하여, 초기 상태로 되돌립니다.
-     */
-    reset(): void;
-}
-
-export { }
+export * from './types/NavigateOptions';
+export * from './types/RouteConfig';
+export * from './types/RouteContext';
+export * from './types/RouteError';
+export * from './types/RouteEvent';
+export * from './types/RouterConfig';
+export * from './components/UOutlet';
+export * from './components/ULink';
+export { Router } from './Router';
 
 declare global {
   interface WindowEventMap {