…mponentRef) (string, bool)` (#945)

* Add function to check if a schema matches the root document's

It does this by keeping track of the source file paths of schemas in
multi-file'd specs.

This enables the amalgamation of schemas which reference the same underlying
model which removes *very annoying* to use anonymous structs in generated
models when using codegen tools like oapi-codegen.

* Move logic to code generation file

And populate all ref types

* Move MatchesSchemaInRootDocument to helper file

* Make matches root component function generic

* Protect against null refs

* Update docs

* Add function comments

* Replace swagger links with OAI spec

* Fix bugs, rebase issues, add tests

* Add example to README.md

* Use JSON pointers to map from name to components

* feat(loader): implement reference back-tracking

* update docs

* address review comments

* update docs and readme

* fix inconsistency

* adjust readme

* openapi3: resolve recursive file references

* fix file name capitalization

* Add failing test case

* Improve default name internalisation to avoid collisions

* Set ref path when resolving refs too

* Update unit tests

Still got some work to do, the recursive test still fails

* Make InternalizeRefs deterministic

This makes resolving references & internalising references determinstic
by sorting map for loops by key.

Ensures refs are resolved in the same order, depending on the spec this
can result in a different (but equal value) internalised spec.

* Ensure root document url is set

The unmarshal function was removing the .url value

* Ensure internalised names are valid

* Update internalized golden files

* Maintain first path assigned to each reference

This will be the path at the closest point to the actual definition
in the reference chain.

Also trim . from the start of paths

* Tidy up & relocation some functions

* Use use OS repsecting file seperator

* Check for duplicate references to tidy up internalized spec

* Swap condition checks & add comment

* Maintain consistent slash, only adjusting for OS specific when needed

* Adjust documentation

* Internalised -> internalized

Excuse my British English

* test: add a test for additionalProperties: false validation

* goimports

* feat(format): add support for number and integer format validators

* update docs

* add deprecation notice

* add breaking changes notice

* minimize error message changes

* remove obvious comments

* fix string quotation

* openapi3: allow YAML-marshaling invalid specs

Signed-off-by: Pierre Fenoll <pierrefenoll@gmail.com>

* fixes

Signed-off-by: Pierre Fenoll <pierrefenoll@gmail.com>

---------

Signed-off-by: Pierre Fenoll <pierrefenoll@gmail.com>