import { renderToStaticMarkup } from 'react-dom/server' import { describe, expect, it, vi } from 'vitest' import { SourceCatalogBrowserView } from './SourceCatalogBrowser' import type { CatalogNode, CatalogNodePage, CatalogSource } from './sourceCatalog' import type { Job } from './jobs' const source: CatalogSource = { connection_id: 'conn-1', source_type: 'dingtalk', name: '公司级技术支持知识库', root_node_id: 'root-1', folder_count: 1080, file_count: 3468, observed_at: '2026-09-08T00:00:00Z', snapshot_only: true, snapshot_status: 'ready', last_refresh_duration_ms: 12000, } const node = (name: string, type: 'folder' | 'file', id: string) => ({ node_id: id, parent_node_id: 'root-1', node_type: type, name, direct_child_count: type === 'folder' ? 2 : 0, subtree_file_count: type === 'folder' ? 10 : 1, subtree_bytes: 1024, size_bytes: type === 'file' ? 1024 : undefined, visibility: type === 'folder' ? ('internal' as const) : ('unknown' as const), imported_count: type === 'folder' ? 8 : 0, parsed_count: type === 'folder' ? 7 : 0, active_count: 1, failed_count: 0, routable_count: type === 'file' ? 1 : 8, }) const page: CatalogNodePage = { current: { ...node('公司级技术支持知识库', 'folder', 'root-1'), parent_node_id: undefined }, breadcrumbs: [{ node_id: 'root-1', name: '公司级技术支持知识库' }], items: [node('01|产品总览与定位', 'folder', 'folder-1'), node('根目录说明.pdf', 'file', 'file-1')], total: 2, limit: 50, offset: 0, } describe('SourceCatalogBrowserView', () => { it('shows a source that is still doing its first scan, with progress', () => { const scanning: CatalogSource = { ...source, connection_id: 'conn-scan', name: '公司级营销资料管理', root_node_id: '', folder_count: 1153, file_count: 1428, snapshot_status: 'scanning', scan_progress: 36, scan_message: '正在扫描目录:已完成 470 个文件夹,待处理 683 个', last_refresh_duration_ms: 0, } const html = renderToStaticMarkup( ) // 新来源不必等快照落地就出现在列表里,并且带百分比。 for (const text of [ '公司级营销资料管理', '首次扫描中 36%', '首次扫描中 · 36%', '正在扫描目录:已完成 470 个文件夹,待处理 683 个', '已发现约 1428 份文件', ]) expect(html).toContain(text) // 还没有目录:不渲染空目录、也不提供标注/格式筛选入口。 expect(html).not.toContain('当前目录为空。') expect(html).not.toContain('禁止导入') }) it('uses a Windows-style path bar instead of a directory tree', () => { const html = renderToStaticMarkup( ) expect(html).toContain('aria-label="当前目录路径"') expect(html).toContain('aria-label="目录面包屑"') expect(html).toContain('aria-label="返回上一级"') expect(html).not.toContain('role="tree"') expect(html).not.toContain('目录树') for (const text of ['禁止导入即生效', '大小', '大小未提供', '总大小', '已知合计']) expect(html).not.toContain(text) expect(html).toContain('
') expect(html).toContain('文件格式筛选') expect(html).not.toMatch(/]*class="catalog-format-filter"[^>]*open/) }) it('looks like a folder browser and shows only direct children', () => { const html = renderToStaticMarkup( ) for (const text of [ '各个知识源头的资料总览与标注', '公司级技术支持知识库', '01|产品总览与定位', '文件夹', '已解析 7 / 已导入 8', '本地只读快照', '含所有子目录文件', ]) expect(html).toContain(text) expect(html).not.toContain('真实目录') expect(html).toContain('根目录说明.pdf') expect(html).not.toContain('显示根目录文件') expect(html).toContain('aria-label="当前目录路径"') expect(html).not.toContain('第 1 / 1 页') expect(html).not.toContain('PP分类 · 不代表完整原始目录') expect(html).toContain('快照时间') expect(html).toContain('快照就绪') expect(html).toContain('上次刷新耗时 12秒') expect(html).toContain('实时刷新目录') expect(html).not.toContain('aria-label="处理策略01|产品总览与定位"') expect(html).not.toContain('递归作用于全部子目录') }) it('shows current directory, discovered file counts and the estimate marker during refresh', () => { const job: Job = { id: 'job-scan', type: 'source.catalog.refresh', payload: { connection_id: 'conn-1', stage: 'scanning', progress: 43, message: '正在扫描目录:已完成 125 个文件夹,待处理 55 个', processed: 125, total: 180, current_directory: '产品资料/CR系列', scanned_files: 2438, estimated_total_files: 5662, total_is_estimate: true, }, state: 'running', priority: 20, available_at: '2026-09-09T00:00:00Z', attempt: 1, max_attempts: 3, idempotency_key: 'safe', created_at: '2026-09-09T00:00:00Z', updated_at: '2026-09-09T00:00:00Z', } const html = renderToStaticMarkup( ) expect(html).toContain('当前目录:产品资料/CR系列') expect(html).toContain('已发现 2438 份文件') expect(html).toContain('(估算)') }) it('hides the running refresh to a compact pill that expands back on click without blocking browsing', () => { const job: Job = { id: 'job-hide', type: 'source.catalog.refresh', payload: { connection_id: 'conn-1', stage: 'scanning', progress: 60, message: '正在扫描目录:已完成 1000 个文件夹', processed: 1000, total: 1339, current_directory: '产品资料/CR系列', scanned_files: 2438, }, state: 'running', priority: 20, available_at: '2026-09-09T00:00:00Z', attempt: 1, max_attempts: 3, idempotency_key: 'safe', created_at: '2026-09-09T00:00:00Z', updated_at: '2026-09-09T00:00:00Z', } const common = { sources: [source], selectedSource: source, page, loading: false, error: null, refreshJob: job, onSelectSource: vi.fn(), onOpenFolder: vi.fn(), onNavigateTo: vi.fn(), onBack: vi.fn(), onPageChange: vi.fn(), onRefresh: vi.fn(), } const full = renderToStaticMarkup( ) expect(full).toContain('隐藏到后台') expect(full).toContain('实时快照进度') expect(full).toContain('产品资料/CR系列') const hidden = renderToStaticMarkup( ) expect(hidden).not.toContain('实时快照进度') expect(hidden).toContain('catalog-refresh-pill') expect(hidden).toContain('60%') expect(hidden).toContain('公司级技术支持知识库') // pill still names the source // browsing and annotation stay interactive in hidden mode (only a duplicate refresh is blocked) expect(hidden).toContain('aria-label="选择01|产品总览与定位"') expect(hidden).toContain('aria-label="选择根目录说明.pdf"') expect(hidden).toContain('全选当前页') expect(hidden).toContain('实时刷新中…') }) it('announces failure safely and keeps old snapshot usable', () => { const job: Job = { id: 'job-fail', type: 'source.catalog.refresh', payload: { connection_id: 'conn-1', stage: 'failed', progress: 0, message: 'AList API Token 未配置,请联系管理员更新来源凭据;旧快照仍然保留', processed: 0, total: 0, }, state: 'failed', priority: 20, available_at: '2026-09-09T00:00:00Z', attempt: 3, max_attempts: 3, idempotency_key: 'safe', created_at: '2026-09-09T00:00:00Z', updated_at: '2026-09-09T00:00:00Z', } const html = renderToStaticMarkup( ) expect(html).toContain('实时刷新失败') expect(html).toContain('刷新失败;旧快照仍然保留,目录浏览与标注不受影响。') expect(html).toContain('快照就绪') expect(html).toContain('01|产品总览与定位') }) it('keeps the progress bar free of directory details when the scanner reports none', () => { const job: Job = { id: 'job-plain', type: 'source.catalog.refresh', payload: { connection_id: 'conn-1', stage: 'building', progress: 80, message: '正在校验目录结构', processed: 10, total: 10, }, state: 'running', priority: 20, available_at: '2026-09-09T00:00:00Z', attempt: 1, max_attempts: 3, idempotency_key: 'safe', created_at: '2026-09-09T00:00:00Z', updated_at: '2026-09-09T00:00:00Z', } const html = renderToStaticMarkup( ) expect(html).toContain('正在校验目录结构') expect(html).not.toContain('刷新明细') }) it('uses durable background refresh progress and the current stage message', () => { const job: Job = { id: 'job-refresh', type: 'source.catalog.refresh', payload: { connection_id: 'conn-1', stage: 'scanning', progress: 50, message: '正在扫描目录:已完成 50 个', processed: 50, total: 100, }, state: 'running', priority: 20, available_at: '2026-09-09T00:00:00Z', attempt: 1, max_attempts: 3, idempotency_key: 'safe', created_at: '2026-09-09T00:00:00Z', updated_at: '2026-09-09T00:00:00Z', } const html = renderToStaticMarkup( ) expect(html).toContain('实时刷新中') expect(html).toContain('正在扫描目录:已完成 50 个') expect(html).toContain('value="50"') }) it('uses clickable breadcrumbs and an explicit back action below the source root', () => { const nested = { ...page, current: { ...page.current, node_id: 'folder-1', parent_node_id: 'root-1', name: '01|产品总览与定位' }, breadcrumbs: [...page.breadcrumbs, { node_id: 'folder-1', name: '01|产品总览与定位' }], } const html = renderToStaticMarkup( ) expect(html).toContain('aria-label="返回上一级"') expect(html).toContain('公司级技术支持知识库') expect(html).toContain('01|产品总览与定位') }) it('shows policy as a read-only table state and offers top-level policy buttons', () => { const nested = { ...page, current: { ...page.current, node_id: 'folder-1', parent_node_id: 'root-1', name: '01|产品总览与定位' }, breadcrumbs: [...page.breadcrumbs, { node_id: 'folder-1', name: '01|产品总览与定位' }], items: [ node('可入队.pdf', 'file', 'file-ready'), node('已知目录', 'folder', 'folder-known'), { ...node('大小未知目录', 'folder', 'folder-unknown'), subtree_bytes: 0 }, { ...node('只有元数据.pdf', 'file', 'file-meta'), size_bytes: undefined, routable_count: 0 }, ], total: 4, } const html = renderToStaticMarkup( ) for (const text of ['名称', '处理策略', '全选当前页', '对内', '对外', '禁止导入', 'aria-label="选择可入队.pdf"']) expect(html).toContain(text) for (const text of [ 'class="catalog-policy-actions"', 'class="internal-policy-button"', 'class="external-policy-button"', 'class="blocked-policy-button"', 'class="selected-count"', ]) expect(html).toContain(text) for (const text of [ '操作人', '判断原因', '名称与处理策略', '当前策略', '选择策略', '批量处理策略', '应用策略', '对内 + 对外', ' { const nested = { ...page, current: { ...page.current, node_id: 'folder-1' }, breadcrumbs: [...page.breadcrumbs, { node_id: 'folder-1', name: '01|产品总览与定位' }], items: [node('可入队.pdf', 'file', 'file-ready'), node('已知目录', 'folder', 'folder-known')], total: 2, } const html = renderToStaticMarkup( ) // exactly three top-level policy buttons: 对内 / 对外 / 禁止导入 (docs/SOURCE_SCOPE_POLICY.md rules 4-6) expect((html.match(/class="[a-z-]+-policy-button"/g) || []).length).toBe(3) // rule 2: only current-page select-all exists expect(html).toContain('全选当前页') expect(html).not.toContain('递归全选') // rule 1: both file and folder rows expose selection checkboxes expect(html).toContain('aria-label="选择可入队.pdf"') expect(html).toContain('aria-label="选择已知目录"') // rules 5-6: no batch entry for historical 对内 + 对外 or for unset state expect(html).not.toContain('对内 + 对外') expect(html).not.toContain('批量未选择') }) it('lets an engineer select a directory without opening it', () => { const html = renderToStaticMarkup( ) expect(html).toContain('aria-label="选择01|产品总览与定位"') }) it('does not claim an empty source loaded when the request failed', () => { const html = renderToStaticMarkup( ) expect(html).toContain('加载失败') expect(html).not.toContain('尚无来源目录') }) })