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

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-template/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-template/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-template/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-template/src/utils/index.ts

@@ -0,0 +1,29 @@
+// 日期处理
+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'
+
+// SignalR 实时通信
+export * from './signalr'

package/ganwei-iotcenter-index-6.2.3/packages/ganwei-iotcenter-template/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-template/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)
+    }
+  }
+}