Kyle Fuller

The OAS 3 parser has an internal context which includes a method `registerId()` which can be used to register IDs which are placed in the API Elements parse result. This...

This issue tracks support for `default` responses in OpenAPI 2. https://github.com/apiaryio/api-elements.js/issues/68 tracks similiar support in OpenAPI 3.

The JSON06Serialiser from Minim is effectively API Elements specific, and it is currently part of the public interface of Minim. Perhaps making this legacy serialiser a separate package in api-elements.js...

I am sure we can make a more intutive syntax for this, here's exerp from the Paw API Blueprint importer: ```js parseResult.errors.forEach((error) => { const start = error.attributes.get('sourceMap').get(0).get(0).get(0); const line...

Rethink Fury API

1

There are some rough edges to the Fury API such as singleton pattern (https://github.com/apiaryio/api-elements.js/pull/141#discussion_r253851981) and limitations of how adapters and media type handling works. The way that adapters declare media...

Rough notes, but roughly the following documents or changes in place: - [ ] README - At a high level to describe the sub-packages, linking to subpackage readmes - [...

Incorporate deckardcain

4

There is various logic for ADD detection in multiple places (fury adapters, deckard cain etc). We should deduplicate these efforts and provide a detection interface to API Elements JS (/Fury)...

I discovered a user trying to describe a property called `$ref` in a schema, for example: ```yaml type: object properties: $ref: type: string ``` This is failing as we're trying...

Provide predicates

1

See https://github.com/refractproject/minim-api-description/issues/38