lib/docs - jsdoc-scribe API

Functions(2)

#extractModules

async

Extract documentation models from an array of file paths. All files are attempted; failures are logged to stderr and omitted from results. Uses Promise.allSettled so a single bad file never aborts the batch.

Parameter	Type	Optional	Description
`files`	`string[]`

Returns: Promise<object[]>

Signature

async extractModules(files: any): any

#generateSite

line 44

async

One-shot convenience: collect files, extract docs, build HTML site. opt-in `rootDir` (task-arch-04): when provided, `getAllFacts(rootDir)` is computed and passed through as `facts` so the generated site includes the Architecture page. Omitted/falsy `rootDir` (every pre-task-arch-04 caller) leaves `facts` undefined -- `buildSite()` treats that as "no Architecture page", so this is fully backward-compatible.

Parameter	Type	Optional	Description
`inputPaths`	`string\|string[]`		Source file or directory paths
`options`	`object`	yes	Same options as buildSite(), plus an

Returns: Promise<Array<{path:string,html:string}>>

Signature

async generateSite(inputPaths: any, options: any): any

Variables & Constants(13)

#{ collectFiles, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS }

line 3

const { collectFiles, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS }: any

const

Signature

const { collectFiles, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS }: any

#{ extractModule }

line 4

const { extractModule }: any

const

Signature

const { extractModule }: any

#{ buildSite, moduleLabel, moduleHtmlPath }

line 5

const { buildSite, moduleLabel, moduleHtmlPath }: any

const

Signature

const { buildSite, moduleLabel, moduleHtmlPath }: any

#{ getAllFacts }

line 6

const { getAllFacts }: any

const

Signature

const { getAllFacts }: any

#results

line 17

const results: any

const

Signature

const results: any

#modules

line 20

const modules: Array

const

Signature

const modules: Array

line 22

const r: any

const

Signature

const r: any

#paths

line 45

const paths: any

const

Signature

const paths: any

#opts

line 46

const opts: any

const

Signature

const opts: any

#files

line 47

const files: any

const

Signature

const files: any

#unique

line 48

const unique: Array

const

Signature

const unique: Array

#modules

line 49

const modules: any

const

Signature

const modules: any

#facts

line 50

const facts: any

const

Signature

const facts: any