@cjser/es-joy__jsdoccomment 1.0.0-cjser.2 → 1.2.0-cjser.2
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/CHANGES.md +12 -0
- package/dist-cjser/index.cjs +18 -11
- package/package.json +17 -17
- package/src/jsdoccomment.js +13 -0
package/CHANGES.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# CHANGES for `@es-joy/jsdoccomment`
|
|
2
2
|
|
|
3
|
+
## 1.2.0
|
|
4
|
+
|
|
5
|
+
- perf: skip token search in `getFollowingComment` when no comment can follow (@christopher-buss)
|
|
6
|
+
- chore: update typescript-eslint/types, devDeps
|
|
7
|
+
- ci: check Node 26 but drop macos and reduce windows test to one
|
|
8
|
+
- ci: drop Node 20.19.0 from the test matrix (@morgan-coded)
|
|
9
|
+
- ci: check TypeScript in a separate job (@morgan-coded)
|
|
10
|
+
|
|
11
|
+
## 1.1.0
|
|
12
|
+
|
|
13
|
+
- chore: update types/estree, typescript-eslint/types, jsdoc-type-pratt-parser, devDeps.
|
|
14
|
+
|
|
3
15
|
## 1.0.0
|
|
4
16
|
|
|
5
17
|
- chore: update jsdoc-type-pratt-parser, devDep.
|
package/dist-cjser/index.cjs
CHANGED
|
@@ -27,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
|
|
|
27
27
|
));
|
|
28
28
|
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
29
29
|
|
|
30
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
30
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/index.js
|
|
31
31
|
var index_exports = {};
|
|
32
32
|
__export(index_exports, {
|
|
33
33
|
commentHandler: () => commentHandler,
|
|
@@ -52,11 +52,11 @@ module.exports = __toCommonJS(index_exports);
|
|
|
52
52
|
var import_jsdoc_type_pratt_parser4 = require("@cjser/jsdoc-type-pratt-parser");
|
|
53
53
|
__reExport(index_exports, require("@cjser/jsdoc-type-pratt-parser"), module.exports);
|
|
54
54
|
|
|
55
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
55
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/commentHandler.js
|
|
56
56
|
var import_esquery = __toESM(require("esquery"), 1);
|
|
57
57
|
var import_jsdoc_type_pratt_parser2 = require("@cjser/jsdoc-type-pratt-parser");
|
|
58
58
|
|
|
59
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
59
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/commentParserToESTree.js
|
|
60
60
|
var import_jsdoc_type_pratt_parser = require("@cjser/jsdoc-type-pratt-parser");
|
|
61
61
|
var stripEncapsulatingBrackets = (container, isArr) => {
|
|
62
62
|
if (isArr) {
|
|
@@ -343,7 +343,7 @@ var jsdocVisitorKeys = {
|
|
|
343
343
|
JsdocInlineTag: []
|
|
344
344
|
};
|
|
345
345
|
|
|
346
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
346
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/commentHandler.js
|
|
347
347
|
var commentHandler = (settings, commentParserToESTreeOptions) => {
|
|
348
348
|
return (commentSelector, jsdoc) => {
|
|
349
349
|
const { mode } = settings;
|
|
@@ -372,10 +372,10 @@ var commentHandler = (settings, commentParserToESTreeOptions) => {
|
|
|
372
372
|
};
|
|
373
373
|
};
|
|
374
374
|
|
|
375
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
375
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/estreeToString.js
|
|
376
376
|
var import_jsdoc_type_pratt_parser3 = require("@cjser/jsdoc-type-pratt-parser");
|
|
377
377
|
|
|
378
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
378
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/inlineTagEscapes.js
|
|
379
379
|
function getLabelDelimiter(format) {
|
|
380
380
|
return format === "prefix" ? "]" : "}";
|
|
381
381
|
}
|
|
@@ -419,7 +419,7 @@ function encodeInlineTagText(text, format) {
|
|
|
419
419
|
return encoded;
|
|
420
420
|
}
|
|
421
421
|
|
|
422
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
422
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/estreeToString.js
|
|
423
423
|
var stringifiers = {
|
|
424
424
|
/* eslint-enable jsdoc/reject-function-type -- Different functions */
|
|
425
425
|
JsdocBlock,
|
|
@@ -575,7 +575,7 @@ function JsdocTag(node, opts) {
|
|
|
575
575
|
return result;
|
|
576
576
|
}
|
|
577
577
|
|
|
578
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
578
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/jsdoccomment.js
|
|
579
579
|
var isCommentToken = (token) => {
|
|
580
580
|
return ["Line", "Block", "Shebang"].includes(token.type);
|
|
581
581
|
};
|
|
@@ -954,6 +954,13 @@ var getFollowingComment = function(sourceCode, astNodeInput) {
|
|
|
954
954
|
return tokenAfter2;
|
|
955
955
|
};
|
|
956
956
|
const tokenAfterIgnoringSemis = (node) => {
|
|
957
|
+
if (node.loc) {
|
|
958
|
+
const { end } = node.loc;
|
|
959
|
+
const line = sourceCode.lines[end.line - 1];
|
|
960
|
+
if (!line.includes("/", end.column) && !line.includes("<", end.column)) {
|
|
961
|
+
return null;
|
|
962
|
+
}
|
|
963
|
+
}
|
|
957
964
|
const tokenAfter2 = getTokensAfterIgnoringSemis(node);
|
|
958
965
|
return tokenAfter2 && isCommentToken(tokenAfter2) && compareLocEndToStart(node, tokenAfter2) ? tokenAfter2 : null;
|
|
959
966
|
};
|
|
@@ -980,10 +987,10 @@ var getFollowingComment = function(sourceCode, astNodeInput) {
|
|
|
980
987
|
return tokenAfter;
|
|
981
988
|
};
|
|
982
989
|
|
|
983
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
990
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/parseComment.js
|
|
984
991
|
var import_comment_parser = require("comment-parser");
|
|
985
992
|
|
|
986
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
993
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/parseInlineTags.js
|
|
987
994
|
function determineFormat(match) {
|
|
988
995
|
const { separator, text } = match.groups;
|
|
989
996
|
const [, textEnd] = match.indices.groups.text;
|
|
@@ -1057,7 +1064,7 @@ function parseInlineTags(block) {
|
|
|
1057
1064
|
);
|
|
1058
1065
|
}
|
|
1059
1066
|
|
|
1060
|
-
// packages/@cjser/es-joy__jsdoccomment.tmp-
|
|
1067
|
+
// packages/@cjser/es-joy__jsdoccomment.tmp-24-1794505098034/src/parseComment.js
|
|
1061
1068
|
var {
|
|
1062
1069
|
name: nameTokenizer,
|
|
1063
1070
|
tag: tagTokenizer,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cjser/es-joy__jsdoccomment",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0-cjser.2",
|
|
4
4
|
"author": "Brett Zamir <brettz9@yahoo.com>",
|
|
5
5
|
"contributors": [],
|
|
6
6
|
"description": "Maintained replacement for ESLint's deprecated SourceCode#getJSDocComment along with other jsdoc utilities",
|
|
@@ -44,34 +44,34 @@
|
|
|
44
44
|
"node": "^22.22.2 || >=24.15.0"
|
|
45
45
|
},
|
|
46
46
|
"dependencies": {
|
|
47
|
-
"@types/estree": "^1.0.
|
|
48
|
-
"@typescript-eslint/types": "^8.72.
|
|
47
|
+
"@types/estree": "^1.0.10",
|
|
48
|
+
"@typescript-eslint/types": "^8.72.2",
|
|
49
49
|
"comment-parser": "1.4.9",
|
|
50
50
|
"esquery": "^1.7.0",
|
|
51
|
-
"@cjser/jsdoc-type-pratt-parser": "9.
|
|
51
|
+
"@cjser/jsdoc-type-pratt-parser": "9.5.0-cjser.2"
|
|
52
52
|
},
|
|
53
53
|
"devDependencies": {
|
|
54
54
|
"@arethetypeswrong/cli": "^0.18.5",
|
|
55
|
-
"@es-joy/escodegen": "^
|
|
55
|
+
"@es-joy/escodegen": "^5.0.1",
|
|
56
56
|
"@node-static/node-static": "^0.10.0",
|
|
57
57
|
"@types/esquery": "^1.5.4",
|
|
58
58
|
"@types/estraverse": "^5.1.7",
|
|
59
|
-
"@typescript-eslint/visitor-keys": "^8.72.
|
|
59
|
+
"@typescript-eslint/visitor-keys": "^8.72.2",
|
|
60
60
|
"@typhonjs-build-test/esm-d-ts": "0.4.0",
|
|
61
61
|
"@typhonjs-typedoc/typedoc-pkg": "^0.4.2",
|
|
62
|
-
"@vitest/coverage-v8": "^5.0
|
|
63
|
-
"@vitest/ui": "^5.0
|
|
62
|
+
"@vitest/coverage-v8": "^5.1.0",
|
|
63
|
+
"@vitest/ui": "^5.1.0",
|
|
64
64
|
"@webcoder49/code-input": "^2.9.0",
|
|
65
|
-
"eslint": "^10.
|
|
65
|
+
"eslint": "^10.14.0",
|
|
66
66
|
"eslint-config-ash-nazg": "43.2.4",
|
|
67
|
-
"eslint-plugin-jsdoc": "^65.4.
|
|
67
|
+
"eslint-plugin-jsdoc": "^65.4.5",
|
|
68
68
|
"espree": "^11.2.0",
|
|
69
69
|
"estraverse": "^5.3.0",
|
|
70
70
|
"prismjs": "^1.30.0",
|
|
71
71
|
"typedoc": "^0.28.20",
|
|
72
72
|
"typescript": "6.0.3",
|
|
73
|
-
"typescript-eslint": "^8.72.
|
|
74
|
-
"vitest": "^5.0
|
|
73
|
+
"typescript-eslint": "^8.72.2",
|
|
74
|
+
"vitest": "^5.1.0"
|
|
75
75
|
},
|
|
76
76
|
"files": [
|
|
77
77
|
"/dist",
|
|
@@ -98,11 +98,11 @@
|
|
|
98
98
|
},
|
|
99
99
|
"main": "./dist-cjser/index.cjs",
|
|
100
100
|
"cjser": {
|
|
101
|
-
"sourceVersion": "1.
|
|
101
|
+
"sourceVersion": "1.2.0",
|
|
102
102
|
"cjserVersion": 2,
|
|
103
103
|
"original": {
|
|
104
104
|
"name": "@es-joy/jsdoccomment",
|
|
105
|
-
"version": "1.
|
|
105
|
+
"version": "1.2.0",
|
|
106
106
|
"exports": {
|
|
107
107
|
".": {
|
|
108
108
|
"types": "./dist/index.d.ts",
|
|
@@ -114,11 +114,11 @@
|
|
|
114
114
|
"url": "git+https://github.com/es-joy/jsdoccomment.git"
|
|
115
115
|
},
|
|
116
116
|
"dependencies": {
|
|
117
|
-
"@types/estree": "^1.0.
|
|
118
|
-
"@typescript-eslint/types": "^8.72.
|
|
117
|
+
"@types/estree": "^1.0.10",
|
|
118
|
+
"@typescript-eslint/types": "^8.72.2",
|
|
119
119
|
"comment-parser": "1.4.9",
|
|
120
120
|
"esquery": "^1.7.0",
|
|
121
|
-
"jsdoc-type-pratt-parser": "~9.
|
|
121
|
+
"jsdoc-type-pratt-parser": "~9.5.0"
|
|
122
122
|
},
|
|
123
123
|
"files": [
|
|
124
124
|
"/dist",
|
package/src/jsdoccomment.js
CHANGED
|
@@ -683,6 +683,19 @@ const getFollowingComment = function (sourceCode, astNodeInput) {
|
|
|
683
683
|
* AST node to get the comment for.
|
|
684
684
|
*/
|
|
685
685
|
const tokenAfterIgnoringSemis = (node) => {
|
|
686
|
+
// Skip the token search if the rest of the line has no comment start
|
|
687
|
+
// (`//`, `/*` or `<!--`)
|
|
688
|
+
if (node.loc) {
|
|
689
|
+
const {end} = node.loc;
|
|
690
|
+
const line = sourceCode.lines[end.line - 1];
|
|
691
|
+
if (
|
|
692
|
+
!line.includes('/', end.column) &&
|
|
693
|
+
!line.includes('<', end.column)
|
|
694
|
+
) {
|
|
695
|
+
return null;
|
|
696
|
+
}
|
|
697
|
+
}
|
|
698
|
+
|
|
686
699
|
const tokenAfter = getTokensAfterIgnoringSemis(node);
|
|
687
700
|
return (
|
|
688
701
|
tokenAfter &&
|