Skip to content

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作

5.6 KB
Raw Blame
import {describe, it} from "node:test";
import * as assert from "node:assert/strict";
import {getTouchAxis} from "./touchGesture";
import {
    getOpeningSidebar,
    getSidebarClosingDirection,
    getSidebarClosingOffset,
    getSidebarOpeningOffset,
    MOBILE_SIDEBAR_SWIPE_ACTIVATION_DISTANCE,
    MOBILE_SIDEBAR_MASK_SWIPING_CLASS,
    MOBILE_SIDEBAR_SWIPING_CLASS,
    setSidebarSwipeState,
    shouldCloseGlobalMenu,
    shouldCommitSidebarSwipe,
    shouldDragOpenSidebar,
} from "./touchPanelGesture";

const createClassTarget = () => {
    const classes = new Set<string>();
    return {
        classes,
        target: {
            classList: {
                add(className: string) {
                    classes.add(className);
                },
                remove(className: string) {
                    classes.delete(className);
                },
            },
        },
    };
};

describe("mobile sidebar touch gesture", () => {
    it("opens the sidebar opposite the finger movement", () => {
        assert.equal(getOpeningSidebar("toRight"), "left");
        assert.equal(getOpeningSidebar("toLeft"), "right");
    });

    it("only starts an open sidebar drag toward its outer edge", () => {
        assert.equal(getSidebarClosingDirection("left"), "toLeft");
        assert.equal(getSidebarClosingDirection("right"), "toRight");
        assert.equal(shouldDragOpenSidebar("left", "toLeft"), true);
        assert.equal(shouldDragOpenSidebar("left", "toRight"), false);
        assert.equal(shouldDragOpenSidebar("right", "toRight"), true);
        assert.equal(shouldDragOpenSidebar("right", "toLeft"), false);
    });

    it("closes the global menu only for an unreversed swipe to the right", () => {
        assert.equal(shouldCloseGlobalMenu("toRight", false), true);
        assert.equal(shouldCloseGlobalMenu("toRight", true), false);
        assert.equal(shouldCloseGlobalMenu("toLeft", false), false);
    });

    it("mirrors and clamps closing transforms", () => {
        assert.equal(getSidebarClosingOffset("left", 120, 300), -120);
        assert.equal(getSidebarClosingOffset("left", -120, 300), 0);
        assert.equal(getSidebarClosingOffset("left", 400, 300), -300);
        assert.equal(getSidebarClosingOffset("right", -120, 300), 120);
        assert.equal(getSidebarClosingOffset("right", 120, 300), 0);
        assert.equal(getSidebarClosingOffset("right", -400, 300), 300);
    });

    it("mirrors and clamps opening transforms", () => {
        assert.equal(getSidebarOpeningOffset("left", -120, 300), -180);
        assert.equal(getSidebarOpeningOffset("left", 20, 300), -300);
        assert.equal(getSidebarOpeningOffset("left", -400, 300), 0);
        assert.equal(getSidebarOpeningOffset("right", 120, 300), 180);
        assert.equal(getSidebarOpeningOffset("right", -20, 300), 300);
        assert.equal(getSidebarOpeningOffset("right", 400, 300), 0);
    });

    it("uses a sidebar-specific activation dead zone", () => {
        assert.equal(getTouchAxis(11, 0, MOBILE_SIDEBAR_SWIPE_ACTIVATION_DISTANCE), undefined);
        assert.equal(getTouchAxis(12, 0, MOBILE_SIDEBAR_SWIPE_ACTIVATION_DISTANCE), "x");
    });

    it("ignores short or slow sidebar swipes", () => {
        assert.equal(shouldCommitSidebarSwipe("toRight", -31, 50, 360), false);
        assert.equal(shouldCommitSidebarSwipe("toLeft", 31, 50, 360), false);
        assert.equal(shouldCommitSidebarSwipe("toRight", -32, 200, 360), false);
        assert.equal(shouldCommitSidebarSwipe("toLeft", 32, 200, 360), false);
    });

    it("commits fast sidebar flicks in either direction", () => {
        assert.equal(shouldCommitSidebarSwipe("toRight", -32, 100, 360), true);
        assert.equal(shouldCommitSidebarSwipe("toLeft", 32, 100, 360), true);
    });

    it("commits long drags and rejects movement opposite to the locked direction", () => {
        assert.equal(shouldCommitSidebarSwipe("toRight", -120, 1000, 360), true);
        assert.equal(shouldCommitSidebarSwipe("toLeft", 120, 1000, 360), true);
        assert.equal(shouldCommitSidebarSwipe("toRight", 120, 100, 360), false);
        assert.equal(shouldCommitSidebarSwipe("toLeft", -120, 100, 360), false);
    });

    it("keeps only the active sidebar in the swiping state", () => {
        const left = createClassTarget();
        const right = createClassTarget();
        const mask = createClassTarget();
        const sidebars = {left: left.target, right: right.target};

        setSidebarSwipeState(sidebars, mask.target, "left");
        assert.equal(left.classes.has(MOBILE_SIDEBAR_SWIPING_CLASS), true);
        assert.equal(right.classes.has(MOBILE_SIDEBAR_SWIPING_CLASS), false);
        assert.equal(mask.classes.has(MOBILE_SIDEBAR_MASK_SWIPING_CLASS), true);

        setSidebarSwipeState(sidebars, mask.target, "right");
        assert.equal(left.classes.has(MOBILE_SIDEBAR_SWIPING_CLASS), false);
        assert.equal(right.classes.has(MOBILE_SIDEBAR_SWIPING_CLASS), true);
        assert.equal(mask.classes.has(MOBILE_SIDEBAR_MASK_SWIPING_CLASS), true);
    });

    it("clears the swiping state when a gesture finishes", () => {
        const left = createClassTarget();
        const right = createClassTarget();
        const mask = createClassTarget();
        const sidebars = {left: left.target, right: right.target};

        setSidebarSwipeState(sidebars, mask.target, "left");
        setSidebarSwipeState(sidebars, mask.target);
        assert.equal(left.classes.has(MOBILE_SIDEBAR_SWIPING_CLASS), false);
        assert.equal(right.classes.has(MOBILE_SIDEBAR_SWIPING_CLASS), false);
        assert.equal(mask.classes.has(MOBILE_SIDEBAR_MASK_SWIPING_CLASS), false);
    });
});