# 预设用 ES module 而不是 JSON

每档壁纸的 `preset.js` 是 `export default {...}` 的 ES module，而不是由 `fetch` 拉取的 `preset.json`。

理由是资源路径的自包含性：模块内用 `import.meta.url` 推导 `./images/...` 的绝对 URL，于是整个壁纸目录可以被复制、改名、搬家而不需要改任何一行路径。若用 JSON，路径只能以**页面**为基准写死，一旦目录改名（本项目的目录名就是显示名，改标题=改目录）就会全站 404，且每档壁纸都必须先异步取回 JSON 才能建播放器，给启动时序又加一个竞态点。

代价：配置文件不再是纯数据，不能直接 `JSON.parse` 消费。本项目接受这一点——预设数据量极小，且始终由代码持有。

## 修订（2026-09，随 TS 构建管线）

**结论不变：产物仍然是 `preset.js`，仍然用 `import.meta.url` 推导路径。** 但当初拒绝 JSON 的两条理由里有一条已经不成立，需要更正：

- ~~"目录名就是显示名，改标题=改目录"~~ —— 目录名已改为**稳定的 id**（见 ADR 0005），显示名只存在于元数据与 `project.json` 里，改标题不再需要碰目录。这条理由作废。
- "以页面为基准写死路径会在改名后 404" —— 仍然成立，且仍然是不用 `fetch` + JSON 的理由：JSON 里的路径只能相对**页面**解析，而 `preset.js` 能相对**自己**解析，后者才能在合集分发里按深度现算（单档 `./audios/`、游戏合集 `../audios/`、全部合集 `../../audios/`）。
- "异步取 JSON 会给启动时序再加一个竞态点" —— 仍然成立。

**新增的写法约定**：`preset.js` 不再手写，而是由 `pnpm build` 从 `preset.template.json`（**JSON，路径相对壁纸目录**）生成。也就是说"用 JSON 写、生成成 ES module"——两条路的好处各取一半：编辑期是纯数据（可 diff、可校验、好工具化），运行期仍是自包含的 ES module。