|
| 1 | +/** |
| 2 | + * JSDoc settings. |
| 3 | + */ |
| 4 | +export interface JSDocSetting extends Partial<Record<string, unknown>> { |
| 5 | + /** |
| 6 | + * Disables all rules for the comment block on which a `@private` tag (or `@access private`) occurs. |
| 7 | + * |
| 8 | + * Defaults to `false`. |
| 9 | + * |
| 10 | + * Note: This has no effect with the rule `check-access` (whose purpose is to check access modifiers) or `empty-tags` (which checks `@private` itself). |
| 11 | + * |
| 12 | + * @see [mode](https://github.com/gajus/eslint-plugin-jsdoc#allow-tags-private-or-internal-to-disable-rules-for-that-comment-block) |
| 13 | + */ |
| 14 | + ignorePrivate?: boolean; |
| 15 | + /** |
| 16 | + * Disables all rules for the comment block on which a `@internal` tag occurs. |
| 17 | + * |
| 18 | + * Defaults to `false`. |
| 19 | + * |
| 20 | + * Note: This has no effect with the rule `empty-tags` (which checks `@internal` itself). |
| 21 | + * |
| 22 | + * @see [mode](https://github.com/gajus/eslint-plugin-jsdoc#allow-tags-private-or-internal-to-disable-rules-for-that-comment-block) |
| 23 | + */ |
| 24 | + ignoreInternal?: boolean; |
| 25 | + /** |
| 26 | + * Set to `typescript`, `closure`, or `jsdoc` (the default unless the `@typescript-eslint` parser is in use in which case `typescript` will be the default). |
| 27 | + * |
| 28 | + * @see [mode](https://github.com/gajus/eslint-plugin-jsdoc#mode) |
| 29 | + */ |
| 30 | + mode?: 'typescript' | 'closure' | 'jsdoc'; |
| 31 | + /** |
| 32 | + * Configure a preferred alias name for a JSDoc tag. |
| 33 | + * |
| 34 | + * @see [Alias Preference](https://github.com/gajus/eslint-plugin-jsdoc#alias-preference) |
| 35 | + */ |
| 36 | + tagNamePreference?: Record<string, string | { message: string; replacement?: string } | false>; |
| 37 | + overrideReplacesDocs?: boolean; |
| 38 | + augmentsExtendsReplacesDocs?: boolean; |
| 39 | + implementsReplacesDocs?: boolean; |
| 40 | + preferredTypes?: unknown; |
| 41 | +} |
| 42 | + |
| 43 | +/** |
| 44 | + * JSDoc settings. |
| 45 | + */ |
| 46 | +export interface JSDocSettings { |
| 47 | + /** |
| 48 | + * JSDoc settings. |
| 49 | + * |
| 50 | + * @see [JSDoc settings](https://github.com/gajus/eslint-plugin-jsdoc#eslint-plugin-jsdoc-settings) |
| 51 | + */ |
| 52 | + jsdoc?: JSDocSetting; |
| 53 | +} |
0 commit comments