utils.module.js

/**
 * @version 1.2.2
 */

const name = 'Utils'

/**
 * @param {object} options
 * @param {string} [options.title]
 * @param {string} [options.message]
 * @param {Array<{ title: string; [key: string]: any }>} options.options
 * @param {boolean} [options.showCancel = true]
 * @param {string} [options.cancelText = 'Cancel']
 */
const presentSheet = async (options) => {
  options = {
    showCancel: true,
    cancelText: 'Cancel',
    ...options
  }
  const alert = new Alert()
  if (options.title) {
    alert.title = options.title
  }
  if (options.message) {
    alert.message = options.message
  }
  if (!options.options) {
    throw new Error('The "options" property of the parameter cannot be empty')
  }
  for (const option of options.options) {
    alert.addAction(option.title)
  }
  if (options.showCancel) {
    alert.addCancelAction(options.cancelText)
  }
  const value = await alert.presentSheet()
  return {
    value,
    option: options.options[value]
  }
}

/**
 * Thanks @mzeryck
 *
 * @param {number} [height] The screen height measured in pixels
 */
const phoneSize = (height) => {
  const phones = {
    /** 16 Pro Max */
    2868: {
      small: 510,
      medium: 1092,
      large: 1146,
      left: 114,
      right: 696,
      top: 276,
      middle: 912,
      bottom: 1548
    },
    /** 16 Pro */
    2622: {
      small: 486,
      medium: 1032,
      large: 1098,
      left: 87,
      right: 633,
      top: 261,
      middle: 873,
      bottom: 1485
    },
    /** 16 Plus, 15 Pro Max, 15 Plus, 14 Pro Max */
    2796: {
      small: 510,
      medium: 1092,
      large: 1146,
      left: 99,
      right: 681,
      top: 282,
      middle: 918,
      bottom: 1554
    },
    /** 16, 15 Pro, 15, 14 Pro */
    2556: {
      small: 474,
      medium: 1014,
      large: 1062,
      left: 82,
      right: 622,
      top: 270,
      middle: 858,
      bottom: 1446
    },
    /** 13 Pro Max, 12 Pro Max */
    2778: {
      small: 510,
      medium: 1092,
      large: 1146,
      left: 96,
      right: 678,
      top: 246,
      middle: 882,
      bottom: 1518
    },
    /** 13, 13 Pro, 12, 12 Pro */
    2532: {
      small: 474,
      medium: 1014,
      large: 1062,
      left: 78,
      right: 618,
      top: 231,
      middle: 819,
      bottom: 1407
    },
    /** 11 Pro Max, XS Max */
    2688: {
      small: 507,
      medium: 1080,
      large: 1137,
      left: 81,
      right: 654,
      top: 228,
      middle: 858,
      bottom: 1488
    },
    /** 11, XR */
    1792: {
      small: 338,
      medium: 720,
      large: 758,
      left: 55,
      right: 437,
      top: 159,
      middle: 579,
      bottom: 999
    },
    /** 13 mini, 12 mini / 11 Pro, XS, X */
    2436: {
      small: 465,
      medium: 987,
      large: 1035,
      x: {
        left: 69,
        right: 591,
        top: 213,
        middle: 783,
        bottom: 1353
      },
      mini: {
        left: 69,
        right: 591,
        top: 231,
        middle: 801,
        bottom: 1371
      }
    },
    /** Plus phones */
    2208: {
      small: 471,
      medium: 1044,
      large: 1071,
      left: 99,
      right: 672,
      top: 114,
      middle: 696,
      bottom: 1278
    },
    /** SE2 and 6/6S/7/8 */
    1334: {
      small: 296,
      medium: 642,
      large: 648,
      left: 54,
      right: 400,
      top: 60,
      middle: 412,
      bottom: 764
    },
    /** SE1 */
    1136: {
      small: 282,
      medium: 584,
      large: 622,
      left: 30,
      right: 332,
      top: 59,
      middle: 399,
      bottom: 399
    },
    /** 11 and XR in Display Zoom mode */
    1624: {
      small: 310,
      medium: 658,
      large: 690,
      left: 46,
      right: 394,
      top: 142,
      middle: 522,
      bottom: 902
    },
    /** Plus in Display Zoom mode */
    2001: {
      small: 444,
      medium: 963,
      large: 972,
      left: 81,
      right: 600,
      top: 90,
      middle: 618,
      bottom: 1146
    }
  }
  height = height || Device.screenResolution().height
  const scale = Device.screenScale()

  const phone = phones[height]
  if (phone) {
    return phone
  }

  if (config.runsInWidget) {
    const pc = {
      small: 164 * scale,
      medium: 344 * scale,
      large: 354 * scale
    }
    return pc
  }

  // in app screen fixed 375x812 pt
  return {
    small: 155 * scale,
    medium: 329 * scale,
    large: 345 * scale
  }
}

/**
 * @returns {Record<'small'|'medium'|'large'|'extraLarge', number>}
 */
const widgetSize = () => {
  const phones = {
    /** 16 Pro Max */
    956: { small: 170, medium: 364, large: 382 },
    /** 16 Pro */
    874: { small: 162, medium: 344, large: 366 },
    /** 16 Plus, 15 Pro Max, 15 Plus, 14 Pro Max */
    932: { small: 170, medium: 364, large: 382 },
    /** 13 Pro Max, 12 Pro Max */
    926: { small: 170, medium: 364, large: 382 },
    /** 11 Pro Max, 11, XS Max, XR */
    896: { small: 169, medium: 360, large: 379 },
    /** Plus phones */
    736: { small: 157, medium: 348, large: 357 },
    /** 16, 15 Pro, 15, 14 Pro */
    852: { small: 158, medium: 338, large: 354 },
    /** 13, 13 Pro, 12, 12 Pro */
    844: { small: 158, medium: 338, large: 354 },
    /** 13 mini, 12 mini / 11 Pro, XS, X */
    812: { small: 155, medium: 329, large: 345 },
    /** SE2 and 6/6S/7/8 */
    667: { small: 148, medium: 321, large: 324 },
    /** iPad Pro 2 */
    1194: { small: 155, medium: 342, large: 342, extraLarge: 715.5 },
    /** iPad 6 */
    1024: { small: 141, medium: 305.5, large: 305.5, extraLarge: 634.5 }
  }
  let { width, height } = Device.screenSize()
  if (width > height) height = width

  if (phones[height]) return phones[height]

  if (config.runsInWidget) {
    const pc = { small: 164, medium: 344, large: 344 }
    return pc
  }

  // in app screen fixed 375x812 pt
  return { small: 155, medium: 329, large: 329 }
}

/**
 * @param {number} num
 */
const vw = (num) => {
  const family = config.widgetFamily
  if (!family) throw new Error('`vw` only work in widget')
  const size = widgetSize()
  const width = size[family === 'large' ? 'medium' : family]
  return num * width / 100
}

/**
 * @param {number} num
 */
const vh = (num) => {
  const family = config.widgetFamily
  if (!family) throw new Error('`vh` only work in widget')
  const size = widgetSize()
  const height = family === 'medium'
    ? size.small
    : family === 'extraLarge' ? size.large : size[family]
  return num * height / 100
}

/**
 * @param {number} num
 */
const vmin = (num, widgetFamily) => {
  const family = widgetFamily || config.widgetFamily
  if (!family) throw new Error('`vmin` only work in widget')
  const size = widgetSize()
  const width = size[family === 'large' ? 'medium' : family]
  const height = family === 'medium'
    ? size.small
    : family === 'extraLarge' ? size.large : size[family]
  return num * Math.min(width, height) / 100
}

/**
 * download code
 * @param {object} options
 * @param {string} options.fileURL
 */
const updateCode = async (options) => {
  const { fileURL } = options
  let fm = FileManager.local()
  if (fm.isFileStoredIniCloud(module.filename)) {
    fm = FileManager.iCloud()
  }
  const request = new Request(fileURL)
  try {
    const code = await request.loadString()
    fm.writeString(module.filename, code)
    const alert = new Alert()
    alert.message = 'The code has been updated. If the script is open, close it for the change to take effect.'
    alert.addAction('OK')
    alert.presentAlert()
  } catch (e) {
    console.error(e)
  }
}

/**
 * 多语言国际化
 * @param {{[language: string]: string} | [en:string, zh:string]} langs
 */
const i18n = (langs) => {
  const language = Device.language()
  if (Array.isArray(langs)) {
    langs = {
      en: langs[0],
      zh: langs[1],
      others: langs[0]
    }
  } else {
    langs.others = langs.others || langs.en
  }
  return langs[language] || langs.others
}

/**
 * 获取网络图片
 * @param {string} url
 */
const getImage = async (url) => {
  const request = new Request(url)
  const image = await request.loadImage()
  return image
}

/**
 * 是否同一天
 * @param {string|number|Date} a
 * @param {string|number|Date} b
 */
const isSameDay = (a, b) => {
  const leftDate = new Date(a)
  leftDate.setHours(0)
  const rightDate = new Date(b)
  rightDate.setHours(0)
  return Math.abs(leftDate - rightDate) < 3600000
}

/**
 * 是否是今天
 * @param {string|number|Date} date
 */
const isToday = (date) => isSameDay(new Date(), date)

/**
 * 图标换色
 * @param {Image} image
 * @param {Color} color
 */
const tintedImage = async (image, color) => {
  const html =
    `<img id="image" src="data:image/png;base64,${Data.fromPNG(image).toBase64String()}" />
    <canvas id="canvas"></canvas>`
  const js =
    `let img = document.getElementById("image");
     let canvas = document.getElementById("canvas");
     let color = 0x${color.hex};

     canvas.width = img.width;
     canvas.height = img.height;
     let ctx = canvas.getContext("2d");
     ctx.drawImage(img, 0, 0);
     let imgData = ctx.getImageData(0, 0, img.width, img.height);
     // ordered in RGBA format
     let data = imgData.data;
     for (let i = 0; i < data.length; i++) {
       // skip alpha channel
       if (i % 4 === 3) continue;
       // bit shift the color value to get the correct channel
       data[i] = (color >> (2 - i % 4) * 8) & 0xFF
     }
     ctx.putImageData(imgData, 0, 0);
     canvas.toDataURL("image/png").replace(/^data:image\\/png;base64,/, "");`
  const wv = new WebView()
  await wv.loadHTML(html)
  const base64 = await wv.evaluateJavaScript(js)
  return Image.fromData(Data.fromBase64String(base64))
}

/**
 * @param {...string} paths
 */
const joinPath = (...paths) => {
  const fm = FileManager.local()
  return paths.reduce((prev, curr) => {
    return fm.joinPath(prev, curr)
  }, '')
}

/**
 * 规范使用 FileManager。每个脚本使用独立文件夹
 *
 * 注意：桌面组件无法写入 cacheDirectory 和 temporaryDirectory
 * @param {object} options
 * @param {boolean} [options.useICloud]
 * @param {string} [options.basePath]
 */
const useFileManager = (options = {}) => {
  const { useICloud, basePath } = options
  const fm = useICloud ? FileManager.iCloud() : FileManager.local()
  const paths = [fm.documentsDirectory(), Script.name()]
  if (basePath) {
    paths.push(basePath)
  }
  const cacheDirectory = joinPath(...paths)
  /**
   * 删除路径末尾所有的 /
   * @param {string} filePath
   */
  const safePath = (filePath) => {
    return fm.joinPath(cacheDirectory, filePath).replace(/\/+$/, '')
  }
  /**
   * 如果上级文件夹不存在，则先创建文件夹
   * @param {string} filePath
   */
  const preWrite = (filePath) => {
    const i = filePath.lastIndexOf('/')
    const directory = filePath.substring(0, i)
    if (!fm.fileExists(directory)) {
      fm.createDirectory(directory, true)
    }
  }

  const writeString = (filePath, content) => {
    const nextPath = safePath(filePath)
    preWrite(nextPath)
    fm.writeString(nextPath, content)
  }

  /**
   * @param {string} filePath
   * @param {*} jsonData
   */
  const writeJSON = (filePath, jsonData) => writeString(filePath, JSON.stringify(jsonData))
  /**
   * @param {string} filePath
   * @param {Image} image
   */
  const writeImage = (filePath, image) => {
    const nextPath = safePath(filePath)
    preWrite(nextPath)
    return fm.writeImage(nextPath, image)
  }

  /**
   * 文件不存在时返回 null
   * @param {string} filePath
   * @returns {string|null}
   */
  const readString = (filePath) => {
    const fullPath = fm.joinPath(cacheDirectory, filePath)
    if (fm.fileExists(fullPath)) {
      return fm.readString(
        fm.joinPath(cacheDirectory, filePath)
      )
    }
    return null
  }

  /**
   * @param {string} filePath
   */
  const readJSON = (filePath) => JSON.parse(readString(filePath))

  /**
   * @param {string} filePath
   */
  const readImage = (filePath) => {
    const fullPath = safePath(filePath)
    if (fm.fileExists(fullPath)) {
      return fm.readImage(fullPath)
    }
    return null
  }

  return {
    cacheDirectory,
    writeString,
    writeJSON,
    writeImage,
    readString,
    readJSON,
    readImage
  }
}

/** 规范使用文件缓存。每个脚本使用独立文件夹 */
const useCache = () => useFileManager({ basePath: 'cache' })

/**
 * @param {string} filename
 */
const isRunSelf = (filename) => {
  const matches = filename.match(/[^/]+$/)
  const name = matches ? matches[0].replace('.js', '') : ''
  return Script.name() === name
}

/**
 * @param {string} data
 */
const hashCode = (data) => {
  return Array.from(data).reduce((accumulator, currentChar) => Math.imul(31, accumulator) + currentChar.charCodeAt(0), 0)
}

/**
 * 时差
 * @param {Date} date
 * @returns {string} 如：1小时前
 */
const timeOffset = (date) => {
  const now = new Date()
  let offset = now.getTime() - date.getTime()
  const type = offset < 0 ? i18n([' later', '后']) : i18n([' ago', '前'])
  const minute = i18n(['minutes', '分钟'])
  const hour = i18n(['hours', '小时'])
  const day = i18n(['days', '天'])
  if (offset < 0) {
    offset = Math.abs(offset)
  }
  if (offset < 60000) {
    // 小于一分钟
    return i18n([`${Math.ceil(offset / 1000)} seconds${type}`, '刚刚'])
  }
  if (offset < 3600000) {
    // 小于一小时
    const minutes = Math.ceil(offset / 60000)
    return `${minutes} ${minute}${type}`
  }
  if (offset < 24 * 3600000) {
    // 小于一天
    const hours = Math.ceil(offset / 3600000)
    return `${hours} ${hour}${type}`
  }

  const days = Math.ceil(offset / (24 * 3600000))
  return `${days} ${day}${type}`
}

module.exports = {
  name,
  i18n,
  phoneSize,
  widgetSize,
  vw,
  vh,
  vmin,
  presentSheet,
  updateCode,
  getImage,
  isSameDay,
  isToday,
  tintedImage,
  useFileManager,
  useCache,
  isRunSelf,
  hashCode,
  timeOffset
}