It is definitions or $defs?

[tpoxa]

It is definitions or $defs?

[vearutop]

This library is at draft-07 which has definitions.

But it is possible to use any custom place for definitions with a bit of instrumentation.

https://go.dev/play/p/Zd33cpj6Q4e

package main

import (
	"encoding/json"
	"fmt"
	"github.com/swaggest/jsonschema-go"
)

type S1 struct {
	A int `json:"a"`
	S S2  `json:"s"`
}

type S2 struct {
	B string `json:"b"`
}

func main() {
	r := jsonschema.Reflector{}

	defs := map[string]jsonschema.Schema{}

	s, _ := r.Reflect(S1{}, func(rc *jsonschema.ReflectContext) {
		rc.DefinitionsPrefix = "#/$defs/"
		rc.CollectDefinitions = func(name string, schema jsonschema.Schema) {
			defs[name] = schema
		}
	})

	s.WithExtraPropertiesItem("$defs", defs)

	j, _ := json.MarshalIndent(s, "", " ")

	fmt.Println(string(j))
}

{
 "properties": {
  "a": {
   "type": "integer"
  },
  "s": {
   "$ref": "#/$defs/S2"
  }
 },
 "type": "object",
 "$defs": {
  "S2": {
   "properties": {
    "b": {
     "type": "string"
    }
   },
   "type": "object"
  }
 }
}