forgebook 0.1.3 → 0.1.5

package/dist/src/frame/touchLayer.js

@@ -0,0 +1,399 @@
+/**
+ * The frame's simulated touch, on while the root has `data-forgebook-touch` (the Touch switch): the real mouse's
+ * events are caught before the story and sent again as a finger, or as two with Shift held.
+ *
+ * @remarks
+ * A press sends `pointerdown` (touch) and `touchstart`; a move sends `touchmove`, and `pointermove` until a drag
+ * starts scrolling, when the pointer is cancelled as the browser cancels it (`touchScroll.ts`); a lift sends
+ * `pointerup` and `touchend`. A tap then sends the mouse's compatibility events and its own click of the `touch` type
+ * in place of the real one, so a button, a link or a checkbox reacts as it would; a press held half a second sends `contextmenu`. A moving mouse with
+ * no button down sends nothing: a finger does not hover. Shift fixes a centre where the mouse is; a press then puts a
+ * second finger mirrored around it, so dragging pinches and rotates. The real cursor is hidden and the fingers are
+ * dots (`touchDots.ts`). While it is on, `navigator.maxTouchPoints` and `ontouchstart` say touch, and capturing a
+ * simulated pointer works. A simulation: the events are not trusted, so the browser's own scrolling, focus from a
+ * touch, a virtual keyboard and real Safari stay a device's (or `forgebook dev --touch`'s).
+ *
+ * @module
+ */
+import { isRealTouchWindow } from "../realTouch.js";
+import { touchDots } from "./touchDots.js";
+import { sendClick, sendMouse, sendPointer, sendTouch } from "./touchEvents.js";
+import { distance, dragAxis, isDragging, LONG_PRESS_MS, mirroredFinger } from "./touchGesture.js";
+import { endPan, panBy, panOf } from "./touchScroll.js";
+/** The root's attribute that turns the simulation on. */
+const TOUCH_ATTRIBUTE = "data-forgebook-touch";
+/** The simulated pointers' ids: apart from the real mouse's, so the browser never confuses them. */
+const FINGER_IDS = [100, 101];
+/** The least distance between two fingers, in CSS px: a centre right under the mouse moves aside by half of it. */
+const LEAST_SPREAD_PX = 80;
+/** The real events that never reach the story while touch is simulated (the hover a finger does not have). */
+const SWALLOWED = ["mousedown", "mouseup", "mousemove", "mouseover", "mouseout", "mouseenter", "mouseleave"];
+/** The real pointer events that never reach the story: the fingers send their own. */
+const SWALLOWED_POINTER = ["pointerover", "pointerout", "pointerenter", "pointerleave"];
+/**
+ * The two-finger centre for a press at a point: Shift's, moved aside when it is right under the mouse.
+ *
+ * @param center - where Shift fixed it.
+ * @param point - where the press is.
+ */
+const spreadCenter = (center, point) => distance(center, point) * 2 >= LEAST_SPREAD_PX ? center : { x: point.x - LEAST_SPREAD_PX / 2, y: point.y };
+/**
+ * The fingers' dots: the fingers of a press, or the mouse (and the second finger to come, with Shift) between presses.
+ *
+ * @param state - the simulation's state.
+ */
+const drawDots = (state) => {
+    const { press, mouse, center } = state;
+    if (press !== undefined) {
+        state.dots.draw(press.fingers.map((finger) => ({ point: finger.point, isPressed: true })));
+        return;
+    }
+    if (mouse === undefined) {
+        state.dots.draw([]);
+        return;
+    }
+    // the second finger where a press will put it: the same centre the press takes, moved aside as it will be
+    const second = center === undefined
+        ? []
+        : [{ point: mirroredFinger(spreadCenter(center, mouse), mouse), isPressed: false }];
+    state.dots.draw([{ point: mouse, isPressed: false }, ...second]);
+};
+/**
+ * The second finger going down at a point.
+ *
+ * @param document - the frame's document.
+ * @param id - its id.
+ * @param point - where.
+ * @param fallback - the element when none is under the point.
+ */
+const fingerAt = (document, id, point, fallback) => {
+    const target = document.elementFromPoint(point.x, point.y) ?? fallback;
+    return { id, isPrimary: false, point, startTarget: target, captureTarget: target };
+};
+/**
+ * A press begins: its fingers go down, each sending its pointer and touch events.
+ *
+ * @param state - the simulation's state.
+ * @param event - the real pointer's press.
+ */
+const pressDown = (state, event) => {
+    state.stopFling();
+    const point = { x: event.clientX, y: event.clientY };
+    const target = event.target instanceof Element ? event.target : state.document.documentElement;
+    const shiftCenter = event.shiftKey ? (state.center ?? point) : undefined;
+    const center = shiftCenter === undefined ? undefined : spreadCenter(shiftCenter, point);
+    // the first finger goes down where the real press did, on the element the browser found under it
+    const fingers = [
+        { id: FINGER_IDS[0], isPrimary: true, point, startTarget: target, captureTarget: target }
+    ];
+    if (center !== undefined)
+        fingers.push(fingerAt(state.document, FINGER_IDS[1], mirroredFinger(center, point), target));
+    // the press is the layer's before its first event: a story that captures the pointer in its pointerdown finds it
+    const press = {
+        fingers,
+        start: point,
+        center,
+        isDrag: false,
+        isLongPress: false,
+        isDownCancelled: false,
+        isTouchCancelled: false,
+        pan: undefined,
+        last: { point, time: event.timeStamp },
+        speed: { x: 0, y: 0 },
+        timer: undefined
+    };
+    state.press = press;
+    for (const finger of fingers) {
+        sendPointer("pointerover", finger, true);
+        sendPointer("pointerenter", finger, true);
+        if (!sendPointer("pointerdown", finger, true))
+            press.isDownCancelled = true;
+    }
+    press.isTouchCancelled = !sendTouch("touchstart", fingers, fingers, true);
+    // a long press opens the story's menu, as on a phone
+    press.timer = window.setTimeout(() => {
+        if (press.isDrag || press.fingers.length > 1 || state.press !== press)
+            return;
+        press.isLongPress = true;
+        const [first] = press.fingers;
+        if (first !== undefined)
+            sendMouse("contextmenu", first);
+    }, LONG_PRESS_MS);
+    drawDots(state);
+};
+/**
+ * Starts the drag of a press, the first time its finger passes a tap's reach: a single finger whose move no handler
+ * cancelled scrolls what it can (the pointer is then cancelled, as the browser cancels it).
+ *
+ * @param press - the press.
+ * @param isMoveCancelled - whether a handler cancelled this `touchmove`.
+ */
+const startDrag = (press, isMoveCancelled) => {
+    press.isDrag = true;
+    window.clearTimeout(press.timer);
+    const [first] = press.fingers;
+    if (isMoveCancelled || press.isTouchCancelled || press.fingers.length > 1 || first === undefined)
+        return;
+    press.pan = panOf(first.startTarget, dragAxis(press.start, first.point));
+    if (press.pan !== undefined)
+        sendPointer("pointercancel", first, false);
+};
+/**
+ * The fingers follow the mouse: touch events always, pointer events until the drag scrolls, the scroll otherwise.
+ *
+ * @param state - the simulation's state.
+ * @param press - the press.
+ * @param event - the real pointer's move.
+ */
+const pressMove = (state, press, event) => {
+    const point = { x: event.clientX, y: event.clientY };
+    // the mouse goes with the finger: after the lift, its dot stays where the finger left the screen
+    state.mouse = point;
+    const [first, second] = press.fingers;
+    if (first === undefined)
+        return;
+    const from = first.point;
+    first.point = point;
+    if (second !== undefined && press.center !== undefined)
+        second.point = mirroredFinger(press.center, point);
+    const isMoveCancelled = !sendTouch("touchmove", press.fingers, press.fingers, press.pan === undefined);
+    if (!press.isDrag && isDragging(press.start, point))
+        startDrag(press, isMoveCancelled);
+    const ms = Math.max(1, event.timeStamp - press.last.time);
+    press.speed = { x: (point.x - press.last.point.x) / ms, y: (point.y - press.last.point.y) / ms };
+    press.last = { point, time: event.timeStamp };
+    if (press.pan !== undefined)
+        panBy(press.pan, from, point);
+    else
+        for (const finger of press.fingers)
+            sendPointer("pointermove", finger, true);
+    drawDots(state);
+};
+/**
+ * A press ends: the fingers lift, a scroll flings on, a tap sends the mouse's compatibility events and readies its
+ * click.
+ *
+ * @param state - the simulation's state.
+ * @param press - the press.
+ * @param isCancel - whether the browser cancelled the real pointer.
+ */
+const pressUp = (state, press, isCancel) => {
+    window.clearTimeout(press.timer);
+    state.press = undefined;
+    if (press.pan === undefined) {
+        for (const finger of press.fingers) {
+            sendPointer(isCancel ? "pointercancel" : "pointerup", finger, false);
+            sendPointer("pointerout", finger, false);
+            sendPointer("pointerleave", finger, false);
+        }
+    }
+    const isEndCancelled = !sendTouch(isCancel ? "touchcancel" : "touchend", [], press.fingers, press.pan === undefined);
+    if (press.pan !== undefined)
+        state.stopFling = endPan(press.pan, press.speed);
+    const [first] = press.fingers;
+    const isTap = !isCancel && !press.isDrag && !press.isLongPress && press.fingers.length === 1;
+    const isClicking = isTap && !press.isTouchCancelled && !isEndCancelled;
+    state.tapper = isClicking ? first : undefined;
+    if (isClicking && !press.isDownCancelled && first !== undefined) {
+        sendMouse("mousedown", first);
+        sendMouse("mouseup", first);
+    }
+    drawDots(state);
+};
+/**
+ * A real event the story never receives in place of a finger's: the click (a tap's is sent again as a finger's, a
+ * drag's or a long press's is none), a text selection or an image dragged by the finger, the right button's menu.
+ *
+ * @param state - the simulation's state.
+ * @param event - the real event.
+ * @returns whether it was one of them.
+ */
+const blockedDefault = (state, event) => {
+    if (event.type === "click") {
+        event.preventDefault();
+        event.stopImmediatePropagation();
+        const finger = state.tapper;
+        state.tapper = undefined;
+        // after the real click's dispatch: cancelling it undoes a checkbox's toggle at its end, a click sent inside it too
+        const { target } = event;
+        if (finger !== undefined && target !== null)
+            window.setTimeout(() => sendClick(target, finger), 0);
+        return true;
+    }
+    if (event.type !== "selectstart" && event.type !== "dragstart" && event.type !== "contextmenu")
+        return false;
+    event.preventDefault();
+    event.stopImmediatePropagation();
+    return true;
+};
+/**
+ * What the simulation does with one real pointer event: the press, the move and the lift of the fingers, the dots
+ * between presses.
+ *
+ * @param state - the simulation's state.
+ * @param event - the real pointer event.
+ */
+const pointerInput = (state, event) => {
+    const { press } = state;
+    if (event.type === "pointerout" && event.relatedTarget === null && press === undefined) {
+        state.mouse = undefined;
+        drawDots(state);
+    }
+    else if (event.type === "pointerdown" && event.button === 0 && press === undefined)
+        pressDown(state, event);
+    else if (event.type === "pointermove" && press !== undefined)
+        pressMove(state, press, event);
+    else if (event.type === "pointermove") {
+        // Shift read from the pointer, which carries it even when the frame has no focus (the shell usually does): held,
+        // it fixes the two-finger centre where the mouse was
+        if (!event.shiftKey)
+            state.center = undefined;
+        else
+            state.center ??= state.mouse ?? { x: event.clientX, y: event.clientY };
+        state.mouse = { x: event.clientX, y: event.clientY };
+        drawDots(state);
+    }
+    else if ((event.type === "pointerup" || event.type === "pointercancel") && press !== undefined) {
+        state.mouse = { x: event.clientX, y: event.clientY };
+        pressUp(state, press, event.type === "pointercancel");
+    }
+};
+/**
+ * What the simulation does with one real event, before the story sees it: the story never sees a real one.
+ *
+ * @param state - the simulation's state.
+ * @param event - the real event (the story's own dispatched events are left alone).
+ */
+const intercept = (state, event) => {
+    if (!event.isTrusted || blockedDefault(state, event))
+        return;
+    event.stopImmediatePropagation();
+    if (event instanceof PointerEvent)
+        pointerInput(state, event);
+};
+/**
+ * Makes the frame say it is a touch device, and lets the story capture a simulated pointer.
+ *
+ * @param state - the simulation's state.
+ * @returns what puts the frame back as it was.
+ */
+const pretendTouch = (state) => {
+    const view = state.document.defaultView;
+    if (view === null)
+        return () => undefined;
+    Object.defineProperty(view.navigator, "maxTouchPoints", { configurable: true, get: () => 5 });
+    Object.defineProperty(view, "ontouchstart", { configurable: true, writable: true, value: null });
+    const proto = view.Element.prototype;
+    const native = {
+        set: proto.setPointerCapture,
+        release: proto.releasePointerCapture,
+        has: proto.hasPointerCapture
+    };
+    const fingerOf = (id) => state.press?.fingers.find((finger) => finger.id === id);
+    proto.setPointerCapture = function setPointerCapture(id) {
+        const finger = fingerOf(id);
+        if (finger === undefined) {
+            native.set.call(this, id);
+            return;
+        }
+        finger.captureTarget = this;
+        sendPointer("gotpointercapture", finger, true);
+    };
+    proto.releasePointerCapture = function releasePointerCapture(id) {
+        const finger = fingerOf(id);
+        if (finger === undefined) {
+            native.release.call(this, id);
+            return;
+        }
+        sendPointer("lostpointercapture", finger, true);
+        finger.captureTarget = finger.startTarget;
+    };
+    proto.hasPointerCapture = function hasPointerCapture(id) {
+        const finger = fingerOf(id);
+        return finger === undefined ? native.has.call(this, id) : finger.captureTarget === this;
+    };
+    return () => {
+        Reflect.deleteProperty(view.navigator, "maxTouchPoints");
+        Reflect.deleteProperty(view, "ontouchstart");
+        proto.setPointerCapture = native.set;
+        proto.releasePointerCapture = native.release;
+        proto.hasPointerCapture = native.has;
+    };
+};
+/** The events the simulation catches, on the window, before the story. */
+const CAUGHT = [
+    "pointerdown",
+    "pointermove",
+    "pointerup",
+    "pointercancel",
+    ...SWALLOWED_POINTER,
+    ...SWALLOWED,
+    "click",
+    "contextmenu",
+    "selectstart",
+    "dragstart"
+];
+/**
+ * Starts the simulation in a frame.
+ *
+ * @param document - the frame's document.
+ * @returns what stops it.
+ */
+const startTouch = (document) => {
+    const state = {
+        document,
+        dots: touchDots(document),
+        mouse: undefined,
+        center: undefined,
+        press: undefined,
+        tapper: undefined,
+        stopFling: () => undefined
+    };
+    const restore = pretendTouch(state);
+    const onEvent = (event) => intercept(state, event);
+    // Shift fixes the two-finger centre where the mouse is, and shows where the second finger will be
+    const onKey = (event) => {
+        if (event.key !== "Shift" || state.press !== undefined)
+            return;
+        state.center = event.type === "keydown" ? state.mouse : undefined;
+        drawDots(state);
+    };
+    const view = document.defaultView;
+    for (const type of CAUGHT)
+        view?.addEventListener(type, onEvent, { capture: true });
+    view?.addEventListener("keydown", onKey);
+    view?.addEventListener("keyup", onKey);
+    return () => {
+        for (const type of CAUGHT)
+            view?.removeEventListener(type, onEvent, { capture: true });
+        view?.removeEventListener("keydown", onKey);
+        view?.removeEventListener("keyup", onKey);
+        state.stopFling();
+        restore();
+        state.dots.remove();
+    };
+};
+/**
+ * Follows the root's touch attribute from now on: the simulation runs while it is set.
+ *
+ * @param document - the frame's document.
+ */
+export const followTouch = (document) => {
+    let stop;
+    // in Chromium's real touch window the pages see real touch: simulating it on top would send every touch twice
+    const view = document.defaultView;
+    if (view !== null && isRealTouchWindow(view))
+        return;
+    const update = () => {
+        const isOn = document.documentElement.hasAttribute(TOUCH_ATTRIBUTE);
+        if (isOn && stop === undefined)
+            stop = startTouch(document);
+        else if (!isOn && stop !== undefined) {
+            stop();
+            stop = undefined;
+        }
+    };
+    new MutationObserver(update).observe(document.documentElement, { attributeFilter: [TOUCH_ATTRIBUTE] });
+    update();
+};
+//# sourceMappingURL=touchLayer.js.map

package/dist/src/frame/touchLayer.js.map

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

package/dist/src/frame/touchScroll.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A simulated finger's scrolling: the container a drag scrolls, on the axes the `touch-action` on the way allows, and
+ * the fling that carries on after the finger lifts.
+ *
+ * @remarks
+ * An approximation of the browser's own scrolling, which a page cannot start: no rubber band at the ends, the fling
+ * slows down at one fixed rate (`flungSpeed`), and a container that snaps snaps once the finger lifts. The scroll keeps to the drag's axis; the container is the nearest
+ * ancestor that scrolls on it, up to the document's own scrolling element.
+ *
+ * @module
+ */
+import { type PanAxes, type Point } from "./touchGesture.ts";
+/** A scroll a finger drives. */
+export type Pan = {
+    /** The element it scrolls. */
+    readonly scroller: Element;
+    /** The axes it scrolls on. */
+    readonly axes: PanAxes;
+    /**
+     * For a container that snaps, its own `scroll-snap-type` (inline) while the drag pauses its snapping, put back when
+     * the finger lifts; none for one that does not snap.
+     */
+    readonly pausedSnap: string | undefined;
+};
+/**
+ * The scroll a drag drives along its axis, or none when the `touch-action` on the way forbids that axis (a horizontal
+ * swipe on a `pan-y` row stays the row's) or nothing on the way scrolls on it.
+ *
+ * @param target - the element the finger went down on.
+ * @param axis - the drag's axis.
+ */
+export declare const panOf: (target: Element, axis: "x" | "y") => Pan | undefined;
+/**
+ * Scrolls by a finger's move: the content follows the finger.
+ *
+ * @param pan - the scroll.
+ * @param from - where the finger was.
+ * @param to - where it is.
+ */
+export declare const panBy: (pan: Pan, from: Point, to: Point) => void;
+/**
+ * A drag's scroll ends as the finger lifts: a container that snaps snaps again, to the item nearest where the finger
+ * aimed (its place now plus its last speed, at most half the container ahead, so a flick goes to the next item and
+ * never past it), with the browser's smooth scroll; any other flings on. The returned function stops a fling (a new
+ * touch does).
+ *
+ * @param pan - the scroll.
+ * @param speed - the finger's last speed, in CSS px per ms, per axis.
+ */
+export declare const endPan: (pan: Pan, speed: Point) => (() => void);
+//# sourceMappingURL=touchScroll.d.ts.map

package/dist/src/frame/touchScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touchScroll.d.ts","sourceRoot":"","sources":["../../../src/frame/touchScroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAA0B,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAErF,gCAAgC;AAChC,MAAM,MAAM,GAAG,GAAG;IAChB,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,CAAC;AAmCF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,KAAG,GAAG,GAAG,SAQ9D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,GAAG,EAAE,MAAM,KAAK,EAAE,IAAI,KAAK,KAAG,IAKrD,CAAC;AA2CL;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,GAAG,EAAE,OAAO,KAAK,KAAG,CAAC,MAAM,IAAI,CAgB1D,CAAC"}

package/dist/src/frame/touchScroll.js

@@ -0,0 +1,137 @@
+/**
+ * A simulated finger's scrolling: the container a drag scrolls, on the axes the `touch-action` on the way allows, and
+ * the fling that carries on after the finger lifts.
+ *
+ * @remarks
+ * An approximation of the browser's own scrolling, which a page cannot start: no rubber band at the ends, the fling
+ * slows down at one fixed rate (`flungSpeed`), and a container that snaps snaps once the finger lifts. The scroll keeps to the drag's axis; the container is the nearest
+ * ancestor that scrolls on it, up to the document's own scrolling element.
+ *
+ * @module
+ */
+import { allowedPan, flungSpeed } from "./touchGesture.js";
+/** How far ahead a snapping container's fling is aimed, in ms of the finger's last speed. */
+const SNAP_AIM_MS = 250;
+/**
+ * Whether an element scrolls on an axis: it overflows there and its style lets it.
+ *
+ * @param element - the element.
+ * @param axis - the axis.
+ */
+const scrollsOn = (element, axis) => {
+    const isDocument = element === element.ownerDocument.scrollingElement;
+    const overflow = getComputedStyle(element)[axis === "x" ? "overflowX" : "overflowY"];
+    const isScrollable = isDocument || overflow === "auto" || overflow === "scroll";
+    const size = axis === "x" ? element.scrollWidth - element.clientWidth : element.scrollHeight - element.clientHeight;
+    return isScrollable && size > 0;
+};
+/**
+ * A drag's scroll begins: a container that snaps stops snapping while the finger drags it, or every step of the drag
+ * would snap to a whole item.
+ *
+ * @param scroller - the container.
+ * @param axis - the drag's axis.
+ */
+const startPan = (scroller, axis) => {
+    const isSnapping = getComputedStyle(scroller).scrollSnapType !== "none";
+    const style = scroller instanceof HTMLElement ? scroller.style : undefined;
+    const pausedSnap = isSnapping && style !== undefined ? style.scrollSnapType : undefined;
+    if (pausedSnap !== undefined && style !== undefined)
+        style.scrollSnapType = "none";
+    return { scroller, axes: { x: axis === "x", y: axis === "y" }, pausedSnap };
+};
+/**
+ * The scroll a drag drives along its axis, or none when the `touch-action` on the way forbids that axis (a horizontal
+ * swipe on a `pan-y` row stays the row's) or nothing on the way scrolls on it.
+ *
+ * @param target - the element the finger went down on.
+ * @param axis - the drag's axis.
+ */
+export const panOf = (target, axis) => {
+    const touchActions = [];
+    for (let element = target; element !== null; element = element.parentElement) {
+        touchActions.push(getComputedStyle(element).touchAction);
+        if (!allowedPan(touchActions)[axis])
+            return undefined;
+        if (scrollsOn(element, axis))
+            return startPan(element, axis);
+    }
+    return undefined;
+};
+/**
+ * Scrolls by a finger's move: the content follows the finger.
+ *
+ * @param pan - the scroll.
+ * @param from - where the finger was.
+ * @param to - where it is.
+ */
+export const panBy = (pan, from, to) => pan.scroller.scrollBy({
+    left: pan.axes.x ? from.x - to.x : 0,
+    top: pan.axes.y ? from.y - to.y : 0,
+    behavior: "instant"
+});
+/**
+ * Carries a scroll on after the finger lifts, slowing down; the returned function stops it (a new touch does).
+ *
+ * @param pan - the scroll.
+ * @param speed - the finger's last speed, in CSS px per ms, per axis.
+ */
+const fling = (pan, speed) => {
+    const view = pan.scroller.ownerDocument.defaultView;
+    if (view === null)
+        return () => undefined;
+    let current = { x: pan.axes.x ? speed.x : 0, y: pan.axes.y ? speed.y : 0 };
+    let last = view.performance.now();
+    let frame = 0;
+    const step = (now) => {
+        const ms = now - last;
+        last = now;
+        pan.scroller.scrollBy({ left: -current.x * ms, top: -current.y * ms, behavior: "instant" });
+        current = { x: flungSpeed(current.x, ms), y: flungSpeed(current.y, ms) };
+        if (current.x !== 0 || current.y !== 0)
+            frame = view.requestAnimationFrame(step);
+    };
+    frame = view.requestAnimationFrame(step);
+    return () => view.cancelAnimationFrame(frame);
+};
+/**
+ * Where a snapping container's items start along an axis, in its scroll coordinates: its children that snap.
+ *
+ * @param scroller - the container.
+ * @param axis - the axis.
+ */
+const snapPoints = (scroller, axis) => {
+    const box = scroller.getBoundingClientRect();
+    return [...scroller.children]
+        .filter((child) => getComputedStyle(child).scrollSnapAlign !== "none")
+        .map((child) => {
+        const childBox = child.getBoundingClientRect();
+        return axis === "x"
+            ? childBox.left - box.left + scroller.scrollLeft
+            : childBox.top - box.top + scroller.scrollTop;
+    });
+};
+/**
+ * A drag's scroll ends as the finger lifts: a container that snaps snaps again, to the item nearest where the finger
+ * aimed (its place now plus its last speed, at most half the container ahead, so a flick goes to the next item and
+ * never past it), with the browser's smooth scroll; any other flings on. The returned function stops a fling (a new
+ * touch does).
+ *
+ * @param pan - the scroll.
+ * @param speed - the finger's last speed, in CSS px per ms, per axis.
+ */
+export const endPan = (pan, speed) => {
+    if (pan.pausedSnap === undefined || !(pan.scroller instanceof HTMLElement))
+        return fling(pan, speed);
+    const scroller = pan.scroller;
+    const axis = pan.axes.x ? "x" : "y";
+    const room = axis === "x" ? scroller.clientWidth : scroller.clientHeight;
+    const now = axis === "x" ? scroller.scrollLeft : scroller.scrollTop;
+    const aim = now + Math.max(-room / 2, Math.min(room / 2, -(axis === "x" ? speed.x : speed.y) * SNAP_AIM_MS));
+    const target = snapPoints(scroller, axis).reduce((best, point) => (Math.abs(point - aim) < Math.abs(best - aim) ? point : best), aim);
+    // snapping comes back only now: back on, it would snap the place the finger left before the target is read
+    scroller.style.scrollSnapType = pan.pausedSnap;
+    scroller.scrollTo({ [axis === "x" ? "left" : "top"]: target, behavior: "smooth" });
+    return () => undefined;
+};
+//# sourceMappingURL=touchScroll.js.map

package/dist/src/frame/touchScroll.js.map

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