eslint-plugin-tsdoc-require-2 1.2.1 → 1.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -101
- package/dist/internal/require-tag-factory.cjs +40 -48
- package/dist/internal/require-tag-factory.d.ts +7 -8
- package/dist/internal/require-tag-factory.d.ts.map +1 -1
- package/dist/internal/require-tag-factory.js +41 -49
- package/dist/internal/require-tag-factory.js.map +1 -1
- package/dist/plugin.cjs +9 -2
- package/dist/plugin.d.ts.map +1 -1
- package/dist/plugin.js +9 -2
- package/dist/plugin.js.map +1 -1
- package/dist/rules/require-tag-rules.js +112 -112
- package/dist/rules/require.cjs +39 -47
- package/dist/rules/require.d.ts +3 -3
- package/dist/rules/require.d.ts.map +1 -1
- package/dist/rules/require.js +40 -48
- package/dist/rules/require.js.map +1 -1
- package/dist/rules/required-tags/require-abstract.cjs +1 -3
- package/dist/rules/required-tags/require-abstract.d.ts.map +1 -1
- package/dist/rules/required-tags/require-abstract.js +1 -3
- package/dist/rules/required-tags/require-abstract.js.map +1 -1
- package/dist/rules/required-tags/require-alpha.cjs +1 -3
- package/dist/rules/required-tags/require-alpha.d.ts.map +1 -1
- package/dist/rules/required-tags/require-alpha.js +1 -3
- package/dist/rules/required-tags/require-alpha.js.map +1 -1
- package/dist/rules/required-tags/require-author.cjs +1 -3
- package/dist/rules/required-tags/require-author.d.ts.map +1 -1
- package/dist/rules/required-tags/require-author.js +1 -3
- package/dist/rules/required-tags/require-author.js.map +1 -1
- package/dist/rules/required-tags/require-beta.cjs +1 -3
- package/dist/rules/required-tags/require-beta.d.ts.map +1 -1
- package/dist/rules/required-tags/require-beta.js +1 -3
- package/dist/rules/required-tags/require-beta.js.map +1 -1
- package/dist/rules/required-tags/require-category.cjs +1 -3
- package/dist/rules/required-tags/require-category.d.ts.map +1 -1
- package/dist/rules/required-tags/require-category.js +1 -3
- package/dist/rules/required-tags/require-category.js.map +1 -1
- package/dist/rules/required-tags/require-class.cjs +1 -3
- package/dist/rules/required-tags/require-class.d.ts.map +1 -1
- package/dist/rules/required-tags/require-class.js +1 -3
- package/dist/rules/required-tags/require-class.js.map +1 -1
- package/dist/rules/required-tags/require-decorator.cjs +1 -3
- package/dist/rules/required-tags/require-decorator.d.ts.map +1 -1
- package/dist/rules/required-tags/require-decorator.js +1 -3
- package/dist/rules/required-tags/require-decorator.js.map +1 -1
- package/dist/rules/required-tags/require-default-value.cjs +1 -3
- package/dist/rules/required-tags/require-default-value.d.ts.map +1 -1
- package/dist/rules/required-tags/require-default-value.js +1 -3
- package/dist/rules/required-tags/require-default-value.js.map +1 -1
- package/dist/rules/required-tags/require-deprecated.cjs +1 -3
- package/dist/rules/required-tags/require-deprecated.d.ts.map +1 -1
- package/dist/rules/required-tags/require-deprecated.js +1 -3
- package/dist/rules/required-tags/require-deprecated.js.map +1 -1
- package/dist/rules/required-tags/require-document.cjs +1 -3
- package/dist/rules/required-tags/require-document.d.ts.map +1 -1
- package/dist/rules/required-tags/require-document.js +1 -3
- package/dist/rules/required-tags/require-document.js.map +1 -1
- package/dist/rules/required-tags/require-enum.cjs +1 -3
- package/dist/rules/required-tags/require-enum.d.ts.map +1 -1
- package/dist/rules/required-tags/require-enum.js +1 -3
- package/dist/rules/required-tags/require-enum.js.map +1 -1
- package/dist/rules/required-tags/require-event-property.cjs +1 -3
- package/dist/rules/required-tags/require-event-property.d.ts.map +1 -1
- package/dist/rules/required-tags/require-event-property.js +1 -3
- package/dist/rules/required-tags/require-event-property.js.map +1 -1
- package/dist/rules/required-tags/require-event.cjs +1 -3
- package/dist/rules/required-tags/require-event.d.ts.map +1 -1
- package/dist/rules/required-tags/require-event.js +1 -3
- package/dist/rules/required-tags/require-event.js.map +1 -1
- package/dist/rules/required-tags/require-example.cjs +1 -3
- package/dist/rules/required-tags/require-example.d.ts.map +1 -1
- package/dist/rules/required-tags/require-example.js +1 -3
- package/dist/rules/required-tags/require-example.js.map +1 -1
- package/dist/rules/required-tags/require-expand.cjs +1 -3
- package/dist/rules/required-tags/require-expand.d.ts.map +1 -1
- package/dist/rules/required-tags/require-expand.js +1 -3
- package/dist/rules/required-tags/require-expand.js.map +1 -1
- package/dist/rules/required-tags/require-experimental.cjs +1 -3
- package/dist/rules/required-tags/require-experimental.d.ts.map +1 -1
- package/dist/rules/required-tags/require-experimental.js +1 -3
- package/dist/rules/required-tags/require-experimental.js.map +1 -1
- package/dist/rules/required-tags/require-function.cjs +1 -3
- package/dist/rules/required-tags/require-function.d.ts.map +1 -1
- package/dist/rules/required-tags/require-function.js +1 -3
- package/dist/rules/required-tags/require-function.js.map +1 -1
- package/dist/rules/required-tags/require-group.cjs +1 -3
- package/dist/rules/required-tags/require-group.d.ts.map +1 -1
- package/dist/rules/required-tags/require-group.js +1 -3
- package/dist/rules/required-tags/require-group.js.map +1 -1
- package/dist/rules/required-tags/require-hidden.cjs +1 -3
- package/dist/rules/required-tags/require-hidden.d.ts.map +1 -1
- package/dist/rules/required-tags/require-hidden.js +1 -3
- package/dist/rules/required-tags/require-hidden.js.map +1 -1
- package/dist/rules/required-tags/require-hideconstructor.cjs +1 -3
- package/dist/rules/required-tags/require-hideconstructor.d.ts.map +1 -1
- package/dist/rules/required-tags/require-hideconstructor.js +1 -3
- package/dist/rules/required-tags/require-hideconstructor.js.map +1 -1
- package/dist/rules/required-tags/require-ignore.cjs +1 -3
- package/dist/rules/required-tags/require-ignore.d.ts.map +1 -1
- package/dist/rules/required-tags/require-ignore.js +1 -3
- package/dist/rules/required-tags/require-ignore.js.map +1 -1
- package/dist/rules/required-tags/require-import.cjs +1 -3
- package/dist/rules/required-tags/require-import.d.ts.map +1 -1
- package/dist/rules/required-tags/require-import.js +1 -3
- package/dist/rules/required-tags/require-import.js.map +1 -1
- package/dist/rules/required-tags/require-include.cjs +1 -3
- package/dist/rules/required-tags/require-include.d.ts.map +1 -1
- package/dist/rules/required-tags/require-include.js +1 -3
- package/dist/rules/required-tags/require-include.js.map +1 -1
- package/dist/rules/required-tags/require-inherit-doc.cjs +1 -3
- package/dist/rules/required-tags/require-inherit-doc.d.ts.map +1 -1
- package/dist/rules/required-tags/require-inherit-doc.js +1 -3
- package/dist/rules/required-tags/require-inherit-doc.js.map +1 -1
- package/dist/rules/required-tags/require-inline.cjs +1 -3
- package/dist/rules/required-tags/require-inline.d.ts.map +1 -1
- package/dist/rules/required-tags/require-inline.js +1 -3
- package/dist/rules/required-tags/require-inline.js.map +1 -1
- package/dist/rules/required-tags/require-interface.cjs +1 -3
- package/dist/rules/required-tags/require-interface.d.ts.map +1 -1
- package/dist/rules/required-tags/require-interface.js +1 -3
- package/dist/rules/required-tags/require-interface.js.map +1 -1
- package/dist/rules/required-tags/require-internal.cjs +1 -3
- package/dist/rules/required-tags/require-internal.d.ts.map +1 -1
- package/dist/rules/required-tags/require-internal.js +1 -3
- package/dist/rules/required-tags/require-internal.js.map +1 -1
- package/dist/rules/required-tags/require-label.cjs +1 -3
- package/dist/rules/required-tags/require-label.d.ts.map +1 -1
- package/dist/rules/required-tags/require-label.js +1 -3
- package/dist/rules/required-tags/require-label.js.map +1 -1
- package/dist/rules/required-tags/require-license.cjs +1 -3
- package/dist/rules/required-tags/require-license.d.ts.map +1 -1
- package/dist/rules/required-tags/require-license.js +1 -3
- package/dist/rules/required-tags/require-license.js.map +1 -1
- package/dist/rules/required-tags/require-link.cjs +1 -3
- package/dist/rules/required-tags/require-link.d.ts.map +1 -1
- package/dist/rules/required-tags/require-link.js +1 -3
- package/dist/rules/required-tags/require-link.js.map +1 -1
- package/dist/rules/required-tags/require-merge-module-with.cjs +1 -3
- package/dist/rules/required-tags/require-merge-module-with.d.ts.map +1 -1
- package/dist/rules/required-tags/require-merge-module-with.js +1 -3
- package/dist/rules/required-tags/require-merge-module-with.js.map +1 -1
- package/dist/rules/required-tags/require-module.cjs +1 -3
- package/dist/rules/required-tags/require-module.d.ts.map +1 -1
- package/dist/rules/required-tags/require-module.js +1 -3
- package/dist/rules/required-tags/require-module.js.map +1 -1
- package/dist/rules/required-tags/require-namespace.cjs +1 -3
- package/dist/rules/required-tags/require-namespace.d.ts.map +1 -1
- package/dist/rules/required-tags/require-namespace.js +1 -3
- package/dist/rules/required-tags/require-namespace.js.map +1 -1
- package/dist/rules/required-tags/require-overload.cjs +1 -3
- package/dist/rules/required-tags/require-overload.d.ts.map +1 -1
- package/dist/rules/required-tags/require-overload.js +1 -3
- package/dist/rules/required-tags/require-overload.js.map +1 -1
- package/dist/rules/required-tags/require-override.cjs +1 -3
- package/dist/rules/required-tags/require-override.d.ts.map +1 -1
- package/dist/rules/required-tags/require-override.js +1 -3
- package/dist/rules/required-tags/require-override.js.map +1 -1
- package/dist/rules/required-tags/require-package-documentation.cjs +1 -3
- package/dist/rules/required-tags/require-package-documentation.d.ts.map +1 -1
- package/dist/rules/required-tags/require-package-documentation.js +1 -3
- package/dist/rules/required-tags/require-package-documentation.js.map +1 -1
- package/dist/rules/required-tags/require-param.cjs +1 -3
- package/dist/rules/required-tags/require-param.d.ts.map +1 -1
- package/dist/rules/required-tags/require-param.js +1 -3
- package/dist/rules/required-tags/require-param.js.map +1 -1
- package/dist/rules/required-tags/require-primary-export.cjs +1 -3
- package/dist/rules/required-tags/require-primary-export.d.ts.map +1 -1
- package/dist/rules/required-tags/require-primary-export.js +1 -3
- package/dist/rules/required-tags/require-primary-export.js.map +1 -1
- package/dist/rules/required-tags/require-private-remarks.cjs +1 -3
- package/dist/rules/required-tags/require-private-remarks.d.ts.map +1 -1
- package/dist/rules/required-tags/require-private-remarks.js +1 -3
- package/dist/rules/required-tags/require-private-remarks.js.map +1 -1
- package/dist/rules/required-tags/require-private.cjs +1 -3
- package/dist/rules/required-tags/require-private.d.ts.map +1 -1
- package/dist/rules/required-tags/require-private.js +1 -3
- package/dist/rules/required-tags/require-private.js.map +1 -1
- package/dist/rules/required-tags/require-property.cjs +1 -3
- package/dist/rules/required-tags/require-property.d.ts.map +1 -1
- package/dist/rules/required-tags/require-property.js +1 -3
- package/dist/rules/required-tags/require-property.js.map +1 -1
- package/dist/rules/required-tags/require-protected.cjs +1 -3
- package/dist/rules/required-tags/require-protected.d.ts.map +1 -1
- package/dist/rules/required-tags/require-protected.js +1 -3
- package/dist/rules/required-tags/require-protected.js.map +1 -1
- package/dist/rules/required-tags/require-public.cjs +1 -3
- package/dist/rules/required-tags/require-public.d.ts.map +1 -1
- package/dist/rules/required-tags/require-public.js +1 -3
- package/dist/rules/required-tags/require-public.js.map +1 -1
- package/dist/rules/required-tags/require-readonly.cjs +1 -3
- package/dist/rules/required-tags/require-readonly.d.ts.map +1 -1
- package/dist/rules/required-tags/require-readonly.js +1 -3
- package/dist/rules/required-tags/require-readonly.js.map +1 -1
- package/dist/rules/required-tags/require-remarks.cjs +1 -3
- package/dist/rules/required-tags/require-remarks.d.ts.map +1 -1
- package/dist/rules/required-tags/require-remarks.js +1 -3
- package/dist/rules/required-tags/require-remarks.js.map +1 -1
- package/dist/rules/required-tags/require-returns.cjs +1 -3
- package/dist/rules/required-tags/require-returns.d.ts.map +1 -1
- package/dist/rules/required-tags/require-returns.js +1 -3
- package/dist/rules/required-tags/require-returns.js.map +1 -1
- package/dist/rules/required-tags/require-sealed.cjs +1 -3
- package/dist/rules/required-tags/require-sealed.d.ts.map +1 -1
- package/dist/rules/required-tags/require-sealed.js +1 -3
- package/dist/rules/required-tags/require-sealed.js.map +1 -1
- package/dist/rules/required-tags/require-see.cjs +1 -3
- package/dist/rules/required-tags/require-see.d.ts.map +1 -1
- package/dist/rules/required-tags/require-see.js +1 -3
- package/dist/rules/required-tags/require-see.js.map +1 -1
- package/dist/rules/required-tags/require-since.cjs +1 -3
- package/dist/rules/required-tags/require-since.d.ts.map +1 -1
- package/dist/rules/required-tags/require-since.js +1 -3
- package/dist/rules/required-tags/require-since.js.map +1 -1
- package/dist/rules/required-tags/require-sort-strategy.cjs +1 -3
- package/dist/rules/required-tags/require-sort-strategy.d.ts.map +1 -1
- package/dist/rules/required-tags/require-sort-strategy.js +1 -3
- package/dist/rules/required-tags/require-sort-strategy.js.map +1 -1
- package/dist/rules/required-tags/require-summary.cjs +1 -3
- package/dist/rules/required-tags/require-summary.d.ts.map +1 -1
- package/dist/rules/required-tags/require-summary.js +1 -3
- package/dist/rules/required-tags/require-summary.js.map +1 -1
- package/dist/rules/required-tags/require-template.cjs +1 -3
- package/dist/rules/required-tags/require-template.d.ts.map +1 -1
- package/dist/rules/required-tags/require-template.js +1 -3
- package/dist/rules/required-tags/require-template.js.map +1 -1
- package/dist/rules/required-tags/require-throws.cjs +1 -3
- package/dist/rules/required-tags/require-throws.d.ts.map +1 -1
- package/dist/rules/required-tags/require-throws.js +1 -3
- package/dist/rules/required-tags/require-throws.js.map +1 -1
- package/dist/rules/required-tags/require-type-param.cjs +1 -3
- package/dist/rules/required-tags/require-type-param.d.ts.map +1 -1
- package/dist/rules/required-tags/require-type-param.js +1 -3
- package/dist/rules/required-tags/require-type-param.js.map +1 -1
- package/dist/rules/required-tags/require-use-declared-type.cjs +1 -3
- package/dist/rules/required-tags/require-use-declared-type.d.ts.map +1 -1
- package/dist/rules/required-tags/require-use-declared-type.js +1 -3
- package/dist/rules/required-tags/require-use-declared-type.js.map +1 -1
- package/dist/rules/required-tags/require-virtual.cjs +1 -3
- package/dist/rules/required-tags/require-virtual.d.ts.map +1 -1
- package/dist/rules/required-tags/require-virtual.js +1 -3
- package/dist/rules/required-tags/require-virtual.js.map +1 -1
- package/dist/rules/restrict-tags.cjs +40 -48
- package/dist/rules/restrict-tags.d.ts +3 -3
- package/dist/rules/restrict-tags.d.ts.map +1 -1
- package/dist/rules/restrict-tags.js +41 -49
- package/dist/rules/restrict-tags.js.map +1 -1
- package/docs/rules/getting-started.md +27 -27
- package/docs/rules/index.md +22 -22
- package/docs/rules/presets/all.md +1 -3
- package/docs/rules/presets/detailed.md +1 -3
- package/docs/rules/presets/index.md +75 -75
- package/docs/rules/presets/jsdoc.md +1 -3
- package/docs/rules/presets/packages.md +1 -3
- package/docs/rules/presets/recommended.md +1 -3
- package/docs/rules/presets/tsdoc.md +1 -3
- package/docs/rules/presets/typedoc-strict.md +1 -3
- package/docs/rules/presets/typedoc.md +1 -3
- package/docs/rules/require.md +53 -44
- package/docs/rules/required-tags/require-abstract.md +31 -30
- package/docs/rules/required-tags/require-alpha.md +18 -9
- package/docs/rules/required-tags/require-author.md +31 -30
- package/docs/rules/required-tags/require-beta.md +18 -9
- package/docs/rules/required-tags/require-category.md +30 -31
- package/docs/rules/required-tags/require-class.md +11 -10
- package/docs/rules/required-tags/require-decorator.md +18 -9
- package/docs/rules/required-tags/require-default-value.md +18 -9
- package/docs/rules/required-tags/require-deprecated.md +18 -9
- package/docs/rules/required-tags/require-document.md +31 -30
- package/docs/rules/required-tags/require-enum.md +13 -12
- package/docs/rules/required-tags/require-event-property.md +18 -9
- package/docs/rules/required-tags/require-event.md +31 -30
- package/docs/rules/required-tags/require-example.md +17 -10
- package/docs/rules/required-tags/require-expand.md +31 -30
- package/docs/rules/required-tags/require-experimental.md +18 -9
- package/docs/rules/required-tags/require-function.md +11 -13
- package/docs/rules/required-tags/require-group.md +31 -30
- package/docs/rules/required-tags/require-hidden.md +32 -31
- package/docs/rules/required-tags/require-hideconstructor.md +31 -30
- package/docs/rules/required-tags/require-ignore.md +31 -30
- package/docs/rules/required-tags/require-import.md +30 -31
- package/docs/rules/required-tags/require-include.md +31 -32
- package/docs/rules/required-tags/require-inherit-doc.md +18 -9
- package/docs/rules/required-tags/require-inline.md +31 -30
- package/docs/rules/required-tags/require-interface.md +14 -13
- package/docs/rules/required-tags/require-internal.md +18 -9
- package/docs/rules/required-tags/require-label.md +18 -9
- package/docs/rules/required-tags/require-license.md +31 -30
- package/docs/rules/required-tags/require-link.md +18 -9
- package/docs/rules/required-tags/require-merge-module-with.md +31 -30
- package/docs/rules/required-tags/require-module.md +14 -13
- package/docs/rules/required-tags/require-namespace.md +31 -30
- package/docs/rules/required-tags/require-overload.md +31 -30
- package/docs/rules/required-tags/require-override.md +18 -9
- package/docs/rules/required-tags/require-package-documentation.md +14 -13
- package/docs/rules/required-tags/require-param.md +14 -13
- package/docs/rules/required-tags/require-primary-export.md +31 -30
- package/docs/rules/required-tags/require-private-remarks.md +18 -11
- package/docs/rules/required-tags/require-private.md +31 -30
- package/docs/rules/required-tags/require-property.md +31 -30
- package/docs/rules/required-tags/require-protected.md +31 -30
- package/docs/rules/required-tags/require-public.md +19 -10
- package/docs/rules/required-tags/require-readonly.md +19 -10
- package/docs/rules/required-tags/require-remarks.md +12 -10
- package/docs/rules/required-tags/require-returns.md +14 -13
- package/docs/rules/required-tags/require-sealed.md +19 -10
- package/docs/rules/required-tags/require-see.md +19 -10
- package/docs/rules/required-tags/require-since.md +30 -31
- package/docs/rules/required-tags/require-sort-strategy.md +31 -30
- package/docs/rules/required-tags/require-summary.md +31 -30
- package/docs/rules/required-tags/require-template.md +31 -30
- package/docs/rules/required-tags/require-throws.md +20 -19
- package/docs/rules/required-tags/require-type-param.md +14 -13
- package/docs/rules/required-tags/require-use-declared-type.md +31 -30
- package/docs/rules/required-tags/require-virtual.md +20 -11
- package/docs/rules/required-tags.md +40 -38
- package/docs/rules/restrict-tags.md +68 -60
- package/package.json +67 -80
|
@@ -16,20 +16,20 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
16
16
|
|
|
17
17
|
```ts
|
|
18
18
|
type Options = [
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
19
|
+
{
|
|
20
|
+
enforceFor?: Array<
|
|
21
|
+
| "class"
|
|
22
|
+
| "enum"
|
|
23
|
+
| "function"
|
|
24
|
+
| "interface"
|
|
25
|
+
| "namespace"
|
|
26
|
+
| "object"
|
|
27
|
+
| "type"
|
|
28
|
+
| "variable"
|
|
29
|
+
>;
|
|
30
|
+
exportMode?: "all" | "exported" | "non-exported";
|
|
31
|
+
includeNonExported?: boolean;
|
|
32
|
+
},
|
|
33
33
|
];
|
|
34
34
|
```
|
|
35
35
|
|
|
@@ -37,20 +37,20 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
37
37
|
|
|
38
38
|
```ts
|
|
39
39
|
[
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
]
|
|
40
|
+
{
|
|
41
|
+
enforceFor: [
|
|
42
|
+
"class",
|
|
43
|
+
"enum",
|
|
44
|
+
"function",
|
|
45
|
+
"interface",
|
|
46
|
+
"namespace",
|
|
47
|
+
"object",
|
|
48
|
+
"type",
|
|
49
|
+
"variable",
|
|
50
|
+
],
|
|
51
|
+
exportMode: "exported",
|
|
52
|
+
},
|
|
53
|
+
];
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
## ❌ Incorrect
|
|
@@ -60,7 +60,7 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
60
60
|
* Performs a tagged operation.
|
|
61
61
|
*/
|
|
62
62
|
export function taggedFunction(value: string): string {
|
|
63
|
-
|
|
63
|
+
return value;
|
|
64
64
|
}
|
|
65
65
|
```
|
|
66
66
|
|
|
@@ -69,10 +69,11 @@ export function taggedFunction(value: string): string {
|
|
|
69
69
|
```ts
|
|
70
70
|
/**
|
|
71
71
|
* Performs a tagged operation.
|
|
72
|
+
*
|
|
72
73
|
* @abstract
|
|
73
74
|
*/
|
|
74
75
|
export function taggedFunction(value: string): string {
|
|
75
|
-
|
|
76
|
+
return value;
|
|
76
77
|
}
|
|
77
78
|
```
|
|
78
79
|
|
|
@@ -15,14 +15,22 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
15
15
|
|
|
16
16
|
```json
|
|
17
17
|
{
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
18
|
+
"rules": {
|
|
19
|
+
"tsdoc-require-2/require-alpha": [
|
|
20
|
+
"error",
|
|
21
|
+
{
|
|
22
|
+
"enforceFor": [
|
|
23
|
+
"class",
|
|
24
|
+
"function",
|
|
25
|
+
"interface",
|
|
26
|
+
"type",
|
|
27
|
+
"enum",
|
|
28
|
+
"variable",
|
|
29
|
+
"object"
|
|
24
30
|
]
|
|
25
|
-
|
|
31
|
+
}
|
|
32
|
+
]
|
|
33
|
+
}
|
|
26
34
|
}
|
|
27
35
|
```
|
|
28
36
|
|
|
@@ -35,7 +43,7 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
35
43
|
* Performs a task.
|
|
36
44
|
*/
|
|
37
45
|
export function runTask(value: string): string {
|
|
38
|
-
|
|
46
|
+
return value;
|
|
39
47
|
}
|
|
40
48
|
```
|
|
41
49
|
|
|
@@ -44,10 +52,11 @@ export function runTask(value: string): string {
|
|
|
44
52
|
```ts
|
|
45
53
|
/**
|
|
46
54
|
* Performs a task.
|
|
55
|
+
*
|
|
47
56
|
* @alpha
|
|
48
57
|
*/
|
|
49
58
|
export function runTask(value: string): string {
|
|
50
|
-
|
|
59
|
+
return value;
|
|
51
60
|
}
|
|
52
61
|
```
|
|
53
62
|
|
|
@@ -16,20 +16,20 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
16
16
|
|
|
17
17
|
```ts
|
|
18
18
|
type Options = [
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
19
|
+
{
|
|
20
|
+
enforceFor?: Array<
|
|
21
|
+
| "class"
|
|
22
|
+
| "enum"
|
|
23
|
+
| "function"
|
|
24
|
+
| "interface"
|
|
25
|
+
| "namespace"
|
|
26
|
+
| "object"
|
|
27
|
+
| "type"
|
|
28
|
+
| "variable"
|
|
29
|
+
>;
|
|
30
|
+
exportMode?: "all" | "exported" | "non-exported";
|
|
31
|
+
includeNonExported?: boolean;
|
|
32
|
+
},
|
|
33
33
|
];
|
|
34
34
|
```
|
|
35
35
|
|
|
@@ -37,20 +37,20 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
37
37
|
|
|
38
38
|
```ts
|
|
39
39
|
[
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
]
|
|
40
|
+
{
|
|
41
|
+
enforceFor: [
|
|
42
|
+
"class",
|
|
43
|
+
"enum",
|
|
44
|
+
"function",
|
|
45
|
+
"interface",
|
|
46
|
+
"namespace",
|
|
47
|
+
"object",
|
|
48
|
+
"type",
|
|
49
|
+
"variable",
|
|
50
|
+
],
|
|
51
|
+
exportMode: "exported",
|
|
52
|
+
},
|
|
53
|
+
];
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
## ❌ Incorrect
|
|
@@ -60,7 +60,7 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
60
60
|
* Performs a tagged operation.
|
|
61
61
|
*/
|
|
62
62
|
export function taggedFunction(value: string): string {
|
|
63
|
-
|
|
63
|
+
return value;
|
|
64
64
|
}
|
|
65
65
|
```
|
|
66
66
|
|
|
@@ -69,10 +69,11 @@ export function taggedFunction(value: string): string {
|
|
|
69
69
|
```ts
|
|
70
70
|
/**
|
|
71
71
|
* Performs a tagged operation.
|
|
72
|
+
*
|
|
72
73
|
* @author
|
|
73
74
|
*/
|
|
74
75
|
export function taggedFunction(value: string): string {
|
|
75
|
-
|
|
76
|
+
return value;
|
|
76
77
|
}
|
|
77
78
|
```
|
|
78
79
|
|
|
@@ -15,14 +15,22 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
15
15
|
|
|
16
16
|
```json
|
|
17
17
|
{
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
18
|
+
"rules": {
|
|
19
|
+
"tsdoc-require-2/require-beta": [
|
|
20
|
+
"error",
|
|
21
|
+
{
|
|
22
|
+
"enforceFor": [
|
|
23
|
+
"class",
|
|
24
|
+
"function",
|
|
25
|
+
"interface",
|
|
26
|
+
"type",
|
|
27
|
+
"enum",
|
|
28
|
+
"variable",
|
|
29
|
+
"object"
|
|
24
30
|
]
|
|
25
|
-
|
|
31
|
+
}
|
|
32
|
+
]
|
|
33
|
+
}
|
|
26
34
|
}
|
|
27
35
|
```
|
|
28
36
|
|
|
@@ -35,7 +43,7 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
35
43
|
* Performs a task.
|
|
36
44
|
*/
|
|
37
45
|
export function runTask(value: string): string {
|
|
38
|
-
|
|
46
|
+
return value;
|
|
39
47
|
}
|
|
40
48
|
```
|
|
41
49
|
|
|
@@ -44,10 +52,11 @@ export function runTask(value: string): string {
|
|
|
44
52
|
```ts
|
|
45
53
|
/**
|
|
46
54
|
* Performs a task.
|
|
55
|
+
*
|
|
47
56
|
* @beta
|
|
48
57
|
*/
|
|
49
58
|
export function runTask(value: string): string {
|
|
50
|
-
|
|
59
|
+
return value;
|
|
51
60
|
}
|
|
52
61
|
```
|
|
53
62
|
|
|
@@ -16,20 +16,20 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
16
16
|
|
|
17
17
|
```ts
|
|
18
18
|
type Options = [
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
19
|
+
{
|
|
20
|
+
enforceFor?: Array<
|
|
21
|
+
| "class"
|
|
22
|
+
| "enum"
|
|
23
|
+
| "function"
|
|
24
|
+
| "interface"
|
|
25
|
+
| "namespace"
|
|
26
|
+
| "object"
|
|
27
|
+
| "type"
|
|
28
|
+
| "variable"
|
|
29
|
+
>;
|
|
30
|
+
exportMode?: "all" | "exported" | "non-exported";
|
|
31
|
+
includeNonExported?: boolean;
|
|
32
|
+
},
|
|
33
33
|
];
|
|
34
34
|
```
|
|
35
35
|
|
|
@@ -37,20 +37,20 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
37
37
|
|
|
38
38
|
```ts
|
|
39
39
|
[
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
]
|
|
40
|
+
{
|
|
41
|
+
enforceFor: [
|
|
42
|
+
"class",
|
|
43
|
+
"enum",
|
|
44
|
+
"function",
|
|
45
|
+
"interface",
|
|
46
|
+
"namespace",
|
|
47
|
+
"object",
|
|
48
|
+
"type",
|
|
49
|
+
"variable",
|
|
50
|
+
],
|
|
51
|
+
exportMode: "exported",
|
|
52
|
+
},
|
|
53
|
+
];
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
## ❌ Incorrect
|
|
@@ -60,7 +60,7 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
60
60
|
* Performs a tagged operation.
|
|
61
61
|
*/
|
|
62
62
|
export function taggedFunction(value: string): string {
|
|
63
|
-
|
|
63
|
+
return value;
|
|
64
64
|
}
|
|
65
65
|
```
|
|
66
66
|
|
|
@@ -69,10 +69,9 @@ export function taggedFunction(value: string): string {
|
|
|
69
69
|
```ts
|
|
70
70
|
/**
|
|
71
71
|
* Performs a tagged operation.
|
|
72
|
-
* @category
|
|
73
72
|
*/
|
|
74
73
|
export function taggedFunction(value: string): string {
|
|
75
|
-
|
|
74
|
+
return value;
|
|
76
75
|
}
|
|
77
76
|
```
|
|
78
77
|
|
|
@@ -26,14 +26,14 @@ Flat config example (class-only scope):
|
|
|
26
26
|
import tsdocRequire from "eslint-plugin-tsdoc-require-2";
|
|
27
27
|
|
|
28
28
|
export default [
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
29
|
+
{
|
|
30
|
+
plugins: {
|
|
31
|
+
"tsdoc-require-2": tsdocRequire,
|
|
32
|
+
},
|
|
33
|
+
rules: {
|
|
34
|
+
"tsdoc-require-2/require-class": ["error", { enforceFor: ["class"] }],
|
|
35
|
+
},
|
|
36
|
+
},
|
|
37
37
|
];
|
|
38
38
|
```
|
|
39
39
|
|
|
@@ -44,7 +44,7 @@ export default [
|
|
|
44
44
|
* Represents a cache entry.
|
|
45
45
|
*/
|
|
46
46
|
export class CacheEntry {
|
|
47
|
-
|
|
47
|
+
public constructor(public readonly key: string) {}
|
|
48
48
|
}
|
|
49
49
|
```
|
|
50
50
|
|
|
@@ -53,10 +53,11 @@ export class CacheEntry {
|
|
|
53
53
|
```ts
|
|
54
54
|
/**
|
|
55
55
|
* Represents a cache entry.
|
|
56
|
+
*
|
|
56
57
|
* @class
|
|
57
58
|
*/
|
|
58
59
|
export class CacheEntry {
|
|
59
|
-
|
|
60
|
+
public constructor(public readonly key: string) {}
|
|
60
61
|
}
|
|
61
62
|
```
|
|
62
63
|
|
|
@@ -15,14 +15,22 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
15
15
|
|
|
16
16
|
```json
|
|
17
17
|
{
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
18
|
+
"rules": {
|
|
19
|
+
"tsdoc-require-2/require-decorator": [
|
|
20
|
+
"error",
|
|
21
|
+
{
|
|
22
|
+
"enforceFor": [
|
|
23
|
+
"class",
|
|
24
|
+
"function",
|
|
25
|
+
"interface",
|
|
26
|
+
"type",
|
|
27
|
+
"enum",
|
|
28
|
+
"variable",
|
|
29
|
+
"object"
|
|
24
30
|
]
|
|
25
|
-
|
|
31
|
+
}
|
|
32
|
+
]
|
|
33
|
+
}
|
|
26
34
|
}
|
|
27
35
|
```
|
|
28
36
|
|
|
@@ -35,7 +43,7 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
35
43
|
* Performs a task.
|
|
36
44
|
*/
|
|
37
45
|
export function runTask(value: string): string {
|
|
38
|
-
|
|
46
|
+
return value;
|
|
39
47
|
}
|
|
40
48
|
```
|
|
41
49
|
|
|
@@ -44,10 +52,11 @@ export function runTask(value: string): string {
|
|
|
44
52
|
```ts
|
|
45
53
|
/**
|
|
46
54
|
* Performs a task.
|
|
55
|
+
*
|
|
47
56
|
* @decorator
|
|
48
57
|
*/
|
|
49
58
|
export function runTask(value: string): string {
|
|
50
|
-
|
|
59
|
+
return value;
|
|
51
60
|
}
|
|
52
61
|
```
|
|
53
62
|
|
|
@@ -15,14 +15,22 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
15
15
|
|
|
16
16
|
```json
|
|
17
17
|
{
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
18
|
+
"rules": {
|
|
19
|
+
"tsdoc-require-2/require-default-value": [
|
|
20
|
+
"error",
|
|
21
|
+
{
|
|
22
|
+
"enforceFor": [
|
|
23
|
+
"class",
|
|
24
|
+
"function",
|
|
25
|
+
"interface",
|
|
26
|
+
"type",
|
|
27
|
+
"enum",
|
|
28
|
+
"variable",
|
|
29
|
+
"object"
|
|
24
30
|
]
|
|
25
|
-
|
|
31
|
+
}
|
|
32
|
+
]
|
|
33
|
+
}
|
|
26
34
|
}
|
|
27
35
|
```
|
|
28
36
|
|
|
@@ -35,7 +43,7 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
35
43
|
* Performs a task.
|
|
36
44
|
*/
|
|
37
45
|
export function runTask(value: string): string {
|
|
38
|
-
|
|
46
|
+
return value;
|
|
39
47
|
}
|
|
40
48
|
```
|
|
41
49
|
|
|
@@ -44,10 +52,11 @@ export function runTask(value: string): string {
|
|
|
44
52
|
```ts
|
|
45
53
|
/**
|
|
46
54
|
* Performs a task.
|
|
55
|
+
*
|
|
47
56
|
* @defaultValue
|
|
48
57
|
*/
|
|
49
58
|
export function runTask(value: string): string {
|
|
50
|
-
|
|
59
|
+
return value;
|
|
51
60
|
}
|
|
52
61
|
```
|
|
53
62
|
|
|
@@ -15,14 +15,22 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
15
15
|
|
|
16
16
|
```json
|
|
17
17
|
{
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
18
|
+
"rules": {
|
|
19
|
+
"tsdoc-require-2/require-deprecated": [
|
|
20
|
+
"error",
|
|
21
|
+
{
|
|
22
|
+
"enforceFor": [
|
|
23
|
+
"class",
|
|
24
|
+
"function",
|
|
25
|
+
"interface",
|
|
26
|
+
"type",
|
|
27
|
+
"enum",
|
|
28
|
+
"variable",
|
|
29
|
+
"object"
|
|
24
30
|
]
|
|
25
|
-
|
|
31
|
+
}
|
|
32
|
+
]
|
|
33
|
+
}
|
|
26
34
|
}
|
|
27
35
|
```
|
|
28
36
|
|
|
@@ -35,7 +43,7 @@ It supports the same options as [`tsdoc-require-2/require`](../require.md):
|
|
|
35
43
|
* Performs a task.
|
|
36
44
|
*/
|
|
37
45
|
export function runTask(value: string): string {
|
|
38
|
-
|
|
46
|
+
return value;
|
|
39
47
|
}
|
|
40
48
|
```
|
|
41
49
|
|
|
@@ -44,10 +52,11 @@ export function runTask(value: string): string {
|
|
|
44
52
|
```ts
|
|
45
53
|
/**
|
|
46
54
|
* Performs a task.
|
|
55
|
+
*
|
|
47
56
|
* @deprecated
|
|
48
57
|
*/
|
|
49
58
|
export function runTask(value: string): string {
|
|
50
|
-
|
|
59
|
+
return value;
|
|
51
60
|
}
|
|
52
61
|
```
|
|
53
62
|
|
|
@@ -16,20 +16,20 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
16
16
|
|
|
17
17
|
```ts
|
|
18
18
|
type Options = [
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
19
|
+
{
|
|
20
|
+
enforceFor?: Array<
|
|
21
|
+
| "class"
|
|
22
|
+
| "enum"
|
|
23
|
+
| "function"
|
|
24
|
+
| "interface"
|
|
25
|
+
| "namespace"
|
|
26
|
+
| "object"
|
|
27
|
+
| "type"
|
|
28
|
+
| "variable"
|
|
29
|
+
>;
|
|
30
|
+
exportMode?: "all" | "exported" | "non-exported";
|
|
31
|
+
includeNonExported?: boolean;
|
|
32
|
+
},
|
|
33
33
|
];
|
|
34
34
|
```
|
|
35
35
|
|
|
@@ -37,20 +37,20 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
37
37
|
|
|
38
38
|
```ts
|
|
39
39
|
[
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
]
|
|
40
|
+
{
|
|
41
|
+
enforceFor: [
|
|
42
|
+
"class",
|
|
43
|
+
"enum",
|
|
44
|
+
"function",
|
|
45
|
+
"interface",
|
|
46
|
+
"namespace",
|
|
47
|
+
"object",
|
|
48
|
+
"type",
|
|
49
|
+
"variable",
|
|
50
|
+
],
|
|
51
|
+
exportMode: "exported",
|
|
52
|
+
},
|
|
53
|
+
];
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
## ❌ Incorrect
|
|
@@ -60,7 +60,7 @@ This rule accepts the same options as [`tsdoc-require-2/require`](../require.md)
|
|
|
60
60
|
* Performs a tagged operation.
|
|
61
61
|
*/
|
|
62
62
|
export function taggedFunction(value: string): string {
|
|
63
|
-
|
|
63
|
+
return value;
|
|
64
64
|
}
|
|
65
65
|
```
|
|
66
66
|
|
|
@@ -69,10 +69,11 @@ export function taggedFunction(value: string): string {
|
|
|
69
69
|
```ts
|
|
70
70
|
/**
|
|
71
71
|
* Performs a tagged operation.
|
|
72
|
+
*
|
|
72
73
|
* @document
|
|
73
74
|
*/
|
|
74
75
|
export function taggedFunction(value: string): string {
|
|
75
|
-
|
|
76
|
+
return value;
|
|
76
77
|
}
|
|
77
78
|
```
|
|
78
79
|
|