luau-unzip/.lune/docsgen/init.luau

--> Generate markdown documentation from moonwave comments

local process = require("@lune/process")
local serde = require("@lune/serde")

local moonwave = require("./moonwave")
local logger = require("./log")
local writeMarkdown = require("./markdown")

local function extract(input: string): (number, { moonwave.Item }?)
  local res = process.spawn("moonwave-extractor", { "extract", input }, {
    stdio = {
      stderr = "forward"
    }
  })

  if not res.ok then
    print()
    logger.log("error", "`moonwave-extractor` failed with exit code", res.code)
    return res.code, nil
  end

  local ok, items: { moonwave.Item } = pcall(serde.decode, "json" :: "json", res.stdout)
  if not ok then 
    return 1, nil
  end

  return 0, items
end

local code, items = extract("lib/init.luau")
writeMarkdown("./docs/index.md", items :: { moonwave.Item })

process.exit(code)