Docs-v2/autogen/mdgen.js

const fs = require("fs")
const path = require("path")
const { XMLParser } = require("fast-xml-parser");

const xmlAPIPath = path.join(__dirname, "../", "xml", "types")
const mdAPIPath = path.join(__dirname, "../", "docs/api", "types")
const iconDataPath = path.join(__dirname, "../", "docs/theme/.icons", "polytoria")
const xmlEnumPath = path.join(__dirname, "../", "xml", "enums")
const mdEnumPath = path.join(__dirname, "../", "docs/api", "enums")

if (!fs.existsSync(mdAPIPath)) {
    fs.mkdirSync(mdAPIPath, { recursive: true })
}

if (!fs.existsSync(xmlAPIPath)) {
    fs.mkdirSync(xmlAPIPath, { recursive: true })
}

if (!fs.existsSync(mdEnumPath)) {
    fs.mkdirSync(mdEnumPath, { recursive: true })
}

if (!fs.existsSync(xmlEnumPath)) {
    fs.mkdirSync(xmlEnumPath, { recursive: true })
}

const parser = new XMLParser();

// Process API Classes
const xmlFiles = fs.readdirSync(xmlAPIPath).filter(file => file.endsWith('.xml'));

for (const xmlFile of xmlFiles) {
    const xmlPath = path.join(xmlAPIPath, xmlFile)
    const xmlContent = fs.readFileSync(xmlPath, "utf-8")
    const data = parser.parse(xmlContent)

    if (!data.ClassDef) continue;

    const c = data.ClassDef;
    const className = path.basename(xmlFile, '.xml')
    let mdPath = path.join(mdAPIPath, className + ".md")
    let mk = ""
    const iconPath = path.join(iconDataPath, c.Name + ".svg")

    function appendLine(str) {
        mk += str + "\n"
    }

    appendLine("---")
    appendLine("title: " + c.Name)
    appendLine("description:")
    if (fs.existsSync(iconPath)) {
        appendLine("icon: polytoria/" + c.Name)
    } else {
        appendLine("icon: polytoria/Unknown")
    }
    appendLine("---")
    appendLine("")
    appendLine("# " + c.Name)

    if (c.BaseType) {
        appendLine("")
        appendLine(`{{ inherits("${c.BaseType}") }}`)
    }

    appendLine("")
    appendLine(c.Description)
    appendLine("")

    if (c.IsStatic) {
        appendLine(`{{ staticclass(${c.Name.replace("Service", "")}) }}`)
        appendLine("")
    }

    if (c.IsAbstract) {
        appendLine("{{ abstract() }}")
        appendLine("")
    }

    if (!c.IsInstantiatable) {
        appendLine("{{ notnewable() }}")
        appendLine("")
    }

    appendLine("")
    appendLine("## Properties")
    appendLine("")

    const properties = c.Properties ? (Array.isArray(c.Properties) ? c.Properties : [c.Properties]) : [];
    for (const prop of properties) {
        appendLine(`### ${prop.Name}:${prop.Type} { property }`)
        appendLine(``)
        appendLine(prop.Description || "Missing documentation!")
        appendLine(``)
    }

    appendLine("")
    appendLine("## Methods")
    appendLine("")

    const methods = c.Methods ? (Array.isArray(c.Methods) ? c.Methods : [c.Methods]) : [];
    for (const m of methods) {
        if (m.IsObsolete) continue
        let params = []

        const parameters = m.Parameters ? (Array.isArray(m.Parameters) ? m.Parameters : [m.Parameters]) : [];
        for (const p of parameters) {
            params.push(`${p.Name};${p.Type}${p.IsOptional ? "?" : ""}`)
        }

        appendLine(`### ${m.Name}(${params.join(",")}):${m.ReturnType || "void"} { method }`)
        appendLine(``)
        appendLine(m.Description || "Missing documentation!")
        appendLine(``)
    }

    appendLine("")
    appendLine("## Events")
    appendLine("")

    const events = c.Events ? (Array.isArray(c.Events) ? c.Events : [c.Events]) : [];
    for (const e of events) {
        let args = []

        const aargs = e.Arguments ? (Array.isArray(e.Arguments) ? e.Arguments : [e.Arguments]) : [];
        for (const arg of aargs) {
            args.push(`${arg.Name};${arg.Type}`)
        }

        appendLine(`### ${e.Name}(${args.join(",")}) { event }`)
        appendLine(``)
        appendLine(e.Description || "")
        appendLine(``)
    }

    fs.writeFileSync(mdPath, mk)
}

console.log(`Converted ${xmlFiles.length} XML files to Markdown`)

// Process Enums
const xmlEnumFiles = fs.readdirSync(xmlEnumPath).filter(file => file.endsWith('.xml'));

for (const xmlFile of xmlEnumFiles) {
    const xmlPath = path.join(xmlEnumPath, xmlFile);
    const xmlContent = fs.readFileSync(xmlPath, "utf-8");
    const data = parser.parse(xmlContent);

    if (!data.EnumDef) continue;

    const e = data.EnumDef;
    const enumName = path.basename(xmlFile, '.xml');
    let mdPath = path.join(mdEnumPath, enumName + ".md")
    let mk = ""

    function appendLine(str) {
        mk += str + "\n"
    }

    appendLine("---")
    appendLine("title: " + e.Name)
    appendLine("description: " + (e.Description && e.Description !== "Missing Documentation" ? e.Description : ""))
    appendLine("icon: polytoria/Enum")
    appendLine("---")
    appendLine("")
    appendLine("# " + e.Name)
    appendLine("")

    if (e.Description && e.Description !== "Missing Documentation") {
        appendLine(e.Description)
        appendLine("")
    }

    appendLine("| Name | Description |")
    appendLine("| --- | --- |")

    const options = e.Options ? (Array.isArray(e.Options) ? e.Options : [e.Options]) : [];
    for (const option of options) {
        const optionName = typeof option === 'string' ? option : option.Name;
        const optionDesc = typeof option === 'string' ? "" : (option.Description || "");
        const displayDesc = optionDesc === "Missing Documentation" ? "" : optionDesc;
        appendLine(`| \`${e.Name}.${optionName}\` | ${displayDesc} |`)
    }

    fs.writeFileSync(mdPath, mk)
}

console.log(`Converted ${xmlEnumFiles.length} enum XML files to Markdown`)