@iyulab/router 0.9.3 → 0.10.0

package/dist/types/RouterConfig.d.ts

@@ -0,0 +1,52 @@
+import { FallbackRouteConfig, RouteConfig } from './RouteConfig';
+import { RouteContext } from './RouteContext';
+/**
+ * 라우터 설정
+ */
+export 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;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/router",
-  "version": "0.9.3",
+  "version": "0.10.0",
   "description": "A modern client-side router for web applications with support for Lit and React components",
   "keywords": [
     "lit",
@@ -38,12 +38,13 @@
     }
   },
   "scripts": {
-    "test": "vite",
-    "build": "vite build"
+    "test": "vitest run",
+    "build": "vite build",
+    "test:watch": "vitest"
   },
   "dependencies": {
-    "lit": "^3.3.2",
-    "@lit/react": "^1.0.8"
+    "@lit/react": "^1.0.8",
+    "lit": "^3.3.3"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -58,11 +59,13 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
+    "@types/node": "^25.8.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
+    "happy-dom": "^20.10.2",
     "typescript": "^5.9.3",
-    "vite": "^8.0.8",
-    "vite-plugin-dts": "^4.5.4"
+    "vite": "^8.0.13",
+    "vite-plugin-dts": "^5.0.0",
+    "vitest": "^4.1.8"
   }
 }