@antsoo-lib/core 2.0.0 → 2.0.2

package/src/{BaseTable/renderers → render}/AreaCascader.tsx

@@ -4,9 +4,9 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import { getRegisteredComponent } from '../registry'
-import type { ToolbarState } from '../state'
-import type { AreaCascaderProps, AreaCascaderToolbarItem } from '../types'
+import { getRegisteredComponent } from './registry'
+import type { ToolbarState } from './state'
+import type { AreaCascaderProps, AreaCascaderToolbarItem } from './types'
 
 // 渲染地区级联选择器
 export function renderAreaCascader(

package/src/{BaseTable/renderers → render}/AutoComplete.tsx

@@ -4,9 +4,9 @@ import { isFunction } from '@antsoo-lib/utils'
 import { computed, markRaw, nextTick } from 'vue'
 import type { ComponentPublicInstance, VNode } from 'vue'
 
-import { getRegisteredComponent } from '../registry'
-import type { ToolbarState } from '../state'
-import type { AutoCompleteToolbarItem, ToolbarItem } from '../types'
+import { getRegisteredComponent } from './registry'
+import type { ToolbarState } from './state'
+import type { AutoCompleteToolbarItem, ToolbarItem } from './types'
 
 export function renderAutoComplete(item: ToolbarItem, toolbarState: ToolbarState): VNode {
   const { key, events = {} } = item

package/src/{BaseTable/renderers → render}/Button.tsx

@@ -4,8 +4,8 @@ import type { VoidFunction } from '@antsoo-lib/shared'
 import { reactive } from 'vue'
 import type { VNode } from 'vue'
 
-import type { ToolbarState } from '../state'
-import type { ButtonToolbarItem, ToolbarItem } from '../types'
+import type { ToolbarState } from './state'
+import type { ButtonToolbarItem, ToolbarItem } from './types'
 
 // 按钮渲染函数
 export function renderButton(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/renderers → render}/Cascader.tsx

@@ -4,9 +4,9 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import { getRegisteredComponent } from '../registry'
-import type { ToolbarState } from '../state'
-import type { CascaderToolbarItem } from '../types'
+import { getRegisteredComponent } from './registry'
+import type { ToolbarState } from './state'
+import type { CascaderToolbarItem } from './types'
 
 // 渲染级联选择器
 export function renderCascader(

package/src/{BaseTable/renderers → render}/Checkbox.tsx

@@ -6,8 +6,8 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import type { ToolbarState } from '../state'
-import type { CheckboxToolbarItem, ToolbarItem } from '../types'
+import type { ToolbarState } from './state'
+import type { CheckboxToolbarItem, ToolbarItem } from './types'
 
 // 复选框渲染函数
 export function renderCheckbox(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/renderers → render}/CheckboxGroup.tsx

@@ -6,8 +6,8 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import type { ToolbarState } from '../state'
-import type { CheckboxGroupToolbarItem, ToolbarItem } from '../types'
+import type { ToolbarState } from './state'
+import type { CheckboxGroupToolbarItem, ToolbarItem } from './types'
 
 // 复选框组渲染函数
 export function renderCheckboxGroup(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/render/Custom.tsx

@@ -0,0 +1,19 @@
+import type { VNode } from 'vue'
+
+import type { ToolbarState } from './state'
+import type { BaseToolbarItem, ToolbarItem } from './types'
+
+// 自定义工具栏项目
+export interface CustomToolbarItem extends BaseToolbarItem {
+  type: 'custom'
+  render: (toolbarState: ToolbarState) => VNode
+}
+
+// 自定义渲染函数
+export function renderCustom(item: ToolbarItem, toolbarState: ToolbarState): VNode {
+  const customItem = item as CustomToolbarItem
+  if (typeof customItem.render === 'function') {
+    return customItem.render(toolbarState)
+  }
+  return <div key={item.key}>{item.label || item.key || '未命名'}</div>
+}

package/src/{BaseTable/renderers → render}/DatePicker.tsx

@@ -7,8 +7,8 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw, nextTick } from 'vue'
 import type { ComponentPublicInstance, VNode } from 'vue'
 
-import type { ToolbarState } from '../state'
-import type { DatePickerToolbarItem, ToolbarItem } from '../types'
+import type { ToolbarState } from './state'
+import type { DatePickerToolbarItem, ToolbarItem } from './types'
 
 // 日期选择器渲染函数
 export function renderDatePicker(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/renderers → render}/Input.tsx

@@ -6,9 +6,9 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw, nextTick } from 'vue'
 import type { ComponentPublicInstance, VNode } from 'vue'
 
-import { renderSlotContent } from '../helpers'
-import type { ToolbarState } from '../state'
-import type { InputToolbarItem, ToolbarItem } from '../types'
+import { renderSlotContent } from './helper'
+import type { ToolbarState } from './state'
+import type { InputToolbarItem, ToolbarItem } from './types'
 
 // 输入框渲染函数
 export function renderInput(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/renderers → render}/InputGroup.tsx

@@ -5,9 +5,9 @@ import { markRaw } from 'vue'
 import type { ExtractPropTypes, VNode } from 'vue'
 
 import { rendererMap } from '.'
-import { validateInputGroupConfig } from '../helpers'
-import type { ToolbarState } from '../state'
-import type { InputGroupPropsLike, InputGroupToolbarItem, ToolbarItem } from '../types'
+import { validateInputGroupConfig } from './helper'
+import type { ToolbarState } from './state'
+import type { InputGroupPropsLike, InputGroupToolbarItem, ToolbarItem } from './types'
 
 // Input.Group 渲染函数
 export function renderInputGroup(

package/src/{BaseTable/renderers → render}/InputNumber.tsx

@@ -6,9 +6,9 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw, nextTick } from 'vue'
 import type { ComponentPublicInstance, VNode } from 'vue'
 
-import { getInputNumberFocusState, renderSlotContent } from '../helpers'
-import type { ToolbarState } from '../state'
-import type { InputNumberToolbarItem, ToolbarItem } from '../types'
+import { getInputNumberFocusState, renderSlotContent } from './helper'
+import type { ToolbarState } from './state'
+import type { InputNumberToolbarItem, ToolbarItem } from './types'
 
 // 数字输入框渲染函数
 export function renderInputNumber(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/renderers → render}/InputPassword.tsx

@@ -6,9 +6,9 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import { renderSlotContent } from '../helpers'
-import type { ToolbarState } from '../state'
-import type { InputPasswordToolbarItem, ToolbarItem } from '../types'
+import { renderSlotContent } from './helper'
+import type { ToolbarState } from './state'
+import type { InputPasswordToolbarItem, ToolbarItem } from './types'
 
 export function renderInputPassword(item: ToolbarItem, toolbarState: ToolbarState): VNode {
   const inputItem = item as InputPasswordToolbarItem

package/src/render/InputRange.tsx

@@ -0,0 +1,154 @@
+import { Form, Input } from '@antsoo-lib/components'
+import type { AnyObject } from '@antsoo-lib/shared'
+
+import { defineComponent, h, markRaw } from 'vue'
+import type { VNode } from 'vue'
+
+import type { ToolbarState } from './state'
+import type { InputRangeToolbarItem, ToolbarItem } from './types'
+
+/**
+ * InputRange 业务包装组件
+ * @description 统一处理 CoreForm 下 key/attr 映射、事件回调与校验触发
+ */
+const InputRangeWrapper = defineComponent({
+  name: 'InputRangeWrapper',
+  props: {
+    item: {
+      type: Object,
+      required: true,
+    },
+    toolbarState: {
+      type: Object,
+      required: true,
+    },
+    formValues: {
+      type: Object,
+      required: false,
+      default: undefined,
+    },
+  },
+  setup(props) {
+    const formItemContext = Form.useInjectFormItemContext()
+
+    return (): VNode => {
+      const inputRangeItem = props.item as InputRangeToolbarItem
+      const toolbarState = props.toolbarState as ToolbarState
+      const formValues = props.formValues as AnyObject | undefined
+      const attr = (inputRangeItem as AnyObject).attr
+      const allowClear = Boolean((inputRangeItem.props as AnyObject)?.allowClear)
+
+      /**
+       * 解析区间值
+       * @description attr 模式优先取 formValues，回退到 toolbarState
+       */
+      const getRangeValue = (): [string, string] => {
+        if (formValues && Array.isArray(attr) && attr.length >= 2) {
+          const [startKey, endKey] = attr as [string, string]
+          const start = formValues[startKey]
+          const end = formValues[endKey]
+          return [start != null ? String(start) : '', end != null ? String(end) : '']
+        }
+        const stateValue = toolbarState.getValue(inputRangeItem.key || '')
+        if (Array.isArray(stateValue)) {
+          const [start, end] = stateValue
+          return [start != null ? String(start) : '', end != null ? String(end) : '']
+        }
+        return ['', '']
+      }
+
+      /**
+       * 同步区间值并触发外部事件
+       */
+      const handleRangeChange = (value: [string, string]) => {
+        if (!formValues || !Array.isArray(attr)) {
+          toolbarState.setValue(inputRangeItem.key || '', value)
+        }
+        const allValues = toolbarState.getAllValues()
+        inputRangeItem.events?.['onUpdate:value']?.(value, allValues, toolbarState)
+        inputRangeItem.events?.onChange?.(value, allValues, toolbarState)
+        formItemContext.onFieldChange()
+      }
+
+      const [startValue, endValue] = getRangeValue()
+      const Comp = markRaw(Input)
+
+      const startInput = (
+        <Comp
+          {...inputRangeItem.props?.startProps}
+          value={startValue}
+          allowClear={Boolean(
+            (inputRangeItem.props as AnyObject)?.startProps?.allowClear ?? allowClear,
+          )}
+          placeholder={inputRangeItem.props?.startPlaceholder || '起始值'}
+          onUpdate:value={(value: string) => {
+            const [, currentEnd] = getRangeValue()
+            handleRangeChange([value, currentEnd])
+          }}
+          onChange={(event: Event) => {
+            const target = event.target as HTMLInputElement
+            const [, currentEnd] = getRangeValue()
+            handleRangeChange([target.value, currentEnd])
+          }}
+        />
+      )
+
+      const endInput = (
+        <Comp
+          {...inputRangeItem.props?.endProps}
+          value={endValue}
+          allowClear={Boolean(
+            (inputRangeItem.props as AnyObject)?.endProps?.allowClear ?? allowClear,
+          )}
+          placeholder={inputRangeItem.props?.endPlaceholder || '结束值'}
+          onUpdate:value={(value: string) => {
+            const [currentStart] = getRangeValue()
+            handleRangeChange([currentStart, value])
+          }}
+          onChange={(event: Event) => {
+            const target = event.target as HTMLInputElement
+            const [currentStart] = getRangeValue()
+            handleRangeChange([currentStart, target.value])
+          }}
+        />
+      )
+
+      const content = (
+        <div
+          key={inputRangeItem.key}
+          style={{
+            display: 'flex',
+            alignItems: 'center',
+            ...(inputRangeItem as AnyObject).containerStyle,
+          }}
+        >
+          {startInput}
+          <span style={{ margin: '0 8px', color: '#999' }}>
+            {inputRangeItem.props?.separator || '至'}
+          </span>
+          {endInput}
+        </div>
+      )
+
+      return h(Form.ItemRest, null, {
+        default: () => content,
+      })
+    }
+  },
+})
+
+/**
+ * 渲染 InputRange
+ * @description 透传 toolbarState 与 formValues，供 CoreForm 统一状态管理
+ */
+export function renderInputRange(
+  item: ToolbarItem,
+  toolbarState: ToolbarState,
+  formValues?: AnyObject,
+): VNode {
+  return h(InputRangeWrapper, {
+    item,
+    toolbarState,
+    formValues,
+  })
+}

package/src/{BaseTable/renderers → render}/RadioGroup.tsx

@@ -6,8 +6,8 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import type { ToolbarState } from '../state'
-import type { RadioGroupToolbarItem, ToolbarItem } from '../types'
+import type { ToolbarState } from './state'
+import type { RadioGroupToolbarItem, ToolbarItem } from './types'
 
 // 单选框渲染函数
 export function renderRadioGroup(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/renderers → render}/Select.tsx

@@ -6,8 +6,8 @@ import { isFunction } from '@antsoo-lib/utils'
 import { computed, markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import type { ToolbarState } from '../state'
-import type { SelectToolbarItem, ToolbarItem } from '../types'
+import type { ToolbarState } from './state'
+import type { SelectToolbarItem, ToolbarItem } from './types'
 
 // 选择框渲染函数
 export function renderSelect(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/renderers → render}/SselectPage.tsx

@@ -4,9 +4,9 @@ import { isFunction } from '@antsoo-lib/utils'
 import { computed, markRaw, nextTick } from 'vue'
 import type { ComponentPublicInstance, VNode } from 'vue'
 
-import { getRegisteredComponent } from '../registry'
-import type { ToolbarState } from '../state'
-import type { SselectPageProps, SselectPageToolbarItem, ToolbarItem } from '../types'
+import { getRegisteredComponent } from './registry'
+import type { ToolbarState } from './state'
+import type { SselectPageProps, SselectPageToolbarItem, ToolbarItem } from './types'
 
 export function renderSselectPage(item: ToolbarItem, toolbarState: ToolbarState): VNode {
   const sselectPageItem = item as SselectPageToolbarItem

package/src/{BaseTable/renderers → render}/Switch.tsx

@@ -6,8 +6,8 @@ import { isFunction } from '@antsoo-lib/utils'
 import { markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import type { ToolbarState } from '../state'
-import type { SwitchToolbarItem, ToolbarItem } from '../types'
+import type { ToolbarState } from './state'
+import type { SwitchToolbarItem, ToolbarItem } from './types'
 
 // 开关渲染函数
 export function renderSwitch(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/render/Tree.tsx

@@ -0,0 +1,136 @@
+import { Tree } from '@antsoo-lib/components'
+import type { AnyObject } from '@antsoo-lib/shared'
+import { isFunction } from '@antsoo-lib/utils'
+
+import { markRaw } from 'vue'
+import type { VNode } from 'vue'
+
+import type { ToolbarState } from './state'
+import type { ToolbarItem, TreeToolbarItem } from './types'
+
+/**
+ * 按工具栏项缓存树展开状态，避免表单重渲染后丢失展开态
+ */
+const treeExpandedKeysCache = new WeakMap<object, any[]>()
+
+/**
+ * 解析树组件选中值
+ * @description 优先级：formValues -> toolbarState -> props.checkedKeys
+ */
+function resolveTreeCheckedKeys(
+  key: string | undefined,
+  props: AnyObject,
+  toolbarState: ToolbarState,
+  formValues?: AnyObject,
+): any[] {
+  if (key && formValues && formValues[key] !== undefined) {
+    return formValues[key] ?? []
+  }
+  if (key) {
+    const stateValue = toolbarState.getValue(key)
+    if (stateValue !== undefined) {
+      return stateValue ?? []
+    }
+  }
+  const propValue = props?.checkedKeys
+  if (isFunction(propValue)) {
+    return propValue(toolbarState.getAllValues(), toolbarState) ?? []
+  }
+  return propValue ?? []
+}
+
+/**
+ * 标准化树勾选值
+ * @description 兼容 strict 模式下 { checked, halfChecked } 结构
+ */
+function normalizeCheckedKeys(value: any): any {
+  if (Array.isArray(value)) return value
+  if (value && typeof value === 'object' && Array.isArray(value.checked)) return value.checked
+  return value
+}
+
+/**
+ * 渲染树控件
+ * @description 提供 checkedKeys 与 expandedKeys 的同步能力，并桥接到 CoreForm 事件系统
+ */
+export function renderTree(
+  item: ToolbarItem,
+  toolbarState: ToolbarState,
+  formValues?: AnyObject,
+): VNode {
+  const treeItem = item as TreeToolbarItem
+  const { key, events = {} } = treeItem
+  const { props = {}, disabled } = treeItem
+  const finalDisabled = isFunction(disabled)
+    ? disabled(toolbarState.getAllValues(), toolbarState)
+    : disabled
+
+  const { treeData: originalTreeData, ...otherProps } = props as AnyObject
+  const treeData = (() => {
+    if (isFunction(originalTreeData)) {
+      return originalTreeData(toolbarState.getAllValues())
+    }
+    if (originalTreeData && typeof originalTreeData === 'object' && 'value' in originalTreeData) {
+      return (originalTreeData as AnyObject).value || []
+    }
+    return originalTreeData || []
+  })()
+
+  const allValues = () => toolbarState.getAllValues()
+  const cachedExpanded = treeExpandedKeysCache.get(treeItem as object)
+  const expandedKeys = (props as AnyObject).expandedKeys ?? cachedExpanded
+
+  /**
+   * 同步勾选键值
+   */
+  const syncCheckedKeys = (value: any) => {
+    const normalized = normalizeCheckedKeys(value)
+    if (key) {
+      toolbarState.setValue(key, normalized)
+    }
+    const values = allValues()
+    events['onUpdate:checkedKeys']?.(normalized, values, toolbarState)
+    ;(events as AnyObject)['onUpdate:value']?.(normalized, values, toolbarState)
+    events.onChange?.(normalized, values, toolbarState)
+  }
+
+  /**
+   * 同步展开键值
+   */
+  const syncExpandedKeys = (value: any) => {
+    treeExpandedKeysCache.set(treeItem as object, value)
+    const values = allValues()
+    ;(events as AnyObject)['onUpdate:expandedKeys']?.(value, values, toolbarState)
+    ;(events as AnyObject).onExpand?.(value, values, toolbarState)
+  }
+
+  const Comp = markRaw(Tree)
+  return (
+    <div
+      style={{
+        border: '1px solid rgba(228, 229, 235, 1)',
+        borderRadius: '6px',
+        padding: '8px 0 8px 8px',
+      }}
+    >
+      <Comp
+        key={key}
+        checkedKeys={resolveTreeCheckedKeys(key, props as AnyObject, toolbarState, formValues)}
+        treeData={treeData}
+        disabled={finalDisabled}
+        {...(expandedKeys !== undefined ? { expandedKeys } : {})}
+        {...otherProps}
+        onUpdate:checkedKeys={syncCheckedKeys}
+        onCheck={(checked: any, info: any) => {
+          syncCheckedKeys(checked)
+          ;(events as AnyObject).onCheck?.(checked, info, allValues(), toolbarState)
+        }}
+        onUpdate:expandedKeys={syncExpandedKeys}
+        onExpand={(keys: any, info: any) => {
+          syncExpandedKeys(keys)
+          ;(events as AnyObject).onExpand?.(keys, info, allValues(), toolbarState)
+        }}
+      />
+    </div>
+  )
+}

package/src/{BaseTable/renderers → render}/TreeSelect.tsx

@@ -5,8 +5,8 @@ import { isFunction } from '@antsoo-lib/utils'
 import { computed, markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import type { ToolbarState } from '../state'
-import type { ToolbarItem, TreeSelectToolbarItem } from '../types'
+import type { ToolbarState } from './state'
+import type { ToolbarItem, TreeSelectToolbarItem } from './types'
 
 // 树选择器渲染函数
 export function renderTreeSelect(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/renderers → render}/Upload.tsx

@@ -1,14 +1,13 @@
 import type { UploadFile } from '@antsoo-lib/components'
+import type { AnyObject } from '@antsoo-lib/shared'
 import { isFunction } from '@antsoo-lib/utils'
 
 import { markRaw } from 'vue'
 import type { VNode } from 'vue'
 
-import type { AnyObject } from '@/packages/shared'
-
-import { getRegisteredComponent } from '../registry'
-import type { ToolbarState } from '../state'
-import type { ToolbarItem, UploadToolbarItem } from '../types'
+import { getRegisteredComponent } from './registry'
+import type { ToolbarState } from './state'
+import type { ToolbarItem, UploadToolbarItem } from './types'
 
 // 上传渲染函数
 export function renderUpload(item: ToolbarItem, toolbarState: ToolbarState): VNode {

package/src/{BaseTable/utils.tsx → render/helper.tsx}

@@ -1,15 +1,13 @@
-import { Button, Dropdown, Menu, MenuItem } from '@antsoo-lib/components'
+import { Button, Dropdown, Menu, MenuItem, Select } from '@antsoo-lib/components'
 import { DownOutlined, UpOutlined } from '@antsoo-lib/icons'
 import { isEmpty, isFunction } from '@antsoo-lib/utils'
 
-import { markRaw, ref } from 'vue'
+import { markRaw, nextTick, ref } from 'vue'
 import type { VNode } from 'vue'
 
-import { registerBaseTableComponents } from './registry'
-import { rendererMap } from './renderers'
-import { useToolbarState } from './state'
+import { rendererMap } from '.'
 import type { ToolbarState } from './state'
-import type { ToolbarConfig, ToolbarItem } from './types'
+import type { InputGroupToolbarItem, SlotConfig, ToolbarConfig, ToolbarItem } from './types'
 
 // 工具栏渲染函数
 export function renderToolbar(
@@ -139,6 +137,85 @@ export function renderToolbar(
   return renderedExtendShow.filter(Boolean) as VNode[]
 }
 
-export { registerBaseTableComponents, ToolbarState, useToolbarState }
-export * from './types'
-export * from './renderers'
+// 渲染插槽内容的辅助函数
+export function renderSlotContent(
+  slotConfig: SlotConfig,
+  toolbarState: ToolbarState,
+): VNode | undefined {
+  if (!slotConfig?.content) return undefined
+
+  // 如果是函数，直接调用
+  if (typeof slotConfig.content === 'function') {
+    return slotConfig.content(toolbarState)
+  }
+
+  // 如果是组件配置对象
+  const { component, key, props = {}, events = {}, options = [] } = slotConfig.content
+  const allValues = toolbarState.getAllValues()
+
+  // 处理事件，注入工具栏状态
+  const processedEvents: Record<string, VoidFunction> = {}
+  Object.entries(events).forEach(([eventName, handler]) => {
+    if (eventName === 'onChange') {
+      // 对于 onChange 事件，使用 nextTick 确保在下一个 tick 中执行外部处理函数
+      processedEvents[eventName] = (...args: any[]) => {
+        nextTick(() => {
+          handler(...args, allValues, toolbarState)
+        })
+      }
+    } else {
+      // 其他事件保持原有逻辑
+      processedEvents[eventName] = (...args: any[]) => {
+        handler(...args, allValues, toolbarState)
+      }
+    }
+  })
+
+  const value = allValues[key]
+
+  // 如果是Select组件且有options，添加选项子节点
+  if (component === Select && options.length > 0) {
+    const Comp = markRaw(component)
+    return (
+      <Comp value={value ?? ''} {...props} {...processedEvents}>
+        {options.map((option: any) => (
+          <Select.Option key={option.value} value={option.value}>
+            {option.label}
+          </Select.Option>
+        ))}
+      </Comp>
+    )
+  }
+
+  // 普通组件渲染
+  const Comp = markRaw(component)
+  return <Comp value={value ?? ''} {...props} {...processedEvents} />
+}
+
+export function validateInputGroupConfig(cfg: InputGroupToolbarItem): {
+  valid: boolean
+  errors?: string[]
+} {
+  const errors: string[] = []
+  if (!cfg) errors.push('inputGroup config is required')
+  if (cfg.type !== 'inputGroup') errors.push("type must be 'inputGroup'")
+  if (!Array.isArray(cfg.children) || cfg.children.length === 0)
+    errors.push('children must be a non-empty array')
+  // 校验子项 key 唯一性
+  const keys = (cfg.children || []).map((c) => c.key).filter(Boolean) as string[]
+  const dup = keys.filter((k, i) => keys.indexOf(k) !== i)
+  if (dup.length) errors.push(`duplicate child keys: ${Array.from(new Set(dup)).join(',')}`)
+  return { valid: errors.length === 0, errors: errors.length ? errors : undefined }
+}
+
+// InputNumber 的焦点态只用于“显示逻辑（失焦补零）”，不属于业务值：
+// - 不写入 ToolbarState，避免污染 getAllValues() 及其下游（按钮事件、联动禁用、外部 expose、deep watch 等）
+// - 采用 WeakMap：当 ToolbarState 实例被销毁且无引用时，对应缓存可被 GC 自动回收
+const inputNumberFocusState = new WeakMap<ToolbarState, Map<string, boolean>>()
+export function getInputNumberFocusState(toolbarState: ToolbarState) {
+  const existing = inputNumberFocusState.get(toolbarState)
+  if (existing) return existing
+  const next = new Map<string, boolean>()
+  inputNumberFocusState.set(toolbarState, next)
+  return next
+}