imean-service-engine-htmx-plugin 1.2.0 → 2.0.0

package/dist/index.d.ts

@@ -1,175 +1,200 @@
 import { Context } from 'hono';
 import { z } from 'zod';
-import { Plugin, PluginPriority, PluginModuleOptionsSchema, Microservice, ModuleMetadata } from 'imean-service-engine';
+import { Plugin, PluginPriority, Microservice } from 'imean-service-engine';
 import * as hono_jsx_jsx_dev_runtime from 'hono/jsx/jsx-dev-runtime';
 
 /**
- * HtmxAdminPlugin 类型定义
+ * HtmxAdminPlugin 核心类型定义
  */
 
 /**
- * 导航项配置
+ * 操作按钮配置
  */
-interface NavItemConfig {
-    /** 导航标签 */
+interface ActionButton {
+    /** 按钮文本 */
     label: string;
-    /** 导航图标 */
-    icon?: string;
-    /** 自定义路径 */
-    href: string;
-    /** 嵌套子路由 */
-    children?: NavItemConfig[];
-}
-/**
- * 用户信息接口
- */
-interface UserInfo {
-    name?: string;
-    avatar?: string;
-    email?: string;
-    /** 用户权限列表（支持通配符，如 "users.*", "users.read", "deny:users.delete"） */
-    permissions?: string[];
-    [key: string]: any;
-}
-/**
- * 权限校验结果
- */
-interface PermissionResult {
-    /** 是否允许访问 */
-    allowed: boolean;
-    /** 如果拒绝访问，可选的错误消息 */
-    message?: string;
-    /** 如果拒绝访问，可选的重定向URL */
-    redirectUrl?: string;
-    /** 被拒绝的操作ID（用于显示详细信息） */
-    operationId?: string;
-}
-/**
- * 认证提供者接口
- */
-interface AuthProvider {
-    /** Cookie 中存储 token 的 key（默认 "auth_token"） */
-    cookieKey?: string;
-    /** 登录页面 URL（当用户未登录且需要权限时重定向到此页面） */
-    loginUrl?: string;
-    /** 退出登录页面 URL（用于退出登录功能） */
-    logoutUrl?: string;
-    /** 将 token 转换为用户信息 */
-    tokenToUser: (token: string, ctx: Context) => UserInfo | null | Promise<UserInfo | null>;
-    /** 权限校验钩子（可选，如果不提供则使用默认实现） */
-    checkPermission?: (user: UserInfo | null, operation: string, context: any) => PermissionResult | Promise<PermissionResult>;
+    /** 链接地址（页面模式使用） */
+    href?: string;
+    /** HTTP 方法 */
+    method?: "get" | "post" | "put" | "delete";
+    /** 按钮样式 */
+    variant?: "primary" | "secondary" | "danger" | "ghost";
+    /** HTMX GET 请求（弹窗模式使用） */
+    hxGet?: string;
+    /** HTMX POST 请求 */
+    hxPost?: string;
+    /** HTMX PUT 请求 */
+    hxPut?: string;
+    /** HTMX DELETE 请求 */
+    hxDelete?: string;
+    /** 确认提示 */
+    confirm?: string;
+    /** 是否关闭弹窗（设置为 true 时，点击按钮会自动关闭弹窗，无需写 Hyperscript 代码） */
+    close?: boolean;
+    /** 是否提交表单（设置为 true 时，按钮会提交指定的表单，需要配合 formId 使用） */
+    submit?: boolean;
+    /** 表单 ID（当 submit 为 true 时，指定要提交的表单 ID） */
+    formId?: string;
+    /** 自定义点击事件（如关闭弹窗，当 close 为 true 时此属性会被忽略） */
+    onClick?: string;
+    /** 自定义类名 */
+    className?: string;
 }
 /**
- * 操作类型
- */
-type OperationType = "read" | "create" | "edit" | "delete";
-/**
- * 操作信息
+ * 对话框大小类型
  */
-interface OperationInfo {
-    /** 操作ID（格式：moduleName.operation） */
-    operationId: string;
-    /** 模块名 */
-    moduleName: string;
-    /** 操作类型 */
-    operationType: OperationType;
-    /** 模块类型 */
-    moduleType: ModuleType;
-    /** 模块标题 */
-    moduleTitle?: string;
-    /** 模块描述 */
-    moduleDescription?: string;
-    /** HTTP 方法 */
-    httpMethod: string;
-    /** 路由路径 */
-    routePath: string;
-}
+type DialogSize = "sm" | "md" | "lg" | "xl" | "full";
 /**
- * 模块类型信息
+ * 页面元数据配置
  */
-interface ModuleTypeInfo {
-    /** 模块标题 */
+interface PageMetadata {
+    /** 页面标题（必需） */
     title: string;
-    /** 模块描述 */
-    description: string;
-    /** 模块基础路径 */
-    basePath: string;
-    /** 是否有 list 类型的模块 */
-    hasList: boolean;
-    /** 是否有 detail 类型的模块 */
-    hasDetail: boolean;
-    /** 是否有 form 类型的模块 */
-    hasForm: boolean;
-    /** 是否有 custom 类型的模块 */
-    hasCustom: boolean;
+    /** 页面描述（可选） */
+    description?: string;
+    /** 是否使用管理后台布局（默认 true） */
+    useAdminLayout?: boolean;
 }
 /**
- * 面包屑项
+ * 字段元数据
  */
-interface BreadcrumbItem {
-    label: string;
-    href?: string;
+interface FieldMetadata {
+    /** 字段标签（中文名称） */
+    label?: string;
+    /** 字段描述 */
+    description?: string;
+    /** 字段占位符 */
+    placeholder?: string;
+    /** 字段类型（覆盖自动推断） */
+    type?: "text" | "textarea" | "select" | "date" | "number" | "email" | "url";
+    /** 选项（用于 select 类型） */
+    options?: Array<{
+        value: string | number;
+        label: string;
+    }>;
+    /** 是否在列表中显示 */
+    showInList?: boolean;
+    /** 是否在详情中显示 */
+    showInDetail?: boolean;
+    /** 是否在表单中显示 */
+    showInForm?: boolean;
+    /** 是否可搜索 */
+    searchable?: boolean;
+    /** 是否可排序 */
+    sortable?: boolean;
+    /** 自定义渲染函数 */
+    render?: (value: any, item: any) => any;
 }
 /**
- * 站点配置选项
+ * Model Schema 接口
+ * 类型通过 schema 的 z.infer 推断，无需显式传递泛型
  */
-interface HtmxAdminPluginOptions {
-    /** 站点标题 */
-    title?: string;
-    /** 站点 Logo URL（可选） */
-    logo?: string;
-    /** 管理后台路径前缀（默认 /admin） */
-    prefix?: string;
-    /** 首页路径（访问插件默认路径时重定向到此路径，如果未配置则使用第一个模块的路径） */
-    homePath?: string;
-    /** 导航配置（集中式声明导航结构，支持嵌套） */
-    navigation?: NavItemConfig[];
-    /** 认证提供者（用于鉴权和权限控制） */
-    authProvider?: AuthProvider;
+interface ModelSchema {
+    /** Zod Schema（用于数据验证和类型推断） */
+    schema: z.ZodObject<any>;
+    /** 字段元数据（可选，用于自定义字段标签、描述等） */
+    fields?: Record<string, FieldMetadata>;
+    /** 列表显示字段（可选，用于列表页显示哪些字段） */
+    listFields?: string[];
+    /** 详情显示字段（可选，用于详情页显示哪些字段） */
+    detailFields?: string[];
+    /** 表单字段（可选，用于表单页显示哪些字段，默认排除 id、createdAt、updatedAt） */
+    formFields?: string[];
 }
 /**
- * 模块类型
+ * Feature 类型
  */
-type ModuleType = "list" | "detail" | "form" | "custom";
+type FeatureType = "list" | "detail" | "create" | "edit" | "delete" | "custom";
 /**
- * 模块配置选项
- * 通用配置放在这里，不同类型页面的差异配置通过类来实现
+ * 通知类型
  */
-interface HtmxAdminModuleOptions {
-    type: ModuleType;
-    title?: string;
-    description?: string;
-    /** 是否使用管理后台布局（默认 true，设置为 false 时不使用侧边栏和头部，只使用 BaseLayout） */
-    useAdminLayout?: boolean;
-}
+type NotificationType$1 = "error" | "warning" | "info" | "success";
 /**
- * 列表数据源接口（仅用于 list 类型）
+ * 通知接口
  */
-interface ListDatasource<T = any> {
-    /** 获取列表数据 */
-    getList(params: ListParams): Promise<ListResult<T>>;
-    /** 删除数据（可选，如果不提供则列表页不显示删除操作） */
-    deleteItem?(id: string | number): Promise<boolean>;
+interface Notification {
+    type: NotificationType$1;
+    title: string;
+    message: string;
 }
 /**
- * 详情数据源接口（仅用于 detail 类型）
+ * Feature 上下文
+ * 类型通过 model.modelSchema.schema 的 z.infer 推断
  */
-interface DetailDatasource<T = any> {
-    /** 获取单条数据 */
-    getItem(id: string | number): Promise<T | null>;
-    /** 删除数据（可选） */
-    deleteItem?(id: string | number): Promise<boolean>;
+interface FeatureContext {
+    /** PageModel 实例 */
+    model: any;
+    /** Hono Context */
+    ctx: Context;
+    /** 用户信息 */
+    user: UserInfo | null;
+    /** 路由参数（路径参数） */
+    params: Record<string, any>;
+    /** 查询参数 */
+    query: Record<string, any>;
+    /** 请求体数据（表单数据或 JSON） */
+    body: Record<string, any>;
+    /** 插件前缀路径 */
+    prefix?: string;
+    /** 当前数据项（用于 detail、edit） */
+    item?: any;
+    /** 数据列表（用于 list） */
+    items?: any[];
+    /** 通知队列 */
+    notifications: Notification[];
+    /** 发送通知 */
+    sendNotification(type: NotificationType$1, title: string, message: string): void;
+    /** 发送错误通知（便捷方法） */
+    sendError(title: string, message: string): void;
+    /** 发送警告通知（便捷方法） */
+    sendWarning(title: string, message: string): void;
+    /** 发送信息通知（便捷方法） */
+    sendInfo(title: string, message: string): void;
+    /** 发送成功通知（便捷方法） */
+    sendSuccess(title: string, message: string): void;
+    /** 是否是 HTMX 请求 */
+    isHtmxRequest: boolean;
+    /** 是否在对话框中打开 */
+    isDialog: boolean;
+    /** 重定向 URL */
+    redirectUrl?: string;
+    /** 设置重定向 URL */
+    redirect(url: string): void;
+    /** 是否需要刷新页面 */
+    refresh: boolean;
+    /** 设置需要刷新页面 */
+    setRefresh(refresh?: boolean): void;
 }
 /**
- * 表单数据源接口（仅用于 form 类型）
+ * Feature 接口
+ * 类型通过 context.model.modelSchema.schema 的 z.infer 推断
  */
-interface FormDatasource<T = any> {
-    /** 获取单条数据（编辑时使用） */
-    getItem?(id: string | number): Promise<T | null>;
-    /** 更新数据 */
-    updateItem?(id: string | number, data: Partial<T>): Promise<T | null>;
-    /** 创建数据 */
-    createItem?(data: Partial<T>): Promise<T>;
+interface Feature {
+    /** Feature 名称 */
+    name: string;
+    /** Feature 类型 */
+    type: FeatureType;
+    /** 所需权限（格式：modelName.featureName 或自定义，null 表示开放访问） */
+    permission: string | null;
+    /** 弹窗大小（当 Feature 在弹窗中打开时使用，默认 "lg"） */
+    dialogSize?: DialogSize;
+    /** 是否允许点击遮罩区域关闭弹窗（默认 true，设置为 false 时只能通过关闭按钮关闭） */
+    closeOnBackdropClick?: boolean;
+    /** 获取动态标题（可选，会覆盖 PageMetadata 的 title） */
+    getTitle?(context: FeatureContext): string | Promise<string>;
+    /** 获取动态描述（可选，会覆盖 PageMetadata 的 description） */
+    getDescription?(context: FeatureContext): string | Promise<string> | undefined | Promise<string | undefined>;
+    /** 获取操作按钮（可选，根据 isDialog 返回不同的按钮配置） */
+    getActions?(context: FeatureContext): ActionButton[] | Promise<ActionButton[]>;
+    /** 路由配置（必须实现） */
+    getRoutes(): Array<{
+        method: "get" | "post" | "put" | "delete";
+        path: string;
+    }>;
+    /** 处理请求 */
+    handle?(context: FeatureContext): any | Promise<any>;
+    /** 渲染页面 */
+    render?(context: FeatureContext): any | Promise<any>;
 }
 /**
  * 列表查询参数
@@ -201,942 +226,721 @@ interface ListResult<T> {
     /** 总页数 */
     totalPages: number;
 }
-
 /**
- * Action Helper - 简化操作按钮定义
+ * 用户信息接口
  */
+interface UserInfo {
+    name?: string;
+    avatar?: string;
+    email?: string;
+    /** 用户权限列表（支持通配符，如 "users.*", "users.read", "deny:users.delete"） */
+    permissions?: string[];
+    [key: string]: any;
+}
 /**
- * Action Helper 类
- * 提供便捷的方法来定义操作按钮，隐藏路径规则的具体实现
+ * 权限校验结果
  */
-declare class PathHelper {
-    private basePath;
-    constructor(basePath: string);
-    /**
-     * 详情页动作
-     * 生成路径: {basePath}/detail/{id}
-     * @param label 按钮标签
-     * @param dialog 是否在对话框中打开
-     */
-    detail(id: string | number, dialog?: boolean): string;
-    /**
-     * 编辑页动作
-     * 生成路径: {basePath}/edit/{id}
-     * @param dialog 是否在对话框中打开
-     */
-    edit(id: string | number, dialog?: boolean): string;
-    /**
-     * 删除动作
-     * 生成路径: {basePath}/detail/{id}，方法: DELETE
-     */
-    delete(id: string | number): string;
-    /**
-     * 新建页动作
-     * 生成路径: {basePath}/new
-     * @param label 按钮标签
-     * @param dialog 是否在对话框中打开
-     */
-    create(dialog?: boolean): string;
-    /**
-     * 列表页动作
-     * 生成路径: {basePath}/list
-     */
-    list(): string;
-    base(): string;
+interface PermissionResult {
+    /** 是否允许访问 */
+    allowed: boolean;
+    /** 如果拒绝访问，可选的错误消息 */
+    message?: string;
+    /** 如果拒绝访问，可选的重定向URL */
+    redirectUrl?: string;
+    /** 被拒绝的操作ID（用于显示详细信息） */
+    operationId?: string;
 }
-
 /**
- * HtmxAdmin 上下文对象
- * 封装请求处理过程中的状态和操作
+ * 认证提供者接口
  */
-
+interface AuthProvider {
+    /** Cookie 中存储 token 的 key（默认 "auth_token"） */
+    cookieKey?: string;
+    /** 登录页面 URL（当用户未登录且需要权限时重定向到此页面） */
+    loginUrl?: string;
+    /** 退出登录页面 URL（用于退出登录功能） */
+    logoutUrl?: string;
+    /** 将 token 转换为用户信息 */
+    tokenToUser: (token: string, ctx: Context) => UserInfo | null | Promise<UserInfo | null>;
+    /** 权限校验钩子（可选，如果不提供则使用默认实现） */
+    checkPermission?: (user: UserInfo | null, operation: string, context: any) => PermissionResult | Promise<PermissionResult>;
+}
 /**
- * 通知类型
+ * 插件配置选项（用户输入，可选值）
  */
-type NotificationType = "error" | "warning" | "info" | "success";
+interface HtmxAdminPluginOptions {
+    /** 站点标题 */
+    title?: string;
+    /** 站点 Logo URL（可选） */
+    logo?: string;
+    /** 管理后台路径前缀（默认 /admin） */
+    prefix?: string;
+    /** 首页路径（访问插件默认路径时重定向到此路径） */
+    homePath?: string;
+    /** 导航配置（集中式声明导航结构，支持嵌套） */
+    navigation?: NavItemConfig[];
+    /** 认证提供者（用于鉴权和权限控制） */
+    authProvider?: AuthProvider;
+}
 /**
- * 通知项
+ * 导航项配置
  */
-interface Notification {
-    type: NotificationType;
-    title: string;
-    message: string;
+interface NavItemConfig {
+    /** 导航标签 */
+    label: string;
+    /** 导航图标 */
+    icon?: string;
+    /** 自定义路径 */
+    href: string;
+    /** 嵌套子路由 */
+    children?: NavItemConfig[];
 }
 /**
- * HtmxAdmin 上下文
- * 封装请求处理过程中的所有状态和操作
+ * 表单字段定义
  */
-declare class HtmxAdminContext {
-    /** 模块元数据 */
-    readonly moduleMetadata: ModuleTypeInfo;
-    /** 插件选项 */
-    readonly pluginOptions: Required<HtmxAdminPluginOptions>;
-    /** 服务名（用于生成权限ID） */
-    readonly serviceName: string;
-    /** Hono Context */
-    readonly ctx: Context;
-    /** 之前的模块名 */
-    readonly previousModuleName?: string;
-    /** 是否是片段请求（HTMX 请求） */
-    readonly isFragment: boolean;
-    /** 是否是对话框请求 */
-    readonly isDialog: boolean;
-    /** 用户信息 */
-    readonly userInfo: UserInfo | null;
-    /** 通知队列 */
-    readonly notifications: Notification[];
-    /** 页面标题（用于 HX-Title 和页面展示） */
-    title: string;
-    /** 页面描述（用于SEO和页面展示） */
-    description: string;
-    /** 面包屑项 */
-    breadcrumbs: BreadcrumbItem[];
-    /** 主要内容 */
-    content: any;
-    /** 需要重定向的 URL */
-    redirectUrl?: string;
-    /** 是否需要刷新页面（用于 HX-Refresh） */
-    refresh: boolean;
-    constructor(ctx: Context, userInfo: UserInfo | null, moduleMetadata: ModuleTypeInfo, pluginOptions: Required<HtmxAdminPluginOptions>, serviceName?: string);
-    /**
-     * 发送通知
-     * 通知将在响应时通过 OOB 更新到错误容器
-     */
-    sendNotification(type: NotificationType, title: string, message: string): void;
-    /**
-     * 发送错误通知（便捷方法）
-     */
-    sendError(title: string, message: string): void;
-    /**
-     * 发送警告通知（便捷方法）
+interface FormField {
+    name: string;
+    label: string;
+    type?: "text" | "textarea" | "select" | "date" | "number" | "email" | "url" | "checkbox";
+    required?: boolean;
+    placeholder?: string;
+    description?: string;
+    options?: Array<{
+        value: string | number;
+        label: string;
+    }>;
+}
+
+/**
+ * Feature 注册表
+ * 类型通过 model.modelSchema.schema 的 z.infer 推断
+ */
+declare class FeatureRegistry {
+    private features;
+    private model;
+    constructor(model: PageModel);
+    /**
+     * 注册 Feature
+     */
+    register(name: string, feature: Feature): void;
+    /**
+     * 快捷方法：注册列表 Feature
      */
-    sendWarning(title: string, message: string): void;
+    list(feature: Feature): void;
     /**
-     * 发送信息通知（便捷方法）
+     * 快捷方法：注册详情 Feature
      */
-    sendInfo(title: string, message: string): void;
+    detail(feature: Feature): void;
     /**
-     * 发送成功通知（便捷方法）
+     * 快捷方法：注册创建 Feature
      */
-    sendSuccess(title: string, message: string): void;
+    create(feature: Feature): void;
     /**
-     * 设置需要推送的 URL
-     * 用于 HX-Push-Url 响应头
+     * 快捷方法：注册编辑 Feature
      */
-    redirect(url: string): void;
+    edit(feature: Feature): void;
     /**
-     * 设置需要刷新页面
-     * 用于 HX-Refresh 响应头
+     * 快捷方法：注册删除 Feature
      */
-    setRefresh(refresh?: boolean): void;
+    delete(feature: Feature): void;
     /**
-     * 检查是否有列表页面
-     * 封装 moduleMetadata 访问，避免直接访问内部属性
+     * 快捷方法：注册自定义 Feature
      */
-    hasList(): boolean;
+    custom(name: string, feature: Feature): void;
     /**
-     * 检查是否有详情页面
-     * 封装 moduleMetadata 访问，避免直接访问内部属性
+     * 一键启用所有 CRUD Feature
+     * 类型通过 model.modelSchema.schema 的 z.infer 推断
      */
-    hasDetail(): boolean;
+    crud<T extends {
+        id: string | number;
+    } = any>(options: {
+        /** 权限前缀 */
+        permissionPrefix: string;
+        /** 获取列表数据的函数 */
+        getList: (params: ListParams) => Promise<ListResult<T>>;
+        /** 获取单条数据的函数 */
+        getItem: (id: string | number) => Promise<T | null>;
+        /** 创建数据的函数 */
+        createItem: (data: Partial<T>) => Promise<T>;
+        /** 更新数据的函数 */
+        updateItem: (id: string | number, data: Partial<T>) => Promise<T | null>;
+        /** 删除数据的函数（可选） */
+        deleteItem?: (id: string | number) => Promise<boolean>;
+        /** 自定义权限（可选） */
+        permissions?: {
+            list?: string;
+            read?: string;
+            create?: string;
+            edit?: string;
+            delete?: string;
+        };
+        /** 是否启用某些 Feature（可选） */
+        features?: {
+            list?: boolean;
+            detail?: boolean;
+            create?: boolean;
+            edit?: boolean;
+            delete?: boolean;
+        };
+        /** 弹窗大小配置（可选） */
+        dialogSizes?: {
+            list?: DialogSize;
+            detail?: DialogSize;
+            create?: DialogSize;
+            edit?: DialogSize;
+            delete?: DialogSize;
+        };
+        /** 是否允许点击遮罩关闭配置（可选） */
+        closeOnBackdropClick?: {
+            list?: boolean;
+            detail?: boolean;
+            create?: boolean;
+            edit?: boolean;
+            delete?: boolean;
+        };
+        /** 动态标题配置（可选） */
+        getTitles?: {
+            detail?: (item: T, context: FeatureContext) => string | Promise<string>;
+            edit?: (item: T, context: FeatureContext) => string | Promise<string>;
+            create?: (context: FeatureContext) => string | Promise<string>;
+        };
+        /** 动态描述配置（可选） */
+        getDescriptions?: {
+            detail?: (item: T, context: FeatureContext) => string | Promise<string> | undefined;
+            edit?: (item: T, context: FeatureContext) => string | Promise<string> | undefined;
+            create?: (context: FeatureContext) => string | Promise<string> | undefined;
+        };
+    }): void;
     /**
-     * 检查是否有表单页面
-     * 封装 moduleMetadata 访问，避免直接访问内部属性
+     * 获取所有注册的 Feature
      */
-    hasForm(): boolean;
+    getAll(): Feature[];
     /**
-     * 检查是否有自定义页面
-     * 封装 moduleMetadata 访问，避免直接访问内部属性
+     * 获取指定 Feature
      */
-    hasCustom(): boolean;
+    get(name: string): Feature | undefined;
 }
 
 /**
- * Page 模块基类
- * 所有页面模块的基类，提供通用的属性和方法
+ * PageModel 基类
+ * 统一处理有数据模型和无数据模型的场景
  */
 
 /**
- * Page 页面模块基类
- * 所有页面模块都继承此类，包括 ListPageModule、DetailPageModule、FormPageModule
- *
- * 对于 custom 类型的模块，必须实现 render 方法
- * 对于其他类型的模块，可以重写 render 方法来自定义渲染，否则使用默认渲染逻辑
+ * PageModel 基类
+ * 类型通过 modelSchema.schema 的 z.infer 推断，无需显式传递泛型
  */
-declare abstract class PageModule {
-    /** HtmxAdmin 上下文对象 */
-    context: HtmxAdminContext;
-    /** Action Helper 实例 */
-    paths: PathHelper;
-    /**
-     * 初始化模块实例（私有方法，仅由 RouteHandler 调用）
-     * 用于设置模块的基础属性
-     */
-    __init(context: HtmxAdminContext): void;
+declare abstract class PageModel {
+    readonly modelName: string;
+    readonly features: FeatureRegistry;
+    protected modelSchema?: ModelSchema;
+    private metadata;
     /**
-     * 获取页面标题
-     * 子类可以重写此方法来返回页面标题
-     * 默认实现：使用模块名
+     * 构造函数
+     * @param modelName 模型/页面名称（用于路由和权限）
+     * @param schema 模型 Schema（可选，不提供则为普通页面）
+     * @param metadata 页面元数据（可选，如果提供则不需要实现 getMetadata）
      */
-    getTitle(): string;
+    constructor(modelName: string, schema?: ModelSchema, metadata?: PageMetadata);
     /**
-     * 获取页面描述
-     * 子类可以重写此方法来返回页面描述（用于SEO和页面展示）
-     * 默认实现：返回空字符串
+     * 获取推断的类型（如果有 schema）
+     * 使用方式：type ModelType = z.infer<typeof pageModel.getSchema()!.schema>
      */
-    getDescription(): string;
+    getInferredType(): z.ZodObject<any> | undefined;
     /**
-     * 获取面包屑
-     * 子类可以重写此方法来自定义面包屑
-     * 默认实现：首页 => 自定义页面
+     * 获取页面元数据
+     * 如果构造函数提供了 metadata，直接返回
+     * 否则调用子类实现
      */
-    getBreadcrumbs(): BreadcrumbItem[];
+    getMetadata(): PageMetadata;
     /**
-     * 获取所需权限
-     * 子类可以重写此方法来声明页面所需的权限
-     *
-     * 返回值说明：
-     * - 返回空字符串 "" 或 null 或 undefined：表示开放访问（无需权限）
-     * - 返回权限字符串：表示需要该权限，如 "users.read", "users.*"
-     *
-     * 默认实现：返回空字符串（开放访问）
-     *
-     * @param ctx Hono Context（可选，用于根据请求动态决定权限）
-     * @returns 所需权限字符串，或空字符串/null/undefined 表示开放
+     * 判断是否有数据模型（有 Schema）
      */
-    getRequiredPermission?(ctx?: any): string | null | undefined;
+    hasModel(): boolean;
     /**
-     * 处理请求的统一入口（由 RouteHandler 调用）
-     * 默认实现：直接调用 render 方法
-     * 子类可以重写此方法来处理请求级别的逻辑（如根据 HTTP method 分发）
-     *
-     * @param adminContext HtmxAdmin 上下文对象（必需），包含请求状态和 helper 方法
-     * @returns 页面内容
+     * 获取模型 Schema（可选）
      */
-    __handle(): Promise<any>;
+    getSchema?(): ModelSchema | undefined;
     /**
-     * 渲染页面内容
-     *
-     * 所有页面模块都必须提供 render 方法
-     * - Custom 类型：必须实现此方法
-     * - List/Detail/Form 类型：基类提供默认实现，可以重写来自定义渲染
-     *
-     * @param adminContext HtmxAdmin 上下文对象（必需），包含请求状态和 helper 方法
-     *                     可以通过 adminContext.ctx 访问 Hono Context
+     * 验证数据（仅用于有数据模型的场景）
      */
-    abstract render(): any | Promise<any>;
-}
-
-/**
- * Detail 模块基类
- * 用于详情展示，继承自 PageModule
- */
-
-/**
- * Detail 页面模块基类
- * 继承自 PageModule，提供详情页面的默认行为
- *
- * 可以重写 render 方法来自定义渲染，否则使用默认的详情渲染逻辑
- */
-declare abstract class DetailPageModule<T = any> extends PageModule {
-    /** ID 字段名（默认 "id"） */
-    protected readonly idField: string;
+    validate(data: unknown): {
+        success: true;
+        data: any;
+    } | {
+        success: false;
+        error: string;
+    };
     /**
-     * 获取所需权限
-     * 默认实现：返回 "{serviceName}.{moduleName}.read"
-     * 子类可以重写此方法来自定义权限要求
-     *
-     * @param ctx Hono Context（可选）
-     * @returns 所需权限字符串，或空字符串/null/undefined 表示开放
+     * 获取表单字段（仅用于有数据模型的场景）
      */
-    getRequiredPermission(ctx?: any): string | null | undefined;
+    getFormFields(): FormField[];
     /**
-     * 获取数据源（抽象方法，必须实现）
-     * 子类必须实现此方法来提供数据源
+     * 创建表单字段
      */
-    abstract getDatasource(): DetailDatasource<T>;
+    private createFormField;
     /**
-     * 获取字段标签（可选）
-     * 子类可以重写此方法来自定义字段的中文标签
+     * 从 Zod enum schema 中提取选项
      */
-    getFieldLabel?(field: string): string;
+    private extractEnumOptions;
     /**
-     * 渲染字段值（可选）
-     * 子类可以重写此方法来自定义字段的渲染方式
+     * 判断字段是否为必填
      */
-    renderField?(field: string, value: any, item: T): any;
+    private isRequiredField;
     /**
-     * 获取字段分组（可选）
-     * 子类可以重写此方法来定义字段分组
-     * 返回 null 或 undefined 表示不分组，平铺显示
+     * 推断字段类型
      */
-    getFieldGroups?(item: T): Array<{
-        title: string;
-        fields: string[];
-    }> | null;
+    private inferFieldType;
     /**
-     * 获取可见字段列表（可选）
-     * 子类可以重写此方法来控制字段的显示顺序和可见性
-     * 返回 null 或 undefined 表示显示所有字段
+     * 获取列表字段（仅用于有数据模型的场景）
      */
-    getVisibleFields?(item: T): string[] | null;
+    getListFields(): string[];
     /**
-     * 获取详情页操作按钮（可选）
-     * 子类可以重写此方法来添加详情页的操作按钮
-     * 如果不定义，则根据模块元数据智能生成默认操作按钮
+     * 获取详情字段（仅用于有数据模型的场景）
      */
-    getDetailActions?(item: T): Array<{
-        label: string;
-        href: string | ((item: T) => string);
-        method?: string;
-        class?: string;
-    }>;
+    getDetailFields(): string[];
     /**
-     * 渲染详情页面（默认实现）
-     * 子类可以重写此方法来自定义渲染
+     * 获取字段标签
      */
-    render(): Promise<any>;
+    getFieldLabel(fieldName: string): string;
 }
 
 /**
- * Form 模块基类
- * 用于表单（新建/编辑），继承自 PageModule
+ * Feature 基类
+ * 提供所有 Feature 的公共属性和默认实现
  */
 
 /**
- * Form 页面模块基类
- * 继承自 PageModule，提供表单页面的默认行为
- *
- * 可以重写 render 方法来自定义渲染，否则使用默认的表单渲染逻辑
+ * Feature 基类
+ * 所有 Feature 都应该继承此类，而不是直接实现 Feature 接口
  */
-declare abstract class FormPageModule<T = any> extends PageModule {
-    /** ID 字段名（默认 "id"） */
-    protected idField: string;
-    /** Zod Schema（可选，如果提供则自动生成表单字段和校验） */
-    protected schema?: z.ZodObject<any>;
-    constructor(schema?: z.ZodObject<any>);
+declare abstract class BaseFeature implements Feature {
+    /** Feature 名称 */
+    readonly name: string;
+    /** Feature 类型 */
+    readonly type: FeatureType;
+    /** 所需权限（格式：modelName.featureName 或自定义，null 表示开放访问） */
+    permission: string | null;
+    /** 弹窗大小（当 Feature 在弹窗中打开时使用，默认 "lg"） */
+    dialogSize?: DialogSize;
+    /** 是否允许点击遮罩区域关闭弹窗（默认 true，设置为 false 时只能通过关闭按钮关闭） */
+    closeOnBackdropClick?: boolean;
+    constructor(options: {
+        name: string;
+        type: FeatureType;
+        permission: string | null;
+        dialogSize?: DialogSize;
+        closeOnBackdropClick?: boolean;
+    });
+    /**
+     * 获取动态标题（默认实现：返回 PageMetadata 的 title）
+     * 子类可以覆盖此方法以提供动态标题
+     */
+    getTitle(context: FeatureContext): Promise<string>;
+    /**
+     * 获取动态描述（默认实现：返回 PageMetadata 的 description）
+     * 子类可以覆盖此方法以提供动态描述
+     */
+    getDescription(context: FeatureContext): Promise<string | undefined>;
     /**
-     * 获取所需权限
-     * 根据是新建还是编辑返回不同的权限要求
-     * - 新建：{serviceName}.{moduleName}.create
-     * - 编辑：{serviceName}.{moduleName}.edit
-     * 子类可以重写此方法来自定义权限要求
-     *
-     * @param ctx Hono Context（可选）
-     * @returns 所需权限字符串，或空字符串/null/undefined 表示开放
+     * 获取操作按钮（默认实现：返回空数组）
+     * 子类可以覆盖此方法以提供操作按钮
      */
-    getRequiredPermission(ctx?: any): string | null | undefined;
+    getActions(context: FeatureContext): Promise<ActionButton[]>;
     /**
-     * 获取数据源（抽象方法，必须实现）
-     * 子类必须实现此方法来提供数据源
+     * 获取路由配置（必须实现）
      */
-    abstract getDatasource(): FormDatasource<T>;
+    abstract getRoutes(): Array<{
+        method: "get" | "post" | "put" | "delete";
+        path: string;
+    }>;
     /**
-     * 获取单条数据（编辑时使用）
+     * 处理请求（可选，如果实现了 handle，则优先使用 handle）
      */
-    getItem(id: string | number): Promise<T | null>;
+    handle?(context: FeatureContext): Promise<any>;
     /**
-     * 获取字段标签（可选）
-     * 子类可以重写此方法来自定义字段的中文标签
+     * 渲染页面（可选，如果 handle 不存在或返回 undefined，则使用 render）
      */
-    getFieldLabel?(field: string): string;
+    render?(context: FeatureContext): Promise<any>;
+}
+
+/**
+ * 表单 Feature 基类
+ * 提供创建和编辑 Feature 的公共逻辑
+ */
+
+/**
+ * 表单操作类型
+ */
+type FormAction = "create" | "edit";
+/**
+ * 表单 Feature 基类
+ * 用于创建和编辑 Feature 的共同逻辑
+ */
+declare abstract class BaseFormFeature<T extends {
+    id: string | number;
+} = any> extends BaseFeature {
+    protected titleGetter?: (context: FeatureContext, item?: T) => string | Promise<string>;
+    protected descriptionGetter?: (context: FeatureContext, item?: T) => string | Promise<string> | undefined;
+    /** 当前请求的表单 ID（用于在 render 和 getActions 之间共享） */
+    private currentFormId?;
     /**
-     * 获取表单字段定义
-     *
-     * 如果提供了 schema，则自动从 schema 生成字段定义
-     * 否则子类必须实现此方法来定义表单的字段
+     * 获取或生成表单 ID（确保在同一个请求中保持一致）
      */
-    getFormFields(item: T | null): Array<{
+    private getFormId;
+    constructor(options: {
         name: string;
-        label: string;
-        type?: "text" | "email" | "number" | "textarea" | "select" | "date" | "datetime-local";
-        required?: boolean;
-        placeholder?: string;
-        options?: Array<{
-            value: string | number;
-            label: string;
-        }>;
-    }>;
+        type: "create" | "edit";
+        permission: string;
+        dialogSize?: DialogSize;
+        closeOnBackdropClick?: boolean;
+        getTitle?: (context: FeatureContext, item?: T) => string | Promise<string>;
+        getDescription?: (context: FeatureContext, item?: T) => string | Promise<string> | undefined;
+    });
     /**
-     * 获取字段标签映射（可选）
-     * 用于覆盖从 schema description 提取的标签
+     * 获取表单操作类型
      */
-    getFieldLabels?(): Record<string, string>;
+    abstract getFormAction(): FormAction;
     /**
-     * 获取字段占位符映射（可选）
+     * 获取提交 URL
      */
-    getFieldPlaceholders?(): Record<string, string>;
+    abstract getSubmitUrl(context: FeatureContext): string;
     /**
-     * 获取字段选项映射（可选）
-     * 用于覆盖从 schema enum 提取的选项
+     * 获取初始数据（用于编辑时加载现有数据）
      */
-    getFieldOptions?(): Record<string, Array<{
-        value: string | number;
-        label: string;
-    }>>;
+    abstract getInitialData(context: FeatureContext): Promise<Partial<T> | undefined>;
     /**
-     * 获取字段类型映射（可选）
-     * 用于覆盖自动推断的类型
+     * 处理表单提交
      */
-    getFieldTypes?(): Record<string, "text" | "email" | "number" | "textarea" | "select" | "date" | "datetime-local">;
+    abstract handleSubmit(context: FeatureContext, validatedData: Partial<T>): Promise<T | null>;
     /**
-     * 获取要排除的字段列表（可选）
+     * 获取成功后的重定向 URL
      */
-    getExcludeFields?(): string[];
+    abstract getSuccessRedirectUrl(context: FeatureContext, item: T): string;
     /**
-     * 验证表单数据
-     *
-     * 如果提供了 schema，则自动使用 schema 进行校验
-     * 否则子类可以重写此方法来验证表单数据
+     * 获取取消按钮的跳转 URL
      */
-    validateFormData(data: Record<string, any>, item: T | null): string | null;
+    abstract getCancelUrl(context: FeatureContext): string | undefined;
     /**
-     * 处理请求的统一入口（重写基类方法）
-     * 根据 HTTP method 处理不同请求：
-     * - GET: 渲染表单页面（调用 render）
-     * - POST: 创建数据
-     * - PUT: 更新数据
-     * - DELETE: 删除数据
-     * 子类可以重写此方法来自定义请求处理逻辑
+     * 获取动态标题
      */
-    __handle(): Promise<any>;
+    getTitle(context: FeatureContext): Promise<string>;
     /**
-     * 渲染表单页面（默认实现）
-     * 子类可以重写此方法来自定义渲染
-     * @param formData 表单数据（用于回填验证失败时的值）
+     * 获取动态描述
      */
-    render(formData?: Record<string, any>): Promise<any>;
+    getDescription(context: FeatureContext): Promise<string | undefined>;
     /**
-     * 处理创建请求（POST）
+     * 预处理表单数据：根据 schema 类型转换数据
+     * 表单数据都是字符串，需要转换为正确的类型（数字、布尔等）
      */
-    private handleCreate;
+    private preprocessFormData;
     /**
-     * 处理更新请求（PUT）
+     * 处理请求
      */
-    private handleUpdate;
+    handle(context: FeatureContext): Promise<any>;
     /**
-     * 处理删除请求（DELETE）
-     * 注意：FormDatasource 不包含 deleteItem，删除操作通常由 List 或 Detail 模块处理
-     * 这里提供默认实现，子类可以重写
+     * 渲染表单页面
      */
-    private handleDelete;
+    render(context: FeatureContext, initialData?: Partial<T>): Promise<any>;
     /**
-     * 渲染表单页面（辅助方法）
-     * 用于在验证失败时重新渲染表单页面
-     * @param adminContext 上下文对象
-     * @param item 原始数据项（编辑时）
-     * @param isEdit 是否是编辑模式
-     * @param formData 表单数据（用于回填验证失败时的值）
+     * 获取操作按钮
      */
-    private renderFormPage;
+    getActions(context: FeatureContext): Promise<ActionButton[]>;
+}
+
+/**
+ * 自定义 Feature
+ * 用于处理不需要数据模型的业务逻辑
+ */
+
+/**
+ * 自定义 Feature
+ */
+declare class CustomFeature extends BaseFeature {
+    private routes;
+    private handlerFn?;
+    private renderFn?;
+    private titleGetter?;
+    private descriptionGetter?;
+    constructor(options: {
+        name: string;
+        routes: Array<{
+            method: "get" | "post" | "put" | "delete";
+            path: string;
+        }>;
+        handler?: (context: FeatureContext) => any | Promise<any>;
+        render?: (context: FeatureContext) => any | Promise<any>;
+        permission?: string | null;
+        dialogSize?: DialogSize;
+        closeOnBackdropClick?: boolean;
+        /** 获取动态标题（可选，会覆盖 PageMetadata 的 title） */
+        getTitle?: (context: FeatureContext) => string | Promise<string>;
+        /** 获取动态描述（可选，会覆盖 PageMetadata 的 description） */
+        getDescription?: (context: FeatureContext) => string | Promise<string> | undefined | Promise<string | undefined>;
+    });
+    getTitle(context: FeatureContext): Promise<string>;
+    getDescription(context: FeatureContext): Promise<string | undefined>;
+    getRoutes(): {
+        method: "get" | "post" | "put" | "delete";
+        path: string;
+    }[];
+    handle(context: FeatureContext): Promise<any>;
+    render(context: FeatureContext): Promise<any>;
 }
 
 /**
- * List 模块基类
- * 用于列表展示，继承自 PageModule
+ * 默认创建 Feature
  */
 
 /**
- * List 页面模块基类
- * 继承自 PageModule，提供列表页面的默认行为
- *
- * 可以重写 render 方法来自定义渲染，否则使用默认的列表渲染逻辑
+ * 默认创建 Feature
+ * 类型通过 context.model.modelSchema.schema 的 z.infer 推断
  */
-declare abstract class ListPageModule<T extends {
+declare class DefaultCreateFeature<T extends {
     id: string | number;
-} = {
+} = any> extends BaseFormFeature<T> {
+    private createItem;
+    constructor(options: {
+        createItem: (data: Partial<T>) => Promise<T>;
+        permissionPrefix: string;
+        permission?: string;
+        dialogSize?: DialogSize;
+        closeOnBackdropClick?: boolean;
+        /** 获取动态标题（可选，接收 context，返回标题字符串，如 "新建文章"） */
+        getTitle?: (context: FeatureContext) => string | Promise<string>;
+        /** 获取动态描述（可选，接收 context，返回描述字符串） */
+        getDescription?: (context: FeatureContext) => string | Promise<string> | undefined;
+    });
+    getFormAction(): "create";
+    getRoutes(): ({
+        method: "get";
+        path: string;
+    } | {
+        method: "post";
+        path: string;
+    })[];
+    getSubmitUrl(context: FeatureContext): string;
+    getInitialData(context: FeatureContext): Promise<Partial<T> | undefined>;
+    handleSubmit(context: FeatureContext, validatedData: Partial<T>): Promise<T | null>;
+    getSuccessRedirectUrl(context: FeatureContext, item: T): string;
+    getCancelUrl(context: FeatureContext): string | undefined;
+}
+
+/**
+ * 默认删除 Feature
+ */
+
+/**
+ * 默认删除 Feature
+ * 类型通过 context.model.modelSchema.schema 的 z.infer 推断
+ */
+declare class DefaultDeleteFeature<T extends {
     id: string | number;
-}> extends PageModule {
-    /** ID 字段名（默认 "id"） */
-    protected readonly idField: string;
-    /**
-     * 获取所需权限
-     * 默认实现：返回 "{serviceName}.{moduleName}.read"
-     * 子类可以重写此方法来自定义权限要求
-     *
-     * @param ctx Hono Context（可选）
-     * @returns 所需权限字符串，或空字符串/null/undefined 表示开放
-     */
-    getRequiredPermission(ctx?: any): string | null | undefined;
-    /**
-     * 获取数据源（抽象方法，必须实现）
-     * 子类必须实现此方法来提供数据源
-     */
-    abstract getDatasource(): ListDatasource<T>;
-    /**
-     * 获取列表数据
-     */
-    getList(params: ListParams): Promise<ListResult<T>>;
-    /**
-     * 删除数据（可选，如果数据源支持删除）
-     */
-    deleteItem(id: string | number): Promise<boolean>;
-    /**
-     * 获取字段标签（可选）
-     * 子类可以重写此方法来自定义字段的中文标签
-     */
-    getFieldLabel?(field: string): string;
-    /**
-     * 自定义列渲染（可选）
-     * 子类可以重写此方法来自定义列的渲染逻辑
-     */
-    renderColumn?(field: string, value: any, item: T): any;
-    /**
-     * 获取统计信息（可选）
-     * 子类可以重写此方法来返回 KPI 统计卡片数据
-     * 返回的数组将渲染为 StatCard 组件
-     */
-    getStats?(params: ListParams): Promise<Array<{
-        title: string;
-        value: string | number;
-        change?: number;
-        changeLabel?: string;
-        iconColor?: "blue" | "green" | "yellow" | "purple" | "red" | "indigo";
-        icon?: any;
-    }>> | Array<{
-        title: string;
-        value: string | number;
-        change?: number;
-        changeLabel?: string;
-        iconColor?: "blue" | "green" | "yellow" | "purple" | "red" | "indigo";
-        icon?: any;
-    }>;
-    /**
-     * 获取筛选器配置（可选）
-     * 子类可以重写此方法来返回筛选器字段配置
-     * 返回的配置将渲染为 FilterCard 组件
-     */
-    getFilters?(params: ListParams): Array<{
-        name: string;
-        label: string;
-        options: Array<{
-            value: string | number;
-            label: string;
-            disabled?: boolean;
-        }>;
-        value?: string | number;
-        defaultValue?: string | number;
-    }>;
-    /**
-     * 获取表格标题（可选）
-     * 子类可以重写此方法来返回表格标题
-     * 如果不定义，默认使用模块名
-     */
-    getTableTitle?(): string;
-    /**
-     * 获取表格操作按钮（可选）
-     * 子类可以重写此方法来返回表格操作按钮配置（如导出、清空、刷新等）
-     * 如果不定义，默认会生成一个刷新按钮
-     */
-    getTableActions?(params: ListParams, basePath: string): Array<{
-        label: string;
-        href?: string;
-        hxGet?: string;
-        hxPost?: string;
-        hxDelete?: string;
-        variant?: "primary" | "secondary" | "danger" | "ghost";
-        hxConfirm?: string;
-    }>;
-    /**
-     * 自定义操作按钮（可选）
-     * 子类可以重写此方法来添加自定义操作按钮
-     * 如果不定义，则根据模块元数据智能生成默认操作按钮
-     */
-    getActions?(item: T): Array<{
-        label: string;
-        href: string | ((item: T) => string);
-        method?: string;
-        class?: string;
-    }>;
-    /**
-     * 渲染列表页面（默认实现）
-     * 子类可以重写此方法来自定义渲染
-     */
-    render(): Promise<any>;
+} = any> extends BaseFeature {
+    private deleteItem;
+    constructor(options: {
+        deleteItem: (id: string | number) => Promise<boolean>;
+        permissionPrefix: string;
+        permission?: string;
+    });
+    getRoutes(): {
+        method: "delete";
+        path: string;
+    }[];
+    handle(context: FeatureContext): Promise<any>;
 }
 
 /**
- * 数据源接口和基础实现
+ * 默认详情 Feature
  */
 
 /**
- * 内存数据源（完整实现，可用于 list、detail、form 类型）
+ * 默认详情 Feature
+ * 类型通过 context.model.modelSchema.schema 的 z.infer 推断
  */
-declare class MemoryListDatasource<T extends {
+declare class DefaultDetailFeature<T extends {
     id: string | number;
-}> implements ListDatasource<T>, DetailDatasource<T>, FormDatasource<T> {
-    private data;
-    constructor(data?: T[]);
-    getList(params?: ListParams): Promise<ListResult<T>>;
-    getItem(id: string | number): Promise<T | null>;
-    deleteItem(id: string | number): Promise<boolean>;
-    updateItem(id: string | number, data: Partial<T>): Promise<T | null>;
-    createItem(data: Partial<T>): Promise<T>;
-}
-
-/**
- * HtmxAdminPlugin - 管理后台插件
- * 使用 HTMX + Tailwind + Hyperscript + JSX 快速构建管理后台
+} = any> extends BaseFeature {
+    private getItem;
+    private deleteItem?;
+    private titleGetter?;
+    private descriptionGetter?;
+    constructor(options: {
+        getItem: (id: string | number) => Promise<T | null>;
+        deleteItem?: (id: string | number) => Promise<boolean>;
+        permissionPrefix: string;
+        permission?: string;
+        dialogSize?: DialogSize;
+        closeOnBackdropClick?: boolean;
+        /** 获取动态标题（可选，接收 item 和 context，返回标题字符串） */
+        getTitle?: (item: T, context: FeatureContext) => string | Promise<string>;
+        /** 获取动态描述（可选，接收 item 和 context，返回描述字符串） */
+        getDescription?: (item: T, context: FeatureContext) => string | Promise<string> | undefined;
+    });
+    getTitle(context: FeatureContext): Promise<string>;
+    getDescription(context: FeatureContext): Promise<string | undefined>;
+    getRoutes(): {
+        method: "get";
+        path: string;
+    }[];
+    render(context: FeatureContext): Promise<any>;
+    getActions(context: FeatureContext): Promise<ActionButton[]>;
+}
+
+/**
+ * 默认编辑 Feature
+ */
+
+/**
+ * 默认编辑 Feature
+ * 类型通过 context.model.modelSchema.schema 的 z.infer 推断
+ */
+declare class DefaultEditFeature<T extends {
+    id: string | number;
+} = any> extends BaseFormFeature<T> {
+    private getItem;
+    private updateItem;
+    constructor(options: {
+        getItem: (id: string | number) => Promise<T | null>;
+        updateItem: (id: string | number, data: Partial<T>) => Promise<T | null>;
+        permissionPrefix: string;
+        permission?: string;
+        dialogSize?: DialogSize;
+        closeOnBackdropClick?: boolean;
+        /** 获取动态标题（可选，接收 item 和 context，返回标题字符串，如 "编辑 {文章标题}"） */
+        getTitle?: (item: T, context: FeatureContext) => string | Promise<string>;
+        /** 获取动态描述（可选，接收 item 和 context，返回描述字符串） */
+        getDescription?: (item: T, context: FeatureContext) => string | Promise<string> | undefined;
+    });
+    getFormAction(): "edit";
+    getRoutes(): ({
+        method: "get";
+        path: string;
+    } | {
+        method: "put";
+        path: string;
+    })[];
+    getSubmitUrl(context: FeatureContext): string;
+    getInitialData(context: FeatureContext): Promise<Partial<T> | undefined>;
+    handleSubmit(context: FeatureContext, validatedData: Partial<T>): Promise<T | null>;
+    getSuccessRedirectUrl(context: FeatureContext, item: T): string;
+    getCancelUrl(context: FeatureContext): string | undefined;
+    /**
+     * 重写 render 方法以处理 404 情况
+     */
+    render(context: FeatureContext, initialData?: Partial<T>): Promise<any>;
+}
+
+/**
+ * 默认列表 Feature
+ */
+
+/**
+ * 默认列表 Feature
+ * 类型通过 context.model.modelSchema.schema 的 z.infer 推断
+ */
+declare class DefaultListFeature<T extends {
+    id: string | number;
+} = any> extends BaseFeature {
+    private getList;
+    private deleteItem?;
+    constructor(options: {
+        /** 获取列表数据的函数 */
+        getList: (params: ListParams) => Promise<ListResult<T>>;
+        /** 删除数据的函数（可选，不提供则列表不显示删除操作） */
+        deleteItem?: (id: string | number) => Promise<boolean>;
+        /** 权限前缀（格式：modelName，最终权限为 modelName.list） */
+        permissionPrefix: string;
+        /** 自定义权限（可选，覆盖默认的 modelName.list） */
+        permission?: string;
+        /** 弹窗大小（当 Feature 在弹窗中打开时使用） */
+        dialogSize?: DialogSize;
+        /** 是否允许点击遮罩区域关闭弹窗 */
+        closeOnBackdropClick?: boolean;
+    });
+    getRoutes(): {
+        method: "get";
+        path: string;
+    }[];
+    render(context: FeatureContext): Promise<any>;
+    getActions(context: FeatureContext): Promise<ActionButton[]>;
+}
+
+/**
+ * HtmxAdminPlugin - 管理后台插件 v2
+ * 基于 PageModel 和 Feature 的简化设计
  */
 
 /**
  * HtmxAdminPlugin
  */
-declare class HtmxAdminPlugin implements Plugin<HtmxAdminModuleOptions> {
+declare class HtmxAdminPlugin implements Plugin {
     readonly name = "htmx-admin-plugin";
     readonly priority = PluginPriority.ROUTE;
     private engine;
     private hono;
     private options;
     private serviceName;
-    private moduleTypeMap;
-    private registeredOperations;
+    private pages;
     constructor(options?: HtmxAdminPluginOptions);
     /**
-     * 声明Module配置Schema
+     * 注册页面（统一接口，支持有模型和无模型）
      */
-    getModuleOptionsSchema(): PluginModuleOptionsSchema<HtmxAdminModuleOptions>;
+    registerPage(page: PageModel): this;
     /**
-     * 引擎初始化钩子
-     */
-    onInit(engine: Microservice): void;
-    /**
-     * 检查并注册模块
-     */
-    private checkAndRegisterModules;
-    /**
-     * 根据模块类型和路由信息生成操作ID
-     */
-    private generateOperationId;
-    /**
-     * 注册内置路由（权限提示页面）
-     */
-    private registerBuiltinRoutes;
-    /**
-     * 注册路由
+     * 批量注册页面
      */
-    private registerRoutes;
+    registerPages(...pages: PageModel[]): this;
     /**
-     * 获取所有注册的操作（权限）列表
-     * 可用于权限管理模块作为数据源，或用于确定管理员的权限
-     *
-     * @returns 所有注册的操作信息列表
-     */
-    getRegisteredOperations(): OperationInfo[];
-    /**
-     * 获取指定模块的所有操作
-     *
-     * @param moduleName 模块名
-     * @returns 该模块的所有操作信息列表
-     */
-    getModuleOperations(moduleName: string): OperationInfo[];
-    /**
-     * 获取所有唯一的操作ID列表（去重）
-     *
-     * @returns 所有唯一的操作ID列表
+     * 引擎初始化钩子
      */
-    getOperationIds(): string[];
+    onInit(engine: Microservice): void;
     /**
-     * 模块加载钩子：检查模块类型约束并注册路由
+     * 引擎启动后注册路由
      */
-    onModuleLoad(modules: ModuleMetadata[]): void;
+    onAfterStart(engine: Microservice): void;
 }
 
 /**
- * 渲染工具函数
- */
-/**
- * 安全渲染值（支持 JSX 和字符串 HTML）
- * 如果返回的是字符串 HTML，将其转换为 JSX 元素
+ * 认证工具函数
  */
-declare function safeRender(value: any): any;
 
 /**
- * 表单组件（用于编辑和新建）
- */
-/**
- * 字段定义
+ * 从 Context 获取用户信息
  */
-interface FormField$1 {
-    /** 字段名 */
-    name: string;
-    /** 字段标签 */
-    label: string;
-    /** 字段类型 */
-    type?: "text" | "email" | "number" | "textarea" | "select" | "date" | "datetime-local";
-    /** 是否必填 */
-    required?: boolean;
-    /** 占位符 */
-    placeholder?: string;
-    /** 选项（用于 select 类型） */
-    options?: Array<{
-        value: string | number;
-        label: string;
-    }>;
-    /** 自定义渲染函数 */
-    render?: (value: any, item: any) => any;
-}
-/**
- * 表单组件 Props
- */
-interface FormProps<T = any> {
-    /** 数据项（编辑时传入，新建时为 null） */
-    item: T | null;
-    /** 字段定义列表 */
-    fields: FormField$1[];
-    /** 提交 URL */
-    submitUrl: string;
-    /** 提交方法（默认 PUT） */
-    method?: "PUT" | "POST";
-    /** 提交后重定向 URL */
-    redirectUrl?: string;
-    /** 页面标题（默认 "编辑" 或 "新建"） */
-    title?: string;
-    /** 取消按钮 URL */
-    cancelUrl?: string;
-    /** 是否在对话框中显示 */
-    isDialog?: boolean;
-    /** 表单数据（用于回填验证失败时的值） */
-    formData?: Record<string, any>;
-}
-/**
- * 表单组件
- */
-declare const Form: <T extends Record<string, any>>(props: FormProps<T>) => hono_jsx_jsx_dev_runtime.JSX.Element;
+declare function getUserInfo(ctx: Context, authProvider?: AuthProvider): Promise<UserInfo | null>;
 
 /**
- * Zod Schema 表单工具
- * 从 Zod Schema 自动生成表单字段定义和校验逻辑
- */
-
-/**
- * 从 Zod Object Schema 生成表单字段定义
- */
-declare function generateFormFieldsFromSchema<T extends z.ZodObject<any>>(schema: T, options?: {
-    /** 字段标签映射（覆盖从 description 提取的标签） */
-    fieldLabels?: Record<string, string>;
-    /** 字段占位符映射 */
-    fieldPlaceholders?: Record<string, string>;
-    /** 字段选项映射（覆盖从 enum 提取的选项） */
-    fieldOptions?: Record<string, Array<{
-        value: string | number;
-        label: string;
-    }>>;
-    /** 字段类型映射（覆盖自动推断的类型） */
-    fieldTypes?: Record<string, FormField$1["type"]>;
-    /** 要排除的字段 */
-    excludeFields?: string[];
-}): FormField$1[];
-/**
- * 使用 Zod Schema 验证表单数据
- */
-declare function validateFormDataWithSchema<T extends z.ZodObject<any>>(schema: T, data: Record<string, any>): {
-    success: true;
-    data: z.infer<T>;
-} | {
-    success: false;
-    error: string;
-};
-
-/**
- * 操作按钮组件
- */
-interface ActionButtonProps {
-    /** 按钮文本 */
-    label: string;
-    /** 链接地址 */
-    href: string | ((item: any) => string);
-    /** HTTP 方法 */
-    method?: string;
-    /** 自定义类名 */
-    className?: string;
-    /** 数据项（用于生成动态链接） */
-    item?: any;
-}
-/**
- * 操作按钮组件
+ * 参数解析工具函数
  */
-declare const ActionButton: (props: ActionButtonProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
 
 /**
- * 最近活动卡片组件
- */
-interface ActivityItem {
-    /** 活动描述 */
-    description: string;
-    /** 时间（如"2分钟前"） */
-    time: string;
-    /** 活动类型颜色（blue, green, purple, gray等） */
-    color?: "blue" | "green" | "purple" | "gray" | "yellow" | "red";
-}
-interface ActivityCardProps {
-    /** 标题 */
-    title: string;
-    /** 活动列表 */
-    activities: ActivityItem[];
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 最近活动卡片组件
- * 用于展示最近的活动记录列表
+ * 解析列表查询参数
  */
-declare const ActivityCard: (props: ActivityCardProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
+declare function parseListParams(ctx: Context): ListParams;
 
 /**
- * 徽章组件（用于标签显示）
+ * 路径工具函数
  */
-interface BadgeProps {
-    /** 标签文本 */
-    children: any;
-    /** 颜色主题 */
-    variant?: "blue" | "green" | "yellow" | "red" | "gray" | "purple" | "indigo";
-    /** 自定义类名 */
-    className?: string;
-}
 /**
- * 徽章组件
- * 用于显示状态标签，如日志级别、状态等
+ * 将模型名转换为路径
  */
-declare const Badge: (props: BadgeProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
+declare function modelNameToPath(modelName: string): string;
 
 /**
- * 按钮组件
+ * 权限校验工具
+ * 支持灵活的权限系统，包括通配符和禁止权限
  */
-interface ButtonProps {
-    /** 按钮文本 */
-    children: any;
-    /** 按钮类型 */
-    variant?: "primary" | "secondary" | "danger" | "ghost";
-    /** 按钮大小 */
-    size?: "sm" | "md" | "lg";
-    /** 是否禁用 */
-    disabled?: boolean;
-    /** 自定义类名 */
-    className?: string;
-    /** HTMX 属性 */
-    hxGet?: string;
-    hxPost?: string;
-    hxPut?: string;
-    hxDelete?: string;
-    hxTarget?: string;
-    hxSwap?: string;
-    hxPushUrl?: string | boolean;
-    hxIndicator?: string;
-    hxConfirm?: string;
-    hxHeaders?: string;
-    /** 其他属性 */
-    [key: string]: any;
-}
-/**
- * 按钮组件
- */
-declare const Button: (props: ButtonProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 卡片组件
- */
-interface CardProps {
-    /** 卡片内容 */
-    children: any;
-    /** 卡片标题 */
-    title?: string;
-    /** 自定义类名 */
-    className?: string;
-    /** 是否显示阴影 */
-    shadow?: boolean;
-    /** 是否显示边框 */
-    bordered?: boolean;
-    /** 是否去掉内边距 */
-    noPadding?: boolean;
-}
-/**
- * 卡片组件
- */
-declare const Card: (props: CardProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 详情页面组件
- */
-/**
- * 字段组定义
- */
-interface FieldGroup {
-    title: string;
-    fields: string[];
-}
-/**
- * 详情页面组件 Props
- */
-interface DetailProps<T = any> {
-    /** 数据项 */
-    item: T;
-    /** 字段标签映射（字段名 -> 中文标签） */
-    fieldLabels?: Record<string, string>;
-    /** 字段渲染函数（字段名 -> 渲染函数） */
-    fieldRenderers?: Record<string, (value: any, item: T) => any>;
-    /** 字段分组（可选，如果不提供则平铺显示） */
-    fieldGroups?: FieldGroup[];
-    /** 可见字段列表（控制显示顺序和可见性） */
-    visibleFields?: string[];
-    /** 操作按钮 */
-    actions?: Array<{
-        label: string;
-        href: string | ((item: T) => string);
-        method?: string;
-        class?: string;
-    }>;
-    /** 页面标题（默认 "详情"） */
-    title?: string;
-    /** 是否在对话框中显示 */
-    isDialog?: boolean;
-}
-/**
- * 详情页面组件
- */
-declare const Detail: <T extends Record<string, any>>(props: DetailProps<T>) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * DetailContent - 详情内容组件（纯组件）
- * 接收渲染所需的数据，渲染详情页面内容
- */
-/**
- * 详情内容组件 Props
- */
-interface DetailContentProps<T = any> {
-    /** 数据项 */
-    item: T;
-    /** 字段标签映射 */
-    fieldLabels: Record<string, string>;
-    /** 字段渲染器映射 */
-    fieldRenderers?: Record<string, (value: any, item: T) => any>;
-    /** 字段分组 */
-    fieldGroups?: Array<{
-        title: string;
-        fields: string[];
-    }>;
-    /** 可见字段列表 */
-    visibleFields?: string[];
-    /** 操作按钮配置 */
-    actions?: Array<{
-        label: string;
-        href: string | ((item: T) => string);
-        method?: string;
-        class?: string;
-    }>;
-    /** 页面标题 */
-    title: string;
-    /** 是否是对话框模式 */
-    isDialog: boolean;
+interface PermissionCheckResult {
+    allowed: boolean;
+    reason?: string;
+    matchedPermission?: string;
 }
 /**
- * 详情内容组件
+ * 权限校验函数
  */
-declare function DetailContent<T extends Record<string, any> = Record<string, any>>(props: DetailContentProps<T>): hono_jsx_jsx_dev_runtime.JSX.Element;
+declare function checkUserPermission(requiredPermission: string | null, userPermissions: string[]): PermissionCheckResult;
 
-/**
- * 对话框组件（Modal/Dialog）
- */
 interface DialogProps {
     /** 对话框标题 */
     title?: string;
@@ -1144,33 +948,21 @@ interface DialogProps {
     children: any;
     /** 是否显示关闭按钮 */
     showClose?: boolean;
-    /** 关闭时的回调 URL（用于关闭对话框） */
-    closeUrl?: string;
     /** 自定义类名 */
     className?: string;
     /** 对话框大小 */
     size?: "sm" | "md" | "lg" | "xl" | "full";
+    /** 是否允许点击遮罩区域关闭（默认 true，设置为 false 时只能通过关闭按钮关闭） */
+    closeOnBackdropClick?: boolean;
+    /** 操作按钮（在 Footer 中显示，固定在底部） */
+    actions?: ActionButton[];
 }
-/**
- * 对话框组件
- * 用于在模态框中显示内容，支持 HTMX 交互
- */
-declare const Dialog: (props: DialogProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
+declare function Dialog(props: DialogProps): hono_jsx_jsx_dev_runtime.JSX.Element;
 
 /**
- * 空状态组件
+ * 错误提示组件（通知组件）
  */
-interface EmptyStateProps {
-    /** 提示文本 */
-    message?: string;
-    /** 自定义内容 */
-    children?: any;
-}
-/**
- * 空状态组件
- */
-declare const EmptyState: (props: EmptyStateProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
+type NotificationType = "error" | "warning" | "info" | "success";
 interface ErrorAlertProps {
     /** 错误标题 */
     title?: string;
@@ -1182,433 +974,19 @@ interface ErrorAlertProps {
     showClose?: boolean;
     /** 自定义类名 */
     className?: string;
+    /** 自动关闭时间（毫秒），0 表示不自动关闭 */
+    autoClose?: number;
 }
 /**
  * 错误提示组件
  * 用于显示错误、警告或信息提示
  */
-declare const ErrorAlert: (props: ErrorAlertProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 选择框组件
- */
-interface SelectOption {
-    value: string | number;
-    label: string;
-    disabled?: boolean;
-}
-interface SelectProps {
-    /** 字段ID */
-    id?: string;
-    /** 字段名 */
-    name: string;
-    /** 字段值 */
-    value?: string | number;
-    /** 默认值 */
-    defaultValue?: string | number;
-    /** 是否必填 */
-    required?: boolean;
-    /** 是否禁用 */
-    disabled?: boolean;
-    /** 选项列表 */
-    options: SelectOption[];
-    /** 占位符选项（当required为false时显示） */
-    placeholder?: string;
-    /** 自定义类名 */
-    className?: string;
-    /** 其他属性 */
-    [key: string]: any;
-}
-/**
- * 选择框组件
- */
-declare const Select: (props: SelectProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-interface FilterField {
-    /** 字段名 */
-    name: string;
-    /** 字段标签 */
-    label: string;
-    /** 选项列表 */
-    options: SelectOption[];
-    /** 当前值 */
-    value?: string | number;
-    /** 默认值 */
-    defaultValue?: string | number;
-}
-interface FilterCardProps {
-    /** 标题 */
-    title?: string;
-    /** 筛选字段列表 */
-    fields: FilterField[];
-    /** 筛选按钮文本 */
-    filterButtonText?: string;
-    /** 筛选按钮的 HTMX 属性 */
-    filterButtonHxGet?: string;
-    /** 需要保留的查询参数名列表（如排序参数） */
-    preserveParams?: string[];
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 筛选卡片组件
- * 用于展示筛选表单，包含多个下拉选择器和筛选按钮
- */
-declare const FilterCard: (props: FilterCardProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 列表内容组件 Props
- */
-interface ListContentProps<T = any> {
-    /** 列表查询结果 */
-    result: ListResult<T>;
-    /** 列表查询参数 */
-    params: ListParams;
-    /** 页面标题 */
-    pageTitle: string;
-    /** 页面描述 */
-    pageDescription?: string;
-    /** 表格标题 */
-    tableTitle: string;
-    /** 列定义 */
-    columns: Array<{
-        key: string;
-        label: string;
-        render?: (value: any, item: T) => any;
-    }>;
-    /** 操作按钮配置 */
-    actions?: Array<{
-        label: string;
-        href: string | ((item: T) => string);
-        method?: string;
-        class?: string;
-    }>;
-    /** 统计信息（KPI卡片） */
-    stats?: Array<{
-        title: string;
-        value: string | number;
-        change?: number;
-        changeLabel?: string;
-        iconColor?: "blue" | "green" | "yellow" | "purple" | "red" | "indigo";
-        icon?: any;
-    }>;
-    /** 筛选器配置 */
-    filters?: Array<{
-        name: string;
-        label: string;
-        options: Array<{
-            value: string | number;
-            label: string;
-            disabled?: boolean;
-        }>;
-        value?: string | number;
-        defaultValue?: string | number;
-    }>;
-    /** 表格操作按钮 */
-    tableActions?: Array<{
-        label: string;
-        href?: string;
-        hxGet?: string;
-        hxPost?: string;
-        hxDelete?: string;
-        variant?: "primary" | "secondary" | "danger" | "ghost";
-        hxConfirm?: string;
-    }>;
-    /** 是否有 form 模块（用于决定是否显示新建按钮） */
-    hasFormModule: boolean;
-    /** 新建按钮路径 */
-    createPath: string;
-    /** 列表路径（用于分页和筛选） */
-    listPath: string;
-}
-/**
- * 列表内容组件
- */
-declare function ListContent<T extends {
-    id: string | number;
-} = {
-    id: string | number;
-}>(props: ListContentProps<T>): hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 页面标题组件
- */
-interface PageHeaderProps {
-    /** 标题 */
-    title: string;
-    /** 描述文本 */
-    description?: string;
-    /** 右侧操作按钮 */
-    actions?: any;
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 页面标题组件
- */
-declare const PageHeader: (props: PageHeaderProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 分页组件
- */
-interface PaginationProps {
-    /** 当前页码 */
-    page: number;
-    /** 每页数量 */
-    pageSize: number;
-    /** 总记录数 */
-    total: number;
-    /** 总页数 */
-    totalPages: number;
-    /** 基础 URL */
-    baseUrl: string;
-    /** 当前查询参数（用于保留筛选条件等） */
-    currentParams?: Record<string, string | number | undefined>;
-}
-/**
- * 分页组件
- */
-declare const Pagination: (props: PaginationProps) => hono_jsx_jsx_dev_runtime.JSX.Element | null;
-
-/**
- * 统计卡片组件（KPI卡片）
- */
-interface StatCardProps {
-    /** 标题 */
-    title: string;
-    /** 数值 */
-    value: string | number;
-    /** 变化百分比（正数表示增长，负数表示下降） */
-    change?: number;
-    /** 变化描述（如"相比上月"） */
-    changeLabel?: string;
-    /** 图标颜色（blue, green, yellow, purple等） */
-    iconColor?: "blue" | "green" | "yellow" | "purple" | "red" | "indigo";
-    /** 自定义图标（SVG或emoji） */
-    icon?: any;
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 统计卡片组件
- * 用于展示关键指标，包含标题、数值、变化趋势和图标
- */
-declare const StatCard: (props: StatCardProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 系统状态卡片组件
- */
-interface StatusItem {
-    /** 状态名称 */
-    label: string;
-    /** 当前值（百分比或文本） */
-    value: string | number;
-    /** 进度条百分比（0-100） */
-    progress?: number;
-    /** 进度条颜色 */
-    color?: "blue" | "green" | "orange" | "red" | "purple" | "yellow";
-    /** 是否为文本状态（如"正常"） */
-    isText?: boolean;
-}
-interface SystemStatusCardProps {
-    /** 标题 */
-    title: string;
-    /** 状态项列表 */
-    statusItems: StatusItem[];
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 系统状态卡片组件
- * 用于展示系统资源使用情况，包含进度条和文本状态
- */
-declare const SystemStatusCard: (props: SystemStatusCardProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 日期输入组件
- */
-interface DateInputProps {
-    /** 字段ID */
-    id?: string;
-    /** 字段名 */
-    name: string;
-    /** 日期类型 */
-    type?: "date" | "datetime-local" | "time" | "month" | "week";
-    /** 字段值 */
-    value?: string;
-    /** 默认值 */
-    defaultValue?: string;
-    /** 是否必填 */
-    required?: boolean;
-    /** 是否禁用 */
-    disabled?: boolean;
-    /** 是否只读 */
-    readOnly?: boolean;
-    /** 最小值 */
-    min?: string;
-    /** 最大值 */
-    max?: string;
-    /** 自定义类名 */
-    className?: string;
-    /** 其他属性 */
-    [key: string]: any;
-}
-/**
- * 日期输入组件
- */
-declare const DateInput: (props: DateInputProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
+declare function ErrorAlert(props: ErrorAlertProps): hono_jsx_jsx_dev_runtime.JSX.Element;
 
 /**
- * 表单字段组件（标签 + 输入框的包装器）
+ * 加载条组件
+ * 用于显示 HTMX 请求的加载状态
  */
-interface FormFieldProps {
-    /** 字段标签 */
-    label: string;
-    /** 字段ID（用于关联label和input） */
-    id: string;
-    /** 是否必填 */
-    required?: boolean;
-    /** 错误信息 */
-    error?: string;
-    /** 帮助文本 */
-    help?: string;
-    /** 子元素（输入框等） */
-    children: any;
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 表单字段组件
- * 提供统一的标签、错误提示、帮助文本样式
- */
-declare const FormField: (props: FormFieldProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 输入框组件
- */
-interface InputProps {
-    /** 字段ID */
-    id?: string;
-    /** 字段名 */
-    name: string;
-    /** 字段类型 */
-    type?: "text" | "email" | "password" | "number" | "tel" | "url" | "search";
-    /** 字段值 */
-    value?: string | number;
-    /** 默认值 */
-    defaultValue?: string | number;
-    /** 占位符 */
-    placeholder?: string;
-    /** 是否必填 */
-    required?: boolean;
-    /** 是否禁用 */
-    disabled?: boolean;
-    /** 是否只读 */
-    readOnly?: boolean;
-    /** 最小值（用于number类型） */
-    min?: number;
-    /** 最大值（用于number类型） */
-    max?: number;
-    /** 步长（用于number类型） */
-    step?: number;
-    /** 自定义类名 */
-    className?: string;
-    /** 其他属性 */
-    [key: string]: any;
-}
-/**
- * 输入框组件
- */
-declare const Input: (props: InputProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * 文本域组件
- */
-interface TextareaProps {
-    /** 字段ID */
-    id?: string;
-    /** 字段名 */
-    name: string;
-    /** 字段值 */
-    value?: string;
-    /** 默认值 */
-    defaultValue?: string;
-    /** 占位符 */
-    placeholder?: string;
-    /** 是否必填 */
-    required?: boolean;
-    /** 是否禁用 */
-    disabled?: boolean;
-    /** 是否只读 */
-    readOnly?: boolean;
-    /** 行数 */
-    rows?: number;
-    /** 自定义类名 */
-    className?: string;
-    /** 其他属性 */
-    [key: string]: any;
-}
-/**
- * 文本域组件
- */
-declare const Textarea: (props: TextareaProps) => hono_jsx_jsx_dev_runtime.JSX.Element;
-
-/**
- * HtmxAdmin 组件导出
- * 外部可用的组件通过 Components 命名空间导出
- */
-
-declare const index_ActionButton: typeof ActionButton;
-type index_ActionButtonProps = ActionButtonProps;
-declare const index_ActivityCard: typeof ActivityCard;
-type index_ActivityCardProps = ActivityCardProps;
-type index_ActivityItem = ActivityItem;
-declare const index_Badge: typeof Badge;
-type index_BadgeProps = BadgeProps;
-declare const index_Button: typeof Button;
-type index_ButtonProps = ButtonProps;
-declare const index_Card: typeof Card;
-type index_CardProps = CardProps;
-declare const index_DateInput: typeof DateInput;
-type index_DateInputProps = DateInputProps;
-declare const index_Detail: typeof Detail;
-declare const index_DetailContent: typeof DetailContent;
-type index_DetailContentProps<T = any> = DetailContentProps<T>;
-type index_DetailProps<T = any> = DetailProps<T>;
-declare const index_Dialog: typeof Dialog;
-type index_DialogProps = DialogProps;
-declare const index_EmptyState: typeof EmptyState;
-type index_EmptyStateProps = EmptyStateProps;
-declare const index_ErrorAlert: typeof ErrorAlert;
-type index_ErrorAlertProps = ErrorAlertProps;
-type index_FieldGroup = FieldGroup;
-declare const index_FilterCard: typeof FilterCard;
-type index_FilterCardProps = FilterCardProps;
-type index_FilterField = FilterField;
-declare const index_Form: typeof Form;
-declare const index_FormField: typeof FormField;
-type index_FormFieldProps = FormFieldProps;
-type index_FormProps<T = any> = FormProps<T>;
-declare const index_Input: typeof Input;
-type index_InputProps = InputProps;
-declare const index_ListContent: typeof ListContent;
-type index_ListContentProps<T = any> = ListContentProps<T>;
-declare const index_PageHeader: typeof PageHeader;
-type index_PageHeaderProps = PageHeaderProps;
-declare const index_Pagination: typeof Pagination;
-type index_PaginationProps = PaginationProps;
-declare const index_Select: typeof Select;
-type index_SelectOption = SelectOption;
-type index_SelectProps = SelectProps;
-declare const index_StatCard: typeof StatCard;
-type index_StatCardProps = StatCardProps;
-type index_StatusItem = StatusItem;
-declare const index_SystemStatusCard: typeof SystemStatusCard;
-type index_SystemStatusCardProps = SystemStatusCardProps;
-declare const index_Textarea: typeof Textarea;
-type index_TextareaProps = TextareaProps;
-declare namespace index {
-  export { index_ActionButton as ActionButton, type index_ActionButtonProps as ActionButtonProps, index_ActivityCard as ActivityCard, type index_ActivityCardProps as ActivityCardProps, type index_ActivityItem as ActivityItem, index_Badge as Badge, type index_BadgeProps as BadgeProps, index_Button as Button, type index_ButtonProps as ButtonProps, index_Card as Card, type index_CardProps as CardProps, index_DateInput as DateInput, type index_DateInputProps as DateInputProps, index_Detail as Detail, index_DetailContent as DetailContent, type index_DetailContentProps as DetailContentProps, type index_DetailProps as DetailProps, index_Dialog as Dialog, type index_DialogProps as DialogProps, index_EmptyState as EmptyState, type index_EmptyStateProps as EmptyStateProps, index_ErrorAlert as ErrorAlert, type index_ErrorAlertProps as ErrorAlertProps, type index_FieldGroup as FieldGroup, index_FilterCard as FilterCard, type index_FilterCardProps as FilterCardProps, type index_FilterField as FilterField, index_Form as Form, index_FormField as FormField, type index_FormFieldProps as FormFieldProps, type FormField$1 as FormFieldType, type index_FormProps as FormProps, index_Input as Input, type index_InputProps as InputProps, index_ListContent as ListContent, type index_ListContentProps as ListContentProps, index_PageHeader as PageHeader, type index_PageHeaderProps as PageHeaderProps, index_Pagination as Pagination, type index_PaginationProps as PaginationProps, index_Select as Select, type index_SelectOption as SelectOption, type index_SelectProps as SelectProps, index_StatCard as StatCard, type index_StatCardProps as StatCardProps, type index_StatusItem as StatusItem, index_SystemStatusCard as SystemStatusCard, type index_SystemStatusCardProps as SystemStatusCardProps, index_Textarea as Textarea, type index_TextareaProps as TextareaProps };
-}
+declare function LoadingBar(): hono_jsx_jsx_dev_runtime.JSX.Element;
 
-export { type BreadcrumbItem, index as Components, type DetailDatasource, DetailPageModule, type FormDatasource, FormPageModule, HtmxAdminContext, type HtmxAdminModuleOptions, HtmxAdminPlugin, type HtmxAdminPluginOptions, type ListDatasource, ListPageModule, type ListParams, type ListResult, MemoryListDatasource, type ModuleType, PageModule, PathHelper, type UserInfo, generateFormFieldsFromSchema, safeRender, validateFormDataWithSchema };
+export { type AuthProvider, BaseFeature, CustomFeature, DefaultCreateFeature, DefaultDeleteFeature, DefaultDetailFeature, DefaultEditFeature, DefaultListFeature, Dialog, type DialogProps, type DialogSize, ErrorAlert, type ErrorAlertProps, type Feature, type FeatureContext, type FeatureType, type FieldMetadata, HtmxAdminPlugin, type HtmxAdminPluginOptions, type ListParams, type ListResult, LoadingBar, type ModelSchema, type NavItemConfig, type Notification, type NotificationType$1 as NotificationType, type PageMetadata, PageModel, type PermissionResult, type UserInfo, checkUserPermission, getUserInfo, modelNameToPath, parseListParams };