@sasjs/lint 5.3.0 → 5.4.0

package/format/reflowComments.js

@@ -0,0 +1,305 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reflowComments = void 0;
+const LineEndings_1 = require("../types/LineEndings");
+const getDataSectionsDetail_1 = require("../utils/getDataSectionsDetail");
+const getHeaderLinesCount_1 = require("../utils/getHeaderLinesCount");
+const scanLine_1 = require("../utils/scanLine");
+const longLines_1 = require("./longLines");
+const rewrapText_1 = require("./rewrapText");
+/**
+ * What begins a new paragraph: any Doxygen tag - so `@param y` never joins the
+ * `@param x` above it - an HTML heading, a list marker, a table row and a macro
+ * trigger.
+ *
+ * A run of spaces is not in this list: two spaces after a full stop is ordinary
+ * prose, and treating it as structure would leave every sentence-spaced
+ * paragraph wrapped one line at a time. A reflow therefore normalises the runs
+ * inside the paragraph it rewrites.
+ */
+const startsParagraph = /^(?:@|<|[-*+]\s|\d+[.)]\s|\||#|%|`)/i;
+/**
+ * What is not prose at all, and so is never reflowed even when it is a
+ * paragraph of its own: an `@li` entry - whose continuation line would end the
+ * list the header readers parse - a `@sasjslint` object, a heading, a list
+ * item, a table row, and a macro trigger.
+ */
+const lineOriented = /^(?:@li\b|@sasjslint\b|<|[-*+]\s|\d+[.)]\s|\||#|%|`)/i;
+/** A tag whose body is code rather than prose. */
+const codeTag = /@(?:example|code|verbatim)\b/i;
+/** The heading whose `@li` entries other rules read and rewrite. */
+const macrosHeading = /<h4>\s*SAS Macros\s*<\/h4>/i;
+/** The width of a line's leading whitespace. */
+const indentOf = (text) => /^\s*/.exec(text)[0].length;
+/**
+ * Wraps one paragraph's words into lines that fit, or returns `null` when a
+ * word is longer than the room its line has - there is no break inside a word,
+ * so the paragraph is left as the author wrote it.
+ */
+const wrapWords = (content, limit, lead, continuationIndent, trail) => {
+    const words = content.split(/\s+/).filter(Boolean);
+    const lines = [];
+    let line = lead;
+    let empty = true;
+    for (const word of words) {
+        const candidate = empty ? lead + word : line + ' ' + word;
+        if (empty || candidate.length <= limit) {
+            line = candidate;
+            empty = false;
+            continue;
+        }
+        lines.push(line);
+        line = continuationIndent + word;
+    }
+    lines.push(line);
+    // The closing marker rides on the last line, so that line has `trail.length`
+    // fewer characters to spend: pull words down until the marker fits, and give
+    // up when the last line is a single word that cannot move.
+    while (lines[lines.length - 1].length + trail.length > limit) {
+        const last = lines[lines.length - 1];
+        const cut = last.lastIndexOf(' ');
+        if (cut < 1 || !last.slice(0, cut).trim())
+            return null;
+        lines[lines.length - 1] = last.slice(0, cut);
+        lines.push(continuationIndent + last.slice(cut + 1));
+    }
+    lines[lines.length - 1] += trail;
+    return lines.every((wrapped) => wrapped.length <= limit) ? lines : null;
+};
+/**
+ * Collects the block comments of a file that occupy whole lines, so that a
+ * comment sharing a line with code - which a reflow would have to move the code
+ * around - is left alone.
+ *
+ * A block opens on a line with nothing but whitespace before its marker, closes
+ * on a line with nothing but whitespace after the closing marker, and covers no
+ * line that carries code. Text inside a `datalines` record is data rather than
+ * SAS, so a marker there is data and never opens a block.
+ *
+ * @param {string[]} lines - the file's lines.
+ * @param {LintConfig} configuration - the configuration in force.
+ * @returns {Block[]} the blocks a reflow may edit.
+ */
+const collectBlocks = (lines, configuration) => {
+    const blocks = [];
+    const dataSections = (0, getDataSectionsDetail_1.getDataSectionsDetail)(lines.join('\n'), configuration);
+    let state = (0, scanLine_1.cleanState)();
+    let index = 0;
+    while (index < lines.length) {
+        // A data record is data, so it is not scanned and it closes whatever the
+        // line before it left open: a comment marker inside a record would
+        // otherwise hide every comment block below it.
+        if ((0, getDataSectionsDetail_1.checkIsDataLine)(dataSections, index)) {
+            state = (0, scanLine_1.cleanState)();
+            index++;
+            continue;
+        }
+        const scanned = (0, scanLine_1.scanLine)(lines[index], state);
+        state = scanned.endState;
+        const span = scanned.comments[0];
+        const opensHere = !!span &&
+            scanned.comments.length === 1 &&
+            lines[index].slice(0, span.start).trim() === '';
+        if (!opensHere) {
+            index++;
+            continue;
+        }
+        if (span.end < lines[index].length) {
+            if (lines[index].slice(span.end + 2).trim() === '') {
+                blocks.push({ open: index, close: index });
+            }
+            index++;
+            continue;
+        }
+        // The comment continues: walk forward to the line carrying its closer. A
+        // block that runs to the end of the file has no closer to re-emit, and one
+        // that covers a line of code cannot be edited without moving that code, so
+        // both are left to their author.
+        let close = index;
+        let closed = false;
+        let usable = true;
+        while (usable && !closed && close < lines.length - 1) {
+            close++;
+            if ((0, getDataSectionsDetail_1.checkIsDataLine)(dataSections, close)) {
+                usable = false;
+                break;
+            }
+            const next = (0, scanLine_1.scanLine)(lines[close], state);
+            state = next.endState;
+            if (next.code.trim() !== '') {
+                usable = false;
+                break;
+            }
+            const closing = next.comments[0];
+            if (closing && closing.end < lines[close].length) {
+                closed = true;
+                usable = lines[close].slice(closing.end + 2).trim() === '';
+            }
+        }
+        if (usable && closed)
+            blocks.push({ open: index, close });
+        index = close + 1;
+    }
+    return blocks;
+};
+/**
+ * Splits a block into its lines, and works out the indentation its continuation
+ * lines use - which is where a reflow puts the text it does not fit on the
+ * first line.
+ *
+ * The opener is a special case in both directions: it carries the marker, so
+ * its text starts after `/* `, and a comment written as `/* text` on one line
+ * with its body indented below it is one paragraph, not two.
+ */
+const readBlock = (lines, block, multiple) => {
+    const openLine = lines[block.open];
+    const marker = openLine.indexOf('/*');
+    // `/**` is one marker, so the second asterisk belongs to the lead.
+    const afterMarker = marker + 2 + (openLine[marker + 2] === '*' ? 1 : 0);
+    const openRest = openLine.slice(afterMarker);
+    const openLead = afterMarker + indentOf(openRest);
+    const closer = block.open === block.close ? openLine.indexOf('*/') : -1;
+    const openBody = openLine.slice(openLead, closer > -1 ? closer : undefined);
+    const openContent = openBody.trimEnd();
+    const read = [
+        {
+            raw: openLine,
+            lead: openLine.slice(0, openLead),
+            content: openContent,
+            trail: openBody.slice(openContent.length) +
+                (closer > -1 ? openLine.slice(closer) : ''),
+            indent: indentOf(openLine)
+        }
+    ];
+    for (let index = block.open + 1; index <= block.close; index++) {
+        const line = lines[index];
+        const lead = /^\s*/.exec(line)[0];
+        const close = index === block.close ? line.indexOf('*/') : -1;
+        const body = line.slice(lead.length, close > -1 ? close : undefined);
+        const content = body.trimEnd();
+        read.push({
+            raw: line,
+            lead,
+            content,
+            trail: body.slice(content.length) + (close > -1 ? line.slice(close) : ''),
+            indent: lead.length
+        });
+    }
+    // The opener shares its paragraph with the line below it, when that line
+    // carries text: that is the indentation its continuation takes. When the line
+    // below is blank the opener stands alone, and its continuation is one
+    // `indentationMultiple` in from the marker.
+    const below = read[1];
+    const contentIndent = below !== undefined && below.content !== ''
+        ? below.indent
+        : indentOf(openLine) + (multiple - (indentOf(openLine) % multiple));
+    return { read, contentIndent };
+};
+/**
+ * Reflows the prose inside a file's block comments so that no line exceeds the
+ * limit that applies to it, and leaves every other line byte-identical.
+ *
+ * A paragraph is a run of comment lines at one indentation that carry prose. It
+ * breaks at a blank line and before anything line-oriented: an `@li` entry, a
+ * `@sasjslint` tag, an HTML heading, a list marker, a table row or a macro
+ * trigger. Wrapping one of those - or wrapping one line of a paragraph without
+ * reflowing the rest - is what leaves a header ragged. A `@brief` or `@param`
+ * line is prose, so it carries the lines that follow it.
+ *
+ * Blocks that are left entirely alone: one sharing a line with code, one inside
+ * a `datalines` record, one holding a `@example` / `@code` / `@verbatim` body,
+ * the `<h4> SAS Macros </h4>` section - whose entries other rules read and
+ * rewrite - and any block holding a `@sasjslint` tag, whose object has to stay
+ * on the line the tag opens.
+ *
+ * A paragraph is reflowed only when every line of the result fits, so the pass
+ * never raises the diagnostic count: a word longer than the limit - a URL,
+ * usually - leaves its paragraph as the author wrote it.
+ *
+ * @param {string} text - the text to reflow.
+ * @param {LintConfig} configuration - the configuration in force, header
+ *   override included.
+ * @returns {string} the reflowed text.
+ */
+const reflowComments = (text, configuration) => {
+    if (!text)
+        return text;
+    if (!configuration.lineLintRules.some((rule) => rule.name === 'maxLineLength'))
+        return text;
+    const entries = (0, rewrapText_1.splitWithTerminators)(text);
+    const lines = entries.map((entry) => entry.line);
+    const headerLinesCount = (0, getHeaderLinesCount_1.getHeaderLinesCount)(text, configuration);
+    const multiple = (0, longLines_1.indentationMultipleOf)(configuration);
+    const headerLimit = Math.max(configuration.maxLineLength, configuration.maxHeaderLineLength);
+    const defaultEnding = configuration.lineEndings === LineEndings_1.LineEndings.CRLF ? '\r\n' : '\n';
+    const output = [];
+    let cursor = 0;
+    const emitTo = (index) => {
+        while (cursor < index && cursor < lines.length) {
+            output.push(lines[cursor] + entries[cursor].ending);
+            cursor++;
+        }
+    };
+    for (const block of collectBlocks(lines, configuration)) {
+        const { read, contentIndent } = readBlock(lines, block, multiple);
+        const limit = block.open < headerLinesCount ? headerLimit : configuration.maxLineLength;
+        const blockText = read.map((line) => line.raw).join('\n');
+        const refused = macrosHeading.test(blockText) ||
+            codeTag.test(blockText) ||
+            read.some((line) => /@sasjslint\b/.test(line.content));
+        if (refused)
+            continue;
+        emitTo(block.open);
+        const emitted = [];
+        let paragraph = [];
+        let paragraphIndent = -1;
+        const flush = () => {
+            if (!paragraph.length)
+                return;
+            const last = paragraph[paragraph.length - 1];
+            const overlong = !lineOriented.test(paragraph[0].content) &&
+                paragraph.some((line) => line.lead.length + line.content.length + line.trail.length > limit);
+            const content = paragraph.map((line) => line.content).join(' ');
+            const wrapped = overlong
+                ? wrapWords(content, limit, paragraph[0].lead, ' '.repeat(paragraphIndent), last.trail)
+                : null;
+            if (wrapped)
+                emitted.push(...wrapped);
+            else
+                emitted.push(...paragraph.map((line) => line.raw));
+            paragraph = [];
+            paragraphIndent = -1;
+        };
+        read.forEach((line, index) => {
+            if (line.content === '') {
+                flush();
+                emitted.push(line.raw);
+                return;
+            }
+            if (paragraph.length) {
+                const continues = index > 0 &&
+                    line.indent === paragraphIndent &&
+                    !startsParagraph.test(line.content);
+                if (!continues)
+                    flush();
+            }
+            if (!paragraph.length)
+                paragraphIndent = index === 0 ? contentIndent : line.indent;
+            paragraph.push(line);
+        });
+        flush();
+        // Lines inserted inside the block take the block's own final terminator, so
+        // a CRLF file keeps CRLF even with `lineEndings` off.
+        const blockEnding = entries[block.close].ending || defaultEnding;
+        emitted.forEach((line, index) => {
+            const ending = index === emitted.length - 1 ? entries[block.close].ending : blockEnding;
+            output.push(line + ending);
+        });
+        cursor = block.close + 1;
+    }
+    emitTo(lines.length);
+    const result = output.join('');
+    return result === text ? text : result;
+};
+exports.reflowComments = reflowComments;
+//# sourceMappingURL=reflowComments.js.map

package/format/reflowComments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflowComments.js","sourceRoot":"","sources":["../../src/format/reflowComments.ts"],"names":[],"mappings":"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"}

package/format/rewrapText.d.ts

@@ -0,0 +1,38 @@
+import { LintConfig } from '../types';
+/**
+ * The lines of the text, each paired with the terminator that follows it.
+ *
+ * The terminator is kept rather than assumed, so a line a pass does not touch
+ * keeps its own bytes - including in a file whose endings are mixed, and in a
+ * file that has no final terminator at all.
+ */
+export declare const splitWithTerminators: (text: string) => {
+    line: string;
+    ending: string;
+}[];
+/**
+ * Wraps the lines of a file that exceed `maxLineLength`, and leaves every other
+ * line byte-identical.
+ *
+ * Lines that are left alone, because a break would change what SAS reads or
+ * what another rule has to parse:
+ *
+ * - `datalines` / `cards` / `parmcards` records, and the statement that opens
+ *   them, where a newline ends the record;
+ * - `%macro` and `%mend` declarations, which the macro rules read as one
+ *   statement;
+ * - a `%*` comment statement, which is prose;
+ * - a `put` / `putlog` / `%put` / `%window` / `%display` statement and every
+ *   line of it, where a newline is a line of output rather than a delimiter;
+ * - any line that carries a block comment, which `reflowComments` owns.
+ *
+ * A line is wrapped only when every line it becomes fits the limit, so the pass
+ * never turns one diagnostic into two.
+ *
+ * @param {string} text - the text to rewrap.
+ * @param {LintConfig} configuration - the configuration in force, header
+ *   override included.
+ * @returns {string} the rewrapped text, with every untouched line's own
+ *   terminator preserved.
+ */
+export declare const rewrapText: (text: string, configuration: LintConfig) => string;