feat: generate OpenAPI spec API

[o-az]

ability to generate OpenAPI v3.2.0 automatically

import { Cli, Openapi, z } from 'incur'

const cli = Cli.create('my-cli', { description: 'My CLI' }).command('users list', {
  options: z.object({ limit: z.coerce.number().optional() }),
  run() {
    return { users: [] }
  },
})

const spec = Openapi.fromCli(cli)

validate: in exmaples/npm:

bun cli.ts

curl http://localhost:3000/openapi.json

note: other 'unrelated' changes are from pnpm check

playground https://stackblitz.com/edit/unjs-h3-sgf15m6f?file=server.mjs (visit /openapi.json in preview)

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/incur@139

commit: 91c79ad