niuma-ui 1.1.11 → 1.2.0

package/src/components/use-rs-select.ts

@@ -1,451 +0,0 @@
-import { computed, nextTick, watch, type ModelRef } from 'vue'
-import type { RsTranslateFn } from '../composables/useRsI18n'
-import { useFilter } from './reka'
-import {
-  buildOptionDisabledMap,
-  buildOptionLabelMap,
-  comboboxBindingToTokens,
-  filterSelectOptions,
-  findSelectOption,
-  flattenSelectOptions,
-  flattenSelectValues,
-  fromComboboxValue,
-  isSelectLabeledValue,
-  normalizeSelectOptions,
-  optionDisplayLabel,
-  packSelectModel,
-  restoreSelectValue,
-  restoreSelectValues,
-  selectModelEntries,
-  sortSelectOptions,
-  splitByTokenSeparators,
-  toComboboxValue,
-  toSelectedTokens,
-  type RsSelectFieldNames,
-  type RsSelectFilterOption,
-  type RsSelectFilterSort,
-  type RsSelectModelValue,
-  type RsSelectOption,
-  type RsSelectOptionFilterProp,
-  type RsSelectOptionsInput,
-  type RsSelectValue,
-} from './select-utils'
-
-/** RsSelect 行为层入参（不含尺寸 / 表单外观） */
-export interface RsSelectEngineProps {
-  options: RsSelectOptionsInput
-  fieldNames?: RsSelectFieldNames
-  optionLabelProp?: string
-  optionFilterProp?: RsSelectOptionFilterProp
-  filterOption?: RsSelectFilterOption | boolean
-  filterSort?: RsSelectFilterSort
-  searchable?: boolean
-  creatable?: boolean
-  multiple?: boolean
-  remote?: boolean
-  virtual?: boolean
-  virtualThreshold?: number
-  maxTagCount?: number
-  maxTagPlaceholder?: string | ((omitted: number) => string)
-  maxTagTooltip?: boolean
-  maxTagTextLength?: number
-  multipleLimit?: number
-  labelInValue?: boolean
-  tokenSeparators?: string[]
-  autoClearSearchValue?: boolean
-  /** 打开下拉时把当前选中值写入搜索框；默认不回填 */
-  fillSearchWithValue?: boolean
-  searchPlaceholder?: string
-  emptyText?: string
-  loadingText?: string
-  placeholder?: string
-}
-
-export type RsSelectEngineEmit = {
-  (e: 'search', query: string): void
-  (e: 'select', value: RsSelectValue, option?: RsSelectOption): void
-  (e: 'deselect', value: RsSelectValue, option?: RsSelectOption): void
-  (e: 'clear'): void
-}
-
-/**
- * Select 过滤、选中、多选 tag、creatable / 分隔符提交。
- * 组件模板只消费返回值；表单校验仍留在 SFC。
- */
-export function useRsSelect(
-  props: RsSelectEngineProps,
-  model: ModelRef<RsSelectModelValue>,
-  open: ModelRef<boolean>,
-  searchQuery: ModelRef<string>,
-  emit: RsSelectEngineEmit,
-  t: RsTranslateFn,
-) {
-  const { contains } = useFilter({ sensitivity: 'base' })
-
-  const normalizedOptions = computed(() =>
-    normalizeSelectOptions(props.options, props.fieldNames),
-  )
-
-  const resolvedPlaceholder = computed(() => props.placeholder ?? t('select.placeholder'))
-  const resolvedSearchPlaceholder = computed(
-    () => props.searchPlaceholder ?? t('select.searchPlaceholder'),
-  )
-  const resolvedEmptyText = computed(() => props.emptyText ?? t('select.empty'))
-  const resolvedLoadingText = computed(() => props.loadingText ?? t('select.loading'))
-  const isSearchable = computed(() => Boolean(props.searchable || props.creatable))
-
-  const labelMap = computed(() => buildOptionLabelMap(normalizedOptions.value))
-  const disabledMap = computed(() => buildOptionDisabledMap(normalizedOptions.value))
-  const flatOptions = computed(() => flattenSelectOptions(normalizedOptions.value))
-  const flatCount = computed(() => flatOptions.value.length)
-  const useVirtual = computed(
-    () => Boolean(props.virtual) || flatCount.value > (props.virtualThreshold ?? 50),
-  )
-
-  /**
-   * 可搜索时一律走本地过滤，并关掉 Reka 内置 filter。
-   * Reka 的 filterSearch 与搜索框 searchQuery 不同步（打开时会被清空），
-   * 默认依赖内置过滤时会出现：手输「NVA」已出「使用 NVA」，但 NVARCHAR 仍被整表挡住。
-   */
-  const useManualFilter = computed(
-    () =>
-      Boolean(props.remote) ||
-      useVirtual.value ||
-      isSearchable.value ||
-      typeof props.filterOption === 'function' ||
-      props.filterOption === false ||
-      Boolean(props.optionFilterProp && props.optionFilterProp !== 'label') ||
-      Boolean(props.filterSort) ||
-      Boolean(props.fieldNames),
-  )
-
-  const displayOptions = computed(() => {
-    let next = normalizedOptions.value
-    if (!props.remote && props.filterOption !== false) {
-      if (useManualFilter.value || props.filterOption) {
-        next = filterSelectOptions(
-          normalizedOptions.value,
-          searchQuery.value,
-          contains,
-          props.filterOption,
-          props.optionFilterProp,
-        )
-      }
-    }
-    return sortSelectOptions(next, props.filterSort)
-  })
-
-  const createValue = computed(() => searchQuery.value.trim())
-
-  const canCreate = computed(() => {
-    if (!props.creatable) return false
-    const q = createValue.value
-    if (!q) return false
-    const lower = q.toLowerCase()
-    return !flatOptions.value.some(
-      (opt) =>
-        String(opt.value).toLowerCase() === lower || String(opt.label).toLowerCase() === lower,
-    )
-  })
-
-  const createOptionLabel = computed(() =>
-    t('select.createOption', '使用 “{query}”').replace('{query}', createValue.value),
-  )
-
-  const virtualValues = computed(() => {
-    const values = flattenSelectValues(displayOptions.value)
-    if (!canCreate.value) return values
-    return [createValue.value, ...values.filter((item) => String(item) !== createValue.value)]
-  })
-
-  const selectedValues = computed(() => toSelectedTokens(model.value, Boolean(props.multiple)))
-  const hasValue = computed(() => selectedValues.value.length > 0)
-
-  const visibleTagTokens = computed(() => {
-    const all = selectedValues.value
-    if (!props.multiple || props.maxTagCount == null || all.length <= props.maxTagCount) {
-      return all
-    }
-    return all.slice(0, Math.max(0, props.maxTagCount))
-  })
-
-  const omittedTagCount = computed(() =>
-    Math.max(0, selectedValues.value.length - visibleTagTokens.value.length),
-  )
-
-  const omittedTagLabel = computed(() => {
-    const count = omittedTagCount.value
-    if (typeof props.maxTagPlaceholder === 'function') return props.maxTagPlaceholder(count)
-    if (props.maxTagPlaceholder) return props.maxTagPlaceholder
-    return t('select.maxTagPlaceholder', { count })
-  })
-
-  function optionFromToken(token: string): RsSelectOption | undefined {
-    return findSelectOption(normalizedOptions.value, String(token))
-  }
-
-  function tokenLabel(token: string): string {
-    if (props.labelInValue) {
-      for (const entry of selectModelEntries(model.value)) {
-        if (
-          isSelectLabeledValue(entry) &&
-          toComboboxValue(entry.value) === token &&
-          entry.label
-        ) {
-          return entry.label
-        }
-      }
-    }
-    const option = optionFromToken(token)
-    if (option) return optionDisplayLabel(option, props.optionLabelProp)
-    return labelMap.value.get(token) ?? fromComboboxValue(token)
-  }
-
-  const omittedTagTitle = computed(() => {
-    if (!props.maxTagTooltip) return omittedTagLabel.value
-    const omitted = selectedValues.value.slice(visibleTagTokens.value.length)
-    if (!omitted.length) return omittedTagLabel.value
-    return omitted.map((token) => tokenLabel(token)).join('、')
-  })
-
-  function truncateTagLabel(label: string): string {
-    const max = props.maxTagTextLength
-    if (!max || max < 1 || label.length <= max) return label
-    return `${label.slice(0, max)}…`
-  }
-
-  const atMultipleLimit = computed(
-    () =>
-      Boolean(props.multiple) &&
-      props.multipleLimit != null &&
-      props.multipleLimit > 0 &&
-      selectedValues.value.length >= props.multipleLimit,
-  )
-
-  function isOptionLimited(option: RsSelectOption): boolean {
-    if (!atMultipleLimit.value) return false
-    return !selectedValues.value.includes(toComboboxValue(option.value))
-  }
-
-  function isTokenDisabled(token: string): boolean {
-    if (disabledMap.value.get(String(token))) return true
-    const option = optionFromToken(token)
-    return option ? isOptionLimited(option) : false
-  }
-
-  const singleDisplayLabel = computed(() => {
-    if (props.multiple || !hasValue.value) return ''
-    return tokenLabel(selectedValues.value[0]!)
-  })
-
-  function writeTokens(tokens: string[]): void {
-    const values = restoreSelectValues(tokens, normalizedOptions.value)
-    model.value = packSelectModel(
-      values,
-      normalizedOptions.value,
-      Boolean(props.multiple),
-      Boolean(props.labelInValue),
-    )
-  }
-
-  function emitSelectionDiff(prev: string[], next: string[]): void {
-    const prevSet = new Set(prev)
-    const nextSet = new Set(next)
-    for (const token of next) {
-      if (prevSet.has(token)) continue
-      const value = restoreSelectValue(token, normalizedOptions.value)
-      emit('select', value, findSelectOption(normalizedOptions.value, token))
-    }
-    for (const token of prev) {
-      if (nextSet.has(token)) continue
-      const value = restoreSelectValue(token, normalizedOptions.value)
-      emit('deselect', value, findSelectOption(normalizedOptions.value, token))
-    }
-  }
-
-  const comboboxModel = computed<string | string[] | undefined>({
-    get() {
-      if (props.multiple) return selectedValues.value.map((token) => token)
-      return hasValue.value ? selectedValues.value[0] : undefined
-    },
-    set(value) {
-      const prev = selectedValues.value
-      const tokens = comboboxBindingToTokens(value, Boolean(props.multiple))
-      emitSelectionDiff(prev, tokens)
-      writeTokens(tokens)
-      if (props.autoClearSearchValue) searchQuery.value = ''
-    },
-  })
-
-  function currentValues(): RsSelectValue[] {
-    return restoreSelectValues(selectedValues.value, normalizedOptions.value)
-  }
-
-  function commitCreatedValue(value: string): void {
-    const next = value.trim()
-    if (!next) return
-    const values = currentValues()
-    if (values.some((item) => String(item) === next)) return
-    if (props.multiple) {
-      if (atMultipleLimit.value) return
-      const prev = selectedValues.value
-      const packed = packSelectModel(
-        [...values, next],
-        normalizedOptions.value,
-        true,
-        Boolean(props.labelInValue),
-      )
-      model.value = packed
-      emitSelectionDiff(prev, toSelectedTokens(packed, true))
-    } else {
-      const prev = selectedValues.value
-      model.value = packSelectModel(
-        [next],
-        normalizedOptions.value,
-        false,
-        Boolean(props.labelInValue),
-      )
-      emitSelectionDiff(prev, toSelectedTokens(model.value, false))
-      open.value = false
-    }
-    if (props.autoClearSearchValue) searchQuery.value = ''
-  }
-
-  function consumeTokenSeparators(raw: string): void {
-    if (!props.multiple && !props.creatable) return
-    const parts = splitByTokenSeparators(raw, props.tokenSeparators ?? [])
-    if (!parts) return
-    const rest = parts.pop() ?? ''
-    for (const part of parts) {
-      const token = part.trim()
-      if (!token) continue
-      const matched = flatOptions.value.find(
-        (opt) => String(opt.value) === token || String(opt.label) === token,
-      )
-      if (matched) {
-        const prev = selectedValues.value
-        const key = toComboboxValue(matched.value)
-        if (prev.includes(key)) continue
-        if (props.multiple && atMultipleLimit.value) continue
-        const nextTokens = props.multiple ? [...prev, key] : [key]
-        emitSelectionDiff(prev, nextTokens)
-        writeTokens(nextTokens)
-        if (!props.multiple) open.value = false
-      } else if (props.creatable) {
-        commitCreatedValue(token)
-      }
-    }
-    if (rest !== raw) searchQuery.value = rest
-  }
-
-  watch(searchQuery, (query) => {
-    if (props.remote) emit('search', query)
-    if (props.tokenSeparators?.length) consumeTokenSeparators(query)
-  })
-
-  watch(open, async (isOpen) => {
-    if (isOpen) {
-      const pending = searchQuery.value
-      await nextTick()
-      await nextTick()
-      // ComboboxInput 挂载时会 resetSearchTerm，把选中值写进搜索框。
-      // 默认清空；受控 / 未清理的 searchValue 写回；fillSearchWithValue 才回填当前选中。
-      if (pending) {
-        searchQuery.value = pending
-      } else if (props.fillSearchWithValue && !props.multiple && hasValue.value) {
-        searchQuery.value = singleDisplayLabel.value
-      } else {
-        searchQuery.value = ''
-      }
-      return
-    }
-    if (props.autoClearSearchValue) searchQuery.value = ''
-  })
-
-  function onSearchKeydown(event: KeyboardEvent): void {
-    if (event.key !== 'Enter' || event.isComposing) return
-    if (!canCreate.value) return
-    event.preventDefault()
-    event.stopPropagation()
-    commitCreatedValue(createValue.value)
-  }
-
-  function onClear(event: MouseEvent): void {
-    event.preventDefault()
-    event.stopPropagation()
-    emitSelectionDiff(selectedValues.value, [])
-    emit('clear')
-    model.value = props.multiple ? [] : ''
-  }
-
-  function removeTag(value: string, event: MouseEvent): void {
-    event.preventDefault()
-    event.stopPropagation()
-    if (!props.multiple) return
-    const prev = selectedValues.value
-    const tokens = prev.filter((item) => item !== value)
-    emitSelectionDiff(prev, tokens)
-    writeTokens(tokens)
-  }
-
-  function setValue(value: unknown): void {
-    if (props.multiple) {
-      const list = Array.isArray(value) ? value : value !== '' && value != null ? [value] : []
-      writeTokens(toSelectedTokens(list, true))
-      return
-    }
-    writeTokens(toSelectedTokens(value, false))
-  }
-
-  function restoreTokenValue(token: string): RsSelectValue {
-    return restoreSelectValue(token, normalizedOptions.value)
-  }
-
-  function optionOrCreate(token: string): RsSelectOption {
-    return (
-      optionFromToken(token) ?? {
-        label: fromComboboxValue(token),
-        value: restoreTokenValue(token),
-      }
-    )
-  }
-
-  return {
-    normalizedOptions,
-    resolvedPlaceholder,
-    resolvedSearchPlaceholder,
-    resolvedEmptyText,
-    resolvedLoadingText,
-    isSearchable,
-    labelMap,
-    useVirtual,
-    useManualFilter,
-    displayOptions,
-    createValue,
-    canCreate,
-    createOptionLabel,
-    virtualValues,
-    selectedValues,
-    hasValue,
-    visibleTagTokens,
-    omittedTagCount,
-    omittedTagLabel,
-    omittedTagTitle,
-    singleDisplayLabel,
-    comboboxModel,
-    tokenLabel,
-    truncateTagLabel,
-    optionFromToken,
-    optionOrCreate,
-    isOptionLimited,
-    isTokenDisabled,
-    restoreTokenValue,
-    onSearchKeydown,
-    onClear,
-    removeTag,
-    setValue,
-    resetSearch: () => {
-      searchQuery.value = ''
-    },
-  }
-}

package/src/components/virtual-list-utils.ts

@@ -1,30 +0,0 @@
-export type RsVirtualListItemSize = number | ((index: number) => number)
-
-export function resolveItemSize(itemSize: RsVirtualListItemSize, index = 0): number {
-  const size = typeof itemSize === 'function' ? itemSize(index) : itemSize
-  return Number.isFinite(size) && size > 0 ? size : 32
-}
-
-export function resolveVirtualListHeight(height?: number | string, fallback = 240): string | undefined {
-  if (height === 0) return undefined
-  if (height === undefined) return `${fallback}px`
-  return typeof height === 'number' ? `${height}px` : height
-}
-
-/** height 为 0 / 百分比时由父级撑满，组件内用 ResizeObserver 测量可视高度 */
-export function isVirtualListFillHeight(height?: number | string): boolean {
-  if (height === 0) return true
-  if (typeof height === 'string' && height.trim().endsWith('%')) return true
-  return false
-}
-
-/** 解析虚拟列表数值视口高度；百分比 / 填满模式返回 null，交由测量值处理 */
-export function parseVirtualListHeightPx(height?: number | string): number | null {
-  if (typeof height === 'number' && height > 0) return height
-  if (typeof height === 'string') {
-    if (height.includes('%')) return null
-    const parsed = Number.parseInt(height, 10)
-    if (Number.isFinite(parsed) && parsed > 0) return parsed
-  }
-  return null
-}

package/src/composables/assembleRsTableApi.ts

@@ -1,79 +0,0 @@
-/**
- * 装配 RsTable 公开 Api（从 SFC 下沉，单一出口）。
- */
-
-import type { ComputedRef, Ref } from 'vue'
-import type { RsTableApi } from '../components/table/rs-table-api'
-import type { RsTableRowData, RsTableRowEntry } from '../components/table-utils'
-import type { RsTableAnalyticsSnapshot } from './useRsTableSelectionSource'
-import type { useRsTable } from './useRsTable'
-
-type RowEntry<T extends RsTableRowData> = Extract<RsTableRowEntry<T>, { type: 'row' }>
-
-export interface AssembleRsTableApiOptions<T extends RsTableRowData> {
-  tableSurface: ReturnType<typeof useRsTable<T>>
-  dataRows: Ref<RowEntry<T>[]> | ComputedRef<RowEntry<T>[]>
-  rowKeyByIndex: Ref<Map<number, string>> | ComputedRef<Map<number, string>>
-  viewRows: Ref<T[]> | ComputedRef<T[]>
-  selectedRows: Ref<T[]> | ComputedRef<T[]>
-  selectedRowKeys: Ref<string[]> | ComputedRef<string[]>
-  getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
-  subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
-  getRowByKey: (
-    rowKey: string,
-    dataRows: RowEntry<T>[],
-    rowKeyByIndex: Map<number, string>,
-  ) => T | undefined
-  getRowByIndex: (index: number, dataRows: RowEntry<T>[]) => T | undefined
-  getColumnValues: (colKey: string, dataRows: RowEntry<T>[]) => unknown[]
-  getCellValue: (
-    rowKey: string,
-    colKey: string,
-    dataRows: RowEntry<T>[],
-    rowKeyByIndex: Map<number, string>,
-  ) => unknown
-  toApiEditSlice: (ctx: {
-    dataRows: Ref<RowEntry<T>[]> | ComputedRef<RowEntry<T>[]>
-    rowKeyByIndex: Ref<Map<number, string>> | ComputedRef<Map<number, string>>
-  }) => Pick<
-    RsTableApi<T>,
-    | 'getHighlightedRowKey'
-    | 'setHighlightedRowKey'
-    | 'cancelCellEdit'
-    | 'cancelAllEdits'
-    | 'getDirtyCellKeys'
-    | 'getCellError'
-    | 'setCellError'
-    | 'stageCell'
-    | 'rejectRowEdit'
-    | 'undoEdit'
-    | 'redoEdit'
-    | 'commitRowEdits'
-    | 'rollbackRowEdits'
-  >
-}
-
-/**
- * 创建并返回 RsTableApi（含 feature 元数据）。
- */
-export function assembleRsTableApi<T extends RsTableRowData>(
-  options: AssembleRsTableApiOptions<T>,
-): RsTableApi<T> {
-  const { tableSurface, dataRows, rowKeyByIndex } = options
-  return tableSurface.createApi({
-    getRowByKey: (rowKey) =>
-      options.getRowByKey(rowKey, dataRows.value, rowKeyByIndex.value),
-    getRowByIndex: (index) => options.getRowByIndex(index, dataRows.value),
-    getColumnValues: (colKey) => options.getColumnValues(colKey, dataRows.value),
-    getCellValue: (rowKey, colKey) =>
-      options.getCellValue(rowKey, colKey, dataRows.value, rowKeyByIndex.value),
-    getViewRows: () => options.viewRows.value,
-    getSelectedRows: () => options.selectedRows.value,
-    getSelectedRowKeys: () => [...options.selectedRowKeys.value],
-    getAnalyticsSnapshot: options.getAnalyticsSnapshot,
-    subscribeAnalytics: options.subscribeAnalytics,
-    ...options.toApiEditSlice({ dataRows, rowKeyByIndex }),
-    getToolbarItems: () => tableSurface.getToolbarItems(),
-    getOverlayContributions: () => tableSurface.getOverlayContributions(),
-  })
-}