@ganwei-web/ganwei-pc-cli 6.2.9 → 6.3.2

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/date.ts

@@ -0,0 +1,80 @@
+import dayjs from 'dayjs'
+import relativeTime from 'dayjs/plugin/relativeTime'
+
+import 'dayjs/locale/zh-cn'
+
+dayjs.extend(relativeTime)
+dayjs.locale('zh-cn')
+
+/**
+ * 格式化日期
+ * @param date - 日期对象、时间戳或日期字符串
+ * @param format - 格式化模板，默认 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的日期字符串
+ * @example
+ * formatDate(new Date()) // '2024-01-15 14:30:00'
+ * formatDate(Date.now(), 'YYYY年MM月DD日') // '2024年01月15日'
+ */
+export function formatDate(
+  date: Date | number | string,
+  format = 'YYYY-MM-DD HH:mm:ss'
+): string {
+  return dayjs(date).format(format)
+}
+
+/**
+ * 获取相对时间
+ * @param date - 日期对象、时间戳或日期字符串
+ * @returns 相对时间描述，如 '3 天前'
+ * @example
+ * getRelativeTime(Date.now() - 3 * 24 * 60 * 60 * 1000) // '3 天前'
+ */
+export function getRelativeTime(date: Date | number | string): string {
+  return dayjs(date).fromNow()
+}
+
+/**
+ * 获取时间范围
+ * @param type - 时间范围类型
+ * @returns [开始时间, 结束时间]
+ */
+export function getDateRange(
+  type: 'today' | 'week' | 'month' | 'year'
+): [Date, Date] {
+  const now = dayjs()
+  let start: dayjs.Dayjs
+  const end: dayjs.Dayjs = now
+
+  switch (type) {
+    case 'today':
+      start = now.startOf('day')
+      break
+    case 'week':
+      start = now.startOf('week')
+      break
+    case 'month':
+      start = now.startOf('month')
+      break
+    case 'year':
+      start = now.startOf('year')
+      break
+    default:
+      start = now.startOf('day')
+  }
+
+  return [start.toDate(), end.toDate()]
+}
+
+/**
+ * 判断是否为今天
+ */
+export function isToday(date: Date | number | string): boolean {
+  return dayjs(date).isSame(dayjs(), 'day')
+}
+
+/**
+ * 判断是否为本周
+ */
+export function isThisWeek(date: Date | number | string): boolean {
+  return dayjs(date).isSame(dayjs(), 'week')
+}

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/dom.ts

@@ -0,0 +1,99 @@
+/**
+ * 添加事件监听器
+ * @returns 移除监听器的函数
+ */
+export function addEventListener(
+  element: HTMLElement | Window,
+  event: string,
+  handler: EventListener,
+  options?: AddEventListenerOptions
+): () => void {
+  element.addEventListener(event, handler, options)
+  return () => element.removeEventListener(event, handler, options)
+}
+
+/**
+ * 判断元素是否可见
+ */
+export function isVisible(element: HTMLElement): boolean {
+  const rect = element.getBoundingClientRect()
+  return (
+    rect.width > 0 &&
+    rect.height > 0 &&
+    rect.top < window.innerHeight &&
+    rect.bottom > 0 &&
+    rect.left < window.innerWidth &&
+    rect.right > 0
+  )
+}
+
+/**
+ * 滚动到元素
+ */
+export function scrollToElement(
+  element: HTMLElement,
+  options?: ScrollIntoViewOptions
+): void {
+  element.scrollIntoView({
+    behavior: 'smooth',
+    block: 'start',
+    ...options
+  })
+}
+
+/**
+ * 复制文本到剪贴板
+ */
+export async function copyToClipboard(text: string): Promise<boolean> {
+  try {
+    await navigator.clipboard.writeText(text)
+    return true
+  } catch {
+    // 降级方案
+    const textarea = document.createElement('textarea')
+    textarea.value = text
+    textarea.style.position = 'fixed'
+    textarea.style.opacity = '0'
+    document.body.appendChild(textarea)
+    textarea.select()
+    const success = document.execCommand('copy')
+    document.body.removeChild(textarea)
+    return success
+  }
+}
+
+/**
+ * 全屏切换
+ */
+export function toggleFullscreen(element?: HTMLElement): Promise<void> {
+  const target = element || document.documentElement
+
+  if (!document.fullscreenElement) {
+    return target.requestFullscreen()
+  } 
+    return document.exitFullscreen()
+  
+}
+
+/**
+ * 获取元素样式
+ */
+export function getStyle(element: HTMLElement, property: string): string {
+  return window.getComputedStyle(element).getPropertyValue(property)
+}
+
+/**
+ * 设置 CSS 变量
+ */
+export function setCssVariable(name: string, value: string): void {
+  document.documentElement.style.setProperty(name, value)
+}
+
+/**
+ * 设置主题
+ */
+export const setTheme = (theme: string): void => {
+  localStorage.setItem('theme', theme)
+  sessionStorage.setItem('theme', theme)
+  window.document.documentElement.setAttribute('data-theme', theme)
+}

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/env.ts

@@ -0,0 +1,20 @@
+export const ENV = {
+
+    /** 应用标题 */
+    APP_TITLE: import.meta.env.VITE_APP_TITLE,
+
+    /** 应用端口 */
+    APP_VERSION: import.meta.env.VITE_APP_PORT,
+
+    /** proxy代理配置 */
+    APP_ENV: import.meta.env.VITE_APP_TARGET_URL,
+
+    /** 本地地址 */
+    API_URL: import.meta.env.VITE_APP_THIS_URL,
+
+    /** 是否开发环境 */
+    IS_DEV: import.meta.env.DEV,
+
+    /** 是否生产环境 */
+    IS_PROD: import.meta.env.PROD
+} as const

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/file.ts

@@ -0,0 +1,74 @@
+/**
+ * 下载文件
+ */
+export function downloadFile(url: string, filename?: string): void {
+  const link = document.createElement('a')
+  link.href = url
+  link.download = filename || ''
+  document.body.appendChild(link)
+  link.click()
+  document.body.removeChild(link)
+}
+
+/**
+ * 下载 Blob 文件
+ */
+export function downloadBlob(blob: Blob, filename: string): void {
+  const url = URL.createObjectURL(blob)
+  downloadFile(url, filename)
+  URL.revokeObjectURL(url)
+}
+
+/**
+ * 文件转 Base64
+ */
+export function fileToBase64(file: File): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader()
+    reader.onload = () => resolve(reader.result as string)
+    reader.onerror = reject
+    reader.readAsDataURL(file)
+  })
+}
+
+/**
+ * Base64 转 Blob
+ */
+export function base64ToBlob(
+  base64: string,
+  mimeType = 'application/octet-stream'
+): Blob {
+  const byteString = atob(base64.split(',')[1])
+  const arrayBuffer = new ArrayBuffer(byteString.length)
+  const uint8Array = new Uint8Array(arrayBuffer)
+
+  for (let i = 0; i < byteString.length; i++) {
+    uint8Array[i] = byteString.charCodeAt(i)
+  }
+
+  return new Blob([uint8Array], { type: mimeType })
+}
+
+/**
+ * 获取文件扩展名
+ */
+export function getFileExtension(filename: string): string {
+  return filename.slice(((filename.lastIndexOf('.') - 1) >>> 0) + 2)
+}
+
+/**
+ * 验证文件类型
+ */
+export function validateFileType(file: File, allowedTypes: string[]): boolean {
+  const extension = getFileExtension(file.name).toLowerCase()
+  return allowedTypes.includes(extension) || allowedTypes.includes(file.type)
+}
+
+/**
+ * 验证文件大小
+ * @param file - 文件对象
+ * @param maxSize - 最大大小（MB）
+ */
+export function validateFileSize(file: File, maxSize: number): boolean {
+  return file.size <= maxSize * 1024 * 1024
+}

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/index.ts

@@ -0,0 +1,26 @@
+// 日期处理
+export * from './date'
+
+// 数字处理
+export * from './number'
+
+// 字符串处理
+export * from './string'
+
+// 文件处理
+export * from './file'
+
+// DOM 操作
+export * from './dom'
+
+// 本地存储
+export * from './storage'
+
+// 性能优化
+export * from './performance'
+
+// 环境变量
+export * from './env'
+
+// XSS 过滤
+export * from './xss-filter'

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/number.ts

@@ -0,0 +1,83 @@
+/**
+ * 格式化数字（千分位）
+ * @param num - 数字或字符串
+ * @param decimals - 小数位数，默认 0
+ * @returns 格式化后的数字字符串
+ */
+export function formatNumber(num: number | string, decimals = 0): string {
+  const number = Number(num)
+  if (isNaN(number)) return '0'
+
+  return number.toLocaleString('zh-CN', {
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals
+  })
+}
+
+/**
+ * 格式化金额
+ * @param amount - 金额
+ * @param currency - 货币符号，默认 '¥'
+ * @param decimals - 小数位数，默认 2
+ */
+export function formatMoney(
+  amount: number | string,
+  currency = '¥',
+  decimals = 2
+): string {
+  const number = Number(amount)
+  if (isNaN(number)) return `${currency}0.00`
+
+  return `${currency}${formatNumber(number, decimals)}`
+}
+
+/**
+ * 格式化百分比
+ * @param value - 值（0-1）
+ * @param decimals - 小数位数，默认 2
+ */
+export function formatPercent(
+  value: number | string,
+  decimals = 2
+): string {
+  const number = Number(value)
+  if (isNaN(number)) return '0%'
+
+  return `${(number * 100).toFixed(decimals)}%`
+}
+
+/**
+ * 格式化文件大小
+ * @param bytes - 字节数
+ * @param decimals - 小数位数，默认 2
+ */
+export function formatFileSize(bytes: number, decimals = 2): string {
+  if (bytes === 0) return '0 B'
+
+  const k = 1024
+  const sizes = ['B', 'KB', 'MB', 'GB', 'TB']
+  const i = Math.floor(Math.log(bytes) / Math.log(k))
+
+  return `${(bytes / Math.pow(k, i)).toFixed(decimals)} ${sizes[i]}`
+}
+
+/**
+ * 数字范围限制
+ */
+export function clamp(value: number, min: number, max: number): number {
+  return Math.min(Math.max(value, min), max)
+}
+
+/**
+ * 生成随机数
+ */
+export function random(min: number, max: number): number {
+  return Math.floor(Math.random() * (max - min + 1)) + min
+}
+
+/**
+ * 生成随机 ID
+ */
+export function generateId(prefix = ''): string {
+  return `${prefix}${Date.now()}${Math.random().toString(36).substr(2, 9)}`
+}

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/performance.ts

@@ -0,0 +1,69 @@
+/**
+ * 防抖函数
+ * @param func - 要防抖的函数
+ * @param wait - 等待时间（毫秒）
+ * @param immediate - 是否立即执行
+ */
+export function debounce<T extends (...args: any[]) => any>(
+  func: T,
+  wait: number,
+  immediate = false
+): (...args: Parameters<T>) => ReturnType<T> | undefined {
+  let timeout: ReturnType<typeof setTimeout> | null = null
+
+  return function (this: any, ...args: Parameters<T>) {
+    const context = this
+
+    const later = () => {
+      timeout = null
+      if (!immediate) {
+        func.apply(context, args)
+      }
+    }
+
+    const callNow = immediate && !timeout
+
+    if (timeout) {
+      clearTimeout(timeout)
+    }
+
+    timeout = setTimeout(later, wait)
+
+    if (callNow) {
+      func.apply(context, args)
+    }
+  }
+}
+
+/**
+ * 节流函数
+ * @param func - 要节流的函数
+ * @param wait - 等待时间（毫秒）
+ */
+export function throttle<T extends (...args: any[]) => any>(
+  func: T,
+  wait: number
+): (...args: Parameters<T>) => ReturnType<T> | undefined {
+  let timeout: ReturnType<typeof setTimeout> | null = null
+  let previous = 0
+
+  return function (this: any, ...args: Parameters<T>) {
+    const context = this
+    const now = Date.now()
+
+    if (now - previous > wait) {
+      if (timeout) {
+        clearTimeout(timeout)
+        timeout = null
+      }
+      previous = now
+      func.apply(context, args)
+    } else if (!timeout) {
+      timeout = setTimeout(() => {
+        previous = Date.now()
+        timeout = null
+        func.apply(context, args)
+      }, wait)
+    }
+  }
+}

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/storage.ts

@@ -0,0 +1,80 @@
+/**
+ * 本地存储工具类
+ */
+class StorageUtil {
+    private storage: Storage
+
+    constructor(storage: Storage) {
+        this.storage = storage
+    }
+
+    /**
+     * 设置存储项
+     * @param key - 键名
+     * @param value - 值
+     * @param expires - 过期时间（毫秒）
+     */
+    set<T>(key: string, value: T, expires?: number): void {
+        const data = {
+            value,
+            expires: expires ? Date.now() + expires : undefined
+        }
+        this.storage.setItem(key, JSON.stringify(data))
+    }
+
+    /**
+     * 获取存储项
+     */
+    get<T>(key: string): T | null {
+        const item = this.storage.getItem(key)
+        if (!item) return null
+
+        try {
+            const data = JSON.parse(item)
+
+            // 检查是否过期
+            if (data.expires && Date.now() > data.expires) {
+                this.remove(key)
+                return null
+            }
+
+            return data.value as T
+        } catch {
+            return null
+        }
+    }
+
+    /**
+     * 移除存储项
+     */
+    remove(key: string): void {
+        this.storage.removeItem(key)
+    }
+
+    /**
+     * 清空存储
+     */
+    clear(): void {
+        this.storage.clear()
+    }
+
+    /**
+     * 获取所有键
+     */
+    keys(): string[] {
+        const keys: string[] = []
+        for (let i = 0; i < this.storage.length; i++) {
+            const key = this.storage.key(i)
+            if (key) keys.push(key)
+        }
+        return keys
+    }
+}
+
+export const localStorageUtil = new StorageUtil(window.localStorage)
+export const sessionStorageUtil = new StorageUtil(window.sessionStorage)
+export const setTheme = (theme: string) => {
+    localStorage.setItem('theme', theme);
+    sessionStorage.setItem('theme', theme);
+    window.document.documentElement.setAttribute('data-theme', theme)
+}

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-index/src/utils/string.ts

@@ -0,0 +1,116 @@
+/**
+ * 首字母大写
+ */
+export function capitalize(str: string): string {
+    return str.charAt(0).toUpperCase() + str.slice(1)
+}
+
+/**
+ * 驼峰转连字符
+ */
+export function camelToKebab(str: string): string {
+    return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()
+}
+
+/**
+ * 连字符转驼峰
+ */
+export function kebabToCamel(str: string): string {
+    return str.replace(/-([a-z])/g, (_, char) => char.toUpperCase())
+}
+
+/**
+ * 手机号脱敏
+ */
+export function maskPhone(phone: string): string {
+    return phone.replace(/(\d{3})\d{4}(\d{4})/, '$1****$2')
+}
+
+/**
+ * 身份证号脱敏
+ */
+export function maskIdCard(idCard: string): string {
+    return idCard.replace(/(\d{6})\d{8}(\d{4})/, '$1********$2')
+}
+
+/**
+ * 银行卡号脱敏
+ */
+export function maskBankCard(cardNo: string): string {
+    return cardNo.replace(/(\d{4})\d+(\d{4})/, '$1 **** **** $2')
+}
+
+/** 邮箱脱敏：t***e@example.com */
+export function maskEmail(email: string): string {
+    if (!email || !email.includes('@')) return email
+    const [prefix, suffix] = email.split('@')
+    const maskedPrefix = prefix.charAt(0) + '***' + prefix.charAt(prefix.length - 1)
+    return `${maskedPrefix}@${suffix}`
+}
+
+/** 姓名脱敏：张*（2字）/ 张**（3字+） */
+export function maskName(name: string): string {
+    if (!name) return name
+    if (name.length === 2) return name.charAt(0) + '*'
+    return name.charAt(0) + '*'.repeat(name.length - 1)
+}
+
+/** 地址脱敏：北京市朝阳区*** */
+export function maskAddress(address: string): string {
+    if (!address || address.length <= 6) return address
+    return address.substring(0, 6) + '***'
+}
+
+/**
+ * 截断字符串
+ */
+export function truncate(str: string, length: number, suffix = '...'): string {
+    if (str.length <= length) return str
+    return str.substring(0, length) + suffix
+}
+
+/**
+ * 移除 HTML 标签
+ */
+export function stripHtml(html: string): string {
+    return html.replace(/<[^>]*>/g, '')
+}
+
+/**
+ * 转义 HTML 特殊字符
+ */
+export function escapeHtml(str: string): string {
+    const escapeMap: Record<string, string> = {
+        '&': '&amp;',
+        '<': '&lt;',
+        '>': '&gt;',
+        '"': '&quot;',
+        "'": '&#39;'
+    }
+
+    return str.replace(/[&<>"']/g, char => escapeMap[char])
+}
+
+/**
+ * 解析 URL 参数
+ */
+export function parseQueryString(url: string): Record<string, string> {
+    const queryString = url.split('?')[1]
+    if (!queryString) return {}
+
+    return queryString.split('&').reduce((params, param) => {
+        const [key, value] = param.split('=')
+        params[decodeURIComponent(key)] = decodeURIComponent(value || '')
+        return params
+    }, {} as Record<string, string>)
+}
+
+/**
+ * 序列化对象为 URL 参数
+ */
+export function stringifyQueryString(obj: Record<string, any>): string {
+    return Object.entries(obj)
+        .filter(([, value]) => value !== undefined && value !== null)
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+        .join('&')
+}