@frontit/core 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yohan Byun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @frontit/core
+
+Low-level browser primitives and utilities for frontend development.
+
+```ts
+import { createScrollState } from '@frontit/core/scroll'
+
+const scroll = createScrollState()
+
+scroll.subscribe((state) => {
+  console.log(state.isTouchScrolling)
+})
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createScrollState } from './scroll/index.js';
+export type { ScrollState, ScrollStateListener, ScrollStateOptions, ScrollStateSnapshot, } from './scroll/index.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createScrollState } from './scroll/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/scroll/index.d.ts

@@ -0,0 +1,2 @@
+export { createScrollState } from './scroll-state.js';
+export type { ScrollState, ScrollStateListener, ScrollStateOptions, ScrollStateSnapshot, } from './scroll-state.js';

package/dist/scroll/index.js

@@ -0,0 +1,2 @@
+export { createScrollState } from './scroll-state.js';
+//# sourceMappingURL=index.js.map

package/dist/scroll/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scroll/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/scroll/scroll-state.d.ts

@@ -0,0 +1,15 @@
+export interface ScrollStateSnapshot {
+    readonly isTouching: boolean;
+    readonly isScrolling: boolean;
+    readonly isTouchScrolling: boolean;
+}
+export type ScrollStateListener = (state: ScrollStateSnapshot) => void;
+export interface ScrollStateOptions {
+    target?: EventTarget;
+    idleDelay?: number;
+}
+export interface ScrollState extends ScrollStateSnapshot {
+    subscribe(listener: ScrollStateListener): () => void;
+    destroy(): void;
+}
+export declare const createScrollState: (options?: ScrollStateOptions) => ScrollState;

package/dist/scroll/scroll-state.js

@@ -0,0 +1,146 @@
+const getTouchCount = (event) => {
+    if (!('touches' in event)) {
+        return undefined;
+    }
+    const touches = event.touches;
+    if (typeof touches !== 'object' ||
+        touches === null ||
+        !('length' in touches) ||
+        typeof touches.length !== 'number') {
+        return undefined;
+    }
+    return touches.length;
+};
+export const createScrollState = (options = {}) => {
+    const target = options.target ?? (typeof window === 'undefined' ? undefined : window);
+    const idleDelay = options.idleDelay ?? 200;
+    const listeners = new Set();
+    let isTouching = false;
+    let isScrolling = false;
+    let isTouchScrolling = false;
+    let touchSequenceActive = false;
+    let scrollTimeout;
+    let touchTimeout;
+    let destroyed = false;
+    const snapshot = () => ({
+        isTouching,
+        isScrolling,
+        isTouchScrolling,
+    });
+    const notify = () => {
+        const state = snapshot();
+        listeners.forEach((listener) => listener(state));
+    };
+    const update = (nextState) => {
+        if (destroyed) {
+            return;
+        }
+        const nextIsTouching = nextState.isTouching ?? isTouching;
+        const nextIsScrolling = nextState.isScrolling ?? isScrolling;
+        const nextIsTouchScrolling = nextState.isTouchScrolling ?? isTouchScrolling;
+        if (nextIsTouching === isTouching &&
+            nextIsScrolling === isScrolling &&
+            nextIsTouchScrolling === isTouchScrolling) {
+            return;
+        }
+        isTouching = nextIsTouching;
+        isScrolling = nextIsScrolling;
+        isTouchScrolling = nextIsTouchScrolling;
+        notify();
+    };
+    const clearScrollTimeout = () => {
+        if (scrollTimeout !== undefined) {
+            clearTimeout(scrollTimeout);
+            scrollTimeout = undefined;
+        }
+    };
+    const clearTouchTimeout = () => {
+        if (touchTimeout !== undefined) {
+            clearTimeout(touchTimeout);
+            touchTimeout = undefined;
+        }
+    };
+    const handleTouchStart = () => {
+        clearTouchTimeout();
+        touchSequenceActive = true;
+        update({ isTouching: true });
+    };
+    const handleTouchEnd = (event) => {
+        const nextIsTouching = (getTouchCount(event) ?? 0) > 0;
+        update({ isTouching: nextIsTouching });
+        if (nextIsTouching) {
+            return;
+        }
+        clearTouchTimeout();
+        touchTimeout = globalThis.setTimeout(() => {
+            touchTimeout = undefined;
+            if (!isScrolling) {
+                touchSequenceActive = false;
+                update({ isTouchScrolling: false });
+            }
+        }, idleDelay);
+    };
+    const handleScroll = () => {
+        clearScrollTimeout();
+        if (touchSequenceActive) {
+            clearTouchTimeout();
+        }
+        update({
+            isScrolling: true,
+            isTouchScrolling: touchSequenceActive || isTouchScrolling,
+        });
+        scrollTimeout = globalThis.setTimeout(() => {
+            scrollTimeout = undefined;
+            const shouldEndTouchScroll = !isTouching;
+            if (shouldEndTouchScroll) {
+                touchSequenceActive = false;
+            }
+            update({
+                isScrolling: false,
+                isTouchScrolling: shouldEndTouchScroll ? false : isTouchScrolling,
+            });
+        }, idleDelay);
+    };
+    target?.addEventListener('touchstart', handleTouchStart, { passive: true });
+    target?.addEventListener('touchend', handleTouchEnd, { passive: true });
+    target?.addEventListener('touchcancel', handleTouchEnd, { passive: true });
+    target?.addEventListener('scroll', handleScroll, { passive: true });
+    return {
+        get isTouching() {
+            return isTouching;
+        },
+        get isScrolling() {
+            return isScrolling;
+        },
+        get isTouchScrolling() {
+            return isTouchScrolling;
+        },
+        subscribe(listener) {
+            if (destroyed) {
+                return () => undefined;
+            }
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        destroy() {
+            if (destroyed) {
+                return;
+            }
+            destroyed = true;
+            clearScrollTimeout();
+            clearTouchTimeout();
+            listeners.clear();
+            isTouching = false;
+            isScrolling = false;
+            isTouchScrolling = false;
+            touchSequenceActive = false;
+            target?.removeEventListener('touchstart', handleTouchStart);
+            target?.removeEventListener('touchend', handleTouchEnd);
+            target?.removeEventListener('touchcancel', handleTouchEnd);
+            target?.removeEventListener('scroll', handleScroll);
+        },
+    };
+};
+//# sourceMappingURL=scroll-state.js.map

package/dist/scroll/scroll-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-state.js","sourceRoot":"","sources":["../../src/scroll/scroll-state.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@frontit/core",
+  "version": "0.0.1",
+  "description": "Low-level browser primitives and utilities for frontend development.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./scroll": {
+      "types": "./dist/scroll/index.d.ts",
+      "import": "./dist/scroll/index.js",
+      "default": "./dist/scroll/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/restarea92/frontit.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/restarea92/frontit#readme",
+  "bugs": {
+    "url": "https://github.com/restarea92/frontit/issues"
+  },
+  "keywords": [
+    "frontend",
+    "browser",
+    "touch",
+    "scroll",
+    "interaction",
+    "typescript"
+  ],
+  "author": "Yohan Byun <restarea@me.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}