@aspire-ui/element-component-pro 1.0.6 → 1.0.8

package/src/utils/formattedNumber.ts

@@ -0,0 +1,118 @@
+/** 进位方式：向下取整、向上取整、四舍五入 */
+export type FormattedNumberRounding = 'floor' | 'ceil' | 'round'
+
+/** 仅保留数字、至多一个小数点、可选前导负号 */
+export function sanitizeNumericInput(raw: string): string {
+  const t = raw.trim()
+  if (!t) return ''
+  let i = 0
+  let res = ''
+  if (t[0] === '-') {
+    res = '-'
+    i = 1
+  }
+  let dot = false
+  for (; i < t.length; i++) {
+    const c = t[i]
+    if (c >= '0' && c <= '9') {
+      res += c
+      continue
+    }
+    if (c === '.' && !dot) {
+      dot = true
+      if (res === '' || res === '-') res += '0'
+      res += '.'
+    }
+  }
+  return res
+}
+
+export function stripNumberGrouping(s: string): string {
+  return s.replace(/,/g, '').trim()
+}
+
+function maxAbsValue(integerDigits: number, decimalPlaces: number): number {
+  const maxInt = Math.pow(10, integerDigits) - 1
+  if (decimalPlaces <= 0) return maxInt
+  return maxInt + (1 - Math.pow(10, -decimalPlaces))
+}
+
+/** 按整数位数上限约束绝对值 */
+export function clampByIntegerDigits(
+  value: number,
+  integerDigits: number,
+  decimalPlaces: number
+): number {
+  const max = maxAbsValue(integerDigits, decimalPlaces)
+  const sign = value < 0 ? -1 : 1
+  const abs = Math.abs(value)
+  if (abs <= max) return value
+  return sign * max
+}
+
+export function roundToDecimals(
+  value: number,
+  decimalPlaces: number,
+  rounding: FormattedNumberRounding
+): number {
+  if (decimalPlaces <= 0) {
+    switch (rounding) {
+      case 'floor':
+        return Math.floor(value)
+      case 'ceil':
+        return Math.ceil(value)
+      default:
+        return Math.round(value)
+    }
+  }
+  const factor = Math.pow(10, decimalPlaces)
+  const x = value * factor
+  let y: number
+  switch (rounding) {
+    case 'floor':
+      y = Math.floor(x)
+      break
+    case 'ceil':
+      y = Math.ceil(x)
+      break
+    default:
+      y = Math.round(x)
+  }
+  return y / factor
+}
+
+/**
+ * 解析 → 按整数位夹紧 → 按小数位与进位方式舍入 → 再夹紧（防止舍入后越界）
+ */
+export function normalizeNumericValue(
+  value: number,
+  integerDigits: number,
+  decimalPlaces: number,
+  rounding: FormattedNumberRounding
+): number {
+  let v = clampByIntegerDigits(value, integerDigits, decimalPlaces)
+  v = roundToDecimals(v, decimalPlaces, rounding)
+  v = clampByIntegerDigits(v, integerDigits, decimalPlaces)
+  return v
+}
+
+/** 千分位格式化展示（整数部分），小数部分固定 m 位 */
+export function formatWithThousands(value: number, decimalPlaces: number): string {
+  if (Number.isNaN(value) || !Number.isFinite(value)) return ''
+  const fixed = value.toFixed(Math.max(0, decimalPlaces))
+  const neg = fixed.startsWith('-')
+  const body = neg ? fixed.slice(1) : fixed
+  const [intPart, decPart] = body.split('.')
+  const withSep = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',')
+  if (decimalPlaces <= 0 || decPart === undefined) return (neg ? '-' : '') + withSep
+  return (neg ? '-' : '') + withSep + '.' + decPart
+}
+
+/** 编辑态：无千分位，去掉多余尾部 0（在 m 位精度内） */
+export function numberToEditString(value: number, decimalPlaces: number): string {
+  if (Number.isNaN(value) || !Number.isFinite(value)) return ''
+  let s = value.toFixed(Math.max(0, decimalPlaces))
+  s = s.replace(/(\.\d*?)0+$/, '$1')
+  s = s.replace(/\.$/, '')
+  return s
+}

package/src/utils/tooltip.ts

@@ -0,0 +1,56 @@
+export type TooltipValue = boolean | string | Record<string, unknown>
+
+export const hasTooltipContent = (value: unknown): boolean => {
+  if (Array.isArray(value)) return value.length > 0
+  return value !== undefined && value !== null && String(value).trim() !== ''
+}
+
+export const getTooltipContent = (value: unknown): string => {
+  if (Array.isArray(value)) {
+    return value.map((item) => String(item)).join(', ')
+  }
+  if (value === undefined || value === null) return ''
+  if (typeof value === 'object') return JSON.stringify(value)
+  return String(value)
+}
+
+export const normalizeTooltipConfig = (
+  tooltip: TooltipValue | null | undefined,
+  fallbackValue?: unknown
+): Record<string, unknown> | null => {
+  if (!tooltip) return null
+
+  if (tooltip === true) {
+    return {
+      content: getTooltipContent(fallbackValue),
+      placement: 'top',
+      effect: 'dark',
+      disabled: !hasTooltipContent(fallbackValue),
+    }
+  }
+
+  if (typeof tooltip === 'string') {
+    return {
+      content: tooltip,
+      placement: 'top',
+      effect: 'dark',
+    }
+  }
+
+  const normalized = { ...tooltip }
+  const hasExplicitContent = Object.prototype.hasOwnProperty.call(normalized, 'content')
+  if (!hasExplicitContent) {
+    normalized.content = getTooltipContent(fallbackValue)
+  }
+  if (!Object.prototype.hasOwnProperty.call(normalized, 'placement')) {
+    normalized.placement = 'top'
+  }
+  if (!Object.prototype.hasOwnProperty.call(normalized, 'effect')) {
+    normalized.effect = 'dark'
+  }
+  if (!Object.prototype.hasOwnProperty.call(normalized, 'disabled')) {
+    normalized.disabled = !hasTooltipContent(normalized.content)
+  }
+
+  return normalized
+}

package/src/vite-env.d.ts

@@ -1 +1,6 @@
 /// <reference types="vite/client" />
+
+declare module '*.md?raw' {
+  const content: string
+  export default content
+}