@sasjs/lint 2.7.0 → 4.0.0

package/utils/headerMacros.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeMacrosFromHeader = exports.addMacrosToHeader = exports.getHeaderMacros = void 0;
+const types_1 = require("../types");
+const LineEndings_1 = require("../types/LineEndings");
+const getHeaderLinesCount_1 = require("./getHeaderLinesCount");
+const splitText_1 = require("./splitText");
+const sasMacrosHeader = /<h4>\s*SAS Macros\s*<\/h4>/i;
+const otherMacrosHeader = /<h4>\s*Other Macros\s*<\/h4>/i;
+const anyHeader = /<h4>/i;
+const headerTag = '</h4>';
+const listItem = /^(\s*@li\s+)(.+?)(\s*)$/;
+/**
+ * Reads an `@li` entry, returning the macro name and the column at which it
+ * starts. The column is derived from the entry text rather than from a search
+ * for the name, so an entry such as `@li li.sas` reports the `li` after the
+ * tag, not the `li` inside it.
+ *
+ * @param {string} text - the line, or the tail of a line, to read.
+ * @param {number} offset - the 0-based column at which `text` starts in the
+ * line, so a trailing entry on a `<h4>` line still reports its real position.
+ */
+const parseListItem = (text, offset = 0) => {
+    const match = listItem.exec(text);
+    if (!match)
+        return null;
+    const entry = match[2];
+    const firstToken = entry.trim().split(/\s+/)[0] || '';
+    const normalised = firstToken.replace(/\\/g, '/');
+    const fileName = normalised.split('/').pop() || '';
+    const name = fileName.replace(/\.sas$/i, '');
+    if (!name)
+        return null;
+    const tokenOffset = entry.indexOf(firstToken);
+    const fileOffset = normalised.lastIndexOf('/') + 1;
+    const column = offset + match[1].length + tokenOffset + fileOffset + 1;
+    return { name, column };
+};
+/**
+ * Reads the `@li` entries of a section that starts at `sectionIndex`.
+ *
+ * A blank line ends the list unless the next non-blank line is another entry,
+ * so a list broken up by a stray blank line is still read in full - the
+ * formatter rewrites exactly the lines it read, and an entry it did not read
+ * would be left behind and duplicated.
+ *
+ * @returns the entries, and the index of the first line after the last one.
+ */
+const readSectionList = (lines, sectionIndex, limit) => {
+    const entries = [];
+    let end = sectionIndex + 1;
+    let index = sectionIndex + 1;
+    while (index < limit && index < lines.length) {
+        const line = lines[index];
+        if (line.trim() === '') {
+            let next = index;
+            while (next < limit && next < lines.length && lines[next].trim() === '') {
+                next++;
+            }
+            if (next < limit && next < lines.length && listItem.test(lines[next])) {
+                index = next;
+                continue;
+            }
+            break;
+        }
+        const parsed = parseListItem(line);
+        if (!parsed)
+            break;
+        entries.push({
+            name: parsed.name,
+            line,
+            lineNumber: index + 1,
+            column: parsed.column
+        });
+        index++;
+        end = index;
+    }
+    return { entries, end };
+};
+/**
+ * Reads the macros declared in the header of a file - both the
+ * `<h4> SAS Macros </h4>` and the `<h4> Other Macros </h4>` sections.
+ * @param {string} text - the text content of the file.
+ * @param {LintConfig} config - the lint configuration, used for line endings.
+ * @returns {HeaderMacro[]} the declared macros, in the order they appear.
+ */
+const getHeaderMacros = (text, config) => {
+    if (!text)
+        return [];
+    const cfg = config || new types_1.LintConfig();
+    const headerLinesCount = (0, getHeaderLinesCount_1.getHeaderLinesCount)(text, cfg);
+    if (!headerLinesCount)
+        return [];
+    const lines = (0, splitText_1.splitText)(text, cfg);
+    const macros = [];
+    for (let index = 0; index < headerLinesCount && index < lines.length; index++) {
+        const line = lines[index];
+        const section = sasMacrosHeader.test(line)
+            ? 'sasMacros'
+            : otherMacrosHeader.test(line)
+                ? 'otherMacros'
+                : null;
+        if (!section)
+            continue;
+        // An entry can share the line with the section tag.
+        const tagEnd = line.indexOf(headerTag) + headerTag.length;
+        const trailing = parseListItem(line.slice(tagEnd), tagEnd);
+        if (trailing) {
+            macros.push({
+                name: trailing.name,
+                lineNumber: index + 1,
+                startColumnNumber: trailing.column,
+                endColumnNumber: trailing.column + trailing.name.length,
+                section
+            });
+        }
+        readSectionList(lines, index, headerLinesCount).entries.forEach((entry) => {
+            macros.push({
+                name: entry.name,
+                lineNumber: entry.lineNumber,
+                startColumnNumber: entry.column,
+                endColumnNumber: entry.column + entry.name.length,
+                section
+            });
+        });
+    }
+    return macros;
+};
+exports.getHeaderMacros = getHeaderMacros;
+/**
+ * Derives the indentation used by the content lines of a header. Falls back to
+ * two spaces, which is the indentation of the default header.
+ */
+const getHeaderIndent = (lines, headerLinesCount) => {
+    for (let index = 1; index < headerLinesCount && index < lines.length; index++) {
+        const match = /^(\s+)\S/.exec(lines[index]);
+        if (match)
+            return match[1];
+    }
+    return '  ';
+};
+/**
+ * Ensures a blank line separates a header section from its neighbours. The
+ * section header sits at `sectionIndex` and `listEnd` is the index of the first
+ * line after the section's `@li` entries.
+ */
+const withSectionSpacing = (lines, sectionIndex, listEnd) => {
+    const result = [...lines];
+    if (listEnd < result.length && result[listEnd].trim() !== '') {
+        result.splice(listEnd, 0, '');
+    }
+    if (sectionIndex > 0 && result[sectionIndex - 1].trim() !== '') {
+        result.splice(sectionIndex, 0, '');
+    }
+    return result;
+};
+/**
+ * Locates the `<h4> SAS Macros </h4>` section of a header.
+ *
+ * Returns `null` when the section is absent, and `null` when it cannot be
+ * rewritten without disturbing the surrounding text: when the section shares a
+ * line with the header's closing `**`, or when an `@li` entry shares the line
+ * with the section tag. In those cases the caller leaves the file alone, so a
+ * warning that cannot be resolved is preferable to a corrupted header.
+ */
+const findSasMacrosSection = (lines, headerLinesCount) => {
+    let sectionIndex = -1;
+    for (let index = 0; index < headerLinesCount && index < lines.length; index++) {
+        if (sasMacrosHeader.test(lines[index])) {
+            sectionIndex = index;
+            break;
+        }
+    }
+    if (sectionIndex === -1)
+        return null;
+    if (sectionIndex === headerLinesCount - 1)
+        return null;
+    const tagEnd = lines[sectionIndex].indexOf(headerTag) + headerTag.length;
+    if (parseListItem(lines[sectionIndex].slice(tagEnd)))
+        return null;
+    const { entries, end } = readSectionList(lines, sectionIndex, headerLinesCount);
+    return { sectionIndex, entries, end };
+};
+/**
+ * Adds macro names to the `<h4> SAS Macros </h4>` section of a file header,
+ * merging them with the entries that are already listed, de-duplicating by
+ * name, and sorting the result alphabetically. A new section is added when the
+ * header has none.
+ *
+ * A blank line separates the section from the header content before it and from
+ * whatever follows the list, so the section reads as its own block.
+ *
+ * @param {string} text - the text content of the file.
+ * @param {LintConfig} config - the lint configuration, used for line endings.
+ * @param {string[]} macros - the macro names to add.
+ * @returns {string} the updated text content.
+ */
+const addMacrosToHeader = (text, config, macros) => {
+    if (!text || !macros.length)
+        return text;
+    const headerLinesCount = (0, getHeaderLinesCount_1.getHeaderLinesCount)(text, config);
+    if (!headerLinesCount)
+        return text;
+    const lines = (0, splitText_1.splitText)(text, config);
+    const lineEnding = config.lineEndings === LineEndings_1.LineEndings.CRLF ? '\r\n' : '\n';
+    const headerEndIndex = headerLinesCount - 1;
+    const section = findSasMacrosSection(lines, headerLinesCount);
+    if (!section) {
+        // No section, or one that cannot be rewritten. Only a genuinely absent
+        // section is safe to create, so check for the tag first.
+        const hasSection = lines
+            .slice(0, headerLinesCount)
+            .some((line) => sasMacrosHeader.test(line));
+        if (hasSection || headerEndIndex === 0)
+            return text;
+        const indent = getHeaderIndent(lines, headerLinesCount);
+        const sectionLines = [
+            `${indent}<h4> SAS Macros </h4>`,
+            ...macros.map((macro) => `${indent}@li ${macro}.sas`)
+        ];
+        const result = [
+            ...lines.slice(0, headerEndIndex),
+            ...sectionLines,
+            ...lines.slice(headerEndIndex)
+        ];
+        return withSectionSpacing(result, headerEndIndex, headerEndIndex + sectionLines.length).join(lineEnding);
+    }
+    const { sectionIndex, entries, end } = section;
+    const indent = lines[sectionIndex].match(/^\s*/)[0];
+    const byName = new Map();
+    entries.forEach((entry) => {
+        const key = entry.name.toLowerCase();
+        if (!byName.has(key))
+            byName.set(key, { name: entry.name, line: entry.line });
+    });
+    macros.forEach((macro) => {
+        const key = macro.toLowerCase();
+        if (byName.has(key))
+            return;
+        byName.set(key, { name: macro, line: `${indent}@li ${macro}.sas` });
+    });
+    const sortedLines = [...byName.values()]
+        .sort((a, b) => compareMacroNames(a.name, b.name))
+        .map((entry) => entry.line);
+    const result = [
+        ...lines.slice(0, sectionIndex + 1),
+        ...sortedLines,
+        ...lines.slice(end)
+    ];
+    return withSectionSpacing(result, sectionIndex, sectionIndex + 1 + sortedLines.length).join(lineEnding);
+};
+exports.addMacrosToHeader = addMacrosToHeader;
+/**
+ * Removes macro names from the `<h4> SAS Macros </h4>` section of a file
+ * header. The section header itself is kept, so an empty list remains a valid
+ * place for the formatter to add entries. The blank line before the section and
+ * after the list is preserved.
+ *
+ * The file is returned unchanged when it has no Doxygen header, when the header
+ * has no `SAS Macros` section, when the section cannot be rewritten safely, or
+ * when none of the named macros are listed.
+ *
+ * @param {string} text - the text content of the file.
+ * @param {LintConfig} config - the lint configuration, used for line endings.
+ * @param {string[]} macros - the macro names to remove.
+ * @returns {string} the updated text content.
+ */
+const removeMacrosFromHeader = (text, config, macros) => {
+    if (!text || !macros.length)
+        return text;
+    const headerLinesCount = (0, getHeaderLinesCount_1.getHeaderLinesCount)(text, config);
+    if (!headerLinesCount)
+        return text;
+    const lines = (0, splitText_1.splitText)(text, config);
+    const lineEnding = config.lineEndings === LineEndings_1.LineEndings.CRLF ? '\r\n' : '\n';
+    const section = findSasMacrosSection(lines, headerLinesCount);
+    if (!section)
+        return text;
+    const { sectionIndex, entries, end } = section;
+    const remove = new Set(macros.map((macro) => macro.toLowerCase()));
+    const kept = [];
+    const seen = new Set();
+    let changed = false;
+    entries.forEach((entry) => {
+        const key = entry.name.toLowerCase();
+        if (remove.has(key)) {
+            changed = true;
+            return;
+        }
+        if (seen.has(key)) {
+            // A duplicate entry for a macro that is kept.
+            changed = true;
+            return;
+        }
+        seen.add(key);
+        kept.push(entry.line);
+    });
+    if (!changed)
+        return text;
+    const result = [
+        ...lines.slice(0, sectionIndex + 1),
+        ...kept,
+        ...lines.slice(end)
+    ];
+    return withSectionSpacing(result, sectionIndex, sectionIndex + 1 + kept.length).join(lineEnding);
+};
+exports.removeMacrosFromHeader = removeMacrosFromHeader;
+const compareMacroNames = (a, b) => a.toLowerCase().localeCompare(b.toLowerCase());
+//# sourceMappingURL=headerMacros.js.map

package/utils/headerMacros.js.map

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

package/utils/index.d.ts

@@ -8,3 +8,8 @@ export * from './splitText';
 export * from './getIndicesOf';
 export * from './getHeaderLinesCount';
 export * from './getDataSectionsDetail';
+export * from './headerMacros';
+export * from './mergeLintConfig';
+export * from './parseLintOverride';
+export * from './parseMacroCalls';
+export * from './sasMacros';

package/utils/index.js

@@ -24,4 +24,9 @@ __exportStar(require("./splitText"), exports);
 __exportStar(require("./getIndicesOf"), exports);
 __exportStar(require("./getHeaderLinesCount"), exports);
 __exportStar(require("./getDataSectionsDetail"), exports);
+__exportStar(require("./headerMacros"), exports);
+__exportStar(require("./mergeLintConfig"), exports);
+__exportStar(require("./parseLintOverride"), exports);
+__exportStar(require("./parseMacroCalls"), exports);
+__exportStar(require("./sasMacros"), exports);
 //# sourceMappingURL=index.js.map

package/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B;AAC9B,kDAA+B;AAC/B,mDAAgC;AAChC,sDAAmC;AACnC,8CAA2B;AAC3B,iDAA8B;AAC9B,8CAA2B;AAC3B,iDAA8B;AAC9B,wDAAqC;AACrC,0DAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B;AAC9B,kDAA+B;AAC/B,mDAAgC;AAChC,sDAAmC;AACnC,8CAA2B;AAC3B,iDAA8B;AAC9B,8CAA2B;AAC3B,iDAA8B;AAC9B,wDAAqC;AACrC,0DAAuC;AACvC,iDAA8B;AAC9B,oDAAiC;AACjC,sDAAmC;AACnC,oDAAiC;AACjC,8CAA2B"}

package/utils/mergeLintConfig.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Merges a per-file configuration override over the project configuration.
+ *
+ * Scalars replace, arrays are additive, and objects merge key by key. A file
+ * therefore adds an allowed gremlin, a required macro option or a severity
+ * level without having to restate the rest of the project configuration, and
+ * it can still switch a rule off or raise a limit for itself. Deprecated
+ * setting names are folded onto their canonical key first.
+ */
+export declare const mergeLintConfig: (base: any, override: any) => any;

package/utils/mergeLintConfig.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeLintConfig = void 0;
+/**
+ * Deprecated setting names, mapped to the canonical key. An alias is folded onto
+ * the canonical key before the merge, so a project that sets `noTabIndentation`
+ * and a file that sets `noTabs` cannot end up carrying both - which would let
+ * the alias win in the constructor and defeat the file.
+ */
+const aliases = {
+    noTabIndentation: 'noTabs'
+};
+const normaliseAliases = (json) => {
+    if (!isPlainObject(json))
+        return json;
+    const normalised = Object.assign({}, json);
+    for (const [alias, canonical] of Object.entries(aliases)) {
+        if (alias in normalised) {
+            if (!(canonical in normalised)) {
+                normalised[canonical] = normalised[alias];
+            }
+            delete normalised[alias];
+        }
+    }
+    return normalised;
+};
+/**
+ * Merges a per-file configuration override over the project configuration.
+ *
+ * Scalars replace, arrays are additive, and objects merge key by key. A file
+ * therefore adds an allowed gremlin, a required macro option or a severity
+ * level without having to restate the rest of the project configuration, and
+ * it can still switch a rule off or raise a limit for itself. Deprecated
+ * setting names are folded onto their canonical key first.
+ */
+const mergeLintConfig = (base, override) => {
+    const normalisedOverride = normaliseAliases(override);
+    if (!isPlainObject(base) || !isPlainObject(normalisedOverride)) {
+        return normalisedOverride;
+    }
+    const merged = normaliseAliases(base);
+    for (const [key, value] of Object.entries(normalisedOverride)) {
+        const current = merged[key];
+        if (Array.isArray(current) && Array.isArray(value)) {
+            merged[key] = mergeArrays(current, value);
+        }
+        else if (isPlainObject(current) && isPlainObject(value)) {
+            merged[key] = Object.assign(Object.assign({}, current), value);
+        }
+        else {
+            merged[key] = value;
+        }
+    }
+    return merged;
+};
+exports.mergeLintConfig = mergeLintConfig;
+const isPlainObject = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const isPrimitiveArray = (value) => value.every((item) => item === null || typeof item !== 'object');
+/**
+ * Concatenates two arrays. Arrays of primitives are de-duplicated, so an
+ * override that repeats an entry the project already lists does not add it
+ * twice.
+ */
+const mergeArrays = (base, override) => isPrimitiveArray(base) && isPrimitiveArray(override)
+    ? [...new Set([...base, ...override])]
+    : [...base, ...override];
+//# sourceMappingURL=mergeLintConfig.js.map

package/utils/mergeLintConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeLintConfig.js","sourceRoot":"","sources":["../../src/utils/mergeLintConfig.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAM,OAAO,GAA2B;IACtC,gBAAgB,EAAE,QAAQ;CAC3B,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,IAAS,EAAO,EAAE;IAC1C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAErC,MAAM,UAAU,qBAAQ,IAAI,CAAE,CAAA;IAE9B,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,SAAS,IAAI,UAAU,CAAC,EAAE,CAAC;gBAC/B,UAAU,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;YAC3C,CAAC;YAED,OAAO,UAAU,CAAC,KAAK,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC,CAAA;AAED;;;;;;;;GAQG;AACI,MAAM,eAAe,GAAG,CAAC,IAAS,EAAE,QAAa,EAAO,EAAE;IAC/D,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAErD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC/D,OAAO,kBAAkB,CAAA;IAC3B,CAAC;IAED,MAAM,MAAM,GAAQ,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QAE3B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC3C,CAAC;aAAM,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,CAAC,mCAAS,OAAkB,GAAM,KAAgB,CAAE,CAAA;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAtBY,QAAA,eAAe,mBAsB3B;AAED,MAAM,aAAa,GAAG,CAAC,KAAU,EAAW,EAAE,CAC5C,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAE/D,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAAW,EAAE,CACjD,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAA;AAElE;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,IAAW,EAAE,QAAe,EAAS,EAAE,CAC1D,gBAAgB,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC;IAClD,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAA"}

package/utils/parseLintOverride.d.ts

@@ -0,0 +1,36 @@
+import type { LintConfig } from '../types/LintConfig';
+/**
+ * Reads the per-file override from the header of a file.
+ *
+ * The override is a `@sasjslint` tag followed by a JSON object, anywhere in the
+ * Doxygen header:
+ *
+ * ```
+ * /**
+ *   @file
+ *   @brief Calls the settlement API
+ *
+ *   @sasjslint {"maxHeaderLineLength": 200, "noUndeclaredMacros": false}
+ * **\/
+ * ```
+ *
+ * Only the header is read, so an override cannot be buried in the body of a
+ * file. A tag that is missing, unterminated, malformed or not an object is
+ * ignored rather than raised: the linter must not fail on bad input.
+ *
+ * @param {string} text - the text content of the file.
+ * @param {LintConfig} config - the resolved configuration, used to find the
+ * header and its line endings.
+ * @returns {object | null} the override, or null when there is none.
+ */
+export declare const getLintOverride: (text: string, config: LintConfig) => any | null;
+/**
+ * Returns the configuration to lint a file with: the given configuration, with
+ * the file's own `@sasjslint` override merged over it. The header wins, since
+ * it is the more specific statement.
+ *
+ * @param {string} text - the text content of the file.
+ * @param {LintConfig} config - the resolved configuration.
+ * @returns {LintConfig} the effective configuration.
+ */
+export declare const applyLintOverride: (text: string, config: LintConfig) => LintConfig;

package/utils/parseLintOverride.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyLintOverride = exports.getLintOverride = void 0;
+const getHeaderLinesCount_1 = require("./getHeaderLinesCount");
+const splitText_1 = require("./splitText");
+/**
+ * The tag that introduces a per-file override, with the object that must follow
+ * it. The tag has to start a header line, and the `{` has to come immediately
+ * after it, so a `@brief` that mentions the syntax in prose, a longer tag such
+ * as `@sasjslintFoo`, and a tag with something else after it are all left alone
+ * rather than read as an override.
+ */
+const marker = /^[^\w]*@sasjslint\s*\{/m;
+/**
+ * Reads a balanced JSON object from `start`, honouring strings and escapes so
+ * a brace inside a value does not end the scan early.
+ */
+const readObject = (text, start) => {
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let index = start; index < text.length; index++) {
+        const char = text[index];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (char === '\\')
+                escaped = true;
+            else if (char === '"')
+                inString = false;
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+        }
+        else if (char === '{') {
+            depth++;
+        }
+        else if (char === '}') {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, index + 1);
+        }
+    }
+    return null;
+};
+/**
+ * Reads the per-file override from the header of a file.
+ *
+ * The override is a `@sasjslint` tag followed by a JSON object, anywhere in the
+ * Doxygen header:
+ *
+ * ```
+ * /**
+ *   @file
+ *   @brief Calls the settlement API
+ *
+ *   @sasjslint {"maxHeaderLineLength": 200, "noUndeclaredMacros": false}
+ * **\/
+ * ```
+ *
+ * Only the header is read, so an override cannot be buried in the body of a
+ * file. A tag that is missing, unterminated, malformed or not an object is
+ * ignored rather than raised: the linter must not fail on bad input.
+ *
+ * @param {string} text - the text content of the file.
+ * @param {LintConfig} config - the resolved configuration, used to find the
+ * header and its line endings.
+ * @returns {object | null} the override, or null when there is none.
+ */
+const getLintOverride = (text, config) => {
+    if (!text)
+        return null;
+    const headerLinesCount = (0, getHeaderLinesCount_1.getHeaderLinesCount)(text, config);
+    if (!headerLinesCount)
+        return null;
+    const header = (0, splitText_1.splitText)(text, config).slice(0, headerLinesCount).join('\n');
+    const match = marker.exec(header);
+    if (!match)
+        return null;
+    // The match ends with the opening brace.
+    const brace = match.index + match[0].length - 1;
+    const body = readObject(header, brace);
+    if (!body)
+        return null;
+    try {
+        // The body always starts with `{`, so a successful parse is an object.
+        return JSON.parse(body);
+    }
+    catch (_a) {
+        return null;
+    }
+};
+exports.getLintOverride = getLintOverride;
+/**
+ * Returns the configuration to lint a file with: the given configuration, with
+ * the file's own `@sasjslint` override merged over it. The header wins, since
+ * it is the more specific statement.
+ *
+ * @param {string} text - the text content of the file.
+ * @param {LintConfig} config - the resolved configuration.
+ * @returns {LintConfig} the effective configuration.
+ */
+const applyLintOverride = (text, config) => {
+    const override = (0, exports.getLintOverride)(text, config);
+    return override ? config.override(override) : config;
+};
+exports.applyLintOverride = applyLintOverride;
+//# sourceMappingURL=parseLintOverride.js.map

package/utils/parseLintOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseLintOverride.js","sourceRoot":"","sources":["../../src/utils/parseLintOverride.ts"],"names":[],"mappings":";;;AACA,+DAA2D;AAC3D,2CAAuC;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,yBAAyB,CAAA;AAExC;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,KAAa,EAAiB,EAAE;IAChE,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,KAAK,IAAI,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAExB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,OAAO;gBAAE,OAAO,GAAG,KAAK,CAAA;iBACvB,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,GAAG,IAAI,CAAA;iBACjC,IAAI,IAAI,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAA;YACvC,SAAQ;QACV,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAA;QACjB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,KAAK,EAAE,CAAA;QACT,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,KAAK,EAAE,CAAA;YACP,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,eAAe,GAAG,CAC7B,IAAY,EACZ,MAAkB,EACN,EAAE;IACd,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,MAAM,gBAAgB,GAAG,IAAA,yCAAmB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC1D,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAA;IAElC,MAAM,MAAM,GAAG,IAAA,qBAAS,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE5E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IAEvB,yCAAyC;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAE/C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,IAAI,CAAC;QACH,uEAAuE;QACvE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AA1BY,QAAA,eAAe,mBA0B3B;AAED;;;;;;;;GAQG;AACI,MAAM,iBAAiB,GAAG,CAC/B,IAAY,EACZ,MAAkB,EACN,EAAE;IACd,MAAM,QAAQ,GAAG,IAAA,uBAAe,EAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC9C,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AACtD,CAAC,CAAA;AANY,QAAA,iBAAiB,qBAM7B"}

package/utils/parseMacroCalls.d.ts

@@ -0,0 +1,28 @@
+import { LintConfig } from '../types';
+/**
+ * A macro invocation found in a file, with the position of its `%` character.
+ */
+export interface MacroCall {
+    name: string;
+    lineNumber: number;
+    startColumnNumber: number;
+    endColumnNumber: number;
+}
+/**
+ * Finds the macro invocations in a file.
+ *
+ * SAS resolves macro triggers inside double-quoted strings but not inside
+ * single-quoted strings, so a double-quoted string is scanned as code while a
+ * single-quoted string is opaque. Invocations inside block comments, macro
+ * comments, comment statements, masking functions (`%str` / `%nrstr`), data
+ * sections and embedded-language `submit` blocks are excluded.
+ *
+ * Every `%name` token is reported, including the macro language keywords and
+ * the macros that ship with SAS. Callers decide which names are interesting.
+ *
+ * @param {string} text - the text content to scan.
+ * @param {LintConfig} config - the lint configuration. It is accepted for
+ * symmetry with the other utilities and is not used by the scan.
+ * @returns {MacroCall[]} the invocations, in the order they appear.
+ */
+export declare const parseMacroCalls: (text: string, config?: LintConfig) => MacroCall[];