How to emit examples in json schema?

[risabhds]

I have the following typespec in my playground:

import "@typespec/json-schema";

using TypeSpec.JsonSchema;

@jsonSchema
namespace Schemas;

/** Description goes here */
@summary("Title goes here")
model Person {
  /** The person's name. */
  @example("John")
  name: string;

  /** Age in years which must be equal to or greater than zero. */
  @example(18)
  @minValue(0)
  age: integer;
}

But I don't get examples in the emitted json-schema.

What I desire is a json-schema with examples on the property:

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "Person.json",
    "description": "Description goes here",
    "title": "Title goes here",
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "The person's name.",
            "examples": ["John"]
        },
        "age": {
            "type": "integer",
            "minimum": 0,
            "description": "Age in years which must be equal to or greater than zero.",
            "examples": [18]
        }
    },
    "required": [
        "name",
        "age"
    ]
}

How do I get examples in the emitted json-schema?

[timotheeguerin]

json schema emitter doesn't yet make use of the example decorator. Could convert that to an issue

[risabhds]

Thanks for the prompt response!
Created the issue #3950.

[risabhds]

Just noticed that you already created the issue #3946. Thanks!
Closed my issue as duplicate.

[timotheeguerin]

@risabhds following back on this, is there actually any specification on examples in json schema? I can't seem to find it? If not I am not sure we should be adding that at least for now.

[timotheeguerin]

Ignore, found it https://json-schema.org/draft/2020-12/json-schema-validation#name-examples