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

package/dist/index.js

@@ -149,6 +149,146 @@ var init_cdn_cache = __esm({
     cache = /* @__PURE__ */ new Map();
   }
 });
+
+// src/feature-registry.ts
+var FeatureRegistry = class {
+  features = /* @__PURE__ */ new Map();
+  model;
+  constructor(model) {
+    this.model = model;
+  }
+  /**
+   * 注册 Feature
+   */
+  register(name, feature) {
+    this.features.set(name, feature);
+  }
+  /**
+   * 快捷方法：注册列表 Feature
+   */
+  list(feature) {
+    this.register("list", feature);
+  }
+  /**
+   * 快捷方法：注册详情 Feature
+   */
+  detail(feature) {
+    this.register("detail", feature);
+  }
+  /**
+   * 快捷方法：注册创建 Feature
+   */
+  create(feature) {
+    this.register("create", feature);
+  }
+  /**
+   * 快捷方法：注册编辑 Feature
+   */
+  edit(feature) {
+    this.register("edit", feature);
+  }
+  /**
+   * 快捷方法：注册删除 Feature
+   */
+  delete(feature) {
+    this.register("delete", feature);
+  }
+  /**
+   * 快捷方法：注册自定义 Feature
+   */
+  custom(name, feature) {
+    this.register(name, feature);
+  }
+  /**
+   * 获取所有注册的 Feature
+   */
+  getAll() {
+    return Array.from(this.features.values());
+  }
+  /**
+   * 获取指定 Feature
+   */
+  get(name) {
+    return this.features.get(name);
+  }
+};
+
+// src/page-model.ts
+var PageModel = class {
+  modelName;
+  features;
+  metadata;
+  /**
+   * 构造函数
+   * @param modelName 模型/页面名称（用于路由和权限）
+   * @param metadata 页面元数据（可选，如果提供则不需要实现 getMetadata）
+   */
+  constructor(modelName, metadata) {
+    this.modelName = modelName;
+    this.metadata = metadata || {
+      title: modelName,
+      description: "",
+      useAdminLayout: true
+    };
+    this.features = new FeatureRegistry(this);
+  }
+  /**
+   * 获取页面元数据
+   * 如果构造函数提供了 metadata，直接返回
+   * 否则调用子类实现
+   */
+  getMetadata() {
+    return this.metadata;
+  }
+};
+
+// src/features/base-feature.ts
+var BaseFeature = class {
+  /** Feature 名称 */
+  name;
+  /** Feature 类型 */
+  type;
+  /** 所需权限（格式：modelName.featureName 或自定义，null 表示开放访问） */
+  permission;
+  /** 弹窗大小（当 Feature 在弹窗中打开时使用，默认 "lg"） */
+  dialogSize;
+  /** 是否允许点击遮罩区域关闭弹窗（默认 true，设置为 false 时只能通过关闭按钮关闭） */
+  closeOnBackdropClick;
+  /** Schema（可选，由子类在构造函数中设置） */
+  schema;
+  /** 解析后的字段列表（可选，由子类在构造函数中设置） */
+  fields;
+  constructor(options) {
+    this.name = options.name;
+    this.type = options.type;
+    this.permission = options.permission;
+    this.dialogSize = options.dialogSize;
+    this.closeOnBackdropClick = options.closeOnBackdropClick;
+  }
+  /**
+   * 获取动态标题（默认实现：返回 PageMetadata 的 title）
+   * 子类可以覆盖此方法以提供动态标题
+   */
+  async getTitle(context) {
+    const metadata = context.model.getMetadata();
+    return metadata.title;
+  }
+  /**
+   * 获取动态描述（默认实现：返回 PageMetadata 的 description）
+   * 子类可以覆盖此方法以提供动态描述
+   */
+  async getDescription(context) {
+    const metadata = context.model.getMetadata();
+    return metadata.description;
+  }
+  /**
+   * 获取操作按钮（默认实现：返回空数组）
+   * 子类可以覆盖此方法以提供操作按钮
+   */
+  async getActions(context) {
+    return [];
+  }
+};
 function getFieldValue(field, initialData) {
   if (initialData && Object.prototype.hasOwnProperty.call(initialData, field.name)) {
     const value = initialData[field.name];
@@ -295,49 +435,187 @@ function FormPage(props) {
   ) });
 }
 
-// src/features/base-feature.ts
-var BaseFeature = class {
-  /** Feature 名称 */
-  name;
-  /** Feature 类型 */
-  type;
-  /** 所需权限（格式：modelName.featureName 或自定义，null 表示开放访问） */
-  permission;
-  /** 弹窗大小（当 Feature 在弹窗中打开时使用，默认 "lg"） */
-  dialogSize;
-  /** 是否允许点击遮罩区域关闭弹窗（默认 true，设置为 false 时只能通过关闭按钮关闭） */
-  closeOnBackdropClick;
-  constructor(options) {
-    this.name = options.name;
-    this.type = options.type;
-    this.permission = options.permission;
-    this.dialogSize = options.dialogSize;
-    this.closeOnBackdropClick = options.closeOnBackdropClick;
+// src/utils/schema-utils.ts
+function parseSchemaToFields(schema) {
+  const def = schema._def;
+  const shape = typeof def.shape === "function" ? def.shape() : def.shape;
+  if (!shape || typeof shape !== "object") {
+    return [];
   }
-  /**
-   * 获取动态标题（默认实现：返回 PageMetadata 的 title）
-   * 子类可以覆盖此方法以提供动态标题
-   */
-  async getTitle(context) {
-    const metadata = context.model.getMetadata();
-    return metadata.title;
+  const fields = [];
+  for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+    if (["id", "createdAt", "updatedAt"].includes(fieldName)) {
+      continue;
+    }
+    const field = parseFieldSchema(fieldName, fieldSchema);
+    if (field) {
+      fields.push(field);
+    }
   }
-  /**
-   * 获取动态描述（默认实现：返回 PageMetadata 的 description）
-   * 子类可以覆盖此方法以提供动态描述
-   */
-  async getDescription(context) {
-    const metadata = context.model.getMetadata();
-    return metadata.description;
+  return fields;
+}
+function parseFieldSchema(fieldName, fieldSchema) {
+  if (!fieldSchema || !fieldSchema._def) {
+    return null;
   }
-  /**
-   * 获取操作按钮（默认实现：返回空数组）
-   * 子类可以覆盖此方法以提供操作按钮
-   */
-  async getActions(context) {
+  const label = getFieldDescription(fieldSchema) || fieldName;
+  const { type, required, options, innerSchema } = analyzeFieldType(fieldSchema);
+  return {
+    name: fieldName,
+    label,
+    type,
+    required,
+    options,
+    schema: innerSchema || fieldSchema
+  };
+}
+function getFieldDescription(schema) {
+  if (schema?.description) {
+    return schema.description;
+  }
+  const schemaDef = schema._def;
+  if (schemaDef?.description) {
+    return schemaDef.description;
+  }
+  if (schemaDef?.innerType) {
+    return getFieldDescription(schemaDef.innerType);
+  }
+  return void 0;
+}
+function analyzeFieldType(schema) {
+  const def = schema._def;
+  const typeName = def?.type || def?.typeName;
+  if (typeName === "optional" || typeName === "ZodOptional") {
+    const inner = analyzeFieldType(def.innerType);
+    return {
+      ...inner,
+      required: false,
+      innerSchema: def.innerType
+    };
+  }
+  if (typeName === "nullable" || typeName === "ZodNullable") {
+    const inner = analyzeFieldType(def.innerType);
+    return {
+      ...inner,
+      innerSchema: def.innerType
+    };
+  }
+  if (typeName === "enum" || typeName === "ZodEnum") {
+    const options = extractEnumValues(def);
+    return {
+      type: "select",
+      required: true,
+      options,
+      innerSchema: schema
+    };
+  }
+  if (typeName === "nativeEnum" || typeName === "ZodNativeEnum") {
+    const options = extractNativeEnumValues(def);
+    return {
+      type: "select",
+      required: true,
+      options,
+      innerSchema: schema
+    };
+  }
+  if (typeName === "string" || typeName === "ZodString") {
+    let fieldType = "text";
+    if (def?.checks) {
+      const hasEmailCheck = def.checks.some(
+        (check) => check.kind === "email"
+      );
+      if (hasEmailCheck) {
+        fieldType = "email";
+      }
+    }
+    return {
+      type: fieldType,
+      required: true,
+      innerSchema: schema
+    };
+  }
+  if (typeName === "number" || typeName === "ZodNumber") {
+    return {
+      type: "number",
+      required: true,
+      innerSchema: schema
+    };
+  }
+  if (typeName === "date" || typeName === "ZodDate") {
+    return {
+      type: "date",
+      required: true,
+      innerSchema: schema
+    };
+  }
+  if (typeName === "boolean" || typeName === "ZodBoolean") {
+    return {
+      type: "checkbox",
+      required: true,
+      innerSchema: schema
+    };
+  }
+  return {
+    type: "text",
+    required: true,
+    innerSchema: schema
+  };
+}
+function extractEnumValues(def) {
+  let values;
+  if (def?.values && Array.isArray(def.values)) {
+    values = def.values;
+  } else if (def?.entries && typeof def.entries === "object") {
+    values = Object.keys(def.entries);
+  }
+  if (values && values.length > 0) {
+    return values.map((value) => ({
+      value,
+      label: String(value)
+    }));
+  }
+  return void 0;
+}
+function extractNativeEnumValues(def) {
+  const enumValues = def.values || def._def?.values || {};
+  if (enumValues && typeof enumValues === "object") {
+    return Object.entries(enumValues).filter(
+      ([_, value]) => typeof value === "string" || typeof value === "number"
+    ).map(([key, value]) => ({
+      value,
+      label: key
+    }));
+  }
+  return void 0;
+}
+function filterFieldsByNames(fields, fieldNames) {
+  if (fieldNames === void 0) {
+    return fields;
+  }
+  if (fieldNames.length === 0) {
     return [];
   }
-};
+  return fields.filter((field) => fieldNames.includes(field.name));
+}
+function modelFieldsToFormFields(fields) {
+  return fields.map((field) => ({
+    name: field.name,
+    type: field.type,
+    label: field.label,
+    required: field.required,
+    options: field.options
+  }));
+}
+function getFieldNamesFromFields(fields) {
+  return fields.map((field) => field.name);
+}
+function getFieldByName(fields, fieldName) {
+  return fields.find((field) => field.name === fieldName);
+}
+function getFieldLabelFromFields(fields, fieldName) {
+  const field = getFieldByName(fields, fieldName);
+  return field?.label || fieldName;
+}
 var BaseFormFeature = class extends BaseFeature {
   titleGetter;
   descriptionGetter;
@@ -405,8 +683,8 @@ var BaseFormFeature = class extends BaseFeature {
    * 预处理表单数据：根据 schema 类型转换数据
    * 表单数据都是字符串，需要转换为正确的类型（数字、布尔等）
    */
-  preprocessFormData(context, data) {
-    if (!context.model.modelSchema?.schema) {
+  preprocessFormData(data) {
+    if (!this.schema) {
       return data;
     }
     const processed = { ...data };
@@ -415,7 +693,7 @@ var BaseFormFeature = class extends BaseFeature {
         processed[key] = void 0;
       }
     }
-    const def = context.model.modelSchema.schema._def;
+    const def = this.schema._def;
     const shape = typeof def.shape === "function" ? def.shape() : def.shape;
     if (!shape || typeof shape !== "object") {
       return data;
@@ -476,16 +754,24 @@ var BaseFormFeature = class extends BaseFeature {
       imeanServiceEngine.logger.info(
         `[BaseFormFeature] Original body data: ${JSON.stringify(originalData)}`
       );
-      let data = this.preprocessFormData(context, context.body);
-      const validation = context.model.validate(data);
-      if (!validation.success) {
-        context.sendError("\u9A8C\u8BC1\u5931\u8D25", validation.error);
+      let data = this.preprocessFormData(context.body);
+      if (!this.schema) {
+        throw new Error("Schema is required for form validation");
+      }
+      const parseResult = this.schema.safeParse(data);
+      if (!parseResult.success) {
+        const issues = parseResult.error.issues || [];
+        const firstError = issues[0];
+        const fieldName = firstError.path && firstError.path.length > 0 ? firstError.path.join(".") : "";
+        const errorMessage = firstError.message;
+        const errorText = fieldName ? `${fieldName}: ${errorMessage}` : errorMessage;
+        context.sendError("\u9A8C\u8BC1\u5931\u8D25", errorText);
         imeanServiceEngine.logger.info(
           `[BaseFormFeature] Validation failed, returning form with originalData: ${JSON.stringify(originalData)}`
         );
         return this.render(context, originalData);
       }
-      const item = await this.handleSubmit(context, validation.data);
+      const item = await this.handleSubmit(context, parseResult.data);
       if (!item) {
         context.sendError(
           this.getFormAction() === "create" ? "\u521B\u5EFA\u5931\u8D25" : "\u66F4\u65B0\u5931\u8D25",
@@ -514,12 +800,13 @@ var BaseFormFeature = class extends BaseFeature {
       }
     }
   }
+  formFieldNames;
   /**
    * 渲染表单页面
    */
   async render(context, initialData) {
-    const model = context.model;
-    const fields = model.getFormFields();
+    const filteredFields = this.formFieldNames ? filterFieldsByNames(this.fields || [], this.formFieldNames) : this.fields || [];
+    const fields = modelFieldsToFormFields(filteredFields);
     let formData;
     if (this.getFormAction() === "edit") {
       if (initialData) {
@@ -585,22 +872,80 @@ var BaseFormFeature = class extends BaseFeature {
   }
 };
 
-// src/features/default-create-feature.tsx
-var DefaultCreateFeature = class extends BaseFormFeature {
-  createItem;
+// src/features/custom-feature.ts
+var CustomFeature = class extends BaseFeature {
+  routes;
+  handlerFn;
+  renderFn;
+  titleGetter;
+  descriptionGetter;
   constructor(options) {
     super({
-      name: "create",
-      type: "create",
-      permission: options.permission || `${options.permissionPrefix}.create`,
+      name: options.name,
+      type: "custom",
+      permission: options.permission ?? null,
       dialogSize: options.dialogSize,
-      closeOnBackdropClick: options.closeOnBackdropClick,
-      getTitle: options.getTitle ? (context) => options.getTitle(context) : void 0,
-      getDescription: options.getDescription ? (context) => options.getDescription(context) : void 0
+      closeOnBackdropClick: options.closeOnBackdropClick
     });
-    this.createItem = options.createItem;
-  }
-  getFormAction() {
+    this.routes = options.routes;
+    this.handlerFn = options.handler;
+    this.renderFn = options.render;
+    this.titleGetter = options.getTitle;
+    this.descriptionGetter = options.getDescription;
+    if (!this.handlerFn && !this.renderFn) {
+      throw new Error(
+        `CustomFeature "${options.name}" must provide either "handler" or "render" method`
+      );
+    }
+  }
+  async getTitle(context) {
+    if (this.titleGetter) {
+      return await this.titleGetter(context);
+    }
+    return super.getTitle(context);
+  }
+  async getDescription(context) {
+    if (this.descriptionGetter) {
+      return await this.descriptionGetter(context);
+    }
+    return super.getDescription(context);
+  }
+  getRoutes() {
+    return this.routes;
+  }
+  async handle(context) {
+    if (this.handlerFn) {
+      return await this.handlerFn(context);
+    }
+    return void 0;
+  }
+  async render(context) {
+    if (this.renderFn) {
+      return await this.renderFn(context);
+    }
+    return void 0;
+  }
+};
+
+// src/features/default-create-feature.tsx
+var DefaultCreateFeature = class extends BaseFormFeature {
+  createItem;
+  constructor(options) {
+    super({
+      name: "create",
+      type: "create",
+      permission: options.permission || `${options.permissionPrefix}.create`,
+      dialogSize: options.dialogSize,
+      closeOnBackdropClick: options.closeOnBackdropClick,
+      getTitle: options.getTitle ? (context) => options.getTitle(context) : void 0,
+      getDescription: options.getDescription ? (context) => options.getDescription(context) : void 0
+    });
+    this.schema = options.schema;
+    this.fields = parseSchemaToFields(options.schema);
+    this.createItem = options.createItem;
+    this.formFieldNames = options.formFieldNames;
+  }
+  getFormAction() {
     return "create";
   }
   getRoutes() {
@@ -670,6 +1015,7 @@ var DefaultDetailFeature = class extends BaseFeature {
   deleteItem;
   titleGetter;
   descriptionGetter;
+  detailFieldNames;
   constructor(options) {
     super({
       name: "detail",
@@ -678,10 +1024,13 @@ var DefaultDetailFeature = class extends BaseFeature {
       dialogSize: options.dialogSize,
       closeOnBackdropClick: options.closeOnBackdropClick
     });
+    this.schema = options.schema;
+    this.fields = parseSchemaToFields(options.schema);
     this.getItem = options.getItem;
     this.deleteItem = options.deleteItem;
     this.titleGetter = options.getTitle;
     this.descriptionGetter = options.getDescription;
+    this.detailFieldNames = options.detailFieldNames;
   }
   async getTitle(context) {
     if (this.titleGetter) {
@@ -712,12 +1061,25 @@ var DefaultDetailFeature = class extends BaseFeature {
     if (!item) {
       return context.ctx.json({ error: "Not found" }, 404);
     }
-    const model = context.model;
-    model.getMetadata();
-    const detailFields = model.getDetailFields();
-    const fields = detailFields.map((fieldName) => ({
+    const detailFields = this.detailFieldNames ? filterFieldsByNames(this.fields || [], this.detailFieldNames) : this.fields || [];
+    if (this.detailFieldNames) {
+      const systemFields = ["id", "createdAt", "updatedAt"];
+      for (const sysField of systemFields) {
+        if (this.detailFieldNames.includes(sysField) && !detailFields.find((f) => f.name === sysField)) {
+          detailFields.push({
+            name: sysField,
+            label: sysField,
+            type: "text",
+            required: false,
+            schema: null
+          });
+        }
+      }
+    }
+    const detailFieldNames = getFieldNamesFromFields(detailFields);
+    const fields = detailFieldNames.map((fieldName) => ({
       key: fieldName,
-      label: model.getFieldLabel(fieldName)
+      label: getFieldLabelFromFields(this.fields || [], fieldName) || fieldName
     }));
     return /* @__PURE__ */ jsxRuntime.jsx(DetailPage, { item, fields });
   }
@@ -790,8 +1152,11 @@ var DefaultEditFeature = class extends BaseFormFeature {
         return void 0;
       } : void 0
     });
+    this.schema = options.schema;
+    this.fields = parseSchemaToFields(options.schema);
     this.getItem = options.getItem;
     this.updateItem = options.updateItem;
+    this.formFieldNames = options.formFieldNames;
   }
   getFormAction() {
     return "edit";
@@ -853,33 +1218,115 @@ var DefaultEditFeature = class extends BaseFormFeature {
     }
   }
 };
-function Card(props) {
+function FilterForm(props) {
   const {
-    children,
-    title,
-    className = "",
-    shadow = true,
-    bordered = false,
-    noPadding = false
+    fields,
+    listPath,
+    currentFilters = {}
   } = 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__ */ jsxRuntime.jsxs(
-    "div",
+  function getFieldValue2(field) {
+    const value = currentFilters[field.name];
+    if (value === null || value === void 0 || value === "") {
+      return "";
+    }
+    return String(value);
+  }
+  if (fields.length === 0) {
+    return null;
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "bg-white border border-gray-200 rounded-lg shadow-sm p-4 mb-6", "data-testid": "filter-form-container", children: /* @__PURE__ */ jsxRuntime.jsxs(
+    "form",
     {
-      className: `${baseClasses} ${shadowClass} ${borderClass} ${className}`,
+      method: "get",
+      action: listPath,
+      "hx-get": listPath,
+      className: "space-y-4",
+      "data-testid": "filter-form",
       children: [
-        title && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-6 py-4 border-b border-gray-200", children: /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "text-lg font-semibold text-gray-900", children: title }) }),
-        /* @__PURE__ */ jsxRuntime.jsx("div", { className: noPadding ? "" : paddingClass, children })
+        fields.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4", children: fields.map((field) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-2", "data-testid": `filter-field-${field.name}`, children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "label",
+            {
+              htmlFor: `filter-${field.name}`,
+              className: "block text-sm font-semibold text-gray-700",
+              "data-testid": `filter-label-${field.name}`,
+              children: field.label
+            }
+          ),
+          field.type === "select" ? /* @__PURE__ */ jsxRuntime.jsxs(
+            "select",
+            {
+              id: `filter-${field.name}`,
+              name: field.name,
+              className: "w-full px-4 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition-all duration-200 bg-white",
+              "data-testid": `filter-select-${field.name}`,
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx("option", { value: "", selected: getFieldValue2(field) === "", children: "\u5168\u90E8" }),
+                field.options?.map((option) => {
+                  const optionValue = String(option.value);
+                  const isSelected = getFieldValue2(field) === optionValue;
+                  return /* @__PURE__ */ jsxRuntime.jsx("option", { value: optionValue, selected: isSelected, children: option.label }, optionValue);
+                })
+              ]
+            }
+          ) : field.type === "date" ? /* @__PURE__ */ jsxRuntime.jsx(
+            "input",
+            {
+              id: `filter-${field.name}`,
+              name: field.name,
+              type: "date",
+              value: getFieldValue2(field),
+              className: "w-full px-4 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition-all duration-200 bg-white",
+              "data-testid": `filter-input-${field.name}`
+            }
+          ) : field.type === "number" ? /* @__PURE__ */ jsxRuntime.jsx(
+            "input",
+            {
+              id: `filter-${field.name}`,
+              name: field.name,
+              type: "number",
+              value: getFieldValue2(field),
+              placeholder: field.placeholder || `\u8BF7\u8F93\u5165${field.label}`,
+              className: "w-full px-4 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition-all duration-200 bg-white",
+              "data-testid": `filter-input-${field.name}`
+            }
+          ) : /* @__PURE__ */ jsxRuntime.jsx(
+            "input",
+            {
+              id: `filter-${field.name}`,
+              name: field.name,
+              type: "text",
+              value: getFieldValue2(field),
+              placeholder: field.placeholder || `\u8BF7\u8F93\u5165${field.label}`,
+              className: "w-full px-4 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition-all duration-200 bg-white",
+              "data-testid": `filter-input-${field.name}`
+            }
+          )
+        ] }, field.name)) }),
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3 pt-2", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "submit",
+              className: "px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors font-medium",
+              "data-testid": "filter-submit-button",
+              children: "\u7B5B\u9009"
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "a",
+            {
+              href: listPath,
+              "hx-get": listPath,
+              className: "px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 transition-colors font-medium",
+              "data-testid": "filter-reset-button",
+              children: "\u91CD\u7F6E"
+            }
+          )
+        ] })
       ]
     }
-  );
-}
-function EmptyState(props) {
-  const { message = "\u6682\u65E0\u6570\u636E", children } = props;
-  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-center py-12", children: children || /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-gray-500 text-sm", children: message }) });
+  ) });
 }
 function Button(props) {
   const {
@@ -945,6 +1392,34 @@ function Button(props) {
     }
   );
 }
+function 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__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: `${baseClasses} ${shadowClass} ${borderClass} ${className}`,
+      children: [
+        title && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-6 py-4 border-b border-gray-200", children: /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "text-lg font-semibold text-gray-900", children: title }) }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: noPadding ? "" : paddingClass, children })
+      ]
+    }
+  );
+}
+function EmptyState(props) {
+  const { message = "\u6682\u65E0\u6570\u636E", children } = props;
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-center py-12", children: children || /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-gray-500 text-sm", children: message }) });
+}
 function Pagination(props) {
   const {
     page,
@@ -1046,23 +1521,30 @@ function TableHeader(props) {
   if (!showHeader) return null;
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: STYLES.header.container, children: [
     title && title.trim() ? /* @__PURE__ */ jsxRuntime.jsx("h3", { className: STYLES.header.title, children: title }) : /* @__PURE__ */ jsxRuntime.jsx("div", {}),
-    tableActions && tableActions.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: STYLES.header.actions, "data-testid": "table-header-actions", children: tableActions.map((action, idx) => {
-      const testId = `table-action-${action.label}`;
-      return /* @__PURE__ */ jsxRuntime.jsx(
-        Button,
-        {
-          variant: action.variant || "secondary",
-          href: action.href,
-          hxGet: action.hxGet,
-          hxPost: action.hxPost,
-          hxDelete: action.hxDelete,
-          hxConfirm: action.hxConfirm,
-          "data-testid": testId,
-          children: action.label
-        },
-        idx
-      );
-    }) })
+    tableActions && tableActions.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        className: STYLES.header.actions,
+        "data-testid": "table-header-actions",
+        children: tableActions.map((action, idx) => {
+          const testId = `table-action-${action.label}`;
+          return /* @__PURE__ */ jsxRuntime.jsx(
+            Button,
+            {
+              variant: action.variant || "secondary",
+              href: action.href,
+              hxGet: action.hxGet,
+              hxPost: action.hxPost,
+              hxDelete: action.hxDelete,
+              hxConfirm: action.hxConfirm,
+              "data-testid": testId,
+              children: action.label
+            },
+            idx
+          );
+        })
+      }
+    )
   ] });
 }
 function TableHeaderRow(props) {
@@ -1141,7 +1623,14 @@ function ActionCell(props) {
       className: `${STYLES.table.td.base} ${STYLES.table.td.stickyRight}`,
       "data-testid": "table-cell-actions",
       role: "cell",
-      children: actionStyle === "link" ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: STYLES.actionLink.container, "data-testid": "table-actions", children: actions.map((action, idx) => /* @__PURE__ */ jsxRuntime.jsx(ActionLink, { action, item }, idx)) }) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: STYLES.actionButton, "data-testid": "table-actions", children: actions.map((action, idx) => {
+      children: actionStyle === "link" ? /* @__PURE__ */ jsxRuntime.jsx(
+        "div",
+        {
+          className: STYLES.actionLink.container,
+          "data-testid": "table-actions",
+          children: actions.map((action, idx) => /* @__PURE__ */ jsxRuntime.jsx(ActionLink, { action, item }, idx))
+        }
+      ) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: STYLES.actionButton, "data-testid": "table-actions", children: actions.map((action, idx) => {
         const hrefValue = action.href(item);
         const isDelete = action.method === "delete";
         return /* @__PURE__ */ jsxRuntime.jsx(
@@ -1193,35 +1682,51 @@ function Table(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__ */ jsxRuntime.jsxs(Card, { shadow: true, noPadding: true, className: "overflow-hidden", "data-testid": "data-table", children: [
-    /* @__PURE__ */ jsxRuntime.jsx(TableHeader, { title, tableActions }),
-    items.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx(EmptyState, { message: "\u6682\u65E0\u6570\u636E" }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: STYLES.table.container, "data-testid": "table-container", children: /* @__PURE__ */ jsxRuntime.jsxs("table", { className: STYLES.table.table, "data-testid": "table", role: "table", children: [
-        /* @__PURE__ */ jsxRuntime.jsx("thead", { className: STYLES.table.thead, "data-testid": "table-head", children: /* @__PURE__ */ jsxRuntime.jsx(
-          TableHeaderRow,
-          {
-            columns,
-            idColumn,
-            otherColumns,
-            hasActions
-          }
-        ) }),
-        /* @__PURE__ */ jsxRuntime.jsx("tbody", { className: STYLES.table.tbody, "data-testid": "table-body", children: items.map((item, rowIndex) => /* @__PURE__ */ jsxRuntime.jsx(
-          TableRow,
-          {
-            item,
-            idColumn,
-            otherColumns,
-            actions,
-            actionStyle,
-            rowIndex
-          },
-          item.id
-        )) })
-      ] }) }),
-      pagination && /* @__PURE__ */ jsxRuntime.jsx(Pagination, { ...pagination })
-    ] })
-  ] });
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    Card,
+    {
+      shadow: true,
+      noPadding: true,
+      className: "overflow-hidden",
+      "data-testid": "data-table",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx(TableHeader, { title, tableActions }),
+        items.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx(EmptyState, { message: "\u6682\u65E0\u6570\u636E" }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: STYLES.table.container, "data-testid": "table-container", children: /* @__PURE__ */ jsxRuntime.jsxs(
+            "table",
+            {
+              className: STYLES.table.table,
+              "data-testid": "table",
+              role: "table",
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx("thead", { className: STYLES.table.thead, "data-testid": "table-head", children: /* @__PURE__ */ jsxRuntime.jsx(
+                  TableHeaderRow,
+                  {
+                    columns,
+                    idColumn,
+                    otherColumns,
+                    hasActions
+                  }
+                ) }),
+                /* @__PURE__ */ jsxRuntime.jsx("tbody", { className: STYLES.table.tbody, "data-testid": "table-body", children: items.map((item) => /* @__PURE__ */ jsxRuntime.jsx(
+                  TableRow,
+                  {
+                    item,
+                    idColumn,
+                    otherColumns,
+                    actions,
+                    actionStyle
+                  },
+                  item.id
+                )) })
+              ]
+            }
+          ) }),
+          pagination && /* @__PURE__ */ jsxRuntime.jsx(Pagination, { ...pagination })
+        ] })
+      ]
+    }
+  );
 }
 function ListPage(props) {
   const {
@@ -1232,7 +1737,8 @@ function ListPage(props) {
     detailPath,
     editPath,
     deletePath,
-    listPath
+    listPath,
+    filterFields
   } = props;
   const actions = [];
   if (detailPath) {
@@ -1268,40 +1774,42 @@ function ListPage(props) {
       variant: "primary"
     }
   ];
-  if (createPath) {
-    tableActions.push({
-      label: "\u65B0\u5EFA",
-      href: createPath,
-      hxGet: createPath,
-      variant: "primary"
-    });
-  }
-  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-6", children: /* @__PURE__ */ jsxRuntime.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: actions.length > 0 ? actions.map((action) => ({
-        label: action.label,
-        href: (item) => action.href(item),
-        method: action.method
-      })) : void 0,
-      pagination: {
-        page: result.page,
-        pageSize: result.pageSize,
-        total: result.total,
-        totalPages: result.totalPages,
-        baseUrl: listPath,
-        currentParams
-      },
-      tableActions,
-      actionStyle: "link"
-    }
-  ) });
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-6", children: [
+    filterFields && filterFields.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(
+      FilterForm,
+      {
+        fields: filterFields,
+        listPath,
+        currentFilters: params.filters
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.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: actions.length > 0 ? actions.map((action) => ({
+          label: action.label,
+          href: (item) => action.href(item),
+          method: action.method
+        })) : void 0,
+        pagination: {
+          page: result.page,
+          pageSize: result.pageSize,
+          total: result.total,
+          totalPages: result.totalPages,
+          baseUrl: listPath,
+          currentParams
+        },
+        tableActions,
+        actionStyle: "link"
+      }
+    )
+  ] });
 }
 
 // src/utils/params.ts
@@ -1325,6 +1833,8 @@ function parseListParams(ctx) {
 var DefaultListFeature = class extends BaseFeature {
   getList;
   deleteItem;
+  listFieldNames;
+  filterSchema;
   constructor(options) {
     super({
       name: "list",
@@ -1333,8 +1843,12 @@ var DefaultListFeature = class extends BaseFeature {
       dialogSize: options.dialogSize,
       closeOnBackdropClick: options.closeOnBackdropClick
     });
+    this.schema = options.schema;
+    this.fields = parseSchemaToFields(options.schema);
     this.getList = options.getList;
     this.deleteItem = options.deleteItem;
+    this.listFieldNames = options.listFieldNames;
+    this.filterSchema = options.filterSchema;
   }
   getRoutes() {
     return [{ method: "get", path: "/list" }];
@@ -1342,16 +1856,14 @@ var DefaultListFeature = class extends BaseFeature {
   async render(context) {
     const params = parseListParams(context.ctx);
     const result = await this.getList(params);
+    const listFields = this.listFieldNames ? filterFieldsByNames(this.fields || [], this.listFieldNames) : this.fields || [];
+    const listFieldNames = getFieldNamesFromFields(listFields);
+    const filterFields = this.filterSchema ? modelFieldsToFormFields(parseSchemaToFields(this.filterSchema)) : [];
+    const columns = listFieldNames.map((fieldName) => ({
+      key: fieldName,
+      label: getFieldLabelFromFields(this.fields || [], fieldName)
+    }));
     const model = context.model;
-    const listFields = model.getListFields();
-    const columns = listFields.map((fieldName) => {
-      const fieldMetadata = model.modelSchema?.fields?.[fieldName];
-      return {
-        key: fieldName,
-        label: model.getFieldLabel(fieldName),
-        render: fieldMetadata?.render ? (value, item) => fieldMetadata.render(value, item) : void 0
-      };
-    });
     const prefix = context.prefix || "";
     const basePath = `${prefix}/${model.modelName}`;
     const listPath = `${basePath}/list`;
@@ -1369,7 +1881,8 @@ var DefaultListFeature = class extends BaseFeature {
         detailPath,
         editPath,
         deletePath,
-        listPath
+        listPath,
+        filterFields
       }
     );
   }
@@ -1390,523 +1903,6 @@ var DefaultListFeature = class extends BaseFeature {
   }
 };
 
-// src/feature-registry.ts
-var FeatureRegistry = class {
-  features = /* @__PURE__ */ new Map();
-  model;
-  constructor(model) {
-    this.model = model;
-  }
-  /**
-   * 注册 Feature
-   */
-  register(name, feature) {
-    this.features.set(name, feature);
-  }
-  /**
-   * 快捷方法：注册列表 Feature
-   */
-  list(feature) {
-    this.register("list", feature);
-  }
-  /**
-   * 快捷方法：注册详情 Feature
-   */
-  detail(feature) {
-    this.register("detail", feature);
-  }
-  /**
-   * 快捷方法：注册创建 Feature
-   */
-  create(feature) {
-    this.register("create", feature);
-  }
-  /**
-   * 快捷方法：注册编辑 Feature
-   */
-  edit(feature) {
-    this.register("edit", feature);
-  }
-  /**
-   * 快捷方法：注册删除 Feature
-   */
-  delete(feature) {
-    this.register("delete", feature);
-  }
-  /**
-   * 快捷方法：注册自定义 Feature
-   */
-  custom(name, feature) {
-    this.register(name, feature);
-  }
-  /**
-   * 一键启用所有 CRUD Feature
-   * 类型通过 model.modelSchema.schema 的 z.infer 推断
-   */
-  crud(options) {
-    const {
-      permissionPrefix,
-      getList,
-      getItem,
-      createItem,
-      updateItem,
-      deleteItem,
-      permissions = {},
-      features = {},
-      dialogSizes = {},
-      closeOnBackdropClick = {},
-      getTitles = {},
-      getDescriptions = {}
-    } = options;
-    if (features.list !== false) {
-      this.list(
-        new DefaultListFeature({
-          getList,
-          deleteItem,
-          permissionPrefix,
-          permission: permissions.list,
-          dialogSize: dialogSizes.list,
-          closeOnBackdropClick: closeOnBackdropClick.list
-        })
-      );
-    }
-    if (features.detail !== false) {
-      this.detail(
-        new DefaultDetailFeature({
-          getItem,
-          deleteItem,
-          permissionPrefix,
-          permission: permissions.read,
-          dialogSize: dialogSizes.detail,
-          closeOnBackdropClick: closeOnBackdropClick.detail,
-          getTitle: getTitles.detail,
-          getDescription: getDescriptions.detail
-        })
-      );
-    }
-    if (features.create !== false) {
-      this.create(
-        new DefaultCreateFeature({
-          createItem,
-          permissionPrefix,
-          permission: permissions.create,
-          dialogSize: dialogSizes.create,
-          closeOnBackdropClick: closeOnBackdropClick.create,
-          getTitle: getTitles.create,
-          getDescription: getDescriptions.create
-        })
-      );
-    }
-    if (features.edit !== false) {
-      this.edit(
-        new DefaultEditFeature({
-          getItem,
-          updateItem,
-          permissionPrefix,
-          permission: permissions.edit,
-          dialogSize: dialogSizes.edit,
-          closeOnBackdropClick: closeOnBackdropClick.edit,
-          getTitle: getTitles.edit,
-          getDescription: getDescriptions.edit
-        })
-      );
-    }
-    if (features.delete !== false && deleteItem) {
-      this.delete(
-        new DefaultDeleteFeature({
-          deleteItem,
-          permissionPrefix,
-          permission: permissions.delete
-        })
-      );
-    }
-  }
-  /**
-   * 获取所有注册的 Feature
-   */
-  getAll() {
-    return Array.from(this.features.values());
-  }
-  /**
-   * 获取指定 Feature
-   */
-  get(name) {
-    return this.features.get(name);
-  }
-};
-
-// src/page-model.ts
-var PageModel = class {
-  modelName;
-  features;
-  modelSchema;
-  metadata;
-  /**
-   * 构造函数
-   * @param modelName 模型/页面名称（用于路由和权限）
-   * @param schema 模型 Schema（可选，不提供则为普通页面）
-   * @param metadata 页面元数据（可选，如果提供则不需要实现 getMetadata）
-   */
-  constructor(modelName, schema, metadata) {
-    this.modelName = modelName;
-    this.modelSchema = schema;
-    this.metadata = metadata || {
-      title: modelName,
-      description: "",
-      useAdminLayout: true
-    };
-    this.features = new FeatureRegistry(this);
-  }
-  /**
-   * 获取推断的类型（如果有 schema）
-   * 使用方式：type ModelType = z.infer<typeof pageModel.getSchema()!.schema>
-   */
-  getInferredType() {
-    if (!this.modelSchema?.schema) {
-      return void 0;
-    }
-    return this.modelSchema.schema;
-  }
-  /**
-   * 获取页面元数据
-   * 如果构造函数提供了 metadata，直接返回
-   * 否则调用子类实现
-   */
-  getMetadata() {
-    return this.metadata;
-  }
-  /**
-   * 判断是否有数据模型（有 Schema）
-   */
-  hasModel() {
-    return !!this.modelSchema;
-  }
-  /**
-   * 获取模型 Schema（可选）
-   */
-  getSchema() {
-    return this.modelSchema;
-  }
-  /**
-   * 验证数据（仅用于有数据模型的场景）
-   */
-  validate(data) {
-    if (!this.modelSchema) {
-      return { success: true, data };
-    }
-    const result = this.modelSchema.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;
-      return {
-        success: false,
-        error: fieldName ? `${fieldName}: ${errorMessage}` : errorMessage
-      };
-    }
-  }
-  /**
-   * 获取表单字段（仅用于有数据模型的场景）
-   */
-  getFormFields() {
-    if (!this.modelSchema) {
-      return [];
-    }
-    if (this.modelSchema.formFields) {
-      return this.modelSchema.formFields.map((fieldName) => this.createFormField(fieldName)).filter((field) => field !== null);
-    }
-    const def = this.modelSchema.schema._def;
-    const shape = typeof def.shape === "function" ? def.shape() : def.shape;
-    if (!shape || typeof shape !== "object") {
-      return [];
-    }
-    const fields = [];
-    for (const fieldName of Object.keys(shape)) {
-      if (["id", "createdAt", "updatedAt"].includes(fieldName)) {
-        continue;
-      }
-      const field = this.createFormField(fieldName);
-      if (field) {
-        fields.push(field);
-      }
-    }
-    return fields;
-  }
-  /**
-   * 创建表单字段
-   */
-  createFormField(fieldName) {
-    if (!this.modelSchema?.schema) {
-      return null;
-    }
-    const def = this.modelSchema.schema._def;
-    const shape = typeof def.shape === "function" ? def.shape() : def.shape;
-    if (!shape || typeof shape !== "object") {
-      return null;
-    }
-    const fieldSchema = shape[fieldName];
-    if (!fieldSchema) {
-      return null;
-    }
-    const fieldMetadata = this.modelSchema.fields?.[fieldName];
-    const label = fieldMetadata?.label || this.getFieldLabel(fieldName);
-    const description = fieldMetadata?.description;
-    const placeholder = fieldMetadata?.placeholder;
-    const required = this.isRequiredField(fieldSchema);
-    const type = fieldMetadata?.type || this.inferFieldType(fieldSchema);
-    let options;
-    if (fieldMetadata?.options) {
-      options = fieldMetadata.options;
-    } else {
-      const inferredType = this.inferFieldType(fieldSchema);
-      if (type === "select" || inferredType === "select") {
-        options = this.extractEnumOptions(fieldSchema);
-      }
-    }
-    return {
-      name: fieldName,
-      type,
-      label,
-      required,
-      description,
-      placeholder,
-      options
-    };
-  }
-  /**
-   * 从 Zod enum schema 中提取选项
-   */
-  extractEnumOptions(schema) {
-    if (!schema || !schema._def) {
-      return void 0;
-    }
-    const def = schema._def;
-    const typeName = def?.typeName || def?.type;
-    if (typeName === "ZodOptional" || typeName === "optional") {
-      return this.extractEnumOptions(def.innerType);
-    }
-    if (typeName === "ZodNullable" || typeName === "nullable") {
-      return this.extractEnumOptions(def.innerType);
-    }
-    if (typeName === "ZodEnum" || typeName === "enum" || def?.type === "enum") {
-      let values;
-      if (def?.values && Array.isArray(def.values)) {
-        values = def.values;
-      } else if (def?.entries && typeof def.entries === "object") {
-        values = Object.keys(def.entries);
-      }
-      if (values && values.length > 0) {
-        return values.map((value) => ({
-          value,
-          label: String(value)
-        }));
-      }
-    }
-    if (typeName === "ZodNativeEnum" || typeName === "nativeEnum") {
-      const enumValues = def.values || def._def?.values || {};
-      if (enumValues && typeof enumValues === "object") {
-        return Object.entries(enumValues).filter(
-          ([_, value]) => typeof value === "string" || typeof value === "number"
-        ).map(([key, value]) => ({
-          value,
-          label: key
-        }));
-      }
-    }
-    return void 0;
-  }
-  /**
-   * 判断字段是否为必填
-   */
-  isRequiredField(schema) {
-    const def = schema._def;
-    const typeName = def?.type || def?.typeName;
-    if (typeName === "optional" || typeName === "ZodOptional") {
-      return false;
-    }
-    if (typeName === "nullable" || typeName === "ZodNullable") {
-      return this.isRequiredField(def.innerType);
-    }
-    return true;
-  }
-  /**
-   * 推断字段类型
-   */
-  inferFieldType(schema) {
-    const def = schema._def;
-    const typeName = def?.type || def?.typeName;
-    if (typeName === "optional" || typeName === "ZodOptional") {
-      return this.inferFieldType(def.innerType);
-    }
-    if (typeName === "nullable" || typeName === "ZodNullable") {
-      return this.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 "checkbox";
-    }
-    return "text";
-  }
-  /**
-   * 获取列表字段（仅用于有数据模型的场景）
-   */
-  getListFields() {
-    if (this.modelSchema?.listFields) {
-      return this.modelSchema.listFields;
-    }
-    if (this.modelSchema?.fields) {
-      return Object.entries(this.modelSchema.fields).filter(([_, meta]) => meta.showInList !== false).map(([key]) => key);
-    }
-    if (this.modelSchema?.schema) {
-      const def = this.modelSchema.schema._def;
-      const shape = typeof def.shape === "function" ? def.shape() : def.shape;
-      if (shape && typeof shape === "object") {
-        return Object.keys(shape).filter(
-          (key) => !["id", "createdAt", "updatedAt"].includes(key)
-        );
-      }
-    }
-    return [];
-  }
-  /**
-   * 获取详情字段（仅用于有数据模型的场景）
-   */
-  getDetailFields() {
-    if (this.modelSchema?.detailFields) {
-      return this.modelSchema.detailFields;
-    }
-    if (this.modelSchema?.fields) {
-      return Object.entries(this.modelSchema.fields).filter(([_, meta]) => meta.showInDetail !== false).map(([key]) => key);
-    }
-    if (this.modelSchema?.schema) {
-      const def = this.modelSchema.schema._def;
-      const shape = typeof def.shape === "function" ? def.shape() : def.shape;
-      if (shape && typeof shape === "object") {
-        return Object.keys(shape);
-      }
-    }
-    return [];
-  }
-  /**
-   * 获取字段标签
-   */
-  getFieldLabel(fieldName) {
-    if (this.modelSchema?.fields?.[fieldName]?.label) {
-      return this.modelSchema.fields[fieldName].label;
-    }
-    if (this.modelSchema?.schema) {
-      const def = this.modelSchema.schema._def;
-      const shape = typeof def.shape === "function" ? def.shape() : def.shape;
-      if (shape && typeof shape === "object") {
-        const fieldSchema = shape[fieldName];
-        if (fieldSchema) {
-          const getDescription = (schema) => {
-            if (schema?.description) {
-              return schema.description;
-            }
-            const schemaDef = schema._def;
-            if (schemaDef?.description) {
-              return schemaDef.description;
-            }
-            if (schemaDef?.innerType) {
-              return getDescription(schemaDef.innerType);
-            }
-            return void 0;
-          };
-          const description = getDescription(fieldSchema);
-          if (description) {
-            return description;
-          }
-        }
-      }
-    }
-    return fieldName;
-  }
-};
-
-// src/features/custom-feature.ts
-var CustomFeature = class extends BaseFeature {
-  routes;
-  handlerFn;
-  renderFn;
-  titleGetter;
-  descriptionGetter;
-  constructor(options) {
-    super({
-      name: options.name,
-      type: "custom",
-      permission: options.permission ?? null,
-      dialogSize: options.dialogSize,
-      closeOnBackdropClick: options.closeOnBackdropClick
-    });
-    this.routes = options.routes;
-    this.handlerFn = options.handler;
-    this.renderFn = options.render;
-    this.titleGetter = options.getTitle;
-    this.descriptionGetter = options.getDescription;
-    if (!this.handlerFn && !this.renderFn) {
-      throw new Error(
-        `CustomFeature "${options.name}" must provide either "handler" or "render" method`
-      );
-    }
-  }
-  async getTitle(context) {
-    if (this.titleGetter) {
-      return await this.titleGetter(context);
-    }
-    return super.getTitle(context);
-  }
-  async getDescription(context) {
-    if (this.descriptionGetter) {
-      return await this.descriptionGetter(context);
-    }
-    return super.getDescription(context);
-  }
-  getRoutes() {
-    return this.routes;
-  }
-  async handle(context) {
-    if (this.handlerFn) {
-      return await this.handlerFn(context);
-    }
-    return void 0;
-  }
-  async render(context) {
-    if (this.renderFn) {
-      return await this.renderFn(context);
-    }
-    return void 0;
-  }
-};
-
 // src/utils/path.ts
 function modelNameToPath(modelName) {
   return `/${modelName.replace(/([A-Z])/g, "-$1").toLowerCase()}`;
@@ -3528,8 +3524,7 @@ var HtmxAdminPlugin = class {
       );
     }
     this.pages.set(page.modelName, page);
-    const pageType = page.hasModel() ? "model" : "page";
-    imeanServiceEngine.logger.info(`[HtmxAdminPlugin] Registered ${pageType}: ${page.modelName}`);
+    imeanServiceEngine.logger.info(`[HtmxAdminPlugin] Registered page: ${page.modelName}`);
     return this;
   }
   /**