71 lines
2.7 KiB
TypeScript
71 lines
2.7 KiB
TypeScript
// FrontmatterCodec — 文件头 frontmatter 解析/序列化（FR-M1/M2）
|
||
// 仅 4 个业务字段：title? / tags? / star? / links?；空数组与默认值不落盘
|
||
import type { DocMeta } from './doc.js';
|
||
|
||
const FENCE = '---';
|
||
|
||
// 解析：返回 { meta, body }；无 frontmatter 时 meta={} body=原文
|
||
export function splitFrontmatter(raw: string): { meta: DocMeta; body: string } {
|
||
// 必须以 --- 开头（允许前导空白行后紧跟围栏）
|
||
const m = raw.match(/^\s*---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
|
||
if (!m) return { meta: {}, body: raw };
|
||
const yaml = m[1];
|
||
const body = m[2];
|
||
return { meta: parseYaml(yaml), body };
|
||
}
|
||
|
||
// 序列化：把 meta + body 合并为完整文件文本；默认值与空数组不写入
|
||
export function joinFrontmatter(meta: DocMeta, body: string): string {
|
||
const yaml = serializeYaml(meta);
|
||
if (!yaml) return body;
|
||
return `${FENCE}\n${yaml}${FENCE}\n${body}`;
|
||
}
|
||
|
||
// ---- 极简 YAML 子集解析（只支持本项目 4 字段的形态）----
|
||
function parseYaml(yaml: string): DocMeta {
|
||
const meta: DocMeta = {};
|
||
const lines = yaml.split(/\r?\n/);
|
||
for (const line of lines) {
|
||
if (!line.trim() || line.trim().startsWith('#')) continue;
|
||
const kv = line.match(/^([a-zA-Z]+):\s*(.*)$/);
|
||
if (!kv) continue;
|
||
const [, key, val] = kv;
|
||
const v = val.trim();
|
||
if (key === 'title') meta.title = unquote(v);
|
||
else if (key === 'star') meta.star = v === 'true';
|
||
else if (key === 'tags') meta.tags = parseList(v);
|
||
else if (key === 'links') meta.links = parseList(v);
|
||
}
|
||
return meta;
|
||
}
|
||
|
||
function parseList(v: string): string[] {
|
||
// 内联数组 [a, b] 或流式；本项目只用内联
|
||
const m = v.match(/^\[\s*(.*)\s*\]$/);
|
||
if (!m) return [];
|
||
const inner = m[1].trim();
|
||
if (!inner) return [];
|
||
return inner.split(',').map(s => unquote(s.trim())).filter(Boolean);
|
||
}
|
||
|
||
function unquote(s: string): string {
|
||
const m = s.match(/^['"](.*)['"]$/);
|
||
return m ? m[1] : s;
|
||
}
|
||
|
||
// ---- 序列化：剔除默认值与空数组 ----
|
||
function serializeYaml(meta: DocMeta): string {
|
||
const lines: string[] = [];
|
||
if (meta.title !== undefined && meta.title !== '') lines.push(`title: ${quoteIfNeeded(meta.title)}`);
|
||
if (meta.tags && meta.tags.length > 0) lines.push(`tags: [${meta.tags.map(quoteIfNeeded).join(', ')}]`);
|
||
if (meta.star === true) lines.push('star: true');
|
||
if (meta.links && meta.links.length > 0) lines.push(`links: [${meta.links.map(quoteIfNeeded).join(', ')}]`);
|
||
return lines.length ? lines.join('\n') + '\n' : '';
|
||
}
|
||
|
||
function quoteIfNeeded(s: string): string {
|
||
// 含特殊字符（冒号/井号/方括号/引号/前后空格）则加引号
|
||
if (/[:#\[\]"']|^\s|\s$/.test(s)) return JSON.stringify(s);
|
||
return s;
|
||
}
|