@substrate-system/raf-scroll 0.0.2

package/LICENSE

@@ -0,0 +1,99 @@
+# Big Time Public License
+
+Version 2.0.2
+
+<https://bigtimelicense.com/versions/2.0.2>
+
+## Purpose
+
+These terms let you use and share this software for noncommercial purposes and in small business for free, while also guaranteeing that paid licenses for big businesses will be available on fair, reasonable, and nondiscriminatory terms.
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Noncommercial Purposes
+
+You may use the software for any noncommercial purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, count as use for noncommercial purposes.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution counts as use for noncommercial purposes, regardless of the source of funding or obligations resulting from the funding.
+
+## Small Business
+
+You may use the software for the benefit of your company if it meets all these criteria:
+
+1.  had fewer than 20 total individuals working as employees and independent contractors at all times during the last tax year
+
+2.  earned less than $1,000,000 total revenue in the last tax year
+
+3.  received less than $1,000,000 total debt, equity, and other investment in the last five tax years, counting investment in predecessor companies that reorganized into, merged with, or spun out your company
+
+All dollar figures are United States dollars as of 2019.  Adjust for them inflation according to the United States Bureau of Labor Statistics' consumer price index for all urban consumers, United States city average, for all items, not seasonally adjusted, with 1982–1984=100 reference base.
+
+## Big Business
+
+You may use the software for the benefit of your company:
+
+1.  for 128 days after your company stops qualifying under [Small Business](#small-business)
+
+2.  indefinitely, if the licensor or their legal successor does not offer fair, reasonable, and nondiscriminatory terms for a commercial license for the software within 32 days of [written request](#how-to-request) and negotiate in good faith to conclude a deal
+
+## How to Request
+
+If this software includes an address for the licensor or an agent of the licensor in a standard place, such as in documentation, software package metadata, or an "about" page or screen, try to request a fair commercial license at that address.  If this package includes both online and offline addresses, try online before offline.  If you can't deliver a request that way, or this software doesn't include any addressees, spend one hour online researching an address, recording all your searches and inquiries as you go, and try any addresses that you find.  If you can't find any addresses, or if those addresses also fail, that counts as failure to offer a fair commercial license by the licensor under [Big Business](#big-business).
+
+## Fair, Reasonable, and Nondiscriminatory Terms
+
+Fair, reasonable, and nondiscriminatory terms may license the software perpetually or for a term, and may or may not cover new versions of the software.  If the licensor advertises license terms and a pricing structure for generally available commercial licenses, the licensor proposes license terms and a price as advertised, and a customer not affiliated with the licensor has bought a commercial license for the software on substantially equivalent terms in the past year, the proposal is fair, reasonable, and nondiscriminatory.
+
+## Copyright License
+
+The licensor grants you a copyright license to do everything with the software that would otherwise infringe the licensor's copyright in it for any purpose allowed by these terms.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Nick Thomas (https://nichoth.com).
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/README.md

@@ -0,0 +1,58 @@
+# raf scroll
+[![tests](https://img.shields.io/github/actions/workflow/status/substrate-system/raf-scroll/nodejs.yml?style=flat-square)](https://github.com/substrate-system/raf-scroll/actions/workflows/nodejs.yml)
+[![dependencies](https://img.shields.io/badge/dependencies-zero-brightgreen.svg?style=flat-square)](package.json)
+[![types](https://img.shields.io/npm/types/@substrate-system/raf-scroll?style=flat-square)](README.md)
+[![module](https://img.shields.io/badge/module-ESM%2FCJS-blue?style=flat-square)](README.md)
+[![install size](https://flat.badgen.net/packagephobia/install/@substrate-system/raf-scroll?cache-control=no-cache)](https://packagephobia.com/result?p=@substrate-system/raf-scroll)
+[![gzip size](https://img.shields.io/bundlephobia/minzip/@substrate-system/raf-scroll?style=flat-square)](https://bundlephobia.com/package/@substrate-system/raf-scroll)
+[![license](https://img.shields.io/badge/license-Big_Time-blue?style=flat-square)](LICENSE)
+
+Scroll events, debounced with `requestAnimationFrame`.
+
+<details><summary><h2>Contents</h2></summary>
+<!-- toc -->
+</details>
+
+## Install
+```sh
+npm i -S @substrate-system/raf-scroll
+```
+
+## Example
+
+```js
+import { rafScroll } from '@substrate-system/raf-scroll'
+
+rafScroll(ev => {
+    // this is called at most once per animation frame
+    console.log('scroll event', ev)
+})
+```
+
+## Modules
+
+This exposes ESM and common JS via [package.json `exports` field](https://nodejs.org/api/packages.html#exports).
+
+### Bundler
+
+Import like normal.
+
+```js
+import { rafScroll } from '@substrate-system/raf-scroll'
+```
+
+### Minified
+
+This package exposes minified JS too. Copy to a location that is
+accessible to your web server, then link to it in HTML.
+
+#### copy
+```sh
+cp ./node_modules/@substrate-system/raf-scroll/dist/index.min.js ./public/raf-scroll.min.js
+```
+
+#### HTML
+```html
+<script type="module" src="./raf-scroll.min.js"></script>
+```
+

package/dist/index.cjs

@@ -0,0 +1,44 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  rafScroll: () => rafScroll
+});
+module.exports = __toCommonJS(index_exports);
+let lastKnownScrollPosition = 0;
+let ticking = false;
+const rafScroll = /* @__PURE__ */ __name(function rafScroll2(cb) {
+  document.addEventListener("scroll", onScroll);
+  function onScroll() {
+    lastKnownScrollPosition = window.scrollY;
+    if (!ticking) {
+      window.requestAnimationFrame(() => {
+        cb(lastKnownScrollPosition);
+        ticking = false;
+      });
+      ticking = true;
+    }
+  }
+  __name(onScroll, "onScroll");
+  return /* @__PURE__ */ __name(function Unsubscribe() {
+    document.removeEventListener("scroll", onScroll);
+  }, "Unsubscribe");
+}, "rafScroll");
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyJsZXQgbGFzdEtub3duU2Nyb2xsUG9zaXRpb24gPSAwXG5sZXQgdGlja2luZyA9IGZhbHNlXG5cbmludGVyZmFjZSBVbnN1YnNjcmliZSB7XG4gICAgKCk6dm9pZFxufVxuXG5leHBvcnQgY29uc3QgcmFmU2Nyb2xsID0gZnVuY3Rpb24gcmFmU2Nyb2xsIChcbiAgICBjYjooc2Nyb2xsWTpudW1iZXIpPT5hbnlcbik6VW5zdWJzY3JpYmUge1xuICAgIGRvY3VtZW50LmFkZEV2ZW50TGlzdGVuZXIoJ3Njcm9sbCcsIG9uU2Nyb2xsKVxuXG4gICAgZnVuY3Rpb24gb25TY3JvbGwgKCkge1xuICAgICAgICBsYXN0S25vd25TY3JvbGxQb3NpdGlvbiA9IHdpbmRvdy5zY3JvbGxZXG5cbiAgICAgICAgaWYgKCF0aWNraW5nKSB7XG4gICAgICAgICAgICB3aW5kb3cucmVxdWVzdEFuaW1hdGlvbkZyYW1lKCgpID0+IHtcbiAgICAgICAgICAgICAgICBjYihsYXN0S25vd25TY3JvbGxQb3NpdGlvbilcbiAgICAgICAgICAgICAgICB0aWNraW5nID0gZmFsc2VcbiAgICAgICAgICAgIH0pXG5cbiAgICAgICAgICAgIHRpY2tpbmcgPSB0cnVlXG4gICAgICAgIH1cbiAgICB9XG5cbiAgICByZXR1cm4gZnVuY3Rpb24gVW5zdWJzY3JpYmUgKCkge1xuICAgICAgICBkb2N1bWVudC5yZW1vdmVFdmVudExpc3RlbmVyKCdzY3JvbGwnLCBvblNjcm9sbClcbiAgICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLElBQUksMEJBQTBCO0FBQzlCLElBQUksVUFBVTtBQU1QLE1BQU0sWUFBWSxnQ0FBU0EsV0FDOUIsSUFDVTtBQUNWLFdBQVMsaUJBQWlCLFVBQVUsUUFBUTtBQUU1QyxXQUFTLFdBQVk7QUFDakIsOEJBQTBCLE9BQU87QUFFakMsUUFBSSxDQUFDLFNBQVM7QUFDVixhQUFPLHNCQUFzQixNQUFNO0FBQy9CLFdBQUcsdUJBQXVCO0FBQzFCLGtCQUFVO0FBQUEsTUFDZCxDQUFDO0FBRUQsZ0JBQVU7QUFBQSxJQUNkO0FBQUEsRUFDSjtBQVhTO0FBYVQsU0FBTyxnQ0FBUyxjQUFlO0FBQzNCLGFBQVMsb0JBQW9CLFVBQVUsUUFBUTtBQUFBLEVBQ25ELEdBRk87QUFHWCxHQXJCeUI7IiwKICAibmFtZXMiOiBbInJhZlNjcm9sbCJdCn0K

package/dist/index.js

@@ -0,0 +1,25 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+let lastKnownScrollPosition = 0;
+let ticking = false;
+const rafScroll = /* @__PURE__ */ __name(function rafScroll2(cb) {
+  document.addEventListener("scroll", onScroll);
+  function onScroll() {
+    lastKnownScrollPosition = window.scrollY;
+    if (!ticking) {
+      window.requestAnimationFrame(() => {
+        cb(lastKnownScrollPosition);
+        ticking = false;
+      });
+      ticking = true;
+    }
+  }
+  __name(onScroll, "onScroll");
+  return /* @__PURE__ */ __name(function Unsubscribe() {
+    document.removeEventListener("scroll", onScroll);
+  }, "Unsubscribe");
+}, "rafScroll");
+export {
+  rafScroll
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyJsZXQgbGFzdEtub3duU2Nyb2xsUG9zaXRpb24gPSAwXG5sZXQgdGlja2luZyA9IGZhbHNlXG5cbmludGVyZmFjZSBVbnN1YnNjcmliZSB7XG4gICAgKCk6dm9pZFxufVxuXG5leHBvcnQgY29uc3QgcmFmU2Nyb2xsID0gZnVuY3Rpb24gcmFmU2Nyb2xsIChcbiAgICBjYjooc2Nyb2xsWTpudW1iZXIpPT5hbnlcbik6VW5zdWJzY3JpYmUge1xuICAgIGRvY3VtZW50LmFkZEV2ZW50TGlzdGVuZXIoJ3Njcm9sbCcsIG9uU2Nyb2xsKVxuXG4gICAgZnVuY3Rpb24gb25TY3JvbGwgKCkge1xuICAgICAgICBsYXN0S25vd25TY3JvbGxQb3NpdGlvbiA9IHdpbmRvdy5zY3JvbGxZXG5cbiAgICAgICAgaWYgKCF0aWNraW5nKSB7XG4gICAgICAgICAgICB3aW5kb3cucmVxdWVzdEFuaW1hdGlvbkZyYW1lKCgpID0+IHtcbiAgICAgICAgICAgICAgICBjYihsYXN0S25vd25TY3JvbGxQb3NpdGlvbilcbiAgICAgICAgICAgICAgICB0aWNraW5nID0gZmFsc2VcbiAgICAgICAgICAgIH0pXG5cbiAgICAgICAgICAgIHRpY2tpbmcgPSB0cnVlXG4gICAgICAgIH1cbiAgICB9XG5cbiAgICByZXR1cm4gZnVuY3Rpb24gVW5zdWJzY3JpYmUgKCkge1xuICAgICAgICBkb2N1bWVudC5yZW1vdmVFdmVudExpc3RlbmVyKCdzY3JvbGwnLCBvblNjcm9sbClcbiAgICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOztBQUFBLElBQUksMEJBQTBCO0FBQzlCLElBQUksVUFBVTtBQU1QLE1BQU0sWUFBWSxnQ0FBU0EsV0FDOUIsSUFDVTtBQUNWLFdBQVMsaUJBQWlCLFVBQVUsUUFBUTtBQUU1QyxXQUFTLFdBQVk7QUFDakIsOEJBQTBCLE9BQU87QUFFakMsUUFBSSxDQUFDLFNBQVM7QUFDVixhQUFPLHNCQUFzQixNQUFNO0FBQy9CLFdBQUcsdUJBQXVCO0FBQzFCLGtCQUFVO0FBQUEsTUFDZCxDQUFDO0FBRUQsZ0JBQVU7QUFBQSxJQUNkO0FBQUEsRUFDSjtBQVhTO0FBYVQsU0FBTyxnQ0FBUyxjQUFlO0FBQzNCLGFBQVMsb0JBQW9CLFVBQVUsUUFBUTtBQUFBLEVBQ25ELEdBRk87QUFHWCxHQXJCeUI7IiwKICAibmFtZXMiOiBbInJhZlNjcm9sbCJdCn0K

package/dist/index.min.cjs

@@ -0,0 +1 @@
+"use strict";var l=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var t=(e,n)=>l(e,"name",{value:n,configurable:!0});var b=(e,n)=>{for(var o in n)l(e,o,{get:n[o],enumerable:!0})},d=(e,n,o,c)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of a(n))!f.call(e,r)&&r!==o&&l(e,r,{get:()=>n[r],enumerable:!(c=u(n,r))||c.enumerable});return e};var m=e=>d(l({},"__esModule",{value:!0}),e);var v={};b(v,{rafScroll:()=>w});module.exports=m(v);let s=0,i=!1;const w=t(function(n){document.addEventListener("scroll",o);function o(){s=window.scrollY,i||(window.requestAnimationFrame(()=>{n(s),i=!1}),i=!0)}return t(o,"onScroll"),t(function(){document.removeEventListener("scroll",o)},"Unsubscribe")},"rafScroll");

package/dist/index.min.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var n=(r,e)=>c(r,"name",{value:e,configurable:!0});let t=0,o=!1;const u=n(function(e){document.addEventListener("scroll",l);function l(){t=window.scrollY,o||(window.requestAnimationFrame(()=>{e(t),o=!1}),o=!0)}return n(l,"onScroll"),n(function(){document.removeEventListener("scroll",l)},"Unsubscribe")},"rafScroll");export{u as rafScroll};

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@substrate-system/raf-scroll",
+  "description": "Scroll events, debounced with `requestAnimationFrame`",
+  "directories": {
+    "example": "example",
+    "test": "test"
+  },
+  "type": "module",
+  "version": "0.0.2",
+  "main": "dist/index.js",
+  "files": [
+    "./dist/*"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./min": {
+      "import": [
+        "./dist/index.min.js"
+      ],
+      "require": [
+        "./dist/index.min.cjs"
+      ]
+    },
+    "./*": {
+      "import": [
+        "./dist/*.js",
+        "./dist/*"
+      ],
+      "require": [
+        "./dist/*.cjs",
+        "./dist/*"
+      ]
+    }
+  },
+  "scripts": {
+    "lint": "eslint \"./**/*.{ts,js}\"",
+    "build-tests": "esbuild test/index.ts --target=es2020 --bundle --keep-names > test/test-bundle.js",
+    "test": "npm run lint && npm run build",
+    "build-cjs": "esbuild src/*.ts --format=cjs --tsconfig=tsconfig.build.json --keep-names --outdir=./dist --out-extension:.js=.cjs --sourcemap=inline",
+    "build-esm": "esbuild src/*.ts --format=esm --tsconfig=tsconfig.build.json --keep-names --outdir=./dist --sourcemap=inline",
+    "build": "mkdir -p ./dist && rm -rf ./dist/* && npm run build-cjs && npm run build-esm && npm run build:min",
+    "build-cjs:min": "esbuild src/*.ts --minify --format=cjs --tsconfig=tsconfig.build.json --keep-names --outdir=./dist --out-extension:.js=.min.cjs",
+    "build-esm:min": "esbuild src/*.ts --minify --format=esm --tsconfig=tsconfig.build.json --keep-names --outdir=./dist --out-extension:.js=.min.js",
+    "build:min": "npm run build-cjs:min && npm run build-esm:min",
+    "start": "vite",
+    "toc": "markdown-toc --maxdepth 3 -i README.md",
+    "preversion": "npm run lint",
+    "version": "npm run toc && auto-changelog -p --template keepachangelog --breaking-pattern 'BREAKING CHANGE:' && git add CHANGELOG.md README.md",
+    "postversion": "git push --follow-tags && npm publish",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@bicycle-codes/tapzero": "^0.10.0",
+    "@nichoth/debug": "^0.6.5",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "auto-changelog": "^2.4.0",
+    "esbuild": "^0.25.0",
+    "eslint": "^8.57.0",
+    "eslint-config-standard": "^17.1.0",
+    "markdown-toc": "^1.2.0",
+    "postcss-nesting": "^13.0.0",
+    "tap-arc": "^1.2.2",
+    "tape-run": "^11.0.0",
+    "typescript": "^5.3.3",
+    "vite": "^6.0.0"
+  },
+  "author": "nichoth <nichoth@gmail.com> (https://nichoth.com)",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bicycle-codes/raf-scroll.git"
+  },
+  "keywords": [
+    "request",
+    "animation",
+    "from",
+    "scroll",
+    "raf"
+  ],
+  "bugs": {
+    "url": "https://github.com/bicycle-codes/raf-scroll/issues"
+  },
+  "homepage": "https://github.com/bicycle-codes/raf-scroll#readme"
+}