@iyulab/router 0.7.4 → 0.7.5

package/dist/index.js

@@ -1,131 +1,144 @@
-import { a as absolutePath, i as isExternalUrl, p as parseUrl } from "./share-CG-3Tbuy.js";
-import { U, b } from "./share-CG-3Tbuy.js";
-import { css, LitElement, html } from "lit";
-import { property, customElement } from "lit/decorators.js";
-class RouteError extends Error {
-  constructor(code, message, original) {
-    super(message);
-    this.name = "RouteError";
-    this.code = code;
-    this.original = original;
-    this.timestamp = (/* @__PURE__ */ new Date()).toISOString();
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, RouteError);
-    }
-  }
-}
-class NotFoundError extends RouteError {
-  constructor(path, original) {
-    super(404, `Page not found: ${path}`, original);
-  }
-}
-class OutletMissingError extends RouteError {
-  constructor() {
-    super("OUTLET_MISSING", "Router outlet element not found. Add <u-outlet> to your template.");
-  }
-}
-class ContentLoadError extends RouteError {
-  constructor(original) {
-    super("CONTENT_LOAD_FAILED", "Failed to load route content. Check browser console for details.", original);
-  }
-}
-class ContentRenderError extends RouteError {
-  constructor(original) {
-    super("CONTENT_RENDER_FAILED", "Failed to render route component. Check browser console for details.", original);
-  }
-}
-class RouteEvent extends Event {
-  constructor(type, context, cancelable = false) {
-    super(type, { bubbles: true, composed: true, cancelable });
-    this.context = context;
-    this.timestamp = (/* @__PURE__ */ new Date()).toISOString();
-  }
-  /** 이벤트가 취소되었는지 확인 */
-  get cancelled() {
-    return this.defaultPrevented;
-  }
-  /** 이벤트 취소 */
-  cancel() {
-    if (this.cancelable) {
-      this.preventDefault();
-    }
-  }
-}
-class RouteBeginEvent extends RouteEvent {
-  constructor(context) {
-    super("route-begin", context, false);
-  }
-}
-class RouteProgressEvent extends RouteEvent {
-  constructor(context, progress) {
-    super("route-progress", context, false);
-    this.progress = progress;
-  }
-}
-class RouteDoneEvent extends RouteEvent {
-  constructor(context) {
-    super("route-done", context, false);
-  }
-}
-class RouteErrorEvent extends RouteEvent {
-  constructor(context, error) {
-    super("route-error", context, false);
-    this.error = error;
-  }
-}
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
-  for (var i = decorators.length - 1, decorator; i >= 0; i--)
-    if (decorator = decorators[i])
-      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-  if (kind && result) __defProp(target, key, result);
-  return result;
+import { a as isExternalUrl, i as absolutePath, n as __decorate, o as parseUrl, r as __decorateMetadata, s as UOutlet, t as ULink } from "./share-sbAElOI7.js";
+import { LitElement, css, html } from "lit";
+import { customElement, property } from "lit/decorators.js";
+//#region src/types/RouteError.ts
+/**
+* 라우팅 에러 정보
+*/
+var RouteError = class RouteError extends Error {
+	constructor(code, message, original) {
+		super(message);
+		this.name = "RouteError";
+		this.code = code;
+		this.original = original;
+		this.timestamp = (/* @__PURE__ */ new Date()).toISOString();
+		if (Error.captureStackTrace) Error.captureStackTrace(this, RouteError);
+	}
+};
+/**
+* 페이지를 찾을 수 없을 때 발생하는 에러
+*/
+var NotFoundError = class extends RouteError {
+	constructor(path, original) {
+		super(404, `Page not found: ${path}`, original);
+	}
+};
+/**
+* u-outlet 요소를 찾을 수 없을 때 발생하는 에러
+*/
+var OutletMissingError = class extends RouteError {
+	constructor() {
+		super("OUTLET_MISSING", "Router outlet element not found. Add <u-outlet> to your template.");
+	}
+};
+/**
+* 컨텐츠 로드시 나타나는 에러
+*/
+var ContentLoadError = class extends RouteError {
+	constructor(original) {
+		super("CONTENT_LOAD_FAILED", "Failed to load route content. Check browser console for details.", original);
+	}
+};
+/**
+* 컨텐츠 렌더링시 발생하는 에러
+*/
+var ContentRenderError = class extends RouteError {
+	constructor(original) {
+		super("CONTENT_RENDER_FAILED", "Failed to render route component. Check browser console for details.", original);
+	}
+};
+//#endregion
+//#region src/types/RouteEvent.ts
+/** 라우터 이벤트 기본 클래스 */
+var RouteEvent = class extends Event {
+	constructor(type, context, cancelable = false) {
+		super(type, {
+			bubbles: true,
+			composed: true,
+			cancelable
+		});
+		this.context = context;
+		this.timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	}
+	/** 이벤트가 취소되었는지 확인 */
+	get cancelled() {
+		return this.defaultPrevented;
+	}
+	/** 이벤트 취소 */
+	cancel() {
+		if (this.cancelable) this.preventDefault();
+	}
 };
-let UErrorPage = class extends LitElement {
-  render() {
-    const error = this.error || this.getDefaultError();
-    const icon = this.getErrorIcon(error.code);
-    return html`
-      <div class="icon">${icon}</div>
+/**
+* 라우트 시작 이벤트
+*/
+var RouteBeginEvent = class extends RouteEvent {
+	constructor(context) {
+		super("route-begin", context, false);
+	}
+};
+/**
+* 라우트 진행 이벤트
+*/
+var RouteProgressEvent = class extends RouteEvent {
+	constructor(context, progress) {
+		super("route-progress", context, false);
+		this.progress = progress;
+	}
+};
+/**
+* 라우트 완료 이벤트
+*/
+var RouteDoneEvent = class extends RouteEvent {
+	constructor(context) {
+		super("route-done", context, false);
+	}
+};
+/**
+* 라우트 에러 이벤트
+*/
+var RouteErrorEvent = class extends RouteEvent {
+	constructor(context, error) {
+		super("route-error", context, false);
+		this.error = error;
+	}
+};
+//#endregion
+//#region src/components/UErrorPage.ts
+var _ref;
+var UErrorPage = class UErrorPage extends LitElement {
+	render() {
+		const error = this.error || this.getDefaultError();
+		return html`
+      <div class="icon">${this.getErrorIcon(error.code)}</div>
       <div class="code">${error.code}</div>
       <div class="message">${error.message}</div>
     `;
-  }
-  /** 기본 에러 정보 반환 */
-  getDefaultError() {
-    return new RouteError(500, "Something went wrong. Please try again or contact support if the problem persists.");
-  }
-  /** 에러 코드에 따른 기본 아이콘 반환 */
-  getErrorIcon(code) {
-    const codeStr = String(code);
-    const numericCode = typeof code === "string" ? parseInt(code) : code;
-    switch (codeStr) {
-      case "OUTLET_MISSING":
-        return "📦";
-      case "CONTENT_LOAD_FAILED":
-        return "📡";
-      case "CONTENT_RENDER_FAILED":
-        return "🎨";
-    }
-    switch (numericCode) {
-      case 404:
-        return "🔍";
-      case 403:
-        return "🚫";
-      case 401:
-        return "🔐";
-      case 429:
-        return "⏱️";
-      case 503:
-        return "🛠️";
-      default:
-        return "⚠️";
-    }
-  }
-};
-UErrorPage.styles = css`
+	}
+	/** 기본 에러 정보 반환 */
+	getDefaultError() {
+		return new RouteError(500, "Something went wrong. Please try again or contact support if the problem persists.");
+	}
+	/** 에러 코드에 따른 기본 아이콘 반환 */
+	getErrorIcon(code) {
+		const codeStr = String(code);
+		const numericCode = typeof code === "string" ? parseInt(code) : code;
+		switch (codeStr) {
+			case "OUTLET_MISSING": return "📦";
+			case "CONTENT_LOAD_FAILED": return "📡";
+			case "CONTENT_RENDER_FAILED": return "🎨";
+		}
+		switch (numericCode) {
+			case 404: return "🔍";
+			case 403: return "🚫";
+			case 401: return "🔐";
+			case 429: return "⏱️";
+			case 503: return "🛠️";
+			default: return "⚠️";
+		}
+	}
+	static {
+		this.styles = css`
     :host {
       --error-icon-color: #4a5568;
       --error-code-color: #1a202c;
@@ -179,264 +192,281 @@ UErrorPage.styles = css`
       max-width: 600px;
     }
   `;
-__decorateClass([
-  property({ type: Object })
-], UErrorPage.prototype, "error", 2);
-UErrorPage = __decorateClass([
-  customElement("u-error-page")
-], UErrorPage);
+	}
+};
+__decorate([property({ type: Object }), __decorateMetadata("design:type", typeof (_ref = typeof RouteError !== "undefined" && RouteError) === "function" ? _ref : Object)], UErrorPage.prototype, "error", void 0);
+UErrorPage = __decorate([customElement("u-error-page")], UErrorPage);
+//#endregion
+//#region src/internals/crypto-helpers.ts
+/**
+* 브라우저에서 랜덤한 문자열ID를 생성합니다.
+* - https일 경우 crypto.randomUUID()를 사용합니다.
+* - 그 외의 경우 crypto.getRandomValues()를 사용합니다.
+* 
+* @return 랜덤한 ID 문자열
+*/
 function getRandomID() {
-  return window.isSecureContext ? window.crypto.randomUUID() : window.crypto.getRandomValues(new Uint32Array(1))[0].toString(16);
+	return window.isSecureContext ? window.crypto.randomUUID() : window.crypto.getRandomValues(new Uint32Array(1))[0].toString(16);
 }
+//#endregion
+//#region src/internals/element-helpers.ts
+/** 
+* `u-outlet` 엘리먼트를 찾아 반환합니다. 
+* 
+* @param element 검색을 시작할 HTMLElement
+* @returns 찾은 UOutlet 엘리먼트 또는 undefined
+*/
 function findOutlet(element) {
-  if (element.tagName === "U-OUTLET") return element;
-  const roots = element.shadowRoot ? [element.shadowRoot, element] : [element];
-  for (const root of roots) {
-    for (const child of Array.from(root.children)) {
-      const result = findOutlet(child);
-      if (result) return result;
-    }
-  }
-  return void 0;
+	if (element.tagName === "U-OUTLET") return element;
+	const roots = element.shadowRoot ? [element.shadowRoot, element] : [element];
+	for (const root of roots) for (const child of Array.from(root.children)) {
+		const result = findOutlet(child);
+		if (result) return result;
+	}
 }
+/** 
+* `u-outlet` 엘리먼트를 찾아 반환합니다. 없으면 에러를 던집니다. 
+* 
+* @param element 검색을 시작할 HTMLElement
+* @returns 찾은 UOutlet 엘리먼트
+* @throws OutletMissingError `u-outlet` 엘리먼트를 찾지 못한 경우
+*/
 function findOutletOrThrow(element) {
-  const outlet = findOutlet(element);
-  if (!outlet) {
-    throw new OutletMissingError();
-  }
-  return outlet;
+	const outlet = findOutlet(element);
+	if (!outlet) throw new OutletMissingError();
+	return outlet;
 }
+/** 
+* 주어진 엘리먼트 내에서 `u-outlet`이 준비될 때까지 대기합니다.
+* 
+* @param element 대기할 엘리먼트
+* @param timeout 타임아웃 시간(밀리초, 기본값: 10_000ms)
+* @returns 준비된 `u-outlet` 엘리먼트
+*/
 async function waitOutlet(element, timeout = 1e4) {
-  const start = performance.now();
-  while (performance.now() - start < timeout) {
-    const outlet = findOutlet(element);
-    if (outlet) return outlet;
-    await new Promise((r) => setTimeout(r, 50));
-  }
-  throw new Error(
-    `Timed out waiting for <u-outlet> inside <${element.tagName.toLowerCase()}>. Ensure that the router root element contains a <u-outlet> child.`
-  );
+	const start = performance.now();
+	while (performance.now() - start < timeout) {
+		const outlet = findOutlet(element);
+		if (outlet) return outlet;
+		await new Promise((r) => setTimeout(r, 50));
+	}
+	throw new Error(`Timed out waiting for <u-outlet> inside <${element.tagName.toLowerCase()}>. Ensure that the router root element contains a <u-outlet> child.`);
 }
+/** 
+* 이벤트에서 composedPath()/closest를 사용하여 A 태그를 찾아 반환합니다. 
+* 
+* @param event 이벤트 객체
+* @returns 찾은 A 태그 엘리먼트 또는 null
+*/
 function findAnchorFrom(event) {
-  const targets = event.composedPath() || [];
-  if (targets && targets.length) {
-    for (const node of targets) {
-      if (!(node instanceof Element)) continue;
-      if (node.tagName === "A") return node;
-    }
-  }
-  const tgt = event.target;
-  if (!tgt) return null;
-  return tgt.closest("a");
+	const targets = event.composedPath() || [];
+	if (targets && targets.length) for (const node of targets) {
+		if (!(node instanceof Element)) continue;
+		if (node.tagName === "A") return node;
+	}
+	const tgt = event.target;
+	if (!tgt) return null;
+	return tgt.closest("a");
 }
+//#endregion
+//#region src/internals/route-helpers.ts
+/**
+* 라우트들을 다음 사항에 따라 재귀적으로 재설정합니다.
+* - 각 라우트에 고유 `id`를 랜덤하게 부여합니다.
+* - `path`를 URLPattern 객체로 변환합니다.
+* - 자식 라우트가 있으면 재귀적으로 재설정합니다.
+* 
+* @param routes 설정할 라우트 배열
+* @param basepath 기준이 되는 basepath 문자열
+* @returns 재설정된 라우트 배열
+*/
 function setRoutes(routes, basepath) {
-  for (const route of routes) {
-    route.id ||= getRandomID();
-    route.ignoreCase ||= false;
-    if (route.index === true) {
-      route.path = new URLPattern({ 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 (route.children && route.children.length > 0) {
-        const childBasepath = route.path.pathname.replace("{/}?", "");
-        route.children = setRoutes(route.children, childBasepath);
-        route.force ||= false;
-      } else {
-        route.force ||= true;
-      }
-    }
-  }
-  return routes;
+	for (const route of routes) {
+		route.id ||= getRandomID();
+		route.ignoreCase ||= false;
+		if (route.index === true) {
+			route.path = new URLPattern({ 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 (route.children && route.children.length > 0) {
+				const childBasepath = route.path.pathname.replace("{/}?", "");
+				route.children = setRoutes(route.children, childBasepath);
+				route.force ||= false;
+			} else route.force ||= true;
+		}
+	}
+	return routes;
 }
+/** 
+* URLPattern을 사용하여 경로와 일치하는 라우트들을 자식 라우트까지 포함하여 반환합니다.
+* 반환된 배열은 상위 라우트부터 하위 라우트 순서로 정렬됩니다.
+* 
+* @param routes 검사할 라우트 배열 
+* @param pathname 검사할 경로 이름
+* @returns 일치하는 라우트 배열
+*/
 function getRoutes(routes, pathname) {
-  for (const route of routes) {
-    if (route.index !== true && route.children && route.children.length > 0) {
-      const childRoutes = getRoutes(route.children, pathname);
-      if (childRoutes.length > 0) {
-        return [route, ...childRoutes];
-      }
-    }
-    if (route.path instanceof URLPattern) {
-      const isMatch = route.path.test({ pathname });
-      if (isMatch) return [route];
-    } else {
-      throw new Error("Route path must be an instance of URLPattern, Something wrong in setRoutes function.");
-    }
-  }
-  return [];
-}
-class Router {
-  constructor(config) {
-    this.handleWindowPopstate = async (_) => {
-      const href = window.location.href;
-      await this.go(href);
-    };
-    this.handleDocumentClick = async (e) => {
-      try {
-        if (e.defaultPrevented) return;
-        if (e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey) return;
-        const anchor = findAnchorFrom(e);
-        if (!anchor) return;
-        const href = anchor.getAttribute("href") || anchor.href;
-        if (!href) return;
-        if (isExternalUrl(href)) return;
-        if (anchor.hasAttribute("download")) return;
-        if (anchor.getAttribute("rel") === "external") return;
-        if (anchor.target && anchor.target !== "") return;
-        e.preventDefault();
-        await this.go(anchor.href);
-      } catch {
-      }
-    };
-    this.destroy();
-    this._rootElement = config.root;
-    this._basepath = absolutePath(config.basepath || "/");
-    this._routes = setRoutes(config.routes || [], this._basepath);
-    this._fallback = config.fallback;
-    window.addEventListener("popstate", this.handleWindowPopstate);
-    if (config.useIntercept !== false) {
-      document.addEventListener("click", this.handleDocumentClick);
-    }
-    if (config.initialLoad !== false) {
-      void waitOutlet(this._rootElement).then(() => {
-        this.go(window.location.href);
-      });
-    }
-  }
-  /** 객체를 정리하고 이벤트 리스너를 제거합니다. */
-  destroy() {
-    window.removeEventListener("popstate", this.handleWindowPopstate);
-    document.removeEventListener("click", this.handleDocumentClick);
-    this._requestID = void 0;
-    this._context = void 0;
-  }
-  /** 라우터의 기본 경로 반환 */
-  get basepath() {
-    return this._basepath;
-  }
-  /** 등록된 라우트 정보 반환 */
-  get routes() {
-    return this._routes;
-  }
-  /** 현재 라우팅 정보 반환 */
-  get context() {
-    return this._context;
-  }
-  /**
-   * 지정한 경로의 클라이언트 라우팅을 수행합니다. 상대경로일 경우 basepath와 조합되어 이동합니다.
-   * @param href 이동할 경로
-   */
-  async go(href) {
-    const requestID = getRandomID();
-    this._requestID = requestID;
-    const context = parseUrl(href, this._basepath);
-    if (context.href !== window.location.href) {
-      window.history.pushState({ basepath: context.basepath }, "", context.href);
-    } else {
-      window.history.replaceState({ basepath: context.basepath }, "", context.href);
-    }
-    const progressCallback = (value) => {
-      if (this._requestID !== requestID) return;
-      const progress = Math.max(0, Math.min(100, Math.round(value)));
-      window.dispatchEvent(new RouteProgressEvent(context, progress));
-    };
-    context.progress = progressCallback;
-    let outlet = void 0;
-    try {
-      if (this._requestID !== requestID) return;
-      window.dispatchEvent(new RouteBeginEvent(context));
-      const routes = getRoutes(this._routes, context.pathname);
-      const lastRoute = routes[routes.length - 1];
-      if (lastRoute && lastRoute.path instanceof URLPattern) {
-        context.params = lastRoute.path.exec({ pathname: context.pathname })?.pathname.groups || {};
-      }
-      const mergedMeta = {};
-      for (const route of routes) {
-        if (route.meta) Object.assign(mergedMeta, route.meta);
-      }
-      context.meta = mergedMeta;
-      this._context = context;
-      outlet = findOutletOrThrow(this._rootElement);
-      let title = void 0;
-      let content = null;
-      if (routes.length === 0) {
-        throw new NotFoundError(context.href);
-      }
-      for (const route of routes) {
-        if (this._requestID !== requestID) return;
-        if (!route.render) continue;
-        try {
-          content = await route.render(context);
-          if (content === false || content === void 0 || content === null) {
-            throw new Error("Failed to load content for the route.");
-          }
-        } catch (LoadError) {
-          throw new ContentLoadError(LoadError);
-        }
-        try {
-          outlet.render({ id: route.id, value: content, force: route.force });
-        } catch (renderError) {
-          throw new ContentRenderError(renderError);
-        }
-        outlet = findOutlet(outlet) || outlet;
-        title = route.title || title;
-      }
-      document.title = title || document.title;
-      window.dispatchEvent(new RouteDoneEvent(context));
-    } catch (error) {
-      const routeError = error instanceof RouteError ? error : new RouteError(
-        error?.status || error?.code || "UNKNOWN_ERROR",
-        error?.message || "An unexpected error occurred",
-        error
-      );
-      window.dispatchEvent(new RouteErrorEvent(context, routeError));
-      console.error("Routing error:", routeError.original);
-      try {
-        if (this._fallback && this._fallback.render && outlet) {
-          const fallbackContent = await this._fallback.render({ ...context, error: routeError });
-          outlet.render({ id: "#fallback", value: fallbackContent, force: true });
-          document.title = this._fallback.title || document.title;
-        } else {
-          const errorContent = new UErrorPage();
-          errorContent.error = error;
-          if (outlet) {
-            outlet.render({ id: "#error", value: errorContent, force: true });
-          } else {
-            document.body.innerHTML = "";
-            document.body.appendChild(errorContent);
-          }
-        }
-      } catch (pageError) {
-        console.error("Failed to render error component:", pageError);
-        console.error("Original error:", routeError.original || routeError);
-      }
-    }
-  }
+	for (const route of routes) {
+		if (route.index !== true && route.children && route.children.length > 0) {
+			const childRoutes = getRoutes(route.children, pathname);
+			if (childRoutes.length > 0) return [route, ...childRoutes];
+		}
+		if (route.path instanceof URLPattern) {
+			if (route.path.test({ pathname })) return [route];
+		} else throw new Error("Route path must be an instance of URLPattern, Something wrong in setRoutes function.");
+	}
+	return [];
 }
-export {
-  ContentLoadError,
-  ContentRenderError,
-  NotFoundError,
-  OutletMissingError,
-  RouteBeginEvent,
-  RouteDoneEvent,
-  RouteError,
-  RouteErrorEvent,
-  RouteProgressEvent,
-  Router,
-  U as ULink,
-  b as UOutlet
+//#endregion
+//#region src/Router.ts
+/**
+* `lit-element`, `react`를 지원하는 SPA 클라이언트 라우터 객체입니다.
+*/
+var Router = class {
+	constructor(config) {
+		this.handleWindowPopstate = async (_) => {
+			const href = window.location.href;
+			await this.go(href);
+		};
+		this.handleDocumentClick = async (e) => {
+			try {
+				if (e.defaultPrevented) return;
+				if (e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey) return;
+				const anchor = findAnchorFrom(e);
+				if (!anchor) return;
+				const href = anchor.getAttribute("href") || anchor.href;
+				if (!href) return;
+				if (isExternalUrl(href)) return;
+				if (anchor.hasAttribute("download")) return;
+				if (anchor.getAttribute("rel") === "external") return;
+				if (anchor.target && anchor.target !== "") return;
+				e.preventDefault();
+				await this.go(anchor.href);
+			} catch {}
+		};
+		this.destroy();
+		this._rootElement = config.root;
+		this._basepath = absolutePath(config.basepath || "/");
+		this._routes = setRoutes(config.routes || [], this._basepath);
+		this._fallback = config.fallback;
+		window.addEventListener("popstate", this.handleWindowPopstate);
+		if (config.useIntercept !== false) document.addEventListener("click", this.handleDocumentClick);
+		if (config.initialLoad !== false) waitOutlet(this._rootElement).then(() => {
+			this.go(window.location.href);
+		});
+	}
+	/** 객체를 정리하고 이벤트 리스너를 제거합니다. */
+	destroy() {
+		window.removeEventListener("popstate", this.handleWindowPopstate);
+		document.removeEventListener("click", this.handleDocumentClick);
+		this._requestID = void 0;
+		this._context = void 0;
+	}
+	/** 라우터의 기본 경로 반환 */
+	get basepath() {
+		return this._basepath;
+	}
+	/** 등록된 라우트 정보 반환 */
+	get routes() {
+		return this._routes;
+	}
+	/** 현재 라우팅 정보 반환 */
+	get context() {
+		return this._context;
+	}
+	/**
+	* 지정한 경로의 클라이언트 라우팅을 수행합니다. 상대경로일 경우 basepath와 조합되어 이동합니다.
+	* @param href 이동할 경로
+	*/
+	async go(href) {
+		const requestID = getRandomID();
+		this._requestID = requestID;
+		const context = parseUrl(href, this._basepath);
+		if (context.href !== window.location.href) window.history.pushState({ basepath: context.basepath }, "", context.href);
+		else window.history.replaceState({ basepath: context.basepath }, "", context.href);
+		const progressCallback = (value) => {
+			if (this._requestID !== requestID) return;
+			const progress = Math.max(0, Math.min(100, Math.round(value)));
+			window.dispatchEvent(new RouteProgressEvent(context, progress));
+		};
+		context.progress = progressCallback;
+		let outlet = void 0;
+		try {
+			if (this._requestID !== requestID) return;
+			window.dispatchEvent(new RouteBeginEvent(context));
+			const routes = getRoutes(this._routes, context.pathname);
+			const lastRoute = routes[routes.length - 1];
+			if (lastRoute && lastRoute.path instanceof URLPattern) context.params = lastRoute.path.exec({ pathname: context.pathname })?.pathname.groups || {};
+			const mergedMeta = {};
+			for (const route of routes) if (route.meta) Object.assign(mergedMeta, route.meta);
+			context.meta = mergedMeta;
+			this._context = context;
+			outlet = findOutletOrThrow(this._rootElement);
+			let title = void 0;
+			let content = null;
+			if (routes.length === 0) throw new NotFoundError(context.href);
+			for (const route of routes) {
+				if (this._requestID !== requestID) return;
+				if (!route.render) continue;
+				try {
+					content = await route.render(context);
+					if (content === false || content === void 0 || content === null) throw new Error("Failed to load content for the route.");
+				} catch (LoadError) {
+					throw new ContentLoadError(LoadError);
+				}
+				try {
+					outlet.render({
+						id: route.id,
+						value: content,
+						force: route.force
+					});
+				} catch (renderError) {
+					throw new ContentRenderError(renderError);
+				}
+				outlet = findOutlet(outlet) || outlet;
+				title = route.title || title;
+			}
+			document.title = title || document.title;
+			window.dispatchEvent(new RouteDoneEvent(context));
+		} catch (error) {
+			const routeError = error instanceof RouteError ? error : new RouteError(error?.status || error?.code || "UNKNOWN_ERROR", error?.message || "An unexpected error occurred", error);
+			window.dispatchEvent(new RouteErrorEvent(context, routeError));
+			console.error("Routing error:", routeError.original);
+			try {
+				if (this._fallback && this._fallback.render && outlet) {
+					const fallbackContent = await this._fallback.render({
+						...context,
+						error: routeError
+					});
+					outlet.render({
+						id: "#fallback",
+						value: fallbackContent,
+						force: true
+					});
+					document.title = this._fallback.title || document.title;
+				} else {
+					const errorContent = new UErrorPage();
+					errorContent.error = error;
+					if (outlet) outlet.render({
+						id: "#error",
+						value: errorContent,
+						force: true
+					});
+					else {
+						document.body.innerHTML = "";
+						document.body.appendChild(errorContent);
+					}
+				}
+			} catch (pageError) {
+				console.error("Failed to render error component:", pageError);
+				console.error("Original error:", routeError.original || routeError);
+			}
+		}
+	}
 };
+//#endregion
+export { ContentLoadError, ContentRenderError, NotFoundError, OutletMissingError, RouteBeginEvent, RouteDoneEvent, RouteError, RouteErrorEvent, RouteProgressEvent, Router, ULink, UOutlet };