mirror of
https://github.com/bytedance/deer-flow.git
synced 2026-10-27 21:50:36 +00:00
* fix(frontend): make docs search work on desktop and mobile Docs search on deerflow.tech was broken twice over: no build step ever generated the Pagefind index that Nextra's <Search> loads, and the custom docs header that replaces Nextra's navbar never rendered a search box. - `pnpm build` now runs `search:index` (pagefind 1.5.2, pinned) to write public/_pagefind/ (gitignored). - The landing Header and its mobile sheet take an optional `search` slot; only the docs layout fills it, with localized labels and an aria-label. - Each docs page carries a Pagefind `lang` filter and queries are scoped to it, since the root <html lang> is fixed and would mix en/zh results. - globals.css restyles the results panel with app tokens because Nextra's <Head> variables are unset, lifts it above the mobile sheet, and keeps it tappable; the sheet no longer closes before a result navigates and closes after navigation. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(frontend): add DESIGN.md describing the shipped design system Records the existing tokens, typography, components, docs (Nextra) overrides, motion, accessibility and copy rules, plus the landing-only decorative exceptions, so UI changes have something to be checked against. Linked from frontend/AGENTS.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(frontend): address Codex review of docs search - Chinese search: the root <html lang> is fixed, so Pagefind indexed zh pages with the English tokenizer and multi-character words (e.g. 偏好) never matched. scripts/build-search-index.mjs now sets each page's lang from its route before indexing, producing separate en-US and zh-CN indexes, and DocsHtmlLang syncs <html lang> at runtime (resetting Pagefind on a language switch) so queries hit the right index. - Mobile menu: reset the open state when the route changes instead of comparing against the saved path, so Back no longer reopens the sheet. - Shortcut: stop mounting a second <Search> in Nextra's unused mobile menu, which captured Cmd/Ctrl+K and focused an offscreen input at 640-767px. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(frontend): keep guidance within size budget * fix(frontend): address docs search review feedback Keep Nextra results within the mobile sheet scroll boundary and dismiss same-hash selections by pointer or keyboard. Rebuild Pagefind output without stale fragments and replace UI source-string checks with behavioral coverage. --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Willem Jiang <willem.jiang@gmail.com>
29 lines
1015 B
TypeScript
29 lines
1015 B
TypeScript
import { readFileSync } from "node:fs";
|
|
import path from "node:path";
|
|
|
|
import { describe, expect, it } from "@rstest/core";
|
|
|
|
const FRONTEND_ROOT = path.resolve(__dirname, "../../..");
|
|
|
|
function source(relativePath: string) {
|
|
return readFileSync(path.join(FRONTEND_ROOT, relativePath), "utf8");
|
|
}
|
|
|
|
describe("docs search", () => {
|
|
it("builds the Pagefind index that Nextra's search loads", () => {
|
|
const pkg = JSON.parse(source("package.json")) as {
|
|
scripts: Record<string, string>;
|
|
devDependencies: Record<string, string>;
|
|
};
|
|
|
|
// Nextra's <Search> imports /_pagefind/pagefind.js at runtime; every build
|
|
// path (Docker, build-static, serve.sh, CI) goes through `pnpm build`.
|
|
expect(pkg.scripts.build).toContain("pnpm run search:index");
|
|
expect(pkg.scripts["search:index"]).toBe(
|
|
"node scripts/build-search-index.mjs",
|
|
);
|
|
expect(pkg.devDependencies.pagefind).toMatch(/^\d+\.\d+\.\d+$/);
|
|
expect(source(".gitignore")).toContain("/public/_pagefind/");
|
|
});
|
|
});
|