import { YAML } from "$sb/plugos-syscall/mod.ts"; import { addParentPointers, collectNodesOfType, ParseTree, renderToText, replaceNodesMatchingAsync, traverseTreeAsync, } from "$sb/lib/tree.ts"; export type FrontMatter = { tags: string[] } & Record; // Extracts front matter (or legacy "meta" code blocks) from a markdown document // optionally removes certain keys from the front matter export async function extractFrontmatter( tree: ParseTree, removeKeys: string[] = [], removeFrontmatterSection = false, ): Promise { let data: FrontMatter = { tags: [], }; addParentPointers(tree); let paragraphCounter = 0; await replaceNodesMatchingAsync(tree, async (t) => { // Find tags in the first paragraph to attach to the page if (t.type === "Paragraph") { paragraphCounter++; // Only attach hashtags in the first paragraph to the page if (paragraphCounter !== 1) { return; } collectNodesOfType(t, "Hashtag").forEach((h) => { const tagname = h.children![0].text!.substring(1); if (!data.tags.includes(tagname)) { data.tags.push(tagname); } }); } // Find FrontMatter and parse it if (t.type === "FrontMatter") { const yamlNode = t.children![1].children![0]; const yamlText = renderToText(yamlNode); try { const parsedData: any = await YAML.parse(yamlText); const newData = { ...parsedData }; data = { ...data, ...parsedData }; // Make sure we have a tags array if (!data.tags) { data.tags = []; } // Normalize tags to an array and support a "tag1, tag2" notation if (typeof data.tags === "string") { data.tags = (data.tags as string).split(/,\s*/); } if (removeKeys.length > 0) { let removedOne = false; for (const key of removeKeys) { if (key in newData) { delete newData[key]; removedOne = true; } } if (removedOne) { yamlNode.text = await YAML.stringify(newData); } } // If nothing is left, let's just delete this whole block if (Object.keys(newData).length === 0 || removeFrontmatterSection) { return null; } } catch (e: any) { console.warn("Could not parse frontmatter", e.message); } } return undefined; }); if (data.name) { data.displayName = data.name; delete data.name; } return data; } // Updates the front matter of a markdown document and returns the text as a rendered string export async function prepareFrontmatterDispatch( tree: ParseTree, data: Record, ): Promise { let dispatchData: any = null; await traverseTreeAsync(tree, async (t) => { // Find FrontMatter and parse it if (t.type === "FrontMatter") { const bodyNode = t.children![1].children![0]; const yamlText = renderToText(bodyNode); try { const parsedYaml = await YAML.parse(yamlText) as any; const newData = { ...parsedYaml, ...data }; // Patch inline dispatchData = { changes: { from: bodyNode.from, to: bodyNode.to, insert: await YAML.stringify(newData), }, }; } catch (e: any) { console.error("Error parsing YAML", e); } return true; } return false; }); if (!dispatchData) { // If we didn't find frontmatter, let's add it dispatchData = { changes: { from: 0, to: 0, insert: "---\n" + await YAML.stringify(data) + "---\n", }, }; } return dispatchData; }