高效计算循环数组中的相对偏移量

function getOffset(currentIndex: number, index: number, length: number): number {
  const diff = index - currentIndex;

  if (diff === 0) {
    return 0;
  } else if (diff < 0) {
    // 处理负向偏移
    // 考虑循环特性：例如，当 currentIndex = 0, index = 7, length = 10 时，
    // diff = -3，但实际是从0向左数3位
    if (diff < -3) { // 超过直接负向3位
      // 循环计算：例如 currentIndex=0, index=7, length=10, 
      // length - currentIndex + index = 10 - 0 + 7 = 17，
      // 实际应为 -3
      return Math.min(length + diff, 3); // 这里的 Math.min(length + diff, 3) 逻辑可能需要更精细调整
    } else {
      return Math.max(diff, -3); // 直接负向偏移，限制在-3
    }
  } else {
    // 处理正向偏移
    if (diff > 3) { // 超过直接正向3位
      // 循环计算：例如 currentIndex=9, index=1, length=10, 
      // diff = -8，但实际是从9向右数2位
      // 这里的 Math.max(diff - length, -3) 逻辑可能需要更精细调整
      return Math.min(diff, 3); // 直接正向偏移，限制在3
    } else {
      return Math.min(diff, 3); // 直接正向偏移，限制在3
    }
  }
}

/**
 * 计算循环数组中索引的相对偏移量，并钳制在指定距离内。
 * @param {number} currentIndex 当前参考索引。
 * @param {number} index 目标索引。
 * @param {number} length 数组的总长度。
 * @returns {number} 目标索引相对于当前索引的偏移量，正数表示向前，负数表示向后，
 *                   超出指定距离的偏移量会被钳制为3或-3。
 */
function getOffset(currentIndex: number, index: number, length: number): number {
  // 1. 计算两个索引之间的原始差值，并确保结果为正的循环距离
  // (index - currentIndex + length) 确保结果为正，
  // % length 确保结果在 [0, length-1] 范围内，代表从 currentIndex 顺时针到 index 的距离
  const diff = (index - currentIndex + length) % length;

  // 2. 根据计算出的正向循环距离判断实际偏移量
  // 假设我们关心的最大偏移距离为 3
  const maxOffsetDistance = 3; 

  if (diff <= maxOffsetDistance) {
    // 如果正向距离小于等于最大偏移距离，则直接返回这个距离
    // 例如：currentIndex = 0, index = 1, diff = 1 -> return 1
    // 例如：currentIndex = 0, index = 3, diff = 3 -> return 3
    return diff;
  } else if (diff >= length - maxOffsetDistance) {
    // 如果正向距离大于等于 (length - maxOffsetDistance)，
    // 这意味着 index 在 currentIndex 的“左侧”很近的位置。
    // 例如：currentIndex = 0, index = 9, length = 10, maxOffsetDistance = 3
    // diff = 9。 length - maxOffsetDistance = 10 - 3 = 7。 9 >= 7 为真。
    // 此时，9 实际上是 -1 的偏移量。
    // diff - length 即可得到负向偏移量。
    return diff - length;
  } else {
    // 否则，表示 index 位于 currentIndex 的“远处”，且不是近距离的负向偏移。
    // 按照需求，所有超出直接范围的索引都统一设置为 maxOffsetDistance (即 3)。
    // 例如：currentIndex = 0, index = 4, length = 10, maxOffsetDistance = 3
    // diff = 4。 4 <= 3 为假。 4 >= 7 为假。
    // 进入此分支，返回 3。
    return maxOffsetDistance;
  }
}