| 1 | {
|
| 2 | "title": "TSDoc Configuration",
|
| 3 | "description": "Describes the TSDoc configuration for a TypeScript project",
|
| 4 | "type": "object",
|
| 5 | "properties": {
|
| 6 | "$schema": {
|
| 7 | "description": "Part of the JSON Schema standard, this optional keyword declares the URL of the schema that the file conforms to. Editors may download the schema and use it to perform syntax highlighting.",
|
| 8 | "type": "string"
|
| 9 | },
|
| 10 |
|
| 11 | "extends": {
|
| 12 | "description": "Optionally specifies one or more JSON config files that will be combined with this file. This provides a way for standard settings to be shared across multiple projects. Important: The \"extends\" paths are resolved using NodeJS module resolution, so a path to a local file MUST be prefixed with \"./\".",
|
| 13 | "type": "array",
|
| 14 | "items": {
|
| 15 | "type": "string"
|
| 16 | }
|
| 17 | },
|
| 18 |
|
| 19 | "tagDefinitions": {
|
| 20 | "description": "Additional tags to support when parsing documentation comments with TSDoc.",
|
| 21 | "type": "array",
|
| 22 | "items": {
|
| 23 | "$ref": "#/definitions/tsdocTagDefinition"
|
| 24 | }
|
| 25 | }
|
| 26 | },
|
| 27 | "required": ["$schema"],
|
| 28 | "additionalProperties": false,
|
| 29 |
|
| 30 | "definitions": {
|
| 31 | "tsdocTagDefinition": {
|
| 32 | "description": "Configuration for a custom supported TSDoc tag.",
|
| 33 | "type": "object",
|
| 34 | "properties": {
|
| 35 | "tagName": {
|
| 36 | "description": "Name of the custom tag. TSDoc tag names start with an at-sign (@) followed by ASCII letters using camelCase capitalization.",
|
| 37 | "type": "string"
|
| 38 | },
|
| 39 | "syntaxKind": {
|
| 40 | "description": "Syntax kind of the custom tag. \"inline\" means that this tag can appear inside other documentation sections (example: {@link}). \"block\" means that this tag starts a new documentation section (example: @remarks). \"modifier\" means that this tag's presence indicates an aspect of the associated API item (example: @internal).",
|
| 41 | "type": "string",
|
| 42 | "enum": ["inline", "block", "modifier"]
|
| 43 | },
|
| 44 | "allowMultiple": {
|
| 45 | "description": "If true, then this tag may appear multiple times in a doc comment. By default, a tag may only appear once.",
|
| 46 | "type": "boolean"
|
| 47 | }
|
| 48 | },
|
| 49 | "required": ["tagName", "syntaxKind"],
|
| 50 | "additionalProperties": false
|
| 51 | }
|
| 52 | }
|
| 53 | }
|