fix navigation flow

This commit is contained in:
2026-08-07 00:28:24 -04:00
parent 9e7a44309a
commit c8d29ed59d
14 changed files with 924 additions and 484 deletions

View File

@@ -1,12 +1,20 @@
/**
* nav-model.test.ts — yazi remake task 01 unit/integration tests.
* nav-model.test.ts — yazi remake task 01/07 unit/integration tests.
*
* Covers the removal of the SIDEBAR_PANE concept:
* Covers the tab-list-as-root navigation model:
* • createNavigation() exposes the nav factory directly (no Solid render
* needed), wrapped in a createRoot so effects register/dispose.
* • focus starts on the tab list — the app root. `atRootTab()` is true while
* the tab list is the CURRENT pane (nothing above it). `enterTabContent()`
* slides the tab into UP and puts focus on the content; `backToTabRoot()`
* returns to the root. Only depth-tabs participate (`atRootTab()` is false
* for the fixed-pane Search/Player tabs).
* • the root tab list is a normal list: `tabCursor` is independent of
* `activeTab`; moveTabCursor moves it (clamped), activateTabCursor opens
* the hovered tab + enters content, and direct tab switches re-sync it.
* • depth-tab focusedIndex depth-current read/writes the top frame's focus.
* • the tab-switch effect resets activePane to DEPTH_CENTER_PANE (0), not -1.
* • swipe() clamps to [0, paneCount-1] (no -1 sidebar slot).
* • swipe() is clamped to [1, paneCount] (content panes only; there is no
* pane-0 tab slot — the tab root is a flag, not a pane).
*/
import { test, expect } from "bun:test";
import { createRoot } from "solid-js";
@@ -27,17 +35,18 @@ function withNav(fn: (nav: ReturnType<typeof createNavigation>) => void) {
});
}
test("createNavigation initial activePane is DEPTH_CENTER_PANE (0), not -1", () => {
test("createNavigation starts on the tab root (atRootTab true)", () => {
withNav((nav) => {
expect(nav.atRootTab()).toBe(true);
expect(nav.activeTab()).toBe(TABS.FEED);
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
expect(nav.activePane()).toBe(0);
});
});
// ── depth-tab focus: reads/writes the top frame's focus ───────────────────────
test("depth-tab focusedIndex(DEPTH_CENTER_PANE) returns top frame's focus", () => {
withNav((nav) => {
// FEED is a depth-tab; its root frame is { kind: "feeds", focus: 0 }.
// FeeD is a depth-tab; its root frame is a the top frame on the stack.
nav.setActiveTab(TABS.FEED);
expect(nav.isDepthTab()).toBe(true);
expect(nav.focusedIndex(DEPTH_CENTER_PANE)).toBe(0);
@@ -52,6 +61,7 @@ test("depth-tab focusedIndex(DEPTH_CENTER_PANE) returns top frame's focus", () =
test("setFocusedIndex on a 2-frame stack writes only the top frame", () => {
withNav((nav) => {
nav.setActiveTab(TABS.FEED);
nav.enterTabContent();
// root frame focus 3, then push a child frame whose focus is 5.
nav.setFocusedIndex(DEPTH_CENTER_PANE, 3);
nav.pushDepth({ kind: "episodes:feedId", ctx: "f1", focus: 5 });
@@ -79,19 +89,120 @@ test("popDepth at depth 0 is a noop (returns false, no frame lost)", () => {
});
});
// ── tab-switch resets focus to DEPTH_CENTER_PANE, not a sidebar ──────────────
test("tab-switch effect resets activePane to DEPTH_CENTER_PANE", () => {
// ── tab switching keeps focus context ────────────────────────────────────────
test("tab switch keeps focus context: at the root it stays at the root", () => {
withNav((nav) => {
// start on a depth-tab, land on the current pane.
// focus starts on the tab root.
expect(nav.atRootTab()).toBe(true);
// switching depth-tabs from the root must not drop focus into content.
nav.setActiveTab(TABS.FEED);
expect(nav.atRootTab()).toBe(true);
expect(nav.activeTab()).toBe(TABS.FEED);
nav.setActiveTab(TABS.MYSHOWS);
expect(nav.atRootTab()).toBe(true);
});
});
test("tab switch keeps focus context: in content it stays in content", () => {
withNav((nav) => {
nav.enterTabContent();
expect(nav.atRootTab()).toBe(false);
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
// move pane focus away (swipe is a noop for depth-tabs count=1, so
// instead prove the effect resets on tab change).
nav.setActiveTab(TABS.SEARCH);
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
// switch to another tab; the effect must reset to 0, never -1.
// switching tabs from content keeps the content context.
nav.setActiveTab(TABS.SETTINGS);
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
expect(nav.activePane()).toBeGreaterThanOrEqual(0);
expect(nav.atRootTab()).toBe(false);
});
});
test("switching to a Search/Player tab leaves the root (special content)", () => {
withNav((nav) => {
// at root, opening Search is special: atRootTab() reports false because
// Search has its own content and never renders the tab-list root view.
nav.setActiveTab(TABS.SEARCH);
expect(nav.atRootTab()).toBe(false);
nav.enterTabContent();
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
expect(nav.atRootTab()).toBe(false);
});
});
// ── tab root <-> content transitions ─────────────────────────────────────────
test("enterTabContent/backToTabRoot round-trip between root and content", () => {
withNav((nav) => {
nav.setActiveTab(TABS.FEED);
expect(nav.atRootTab()).toBe(true);
nav.enterTabContent();
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
expect(nav.atRootTab()).toBe(false);
nav.backToTabRoot();
expect(nav.atRootTab()).toBe(true);
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
});
});
test("enterTabContent preserves the active tab's depth", () => {
withNav((nav) => {
nav.setActiveTab(TABS.FEED);
nav.pushDepth({ kind: "episodes:feedId", ctx: "f1", focus: 0 });
expect(nav.currentDepth()).toBe(1);
// moving between the root and content never touches the depth stack.
nav.backToTabRoot();
nav.enterTabContent();
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
expect(nav.currentDepth()).toBe(1);
expect(nav.popDepth()).toBe(true);
expect(nav.currentDepth()).toBe(0);
});
});
test("tabCursor starts on the active tab", () => {
withNav((nav) => {
expect(nav.tabCursor()).toBe(TABS.FEED);
expect(nav.activeTab()).toBe(TABS.FEED);
});
});
test("moveTabCursor moves the cursor without changing the active tab, clamped at the ends", () => {
withNav((nav) => {
nav.setActiveTab(TABS.MYSHOWS); // cursor syncs to the active tab
expect(nav.tabCursor()).toBe(TABS.MYSHOWS);
nav.moveTabCursor(1);
expect(nav.tabCursor()).toBe(TABS.DISCOVER);
expect(nav.activeTab()).toBe(TABS.MYSHOWS); // active tab untouched
nav.moveTabCursor(-1);
expect(nav.tabCursor()).toBe(TABS.MYSHOWS);
// clamp: from FEED, up stays FEED; from SETTINGS, down stays SETTINGS.
nav.moveTabCursor(-1); // MYSHOWS -> FEED
nav.moveTabCursor(-1); // FEED -> FEED (clamped)
expect(nav.tabCursor()).toBe(TABS.FEED);
nav.setActiveTab(TABS.SETTINGS);
nav.moveTabCursor(1); // SETTINGS -> SETTINGS (clamped)
expect(nav.tabCursor()).toBe(TABS.SETTINGS);
expect(nav.activeTab()).toBe(TABS.SETTINGS);
});
});
test("activateTabCursor switches to the hovered tab and enters its content", () => {
withNav((nav) => {
nav.moveTabCursor(1); // cursor -> MYSHOWS
nav.moveTabCursor(1); // cursor -> DISCOVER
expect(nav.tabCursor()).toBe(TABS.DISCOVER);
expect(nav.activeTab()).toBe(TABS.FEED);
nav.activateTabCursor();
expect(nav.activeTab()).toBe(TABS.DISCOVER); // hovered tab opened
expect(nav.tabCursor()).toBe(TABS.DISCOVER);
expect(nav.atRootTab()).toBe(false);
expect(nav.activePane()).toBe(DEPTH_CENTER_PANE);
});
});
test("direct tab switches re-sync the tab cursor", () => {
withNav((nav) => {
nav.moveTabCursor(1); // cursor -> MYSHOWS
expect(nav.activeTab()).toBe(TABS.FEED);
nav.setActiveTab(TABS.SETTINGS);
expect(nav.tabCursor()).toBe(TABS.SETTINGS);
});
});
@@ -105,37 +216,44 @@ test("tab-switch resets mode/visual/command state", () => {
});
});
// ── swipe clamps to [0, paneCount-1] (no sidebar slot) ────────────────────────
test("swipe(-1, 3) on a fixed-pane tab clamps to 0, not -1", () => {
// ── swipe clamps to [1, paneCount] (no pane-0 tab slot) ──────────────────────
test("swipe on a fixed-pane tab stays within [1, paneCount]", () => {
withNav((nav) => {
nav.setActiveTab(TABS.SEARCH); // fixed-pane, TabPaneCount = 3
expect(TabPaneCount[TABS.SEARCH]).toBe(3);
// tab-switch effect lands us on pane 0 (DEPTH_CENTER_PANE).
expect(nav.activePane()).toBe(0);
nav.swipe(-1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(0); // lower bound, never -1
// swipe right twice then back: clamps to [0, 2].
nav.swipe(1, 3);
nav.swipe(1, 3);
expect(nav.activePane()).toBe(2); // upper bound
nav.swipe(1, 3);
expect(nav.activePane()).toBe(2); // never exceeds count-1
nav.swipe(-1, 3);
nav.enterTabContent();
expect(nav.activePane()).toBe(1);
// swipe left stays at 1 (no pane 0).
nav.swipe(-1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(1);
nav.swipe(-1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(1);
// swipe right up through the columns, then hold the upper bound.
nav.swipe(1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(2);
nav.swipe(1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(3);
nav.swipe(1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(3); // never exceeds paneCount
nav.swipe(-1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(2);
nav.swipe(-1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(1);
nav.swipe(-1, TabPaneCount[TABS.SEARCH]);
expect(nav.activePane()).toBe(1);
nav.swipe(-1, 3);
expect(nav.activePane()).toBe(0);
});
});
test("swipe on a single-pane fixed tab stays at 0", () => {
test("swipe on a single-pane fixed tab stays at its one content pane", () => {
withNav((nav) => {
nav.setActiveTab(TABS.PLAYER); // single-pane
expect(TabPaneCount[TABS.PLAYER]).toBe(1);
expect(nav.activePane()).toBe(0);
nav.enterTabContent(); // lands on its one content pane (1)
expect(nav.activePane()).toBe(1);
nav.swipe(1, TabPaneCount[TABS.PLAYER]);
expect(nav.activePane()).toBe(0);
expect(nav.activePane()).toBe(1); // upper bound
nav.swipe(-1, TabPaneCount[TABS.PLAYER]);
expect(nav.activePane()).toBe(0);
expect(nav.activePane()).toBe(1); // lower bound — never drops to a tab 0
});
});