imean-service-engine-htmx-plugin 1.0.0

package/dist/index.mjs

@@ -0,0 +1,3087 @@
+import { jsx, jsxs, Fragment } from 'hono/jsx/jsx-runtime';
+import { PluginPriority, logger } from 'imean-service-engine';
+
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+function safeRender(value) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (typeof value === "object" && value !== null && "type" in value) {
+    return value;
+  }
+  if (typeof value === "string") {
+    if (/<[^>]+>/.test(value)) {
+      return /* @__PURE__ */ jsx("span", { dangerouslySetInnerHTML: { __html: value } });
+    }
+    return value;
+  }
+  return value;
+}
+var Button = (props) => {
+  const {
+    children,
+    variant = "primary",
+    size = "md",
+    disabled = false,
+    className = "",
+    hxGet,
+    hxPost,
+    hxPut,
+    hxDelete,
+    hxTarget,
+    hxSwap,
+    hxPushUrl,
+    hxIndicator,
+    hxConfirm,
+    hxHeaders,
+    ...rest
+  } = props;
+  const baseClasses = "inline-flex items-center justify-center font-medium rounded-lg transition-colors focus:outline-none focus:ring-2 focus:ring-offset-2";
+  const variantClasses = {
+    primary: "bg-blue-600 text-white hover:bg-blue-700 focus:ring-blue-500",
+    secondary: "bg-gray-200 text-gray-800 hover:bg-gray-300 focus:ring-gray-500",
+    danger: "bg-red-600 text-white hover:bg-red-700 focus:ring-red-500",
+    ghost: "bg-transparent text-gray-700 hover:bg-gray-100 focus:ring-gray-500"
+  };
+  const sizeClasses = {
+    sm: "px-3 py-1.5 text-sm",
+    md: "px-4 py-2 text-sm",
+    lg: "px-6 py-3 text-base"
+  };
+  const classes = `${baseClasses} ${variantClasses[variant]} ${sizeClasses[size]} ${disabled ? "opacity-50 cursor-not-allowed" : ""} ${className}`;
+  const htmxAttrs = {};
+  if (hxGet) htmxAttrs["hx-get"] = hxGet;
+  if (hxPost) htmxAttrs["hx-post"] = hxPost;
+  if (hxPut) htmxAttrs["hx-put"] = hxPut;
+  if (hxDelete) htmxAttrs["hx-delete"] = hxDelete;
+  if (hxTarget) htmxAttrs["hx-target"] = hxTarget;
+  if (hxSwap) htmxAttrs["hx-swap"] = hxSwap;
+  if (hxPushUrl !== void 0)
+    htmxAttrs["hx-push-url"] = hxPushUrl === true ? "true" : hxPushUrl;
+  if (hxIndicator) htmxAttrs["hx-indicator"] = hxIndicator;
+  if (hxConfirm) htmxAttrs["hx-confirm"] = hxConfirm;
+  if (hxHeaders) htmxAttrs["hx-headers"] = hxHeaders;
+  const Tag = hxGet || hxPost || hxPut || hxDelete ? "a" : "button";
+  const href = rest.href ?? hxGet ?? "#";
+  return /* @__PURE__ */ jsx(
+    Tag,
+    {
+      className: classes,
+      disabled,
+      href,
+      ...htmxAttrs,
+      ...rest,
+      children
+    }
+  );
+};
+var Card = (props) => {
+  const {
+    children,
+    title,
+    className = "",
+    shadow = true,
+    bordered = false,
+    noPadding = false
+  } = props;
+  const baseClasses = "bg-white rounded-lg";
+  const shadowClass = shadow ? "shadow-sm hover:shadow-md transition-shadow" : "";
+  const borderClass = bordered ? "border border-gray-200" : "";
+  const paddingClass = noPadding ? "" : "p-6";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: `${baseClasses} ${shadowClass} ${borderClass} ${className}`,
+      children: [
+        title && /* @__PURE__ */ jsx("div", { className: "px-6 py-4 border-b border-gray-200", children: /* @__PURE__ */ jsx("h3", { className: "text-lg font-semibold text-gray-900", children: title }) }),
+        /* @__PURE__ */ jsx("div", { className: noPadding ? "" : paddingClass, children })
+      ]
+    }
+  );
+};
+var PageHeader = (props) => {
+  const { title, description, actions, className = "" } = props;
+  return /* @__PURE__ */ jsx("div", { className: `mb-6 ${className}`, children: /* @__PURE__ */ jsxs("div", { className: "flex justify-between items-start", children: [
+    /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx("h1", { className: "text-3xl font-bold text-gray-900 mb-2", children: title }),
+      description && /* @__PURE__ */ jsx("p", { className: "text-gray-600", children: description })
+    ] }),
+    actions && /* @__PURE__ */ jsx("div", { className: "flex gap-2", children: actions })
+  ] }) });
+};
+var Detail = (props) => {
+  const {
+    item,
+    fieldLabels = {},
+    fieldRenderers = {},
+    fieldGroups,
+    visibleFields,
+    actions,
+    title = "\u8BE6\u60C5",
+    isDialog = false
+  } = props;
+  const getFieldLabel = (field) => {
+    return fieldLabels[field] || field;
+  };
+  const renderFieldValue = (field, value) => {
+    if (fieldRenderers[field]) {
+      return safeRender(fieldRenderers[field](value, item));
+    }
+    if (value === null || value === void 0) {
+      return /* @__PURE__ */ jsx("span", { className: "text-gray-400", children: "-" });
+    }
+    if (typeof value === "boolean") {
+      return value ? "\u662F" : "\u5426";
+    }
+    if (typeof value === "object") {
+      return /* @__PURE__ */ jsx("pre", { className: "text-sm", children: JSON.stringify(value, null, 2) });
+    }
+    return String(value);
+  };
+  const getAllFields = () => {
+    if (visibleFields) {
+      return visibleFields;
+    }
+    return Object.keys(item);
+  };
+  const renderField = (field) => {
+    const value = item[field];
+    return /* @__PURE__ */ jsxs("div", { className: "py-4", children: [
+      /* @__PURE__ */ jsx("div", { className: "text-xs font-semibold text-gray-500 uppercase tracking-wider mb-2", children: getFieldLabel(field) }),
+      /* @__PURE__ */ jsx("div", { className: "text-sm text-gray-900", children: renderFieldValue(field, value) })
+    ] });
+  };
+  const renderFieldGroup = (group) => {
+    const fields2 = group.fields.filter((field) => item.hasOwnProperty(field));
+    if (fields2.length === 0) {
+      return null;
+    }
+    return /* @__PURE__ */ jsx(Card, { title: group.title, children: /* @__PURE__ */ jsx("div", { className: "divide-y divide-gray-200", children: fields2.map(renderField) }) });
+  };
+  const fields = getAllFields();
+  const actionButtons = actions && actions.length > 0 ? /* @__PURE__ */ jsx("div", { className: "flex gap-2", children: actions.map((action, index) => {
+    const href = typeof action.href === "string" ? action.href : action.href(item);
+    const isDelete = action.method === "delete";
+    const target = isDialog ? "#dialog-container" : "#main-content";
+    return /* @__PURE__ */ jsx(
+      Button,
+      {
+        variant: isDelete ? "danger" : "primary",
+        href,
+        hxGet: !isDelete ? href : void 0,
+        hxDelete: isDelete ? href : void 0,
+        hxConfirm: isDelete ? "\u786E\u5B9A\u8981\u5220\u9664\u5417\uFF1F" : void 0,
+        hxHeaders: isDelete ? JSON.stringify({ "HX-Target": target }) : void 0,
+        children: action.label
+      },
+      index
+    );
+  }) }) : null;
+  const content = /* @__PURE__ */ jsxs(Fragment, { children: [
+    !isDialog && /* @__PURE__ */ jsx(PageHeader, { title, actions: actionButtons }),
+    isDialog && actionButtons && /* @__PURE__ */ jsx("div", { className: "mb-4 flex justify-end", children: actionButtons }),
+    fieldGroups && fieldGroups.length > 0 ? (
+      // 分组显示
+      /* @__PURE__ */ jsx("div", { className: "space-y-6", children: fieldGroups.map(renderFieldGroup) })
+    ) : (
+      // 平铺显示
+      /* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsx("div", { className: "divide-y divide-gray-200", children: fields.map(renderField) }) })
+    )
+  ] });
+  return /* @__PURE__ */ jsx("div", { children: content });
+};
+function DetailContent(props) {
+  const {
+    item,
+    fieldLabels,
+    fieldRenderers,
+    fieldGroups,
+    visibleFields,
+    actions,
+    title,
+    isDialog
+  } = props;
+  const detailActions = actions && actions.length > 0 ? actions.map((action) => ({
+    label: action.label,
+    href: typeof action.href === "string" ? action.href : ((item2) => action.href(item2)),
+    method: action.method,
+    class: action.class
+  })) : void 0;
+  const convertedFieldRenderers = fieldRenderers ? Object.keys(fieldRenderers).reduce((acc, key) => {
+    acc[key] = (value, item2) => fieldRenderers[key](value, item2);
+    return acc;
+  }, {}) : void 0;
+  return /* @__PURE__ */ jsx(
+    Detail,
+    {
+      item,
+      fieldLabels,
+      fieldRenderers: convertedFieldRenderers,
+      fieldGroups,
+      visibleFields,
+      actions: detailActions,
+      title,
+      isDialog
+    }
+  );
+}
+
+// src/utils/path.ts
+var PathHelper = class {
+  basePath;
+  constructor(basePath) {
+    this.basePath = basePath;
+  }
+  /**
+   * 详情页动作
+   * 生成路径: {basePath}/detail/{id}
+   * @param label 按钮标签
+   * @param dialog 是否在对话框中打开
+   */
+  detail(id, dialog = false) {
+    const url = `${this.basePath}/detail/${id}`;
+    return dialog ? `${url}?dialog=true` : url;
+  }
+  /**
+   * 编辑页动作
+   * 生成路径: {basePath}/edit/{id}
+   * @param dialog 是否在对话框中打开
+   */
+  edit(id, dialog = false) {
+    const url = `${this.basePath}/edit/${id}`;
+    return dialog ? `${url}?dialog=true` : url;
+  }
+  /**
+   * 删除动作
+   * 生成路径: {basePath}/detail/{id}，方法: DELETE
+   */
+  delete(id) {
+    return `${this.basePath}/detail/${id}`;
+  }
+  /**
+   * 新建页动作
+   * 生成路径: {basePath}/new
+   * @param label 按钮标签
+   * @param dialog 是否在对话框中打开
+   */
+  create(dialog = false) {
+    const url = dialog ? `${this.basePath}/new?dialog=true` : `${this.basePath}/new`;
+    return url;
+  }
+  /**
+   * 列表页动作
+   * 生成路径: {basePath}/list
+   */
+  list() {
+    return `${this.basePath}/list`;
+  }
+  base() {
+    return this.basePath;
+  }
+};
+function moduleNameToPath(moduleName) {
+  if (moduleName === moduleName.toLowerCase() && !/[A-Z]/.test(moduleName)) {
+    return `/${moduleName}`;
+  }
+  const path = moduleName.replace(/([A-Z])/g, "-$1").toLowerCase().replace(/^-/, "");
+  return `/${path}`;
+}
+
+// src/base/base-page.ts
+var PageModule = class {
+  /** HtmxAdmin 上下文对象 */
+  context;
+  /** Action Helper 实例 */
+  paths;
+  /**
+   * 初始化模块实例（私有方法，仅由 RouteHandler 调用）
+   * 用于设置模块的基础属性
+   */
+  __init(context) {
+    this.context = context;
+    this.paths = new PathHelper(this.context.moduleMetadata.basePath);
+  }
+  /**
+   * 获取页面标题
+   * 子类可以重写此方法来返回页面标题
+   * 默认实现：使用模块名
+   */
+  getTitle() {
+    return this.context.moduleMetadata.title;
+  }
+  /**
+   * 获取页面描述
+   * 子类可以重写此方法来返回页面描述（用于SEO和页面展示）
+   * 默认实现：返回空字符串
+   */
+  getDescription() {
+    return this.context.moduleMetadata.description;
+  }
+  /**
+   * 获取面包屑
+   * 子类可以重写此方法来自定义面包屑
+   * 默认实现：首页 => 自定义页面
+   */
+  getBreadcrumbs() {
+    const breadcrumbs = [
+      { label: "\u9996\u9875", href: this.context.pluginOptions.prefix },
+      { label: this.context.moduleMetadata.title }
+    ];
+    return breadcrumbs;
+  }
+  /**
+   * 处理请求的统一入口（由 RouteHandler 调用）
+   * 默认实现：直接调用 render 方法
+   * 子类可以重写此方法来处理请求级别的逻辑（如根据 HTTP method 分发）
+   *
+   * @param adminContext HtmxAdmin 上下文对象（必需），包含请求状态和 helper 方法
+   * @returns 页面内容
+   */
+  async __handle() {
+    return await this.render();
+  }
+};
+var DetailPageModule = class extends PageModule {
+  /** ID 字段名（默认 "id"） */
+  idField = "id";
+  /**
+   * 获取字段标签（可选）
+   * 子类可以重写此方法来自定义字段的中文标签
+   */
+  getFieldLabel(field) {
+    return field;
+  }
+  /**
+   * 渲染字段值（可选）
+   * 子类可以重写此方法来自定义字段的渲染方式
+   */
+  renderField(field, value, item) {
+    return value;
+  }
+  /**
+   * 获取字段分组（可选）
+   * 子类可以重写此方法来定义字段分组
+   * 返回 null 或 undefined 表示不分组，平铺显示
+   */
+  getFieldGroups(item) {
+    return null;
+  }
+  /**
+   * 获取可见字段列表（可选）
+   * 子类可以重写此方法来控制字段的显示顺序和可见性
+   * 返回 null 或 undefined 表示显示所有字段
+   */
+  getVisibleFields(item) {
+    return null;
+  }
+  /**
+   * 获取详情页操作按钮（可选）
+   * 子类可以重写此方法来添加详情页的操作按钮
+   * 如果不定义，则根据模块元数据智能生成默认操作按钮
+   */
+  getDetailActions(item) {
+    const id = item[this.idField];
+    const actions = [];
+    if (this.context.moduleMetadata.hasList) {
+      actions.push({
+        label: "\u8FD4\u56DE\u5217\u8868",
+        href: this.paths.list()
+      });
+    }
+    if (this.context.moduleMetadata.hasForm) {
+      actions.push({
+        label: "\u7F16\u8F91",
+        href: this.paths.edit(id)
+      });
+    }
+    if (this.getDatasource().deleteItem) {
+      actions.push({
+        label: "\u5220\u9664",
+        href: this.paths.delete(id)
+      });
+    }
+    return actions;
+  }
+  /**
+   * 渲染详情页面（默认实现）
+   * 子类可以重写此方法来自定义渲染
+   */
+  async render() {
+    const idParam = this.context.ctx.req.param("id");
+    if (!idParam) {
+      throw new Error("Detail page requires id parameter");
+    }
+    let item = await this.getDatasource().getItem(idParam);
+    if (!item && !isNaN(Number(idParam))) {
+      item = await this.getDatasource().getItem(Number(idParam));
+    }
+    if (!item) {
+      return /* @__PURE__ */ jsx("div", { className: "text-center py-12", children: /* @__PURE__ */ jsx("p", { className: "text-gray-500", children: "\u672A\u627E\u5230\u6570\u636E" }) });
+    }
+    const allFields = Object.keys(item);
+    const fieldLabels = {};
+    for (const field of allFields) {
+      fieldLabels[field] = this.getFieldLabel ? this.getFieldLabel(field) : field;
+    }
+    const fieldRenderers = {};
+    if (this.renderField) {
+      for (const field of allFields) {
+        fieldRenderers[field] = (value, item2) => this.renderField(field, value, item2);
+      }
+    }
+    const fieldGroups = this.getFieldGroups ? this.getFieldGroups(item) : void 0;
+    const visibleFields = this.getVisibleFields ? this.getVisibleFields(item) : void 0;
+    const actions = this.getDetailActions ? this.getDetailActions(item) : [];
+    return /* @__PURE__ */ jsx(
+      DetailContent,
+      {
+        item,
+        fieldLabels,
+        fieldRenderers: Object.keys(fieldRenderers).length > 0 ? fieldRenderers : void 0,
+        fieldGroups: fieldGroups || void 0,
+        visibleFields: visibleFields || void 0,
+        actions,
+        title: this.context.moduleMetadata.title,
+        isDialog: this.context.isDialog
+      }
+    );
+  }
+};
+var DateInput = (props) => {
+  const {
+    id,
+    name,
+    type = "date",
+    value,
+    defaultValue,
+    required,
+    disabled,
+    readOnly,
+    min,
+    max,
+    className = "",
+    ...rest
+  } = props;
+  const baseClasses = "block w-full px-4 py-2.5 text-sm text-gray-900 bg-white border border-gray-300 rounded-lg shadow-sm transition-all duration-200";
+  const focusClasses = "focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500";
+  const disabledClasses = disabled ? "bg-gray-50 text-gray-500 cursor-not-allowed" : "";
+  const readOnlyClasses = readOnly ? "bg-gray-50 text-gray-700 cursor-default" : "";
+  const errorClasses = rest["data-error"] ? "border-red-300 focus:border-red-500 focus:ring-red-500" : "";
+  const classes = `${baseClasses} ${focusClasses} ${disabledClasses} ${readOnlyClasses} ${errorClasses} ${className}`.trim();
+  return /* @__PURE__ */ jsx(
+    "input",
+    {
+      type,
+      id,
+      name,
+      value,
+      defaultValue,
+      required,
+      disabled,
+      readOnly,
+      min,
+      max,
+      className: classes,
+      ...rest
+    }
+  );
+};
+var FormField = (props) => {
+  const { label, id, required, error, help, children, className = "" } = props;
+  return /* @__PURE__ */ jsxs("div", { className, children: [
+    /* @__PURE__ */ jsxs(
+      "label",
+      {
+        htmlFor: id,
+        className: "block text-sm font-semibold text-gray-700 mb-2",
+        children: [
+          label,
+          required && /* @__PURE__ */ jsx("span", { className: "text-red-500 ml-1", children: "*" })
+        ]
+      }
+    ),
+    children,
+    error && /* @__PURE__ */ jsx("p", { className: "mt-1 text-sm text-red-600", children: error }),
+    help && !error && /* @__PURE__ */ jsx("p", { className: "mt-1 text-sm text-gray-500", children: help })
+  ] });
+};
+var Input = (props) => {
+  const {
+    id,
+    name,
+    type = "text",
+    value,
+    defaultValue,
+    placeholder,
+    required,
+    disabled,
+    readOnly,
+    min,
+    max,
+    step,
+    className = "",
+    ...rest
+  } = props;
+  const baseClasses = "block w-full px-4 py-2.5 text-sm text-gray-900 bg-white border border-gray-300 rounded-lg shadow-sm transition-all duration-200";
+  const focusClasses = "focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500";
+  const disabledClasses = disabled ? "bg-gray-50 text-gray-500 cursor-not-allowed" : "";
+  const readOnlyClasses = readOnly ? "bg-gray-50 text-gray-700 cursor-default" : "";
+  const errorClasses = rest["data-error"] ? "border-red-300 focus:border-red-500 focus:ring-red-500" : "";
+  const classes = `${baseClasses} ${focusClasses} ${disabledClasses} ${readOnlyClasses} ${errorClasses} ${className}`.trim();
+  return /* @__PURE__ */ jsx(
+    "input",
+    {
+      type,
+      id,
+      name,
+      value,
+      defaultValue,
+      placeholder,
+      required,
+      disabled,
+      readOnly,
+      min,
+      max,
+      step,
+      className: classes,
+      ...rest
+    }
+  );
+};
+var Select = (props) => {
+  const {
+    id,
+    name,
+    value,
+    defaultValue,
+    required,
+    disabled,
+    options,
+    placeholder = "\u8BF7\u9009\u62E9",
+    className = "",
+    ...rest
+  } = props;
+  const baseClasses = "block w-full px-4 py-2.5 text-sm text-gray-900 bg-white border border-gray-300 rounded-lg shadow-sm transition-all duration-200 appearance-none bg-[url('data:image/svg+xml;charset=utf-8,%3Csvg xmlns=\\'http://www.w3.org/2000/svg\\' fill=\\'none\\' viewBox=\\'0 0 20 20\\'%3E%3Cpath stroke=\\'%236b7280\\' stroke-linecap=\\'round\\' stroke-linejoin=\\'round\\' stroke-width=\\'1.5\\' d=\\'M6 8l4 4 4-4\\'/%3E%3C/svg%3E')] bg-[length:1.5em_1.5em] bg-[right_0.75rem_center] bg-no-repeat pr-10";
+  const focusClasses = "focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500";
+  const disabledClasses = disabled ? "bg-gray-50 text-gray-500 cursor-not-allowed" : "";
+  const errorClasses = rest["data-error"] ? "border-red-300 focus:border-red-500 focus:ring-red-500" : "";
+  const classes = `${baseClasses} ${focusClasses} ${disabledClasses} ${errorClasses} ${className}`.trim();
+  return /* @__PURE__ */ jsxs(
+    "select",
+    {
+      id,
+      name,
+      value,
+      defaultValue,
+      required,
+      disabled,
+      className: classes,
+      ...rest,
+      children: [
+        !required && /* @__PURE__ */ jsx("option", { value: "", disabled: true, children: placeholder }),
+        options.map((option) => /* @__PURE__ */ jsx(
+          "option",
+          {
+            value: option.value,
+            disabled: option.disabled,
+            selected: value === option.value || defaultValue === option.value,
+            children: option.label
+          },
+          option.value
+        ))
+      ]
+    }
+  );
+};
+var Textarea = (props) => {
+  const {
+    id,
+    name,
+    value,
+    defaultValue,
+    placeholder,
+    required,
+    disabled,
+    readOnly,
+    rows = 4,
+    className = "",
+    ...rest
+  } = props;
+  const baseClasses = "block w-full px-4 py-2.5 text-sm text-gray-900 bg-white border border-gray-300 rounded-lg shadow-sm transition-all duration-200 resize-y";
+  const focusClasses = "focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500";
+  const disabledClasses = disabled ? "bg-gray-50 text-gray-500 cursor-not-allowed" : "";
+  const readOnlyClasses = readOnly ? "bg-gray-50 text-gray-700 cursor-default" : "";
+  const errorClasses = rest["data-error"] ? "border-red-300 focus:border-red-500 focus:ring-red-500" : "";
+  const classes = `${baseClasses} ${focusClasses} ${disabledClasses} ${readOnlyClasses} ${errorClasses} ${className}`.trim();
+  return /* @__PURE__ */ jsx(
+    "textarea",
+    {
+      id,
+      name,
+      value,
+      defaultValue,
+      placeholder,
+      required,
+      disabled,
+      readOnly,
+      rows,
+      className: classes,
+      ...rest
+    }
+  );
+};
+var Form = (props) => {
+  const {
+    item,
+    fields,
+    submitUrl,
+    method = item ? "PUT" : "POST",
+    redirectUrl,
+    title = item ? "\u7F16\u8F91" : "\u65B0\u5EFA",
+    cancelUrl,
+    isDialog = false,
+    formData
+  } = props;
+  const getFieldValue = (fieldName) => {
+    if (formData && Object.prototype.hasOwnProperty.call(formData, fieldName)) {
+      const value = formData[fieldName];
+      return value === null || value === void 0 ? "" : value;
+    }
+    if (item && Object.prototype.hasOwnProperty.call(item, fieldName)) {
+      const value = item[fieldName];
+      return value === null || value === void 0 ? "" : value;
+    }
+    return "";
+  };
+  const renderFieldInput = (field) => {
+    const value = getFieldValue(field.name);
+    const fieldId = `field-${field.name}`;
+    switch (field.type || "text") {
+      case "textarea":
+        return /* @__PURE__ */ jsx(
+          Textarea,
+          {
+            id: fieldId,
+            name: field.name,
+            value,
+            required: field.required,
+            placeholder: field.placeholder,
+            rows: 4
+          }
+        );
+      case "select":
+        return /* @__PURE__ */ jsx(
+          Select,
+          {
+            id: fieldId,
+            name: field.name,
+            value,
+            required: field.required,
+            options: field.options || [],
+            placeholder: "\u8BF7\u9009\u62E9"
+          }
+        );
+      case "number":
+        return /* @__PURE__ */ jsx(
+          Input,
+          {
+            type: "number",
+            id: fieldId,
+            name: field.name,
+            value,
+            required: field.required,
+            placeholder: field.placeholder
+          }
+        );
+      case "date":
+      case "datetime-local":
+        return /* @__PURE__ */ jsx(
+          DateInput,
+          {
+            type: field.type,
+            id: fieldId,
+            name: field.name,
+            value: value ? field.type === "date" ? value.split("T")[0] : value : "",
+            required: field.required
+          }
+        );
+      default:
+        const inputType = field.type === "email" ? "email" : "text";
+        return /* @__PURE__ */ jsx(
+          Input,
+          {
+            type: inputType,
+            id: fieldId,
+            name: field.name,
+            value,
+            required: field.required,
+            placeholder: field.placeholder
+          }
+        );
+    }
+  };
+  const target = isDialog ? "#dialog-container" : "#main-content";
+  return /* @__PURE__ */ jsxs("div", { children: [
+    !isDialog && /* @__PURE__ */ jsx(PageHeader, { title }),
+    /* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsx(
+      "form",
+      {
+        "hx-put": method === "PUT" ? submitUrl : void 0,
+        "hx-post": method === "POST" ? submitUrl : void 0,
+        "hx-encoding": "json",
+        "hx-headers": JSON.stringify({
+          "HX-Target": target,
+          "HX-Redirect-Url": redirectUrl || "",
+          "Content-Type": "application/json"
+        }),
+        children: /* @__PURE__ */ jsxs("div", { className: "space-y-6", children: [
+          fields.map((field) => {
+            const fieldId = `field-${field.name}`;
+            return /* @__PURE__ */ jsx(
+              FormField,
+              {
+                id: fieldId,
+                label: field.label,
+                required: field.required,
+                children: field.render ? field.render(getFieldValue(field.name), item) : renderFieldInput(field)
+              },
+              field.name
+            );
+          }),
+          /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-end gap-3 pt-6 border-t border-gray-200", children: [
+            cancelUrl && (isDialog ? /* @__PURE__ */ jsx(
+              Button,
+              {
+                type: "button",
+                variant: "secondary",
+                className: "min-w-[80px]",
+                _: "on click \r\n                         add .dialog-exit to .dialog-backdrop\r\n                         add .dialog-content-exit to .dialog-content\r\n                         wait 200ms\r\n                         set #dialog-container's innerHTML to '' end",
+                children: "\u53D6\u6D88"
+              }
+            ) : /* @__PURE__ */ jsx(
+              Button,
+              {
+                variant: "secondary",
+                href: cancelUrl,
+                hxGet: cancelUrl,
+                className: "min-w-[80px]",
+                children: "\u53D6\u6D88"
+              }
+            )),
+            /* @__PURE__ */ jsx(
+              Button,
+              {
+                type: "submit",
+                variant: "primary",
+                className: "min-w-[100px] font-semibold",
+                children: "\u4FDD\u5B58"
+              }
+            )
+          ] })
+        ] })
+      }
+    ) })
+  ] });
+};
+
+// src/utils/zod-form.tsx
+function getFieldDescription(schema) {
+  const def = schema._def;
+  if (def?.description) {
+    return def.description;
+  }
+  if (def?.innerType) {
+    return getFieldDescription(def.innerType);
+  }
+  return void 0;
+}
+function isRequiredField(schema) {
+  const def = schema._def;
+  if (def?.type === "optional" || def?.typeName === "ZodOptional") {
+    return false;
+  }
+  if (def?.type === "nullable" || def?.typeName === "ZodNullable") {
+    return isRequiredField(def.innerType);
+  }
+  return true;
+}
+function inferFieldType(schema) {
+  const def = schema._def;
+  const typeName = def?.type || def?.typeName;
+  if (typeName === "optional" || typeName === "ZodOptional") {
+    return inferFieldType(def.innerType);
+  }
+  if (typeName === "nullable" || typeName === "ZodNullable") {
+    return inferFieldType(def.innerType);
+  }
+  if (typeName === "enum" || typeName === "ZodEnum") {
+    return "select";
+  }
+  if (typeName === "nativeEnum" || typeName === "ZodNativeEnum") {
+    return "select";
+  }
+  if (typeName === "string" || typeName === "ZodString") {
+    if (def?.checks) {
+      const hasEmailCheck = def.checks.some(
+        (check) => check.kind === "email"
+      );
+      if (hasEmailCheck) {
+        return "email";
+      }
+    }
+    return "text";
+  }
+  if (typeName === "number" || typeName === "ZodNumber") {
+    return "number";
+  }
+  if (typeName === "date" || typeName === "ZodDate") {
+    return "date";
+  }
+  if (typeName === "boolean" || typeName === "ZodBoolean") {
+    return "select";
+  }
+  return "text";
+}
+function extractEnumOptions(schema) {
+  const def = schema._def;
+  const typeName = def?.type || def?.typeName;
+  if (typeName === "optional" || typeName === "ZodOptional") {
+    return extractEnumOptions(def.innerType);
+  }
+  if (typeName === "nullable" || typeName === "ZodNullable") {
+    return extractEnumOptions(def.innerType);
+  }
+  if (typeName === "enum" || typeName === "ZodEnum") {
+    const values = def?.values || [];
+    return values.map((value) => ({
+      value,
+      label: value
+    }));
+  }
+  if (typeName === "nativeEnum" || typeName === "ZodNativeEnum") {
+    const enumObject = def?.values;
+    if (enumObject) {
+      return Object.entries(enumObject).filter(
+        ([_, value]) => typeof value === "string" || typeof value === "number"
+      ).map(([key, value]) => ({
+        value,
+        label: key
+      }));
+    }
+  }
+  if (typeName === "boolean" || typeName === "ZodBoolean") {
+    return [
+      { value: "true", label: "\u662F" },
+      { value: "false", label: "\u5426" }
+    ];
+  }
+  return void 0;
+}
+function generateFormFieldsFromSchema(schema, options) {
+  const def = schema._def;
+  if (!def || !def.shape) {
+    return [];
+  }
+  const shape = typeof def.shape === "function" ? def.shape() : def.shape;
+  if (!shape || typeof shape !== "object") {
+    return [];
+  }
+  const fields = [];
+  const {
+    fieldLabels = {},
+    fieldPlaceholders = {},
+    fieldOptions = {},
+    fieldTypes = {},
+    excludeFields = []
+  } = options || {};
+  for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+    if (excludeFields.includes(fieldName)) {
+      continue;
+    }
+    const zodSchema = fieldSchema;
+    const description = getFieldDescription(zodSchema);
+    const label = fieldLabels[fieldName] || description || fieldName;
+    const type = fieldTypes[fieldName] || inferFieldType(zodSchema);
+    const required = isRequiredField(zodSchema);
+    const placeholder = fieldPlaceholders[fieldName];
+    const options2 = fieldOptions[fieldName] || extractEnumOptions(zodSchema);
+    fields.push({
+      name: fieldName,
+      label,
+      type,
+      required,
+      placeholder,
+      options: options2
+    });
+  }
+  return fields;
+}
+function validateFormDataWithSchema(schema, data) {
+  try {
+    const result = schema.safeParse(data);
+    if (result.success) {
+      return { success: true, data: result.data };
+    } else {
+      const issues = result.error.issues || [];
+      if (issues.length === 0) {
+        return { success: false, error: "\u9A8C\u8BC1\u5931\u8D25" };
+      }
+      const firstError = issues[0];
+      const fieldName = firstError.path && firstError.path.length > 0 ? firstError.path.join(".") : "";
+      const errorMessage = firstError.message;
+      const formattedError = fieldName ? `${fieldName}: ${errorMessage}` : errorMessage;
+      return { success: false, error: formattedError };
+    }
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : "\u9A8C\u8BC1\u5931\u8D25"
+    };
+  }
+}
+var FormPageModule = class extends PageModule {
+  /** ID 字段名（默认 "id"） */
+  idField = "id";
+  /** Zod Schema（可选，如果提供则自动生成表单字段和校验） */
+  schema;
+  constructor(schema) {
+    super();
+    this.schema = schema;
+  }
+  /**
+   * 获取单条数据（编辑时使用）
+   */
+  async getItem(id) {
+    const datasource = this.getDatasource();
+    return await datasource.getItem?.(id) || null;
+  }
+  /**
+   * 获取字段标签（可选）
+   * 子类可以重写此方法来自定义字段的中文标签
+   */
+  getFieldLabel(field) {
+    return field;
+  }
+  /**
+   * 获取表单字段定义
+   *
+   * 如果提供了 schema，则自动从 schema 生成字段定义
+   * 否则子类必须实现此方法来定义表单的字段
+   */
+  getFormFields(item) {
+    if (this.schema) {
+      return generateFormFieldsFromSchema(this.schema, {
+        fieldLabels: this.getFieldLabels?.(),
+        fieldPlaceholders: this.getFieldPlaceholders?.(),
+        fieldOptions: this.getFieldOptions?.(),
+        fieldTypes: this.getFieldTypes?.(),
+        excludeFields: this.getExcludeFields?.()
+      });
+    }
+    throw new Error(
+      "getFormFields must be implemented or schema must be provided"
+    );
+  }
+  /**
+   * 验证表单数据
+   *
+   * 如果提供了 schema，则自动使用 schema 进行校验
+   * 否则子类可以重写此方法来验证表单数据
+   */
+  validateFormData(data, item) {
+    if (this.schema) {
+      const result = validateFormDataWithSchema(this.schema, data);
+      if (!result.success) {
+        return result.error;
+      }
+      return null;
+    }
+    return null;
+  }
+  /**
+   * 处理请求的统一入口（重写基类方法）
+   * 根据 HTTP method 处理不同请求：
+   * - GET: 渲染表单页面（调用 render）
+   * - POST: 创建数据
+   * - PUT: 更新数据
+   * - DELETE: 删除数据
+   * 子类可以重写此方法来自定义请求处理逻辑
+   */
+  async __handle() {
+    const ctx = this.context.ctx;
+    const method = ctx.req.method;
+    const id = ctx.req.param("id") || null;
+    if (method === "POST") {
+      return await this.handleCreate(ctx, this.context);
+    } else if (method === "PUT") {
+      return await this.handleUpdate(ctx, this.context, id);
+    } else if (method === "DELETE") {
+      return await this.handleDelete(ctx, this.context, id);
+    }
+    return await this.render();
+  }
+  /**
+   * 渲染表单页面（默认实现）
+   * 子类可以重写此方法来自定义渲染
+   * @param formData 表单数据（用于回填验证失败时的值）
+   */
+  async render(formData) {
+    const referer = this.context.ctx.req.header("Referer");
+    let pathname = new URL(this.context.ctx.req.url).pathname;
+    const method = this.context.ctx.req.method;
+    if (referer && ["POST", "PUT", "DELETE"].includes(method)) {
+      try {
+        const refererUrl = new URL(referer);
+        pathname = refererUrl.pathname;
+      } catch (e) {
+      }
+    }
+    const url = new URL(this.context.ctx.req.url);
+    const isDialog = url.searchParams.get("dialog") === "true";
+    const isEdit = pathname.includes("/edit");
+    const id = isEdit ? this.context.ctx.req.param("id") : null;
+    let item = null;
+    if (isEdit && id) {
+      item = await this.getItem(id);
+      if (!item) {
+        return /* @__PURE__ */ jsx("div", { className: "text-center py-12", children: /* @__PURE__ */ jsx("p", { className: "text-gray-500", children: "\u672A\u627E\u5230\u6570\u636E" }) });
+      }
+    }
+    const fields = this.getFormFields(item);
+    if (fields.length === 0) {
+      return /* @__PURE__ */ jsx("div", { className: "text-center py-12", children: /* @__PURE__ */ jsx("p", { className: "text-gray-500", children: "\u6CA1\u6709\u53EF\u7F16\u8F91\u7684\u5B57\u6BB5" }) });
+    }
+    const moduleName = this.context.moduleMetadata.title;
+    const basePath = this.context.moduleMetadata.basePath;
+    const hasList = this.context.moduleMetadata.hasList;
+    let cancelUrl;
+    if (hasList && basePath) {
+      cancelUrl = isEdit ? `${basePath}/detail/${id}` : `${basePath}/list`;
+    }
+    const formContent = /* @__PURE__ */ jsx(
+      Form,
+      {
+        item,
+        fields,
+        submitUrl: isEdit ? `${basePath}/${id}` : basePath,
+        method: isEdit ? "PUT" : "POST",
+        redirectUrl: isEdit ? `${basePath}/detail/${id}` : hasList ? `${basePath}/list` : void 0,
+        title: moduleName + (isEdit ? " - \u7F16\u8F91" : " - \u65B0\u5EFA"),
+        cancelUrl,
+        isDialog,
+        formData
+      }
+    );
+    return formContent;
+  }
+  /**
+   * 处理创建请求（POST）
+   */
+  async handleCreate(ctx, adminContext) {
+    let body = {};
+    try {
+      const contentType = ctx.req.header("Content-Type") || "";
+      if (contentType.includes("application/json")) {
+        body = await ctx.req.json();
+      } else {
+        const formData = await ctx.req.parseBody();
+        body = formData;
+      }
+    } catch (e) {
+      body = {};
+    }
+    const validationError = this.validateFormData(body, null);
+    if (validationError) {
+      adminContext.sendNotification("error", "\u9A8C\u8BC1\u5931\u8D25", validationError);
+      return await this.renderFormPage(adminContext, null, false, body);
+    }
+    try {
+      const newItem = await this.getDatasource().createItem?.(
+        body
+      );
+      const basePath = this.context.moduleMetadata.basePath;
+      const hasDetail = this.context.moduleMetadata.hasDetail;
+      const hasList = this.context.moduleMetadata.hasList;
+      if (adminContext.isDialog) {
+        adminContext.sendNotification("success", "\u521B\u5EFA\u6210\u529F", "\u6570\u636E\u5DF2\u6210\u529F\u521B\u5EFA");
+        adminContext.setRefresh(true);
+        return null;
+      }
+      if (hasDetail) {
+        adminContext.redirect(
+          `${basePath}/detail/${newItem[this.idField]}`
+        );
+      } else if (hasList) {
+        adminContext.redirect(`${basePath}/list`);
+      }
+      adminContext.sendNotification("success", "\u521B\u5EFA\u6210\u529F", "\u6570\u636E\u5DF2\u6210\u529F\u521B\u5EFA");
+      return await this.render();
+    } catch (error) {
+      this.context.sendNotification(
+        "error",
+        "\u521B\u5EFA\u5931\u8D25",
+        error instanceof Error ? error.message : "\u521B\u5EFA\u5931\u8D25"
+      );
+      return await this.renderFormPage(adminContext, null, false, body);
+    }
+  }
+  /**
+   * 处理更新请求（PUT）
+   */
+  async handleUpdate(ctx, adminContext, id) {
+    let body = {};
+    try {
+      const contentType = ctx.req.header("Content-Type") || "";
+      if (contentType.includes("application/json")) {
+        body = await ctx.req.json();
+      } else {
+        const formData = await ctx.req.parseBody();
+        body = formData;
+      }
+    } catch (e) {
+      body = {};
+    }
+    const item = await this.getItem(id);
+    if (!item) {
+      adminContext.sendNotification(
+        "error",
+        "\u672A\u627E\u5230\u6570\u636E",
+        "\u65E0\u6CD5\u627E\u5230\u8981\u7F16\u8F91\u7684\u6570\u636E"
+      );
+      return /* @__PURE__ */ jsx("div", { className: "text-center py-12", children: /* @__PURE__ */ jsx("p", { className: "text-gray-500", children: "\u672A\u627E\u5230\u6570\u636E" }) });
+    }
+    const validationError = this.validateFormData(body, item);
+    if (validationError) {
+      adminContext.sendNotification("error", "\u9A8C\u8BC1\u5931\u8D25", validationError);
+      const mergedData = { ...item, ...body };
+      return await this.renderFormPage(adminContext, item, true, mergedData);
+    }
+    try {
+      const datasource = this.getDatasource();
+      if (datasource.updateItem) {
+        await datasource.updateItem(id, body);
+      }
+      if (adminContext.isDialog) {
+        adminContext.sendNotification("success", "\u66F4\u65B0\u6210\u529F", "\u6570\u636E\u5DF2\u6210\u529F\u66F4\u65B0");
+        adminContext.setRefresh(true);
+        return null;
+      }
+      const basePath = this.context.moduleMetadata.basePath;
+      this.context.redirect(`${basePath}/detail/${id}`);
+      this.context.sendNotification("success", "\u66F4\u65B0\u6210\u529F", "\u6570\u636E\u5DF2\u6210\u529F\u66F4\u65B0");
+      return this.context.content;
+    } catch (error) {
+      adminContext.sendNotification(
+        "error",
+        "\u66F4\u65B0\u5931\u8D25",
+        error instanceof Error ? error.message : "\u66F4\u65B0\u5931\u8D25"
+      );
+      const mergedData = { ...item, ...body };
+      return await this.renderFormPage(adminContext, item, true, mergedData);
+    }
+  }
+  /**
+   * 处理删除请求（DELETE）
+   * 注意：FormDatasource 不包含 deleteItem，删除操作通常由 List 或 Detail 模块处理
+   * 这里提供默认实现，子类可以重写
+   */
+  async handleDelete(ctx, adminContext, id) {
+    adminContext.sendNotification(
+      "error",
+      "\u4E0D\u652F\u6301\u5220\u9664\u64CD\u4F5C",
+      "\u8868\u5355\u6A21\u5757\u4E0D\u652F\u6301\u5220\u9664\u64CD\u4F5C\uFF0C\u8BF7\u4F7F\u7528\u5217\u8868\u6216\u8BE6\u60C5\u6A21\u5757"
+    );
+    const basePath = this.context.moduleMetadata.basePath;
+    const hasList = this.context.moduleMetadata.hasList;
+    if (hasList) {
+      adminContext.redirect(`${basePath}/list`);
+    } else {
+      adminContext.redirect(basePath);
+    }
+    return null;
+  }
+  /**
+   * 渲染表单页面（辅助方法）
+   * 用于在验证失败时重新渲染表单页面
+   * @param adminContext 上下文对象
+   * @param item 原始数据项（编辑时）
+   * @param isEdit 是否是编辑模式
+   * @param formData 表单数据（用于回填验证失败时的值）
+   */
+  async renderFormPage(adminContext, item, isEdit, formData) {
+    return await this.render(formData);
+  }
+};
+var FilterCard = (props) => {
+  const {
+    title,
+    fields,
+    filterButtonText = "\u7B5B\u9009",
+    filterButtonHxGet,
+    preserveParams = [],
+    className = ""
+  } = props;
+  return /* @__PURE__ */ jsx(Card, { className, children: /* @__PURE__ */ jsxs("form", { "hx-get": filterButtonHxGet, className: "space-y-4", children: [
+    title && /* @__PURE__ */ jsx("h3", { className: "text-lg font-semibold text-gray-900", children: title }),
+    /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4 items-end", children: [
+      fields.map((field) => /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx(
+          "label",
+          {
+            htmlFor: field.name,
+            className: "block text-sm font-medium text-gray-700 mb-2",
+            children: field.label
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          Select,
+          {
+            id: field.name,
+            name: field.name,
+            value: field.value,
+            defaultValue: field.defaultValue,
+            options: field.options,
+            className: "w-full"
+          }
+        )
+      ] }, field.name)),
+      filterButtonHxGet && /* @__PURE__ */ jsx("div", { children: /* @__PURE__ */ jsx(Button, { type: "submit", variant: "primary", className: "w-full", children: filterButtonText }) })
+    ] })
+  ] }) });
+};
+var StatCard = (props) => {
+  const {
+    title,
+    value,
+    change,
+    changeLabel = "\u76F8\u6BD4\u4E0A\u6708",
+    iconColor = "blue",
+    icon,
+    className = ""
+  } = props;
+  const iconColorClasses = {
+    blue: "bg-blue-100 text-blue-600",
+    green: "bg-green-100 text-green-600",
+    yellow: "bg-yellow-100 text-yellow-600",
+    purple: "bg-purple-100 text-purple-600",
+    red: "bg-red-100 text-red-600",
+    indigo: "bg-indigo-100 text-indigo-600"
+  };
+  const changeColorClass = change === void 0 ? "" : change > 0 ? "text-green-600" : change < 0 ? "text-red-600" : "text-gray-600";
+  const defaultIcon = /* @__PURE__ */ jsx(
+    "svg",
+    {
+      className: "w-6 h-6",
+      fill: "none",
+      stroke: "currentColor",
+      viewBox: "0 0 24 24",
+      children: /* @__PURE__ */ jsx(
+        "path",
+        {
+          strokeLinecap: "round",
+          strokeLinejoin: "round",
+          strokeWidth: 2,
+          d: change !== void 0 && change > 0 ? "M13 7h8m0 0v8m0-8l-8 8-4-4-6 6" : change !== void 0 && change < 0 ? "M13 17h8m0 0V9m0 8l-8-8-4 4-6 6" : "M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"
+        }
+      )
+    }
+  );
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: `bg-white rounded-lg shadow-sm p-6 hover:shadow-md transition-shadow ${className}`,
+      children: /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between", children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex-1", children: [
+          /* @__PURE__ */ jsx("p", { className: "text-sm font-medium text-gray-600 mb-1", children: title }),
+          /* @__PURE__ */ jsx("p", { className: "text-3xl font-bold text-gray-900 mb-2", children: typeof value === "number" ? value.toLocaleString() : value }),
+          change !== void 0 && /* @__PURE__ */ jsxs("p", { className: `text-sm font-medium ${changeColorClass}`, children: [
+            change > 0 ? /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center", children: [
+              /* @__PURE__ */ jsx(
+                "svg",
+                {
+                  className: "w-4 h-4 mr-1",
+                  fill: "none",
+                  stroke: "currentColor",
+                  viewBox: "0 0 24 24",
+                  children: /* @__PURE__ */ jsx(
+                    "path",
+                    {
+                      strokeLinecap: "round",
+                      strokeLinejoin: "round",
+                      strokeWidth: 2,
+                      d: "M5 10l7-7m0 0l7 7m-7-7v18"
+                    }
+                  )
+                }
+              ),
+              Math.abs(change),
+              "%"
+            ] }) : change < 0 ? /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center", children: [
+              /* @__PURE__ */ jsx(
+                "svg",
+                {
+                  className: "w-4 h-4 mr-1",
+                  fill: "none",
+                  stroke: "currentColor",
+                  viewBox: "0 0 24 24",
+                  children: /* @__PURE__ */ jsx(
+                    "path",
+                    {
+                      strokeLinecap: "round",
+                      strokeLinejoin: "round",
+                      strokeWidth: 2,
+                      d: "M19 14l-7 7m0 0l-7-7m7 7V3"
+                    }
+                  )
+                }
+              ),
+              Math.abs(change),
+              "%"
+            ] }) : /* @__PURE__ */ jsxs("span", { children: [
+              change,
+              "%"
+            ] }),
+            " ",
+            changeLabel
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: `flex-shrink-0 w-12 h-12 rounded-lg flex items-center justify-center ${iconColorClasses[iconColor]}`,
+            children: icon || defaultIcon
+          }
+        )
+      ] })
+    }
+  );
+};
+var ActionButton = (props) => {
+  const { label, href, method, className = "", item } = props;
+  const hrefValue = typeof href === "function" ? href(item || {}) : href;
+  const isDelete = method === "delete";
+  const variant = isDelete ? "danger" : "ghost";
+  const size = "sm";
+  return /* @__PURE__ */ jsx(
+    Button,
+    {
+      variant,
+      size,
+      className: `${isDelete ? "" : "text-blue-600 hover:text-blue-800"} ${className}`,
+      href: hrefValue,
+      hxGet: !isDelete ? hrefValue : void 0,
+      hxDelete: isDelete ? hrefValue : void 0,
+      hxPushUrl: !isDelete,
+      hxConfirm: isDelete ? "\u786E\u5B9A\u5220\u9664\u5417\uFF1F" : void 0,
+      hxHeaders: isDelete ? JSON.stringify({ "HX-Target": "#main-content" }) : void 0,
+      children: label
+    }
+  );
+};
+var EmptyState = (props) => {
+  const { message = "\u6682\u65E0\u6570\u636E", children } = props;
+  return /* @__PURE__ */ jsx("div", { className: "text-center py-12", children: children || /* @__PURE__ */ jsx("p", { className: "text-gray-500 text-sm", children: message }) });
+};
+var Pagination = (props) => {
+  const {
+    page,
+    pageSize,
+    total,
+    totalPages,
+    baseUrl,
+    currentParams = {}
+  } = props;
+  if (totalPages <= 1) {
+    return null;
+  }
+  const start = (page - 1) * pageSize + 1;
+  const end = Math.min(page * pageSize, total);
+  const buildUrl = (targetPage) => {
+    const url = new URL(baseUrl, "http://localhost");
+    for (const [key, value] of Object.entries(currentParams)) {
+      if (value !== void 0 && value !== null && value !== "") {
+        url.searchParams.set(key, String(value));
+      }
+    }
+    url.searchParams.set("page", String(targetPage));
+    return url.pathname + url.search;
+  };
+  return /* @__PURE__ */ jsxs("div", { className: "px-6 py-4 flex items-center justify-between border-t border-gray-200 bg-gray-50", children: [
+    /* @__PURE__ */ jsxs("div", { className: "text-sm text-gray-700", children: [
+      "\u663E\u793A ",
+      /* @__PURE__ */ jsx("span", { className: "font-medium", children: start }),
+      " \u5230",
+      " ",
+      /* @__PURE__ */ jsx("span", { className: "font-medium", children: end }),
+      " \u6761\uFF0C\u5171",
+      " ",
+      /* @__PURE__ */ jsx("span", { className: "font-medium", children: total }),
+      " \u6761"
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
+      page > 1 && /* @__PURE__ */ jsx(
+        Button,
+        {
+          variant: "secondary",
+          size: "sm",
+          hxGet: buildUrl(page - 1),
+          href: buildUrl(page - 1),
+          children: "\u4E0A\u4E00\u9875"
+        }
+      ),
+      page < totalPages && /* @__PURE__ */ jsx(
+        Button,
+        {
+          variant: "secondary",
+          size: "sm",
+          hxGet: buildUrl(page + 1),
+          href: buildUrl(page + 1),
+          children: "\u4E0B\u4E00\u9875"
+        }
+      )
+    ] })
+  ] });
+};
+var STYLES = {
+  header: {
+    container: "px-6 py-4 border-b border-gray-200 flex items-center justify-between",
+    title: "text-lg font-semibold text-gray-900",
+    actions: "flex gap-2"
+  },
+  table: {
+    container: "overflow-x-auto",
+    table: "min-w-full divide-y divide-gray-200",
+    thead: "bg-gray-50",
+    th: {
+      base: "px-6 py-3 text-left text-xs font-semibold text-gray-600 uppercase tracking-wider whitespace-nowrap",
+      stickyLeft: "sticky left-0 z-20 bg-gray-50 border-r border-gray-200 whitespace-nowrap",
+      stickyRight: "sticky right-0 z-20 bg-gray-50 border-l border-gray-200 whitespace-nowrap"
+    },
+    tbody: "bg-white divide-y divide-gray-200",
+    tr: "group hover:bg-gray-50 transition-colors",
+    td: {
+      base: "px-6 py-4 whitespace-nowrap text-sm text-gray-900",
+      stickyLeft: "sticky left-0 z-10 bg-white group-hover:bg-gray-50 transition-colors border-r border-gray-200",
+      stickyRight: "sticky right-0 z-10 bg-white group-hover:bg-gray-50 transition-colors border-l border-gray-200"
+    }
+  },
+  actionLink: {
+    container: "flex gap-3",
+    base: "text-sm hover:underline",
+    default: "text-blue-600 hover:text-blue-800",
+    delete: "text-red-600 hover:text-red-800"
+  },
+  actionButton: "flex gap-2 flex-wrap"
+};
+function TableHeader(props) {
+  const { title, tableActions } = props;
+  const showHeader = title && title.trim() || tableActions && tableActions.length > 0;
+  if (!showHeader) return null;
+  return /* @__PURE__ */ jsxs("div", { className: STYLES.header.container, children: [
+    title && title.trim() ? /* @__PURE__ */ jsx("h3", { className: STYLES.header.title, children: title }) : /* @__PURE__ */ jsx("div", {}),
+    tableActions && tableActions.length > 0 && /* @__PURE__ */ jsx("div", { className: STYLES.header.actions, children: tableActions.map((action, idx) => /* @__PURE__ */ jsx(
+      Button,
+      {
+        variant: action.variant || "secondary",
+        href: action.href,
+        hxGet: action.hxGet,
+        hxPost: action.hxPost,
+        hxDelete: action.hxDelete,
+        hxConfirm: action.hxConfirm,
+        children: action.label
+      },
+      idx
+    )) })
+  ] });
+}
+function TableHeaderRow(props) {
+  const { idColumn, otherColumns, hasActions } = props;
+  return /* @__PURE__ */ jsxs("tr", { children: [
+    idColumn && /* @__PURE__ */ jsx("th", { className: `${STYLES.table.th.base} ${STYLES.table.th.stickyLeft}`, children: idColumn.label }),
+    otherColumns.map((col) => /* @__PURE__ */ jsx("th", { className: STYLES.table.th.base, children: col.label }, col.key)),
+    hasActions && /* @__PURE__ */ jsx(
+      "th",
+      {
+        className: `${STYLES.table.th.base} ${STYLES.table.th.stickyRight}`,
+        children: "\u64CD\u4F5C"
+      }
+    )
+  ] });
+}
+function TableCell(props) {
+  const { column, item, isSticky, stickyClass } = props;
+  const value = item[column.key];
+  const content = column.render ? safeRender(column.render(value, item)) : String(value || "");
+  const className = isSticky ? `${STYLES.table.td.base} ${stickyClass || ""}` : STYLES.table.td.base;
+  return /* @__PURE__ */ jsx("td", { className, children: content });
+}
+function ActionLink(props) {
+  const { action, item } = props;
+  const hrefValue = action.href(item);
+  const isDelete = action.method === "delete";
+  const className = `${STYLES.actionLink.base} ${isDelete ? STYLES.actionLink.delete : STYLES.actionLink.default}`;
+  return /* @__PURE__ */ jsx(
+    "a",
+    {
+      href: hrefValue,
+      className,
+      "hx-get": !isDelete ? hrefValue : void 0,
+      "hx-delete": isDelete ? hrefValue : void 0,
+      "hx-confirm": isDelete ? "\u786E\u5B9A\u5220\u9664\u5417\uFF1F" : void 0,
+      children: action.label
+    }
+  );
+}
+function ActionCell(props) {
+  const { actions, item, actionStyle } = props;
+  if (!actions || actions.length === 0) return null;
+  return /* @__PURE__ */ jsx("td", { className: `${STYLES.table.td.base} ${STYLES.table.td.stickyRight}`, children: actionStyle === "link" ? /* @__PURE__ */ jsx("div", { className: STYLES.actionLink.container, children: actions.map((action, idx) => /* @__PURE__ */ jsx(ActionLink, { action, item }, idx)) }) : /* @__PURE__ */ jsx("div", { className: STYLES.actionButton, children: actions.map((action, idx) => /* @__PURE__ */ jsx(
+    ActionButton,
+    {
+      label: action.label,
+      href: action.href,
+      method: action.method,
+      className: action.class,
+      item
+    },
+    idx
+  )) }) });
+}
+function TableRow(props) {
+  const { item, idColumn, otherColumns, actions, actionStyle } = props;
+  return /* @__PURE__ */ jsxs("tr", { className: STYLES.table.tr, children: [
+    idColumn && /* @__PURE__ */ jsx(
+      TableCell,
+      {
+        column: idColumn,
+        item,
+        isSticky: true,
+        stickyClass: STYLES.table.td.stickyLeft
+      }
+    ),
+    otherColumns.map((col) => /* @__PURE__ */ jsx(TableCell, { column: col, item }, col.key)),
+    actions && actions.length > 0 && /* @__PURE__ */ jsx(ActionCell, { actions, item, actionStyle })
+  ] });
+}
+var Table = (props) => {
+  const {
+    items,
+    columns,
+    actions,
+    pagination,
+    title,
+    tableActions,
+    actionStyle = "link"
+  } = props;
+  const idColumn = columns.find((col) => col.key === "id");
+  const otherColumns = columns.filter((col) => col.key !== "id");
+  const hasActions = Boolean(actions && actions.length > 0);
+  return /* @__PURE__ */ jsxs(Card, { shadow: true, noPadding: true, className: "overflow-hidden", children: [
+    /* @__PURE__ */ jsx(TableHeader, { title, tableActions }),
+    items.length === 0 ? /* @__PURE__ */ jsx(EmptyState, { message: "\u6682\u65E0\u6570\u636E" }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("div", { className: STYLES.table.container, children: /* @__PURE__ */ jsxs("table", { className: STYLES.table.table, children: [
+        /* @__PURE__ */ jsx("thead", { className: STYLES.table.thead, children: /* @__PURE__ */ jsx(
+          TableHeaderRow,
+          {
+            columns,
+            idColumn,
+            otherColumns,
+            hasActions
+          }
+        ) }),
+        /* @__PURE__ */ jsx("tbody", { className: STYLES.table.tbody, children: items.map((item) => /* @__PURE__ */ jsx(
+          TableRow,
+          {
+            item,
+            idColumn,
+            otherColumns,
+            actions,
+            actionStyle
+          },
+          item.id
+        )) })
+      ] }) }),
+      pagination && /* @__PURE__ */ jsx(Pagination, { ...pagination })
+    ] })
+  ] });
+};
+function ListContent(props) {
+  const {
+    result,
+    params,
+    pageTitle,
+    pageDescription,
+    tableTitle,
+    columns,
+    actions,
+    stats = [],
+    filters = [],
+    tableActions = [],
+    hasFormModule,
+    createPath,
+    listPath
+  } = props;
+  const currentParams = {
+    pageSize: params.pageSize,
+    sortBy: params.sortBy,
+    sortOrder: params.sortOrder,
+    ...params.filters
+    // 包含所有筛选条件
+  };
+  const tableActionsList = actions && actions.length > 0 ? actions.map((action) => ({
+    label: action.label,
+    href: typeof action.href === "string" ? () => action.href : action.href,
+    method: action.method,
+    class: action.class
+  })) : void 0;
+  const finalTableActions = tableActions.length > 0 ? tableActions : [
+    {
+      label: "\u5237\u65B0",
+      hxGet: listPath,
+      variant: "primary"
+    }
+  ];
+  const createButton = hasFormModule ? /* @__PURE__ */ jsx(Button, { variant: "primary", href: createPath, hxGet: createPath, children: "\u65B0\u5EFA" }) : null;
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-6", children: [
+    /* @__PURE__ */ jsx(
+      PageHeader,
+      {
+        title: pageTitle,
+        description: pageDescription,
+        actions: createButton
+      }
+    ),
+    stats.length > 0 && /* @__PURE__ */ jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6", children: stats.map((stat, idx) => /* @__PURE__ */ jsx(StatCard, { ...stat }, idx)) }),
+    filters.length > 0 && /* @__PURE__ */ jsx(
+      FilterCard,
+      {
+        fields: filters,
+        filterButtonText: "\u7B5B\u9009",
+        filterButtonHxGet: listPath
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Table,
+      {
+        items: result.items,
+        columns: columns.map((col) => ({
+          key: col.key,
+          label: col.label,
+          render: col.render ? (value, item) => col.render(value, item) : void 0
+        })),
+        actions: tableActionsList?.map((action) => ({
+          label: action.label,
+          href: (item) => action.href(item),
+          method: action.method,
+          class: action.class
+        })),
+        pagination: {
+          page: result.page,
+          pageSize: result.pageSize,
+          total: result.total,
+          totalPages: result.totalPages,
+          baseUrl: listPath,
+          currentParams
+        },
+        title: tableTitle,
+        tableActions: finalTableActions.length > 0 ? finalTableActions : void 0,
+        actionStyle: "link"
+      }
+    )
+  ] });
+}
+
+// src/utils/params.ts
+function parseListParams(ctx) {
+  const url = new URL(ctx.req.url);
+  const systemParams = /* @__PURE__ */ new Set(["page", "pageSize", "sortBy", "sortOrder"]);
+  const filters = {};
+  for (const [key, value] of url.searchParams.entries()) {
+    if (!systemParams.has(key) && value !== "") {
+      filters[key] = value;
+    }
+  }
+  return {
+    page: parseInt(url.searchParams.get("page") || "1", 10),
+    pageSize: parseInt(url.searchParams.get("pageSize") || "10", 10),
+    sortBy: url.searchParams.get("sortBy") || void 0,
+    sortOrder: url.searchParams.get("sortOrder") || void 0,
+    filters: Object.keys(filters).length > 0 ? filters : void 0
+  };
+}
+var ListPageModule = class extends PageModule {
+  /** ID 字段名（默认 "id"） */
+  idField = "id";
+  /**
+   * 获取列表数据
+   */
+  async getList(params) {
+    return await this.getDatasource().getList(params);
+  }
+  /**
+   * 删除数据（可选，如果数据源支持删除）
+   */
+  async deleteItem(id) {
+    const datasource = this.getDatasource();
+    if (datasource.deleteItem) {
+      return await datasource.deleteItem(id);
+    }
+    return false;
+  }
+  /**
+   * 获取字段标签（可选）
+   * 子类可以重写此方法来自定义字段的中文标签
+   */
+  getFieldLabel(field) {
+    return field;
+  }
+  /**
+   * 自定义列渲染（可选）
+   * 子类可以重写此方法来自定义列的渲染逻辑
+   */
+  renderColumn(field, value, item) {
+    return value;
+  }
+  /**
+   * 获取统计信息（可选）
+   * 子类可以重写此方法来返回 KPI 统计卡片数据
+   * 返回的数组将渲染为 StatCard 组件
+   */
+  getStats(params) {
+    return [];
+  }
+  /**
+   * 获取筛选器配置（可选）
+   * 子类可以重写此方法来返回筛选器字段配置
+   * 返回的配置将渲染为 FilterCard 组件
+   */
+  getFilters(params) {
+    return [];
+  }
+  /**
+   * 获取表格标题（可选）
+   * 子类可以重写此方法来返回表格标题
+   * 如果不定义，默认使用模块名
+   */
+  getTableTitle() {
+    return "";
+  }
+  /**
+   * 获取表格操作按钮（可选）
+   * 子类可以重写此方法来返回表格操作按钮配置（如导出、清空、刷新等）
+   * 如果不定义，默认会生成一个刷新按钮
+   */
+  getTableActions(params, basePath) {
+    return [];
+  }
+  /**
+   * 自定义操作按钮（可选）
+   * 子类可以重写此方法来添加自定义操作按钮
+   * 如果不定义，则根据模块元数据智能生成默认操作按钮
+   */
+  getActions(item) {
+    const id = item[this.idField];
+    const actions = [];
+    if (this.context.moduleMetadata.hasDetail) {
+      actions.push({
+        label: "\u67E5\u770B",
+        href: this.paths.detail(id)
+      });
+    }
+    if (this.context.moduleMetadata.hasForm) {
+      actions.push({
+        label: "\u7F16\u8F91",
+        href: this.paths.edit(id)
+      });
+    }
+    if (this.getDatasource().deleteItem) {
+      actions.push({
+        label: "\u5220\u9664",
+        href: this.paths.delete(id)
+      });
+    }
+    return actions;
+  }
+  /**
+   * 渲染列表页面（默认实现）
+   * 子类可以重写此方法来自定义渲染
+   */
+  async render() {
+    const params = parseListParams(this.context.ctx);
+    const result = await this.getList(params);
+    const pageTitle = this.getTitle();
+    const pageDescription = this.getDescription();
+    const tableTitle = this.getTableTitle ? this.getTableTitle() : pageTitle;
+    const columns = result.items.length > 0 ? Object.keys(result.items[0]).map((key) => ({
+      key,
+      label: this.getFieldLabel ? this.getFieldLabel(key) : key,
+      render: this.renderColumn ? (value, item) => this.renderColumn(key, value, item) : void 0
+    })) : [];
+    const actions = this.getActions && result.items.length > 0 ? this.getActions(result.items[0]) : [];
+    const statsResult = this.getStats ? await Promise.resolve(this.getStats(params)) : [];
+    const stats = Array.isArray(statsResult) ? statsResult : [];
+    const filters = this.getFilters ? this.getFilters(params) : [];
+    let tableActions = this.getTableActions ? this.getTableActions(params, this.paths.base()) : [];
+    const convertedActions = actions.map((action) => ({
+      label: action.label,
+      href: typeof action.href === "string" ? action.href : ((item) => action.href(item)),
+      method: action.method,
+      class: action.class
+    }));
+    return /* @__PURE__ */ jsx(
+      ListContent,
+      {
+        result,
+        params,
+        pageTitle,
+        pageDescription,
+        tableTitle,
+        columns,
+        actions: convertedActions,
+        stats,
+        filters,
+        tableActions,
+        hasFormModule: this.context.moduleMetadata.hasForm,
+        createPath: this.paths.create(),
+        listPath: this.paths.list()
+      }
+    );
+  }
+};
+
+// src/datasource/index.ts
+var MemoryListDatasource = class {
+  data;
+  constructor(data = []) {
+    this.data = data;
+  }
+  async getList(params = {}) {
+    const {
+      page = 1,
+      pageSize = 10,
+      sortBy,
+      sortOrder = "asc",
+      filters = {}
+    } = params;
+    let filtered = this.data.filter((item) => {
+      for (const [key, value] of Object.entries(filters)) {
+        if (value === void 0 || value === null || value === "") {
+          continue;
+        }
+        const itemValue = item[key];
+        if (typeof itemValue === "string" && !itemValue.toLowerCase().includes(String(value).toLowerCase())) {
+          return false;
+        }
+        if (itemValue !== value) {
+          return false;
+        }
+      }
+      return true;
+    });
+    if (sortBy) {
+      filtered.sort((a, b) => {
+        const aVal = a[sortBy];
+        const bVal = b[sortBy];
+        const comparison = aVal < bVal ? -1 : aVal > bVal ? 1 : 0;
+        return sortOrder === "asc" ? comparison : -comparison;
+      });
+    }
+    const start = (page - 1) * pageSize;
+    const end = start + pageSize;
+    const items = filtered.slice(start, end);
+    return {
+      items,
+      total: filtered.length,
+      page,
+      pageSize,
+      totalPages: Math.ceil(filtered.length / pageSize)
+    };
+  }
+  async getItem(id) {
+    return this.data.find((item) => {
+      if (item.id === id) {
+        return true;
+      }
+      if (typeof item.id === "number" && typeof id === "string") {
+        return item.id === Number(id);
+      }
+      if (typeof item.id === "string" && typeof id === "number") {
+        return Number(item.id) === id;
+      }
+      return false;
+    }) || null;
+  }
+  async deleteItem(id) {
+    const index = this.data.findIndex((item) => {
+      if (item.id === id) {
+        return true;
+      }
+      if (typeof item.id === "number" && typeof id === "string") {
+        return item.id === Number(id);
+      }
+      if (typeof item.id === "string" && typeof id === "number") {
+        return Number(item.id) === id;
+      }
+      return false;
+    });
+    if (index === -1) {
+      return false;
+    }
+    this.data.splice(index, 1);
+    return true;
+  }
+  async updateItem(id, data) {
+    const index = this.data.findIndex((item) => {
+      if (item.id === id) {
+        return true;
+      }
+      if (typeof item.id === "number" && typeof id === "string") {
+        return item.id === Number(id);
+      }
+      if (typeof item.id === "string" && typeof id === "number") {
+        return Number(item.id) === id;
+      }
+      return false;
+    });
+    if (index === -1) {
+      return null;
+    }
+    this.data[index] = { ...this.data[index], ...data };
+    return this.data[index];
+  }
+  async createItem(data) {
+    const maxId = this.data.length > 0 ? Math.max(
+      ...this.data.map(
+        (item) => typeof item.id === "number" ? item.id : 0
+      )
+    ) : 0;
+    const newId = maxId + 1;
+    const newItem = { ...data, id: newId };
+    this.data.push(newItem);
+    return newItem;
+  }
+};
+var Dialog = (props) => {
+  const {
+    title,
+    children,
+    showClose = true,
+    closeUrl,
+    className = "",
+    size = "lg"
+  } = props;
+  const sizeClasses = {
+    sm: "max-w-md",
+    md: "max-w-lg",
+    lg: "max-w-2xl",
+    xl: "max-w-4xl",
+    full: "max-w-7xl"
+  };
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: "fixed inset-0 bg-black bg-opacity-50 z-[100] flex items-center justify-center p-4 dialog-backdrop",
+      style: {
+        animation: "fadeIn 0.2s ease-out"
+      },
+      _: "on click if event.target is me \r\n         add .dialog-exit to me\r\n         add .dialog-content-exit to .dialog-content\r\n         wait 200ms\r\n         set #dialog-container's innerHTML to '' end",
+      children: /* @__PURE__ */ jsxs(
+        "div",
+        {
+          className: `bg-gray-50 rounded-lg shadow-xl ${sizeClasses[size]} w-full max-h-[90vh] overflow-hidden flex flex-col dialog-content ${className}`,
+          style: {
+            animation: "slideIn 0.3s ease-out"
+          },
+          _: "on click call event.stopPropagation()",
+          children: [
+            (title || showClose) && /* @__PURE__ */ jsxs("div", { className: "px-6 py-4 border-b border-gray-200 bg-white flex items-center justify-between", children: [
+              title && /* @__PURE__ */ jsx("h3", { className: "text-lg font-semibold text-gray-900", children: title }),
+              showClose && /* @__PURE__ */ jsx(
+                "button",
+                {
+                  className: "text-gray-400 hover:text-gray-600 transition-colors",
+                  _: "on click \r\n                     add .dialog-exit to .dialog-backdrop\r\n                     add .dialog-content-exit to .dialog-content\r\n                     wait 200ms\r\n                     set #dialog-container's innerHTML to '' end",
+                  children: /* @__PURE__ */ jsx(
+                    "svg",
+                    {
+                      className: "w-6 h-6",
+                      fill: "none",
+                      stroke: "currentColor",
+                      viewBox: "0 0 24 24",
+                      children: /* @__PURE__ */ jsx(
+                        "path",
+                        {
+                          strokeLinecap: "round",
+                          strokeLinejoin: "round",
+                          strokeWidth: 2,
+                          d: "M6 18L18 6M6 6l12 12"
+                        }
+                      )
+                    }
+                  )
+                }
+              )
+            ] }),
+            /* @__PURE__ */ jsx("div", { className: "flex-1 overflow-y-auto p-6 bg-gray-50", children })
+          ]
+        }
+      )
+    }
+  );
+};
+var ErrorAlert = (props) => {
+  const {
+    title,
+    message,
+    type = "error",
+    showClose = true,
+    className = ""
+  } = props;
+  const typeClasses = {
+    error: "bg-red-50 border-red-200 text-red-800",
+    warning: "bg-yellow-50 border-yellow-200 text-yellow-800",
+    info: "bg-blue-50 border-blue-200 text-blue-800",
+    success: "bg-green-50 border-green-200 text-green-800"
+  };
+  const iconColors = {
+    error: "text-red-400",
+    warning: "text-yellow-400",
+    info: "text-blue-400",
+    success: "text-green-400"
+  };
+  const icons = {
+    error: /* @__PURE__ */ jsx("svg", { className: "w-5 h-5", fill: "currentColor", viewBox: "0 0 20 20", children: /* @__PURE__ */ jsx(
+      "path",
+      {
+        fillRule: "evenodd",
+        d: "M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z",
+        clipRule: "evenodd"
+      }
+    ) }),
+    warning: /* @__PURE__ */ jsx("svg", { className: "w-5 h-5", fill: "currentColor", viewBox: "0 0 20 20", children: /* @__PURE__ */ jsx(
+      "path",
+      {
+        fillRule: "evenodd",
+        d: "M8.257 3.099c.765-1.36 2.722-1.36 3.486 0l5.58 9.92c.75 1.334-.213 2.98-1.742 2.98H4.42c-1.53 0-2.493-1.646-1.743-2.98l5.58-9.92zM11 13a1 1 0 11-2 0 1 1 0 012 0zm-1-8a1 1 0 00-1 1v3a1 1 0 002 0V6a1 1 0 00-1-1z",
+        clipRule: "evenodd"
+      }
+    ) }),
+    info: /* @__PURE__ */ jsx("svg", { className: "w-5 h-5", fill: "currentColor", viewBox: "0 0 20 20", children: /* @__PURE__ */ jsx(
+      "path",
+      {
+        fillRule: "evenodd",
+        d: "M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7-4a1 1 0 11-2 0 1 1 0 012 0zM9 9a1 1 0 000 2v3a1 1 0 001 1h1a1 1 0 100-2v-3a1 1 0 00-1-1H9z",
+        clipRule: "evenodd"
+      }
+    ) }),
+    success: /* @__PURE__ */ jsx("svg", { className: "w-5 h-5", fill: "currentColor", viewBox: "0 0 20 20", children: /* @__PURE__ */ jsx(
+      "path",
+      {
+        fillRule: "evenodd",
+        d: "M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z",
+        clipRule: "evenodd"
+      }
+    ) })
+  };
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: `border rounded-lg p-4 shadow-lg mb-2 ${typeClasses[type]} ${className} animate-[slideInRight_0.3s_ease-out]`,
+      role: "alert",
+      style: {
+        animation: "slideInRight 0.3s ease-out"
+      },
+      _: "on click if event.target is me or event.target.closest('button') \r\n         add .error-alert-exit to me\r\n         wait 300ms\r\n         remove me end",
+      children: /* @__PURE__ */ jsxs("div", { className: "flex items-start", children: [
+        /* @__PURE__ */ jsx("div", { className: `flex-shrink-0 ${iconColors[type]}`, children: icons[type] }),
+        /* @__PURE__ */ jsxs("div", { className: "ml-3 flex-1 min-w-0", children: [
+          title && /* @__PURE__ */ jsx("h3", { className: "text-sm font-medium mb-1", children: title }),
+          /* @__PURE__ */ jsx("div", { className: "text-sm break-words whitespace-pre-wrap", children: message })
+        ] }),
+        showClose && /* @__PURE__ */ jsx(
+          "button",
+          {
+            className: "ml-4 flex-shrink-0 text-gray-400 hover:text-gray-600 transition-colors",
+            type: "button",
+            children: /* @__PURE__ */ jsx(
+              "svg",
+              {
+                className: "w-5 h-5",
+                fill: "none",
+                stroke: "currentColor",
+                viewBox: "0 0 24 24",
+                children: /* @__PURE__ */ jsx(
+                  "path",
+                  {
+                    strokeLinecap: "round",
+                    strokeLinejoin: "round",
+                    strokeWidth: 2,
+                    d: "M6 18L18 6M6 6l12 12"
+                  }
+                )
+              }
+            )
+          }
+        )
+      ] })
+    }
+  );
+};
+var Breadcrumb = (props) => {
+  const { items } = props;
+  if (items.length === 0) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx("nav", { className: "flex", "aria-label": "Breadcrumb", children: /* @__PURE__ */ jsx("ol", { className: "flex items-center space-x-2", children: items.map((item, index) => /* @__PURE__ */ jsxs("li", { className: "flex items-center", children: [
+    index > 0 && /* @__PURE__ */ jsx(
+      "svg",
+      {
+        className: "w-5 h-5 text-gray-400 mx-2",
+        fill: "currentColor",
+        viewBox: "0 0 20 20",
+        children: /* @__PURE__ */ jsx(
+          "path",
+          {
+            fillRule: "evenodd",
+            d: "M7.293 14.707a1 1 0 010-1.414L10.586 10 7.293 6.707a1 1 0 011.414-1.414l4 4a1 1 0 010 1.414l-4 4a1 1 0 01-1.414 0z",
+            clipRule: "evenodd"
+          }
+        )
+      }
+    ),
+    item.href ? /* @__PURE__ */ jsx(
+      "a",
+      {
+        href: item.href,
+        className: "text-sm font-medium text-gray-500 hover:text-gray-700",
+        "hx-get": item.href,
+        "hx-push-url": "true",
+        children: item.label
+      }
+    ) : /* @__PURE__ */ jsx("span", { className: "text-sm font-medium text-gray-900", children: item.label })
+  ] }, index)) }) });
+};
+var Header = (props) => {
+  const { breadcrumbs = [], userInfo, sidebarCollapsed = false } = props;
+  return /* @__PURE__ */ jsx("header", { className: "bg-white border-b border-gray-200 shadow-sm sticky top-0 z-40", children: /* @__PURE__ */ jsx("div", { className: "px-6 py-4", children: /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-4 flex-1 min-w-0", children: [
+      /* @__PURE__ */ jsx(
+        "a",
+        {
+          className: "p-2 rounded-lg hover:bg-gray-100 transition-colors inline-block flex-shrink-0",
+          title: sidebarCollapsed ? "\u5C55\u5F00\u4FA7\u8FB9\u680F" : "\u6298\u53E0\u4FA7\u8FB9\u680F",
+          "hx-get": "",
+          children: sidebarCollapsed ? (
+            // 展开图标（向右箭头）
+            /* @__PURE__ */ jsx(
+              "svg",
+              {
+                className: "w-5 h-5 text-gray-600",
+                fill: "none",
+                stroke: "currentColor",
+                viewBox: "0 0 24 24",
+                children: /* @__PURE__ */ jsx(
+                  "path",
+                  {
+                    strokeLinecap: "round",
+                    strokeLinejoin: "round",
+                    strokeWidth: 2,
+                    d: "M9 5l7 7-7 7"
+                  }
+                )
+              }
+            )
+          ) : (
+            // 折叠图标（三条横线）
+            /* @__PURE__ */ jsx(
+              "svg",
+              {
+                className: "w-5 h-5 text-gray-600",
+                fill: "none",
+                stroke: "currentColor",
+                viewBox: "0 0 24 24",
+                children: /* @__PURE__ */ jsx(
+                  "path",
+                  {
+                    strokeLinecap: "round",
+                    strokeLinejoin: "round",
+                    strokeWidth: 2,
+                    d: "M4 6h16M4 12h16M4 18h16"
+                  }
+                )
+              }
+            )
+          )
+        }
+      ),
+      breadcrumbs.length > 0 && /* @__PURE__ */ jsx(Breadcrumb, { items: breadcrumbs })
+    ] }),
+    userInfo && /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 flex-shrink-0", children: [
+      /* @__PURE__ */ jsxs("div", { className: "text-right hidden sm:block", children: [
+        userInfo.name && /* @__PURE__ */ jsx("div", { className: "text-sm font-medium text-gray-900", children: userInfo.name }),
+        userInfo.email && /* @__PURE__ */ jsx("div", { className: "text-xs text-gray-500", children: userInfo.email })
+      ] }),
+      userInfo.avatar ? /* @__PURE__ */ jsx(
+        "img",
+        {
+          src: userInfo.avatar,
+          alt: userInfo.name || "\u7528\u6237",
+          className: "w-8 h-8 rounded-full"
+        }
+      ) : /* @__PURE__ */ jsx("div", { className: "w-8 h-8 rounded-full bg-blue-600 flex items-center justify-center text-white text-sm font-medium", children: (userInfo.name || userInfo.email || "U").charAt(0).toUpperCase() })
+    ] })
+  ] }) }) });
+};
+var LoadingBar = () => {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        id: "loading-bar",
+        className: "fixed top-0 left-0 right-0 h-1 bg-transparent z-50 opacity-0 transition-opacity duration-200",
+        children: /* @__PURE__ */ jsx("div", { className: "h-full bg-gradient-to-r from-blue-500 via-blue-600 to-blue-500 loading-bar-progress" })
+      }
+    ),
+    /* @__PURE__ */ jsx("style", { children: `
+          @keyframes loading-progress {
+            0% { transform: translateX(-100%); width: 0%; }
+            50% { width: 70%; }
+            100% { transform: translateX(100%); width: 100%; }
+          }
+          #loading-bar.htmx-request {
+            opacity: 1 !important;
+          }
+          #loading-bar.htmx-request .loading-bar-progress {
+            animation: loading-progress 1.5s ease-in-out infinite;
+          }
+        ` })
+  ] });
+};
+function renderNavItem(item, currentPath, collapsed = false, isChild = false) {
+  const isActive = currentPath === item.href || currentPath && currentPath.startsWith(item.href + "/");
+  const hasActiveChild = item.children?.some(
+    (child) => currentPath === child.href || currentPath && currentPath.startsWith(child.href + "/")
+  );
+  const navItemId = `nav-item-${item.href.replace(/[^a-zA-Z0-9]/g, "-")}`;
+  return /* @__PURE__ */ jsxs("li", { id: navItemId, className: "relative group", children: [
+    /* @__PURE__ */ jsxs(
+      "a",
+      {
+        href: item.href,
+        className: `flex items-center ${collapsed ? "justify-center px-2" : "px-4"} py-2 rounded-lg transition-colors ${isActive || hasActiveChild ? "bg-blue-600 text-white shadow-md" : "text-gray-300 hover:bg-gray-700 hover:text-white"}`,
+        "hx-get": item.href,
+        "hx-push-url": "true",
+        title: collapsed ? item.label : void 0,
+        children: [
+          item.icon && /* @__PURE__ */ jsx("span", { className: collapsed ? "" : "mr-2", children: item.icon }),
+          !collapsed && /* @__PURE__ */ jsx("span", { className: "whitespace-nowrap overflow-hidden text-ellipsis", children: item.label })
+        ]
+      }
+    ),
+    collapsed && /* @__PURE__ */ jsxs("div", { className: "absolute left-full ml-2 px-3 py-2 bg-gray-900 text-white text-sm rounded-lg shadow-lg opacity-0 invisible group-hover:opacity-100 group-hover:visible transition-all duration-200 pointer-events-none z-50 whitespace-nowrap", children: [
+      item.label,
+      /* @__PURE__ */ jsx("div", { className: "absolute right-full top-1/2 -translate-y-1/2 border-4 border-transparent border-r-gray-900" })
+    ] }),
+    !collapsed && item.children && item.children.length > 0 && /* @__PURE__ */ jsx("ul", { className: "ml-4 mt-1 space-y-1", children: item.children.map((child) => {
+      const isChildActive = currentPath === child.href || currentPath && currentPath.startsWith(child.href + "/");
+      const childNavItemId = `nav-item-${child.href.replace(/[^a-zA-Z0-9]/g, "-")}`;
+      return /* @__PURE__ */ jsx(
+        "li",
+        {
+          id: childNavItemId,
+          className: "relative group",
+          children: /* @__PURE__ */ jsxs(
+            "a",
+            {
+              href: child.href,
+              className: `flex items-center px-4 py-2 rounded-lg text-sm transition-colors ${isChildActive ? "bg-blue-500 text-white" : "text-gray-400 hover:bg-gray-700 hover:text-white"}`,
+              "hx-get": child.href,
+              "hx-push-url": "true",
+              children: [
+                child.icon && /* @__PURE__ */ jsx("span", { className: "mr-2", children: child.icon }),
+                /* @__PURE__ */ jsx("span", { className: "whitespace-nowrap overflow-hidden text-ellipsis", children: child.label })
+              ]
+            }
+          )
+        },
+        child.href
+      );
+    }) })
+  ] }, item.href);
+}
+var BaseLayout = (props) => {
+  return /* @__PURE__ */ jsxs("html", { children: [
+    /* @__PURE__ */ jsxs("head", { children: [
+      /* @__PURE__ */ jsx("meta", { charset: "UTF-8" }),
+      /* @__PURE__ */ jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
+      /* @__PURE__ */ jsx("title", { children: props.title }),
+      props.description && /* @__PURE__ */ jsx("meta", { name: "description", content: props.description }),
+      /* @__PURE__ */ jsx("script", { src: "https://unpkg.com/htmx.org@latest" }),
+      /* @__PURE__ */ jsx("script", { src: "https://unpkg.com/hyperscript.org@latest" }),
+      /* @__PURE__ */ jsx("script", { src: "https://cdn.tailwindcss.com" }),
+      /* @__PURE__ */ jsx(
+        "style",
+        {
+          dangerouslySetInnerHTML: {
+            __html: `
+          @keyframes fadeIn {
+            from { opacity: 0;}
+            to { opacity: 1;}
+          }
+          
+          @keyframes slideIn {
+            from { opacity: 0; transform: scale(0.95) translateY(-10px); }
+            to { opacity: 1; transform: scale(1) translateY(0); }
+          }
+          
+          @keyframes slideInRight {
+            from { opacity: 0; transform: translateX(100%); }
+            to { opacity: 1; transform: translateX(0); }
+          }
+          
+          @keyframes slideOutRight {
+            from { opacity: 1; transform: translateX(0); }
+            to { opacity: 0; transform: translateX(100%); }
+          }
+          
+          @keyframes fadeOut {
+            from { opacity: 1; }
+            to { opacity: 0; }
+          }
+          
+          @keyframes scaleOut {
+            from { opacity: 1; transform: scale(1) translateY(0); } 
+            to { opacity: 0; transform: scale(0.95) translateY(-10px); }
+          }
+          
+          /* Dialog \u9000\u51FA\u52A8\u753B */
+          .dialog-exit {
+            animation: fadeOut 0.2s ease-in forwards !important;
+          }
+          
+          .dialog-content-exit {
+            animation: scaleOut 0.2s ease-in forwards !important;
+          }
+          
+          /* ErrorAlert \u9000\u51FA\u52A8\u753B */
+          .error-alert-exit {
+            animation: slideOutRight 0.3s ease-in forwards, fadeOut 0.3s ease-in forwards;
+          }
+        `
+          }
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs(
+      "body",
+      {
+        className: "bg-gray-50",
+        "hx-indicator": "#loading-bar",
+        "hx-target": "#main-content",
+        "hx-swap": "outerHTML",
+        children: [
+          /* @__PURE__ */ jsx(LoadingBar, {}),
+          props.children,
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              id: "error-container",
+              className: "fixed top-4 right-4 z-[200] w-full max-w-2xl px-4"
+            }
+          ),
+          /* @__PURE__ */ jsx("div", { id: "dialog-container" })
+        ]
+      }
+    )
+  ] });
+};
+var AdminLayout = (props) => {
+  const logo = props.adminContext.pluginOptions.logo;
+  const navItems = props.adminContext.pluginOptions.navigation;
+  const referer = props.adminContext.ctx.req.header("Referer");
+  let currentPath = props.adminContext.ctx.req.path;
+  if (referer) {
+    try {
+      const refererUrl = new URL(referer);
+      const method = props.adminContext.ctx.req.method;
+      if (["POST", "PUT", "DELETE"].includes(method)) {
+        currentPath = refererUrl.pathname;
+      }
+    } catch (e) {
+    }
+  }
+  const sidebarCollapsed = props.sidebarCollapsed || false;
+  const breadcrumbs = props.adminContext.breadcrumbs;
+  const userInfo = props.adminContext.userInfo;
+  return /* @__PURE__ */ jsxs("div", { className: "flex h-screen", id: "main-content", children: [
+    /* @__PURE__ */ jsx(
+      "aside",
+      {
+        className: `${props.sidebarCollapsed ? "w-16" : "w-64"} bg-gradient-to-b from-gray-900 to-gray-800 text-white shadow-lg transition-all duration-300 ease-in-out overflow-hidden`,
+        children: /* @__PURE__ */ jsxs("div", { className: `${props.sidebarCollapsed ? "p-2" : "p-6"}`, children: [
+          !props.sidebarCollapsed && /* @__PURE__ */ jsx(Fragment, { children: logo ? /* @__PURE__ */ jsx("img", { src: logo, alt: "Logo", className: "h-10 mb-6" }) : /* @__PURE__ */ jsx("h1", { className: "text-xl font-bold mb-6 text-white whitespace-nowrap overflow-hidden text-ellipsis", children: props.adminContext.pluginOptions.title }) }),
+          /* @__PURE__ */ jsx("nav", { children: /* @__PURE__ */ jsx("ul", { className: "space-y-1", children: navItems && navItems.length > 0 ? navItems.map(
+            (item) => renderNavItem(
+              item,
+              currentPath,
+              props.sidebarCollapsed || false
+            )
+          ) : /* @__PURE__ */ jsx(
+            "li",
+            {
+              className: `${props.sidebarCollapsed ? "px-2" : "px-4"} py-2 text-gray-400 text-sm`,
+              children: "\u6682\u65E0\u5BFC\u822A\u9879"
+            }
+          ) }) })
+        ] })
+      }
+    ),
+    /* @__PURE__ */ jsxs("div", { className: "flex-1 flex flex-col overflow-hidden", children: [
+      /* @__PURE__ */ jsx(
+        Header,
+        {
+          breadcrumbs,
+          userInfo,
+          sidebarCollapsed: sidebarCollapsed || false
+        }
+      ),
+      /* @__PURE__ */ jsx("main", { className: "flex-1 overflow-auto bg-gray-50", children: /* @__PURE__ */ jsx("div", { className: "p-6", children: props.children }) })
+    ] })
+  ] });
+};
+
+// src/utils/context.tsx
+var HtmxAdminContext = class {
+  /** 模块元数据 */
+  moduleMetadata;
+  /** 插件选项 */
+  pluginOptions;
+  /** Hono Context */
+  ctx;
+  /** 之前的模块名 */
+  previousModuleName;
+  /** 是否是片段请求（HTMX 请求） */
+  isFragment;
+  /** 是否是对话框请求 */
+  isDialog;
+  /** 用户信息 */
+  userInfo;
+  /** 通知队列 */
+  notifications = [];
+  /** 页面标题（用于 HX-Title 和页面展示） */
+  title = "";
+  /** 页面描述（用于SEO和页面展示） */
+  description = "";
+  /** 面包屑项 */
+  breadcrumbs = [];
+  /** 主要内容 */
+  content = null;
+  /** 需要重定向的 URL */
+  redirectUrl;
+  /** 是否需要刷新页面（用于 HX-Refresh） */
+  refresh = false;
+  constructor(ctx, userInfo, moduleMetadata, pluginOptions) {
+    this.ctx = ctx;
+    this.userInfo = userInfo;
+    this.moduleMetadata = moduleMetadata;
+    this.pluginOptions = pluginOptions;
+    const url = new URL(ctx.req.url);
+    this.isFragment = ctx.req.header("HX-Request") === "true";
+    this.isDialog = url.searchParams.get("dialog") === "true" || ctx.req.header("HX-Target") === "#dialog-container" || (ctx.req.header("Referer") || "").includes("dialog=true");
+    const referer = ctx.req.header("Referer");
+    this.previousModuleName = referer ? new URL(referer).pathname.replace(pluginOptions.prefix, "").split("/").pop() : void 0;
+  }
+  /**
+   * 发送通知
+   * 通知将在响应时通过 OOB 更新到错误容器
+   */
+  sendNotification(type, title, message) {
+    this.notifications.push({ type, title, message });
+  }
+  /**
+   * 发送错误通知（便捷方法）
+   */
+  sendError(title, message) {
+    this.sendNotification("error", title, message);
+  }
+  /**
+   * 发送警告通知（便捷方法）
+   */
+  sendWarning(title, message) {
+    this.sendNotification("warning", title, message);
+  }
+  /**
+   * 发送信息通知（便捷方法）
+   */
+  sendInfo(title, message) {
+    this.sendNotification("info", title, message);
+  }
+  /**
+   * 发送成功通知（便捷方法）
+   */
+  sendSuccess(title, message) {
+    this.sendNotification("success", title, message);
+  }
+  /**
+   * 设置需要推送的 URL
+   * 用于 HX-Push-Url 响应头
+   */
+  redirect(url) {
+    this.redirectUrl = url;
+  }
+  /**
+   * 设置需要刷新页面
+   * 用于 HX-Refresh 响应头
+   */
+  setRefresh(refresh = true) {
+    this.refresh = refresh;
+  }
+  /**
+   * 检查是否有列表页面
+   * 封装 moduleMetadata 访问，避免直接访问内部属性
+   */
+  hasList() {
+    return this.moduleMetadata.hasList;
+  }
+  /**
+   * 检查是否有详情页面
+   * 封装 moduleMetadata 访问，避免直接访问内部属性
+   */
+  hasDetail() {
+    return this.moduleMetadata.hasDetail;
+  }
+  /**
+   * 检查是否有表单页面
+   * 封装 moduleMetadata 访问，避免直接访问内部属性
+   */
+  hasForm() {
+    return this.moduleMetadata.hasForm;
+  }
+  /**
+   * 检查是否有自定义页面
+   * 封装 moduleMetadata 访问，避免直接访问内部属性
+   */
+  hasCustom() {
+    return this.moduleMetadata.hasCustom;
+  }
+};
+var RouteHandler = class {
+  moduleClass;
+  pluginOptions;
+  moduleMetadata;
+  moduleOptions;
+  constructor(options) {
+    this.moduleClass = options.moduleClass;
+    this.pluginOptions = options.pluginOptions;
+    this.moduleMetadata = options.moduleMetadata;
+    this.moduleOptions = options.moduleOptions;
+  }
+  /**
+   * 更新模块元数据
+   */
+  setModuleMetadata(moduleMetadata) {
+    this.moduleMetadata = moduleMetadata;
+  }
+  /**
+   * 处理请求的唯一对外接口
+   */
+  async handle(ctx) {
+    try {
+      const userInfo = await this.pluginOptions.getUserInfo(ctx);
+      const adminContext = this.createAdminContext(ctx, userInfo);
+      const moduleInstance = new this.moduleClass();
+      moduleInstance.__init(adminContext);
+      try {
+        adminContext.content = await moduleInstance.__handle();
+        adminContext.title = moduleInstance.getTitle();
+        adminContext.description = moduleInstance.getDescription();
+        adminContext.breadcrumbs = moduleInstance.getBreadcrumbs();
+      } catch (error) {
+        this.handleError(adminContext, error);
+      }
+      if (!adminContext.isFragment) {
+        return this.renderFullPage(ctx, adminContext);
+      } else {
+        return this.renderFragment(ctx, adminContext);
+      }
+    } catch (error) {
+      return ctx.html(
+        /* @__PURE__ */ jsxs("div", { className: "text-red-500 p-4", children: [
+          /* @__PURE__ */ jsx("p", { className: "font-semibold", children: "\u9519\u8BEF" }),
+          /* @__PURE__ */ jsx("p", { children: error instanceof Error ? error.message : String(error) })
+        ] }),
+        500
+      );
+    }
+  }
+  renderFullPage(ctx, adminContext) {
+    const useAdminLayout = this.moduleOptions.useAdminLayout !== false;
+    return ctx.html(
+      /* @__PURE__ */ jsx(
+        BaseLayout,
+        {
+          title: adminContext.title,
+          description: adminContext.description,
+          children: useAdminLayout ? /* @__PURE__ */ jsx(AdminLayout, { adminContext, sidebarCollapsed: false, children: adminContext.content }) : /* @__PURE__ */ jsx("div", { id: "main-content", children: adminContext.content })
+        }
+      )
+    );
+  }
+  renderFragment(ctx, adminContext) {
+    if (adminContext.redirectUrl) {
+      return ctx.redirect(adminContext.redirectUrl);
+    }
+    const target = adminContext.isDialog ? "#dialog-container" : "#main-content";
+    const swap = adminContext.isDialog ? "innerHTML" : "outerHTML";
+    const fragments = [
+      // 通知变动 - 使用 OOB swap 到 error-container
+      adminContext.notifications.map((notification, index) => {
+        return /* @__PURE__ */ jsx(
+          "div",
+          {
+            id: "error-container",
+            "hx-swap-oob": "beforeend",
+            children: /* @__PURE__ */ jsx(
+              ErrorAlert,
+              {
+                type: notification.type,
+                title: notification.title,
+                message: notification.message
+              }
+            )
+          },
+          `notification-${index}`
+        );
+      }),
+      /* @__PURE__ */ jsx("title", { children: adminContext.title })
+    ];
+    const headers = {
+      "HX-Retarget": target,
+      "HX-Reswap": swap
+    };
+    if (!adminContext.isDialog) {
+      const url = new URL(adminContext.ctx.req.url);
+      if (url.search) {
+        headers["HX-Push-Url"] = url.pathname + "?" + url.search;
+      } else {
+        headers["HX-Push-Url"] = url.pathname;
+      }
+    }
+    if (adminContext.refresh) {
+      headers["HX-Refresh"] = "true";
+      if (adminContext.isDialog) {
+        return ctx.html(
+          /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx(
+              "div",
+              {
+                id: "dialog-container",
+                "hx-swap-oob": "innerHTML"
+              }
+            ),
+            fragments
+          ] }),
+          200,
+          headers
+        );
+      }
+      return ctx.html(/* @__PURE__ */ jsx("div", {}), 200, headers);
+    }
+    const useAdminLayout = this.moduleOptions.useAdminLayout !== false;
+    return ctx.html(
+      /* @__PURE__ */ jsxs(Fragment, { children: [
+        adminContext.isDialog ? (
+          // Dialog 会被插入到 #dialog-container 中（使用 innerHTML）
+          /* @__PURE__ */ jsx(Dialog, { title: adminContext.title, size: "lg", children: adminContext.content })
+        ) : useAdminLayout ? (
+          // AdminLayout 会被替换整个 #main-content（使用 outerHTML）
+          /* @__PURE__ */ jsx(AdminLayout, { adminContext, sidebarCollapsed: false, children: adminContext.content })
+        ) : (
+          // 不使用 AdminLayout 时，替换 #main-content 容器（使用 outerHTML）
+          /* @__PURE__ */ jsx("div", { id: "main-content", children: adminContext.content })
+        ),
+        fragments
+      ] }),
+      200,
+      headers
+    );
+  }
+  /**
+   * 创建 HtmxAdminContext
+   */
+  createAdminContext(ctx, userInfo) {
+    return new HtmxAdminContext(
+      ctx,
+      userInfo,
+      this.moduleMetadata,
+      this.pluginOptions
+    );
+  }
+  /**
+   * 统一错误处理
+   */
+  handleError(adminContext, error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    adminContext.content = /* @__PURE__ */ jsxs("div", { className: "text-red-500 p-4", children: [
+      /* @__PURE__ */ jsx("p", { className: "font-semibold", children: "\u9519\u8BEF" }),
+      /* @__PURE__ */ jsx("p", { children: errorMessage })
+    ] });
+    adminContext.notifications.push({
+      type: "error",
+      title: "\u9519\u8BEF",
+      message: errorMessage
+    });
+  }
+};
+
+// src/utils/module.ts
+function isListPageModule(moduleClass) {
+  if (!moduleClass || !moduleClass.prototype) {
+    return false;
+  }
+  let proto = moduleClass.prototype;
+  while (proto) {
+    if (proto.constructor === ListPageModule) {
+      return true;
+    }
+    proto = Object.getPrototypeOf(proto);
+    if (!proto) {
+      break;
+    }
+  }
+  return false;
+}
+function isDetailPageModule(moduleClass) {
+  if (!moduleClass || !moduleClass.prototype) {
+    return false;
+  }
+  let proto = moduleClass.prototype;
+  while (proto) {
+    if (proto.constructor === DetailPageModule) {
+      return true;
+    }
+    proto = Object.getPrototypeOf(proto);
+    if (!proto) {
+      break;
+    }
+  }
+  return false;
+}
+function isFormPageModule(moduleClass) {
+  if (!moduleClass || !moduleClass.prototype) {
+    return false;
+  }
+  let proto = moduleClass.prototype;
+  while (proto) {
+    if (proto.constructor === FormPageModule) {
+      return true;
+    }
+    proto = Object.getPrototypeOf(proto);
+    if (!proto) {
+      break;
+    }
+  }
+  return false;
+}
+function isPageModule(moduleClass) {
+  if (!moduleClass || !moduleClass.prototype) {
+    return false;
+  }
+  let proto = moduleClass.prototype;
+  while (proto) {
+    if (proto.constructor === PageModule) {
+      return true;
+    }
+    proto = Object.getPrototypeOf(proto);
+    if (!proto) {
+      break;
+    }
+  }
+  return false;
+}
+
+// src/plugin.tsx
+var HtmxAdminPlugin = class {
+  name = "htmx-admin-plugin";
+  priority = PluginPriority.ROUTE;
+  engine;
+  hono;
+  options;
+  // 模块类映射（记录每个模块的类）
+  moduleTypeMap = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.options = {
+      title: options?.title || "\u7BA1\u7406\u540E\u53F0",
+      logo: options?.logo || "",
+      prefix: options?.prefix || "/admin",
+      homePath: options?.homePath || "",
+      navigation: options?.navigation ?? [],
+      getUserInfo: options?.getUserInfo ?? (() => null)
+    };
+  }
+  /**
+   * 声明Module配置Schema
+   */
+  getModuleOptionsSchema() {
+    return {
+      _type: {},
+      validate: (options) => {
+        if (!options.type) {
+          return "Module type is required";
+        }
+        return true;
+      }
+    };
+  }
+  /**
+   * 引擎初始化钩子
+   */
+  onInit(engine) {
+    this.engine = engine;
+    this.hono = engine.getHono();
+    logger.info("HtmxAdminPlugin initialized");
+  }
+  /**
+   * 检查并注册模块
+   */
+  checkAndRegisterModules(modules) {
+    modules = modules.filter(
+      (module) => module.clazz instanceof PageModule || module.clazz.prototype instanceof PageModule
+    );
+    for (const module of modules) {
+      const options = module.options;
+      const moduleClass = module.clazz;
+      if (!this.options.homePath) {
+        this.options.homePath = `${this.options.prefix}${moduleNameToPath(module.name)}`;
+      }
+      if (options.type === "list") {
+        if (!isListPageModule(moduleClass)) {
+          throw new Error(
+            `Module ${module.name} is of type "list" but does not extend ListPageModule. Please extend ListPageModule to customize list behavior.`
+          );
+        }
+      } else if (options.type === "detail") {
+        if (!isDetailPageModule(moduleClass)) {
+          throw new Error(
+            `Module ${module.name} is of type "detail" but does not extend DetailPageModule. Please extend DetailPageModule to customize detail behavior.`
+          );
+        }
+      } else if (options.type === "form") {
+        if (!isFormPageModule(moduleClass)) {
+          throw new Error(
+            `Module ${module.name} is of type "form" but does not extend FormPageModule. Please extend FormPageModule to customize form behavior.`
+          );
+        }
+      } else if (options.type === "custom") {
+        if (!isPageModule(moduleClass)) {
+          throw new Error(
+            `Module ${module.name} is of type "custom" but does not extend PageModule. Please extend PageModule to customize page rendering.`
+          );
+        }
+      } else {
+        throw new Error(
+          `Module ${module.name} has an invalid type: ${options.type}. Please use one of the following types: "list", "detail", "form", "custom".`
+        );
+      }
+      let metadata = this.moduleTypeMap.get(module.name);
+      if (!metadata) {
+        this.moduleTypeMap.set(module.name, {});
+        metadata = this.moduleTypeMap.get(module.name);
+      }
+      if (!metadata[options.type]) {
+        metadata[options.type] = {
+          class: moduleClass,
+          options
+        };
+      } else {
+        throw new Error(
+          `Module ${module.name} already has a ${options.type} module. Please use a different name.`
+        );
+      }
+    }
+  }
+  /**
+   * 注册路由
+   */
+  registerRoutes() {
+    const moduleNames = Array.from(this.moduleTypeMap.keys());
+    for (const moduleName of moduleNames) {
+      const moduleTypes = this.moduleTypeMap.get(moduleName);
+      const basePath = `${this.options.prefix}${moduleNameToPath(moduleName)}`;
+      for (const type in moduleTypes) {
+        const moduleInfo = moduleTypes[type];
+        const routeHandler = new RouteHandler({
+          moduleClass: moduleInfo.class,
+          moduleName,
+          basePath,
+          moduleOptions: moduleInfo.options,
+          pluginOptions: this.options,
+          moduleMetadata: {
+            hasList: !!moduleTypes["list"],
+            hasDetail: !!moduleTypes["detail"],
+            hasForm: !!moduleTypes["form"],
+            hasCustom: !!moduleTypes["custom"],
+            basePath,
+            title: moduleInfo.options.title ?? moduleName,
+            description: moduleInfo.options.description ?? ""
+          }
+        });
+        const routeConfig = {
+          list: [{ method: "get", path: `${basePath}/list` }],
+          detail: [{ method: "get", path: `${basePath}/detail/:id` }],
+          form: [
+            { method: "get", path: `${basePath}/new` },
+            { method: "get", path: `${basePath}/edit/:id` },
+            { method: "post", path: basePath },
+            { method: "put", path: `${basePath}/:id` },
+            { method: "delete", path: `${basePath}/:id` }
+          ],
+          custom: [{ method: "get", path: basePath }]
+        };
+        const routes = routeConfig[type];
+        for (const route of routes) {
+          logger.info(
+            `[HtmxAdminPlugin] Registering ${type} route: ${route.method.toUpperCase()} ${route.path}`
+          );
+          const handler = async (ctx) => routeHandler.handle(ctx);
+          this.hono[route.method](route.path, handler);
+        }
+      }
+    }
+  }
+  /**
+   * 模块加载钩子：检查模块类型约束并注册路由
+   */
+  onModuleLoad(modules) {
+    this.checkAndRegisterModules(modules);
+    this.registerRoutes();
+    this.engine.getHono().get(this.options.prefix, async (ctx) => {
+      return ctx.redirect(this.options.homePath);
+    });
+  }
+};
+
+// src/components/index.ts
+var components_exports = {};
+__export(components_exports, {
+  ActionButton: () => ActionButton,
+  ActivityCard: () => ActivityCard,
+  Badge: () => Badge,
+  Button: () => Button,
+  Card: () => Card,
+  DateInput: () => DateInput,
+  Detail: () => Detail,
+  DetailContent: () => DetailContent,
+  Dialog: () => Dialog,
+  EmptyState: () => EmptyState,
+  ErrorAlert: () => ErrorAlert,
+  FilterCard: () => FilterCard,
+  Form: () => Form,
+  FormField: () => FormField,
+  Input: () => Input,
+  ListContent: () => ListContent,
+  PageHeader: () => PageHeader,
+  Pagination: () => Pagination,
+  Select: () => Select,
+  StatCard: () => StatCard,
+  SystemStatusCard: () => SystemStatusCard,
+  Textarea: () => Textarea
+});
+var ActivityCard = (props) => {
+  const { title, activities, className = "" } = props;
+  const colorClasses = {
+    blue: "bg-blue-500",
+    green: "bg-green-500",
+    purple: "bg-purple-500",
+    gray: "bg-gray-500",
+    yellow: "bg-yellow-500",
+    red: "bg-red-500"
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: `bg-white rounded-lg shadow-sm p-6 hover:shadow-md transition-shadow ${className}`,
+      children: [
+        /* @__PURE__ */ jsx("h3", { className: "text-lg font-semibold text-gray-900 mb-4", children: title }),
+        /* @__PURE__ */ jsx("div", { className: "space-y-4", children: activities.length > 0 ? activities.map((activity, index) => /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-3", children: [
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: `flex-shrink-0 w-2 h-2 rounded-full mt-2 ${colorClasses[activity.color || "gray"]}`
+            }
+          ),
+          /* @__PURE__ */ jsxs("div", { className: "flex-1 min-w-0", children: [
+            /* @__PURE__ */ jsx("p", { className: "text-sm text-gray-900", children: activity.description }),
+            /* @__PURE__ */ jsx("p", { className: "text-xs text-gray-500 mt-1", children: activity.time })
+          ] })
+        ] }, index)) : /* @__PURE__ */ jsx("p", { className: "text-sm text-gray-500 text-center py-4", children: "\u6682\u65E0\u6D3B\u52A8\u8BB0\u5F55" }) })
+      ]
+    }
+  );
+};
+var Badge = (props) => {
+  const { children, variant = "gray", className = "" } = props;
+  const variantClasses = {
+    blue: "bg-blue-100 text-blue-800",
+    green: "bg-green-100 text-green-800",
+    yellow: "bg-yellow-100 text-yellow-800",
+    red: "bg-red-100 text-red-800",
+    gray: "bg-gray-100 text-gray-800",
+    purple: "bg-purple-100 text-purple-800",
+    indigo: "bg-indigo-100 text-indigo-800"
+  };
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      className: `inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium ${variantClasses[variant]} ${className}`,
+      children
+    }
+  );
+};
+var SystemStatusCard = (props) => {
+  const { title, statusItems, className = "" } = props;
+  const progressColorClasses = {
+    blue: "bg-blue-500",
+    green: "bg-green-500",
+    orange: "bg-orange-500",
+    red: "bg-red-500",
+    purple: "bg-purple-500",
+    yellow: "bg-yellow-500"
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: `bg-white rounded-lg shadow-sm p-6 hover:shadow-md transition-shadow ${className}`,
+      children: [
+        /* @__PURE__ */ jsx("h3", { className: "text-lg font-semibold text-gray-900 mb-4", children: title }),
+        /* @__PURE__ */ jsx("div", { className: "space-y-4", children: statusItems.map((item, index) => /* @__PURE__ */ jsxs("div", { children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between mb-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "text-sm font-medium text-gray-700", children: item.label }),
+            item.isText ? /* @__PURE__ */ jsx(
+              "span",
+              {
+                className: `text-sm font-medium ${item.value === "\u6B63\u5E38" || item.value === "Normal" ? "text-green-600" : "text-gray-900"}`,
+                children: item.value
+              }
+            ) : /* @__PURE__ */ jsx("span", { className: "text-sm font-medium text-gray-900", children: typeof item.value === "number" ? `${item.value}%` : item.value })
+          ] }),
+          !item.isText && item.progress !== void 0 && /* @__PURE__ */ jsx("div", { className: "w-full bg-gray-200 rounded-full h-2 overflow-hidden", children: /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: `h-full rounded-full transition-all duration-300 ${progressColorClasses[item.color || "blue"]}`,
+              style: {
+                width: `${Math.min(100, Math.max(0, item.progress))}%`
+              }
+            }
+          ) })
+        ] }, index)) })
+      ]
+    }
+  );
+};
+
+export { components_exports as Components, DetailPageModule, FormPageModule, HtmxAdminPlugin, ListPageModule, MemoryListDatasource, PageModule, PathHelper, generateFormFieldsFromSchema, safeRender, validateFormDataWithSchema };