feat(oas3): add format link

[marcofriso]

Closes APIARY-6106

[marcofriso]

Why are not there package-lock.json files? Should I add them to .gitignore?

[kylef]

Yarn is used, not npm. There is yarn lockfile in root of repo, there is no need to run npm install here, you can delete the files and use yarn: (https://github.com/apiaryio/api-elements.js#using-lerna).

[kylef]

I've commented on some cases where the changes in lib/parser.js can return an undesired output given certain inputs. I'd suggest using the document variable to retieve the version. document will contain the parsed YAML/JSON document as Minim elements (wrapped in parse result). You could use something along the lines of document.content.find(isObject) to get the "object" element which represent the tree. The getValue('openapi') on an object element can get you the value of the key (which might be a string element, you would want to confirm that is true).

[kylef]

I think this check can be removed like in the API Blueprint version.

[marcofriso]

removed

[kylef]

I'd suggest adding a check here for the value of the openapi member element being a string element, and if any of these checks fail I think we should default to the latest OpenAPI 3 version we know about which is 3.0.3. I think there may be cases where we could get here with an invalid document which cannot be parsed correctly.

Making a test similar to it('add the format link', () => { but instead the source is invalid document should verify this, if you set source to be an unexpected value such as const source = '{}' or const source = '[]' etc.

[marcofriso]

changed here f52cd03

[marcofriso]

check if the value of the OpenAPi member element is a string element 88bcb56