+
+
+
+
+ `
+
+ container.querySelector('#add-item-btn')?.addEventListener('click', addItem)
+ container.querySelector('#flush-btn')?.addEventListener('click', flushBatch)
+ container.querySelector('#clear-btn')?.addEventListener('click', clearBatch)
+ container
+ .querySelector('#cancel-btn')
+ ?.addEventListener('click', cancelPending)
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'LiteBatcher example ready! Add items and watch them batch automatically, or use flush to process immediately.',
+)
diff --git a/examples/vanilla/LiteBatcher/tsconfig.json b/examples/vanilla/LiteBatcher/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/LiteBatcher/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/LiteBatcher/vite.config.ts b/examples/vanilla/LiteBatcher/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/LiteBatcher/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/LiteDebouncer/index.html b/examples/vanilla/LiteDebouncer/index.html
new file mode 100644
index 00000000..181e3539
--- /dev/null
+++ b/examples/vanilla/LiteDebouncer/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer LiteBatcher Example
+| Batch Size: | +${batchSize} | +
| Batch Max Size: | +5 | +
| Batch Items: | +${batchItems.length > 0 ? batchItems.join(', ') : 'None'} | +
| Is Pending: | +${isPending ? 'Yes' : 'No'} | +
| Batches Processed: | +${batchesProcessed} | +
| Items Processed: | +${totalItemsProcessed} | +
| Processed Batches: | +${processedBatches.length > 0 ? processedBatches.map((b) => `[${b.join(', ')}]`).join(', ') : 'None'} | +
+
+
+
+
+
+
+
+
+
+
+ `
+
+ container
+ .querySelector('#increment-btn')
+ ?.addEventListener('click', increment)
+ container
+ .querySelector('#decrement-btn')
+ ?.addEventListener('click', decrement)
+ container.querySelector('#flush-btn')?.addEventListener('click', flush)
+ container.querySelector('#cancel-btn')?.addEventListener('click', cancel)
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'LiteDebouncer example ready! Click the buttons rapidly and watch the console for debounced executions.',
+)
diff --git a/examples/vanilla/LiteDebouncer/tsconfig.json b/examples/vanilla/LiteDebouncer/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/LiteDebouncer/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/LiteDebouncer/vite.config.ts b/examples/vanilla/LiteDebouncer/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/LiteDebouncer/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/LiteQueuer/index.html b/examples/vanilla/LiteQueuer/index.html
new file mode 100644
index 00000000..dbb31999
--- /dev/null
+++ b/examples/vanilla/LiteQueuer/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer LiteDebouncer Example
+| Instant Count: | +${instantCount} | +
| Debounced Count: | +${debouncedCount} | +
+
+
+
+
+
+
+
+
+
+
+ `
+
+ container.querySelector('#add-item-btn')?.addEventListener('click', addItem)
+ container
+ .querySelector('#execute-btn')
+ ?.addEventListener('click', executeNext)
+ container.querySelector('#clear-btn')?.addEventListener('click', clearQueue)
+ container
+ .querySelector('#start-btn')
+ ?.addEventListener('click', startProcessing)
+ container
+ .querySelector('#stop-btn')
+ ?.addEventListener('click', stopProcessing)
+ container.querySelector('#flush-btn')?.addEventListener('click', flushQueue)
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'LiteQueuer example ready! Use the buttons to control queue processing.',
+)
diff --git a/examples/vanilla/LiteQueuer/tsconfig.json b/examples/vanilla/LiteQueuer/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/LiteQueuer/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/LiteQueuer/vite.config.ts b/examples/vanilla/LiteQueuer/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/LiteQueuer/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/LiteRateLimiter/index.html b/examples/vanilla/LiteRateLimiter/index.html
new file mode 100644
index 00000000..2f19b23c
--- /dev/null
+++ b/examples/vanilla/LiteRateLimiter/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer LiteQueuer Example
+| Queue Size: | +${queueSize} | +
| Queue Max Size: | +25 | +
| Queue Full: | +${isFull ? 'Yes' : 'No'} | +
| Queue Peek: | +${peekNext ?? 'None'} | +
| Queue Empty: | +${isEmpty ? 'Yes' : 'No'} | +
| Queuer Status: | +${isRunning ? 'Running' : 'Stopped'} | +
| Items Processed: | +${executionCount} | +
| Queue Items: | +${allItems.length > 0 ? allItems.join(', ') : 'None'} | +
+
+
+
+
+
+
+
+
+
+
+
+
+ `
+
+ container
+ .querySelector('#increment-btn')
+ ?.addEventListener('click', increment)
+ container.querySelector('#reset-btn')?.addEventListener('click', reset)
+ container
+ .querySelector('input[value="fixed"]')
+ ?.addEventListener('change', () => setWindowType('fixed'))
+ container
+ .querySelector('input[value="sliding"]')
+ ?.addEventListener('change', () => setWindowType('sliding'))
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'LiteRateLimiter example ready! Click increment rapidly and watch the console for rate limited executions.',
+)
diff --git a/examples/vanilla/LiteRateLimiter/tsconfig.json b/examples/vanilla/LiteRateLimiter/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/LiteRateLimiter/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/LiteRateLimiter/vite.config.ts b/examples/vanilla/LiteRateLimiter/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/LiteRateLimiter/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/LiteThrottler/index.html b/examples/vanilla/LiteThrottler/index.html
new file mode 100644
index 00000000..ff224096
--- /dev/null
+++ b/examples/vanilla/LiteThrottler/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer LiteRateLimiter Example
+
+
+
+
+ | Execution Count: | +${executionCount} | +
| Rejection Count: | +${rejectionCount} | +
| Remaining in Window: | +${remainingInWindow} | +
| Ms Until Next Window: | +${msUntilNextWindow} | +
| Instant Count: | +${instantCount} | +
| Rate Limited Count: | +${limitedCount} | +
+
+
+
+
+
+
+
+
+ `
+
+ container
+ .querySelector('#increment-btn')
+ ?.addEventListener('click', increment)
+ container
+ .querySelector('#decrement-btn')
+ ?.addEventListener('click', decrement)
+ container.querySelector('#flush-btn')?.addEventListener('click', flush)
+ container.querySelector('#cancel-btn')?.addEventListener('click', cancel)
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'LiteThrottler example ready! Click the buttons rapidly and watch the console for throttled executions.',
+)
diff --git a/examples/vanilla/LiteThrottler/tsconfig.json b/examples/vanilla/LiteThrottler/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/LiteThrottler/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/LiteThrottler/vite.config.ts b/examples/vanilla/LiteThrottler/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/LiteThrottler/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/liteBatch/index.html b/examples/vanilla/liteBatch/index.html
new file mode 100644
index 00000000..dc4e0ecb
--- /dev/null
+++ b/examples/vanilla/liteBatch/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer LiteThrottler Example
+| Instant Count: | +${instantCount} | +
| Throttled Count: | +${throttledCount} | +
+
+
+
+
+
+
+
+
+
+
+ `
+
+ container.querySelector('#add-item-btn')?.addEventListener('click', addItem)
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'liteBatch example ready! Add items and watch them batch automatically.',
+)
diff --git a/examples/vanilla/liteBatch/tsconfig.json b/examples/vanilla/liteBatch/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/liteBatch/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/liteBatch/vite.config.ts b/examples/vanilla/liteBatch/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/liteBatch/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/liteDebounce/index.html b/examples/vanilla/liteDebounce/index.html
new file mode 100644
index 00000000..2e51fefb
--- /dev/null
+++ b/examples/vanilla/liteDebounce/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer liteBatch Example
+| Batch Max Size: | +5 | +
| Batches Processed: | +${batchesProcessed} | +
| Items Processed: | +${totalItemsProcessed} | +
| Processed Batches: | +${processedBatches.length > 0 ? processedBatches.map((b) => `[${b.join(', ')}]`).join(', ') : 'None'} | +
+
+
+
+
+ Note: liteBatch function automatically processes batches. Batches process when: maxSize (5) is reached, wait time (3s) elapses, or item 42 is added. Use LiteBatcher class for manual control.
+
+
+
+
+
+ `
+
+ const incrementBtn = container.querySelector(
+ '#increment-btn',
+ ) as HTMLButtonElement
+ const decrementBtn = container.querySelector(
+ '#decrement-btn',
+ ) as HTMLButtonElement
+ incrementBtn?.addEventListener('click', increment)
+ decrementBtn?.addEventListener('click', decrement)
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'liteDebounce example ready! Click the buttons rapidly and watch the console for debounced executions.',
+)
diff --git a/examples/vanilla/liteDebounce/tsconfig.json b/examples/vanilla/liteDebounce/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/liteDebounce/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/liteDebounce/vite.config.ts b/examples/vanilla/liteDebounce/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/liteDebounce/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/liteQueue/index.html b/examples/vanilla/liteQueue/index.html
new file mode 100644
index 00000000..b8e249fc
--- /dev/null
+++ b/examples/vanilla/liteQueue/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer liteDebounce Example
+| Instant Count: | +${instantCount} | +
| Debounced Count: | +${debouncedCount} | +
+
+
+
+
+
+
+
+
+ `
+
+ container.querySelector('#add-item-btn')?.addEventListener('click', addItem)
+ container.querySelector('#clear-btn')?.addEventListener('click', clearQueue)
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'liteQueue example ready! Items will be processed automatically with 1 second delay between each.',
+)
diff --git a/examples/vanilla/liteQueue/tsconfig.json b/examples/vanilla/liteQueue/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/liteQueue/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/liteQueue/vite.config.ts b/examples/vanilla/liteQueue/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/liteQueue/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/liteRateLimit/index.html b/examples/vanilla/liteRateLimit/index.html
new file mode 100644
index 00000000..06c71fcd
--- /dev/null
+++ b/examples/vanilla/liteRateLimit/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer liteQueue Example
+| Items Processed: | +${executionCount} | +
| Processed Items: | +${processedItems.length > 0 ? processedItems.join(', ') : 'None'} | +
| Queue Max Size: | +25 | +
+
+
+
+
+
+ Note: liteQueue function automatically processes items with 1 second delay. Queue state is not accessible - use LiteQueuer class for full control.
+
+
+
+
+
+ `
+
+ container
+ .querySelector('#increment-btn')
+ ?.addEventListener('click', increment)
+ container.querySelector('#reset-btn')?.addEventListener('click', reset)
+ container
+ .querySelector('input[value="fixed"]')
+ ?.addEventListener('change', () => setWindowType('fixed'))
+ container
+ .querySelector('input[value="sliding"]')
+ ?.addEventListener('change', () => setWindowType('sliding'))
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'liteRateLimit example ready! Click increment rapidly and watch the console for rate limited executions.',
+)
diff --git a/examples/vanilla/liteRateLimit/tsconfig.json b/examples/vanilla/liteRateLimit/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/liteRateLimit/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/liteRateLimit/vite.config.ts b/examples/vanilla/liteRateLimit/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/liteRateLimit/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/examples/vanilla/liteThrottle/index.html b/examples/vanilla/liteThrottle/index.html
new file mode 100644
index 00000000..51a534be
--- /dev/null
+++ b/examples/vanilla/liteThrottle/index.html
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+ TanStack Pacer liteRateLimit Example
+
+
+
+
+ | Execution Count: | +${executionCount} | +
| Rejection Count: | +${rejectionCount} | +
| Instant Count: | +${instantCount} | +
| Rate Limited Count: | +${limitedCount} | +
+
+
+
+
+
+
+
+
+ `
+
+ const incrementBtn = container.querySelector(
+ '#increment-btn',
+ ) as HTMLButtonElement
+ const decrementBtn = container.querySelector(
+ '#decrement-btn',
+ ) as HTMLButtonElement
+ incrementBtn?.addEventListener('click', increment)
+ decrementBtn?.addEventListener('click', decrement)
+ }
+
+ updateDisplay()
+ return container
+}
+
+const app = document.getElementById('app')!
+app.appendChild(createApp1())
+
+console.log(
+ 'liteThrottle example ready! Click the buttons rapidly and watch the console for throttled executions.',
+)
diff --git a/examples/vanilla/liteThrottle/tsconfig.json b/examples/vanilla/liteThrottle/tsconfig.json
new file mode 100644
index 00000000..41a2fe79
--- /dev/null
+++ b/examples/vanilla/liteThrottle/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ESNext",
+ "lib": ["DOM", "DOM.Iterable", "ESNext"],
+ "module": "ESNext",
+ "skipLibCheck": true,
+
+ /* Bundler mode */
+ "moduleResolution": "Bundler",
+ "allowImportingTsExtensions": true,
+ "resolveJsonModule": true,
+ "isolatedModules": true,
+ "noEmit": true,
+
+ /* Linting */
+ "strict": true,
+ "noUnusedLocals": true,
+ "noUnusedParameters": true,
+ "noFallthroughCasesInSwitch": true
+ },
+ "include": ["src", "vite.config.ts"]
+}
diff --git a/examples/vanilla/liteThrottle/vite.config.ts b/examples/vanilla/liteThrottle/vite.config.ts
new file mode 100644
index 00000000..f93d3793
--- /dev/null
+++ b/examples/vanilla/liteThrottle/vite.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+ root: '.',
+ publicDir: 'public',
+ build: {
+ outDir: 'dist',
+ },
+ server: {
+ port: 3005,
+ },
+})
diff --git a/package.json b/package.json
index 93f76934..babcf209 100644
--- a/package.json
+++ b/package.json
@@ -8,15 +8,16 @@
"packageManager": "pnpm@10.17.1",
"type": "module",
"scripts": {
- "build": "nx affected --skip-nx-cache --targets=build --exclude=examples/** && size-limit",
- "build:all": "nx run-many --targets=build --exclude=examples/** && size-limit",
- "build:core": "nx run-many --targets=build --projects=packages/pacer,packages/persister && size-limit",
+ "build": "nx affected --skip-nx-cache --targets=build --exclude=examples/** && size-limit && pnpm run copy:readme",
+ "build:all": "nx run-many --targets=build --exclude=examples/** && size-limit && pnpm run copy:readme",
+ "build:core": "nx run-many --targets=build --projects=packages/pacer,packages/persister && size-limit && pnpm run copy:readme",
"changeset": "changeset",
"changeset:publish": "changeset publish",
"changeset:version": "changeset version && pnpm install --no-frozen-lockfile && pnpm prettier:write",
"clean": "find . -name 'dist' -type d -prune -exec rm -rf {} +",
"clean:node_modules": "find . -name 'node_modules' -type d -prune -exec rm -rf {} +",
"clean:all": "pnpm run clean && pnpm run clean:node_modules",
+ "copy:readme": "cp README.md packages/pacer/README.md && cp README.md packages/pacer-devtools/README.md && cp README.md packages/pacer-lite/README.md && cp README.md packages/react-pacer/README.md && cp README.md packages/react-pacer-devtools/README.md && cp README.md packages/solid-pacer/README.md && cp README.md packages/solid-pacer-devtools/README.md",
"dev": "pnpm run watch",
"docs:generate": "node scripts/generateDocs.js",
"format": "pnpm run prettier:write",
@@ -79,6 +80,7 @@
},
"overrides": {
"@tanstack/pacer": "workspace:*",
+ "@tanstack/pacer-lite": "workspace:*",
"@tanstack/react-pacer": "workspace:*",
"@tanstack/solid-pacer": "workspace:*",
"@tanstack/pacer-devtools": "workspace:*",
diff --git a/packages/pacer-devtools/README.md b/packages/pacer-devtools/README.md
new file mode 100644
index 00000000..42347dcc
--- /dev/null
+++ b/packages/pacer-devtools/README.md
@@ -0,0 +1,165 @@
+TanStack Pacer liteThrottle Example
+| Instant Count: | +${instantCount} | +
| Throttled Count: | +${throttledCount} | +
+
+
+
+
+ 
+
+
+
++ + + + + +
+ 
+ 
+
+ 
+
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
+# TanStack Pacer
+
+A lightweight timing and scheduling library for debouncing, throttling, rate limiting, queuing, and batching.
+
+> [!NOTE]
+> TanStack Pacer is currently mostly a client-side only library, but it is being designed to be able to potentially be used on the server-side as well.
+
+- **Debouncing**
+ - Delay execution until after a period of inactivity for when you only care about the last execution in a sequence.
+ - Synchronous or Asynchronous Debounce utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options
+- **Throttling**
+ - Smoothly limit the rate at which a function can fire
+ - Synchronous or Asynchronous Throttle utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options.
+- **Rate Limiting**
+ - Limit the rate at which a function can fire over a period of time
+ - Synchronous or Asynchronous Rate Limiting utilities with promise support and error handling
+ - Fixed or Sliding Window variations of Rate Limiting
+- **Queuing**
+ - Queue functions to be executed in a specific order
+ - Choose from FIFO, LIFO, and Priority queue implementations
+ - Control processing speed with configurable wait times or concurrency limits
+ - Manage queue execution with start/stop capabilities
+ - Expire items from the queue after a configurable duration
+- **Batching**
+ - Chunk up multiple operations into larger batches to reduce total back-and-forth operations
+ - Batch by time period, batch size, whichever comes first, or a custom condition to trigger batch executions
+- **Async or Sync Variations**
+ - Choose between synchronous and asynchronous versions of each utility
+ - Optional error, success, and settled handling for async variations
+ - Retry and Abort support for async variations
+- **State Management**
+ - Uses TanStack Store under the hood for state management with fine-grained reactivity
+ - Easily integrate with your own state management library of choice
+ - Persist state to local or session storage for some utilities like rate limiting and queuing
+- **Convenient Hooks**
+ - Reduce boilerplate code with pre-built hooks like `useDebouncedCallback`, `useThrottledValue`, and `useQueuedState`, and more.
+ - Multiple layers of abstraction to choose from depending on your use case.
+ - Works with each framework's default state management solutions, or with whatever custom state management library that you prefer.
+- **Type Safety**
+ - Full type safety with TypeScript that makes sure that your functions will always be called with the correct arguments
+ - Generics for flexible and reusable utilities
+- **Framework Adapters**
+ - React, Solid, and more
+- **Tree Shaking**
+ - We, of course, get tree-shaking right for your applications by default, but we also provide extra deep imports for each utility, making it easier to embed these utilities into your libraries without increasing the bundle-phobia reports of your library.
+
+### Read the docs →
+
++ +> [!NOTE] +> You may know **TanSack Pacer** by our adapter names, too! +> +> - [**React Pacer**](https://tanstack.com/pacer/latest/docs/framework/react/react-pacer) +> - [**Solid Pacer**](https://tanstack.com/pacer/latest/docs/framework/solid/solid-pacer) +> - Angular Pacer - needs a contributor! +> - Preact Pacer - Coming soon! (After React Pacer is more fleshed out) +> - Svelte Pacer - needs a contributor! +> - Vue Pacer - needs a contributor! + +## Get Involved + +- We welcome issues and pull requests! +- Participate in [GitHub discussions](https://github.com/TanStack/pacer/discussions) +- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ) +- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions + +## Partners + +
+
+ 
+ |
+
+
+ 
+ |
+
+
+ 
+ |
+
+
+
+
+
+
+## Explore the TanStack Ecosystem
+
+- TanStack Config – Tooling for JS/TS packages
+- TanStack DB – Reactive sync client store
+- TanStack DevTools – Unified devtools panel
+- TanStack Form – Type‑safe form state
+- TanStack Query – Async state & caching
+- TanStack Ranger – Range & slider primitives
+- TanStack Router – Type‑safe routing, caching & URL state
+- TanStack Start – Full‑stack SSR & streaming
+- TanStack Store – Reactive data store
+- TanStack Table – Headless datagrids
+- TanStack Virtual – Virtualized rendering
+
+… and more at TanStack.com »
+
+
diff --git a/packages/pacer-lite/README.md b/packages/pacer-lite/README.md
new file mode 100644
index 00000000..42347dcc
--- /dev/null
+++ b/packages/pacer-lite/README.md
@@ -0,0 +1,165 @@
+
++We're looking for TanStack Pacer Partners to join our mission! Partner with us to push the boundaries of TanStack Pacer and build amazing things together. +
+LET'S CHAT +
+
+
+
+
++ + + + + +
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
+# TanStack Pacer
+
+A lightweight timing and scheduling library for debouncing, throttling, rate limiting, queuing, and batching.
+
+> [!NOTE]
+> TanStack Pacer is currently mostly a client-side only library, but it is being designed to be able to potentially be used on the server-side as well.
+
+- **Debouncing**
+ - Delay execution until after a period of inactivity for when you only care about the last execution in a sequence.
+ - Synchronous or Asynchronous Debounce utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options
+- **Throttling**
+ - Smoothly limit the rate at which a function can fire
+ - Synchronous or Asynchronous Throttle utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options.
+- **Rate Limiting**
+ - Limit the rate at which a function can fire over a period of time
+ - Synchronous or Asynchronous Rate Limiting utilities with promise support and error handling
+ - Fixed or Sliding Window variations of Rate Limiting
+- **Queuing**
+ - Queue functions to be executed in a specific order
+ - Choose from FIFO, LIFO, and Priority queue implementations
+ - Control processing speed with configurable wait times or concurrency limits
+ - Manage queue execution with start/stop capabilities
+ - Expire items from the queue after a configurable duration
+- **Batching**
+ - Chunk up multiple operations into larger batches to reduce total back-and-forth operations
+ - Batch by time period, batch size, whichever comes first, or a custom condition to trigger batch executions
+- **Async or Sync Variations**
+ - Choose between synchronous and asynchronous versions of each utility
+ - Optional error, success, and settled handling for async variations
+ - Retry and Abort support for async variations
+- **State Management**
+ - Uses TanStack Store under the hood for state management with fine-grained reactivity
+ - Easily integrate with your own state management library of choice
+ - Persist state to local or session storage for some utilities like rate limiting and queuing
+- **Convenient Hooks**
+ - Reduce boilerplate code with pre-built hooks like `useDebouncedCallback`, `useThrottledValue`, and `useQueuedState`, and more.
+ - Multiple layers of abstraction to choose from depending on your use case.
+ - Works with each framework's default state management solutions, or with whatever custom state management library that you prefer.
+- **Type Safety**
+ - Full type safety with TypeScript that makes sure that your functions will always be called with the correct arguments
+ - Generics for flexible and reusable utilities
+- **Framework Adapters**
+ - React, Solid, and more
+- **Tree Shaking**
+ - We, of course, get tree-shaking right for your applications by default, but we also provide extra deep imports for each utility, making it easier to embed these utilities into your libraries without increasing the bundle-phobia reports of your library.
+
+### Read the docs →
+
++ +> [!NOTE] +> You may know **TanSack Pacer** by our adapter names, too! +> +> - [**React Pacer**](https://tanstack.com/pacer/latest/docs/framework/react/react-pacer) +> - [**Solid Pacer**](https://tanstack.com/pacer/latest/docs/framework/solid/solid-pacer) +> - Angular Pacer - needs a contributor! +> - Preact Pacer - Coming soon! (After React Pacer is more fleshed out) +> - Svelte Pacer - needs a contributor! +> - Vue Pacer - needs a contributor! + +## Get Involved + +- We welcome issues and pull requests! +- Participate in [GitHub discussions](https://github.com/TanStack/pacer/discussions) +- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ) +- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions + +## Partners + +
|
+
+
+ |
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+## Explore the TanStack Ecosystem
+
+- TanStack Config – Tooling for JS/TS packages
+- TanStack DB – Reactive sync client store
+- TanStack DevTools – Unified devtools panel
+- TanStack Form – Type‑safe form state
+- TanStack Query – Async state & caching
+- TanStack Ranger – Range & slider primitives
+- TanStack Router – Type‑safe routing, caching & URL state
+- TanStack Start – Full‑stack SSR & streaming
+- TanStack Store – Reactive data store
+- TanStack Table – Headless datagrids
+- TanStack Virtual – Virtualized rendering
+
+… and more at TanStack.com »
+
+
diff --git a/packages/pacer-lite/package.json b/packages/pacer-lite/package.json
new file mode 100644
index 00000000..34cacb99
--- /dev/null
+++ b/packages/pacer-lite/package.json
@@ -0,0 +1,113 @@
+{
+ "name": "@tanstack/pacer-lite",
+ "version": "0.0.1",
+ "description": "Lightweight utilities for debouncing, throttling, and more - designed for npm packages.",
+ "author": "Tanner Linsley",
+ "license": "MIT",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/TanStack/pacer.git",
+ "directory": "packages/pacer-lite"
+ },
+ "homepage": "https://tanstack.com/pacer",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/tannerlinsley"
+ },
+ "keywords": [
+ "debounce",
+ "throttle",
+ "rate-limit",
+ "pacer",
+ "lightweight",
+ "minimal"
+ ],
+ "type": "module",
+ "types": "dist/esm/index.d.ts",
+ "main": "dist/cjs/index.cjs",
+ "module": "dist/esm/index.js",
+ "exports": {
+ ".": {
+ "import": {
+ "types": "./dist/esm/index.d.ts",
+ "default": "./dist/esm/index.js"
+ },
+ "require": {
+ "types": "./dist/cjs/index.d.cts",
+ "default": "./dist/cjs/index.cjs"
+ }
+ },
+ "./lite-debouncer": {
+ "import": {
+ "types": "./dist/esm/lite-debouncer.d.ts",
+ "default": "./dist/esm/lite-debouncer.js"
+ },
+ "require": {
+ "types": "./dist/cjs/lite-debouncer.d.cts",
+ "default": "./dist/cjs/lite-debouncer.cjs"
+ }
+ },
+ "./lite-throttler": {
+ "import": {
+ "types": "./dist/esm/lite-throttler.d.ts",
+ "default": "./dist/esm/lite-throttler.js"
+ },
+ "require": {
+ "types": "./dist/cjs/lite-throttler.d.cts",
+ "default": "./dist/cjs/lite-throttler.cjs"
+ }
+ },
+ "./lite-rate-limiter": {
+ "import": {
+ "types": "./dist/esm/lite-rate-limiter.d.ts",
+ "default": "./dist/esm/lite-rate-limiter.js"
+ },
+ "require": {
+ "types": "./dist/cjs/lite-rate-limiter.d.cts",
+ "default": "./dist/cjs/lite-rate-limiter.cjs"
+ }
+ },
+ "./lite-queuer": {
+ "import": {
+ "types": "./dist/esm/lite-queuer.d.ts",
+ "default": "./dist/esm/lite-queuer.js"
+ },
+ "require": {
+ "types": "./dist/cjs/lite-queuer.d.cts",
+ "default": "./dist/cjs/lite-queuer.cjs"
+ }
+ },
+ "./lite-batcher": {
+ "import": {
+ "types": "./dist/esm/lite-batcher.d.ts",
+ "default": "./dist/esm/lite-batcher.js"
+ },
+ "require": {
+ "types": "./dist/cjs/lite-batcher.d.cts",
+ "default": "./dist/cjs/lite-batcher.cjs"
+ }
+ },
+ "./package.json": "./package.json"
+ },
+ "sideEffects": false,
+ "engines": {
+ "node": ">=18"
+ },
+ "files": [
+ "dist/",
+ "src"
+ ],
+ "scripts": {
+ "clean": "premove ./build ./dist",
+ "lint:fix": "eslint ./src --fix",
+ "test:eslint": "eslint ./src",
+ "test:lib": "vitest",
+ "test:lib:dev": "pnpm test:lib --watch",
+ "test:types": "tsc",
+ "test:build": "publint --strict",
+ "build": "vite build"
+ },
+ "devDependencies": {
+ "@tanstack/pacer": "workspace:*"
+ }
+}
diff --git a/packages/pacer-lite/src/index.ts b/packages/pacer-lite/src/index.ts
new file mode 100644
index 00000000..dcb0c9f0
--- /dev/null
+++ b/packages/pacer-lite/src/index.ts
@@ -0,0 +1,5 @@
+export * from './lite-debouncer'
+export * from './lite-throttler'
+export * from './lite-rate-limiter'
+export * from './lite-queuer'
+export * from './lite-batcher'
diff --git a/packages/pacer-lite/src/lite-batcher.ts b/packages/pacer-lite/src/lite-batcher.ts
new file mode 100644
index 00000000..92806e41
--- /dev/null
+++ b/packages/pacer-lite/src/lite-batcher.ts
@@ -0,0 +1,267 @@
+/**
+ * Options for configuring a lite batcher instance
+ */
+export interface LiteBatcherOptions
++We're looking for TanStack Pacer Partners to join our mission! Partner with us to push the boundaries of TanStack Pacer and build amazing things together. +
+LET'S CHAT +
+
+
+
+
++ + + + + +
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
+# TanStack Pacer
+
+A lightweight timing and scheduling library for debouncing, throttling, rate limiting, queuing, and batching.
+
+> [!NOTE]
+> TanStack Pacer is currently mostly a client-side only library, but it is being designed to be able to potentially be used on the server-side as well.
+
+- **Debouncing**
+ - Delay execution until after a period of inactivity for when you only care about the last execution in a sequence.
+ - Synchronous or Asynchronous Debounce utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options
+- **Throttling**
+ - Smoothly limit the rate at which a function can fire
+ - Synchronous or Asynchronous Throttle utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options.
+- **Rate Limiting**
+ - Limit the rate at which a function can fire over a period of time
+ - Synchronous or Asynchronous Rate Limiting utilities with promise support and error handling
+ - Fixed or Sliding Window variations of Rate Limiting
+- **Queuing**
+ - Queue functions to be executed in a specific order
+ - Choose from FIFO, LIFO, and Priority queue implementations
+ - Control processing speed with configurable wait times or concurrency limits
+ - Manage queue execution with start/stop capabilities
+ - Expire items from the queue after a configurable duration
+- **Batching**
+ - Chunk up multiple operations into larger batches to reduce total back-and-forth operations
+ - Batch by time period, batch size, whichever comes first, or a custom condition to trigger batch executions
+- **Async or Sync Variations**
+ - Choose between synchronous and asynchronous versions of each utility
+ - Optional error, success, and settled handling for async variations
+ - Retry and Abort support for async variations
+- **State Management**
+ - Uses TanStack Store under the hood for state management with fine-grained reactivity
+ - Easily integrate with your own state management library of choice
+ - Persist state to local or session storage for some utilities like rate limiting and queuing
+- **Convenient Hooks**
+ - Reduce boilerplate code with pre-built hooks like `useDebouncedCallback`, `useThrottledValue`, and `useQueuedState`, and more.
+ - Multiple layers of abstraction to choose from depending on your use case.
+ - Works with each framework's default state management solutions, or with whatever custom state management library that you prefer.
+- **Type Safety**
+ - Full type safety with TypeScript that makes sure that your functions will always be called with the correct arguments
+ - Generics for flexible and reusable utilities
+- **Framework Adapters**
+ - React, Solid, and more
+- **Tree Shaking**
+ - We, of course, get tree-shaking right for your applications by default, but we also provide extra deep imports for each utility, making it easier to embed these utilities into your libraries without increasing the bundle-phobia reports of your library.
+
+### Read the docs →
+
++ +> [!NOTE] +> You may know **TanSack Pacer** by our adapter names, too! +> +> - [**React Pacer**](https://tanstack.com/pacer/latest/docs/framework/react/react-pacer) +> - [**Solid Pacer**](https://tanstack.com/pacer/latest/docs/framework/solid/solid-pacer) +> - Angular Pacer - needs a contributor! +> - Preact Pacer - Coming soon! (After React Pacer is more fleshed out) +> - Svelte Pacer - needs a contributor! +> - Vue Pacer - needs a contributor! + +## Get Involved + +- We welcome issues and pull requests! +- Participate in [GitHub discussions](https://github.com/TanStack/pacer/discussions) +- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ) +- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions + +## Partners + +
|
+
+
+ |
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+## Explore the TanStack Ecosystem
+
+- TanStack Config – Tooling for JS/TS packages
+- TanStack DB – Reactive sync client store
+- TanStack DevTools – Unified devtools panel
+- TanStack Form – Type‑safe form state
+- TanStack Query – Async state & caching
+- TanStack Ranger – Range & slider primitives
+- TanStack Router – Type‑safe routing, caching & URL state
+- TanStack Start – Full‑stack SSR & streaming
+- TanStack Store – Reactive data store
+- TanStack Table – Headless datagrids
+- TanStack Virtual – Virtualized rendering
+
+… and more at TanStack.com »
+
+
diff --git a/packages/react-pacer-devtools/README.md b/packages/react-pacer-devtools/README.md
new file mode 100644
index 00000000..42347dcc
--- /dev/null
+++ b/packages/react-pacer-devtools/README.md
@@ -0,0 +1,165 @@
+
++We're looking for TanStack Pacer Partners to join our mission! Partner with us to push the boundaries of TanStack Pacer and build amazing things together. +
+LET'S CHAT +
+
+
+
+
++ + + + + +
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
+# TanStack Pacer
+
+A lightweight timing and scheduling library for debouncing, throttling, rate limiting, queuing, and batching.
+
+> [!NOTE]
+> TanStack Pacer is currently mostly a client-side only library, but it is being designed to be able to potentially be used on the server-side as well.
+
+- **Debouncing**
+ - Delay execution until after a period of inactivity for when you only care about the last execution in a sequence.
+ - Synchronous or Asynchronous Debounce utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options
+- **Throttling**
+ - Smoothly limit the rate at which a function can fire
+ - Synchronous or Asynchronous Throttle utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options.
+- **Rate Limiting**
+ - Limit the rate at which a function can fire over a period of time
+ - Synchronous or Asynchronous Rate Limiting utilities with promise support and error handling
+ - Fixed or Sliding Window variations of Rate Limiting
+- **Queuing**
+ - Queue functions to be executed in a specific order
+ - Choose from FIFO, LIFO, and Priority queue implementations
+ - Control processing speed with configurable wait times or concurrency limits
+ - Manage queue execution with start/stop capabilities
+ - Expire items from the queue after a configurable duration
+- **Batching**
+ - Chunk up multiple operations into larger batches to reduce total back-and-forth operations
+ - Batch by time period, batch size, whichever comes first, or a custom condition to trigger batch executions
+- **Async or Sync Variations**
+ - Choose between synchronous and asynchronous versions of each utility
+ - Optional error, success, and settled handling for async variations
+ - Retry and Abort support for async variations
+- **State Management**
+ - Uses TanStack Store under the hood for state management with fine-grained reactivity
+ - Easily integrate with your own state management library of choice
+ - Persist state to local or session storage for some utilities like rate limiting and queuing
+- **Convenient Hooks**
+ - Reduce boilerplate code with pre-built hooks like `useDebouncedCallback`, `useThrottledValue`, and `useQueuedState`, and more.
+ - Multiple layers of abstraction to choose from depending on your use case.
+ - Works with each framework's default state management solutions, or with whatever custom state management library that you prefer.
+- **Type Safety**
+ - Full type safety with TypeScript that makes sure that your functions will always be called with the correct arguments
+ - Generics for flexible and reusable utilities
+- **Framework Adapters**
+ - React, Solid, and more
+- **Tree Shaking**
+ - We, of course, get tree-shaking right for your applications by default, but we also provide extra deep imports for each utility, making it easier to embed these utilities into your libraries without increasing the bundle-phobia reports of your library.
+
+### Read the docs →
+
++ +> [!NOTE] +> You may know **TanSack Pacer** by our adapter names, too! +> +> - [**React Pacer**](https://tanstack.com/pacer/latest/docs/framework/react/react-pacer) +> - [**Solid Pacer**](https://tanstack.com/pacer/latest/docs/framework/solid/solid-pacer) +> - Angular Pacer - needs a contributor! +> - Preact Pacer - Coming soon! (After React Pacer is more fleshed out) +> - Svelte Pacer - needs a contributor! +> - Vue Pacer - needs a contributor! + +## Get Involved + +- We welcome issues and pull requests! +- Participate in [GitHub discussions](https://github.com/TanStack/pacer/discussions) +- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ) +- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions + +## Partners + +
|
+
+
+ |
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+## Explore the TanStack Ecosystem
+
+- TanStack Config – Tooling for JS/TS packages
+- TanStack DB – Reactive sync client store
+- TanStack DevTools – Unified devtools panel
+- TanStack Form – Type‑safe form state
+- TanStack Query – Async state & caching
+- TanStack Ranger – Range & slider primitives
+- TanStack Router – Type‑safe routing, caching & URL state
+- TanStack Start – Full‑stack SSR & streaming
+- TanStack Store – Reactive data store
+- TanStack Table – Headless datagrids
+- TanStack Virtual – Virtualized rendering
+
+… and more at TanStack.com »
+
+
diff --git a/packages/react-pacer/README.md b/packages/react-pacer/README.md
new file mode 100644
index 00000000..42347dcc
--- /dev/null
+++ b/packages/react-pacer/README.md
@@ -0,0 +1,165 @@
+
++We're looking for TanStack Pacer Partners to join our mission! Partner with us to push the boundaries of TanStack Pacer and build amazing things together. +
+LET'S CHAT +
+
+
+
+
++ + + + + +
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
+# TanStack Pacer
+
+A lightweight timing and scheduling library for debouncing, throttling, rate limiting, queuing, and batching.
+
+> [!NOTE]
+> TanStack Pacer is currently mostly a client-side only library, but it is being designed to be able to potentially be used on the server-side as well.
+
+- **Debouncing**
+ - Delay execution until after a period of inactivity for when you only care about the last execution in a sequence.
+ - Synchronous or Asynchronous Debounce utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options
+- **Throttling**
+ - Smoothly limit the rate at which a function can fire
+ - Synchronous or Asynchronous Throttle utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options.
+- **Rate Limiting**
+ - Limit the rate at which a function can fire over a period of time
+ - Synchronous or Asynchronous Rate Limiting utilities with promise support and error handling
+ - Fixed or Sliding Window variations of Rate Limiting
+- **Queuing**
+ - Queue functions to be executed in a specific order
+ - Choose from FIFO, LIFO, and Priority queue implementations
+ - Control processing speed with configurable wait times or concurrency limits
+ - Manage queue execution with start/stop capabilities
+ - Expire items from the queue after a configurable duration
+- **Batching**
+ - Chunk up multiple operations into larger batches to reduce total back-and-forth operations
+ - Batch by time period, batch size, whichever comes first, or a custom condition to trigger batch executions
+- **Async or Sync Variations**
+ - Choose between synchronous and asynchronous versions of each utility
+ - Optional error, success, and settled handling for async variations
+ - Retry and Abort support for async variations
+- **State Management**
+ - Uses TanStack Store under the hood for state management with fine-grained reactivity
+ - Easily integrate with your own state management library of choice
+ - Persist state to local or session storage for some utilities like rate limiting and queuing
+- **Convenient Hooks**
+ - Reduce boilerplate code with pre-built hooks like `useDebouncedCallback`, `useThrottledValue`, and `useQueuedState`, and more.
+ - Multiple layers of abstraction to choose from depending on your use case.
+ - Works with each framework's default state management solutions, or with whatever custom state management library that you prefer.
+- **Type Safety**
+ - Full type safety with TypeScript that makes sure that your functions will always be called with the correct arguments
+ - Generics for flexible and reusable utilities
+- **Framework Adapters**
+ - React, Solid, and more
+- **Tree Shaking**
+ - We, of course, get tree-shaking right for your applications by default, but we also provide extra deep imports for each utility, making it easier to embed these utilities into your libraries without increasing the bundle-phobia reports of your library.
+
+### Read the docs →
+
++ +> [!NOTE] +> You may know **TanSack Pacer** by our adapter names, too! +> +> - [**React Pacer**](https://tanstack.com/pacer/latest/docs/framework/react/react-pacer) +> - [**Solid Pacer**](https://tanstack.com/pacer/latest/docs/framework/solid/solid-pacer) +> - Angular Pacer - needs a contributor! +> - Preact Pacer - Coming soon! (After React Pacer is more fleshed out) +> - Svelte Pacer - needs a contributor! +> - Vue Pacer - needs a contributor! + +## Get Involved + +- We welcome issues and pull requests! +- Participate in [GitHub discussions](https://github.com/TanStack/pacer/discussions) +- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ) +- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions + +## Partners + +
|
+
+
+ |
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+## Explore the TanStack Ecosystem
+
+- TanStack Config – Tooling for JS/TS packages
+- TanStack DB – Reactive sync client store
+- TanStack DevTools – Unified devtools panel
+- TanStack Form – Type‑safe form state
+- TanStack Query – Async state & caching
+- TanStack Ranger – Range & slider primitives
+- TanStack Router – Type‑safe routing, caching & URL state
+- TanStack Start – Full‑stack SSR & streaming
+- TanStack Store – Reactive data store
+- TanStack Table – Headless datagrids
+- TanStack Virtual – Virtualized rendering
+
+… and more at TanStack.com »
+
+
diff --git a/packages/solid-pacer-devtools/README.md b/packages/solid-pacer-devtools/README.md
new file mode 100644
index 00000000..42347dcc
--- /dev/null
+++ b/packages/solid-pacer-devtools/README.md
@@ -0,0 +1,165 @@
+
++We're looking for TanStack Pacer Partners to join our mission! Partner with us to push the boundaries of TanStack Pacer and build amazing things together. +
+LET'S CHAT +
+
+
+
+
++ + + + + +
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
+# TanStack Pacer
+
+A lightweight timing and scheduling library for debouncing, throttling, rate limiting, queuing, and batching.
+
+> [!NOTE]
+> TanStack Pacer is currently mostly a client-side only library, but it is being designed to be able to potentially be used on the server-side as well.
+
+- **Debouncing**
+ - Delay execution until after a period of inactivity for when you only care about the last execution in a sequence.
+ - Synchronous or Asynchronous Debounce utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options
+- **Throttling**
+ - Smoothly limit the rate at which a function can fire
+ - Synchronous or Asynchronous Throttle utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options.
+- **Rate Limiting**
+ - Limit the rate at which a function can fire over a period of time
+ - Synchronous or Asynchronous Rate Limiting utilities with promise support and error handling
+ - Fixed or Sliding Window variations of Rate Limiting
+- **Queuing**
+ - Queue functions to be executed in a specific order
+ - Choose from FIFO, LIFO, and Priority queue implementations
+ - Control processing speed with configurable wait times or concurrency limits
+ - Manage queue execution with start/stop capabilities
+ - Expire items from the queue after a configurable duration
+- **Batching**
+ - Chunk up multiple operations into larger batches to reduce total back-and-forth operations
+ - Batch by time period, batch size, whichever comes first, or a custom condition to trigger batch executions
+- **Async or Sync Variations**
+ - Choose between synchronous and asynchronous versions of each utility
+ - Optional error, success, and settled handling for async variations
+ - Retry and Abort support for async variations
+- **State Management**
+ - Uses TanStack Store under the hood for state management with fine-grained reactivity
+ - Easily integrate with your own state management library of choice
+ - Persist state to local or session storage for some utilities like rate limiting and queuing
+- **Convenient Hooks**
+ - Reduce boilerplate code with pre-built hooks like `useDebouncedCallback`, `useThrottledValue`, and `useQueuedState`, and more.
+ - Multiple layers of abstraction to choose from depending on your use case.
+ - Works with each framework's default state management solutions, or with whatever custom state management library that you prefer.
+- **Type Safety**
+ - Full type safety with TypeScript that makes sure that your functions will always be called with the correct arguments
+ - Generics for flexible and reusable utilities
+- **Framework Adapters**
+ - React, Solid, and more
+- **Tree Shaking**
+ - We, of course, get tree-shaking right for your applications by default, but we also provide extra deep imports for each utility, making it easier to embed these utilities into your libraries without increasing the bundle-phobia reports of your library.
+
+### Read the docs →
+
++ +> [!NOTE] +> You may know **TanSack Pacer** by our adapter names, too! +> +> - [**React Pacer**](https://tanstack.com/pacer/latest/docs/framework/react/react-pacer) +> - [**Solid Pacer**](https://tanstack.com/pacer/latest/docs/framework/solid/solid-pacer) +> - Angular Pacer - needs a contributor! +> - Preact Pacer - Coming soon! (After React Pacer is more fleshed out) +> - Svelte Pacer - needs a contributor! +> - Vue Pacer - needs a contributor! + +## Get Involved + +- We welcome issues and pull requests! +- Participate in [GitHub discussions](https://github.com/TanStack/pacer/discussions) +- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ) +- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions + +## Partners + +
|
+
+
+ |
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+## Explore the TanStack Ecosystem
+
+- TanStack Config – Tooling for JS/TS packages
+- TanStack DB – Reactive sync client store
+- TanStack DevTools – Unified devtools panel
+- TanStack Form – Type‑safe form state
+- TanStack Query – Async state & caching
+- TanStack Ranger – Range & slider primitives
+- TanStack Router – Type‑safe routing, caching & URL state
+- TanStack Start – Full‑stack SSR & streaming
+- TanStack Store – Reactive data store
+- TanStack Table – Headless datagrids
+- TanStack Virtual – Virtualized rendering
+
+… and more at TanStack.com »
+
+
diff --git a/packages/solid-pacer/README.md b/packages/solid-pacer/README.md
new file mode 100644
index 00000000..42347dcc
--- /dev/null
+++ b/packages/solid-pacer/README.md
@@ -0,0 +1,165 @@
+
++We're looking for TanStack Pacer Partners to join our mission! Partner with us to push the boundaries of TanStack Pacer and build amazing things together. +
+LET'S CHAT +
+
+
+
+
++ + + + + +
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
+# TanStack Pacer
+
+A lightweight timing and scheduling library for debouncing, throttling, rate limiting, queuing, and batching.
+
+> [!NOTE]
+> TanStack Pacer is currently mostly a client-side only library, but it is being designed to be able to potentially be used on the server-side as well.
+
+- **Debouncing**
+ - Delay execution until after a period of inactivity for when you only care about the last execution in a sequence.
+ - Synchronous or Asynchronous Debounce utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options
+- **Throttling**
+ - Smoothly limit the rate at which a function can fire
+ - Synchronous or Asynchronous Throttle utilities with promise support and error handling
+ - Control of leading, trailing, and enabled options.
+- **Rate Limiting**
+ - Limit the rate at which a function can fire over a period of time
+ - Synchronous or Asynchronous Rate Limiting utilities with promise support and error handling
+ - Fixed or Sliding Window variations of Rate Limiting
+- **Queuing**
+ - Queue functions to be executed in a specific order
+ - Choose from FIFO, LIFO, and Priority queue implementations
+ - Control processing speed with configurable wait times or concurrency limits
+ - Manage queue execution with start/stop capabilities
+ - Expire items from the queue after a configurable duration
+- **Batching**
+ - Chunk up multiple operations into larger batches to reduce total back-and-forth operations
+ - Batch by time period, batch size, whichever comes first, or a custom condition to trigger batch executions
+- **Async or Sync Variations**
+ - Choose between synchronous and asynchronous versions of each utility
+ - Optional error, success, and settled handling for async variations
+ - Retry and Abort support for async variations
+- **State Management**
+ - Uses TanStack Store under the hood for state management with fine-grained reactivity
+ - Easily integrate with your own state management library of choice
+ - Persist state to local or session storage for some utilities like rate limiting and queuing
+- **Convenient Hooks**
+ - Reduce boilerplate code with pre-built hooks like `useDebouncedCallback`, `useThrottledValue`, and `useQueuedState`, and more.
+ - Multiple layers of abstraction to choose from depending on your use case.
+ - Works with each framework's default state management solutions, or with whatever custom state management library that you prefer.
+- **Type Safety**
+ - Full type safety with TypeScript that makes sure that your functions will always be called with the correct arguments
+ - Generics for flexible and reusable utilities
+- **Framework Adapters**
+ - React, Solid, and more
+- **Tree Shaking**
+ - We, of course, get tree-shaking right for your applications by default, but we also provide extra deep imports for each utility, making it easier to embed these utilities into your libraries without increasing the bundle-phobia reports of your library.
+
+### Read the docs →
+
++ +> [!NOTE] +> You may know **TanSack Pacer** by our adapter names, too! +> +> - [**React Pacer**](https://tanstack.com/pacer/latest/docs/framework/react/react-pacer) +> - [**Solid Pacer**](https://tanstack.com/pacer/latest/docs/framework/solid/solid-pacer) +> - Angular Pacer - needs a contributor! +> - Preact Pacer - Coming soon! (After React Pacer is more fleshed out) +> - Svelte Pacer - needs a contributor! +> - Vue Pacer - needs a contributor! + +## Get Involved + +- We welcome issues and pull requests! +- Participate in [GitHub discussions](https://github.com/TanStack/pacer/discussions) +- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ) +- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions + +## Partners + +
|
+
+
+ |
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+## Explore the TanStack Ecosystem
+
+- TanStack Config – Tooling for JS/TS packages
+- TanStack DB – Reactive sync client store
+- TanStack DevTools – Unified devtools panel
+- TanStack Form – Type‑safe form state
+- TanStack Query – Async state & caching
+- TanStack Ranger – Range & slider primitives
+- TanStack Router – Type‑safe routing, caching & URL state
+- TanStack Start – Full‑stack SSR & streaming
+- TanStack Store – Reactive data store
+- TanStack Table – Headless datagrids
+- TanStack Virtual – Virtualized rendering
+
+… and more at TanStack.com »
+
+
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index c2ab253d..812f5249 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -1619,6 +1619,106 @@ importers:
specifier: ^2.11.10
version: 2.11.10(@testing-library/jest-dom@6.9.1)(solid-js@1.9.10)(vite@7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1))
+ examples/vanilla/LiteBatcher:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/LiteDebouncer:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/LiteQueuer:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/LiteRateLimiter:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/LiteThrottler:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/liteBatch:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/liteDebounce:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/liteQueue:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/liteRateLimit:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
+ examples/vanilla/liteThrottle:
+ dependencies:
+ '@tanstack/pacer-lite':
+ specifier: 0.0.1
+ version: link:../../../packages/pacer-lite
+ devDependencies:
+ vite:
+ specifier: ^7.2.2
+ version: 7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1)
+
packages/pacer:
dependencies:
'@tanstack/devtools-event-client':
@@ -1659,6 +1759,12 @@ importers:
specifier: ^2.11.10
version: 2.11.10(@testing-library/jest-dom@6.9.1)(solid-js@1.9.10)(vite@7.2.2(@types/node@24.10.1)(jiti@2.6.0)(yaml@2.8.1))
+ packages/pacer-lite:
+ devDependencies:
+ '@tanstack/pacer':
+ specifier: workspace:*
+ version: link:../pacer
+
packages/react-pacer:
dependencies:
'@tanstack/pacer':
diff --git a/vitest.workspace.js b/vitest.workspace.js
index fcb88e20..e5a5d999 100644
--- a/vitest.workspace.js
+++ b/vitest.workspace.js
@@ -4,10 +4,11 @@ export default defineConfig({
test: {
projects: [
'./packages/pacer/vite.config.ts',
- './packages/persister/vite.config.ts',
+ './packages/pacer-lite/vite.config.ts',
'./packages/react-pacer/vite.config.ts',
- './packages/react-persister/vite.config.ts',
+ './packages/react-pacer-devtools/vite.config.ts',
'./packages/solid-pacer/vite.config.ts',
+ './packages/solid-pacer-devtools/vite.config.ts',
],
},
})
++We're looking for TanStack Pacer Partners to join our mission! Partner with us to push the boundaries of TanStack Pacer and build amazing things together. +
+LET'S CHAT +