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 [
'操作人',
'判断原因',
'名称与处理策略',
'当前策略',
'选择策略',
'批量处理策略',
'应用策略',
'对内 + 对外',
'