@sasjs/lint 5.3.1 → 5.4.0

package/format/rewrapText.js

@@ -0,0 +1,389 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rewrapText = exports.splitWithTerminators = void 0;
+const LineEndings_1 = require("../types/LineEndings");
+const getDataSectionsDetail_1 = require("../utils/getDataSectionsDetail");
+const scanLine_1 = require("../utils/scanLine");
+const longLines_1 = require("./longLines");
+/**
+ * A macro keyword that reads the token after it, so a break that leaves one at
+ * the end of a line is legal but reads badly.
+ *
+ * The delimiter before the keyword is required: without it the pattern also
+ * matches any word ENDING in those letters - `todo`, `redo`, `pseudo` - and the
+ * pass walks back to an earlier space for a reason that does not exist, leaving
+ * lines shorter than the limit allows. The `%` sigil counts as a delimiter in its
+ * own right, so the unspaced form `%do i=1%to` is still recognised.
+ */
+const leadingKeyword = /(?:^|[\s(;,=]|%)%?(?:let|global|local|then|else|do|to|by)$/i;
+/**
+ * The index of the last safe break point at or before `maximum`, searching only
+ * the range from `firstIndex`, so a caller looking for a break after the one it
+ * already took is not handed the one behind it.
+ */
+const lastPositionAtMost = (positions, maximum, lastIndex, firstIndex = 0) => {
+    let low = firstIndex;
+    let high = lastIndex;
+    let found = -1;
+    while (low <= high) {
+        const middle = (low + high) >> 1;
+        if (positions[middle] <= maximum) {
+            found = middle;
+            low = middle + 1;
+        }
+        else {
+            high = middle - 1;
+        }
+    }
+    return found;
+};
+/**
+ * Breaks one line into lines no longer than `limit`, or returns `null` when no
+ * break produces a line that fits.
+ *
+ * The break is greedy: the last safe space that fits, walking back towards the
+ * indentation until one is found, so a wrap never turns one diagnostic into
+ * two. A continuation is indented one `indentationMultiple` past the line it
+ * came from, which keeps a file that satisfies `indentationMultiple` doing so.
+ */
+const lastBreakBefore = (line, positions, maximum, start) => {
+    const last = lastPositionAtMost(positions, maximum, positions.length - 1);
+    let fallback = -1;
+    for (let index = last; index >= 0; index--) {
+        const position = positions[index];
+        if (position <= start)
+            break;
+        if (!leadingKeyword.test(line.slice(0, position).trimEnd()))
+            return position;
+        if (fallback < 0)
+            fallback = position;
+    }
+    return fallback;
+};
+/**
+ * The break points that sit at a statement boundary - the space immediately
+ * after a `;` in the code view.
+ *
+ * A newline there is always inert: the statement has ended, so no `%trim(` is
+ * needed, no macro variable value can gain whitespace and no `put` can gain an
+ * output line. They are therefore preferred over a break inside a statement,
+ * which is why `%let a=1; %let b=2;` breaks between the two statements rather
+ * than in the middle of the second one.
+ *
+ * @param {string} code - the line with literals and comments blanked, so the
+ *   `;` inside a quoted value is not a boundary.
+ * @param {number[]} positions - the line's safe break points.
+ * @returns {number[]} the break points that follow a terminator.
+ */
+const statementBoundaries = (code, positions) => positions.filter((position) => code.slice(0, position).trimEnd().endsWith(';'));
+/** The index of the first safe break point at or after `minimum`. */
+const firstPositionAtLeast = (positions, minimum) => {
+    let low = 0;
+    let high = positions.length - 1;
+    let found = -1;
+    while (low <= high) {
+        const middle = (low + high) >> 1;
+        if (positions[middle] >= minimum) {
+            found = middle;
+            high = middle - 1;
+        }
+        else {
+            low = middle + 1;
+        }
+    }
+    return found;
+};
+/**
+ * Breaks a macro declaration before its parameter commas, or returns `null`
+ * when it cannot.
+ *
+ * The declaration is the one statement the macro rules read as a whole, so the
+ * break is placed only at a comma that separates two parameters - never inside
+ * one - and a continuation line starts with the comma, which is how the library
+ * already writes a call that does not fit. `%mend` has no parameters and is
+ * left alone.
+ *
+ * @param {string} line - the declaration.
+ * @param {string} code - the same line with literals blanked, so a comma inside
+ *   a quoted default is not mistaken for a separator.
+ * @param {number} limit - the maximum line length.
+ * @param {number} multiple - the indentation multiple.
+ * @returns {string[] | null} the lines, or `null` when no split fits.
+ */
+const splitMacroDeclaration = (line, code, limit, multiple) => {
+    const opening = /^\s*%macro\s+[\w.]+\s*\(/i.exec(code);
+    if (!opening)
+        return null;
+    const open = opening[0].length - 1;
+    let depth = 0;
+    let close = -1;
+    for (let index = open; index < code.length; index++) {
+        if (code[index] === '(')
+            depth++;
+        else if (code[index] === ')' && --depth === 0) {
+            close = index;
+            break;
+        }
+    }
+    if (close < 0)
+        return null;
+    const inside = code.slice(open + 1, close);
+    const commas = [];
+    depth = 0;
+    for (let index = 0; index < inside.length; index++) {
+        if (inside[index] === '(')
+            depth++;
+        else if (inside[index] === ')')
+            depth--;
+        else if (inside[index] === ',' && depth === 0)
+            commas.push(index + open + 1);
+    }
+    if (!commas.length)
+        return null;
+    const indent = /^\s*/.exec(line)[0];
+    const continuationIndent = (0, longLines_1.continuationIndentFor)(indent, multiple);
+    const parameters = [];
+    let from = open + 1;
+    commas.forEach((comma) => {
+        parameters.push(line.slice(from, comma));
+        from = comma + 1;
+    });
+    parameters.push(line.slice(from, close));
+    const tail = line.slice(close);
+    const pieces = [];
+    let current = line.slice(0, open + 1) + parameters[0];
+    for (const parameter of parameters.slice(1)) {
+        const candidate = current + ',' + parameter;
+        if (candidate.length <= limit)
+            current = candidate;
+        else {
+            pieces.push(current);
+            current = continuationIndent + ',' + parameter;
+        }
+        if (current.length > limit)
+            return null;
+    }
+    if (current.length + tail.length <= limit) {
+        pieces.push(current + tail);
+    }
+    else {
+        pieces.push(current);
+        pieces.push(continuationIndent + tail);
+    }
+    return pieces.length > 1 && pieces.every((piece) => piece.length <= limit)
+        ? pieces
+        : null;
+};
+/**
+ * Breaks a `put`-family statement by ending the line with `%trim(` and opening
+ * the continuation with `)`, or returns `null` when it cannot.
+ *
+ * The newline and the continuation's indentation become the argument of
+ * `%trim`, which resolves to nothing, so the statement SAS reads is the same
+ * text it read before the break - `%put NOTE- the text %trim(` and
+ * `)continues;` write one line, not two. The space before `%trim(` is the
+ * separator the two halves need, so the space is kept rather than lost.
+ *
+ * @param {string} line - the line to break.
+ * @param {number} limit - the maximum line length.
+ * @param {number} multiple - the indentation multiple.
+ * @param {number[]} positions - the indexes of the line's safe spaces.
+ * @param {number} from - the index where the statement's text begins.
+ * @returns {string[] | null} the lines, or `null` when no break fits.
+ */
+const splitWithTrim = (line, limit, multiple, positions, from, boundaries) => {
+    const indent = /^\s*/.exec(line)[0];
+    const continuationIndent = (0, longLines_1.continuationIndentFor)(indent, multiple);
+    const opening = '%trim(';
+    const pieces = [];
+    let prefix = '';
+    let start = (0, longLines_1.firstNonSpace)(line, 0);
+    let textFrom = from;
+    for (;;) {
+        const tail = line.slice(start);
+        if (prefix.length + tail.length <= limit) {
+            pieces.push((pieces.length ? prefix : '') + tail);
+            return pieces.length > 1 ? pieces : null;
+        }
+        // A statement boundary is the cheapest break there is: the text above ends
+        // with its `;`, so nothing has to be swallowed and the piece carries no
+        // `%trim(` machinery. Take it when it fits, and fall back to a break inside
+        // the statement only when none does.
+        // The first piece is emitted from column 0, so it is measured from there;
+        // a later one carries the prefix and starts at `start`. Measuring the first
+        // piece from `start` accepts one up to `limit + indent.length` characters
+        // and leaves a line that still raises `maxLineLength`.
+        const boundaryFrom = pieces.length ? start : 0;
+        const boundary = boundaries.filter((position) => position > start && prefix.length + position - boundaryFrom <= limit);
+        if (boundary.length) {
+            const at = boundary[boundary.length - 1];
+            pieces.push(pieces.length ? prefix + line.slice(start, at) : line.slice(0, at));
+            start = at + 1;
+            textFrom = start;
+            prefix = continuationIndent;
+            continue;
+        }
+        // The piece carries the prefix, the text up to the space it breaks at,
+        // and the `%trim(` that swallows the break. The space itself is carried by
+        // the `) ` that opens the next piece. The first piece is measured from the
+        // start of the line, because it keeps the line's own indentation.
+        const pieceFrom = pieces.length ? start : 0;
+        const maximum = pieceFrom + limit - prefix.length - opening.length;
+        // Only a break after the text already placed can be taken: the search starts
+        // at the first position at or after `textFrom`, which is where this piece
+        // begins.
+        const firstIndex = firstPositionAtLeast(positions, textFrom);
+        // No break point is left after the text already placed, so the whole line
+        // stays as it is rather than being broken somewhere behind itself.
+        if (firstIndex < 0)
+            return null;
+        const cut = lastPositionAtMost(positions, maximum, positions.length - 1, firstIndex);
+        const at = cut >= 0 ? positions[cut] : -1;
+        if (at < 0)
+            return null;
+        // The first piece keeps the line's own indentation and keyword; every
+        // later one starts with the `)` that closes the `%trim(` above it, and the
+        // blank the break replaced follows it. A blank left at the end of the
+        // upper line would be discarded, because SAS drops one that sits
+        // immediately before a macro call - and a trailing blank is what
+        // `noTrailingSpaces` reports anyway.
+        pieces.push((pieces.length ? prefix + line.slice(start, at) : line.slice(0, at)) +
+            opening);
+        start = at + 1;
+        textFrom = start;
+        prefix = continuationIndent + ') ';
+    }
+};
+const wrapLine = (line, limit, multiple, positions, boundaries) => {
+    const indent = /^\s*/.exec(line)[0];
+    const continuationIndent = (0, longLines_1.continuationIndentFor)(indent, multiple);
+    const continuationWidth = continuationIndent.length;
+    const lines = [];
+    let start = (0, longLines_1.firstNonSpace)(line, 0);
+    let first = true;
+    while (line.length - start + (first ? start : continuationWidth) > limit) {
+        // A continuation line carries its indentation, so it has that much less
+        // room than the line it replaces.
+        const maximum = first ? limit : start + limit - continuationWidth;
+        // A statement boundary first: it ends a whole statement, so the line reads
+        // as SAS rather than as a slice of one.
+        const boundary = lastBreakBefore(line, boundaries, maximum, start);
+        const cut = boundary >= 0
+            ? boundary
+            : lastBreakBefore(line, positions, maximum, start);
+        // No break point fits: the tail stays on one line and the caller leaves the
+        // whole line as it is.
+        if (cut < 0)
+            return null;
+        lines.push(first
+            ? line.slice(0, cut).trimEnd()
+            : continuationIndent + line.slice(start, cut).trimEnd());
+        start = (0, longLines_1.firstNonSpace)(line, cut);
+        first = false;
+    }
+    lines.push(first ? line : continuationIndent + line.slice(start));
+    return lines;
+};
+/**
+ * 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.
+ */
+const splitWithTerminators = (text) => {
+    var _a;
+    const parts = text.split(/(\r\n|\n)/);
+    const lines = [];
+    for (let index = 0; index < parts.length; index += 2) {
+        lines.push({ line: parts[index], ending: (_a = parts[index + 1]) !== null && _a !== void 0 ? _a : '' });
+    }
+    return lines;
+};
+exports.splitWithTerminators = splitWithTerminators;
+/**
+ * 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.
+ */
+const rewrapText = (text, configuration) => {
+    if (!text)
+        return text;
+    // The limit is off when the rule is absent from the config, not when
+    // `maxLineLength` reads 0: a switched-off limit leaves the property at its
+    // documented default of 80.
+    if (!configuration.lineLintRules.some((rule) => rule.name === 'maxLineLength'))
+        return text;
+    const entries = (0, exports.splitWithTerminators)(text);
+    const dataSections = (0, getDataSectionsDetail_1.getDataSectionsDetail)(text, configuration);
+    const multiple = (0, longLines_1.indentationMultipleOf)(configuration);
+    // The terminator for a break inserted into a line that has none of its own
+    // (the final line of a file with no final newline).
+    const defaultEnding = configuration.lineEndings === LineEndings_1.LineEndings.CRLF ? '\r\n' : '\n';
+    const result = [];
+    let state = (0, scanLine_1.cleanState)();
+    // Whether the previous line opened a `put`-family statement that has not
+    // reached its terminator yet, which makes this line a continuation of it.
+    let breakAwareOpen = false;
+    let changed = false;
+    entries.forEach(({ line, ending }, index) => {
+        // A data record is data, so it is not scanned: a comment marker or an
+        // apostrophe in one would otherwise stay open for the rest of the file.
+        const isData = (0, getDataSectionsDetail_1.checkIsDataLine)(dataSections, index);
+        const scanned = isData ? (0, scanLine_1.noScan)() : (0, scanLine_1.scanLine)(line, state);
+        state = scanned.endState;
+        const breakAware = isData
+            ? { line: false, open: false }
+            : (0, longLines_1.breakAwareState)(scanned.code, breakAwareOpen);
+        breakAwareOpen = breakAware.open;
+        // Break points that sit at a statement boundary, which the wrap and the
+        // `%trim(` break both prefer.
+        const boundaries = statementBoundaries(scanned.code, scanned.positions);
+        // Trailing spaces are another rule's finding: a line whose content fits is
+        // left for that fix rather than wrapped into a blank continuation.
+        const fits = line.trimEnd().length <= configuration.maxLineLength;
+        const wrapped = isData || longLines_1.macroComment.test(line) || fits
+            ? null
+            : longLines_1.macroDeclaration.test(line)
+                ? splitMacroDeclaration(line, scanned.code, configuration.maxLineLength, multiple)
+                : breakAware.line && !scanned.hasComment
+                    ? splitWithTrim(line, configuration.maxLineLength, multiple, scanned.positions, (0, longLines_1.putTextStart)(line), boundaries)
+                    : scanned.hasComment
+                        ? null
+                        : wrapLine(line, configuration.maxLineLength, multiple, scanned.positions, boundaries);
+        if (!wrapped) {
+            result.push(line + ending);
+            return;
+        }
+        changed = true;
+        // The break inside the line takes that line's own terminator, and a
+        // break in the final line takes the configured one.
+        const breakEnding = ending || defaultEnding;
+        wrapped.forEach((piece, pieceIndex) => {
+            result.push(piece + (pieceIndex === wrapped.length - 1 ? ending : breakEnding));
+        });
+    });
+    return changed ? result.join('') : text;
+};
+exports.rewrapText = rewrapText;
+//# sourceMappingURL=rewrapText.js.map

package/format/rewrapText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrapText.js","sourceRoot":"","sources":["../../src/format/rewrapText.ts"],"names":[],"mappings":";;;AACA,sDAAkD;AAClD,0EAGuC;AACvC,gDAAgE;AAChE,2CAQoB;AAEpB;;;;;;;;;GASG;AACH,MAAM,cAAc,GAClB,6DAA6D,CAAA;AAE/D;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CACzB,SAAmB,EACnB,OAAe,EACf,SAAiB,EACjB,UAAU,GAAG,CAAC,EACN,EAAE;IACV,IAAI,GAAG,GAAG,UAAU,CAAA;IACpB,IAAI,IAAI,GAAG,SAAS,CAAA;IACpB,IAAI,KAAK,GAAG,CAAC,CAAC,CAAA;IAEd,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,KAAK,GAAG,MAAM,CAAA;YACd,GAAG,GAAG,MAAM,GAAG,CAAC,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,GAAG,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,eAAe,GAAG,CACtB,IAAY,EACZ,SAAmB,EACnB,OAAe,EACf,KAAa,EACL,EAAE;IACV,MAAM,IAAI,GAAG,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACzE,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAA;IAEjB,KAAK,IAAI,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAEjC,IAAI,QAAQ,IAAI,KAAK;YAAE,MAAK;QAC5B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,QAAQ,CAAA;QAC5E,IAAI,QAAQ,GAAG,CAAC;YAAE,QAAQ,GAAG,QAAQ,CAAA;IACvC,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAE,SAAmB,EAAY,EAAE,CAC1E,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC5B,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAChD,CAAA;AAEH,qEAAqE;AACrE,MAAM,oBAAoB,GAAG,CAAC,SAAmB,EAAE,OAAe,EAAU,EAAE;IAC5E,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAA;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAC,CAAA;IAEd,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,KAAK,GAAG,MAAM,CAAA;YACd,IAAI,GAAG,MAAM,GAAG,CAAC,CAAA;QACnB,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,MAAM,GAAG,CAAC,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,qBAAqB,GAAG,CAC5B,IAAY,EACZ,IAAY,EACZ,KAAa,EACb,QAAgB,EACC,EAAE;IACnB,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEtD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAEzB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,KAAK,GAAG,CAAC,CAAC,CAAA;IAEd,KAAK,IAAI,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG;YAAE,KAAK,EAAE,CAAA;aAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;YAC9C,KAAK,GAAG,KAAK,CAAA;YACb,MAAK;QACP,CAAC;IACH,CAAC;IAED,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,KAAK,GAAG,CAAC,CAAA;IACT,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG;YAAE,KAAK,EAAE,CAAA;aAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG;YAAE,KAAK,EAAE,CAAA;aAClC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAA;IAC9E,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAE/B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAA;IACpC,MAAM,kBAAkB,GAAG,IAAA,iCAAqB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAClE,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC,CAAA;IAEnB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;QACxC,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA;IAClB,CAAC,CAAC,CAAA;IACF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAExC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IAErD,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,OAAO,GAAG,GAAG,GAAG,SAAS,CAAA;QAE3C,IAAI,SAAS,CAAC,MAAM,IAAI,KAAK;YAAE,OAAO,GAAG,SAAS,CAAA;aAC7C,CAAC;YACJ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACpB,OAAO,GAAG,kBAAkB,GAAG,GAAG,GAAG,SAAS,CAAA;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK;YAAE,OAAO,IAAI,CAAA;IACzC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACpB,MAAM,CAAC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAA;IACxC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC;QACxE,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,IAAI,CAAA;AACV,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,aAAa,GAAG,CACpB,IAAY,EACZ,KAAa,EACb,QAAgB,EAChB,SAAmB,EACnB,IAAY,EACZ,UAAoB,EACH,EAAE;IACnB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAA;IACpC,MAAM,kBAAkB,GAAG,IAAA,iCAAqB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAA;IACxB,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,KAAK,GAAG,IAAA,yBAAa,EAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAClC,IAAI,QAAQ,GAAG,IAAI,CAAA;IAEnB,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAE9B,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YAEjD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;QAC1C,CAAC;QAED,2EAA2E;QAC3E,wEAAwE;QACxE,4EAA4E;QAC5E,qCAAqC;QACrC,0EAA0E;QAC1E,4EAA4E;QAC5E,0EAA0E;QAC1E,uDAAuD;QACvD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAChC,CAAC,QAAQ,EAAE,EAAE,CACX,QAAQ,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,GAAG,QAAQ,GAAG,YAAY,IAAI,KAAK,CACvE,CAAA;QAED,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YAExC,MAAM,CAAC,IAAI,CACT,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CACnE,CAAA;YACD,KAAK,GAAG,EAAE,GAAG,CAAC,CAAA;YACd,QAAQ,GAAG,KAAK,CAAA;YAChB,MAAM,GAAG,kBAAkB,CAAA;YAE3B,SAAQ;QACV,CAAC;QAED,uEAAuE;QACvE,2EAA2E;QAC3E,2EAA2E;QAC3E,kEAAkE;QAClE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3C,MAAM,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAClE,6EAA6E;QAC7E,0EAA0E;QAC1E,UAAU;QACV,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAE5D,0EAA0E;QAC1E,mEAAmE;QACnE,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAE/B,MAAM,GAAG,GAAG,kBAAkB,CAC5B,SAAS,EACT,OAAO,EACP,SAAS,CAAC,MAAM,GAAG,CAAC,EACpB,UAAU,CACX,CAAA;QACD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAEzC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAEvB,sEAAsE;QACtE,2EAA2E;QAC3E,sEAAsE;QACtE,iEAAiE;QACjE,iEAAiE;QACjE,qCAAqC;QACrC,MAAM,CAAC,IAAI,CACT,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClE,OAAO,CACV,CAAA;QACD,KAAK,GAAG,EAAE,GAAG,CAAC,CAAA;QACd,QAAQ,GAAG,KAAK,CAAA;QAChB,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAA;IACpC,CAAC;AACH,CAAC,CAAA;AAED,MAAM,QAAQ,GAAG,CACf,IAAY,EACZ,KAAa,EACb,QAAgB,EAChB,SAAmB,EACnB,UAAoB,EACH,EAAE;IACnB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAA;IACpC,MAAM,kBAAkB,GAAG,IAAA,iCAAqB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAClE,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,MAAM,CAAA;IACnD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,KAAK,GAAG,IAAA,yBAAa,EAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAClC,IAAI,KAAK,GAAG,IAAI,CAAA;IAEhB,OAAO,IAAI,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,KAAK,EAAE,CAAC;QACzE,wEAAwE;QACxE,kCAAkC;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,GAAG,iBAAiB,CAAA;QACjE,2EAA2E;QAC3E,wCAAwC;QACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;QAClE,MAAM,GAAG,GACP,QAAQ,IAAI,CAAC;YACX,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;QAEtD,4EAA4E;QAC5E,uBAAuB;QACvB,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QACxB,KAAK,CAAC,IAAI,CACR,KAAK;YACH,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE;YAC9B,CAAC,CAAC,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAC1D,CAAA;QACD,KAAK,GAAG,IAAA,yBAAa,EAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAChC,KAAK,GAAG,KAAK,CAAA;IACf,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAEjE,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;;GAMG;AACI,MAAM,oBAAoB,GAAG,CAClC,IAAY,EACwB,EAAE;;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IACrC,MAAM,KAAK,GAAuC,EAAE,CAAA;IAEpD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAA,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,mCAAI,EAAE,EAAE,CAAC,CAAA;IACpE,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAXY,QAAA,oBAAoB,wBAWhC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,aAAyB,EAAU,EAAE;IAC5E,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,qEAAqE;IACrE,2EAA2E;IAC3E,4BAA4B;IAC5B,IACE,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;QAE1E,OAAO,IAAI,CAAA;IAEb,MAAM,OAAO,GAAG,IAAA,4BAAoB,EAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,YAAY,GAAG,IAAA,6CAAqB,EAAC,IAAI,EAAE,aAAa,CAAC,CAAA;IAC/D,MAAM,QAAQ,GAAG,IAAA,iCAAqB,EAAC,aAAa,CAAC,CAAA;IAErD,2EAA2E;IAC3E,oDAAoD;IACpD,MAAM,aAAa,GACjB,aAAa,CAAC,WAAW,KAAK,yBAAW,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;IAChE,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,GAAG,IAAA,qBAAU,GAAE,CAAA;IACxB,yEAAyE;IACzE,0EAA0E;IAC1E,IAAI,cAAc,GAAG,KAAK,CAAA;IAC1B,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE;QAC1C,sEAAsE;QACtE,wEAAwE;QACxE,MAAM,MAAM,GAAG,IAAA,uCAAe,EAAC,YAAY,EAAE,KAAK,CAAC,CAAA;QACnD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,iBAAM,GAAE,CAAC,CAAC,CAAC,IAAA,mBAAQ,EAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACzD,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAA;QAExB,MAAM,UAAU,GAAG,MAAM;YACvB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;YAC9B,CAAC,CAAC,IAAA,2BAAe,EAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;QACjD,cAAc,GAAG,UAAU,CAAC,IAAI,CAAA;QAEhC,wEAAwE;QACxE,8BAA8B;QAC9B,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAEvE,2EAA2E;QAC3E,mEAAmE;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,IAAI,aAAa,CAAC,aAAa,CAAA;QAEjE,MAAM,OAAO,GACX,MAAM,IAAI,wBAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI;YACvC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,4BAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3B,CAAC,CAAC,qBAAqB,CACnB,IAAI,EACJ,OAAO,CAAC,IAAI,EACZ,aAAa,CAAC,aAAa,EAC3B,QAAQ,CACT;gBACH,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU;oBACtC,CAAC,CAAC,aAAa,CACX,IAAI,EACJ,aAAa,CAAC,aAAa,EAC3B,QAAQ,EACR,OAAO,CAAC,SAAS,EACjB,IAAA,wBAAY,EAAC,IAAI,CAAC,EAClB,UAAU,CACX;oBACH,CAAC,CAAC,OAAO,CAAC,UAAU;wBAClB,CAAC,CAAC,IAAI;wBACN,CAAC,CAAC,QAAQ,CACN,IAAI,EACJ,aAAa,CAAC,aAAa,EAC3B,QAAQ,EACR,OAAO,CAAC,SAAS,EACjB,UAAU,CACX,CAAA;QAEb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,CAAA;YAC1B,OAAM;QACR,CAAC;QAED,OAAO,GAAG,IAAI,CAAA;QACd,oEAAoE;QACpE,oDAAoD;QACpD,MAAM,WAAW,GAAG,MAAM,IAAI,aAAa,CAAA;QAC3C,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;YACpC,MAAM,CAAC,IAAI,CACT,KAAK,GAAG,CAAC,UAAU,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CACnE,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACzC,CAAC,CAAA;AA5FY,QAAA,UAAU,cA4FtB"}

package/format/shared.js

@@ -1,18 +1,47 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.processLine = exports.processText = void 0;
-const LineEndings_1 = require("../types/LineEndings");
+const parseLintOverride_1 = require("../utils/parseLintOverride");
 const splitText_1 = require("../utils/splitText");
+const adjustLineLength_1 = require("./adjustLineLength");
+const reflowComments_1 = require("./reflowComments");
+const rewrapText_1 = require("./rewrapText");
+const splitTrailingComments_1 = require("./splitTrailingComments");
+/**
+ * How many times the passes run before the result is taken as final.
+ *
+ * A run is not idempotent on its own: `adjustLineLength` raises the file's own
+ * `maxLineLength` when it writes an exception, so a second run works to a
+ * higher limit and can wrap a line the first run declined. Running the passes
+ * until the text stops changing makes the output a fixed point, which is what
+ * "formatting twice changes nothing" means - and the bound stops a pair of
+ * states that undo each other from looping.
+ */
+const maxPasses = 3;
 const processText = (text, config) => {
-    const processedText = processContent(config, text);
+    let current = text;
+    // A pass that writes an exception has raised the limit the next pass works
+    // to, so the override is re-read from the text each time round.
+    let effective = (0, parseLintOverride_1.applyLintOverride)(current, config);
+    for (let pass = 0; pass < maxPasses; pass++) {
+        const next = processOnce(current, effective);
+        if (next === current)
+            break;
+        current = next;
+        effective = (0, parseLintOverride_1.applyLintOverride)(current, config);
+    }
+    return current;
+};
+exports.processText = processText;
+const processOnce = (text, config) => {
+    const rewrapped = (0, rewrapText_1.rewrapText)((0, splitTrailingComments_1.splitTrailingComments)(processContent(config, text), config), config);
+    const processedText = (0, adjustLineLength_1.adjustLineLength)((0, reflowComments_1.reflowComments)(rewrapped, config), config);
     const lines = (0, splitText_1.splitText)(processedText, config);
     const formattedLines = lines.map((line) => {
         return (0, exports.processLine)(config, line);
     });
-    const configuredLineEnding = config.lineEndings === LineEndings_1.LineEndings.LF ? '\n' : '\r\n';
-    return formattedLines.join(configuredLineEnding);
+    return formattedLines.join((0, adjustLineLength_1.lineEndingOf)(config));
 };
-exports.processText = processText;
 const processContent = (config, content) => {
     let processedContent = content;
     config.fileLintRules

package/format/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/format/shared.ts"],"names":[],"mappings":";;;AACA,sDAAkD;AAClD,kDAA8C;AAEvC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAkB,EAAE,EAAE;IAC9D,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAClD,MAAM,KAAK,GAAG,IAAA,qBAAS,EAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxC,OAAO,IAAA,mBAAW,EAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,MAAM,oBAAoB,GACxB,MAAM,CAAC,WAAW,KAAK,yBAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;IACvD,OAAO,cAAc,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;AAClD,CAAC,CAAA;AAVY,QAAA,WAAW,eAUvB;AAED,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,OAAe,EAAU,EAAE;IACrE,IAAI,gBAAgB,GAAG,OAAO,CAAA;IAC9B,MAAM,CAAC,aAAa;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;SACtB,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChB,gBAAgB,GAAG,IAAI,CAAC,GAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEJ,OAAO,gBAAgB,CAAA;AACzB,CAAC,CAAA;AAEM,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAE,IAAY,EAAU,EAAE;IACtE,IAAI,aAAa,GAAG,IAAI,CAAA;IACxB,MAAM,CAAC,aAAa;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;SACtB,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChB,aAAa,GAAG,IAAI,CAAC,GAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEJ,OAAO,aAAa,CAAA;AACtB,CAAC,CAAA;AATY,QAAA,WAAW,eASvB"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/format/shared.ts"],"names":[],"mappings":";;;AACA,kEAA8D;AAC9D,kDAA8C;AAC9C,yDAAmE;AACnE,qDAAiD;AACjD,6CAAyC;AACzC,mEAA+D;AAE/D;;;;;;;;;GASG;AACH,MAAM,SAAS,GAAG,CAAC,CAAA;AAEZ,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAkB,EAAE,EAAE;IAC9D,IAAI,OAAO,GAAG,IAAI,CAAA;IAClB,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,SAAS,GAAG,IAAA,qCAAiB,EAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAElD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAE5C,IAAI,IAAI,KAAK,OAAO;YAAE,MAAK;QAE3B,OAAO,GAAG,IAAI,CAAA;QACd,SAAS,GAAG,IAAA,qCAAiB,EAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAChD,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAhBY,QAAA,WAAW,eAgBvB;AAED,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAkB,EAAU,EAAE;IAC/D,MAAM,SAAS,GAAG,IAAA,uBAAU,EAC1B,IAAA,6CAAqB,EAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAC3D,MAAM,CACP,CAAA;IACD,MAAM,aAAa,GAAG,IAAA,mCAAgB,EACpC,IAAA,+BAAc,EAAC,SAAS,EAAE,MAAM,CAAC,EACjC,MAAM,CACP,CAAA;IACD,MAAM,KAAK,GAAG,IAAA,qBAAS,EAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxC,OAAO,IAAA,mBAAW,EAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,OAAO,cAAc,CAAC,IAAI,CAAC,IAAA,+BAAY,EAAC,MAAM,CAAC,CAAC,CAAA;AAClD,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,OAAe,EAAU,EAAE;IACrE,IAAI,gBAAgB,GAAG,OAAO,CAAA;IAC9B,MAAM,CAAC,aAAa;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;SACtB,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChB,gBAAgB,GAAG,IAAI,CAAC,GAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEJ,OAAO,gBAAgB,CAAA;AACzB,CAAC,CAAA;AAEM,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAE,IAAY,EAAU,EAAE;IACtE,IAAI,aAAa,GAAG,IAAI,CAAA;IACxB,MAAM,CAAC,aAAa;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;SACtB,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChB,aAAa,GAAG,IAAI,CAAC,GAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEJ,OAAO,aAAa,CAAA;AACtB,CAAC,CAAA;AATY,QAAA,WAAW,eASvB"}

package/format/splitTrailingComments.d.ts

@@ -0,0 +1,22 @@
+import { LintConfig } from '../types';
+/**
+ * Lifts a trailing block comment onto a line of its own when the code it sits
+ * after is what has to be shortened.
+ *
+ * A line like
+ *
+ *     , var /* variable name from which to return the format *\/
+ *
+ * is 63 characters whose code is 9, and no pass may break a line carrying a
+ * comment - so the comment moves down and both halves become ordinary lines:
+ * the code is wrapped by `rewrapText` if it is still too long, and the comment
+ * is reflowed by `reflowComments` like any other prose.
+ *
+ * A line is split only when it exceeds the limit, so a file that already fits
+ * keeps its layout. A `datalines` record is data and is never touched.
+ *
+ * @param {string} text - the text to read.
+ * @param {LintConfig} configuration - the configuration in force.
+ * @returns {string} the text, with over-long code/comment lines split.
+ */
+export declare const splitTrailingComments: (text: string, configuration: LintConfig) => string;

package/format/splitTrailingComments.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitTrailingComments = void 0;
+const getDataSectionsDetail_1 = require("../utils/getDataSectionsDetail");
+const scanLine_1 = require("../utils/scanLine");
+const adjustLineLength_1 = require("./adjustLineLength");
+const rewrapText_1 = require("./rewrapText");
+/**
+ * Lifts a trailing block comment onto a line of its own when the code it sits
+ * after is what has to be shortened.
+ *
+ * A line like
+ *
+ *     , var /* variable name from which to return the format *\/
+ *
+ * is 63 characters whose code is 9, and no pass may break a line carrying a
+ * comment - so the comment moves down and both halves become ordinary lines:
+ * the code is wrapped by `rewrapText` if it is still too long, and the comment
+ * is reflowed by `reflowComments` like any other prose.
+ *
+ * A line is split only when it exceeds the limit, so a file that already fits
+ * keeps its layout. A `datalines` record is data and is never touched.
+ *
+ * @param {string} text - the text to read.
+ * @param {LintConfig} configuration - the configuration in force.
+ * @returns {string} the text, with over-long code/comment lines split.
+ */
+const splitTrailingComments = (text, configuration) => {
+    if (!text)
+        return text;
+    if (!configuration.lineLintRules.some((rule) => rule.name === 'maxLineLength'))
+        return text;
+    const entries = (0, rewrapText_1.splitWithTerminators)(text);
+    const dataSections = (0, getDataSectionsDetail_1.getDataSectionsDetail)(text, configuration);
+    const output = [];
+    let state = (0, scanLine_1.cleanState)();
+    let changed = false;
+    entries.forEach(({ line, ending }, index) => {
+        const isData = (0, getDataSectionsDetail_1.checkIsDataLine)(dataSections, index);
+        const scanned = isData ? (0, scanLine_1.noScan)() : (0, scanLine_1.scanLine)(line, state);
+        state = scanned.endState;
+        const span = scanned.comments[0];
+        const code = span ? line.slice(0, span.start) : '';
+        // A line is split whenever it is over the limit and carries code before a
+        // comment, including when the CODE alone overruns: the code then goes to the
+        // wrapper (or to `adjustLineLength`) and the comment to the reflow, so each
+        // half reaches the pass that owns it instead of the line being refused by
+        // both.
+        const splits = !isData &&
+            !!span &&
+            line.length > configuration.maxLineLength &&
+            code.trim() !== '';
+        if (!splits) {
+            output.push(line + ending);
+            return;
+        }
+        changed = true;
+        const indent = /^\s*/.exec(line)[0];
+        // The break takes the line's own terminator; the final line of a file with
+        // no final newline takes the configured one instead.
+        const breakEnding = ending || (0, adjustLineLength_1.lineEndingOf)(configuration);
+        output.push(code.trimEnd() + breakEnding);
+        output.push(indent + line.slice(span.start) + ending);
+    });
+    return changed ? output.join('') : text;
+};
+exports.splitTrailingComments = splitTrailingComments;
+//# sourceMappingURL=splitTrailingComments.js.map

package/format/splitTrailingComments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitTrailingComments.js","sourceRoot":"","sources":["../../src/format/splitTrailingComments.ts"],"names":[],"mappings":";;;AACA,0EAGuC;AACvC,gDAAgE;AAChE,yDAAiD;AACjD,6CAAmD;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,qBAAqB,GAAG,CACnC,IAAY,EACZ,aAAyB,EACjB,EAAE;IACV,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,IACE,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;QAE1E,OAAO,IAAI,CAAA;IAEb,MAAM,OAAO,GAAG,IAAA,iCAAoB,EAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,YAAY,GAAG,IAAA,6CAAqB,EAAC,IAAI,EAAE,aAAa,CAAC,CAAA;IAC/D,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,GAAG,IAAA,qBAAU,GAAE,CAAA;IACxB,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAG,IAAA,uCAAe,EAAC,YAAY,EAAE,KAAK,CAAC,CAAA;QACnD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,iBAAM,GAAE,CAAC,CAAC,CAAC,IAAA,mBAAQ,EAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACzD,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAA;QAExB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAElD,0EAA0E;QAC1E,6EAA6E;QAC7E,4EAA4E;QAC5E,0EAA0E;QAC1E,QAAQ;QACR,MAAM,MAAM,GACV,CAAC,MAAM;YACP,CAAC,CAAC,IAAI;YACN,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,aAAa;YACzC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;QAEpB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,CAAA;YAC1B,OAAM;QACR,CAAC;QAED,OAAO,GAAG,IAAI,CAAA;QACd,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAA;QACpC,2EAA2E;QAC3E,qDAAqD;QACrD,MAAM,WAAW,GAAG,MAAM,IAAI,IAAA,+BAAY,EAAC,aAAa,CAAC,CAAA;QAEzD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC,CAAA;QACzC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACzC,CAAC,CAAA;AApDY,QAAA,qBAAqB,yBAoDjC"}

package/package.json

@@ -5,38 +5,24 @@
     "node": ">=22"
   },
   "scripts": {
-    "test": "jest --coverage",
     "build": "rimraf build && tsc",
+    "check:package": "node scripts/checkPackageContents.mjs",
     "generate:macros": "node ./scripts/generate-macro-names.mjs",
-    "prebuild": "node checkNodeVersion",
-    "publishInit": "cp -r ./build/* . && rm -rf ./build && rm -rf ./src && rm tsconfig.json",
-    "package:lib": "npm run build && cp ./package.json ./checkNodeVersion.js build && cp README.md build && cd build && npm version \"5.0.0\" && npm pack",
-    "lint:fix": "npx prettier --write \"{src,test}/**/*.{ts,tsx,js,jsx,html,css,sass,less,json,yml,md,graphql}\"",
     "lint": "npx prettier --check \"{src,test}/**/*.{ts,tsx,js,jsx,html,css,sass,less,json,yml,md,graphql}\"",
+    "lint:fix": "npx prettier --write \"{src,test}/**/*.{ts,tsx,js,jsx,html,css,sass,less,json,yml,md,graphql}\"",
     "mutation": "stryker run",
     "mutation:changed": "node scripts/mutation-gate.mjs pr",
     "mutation:watch": "node scripts/mutation-gate.mjs weekly",
-    "check:package": "node scripts/checkPackageContents.mjs"
+    "package:lib": "npm run build && cp ./package.json ./checkNodeVersion.js build && cp README.md build && cd build && npm version \"5.0.0\" && npm pack",
+    "prebuild": "node checkNodeVersion",
+    "prepublishOnly": "node -e \"const v=require('./package.json').version; if (/^0\\.0\\.0/.test(v)) { console.error('refusing to publish ' + v + ': the version is stamped from the tag (npm version <tag> --no-git-tag-version)'); process.exit(1) }\"",
+    "publishInit": "cp -r ./build/* . && rm -rf ./build && rm -rf ./src && rm tsconfig.json",
+    "release": "sasjs-release",
+    "test": "jest --coverage"
   },
   "publishConfig": {
     "access": "public"
   },
-  "release": {
-    "branches": [
-      "main"
-    ],
-    "plugins": [
-      "@semantic-release/commit-analyzer",
-      "@semantic-release/release-notes-generator",
-      [
-        "@semantic-release/exec",
-        {
-          "prepareCmd": "npm version ${nextRelease.version} --no-git-tag-version --allow-same-version"
-        }
-      ],
-      "@semantic-release/github"
-    ]
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sasjs/lint.git"
@@ -56,6 +42,7 @@
   "homepage": "https://github.com/sasjs/lint#readme",
   "devDependencies": {
     "@nogoo9/gitleaks": "8.30.1-post.2",
+    "@sasjs/release": "0.1.3",
     "@sasjs/sas-language": "0.3.3",
     "@stryker-mutator/core": "10.1.1",
     "@stryker-mutator/jest-runner": "10.1.1",
@@ -93,7 +80,7 @@
     "glob": "^14.0.2",
     "minimatch": "^11.0.1"
   },
-  "version": "5.3.1",
+  "version": "5.4.0",
   "devEngines": {
     "runtime": {
       "name": "node",