@esmx/router 3.0.0-rc.12 → 3.0.0-rc.120

package/README.md

@@ -0,0 +1,158 @@
+<div align="center">
+  <img src="https://esmx.dev/logo.svg?t=2025" width="120" alt="Esmx Logo" />
+  <h1>@esmx/router</h1>
+  
+  <div>
+    <a href="https://www.npmjs.com/package/@esmx/router">
+      <img src="https://img.shields.io/npm/v/@esmx/router.svg" alt="npm version" />
+    </a>
+    <a href="https://github.com/esmnext/esmx/actions/workflows/build.yml">
+      <img src="https://github.com/esmnext/esmx/actions/workflows/build.yml/badge.svg" alt="Build" />
+    </a>
+    <a href="https://esmx.dev/coverage/">
+      <img src="https://img.shields.io/badge/coverage-live%20report-brightgreen" alt="Coverage Report" />
+    </a>
+    <a href="https://nodejs.org/">
+      <img src="https://img.shields.io/node/v/@esmx/router.svg" alt="node version" />
+    </a>
+    <a href="https://bundlephobia.com/package/@esmx/router">
+      <img src="https://img.shields.io/bundlephobia/minzip/@esmx/router" alt="size" />
+    </a>
+  </div>
+  
+  <p>A universal, framework-agnostic router that works seamlessly with modern frontend frameworks</p>
+  
+  <p>
+    English | <a href="https://github.com/esmnext/esmx/blob/master/packages/router/README.zh-CN.md">中文</a>
+  </p>
+</div>
+
+## 🚀 Features
+
+- **Framework Agnostic** - Works with any frontend framework (Vue, React, Preact, Solid, etc.)
+- **Universal Support** - Runs in both browser and Node.js environments
+- **TypeScript Ready** - Full TypeScript support with excellent type inference
+- **High Performance** - Optimized for production use with minimal bundle size
+- **SSR Compatible** - Complete SSR support
+- **Modern API** - Clean and intuitive API design
+
+## 📦 Installation
+
+```bash
+# npm
+npm install @esmx/router
+
+# pnpm
+pnpm add @esmx/router
+
+# yarn
+yarn add @esmx/router
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { Router, RouterMode } from '@esmx/router';
+
+// Create router instance
+const router = new Router({
+  appId: 'app', // Application mount container ID (optional, defaults to 'app')
+  mode: RouterMode.history,
+  routes: [
+    { path: '/', component: () => 'Home Page' },
+    { path: '/about', component: () => 'About Page' }
+  ]
+});
+
+// Navigate to route
+await router.push('/about');
+```
+
+## 📚 Documentation
+
+Visit the [official documentation](https://esmx.dev) for detailed usage guides and API reference.
+
+### Route Navigation Flow
+
+```mermaid
+flowchart TD
+  start(["Start"]):::Terminal --> normalizeURL["normalizeURL"]
+  normalizeURL --> isExternalUrl{"Internal URL"}:::Decision
+  isExternalUrl -- Yes --> matchInRouteTable["Match in route table"]
+  isExternalUrl -- No --> fallback["fallback"] --> End
+  matchInRouteTable --> isExist{"Match found"}:::Decision
+  isExist -- No --> fallback
+  isExist -- Yes --> execGuard["Execute hooks/guards"] --> End(["End"]):::Terminal
+  classDef Terminal fill:#FFF9C4,color:#000
+  classDef Decision fill:#C8E6C9,color:#000
+```
+
+#### Route Hook Pipeline
+
+|  | fallback | override | beforeLeave | beforeEach | beforeUpdate | beforeEnter | asyncComponent | confirm |
+|---------|----------|----------|-------------|------------|--------------|-------------|----------------|---------|
+| `push` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `replace` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `pushWindow` | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ |
+| `pushLayer` | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ |
+| `replaceWindow` | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ |
+| `restartApp` | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `unknown` | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+```mermaid
+gantt
+  title Route Hook Execution Comparison
+  dateFormat X
+  axisFormat %s
+  section push\nreplace
+    fallback      :0, 1
+    override      :1, 2
+    beforeLeave   :2, 3
+    beforeEach    :3, 4
+    beforeUpdate  :4, 5
+    beforeEnter   :5, 6
+    asyncComponent:6, 7
+    confirm       :7, 8
+  section pushWindow\npushLayer
+    fallback      :0, 1
+    override      :1, 2
+    beforeEach    :3, 4
+    confirm       :7, 8
+  section replaceWindow
+    fallback      :0, 1
+    override      :1, 2
+    beforeLeave   :2, 3
+    beforeEach    :3, 4
+    confirm       :7, 8
+  section restartApp\nunknown
+    fallback      :0, 1
+    beforeLeave   :2, 3
+    beforeEach    :3, 4
+    beforeUpdate  :4, 5
+    beforeEnter   :5, 6
+    asyncComponent:6, 7
+    confirm       :7, 8
+```
+
+#### Hook Functions
+
+- **fallback**: Handle unmatched routes
+- **override**: Allow route override logic
+- **beforeLeave**: Execute before leaving current route
+- **beforeEach**: Global navigation guard
+- **beforeUpdate**: Execute before route update (same component)
+- **beforeEnter**: Execute before entering new route
+- **asyncComponent**: Load async component
+- **confirm**: Final confirmation and navigation execution
+
+#### Navigation Types
+
+- **Standard Navigation** (`push`, `replace`): Execute full hook chain
+- **Window Operations** (`pushWindow`, `replaceWindow`): Simplified hook chain for window-level navigation
+- **Layer Operations** (`pushLayer`): Minimal hook chain for layer navigation
+- **App Restart** (`restartApp`): Full hook chain but skip override
+- **Unknown Type** (`unknown`): Full hook chain but skip override, used as default handling
+
+## 📄 License
+
+MIT © [Esmx Team](https://github.com/esmnext/esmx)

package/README.zh-CN.md

@@ -0,0 +1,158 @@
+<div align="center">
+  <img src="https://esmx.dev/logo.svg?t=2025" width="120" alt="Esmx Logo" />
+  <h1>@esmx/router</h1>
+  
+  <div>
+    <a href="https://www.npmjs.com/package/@esmx/router">
+      <img src="https://img.shields.io/npm/v/@esmx/router.svg" alt="npm version" />
+    </a>
+    <a href="https://github.com/esmnext/esmx/actions/workflows/build.yml">
+      <img src="https://github.com/esmnext/esmx/actions/workflows/build.yml/badge.svg" alt="Build" />
+    </a>
+    <a href="https://esmx.dev/coverage/">
+      <img src="https://img.shields.io/badge/coverage-live%20report-brightgreen" alt="Coverage Report" />
+    </a>
+    <a href="https://nodejs.org/">
+      <img src="https://img.shields.io/node/v/@esmx/router.svg" alt="node version" />
+    </a>
+    <a href="https://bundlephobia.com/package/@esmx/router">
+      <img src="https://img.shields.io/bundlephobia/minzip/@esmx/router" alt="size" />
+    </a>
+  </div>
+  
+  <p>通用的框架无关路由器，与现代前端框架无缝协作</p>
+  
+  <p>
+    <a href="https://github.com/esmnext/esmx/blob/master/packages/router/README.md">English</a> | 中文
+  </p>
+</div>
+
+## 🚀 特性
+
+- **框架无关** - 适用于任何前端框架（Vue、React、Preact、Solid 等）
+- **通用支持** - 在浏览器和 Node.js 环境中运行
+- **TypeScript 支持** - 完整的 TypeScript 类型推断与类型安全
+- **高性能** - 针对生产环境优化，极小的包体积
+- **SSR 兼容** - 完整的 SSR 支持
+- **现代 API** - 简洁直观的 API 设计
+
+## 📦 安装
+
+```bash
+# npm
+npm install @esmx/router
+
+# pnpm
+pnpm add @esmx/router
+
+# yarn
+yarn add @esmx/router
+```
+
+## 🚀 快速开始
+
+```typescript
+import { Router, RouterMode } from '@esmx/router';
+
+// 创建路由器实例
+const router = new Router({
+  appId: 'app', // 应用挂载容器 ID（可选，默认 'app'）
+  mode: RouterMode.history,
+  routes: [
+    { path: '/', component: () => '首页' },
+    { path: '/about', component: () => '关于页面' }
+  ]
+});
+
+// 导航到路由
+await router.push('/about');
+```
+
+## 📚 文档
+
+访问[官方文档](https://esmx.dev)获取详细的使用指南和 API 参考。
+
+### 路由导航时大致的流程说明
+
+```mermaid
+flowchart TD
+  start(["Start"]):::Terminal --> normalizeURL["normalizeURL"]
+  normalizeURL --> isExternalUrl{"是站内地址"}:::Decision
+  isExternalUrl -- Yes --> matchInRouteTable["在路由表内匹配"]
+  isExternalUrl -- No --> fallback["fallback"] --> End
+  matchInRouteTable --> isExist{"存在匹配项"}:::Decision
+  isExist -- No --> fallback
+  isExist -- Yes --> execGuard["执行其他回调钩子/守卫"] --> End(["End"]):::Terminal
+  classDef Terminal fill:#FFF9C4,color:#000
+  classDef Decision fill:#C8E6C9,color:#000
+```
+
+#### 路由钩子管道
+
+|  | fallback | override | beforeLeave | beforeEach | beforeUpdate | beforeEnter | asyncComponent | confirm |
+|---------|----------|----------|-------------|------------|--------------|-------------|----------------|---------|
+| `push` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `replace` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `pushWindow` | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ |
+| `pushLayer` | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ |
+| `replaceWindow` | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ |
+| `restartApp` | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| `unknown` | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+```mermaid
+gantt
+  title 路由钩子执行对比
+  dateFormat X
+  axisFormat %s
+  section push<br>replace
+    fallback      :0, 1
+    override      :1, 2
+    beforeLeave   :2, 3
+    beforeEach    :3, 4
+    beforeUpdate  :4, 5
+    beforeEnter   :5, 6
+    asyncComponent:6, 7
+    confirm       :7, 8
+  section pushWindow<br>pushLayer
+    fallback      :0, 1
+    override      :1, 2
+    beforeEach    :3, 4
+    confirm       :7, 8
+  section replaceWindow
+    fallback      :0, 1
+    override      :1, 2
+    beforeLeave   :2, 3
+    beforeEach    :3, 4
+    confirm       :7, 8
+  section restartApp<br>unknown
+    fallback      :0, 1
+    beforeLeave   :2, 3
+    beforeEach    :3, 4
+    beforeUpdate  :4, 5
+    beforeEnter   :5, 6
+    asyncComponent:6, 7
+    confirm       :7, 8
+```
+
+#### 钩子函数说明
+
+- **fallback**: 处理未匹配的路由
+- **override**: 允许路由重写逻辑
+- **beforeLeave**: 离开当前路由前执行
+- **beforeEach**: 全局导航守卫
+- **beforeUpdate**: 路由更新前执行（相同组件）
+- **beforeEnter**: 进入新路由前执行
+- **asyncComponent**: 加载异步组件
+- **confirm**: 最终确认和导航执行
+
+#### 路由类型特点
+
+- **标准导航** (`push`、`replace`): 执行完整的钩子链
+- **窗口操作** (`pushWindow`、`replaceWindow`): 简化的钩子链，主要用于窗口级别的导航
+- **层级操作** (`pushLayer`): 最简化的钩子链，用于层级导航
+- **应用重启** (`restartApp`): 完整钩子链但跳过 override
+- **未知类型** (`unknown`): 完整钩子链但跳过 override，作为默认处理
+
+## 📄 许可证
+
+MIT © [Esmx Team](https://github.com/esmnext/esmx)

package/dist/error.d.ts

@@ -0,0 +1,23 @@
+import type { Route } from './route';
+export declare class RouteError extends Error {
+    readonly code: string;
+    readonly to: Route;
+    readonly from: Route | null;
+    constructor(message: string, code: string, to: Route, from?: Route | null);
+}
+export declare class RouteTaskCancelledError extends RouteError {
+    readonly taskName: string;
+    constructor(taskName: string, to: Route, from?: Route | null);
+}
+export declare class RouteTaskExecutionError extends RouteError {
+    readonly taskName: string;
+    readonly originalError: Error;
+    constructor(taskName: string, to: Route, from?: Route | null, originalError?: unknown);
+}
+export declare class RouteNavigationAbortedError extends RouteError {
+    readonly taskName: string;
+    constructor(taskName: string, to: Route, from?: Route | null);
+}
+export declare class RouteSelfRedirectionError extends RouteError {
+    constructor(fullPath: string, to: Route, from?: Route | null);
+}

package/dist/error.mjs

@@ -0,0 +1,64 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+export class RouteError extends Error {
+  constructor(message, code, to, from = null) {
+    super(message);
+    __publicField(this, "code");
+    __publicField(this, "to");
+    __publicField(this, "from");
+    this.name = "RouteError";
+    this.code = code;
+    this.to = to;
+    this.from = from;
+  }
+}
+export class RouteTaskCancelledError extends RouteError {
+  constructor(taskName, to, from = null) {
+    super(
+      'Route task "'.concat(taskName, '" was cancelled'),
+      "ROUTE_TASK_CANCELLED",
+      to,
+      from
+    );
+    __publicField(this, "taskName");
+    this.name = "RouteTaskCancelledError";
+    this.taskName = taskName;
+  }
+}
+export class RouteTaskExecutionError extends RouteError {
+  constructor(taskName, to, from = null, originalError) {
+    const error = originalError instanceof Error ? originalError : new Error(String(originalError));
+    const message = 'Route task "'.concat(taskName, '" failed').concat(error.message ? ": ".concat(error.message) : "");
+    super(message, "ROUTE_TASK_EXECUTION_ERROR", to, from);
+    __publicField(this, "taskName");
+    __publicField(this, "originalError");
+    this.name = "RouteTaskExecutionError";
+    this.taskName = taskName;
+    this.originalError = error;
+  }
+}
+export class RouteNavigationAbortedError extends RouteError {
+  constructor(taskName, to, from = null) {
+    super(
+      'Navigation was aborted by task "'.concat(taskName, '"'),
+      "ROUTE_NAVIGATION_ABORTED",
+      to,
+      from
+    );
+    __publicField(this, "taskName");
+    this.name = "RouteNavigationAbortedError";
+    this.taskName = taskName;
+  }
+}
+export class RouteSelfRedirectionError extends RouteError {
+  constructor(fullPath, to, from = null) {
+    super(
+      'Detected a self-redirection to "'.concat(fullPath, '". Aborting navigation.'),
+      "ROUTE_SELF_REDIRECTION",
+      to,
+      from
+    );
+    this.name = "RouteSelfRedirectionError";
+  }
+}

package/dist/increment-id.d.ts

@@ -0,0 +1,7 @@
+export declare class IncrementId {
+    private value;
+    equal(id: number): boolean;
+    next(): number;
+}
+export declare const PAGE_ID: IncrementId;
+export declare const LAYER_ID: IncrementId;

package/dist/increment-id.mjs

@@ -0,0 +1,16 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+export class IncrementId {
+  constructor() {
+    __publicField(this, "value", 0);
+  }
+  equal(id) {
+    return this.value === id;
+  }
+  next() {
+    return ++this.value;
+  }
+}
+export const PAGE_ID = new IncrementId();
+export const LAYER_ID = new IncrementId();

package/dist/index.d.ts

@@ -1,3 +1,14 @@
-export { createRouter } from './router';
-export * from './types';
-export * from './utils';
+export { RouteError, RouteNavigationAbortedError, RouteSelfRedirectionError, RouteTaskCancelledError, RouteTaskExecutionError } from './error';
+export { Route } from './route';
+export { Router } from './router';
+export { type RouteConfig, type RouteConfirmHook, type RouteConfirmHookResult, type RouteHandleHook, type RouteHandleResult, type RouteLayerOptions, type RouteLayerResult, type RouteLocation, type RouteLocationInput, type RouteMatcher, type RouteMatchResult, type RouteMatchType, type RouteMeta, type RouteNotifyHook, type RouteOptions, type RouteParsedConfig, type RouterLayerOptions, type RouterLinkAttributes, type RouterLinkProps, type RouterLinkResolved, type RouterLinkType, type RouterMicroApp, type RouterMicroAppCallback, type RouterMicroAppOptions, RouterMode, type RouterOptions, type RouterParsedOptions, type RouteState, RouteType, type RouteVerifyHook } from './types';
+import type { Router } from './router';
+import type { Route, RouteLocation, RouteLocationInput } from './types';
+/** @deprecated Use `Router` directly instead of `RouterInstance`. */
+export type RouterInstance = Router;
+/** @deprecated Use `RouteLocationInput` directly instead of `RouterRawLocation`. */
+export type RouterRawLocation = RouteLocationInput;
+/** @deprecated Use `RouteLocation` directly instead of `RouterLocation`. */
+export type RouterLocation = RouteLocation;
+/** @deprecated Use `Route` directly instead of `RouteRecord`. */
+export type RouteRecord = Route;

package/dist/index.mjs

@@ -1,3 +1,13 @@
-export { createRouter } from "./router.mjs";
-export * from "./types";
-export * from "./utils/index.mjs";
+export {
+  RouteError,
+  RouteNavigationAbortedError,
+  RouteSelfRedirectionError,
+  RouteTaskCancelledError,
+  RouteTaskExecutionError
+} from "./error.mjs";
+export { Route } from "./route.mjs";
+export { Router } from "./router.mjs";
+export {
+  RouterMode,
+  RouteType
+} from "./types.mjs";

package/dist/location.d.ts

@@ -0,0 +1,22 @@
+import type { RouteLocation, RouteLocationInput } from './types';
+/**
+ * Normalizes a URL input into a URL object.
+ * @param url - The URL or string to normalize.
+ * @param base - The base URL to resolve against if the input is relative.
+ * @returns A URL object.
+ */
+export declare function normalizeURL(url: string | URL, base: URL): URL;
+/**
+ * Parses a RouteLocationInput object into a full URL.
+ * @param toInput - The route location input.
+ * @param baseURL - The base URL to resolve against.
+ * @returns The parsed URL object.
+ */
+export declare function parseLocation(toInput: RouteLocationInput, baseURL: URL): URL;
+/**
+ * Resolves RouteLocationInput with fallback from previous route
+ * @param toInput - The route location input
+ * @param from - The previous route URL (optional)
+ * @returns Resolved RouteLocation object
+ */
+export declare function resolveRouteLocationInput(toInput?: RouteLocationInput, from?: URL | null): RouteLocation;

package/dist/location.mjs

@@ -0,0 +1,64 @@
+import { isNotNullish } from "./util.mjs";
+export function normalizeURL(url, base) {
+  if (url instanceof URL) {
+    return url;
+  }
+  if (url.startsWith("//")) {
+    const protocol = base.protocol;
+    return new URL("".concat(protocol).concat(url));
+  }
+  if (url.startsWith("/")) {
+    const newBase = new URL(".", base);
+    const parsed = new URL(url, newBase);
+    parsed.pathname = newBase.pathname.slice(0, -1) + parsed.pathname;
+    return parsed;
+  }
+  try {
+    return new URL(url);
+  } catch (e) {
+    return new URL(url, base);
+  }
+}
+export function parseLocation(toInput, baseURL) {
+  var _a, _b;
+  if (typeof toInput === "string") {
+    return normalizeURL(toInput, baseURL);
+  }
+  const url = normalizeURL((_b = (_a = toInput.path) != null ? _a : toInput.url) != null ? _b : "", baseURL);
+  const searchParams = url.searchParams;
+  const mergedQuery = {};
+  if (toInput.query) {
+    Object.entries(toInput.query).forEach(([key, value]) => {
+      if (typeof value !== "undefined") {
+        mergedQuery[key] = value;
+      }
+    });
+  }
+  if (toInput.queryArray) {
+    Object.entries(toInput.queryArray).forEach(([key, value]) => {
+      if (typeof value !== "undefined") {
+        mergedQuery[key] = value;
+      }
+    });
+  }
+  Object.entries(mergedQuery).forEach(([key, value]) => {
+    searchParams.delete(key);
+    value = Array.isArray(value) ? value : [value];
+    value.filter((v) => isNotNullish(v) && !Number.isNaN(v)).forEach((v) => {
+      searchParams.append(key, String(v));
+    });
+  });
+  if (toInput.hash) {
+    url.hash = toInput.hash;
+  }
+  return url;
+}
+export function resolveRouteLocationInput(toInput = "/", from = null) {
+  if (typeof toInput === "string") {
+    return { path: toInput };
+  }
+  if (toInput && typeof toInput === "object" && typeof toInput.path !== "string" && typeof toInput.url !== "string" && from !== null) {
+    return { ...toInput, url: from.href };
+  }
+  return toInput;
+}

package/dist/matcher.d.ts

@@ -0,0 +1,4 @@
+import type { RouteConfig, RouteMatcher, RouteParsedConfig } from './types';
+export declare function createMatcher(routes: RouteConfig[], compiledRoutes?: RouteParsedConfig[]): RouteMatcher;
+export declare function createRouteMatches(routes: RouteConfig[], base?: string): RouteParsedConfig[];
+export declare function joinPathname(pathname: string, base?: string): string;

package/dist/matcher.mjs

@@ -0,0 +1,49 @@
+import { compile, match } from "path-to-regexp";
+export function createMatcher(routes, compiledRoutes = createRouteMatches(routes)) {
+  return (toURL, baseURL, cb) => {
+    const matchPath = toURL.pathname.substring(baseURL.pathname.length - 1);
+    const matches = [];
+    const params = {};
+    const collectMatchingRoutes = (routes2) => {
+      for (const item of routes2) {
+        if (cb && !cb(item)) {
+          continue;
+        }
+        if (item.children.length && collectMatchingRoutes(item.children)) {
+          matches.unshift(item);
+          return true;
+        }
+        if (item.requireIndex && item.children.length) continue;
+        const result = item.match(matchPath);
+        if (result) {
+          matches.unshift(item);
+          if (typeof result === "object") {
+            Object.assign(params, result.params);
+          }
+          return true;
+        }
+      }
+      return false;
+    };
+    collectMatchingRoutes(compiledRoutes);
+    return { matches: Object.freeze(matches), params };
+  };
+}
+export function createRouteMatches(routes, base = "") {
+  return routes.map((route) => {
+    var _a;
+    const compilePath = joinPathname(route.path, base);
+    return {
+      ...route,
+      compilePath,
+      match: match(compilePath),
+      compile: compile(compilePath),
+      meta: route.meta || {},
+      requireIndex: (_a = route.requireIndex) != null ? _a : false,
+      children: Array.isArray(route.children) ? createRouteMatches(route.children, compilePath) : []
+    };
+  });
+}
+export function joinPathname(pathname, base = "") {
+  return "/" + "".concat(base, "/").concat(pathname).split("/").filter(Boolean).join("/");
+}

package/dist/micro-app.d.ts

@@ -0,0 +1,20 @@
+import type { Router } from './router';
+import type { RouterMicroAppOptions } from './types';
+/**
+ * Gets the root container element by ID.
+ * If not found, creates a new div with the given ID and appends it to document.body.
+ *
+ * @param appId - The application container ID.
+ * @returns The resolved HTMLElement.
+ */
+export declare function getRootElement(appId: string): HTMLElement;
+export declare class MicroApp {
+    app: RouterMicroAppOptions | null;
+    root: HTMLElement | null;
+    private _factory;
+    private destroyed;
+    _update(router: Router, force?: boolean): void;
+    private _getNextFactory;
+    destroy(): void;
+    private _clearRoot;
+}