mirror of
https://github.com/react/react-native-devtools-frontend.git
synced 2026-09-30 17:27:22 +08:00
This CL adds the eslint-plugin-jsdoc plugin and enables just one rule, `jsdoc/check-alignment`, which ensures that all the lines in a comment are correctly aligned. For example: ``` /** * foo * bar */ ``` Would fail the check and be corrected to: ``` /** * foo * bar */ ``` DISABLE_THIRD_PARTY_CHECK=deliberate install + use of eslint-plugin-jsdoc node_module Bug: none Change-Id: I969983cd550653654a334ede3409b8c850467245 Reviewed-on: https://chromium-review.googlesource.com/c/devtools/devtools-frontend/+/4110906 Commit-Queue: Andres Olivares <andoli@chromium.org> Reviewed-by: Andres Olivares <andoli@chromium.org> Auto-Submit: Jack Franklin <jacktfranklin@chromium.org> Commit-Queue: Jack Franklin <jacktfranklin@chromium.org>
47 lines
1.7 KiB
JavaScript
47 lines
1.7 KiB
JavaScript
import { Markers } from '../primitives.js';
|
|
import { seedTokens, splitSpace, splitCR } from '../util.js';
|
|
export default function getParser({ startLine = 0, markers = Markers, } = {}) {
|
|
let block = null;
|
|
let num = startLine;
|
|
return function parseSource(source) {
|
|
let rest = source;
|
|
const tokens = seedTokens();
|
|
[tokens.lineEnd, rest] = splitCR(rest);
|
|
[tokens.start, rest] = splitSpace(rest);
|
|
if (block === null &&
|
|
rest.startsWith(markers.start) &&
|
|
!rest.startsWith(markers.nostart)) {
|
|
block = [];
|
|
tokens.delimiter = rest.slice(0, markers.start.length);
|
|
rest = rest.slice(markers.start.length);
|
|
[tokens.postDelimiter, rest] = splitSpace(rest);
|
|
}
|
|
if (block === null) {
|
|
num++;
|
|
return null;
|
|
}
|
|
const isClosed = rest.trimRight().endsWith(markers.end);
|
|
if (tokens.delimiter === '' &&
|
|
rest.startsWith(markers.delim) &&
|
|
!rest.startsWith(markers.end)) {
|
|
tokens.delimiter = markers.delim;
|
|
rest = rest.slice(markers.delim.length);
|
|
[tokens.postDelimiter, rest] = splitSpace(rest);
|
|
}
|
|
if (isClosed) {
|
|
const trimmed = rest.trimRight();
|
|
tokens.end = rest.slice(trimmed.length - markers.end.length);
|
|
rest = trimmed.slice(0, -markers.end.length);
|
|
}
|
|
tokens.description = rest;
|
|
block.push({ number: num, source, tokens });
|
|
num++;
|
|
if (isClosed) {
|
|
const result = block.slice();
|
|
block = null;
|
|
return result;
|
|
}
|
|
return null;
|
|
};
|
|
}
|