From 607f07939462a7c511aca2e3215139218254e06f Mon Sep 17 00:00:00 2001 From: spotkorner-dot Date: Sun, 30 Aug 2026 21:31:33 +0100 Subject: [PATCH 1/5] feat(frontend): add command palette for quick navigation (#298) --- docs/components.md | 33 ++++ e2e/command-palette.spec.ts | 30 ++++ src/app/layout.tsx | 2 + src/components/CommandPalette.test.tsx | 121 ++++++++++++++ src/components/CommandPalette.tsx | 216 +++++++++++++++++++++++++ 5 files changed, 402 insertions(+) create mode 100644 e2e/command-palette.spec.ts create mode 100644 src/components/CommandPalette.test.tsx create mode 100644 src/components/CommandPalette.tsx diff --git a/docs/components.md b/docs/components.md index 506beca..a39974a 100644 --- a/docs/components.md +++ b/docs/components.md @@ -77,3 +77,36 @@ import { ConnectWalletButton } from "@/components/ConnectWalletButton"; - On a failed `connect()` call, it also pushes an error toast via [`useToastStore`](../src/store/toast.ts) — you don't need to handle connection errors yourself when using this component. + +## `CommandPalette` + +[`src/components/CommandPalette.tsx`](../src/components/CommandPalette.tsx) + +Global `Cmd/Ctrl+K` command palette for keyboard-driven navigation. Mounted once +in [`src/app/layout.tsx`](../src/app/layout.tsx) so the shortcut works on every +route — you do not render it yourself. + +```tsx +import { CommandPalette } from "@/components/CommandPalette"; + + +``` + +**Props** + +None. State (open/closed, query, active option) is entirely internal. + +**Behavior** + +- `Cmd/Ctrl+K` toggles the palette open/closed from anywhere. `Escape` or a + click on the backdrop closes it. +- Lists the four top-level routes (`/`, `/explore`, `/solve`, `/my-intents`), + filtered by the typed query against each route's label/path. +- If the query is a valid Stellar public key it offers a direct jump to + `/solve/[address]`; otherwise a whitespace-free token that matches no route is + offered as an `/explore/[id]` lookup. +- Fully keyboard-operable: `ArrowUp`/`ArrowDown` move the active option (wrapping), + `Enter` activates it, following the WAI-ARIA combobox/listbox pattern + (`role="combobox"` input + `role="listbox"` with `aria-activedescendant`). +- On activate it calls `router.push(href)` and restores focus to the element that + was focused before the palette opened. diff --git a/e2e/command-palette.spec.ts b/e2e/command-palette.spec.ts new file mode 100644 index 0000000..349aa7f --- /dev/null +++ b/e2e/command-palette.spec.ts @@ -0,0 +1,30 @@ +import { test, expect } from "@playwright/test"; + +// Exercises the Cmd/Ctrl+K command palette end to end: open with the shortcut, +// filter, and navigate. No wallet or backend is needed - the palette is static +// navigation only. +test("command palette: open with the shortcut and jump to a route", async ({ page }) => { + await page.goto("/"); + + // Ctrl+K works cross-platform in Chromium; Meta+K is the macOS equivalent. + await page.keyboard.press("Control+K"); + + const palette = page.getByRole("dialog", { name: "Command palette" }); + await expect(palette).toBeVisible(); + + await page.getByRole("combobox").fill("explore"); + await page.getByRole("option", { name: /Explore intents/ }).click(); + + await expect(page).toHaveURL(/\/explore$/); + await expect(palette).toBeHidden(); +}); + +test("command palette: paste an intent id to open its detail page", async ({ page }) => { + await page.goto("/"); + await page.keyboard.press("Control+K"); + + await page.getByRole("combobox").fill("intent-1"); + await page.getByRole("option", { name: /Open intent/ }).click(); + + await expect(page).toHaveURL(/\/explore\/intent-1$/); +}); diff --git a/src/app/layout.tsx b/src/app/layout.tsx index 543ea82..67791b6 100644 --- a/src/app/layout.tsx +++ b/src/app/layout.tsx @@ -2,6 +2,7 @@ import type { Metadata, Viewport } from "next"; import "./globals.css"; import { WalletHydrator } from "@/components/WalletHydrator"; import { ToastViewport } from "@/components/ToastViewport"; +import { CommandPalette } from "@/components/CommandPalette"; import { I18nProvider } from "@/lib/i18n/I18nProvider"; import { DEFAULT_LOCALE } from "@/lib/i18n"; @@ -94,6 +95,7 @@ export default function RootLayout({ children }: { children: React.ReactNode }) {children} + diff --git a/src/components/CommandPalette.test.tsx b/src/components/CommandPalette.test.tsx new file mode 100644 index 0000000..9239969 --- /dev/null +++ b/src/components/CommandPalette.test.tsx @@ -0,0 +1,121 @@ +import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; +import { fireEvent, render, screen } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; + +const { pushMock } = vi.hoisted(() => ({ pushMock: vi.fn() })); +vi.mock("next/navigation", () => ({ useRouter: () => ({ push: pushMock }) })); + +import { CommandPalette } from "./CommandPalette"; + +// A well-formed Stellar Ed25519 public key (checksum valid). +const VALID_ADDRESS = "GDW4UXK66PDDK4CDDUJGNPFZHBZDWAJNNUE5ZEQYN5S3DISNGXZIVAIV"; + +function openPalette() { + fireEvent.keyDown(window, { key: "k", metaKey: true }); +} + +describe("CommandPalette", () => { + beforeEach(() => { + pushMock.mockReset(); + }); + + afterEach(() => { + // Ensure a lingering open palette from one test can't leak into the next. + fireEvent.keyDown(window, { key: "Escape" }); + }); + + it("is closed until the Cmd/Ctrl+K shortcut is pressed", () => { + render(); + expect(screen.queryByRole("dialog")).not.toBeInTheDocument(); + + openPalette(); + expect(screen.getByRole("dialog", { name: "Command palette" })).toBeInTheDocument(); + }); + + it("toggles closed on a second shortcut press and on Escape", () => { + render(); + + openPalette(); + expect(screen.getByRole("dialog")).toBeInTheDocument(); + + fireEvent.keyDown(window, { key: "k", ctrlKey: true }); + expect(screen.queryByRole("dialog")).not.toBeInTheDocument(); + + openPalette(); + fireEvent.keyDown(screen.getByRole("combobox"), { key: "Escape" }); + expect(screen.queryByRole("dialog")).not.toBeInTheDocument(); + }); + + it("lists the four top-level routes by default", () => { + render(); + openPalette(); + + const options = screen.getAllByRole("option"); + expect(options.map((o) => o.textContent)).toEqual([ + expect.stringContaining("Swap"), + expect.stringContaining("Explore intents"), + expect.stringContaining("Become a solver"), + expect.stringContaining("My Intents"), + ]); + }); + + it("filters routes by the typed query", async () => { + const user = userEvent.setup(); + render(); + openPalette(); + + await user.type(screen.getByRole("combobox"), "solver"); + const options = screen.getAllByRole("option"); + expect(options).toHaveLength(1); + expect(options[0]).toHaveTextContent("Become a solver"); + }); + + it("moves the active option with the arrow keys and activates it with Enter", async () => { + render(); + openPalette(); + + const combobox = screen.getByRole("combobox"); + expect(screen.getAllByRole("option")[0]).toHaveAttribute("aria-selected", "true"); + + fireEvent.keyDown(combobox, { key: "ArrowDown" }); + const options = screen.getAllByRole("option"); + expect(options[0]).toHaveAttribute("aria-selected", "false"); + expect(options[1]).toHaveAttribute("aria-selected", "true"); + + fireEvent.keyDown(combobox, { key: "Enter" }); + expect(pushMock).toHaveBeenCalledWith("/explore"); + }); + + it("navigates directly to a solver page when a valid address is entered", async () => { + const user = userEvent.setup(); + render(); + openPalette(); + + await user.type(screen.getByRole("combobox"), VALID_ADDRESS); + const lookup = screen.getByRole("option", { name: /Go to solver/ }); + await user.click(lookup); + + expect(pushMock).toHaveBeenCalledWith(`/solve/${VALID_ADDRESS}`); + }); + + it("treats a non-address token as an intent id lookup", async () => { + const user = userEvent.setup(); + render(); + openPalette(); + + await user.type(screen.getByRole("combobox"), "intent-42"); + const lookup = screen.getByRole("option", { name: /Open intent/ }); + await user.click(lookup); + + expect(pushMock).toHaveBeenCalledWith("/explore/intent-42"); + }); + + it("closes and restores focus after activating a command", async () => { + render(); + openPalette(); + + fireEvent.keyDown(screen.getByRole("combobox"), { key: "Enter" }); + expect(screen.queryByRole("dialog")).not.toBeInTheDocument(); + expect(pushMock).toHaveBeenCalledWith("/"); + }); +}); diff --git a/src/components/CommandPalette.tsx b/src/components/CommandPalette.tsx new file mode 100644 index 0000000..7c96795 --- /dev/null +++ b/src/components/CommandPalette.tsx @@ -0,0 +1,216 @@ +"use client"; + +import { useCallback, useEffect, useMemo, useRef, useState } from "react"; +import { useRouter } from "next/navigation"; +import { isValidStellarPublicKey } from "@/lib/stellarAddress"; + +// === Static navigation targets +// The four top-level routes the palette can jump to. Keeping this list here +// (rather than deriving it from Nav) keeps the palette self-contained and +// avoids importing Nav's wallet/i18n dependencies into the global layout. +type Command = { + id: string; + label: string; + hint: string; + href: string; +}; + +const ROUTE_COMMANDS: Command[] = [ + { id: "route-home", label: "Swap", hint: "Home", href: "/" }, + { id: "route-explore", label: "Explore intents", hint: "/explore", href: "/explore" }, + { id: "route-solve", label: "Become a solver", hint: "/solve", href: "/solve" }, + { id: "route-my-intents", label: "My Intents", hint: "/my-intents", href: "/my-intents" }, +]; + +// An intent id in this app is an opaque short string; treat any whitespace-free +// token of a few characters as a candidate for a direct /explore/[id] jump. +const MIN_ID_LENGTH = 3; + +function truncateMiddle(value: string): string { + return value.length <= 14 ? value : `${value.slice(0, 6)}…${value.slice(-6)}`; +} + +function buildCommands(query: string): Command[] { + const trimmed = query.trim(); + const lower = trimmed.toLowerCase(); + + const routes = ROUTE_COMMANDS.filter( + (command) => + lower.length === 0 || + command.label.toLowerCase().includes(lower) || + command.hint.toLowerCase().includes(lower), + ); + + if (trimmed.length === 0) return routes; + + const lookups: Command[] = []; + if (isValidStellarPublicKey(trimmed)) { + lookups.push({ + id: "lookup-solver", + label: `Go to solver ${truncateMiddle(trimmed)}`, + hint: "Solver", + href: `/solve/${trimmed}`, + }); + } else if ( + routes.length === 0 && + !trimmed.includes(" ") && + trimmed.length >= MIN_ID_LENGTH + ) { + // Only offer a direct intent-id jump when the query matches no route - + // otherwise a plain search term like "solve" would sprout a bogus + // "Open intent solve" row alongside the real route match. + lookups.push({ + id: "lookup-intent", + label: `Open intent ${truncateMiddle(trimmed)}`, + hint: "Intent", + href: `/explore/${trimmed}`, + }); + } + + return [...lookups, ...routes]; +} + +export function CommandPalette() { + const router = useRouter(); + const [open, setOpen] = useState(false); + const [query, setQuery] = useState(""); + const [activeIndex, setActiveIndex] = useState(0); + + const inputRef = useRef(null); + const listRef = useRef(null); + // The element focused before the palette opened, so focus can be restored on close. + const restoreFocusRef = useRef(null); + + const commands = useMemo(() => buildCommands(query), [query]); + + const close = useCallback(() => { + setOpen(false); + setQuery(""); + setActiveIndex(0); + }, []); + + const runCommand = useCallback( + (command: Command | undefined) => { + if (!command) return; + close(); + router.push(command.href); + }, + [close, router], + ); + + // === Global Cmd/Ctrl+K listener + useEffect(() => { + const onKeyDown = (event: KeyboardEvent) => { + if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "k") { + event.preventDefault(); + setOpen((current) => !current); + } + }; + window.addEventListener("keydown", onKeyDown); + return () => window.removeEventListener("keydown", onKeyDown); + }, []); + + // === Focus management + useEffect(() => { + if (open) { + restoreFocusRef.current = document.activeElement as HTMLElement | null; + inputRef.current?.focus(); + } else { + restoreFocusRef.current?.focus?.(); + } + }, [open]); + + // Keep the active option from drifting past the (query-dependent) list length. + useEffect(() => { + setActiveIndex((current) => Math.min(current, Math.max(0, commands.length - 1))); + }, [commands.length]); + + if (!open) return null; + + const activeOptionId = commands[activeIndex]?.id; + + const onListNavKeyDown = (event: React.KeyboardEvent) => { + if (event.key === "ArrowDown") { + event.preventDefault(); + setActiveIndex((current) => (commands.length === 0 ? 0 : (current + 1) % commands.length)); + } else if (event.key === "ArrowUp") { + event.preventDefault(); + setActiveIndex((current) => + commands.length === 0 ? 0 : (current - 1 + commands.length) % commands.length, + ); + } else if (event.key === "Enter") { + event.preventDefault(); + runCommand(commands[activeIndex]); + } else if (event.key === "Escape") { + event.preventDefault(); + close(); + } + }; + + return ( +
{ + if (event.target === event.currentTarget) close(); + }} + > +
+ { + setQuery(event.target.value); + setActiveIndex(0); + }} + onKeyDown={onListNavKeyDown} + className="w-full border-b border-vx-line bg-transparent px-4 py-3 text-sm text-vx-text + placeholder-vx-dim/60 focus:outline-none" + /> + +
    + {commands.length === 0 ? ( +
  • + No matches +
    • + ) : ( + commands.map((command, index) => ( +
  • setActiveIndex(index)} + onClick={() => runCommand(command)} + className={`flex cursor-pointer items-center justify-between gap-3 px-4 py-2.5 text-sm transition-colors ${ + index === activeIndex ? "bg-vx-sage-bg text-vx-sage" : "text-vx-text" + }`} + > + {command.label} + {command.hint} +
    • + )) + )} +
+
+
+ ); +} + From ba0b82aa01e2885bb4e62de1539f5963e9fc918f Mon Sep 17 00:00:00 2001 From: spotkorner-dot Date: Sun, 30 Aug 2026 21:40:02 +0100 Subject: [PATCH 2/5] feat(frontend): keep relative timestamps current in live views (#299) --- src/app/explore/ExplorePageClient.test.tsx | 55 ++++++++++++++ src/app/explore/ExplorePageClient.tsx | 4 +- src/app/my-intents/page.test.tsx | 17 +++++ src/app/my-intents/page.tsx | 22 ++++-- src/components/ActivityFeed.tsx | 86 +++++++++++++++++----- src/hooks/useLiveRelativeTime.test.ts | 75 +++++++++++++++++++ src/hooks/useLiveRelativeTime.ts | 56 ++++++++++++++ 7 files changed, 286 insertions(+), 29 deletions(-) create mode 100644 src/app/explore/ExplorePageClient.test.tsx create mode 100644 src/hooks/useLiveRelativeTime.test.ts create mode 100644 src/hooks/useLiveRelativeTime.ts diff --git a/src/app/explore/ExplorePageClient.test.tsx b/src/app/explore/ExplorePageClient.test.tsx new file mode 100644 index 0000000..15ce1f6 --- /dev/null +++ b/src/app/explore/ExplorePageClient.test.tsx @@ -0,0 +1,55 @@ +import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; +import { act, render, screen } from "@testing-library/react"; +import type { FeedItem } from "@/lib/types"; + +const { useLiveIntentsMock } = vi.hoisted(() => ({ useLiveIntentsMock: vi.fn() })); +vi.mock("@/hooks/useLiveIntents", () => ({ useLiveIntents: useLiveIntentsMock })); +// Nav/Footer pull in wallet + i18n context this suite does not set up. +vi.mock("@/components/Nav", () => ({ Nav: () => null })); +vi.mock("@/components/Footer", () => ({ Footer: () => null })); + +import ExplorePageClient from "./ExplorePageClient"; + +const intents: FeedItem[] = [ + { + id: "1", + srcChain: "ethereum", + srcToken: "USDC", + srcAmount: "500", + dstToken: "USDC", + solver: "Alpha", + status: "filled", + createdAt: new Date("2026-07-14T00:00:00Z").toISOString(), + }, +]; + +describe("ExplorePageClient", () => { + beforeEach(() => { + vi.useFakeTimers({ shouldAdvanceTime: true }); + vi.setSystemTime(new Date("2026-07-14T00:00:30Z")); + useLiveIntentsMock.mockReturnValue({ intents, isLoading: false, error: undefined, isLive: true }); + }); + + afterEach(() => { + vi.useRealTimers(); + }); + + it("renders an intent row with a relative timestamp", () => { + render(); + expect(screen.getByText("500 USDC → USDC")).toBeInTheDocument(); + expect(screen.getByText("30s ago")).toBeInTheDocument(); + }); + + it("advances the relative timestamp on its own as time passes", () => { + render(); + expect(screen.getByText("30s ago")).toBeInTheDocument(); + + act(() => { + vi.setSystemTime(new Date("2026-07-14T00:02:00Z")); + vi.advanceTimersByTime(45_000); + }); + + expect(screen.getByText("2m ago")).toBeInTheDocument(); + expect(screen.queryByText("30s ago")).not.toBeInTheDocument(); + }); +}); diff --git a/src/app/explore/ExplorePageClient.tsx b/src/app/explore/ExplorePageClient.tsx index 10af3f1..e544143 100644 --- a/src/app/explore/ExplorePageClient.tsx +++ b/src/app/explore/ExplorePageClient.tsx @@ -7,6 +7,7 @@ import { Footer } from "@/components/Footer"; import { IntentStatusBadge } from "@/components/IntentStatusBadge"; import { SkeletonCard } from "@/components/Skeleton"; import { useLiveIntents } from "@/hooks/useLiveIntents"; +import { useLiveRelativeTime } from "@/hooks/useLiveRelativeTime"; import { timeAgo } from "@/lib/time"; import { CHAINS } from "@/lib/marketData"; import type { IntentStatus } from "@/lib/types"; @@ -18,6 +19,7 @@ const PAGE_SIZE = 10; export default function ExplorePageClient() { const { intents, isLoading, error, isLive } = useLiveIntents(); + const now = useLiveRelativeTime(); const [statusFilter, setStatusFilter] = useState("all"); const [chainFilter, setChainFilter] = useState("all"); const [sort, setSort] = useState("newest"); @@ -150,7 +152,7 @@ export default function ExplorePageClient() { - {timeAgo(item.createdAt)} + {timeAgo(item.createdAt, now)} ))} diff --git a/src/app/my-intents/page.test.tsx b/src/app/my-intents/page.test.tsx index d8b1438..c1780ac 100644 --- a/src/app/my-intents/page.test.tsx +++ b/src/app/my-intents/page.test.tsx @@ -11,6 +11,13 @@ const { useWalletStoreMock, useMyLiveIntentsMock } = vi.hoisted(() => ({ vi.mock("@/store/wallet", () => ({ useWalletStore: useWalletStoreMock })); vi.mock("@/store/toast", () => ({ useToastStore: vi.fn(() => ({ addToast: vi.fn() })) })); vi.mock("@/hooks/useMyLiveIntents", () => ({ useMyLiveIntents: useMyLiveIntentsMock })); +// Nav/Footer are unrelated chrome here and pull in wallet/i18n context this +// suite does not set up - stub them so the page's own content is what's tested. +vi.mock("@/components/Nav", () => ({ Nav: () => null })); +vi.mock("@/components/Footer", () => ({ Footer: () => null })); +vi.mock("@/components/ConnectWalletButton", () => ({ + ConnectWalletButton: () => , +})); import MyIntentsPage from "./page"; @@ -186,6 +193,16 @@ describe("MyIntentsPage", () => { expect(screen.getByRole("link", { name: /make your first swap/i })).toHaveAttribute("href", "/"); }); + it("shows a relative 'submitted ... ago' timestamp on each row", () => { + mockWallet({ address: "GABC123", isConnected: true }); + const recent: FeedItem[] = [ + { ...intents[0]!, id: "9", createdAt: new Date(Date.now() - 90_000).toISOString() }, + ]; + useMyLiveIntentsMock.mockReturnValue({ intents: recent, isLoading: false, error: undefined }); + render(); + expect(screen.getByText(/submitted 1m ago/)).toBeInTheDocument(); + }); + it("links each intent row to the intent detail page", () => { mockWallet({ address: "GABC123", isConnected: true }); useMyLiveIntentsMock.mockReturnValue({ intents, isLoading: false, error: undefined }); diff --git a/src/app/my-intents/page.tsx b/src/app/my-intents/page.tsx index 41f9c75..2e2b258 100644 --- a/src/app/my-intents/page.tsx +++ b/src/app/my-intents/page.tsx @@ -8,8 +8,10 @@ import { IntentStatusBadge } from "@/components/IntentStatusBadge"; import { ConnectWalletButton } from "@/components/ConnectWalletButton"; import { useWalletStore } from "@/store/wallet"; import { useMyLiveIntents } from "@/hooks/useMyLiveIntents"; +import { useLiveRelativeTime } from "@/hooks/useLiveRelativeTime"; import { CHAINS } from "@/lib/marketData"; -import { SkeletonCard } from "@/components/Skeleton"; +import { buildIntentsCsv, downloadCsv } from "@/lib/csv"; +import { timeAgo } from "@/lib/time"; import type { IntentStatus } from "@/lib/types"; const STATUS_OPTIONS: Array = ["all", "pending", "accepted", "filled", "failed"]; @@ -20,6 +22,7 @@ export default function MyIntentsPage() { const isConnected = useWalletStore((s) => s.isConnected); const { intents, isLoading, error, isLive } = useMyLiveIntents(address); + const now = useLiveRelativeTime(); const [statusFilter, setStatusFilter] = useState("all"); const [chainFilter, setChainFilter] = useState("all"); @@ -87,7 +90,6 @@ export default function MyIntentsPage() { value={statusFilter} onChange={(e) => setStatusFilter(e.target.value as IntentStatus | "all")} className="bg-vx-surface border border-vx-border rounded-lg px-3 py-2 text-sm text-vx-text" - aria-label="Filter intents by status" > {STATUS_OPTIONS.map((s) => ( {CHAINS.map((c) => ( @@ -129,10 +130,13 @@ export default function MyIntentsPage() { {/* List */} {isLoading ? ( -
- {[0, 1, 2, 3].map((i) => ( -
- ))} +
+ Loading your intents... + ) : error ? (
@@ -167,7 +171,9 @@ export default function MyIntentsPage() {
{item.srcChain} · via {item.solver}
- +
+ submitted {timeAgo(item.createdAt, now)} +
diff --git a/src/components/ActivityFeed.tsx b/src/components/ActivityFeed.tsx index 6b18bde..51dfda2 100644 --- a/src/components/ActivityFeed.tsx +++ b/src/components/ActivityFeed.tsx @@ -1,9 +1,9 @@ "use client"; -import { useMemo } from "react"; +import { useEffect, useMemo, useRef, useState } from "react"; import { useIntentFeed } from "@/hooks/useIntentFeed"; +import { useLiveRelativeTime } from "@/hooks/useLiveRelativeTime"; import { timeAgo } from "@/lib/time"; -import type { FeedItem } from "@/lib/types"; const CHAIN_COLOR: Record = { ethereum: "#627EEA", base: "#0052FF", polygon: "#8247E5", @@ -13,34 +13,87 @@ const CHAIN_COLOR: Record = { /** Maximum number of activity items shown in the feed. */ const FEED_LIMIT = 6; +/** How long to wait for a burst of arrivals to settle before announcing them. */ +const ANNOUNCE_DEBOUNCE_MS = 1500; + +function FeedSkeleton({ count = 3 }: { count?: number }) { + return ( +
+ {Array.from({ length: count }).map((_, i) => ( +
+ ))} +
+ ); +} + export function ActivityFeed() { - const { t } = useTranslation(); const { items, isLoading, error, isLive } = useIntentFeed(); + const now = useLiveRelativeTime(); - /** - * Memoized slice of the most recent feed items. - * Avoids recreating the array on every render when `items` reference is stable. - */ const visibleItems = useMemo(() => items.slice(0, FEED_LIMIT), [items]); + // === Debounced live-region announcement for newly arrived fills + const [announcement, setAnnouncement] = useState(""); + const knownIdsRef = useRef | null>(null); + const pendingCountRef = useRef(0); + const announceTimerRef = useRef | null>(null); + + useEffect(() => { + const currentIds = new Set(items.map((item) => item.id)); + + // The first snapshot is the baseline - it is not "new" activity. + if (knownIdsRef.current === null) { + knownIdsRef.current = currentIds; + return; + } + + let arrived = 0; + for (const id of currentIds) { + if (!knownIdsRef.current.has(id)) arrived += 1; + } + knownIdsRef.current = currentIds; + if (arrived === 0) return; + + pendingCountRef.current += arrived; + if (announceTimerRef.current) clearTimeout(announceTimerRef.current); + announceTimerRef.current = setTimeout(() => { + const n = pendingCountRef.current; + pendingCountRef.current = 0; + setAnnouncement(`${n} new fill${n === 1 ? "" : "s"}`); + }, ANNOUNCE_DEBOUNCE_MS); + }, [items]); + + useEffect( + () => () => { + if (announceTimerRef.current) clearTimeout(announceTimerRef.current); + }, + [], + ); + if (isLoading && items.length === 0) { return ; } return (
-
{announcement}
+
+ {announcement} +
{error && items.length === 0 ? (
- {t("activityFeed.error.unavailable")} + Live feed unavailable right now.
) : items.length === 0 ? (
- {t("activityFeed.empty")} + No fills yet.
) : null} {visibleItems.map((item) => { @@ -57,10 +110,7 @@ export function ActivityFeed() { {item.srcAmount} {item.srcToken} → {item.dstToken}
- {t("activityFeed.item.route", { - chain: item.srcChain, - solver: item.solver, - })} + {item.srcChain} · via {item.solver}
@@ -70,7 +120,7 @@ export function ActivityFeed() { title={new Date(item.createdAt).toLocaleString()} tabIndex={0} > - {timeAgo(item.createdAt)} + {timeAgo(item.createdAt, now)}
@@ -79,7 +129,3 @@ export function ActivityFeed() {
); } - -export function ActivityFeed() { - return ; -} diff --git a/src/hooks/useLiveRelativeTime.test.ts b/src/hooks/useLiveRelativeTime.test.ts new file mode 100644 index 0000000..76c547f --- /dev/null +++ b/src/hooks/useLiveRelativeTime.test.ts @@ -0,0 +1,75 @@ +import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; +import { act, renderHook } from "@testing-library/react"; +import { useLiveRelativeTime } from "./useLiveRelativeTime"; + +function setVisibility(state: DocumentVisibilityState) { + Object.defineProperty(document, "visibilityState", { + value: state, + configurable: true, + }); + document.dispatchEvent(new Event("visibilitychange")); +} + +describe("useLiveRelativeTime", () => { + beforeEach(() => { + vi.useFakeTimers(); + setVisibility("visible"); + }); + + afterEach(() => { + vi.useRealTimers(); + setVisibility("visible"); + }); + + it("advances the returned timestamp on each interval tick", () => { + const { result } = renderHook(() => useLiveRelativeTime(1000)); + const initial = result.current; + + act(() => { + vi.advanceTimersByTime(1000); + }); + expect(result.current).toBeGreaterThan(initial); + + const afterOne = result.current; + act(() => { + vi.advanceTimersByTime(1000); + }); + expect(result.current).toBeGreaterThan(afterOne); + }); + + it("pauses ticking while the tab is hidden and resumes when visible again", () => { + const { result } = renderHook(() => useLiveRelativeTime(1000)); + + act(() => setVisibility("hidden")); + const whileHidden = result.current; + act(() => { + vi.advanceTimersByTime(5000); + }); + expect(result.current).toBe(whileHidden); + + act(() => setVisibility("visible")); + // Returning to the tab catches the value up immediately. + expect(result.current).toBeGreaterThanOrEqual(whileHidden); + + const afterReturn = result.current; + act(() => { + vi.advanceTimersByTime(1000); + }); + expect(result.current).toBeGreaterThan(afterReturn); + }); + + it("clears its interval on unmount", () => { + const clearSpy = vi.spyOn(globalThis, "clearInterval"); + const { unmount } = renderHook(() => useLiveRelativeTime(1000)); + + unmount(); + expect(clearSpy).toHaveBeenCalled(); + + // No further work is scheduled after unmount. + expect(() => + act(() => { + vi.advanceTimersByTime(5000); + }), + ).not.toThrow(); + }); +}); diff --git a/src/hooks/useLiveRelativeTime.ts b/src/hooks/useLiveRelativeTime.ts new file mode 100644 index 0000000..4c71879 --- /dev/null +++ b/src/hooks/useLiveRelativeTime.ts @@ -0,0 +1,56 @@ +import { useEffect, useState } from "react"; + +// Default cadence for refreshing relative timestamps. 45s keeps "2m ago" style +// labels honest without the re-render churn of a per-second tick. +export const DEFAULT_RELATIVE_TIME_INTERVAL_MS = 45_000; + +/** + * Returns a `now` timestamp that advances on an interval, so components rendering + * relative times (`timeAgo(iso, now)`) stay current without an unrelated + * re-render. Call this once per long-lived list view and share the value across + * rows - a single interval, not one timer per row. + * + * The interval pauses while the tab is backgrounded (same `visibilitychange` + * pattern as `useWebSocket`) and is cleared on unmount. + */ +export function useLiveRelativeTime( + intervalMs: number = DEFAULT_RELATIVE_TIME_INTERVAL_MS, +): number { + const [now, setNow] = useState(() => Date.now()); + + useEffect(() => { + let timer: ReturnType | null = null; + + const start = () => { + if (timer === null) { + timer = setInterval(() => setNow(Date.now()), intervalMs); + } + }; + const stop = () => { + if (timer !== null) { + clearInterval(timer); + timer = null; + } + }; + + const handleVisibilityChange = () => { + if (document.visibilityState === "visible") { + // Catch up immediately on return, then resume ticking. + setNow(Date.now()); + start(); + } else { + stop(); + } + }; + + if (document.visibilityState === "visible") start(); + document.addEventListener("visibilitychange", handleVisibilityChange); + + return () => { + stop(); + document.removeEventListener("visibilitychange", handleVisibilityChange); + }; + }, [intervalMs]); + + return now; +} From 3a737859ce02a2f5c5ea3b386f095e9bba563cc2 Mon Sep 17 00:00:00 2001 From: spotkorner-dot Date: Sun, 30 Aug 2026 21:43:38 +0100 Subject: [PATCH 3/5] feat(frontend): add printable summary to intent detail page (#296) --- src/app/explore/[id]/page.test.tsx | 33 ++++++++++++++++++ src/app/explore/[id]/page.tsx | 54 +++++++++++++++++++++++++----- src/app/globals.css | 36 ++++++++++++++++++++ 3 files changed, 114 insertions(+), 9 deletions(-) diff --git a/src/app/explore/[id]/page.test.tsx b/src/app/explore/[id]/page.test.tsx index fac4e69..94c85bb 100644 --- a/src/app/explore/[id]/page.test.tsx +++ b/src/app/explore/[id]/page.test.tsx @@ -1,9 +1,14 @@ import { describe, expect, it, vi } from "vitest"; import { render, screen } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; import type { IntentDetail } from "@/lib/types"; const { useIntentMock } = vi.hoisted(() => ({ useIntentMock: vi.fn() })); vi.mock("@/hooks/useIntent", () => ({ useIntent: useIntentMock })); +// Nav/Footer are app chrome that needs wallet + i18n context this suite does +// not set up - stub them so the record itself is what's under test. +vi.mock("@/components/Nav", () => ({ Nav: () => null })); +vi.mock("@/components/Footer", () => ({ Footer: () => null })); import IntentDetailPage from "./page"; @@ -83,4 +88,32 @@ describe("IntentDetailPage", () => { expect(screen.getByText("← Back to explorer")).toHaveAttribute("href", "/explore"); }); + + it("triggers the browser print dialog from the Print / Save as PDF action", async () => { + const printSpy = vi.spyOn(window, "print").mockImplementation(() => {}); + useIntentMock.mockReturnValue({ intent: detail, isLoading: false, error: undefined }); + render(); + + await userEvent.click(screen.getByRole("button", { name: /print \/ save as pdf/i })); + expect(printSpy).toHaveBeenCalledTimes(1); + printSpy.mockRestore(); + }); + + it("marks a non-settled intent as not a completed-swap record", () => { + useIntentMock.mockReturnValue({ + intent: { ...detail, status: "pending", txHash: undefined }, + isLoading: false, + error: undefined, + }); + render(); + + expect(screen.getByRole("note")).toHaveTextContent(/not yet settled/i); + }); + + it("shows a completed record with no warning for a filled intent", () => { + useIntentMock.mockReturnValue({ intent: detail, isLoading: false, error: undefined }); + render(); + + expect(screen.queryByRole("note")).not.toBeInTheDocument(); + }); }); diff --git a/src/app/explore/[id]/page.tsx b/src/app/explore/[id]/page.tsx index 88cfb04..93a9a19 100644 --- a/src/app/explore/[id]/page.tsx +++ b/src/app/explore/[id]/page.tsx @@ -5,6 +5,7 @@ import Link from "next/link"; import { useCopyToClipboard } from "@/hooks/useCopyToClipboard"; import { Nav } from "@/components/Nav"; import { Footer } from "@/components/Footer"; +import { CopyButton } from "@/components/CopyButton"; import { IntentStatusBadge } from "@/components/IntentStatusBadge"; import { SkeletonDetailCard } from "@/components/Skeleton"; import { useIntent } from "@/hooks/useIntent"; @@ -27,19 +28,33 @@ function deadlineLabel(deadline: string) { export default function IntentDetailPage({ params }: { params: { id: string } }) { const { intent, isLoading, error } = useIntent(params.id); + const { copy } = useCopyToClipboard(); const isExpired = useMemo(() => { if (!intent || intent.status !== "pending" || !intent.deadline) return false; return new Date(intent.deadline).getTime() <= Date.now(); }, [intent]); + const isSettled = intent?.status === "filled"; return (
) : ( -
+
+ {/* Print-only header - the on-screen Nav/Footer are stripped when printing. */} +
+
Vortex - swap intent record
+
+ Intent {params.id} · generated {new Date().toLocaleString()} +
+
+
Intent
@@ -70,12 +93,23 @@ export default function IntentDetailPage({ params }: { params: { id: string } })
+ {!isSettled && ( +

+ This intent is {intent.status} and not yet settled - this is not a + completed-swap record. +

+ )} +
{[ ["Source chain", intent.srcChain], ["Solver", intent.solver], ["Minimum out", `${intent.minOut} ${intent.dstToken}`], - ["Submitted", timeAgo(intent.createdAt)], + ["Submitted", `${new Date(intent.createdAt).toLocaleString()} (${timeAgo(intent.createdAt)})`], ["Deadline", deadlineLabel(intent.deadline)], ].map(([k, v]) => (
@@ -94,19 +128,21 @@ export default function IntentDetailPage({ params }: { params: { id: string } }) {intent.txHash && (
+
Settlement transaction
{truncateAddress(intent.txHash)} View on stellar.expert → diff --git a/src/app/globals.css b/src/app/globals.css index b957339..e3708d2 100644 --- a/src/app/globals.css +++ b/src/app/globals.css @@ -128,3 +128,39 @@ html[data-motion="reduce"] *, html[data-motion="reduce"] *::before, html[data-mo html[data-motion="allow"] *, html[data-motion="allow"] *::before, html[data-motion="allow"] *::after { scroll-behavior: smooth; } + +/* ── Print ────────────────────────────────────────────────────────────────── + The intent detail page (src/app/explore/[id]/page.tsx) doubles as a + printable / save-as-PDF record. Strip the app chrome and interactive-only + controls, and render the summary as plain black-on-white. Elements that + should not appear on paper carry Tailwind's `print:hidden`; this block + covers the structural chrome those utilities can't reach. */ +@media print { + nav, + footer { + display: none !important; + } + + html, + body { + background: #fff !important; + color: #000 !important; + } + + main { + padding: 0 !important; + max-width: none !important; + } + + #intent-record { + background: #fff !important; + color: #000 !important; + } + + /* Keep colour-coded badges legible when printed in greyscale - they already + carry a text label and a distinct icon shape alongside the colour. */ + #intent-record * { + color: #000 !important; + border-color: rgba(0, 0, 0, 0.25) !important; + } +} From 963a40bcd5ce46181ed89d3685dbb340af74cd01 Mon Sep 17 00:00:00 2001 From: spotkorner-dot Date: Sun, 30 Aug 2026 21:57:30 +0100 Subject: [PATCH 4/5] feat(frontend): show quote-change delta indicator in swap card (#297) --- src/components/SwapCard.delta.test.tsx | 88 ++++++++++ src/components/SwapCard.tsx | 212 +++++++++++++++++++------ src/lib/i18n/messages/en.ts | 2 + src/lib/i18n/messages/es.ts | 1 + 4 files changed, 255 insertions(+), 48 deletions(-) create mode 100644 src/components/SwapCard.delta.test.tsx diff --git a/src/components/SwapCard.delta.test.tsx b/src/components/SwapCard.delta.test.tsx new file mode 100644 index 0000000..3f2de9d --- /dev/null +++ b/src/components/SwapCard.delta.test.tsx @@ -0,0 +1,88 @@ +import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; +import { render, screen } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; +import type { Quote } from "@/lib/types"; + +const { useQuoteMock } = vi.hoisted(() => ({ useQuoteMock: vi.fn() })); +vi.mock("@/hooks/useQuote", () => ({ useQuote: useQuoteMock })); +vi.mock("@stellar/freighter-api", () => ({ + default: { + isConnected: vi.fn(), + requestAccess: vi.fn(), + getNetwork: vi.fn(), + isAllowed: vi.fn(), + getPublicKey: vi.fn(), + signTransaction: vi.fn(), + }, +})); + +import { SwapCard } from "./SwapCard"; + +const baseQuote: Quote = { + dstAmount: "100.0000", + solver: "Alpha", + fillTimeSeconds: 30, + priceImpactPct: 0.5, + protocolFeePct: 0.05, + rate: "1 USDC = 8.4600 XLM", +}; + +function setQuote(quote: Quote | undefined) { + useQuoteMock.mockReturnValue({ + quote, + quoteFetchedAt: quote ? Date.now() : null, + isLoading: false, + error: undefined, + }); +} + +describe("SwapCard quote-change delta indicator", () => { + beforeEach(() => { + setQuote(baseQuote); + }); + + afterEach(() => { + useQuoteMock.mockReset(); + }); + + it("shows no delta on the first quote for a route", () => { + render(); + expect(screen.queryByText(/improved by|worsened by/i)).not.toBeInTheDocument(); + }); + + it("flags an improvement when a refreshed quote pays out more", () => { + const { rerender } = render(); + + setQuote({ ...baseQuote, dstAmount: "104.0000" }); + rerender(); + + expect(screen.getByText(/improved by/i)).toBeInTheDocument(); + expect(screen.queryByText(/worsened by/i)).not.toBeInTheDocument(); + }); + + it("flags a worsening when a refreshed quote pays out less", () => { + const { rerender } = render(); + + setQuote({ ...baseQuote, dstAmount: "97.0000" }); + rerender(); + + expect(screen.getByText(/worsened by/i)).toBeInTheDocument(); + expect(screen.queryByText(/improved by/i)).not.toBeInTheDocument(); + }); + + it("does not treat a token/route change as a delta", async () => { + const user = userEvent.setup(); + const { rerender } = render(); + + // Switch the destination token - that's a different route. useQuote would + // drop the stale quote while the new route's quote loads. + await user.click(screen.getByRole("button", { name: "XLM" })); + setQuote(undefined); + rerender(); + + setQuote({ ...baseQuote, dstAmount: "104.0000" }); + rerender(); + + expect(screen.queryByText(/improved by|worsened by/i)).not.toBeInTheDocument(); + }); +}); diff --git a/src/components/SwapCard.tsx b/src/components/SwapCard.tsx index 3524333..c9f2670 100644 --- a/src/components/SwapCard.tsx +++ b/src/components/SwapCard.tsx @@ -15,6 +15,12 @@ import type { Quote, QuoteRequest } from "@/lib/types"; export const DEFAULT_SLIPPAGE_PCT = 0.5; export const HIGH_PRICE_IMPACT_THRESHOLD_PCT = 3; +// A quote older than this is considered stale and must refresh before submit. +export const STALE_QUOTE_THRESHOLD_MS = 30_000; + +// How long the "quote changed" delta indicator stays on screen after a refresh. +const QUOTE_DELTA_TTL_MS = 4000; + const SUBMISSION_LABEL_KEY: Record = { connecting: "swap.submit.connecting", building: "swap.submit.building", @@ -22,6 +28,38 @@ const SUBMISSION_LABEL_KEY: Record = { submitting: "swap.submit.submitting", }; +// Small ▲/▼ indicator shown briefly next to a quote field when a fresh quote +// moved it relative to the previous same-route quote (#297). Green when the +// change favours the user, amber when it works against them. +function QuoteDelta({ + value, + betterWhenHigher, + format, + label, +}: { + value: number; + betterWhenHigher: boolean; + format: (n: number) => string; + label: string; +}) { + if (value === 0) return null; + const isUp = value > 0; + const isGood = betterWhenHigher ? isUp : !isUp; + return ( + + + + + {label} {isGood ? "improved" : "worsened"} by {format(Math.abs(value))} on the latest quote + + + ); +} + export type SwapCardProps = { initialAmount?: string; previewQuote?: Quote; @@ -36,9 +74,11 @@ export function SwapCard({ const { t } = useTranslation(); const [srcChain, setSrcChain] = useState("ethereum"); - const [srcToken, setSrcToken] = useState(SRC_TOKENS["ethereum"][0]); - const [dstToken, setDstToken] = useState(DST_TOKENS[0]); + const [srcToken, setSrcToken] = useState(SRC_TOKENS["ethereum"]![0]!); + const [dstToken, setDstToken] = useState(DST_TOKENS[0]!); const [srcAmount, setSrcAmount] = useState(initialAmount); + const [dstAddress, setDstAddress] = useState(""); + const [slippagePct, setSlippagePct] = useState(String(DEFAULT_SLIPPAGE_PCT)); const [showChainPicker, setShowChainPicker] = useState(false); const [showTokenPicker, setShowTokenPicker] = useState(false); const chainToggleRef = useRef(null); @@ -66,8 +106,8 @@ export function SwapCard({ if (e.key !== "Tab") return; const focusable = chainPickerRef.current?.querySelectorAll("button"); if (!focusable || focusable.length === 0) return; - const first = focusable[0]; - const last = focusable[focusable.length - 1]; + const first = focusable[0]!; + const last = focusable[focusable.length - 1]!; if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); @@ -79,13 +119,50 @@ export function SwapCard({ const debouncedAmount = useDebouncedValue(srcAmount, 500); const hasAmount = Boolean(debouncedAmount) && parseFloat(debouncedAmount) > 0; - const { quote: fetchedQuote, isLoading: quoteIsLoading, error: quoteError } = useQuote( + const { quote: fetchedQuote, quoteFetchedAt, isLoading: quoteIsLoading, error: quoteError } = useQuote( hasAmount && !previewQuote ? { srcChain, srcToken: srcToken.symbol, srcAmount: debouncedAmount, dstToken: dstToken.symbol } : null ); const quote = previewQuote ?? fetchedQuote; const quoting = previewQuote ? false : quoteIsLoading; + const quoteErrorType: { kind: "no-solver" | "generic" } | null = quoteError + ? { kind: /no[_ ]solver/i.test(quoteError.message ?? "") ? "no-solver" : "generic" } + : null; + + // === "Quote changed" delta indicator (#297) + // Compare each fresh quote to the immediately-previous one for the *same + // route* (chain + token pair). A different route is a new quote entirely, not + // a delta; the very first quote for a route has nothing to compare against. + const routeKey = `${srcChain}|${srcToken.symbol}|${dstToken.symbol}`; + const prevQuoteRef = useRef<{ routeKey: string; quote: Quote } | null>(null); + const [quoteDelta, setQuoteDelta] = useState<{ dstAmount: number; priceImpactPct: number } | null>(null); + + useEffect(() => { + const prev = prevQuoteRef.current; + + // No quote (initial, or cleared while a new route's quote loads), or the + // route changed: drop any comparison history so the next quote for this + // route counts as a first quote, not a delta. + if (!quote || (prev && prev.routeKey !== routeKey)) { + prevQuoteRef.current = quote ? { routeKey, quote } : null; + setQuoteDelta(null); + return; + } + + prevQuoteRef.current = { routeKey, quote }; + if (!prev || prev.quote === quote) return; + + const delta = { + dstAmount: parseFloat(quote.dstAmount) - parseFloat(prev.quote.dstAmount), + priceImpactPct: quote.priceImpactPct - prev.quote.priceImpactPct, + }; + if (delta.dstAmount === 0 && delta.priceImpactPct === 0) return; + + setQuoteDelta(delta); + const timer = setTimeout(() => setQuoteDelta(null), QUOTE_DELTA_TTL_MS); + return () => clearTimeout(timer); + }, [quote, routeKey]); const dstAddressError = dstAddress && !isValidStellarPublicKey(dstAddress) ? t("swap.destination.invalidAddress") @@ -113,12 +190,15 @@ export function SwapCard({ /** Truncate a raw amount string to at most `decimals` decimal places. */ function truncateToDecimals(value: string, decimals: number): string { const dotIndex = value.indexOf("."); - if (dotIndex === -1 || decimals === 0) return value.split(".")[0]; + if (dotIndex === -1 || decimals === 0) return value.split(".")[0] ?? ""; return value.slice(0, dotIndex + 1 + decimals); } const handleAmountChange = (raw: string) => { - setSrcAmount(truncateToDecimals(raw, srcToken.decimals)); + // The field is `type="text"` (a `type="number"` input silently reformats + // high-precision decimals) so keep only digits and a single dot here. + const cleaned = raw.replace(/[^\d.]/g, "").replace(/(\..*)\./g, "$1"); + setSrcAmount(truncateToDecimals(cleaned, srcToken.decimals)); }; const handleSubmit = () => { @@ -142,7 +222,7 @@ export function SwapCard({ return; } - submission.submit({ srcChain, srcToken: srcToken.symbol, srcAmount, dstToken: dstToken.symbol }); + submission.submit({ srcChain, srcToken: srcToken.symbol, srcAmount, dstToken: dstToken.symbol, minOut }); }; // While the chain picker overlay is open, the main card sits behind it @@ -150,30 +230,6 @@ export function SwapCard({ // order too, or keyboard users tab through invisible fields. const hiddenTabIndex = showChainPicker ? -1 : undefined; - const chainPickerRef = useRef(null); - const chainToggleRef = useRef(null); - - const closeChainPicker = () => { - setShowChainPicker(false); - chainToggleRef.current?.focus(); - }; - - // Moves focus into the overlay when it opens, since its trigger becomes - // aria-hidden/untabbable the moment the main card is hidden behind it. - useEffect(() => { - if (!showChainPicker) return; - chainPickerRef.current?.querySelector("button")?.focus(); - - const handleKeyDown = (event: KeyboardEvent) => { - if (event.key === "Escape") { - event.preventDefault(); - closeChainPicker(); - } - }; - document.addEventListener("keydown", handleKeyDown); - return () => document.removeEventListener("keydown", handleKeyDown); - }, [showChainPicker]); - return (
{/* Chain picker dropdown */} @@ -194,7 +250,8 @@ export function SwapCard({ type="button" onClick={() => { setSrcChain(c.id); - setSrcToken(SRC_TOKENS[c.id][0]); + const firstToken = SRC_TOKENS[c.id]?.[0]; + if (firstToken) setSrcToken(firstToken); closeChainPicker(); }} className={`flex items-center gap-2.5 px-3 py-2.5 rounded-lg border transition-all @@ -247,7 +304,8 @@ export function SwapCard({ handleAmountChange(e.target.value)} @@ -330,12 +388,26 @@ export function SwapCard({ {t("swap.to.quoteLoading")}
) : ( -
- {dstAmount > 0 - ? formatTokenAmount(dstAmount, undefined, { - maximumFractionDigits: dstToken.symbol === "XLM" ? 2 : 4, - }) - : "0"} +
+
+ {dstAmount > 0 + ? formatTokenAmount(dstAmount, undefined, { + maximumFractionDigits: dstToken.symbol === "XLM" ? 2 : 4, + }) + : "0"} +
+ {quoteDelta && ( + + formatTokenAmount(n, undefined, { + maximumFractionDigits: dstToken.symbol === "XLM" ? 2 : 4, + }) + } + /> + )}
)}
@@ -403,14 +475,30 @@ export function SwapCard({ ] as const).map(([labelKey, value]) => (
{t(labelKey)} - - {value} + + {labelKey === "swap.quote.priceImpact" && quoteDelta && ( + `${n.toFixed(2)}%`} + /> + )} + {labelKey === "swap.quote.rate" && quoteDelta && ( + + + Rate updated on the latest quote + + )} + + {value} +
))} @@ -421,6 +509,34 @@ export function SwapCard({ })}

)} + +
+ +
+ setSlippagePct(e.target.value)} + aria-label={t("swap.slippage.inputLabel")} + className="w-16 bg-vx-surface border border-vx-border rounded-md px-2 py-1 text-xs text-vx-text text-right + focus:outline-none focus:border-vx-sage/50" + /> + +
+
+ {minOut !== "0" && ( +

+ {t("swap.slippage.minOut", { amount: minOut, token: dstToken.symbol })} +

+ )}
)} diff --git a/src/lib/i18n/messages/en.ts b/src/lib/i18n/messages/en.ts index 0b3a108..199440c 100644 --- a/src/lib/i18n/messages/en.ts +++ b/src/lib/i18n/messages/en.ts @@ -36,7 +36,9 @@ export const en = { "swap.quote.protocolFeeValue": "{percent}%", "swap.quote.rate": "Rate", "swap.quote.unavailable": "Live quote unavailable — showing an estimated rate.", + "swap.quote.noSolver": "No solver is quoting this route right now — showing an estimated rate.", "swap.quote.staleWarning": "Quote is stale. Please wait for a refresh before submitting.", + "swap.quote.highPriceImpactWarning": "High price impact above {threshold}%.", "swap.submit.connecting": "Connecting wallet…", "swap.submit.building": "Preparing swap…", diff --git a/src/lib/i18n/messages/es.ts b/src/lib/i18n/messages/es.ts index cbcdbe7..f9f3968 100644 --- a/src/lib/i18n/messages/es.ts +++ b/src/lib/i18n/messages/es.ts @@ -36,6 +36,7 @@ export const es = { "swap.quote.protocolFeeValue": "{percent}%", "swap.quote.rate": "Tasa", "swap.quote.unavailable": "Cotización en tiempo real no disponible — mostrando tasa estimada.", + "swap.quote.noSolver": "Ningún solver está cotizando esta ruta ahora mismo — mostrando tasa estimada.", "swap.quote.highPriceImpactWarning": "Impacto de precio alto por encima de {threshold}% — revisa antes de intercambiar.", "swap.submit.connecting": "Conectando billetera…", From 8f108a61dba0086a5c4face52a6cede3e75dbb3b Mon Sep 17 00:00:00 2001 From: spotkorner-dot Date: Sun, 30 Aug 2026 22:00:26 +0100 Subject: [PATCH 5/5] docs(pr): describe the 296-299 UX enhancements --- docs/pr/spotkorner-dot-296-297-298-299.md | 117 ++++++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 docs/pr/spotkorner-dot-296-297-298-299.md diff --git a/docs/pr/spotkorner-dot-296-297-298-299.md b/docs/pr/spotkorner-dot-296-297-298-299.md new file mode 100644 index 0000000..a74476f --- /dev/null +++ b/docs/pr/spotkorner-dot-296-297-298-299.md @@ -0,0 +1,117 @@ +## Summary + +Four UX enhancements for the Vortex frontend, one commit each: + +- **#298** – `Cmd/Ctrl+K` command palette for keyboard navigation +- **#299** – relative timestamps that stay current in live list views +- **#296** – printable / save-as-PDF summary on the intent detail page +- **#297** – "quote changed" delta indicator on the swap card + +Closes #296 +Closes #297 +Closes #298 +Closes #299 + +## Changes + +### #298 – Command palette (`Cmd/Ctrl+K`) +- New `src/components/CommandPalette.tsx`: global `keydown` listener toggles a + WAI-ARIA combobox/listbox modal. Navigates the four top-level routes; a pasted + Stellar public key routes to `/solve/[address]`, any other whitespace-free + token that matches no route is offered as an `/explore/[id]` lookup. Full + keyboard operation (arrows wrap, `Enter` activates, `Esc`/backdrop close), + focus is moved in on open and restored on close. +- Mounted once in `src/app/layout.tsx`. +- `src/components/CommandPalette.test.tsx` (8 cases), `e2e/command-palette.spec.ts`, + and a `docs/components.md` entry. +- Strings are hard-coded English, matching the existing `ExplorePageClient` + convention and avoiding edits to the (currently out-of-sync) i18n catalogs. + +### #299 – Live relative timestamps +- New `src/hooks/useLiveRelativeTime.ts`: one shared 45s interval returning a + `now` timestamp; pauses on `visibilitychange` (same pattern as `useWebSocket`) + and clears on unmount. One interval per list, not one timer per row. +- Applied in `ActivityFeed.tsx`, `ExplorePageClient.tsx`, and `my-intents/page.tsx` + (`timeAgo(iso, now)`), the latter gaining a "submitted … ago" line per row. +- `useLiveRelativeTime.test.ts` and `ExplorePageClient.test.tsx` (new), the + latter asserting the label advances on its own as time passes. + +### #296 – Printable intent record +- `explore/[id]/page.tsx`: a `print:hidden` "Print / Save as PDF" button calling + `window.print()`; the summary card is wrapped as `#intent-record` with a + print-only header; any non-`filled` intent shows a "not a completed-swap + record" notice so a mid-flight print can't be mistaken for a receipt. The + "Submitted" field now shows an absolute timestamp. +- New `@media print` block in `src/app/globals.css` strips `nav`/`footer` and + interactive chrome and renders the record black-on-white. +- The status badge already carries a text label + distinct icon shape, so it + stays legible in greyscale. + +### #297 – Quote-change delta indicator +- `SwapCard.tsx` tracks the immediately-previous quote for the *same route* + (chain + token pair) in a ref. When a fresh same-route quote moves the output + amount or price impact, a small ▲/▼ badge (green = better for the user, amber = + worse) shows next to that field and fades after 4s. No delta on the first + quote for a route or after a token/route change. +- `SwapCard.delta.test.tsx` (new, 4 cases): improves / worsens / first-quote / + route-change. +- Two missing catalog keys (`swap.quote.noSolver`, `swap.quote.highPriceImpactWarning`) + added to `en`/`es`. + +## Testing + +- [ ] `npm run build` – **blocked by pre-existing breakage** (see below) +- [ ] `npx tsc --noEmit` – **blocked by pre-existing breakage** (see below) +- [x] New tests pass in isolation: + - `CommandPalette.test.tsx` 8/8 + - `useLiveRelativeTime.test.ts` 3/3, `ExplorePageClient.test.tsx` 2/2 + - `explore/[id]/page.test.tsx` 11/11 (was 0/8), `my-intents/page.test.tsx` 18/19 (was 0/17) + - `ActivityFeed.test.tsx` 10/10 (was 0/10) + - `SwapCard.test.tsx` 14/14 (was 0/14, file didn't collect), `SwapCard.delta.test.tsx` 4/4 +- [x] Full suite moved from **72 failed / 231 total** to **55 failed / 283 total** + (52 new tests added, all green; 17 pre-existing failures fixed as a side effect + of repairing files these features touch). + +### Pre-existing breakage (not introduced here) + +`main` does not build, typecheck, lint, or pass its own test suite at +`c87dc14`. Root cause: PRs #217/#218/#219 were merged with `Merge branch main +into feature/…` conflict resolutions that kept both sides, leaving duplicate +declarations, half-applied features, and test files from divergent branches. + +To ship these four features the following files had to be repaired **just enough +to compile and render** (their existing test suites are exercised above): + +- `src/components/SwapCard.tsx` – had ~42 type errors (duplicate `chainPickerRef`/ + `chainToggleRef`/`closeChainPicker`/`useEffect`; undefined `dstAddress`, + `slippagePct`, `quoteFetchedAt`, `STALE_QUOTE_THRESHOLD_MS`, `quoteErrorType`). + The dropped slippage-tolerance field + min-out line were restored (both have + `en`/`es` keys and are required by the existing `SwapCard.test.tsx`); the + amount input is now `type="text" inputMode="decimal"` so 18-dp values aren't + reformatted. +- `src/components/ActivityFeed.tsx` – duplicate `export`, undefined + `useTranslation`/`announcement`/`FeedSkeleton`/`ActivityFeedView`; rebuilt + without i18n (matching `ExplorePageClient`) and with the debounced live-region + announcement its test expects. +- `src/app/explore/[id]/page.tsx` – `CopyButton`/`copy`/`copied` undefined. +- `src/app/my-intents/page.tsx` – `downloadCsv`/`buildIntentsCsv` not imported, + duplicate status badge, over-riding `aria-label`s. + +Still red and **left untouched** (out of scope): the 3 files with unresolved +merge-conflict markers that block a full `tsc`/`build` +(`src/app/explore/page.tsx`, `src/app/solve/page.tsx`, +`src/app/solve/[address]/page.test.tsx`); `Nav.tsx` / `ConnectWalletButton.tsx` / +`wallet.ts` (mocked in the touched test suites); the i18n catalog key-parity +gap; `*.stories.tsx`. `my-intents/page.test.tsx`'s "retry button" case references +undefined `user`/`mutateMock` in the test body and cannot pass without a test +rewrite. + +Print-preview screenshots for #296 could not be captured because the app does +not currently run; the print trigger is covered by a mocked `window.print` test. + +## Checklist + +- [x] Self-reviewed the diff +- [x] Added or updated tests for new behaviour +- [x] No secrets or credentials committed +- [x] PR title follows conventional commits