Skip to content
This repository was archived by the owner on Mar 7, 2025. It is now read-only.

Commit b78bbc2

Browse files
committed
Define JSDocSettings
1 parent 5bf10ae commit b78bbc2

File tree

3 files changed

+59
-7
lines changed

3 files changed

+59
-7
lines changed

src/settings.d.ts

Lines changed: 0 additions & 7 deletions
This file was deleted.

src/settings/index.d.ts

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
import type { JSDocSettings } from './jsdoc';
2+
3+
/**
4+
* Settings.
5+
*/
6+
export interface Settings extends JSDocSettings, Partial<Record<string, unknown>> {}

src/settings/jsdoc.d.ts

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
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

Comments
 (0)