City-Lifeline-Cockpit/.scratch/cockpit-shell-panel-layout/verify/t01-panel-catalog.mjs

/**
 * T01 纯逻辑检查：模式→面板映射、展开收放、全局筛选选项。
 *
 * 仓库没有配置测试运行器（node_modules 里没有 vitest/jest），
 * 且项目约定不为此引入新框架，所以这里用零依赖的 Node 断言脚本。
 *
 * 运行：node .scratch/cockpit-shell-panel-layout/verify/t01-panel-catalog.mjs
 */
import assert from 'node:assert/strict'
import {
    MODES,
    PANEL_LABELS,
    columnsForMode,
    defaultExpandedPanelIds,
    isKnownMode,
    isKnownPanel,
    labelForPanel,
    panelsForMode,
    toggleExpanded,
} from '../../../src/modules/cockpit/domain/panelCatalog.js'
import { DEFAULT_INDUSTRY, DEFAULT_SCOPE, INDUSTRIES, SCOPES, isKnownIndustry, isKnownScope } from '../../../src/modules/cockpit/domain/filterOptions.js'
import {
    getLifecycleStats,
    getMapInstance,
    mountMap,
    resetLifecycleStatsForTest,
    resizeMap,
    unmountMap,
} from '../../../src/modules/cockpit/services/mapService.js'
import { resolveCesiumBaseUrl } from '../../../src/modules/cockpit/services/cesiumAssets.js'

const EXPECTED_MODES = ['overview', 'infrastructure', 'monitoring', 'warningResponse']

// 模式键是稳定的 camelCase 四值，且顺序固定。
assert.deepEqual(MODES, EXPECTED_MODES, '一级模式键或顺序不符')
EXPECTED_MODES.forEach((mode) => assert.equal(isKnownMode(mode), true, `${mode} 应被识别`))
assert.equal(isKnownMode('总体概览'), false, '中文不得作为模式键')

// 每个模式恰好左右各两块，共四块。
EXPECTED_MODES.forEach((mode) => {
    const { left, right } = columnsForMode(mode)
    assert.equal(left.length, 2, `${mode} 左栏应为 2 块`)
    assert.equal(right.length, 2, `${mode} 右栏应为 2 块`)
    assert.equal(panelsForMode(mode).length, 4, `${mode} 应为 4 块面板`)
})

// 未知模式报错，不静默渲染空壳。
assert.throws(() => columnsForMode('unknownMode'), /未知一级模式/, '未知模式应报错')

// panelId 扁平、全局唯一、共 16 个，且每个都有中文展示名。
const allPanelIds = EXPECTED_MODES.flatMap((mode) => panelsForMode(mode))
assert.equal(allPanelIds.length, 16, '面板总数应为 16')
assert.equal(new Set(allPanelIds).size, 16, 'panelId 必须全局唯一')
allPanelIds.forEach((panelId) => {
    assert.equal(panelId.includes('.'), false, `panelId 不应带模式前缀: ${panelId}`)
    assert.equal(isKnownPanel(panelId), true, `${panelId} 应有中文展示名`)
    assert.notEqual(labelForPanel(panelId), panelId, `${panelId} 的中文名未解析`)
})
assert.equal(labelForPanel('noSuchPanel'), 'noSuchPanel', '未知面板应回退为原键')

// 进入模式时默认全部展开。
EXPECTED_MODES.forEach((mode) => {
    assert.deepEqual(defaultExpandedPanelIds(mode), panelsForMode(mode), `${mode} 默认应全部展开`)
})

// 展开集合的收放是纯函数：可来回切换，且不改动入参。
const initial = ['archive', 'operation']
const collapsed = toggleExpanded(initial, 'archive')
assert.deepEqual(collapsed, ['operation'], '已展开的面板应收起')
assert.deepEqual(initial, ['archive', 'operation'], 'toggleExpanded 不得改写入参')

const reExpanded = toggleExpanded(collapsed, 'archive')
// 展开集合语义上是无序集合（面板渲染顺序由目录决定），所以只断言成员与数量，不断言顺序。
assert.equal(reExpanded.includes('archive'), true, '收起后面板应能重新展开')
assert.equal(reExpanded.includes('operation'), true, '重展不得丢失其他已展开项')
assert.equal(reExpanded.length, collapsed.length + 1, '重展后集合应恰好多一项')

// ---- 全局筛选选项（范围 / 行业）----
assert.equal(SCOPES.length >= 2, true, '范围至少要有全域与其他区域')
assert.equal(INDUSTRIES.map((i) => i.key).join(','), 'all,gas,water,drainage,manhole', '行业键与顺序应按 ADR 0002')
assert.equal(DEFAULT_SCOPE, 'all', '默认范围为全域')
assert.equal(DEFAULT_INDUSTRY, 'all', '默认行业为全部')
assert.equal(SCOPES.some((s) => s.key === DEFAULT_SCOPE), true, '默认范围必须是合法选项')
assert.equal(INDUSTRIES.some((i) => i.key === DEFAULT_INDUSTRY), true, '默认行业必须是合法选项')
assert.equal(isKnownScope(DEFAULT_SCOPE), true, '默认范围应被识别')
assert.equal(isKnownIndustry('gas'), true, '燃气应被识别')
assert.equal(isKnownIndustry('电力'), false, '不在行业清单内的键应被拒绝')
assert.equal(isKnownScope('火星'), false, '不在范围清单内的键应被拒绝')

// ---- 地图服务生命周期（票 02）：只创建一次、幂等挂载、只在离开时销毁 ----
// 用普通对象冒充宿主要素，验证本模块不依赖 DOM。
resetLifecycleStatsForTest()
assert.equal(getLifecycleStats().created, 0, '初始不应有实例')
assert.equal(getMapInstance(), null, '初始应为未挂载')

const hostA = { id: 'host-a' }
const first = mountMap(hostA)
const again = mountMap({ id: 'host-b' })

assert.equal(first.id, again.id, '重复挂载必须返回同一实例（幂等，不重建）')
assert.equal(getLifecycleStats().created, 1, '全程只创建一次')
assert.equal(again.host, hostA, '重复挂载不得替换宿主要素')
assert.equal(getLifecycleStats().mounted, true, '挂载后应处于已挂载态')

resizeMap()
assert.equal(getLifecycleStats().resize, 1, '尺寸上报应被记录')
assert.equal(getLifecycleStats().lastResizeAt.length > 0, true, '尺寸上报应带时间戳')

unmountMap()
assert.equal(getLifecycleStats().destroyed, 1, '销毁应计一次')
assert.equal(getMapInstance(), null, '销毁后不应残留实例')
resizeMap()
assert.equal(getLifecycleStats().resize, 1, '未挂载时尺寸上报应被忽略')

const third = mountMap(hostA)
assert.notEqual(third.id, first.id, '销毁后重新挂载应是新实例（id 不复用）')
assert.equal(getLifecycleStats().created, 2, '重新挂载后创建数为 2')

// ---- Cesium 资源基址（票 27）：跟随 publicPath './' 与 qiankun 注入路径，不硬编码 /cesium/ ----
// hash 路由下文档 URL 是 index.html（#/cockpit 不参与解析）。
assert.equal(
    resolveCesiumBaseUrl('./', 'http://localhost:8000/#/cockpit'),
    'http://localhost:8000/cesium/',
    '相对 publicPath 应相对文档解析成绝对 URL（hash 路由不影响）',
)
assert.equal(
    resolveCesiumBaseUrl('./', 'http://host/app/index.html'),
    'http://host/app/cesium/',
    '子目录部署下应落在文档同级目录',
)
assert.equal(
    resolveCesiumBaseUrl('https://cos.icegl.cn/qiankun/tvt/', 'http://host/'),
    'https://cos.icegl.cn/qiankun/tvt/cesium/',
    'qiankun 注入的绝对基址应被采用',
)
assert.equal(resolveCesiumBaseUrl('/base/', 'http://host/'), 'http://host/base/cesium/', '根相对基址应被采用')
assert.equal(resolveCesiumBaseUrl().endsWith('/cesium/'), true, '默认基址也必须以 cesium/ 结尾')

// ---- 非浏览器宿主：不加载引擎、不抛错，且如实标注（票 27）----
resetLifecycleStatsForTest()
const domlessHost = { id: 'not-a-dom-node' }
mountMap(domlessHost)
assert.equal(getLifecycleStats().engine, 'unavailable', '非 DOM 宿主不应启动引擎')
assert.equal(getLifecycleStats().basemap, 'not-configured', '本票不配置底图，状态应如实为未配置')
assert.equal(getLifecycleStats().created, 1, '非 DOM 宿主仍应正常记一次创建')
unmountMap()

resetLifecycleStatsForTest()
assert.equal(getLifecycleStats().created, 0, '重置后计数应归零')
assert.equal(getLifecycleStats().engine, 'idle', '重置后引擎状态应回到 idle')

console.log(
    `T01 检查通过：${EXPECTED_MODES.length} 个模式 / ${allPanelIds.length} 个面板 / 展开收放与默认展开一致 / 筛选选项（${SCOPES.length} 范围 · ${INDUSTRIES.length} 行业）正确 / 地图服务生命周期幂等且只创建一次 / Cesium 资源基址相对 publicPath 解析正确。`,
)