ttrpg-tools/src/components/utils/csv-loader.ts

import { parse } from 'csv-parse/browser/esm/sync';

/**
 * 全局缓存已加载的 CSV 内容
 */
const csvCache = new Map<string, Record<string, string>[]>();

/**
 * 加载 CSV 文件
 * @template T 返回数据的类型，默认为 Record<string, string>
 */
export async function loadCSV<T = Record<string, string>>(path: string): Promise<T[]> {
  if (csvCache.has(path)) {
    return csvCache.get(path)! as T[];
  }

  const response = await fetch(path);
  const content = await response.text();
  const records = parse(content, {
    columns: true,
    comment: '#',
    trim: true,
    skipEmptyLines: true
  });

  const result = records as Record<string, string>[];
  csvCache.set(path, result);
  return result as T[];
}