IWSR

function unstable_scheduleCallback(priorityLevel, callback, options) {
  /**
   * 関数が実行される現在の時間を取得し、後で優先度に基づいてタスクのstartTimeを計算し、
   * タスクが期限切れかどうかを判断する基礎となります。
   * */
  var currentTime = exports.unstable_now();
  var startTime;
  /**
   * 外部から手動でdelayを渡してタスクの実行を遅らせることができます。
  */
  if (typeof options === 'object' && options !== null) {
    var delay = options.delay;

    if (typeof delay === 'number' && delay > 0) {
      startTime = currentTime + delay;
    } else {
      startTime = currentTime;
    }
  } else {
    startTime = currentTime;
  }

  var timeout;
  /**
   * timeoutは優先度によって異なる値が割り当てられます。
   * ImmediatePriorityに対応するtimeoutは-1であり、この優先度のタスクは登録時に
   * すでに期限切れと見なされるため、迅速に実行されます。
  */
  switch (priorityLevel) {
    case ImmediatePriority:
      timeout = IMMEDIATE_PRIORITY_TIMEOUT; // -1
      break;

    case UserBlockingPriority:
      timeout = USER_BLOCKING_PRIORITY_TIMEOUT; // 250
      break;

    case IdlePriority:
      timeout = IDLE_PRIORITY_TIMEOUT; // 1073741823
      break;

    case LowPriority:
      timeout = LOW_PRIORITY_TIMEOUT; // 10000
      break;

    case NormalPriority:
    default:
      timeout = NORMAL_PRIORITY_TIMEOUT; // 5000
      break;
  }
  /**
   * 期限を計算します。
  */
  var expirationTime = startTime + timeout;
  var newTask = {
    id: taskIdCounter++,
    callback: callback, // タスク登録の関数
    priorityLevel: priorityLevel,
    startTime: startTime, // タスクの開始時間
    expirationTime: expirationTime, // 期限
    sortIndex: -1 // 小さいヒープソートの基準
  };

  if (startTime > currentTime) {
    // これは遅延タスクです。delayが設定されているため、これはタイマーを設定する必要があるタスクです。
    newTask.sortIndex = startTime;
    // このタスクをtimerQueueに追加します。
    push(timerQueue, newTask);

    if (peek(taskQueue) === null && newTask === peek(timerQueue)) {
      // すべてのタスクが遅延しており、これは最も早い遅延のタスクです。
      // taskQueueが空で、現在のタスクがtimerQueue内で最前に並んでいます。
      if (isHostTimeoutScheduled) {
        // 既存のタイムアウトをキャンセルします。
        cancelHostTimeout();
      } else {
        isHostTimeoutScheduled = true;
      } // タイムアウトをスケジュールします。

      // requestHostTimeoutは単なるラップされたタイマーです。
      /**
       * handleTimeoutはスケジューリングを開始する関数で、後で分析します。
       * このコードでは、現在のタスクを実行するためにスケジューリングを開始することを一時的に理解できます。
       * */
      requestHostTimeout(handleTimeout, startTime - currentTime);
    }
  } else {
    /**
     * delayが設定されていない場合は、タスクを直接taskQueueに追加します。
    */
    newTask.sortIndex = expirationTime;
    push(taskQueue, newTask);
    // 次にyieldするまで待ちます。

    if (!isHostCallbackScheduled && !isPerformingWork) {
      isHostCallbackScheduled = true;
      /**
       * flushWorkは重要な関数で、taskQueueをクリアする操作に関与します。
       * requestHostCallbackはMessageChannelをトリガーし、performWorkUntilDeadlineを実行します。後で詳細に分析します。
       * ここでは、以下のコードをtaskQueue内のタスクをクリアするためにflushWorkを呼び出すものとして理解できます。
      */
      requestHostCallback(flushWork);
    }
  }

  return newTask;
}

/**
 * advanceTimersがtimerQとtaskQを整理した後
 * taskQ内にタスクがあれば、そのタスクをスケジュールします。
 * そうでなければ、timerQ内にタスクが存在するか確認し、あればそのstartTimeにタイマーを設定し、handleTimeoutを呼び出します。
*/
function handleTimeout(currentTime) {
  isHostTimeoutScheduled = false;
  advanceTimers(currentTime); // timerQとtaskQを整理するための関数です。

  if (!isHostCallbackScheduled) {
    if (peek(taskQueue) !== null) {
      /**
       * taskQが空でない場合、スケジュールを開始します。
      */
      isHostCallbackScheduled = true;
      // unstable_scheduleCallback内にも同様の操作があり、スケジューリングの開始のエントリです。
      requestHostCallback(flushWork);
    } else {
      /**
       * この時点でtaskQ内にスケジュールできるタスクがありません。
       * timerQ内にタスクがstartTimeに達しているか確認する必要があります。
      */
      var firstTimer = peek(timerQueue);

      if (firstTimer !== null) {
        /**
         * timerQの最初の要素にタイマーを設定し、startTimeに達したら、
         * advanceTimersを使ってタスクをtaskQに移し、スケジュールします。
        */
        requestHostTimeout(handleTimeout, firstTimer.startTime - currentTime);
      }
    }
  }
}

/**
 * timerQを繰り返し、startTimeに達したタスクをtaskQに移します。
 * さらに、キャンセルされたタスクを捨てる役割も担います。
*/
function advanceTimers(currentTime) {
  // 期限が切れていないタスクをチェックし、キューに追加します。
  var timer = peek(timerQueue);

  while (timer !== null) {
    if (timer.callback === null) { // unstable_cancelCallbackがタスクをキャンセルすると、タスクのcallbackがnullになります。
      // タイマーがキャンセルされました。
      pop(timerQueue); // ここでキャンセルされたタスクを捨てます。
    } else if (timer.startTime <= currentTime) {
      // タイマーが発火しました。タスクキューに移します。
      // タスクがstartTimeに達したので、taskQに移動します。
      pop(timerQueue);
      timer.sortIndex = timer.expirationTime;
      push(taskQueue, timer);
    } else {
      // 残りのタイマーは保留中です。
      return;
    }

    timer = peek(timerQueue);
  }
}

/**
 * requestHostCallback(flushWork)に基づいて
 * ここでのcallbackはflushWorkです。
*/
function requestHostCallback(callback) {
  scheduledHostCallback = callback; // flushWorkをscheduledHostCallbackに割り当てます。

  if (!isMessageLoopRunning) {
    isMessageLoopRunning = true;
    schedulePerformWorkUntilDeadline(); // 重要な関数です。
  }
}

var channel = new MessageChannel();
var port = channel.port2;
channel.port1.onmessage = performWorkUntilDeadline;

schedulePerformWorkUntilDeadline = function () {
  port.postMessage(null);
};

var performWorkUntilDeadline = function () {
  /**
   * ここでのscheduledHostCallbackは実際にはflushWorkです。
   * 詳細はrequestHostCallbackを参照してください。
  */
  if (scheduledHostCallback !== null) {
    var currentTime = exports.unstable_now();

    startTime = currentTime;
    var hasTimeRemaining = true;

    var hasMoreWork = true;
    try {
      /**
       * flushWorkを実行し、その返り値はtaskQが空かどうかを示します。
       * 空でない場合、スケジュールされるべきタスクがまだ存在します。
      */
      hasMoreWork = scheduledHostCallback(hasTimeRemaining, currentTime);
    } finally {
      /**
       * もし
      */
      if (hasMoreWork) {
        // もしまだ作業が残っている場合、前のメッセージイベントの終わりに次のメッセージイベントをスケジュールします。
        /**
         * まだスケジュールされるタスクが存在するため、再度MessageChannelをトリガーします。
        */
        schedulePerformWorkUntilDeadline();
      } else {
        isMessageLoopRunning = false;
        scheduledHostCallback = null;
      }
    }
  } else {
    isMessageLoopRunning = false;
  } // ブラウザに制御を譲ることで、描画の機会を与えます。
};

/**
 * その意味はただworkLoopを呼び出すことです。
*/
function flushWork(hasTimeRemaining, initialTime) {
  /**
   * hasTimeRemainingはtrueに設定され、
   * initialTimeはperformWorkUntilDeadlineが呼び出されたときのタイムスタンプです。
  */
  isHostCallbackScheduled = false;

  if (isHostTimeoutScheduled) {
    // タイムアウトをスケジュールしましたが、もはや必要ありません。キャンセルします。
    /**
     * まずtaskQをクリアし、タイマー設定の内容が割り込まれないようにします。
     * 既存のタイマーをキャンセルします。
    */
    isHostTimeoutScheduled = false;
    cancelHostTimeout();
  }

  isPerformingWork = true;
  var previousPriorityLevel = currentPriorityLevel;

  try {
    if (enableProfiling) {
      try {
        /**
         * flushWorkの全体の重点は実際にはworkLoopを呼び出すことです。
        */
        return workLoop(hasTimeRemaining, initialTime);
      } catch (error) {
        if (currentTask !== null) {
          var currentTime = exports.unstable_now();
          markTaskErrored(currentTask, currentTime);
          currentTask.isQueued = false;
        }

        throw error;
      }
    } else {
      // プロダクションコードパスではキャッチしません。
      return workLoop(hasTimeRemaining, initialTime);
    }
  } finally {
    currentTask = null;
    currentPriorityLevel = previousPriorityLevel;
    isPerformingWork = false;
  }
}

/**
 * taskQをループし、各タスク内のcallbackを実行します。
*/
function workLoop(hasTimeRemaining, initialTime) {
  var currentTime = initialTime;
  /**
   * timerQとtaskQを整理します。
  */
  advanceTimers(currentTime);
  currentTask = peek(taskQueue); // 最初のタスクを取得します。

  while (currentTask !== null && !(enableSchedulerDebugging)) {
    /**
     * タスクが期限切れでなく、時間スライスがまだ残っている場合は、whileループを続けます。
     * そうでなければ、抜けます。
     * shouldYieldToHost内に時間スライスの内容が存在し、後で個別に分析します。
    */
    if (currentTask.expirationTime > currentTime && (!hasTimeRemaining || shouldYieldToHost())) {
      // このcurrentTaskは期限切れではなく、締切に達しました。
      break;
    }

    var callback = currentTask.callback;

    /**
     * callbackはfunction/nullの2つの値を持ちます。
     * もしfunctionであれば、有効なタスクです。
     * もしnullであれば、キャンセルされたタスクです。
    */
    if (typeof callback === 'function') {
      currentTask.callback = null;
      currentPriorityLevel = currentTask.priorityLevel;
      var didUserCallbackTimeout = currentTask.expirationTime <= currentTime;

      /**
       * Performanceツールでここを記録すると、
       * ここでのcallbackは実際にはperformConcurrentWorkOnRootであることがわかります。
       * その関数内で、root.callbackNode === originalCallbackNodeが満たされると、
       * つまり元のタスクが完了していない場合、再びperformConcurrentWorkOnRootに戻り、中断されたタスクを回復します。
       * 
       * 補足として、ここで中断が発生する可能性があるのは、主に時間スライスが使い果たされたためであり、shouldYieldToHost()の内容です。
       * 
       * Tip: ここであまり細かいことにこだわらないでください。ソースコードを読む上で最も避けるべきことは、細部に巻き込まれることです（後で時間があればこのデバッグ記録を補足します）。
      */
      var continuationCallback = callback(didUserCallbackTimeout);
      currentTime = exports.unstable_now();

      if (typeof continuationCallback === 'function') {
        /**
         * 実行が終了していないため、タスクのcallbackに再度値を設定し、次回の呼び出しで中断されたタスクを回復します。
        */
        currentTask.callback = continuationCallback;
      } else {
        /**
         * ここでは、タスクが正常に実行されたため、このタスクを捨てることができます。
        */
        if (currentTask === peek(taskQueue)) {
          pop(taskQueue);
        }
      }
      /**
       * 分析済みですが、忘れた場合は上に戻ってください。
      */
      advanceTimers(currentTime);
    } else {
      /**
       * これはキャンセルされたタスクです。
       * したがって、実行する必要はなく、popします。
      */
      pop(taskQueue);
    }

    currentTask = peek(taskQueue);
  } // 追加の作業があるかどうかを返します。

  /**
   * たとえ時間スライスが使い果たされてwhileループが中断されても、以下の判断ロジックに入ります。
  */
  if (currentTask !== null) {
    // もしwhileループが中断された場合、currentTaskは必ずnullではありません。
    // したがって、trueを返します。
    return true;
  } else {
    // もしwhileループが正常に終了した場合、currentTaskは必ずnullです。
    var firstTimer = peek(timerQueue);

    if (firstTimer !== null) {
      // timerQueueが空でない限り、次のスケジュールを開始します。
      requestHostTimeout(handleTimeout, firstTimer.startTime - currentTime);
    }
    // タスクが実行されたため、残りのタスクは存在しないので、falseを返します。
    return false;
  }
  // workLoopの返り値は実際にはhasMoreWorkに割り当てられます。
}

function shouldYieldToHost() {
  /**
   * performWorkUntilDeadlineが実行を開始する際にstartTimeが設定されます。
  */
  const timeElapsed = getCurrentTime() - startTime;
  /**
   * frameIntervalのデフォルト値は5msですが、
   * ディスプレイのfps（0, 125）に基づいて自動的に計算されます。計算方法はMath.floor(1000 / fps)です。
   * つまり、一フレームのミリ秒数であり、この値が時間スライスです。
  */
  if (timeElapsed < frameInterval) {
    // メインスレッドは非常に短い時間しかブロックされていません。
    // 一つのフレームよりも小さいです。まだ中断しません。
    return false;
  }

  // メインスレッドが無視できない時間ブロックされています。制御をメインスレッドに譲る必要があります。
  // これにより、ブラウザは高優先度のタスクを実行できます。主なものは描画とユーザー入力です。
  // 保留中の描画や保留中の入力があれば、中断する必要があります。
  // どちらもない場合、応答性を保ちながら、あまり頻繁に中断することはありません。
  // 最終的には中断することになります。なぜなら、保留中の描画があるかもしれないからです。
  // それはrequestPaintの呼び出しを伴わないかもしれませんし、ネットワークイベントのような他のメインスレッドタスクもあります。
  /**
   * 要点：ユーザー入力に優先的に応答する必要があります。
  */
  if (enableIsInputPending) {
    if (needsPaint) {
      // 保留中の描画があります（requestPaintによって信号されます）。今中断します。
      return true;
    }
    if (timeElapsed < continuousInputInterval) {
      // まだスレッドを長時間ブロックしていません。保留中の離散入力（例：クリック）がある場合のみ中断します。
      // 保留中の連続入力（例：マウスオーバー）は問題ありません。
      if (isInputPending !== null) {
        return isInputPending();
      }
    } else if (timeElapsed < maxInterval) {
      // 保留中の離散または連続入力がある場合は中断します。
      if (isInputPending !== null) {
        return isInputPending(continuousOptions);
      }
    } else {
      // スレッドを長時間ブロックしました。保留中の入力がなくても、他のスケジュールされた作業があるかもしれません。
      // 例えば、ネットワークイベントなどです。今中断します。
      return true;
    }
  }

  // `isInputPending`が利用できない場合。今中断します。
  // isInputPendingが関与しないので、中断します。
  return true;
}