Skip to content

yargs issue with docuemntation version 14.0.3 #1641

Closed
@akash-nx

Description

@akash-nx

I have package.json with following entries:

"documentation": "^14.0.3",
"yargs": "^17.5.1"

when I run npm run documentation, I get below error:

[INFO] import yargs from 'yargs';
[INFO]        ^^^^^
[INFO] 
[INFO] SyntaxError: Unexpected identifier
[INFO]     at new Script (vm.js:80:7)
[INFO]     at createScript (vm.js:274:10)
[INFO]     at Object.runInThisContext (vm.js:326:10)
[INFO]     at Module._compile (internal/modules/cjs/loader.js:664:28)
[INFO]     at Object.Module._extensions..js (internal/modules/cjs/loader.js:712:10)
[INFO]     at Module.load (internal/modules/cjs/loader.js:600:32)
[INFO]     at tryModuleLoad (internal/modules/cjs/loader.js:539:12)
[INFO]     at Function.Module._load (internal/modules/cjs/loader.js:531:3)
[INFO]     at Function.Module.runMain (internal/modules/cjs/loader.js:754:12)
[INFO]     at startup (internal/bootstrap/node.js:283:19)
[INFO] npm ERR! code ELIFECYCLE
[INFO] npm ERR! errno 1

If I use older version (13.2.5), documentation works. The reason behind version upgrade is - when docstring are generated for method, it doesnt parse '&' for body param. Example:
For below docstring:

@param { Required<Pick<Model1, 'name'>> & Partial<Model1> } body specification
expectation is to see below format in documentation:

body(Required<Pick<Model1, 'name'>> & Partial<Model1>) specification

but I can see:
body(any) specification

  • What version of documentation.js are you using?: 14.0.3
  • How are you running documentation.js (on the CLI, Node.js API, Grunt, other?): npm run documentation

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions