feat(in-app-help): create notes at root level

src/services/in_app_help.ts

@@ -0,0 +1,47 @@
+import path from "path";
+import fs from "fs";
+import type { HiddenSubtreeItem } from "./hidden_subtree.js";
+import type NoteMeta from "./meta/note_meta.js";
+import type { NoteMetaFile } from "./meta/note_meta.js";
+import { fileURLToPath } from "url";
+import { isDev } from "./utils.js";
+
+export function getHelpHiddenSubtreeData() {
+    const srcRoot = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
+    const appDir = path.join(srcRoot, "public", isDev ? "app" : "app-dist");
+    const helpDir = path.join(appDir, "doc_notes", "en", "User Guide");
+    const metaFilePath = path.join(helpDir, "!!!meta.json");
+    const metaFileContent = JSON.parse(fs.readFileSync(metaFilePath).toString("utf-8"));
+
+    try {
+        return parseNoteMetaFile(metaFileContent as NoteMetaFile);
+    } catch (e) {
+        console.warn(e);
+        return [];
+    }
+}
+
+function parseNoteMetaFile(noteMetaFile: NoteMetaFile): HiddenSubtreeItem[] {
+    if (!noteMetaFile.files) {
+        return [];
+    }
+
+    const metaRoot = noteMetaFile.files[0];
+    const items: HiddenSubtreeItem[] = [];
+
+    for (const childMeta of metaRoot.children ?? []) {
+        items.push(parseNoteMeta(childMeta));
+    }
+
+    return items;
+}
+
+function parseNoteMeta(noteMeta: NoteMeta): HiddenSubtreeItem {
+    const item: HiddenSubtreeItem = {
+        id: `_help_${noteMeta.noteId}`,
+        title: noteMeta.title,
+        type: "doc"
+    };
+
+    return item;
+}