🔀 🔥 deprecate all utility functions

index.ts

@@ -5,8 +5,3 @@ export { default as yieldOrContinue } from './src/yieldOrContinue'
 export { default as yieldControl } from './src/yieldControl'
 export { default as isTimeToYield } from './src/isTimeToYield'
 export type { default as SchedulingStrategy } from './src/SchedulingStrategy'
-
-// utility
-export { default as queueTask } from './src/utils/queueTask'
-export { default as withResolvers } from './src/utils/withResolvers'
-export { default as requestAfterFrame } from './src/utils/requestAfterFrame'

playground/index.html

@@ -53,7 +53,7 @@
         <br />
         <div>
             <code>others:</code>
-            <button id="queue-task">queueTask()</button>
+            <button id="queue-task">waitNextTask()</button>
             <button id="simulate-work">simulateWork()</button>
             <button id="post-task-vs-yield-or-continue">postTask() vs yieldOrContinue()</button>
         </div>

playground/playground.ts

@@ -1,11 +1,6 @@
-import {
-    isTimeToYield,
-    queueTask,
-    SchedulingStrategy,
-    withResolvers,
-    yieldOrContinue,
-} from '../index'
+import { isTimeToYield, SchedulingStrategy, withResolvers, yieldOrContinue } from '../index'
 import simulateWork from './utils/simulateWork'
+import waitNextTask from '../src/utils/waitNextTask'
 
 document.querySelector('#run-interactive')!.addEventListener('click', () => {
     run('interactive')
@@ -45,7 +40,7 @@ document.querySelector('#post-task-vs-yield-or-continue')!.addEventListener('cli
     postTaskVsYieldOrContinue()
 })
 document.querySelector('#queue-task')!.addEventListener('click', () => {
-    runQueueTask()
+    runWaitNextTask()
 })
 
 async function run(strategy: SchedulingStrategy, time: number = 1000) {
@@ -80,10 +75,10 @@ async function runPostTask(priority: 'user-blocking' | 'user-visible' | 'backgro
     }
 }
 
-async function runQueueTask(time: number = 1000) {
+async function runWaitNextTask(time: number = 1000) {
     const start = Date.now()
     while (Date.now() - start < time) {
-        await new Promise<void>((resolve) => queueTask(resolve))
+        await waitNextTask()
         simulateWork()
     }
 }
@@ -102,10 +97,10 @@ async function postTaskVsYieldOrContinue() {
         const start = performance.now()
         let count = 0
         while (performance.now() - start < 1000) {
-            await new Promise<void>((resolve) => queueTask(resolve))
+            await waitNextTask()
             count++
         }
-        console.log(count.toString(), '→ queueTask()')
+        console.log(count.toString(), '→ waitNextTask()')
     }
     {
         const start = performance.now()

readme.md

@@ -83,14 +83,6 @@ async function findInFiles(query: string) {
 }
 ```
 
-#### `requestAfterFrame(callback)`
-
-_This is a utility function, most people don't need to use it._ The same way `requestAnimationFrame()` queues a `callback` to be executed just before a frame is rendered `requestAfterFrame()` is called just after a frame is rendered.
-
-#### `queueTask(callback)`
-
-_This is a utility function, most people don't need to use it._ The same way `queueMicrotask()` queues a `callback` to be executed in the end of the current microtask, `queueTask()` queues the task for the next task. You learn more at [here](https://developer.mozilla.org/en-US/docs/Web/API/HTML_DOM_API/Microtask_guide#tasks_vs._microtasks).
-
 ### More complex scenarios
 
 The library has two more functions available:

src/frameTracker.ts

@@ -1,5 +1,5 @@
 import withResolvers, { PromiseWithResolvers } from './utils/withResolvers'
-import { queueTask } from '../index'
+import waitNextTask from './utils/waitNextTask'
 
 class FrameTracker {
     #timeoutId?: number
@@ -10,13 +10,9 @@ class FrameTracker {
         this.#deferred = withResolvers()
     }
 
-    async waitAnimationFrame(): Promise<void> {
-        return this.#deferred.promise
-    }
-
     async waitAfterFrame(): Promise<void> {
         await this.#deferred.promise
-        await new Promise<void>((resolve) => queueTask(resolve))
+        await waitNextTask()
     }
 
     start(): void {