dsh-agent
507bc90ed2
Excel 导出（原先 4 份各自拼装 workbook） - 新增 src/shared/xlsx.ts 作为唯一实现：文件名统一 .xlsx、sheet 名截断到 31 字符， 对外提供 buildAoaSheet / buildJsonSheet / writeWorkbook / exportAoaSheet / exportJsonSheet。 只收敛"组装与写出"这一层，各调用方仍自行决定列宽、冻结与数字格式，导出样式不变。 - 迁移 assets（内联 json_to_sheet + writeFile）、mileage/xlsx-export、 hydrogen 的两份 helper（prototype-download.ts 与 download-xls.js，均已删除）。 高德地图（原先 2 份近乎逐行复制） - 新增 src/shared/amap.ts：SDK 版本、插件列表、安全码注入、底图参数、 控件位置与热力图色带只在此处定义；两个画布只保留各自的半径/透明度。 - 图例渐变条原先把同一组色值又写了一遍，改为复用 shared 的常量，图例与地图不会漂移。 数值格式化 - 两个下钻视图各自复制了同样的 formatNumber/format（共 42 处调用）， 统一到 hydrogen/model/display-format.ts 的 formatFixed；默认路径与既有行为逐字一致。 - 原 display-format.ts 里的 finiteNumber/formatNumber/formatScaled 无任何生产调用方， 只被自己的测试引用；改为 formatFixed + blankForMissing 显式选项， 既保留了"真零 vs 不可用"的区分能力，也不再留无人使用的导出。测试同步重写。 失效的演示能力 - Blur / DemoModeProvider 恒为 enabled=false，等于永久 no-op： 移除 13 个文件里 50 处 <Blur> 包裹（渲染结果不变）、删除 components/Blur.tsx 与 Shell 中的 Provider，调用方直接渲染原表达式。 未做（刻意） - src/lib/cn.ts 不引入 tailwind-merge：全仓只有 2 处调用，不值得新增传递依赖。已在文档说明。 架构守护新增 2 条：只有 shared/amap.ts 可加载高德 SDK； modules/** 不得再出现 book_new / book_append_sheet / writeFile(。 lint / test(137) / build 全绿，可达性仍为 0 未引用文件。
60 lines
2.1 KiB
TypeScript
60 lines
2.1 KiB
TypeScript
import * as XLSX from 'xlsx';
|
|
|
|
/**
|
|
* Excel 导出的唯一实现。
|
|
*
|
|
* 此前仓库里有 4 份各自拼装 workbook 的代码（assets 内联、mileage 内联、
|
|
* hydrogen 的两份 aoa/json helper），产物后缀与 sheet 名截断规则也不一致。
|
|
* 这里只收敛"组装与写出"这一层原语；各调用方仍自行决定列宽、冻结与数字格式，
|
|
* 以免改变已验收的导出样式。
|
|
*/
|
|
|
|
export type AoaRow = Array<string | number | boolean | null | undefined>;
|
|
|
|
/** 统一产物后缀：内部一律写出 .xlsx。 */
|
|
export function ensureXlsxFilename(name: string | undefined): string {
|
|
const raw = String(name || 'export').trim() || 'export';
|
|
return `${raw.replace(/\.(csv|xls|xlsx)$/i, '')}.xlsx`;
|
|
}
|
|
|
|
/** 由二维数组构建 sheet。 */
|
|
export function buildAoaSheet(rows: AoaRow[]): XLSX.WorkSheet {
|
|
return XLSX.utils.aoa_to_sheet(rows);
|
|
}
|
|
|
|
/** 由对象数组构建 sheet（首行为字段名）。 */
|
|
export function buildJsonSheet(rows: Record<string, unknown>[]): XLSX.WorkSheet {
|
|
return XLSX.utils.json_to_sheet(rows);
|
|
}
|
|
|
|
/** Excel 的 sheet 名上限是 31 字符，空名回退为 Sheet1。 */
|
|
function safeSheetName(name: string): string {
|
|
return (name || 'Sheet1').slice(0, 31) || 'Sheet1';
|
|
}
|
|
|
|
/** 写出一本工作簿。调用方可先给 sheet 设置 `!cols` / `!freeze` / 单元格格式。 */
|
|
export function writeWorkbook(
|
|
sheets: Array<{ name: string; sheet: XLSX.WorkSheet }>,
|
|
fileName: string,
|
|
): void {
|
|
const workbook = XLSX.utils.book_new();
|
|
for (const { name, sheet } of sheets) {
|
|
XLSX.utils.book_append_sheet(workbook, sheet, safeSheetName(name));
|
|
}
|
|
XLSX.writeFile(workbook, ensureXlsxFilename(fileName));
|
|
}
|
|
|
|
/** 便捷：单个二维数组 sheet 直接下载。 */
|
|
export function exportAoaSheet(rows: AoaRow[], fileName: string, sheetName = 'Sheet1'): void {
|
|
writeWorkbook([{ name: sheetName, sheet: buildAoaSheet(rows) }], fileName);
|
|
}
|
|
|
|
/** 便捷：单个对象数组 sheet 直接下载。 */
|
|
export function exportJsonSheet(
|
|
rows: Record<string, unknown>[],
|
|
fileName: string,
|
|
sheetName = 'Sheet1',
|
|
): void {
|
|
writeWorkbook([{ name: sheetName, sheet: buildJsonSheet(rows) }], fileName);
|
|
}
|