@nocobase/app-template-default 1.0.0-beta.81 → 1.0.0-beta.82

package/client/extensions/nocobase-file-component-ui/locales/vi-VN.ts

@@ -0,0 +1,47 @@
+import type { FileUiResource } from './en-US.js';
+const messages = {
+  'files.ooxmlLoadFailed': 'Không thể hiển thị tệp Office Open XML này.',
+  'files.ooxmlLoadTimedOut':
+    'Bản xem trước không tải xong trong vòng {{minutes}} phút.',
+  'files.previewRequestFailed':
+    'Yêu cầu xem trước không thành công ({{status}}).',
+  uploadFailed: 'Tải lên tệp không thành công.',
+  fileLimitReached: 'Đã đạt đến số lượng tệp tối đa.',
+  fileTooLarge: 'Tệp vượt quá kích thước tối đa.',
+  fileTypeNotAllowed: 'Loại tệp không được phép.',
+  removalFailed: 'Xóa tệp không thành công.',
+  urlNotAllowed: 'Tệp URL không được phép.',
+  downloadFailed: 'Tải xuống tệp không thành công.',
+  invalidUrl: 'Tệp URL bị thiếu hoặc không được phép.',
+  pdfPreviewFailed: 'Không thể tải bản xem trước PDF.',
+  pdfPreviewMarkup: 'Tệp URL trả về HTML hoặc XML thay vì PDF.',
+  previewFailed: 'Không thể tải bản xem trước tệp.',
+  'files.empty': 'Không có tập tin.',
+  'files.preview': 'Xem trước',
+  'files.download': 'Tải xuống',
+  'files.remove': 'Loại bỏ',
+  'files.chooseMany': 'Chọn tập tin',
+  'files.chooseOne': 'Chọn tập tin',
+  'files.retry': 'Thử lại',
+  'files.done': 'Hoàn thành',
+  'files.uploading': 'Đang tải lên',
+  'files.failed': 'Thất bại',
+  'files.pending': 'Đang chờ',
+  'files.previous': 'Tệp trước đó',
+  'files.next': 'Tập tin tiếp theo',
+  'files.loadingPreview': 'Đang tải bản xem trước...',
+  'files.downloadFile': 'Tải tập tin',
+  'files.previewUnavailable': 'Bản xem trước không khả dụng cho loại tệp này.',
+  'files.imageFailed':
+    'Không thể hiển thị hình ảnh này. Nó có thể bị hỏng hoặc ở định dạng không được hỗ trợ.',
+  'files.officeFailed': 'Office Online không thể tải tệp này.',
+  'files.officeUrl':
+    'Office Online yêu cầu tệp tuyệt đối có thể truy cập internet URL.',
+  'files.cancelFile': 'Hủy {{filename}}',
+  'files.status.uploading': 'Đang tải lên',
+  'files.status.pending': 'Đang chờ',
+  'files.status.error': 'Thất bại',
+};
+
+const resource: FileUiResource = { fileUi: messages };
+export default resource;

package/client/extensions/nocobase-file-component-ui/locales/zh-CN.ts

@@ -0,0 +1,43 @@
+import type { FileUiResource } from './en-US.js';
+const messages = {
+  'files.ooxmlLoadFailed': '无法渲染此 Office Open XML 文件。',
+  'files.ooxmlLoadTimedOut': '预览未能在 {{minutes}} 分钟内加载完成。',
+  'files.previewRequestFailed': '预览请求失败（{{status}}）。',
+  uploadFailed: '文件上传失败。',
+  fileLimitReached: '已达到文件数量上限。',
+  fileTooLarge: '文件超出大小限制。',
+  fileTypeNotAllowed: '不允许上传此文件类型。',
+  removalFailed: '文件删除失败。',
+  urlNotAllowed: '不允许访问此文件 URL。',
+  downloadFailed: '文件下载失败。',
+  invalidUrl: '文件 URL 缺失或不允许访问。',
+  pdfPreviewFailed: '无法加载 PDF 预览。',
+  pdfPreviewMarkup: '文件 URL 返回的是 HTML 或 XML，而不是 PDF。',
+  previewFailed: '无法加载文件预览。',
+  'files.empty': '暂无文件。',
+  'files.preview': '预览',
+  'files.download': '下载',
+  'files.remove': '移除',
+  'files.chooseMany': '选择文件',
+  'files.chooseOne': '选择文件',
+  'files.retry': '重试',
+  'files.done': '已完成',
+  'files.uploading': '正在上传',
+  'files.failed': '失败',
+  'files.pending': '等待中',
+  'files.previous': '上一个文件',
+  'files.next': '下一个文件',
+  'files.loadingPreview': '正在加载预览…',
+  'files.downloadFile': '下载文件',
+  'files.previewUnavailable': '此文件类型不支持预览。',
+  'files.imageFailed': '无法显示此图片，文件可能已损坏或格式不受支持。',
+  'files.officeFailed': 'Office Online 无法加载此文件。',
+  'files.officeUrl': 'Office Online 需要可通过互联网访问的文件绝对地址。',
+  'files.cancelFile': '取消 {{filename}}',
+  'files.status.uploading': '正在上传',
+  'files.status.pending': '等待中',
+  'files.status.error': '失败',
+};
+
+const resource: FileUiResource = { fileUi: messages };
+export default resource;

package/client/extensions/nocobase-file-component-ui/locales/zh-TW.ts

@@ -0,0 +1,43 @@
+import type { FileUiResource } from './en-US.js';
+const messages = {
+  'files.ooxmlLoadFailed': '無法呈現此 Office Open XML 檔案。',
+  'files.ooxmlLoadTimedOut': '預覽未在 {{minutes}} 分鐘內完成載入。',
+  'files.previewRequestFailed': '預覽請求失敗 ({{status}})。',
+  uploadFailed: '檔案上傳失敗。',
+  fileLimitReached: '已達到最大檔案數。',
+  fileTooLarge: '檔案超出最大大小。',
+  fileTypeNotAllowed: '不允許的檔案型別。',
+  removalFailed: '檔案刪除失敗。',
+  urlNotAllowed: '不允許使用檔案 URL。',
+  downloadFailed: '檔案下載失敗。',
+  invalidUrl: '檔案 URL 遺失或不允許。',
+  pdfPreviewFailed: '無法載入 PDF 預覽。',
+  pdfPreviewMarkup: '檔案 URL 傳回 HTML 或 XML，而不是 PDF。',
+  previewFailed: '無法載入檔案預覽。',
+  'files.empty': '沒有檔案。',
+  'files.preview': '預覽',
+  'files.download': '下載',
+  'files.remove': '刪除',
+  'files.chooseMany': '選擇檔案',
+  'files.chooseOne': '選擇檔案',
+  'files.retry': '重試',
+  'files.done': '已完成',
+  'files.uploading': '上傳中',
+  'files.failed': '失敗',
+  'files.pending': '待處理',
+  'files.previous': '上一個檔案',
+  'files.next': '下一個檔案',
+  'files.loadingPreview': '載入預覽...',
+  'files.downloadFile': '下載檔案',
+  'files.previewUnavailable': '此檔案型別無法預覽。',
+  'files.imageFailed': '此影像無法顯示。它可能已損壞或格式不受支援。',
+  'files.officeFailed': 'Office Online 無法載入此檔案。',
+  'files.officeUrl': 'Office Online 需要可透過 Internet 存取的絕對檔案 URL。',
+  'files.cancelFile': '取消 {{filename}}',
+  'files.status.uploading': '上傳中',
+  'files.status.pending': '待處理',
+  'files.status.error': '失敗',
+};
+
+const resource: FileUiResource = { fileUi: messages };
+export default resource;

package/client/extensions/nocobase-file-component-ui/types.ts

@@ -17,7 +17,7 @@ export interface FileUiLabels {
 }
 
 export interface FileUploadFieldProps {
-  readonly repository: ClientFileRepository;
+  readonly repository: Pick<ClientFileRepository, 'uploadOne' | 'deleteOne'>;
   readonly value: readonly FileRecord[];
   readonly onChange: (value: readonly FileRecord[]) => void;
   readonly onError?: (error: Error) => void;
@@ -47,6 +47,8 @@ export interface FilePreviewDialogProps {
   readonly initialIndex?: number;
   readonly open: boolean;
   readonly onOpenChange: (open: boolean) => void;
+  /** Override downloads for both the toolbar and preview fallbacks. */
+  readonly onDownload?: (file: FileRecord) => void | Promise<void>;
   readonly onError?: (error: Error) => void;
   readonly download?: boolean;
   readonly labels?: FileUiLabels;

package/client/locales/en-US.ts

@@ -1,3 +1,4 @@
+import fileUi from '../extensions/nocobase-file-component-ui/locales/en-US.js';
 import type { LocaleResource } from '@nocobase/i18n';
 
 import systemEnUS from './system/en-US.js';
@@ -6,6 +7,7 @@ const enUS = {
   // The template's own copy: the shell, the sign-in pages, shared components and the homepage. Keep it in
   // `./system/` so a template upgrade can replace it without touching the application's copy below.
   ...systemEnUS,
+  ...fileUi,
   // The application's copy goes here, one group per feature. A shared group such as `navigation` is extended by
   // spreading the system one first, `navigation: { ...systemEnUS.navigation, orders: 'Orders' }`, since a group
   // written here replaces the system group of the same name rather than merging with it.

package/client/locales/zh-CN.ts

@@ -1,9 +1,11 @@
+import fileUi from '../extensions/nocobase-file-component-ui/locales/zh-CN.js';
 import type { AppResource } from './en-US.js';
 import systemZhCN from './system/zh-CN.js';
 
 const zhCN: AppResource = {
   // The template's own copy; see `./en-US.ts`.
   ...systemZhCN,
+  ...fileUi,
 };
 
 export default zhCN;

package/client/pages/settings/role-form.tsx

@@ -31,6 +31,7 @@ import {
   useNavigate,
   useOutletContext,
   useParams,
+  useResolvedPath,
 } from 'react-router';
 import { RouteChildPage } from '#components/route-child-page';
 import { BackButton } from '#components/back-button';
@@ -122,7 +123,10 @@ function RoleEditor(): ReactElement {
     : canUpdate &&
       (!request.data?.data.protection ||
         request.data.data.protection.allow.includes('update'));
-  const closeTo = { pathname: '/settings/roles', search: location.search };
+  const closeTo = {
+    pathname: useResolvedPath('..').pathname,
+    search: location.search,
+  };
   const save = async (event: React.FormEvent<HTMLFormElement>) => {
     event.preventDefault();
     if (options.error || !catalog || (!creating && request.error)) return;

package/client/routing/route-context.tsx

@@ -4,6 +4,7 @@ import {
   createContext,
   useContext,
   useMemo,
+  useState,
   type PropsWithChildren,
   type ReactElement,
 } from 'react';
@@ -26,6 +27,15 @@ export interface RouteTrailEntry {
   readonly pathname: string;
 }
 
+const RouteSearchContext = createContext<ReadonlyMap<string, string>>(
+  new Map(),
+);
+
+/** Queries belong to the page that was visited, never to a child currently covering it. */
+export function useRouteSearches(): ReadonlyMap<string, string> {
+  return useContext(RouteSearchContext);
+}
+
 const RouteTreeContext = createContext<readonly AppClientRegisteredRoute[]>([]);
 export interface RouteTreeProviderProps extends PropsWithChildren {
   readonly routes: readonly AppClientRegisteredRoute[];
@@ -42,9 +52,31 @@ export function RouteTreeProvider({
   children,
   routes,
 }: RouteTreeProviderProps): ReactElement {
+  const location = useLocation();
+  const pathname = location.pathname.replace(/\/+$/u, '') || '/';
+  const search = location.search;
+  const [visited, setVisited] = useState(() => ({
+    pathname,
+    search,
+    queries: new Map([[pathname, search]]),
+  }));
+  let queries = visited.queries;
+  if (visited.pathname !== pathname || visited.search !== search) {
+    // Keep only the active ancestry. A fresh visit (including an empty query) replaces its old state.
+    // Derive before rendering children so a detail never records its parameters against the parent.
+    queries = new Map(
+      [...queries].filter(([path]) =>
+        pathname.startsWith(`${path.replace(/\/$/u, '')}/`),
+      ),
+    );
+    queries.set(pathname, search);
+    setVisited({ pathname, search, queries });
+  }
   return (
     <RouteTreeContext.Provider value={routes}>
-      {children}
+      <RouteSearchContext.Provider value={queries}>
+        {children}
+      </RouteSearchContext.Provider>
     </RouteTreeContext.Provider>
   );
 }

package/eslint.config.js

@@ -7,5 +7,7 @@ export default createApplicationConfig({
     'client-old/**',
     'public/r/**',
     'storage/**',
+    // Internal workspace packages own their lint and TypeScript configurations.
+    'packages/**',
   ],
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nocobase/app-template-default",
   "displayName": "Default Template",
-  "version": "1.0.0-beta.81",
+  "version": "1.0.0-beta.82",
   "type": "module",
   "prettier": "@nocobase/dev-config/prettier",
   "engines": {
@@ -9,7 +9,7 @@
   },
   "nocobase": {
     "templateKind": "app",
-    "defaultTemplateVersion": "1.0.0-beta.81"
+    "defaultTemplateVersion": "1.0.0-beta.82"
   },
   "devDependencies": {
     "@ai-sdk/react": "4.0.131",
@@ -75,7 +75,7 @@
     "@types/jsdom": "^30.0.0",
     "@nocobase/app-client": "^4.0.0-beta.3",
     "@nocobase/app-plugin-template-print": "0.0.2-beta.2",
-    "@nocobase/app-skills": "0.1.0-beta.51",
+    "@nocobase/app-skills": "0.1.0-beta.52",
     "@nocobase/app-testing": "0.1.0-beta.6",
     "@nocobase/app-websocket": "^0.1.0-beta.1",
     "@nocobase/dev-config": "0.1.0-beta.25",
@@ -113,7 +113,8 @@
     "AGENTS.md",
     ".agents/rules",
     "CLAUDE.md",
-    "playwright.config.ts"
+    "playwright.config.ts",
+    "scripts/check-packages.mjs"
   ],
   "publishConfig": {
     "access": "public"
@@ -140,17 +141,17 @@
     "@oclif/core": "^4.14.0",
     "better-auth": "1.7.5",
     "hono": "^4.13.2",
-    "@nocobase/app-plugin-agents": "^1.0.0-beta.25",
-    "@nocobase/app-plugin-api-keys": "^1.0.0-beta.18",
+    "@nocobase/app-plugin-agents": "^1.0.0-beta.27",
+    "@nocobase/app-plugin-api-keys": "^1.0.0-beta.19",
     "@nocobase/app-plugin-authentication": "^2.0.0-beta.15",
     "@nocobase/app-plugin-authorization": "^1.0.0-beta.32",
-    "@nocobase/app-plugin-database-explorer": "^1.0.0-beta.16",
-    "@nocobase/app-plugin-file": "^1.0.0-beta.26",
-    "@nocobase/app-plugin-foundation": "^0.1.0-beta.7",
+    "@nocobase/app-plugin-database-explorer": "^1.0.0-beta.17",
+    "@nocobase/app-plugin-file": "^1.0.0-beta.27",
+    "@nocobase/app-plugin-foundation": "^0.1.0-beta.9",
     "@nocobase/app-plugin-i18n": "^1.0.0-beta.18",
-    "@nocobase/app-plugin-knowledge": "^0.1.0-beta.12",
+    "@nocobase/app-plugin-knowledge": "^0.1.0-beta.13",
     "@nocobase/app-plugin-mail": "^1.0.0-beta.17",
-    "@nocobase/app-plugin-notification": "^2.0.0-beta.0",
+    "@nocobase/app-plugin-notification": "^2.0.0-beta.1",
     "@nocobase/app-plugin-notification-in-app": "^2.0.0-beta.0",
     "@nocobase/app-plugin-notification-providers": "^1.0.0-beta.15",
     "@nocobase/app-plugin-scheduler": "^1.0.0-beta.20",
@@ -161,9 +162,9 @@
     "@nocobase/db-sqlite": "^0.1.0-beta.6",
     "@nocobase/service-provider": "^0.0.2-beta.2",
     "@nocobase/snowflake": "^1.0.0-beta.4",
-    "@nocobase/app-plugin-authz-default-access": "^1.0.0-beta.15",
-    "@nocobase/app-plugin-authz-sharing-rules": "^1.0.0-beta.15",
-    "@nocobase/app-plugin-authz-restriction-rules": "^1.0.0-beta.14",
+    "@nocobase/app-plugin-authz-default-access": "^1.0.0-beta.16",
+    "@nocobase/app-plugin-authz-sharing-rules": "^1.0.0-beta.16",
+    "@nocobase/app-plugin-authz-restriction-rules": "^1.0.0-beta.15",
     "@nocobase/authorization": "^1.0.0-beta.15",
     "@nocobase/queue": "^0.1.0-beta.9",
     "@nocobase/jobs": "^0.1.0-beta.4",
@@ -171,7 +172,7 @@
     "@nocobase/i18n": "^2.0.0-beta.1",
     "@nocobase/caching": "^0.1.0-beta.3",
     "@nocobase/repository-input": "^0.1.0-beta.3",
-    "@nocobase/app-cli": "^1.0.0-beta.27",
+    "@nocobase/app-cli": "^1.0.0-beta.28",
     "@nocobase/realtime": "^0.1.0-beta.3"
   },
   "description": "NocoBase 3 application template with the standard product capabilities.",
@@ -188,7 +189,7 @@
     "dev": "nocobase dev",
     "build": "nocobase build",
     "start": "nocobase start",
-    "check": "pnpm lint && pnpm format:check && pnpm typecheck && pnpm test && pnpm build",
+    "check": "pnpm check:packages && pnpm lint && pnpm format:check && pnpm typecheck && pnpm test && pnpm build",
     "fix": "pnpm lint:fix && pnpm format",
     "typecheck": "tsc --noEmit && tsc -p tsconfig.node.json --noEmit && tsc -p tsconfig.server.json --noEmit",
     "lint": "eslint . --max-warnings 0",
@@ -198,6 +199,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "test:e2e": "playwright test --pass-with-no-tests"
+    "test:e2e": "playwright test --pass-with-no-tests",
+    "check:packages": "node scripts/check-packages.mjs"
   }
 }

package/scripts/check-packages.mjs

@@ -0,0 +1,46 @@
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+
+// Ask pnpm for exactly the packages the following check selects, respecting workspace exclusions.
+const root = path.resolve(import.meta.dirname, '..');
+const filter = './packages/**';
+const listed = spawnSync(
+  'pnpm',
+  ['--filter', filter, 'list', '--depth', '-1', '--json'],
+  {
+    cwd: root,
+    encoding: 'utf8',
+  },
+);
+if (listed.error) throw listed.error;
+if (listed.status !== 0) {
+  process.stderr.write(listed.stderr);
+  process.exit(listed.status ?? 1);
+}
+const packages = JSON.parse(listed.stdout || '[]');
+const missing = packages.filter(({ path: directory }) => {
+  const manifest = JSON.parse(
+    readFileSync(path.join(directory, 'package.json'), 'utf8'),
+  );
+  return (
+    typeof manifest.scripts?.check !== 'string' ||
+    !manifest.scripts.check.trim()
+  );
+});
+if (missing.length > 0) {
+  console.error(
+    'Every internal package must provide a non-empty check script:',
+  );
+  for (const entry of missing)
+    console.error(`  ${path.relative(root, entry.path)}`);
+  process.exit(1);
+}
+if (packages.length > 0) {
+  const result = spawnSync('pnpm', ['--filter', filter, 'check'], {
+    cwd: root,
+    stdio: 'inherit',
+  });
+  if (result.error) throw result.error;
+  process.exitCode = result.status ?? 1;
+}

package/tailwind.config.mjs

@@ -5,18 +5,12 @@
 // nothing, in this repository and in a generated application alike. Reading the directory first and resolving each
 // match to its real path gets past that, because `readdirSync` sees the symlinks and `realpathSync` resolves them.
 //
-// Client runtime files and canonical Registry source are both searched. A workspace plugin exposes TypeScript sources,
-// while an installed one may expose build output plus application-owned Registry recipes. Missing directories are skipped.
+// Scan plugin runtime source in a workspace and compiled output in installed packages. UI Library items installed
+// into the application are already covered by its own client source. Missing directories are skipped.
 import { existsSync, globSync, readdirSync, realpathSync } from 'node:fs';
 import path from 'node:path';
 
-const SOURCE_DIRECTORIES = [
-  'client',
-  'dist/client',
-  'src',
-  'dist/src',
-  'registry',
-];
+const SOURCE_DIRECTORIES = ['client', 'dist/client', 'src', 'dist/src'];
 const SCANNED_FILES = '**/*.{js,jsx,ts,tsx}';
 
 /** Every scannable directory a workspace or installed `@nocobase` package exposes. */

package/tests/client/list-return-state.test.tsx

@@ -0,0 +1,202 @@
+import type { AppClientRegisteredRoute } from '@nocobase/app-client/plugins';
+import {
+  TestI18nProvider,
+  createTestI18nRuntime,
+} from '@nocobase/i18n/testing';
+import { act, render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import {
+  createMemoryRouter,
+  Link,
+  Outlet,
+  RouterProvider,
+  useLocation,
+  useSearchParams,
+} from 'react-router';
+import { describe, expect, it } from 'vitest';
+import { Breadcrumbs } from '../../client/components/breadcrumbs.js';
+import { BackButton } from '../../client/components/back-button.js';
+import { RouteTreeProvider } from '../../client/routing/route-context.js';
+import enUS from '../../client/locales/en-US.js';
+
+const runtime = await createTestI18nRuntime({
+  application: { namespace: '@nocobase/navigation-test', resources: enUS },
+  strict: false,
+});
+const route = (
+  path: string,
+  title: string,
+  children: AppClientRegisteredRoute[] = [],
+): AppClientRegisteredRoute => ({
+  id: path,
+  name: path,
+  path,
+  auth: 'required',
+  packageName: 'test',
+  source: 'application',
+  breadcrumb: { title },
+  componentLoader: async () => ({ default: () => null }),
+  children,
+});
+const routes = [
+  route('/orders', 'Orders', [
+    route('/orders/:id', 'Order', [route('/orders/:id/lines', 'Lines')]),
+  ]),
+  route('/other', 'Other', [route('/other/:id', 'Other detail')]),
+];
+const initial = '/orders?q=Acme&status=open&page=2';
+function List() {
+  const [query, setQuery] = useSearchParams();
+  const { pathname } = useLocation();
+  return (
+    <>
+      <input
+        aria-label='Search'
+        value={query.get('q') ?? ''}
+        onChange={(event) => {
+          const next = new URLSearchParams(query);
+          next.set('q', event.target.value);
+          next.delete('page');
+          setQuery(next);
+        }}
+      />
+      <output data-testid='page'>{query.get('page') ?? '1'}</output>
+      <output data-testid='record'>
+        {query.get('q') || 'All'}-{query.get('page') ?? '1'}
+      </output>
+      <Link to={`${pathname}/42?detailPage=7&q=child`}>Open detail</Link>
+      <button onClick={() => setQuery({})}>Clear</button>
+    </>
+  );
+}
+function Detail() {
+  return (
+    <>
+      <BackButton />
+      <Link to='lines?linePage=9'>Open lines</Link>
+    </>
+  );
+}
+function setup(url = initial) {
+  const router = createMemoryRouter(
+    [
+      {
+        element: (
+          <TestI18nProvider runtime={runtime}>
+            <RouteTreeProvider routes={routes}>
+              <Breadcrumbs />
+              <Outlet />
+            </RouteTreeProvider>
+          </TestI18nProvider>
+        ),
+        children: [
+          {
+            path: '/orders',
+            children: [
+              { index: true, element: <List /> },
+              {
+                path: ':id',
+                children: [
+                  { index: true, element: <Detail /> },
+                  { path: 'lines', element: <h1>Lines</h1> },
+                ],
+              },
+            ],
+          },
+          {
+            path: '/other',
+            children: [
+              { index: true, element: <List /> },
+              { path: ':id', element: <Detail /> },
+            ],
+          },
+        ],
+      },
+    ],
+    { initialEntries: [url] },
+  );
+  render(<RouterProvider router={router} />);
+  return router;
+}
+
+describe('returning to a list', () => {
+  it('restores the actual list query through breadcrumbs across repeated visits', async () => {
+    const router = setup();
+    for (let i = 0; i < 3; i++) {
+      await userEvent.click(screen.getByRole('link', { name: 'Open detail' }));
+      expect(screen.getByRole('link', { name: 'Orders' })).toHaveAttribute(
+        'href',
+        initial,
+      );
+      await userEvent.click(screen.getByRole('link', { name: 'Orders' }));
+      expect(router.state.location.search).toBe('?q=Acme&status=open&page=2');
+      expect(screen.getByRole('textbox', { name: 'Search' })).toHaveValue(
+        'Acme',
+      );
+      expect(screen.getByTestId('page')).toHaveTextContent('2');
+      expect(screen.getByTestId('record')).toHaveTextContent('Acme-2');
+    }
+  });
+  it('restores list state through browser back and the standard BackButton', async () => {
+    const router = setup();
+    await userEvent.click(screen.getByRole('link', { name: 'Open detail' }));
+    await act(() => router.navigate(-1));
+    expect(screen.getByTestId('record')).toHaveTextContent('Acme-2');
+    await userEvent.click(screen.getByRole('link', { name: 'Open detail' }));
+    await userEvent.click(screen.getByRole('link', { name: 'Back' }));
+    expect(router.state.location.pathname).toBe('/orders');
+    expect(screen.getByTestId('record')).toHaveTextContent('Acme-2');
+  });
+  it('keeps each visited ancestor separate from a nested list query', async () => {
+    setup();
+    await userEvent.click(screen.getByRole('link', { name: 'Open detail' }));
+    await userEvent.click(screen.getByRole('link', { name: 'Open lines' }));
+    expect(screen.getByRole('link', { name: 'Orders' })).toHaveAttribute(
+      'href',
+      initial,
+    );
+    // Middle levels appear in both the desktop trail and the collapsed menu.
+    expect(screen.getByRole('link', { name: 'Order' })).toHaveAttribute(
+      'href',
+      '/orders/42?detailPage=7&q=child',
+    );
+  });
+  it('does not revive cleared filters or leak one list into another', async () => {
+    const router = setup();
+    await userEvent.click(screen.getByRole('button', { name: 'Clear' }));
+    await userEvent.click(screen.getByRole('link', { name: 'Open detail' }));
+    expect(screen.getByRole('link', { name: 'Orders' })).toHaveAttribute(
+      'href',
+      '/orders',
+    );
+    await act(() => router.navigate('/other?q=Beta&page=3'));
+    await userEvent.click(screen.getByRole('link', { name: 'Open detail' }));
+    expect(screen.getByRole('link', { name: 'Other' })).toHaveAttribute(
+      'href',
+      '/other?q=Beta&page=3',
+    );
+    await act(() => router.navigate('/orders/42?detailPage=8'));
+    expect(screen.getByRole('link', { name: 'Orders' })).toHaveAttribute(
+      'href',
+      '/orders',
+    );
+  });
+  it('does not apply a deep-linked detail query to an unvisited ancestor', () => {
+    setup('/orders/42?detailPage=7');
+    expect(screen.getByRole('link', { name: 'Orders' })).toHaveAttribute(
+      'href',
+      '/orders',
+    );
+  });
+  it('uses the latest search after changing conditions and resetting the page', async () => {
+    setup();
+    await userEvent.clear(screen.getByRole('textbox', { name: 'Search' }));
+    await userEvent.type(
+      screen.getByRole('textbox', { name: 'Search' }),
+      'Beta',
+    );
+    await userEvent.click(screen.getByRole('link', { name: 'Open detail' }));
+    await userEvent.click(screen.getByRole('link', { name: 'Orders' }));
+    expect(screen.getByTestId('record')).toHaveTextContent('Beta-1');
+  });
+});