@antsoo-lib/core 3.0.0 → 3.0.1

package/src/render/types.ts

@@ -1,567 +1,567 @@
-import type {
-  ButtonProps,
-  CascaderProps,
-  CheckboxGroupProps,
-  CheckboxProps,
-  ColProps,
-  DatePickerProps,
-  InputNumberProps,
-  InputProps,
-  RadioGroupProps,
-  RowProps,
-  SelectProps,
-  SwitchProps,
-  TreeProps,
-  TreeSelectProps,
-  UploadProps,
-} from '@antsoo-lib/components'
-import type { AnyObject, VoidFunction } from '@antsoo-lib/shared'
-
-import type { VNode } from 'vue'
-
-import type { CustomToolbarItem } from './Custom'
-import type { ToolbarState } from './state'
-
-// 事件处理函数类型定义
-export type ToolbarEventHandler = VoidFunction
-
-// 基础事件接口
-export interface BaseEvents {
-  [key: string]: ToolbarEventHandler | undefined
-}
-
-export interface BaseToolbarItem {
-  key?: string
-  label?: string
-  permission?: string
-  beforeCreate?: boolean | ((toolbarState: ToolbarState) => boolean)
-  disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean)
-  props?: Record<string, any>
-  events?: BaseEvents
-}
-
-// 按钮工具栏项目
-export interface ButtonToolbarItem extends BaseToolbarItem {
-  type: 'button'
-  props?: Partial<ButtonProps> & { loading?: boolean; disabled?: boolean }
-  events?: BaseEvents & {
-    onClick?: (
-      loadingControl: { setLoading: (loading: boolean) => void; getLoading: () => boolean },
-      allValues: AnyObject,
-      toolbarState: ToolbarState,
-      ...args: any[]
-    ) => void
-  }
-}
-
-// 插槽配置接口
-export interface SlotConfig {
-  // 插槽内容可以是组件配置或渲染函数
-  content?:
-    | {
-        component: any // 组件
-        key: string // 主表字段
-        props?: AnyObject // 组件属性
-        events?: Record<string, VoidFunction> // 组件事件
-        options?: Array<{ label: string; value: any }> // 选项数据（用于select等）
-      }
-    | ((toolbarState: ToolbarState) => VNode)
-}
-
-// 输入框工具栏项目
-export interface InputToolbarItem extends BaseToolbarItem {
-  type: 'input'
-  props?: Partial<InputProps> & { value?: string; autoFocus?: boolean }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onFocus?: VoidFunction
-    onFocusCapture?: VoidFunction
-    onBlur?: VoidFunction
-    onBlurCapture?: VoidFunction
-  }
-  textarea?: boolean
-  // 插槽配置
-  slots?: {
-    addonBefore?: SlotConfig
-    addonAfter?: SlotConfig
-    prefix?: SlotConfig
-    suffix?: SlotConfig
-  }
-}
-
-// 单选框工具栏项目
-export interface RadioGroupToolbarItem extends BaseToolbarItem {
-  type: 'radioGroup'
-  props?: Partial<RadioGroupProps> & { value?: any }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-// 复选框工具栏项目
-export interface CheckboxToolbarItem extends BaseToolbarItem {
-  type: 'checkbox'
-  props?: Partial<CheckboxProps> & { checked?: boolean; value?: boolean }
-  events?: BaseEvents & {
-    'onUpdate:checked'?: (
-      checked: boolean,
-      allValues: AnyObject,
-      toolbarState: ToolbarState,
-    ) => void
-    onChange?: (event: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    'onUpdate:value'?: (checked: boolean, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-  label?: string // 复选框后面显示的文案
-}
-
-// 开关工具栏项目
-export interface SwitchToolbarItem extends BaseToolbarItem {
-  type: 'switch'
-  props?: Partial<SwitchProps> & { checked?: boolean }
-  events?: BaseEvents & {
-    'onUpdate:checked'?: (
-      checked: boolean,
-      allValues: AnyObject,
-      toolbarState: ToolbarState,
-    ) => void
-    onChange?: (checked: boolean, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-// 复选框组工具栏项目
-export interface CheckboxGroupToolbarItem extends BaseToolbarItem {
-  type: 'checkboxGroup'
-  props?: Partial<CheckboxGroupProps> & { value?: any[] }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any[], allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (checkedValues: any[], allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-// 日期选择器工具栏项目
-export interface DatePickerToolbarItem extends BaseToolbarItem {
-  type: 'datePicker'
-  props?: Partial<DatePickerProps> & { value?: any; autoFocus?: boolean }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onFocus?: VoidFunction
-  }
-  range?: boolean
-}
-
-export interface SelectToolbarItem extends BaseToolbarItem {
-  type: 'select'
-  props?: Partial<SelectProps> & {
-    value?: any
-    options?: any[] | ((values: AnyObject) => any[])
-  }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-// 级联选择器工具栏项目
-export interface CascaderToolbarItem extends BaseToolbarItem {
-  type: 'cascader'
-  props?: Partial<CascaderProps> & { value?: any }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-// 地区级联选择器属性定义
-export interface AreaCascaderProps {
-  value?: any[]
-  placeholder?: string
-  disabled?: boolean
-  allowClear?: boolean
-  [key: string]: any
-}
-
-// 地区级联选择器工具栏项目
-export interface AreaCascaderToolbarItem extends BaseToolbarItem {
-  type: 'areaCascader'
-  props?: AreaCascaderProps
-  attr?: Record<string, any>
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    selectedArea?: (area: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-// 树选择器工具栏项目
-export interface TreeSelectToolbarItem extends BaseToolbarItem {
-  type: 'treeSelect'
-  props?: Partial<TreeSelectProps> & {
-    value?: any
-    options?: any[] | ((values: AnyObject) => any[])
-  }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-export interface TreeToolbarItem extends BaseToolbarItem {
-  type: 'tree'
-  props?: Partial<TreeProps> & {
-    checkedKeys?: any[]
-    expandedKeys?: any[]
-  }
-  events?: BaseEvents & {
-    'onUpdate:checkedKeys'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    'onUpdate:expandedKeys'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onCheck?: (value: any, info: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onExpand?: (value: any, info: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-export interface InputRangeToolbarItem extends BaseToolbarItem {
-  type: 'inputRange'
-  props?: {
-    startProps?: Record<string, unknown>
-    endProps?: Record<string, unknown>
-    separator?: string
-    startPlaceholder?: string
-    endPlaceholder?: string
-    style?: AnyObject
-    className?: string
-    allowClear?: boolean
-  }
-  attr?: string[]
-  events?: BaseEvents & {
-    'onUpdate:value'?: (
-      value: [string, string],
-      allValues: AnyObject,
-      toolbarState: ToolbarState,
-    ) => void
-    onChange?: (value: [string, string], allValues: AnyObject, toolbarState: ToolbarState) => void
-    onStartChange?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onEndChange?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-export interface InputNumberToolbarItem extends BaseToolbarItem {
-  type: 'inputNumber'
-  props?: Partial<InputNumberProps> & {
-    value?: any
-    autoFocus?: boolean
-    xmoney?: boolean
-    xprice?: boolean
-    xweight?: boolean
-    xtaxrate?: boolean
-    xnumber?: boolean
-  }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onStep?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onFocus?: VoidFunction
-    onFocusCapture?: VoidFunction
-    onBlur?: VoidFunction
-    onBlurCapture?: VoidFunction
-  }
-  slots?: {
-    addonBefore?: SlotConfig
-    addonAfter?: SlotConfig
-    prefix?: SlotConfig
-    suffix?: SlotConfig
-  }
-}
-
-export interface InputPasswordToolbarItem extends BaseToolbarItem {
-  type: 'inputPassword'
-  props?: Partial<InputProps> & { value?: string }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-  textarea?: boolean
-  // 插槽配置
-  slots?: {
-    addonBefore?: SlotConfig
-    addonAfter?: SlotConfig
-    prefix?: SlotConfig
-    suffix?: SlotConfig
-  }
-}
-
-export interface UploadToolbarItem extends BaseToolbarItem {
-  type: 'upload'
-  props?: Partial<UploadProps> & {
-    value?: any[]
-    // 基础属性
-    placeholder?: string
-    allowClear?: boolean
-    disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean)
-    multiple?: boolean
-    maxCount?: number
-    listType?: 'text' | 'picture' | 'picture-card'
-
-    // 接口配置
-    api?: {
-      url: string
-      method?: 'GET' | 'POST'
-      headers?: Record<string, string>
-    }
-
-    // 额外参数配置
-    extraParams?: AnyObject | ((allValues: AnyObject, toolbarState: ToolbarState) => AnyObject)
-
-    // 数据映射配置
-    dataMapping?: {
-      list?: string // 文件列表字段路径
-      url?: string // 文件URL字段
-      name?: string // 文件名字段
-      status?: string // 文件状态字段
-    }
-
-    // UI 配置
-    buttonText?: string // 上传按钮文本，默认为"点击上传"
-    placeholderSrc?: string // picture-card 模式下的占位符图片地址
-    placeholderAlt?: string // 占位符图片的 alt 属性
-    placeholderClass?: string // 占位符图片的 CSS 类名
-    placeholderStyle?: AnyObject // 占位符图片的内联样式
-
-    // 其他配置
-    transformData?: (data: any) => any
-    beforeUpload?: (file: File, fileList: File[]) => boolean | Promise<boolean>
-    onPreview?: (file: any) => void
-    onRemove?: (file: any) => boolean | Promise<boolean>
-  }
-
-  // 文件类型限制配置
-  passage?: 'image' | 'pdf' | 'word' | 'excel' | 'video' | 'audio' | string
-
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (info: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onSuccess?: (response: any, file: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onError?: (error: any, file: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-// SselectPage 属性定义
-export interface SselectPageProps {
-  value?: any
-  placeholder?: string
-  allowClear?: boolean
-  showSearch?: boolean
-  disabled?: boolean
-  maxTagCount?: number | 'responsive'
-  size?: 'large' | 'middle' | 'small'
-  mode?: 'multiple' | 'tags'
-  params?: AnyObject
-  api: {
-    url: string
-    method?: 'GET' | 'POST'
-    headers?: Record<string, string>
-    params?: AnyObject
-    data?: AnyObject
-    request?: (config: {
-      method?: 'GET' | 'POST'
-      url: string
-      headers?: Record<string, string>
-      params?: AnyObject
-      data?: AnyObject
-    }) => Promise<any>
-  }
-  dataMapping?: {
-    list?: string
-    total?: string
-    value?: string
-    label?: string
-  }
-  pagination?: boolean
-  paginationConfig?: {
-    pageField?: string
-    pageSizeField?: string
-    searchField?: string
-    searchContains?: string
-  }
-  pageSize?: number
-  searchDelay?: number
-  extraParams?: AnyObject | ((allValues: AnyObject, toolbarState: ToolbarState) => AnyObject)
-  transformData?: (data: any) => any
-  autoLoad?: boolean
-  autoFocus?: boolean
-  attr?: Record<string, string>
-  [key: string]: any
-}
-
-export interface SselectPageToolbarItem extends BaseToolbarItem {
-  type: 'sselectPage'
-  props?: SselectPageProps & {
-    disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean)
-  }
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (
-      value: any,
-      option: any,
-      allOptions: any,
-      allValues: AnyObject,
-      toolbarState: ToolbarState,
-    ) => void
-    onSearch?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onClear?: (allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-export interface AutoCompleteProps {
-  value?: any
-  options?: any[]
-  placeholder?: string
-  disabled?: boolean
-  allowClear?: boolean
-  [key: string]: any
-}
-
-export interface AutoCompleteToolbarItem extends BaseToolbarItem {
-  type: 'autoComplete'
-  props?: AutoCompleteProps
-  events?: BaseEvents & {
-    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onSelect?: (value: any, option: any, allValues: AnyObject, toolbarState: ToolbarState) => void
-    onSearch?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
-  }
-}
-
-// ------------------------------
-// Input.Group 渲染器配置定义
-// ------------------------------
-export type InputGroupSize = 'large' | 'middle' | 'small' | 'default'
-export interface InputGroupPropsLike {
-  size?: InputGroupSize
-  compact?: boolean
-  prefixCls?: string
-}
-
-// 允许在工具栏中直接使用预设描述项（xtype）
-export type PresetXtype = 'add' | 'edit' | 'dels' | 'export' | 'print' | 'files'
-
-export interface FilesCategoryOption {
-  label: string
-  value: string
-  [key: string]: any
-}
-
-export interface FilesPresetConfig {
-  title?: string
-  // 单据类型：决定附件归属（UploadPopup 内部请求依赖该字段）
-  billtypeCode: string | ((row: AnyObject) => string)
-  // 分类下拉：UploadPopup 打开后默认选第一个，并按 category 拉历史列表
-  categoryOptions: FilesCategoryOption[] | ((row: AnyObject) => FilesCategoryOption[])
-  // objId 从行对象取值的字段名，默认 id
-  objIdKey?: string
-  accept?: string
-  passage?: 'image' | 'pdf' | 'word' | 'excel' | 'video' | 'audio' | string
-  maxFileSizeMB?: number
-  maxCount?: number
-  // 上传成功后是否刷新表格（由 SearchTable.openFilesPopup 控制）
-  refreshOnSuccess?: boolean
-}
-
-export interface PresetBaseToolbarItem extends BaseToolbarItem {
-  xtype: PresetXtype
-  permission?: string
-  label?: string
-  events?: any
-  props?: any
-}
-
-export interface PresetDelsToolbarItem extends PresetBaseToolbarItem {
-  xtype: 'dels'
-  api?: {
-    url?: string
-    method?: 'get' | 'post'
-    useParams?: boolean
-  }
-}
-
-export interface PresetExportToolbarItem extends PresetBaseToolbarItem {
-  xtype: 'export'
-  filename?: string
-}
-
-export interface PresetFilesToolbarItem extends PresetBaseToolbarItem {
-  xtype: 'files'
-  // 附件预设配置：由 SearchTable 内置 UploadPopup 消费
-  files: FilesPresetConfig
-}
-
-export type PresetToolbarItem =
-  | PresetDelsToolbarItem
-  | PresetExportToolbarItem
-  | PresetFilesToolbarItem
-
-// Renderable items (those with a 'type' property)
-export type RenderableToolbarItem =
-  | ButtonToolbarItem
-  | InputToolbarItem
-  | RadioGroupToolbarItem
-  | CheckboxToolbarItem
-  | SwitchToolbarItem
-  | CheckboxGroupToolbarItem
-  | DatePickerToolbarItem
-  | UploadToolbarItem
-  | InputNumberToolbarItem
-  | SelectToolbarItem
-  | TreeToolbarItem
-  | TreeSelectToolbarItem
-  | InputPasswordToolbarItem
-  | SselectPageToolbarItem
-  | AutoCompleteToolbarItem
-  | InputGroupToolbarItem
-  | CascaderToolbarItem
-  | AreaCascaderToolbarItem
-  | InputRangeToolbarItem
-  | CustomToolbarItem
-
-export type ToolbarItem = RenderableToolbarItem | PresetToolbarItem
-
-export type InputGroupChild = RenderableToolbarItem & {
-  // 当使用 Row 布局时的列宽设置
-  span?: number // 24 栅格系统
-  flex?: string // 可选：flex 布局
-  class?: string
-  style?: AnyObject
-}
-
-export interface InputGroupToolbarItem extends BaseToolbarItem {
-  [x: string]: any
-  type: 'inputGroup'
-  props?: Partial<InputGroupPropsLike>
-  // 布局控制：compact（紧凑）/ row（栅格）/ none（默认）
-  layout?: {
-    type?: 'compact' | 'row' | 'none'
-    rowProps?: Partial<RowProps>
-    // 针对每个子项的列设置（仅当 type=row 时生效）
-    cols?: Array<Partial<ColProps> & { span?: number }>
-  }
-  children: InputGroupChild[]
-}
-
-// 工具栏配置类型
-export interface ToolbarConfig {
-  items: ToolbarItem[]
-}
-
-export type {
-  ButtonProps,
-  DatePickerProps,
-  InputNumberProps,
-  InputProps,
-  RadioGroupProps,
-  SelectProps,
-  SwitchProps,
-  TreeSelectProps,
-  UploadProps,
-}
+import type {
+  ButtonProps,
+  CascaderProps,
+  CheckboxGroupProps,
+  CheckboxProps,
+  ColProps,
+  DatePickerProps,
+  InputNumberProps,
+  InputProps,
+  RadioGroupProps,
+  RowProps,
+  SelectProps,
+  SwitchProps,
+  TreeProps,
+  TreeSelectProps,
+  UploadProps,
+} from '@antsoo-lib/components'
+import type { AnyObject, VoidFunction } from '@antsoo-lib/shared'
+
+import type { VNode } from 'vue'
+
+import type { CustomToolbarItem } from './Custom'
+import type { ToolbarState } from './state'
+
+// 事件处理函数类型定义
+export type ToolbarEventHandler = VoidFunction
+
+// 基础事件接口
+export interface BaseEvents {
+  [key: string]: ToolbarEventHandler | undefined
+}
+
+export interface BaseToolbarItem {
+  key?: string
+  label?: string
+  permission?: string
+  beforeCreate?: boolean | ((toolbarState: ToolbarState) => boolean)
+  disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean)
+  props?: Record<string, any>
+  events?: BaseEvents
+}
+
+// 按钮工具栏项目
+export interface ButtonToolbarItem extends BaseToolbarItem {
+  type: 'button'
+  props?: Partial<ButtonProps> & { loading?: boolean; disabled?: boolean }
+  events?: BaseEvents & {
+    onClick?: (
+      loadingControl: { setLoading: (loading: boolean) => void; getLoading: () => boolean },
+      allValues: AnyObject,
+      toolbarState: ToolbarState,
+      ...args: any[]
+    ) => void
+  }
+}
+
+// 插槽配置接口
+export interface SlotConfig {
+  // 插槽内容可以是组件配置或渲染函数
+  content?:
+    | {
+        component: any // 组件
+        key: string // 主表字段
+        props?: AnyObject // 组件属性
+        events?: Record<string, VoidFunction> // 组件事件
+        options?: Array<{ label: string; value: any }> // 选项数据（用于select等）
+      }
+    | ((toolbarState: ToolbarState) => VNode)
+}
+
+// 输入框工具栏项目
+export interface InputToolbarItem extends BaseToolbarItem {
+  type: 'input'
+  props?: Partial<InputProps> & { value?: string; autoFocus?: boolean }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onFocus?: VoidFunction
+    onFocusCapture?: VoidFunction
+    onBlur?: VoidFunction
+    onBlurCapture?: VoidFunction
+  }
+  textarea?: boolean
+  // 插槽配置
+  slots?: {
+    addonBefore?: SlotConfig
+    addonAfter?: SlotConfig
+    prefix?: SlotConfig
+    suffix?: SlotConfig
+  }
+}
+
+// 单选框工具栏项目
+export interface RadioGroupToolbarItem extends BaseToolbarItem {
+  type: 'radioGroup'
+  props?: Partial<RadioGroupProps> & { value?: any }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+// 复选框工具栏项目
+export interface CheckboxToolbarItem extends BaseToolbarItem {
+  type: 'checkbox'
+  props?: Partial<CheckboxProps> & { checked?: boolean; value?: boolean }
+  events?: BaseEvents & {
+    'onUpdate:checked'?: (
+      checked: boolean,
+      allValues: AnyObject,
+      toolbarState: ToolbarState,
+    ) => void
+    onChange?: (event: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    'onUpdate:value'?: (checked: boolean, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+  label?: string // 复选框后面显示的文案
+}
+
+// 开关工具栏项目
+export interface SwitchToolbarItem extends BaseToolbarItem {
+  type: 'switch'
+  props?: Partial<SwitchProps> & { checked?: boolean }
+  events?: BaseEvents & {
+    'onUpdate:checked'?: (
+      checked: boolean,
+      allValues: AnyObject,
+      toolbarState: ToolbarState,
+    ) => void
+    onChange?: (checked: boolean, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+// 复选框组工具栏项目
+export interface CheckboxGroupToolbarItem extends BaseToolbarItem {
+  type: 'checkboxGroup'
+  props?: Partial<CheckboxGroupProps> & { value?: any[] }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any[], allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (checkedValues: any[], allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+// 日期选择器工具栏项目
+export interface DatePickerToolbarItem extends BaseToolbarItem {
+  type: 'datePicker'
+  props?: Partial<DatePickerProps> & { value?: any; autoFocus?: boolean }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onFocus?: VoidFunction
+  }
+  range?: boolean
+}
+
+export interface SelectToolbarItem extends BaseToolbarItem {
+  type: 'select'
+  props?: Partial<SelectProps> & {
+    value?: any
+    options?: any[] | ((values: AnyObject) => any[])
+  }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+// 级联选择器工具栏项目
+export interface CascaderToolbarItem extends BaseToolbarItem {
+  type: 'cascader'
+  props?: Partial<CascaderProps> & { value?: any }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+// 地区级联选择器属性定义
+export interface AreaCascaderProps {
+  value?: any[]
+  placeholder?: string
+  disabled?: boolean
+  allowClear?: boolean
+  [key: string]: any
+}
+
+// 地区级联选择器工具栏项目
+export interface AreaCascaderToolbarItem extends BaseToolbarItem {
+  type: 'areaCascader'
+  props?: AreaCascaderProps
+  attr?: Record<string, any>
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    selectedArea?: (area: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+// 树选择器工具栏项目
+export interface TreeSelectToolbarItem extends BaseToolbarItem {
+  type: 'treeSelect'
+  props?: Partial<TreeSelectProps> & {
+    value?: any
+    options?: any[] | ((values: AnyObject) => any[])
+  }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+export interface TreeToolbarItem extends BaseToolbarItem {
+  type: 'tree'
+  props?: Partial<TreeProps> & {
+    checkedKeys?: any[]
+    expandedKeys?: any[]
+  }
+  events?: BaseEvents & {
+    'onUpdate:checkedKeys'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    'onUpdate:expandedKeys'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onCheck?: (value: any, info: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onExpand?: (value: any, info: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+export interface InputRangeToolbarItem extends BaseToolbarItem {
+  type: 'inputRange'
+  props?: {
+    startProps?: Record<string, unknown>
+    endProps?: Record<string, unknown>
+    separator?: string
+    startPlaceholder?: string
+    endPlaceholder?: string
+    style?: AnyObject
+    className?: string
+    allowClear?: boolean
+  }
+  attr?: string[]
+  events?: BaseEvents & {
+    'onUpdate:value'?: (
+      value: [string, string],
+      allValues: AnyObject,
+      toolbarState: ToolbarState,
+    ) => void
+    onChange?: (value: [string, string], allValues: AnyObject, toolbarState: ToolbarState) => void
+    onStartChange?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onEndChange?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+export interface InputNumberToolbarItem extends BaseToolbarItem {
+  type: 'inputNumber'
+  props?: Partial<InputNumberProps> & {
+    value?: any
+    autoFocus?: boolean
+    xmoney?: boolean
+    xprice?: boolean
+    xweight?: boolean
+    xtaxrate?: boolean
+    xnumber?: boolean
+  }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onStep?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onFocus?: VoidFunction
+    onFocusCapture?: VoidFunction
+    onBlur?: VoidFunction
+    onBlurCapture?: VoidFunction
+  }
+  slots?: {
+    addonBefore?: SlotConfig
+    addonAfter?: SlotConfig
+    prefix?: SlotConfig
+    suffix?: SlotConfig
+  }
+}
+
+export interface InputPasswordToolbarItem extends BaseToolbarItem {
+  type: 'inputPassword'
+  props?: Partial<InputProps> & { value?: string }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+  textarea?: boolean
+  // 插槽配置
+  slots?: {
+    addonBefore?: SlotConfig
+    addonAfter?: SlotConfig
+    prefix?: SlotConfig
+    suffix?: SlotConfig
+  }
+}
+
+export interface UploadToolbarItem extends BaseToolbarItem {
+  type: 'upload'
+  props?: Partial<UploadProps> & {
+    value?: any[]
+    // 基础属性
+    placeholder?: string
+    allowClear?: boolean
+    disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean)
+    multiple?: boolean
+    maxCount?: number
+    listType?: 'text' | 'picture' | 'picture-card'
+
+    // 接口配置
+    api?: {
+      url: string
+      method?: 'GET' | 'POST'
+      headers?: Record<string, string>
+    }
+
+    // 额外参数配置
+    extraParams?: AnyObject | ((allValues: AnyObject, toolbarState: ToolbarState) => AnyObject)
+
+    // 数据映射配置
+    dataMapping?: {
+      list?: string // 文件列表字段路径
+      url?: string // 文件URL字段
+      name?: string // 文件名字段
+      status?: string // 文件状态字段
+    }
+
+    // UI 配置
+    buttonText?: string // 上传按钮文本，默认为"点击上传"
+    placeholderSrc?: string // picture-card 模式下的占位符图片地址
+    placeholderAlt?: string // 占位符图片的 alt 属性
+    placeholderClass?: string // 占位符图片的 CSS 类名
+    placeholderStyle?: AnyObject // 占位符图片的内联样式
+
+    // 其他配置
+    transformData?: (data: any) => any
+    beforeUpload?: (file: File, fileList: File[]) => boolean | Promise<boolean>
+    onPreview?: (file: any) => void
+    onRemove?: (file: any) => boolean | Promise<boolean>
+  }
+
+  // 文件类型限制配置
+  passage?: 'image' | 'pdf' | 'word' | 'excel' | 'video' | 'audio' | string
+
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (info: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onSuccess?: (response: any, file: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onError?: (error: any, file: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+// SselectPage 属性定义
+export interface SselectPageProps {
+  value?: any
+  placeholder?: string
+  allowClear?: boolean
+  showSearch?: boolean
+  disabled?: boolean
+  maxTagCount?: number | 'responsive'
+  size?: 'large' | 'middle' | 'small'
+  mode?: 'multiple' | 'tags'
+  params?: AnyObject
+  api: {
+    url: string
+    method?: 'GET' | 'POST'
+    headers?: Record<string, string>
+    params?: AnyObject
+    data?: AnyObject
+    request?: (config: {
+      method?: 'GET' | 'POST'
+      url: string
+      headers?: Record<string, string>
+      params?: AnyObject
+      data?: AnyObject
+    }) => Promise<any>
+  }
+  dataMapping?: {
+    list?: string
+    total?: string
+    value?: string
+    label?: string
+  }
+  pagination?: boolean
+  paginationConfig?: {
+    pageField?: string
+    pageSizeField?: string
+    searchField?: string
+    searchContains?: string
+  }
+  pageSize?: number
+  searchDelay?: number
+  extraParams?: AnyObject | ((allValues: AnyObject, toolbarState: ToolbarState) => AnyObject)
+  transformData?: (data: any) => any
+  autoLoad?: boolean
+  autoFocus?: boolean
+  attr?: Record<string, string>
+  [key: string]: any
+}
+
+export interface SselectPageToolbarItem extends BaseToolbarItem {
+  type: 'sselectPage'
+  props?: SselectPageProps & {
+    disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean)
+  }
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (
+      value: any,
+      option: any,
+      allOptions: any,
+      allValues: AnyObject,
+      toolbarState: ToolbarState,
+    ) => void
+    onSearch?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onClear?: (allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+export interface AutoCompleteProps {
+  value?: any
+  options?: any[]
+  placeholder?: string
+  disabled?: boolean
+  allowClear?: boolean
+  [key: string]: any
+}
+
+export interface AutoCompleteToolbarItem extends BaseToolbarItem {
+  type: 'autoComplete'
+  props?: AutoCompleteProps
+  events?: BaseEvents & {
+    'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onSelect?: (value: any, option: any, allValues: AnyObject, toolbarState: ToolbarState) => void
+    onSearch?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void
+  }
+}
+
+// ------------------------------
+// Input.Group 渲染器配置定义
+// ------------------------------
+export type InputGroupSize = 'large' | 'middle' | 'small' | 'default'
+export interface InputGroupPropsLike {
+  size?: InputGroupSize
+  compact?: boolean
+  prefixCls?: string
+}
+
+// 允许在工具栏中直接使用预设描述项（xtype）
+export type PresetXtype = 'add' | 'edit' | 'dels' | 'export' | 'print' | 'files'
+
+export interface FilesCategoryOption {
+  label: string
+  value: string
+  [key: string]: any
+}
+
+export interface FilesPresetConfig {
+  title?: string
+  // 单据类型：决定附件归属（UploadPopup 内部请求依赖该字段）
+  billtypeCode: string | ((row: AnyObject) => string)
+  // 分类下拉：UploadPopup 打开后默认选第一个，并按 category 拉历史列表
+  categoryOptions: FilesCategoryOption[] | ((row: AnyObject) => FilesCategoryOption[])
+  // objId 从行对象取值的字段名，默认 id
+  objIdKey?: string
+  accept?: string
+  passage?: 'image' | 'pdf' | 'word' | 'excel' | 'video' | 'audio' | string
+  maxFileSizeMB?: number
+  maxCount?: number
+  // 上传成功后是否刷新表格（由 SearchTable.openFilesPopup 控制）
+  refreshOnSuccess?: boolean
+}
+
+export interface PresetBaseToolbarItem extends BaseToolbarItem {
+  xtype: PresetXtype
+  permission?: string
+  label?: string
+  events?: any
+  props?: any
+}
+
+export interface PresetDelsToolbarItem extends PresetBaseToolbarItem {
+  xtype: 'dels'
+  api?: {
+    url?: string
+    method?: 'get' | 'post'
+    useParams?: boolean
+  }
+}
+
+export interface PresetExportToolbarItem extends PresetBaseToolbarItem {
+  xtype: 'export'
+  filename?: string
+}
+
+export interface PresetFilesToolbarItem extends PresetBaseToolbarItem {
+  xtype: 'files'
+  // 附件预设配置：由 SearchTable 内置 UploadPopup 消费
+  files: FilesPresetConfig
+}
+
+export type PresetToolbarItem =
+  | PresetDelsToolbarItem
+  | PresetExportToolbarItem
+  | PresetFilesToolbarItem
+
+// Renderable items (those with a 'type' property)
+export type RenderableToolbarItem =
+  | ButtonToolbarItem
+  | InputToolbarItem
+  | RadioGroupToolbarItem
+  | CheckboxToolbarItem
+  | SwitchToolbarItem
+  | CheckboxGroupToolbarItem
+  | DatePickerToolbarItem
+  | UploadToolbarItem
+  | InputNumberToolbarItem
+  | SelectToolbarItem
+  | TreeToolbarItem
+  | TreeSelectToolbarItem
+  | InputPasswordToolbarItem
+  | SselectPageToolbarItem
+  | AutoCompleteToolbarItem
+  | InputGroupToolbarItem
+  | CascaderToolbarItem
+  | AreaCascaderToolbarItem
+  | InputRangeToolbarItem
+  | CustomToolbarItem
+
+export type ToolbarItem = RenderableToolbarItem | PresetToolbarItem
+
+export type InputGroupChild = RenderableToolbarItem & {
+  // 当使用 Row 布局时的列宽设置
+  span?: number // 24 栅格系统
+  flex?: string // 可选：flex 布局
+  class?: string
+  style?: AnyObject
+}
+
+export interface InputGroupToolbarItem extends BaseToolbarItem {
+  [x: string]: any
+  type: 'inputGroup'
+  props?: Partial<InputGroupPropsLike>
+  // 布局控制：compact（紧凑）/ row（栅格）/ none（默认）
+  layout?: {
+    type?: 'compact' | 'row' | 'none'
+    rowProps?: Partial<RowProps>
+    // 针对每个子项的列设置（仅当 type=row 时生效）
+    cols?: Array<Partial<ColProps> & { span?: number }>
+  }
+  children: InputGroupChild[]
+}
+
+// 工具栏配置类型
+export interface ToolbarConfig {
+  items: ToolbarItem[]
+}
+
+export type {
+  ButtonProps,
+  DatePickerProps,
+  InputNumberProps,
+  InputProps,
+  RadioGroupProps,
+  SelectProps,
+  SwitchProps,
+  TreeSelectProps,
+  UploadProps,
+}