Trying to understand why refs are unresolved.

[Devon-White]

I'm finding that that a couple of inline refs are unable to be resolved.

However, when using the Monaco editor that comes along with the plugin, all the schema validation is working as expected.

So I have confirm its not a schema error, but seems to be something with the viewer.

Example:

However, lets look how these methods are defined:

{
"SWMLMethod": {
      "anyOf": [
        {
          "$ref": "#/$defs/Answer"
        },
        {
          "$ref": "#/$defs/AI"
        },
        {
          "$ref": "#/$defs/Cond"
        },
        {
          "$ref": "#/$defs/Connect"
        },
        {
          "$ref": "#/$defs/Denoise"
        },
        {
          "$ref": "#/$defs/Execute"
        },
        {
          "$ref": "#/$defs/Goto"
        },
        {
          "$ref": "#/$defs/Label"
        },
        {
          "$ref": "#/$defs/LiveTranscribe"
        },
        {
          "$ref": "#/$defs/LiveTranslate"
        },
        {
          "$ref": "#/$defs/Hangup"
        },
        {
          "$ref": "#/$defs/JoinRoom"
        },
        {
          "$ref": "#/$defs/Play"
        },
        {
          "$ref": "#/$defs/Prompt"
        },
        {
          "$ref": "#/$defs/ReceiveFax"
        },
        {
          "$ref": "#/$defs/Record"
        },
        {
          "$ref": "#/$defs/RecordCall"
        },
        {
          "$ref": "#/$defs/Request"
        },
        {
          "$ref": "#/$defs/Return"
        },
        {
          "$ref": "#/$defs/SendDigits"
        },
        {
          "$ref": "#/$defs/SendFax"
        },
        {
          "$ref": "#/$defs/SendSMS"
        },
        {
          "$ref": "#/$defs/Set"
        },
        {
          "$ref": "#/$defs/Sleep"
        },
        {
          "$ref": "#/$defs/SIPRefer"
        },
        {
          "$ref": "#/$defs/StopDenoise"
        },
        {
          "$ref": "#/$defs/StopRecordCall"
        },
        {
          "$ref": "#/$defs/StopTap"
        },
        {
          "$ref": "#/$defs/Switch"
        },
        {
          "$ref": "#/$defs/Tap"
        },
        {
          "$ref": "#/$defs/Transfer"
        },
        {
          "$ref": "#/$defs/Unset"
        },
        {
          "$ref": "#/$defs/Pay"
        }
      ],
      "title": "SWML methods"
    },
}

So I'm confused as to why some of these are unresolved. Any insight would be extremely helpful! I would really like to use this plugin, but this issue is preventing me at the moment.

For testing purposes, a gist of the schema im using can be found here: https://gist.github.com/Devon-White/c655c89f2d13617ccd64744994016c3b

[jy95]

Hello @Devon-White ,

After testing your schema, it seems it is coming from the resolving library used here : @stoplight/json-ref-resolver

It gives this schema to the lib : resolvedSchema.json . As you will see, some $ref aren't resolved as they lead to recursive schema (prohibited by @stoplight/json-ref-resolver) so the library doesn't support them at the moment.

There are a couple of discussions we got in the past :

• What can be done about supporting dynamic references? #258
• Splitting a schema across multiple sections of a documentation site #223