eslint-plugin-tsdoc-require-2 1.0.1 → 1.0.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 +115 -73
- package/dist/internal/require-tag-factory.cjs +309 -0
- package/dist/internal/require-tag-factory.d.ts +26 -0
- package/dist/internal/require-tag-factory.d.ts.map +1 -0
- package/dist/internal/require-tag-factory.js +302 -0
- package/dist/internal/require-tag-factory.js.map +1 -0
- package/dist/plugin.cjs +60 -0
- package/dist/plugin.d.cts +3 -0
- package/dist/plugin.d.ts +2 -1
- package/dist/plugin.d.ts.map +1 -1
- package/dist/plugin.js +33 -11
- package/dist/plugin.js.map +1 -1
- package/dist/rules/require-tag-rules.cjs +88 -0
- package/dist/rules/require-tag-rules.d.ts +35 -0
- package/dist/rules/require-tag-rules.d.ts.map +1 -0
- package/dist/rules/require-tag-rules.js +85 -0
- package/dist/rules/require-tag-rules.js.map +1 -0
- package/dist/rules/require.cjs +296 -0
- package/dist/rules/require.d.ts +1 -0
- package/dist/rules/require.d.ts.map +1 -1
- package/dist/rules/require.js +16 -3
- package/dist/rules/require.js.map +1 -1
- package/dist/rules/required-tags/require-alpha.cjs +32 -0
- package/dist/rules/required-tags/require-alpha.d.ts +4 -0
- package/dist/rules/required-tags/require-alpha.d.ts.map +1 -0
- package/dist/rules/required-tags/require-alpha.js +30 -0
- package/dist/rules/required-tags/require-alpha.js.map +1 -0
- package/dist/rules/required-tags/require-beta.cjs +32 -0
- package/dist/rules/required-tags/require-beta.d.ts +4 -0
- package/dist/rules/required-tags/require-beta.d.ts.map +1 -0
- package/dist/rules/required-tags/require-beta.js +30 -0
- package/dist/rules/required-tags/require-beta.js.map +1 -0
- package/dist/rules/required-tags/require-decorator.cjs +32 -0
- package/dist/rules/required-tags/require-decorator.d.ts +4 -0
- package/dist/rules/required-tags/require-decorator.d.ts.map +1 -0
- package/dist/rules/required-tags/require-decorator.js +30 -0
- package/dist/rules/required-tags/require-decorator.js.map +1 -0
- package/dist/rules/required-tags/require-default-value.cjs +32 -0
- package/dist/rules/required-tags/require-default-value.d.ts +4 -0
- package/dist/rules/required-tags/require-default-value.d.ts.map +1 -0
- package/dist/rules/required-tags/require-default-value.js +30 -0
- package/dist/rules/required-tags/require-default-value.js.map +1 -0
- package/dist/rules/required-tags/require-deprecated.cjs +32 -0
- package/dist/rules/required-tags/require-deprecated.d.ts +4 -0
- package/dist/rules/required-tags/require-deprecated.d.ts.map +1 -0
- package/dist/rules/required-tags/require-deprecated.js +30 -0
- package/dist/rules/required-tags/require-deprecated.js.map +1 -0
- package/dist/rules/required-tags/require-event-property.cjs +32 -0
- package/dist/rules/required-tags/require-event-property.d.ts +4 -0
- package/dist/rules/required-tags/require-event-property.d.ts.map +1 -0
- package/dist/rules/required-tags/require-event-property.js +30 -0
- package/dist/rules/required-tags/require-event-property.js.map +1 -0
- package/dist/rules/required-tags/require-example.cjs +32 -0
- package/dist/rules/required-tags/require-example.d.ts +4 -0
- package/dist/rules/required-tags/require-example.d.ts.map +1 -0
- package/dist/rules/required-tags/require-example.js +30 -0
- package/dist/rules/required-tags/require-example.js.map +1 -0
- package/dist/rules/required-tags/require-experimental.cjs +32 -0
- package/dist/rules/required-tags/require-experimental.d.ts +4 -0
- package/dist/rules/required-tags/require-experimental.d.ts.map +1 -0
- package/dist/rules/required-tags/require-experimental.js +30 -0
- package/dist/rules/required-tags/require-experimental.js.map +1 -0
- package/dist/rules/required-tags/require-inherit-doc.cjs +32 -0
- package/dist/rules/required-tags/require-inherit-doc.d.ts +4 -0
- package/dist/rules/required-tags/require-inherit-doc.d.ts.map +1 -0
- package/dist/rules/required-tags/require-inherit-doc.js +30 -0
- package/dist/rules/required-tags/require-inherit-doc.js.map +1 -0
- package/dist/rules/required-tags/require-internal.cjs +32 -0
- package/dist/rules/required-tags/require-internal.d.ts +4 -0
- package/dist/rules/required-tags/require-internal.d.ts.map +1 -0
- package/dist/rules/required-tags/require-internal.js +30 -0
- package/dist/rules/required-tags/require-internal.js.map +1 -0
- package/dist/rules/required-tags/require-label.cjs +32 -0
- package/dist/rules/required-tags/require-label.d.ts +4 -0
- package/dist/rules/required-tags/require-label.d.ts.map +1 -0
- package/dist/rules/required-tags/require-label.js +30 -0
- package/dist/rules/required-tags/require-label.js.map +1 -0
- package/dist/rules/required-tags/require-link.cjs +32 -0
- package/dist/rules/required-tags/require-link.d.ts +4 -0
- package/dist/rules/required-tags/require-link.d.ts.map +1 -0
- package/dist/rules/required-tags/require-link.js +30 -0
- package/dist/rules/required-tags/require-link.js.map +1 -0
- package/dist/rules/required-tags/require-override.cjs +32 -0
- package/dist/rules/required-tags/require-override.d.ts +4 -0
- package/dist/rules/required-tags/require-override.d.ts.map +1 -0
- package/dist/rules/required-tags/require-override.js +30 -0
- package/dist/rules/required-tags/require-override.js.map +1 -0
- package/dist/rules/required-tags/require-package-documentation.cjs +32 -0
- package/dist/rules/required-tags/require-package-documentation.d.ts +4 -0
- package/dist/rules/required-tags/require-package-documentation.d.ts.map +1 -0
- package/dist/rules/required-tags/require-package-documentation.js +30 -0
- package/dist/rules/required-tags/require-package-documentation.js.map +1 -0
- package/dist/rules/required-tags/require-param.cjs +32 -0
- package/dist/rules/required-tags/require-param.d.ts +4 -0
- package/dist/rules/required-tags/require-param.d.ts.map +1 -0
- package/dist/rules/required-tags/require-param.js +30 -0
- package/dist/rules/required-tags/require-param.js.map +1 -0
- package/dist/rules/required-tags/require-private-remarks.cjs +32 -0
- package/dist/rules/required-tags/require-private-remarks.d.ts +4 -0
- package/dist/rules/required-tags/require-private-remarks.d.ts.map +1 -0
- package/dist/rules/required-tags/require-private-remarks.js +30 -0
- package/dist/rules/required-tags/require-private-remarks.js.map +1 -0
- package/dist/rules/required-tags/require-public.cjs +32 -0
- package/dist/rules/required-tags/require-public.d.ts +4 -0
- package/dist/rules/required-tags/require-public.d.ts.map +1 -0
- package/dist/rules/required-tags/require-public.js +30 -0
- package/dist/rules/required-tags/require-public.js.map +1 -0
- package/dist/rules/required-tags/require-readonly.cjs +32 -0
- package/dist/rules/required-tags/require-readonly.d.ts +4 -0
- package/dist/rules/required-tags/require-readonly.d.ts.map +1 -0
- package/dist/rules/required-tags/require-readonly.js +30 -0
- package/dist/rules/required-tags/require-readonly.js.map +1 -0
- package/dist/rules/required-tags/require-remarks.cjs +32 -0
- package/dist/rules/required-tags/require-remarks.d.ts +4 -0
- package/dist/rules/required-tags/require-remarks.d.ts.map +1 -0
- package/dist/rules/required-tags/require-remarks.js +30 -0
- package/dist/rules/required-tags/require-remarks.js.map +1 -0
- package/dist/rules/required-tags/require-returns.cjs +32 -0
- package/dist/rules/required-tags/require-returns.d.ts +4 -0
- package/dist/rules/required-tags/require-returns.d.ts.map +1 -0
- package/dist/rules/required-tags/require-returns.js +30 -0
- package/dist/rules/required-tags/require-returns.js.map +1 -0
- package/dist/rules/required-tags/require-sealed.cjs +32 -0
- package/dist/rules/required-tags/require-sealed.d.ts +4 -0
- package/dist/rules/required-tags/require-sealed.d.ts.map +1 -0
- package/dist/rules/required-tags/require-sealed.js +30 -0
- package/dist/rules/required-tags/require-sealed.js.map +1 -0
- package/dist/rules/required-tags/require-see.cjs +32 -0
- package/dist/rules/required-tags/require-see.d.ts +4 -0
- package/dist/rules/required-tags/require-see.d.ts.map +1 -0
- package/dist/rules/required-tags/require-see.js +30 -0
- package/dist/rules/required-tags/require-see.js.map +1 -0
- package/dist/rules/required-tags/require-throws.cjs +32 -0
- package/dist/rules/required-tags/require-throws.d.ts +4 -0
- package/dist/rules/required-tags/require-throws.d.ts.map +1 -0
- package/dist/rules/required-tags/require-throws.js +30 -0
- package/dist/rules/required-tags/require-throws.js.map +1 -0
- package/dist/rules/required-tags/require-type-param.cjs +32 -0
- package/dist/rules/required-tags/require-type-param.d.ts +4 -0
- package/dist/rules/required-tags/require-type-param.d.ts.map +1 -0
- package/dist/rules/required-tags/require-type-param.js +30 -0
- package/dist/rules/required-tags/require-type-param.js.map +1 -0
- package/dist/rules/required-tags/require-virtual.cjs +32 -0
- package/dist/rules/required-tags/require-virtual.d.ts +4 -0
- package/dist/rules/required-tags/require-virtual.d.ts.map +1 -0
- package/dist/rules/required-tags/require-virtual.js +30 -0
- package/dist/rules/required-tags/require-virtual.js.map +1 -0
- package/docs/rules/require.md +39 -5
- package/docs/rules/required-tags/require-alpha.md +57 -0
- package/docs/rules/required-tags/require-beta.md +57 -0
- package/docs/rules/required-tags/require-decorator.md +57 -0
- package/docs/rules/required-tags/require-default-value.md +57 -0
- package/docs/rules/required-tags/require-deprecated.md +57 -0
- package/docs/rules/required-tags/require-event-property.md +57 -0
- package/docs/rules/required-tags/require-example.md +57 -0
- package/docs/rules/required-tags/require-experimental.md +57 -0
- package/docs/rules/required-tags/require-inherit-doc.md +57 -0
- package/docs/rules/required-tags/require-internal.md +57 -0
- package/docs/rules/required-tags/require-label.md +57 -0
- package/docs/rules/required-tags/require-link.md +57 -0
- package/docs/rules/required-tags/require-override.md +57 -0
- package/docs/rules/required-tags/require-package-documentation.md +57 -0
- package/docs/rules/required-tags/require-param.md +57 -0
- package/docs/rules/required-tags/require-private-remarks.md +57 -0
- package/docs/rules/required-tags/require-public.md +57 -0
- package/docs/rules/required-tags/require-readonly.md +57 -0
- package/docs/rules/required-tags/require-remarks.md +57 -0
- package/docs/rules/required-tags/require-returns.md +57 -0
- package/docs/rules/required-tags/require-sealed.md +57 -0
- package/docs/rules/required-tags/require-see.md +57 -0
- package/docs/rules/required-tags/require-throws.md +57 -0
- package/docs/rules/required-tags/require-type-param.md +57 -0
- package/docs/rules/required-tags/require-virtual.md +57 -0
- package/docs/rules/required-tags.md +76 -0
- package/package.json +54 -29
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const require_tag_factory_js_1 = require("../../internal/require-tag-factory.cjs");
|
|
4
|
+
const RequireRemarksRule = (0, require_tag_factory_js_1.createTagRule)({
|
|
5
|
+
create(context) {
|
|
6
|
+
return (0, require_tag_factory_js_1.createRequireTagRuleListener)(context, "@remarks");
|
|
7
|
+
},
|
|
8
|
+
defaultOptions: require_tag_factory_js_1.defaultRuleOptions,
|
|
9
|
+
meta: {
|
|
10
|
+
defaultOptions: [
|
|
11
|
+
{
|
|
12
|
+
enforceFor: [...require_tag_factory_js_1.enforceableEntityKinds],
|
|
13
|
+
includeNonExported: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
deprecated: false,
|
|
17
|
+
docs: {
|
|
18
|
+
description: "require @remarks tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
19
|
+
frozen: false,
|
|
20
|
+
recommended: false,
|
|
21
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-remarks.md",
|
|
22
|
+
},
|
|
23
|
+
messages: {
|
|
24
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @remarks.",
|
|
25
|
+
},
|
|
26
|
+
schema: [require_tag_factory_js_1.optionSchema],
|
|
27
|
+
type: "problem",
|
|
28
|
+
},
|
|
29
|
+
name: "require-remarks",
|
|
30
|
+
});
|
|
31
|
+
exports.default = RequireRemarksRule;
|
|
32
|
+
//# sourceMappingURL=require-remarks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-remarks.d.ts","sourceRoot":"","sources":["../../../src/rules/required-tags/require-remarks.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,aAAa,EAErB,MAAM,uCAAuC,CAAC;AAE/C,QAAA,MAAM,kBAAkB,EAAE,aA+BxB,CAAC;AAEH,eAAe,kBAAkB,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { createRequireTagRuleListener, createTagRule, defaultRuleOptions, enforceableEntityKinds, optionSchema, } from "../../internal/require-tag-factory.js";
|
|
2
|
+
const RequireRemarksRule = createTagRule({
|
|
3
|
+
create(context) {
|
|
4
|
+
return createRequireTagRuleListener(context, "@remarks");
|
|
5
|
+
},
|
|
6
|
+
defaultOptions: defaultRuleOptions,
|
|
7
|
+
meta: {
|
|
8
|
+
defaultOptions: [
|
|
9
|
+
{
|
|
10
|
+
enforceFor: [...enforceableEntityKinds],
|
|
11
|
+
includeNonExported: false,
|
|
12
|
+
},
|
|
13
|
+
],
|
|
14
|
+
deprecated: false,
|
|
15
|
+
docs: {
|
|
16
|
+
description: "require @remarks tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
17
|
+
frozen: false,
|
|
18
|
+
recommended: false,
|
|
19
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-remarks.md",
|
|
20
|
+
},
|
|
21
|
+
messages: {
|
|
22
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @remarks.",
|
|
23
|
+
},
|
|
24
|
+
schema: [optionSchema],
|
|
25
|
+
type: "problem",
|
|
26
|
+
},
|
|
27
|
+
name: "require-remarks",
|
|
28
|
+
});
|
|
29
|
+
export default RequireRemarksRule;
|
|
30
|
+
//# sourceMappingURL=require-remarks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-remarks.js","sourceRoot":"","sources":["../../../src/rules/required-tags/require-remarks.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,4BAA4B,EAC5B,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GAKf,MAAM,uCAAuC,CAAC;AAE/C,MAAM,kBAAkB,GAAkB,aAAa,CAGrD;IACE,MAAM,CAAC,OAAuB;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IACD,cAAc,EAAE,kBAAkB;IAClC,IAAI,EAAE;QACF,cAAc,EAAE;YACZ;gBACI,UAAU,EAAE,CAAC,GAAG,sBAAsB,CAAC;gBACvC,kBAAkB,EAAE,KAAK;aAC5B;SACJ;QACD,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE;YACF,WAAW,EACP,uFAAuF;YAC3F,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,mHAAmH;SAC3H;QACD,QAAQ,EAAE;YACN,UAAU,EACN,gEAAgE;SACvE;QACD,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,SAAS;KAClB;IACD,IAAI,EAAE,iBAAiB;CAC1B,CAAC,CAAC;AAEH,eAAe,kBAAkB,CAAC"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const require_tag_factory_js_1 = require("../../internal/require-tag-factory.cjs");
|
|
4
|
+
const RequireReturnsRule = (0, require_tag_factory_js_1.createTagRule)({
|
|
5
|
+
create(context) {
|
|
6
|
+
return (0, require_tag_factory_js_1.createRequireTagRuleListener)(context, "@returns");
|
|
7
|
+
},
|
|
8
|
+
defaultOptions: require_tag_factory_js_1.defaultRuleOptions,
|
|
9
|
+
meta: {
|
|
10
|
+
defaultOptions: [
|
|
11
|
+
{
|
|
12
|
+
enforceFor: [...require_tag_factory_js_1.enforceableEntityKinds],
|
|
13
|
+
includeNonExported: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
deprecated: false,
|
|
17
|
+
docs: {
|
|
18
|
+
description: "require @returns tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
19
|
+
frozen: false,
|
|
20
|
+
recommended: false,
|
|
21
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-returns.md",
|
|
22
|
+
},
|
|
23
|
+
messages: {
|
|
24
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @returns.",
|
|
25
|
+
},
|
|
26
|
+
schema: [require_tag_factory_js_1.optionSchema],
|
|
27
|
+
type: "problem",
|
|
28
|
+
},
|
|
29
|
+
name: "require-returns",
|
|
30
|
+
});
|
|
31
|
+
exports.default = RequireReturnsRule;
|
|
32
|
+
//# sourceMappingURL=require-returns.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-returns.d.ts","sourceRoot":"","sources":["../../../src/rules/required-tags/require-returns.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,aAAa,EAErB,MAAM,uCAAuC,CAAC;AAE/C,QAAA,MAAM,kBAAkB,EAAE,aA+BxB,CAAC;AAEH,eAAe,kBAAkB,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { createRequireTagRuleListener, createTagRule, defaultRuleOptions, enforceableEntityKinds, optionSchema, } from "../../internal/require-tag-factory.js";
|
|
2
|
+
const RequireReturnsRule = createTagRule({
|
|
3
|
+
create(context) {
|
|
4
|
+
return createRequireTagRuleListener(context, "@returns");
|
|
5
|
+
},
|
|
6
|
+
defaultOptions: defaultRuleOptions,
|
|
7
|
+
meta: {
|
|
8
|
+
defaultOptions: [
|
|
9
|
+
{
|
|
10
|
+
enforceFor: [...enforceableEntityKinds],
|
|
11
|
+
includeNonExported: false,
|
|
12
|
+
},
|
|
13
|
+
],
|
|
14
|
+
deprecated: false,
|
|
15
|
+
docs: {
|
|
16
|
+
description: "require @returns tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
17
|
+
frozen: false,
|
|
18
|
+
recommended: false,
|
|
19
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-returns.md",
|
|
20
|
+
},
|
|
21
|
+
messages: {
|
|
22
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @returns.",
|
|
23
|
+
},
|
|
24
|
+
schema: [optionSchema],
|
|
25
|
+
type: "problem",
|
|
26
|
+
},
|
|
27
|
+
name: "require-returns",
|
|
28
|
+
});
|
|
29
|
+
export default RequireReturnsRule;
|
|
30
|
+
//# sourceMappingURL=require-returns.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-returns.js","sourceRoot":"","sources":["../../../src/rules/required-tags/require-returns.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,4BAA4B,EAC5B,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GAKf,MAAM,uCAAuC,CAAC;AAE/C,MAAM,kBAAkB,GAAkB,aAAa,CAGrD;IACE,MAAM,CAAC,OAAuB;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IACD,cAAc,EAAE,kBAAkB;IAClC,IAAI,EAAE;QACF,cAAc,EAAE;YACZ;gBACI,UAAU,EAAE,CAAC,GAAG,sBAAsB,CAAC;gBACvC,kBAAkB,EAAE,KAAK;aAC5B;SACJ;QACD,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE;YACF,WAAW,EACP,uFAAuF;YAC3F,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,mHAAmH;SAC3H;QACD,QAAQ,EAAE;YACN,UAAU,EACN,gEAAgE;SACvE;QACD,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,SAAS;KAClB;IACD,IAAI,EAAE,iBAAiB;CAC1B,CAAC,CAAC;AAEH,eAAe,kBAAkB,CAAC"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const require_tag_factory_js_1 = require("../../internal/require-tag-factory.cjs");
|
|
4
|
+
const RequireSealedRule = (0, require_tag_factory_js_1.createTagRule)({
|
|
5
|
+
create(context) {
|
|
6
|
+
return (0, require_tag_factory_js_1.createRequireTagRuleListener)(context, "@sealed");
|
|
7
|
+
},
|
|
8
|
+
defaultOptions: require_tag_factory_js_1.defaultRuleOptions,
|
|
9
|
+
meta: {
|
|
10
|
+
defaultOptions: [
|
|
11
|
+
{
|
|
12
|
+
enforceFor: [...require_tag_factory_js_1.enforceableEntityKinds],
|
|
13
|
+
includeNonExported: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
deprecated: false,
|
|
17
|
+
docs: {
|
|
18
|
+
description: "require @sealed tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
19
|
+
frozen: false,
|
|
20
|
+
recommended: false,
|
|
21
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-sealed.md",
|
|
22
|
+
},
|
|
23
|
+
messages: {
|
|
24
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @sealed.",
|
|
25
|
+
},
|
|
26
|
+
schema: [require_tag_factory_js_1.optionSchema],
|
|
27
|
+
type: "problem",
|
|
28
|
+
},
|
|
29
|
+
name: "require-sealed",
|
|
30
|
+
});
|
|
31
|
+
exports.default = RequireSealedRule;
|
|
32
|
+
//# sourceMappingURL=require-sealed.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-sealed.d.ts","sourceRoot":"","sources":["../../../src/rules/required-tags/require-sealed.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,aAAa,EAErB,MAAM,uCAAuC,CAAC;AAE/C,QAAA,MAAM,iBAAiB,EAAE,aA+BvB,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { createRequireTagRuleListener, createTagRule, defaultRuleOptions, enforceableEntityKinds, optionSchema, } from "../../internal/require-tag-factory.js";
|
|
2
|
+
const RequireSealedRule = createTagRule({
|
|
3
|
+
create(context) {
|
|
4
|
+
return createRequireTagRuleListener(context, "@sealed");
|
|
5
|
+
},
|
|
6
|
+
defaultOptions: defaultRuleOptions,
|
|
7
|
+
meta: {
|
|
8
|
+
defaultOptions: [
|
|
9
|
+
{
|
|
10
|
+
enforceFor: [...enforceableEntityKinds],
|
|
11
|
+
includeNonExported: false,
|
|
12
|
+
},
|
|
13
|
+
],
|
|
14
|
+
deprecated: false,
|
|
15
|
+
docs: {
|
|
16
|
+
description: "require @sealed tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
17
|
+
frozen: false,
|
|
18
|
+
recommended: false,
|
|
19
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-sealed.md",
|
|
20
|
+
},
|
|
21
|
+
messages: {
|
|
22
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @sealed.",
|
|
23
|
+
},
|
|
24
|
+
schema: [optionSchema],
|
|
25
|
+
type: "problem",
|
|
26
|
+
},
|
|
27
|
+
name: "require-sealed",
|
|
28
|
+
});
|
|
29
|
+
export default RequireSealedRule;
|
|
30
|
+
//# sourceMappingURL=require-sealed.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-sealed.js","sourceRoot":"","sources":["../../../src/rules/required-tags/require-sealed.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,4BAA4B,EAC5B,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GAKf,MAAM,uCAAuC,CAAC;AAE/C,MAAM,iBAAiB,GAAkB,aAAa,CAGpD;IACE,MAAM,CAAC,OAAuB;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC;IACD,cAAc,EAAE,kBAAkB;IAClC,IAAI,EAAE;QACF,cAAc,EAAE;YACZ;gBACI,UAAU,EAAE,CAAC,GAAG,sBAAsB,CAAC;gBACvC,kBAAkB,EAAE,KAAK;aAC5B;SACJ;QACD,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE;YACF,WAAW,EACP,sFAAsF;YAC1F,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,kHAAkH;SAC1H;QACD,QAAQ,EAAE;YACN,UAAU,EACN,+DAA+D;SACtE;QACD,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,SAAS;KAClB;IACD,IAAI,EAAE,gBAAgB;CACzB,CAAC,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const require_tag_factory_js_1 = require("../../internal/require-tag-factory.cjs");
|
|
4
|
+
const RequireSeeRule = (0, require_tag_factory_js_1.createTagRule)({
|
|
5
|
+
create(context) {
|
|
6
|
+
return (0, require_tag_factory_js_1.createRequireTagRuleListener)(context, "@see");
|
|
7
|
+
},
|
|
8
|
+
defaultOptions: require_tag_factory_js_1.defaultRuleOptions,
|
|
9
|
+
meta: {
|
|
10
|
+
defaultOptions: [
|
|
11
|
+
{
|
|
12
|
+
enforceFor: [...require_tag_factory_js_1.enforceableEntityKinds],
|
|
13
|
+
includeNonExported: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
deprecated: false,
|
|
17
|
+
docs: {
|
|
18
|
+
description: "require @see tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
19
|
+
frozen: false,
|
|
20
|
+
recommended: false,
|
|
21
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-see.md",
|
|
22
|
+
},
|
|
23
|
+
messages: {
|
|
24
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @see.",
|
|
25
|
+
},
|
|
26
|
+
schema: [require_tag_factory_js_1.optionSchema],
|
|
27
|
+
type: "problem",
|
|
28
|
+
},
|
|
29
|
+
name: "require-see",
|
|
30
|
+
});
|
|
31
|
+
exports.default = RequireSeeRule;
|
|
32
|
+
//# sourceMappingURL=require-see.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-see.d.ts","sourceRoot":"","sources":["../../../src/rules/required-tags/require-see.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,aAAa,EAErB,MAAM,uCAAuC,CAAC;AAE/C,QAAA,MAAM,cAAc,EAAE,aA+BpB,CAAC;AAEH,eAAe,cAAc,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { createRequireTagRuleListener, createTagRule, defaultRuleOptions, enforceableEntityKinds, optionSchema, } from "../../internal/require-tag-factory.js";
|
|
2
|
+
const RequireSeeRule = createTagRule({
|
|
3
|
+
create(context) {
|
|
4
|
+
return createRequireTagRuleListener(context, "@see");
|
|
5
|
+
},
|
|
6
|
+
defaultOptions: defaultRuleOptions,
|
|
7
|
+
meta: {
|
|
8
|
+
defaultOptions: [
|
|
9
|
+
{
|
|
10
|
+
enforceFor: [...enforceableEntityKinds],
|
|
11
|
+
includeNonExported: false,
|
|
12
|
+
},
|
|
13
|
+
],
|
|
14
|
+
deprecated: false,
|
|
15
|
+
docs: {
|
|
16
|
+
description: "require @see tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
17
|
+
frozen: false,
|
|
18
|
+
recommended: false,
|
|
19
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-see.md",
|
|
20
|
+
},
|
|
21
|
+
messages: {
|
|
22
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @see.",
|
|
23
|
+
},
|
|
24
|
+
schema: [optionSchema],
|
|
25
|
+
type: "problem",
|
|
26
|
+
},
|
|
27
|
+
name: "require-see",
|
|
28
|
+
});
|
|
29
|
+
export default RequireSeeRule;
|
|
30
|
+
//# sourceMappingURL=require-see.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-see.js","sourceRoot":"","sources":["../../../src/rules/required-tags/require-see.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,4BAA4B,EAC5B,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GAKf,MAAM,uCAAuC,CAAC;AAE/C,MAAM,cAAc,GAAkB,aAAa,CAGjD;IACE,MAAM,CAAC,OAAuB;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IACD,cAAc,EAAE,kBAAkB;IAClC,IAAI,EAAE;QACF,cAAc,EAAE;YACZ;gBACI,UAAU,EAAE,CAAC,GAAG,sBAAsB,CAAC;gBACvC,kBAAkB,EAAE,KAAK;aAC5B;SACJ;QACD,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE;YACF,WAAW,EACP,mFAAmF;YACvF,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,+GAA+G;SACvH;QACD,QAAQ,EAAE;YACN,UAAU,EACN,4DAA4D;SACnE;QACD,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,SAAS;KAClB;IACD,IAAI,EAAE,aAAa;CACtB,CAAC,CAAC;AAEH,eAAe,cAAc,CAAC"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const require_tag_factory_js_1 = require("../../internal/require-tag-factory.cjs");
|
|
4
|
+
const RequireThrowsRule = (0, require_tag_factory_js_1.createTagRule)({
|
|
5
|
+
create(context) {
|
|
6
|
+
return (0, require_tag_factory_js_1.createRequireTagRuleListener)(context, "@throws");
|
|
7
|
+
},
|
|
8
|
+
defaultOptions: require_tag_factory_js_1.defaultRuleOptions,
|
|
9
|
+
meta: {
|
|
10
|
+
defaultOptions: [
|
|
11
|
+
{
|
|
12
|
+
enforceFor: [...require_tag_factory_js_1.enforceableEntityKinds],
|
|
13
|
+
includeNonExported: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
deprecated: false,
|
|
17
|
+
docs: {
|
|
18
|
+
description: "require @throws tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
19
|
+
frozen: false,
|
|
20
|
+
recommended: false,
|
|
21
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-throws.md",
|
|
22
|
+
},
|
|
23
|
+
messages: {
|
|
24
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @throws.",
|
|
25
|
+
},
|
|
26
|
+
schema: [require_tag_factory_js_1.optionSchema],
|
|
27
|
+
type: "problem",
|
|
28
|
+
},
|
|
29
|
+
name: "require-throws",
|
|
30
|
+
});
|
|
31
|
+
exports.default = RequireThrowsRule;
|
|
32
|
+
//# sourceMappingURL=require-throws.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-throws.d.ts","sourceRoot":"","sources":["../../../src/rules/required-tags/require-throws.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,aAAa,EAErB,MAAM,uCAAuC,CAAC;AAE/C,QAAA,MAAM,iBAAiB,EAAE,aA+BvB,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { createRequireTagRuleListener, createTagRule, defaultRuleOptions, enforceableEntityKinds, optionSchema, } from "../../internal/require-tag-factory.js";
|
|
2
|
+
const RequireThrowsRule = createTagRule({
|
|
3
|
+
create(context) {
|
|
4
|
+
return createRequireTagRuleListener(context, "@throws");
|
|
5
|
+
},
|
|
6
|
+
defaultOptions: defaultRuleOptions,
|
|
7
|
+
meta: {
|
|
8
|
+
defaultOptions: [
|
|
9
|
+
{
|
|
10
|
+
enforceFor: [...enforceableEntityKinds],
|
|
11
|
+
includeNonExported: false,
|
|
12
|
+
},
|
|
13
|
+
],
|
|
14
|
+
deprecated: false,
|
|
15
|
+
docs: {
|
|
16
|
+
description: "require @throws tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
17
|
+
frozen: false,
|
|
18
|
+
recommended: false,
|
|
19
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-throws.md",
|
|
20
|
+
},
|
|
21
|
+
messages: {
|
|
22
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @throws.",
|
|
23
|
+
},
|
|
24
|
+
schema: [optionSchema],
|
|
25
|
+
type: "problem",
|
|
26
|
+
},
|
|
27
|
+
name: "require-throws",
|
|
28
|
+
});
|
|
29
|
+
export default RequireThrowsRule;
|
|
30
|
+
//# sourceMappingURL=require-throws.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-throws.js","sourceRoot":"","sources":["../../../src/rules/required-tags/require-throws.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,4BAA4B,EAC5B,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GAKf,MAAM,uCAAuC,CAAC;AAE/C,MAAM,iBAAiB,GAAkB,aAAa,CAGpD;IACE,MAAM,CAAC,OAAuB;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC;IACD,cAAc,EAAE,kBAAkB;IAClC,IAAI,EAAE;QACF,cAAc,EAAE;YACZ;gBACI,UAAU,EAAE,CAAC,GAAG,sBAAsB,CAAC;gBACvC,kBAAkB,EAAE,KAAK;aAC5B;SACJ;QACD,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE;YACF,WAAW,EACP,sFAAsF;YAC1F,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,kHAAkH;SAC1H;QACD,QAAQ,EAAE;YACN,UAAU,EACN,+DAA+D;SACtE;QACD,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,SAAS;KAClB;IACD,IAAI,EAAE,gBAAgB;CACzB,CAAC,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const require_tag_factory_js_1 = require("../../internal/require-tag-factory.cjs");
|
|
4
|
+
const RequireTypeParamRule = (0, require_tag_factory_js_1.createTagRule)({
|
|
5
|
+
create(context) {
|
|
6
|
+
return (0, require_tag_factory_js_1.createRequireTagRuleListener)(context, "@typeParam");
|
|
7
|
+
},
|
|
8
|
+
defaultOptions: require_tag_factory_js_1.defaultRuleOptions,
|
|
9
|
+
meta: {
|
|
10
|
+
defaultOptions: [
|
|
11
|
+
{
|
|
12
|
+
enforceFor: [...require_tag_factory_js_1.enforceableEntityKinds],
|
|
13
|
+
includeNonExported: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
deprecated: false,
|
|
17
|
+
docs: {
|
|
18
|
+
description: "require @typeParam tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
19
|
+
frozen: false,
|
|
20
|
+
recommended: false,
|
|
21
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-type-param.md",
|
|
22
|
+
},
|
|
23
|
+
messages: {
|
|
24
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @typeParam.",
|
|
25
|
+
},
|
|
26
|
+
schema: [require_tag_factory_js_1.optionSchema],
|
|
27
|
+
type: "problem",
|
|
28
|
+
},
|
|
29
|
+
name: "require-type-param",
|
|
30
|
+
});
|
|
31
|
+
exports.default = RequireTypeParamRule;
|
|
32
|
+
//# sourceMappingURL=require-type-param.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-type-param.d.ts","sourceRoot":"","sources":["../../../src/rules/required-tags/require-type-param.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,aAAa,EAErB,MAAM,uCAAuC,CAAC;AAE/C,QAAA,MAAM,oBAAoB,EAAE,aA+B1B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { createRequireTagRuleListener, createTagRule, defaultRuleOptions, enforceableEntityKinds, optionSchema, } from "../../internal/require-tag-factory.js";
|
|
2
|
+
const RequireTypeParamRule = createTagRule({
|
|
3
|
+
create(context) {
|
|
4
|
+
return createRequireTagRuleListener(context, "@typeParam");
|
|
5
|
+
},
|
|
6
|
+
defaultOptions: defaultRuleOptions,
|
|
7
|
+
meta: {
|
|
8
|
+
defaultOptions: [
|
|
9
|
+
{
|
|
10
|
+
enforceFor: [...enforceableEntityKinds],
|
|
11
|
+
includeNonExported: false,
|
|
12
|
+
},
|
|
13
|
+
],
|
|
14
|
+
deprecated: false,
|
|
15
|
+
docs: {
|
|
16
|
+
description: "require @typeParam tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
17
|
+
frozen: false,
|
|
18
|
+
recommended: false,
|
|
19
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-type-param.md",
|
|
20
|
+
},
|
|
21
|
+
messages: {
|
|
22
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @typeParam.",
|
|
23
|
+
},
|
|
24
|
+
schema: [optionSchema],
|
|
25
|
+
type: "problem",
|
|
26
|
+
},
|
|
27
|
+
name: "require-type-param",
|
|
28
|
+
});
|
|
29
|
+
export default RequireTypeParamRule;
|
|
30
|
+
//# sourceMappingURL=require-type-param.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-type-param.js","sourceRoot":"","sources":["../../../src/rules/required-tags/require-type-param.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,4BAA4B,EAC5B,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GAKf,MAAM,uCAAuC,CAAC;AAE/C,MAAM,oBAAoB,GAAkB,aAAa,CAGvD;IACE,MAAM,CAAC,OAAuB;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC/D,CAAC;IACD,cAAc,EAAE,kBAAkB;IAClC,IAAI,EAAE;QACF,cAAc,EAAE;YACZ;gBACI,UAAU,EAAE,CAAC,GAAG,sBAAsB,CAAC;gBACvC,kBAAkB,EAAE,KAAK;aAC5B;SACJ;QACD,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE;YACF,WAAW,EACP,yFAAyF;YAC7F,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,sHAAsH;SAC9H;QACD,QAAQ,EAAE;YACN,UAAU,EACN,kEAAkE;SACzE;QACD,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,SAAS;KAClB;IACD,IAAI,EAAE,oBAAoB;CAC7B,CAAC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const require_tag_factory_js_1 = require("../../internal/require-tag-factory.cjs");
|
|
4
|
+
const RequireVirtualRule = (0, require_tag_factory_js_1.createTagRule)({
|
|
5
|
+
create(context) {
|
|
6
|
+
return (0, require_tag_factory_js_1.createRequireTagRuleListener)(context, "@virtual");
|
|
7
|
+
},
|
|
8
|
+
defaultOptions: require_tag_factory_js_1.defaultRuleOptions,
|
|
9
|
+
meta: {
|
|
10
|
+
defaultOptions: [
|
|
11
|
+
{
|
|
12
|
+
enforceFor: [...require_tag_factory_js_1.enforceableEntityKinds],
|
|
13
|
+
includeNonExported: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
deprecated: false,
|
|
17
|
+
docs: {
|
|
18
|
+
description: "require @virtual tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
19
|
+
frozen: false,
|
|
20
|
+
recommended: false,
|
|
21
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-virtual.md",
|
|
22
|
+
},
|
|
23
|
+
messages: {
|
|
24
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @virtual.",
|
|
25
|
+
},
|
|
26
|
+
schema: [require_tag_factory_js_1.optionSchema],
|
|
27
|
+
type: "problem",
|
|
28
|
+
},
|
|
29
|
+
name: "require-virtual",
|
|
30
|
+
});
|
|
31
|
+
exports.default = RequireVirtualRule;
|
|
32
|
+
//# sourceMappingURL=require-virtual.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-virtual.d.ts","sourceRoot":"","sources":["../../../src/rules/required-tags/require-virtual.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,aAAa,EAErB,MAAM,uCAAuC,CAAC;AAE/C,QAAA,MAAM,kBAAkB,EAAE,aA+BxB,CAAC;AAEH,eAAe,kBAAkB,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { createRequireTagRuleListener, createTagRule, defaultRuleOptions, enforceableEntityKinds, optionSchema, } from "../../internal/require-tag-factory.js";
|
|
2
|
+
const RequireVirtualRule = createTagRule({
|
|
3
|
+
create(context) {
|
|
4
|
+
return createRequireTagRuleListener(context, "@virtual");
|
|
5
|
+
},
|
|
6
|
+
defaultOptions: defaultRuleOptions,
|
|
7
|
+
meta: {
|
|
8
|
+
defaultOptions: [
|
|
9
|
+
{
|
|
10
|
+
enforceFor: [...enforceableEntityKinds],
|
|
11
|
+
includeNonExported: false,
|
|
12
|
+
},
|
|
13
|
+
],
|
|
14
|
+
deprecated: false,
|
|
15
|
+
docs: {
|
|
16
|
+
description: "require @virtual tag in TSDoc blocks for TypeScript declarations and default exports.",
|
|
17
|
+
frozen: false,
|
|
18
|
+
recommended: false,
|
|
19
|
+
url: "https://github.com/Nick2bad4u/eslint-plugin-tsdoc-require-2/blob/main/docs/rules/required-tags/require-virtual.md",
|
|
20
|
+
},
|
|
21
|
+
messages: {
|
|
22
|
+
missingTag: "TSDoc for {{entityKind}} {{entityName}} must include @virtual.",
|
|
23
|
+
},
|
|
24
|
+
schema: [optionSchema],
|
|
25
|
+
type: "problem",
|
|
26
|
+
},
|
|
27
|
+
name: "require-virtual",
|
|
28
|
+
});
|
|
29
|
+
export default RequireVirtualRule;
|
|
30
|
+
//# sourceMappingURL=require-virtual.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"require-virtual.js","sourceRoot":"","sources":["../../../src/rules/required-tags/require-virtual.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,4BAA4B,EAC5B,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GAKf,MAAM,uCAAuC,CAAC;AAE/C,MAAM,kBAAkB,GAAkB,aAAa,CAGrD;IACE,MAAM,CAAC,OAAuB;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IACD,cAAc,EAAE,kBAAkB;IAClC,IAAI,EAAE;QACF,cAAc,EAAE;YACZ;gBACI,UAAU,EAAE,CAAC,GAAG,sBAAsB,CAAC;gBACvC,kBAAkB,EAAE,KAAK;aAC5B;SACJ;QACD,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE;YACF,WAAW,EACP,uFAAuF;YAC3F,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,mHAAmH;SAC3H;QACD,QAAQ,EAAE;YACN,UAAU,EACN,gEAAgE;SACvE;QACD,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,SAAS;KAClB;IACD,IAAI,EAAE,iBAAiB;CAC1B,CAAC,CAAC;AAEH,eAAe,kBAAkB,CAAC"}
|
package/docs/rules/require.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# tsdoc-require-2/require
|
|
2
2
|
|
|
3
|
-
Requires TSDoc comments for exported TypeScript declarations and default exports.
|
|
3
|
+
Requires TSDoc comments for exported TypeScript declarations and default exports, with optional enforcement for non-exported top-level declarations.
|
|
4
4
|
|
|
5
5
|
## Rule Details
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
By default, this rule reports exported declarations that do not have a TSDoc block comment (`/** ... */`) directly above them.
|
|
8
8
|
|
|
9
9
|
It checks:
|
|
10
10
|
|
|
@@ -16,6 +16,8 @@ It checks:
|
|
|
16
16
|
- exported variables
|
|
17
17
|
- default exports (including default-exported identifiers)
|
|
18
18
|
|
|
19
|
+
When `includeNonExported: true` is enabled, the same checks also apply to non-exported top-level declarations.
|
|
20
|
+
|
|
19
21
|
Why this matters: if exported APIs are undocumented, consumers have to inspect implementation details instead of reading a stable contract.
|
|
20
22
|
|
|
21
23
|
### ❌ Incorrect
|
|
@@ -67,6 +69,7 @@ type Options = [
|
|
|
67
69
|
"type" |
|
|
68
70
|
"variable"
|
|
69
71
|
>;
|
|
72
|
+
includeNonExported?: boolean;
|
|
70
73
|
},
|
|
71
74
|
];
|
|
72
75
|
```
|
|
@@ -74,12 +77,17 @@ type Options = [
|
|
|
74
77
|
Default options:
|
|
75
78
|
|
|
76
79
|
```ts
|
|
77
|
-
[
|
|
80
|
+
[
|
|
81
|
+
{
|
|
82
|
+
enforceFor: ["class", "enum", "function", "interface", "object", "type", "variable"],
|
|
83
|
+
includeNonExported: false,
|
|
84
|
+
},
|
|
85
|
+
]
|
|
78
86
|
```
|
|
79
87
|
|
|
80
88
|
### `enforceFor`
|
|
81
89
|
|
|
82
|
-
Limits which
|
|
90
|
+
Limits which entity kinds are checked.
|
|
83
91
|
|
|
84
92
|
Example flat config that only enforces docs for classes and functions:
|
|
85
93
|
|
|
@@ -103,9 +111,35 @@ export default [
|
|
|
103
111
|
];
|
|
104
112
|
```
|
|
105
113
|
|
|
114
|
+
### `includeNonExported`
|
|
115
|
+
|
|
116
|
+
When `true`, this rule also enforces TSDoc on supported non-exported top-level declarations.
|
|
117
|
+
|
|
118
|
+
Example flat config:
|
|
119
|
+
|
|
120
|
+
```ts
|
|
121
|
+
import tsdocRequire from "eslint-plugin-tsdoc-require-2";
|
|
122
|
+
|
|
123
|
+
export default [
|
|
124
|
+
{
|
|
125
|
+
plugins: {
|
|
126
|
+
"tsdoc-require-2": tsdocRequire,
|
|
127
|
+
},
|
|
128
|
+
rules: {
|
|
129
|
+
"tsdoc-require-2/require": [
|
|
130
|
+
"error",
|
|
131
|
+
{
|
|
132
|
+
includeNonExported: true,
|
|
133
|
+
},
|
|
134
|
+
],
|
|
135
|
+
},
|
|
136
|
+
},
|
|
137
|
+
];
|
|
138
|
+
```
|
|
139
|
+
|
|
106
140
|
## When Not To Use It
|
|
107
141
|
|
|
108
|
-
Disable this rule if your project intentionally does not require API documentation on exported declarations.
|
|
142
|
+
Disable this rule if your project intentionally does not require API documentation on exported declarations (or internal declarations when `includeNonExported` is enabled).
|
|
109
143
|
|
|
110
144
|
## Further Reading
|
|
111
145
|
|