@lytjs/common-raf 6.0.0

package/dist/index.cjs

@@ -0,0 +1,68 @@
+'use strict';
+
+// src/index.ts
+var _raf = typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : (cb) => setTimeout(() => cb(performance.now()), 16);
+var _caf = typeof cancelAnimationFrame !== "undefined" ? cancelAnimationFrame : (id) => clearTimeout(id);
+function raf(callback) {
+  return _raf(callback);
+}
+function caf(id) {
+  _caf(id);
+}
+function nextFrame() {
+  return new Promise((resolve) => {
+    raf(() => resolve());
+  });
+}
+function rafThrottle(fn) {
+  let pending = false;
+  let latestArgs = null;
+  const throttled = (...args) => {
+    latestArgs = args;
+    if (!pending) {
+      pending = true;
+      raf(() => {
+        pending = false;
+        if (latestArgs) {
+          fn(...latestArgs);
+          latestArgs = null;
+        }
+      });
+    }
+  };
+  return throttled;
+}
+function rafDebounce(fn, delay) {
+  let id = null;
+  let latestArgs = null;
+  let remaining = delay ?? 1;
+  const debounced = (...args) => {
+    latestArgs = args;
+    remaining = delay ?? 1;
+    if (id !== null) {
+      caf(id);
+    }
+    const tick = () => {
+      remaining--;
+      if (remaining <= 0) {
+        id = null;
+        if (latestArgs) {
+          fn(...latestArgs);
+          latestArgs = null;
+        }
+      } else {
+        id = raf(tick);
+      }
+    };
+    id = raf(tick);
+  };
+  return debounced;
+}
+
+exports.caf = caf;
+exports.nextFrame = nextFrame;
+exports.raf = raf;
+exports.rafDebounce = rafDebounce;
+exports.rafThrottle = rafThrottle;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAKA,IAAM,IAAA,GACJ,OAAO,qBAAA,KAA0B,WAAA,GAC7B,wBACA,CAAC,EAAA,KACC,UAAA,CAAW,MAAM,EAAA,CAAG,WAAA,CAAY,GAAA,EAAK,GAAG,EAAE,CAAA;AAElD,IAAM,IAAA,GACJ,OAAO,oBAAA,KAAyB,WAAA,GAC5B,uBACA,CAAC,EAAA,KAAqB,aAAa,EAAE,CAAA;AAKpC,SAAS,IAAI,QAAA,EAAwC;AAC1D,EAAA,OAAO,KAAK,QAAQ,CAAA;AACtB;AAKO,SAAS,IAAI,EAAA,EAAkB;AACpC,EAAA,IAAA,CAAK,EAAE,CAAA;AACT;AAKO,SAAS,SAAA,GAA2B;AACzC,EAAA,OAAO,IAAI,OAAA,CAAc,CAAC,OAAA,KAAY;AACpC,IAAA,GAAA,CAAI,MAAM,SAAS,CAAA;AAAA,EACrB,CAAC,CAAA;AACH;AAKO,SAAS,YAAuD,EAAA,EAAU;AAC/E,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,IAAI,UAAA,GAA+B,IAAA;AAEnC,EAAA,MAAM,SAAA,GAAY,IAAI,IAAA,KAAoB;AACxC,IAAA,UAAA,GAAa,IAAA;AACb,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,GAAA,CAAI,MAAM;AACR,QAAA,OAAA,GAAU,KAAA;AACV,QAAA,IAAI,UAAA,EAAY;AACd,UAAA,EAAA,CAAG,GAAG,UAAU,CAAA;AAChB,UAAA,UAAA,GAAa,IAAA;AAAA,QACf;AAAA,MACF,CAAC,CAAA;AAAA,IACH;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,SAAA;AACT;AAKO,SAAS,WAAA,CAAuD,IAAO,KAAA,EAAmB;AAC/F,EAAA,IAAI,EAAA,GAAoB,IAAA;AACxB,EAAA,IAAI,UAAA,GAA+B,IAAA;AACnC,EAAA,IAAI,YAAY,KAAA,IAAS,CAAA;AAEzB,EAAA,MAAM,SAAA,GAAY,IAAI,IAAA,KAAoB;AACxC,IAAA,UAAA,GAAa,IAAA;AACb,IAAA,SAAA,GAAY,KAAA,IAAS,CAAA;AAErB,IAAA,IAAI,OAAO,IAAA,EAAM;AACf,MAAA,GAAA,CAAI,EAAE,CAAA;AAAA,IACR;AAEA,IAAA,MAAM,OAAO,MAAM;AACjB,MAAA,SAAA,EAAA;AACA,MAAA,IAAI,aAAa,CAAA,EAAG;AAClB,QAAA,EAAA,GAAK,IAAA;AACL,QAAA,IAAI,UAAA,EAAY;AACd,UAAA,EAAA,CAAG,GAAG,UAAU,CAAA;AAChB,UAAA,UAAA,GAAa,IAAA;AAAA,QACf;AAAA,MACF,CAAA,MAAO;AACL,QAAA,EAAA,GAAK,IAAI,IAAI,CAAA;AAAA,MACf;AAAA,IACF,CAAA;AAEA,IAAA,EAAA,GAAK,IAAI,IAAI,CAAA;AAAA,EACf,CAAA;AAEA,EAAA,OAAO,SAAA;AACT","file":"index.cjs","sourcesContent":["/**\r\n * @lytjs/common-raf\r\n * Cross-platform requestAnimationFrame utilities\r\n */\r\n\r\nconst _raf =\r\n  typeof requestAnimationFrame !== 'undefined'\r\n    ? requestAnimationFrame\r\n    : (cb: FrameRequestCallback): ReturnType<typeof setTimeout> =>\r\n        setTimeout(() => cb(performance.now()), 16);\r\n\r\nconst _caf =\r\n  typeof cancelAnimationFrame !== 'undefined'\r\n    ? cancelAnimationFrame\r\n    : (id: number): void => clearTimeout(id);\r\n\r\n/**\r\n * requestAnimationFrame cross-platform wrapper\r\n */\r\nexport function raf(callback: FrameRequestCallback): number {\r\n  return _raf(callback) as number;\r\n}\r\n\r\n/**\r\n * cancelAnimationFrame cross-platform wrapper\r\n */\r\nexport function caf(id: number): void {\r\n  _caf(id);\r\n}\r\n\r\n/**\r\n * Wait for the next animation frame\r\n */\r\nexport function nextFrame(): Promise<void> {\r\n  return new Promise<void>((resolve) => {\r\n    raf(() => resolve());\r\n  });\r\n}\r\n\r\n/**\r\n * Throttle a function to run at most once per animation frame\r\n */\r\nexport function rafThrottle<T extends (...args: unknown[]) => unknown>(fn: T): T {\r\n  let pending = false;\r\n  let latestArgs: unknown[] | null = null;\r\n\r\n  const throttled = (...args: unknown[]) => {\r\n    latestArgs = args;\r\n    if (!pending) {\r\n      pending = true;\r\n      raf(() => {\r\n        pending = false;\r\n        if (latestArgs) {\r\n          fn(...latestArgs);\r\n          latestArgs = null;\r\n        }\r\n      });\r\n    }\r\n  };\r\n\r\n  return throttled as T;\r\n}\r\n\r\n/**\r\n * Debounce a function to run after a specified number of frames (default: 1)\r\n */\r\nexport function rafDebounce<T extends (...args: unknown[]) => unknown>(fn: T, delay?: number): T {\r\n  let id: number | null = null;\r\n  let latestArgs: unknown[] | null = null;\r\n  let remaining = delay ?? 1;\r\n\r\n  const debounced = (...args: unknown[]) => {\r\n    latestArgs = args;\r\n    remaining = delay ?? 1;\r\n\r\n    if (id !== null) {\r\n      caf(id);\r\n    }\r\n\r\n    const tick = () => {\r\n      remaining--;\r\n      if (remaining <= 0) {\r\n        id = null;\r\n        if (latestArgs) {\r\n          fn(...latestArgs);\r\n          latestArgs = null;\r\n        }\r\n      } else {\r\n        id = raf(tick);\r\n      }\r\n    };\r\n\r\n    id = raf(tick);\r\n  };\r\n\r\n  return debounced as T;\r\n}\r\n"]}

package/dist/index.d.mts

@@ -0,0 +1,26 @@
+/**
+ * @lytjs/common-raf
+ * Cross-platform requestAnimationFrame utilities
+ */
+/**
+ * requestAnimationFrame cross-platform wrapper
+ */
+declare function raf(callback: FrameRequestCallback): number;
+/**
+ * cancelAnimationFrame cross-platform wrapper
+ */
+declare function caf(id: number): void;
+/**
+ * Wait for the next animation frame
+ */
+declare function nextFrame(): Promise<void>;
+/**
+ * Throttle a function to run at most once per animation frame
+ */
+declare function rafThrottle<T extends (...args: unknown[]) => unknown>(fn: T): T;
+/**
+ * Debounce a function to run after a specified number of frames (default: 1)
+ */
+declare function rafDebounce<T extends (...args: unknown[]) => unknown>(fn: T, delay?: number): T;
+
+export { caf, nextFrame, raf, rafDebounce, rafThrottle };

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @lytjs/common-raf
+ * Cross-platform requestAnimationFrame utilities
+ */
+/**
+ * requestAnimationFrame cross-platform wrapper
+ */
+declare function raf(callback: FrameRequestCallback): number;
+/**
+ * cancelAnimationFrame cross-platform wrapper
+ */
+declare function caf(id: number): void;
+/**
+ * Wait for the next animation frame
+ */
+declare function nextFrame(): Promise<void>;
+/**
+ * Throttle a function to run at most once per animation frame
+ */
+declare function rafThrottle<T extends (...args: unknown[]) => unknown>(fn: T): T;
+/**
+ * Debounce a function to run after a specified number of frames (default: 1)
+ */
+declare function rafDebounce<T extends (...args: unknown[]) => unknown>(fn: T, delay?: number): T;
+
+export { caf, nextFrame, raf, rafDebounce, rafThrottle };

package/dist/index.mjs

@@ -0,0 +1,62 @@
+// src/index.ts
+var _raf = typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : (cb) => setTimeout(() => cb(performance.now()), 16);
+var _caf = typeof cancelAnimationFrame !== "undefined" ? cancelAnimationFrame : (id) => clearTimeout(id);
+function raf(callback) {
+  return _raf(callback);
+}
+function caf(id) {
+  _caf(id);
+}
+function nextFrame() {
+  return new Promise((resolve) => {
+    raf(() => resolve());
+  });
+}
+function rafThrottle(fn) {
+  let pending = false;
+  let latestArgs = null;
+  const throttled = (...args) => {
+    latestArgs = args;
+    if (!pending) {
+      pending = true;
+      raf(() => {
+        pending = false;
+        if (latestArgs) {
+          fn(...latestArgs);
+          latestArgs = null;
+        }
+      });
+    }
+  };
+  return throttled;
+}
+function rafDebounce(fn, delay) {
+  let id = null;
+  let latestArgs = null;
+  let remaining = delay ?? 1;
+  const debounced = (...args) => {
+    latestArgs = args;
+    remaining = delay ?? 1;
+    if (id !== null) {
+      caf(id);
+    }
+    const tick = () => {
+      remaining--;
+      if (remaining <= 0) {
+        id = null;
+        if (latestArgs) {
+          fn(...latestArgs);
+          latestArgs = null;
+        }
+      } else {
+        id = raf(tick);
+      }
+    };
+    id = raf(tick);
+  };
+  return debounced;
+}
+
+export { caf, nextFrame, raf, rafDebounce, rafThrottle };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAKA,IAAM,IAAA,GACJ,OAAO,qBAAA,KAA0B,WAAA,GAC7B,wBACA,CAAC,EAAA,KACC,UAAA,CAAW,MAAM,EAAA,CAAG,WAAA,CAAY,GAAA,EAAK,GAAG,EAAE,CAAA;AAElD,IAAM,IAAA,GACJ,OAAO,oBAAA,KAAyB,WAAA,GAC5B,uBACA,CAAC,EAAA,KAAqB,aAAa,EAAE,CAAA;AAKpC,SAAS,IAAI,QAAA,EAAwC;AAC1D,EAAA,OAAO,KAAK,QAAQ,CAAA;AACtB;AAKO,SAAS,IAAI,EAAA,EAAkB;AACpC,EAAA,IAAA,CAAK,EAAE,CAAA;AACT;AAKO,SAAS,SAAA,GAA2B;AACzC,EAAA,OAAO,IAAI,OAAA,CAAc,CAAC,OAAA,KAAY;AACpC,IAAA,GAAA,CAAI,MAAM,SAAS,CAAA;AAAA,EACrB,CAAC,CAAA;AACH;AAKO,SAAS,YAAuD,EAAA,EAAU;AAC/E,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,IAAI,UAAA,GAA+B,IAAA;AAEnC,EAAA,MAAM,SAAA,GAAY,IAAI,IAAA,KAAoB;AACxC,IAAA,UAAA,GAAa,IAAA;AACb,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,GAAA,CAAI,MAAM;AACR,QAAA,OAAA,GAAU,KAAA;AACV,QAAA,IAAI,UAAA,EAAY;AACd,UAAA,EAAA,CAAG,GAAG,UAAU,CAAA;AAChB,UAAA,UAAA,GAAa,IAAA;AAAA,QACf;AAAA,MACF,CAAC,CAAA;AAAA,IACH;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,SAAA;AACT;AAKO,SAAS,WAAA,CAAuD,IAAO,KAAA,EAAmB;AAC/F,EAAA,IAAI,EAAA,GAAoB,IAAA;AACxB,EAAA,IAAI,UAAA,GAA+B,IAAA;AACnC,EAAA,IAAI,YAAY,KAAA,IAAS,CAAA;AAEzB,EAAA,MAAM,SAAA,GAAY,IAAI,IAAA,KAAoB;AACxC,IAAA,UAAA,GAAa,IAAA;AACb,IAAA,SAAA,GAAY,KAAA,IAAS,CAAA;AAErB,IAAA,IAAI,OAAO,IAAA,EAAM;AACf,MAAA,GAAA,CAAI,EAAE,CAAA;AAAA,IACR;AAEA,IAAA,MAAM,OAAO,MAAM;AACjB,MAAA,SAAA,EAAA;AACA,MAAA,IAAI,aAAa,CAAA,EAAG;AAClB,QAAA,EAAA,GAAK,IAAA;AACL,QAAA,IAAI,UAAA,EAAY;AACd,UAAA,EAAA,CAAG,GAAG,UAAU,CAAA;AAChB,UAAA,UAAA,GAAa,IAAA;AAAA,QACf;AAAA,MACF,CAAA,MAAO;AACL,QAAA,EAAA,GAAK,IAAI,IAAI,CAAA;AAAA,MACf;AAAA,IACF,CAAA;AAEA,IAAA,EAAA,GAAK,IAAI,IAAI,CAAA;AAAA,EACf,CAAA;AAEA,EAAA,OAAO,SAAA;AACT","file":"index.mjs","sourcesContent":["/**\r\n * @lytjs/common-raf\r\n * Cross-platform requestAnimationFrame utilities\r\n */\r\n\r\nconst _raf =\r\n  typeof requestAnimationFrame !== 'undefined'\r\n    ? requestAnimationFrame\r\n    : (cb: FrameRequestCallback): ReturnType<typeof setTimeout> =>\r\n        setTimeout(() => cb(performance.now()), 16);\r\n\r\nconst _caf =\r\n  typeof cancelAnimationFrame !== 'undefined'\r\n    ? cancelAnimationFrame\r\n    : (id: number): void => clearTimeout(id);\r\n\r\n/**\r\n * requestAnimationFrame cross-platform wrapper\r\n */\r\nexport function raf(callback: FrameRequestCallback): number {\r\n  return _raf(callback) as number;\r\n}\r\n\r\n/**\r\n * cancelAnimationFrame cross-platform wrapper\r\n */\r\nexport function caf(id: number): void {\r\n  _caf(id);\r\n}\r\n\r\n/**\r\n * Wait for the next animation frame\r\n */\r\nexport function nextFrame(): Promise<void> {\r\n  return new Promise<void>((resolve) => {\r\n    raf(() => resolve());\r\n  });\r\n}\r\n\r\n/**\r\n * Throttle a function to run at most once per animation frame\r\n */\r\nexport function rafThrottle<T extends (...args: unknown[]) => unknown>(fn: T): T {\r\n  let pending = false;\r\n  let latestArgs: unknown[] | null = null;\r\n\r\n  const throttled = (...args: unknown[]) => {\r\n    latestArgs = args;\r\n    if (!pending) {\r\n      pending = true;\r\n      raf(() => {\r\n        pending = false;\r\n        if (latestArgs) {\r\n          fn(...latestArgs);\r\n          latestArgs = null;\r\n        }\r\n      });\r\n    }\r\n  };\r\n\r\n  return throttled as T;\r\n}\r\n\r\n/**\r\n * Debounce a function to run after a specified number of frames (default: 1)\r\n */\r\nexport function rafDebounce<T extends (...args: unknown[]) => unknown>(fn: T, delay?: number): T {\r\n  let id: number | null = null;\r\n  let latestArgs: unknown[] | null = null;\r\n  let remaining = delay ?? 1;\r\n\r\n  const debounced = (...args: unknown[]) => {\r\n    latestArgs = args;\r\n    remaining = delay ?? 1;\r\n\r\n    if (id !== null) {\r\n      caf(id);\r\n    }\r\n\r\n    const tick = () => {\r\n      remaining--;\r\n      if (remaining <= 0) {\r\n        id = null;\r\n        if (latestArgs) {\r\n          fn(...latestArgs);\r\n          latestArgs = null;\r\n        }\r\n      } else {\r\n        id = raf(tick);\r\n      }\r\n    };\r\n\r\n    id = raf(tick);\r\n  };\r\n\r\n  return debounced as T;\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@lytjs/common-raf",
+  "version": "6.0.0",
+  "description": "Cross-platform requestAnimationFrame utilities for LytJS",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint \"src/**/*.ts\"",
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.7"
+  }
+}

package/src/index.ts

@@ -0,0 +1,97 @@
+/**
+ * @lytjs/common-raf
+ * Cross-platform requestAnimationFrame utilities
+ */
+
+const _raf =
+  typeof requestAnimationFrame !== 'undefined'
+    ? requestAnimationFrame
+    : (cb: FrameRequestCallback): ReturnType<typeof setTimeout> =>
+        setTimeout(() => cb(performance.now()), 16);
+
+const _caf =
+  typeof cancelAnimationFrame !== 'undefined'
+    ? cancelAnimationFrame
+    : (id: number): void => clearTimeout(id);
+
+/**
+ * requestAnimationFrame cross-platform wrapper
+ */
+export function raf(callback: FrameRequestCallback): number {
+  return _raf(callback) as number;
+}
+
+/**
+ * cancelAnimationFrame cross-platform wrapper
+ */
+export function caf(id: number): void {
+  _caf(id);
+}
+
+/**
+ * Wait for the next animation frame
+ */
+export function nextFrame(): Promise<void> {
+  return new Promise<void>((resolve) => {
+    raf(() => resolve());
+  });
+}
+
+/**
+ * Throttle a function to run at most once per animation frame
+ */
+export function rafThrottle<T extends (...args: unknown[]) => unknown>(fn: T): T {
+  let pending = false;
+  let latestArgs: unknown[] | null = null;
+
+  const throttled = (...args: unknown[]) => {
+    latestArgs = args;
+    if (!pending) {
+      pending = true;
+      raf(() => {
+        pending = false;
+        if (latestArgs) {
+          fn(...latestArgs);
+          latestArgs = null;
+        }
+      });
+    }
+  };
+
+  return throttled as T;
+}
+
+/**
+ * Debounce a function to run after a specified number of frames (default: 1)
+ */
+export function rafDebounce<T extends (...args: unknown[]) => unknown>(fn: T, delay?: number): T {
+  let id: number | null = null;
+  let latestArgs: unknown[] | null = null;
+  let remaining = delay ?? 1;
+
+  const debounced = (...args: unknown[]) => {
+    latestArgs = args;
+    remaining = delay ?? 1;
+
+    if (id !== null) {
+      caf(id);
+    }
+
+    const tick = () => {
+      remaining--;
+      if (remaining <= 0) {
+        id = null;
+        if (latestArgs) {
+          fn(...latestArgs);
+          latestArgs = null;
+        }
+      } else {
+        id = raf(tick);
+      }
+    };
+
+    id = raf(tick);
+  };
+
+  return debounced as T;
+}