Notes/src/services/in_app_help.ts

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;
}