@travetto/doc 3.0.2 → 3.0.3

package/README.md

@@ -1,6 +1,7 @@
 <!-- This file was generated by @travetto/doc and should not be modified directly -->
-<!-- Please modify https://github.com/travetto/travetto/tree/main/module/doc/DOC.ts and execute "npx trv doc" to rebuild -->
+<!-- Please modify https://github.com/travetto/travetto/tree/main/module/doc/DOC.tsx and execute "npx trv doc" to rebuild -->
 # Documentation
+
 ## Documentation support for the Travetto framework
 
 **Install: @travetto/doc**
@@ -12,92 +13,80 @@ npm install @travetto/doc
 yarn add @travetto/doc
 ```
 
-This module provides the ability to generate documentation in [HTML](https://en.wikipedia.org/wiki/HTML) and/or [Markdown](https://en.wikipedia.org/wiki/Markdown).  The module relies on integrating with the source of the project, and providing a fully referenced code-base.  This allows for automatic updates when code is changed and/or refactored. 
+This module provides the ability to generate documentation in [HTML](https://en.wikipedia.org/wiki/HTML) and/or [Markdown](https://en.wikipedia.org/wiki/Markdown).  The module relies on integrating with the source of the project, and providing a fully referenced code-base.  This allows for automatic updates when code is changed and/or refactored.
 
 **Code: Document Sample**
 ```typescript
-import { d, mod } from '@travetto/doc';
-
-export const text = () => d`
-${d.Header()}
-
-Sample documentation for fictional module.  This module fictitiously relies upon ${mod.Cache} functionality.
+/** @jsxImportSource @travetto/doc */
+import { c } from '@travetto/doc';
 
-${d.Ordered(
-  'First',
-  'Second',
-  d.Path('Special')
-)}
+export const text = <>
+  <c.StdHeader />
 
-${d.Section('Content')}
+  Sample documentation for fictional module.  This module fictitiously relies upon <c.Mod name='Cache' /> functionality.
 
-${d.Code('Document Sample', './src/test.ts')}
+  <ol>
+    <li>First</li>
+    <li>Second</li>
+    <li><c.Path name='Special' /></li>
+  </ol>
 
-${d.SubSection('Output')}
+  <c.Section title='Content'>
+    <c.Code title='Document Sample' src='./src/test.ts' />
 
-${d.Execute('Run program', 'trv')}
-`;
+    <c.SubSection title='Output'>
+      <c.Execution title='Run program' cmd='trv' />
+    </c.SubSection>
+  </c.Section>
+</>;
 ```
 
 **Code: Document Context**
 ```typescript
-export interface DocumentShape<T extends DocNode = DocNode> {
-  text: () => (T | Promise<T>);
+export interface DocumentShape {
+  text: JSXElement | JSXElement[] | (() => Promise<JSXElement | JSXElement[]>);
   wrap?: Wrapper;
 }
 ```
 
-As you can see, you need to export a field named `text` as the body of the help text. The `text` field can be either a direct invocation or an async function that returns the expected document output.  
+As you can see, you need to export a field named `text` as the body of the help text. The `text` field can be either a direct invocation or an async function that returns the expected document output.
 
 **Note**: By design all the node types provided are synchronous in nature.  This is intentionally, specifically with respect to invoking commands and ensuring singular operation.
 
 ## Node Types
 
-   
    *  `Anchor` - In page anchor reference
    *  `Class` - Class reference
    *  `Code` - Code sample
+   *  `CodeLink` - Code link with regexp for detecting line
    *  `Command` - Command invocation
-   *  `Comment` - Comment
-   *  `Config` - Configuration Block
-   *  `Execute` - Run a command, and include the output as part of the document
+   *  `Config` - Configuration block
+   *  `Execution` - Run a command, and include the output as part of the document
    *  `Field` - Field reference
-   *  `Group` - Group of content nodes
-   *  `Header` - Standard header
+   *  `File` - File reference
+   *  `Header` - Basic module header
    *  `Image` - Image reference
    *  `Input` - Input text
-   *  `Install` - Installing a package or program
-   *  `Item` - List item
+   *  `Install` - Installing a package or a program
    *  `Library` - Library reference
-   *  `List` - Standard List
    *  `Method` - Method declaration
    *  `Mod` - Node Module Reference
    *  `Note` - A note
-   *  `Ordered` - Ordered List
    *  `Path` - Path reference
-   *  `RawHeader` - Raw Doc Header
    *  `Ref` - File reference
-   *  `Section` - Primary Section
-   *  `Snippet` - Code Snippet
-   *  `SnippetLink` - Link to a snippet of code, including line number
-   *  `Strong` - Strong Content
+   *  `Section` - Primary section
+   *  `StdHeader` - Standard module header
    *  `SubSection` - Sub-section
    *  `SubSubSection` - Sub-sub-section
-   *  `Table` - Table
-   *  `TableOfContents` - Table Of Contents
    *  `Terminal` - Terminal output
-   *  `Text` - Simple Text Contentf
 
 ## Libraries
-
-Some of the more common libraries are provided as the `lib` field.  The purpose of this is to have consistent references to common utilities to help keep external linking simple.
+Some of the more common libraries are provided as the `d.library` method.  The purpose of this is to have consistent references to common utilities to help keep external linking simple.
 
 ## Modules
-
-You can also link to other [Travetto](https://travetto.dev) based modules as needed.  The `mod` object relies on what is already imported into your project, and reference the package.json of the related module. If the module is not installed, doc generation will fail.
+You can also link to other [Travetto](https://travetto.dev) based modules as needed.  The `d.mod` object relies on what is already imported into your project, and reference the package.json of the related module. If the module is not installed, doc generation will fail.
 
 ## CLI - doc
-
 The run command allows for generating documentation output.
 
 **Terminal: CLI Doc Help**
@@ -107,7 +96,7 @@ $ trv doc --help
 Usage:  doc [options]
 
 Options:
-  -i, --input <input>      Input File (default: "DOC.ts")
+  -i, --input <input>      Input File (default: "DOC.tsx")
   -o, --outputs <outputs>  Outputs (default: [])
   -w, --watch              Watch
   -h, --help               display help for command
@@ -120,46 +109,45 @@ By default, running the command will output the [Markdown](https://en.wikipedia.
 $ trv doc -o html
 
 <!-- This file was generated by @travetto/doc and should not be modified directly -->
-<!-- Please modify ./doc-exec/DOC.ts and execute "npx trv doc" to rebuild -->
-<h1>@travetto-doc/doc
-          
-        </h1>
+<!-- Please modify ./doc-exec/DOC.tsx and execute "npx trv doc" to rebuild -->
+<h1>@travetto-doc/doc</h1>
 
-      <figure class="install">
-      <figcaption class="install">Install @travetto-doc/doc
-      
-      </figcaption>
-      <pre><code class="language-bash"><span class="token function">npm</span> <span class="token function">install</span> @travetto-doc/doc
+  <figure class="install">
+    <figcaption class="install">Install @travetto-doc/doc
+    
+    </figcaption>
+    <pre><code class="language-bash"><span class="token function">npm</span> <span class="token function">install</span> @travetto-doc/doc
 
 <span class="token comment"># or</span>
 
-<span class="token function">yarn</span> <span class="token function">add</span> @travetto-doc/doc</code></pre>     
-      </figure>
+<span class="token function">yarn</span> <span class="token function">add</span> @travetto-doc/doc</code></pre>
+  </figure>
 
 Sample documentation for fictional module.  This module fictitiously relies upon <a class="module-link" href="https://github.com/travetto/travetto/tree/main/module/cache" title="Caching functionality with decorators for declarative use.">Caching</a> functionality.
-
 <ol> <li>First</li>
- <li>Second</li>
- <li><code class="item path">Special</code></li></ol>
+<li>Second</li>
+<li><code class="item path">Special</code></li>
+</ol>
 
 <h2 id="content">Content</h2>
 
-      <figure class="code">
-      <figcaption class="code">Document Sample
-      <cite><a target="_blank" href="./doc-exec/src/test.ts">Source</a></cite>
-      </figcaption>
-      <pre><code class="language-typescript"><span class="token keyword">class</span> <span class="token class-name">TestFile</span> <span class="token punctuation">{{'{'}}</span>
+  <figure class="code">
+    <figcaption class="code">Document Sample
+<cite><a target="_blank" href="./doc-exec/src/test.ts">Source</a></cite>
+
+</figcaption>
+    <pre><code class="language-typescript"><span class="token keyword">class</span> <span class="token class-name">TestFile</span> <span class="token punctuation">{{'{'}}</span>
   <span class="token keyword">static</span> <span class="token function">method</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token operator">:</span> <span class="token keyword">void</span> <span class="token punctuation">{{'{'}}</span> <span class="token punctuation">{{'}'}}</span>
-<span class="token punctuation">{{'}'}}</span></code></pre>     
-      </figure>
+<span class="token punctuation">{{'}'}}</span></code></pre>
+  </figure>
 
 <h3 id="output">Output</h3>
 
-      <figure class="terminal">
-      <figcaption class="terminal">Run program
-      
-      </figcaption>
-      <pre><code class="language-bash">$ trv
+  <figure class="terminal">
+    <figcaption class="terminal">Run program
+
+</figcaption>
+    <pre><code class="language-bash">$ trv
 
 Usage:  <span class="token punctuation">[</span>options<span class="token punctuation">]</span> <span class="token punctuation">[</span>command<span class="token punctuation">]</span>
 
@@ -170,6 +158,6 @@ Options:
 Commands:
   doc <span class="token punctuation">[</span>options<span class="token punctuation">]</span>
   main <span class="token operator">&lt;</span>fileOrImport<span class="token operator">></span> <span class="token punctuation">[</span>args<span class="token punctuation">..</span>.<span class="token punctuation">]</span>
-  <span class="token builtin class-name">help</span> <span class="token punctuation">[</span>command<span class="token punctuation">]</span>                 display <span class="token builtin class-name">help</span> <span class="token keyword">for</span> <span class="token builtin class-name">command</span></code></pre>     
-      </figure>
+  <span class="token builtin class-name">help</span> <span class="token punctuation">[</span>command<span class="token punctuation">]</span>                 display <span class="token builtin class-name">help</span> <span class="token keyword">for</span> <span class="token builtin class-name">command</span></code></pre>
+  </figure>
 ```

package/__index__.ts

@@ -1,4 +1,3 @@
-export { node } from './src/nodes';
-export { lib } from './src/lib';
-export { mod } from './src/mod';
-export { doc, d } from './src/doc';
+export { JSXElement as DocJSXElement, isJSXElement as isDocJSXElement } from './jsx-runtime';
+export { c, d, JSXElementByFn as DocJSXElementByFn } from './src/jsx';
+export { MOD_MAPPING as mod } from './src/mapping/mod-mapping';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@travetto/doc",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "Documentation support for the Travetto framework",
   "keywords": [
     "docs",
@@ -24,12 +24,12 @@
     "directory": "module/doc"
   },
   "dependencies": {
-    "@travetto/base": "^3.0.2",
+    "@travetto/base": "^3.0.3",
     "@types/prismjs": "^1.26.0",
     "prismjs": "^1.29.0"
   },
   "peerDependencies": {
-    "@travetto/cli": "^3.0.2"
+    "@travetto/cli": "^3.0.3"
   },
   "peerDependenciesMeta": {
     "@travetto/cli": {

package/src/jsx.ts

@@ -0,0 +1,107 @@
+import { createElement, JSXElement, JSXComponentFunction as CompFn } from '@travetto/doc/jsx-runtime';
+import { TypedObject } from '@travetto/base';
+
+import { LIB_MAPPING } from './mapping/lib-mapping';
+import { MOD_MAPPING } from './mapping/mod-mapping';
+import { RunConfig } from './util/run';
+
+type CodeProps = { title: string, src: string | Function, language?: string, outline?: boolean, startRe?: RegExp, endRe?: RegExp };
+type InstallProps = { title: string, pkg: string };
+type ExecProps = { title: string, cmd: string, args?: string[], config?: RunConfig & { formatCommand?(cmd: string, args: string[]): string } };
+type StdHeaderProps = { mod?: string, install?: boolean };
+type HeaderProps = { title: string, description?: string };
+type ModProps = { name: keyof typeof MOD_MAPPING };
+type LibraryProps = { name: keyof typeof LIB_MAPPING };
+type LinkProps = { title: string, href: string, line?: number };
+type CodeLinkProps = { title: string, src: string | Function, startRe: RegExp };
+type Named = { name: string };
+type Titled = { title: string };
+
+const EMPTY: JSXElement = { type: '', key: '', props: {} };
+
+const Input: CompFn<Named> = () => EMPTY; // Input text
+const Field: CompFn<Named> = () => EMPTY; // Field reference
+const Method: CompFn<Named> = () => EMPTY; // Method declaration
+const Command: CompFn<Named> = () => EMPTY; // Command invocation
+const Path: CompFn<Named> = () => EMPTY; // Path reference
+const Class: CompFn<Named> = () => EMPTY; // Class reference
+
+const CodeLink: CompFn<CodeLinkProps> = () => EMPTY; // Code link with regexp for detecting line
+const Anchor: CompFn<LinkProps> = () => EMPTY; // In page anchor reference
+const Ref: CompFn<LinkProps> = () => EMPTY; // File reference
+const File: CompFn<LinkProps> = () => EMPTY; // File reference
+const Image: CompFn<LinkProps> = () => EMPTY; // Image reference
+
+const Note: CompFn = () => EMPTY; // A note
+const Section: CompFn<Titled> = () => EMPTY; // Primary section
+const SubSection: CompFn<Titled> = () => EMPTY; // Sub-section
+const SubSubSection: CompFn<Titled> = () => EMPTY; // Sub-sub-section
+
+const Code: CompFn<CodeProps> = () => EMPTY; // Code sample
+const Terminal: CompFn<CodeProps> = () => EMPTY; // Terminal output
+const Install: CompFn<InstallProps> = () => EMPTY; // Installing a package or a program
+const Config: CompFn<CodeProps> = () => EMPTY; // Configuration block
+
+const StdHeader: CompFn<StdHeaderProps> = () => EMPTY; // Standard module header
+const Header: CompFn<HeaderProps> = () => EMPTY; // Basic module header
+const Execution: CompFn<ExecProps> = () => EMPTY; // Run a command, and include the output as part of the document
+
+const Mod: CompFn<ModProps> = () => EMPTY; // Node Module Reference
+const Library: CompFn<LibraryProps> = () => EMPTY; // Library reference
+
+export const c = {
+  Input, Field, Method, Command, Path, Class,
+  Anchor, Library, Ref, File, Image, CodeLink,
+  Mod, Note, Header, StdHeader,
+  Section, SubSection, SubSubSection,
+  Code, Execution, Terminal, Install, Config
+} as const;
+
+type C = typeof c;
+
+// @ts-expect-error
+export type JSXElementByFn<K extends keyof C> = JSXElement<C[K], Parameters<C[K]>[0]>;
+export type JSXElements = { [K in keyof C]: JSXElementByFn<K>; };
+
+export const EMPTY_ELEMENT = EMPTY;
+
+const invertedC = new Map<Function, string>(TypedObject.entries(c).map(p => [p[1], p[0]] as [CompFn, string]));
+
+export function getComponentName(fn: Function | string): string {
+  if (typeof fn === 'string') {
+    return fn;
+  }
+  return invertedC.get(fn) ?? fn.name;
+}
+
+function CodeLinker(node: JSXElement): JSXElementByFn<'CodeLink'>;
+function CodeLinker(title: string, src: string, startRe: RegExp): JSXElementByFn<'CodeLink'>;
+function CodeLinker(titleOrNode: string | JSXElement, src?: string, startRe?: RegExp): JSXElementByFn<'CodeLink'> {
+  let props: CodeLinkProps;
+  if (typeof titleOrNode === 'string') {
+    props = { title: titleOrNode, src: src!, startRe: startRe! };
+  } else if (titleOrNode.type === Code) {
+    const node = titleOrNode as unknown as JSXElementByFn<'Code'>;
+    props = {
+      title: node.props.title,
+      src: node.props.src,
+      startRe: node.props.startRe!
+    };
+  } else {
+    throw new Error(`Unsupported element type: ${titleOrNode.type}`);
+  }
+  return createElement(c.CodeLink, props) as JSXElementByFn<'CodeLink'>;
+}
+
+export const d = {
+  ref: (title: string, src: string) => createElement(c.Ref, { title, href: src }),
+  codeLink: CodeLinker,
+  input: (name: string) => createElement(c.Input, { name }),
+  method: (name: string) => createElement(c.Method, { name }),
+  class: (name: string) => createElement(c.Class, { name }),
+  path: (name: string) => createElement(c.Path, { name }),
+  command: (name: string) => createElement(c.Command, { name }),
+  field: (name: string) => createElement(c.Field, { name }),
+  library: (name: keyof typeof LIB_MAPPING) => createElement(c.Library, { name }),
+  mod: (name: keyof typeof MOD_MAPPING) => createElement(c.Mod, { name }),
+};

package/src/mapping/lib-mapping.ts

@@ -0,0 +1,107 @@
+export const LIB_MAPPING = {
+  Travetto: { title: 'Travetto', href: 'https://travetto.dev' },
+  Typescript: { title: 'Typescript', href: 'https://typescriptlang.org' },
+  Javascript: { title: 'Javascript', href: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript' },
+  Node: { title: 'Node', href: 'https://nodejs.org' },
+  TravettoPlugin: { title: 'VSCode plugin', href: 'https://marketplace.visualstudio.com/items?itemName=arcsine.travetto-plugin' },
+  Npm: { title: 'Npm', href: 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm' },
+  Yarn: { title: 'Yarn', href: 'https://yarnpg.com' },
+  Eslint: { title: 'ESLint', href: 'https://eslint.org/' },
+  Rollup: { title: 'Rollup', href: 'https://rollupjs.org/' },
+  TSConfig: { title: 'TS Config', href: 'https://www.typescriptlang.org/docs/handbook/tsconfig-json.html' },
+
+  // Module
+  CommonJS: { title: 'CommonJS', href: 'https://nodejs.org/api/modules.html' },
+  EcmascriptModule: { title: 'Ecmascript Module', href: 'https://nodejs.org/api/esm.html' },
+  PackageJson: { title: 'Package JSON', href: 'https://docs.npmjs.com/cli/v9/configuring-npm/package-json' },
+
+  // Download
+  NodeDownload: { title: 'Node', href: 'https://nodejs.org/en/download/current/' },
+  MongoDownload: { title: 'Mongodb', href: 'https://docs.mongodb.com/manual/administration/install-community/' },
+  VSCodeDownload: { title: 'VSCode', href: 'https://code.visualstudio.com/download' },
+
+  // Data formats
+  YAML: { title: 'YAML', href: 'https://en.wikipedia.org/wiki/YAML' },
+  JSON: { title: 'JSON', href: 'https://www.json.org' },
+  Base64: { title: 'Base64', href: 'https://en.wikipedia.org/wiki/Base64' },
+  TAP: { title: 'TAP 13', href: 'https://testanything.org/tap-version-13-specification.html' },
+  XUnit: { title: 'xUnit', href: 'https://en.wikipedia.org/wiki/XUnit' },
+  Markdown: { title: 'Markdown', href: 'https://en.wikipedia.org/wiki/Markdown' },
+  HTML: { title: 'HTML', href: 'https://en.wikipedia.org/wiki/HTML' },
+  JSX: { title: 'JSX', href: 'https://en.wikipedia.org/wiki/JSX_(JavaScript)' },
+
+  // Info
+  DependencyInjection: { title: 'Dependency injection', href: 'https://en.wikipedia.org/wiki/Dependency_injection' },
+  OpenAPI: { title: 'OpenAPI', href: 'https://github.com/OAI/OpenAPI-Specification' },
+  JSDoc: { title: 'JSDoc', href: 'http://usejsdoc.org/about-getting-started.html' },
+  CodeLens: { title: 'CodeLens', href: 'https://code.visualstudio.com/api/language-extensions/programmatic-language-features#codelens-show-actionable-context-information-within-source-code' },
+  ORM: { title: 'Object Relationship Mapping', href: 'https://en.wikipedia.org/wiki/Object%E2%80%93relational_mapping' },
+  UUID: { title: 'UUID', href: 'https://en.wikipedia.org/wiki/Universally_unique_identifier' },
+
+  // Node
+  ChildProcess: { title: 'child_process', href: 'https://nodejs.org/api/child_process.html' },
+  AsyncHooks: { title: 'async_hooks', href: 'https://nodejs.org/api/async_hooks.html' },
+  Http: { title: 'http', href: 'https://nodejs.org/api/http.html' },
+  Path: { title: 'http', href: 'https://nodejs.org/api/path.html' },
+  Https: { title: 'https', href: 'https://nodejs.org/api/https.html' },
+  Console: { title: 'console', href: 'https://nodejs.org/api/console.html' },
+  Assert: { title: 'assert', href: 'https://nodejs.org/api/assert.html' },
+
+  // Cloud
+  AwsCloudwatch: { title: 'AWS Cloudwatch', href: 'https://aws.amazon.com/cloudwatch/' },
+
+  // Utils
+  Lodash: { title: 'lodash', href: 'https://lodash.com' },
+  NodeForge: { title: 'node-forge', href: 'https://www.npmjs.com/package/node-forge' },
+  Docker: { title: 'docker', href: 'https://www.docker.com/community-edition' },
+  Debug: { title: 'debug', href: 'https://www.npmjs.com/package/debug' },
+  OpenAPIGenerator: { title: 'OpenAPI client generation tools', href: 'https://github.com/OpenAPITools/openapi-generator' },
+  Gaze: { title: 'gaze', href: 'https://github.com/shama/gaze' },
+  Chokidar: { title: 'chokidar', href: 'https://github.com/paulmillr/chokidar' },
+  Faker: { title: 'faker', href: 'https://github.com/faker-js/faker' },
+  Yeoman: { title: 'yeoman', href: 'http://yeoman.io' },
+  Commander: { title: 'commander', href: 'https://www.npmjs.com/package/commander' },
+  Curl: { title: 'curl', href: 'https://curl.haxx.se/' },
+  Fetch: { title: 'fetch', href: 'https://www.npmjs.com/package/node-fetch' },
+  ParcelWatcher: { title: 'fetch', href: 'https://www.npmjs.com/package/@parcel/watcher' },
+  Preact: { title: 'preact', href: 'https://preactjs.com' },
+  PreactRenderToString: { title: 'preact', href: 'https://github.com/preactjs/preact-render-to-string' },
+
+  // JWT
+  JWT: { title: 'JWT', href: 'https://jwt.io/' },
+  NodeJWT: { title: 'node-jsonwebtoken', href: 'https://github.com/auth0/node-jsonwebtoken' },
+
+  // Email
+  NodeMailer: { title: 'nodemailer', href: 'https://nodemailer.com/about/' },
+  Inky: { title: 'inky', href: 'https://github.com/zurb/inky' },
+  Sass: { title: 'sass', href: 'https://github.com/sass/dart-sass' },
+  Mustache: { title: 'mustache', href: 'https://github.com/janl/mustache.js/' },
+
+  // Image
+  ImageMagick: { title: 'ImageMagick', href: 'https://imagemagick.org/index.php' },
+  PngQuant: { title: 'pngquant', href: 'https://pngquant.org/' },
+  JpegOptim: { title: 'Jpegoptim', href: 'https://github.com/tjko/jpegoptim' },
+
+  // Dbs
+  MongoDB: { title: 'mongodb', href: 'https://mongodb.com' },
+  S3: { title: 's3', href: 'https://aws.amazon.com/documentation/s3/' },
+  Redis: { title: 'redis', href: 'https://redis.io' },
+  Memcached: { title: 'memcached', href: 'https://memcached.org' },
+  Elasticsearch: { title: 'elasticsearch', href: 'https://elastic.co' },
+  SQL: { title: 'SQL', href: 'https://en.wikipedia.org/wiki/SQL' },
+  MySQL: { title: 'MySQL', href: 'https://www.mysql.com/' },
+  Postgres: { title: 'Postgres', href: 'https://postgresql.org' },
+  DynamoDB: { title: 'DynamoDB', href: 'https://aws.amazon.com/dynamodb/' },
+  Firestore: { title: 'Firestore', href: 'https://firebase.google.com/docs/firestore' },
+  SQLite: { title: 'SQLite', href: 'https://www.sqlite.org/' },
+
+  // Rest
+  Express: { title: 'express', href: 'https://expressjs.com' },
+  Passport: { title: 'passport', href: 'http://passportjs.org' },
+  Busboy: { title: 'busboy', href: 'https://github.com/mscdex/busboy' },
+  Cookies: { title: 'cookies', href: 'https://www.npmjs.com/package/cookies' },
+  ServerlessExpress: { title: 'aws-serverless-express', href: 'https://github.com/awslabs/aws-serverless-express/blob/master/README.md' },
+  AwsLambdaFastify: { title: '@fastify/aws-lambda', href: 'https://github.com/fastify/aws-lambda-fastify/blob/master/README.md' },
+  Fastify: { title: 'fastify', href: 'https://www.fastify.io/' },
+  Koa: { title: 'koa', href: 'https://koajs.com/' },
+} as const;