jwt-ui 1.11.26 → 1.11.27

package/types/index.d.ts

@@ -0,0 +1,1689 @@
+// Type definitions for jwt-ui v1.x
+// Definitions by WGL
+
+import type {
+  App,
+  ComputedRef,
+  DefineComponent,
+  Ref,
+  VNodeChild,
+} from 'vue'
+
+/** 插槽函数类型 */
+type Slot<T extends Record<string, any> = Record<string, any>> = (props: T) => VNodeChild
+
+// ============================================================
+// Plugin Configuration - 插件初始化配置
+// ============================================================
+
+/** setupJwt 初始化配置项 */
+export interface JwtUiOptions {
+  /** 翻译/国际化函数 */
+  translateTitle: (text: string) => string
+  /** 网络请求函数 (axios 封装) */
+  request: (opt: any) => Promise<any>
+  /** 图片路径补全函数 */
+  fillUrl: (url: string, ...args: any[]) => string
+  /** Vue Router 实例 */
+  router: { push: (options: { path: string; query?: any }) => void }
+  /** 图片上传接口地址 */
+  uploadImgUrl?: string
+  /** 富文本上传接口地址 */
+  uploadRichTextUrl?: string
+  /** 腾讯 COS 上传文件地址 */
+  txCosUploadFileUrl?: string
+  /** 图片上传返回的路径字段名，默认 'relative_path' */
+  imgUploadResKey: string
+  /** 空图片默认地址 */
+  emptyImgUrl?: string
+  /** 图片加载错误时的占位图地址 */
+  errorImgUrl?: string
+  /** 图片默认名称 key */
+  defaultImgNameKey?: string
+  /** 图片默认名称长度 */
+  defaultImgNameLength?: number
+  /** Token 字段名，默认 'Authorization' */
+  tokenKey: string
+  /** 本地存储 Token 的 key，默认 'admin-token' */
+  localTokenKey: string
+  /** 自定义文件类型判断函数 */
+  getFileType?: (filename: string, typeName?: boolean, obj?: boolean) => any
+  /** 自动保存表单函数 */
+  autoSaveForm: () => any
+  /** 上传文件字段名，默认 'filedata' */
+  uploadFileName: string
+  /** 表格按钮权限字段名，默认 'show_table' */
+  showTableKey: string
+  /** 表头按钮权限字段名，默认 'show_header' */
+  showHeaderKey: string
+  /** 联合 ID 字段名 */
+  unionIdKey?: string
+  /** 分页页码字段名 */
+  pageKey?: string
+  /** 分页大小字段名 */
+  pageSizeKey?: string
+  /** 表格每页显示条数选项 */
+  tablePageSizes?: number[] | null
+  /** 自定义图标映射对象 */
+  customIconObj?: Record<string, any>
+  /** 自动保存间隔时间(ms) */
+  autoSaveIntervalTime?: number
+}
+
+/** 注册 jwt-ui 插件，注册后所有组件全局可用 */
+export function setupJwt(app: App, options?: Partial<JwtUiOptions>): void
+
+export function setAppOptions(options: Partial<JwtUiOptions>): void
+export function getAppOptions(): JwtUiOptions
+export function t(text: string): string
+export function getToken(): Record<string, string | null>
+
+// ============================================================
+// JwtTable - 数据表格
+// ============================================================
+
+export interface JwtTableProps {
+  /** 表格配置对象，包含列配置、接口地址、搜索条件等 */
+  config: Record<string, any>
+  /** 表格高度 */
+  tableHeight?: string | number
+  /** 用户菜单权限对象 */
+  userMenusAuth?: Record<string, any>
+  /** 当前路由对象 */
+  route?: Record<string, any>
+  /** 路由实例 */
+  router?: Record<string, any>
+  /** 用户字段配置列表 */
+  userFieldList?: Record<string, any>
+  /** 关联菜单 ID */
+  refMenuId?: string | number
+  /** 权限 URL */
+  pageUrl?: string
+  /** 自定义表格列配置，覆盖 config 中的列 */
+  tableColumn?: any[]
+  /** 是否冻结响应式数据 (markRaw)，默认 true */
+  freezeList?: boolean
+  /** 是否缓存搜索条件，默认 false */
+  cacheSearch?: boolean
+}
+
+/** JwtTable / JwtTableV2 事件 */
+export interface JwtTableEmits {
+  /** 选中行变化 */
+  'selection-change': (selection: any[]) => void
+  /** 列表数据加载成功后触发 */
+  'list-change': () => void
+  /** 表头按钮操作事件 */
+  'header-action': (action: any, selectionRow: any[], detailInfo?: any, rowAction?: any) => void
+  /** 表格行操作按钮点击 */
+  'table-action': (action: any, row: any, rowAction: any, data: any) => void
+  /** 新增操作触发 */
+  'add-handle': (...args: any[]) => void
+  /** 编辑操作触发 */
+  'edit-handle': (...args: any[]) => void
+  /** 新增请求成功 */
+  'add-success': (data: any, type: string) => void
+  /** 编辑请求成功 */
+  'edit-success': (data: any, type: string) => void
+  /** 删除请求成功 */
+  'delete-success': (row: any) => void
+  /** 当前高亮行变化 */
+  'table-current-change': (currentRow: any) => void
+  /** 表格数据加载完成 */
+  'tablelist-change': (data: any) => void
+  /** 获取详情成功 */
+  'get-detail-success': (res: any) => void
+  /** 单元格点击 */
+  'click-cell': (row: any, item: any) => void
+  /** 描述面板内联编辑成功 */
+  'des-edit-success': (res: any, code: string) => void
+  /** 上传按钮点击 */
+  'upload-btn': (item: any) => void
+  /** 通用事件透传 */
+  'event-name': (...args: any[]) => void
+  /** 复制成功 */
+  'copy-success': (row: any) => void
+  /** 异步导出 */
+  asynExport: (...args: any[]) => void
+  /** 搜索提交返回结果 */
+  'search-result': (data: any) => void
+  /** 表格列配置变更（显隐/宽度/拖拽） */
+  'change-table-column': (type: string, item: any) => void
+  /** 固定列变更 */
+  'fixed-table-column': (...args: any[]) => void
+  /** 弹窗关闭 */
+  'dialog-close': () => void
+  /** 刷新抽屉详情 (仅 JwtTable) */
+  'refresh-draw': () => void
+  /** 刷新表格 */
+  'refresh-table': () => void
+  /** 表单项值变化 */
+  'form-item-change': (val: any, item: any, model: any) => void
+  /** 行内编辑值变化 */
+  'row-change': (row: any, item: any) => void
+  /** 单元格双击 */
+  'dbclick-cell': (data: any) => void
+  /** 表格行拖拽排序变更 */
+  'change-table-rank': (tableData: any[]) => void
+  /** 弹窗底部按钮点击后 */
+  'after-btns-click': (btn: any, modelData: any, item: any, fetchContent?: any) => void
+  /** 文件预览 */
+  'show-file': (url: string) => void
+  /** 排序变更 */
+  'sort-change': (sort: { prop: string; order: string; param?: any; tableFields?: any }) => void
+}
+
+/** JwtTable / JwtTableV2 插槽 */
+export interface JwtTableSlots {
+  /** 搜索区域之前 */
+  'search-before'?: Slot
+  /** 搜索表单之后 */
+  'search-form-after'?: Slot
+  /** 搜索区域之后 */
+  'search-after'?: Slot
+  /** 表头按钮之前 */
+  'header-button-before'?: Slot
+  /** 表头按钮之后 */
+  'header-button-after'?: Slot
+  /** 表格上方 */
+  'table-before'?: Slot
+  /** 替换整个表格内容，接收当前列表数据 */
+  'table-content'?: Slot<{ list: any[] }>
+  /** 表格下方 */
+  'table-after'?: Slot
+  /** 分页之前，可用于显示统计信息 */
+  'table-pagination-before'?: Slot<{ data: any }>
+  /** 分页之后 */
+  'table-pagination-after'?: Slot
+  /**
+   * 动态插槽，支持以下命名规则:
+   * - `col-[prop]` 列内容插槽，如 col-name，props: { row, column, $index }
+   * - `col-[prop]-header` 列头插槽，props: { column }
+   * - `[name]` 表单插槽 (由 formList 项的 name 决定)，props: { model }
+   */
+  [slotName: string]: Slot<any> | undefined
+}
+
+/** JwtTable ref 暴露的方法和状态 */
+export interface JwtTableExpose {
+  /** el-table 实例引用 */
+  tableRef: Ref<any>
+  /** 当前表格数据 */
+  tableData: Ref<any[]>
+  /** 当前渲染的列配置 */
+  appTableColumn: Ref<any[]>
+  /** 合并后的配置对象 */
+  appConfig: Record<string, any>
+  /** 分页信息 */
+  pagination: { currentPage: number; pageCount: number; pageSize: number; totalCount: number; sort: string; order: string }
+  /** 编辑弹窗表单引用 */
+  editBoxRef: Ref<any>
+  /** 编辑弹窗表单 model */
+  editBoxRefModel: ComputedRef<any>
+  /** 编辑弹窗状态 (title, type, visible, model, config, boxName) */
+  editBoxInfo: Record<string, any>
+  /** 新增弹窗状态 */
+  addBoxInfo: Record<string, any>
+  /** 当前选中行 */
+  selectionRow: Ref<any[]>
+  /** 选中行 ID (逗号分隔) */
+  selectionRowIds: ComputedRef<string>
+  /** 搜索表单 model */
+  tableSearchModel: Ref<any>
+  /** 获取列表数据 */
+  getList(param?: any): Promise<void>
+  /** 初始化搜索并请求 */
+  initSearch(param?: any): void
+  /** 刷新 (回到第一页) */
+  handleRefresh(): void
+  /** 重置 (清空搜索回到第一页) */
+  handleReset(): void
+  /** 刷新当前页 */
+  handleRefreshCurrent(): void
+  /** 获取选中行 */
+  getSelectionRows(): any[]
+  /** 清空选中 */
+  handleClearSelection(): void
+  /** 切换行选中状态 */
+  handleToggleRowSelection(row: any, selected?: boolean): void
+  /** 切换行展开状态 */
+  handleToggleRowExpansion(row: any, expanded?: boolean): void
+  /** 直接设置表格数据 */
+  handleSetTableData(data: any[]): void
+  /** 设置表格列配置 */
+  handleSetTableColumn(data: any[]): void
+  /** 排序 */
+  handleSort(prop: string, order: string): void
+  /** 打开编辑弹窗 */
+  handleEdit(row: any, rowAction?: any): void
+  /** 获取表单提交数据 */
+  getSubmitData(): Promise<any>
+  /** 设置弹窗表单字段值 */
+  setFormModelVal(key: string, val: any): void
+  /** 设置搜索表单字段值 */
+  handleSetSearchModelVal(key: string, val: any): void
+}
+
+// ============================================================
+// JwtTableV2 - 优化版数据表格（与 JwtTable 接口一致）
+// ============================================================
+
+/** JwtTableV2 Props 与 JwtTable 相同 */
+export type JwtTableV2Props = JwtTableProps
+/** JwtTableV2 事件与 JwtTable 相同 (无 refresh-draw) */
+export type JwtTableV2Emits = JwtTableEmits
+/** JwtTableV2 插槽与 JwtTable 相同 */
+export type JwtTableV2Slots = JwtTableSlots
+
+// ============================================================
+// JwtTableOnly - 纯表格（无工具栏/分页）
+// ============================================================
+
+export interface JwtTableOnlyProps {
+  /** 表格配置 */
+  config: Record<string, any>
+  /** 表格高度 */
+  tableHeight?: string | number
+  /** 用户菜单权限 */
+  userMenusAuth?: Record<string, any>
+}
+
+export interface JwtTableOnlyEmits {
+  /** 选中行变化 */
+  'selection-change': (selection: any[]) => void
+  /** 当前高亮行变化 */
+  'table-current-change': (currentRow: any) => void
+  /** 排序变更 */
+  'sort-change': (sort: { prop: string; order: string }) => void
+  /** 单元格点击 */
+  'click-cell': (data: any) => void
+  /** 文件预览 */
+  'show-file': (url: string) => void
+  /** 表格行操作 */
+  'table-action': (action: any, row: any, rowAction: any, data: any) => void
+}
+
+export interface JwtTableOnlySlots {
+  /** 表格上方 */
+  'table-before'?: Slot
+  /** 动态列插槽，名称为 col-[prop]，props: { row, column, $index } */
+  [slotName: string]: Slot<any> | undefined
+}
+
+// ============================================================
+// JwtTableButton - 表格操作按钮
+// ============================================================
+
+export interface JwtTableButtonProps {
+  /** 当前页面路径（用于权限匹配） */
+  currentPath?: string
+  /** 用户菜单权限对象 */
+  menusObj?: Record<string, any>
+  /** 操作按钮配置 */
+  config?: Record<string, any>
+  /** 当前行数据 */
+  row?: Record<string, any>
+  /** 操作属性名，默认 'operations' */
+  operationName?: string
+  /** 最多显示按钮数量，超出显示省略号，默认 3 */
+  showButtonNum?: number
+  /** 是否显示图标 */
+  showIcon?: boolean
+  /** 是否显示文字 */
+  showText?: boolean
+}
+
+export interface JwtTableButtonEmits {
+  /** 按钮点击事件 */
+  'table-action': (payload: { action: any; e: Event }) => void
+}
+
+// ============================================================
+// JwtForm - 动态表单
+// ============================================================
+
+export interface JwtFormProps {
+  /** 表单数据对象 (v-model) */
+  modelValue?: Record<string, any> | (() => Record<string, any>)
+  /** 表单配置，包含 formList、api 等 */
+  config: Record<string, any>
+  /** 是否为搜索表单模式 */
+  isSearch?: boolean
+  /** 选中行 ID (逗号分隔) */
+  selectionRowIds?: string
+  /** 当前选中行数据 */
+  selectionRow?: any[]
+}
+
+export interface JwtFormEmits {
+  /** 表单提交 */
+  submit: (data: any) => void
+  /** 表单重置 */
+  reset: (model: any) => void
+  /** v-model 更新 */
+  'update:modelValue': (value: any) => void
+  /** 新增成功 */
+  'add-success': (res: any, type: string) => void
+  /** 编辑成功 */
+  'edit-success': (res: any, type: string) => void
+  /** 获取详情成功 */
+  'get-detail-success': (res: any) => void
+  /** 请求错误 */
+  error: () => void
+  /** 上传按钮点击 */
+  'upload-btn': (item: any) => void
+  /** 新增选项 */
+  'add-option': (item: any) => void
+  /** 图片操作 */
+  'picture-action': (payload: { action: any; item: any }) => void
+  /** 表单项值变化 */
+  'item-change': (val: any, item: any, model: any) => void
+  /** 多按钮点击后 */
+  'after-btns-click': (btn: any, modelData: any, item: any, fetchContent?: any) => void
+}
+
+export interface JwtFormSlots {
+  /** 动态插槽，名称由 formList 项的 name 字段决定 (type='slot' 时)，props: { model } */
+  [slotName: string]: Slot<any> | undefined
+}
+
+/** JwtForm ref 暴露的方法 */
+export interface JwtFormExpose {
+  /** el-form 实例引用 */
+  formRef: Ref<any>
+  /** 表单数据对象 */
+  appModel: Ref<Record<string, any>>
+  /** 处理后的表单配置 */
+  formConfig: ComputedRef<any>
+  /** 判断是否为新增表单 */
+  isAddForm(info?: any): Promise<boolean>
+  /** 提交表单 (验证 + 请求) */
+  formSubmit(type?: string, params?: Record<string, any>): Promise<void>
+  /** 重置表单 */
+  formReset(): void
+  /** 验证表单，返回是否通过 */
+  formValidate(): Promise<boolean>
+  /** 获取详情数据 */
+  getDetail(param?: Record<string, any>): void
+  /** 设置表单字段值 */
+  setModelVal(key: string, val: any): void
+  /** 通过回调设置字段值 */
+  handleSetModelVal(key: string, callBack: (model: any) => any): void
+  /** 构建提交数据 */
+  createSubmitData(): Promise<any>
+}
+
+// ============================================================
+// JwtFormItem - 表单项渲染器
+// ============================================================
+
+export interface JwtFormItemProps {
+  /** 表单项配置 (type, key, label, formAttrs 等) */
+  item?: Record<string, any>
+  /** 数据源 */
+  sourceData?: Record<string, any>
+  /** 当前选中行 */
+  selectionRow?: any[]
+}
+
+export interface JwtFormItemEmits {
+  /** 值变化 */
+  change: (val: any, item: any) => void
+  /** 新增选项 */
+  'add-option': (item: any) => void
+  /** 按钮点击 */
+  'after-btn-click': (item: any) => void
+  /** 多按钮点击 */
+  'after-btns-click': (btn: any, fetchContent: any, sourceData: any, item: any) => void
+  /** 图片操作 */
+  'picture-action': (action: any, item: any) => void
+  /** 输入选择框变化 */
+  'input-select-change': (val: any, item: any) => void
+}
+
+// ============================================================
+// JwtDialogForm - 弹窗表单
+// ============================================================
+
+export interface JwtDialogFormProps {
+  /** 应用配置 (包含 editBox 等弹窗配置) */
+  appConfig?: Record<string, any>
+  /** 当前弹窗配置 (响应式，会被 watchEffect 监听) */
+  config?: Record<string, any>
+  /** 选中行 ID */
+  selectionRowIds?: string
+  /** 选中行数据 */
+  selectionRow?: any[]
+}
+
+export interface JwtDialogFormEmits {
+  /** 弹窗关闭 */
+  'dialog-close': () => void
+  /** 新增选项 */
+  'add-option': (data: any) => void
+  /** 新增成功 */
+  'add-success': (data: any, type: string) => void
+  /** 编辑成功 */
+  'edit-success': (data: any, type: string) => void
+  /** 上传按钮点击 */
+  'upload-btn': (item: any) => void
+  /** 表单项变化 */
+  'item-change': (val: any, item: any, model: any) => void
+  /** 多按钮点击后 */
+  'after-btns-click': (btn: any, modelData: any, item: any, fetchContent?: any) => void
+}
+
+export interface JwtDialogFormSlots {
+  /** 弹窗底部按钮之前，可自定义按钮 */
+  'dialog-footer-before'?: Slot<{ model: any }>
+  /** 弹窗底部按钮之后 */
+  'dialog-footer-after'?: Slot<{ model: any }>
+  /** 动态插槽，名称由 formList 项的 name 决定，props: { model } */
+  [slotName: string]: Slot<any> | undefined
+}
+
+/** JwtDialogForm ref 暴露的方法 */
+export interface JwtDialogFormExpose {
+  /** 弹窗状态对象 (title, type, visible, model, config, boxName, refreshTable) */
+  editBoxInfo: { title: string; type: string; visible: boolean; model: Record<string, any>; config: Record<string, any>; boxName: string; refreshTable: boolean }
+  /** 内部 JwtForm 引用 */
+  editBoxRef: Ref<any>
+  /** 内部表单 model */
+  editBoxRefModel: ComputedRef<any>
+  /** 是否全屏 */
+  fullScreen: Ref<boolean>
+  /** 提交加载状态 */
+  submitLoading: Ref<boolean>
+  /** 关闭弹窗 */
+  handleDialogClose(): void
+  /** 弹窗操作: confirm=提交并关闭, continue=提交并继续, cancel=取消 */
+  handleBox(type: 'confirm' | 'continue' | 'cancel', params?: any): Promise<void>
+  /** 设置表单字段值 */
+  setModelVal(key: string, val: any): void
+  /** 构建提交数据 */
+  createSubmitData(): Promise<any>
+  /** 切换全屏 */
+  handleFullScreen(): void
+}
+
+// ============================================================
+// JwtInput - 带变更标记的输入框
+// ============================================================
+
+export interface JwtInputProps {
+  /** 输入值 (v-model) */
+  modelValue?: string | number
+  /** 未变更时的背景色 */
+  defaultBg?: string
+  /** 变更后的背景色 */
+  changeBg?: string
+  /** 文字颜色 */
+  textColor?: string
+}
+
+export interface JwtInputEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: string | number) => void
+  /** 失焦时值发生变化触发 */
+  blur: (value: string | number) => void
+}
+
+// ============================================================
+// JwtColumnItme - 表格列内容渲染器
+// ============================================================
+
+export interface JwtColumnItmeProps {
+  /** 列配置项 */
+  item?: Record<string, any>
+  /** 当前行数据 */
+  row?: Record<string, any>
+  /** 当前行索引 */
+  index?: number
+  /** 分页起始索引 */
+  pagestart?: number
+}
+
+export interface JwtColumnItmeEmits {
+  /** 值变化 (编辑模式下) */
+  change: (appModel: any, item: any) => void
+  /** 单元格点击 */
+  'click-cell': (appModel: any, item: any) => void
+  /** v-model 更新 */
+  'update:modelValue': (appModel: any) => void
+  /** 文件预览 */
+  'show-file': (url: string) => void
+}
+
+export interface JwtColumnItmeSlots {
+  /** 动态透传插槽，名称由父组件决定，props: { scope } */
+  [slotName: string]: Slot<any> | undefined
+}
+
+// Column 子组件共享 Props
+export interface ColumnItemCommonProps {
+  /** 列配置项 */
+  item?: Record<string, any>
+  /** 当前行数据 */
+  row?: Record<string, any>
+  /** 完整数据源 */
+  sourceData?: Record<string, any>
+}
+
+/** 日期格式化列 */
+export interface ColumnDateTimeFormatProps extends ColumnItemCommonProps { modelValue?: string | number }
+/** 默认值显示列 */
+export interface ColumnDefaultProps extends ColumnItemCommonProps { index?: number }
+/** 文件列 */
+export interface ColumnFileProps extends ColumnItemCommonProps {}
+/** HTML 富文本列 */
+export interface ColumnHtmlProps extends ColumnItemCommonProps {}
+/** 单图列 */
+export interface ColumnImgProps extends ColumnItemCommonProps {}
+/** 可添加图片列 */
+export interface ColumnImgAddProps extends ColumnItemCommonProps {}
+/** 多图列 */
+export interface ColumnImgsProps extends ColumnItemCommonProps {}
+/** 链接列 */
+export interface ColumnLinkProps extends ColumnItemCommonProps {}
+/** 标签列 */
+export interface ColumnTagProps extends ColumnItemCommonProps {}
+/** 标签列表列 */
+export interface ColumnTagListProps extends ColumnItemCommonProps { tagType?: string; valKey?: string }
+/** 文本列 */
+export interface ColumnTextProps extends ColumnItemCommonProps {}
+/** 视频列 */
+export interface ColumnVideoProps extends ColumnItemCommonProps {}
+
+// ============================================================
+// JwtUploadImage - 图片上传
+// ============================================================
+
+export interface JwtUploadImageProps {
+  /** 图片路径 (v-model)，字符串或数组 */
+  modelValue?: string | any[]
+  /** 文件大小限制 (KB)，默认 2048 (2MB) */
+  limitSize?: string | number
+  /** 是否禁用 */
+  disabled?: boolean
+  /** 是否允许多选 */
+  multiple?: boolean
+  /** el-upload 列表类型，默认 'picture-card' */
+  listType?: string
+  /** 最大上传数量，默认 10 */
+  limit?: string | number
+  /** 上传额外参数 */
+  uploadParam?: Record<string, any>
+  /** 上传文件名前缀 */
+  uploadPrefixName?: string
+  /** 是否显示粘贴上传图片 */
+  copyImgUploade?: boolean
+  /** 是否校验文件类型，默认 true */
+  verifyFileType?: boolean
+  /** 上传字段名 */
+  uploadName?: string
+  /** 是否启用拖拽上传 */
+  dragUpload?: boolean
+}
+
+export interface JwtUploadImageEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: string | any[]) => void
+  /** 文件列表变化 */
+  onChange: (result: string | any[]) => void
+  /** 上传成功 */
+  success: (response: any) => void
+  /** 图片操作 (设为主图/设计等) */
+  'picture-action': (payload: { action: any; item: any }) => void
+}
+
+export interface JwtUploadImageSlots {
+  /** 自定义触发器内容 */
+  trigger?: Slot
+  /** 自定义文件渲染，仅在配置 mattingUrl 时生效，props: { file } */
+  file?: Slot<{ file: any }>
+}
+
+// ============================================================
+// JwtUploadFile - 文件上传
+// ============================================================
+
+export interface JwtUploadFileProps {
+  /** 文件路径 (v-model) */
+  modelValue?: string | any[]
+  /** 文件大小限制 (KB) */
+  limitSize?: string | number
+  /** 是否禁用 */
+  disabled?: boolean
+  /** 是否允许多选 */
+  multiple?: boolean
+  /** 最大上传数量，默认 10 */
+  limit?: string | number
+  /** 上传额外参数 */
+  uploadParam?: Record<string, any>
+  /** 模块标识 */
+  module?: string
+  /** 是否启用拖拽上传 */
+  dragUpload?: boolean
+}
+
+export interface JwtUploadFileEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: string | any[]) => void
+  /** 文件列表变化 */
+  onChange: (result: string | any[]) => void
+}
+
+// ============================================================
+// JwtUploadVideo - 视频上传
+// ============================================================
+
+export interface JwtUploadVideoProps {
+  /** 视频路径 (v-model) */
+  modelValue?: string | any[]
+  /** 文件大小限制 (KB) */
+  limitSize?: string | number
+  /** 是否禁用 */
+  disabled?: boolean
+  /** 是否允许多选 */
+  multiple?: boolean
+  /** 最大上传数量，默认 10 */
+  limit?: string | number
+  /** 上传额外参数 */
+  uploadParam?: Record<string, any>
+  /** 是否使用腾讯 COS SDK 上传 */
+  isCosSdk?: boolean
+  /** 是否 COS 批量上传 */
+  isCosBacthUpload?: boolean
+  /** 模块标识 */
+  module?: string
+  /** 是否启用拖拽上传 */
+  dragUpload?: boolean
+}
+
+export interface JwtUploadVideoEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: string | any[]) => void
+  /** 文件列表变化 */
+  onChange: (result: string | any[]) => void
+}
+
+// ============================================================
+// JwtFileUpload - 拖拽文件上传 (COS SDK)
+// ============================================================
+
+export interface JwtFileUploadProps {
+  /** 模块路径 */
+  module?: string
+  /** 标识 ID */
+  id?: string
+  /** 最大上传数量，默认 5 */
+  limit?: number
+  /** 文件列表 (v-model) */
+  modelValue?: any[]
+  /** 接受的文件类型 */
+  accept?: string
+  /** 文件大小限制 (KB) */
+  limitSize?: string | number
+  /** 是否使用 COS SDK，默认 true */
+  isCosSdk?: boolean
+  /** 是否 COS 批量上传，默认 true */
+  isCosBacthUpload?: boolean
+  /** 是否显示粘贴上传 */
+  copyImgUploade?: boolean
+}
+
+export interface JwtFileUploadEmits {
+  /** 非 COS 模式上传成功 */
+  'on-success': (uploadFiles: any) => void
+  /** v-model 更新 */
+  'update:modelValue': (value: any[]) => void
+  /** COS 上传成功 (单文件完成，isAllDone 表示是否全部完成) */
+  'upload-success': (file: any, isAllDone: boolean) => void
+}
+
+// ============================================================
+// JwtEditor - 富文本编辑器 (wangEditor)
+// ============================================================
+
+export interface JwtEditorProps {
+  /** 编辑器 HTML 内容 (v-model) */
+  modelValue?: string
+  /** 编辑器高度 (px)，默认 500 */
+  height?: string | number
+  /** 自定义工具栏 key 配置 */
+  toolbarKeys?: any[]
+  /** 需要排除的工具栏 key */
+  excludeKeys?: any[]
+  /** 上传自定义 headers，支持对象或函数 */
+  uploadHeaders?: Record<string, any> | (() => Record<string, any>)
+}
+
+export interface JwtEditorEmits {
+  /** v-model 更新 */
+  'update:modelValue': (html: string) => void
+}
+
+// ============================================================
+// JwtCropper - 图片裁剪
+// ============================================================
+
+export interface JwtCropperProps {
+  /** 待裁剪的图片 URL */
+  url?: string
+}
+
+export interface JwtCropperEmits {
+  /** 裁剪完成，返回 base64 图片数据 */
+  change: (imgBase64: string) => void
+}
+
+export interface JwtCropperExpose {
+  /** 销毁裁剪实例 */
+  handleDestroy(): void
+}
+
+// ============================================================
+// JwtCropperDialog - 弹窗裁剪
+// ============================================================
+
+export interface JwtCropperDialogProps {
+  /** 待裁剪的图片 URL */
+  url?: string
+}
+
+export interface JwtCropperDialogEmits {
+  /** 用户点击"上传保存"时触发，返回裁剪后的 base64 */
+  select: (imgBase64: string) => void
+  /** 裁剪变化时实时触发 */
+  change: (imgBase64: string) => void
+}
+
+export interface JwtCropperDialogExpose {
+  /** 打开弹窗 */
+  showDialogVisible(): void
+  /** 关闭弹窗 */
+  closeDialogVisible(): void
+}
+
+// ============================================================
+// JwtSelectServer - 服务端下拉选择
+// ============================================================
+
+export interface JwtSelectServerProps {
+  /** v-model 绑定值 */
+  modelValue?: string | number | any[]
+  /** 列表接口地址或函数 */
+  listApi?: string | ((...args: any[]) => string)
+  /** 新增选项接口地址 */
+  addApi?: string
+  /** 本地静态选项 */
+  options?: any[]
+  /** 数据源对象 (用于回显和动态参数) */
+  sourceData?: Record<string, any>
+  /** 显示文本字段名，默认 'title' */
+  labelKey?: string
+  /** 值字段名，默认 'id' */
+  valueKey?: string
+  /** 值类型，'number' | 'string' */
+  valueType?: string
+  /** 搜索字段名 */
+  searchKey?: string
+  /** 扩展标签字段 */
+  exLabelKey?: string
+  /** 头像字段名 (有值时显示头像) */
+  avatarKey?: string
+  /** 回显文本 */
+  modelValueName?: string | number | any[]
+  /** sourceData 中的取值路径 */
+  modelValueKey?: string
+  /** 是否用 value 作为初始搜索条件 */
+  searchValueKey?: boolean
+  /** 是否多选 */
+  multiple?: boolean
+  /** 是否禁用 */
+  disabled?: boolean
+  /** 每次聚焦是否重新请求 */
+  focusFetch?: boolean
+  /** 无数据时显示添加按钮 */
+  showAdd?: boolean
+  /** 始终显示添加按钮 */
+  alwaysAdd?: boolean
+  /** 行内快速添加模式 */
+  autoAdd?: boolean
+  /** 占位文本 */
+  placeholder?: string
+  /** 额外请求参数 */
+  exParams?: Record<string, any>
+  /** 新增时额外参数 */
+  addParams?: Record<string, any>
+}
+
+export interface JwtSelectServerEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: any) => void
+  /** 选中值变化 */
+  change: (val: any) => void
+  /** 完整选中项 (需配置 emitSelect) */
+  select: (result: any) => void
+  /** 请求新增选项 */
+  'add-option': () => void
+  /** 新增成功 */
+  'add-success': (res: any) => void
+}
+
+export interface JwtSelectServerSlots {
+  /** 自定义选项渲染，props: { list } */
+  default?: Slot<{ list: any[] }>
+}
+
+/** JwtSelectServer ref 暴露的方法 */
+export interface JwtSelectServerExpose {
+  /** 重新获取选项列表 */
+  getDataList(init?: boolean, refSearchVal?: string, refSearchKey?: string, req?: boolean): void
+  /** 手动设置选项数据 */
+  handleSetListData(list: any[]): void
+  /** 设置动态请求参数 */
+  handleSetDynamicParams(data: Record<string, any>): void
+  /** 清空选中 */
+  handleClear(): void
+}
+
+// ============================================================
+// JwtCascaderArea - 地区级联选择
+// ============================================================
+
+export interface JwtCascaderAreaProps {
+  /** v-model 绑定值 */
+  modelValue?: string | number | any[]
+}
+
+export interface JwtCascaderAreaEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: any) => void
+  /** 选中值变化 */
+  change: (val: any) => void
+}
+
+export interface JwtCascaderAreaExpose {
+  /** 地区数据列表 */
+  listData: Ref<any[]>
+  /** 重新获取数据 */
+  getDataList(): void
+}
+
+// ============================================================
+// JwtCascaderServer - 服务端级联选择
+// ============================================================
+
+export interface JwtCascaderServerProps {
+  /** v-model 绑定值 */
+  modelValue?: string | number | any[]
+  /** 无数据时显示添加按钮 */
+  showAdd?: boolean
+  /** 始终显示添加按钮 */
+  alwaysAdd?: boolean
+  /** 聚焦时重新请求 */
+  focusFetch?: boolean
+  /** 额外请求参数 */
+  exParams?: Record<string, any>
+  /** 显示层级过滤 */
+  showLevel?: string | number
+}
+
+export interface JwtCascaderServerEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: any) => void
+  /** 选中值变化 */
+  change: (val: any) => void
+  /** 请求新增选项 */
+  'add-option': () => void
+}
+
+export interface JwtCascaderServerExpose {
+  /** el-cascader 引用 */
+  JwtCascaderServerRef: Ref<any>
+  /** 级联选项数据 */
+  listData: Ref<any[]>
+  /** 获取数据 */
+  getDataList(req?: boolean): void
+}
+
+// ============================================================
+// JwtTree - 树形组件
+// ============================================================
+
+export interface JwtTreeProps {
+  /** 树形数据 */
+  treeData?: any[]
+  /** 节点唯一标识字段，默认 'id' */
+  nodeKey?: string
+  /** 节点标题字段，默认 'title' */
+  menuTitleKey?: string
+  /** 子节点字段，默认 'children' */
+  children?: string
+  /** 默认选中的节点 key */
+  checkedKeys?: any[]
+  /** 默认展开所有节点，默认 true */
+  expandAll?: boolean
+  /** 菜单 ID 映射对象 */
+  menusIdObj?: Record<string, any>
+  /** 是否显示右侧导航 */
+  showNav?: boolean
+  /** 是否禁用所有节点 */
+  disabled?: boolean
+}
+
+export interface JwtTreeEmits {
+  /** 选中节点变化 */
+  'update:checked-keys': (keys: any[]) => void
+  /** 节点勾选变化 */
+  change: (payload: { key: string; checked: boolean; level: number; data: any; checkedKeys: any[]; halfCheckedKeys: any[] }) => void
+  /** 节点展开/折叠 */
+  toggle: (node: any, nodeChildrenMenuId: any[]) => void
+  /** 导航标签切换 */
+  'tab-change': (val: string) => void
+}
+
+// ============================================================
+// JwtTabs - 标签页
+// ============================================================
+
+export interface JwtTabsProps {
+  /** 标签页配置 (tabPaneList, tabsAttrs, activeName) */
+  config: Record<string, any>
+  /** 当前页面路径 (权限匹配) */
+  currentPath?: string
+  /** 菜单权限对象 */
+  menusObj?: Record<string, any>
+  /** 传递给子组件的额外数据 */
+  info: Record<string, any>
+  /** 是否缓存组件状态，默认 true */
+  keepAlive?: boolean
+}
+
+export interface JwtTabsEmits {
+  /** 标签页点击 */
+  'tab-click': (tab: any, event: Event, currentComponent: any) => void
+}
+
+export interface JwtTabsExpose {
+  /** 当前激活的子组件实例引用 */
+  componentRef: Ref<any>
+  /** 编程式切换标签 */
+  handleChangeTab(name: string): void
+}
+
+// ============================================================
+// JwtTags - 标签选择/展示
+// ============================================================
+
+export interface JwtTagsProps {
+  /** 标签值 (v-model)，逗号分隔字符串或对象数组 */
+  modelValue?: string | any[]
+  /** 添加按钮文字，默认 '添加' */
+  btnTitle?: string
+  /** 是否禁用 */
+  disabled?: boolean
+  /** 数组项的标签字段，默认 'title' */
+  labelKey?: string
+  /** 数组项的值字段，默认 'id' */
+  valueKey?: string
+  /** 是否使用对象数组模式 */
+  isArray?: boolean
+  /** 是否使用输入框样式 */
+  isInput?: boolean
+}
+
+export interface JwtTagsEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: string | any[]) => void
+}
+
+// ============================================================
+// JwtImage - 图片展示
+// ============================================================
+
+export interface JwtImageProps {
+  /** 图片填充模式，默认 'cover' */
+  fit?: string
+  /** 图片地址，多图用逗号分隔 */
+  src?: string
+  /** 覆盖图标类型: 'search' | 'add' | 'delete' */
+  type?: string
+  /** 是否多图模式 */
+  multiple?: boolean
+}
+
+// ============================================================
+// JwtIcon - 图标 (remixicon)
+// ============================================================
+
+export interface JwtIconProps {
+  /** 图标名称，默认 'settings-3-line' */
+  icon?: string
+  /** 图标大小 */
+  size?: string | number
+  /** 是否为自定义图标 */
+  isCustom?: boolean
+  /** 是否为自定义 SVG 图标 */
+  isCustomSvg?: boolean
+  /** SVG 名称前缀，默认 'icon-' */
+  prefixSvg?: string
+}
+
+// ============================================================
+// JwtIconSelect - 图标选择器
+// ============================================================
+
+export interface JwtIconSelectProps {
+  /** 当前选中图标名称 (v-model) */
+  modelValue?: string
+}
+
+export interface JwtIconSelectEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: string) => void
+  /** 图标变化 */
+  change: (icon: string) => void
+  /** 图标选中 */
+  select: (item: { icon: string; name: string; isCustom: boolean }) => void
+}
+
+// ============================================================
+// JwtEmojiSelect - 表情选择器
+// ============================================================
+
+export interface JwtEmojiSelectProps {
+  /** 预览位置，默认 'top' */
+  previewPosition?: string
+  /** 肤色选择位置 */
+  skinTonePosition?: string
+  /** 主题，默认 'light' */
+  theme?: string
+  /** 语言，默认 'zh' */
+  locale?: string
+  /** 当前选中表情 (v-model) */
+  modelValue?: string
+}
+
+export interface JwtEmojiSelectEmits {
+  /** 表情选中 */
+  select: (emoji: { id: string; name: string; native: string; unified: string; keywords: string[]; shortcodes: string }) => void
+  /** v-model 更新 */
+  'update:modelValue': (value: string) => void
+}
+
+// ============================================================
+// JwtFileIcon - 文件类型图标
+// ============================================================
+
+export interface JwtFileIconProps {
+  /** 文件 URL */
+  url?: string
+  /** 图标大小，默认 45 */
+  size?: number
+  /** 提示文字 */
+  title?: string
+  /** 是否显示为图片 */
+  showImg?: boolean
+}
+
+export interface JwtFileIconEmits {
+  /** 文件预览 */
+  'show-file': (url: string) => void
+}
+
+// ============================================================
+// JwtMaterial - 素材库
+// ============================================================
+
+export interface JwtMaterialProps {
+  /** 是否多选，默认 true */
+  multiple?: boolean
+  /** 是否为已使用素材模式 */
+  used?: boolean
+  /** 素材库配置 */
+  config?: Record<string, any>
+}
+
+export interface JwtMaterialEmits {
+  /** 删除成功 */
+  'delete-success': () => void
+  /** 删除操作 */
+  'on-delete': (result: any) => void
+  /** 编辑操作 */
+  'on-edit': (item: any) => void
+  /** 编辑成功 */
+  'edit-success': () => void
+  /** 选中素材 */
+  select: (selectedItems: any[]) => void
+  /** v-model 更新 */
+  'update:modelValue': (value: any) => void
+  /** 抠图操作 */
+  'on-matting': (ids: string) => void
+  /** 抠图成功 */
+  'matting-success': () => void
+}
+
+export interface JwtMaterialSlots {
+  /** 树节点自定义渲染，props: { node, data } */
+  default?: Slot<{ node: any; data: any }>
+}
+
+// ============================================================
+// JwtMaterialItemMask - 素材项遮罩层
+// ============================================================
+
+export interface JwtMaterialItemMaskProps {
+  /** 素材项数据 */
+  item?: Record<string, any>
+  /** 素材项索引 */
+  index?: number
+  /** 是否显示删除按钮 */
+  showDelete?: boolean
+  /** 是否显示编辑按钮 */
+  showEdit?: boolean
+  /** 是否显示选中框，默认 true */
+  showChecked?: boolean
+}
+
+export interface JwtMaterialItemMaskEmits {
+  /** 预览图片 */
+  previewImg: (index: number, item: any) => void
+  /** 删除 */
+  delete: (index: number, item: any) => void
+  /** 切换编辑 */
+  toggleEdit: (index: number, item: any) => void
+}
+
+// ============================================================
+// JwtRateIcon - 评分组件
+// ============================================================
+
+export interface JwtRateIconProps {
+  /** 当前评分值 (v-model) */
+  modelValue?: number | string
+  /** 图标大小，默认 18 */
+  size?: number | string
+  /** 是否禁用 */
+  disabled?: boolean
+  /** 未选中图标，默认 'star-line' */
+  voidIcon?: string
+  /** 选中图标，默认 'star-fill' */
+  icon?: string
+  /** 选中颜色，默认 '#f7ba2a' */
+  color?: string
+  /** 未选中颜色，默认 '#c6d1de' */
+  voidColor?: string
+  /** 最大分值，默认 5 */
+  max?: number | string
+}
+
+export interface JwtRateIconEmits {
+  /** v-model 更新 */
+  'update:modelValue': (value: number) => void
+  /** 评分变化 */
+  change: (value: number) => void
+}
+
+// ============================================================
+// JwtCount - 数字动画
+// ============================================================
+
+export interface JwtCountProps {
+  /** 起始值，默认 0 */
+  startVal?: number
+  /** 结束值，默认 0 */
+  endVal?: number
+  /** 动画时长 (ms)，默认 3000 */
+  duration?: number
+  /** 是否自动播放，默认 true */
+  autoplay?: boolean
+  /** 小数位数，默认 0 */
+  decimals?: number
+  /** 小数点符号，默认 '.' */
+  decimal?: string
+  /** 千分位分隔符，默认 ',' */
+  separator?: string
+  /** 前缀 */
+  prefix?: string
+  /** 后缀 */
+  suffix?: string
+  /** 是否使用缓动动画，默认 true */
+  useEasing?: boolean
+  /** 自定义缓动函数 */
+  easingFn?: (t: number, b: number, c: number, d: number) => number
+}
+
+export interface JwtCountEmits {
+  /** 挂载完成回调 */
+  mountedCallback: () => void
+  /** 动画完成回调 */
+  callback: () => void
+}
+
+export interface JwtCountExpose {
+  /** 开始动画 */
+  start(): void
+  /** 暂停/恢复 */
+  pauseResume(): void
+  /** 暂停 */
+  pause(): void
+  /** 恢复 */
+  resume(): void
+  /** 重置 */
+  reset(): void
+}
+
+// ============================================================
+// JwtDesHeader - 描述区域标题
+// ============================================================
+
+export interface JwtDesHeaderProps {
+  /** 标题文字 */
+  title?: string
+  /** 提示信息 */
+  tips?: string
+  /** 是否显示边框 */
+  border?: boolean
+  /** 提示是否在 hover 时显示，默认 true */
+  tipsHover?: boolean
+}
+
+export interface JwtDesHeaderSlots {
+  /** 标题左侧区域 */
+  left?: Slot
+  /** 标题右侧区域 */
+  default?: Slot
+}
+
+// ============================================================
+// JwtDesInfo - 描述信息展示
+// ============================================================
+
+export interface JwtDesInfoProps {
+  /** 描述配置 */
+  config?: Record<string, any>
+  /** 数据信息 */
+  info?: Record<string, any>
+  /** 用户菜单权限 */
+  userMenusAuth?: Record<string, any>
+  /** 当前页面路径 */
+  currentPagePath?: string
+}
+
+export interface JwtDesInfoEmits {
+  /** 表头按钮操作 */
+  'header-action': (action: any) => void
+  /** 值变化 */
+  change: (row: any, item: any, source: string) => void
+  /** 单元格点击 */
+  'click-cell': (row: any, item: any) => void
+  /** 内联编辑成功 */
+  'des-edit-success': (item: any) => void
+}
+
+export interface JwtDesInfoSlots {
+  /** 动态插槽，名称由 item.slotName 或 item.prop 决定，props: { scope: info } */
+  [slotName: string]: Slot<any> | undefined
+}
+
+// ============================================================
+// JwtDesTable - 描述表格
+// ============================================================
+
+export interface JwtDesTableProps {
+  /** 描述表格配置 */
+  config: Record<string, any>
+  /** 详情数据 */
+  detailInfo: Record<string, any>
+  /** 用户菜单权限 */
+  userMenusAuth?: Record<string, any>
+  /** 当前页面路径 */
+  currentPagePath?: string
+}
+
+export interface JwtDesTableEmits {
+  /** 表头按钮操作 */
+  'header-action': (action: any) => void
+  /** 值变化 */
+  change: (row: any, item: any, source: string) => void
+  /** 单元格点击 */
+  'click-cell': (row: any, item: any) => void
+  /** 内联编辑成功 */
+  'des-edit-success': (item: any) => void
+}
+
+export interface JwtDesTableSlots {
+  /** 标题插槽 (名称由 config.titleSlotName 决定)，props: { scope } */
+  title?: Slot<{ scope: any }>
+  /** 额外区域 (名称由 config.extraSlotName 决定)，props: { scope } */
+  extra?: Slot<{ scope: any }>
+  /** 动态列插槽，名称由 item.prop 决定，props: { index, scope } */
+  [propName: string]: Slot<any> | undefined
+}
+
+// ============================================================
+// JwtDetailDrawer - 详情抽屉
+// ============================================================
+
+export interface JwtDetailDrawerProps {
+  /** 抽屉配置 */
+  config?: Record<string, any>
+  /** 用户菜单权限 */
+  userMenusAuth?: Record<string, any>
+  /** 当前页面路径 */
+  currentPagePath?: string
+  /** 当前页面抽屉配置 */
+  currentPageDrawerConfig?: Record<string, any>
+  /** 已打开的页面抽屉配置列表 */
+  openPageDrawerConfigList?: any[]
+  /** 数据信息 */
+  info?: Record<string, any>
+  /** 请求参数 */
+  params?: Record<string, any>
+  /** 当前行数据 */
+  row?: Record<string, any>
+  /** 是否缓存组件，默认 true */
+  keepAlive?: boolean
+}
+
+export interface JwtDetailDrawerEmits {
+  /** 表头按钮操作 */
+  'header-action': (action: any, selectionRow: any[], detailInfo: any) => void
+  /** 获取详情成功 */
+  'get-detail-success': (response: any) => void
+  /** 内联编辑成功 */
+  'des-edit-success': (response: any, code: string) => void
+  /** 通用事件透传 */
+  'event-name': (...args: any[]) => void
+  /** 刷新关联表格 */
+  'refresh-table': () => void
+  /** 关闭抽屉 */
+  'close-drawer': () => void
+  /** 返回上一级抽屉 */
+  'back-drawer': () => void
+  /** 推入新抽屉 */
+  'push-drawer': (data: any) => void
+  /** 删除成功 */
+  'delete-success': () => void
+  /** 新增成功 */
+  'add-success': (data: any) => void
+  /** 编辑成功 */
+  'edit-success': (data: any) => void
+  /** 底部操作 */
+  'footer-action': (type: string, model: any) => void
+  /** 单元格点击 */
+  'click-cell': (row: any, item: any) => void
+  /** 值变化 */
+  change: (row: any, item: any) => void
+  /** 标签切换 */
+  'tab-click': (tab: any, event: Event) => void
+}
+
+export interface JwtDetailDrawerSlots {
+  /** 头部图标之前 */
+  'drawer-header-icon'?: Slot<{ row: any }>
+  /** 头部图标之后 */
+  'drawer-header-icon-after'?: Slot<{ row: any }>
+  /** 头部按钮之前 */
+  'header-btn-before'?: Slot<{ row: any }>
+  /** 头部按钮之后 */
+  'header-btn-after'?: Slot<{ row: any }>
+  /** 内容区域之前 */
+  'drawer-content-before'?: Slot<{ row: any; scope: any }>
+  /** 内容区域之后 */
+  'drawer-content-after'?: Slot<{ row: any; scope: any }>
+  /** 弹窗底部之前 */
+  'dialog-footer-before'?: Slot<{ model: any }>
+  /** 弹窗底部之后 */
+  'dialog-footer-after'?: Slot<{ model: any }>
+  /**
+   * 动态插槽，支持:
+   * - 头部插槽 (由 config.headerSlotName 决定)，props: { scope }
+   * - 内容插槽 (由 config.contentSlotName 决定)，props: { row, scope }
+   * - 表单插槽 (由 formList 项的 name 决定)，props: { model }
+   */
+  [slotName: string]: Slot<any> | undefined
+}
+
+export interface JwtDetailDrawerExpose {
+  /** 刷新抽屉详情数据 */
+  handleRefreshDrawerDetail(): void
+  /** 显示抽屉 */
+  handleShowDrawer(): void
+  /** 关闭抽屉 */
+  handleCloseDrawer(): void
+  /** 返回上一级 */
+  handleDrawerBack(): void
+  /** 处理表头操作 */
+  handleHeaderAction(action: any): void
+  /** 弹窗操作 */
+  handleBox(action: any, box: any): void
+}
+
+// ============================================================
+// JwtHeaderButton - 表头操作按钮
+// ============================================================
+
+export interface JwtHeaderButtonProps {
+  /** 是否加载中 */
+  loading?: boolean
+  /** 当前页面路径 */
+  currentPath?: string
+  /** 用户菜单权限对象 */
+  menusObj?: Record<string, any>
+  /** 当前选中行 */
+  selectionRow?: any[]
+  /** 操作按钮配置 */
+  config?: Record<string, any>
+  /** 文件导入配置 */
+  fileImport?: Record<string, any>
+  /** 当前行数据 */
+  row?: Record<string, any>
+  /** 操作属性名 */
+  operationName?: string
+  /** 是否显示图标，默认 true */
+  showIcon?: boolean
+  /** 是否显示文字，默认 true */
+  showText?: boolean
+  /** 上传成功回调 */
+  uploadSuccessCb?: Function
+  /** 数据总条数 */
+  totalCount?: number
+}
+
+export interface JwtHeaderButtonEmits {
+  /** 表头按钮操作 */
+  'header-action': (action: any, row?: any) => void
+  /** 上传成功 */
+  'upload-success': () => void
+}
+
+// ============================================================
+// JwtPrefixSuffix - 前缀/后缀包装器
+// ============================================================
+
+export interface JwtPrefixSuffixProps {
+  /** 列配置项 */
+  item?: Record<string, any>
+  /** 当前行数据 */
+  row?: Record<string, any>
+  /** 类型: 'pre' 前缀 | 'suf' 后缀 */
+  type?: 'pre' | 'suf'
+}
+
+// ============================================================
+// Exported Hooks & Utilities
+// ============================================================
+
+/** 记忆化计算属性，相同参数返回缓存结果 */
+export function useComputed<T>(fn: (...args: any[]) => T): (...args: any[]) => ComputedRef<T>
+
+/** 根据文件名获取文件图标信息 */
+export function getFileIcon(fileName?: string, type?: string): { icon: string; cls: string; file: string }
+
+/** 根据文件名获取文件类型 */
+export function getFileType(filename: string, typeName?: boolean, obj?: boolean): string | Record<string, any>
+
+/** 打开编辑弹窗 */
+export function handleDialogEdit(row: any, rowAction: any, appConfig: any, boxInfo: any, options?: any): void
+
+/** 获取弹窗标题 */
+export function getDialogTitle(isEdit: boolean, config: any, editBoxName: string, t?: (text: string) => string): string
+
+/** 处理表格操作按钮事件 */
+export function handleTableActions(action: { code: string }, row?: any, rowAction?: any, selectionRow?: any[], type?: string, options?: any): void
+
+/** 发送简单请求 */
+export function handleSimpleReq(
+  row: any,
+  rowAction: any,
+  code: string,
+  opt?: { selectionRow?: any[] | null; callback?: (res: any, code: string) => void; cancel?: boolean; rowKey?: string }
+): void
+
+/** 表格按钮逻辑 hook */
+export function useTableButton(
+  props: {
+    config?: Record<string, any>
+    row?: Record<string, any>
+    selectionRow?: any[]
+    menusObj?: Record<string, any>
+    currentPath?: string
+    operationName?: string
+    showButtonNum?: number | string
+    totalCount?: number
+    loading?: boolean
+    fileImport?: Record<string, any>
+    tableCopyText?: string
+  },
+  position?: 'table' | 'header'
+): {
+  visibleActions: ComputedRef<any[]>
+  hasOverflowActions: ComputedRef<boolean>
+  tableButtonActions: ComputedRef<any[]>
+}
+
+/** 表单项数据 hook */
+export function useFormItem(props: any, emit: any): {
+  itemOptions: ComputedRef<any>
+  itemAttrs: Record<string, any>
+  itemText: ComputedRef<any>
+  renderText: ComputedRef<any>
+  imgUrl: ComputedRef<any>
+  listUrl: ComputedRef<any>
+  previewUrl: ComputedRef<any[]>
+  itemTagType: ComputedRef<string>
+  defaultImgUrl: ComputedRef<string>
+  errorImgUrl: ComputedRef<string>
+  handleChange(val: any): void
+  handleGetList(listData: Ref<any[]>, req?: boolean): void
+}
+
+// ============================================================
+// Global Component Registration - 全局组件注册
+// ============================================================
+
+declare module '@vue/runtime-core' {
+  export interface GlobalComponents {
+    /** 数据表格 - 包含搜索、工具栏、分页、弹窗编辑 */
+    JwtTable: DefineComponent<JwtTableProps>
+    /** 数据表格 V2 - 优化版，接口与 JwtTable 一致 */
+    JwtTableV2: DefineComponent<JwtTableV2Props>
+    /** 纯表格 - 无工具栏和分页 */
+    JwtTableOnly: DefineComponent<JwtTableOnlyProps>
+    /** 表格行操作按钮 */
+    JwtTableButton: DefineComponent<JwtTableButtonProps>
+    /** 动态表单 */
+    JwtForm: DefineComponent<JwtFormProps>
+    /** 表单项渲染器 */
+    JwtFormItem: DefineComponent<JwtFormItemProps>
+    /** 弹窗表单 */
+    JwtDialogForm: DefineComponent<JwtDialogFormProps>
+    /** 带变更标记的输入框 */
+    JwtInput: DefineComponent<JwtInputProps>
+    /** 表格列内容渲染器 */
+    JwtColumnItme: DefineComponent<JwtColumnItmeProps>
+    /** 日期格式化列 */
+    ColumnDateTimeFormat: DefineComponent<ColumnDateTimeFormatProps>
+    /** 默认值显示列 */
+    ColumnDefault: DefineComponent<ColumnDefaultProps>
+    /** 文件列 */
+    ColumnFile: DefineComponent<ColumnFileProps>
+    /** HTML 富文本列 */
+    ColumnHtml: DefineComponent<ColumnHtmlProps>
+    /** 单图列 */
+    ColumnImg: DefineComponent<ColumnImgProps>
+    /** 可添加图片列 */
+    ColumnImgAdd: DefineComponent<ColumnImgAddProps>
+    /** 多图列 */
+    ColumnImgs: DefineComponent<ColumnImgsProps>
+    /** 链接列 */
+    ColumnLink: DefineComponent<ColumnLinkProps>
+    /** 标签列 */
+    ColumnTag: DefineComponent<ColumnTagProps>
+    /** 标签列表列 */
+    ColumnTagList: DefineComponent<ColumnTagListProps>
+    /** 文本列 */
+    ColumnText: DefineComponent<ColumnTextProps>
+    /** 视频列 */
+    ColumnVideo: DefineComponent<ColumnVideoProps>
+    /** 图片上传 */
+    JwtUploadImage: DefineComponent<JwtUploadImageProps>
+    /** 文件上传 */
+    JwtUploadFile: DefineComponent<JwtUploadFileProps>
+    /** 视频上传 */
+    JwtUploadVideo: DefineComponent<JwtUploadVideoProps>
+    /** 拖拽文件上传 (COS SDK) */
+    JwtFileUpload: DefineComponent<JwtFileUploadProps>
+    /** 富文本编辑器 (wangEditor) */
+    JwtEditor: DefineComponent<JwtEditorProps>
+    /** 图片裁剪 */
+    JwtCropper: DefineComponent<JwtCropperProps>
+    /** 弹窗裁剪 */
+    JwtCropperDialog: DefineComponent<JwtCropperDialogProps>
+    /** 服务端下拉选择 */
+    JwtSelectServer: DefineComponent<JwtSelectServerProps>
+    /** 地区级联选择 */
+    JwtCascaderArea: DefineComponent<JwtCascaderAreaProps>
+    /** 服务端级联选择 */
+    JwtCascaderServer: DefineComponent<JwtCascaderServerProps>
+    /** 树形组件 */
+    JwtTree: DefineComponent<JwtTreeProps>
+    /** 标签页 */
+    JwtTabs: DefineComponent<JwtTabsProps>
+    /** 标签选择/展示 */
+    JwtTags: DefineComponent<JwtTagsProps>
+    /** 图片展示 */
+    JwtImage: DefineComponent<JwtImageProps>
+    /** 图标 (remixicon) */
+    JwtIcon: DefineComponent<JwtIconProps>
+    /** 图标选择器 */
+    JwtIconSelect: DefineComponent<JwtIconSelectProps>
+    /** 表情选择器 */
+    JwtEmojiSelect: DefineComponent<JwtEmojiSelectProps>
+    /** 文件类型图标 */
+    JwtFileIcon: DefineComponent<JwtFileIconProps>
+    /** 素材库 */
+    JwtMaterial: DefineComponent<JwtMaterialProps>
+    /** 素材项遮罩层 */
+    JwtMaterialItemMask: DefineComponent<JwtMaterialItemMaskProps>
+    /** 评分组件 */
+    JwtRateIcon: DefineComponent<JwtRateIconProps>
+    /** 数字动画 */
+    JwtCount: DefineComponent<JwtCountProps>
+    /** 描述区域标题 */
+    JwtDesHeader: DefineComponent<JwtDesHeaderProps>
+    /** 描述信息展示 */
+    JwtDesInfo: DefineComponent<JwtDesInfoProps>
+    /** 描述表格 */
+    JwtDesTable: DefineComponent<JwtDesTableProps>
+    /** 详情抽屉 */
+    JwtDetailDrawer: DefineComponent<JwtDetailDrawerProps>
+    /** 表头操作按钮 */
+    JwtHeaderButton: DefineComponent<JwtHeaderButtonProps>
+    /** 前缀/后缀包装器 */
+    JwtPrefixSuffix: DefineComponent<JwtPrefixSuffixProps>
+  }
+}