@sasjs/lint 2.7.0 → 4.0.0

package/utils/parseMacroCalls.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMacroCalls = void 0;
+/** Matches a macro invocation at the start of the supplied text. */
+const macroNameStart = /^%([a-z_][a-z0-9_]*)/i;
+/** Matches the statements that open a data section. */
+const dataSectionStart = /^(datalines4?|cards4?|parmcards4?)\s*;/i;
+/** Matches the functions whose argument is data rather than code. */
+const maskingFunctionStart = /^%(nrstr|str)\s*\(/i;
+/** Matches the procedures whose `submit` block holds another language. */
+const embeddedLanguageProc = /^proc\s+(lua|groovy)\b/i;
+/** Matches the statement that closes an embedded-language block. */
+const embeddedLanguageEnd = /^endsubmit\s*;/i;
+const embeddedLanguageEndSearch = /endsubmit/i;
+/**
+ * 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.
+ */
+const parseMacroCalls = (text, config) => {
+    const calls = [];
+    if (!text)
+        return calls;
+    const length = text.length;
+    let index = 0;
+    let lineNumber = 1;
+    let columnNumber = 1;
+    let atStatementStart = true;
+    let inDoubleQuote = false;
+    /**
+     * Advances the cursor to `target`, keeping the line and column counters in
+     * step. Every branch that consumes a non-code region moves through here.
+     */
+    const advanceTo = (target) => {
+        const limit = Math.min(target, length);
+        while (index < limit) {
+            if (text[index] === '\n') {
+                lineNumber++;
+                columnNumber = 1;
+            }
+            else {
+                columnNumber++;
+            }
+            index++;
+        }
+    };
+    while (index < length) {
+        const char = text[index];
+        if (char === '\n') {
+            lineNumber++;
+            columnNumber = 1;
+            inDoubleQuote = false;
+            index++;
+            continue;
+        }
+        if (char === '\r' || char === ' ' || char === '\t') {
+            columnNumber++;
+            index++;
+            continue;
+        }
+        // Single-quoted string - opaque. `''` is an escaped quote character. An
+        // apostrophe inside a double-quoted string is ordinary text.
+        if (char === "'") {
+            if (inDoubleQuote) {
+                columnNumber++;
+                index++;
+                continue;
+            }
+            let end = index + 1;
+            while (end < length) {
+                if (text[end] === "'") {
+                    if (text[end + 1] === "'") {
+                        end += 2;
+                        continue;
+                    }
+                    end++;
+                    break;
+                }
+                if (text[end] === '\n')
+                    break;
+                end++;
+            }
+            advanceTo(end);
+            continue;
+        }
+        // Double-quoted string - SAS resolves macro triggers inside it, so the
+        // scan continues until the closing quote.
+        if (char === '"') {
+            inDoubleQuote = !inDoubleQuote;
+            columnNumber++;
+            index++;
+            continue;
+        }
+        if (!inDoubleQuote) {
+            if (char === ';') {
+                atStatementStart = true;
+                columnNumber++;
+                index++;
+                continue;
+            }
+            // Block comment - /* ... */
+            if (char === '/' && text[index + 1] === '*') {
+                let end = index + 2;
+                while (end < length && !(text[end] === '*' && text[end + 1] === '/')) {
+                    end++;
+                }
+                advanceTo(Math.min(end + 2, length));
+                continue;
+            }
+        }
+        if (char === '%') {
+            // Macro comment - %* ... ;
+            if (text[index + 1] === '*') {
+                let end = index + 2;
+                while (end < length && text[end] !== ';')
+                    end++;
+                advanceTo(Math.min(end + 1, length));
+                continue;
+            }
+            // Masking functions - the argument is data, not code. `%(` and `%)` are
+            // the escapes for literal parentheses inside the argument, so they do
+            // not affect the nesting depth.
+            const maskingFunction = maskingFunctionStart.exec(text.slice(index));
+            if (maskingFunction) {
+                let depth = 0;
+                let end = index + maskingFunction[0].length - 1;
+                while (end < length) {
+                    if (text[end] === '%' &&
+                        (text[end + 1] === '(' || text[end + 1] === ')')) {
+                        end += 2;
+                        continue;
+                    }
+                    if (text[end] === '(')
+                        depth++;
+                    else if (text[end] === ')') {
+                        depth--;
+                        if (depth === 0) {
+                            end++;
+                            break;
+                        }
+                    }
+                    end++;
+                }
+                advanceTo(end);
+                atStatementStart = false;
+                continue;
+            }
+            const macroName = macroNameStart.exec(text.slice(index));
+            if (macroName) {
+                // A macro statement label - `%label:` - is not an invocation.
+                if (text[index + macroName[0].length] !== ':') {
+                    calls.push({
+                        name: macroName[1],
+                        lineNumber,
+                        startColumnNumber: columnNumber,
+                        endColumnNumber: columnNumber + 1 + macroName[1].length
+                    });
+                }
+                advanceTo(index + macroName[0].length);
+                atStatementStart = false;
+                continue;
+            }
+        }
+        if (atStatementStart && !inDoubleQuote) {
+            // A proc lua / proc groovy submit block holds another language, so its
+            // body is skipped. The block is only entered when an `endsubmit`
+            // statement closes it, so a stray `proc lua;` cannot swallow the rest
+            // of the file.
+            const embeddedProcStart = embeddedLanguageProc.exec(text.slice(index));
+            if (embeddedProcStart &&
+                embeddedLanguageEndSearch.test(text.slice(index))) {
+                const afterProc = index + embeddedProcStart[0].length;
+                const offset = text.slice(afterProc).search(embeddedLanguageEndSearch);
+                const endSubmit = embeddedLanguageEnd.exec(text.slice(afterProc + offset));
+                advanceTo(endSubmit ? afterProc + offset + endSubmit[0].length : length);
+                atStatementStart = true;
+                continue;
+            }
+            // A data section - everything up to its terminating line is data, not
+            // code. The terminator is a line containing only the `;` or `;;;;`.
+            const dataSection = dataSectionStart.exec(text.slice(index));
+            if (dataSection) {
+                const terminator = /4/.test(dataSection[1]) ? ';;;;' : ';';
+                let lineStart = index + dataSection[0].length;
+                let end = length;
+                while (lineStart <= length) {
+                    const lineEnd = text.indexOf('\n', lineStart);
+                    const actualEnd = lineEnd === -1 ? length : lineEnd;
+                    if (text.slice(lineStart, actualEnd).trim() === terminator) {
+                        end = actualEnd;
+                        break;
+                    }
+                    if (lineEnd === -1)
+                        break;
+                    lineStart = lineEnd + 1;
+                }
+                advanceTo(end);
+                atStatementStart = true;
+                continue;
+            }
+            // A comment statement - its body is opaque up to the terminating `;`.
+            if (char === '*') {
+                let end = index + 1;
+                while (end < length && text[end] !== ';')
+                    end++;
+                advanceTo(end + 1);
+                atStatementStart = true;
+                continue;
+            }
+        }
+        atStatementStart = false;
+        columnNumber++;
+        index++;
+    }
+    return calls;
+};
+exports.parseMacroCalls = parseMacroCalls;
+//# sourceMappingURL=parseMacroCalls.js.map

package/utils/parseMacroCalls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMacroCalls.js","sourceRoot":"","sources":["../../src/utils/parseMacroCalls.ts"],"names":[],"mappings":";;;AAYA,oEAAoE;AACpE,MAAM,cAAc,GAAG,uBAAuB,CAAA;AAE9C,uDAAuD;AACvD,MAAM,gBAAgB,GAAG,yCAAyC,CAAA;AAElE,qEAAqE;AACrE,MAAM,oBAAoB,GAAG,qBAAqB,CAAA;AAElD,0EAA0E;AAC1E,MAAM,oBAAoB,GAAG,yBAAyB,CAAA;AAEtD,oEAAoE;AACpE,MAAM,mBAAmB,GAAG,iBAAiB,CAAA;AAC7C,MAAM,yBAAyB,GAAG,YAAY,CAAA;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,eAAe,GAAG,CAC7B,IAAY,EACZ,MAAmB,EACN,EAAE;IACf,MAAM,KAAK,GAAgB,EAAE,CAAA;IAC7B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAE1B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,IAAI,gBAAgB,GAAG,IAAI,CAAA;IAC3B,IAAI,aAAa,GAAG,KAAK,CAAA;IAEzB;;;OAGG;IACH,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACtC,OAAO,KAAK,GAAG,KAAK,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBACzB,UAAU,EAAE,CAAA;gBACZ,YAAY,GAAG,CAAC,CAAA;YAClB,CAAC;iBAAM,CAAC;gBACN,YAAY,EAAE,CAAA;YAChB,CAAC;YACD,KAAK,EAAE,CAAA;QACT,CAAC;IACH,CAAC,CAAA;IAED,OAAO,KAAK,GAAG,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAExB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,UAAU,EAAE,CAAA;YACZ,YAAY,GAAG,CAAC,CAAA;YAChB,aAAa,GAAG,KAAK,CAAA;YACrB,KAAK,EAAE,CAAA;YACP,SAAQ;QACV,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnD,YAAY,EAAE,CAAA;YACd,KAAK,EAAE,CAAA;YACP,SAAQ;QACV,CAAC;QAED,wEAAwE;QACxE,6DAA6D;QAC7D,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,EAAE,CAAA;gBACd,KAAK,EAAE,CAAA;gBACP,SAAQ;YACV,CAAC;YACD,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC,CAAA;YACnB,OAAO,GAAG,GAAG,MAAM,EAAE,CAAC;gBACpB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;oBACtB,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;wBAC1B,GAAG,IAAI,CAAC,CAAA;wBACR,SAAQ;oBACV,CAAC;oBACD,GAAG,EAAE,CAAA;oBACL,MAAK;gBACP,CAAC;gBACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI;oBAAE,MAAK;gBAC7B,GAAG,EAAE,CAAA;YACP,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,CAAA;YACd,SAAQ;QACV,CAAC;QAED,uEAAuE;QACvE,0CAA0C;QAC1C,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,aAAa,GAAG,CAAC,aAAa,CAAA;YAC9B,YAAY,EAAE,CAAA;YACd,KAAK,EAAE,CAAA;YACP,SAAQ;QACV,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,gBAAgB,GAAG,IAAI,CAAA;gBACvB,YAAY,EAAE,CAAA;gBACd,KAAK,EAAE,CAAA;gBACP,SAAQ;YACV,CAAC;YAED,4BAA4B;YAC5B,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC5C,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC,CAAA;gBACnB,OAAO,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;oBACrE,GAAG,EAAE,CAAA;gBACP,CAAC;gBACD,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;gBACpC,SAAQ;YACV,CAAC;QACH,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,2BAA2B;YAC3B,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC5B,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC,CAAA;gBACnB,OAAO,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;oBAAE,GAAG,EAAE,CAAA;gBAC/C,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;gBACpC,SAAQ;YACV,CAAC;YAED,wEAAwE;YACxE,sEAAsE;YACtE,gCAAgC;YAChC,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;YACpE,IAAI,eAAe,EAAE,CAAC;gBACpB,IAAI,KAAK,GAAG,CAAC,CAAA;gBACb,IAAI,GAAG,GAAG,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;gBAC/C,OAAO,GAAG,GAAG,MAAM,EAAE,CAAC;oBACpB,IACE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;wBACjB,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,EAChD,CAAC;wBACD,GAAG,IAAI,CAAC,CAAA;wBACR,SAAQ;oBACV,CAAC;oBACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;wBAAE,KAAK,EAAE,CAAA;yBACzB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;wBAC3B,KAAK,EAAE,CAAA;wBACP,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;4BAChB,GAAG,EAAE,CAAA;4BACL,MAAK;wBACP,CAAC;oBACH,CAAC;oBACD,GAAG,EAAE,CAAA;gBACP,CAAC;gBACD,SAAS,CAAC,GAAG,CAAC,CAAA;gBACd,gBAAgB,GAAG,KAAK,CAAA;gBACxB,SAAQ;YACV,CAAC;YAED,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;YACxD,IAAI,SAAS,EAAE,CAAC;gBACd,8DAA8D;gBAC9D,IAAI,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC9C,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;wBAClB,UAAU;wBACV,iBAAiB,EAAE,YAAY;wBAC/B,eAAe,EAAE,YAAY,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM;qBACxD,CAAC,CAAA;gBACJ,CAAC;gBACD,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;gBACtC,gBAAgB,GAAG,KAAK,CAAA;gBACxB,SAAQ;YACV,CAAC;QACH,CAAC;QAED,IAAI,gBAAgB,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,uEAAuE;YACvE,iEAAiE;YACjE,sEAAsE;YACtE,eAAe;YACf,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;YACtE,IACE,iBAAiB;gBACjB,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EACjD,CAAC;gBACD,MAAM,SAAS,GAAG,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;gBACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAA;gBACtE,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CACxC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAC/B,CAAA;gBACD,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;gBACxE,gBAAgB,GAAG,IAAI,CAAA;gBACvB,SAAQ;YACV,CAAC;YAED,sEAAsE;YACtE,oEAAoE;YACpE,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;YAC5D,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAA;gBAC1D,IAAI,SAAS,GAAG,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;gBAC7C,IAAI,GAAG,GAAG,MAAM,CAAA;gBAChB,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;oBAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;oBAC7C,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;oBACnD,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;wBAC3D,GAAG,GAAG,SAAS,CAAA;wBACf,MAAK;oBACP,CAAC;oBACD,IAAI,OAAO,KAAK,CAAC,CAAC;wBAAE,MAAK;oBACzB,SAAS,GAAG,OAAO,GAAG,CAAC,CAAA;gBACzB,CAAC;gBACD,SAAS,CAAC,GAAG,CAAC,CAAA;gBACd,gBAAgB,GAAG,IAAI,CAAA;gBACvB,SAAQ;YACV,CAAC;YAED,sEAAsE;YACtE,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC,CAAA;gBACnB,OAAO,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;oBAAE,GAAG,EAAE,CAAA;gBAC/C,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;gBAClB,gBAAgB,GAAG,IAAI,CAAA;gBACvB,SAAQ;YACV,CAAC;QACH,CAAC;QAED,gBAAgB,GAAG,KAAK,CAAA;QACxB,YAAY,EAAE,CAAA;QACd,KAAK,EAAE,CAAA;IACT,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAxNY,QAAA,eAAe,mBAwN3B"}

package/utils/sasMacros.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The set of macro names that ship with SAS, lower-cased for comparison.
+ *
+ * The names are generated from the macroStatements and macroFunctions groups of
+ * `@sasjs/sas-language`, which owns the SAS language data - see
+ * `scripts/generate-macro-names.mjs`. A macro matching one of these names is
+ * treated as declared, so it is never reported by `noUndeclaredMacros` and
+ * never written to a file header by the formatter.
+ */
+export declare const sasMacros: Set<string>;
+/**
+ * Reports whether a macro name is one of the macros that ship with SAS.
+ * @param {string} name - the macro name to test.
+ * @returns {boolean} true when the name belongs to a SAS-provided macro.
+ */
+export declare const isSasMacro: (name: string) => boolean;

package/utils/sasMacros.generated.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The macro names that ship with SAS, lower-cased and without the leading
+ * `%`, as published in the macroStatements and macroFunctions groups of
+ * `@sasjs/sas-language`.
+ */
+export declare const sasMacros: readonly string[];

package/utils/sasMacros.generated.js

@@ -0,0 +1,136 @@
+"use strict";
+// Generated by scripts/generate-macro-names.mjs from @sasjs/sas-language.
+// Do not edit. Regenerate with `npm run generate:macros`.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sasMacros = void 0;
+/**
+ * The macro names that ship with SAS, lower-cased and without the leading
+ * `%`, as published in the macroStatements and macroFunctions groups of
+ * `@sasjs/sas-language`.
+ */
+exports.sasMacros = [
+    'abort',
+    'armconv',
+    'armend',
+    'armgtid',
+    'arminit',
+    'armjoin',
+    'armproc',
+    'armstop',
+    'armstrt',
+    'armupdt',
+    'bquote',
+    'by',
+    'cmpres',
+    'colormac',
+    'compstor',
+    'copy',
+    'datatyp',
+    'dequote',
+    'display',
+    'do',
+    'dqload',
+    'dqputloc',
+    'dqunload',
+    'else',
+    'end',
+    'eval',
+    'global',
+    'goto',
+    'helpclr',
+    'if',
+    'inc',
+    'include',
+    'index',
+    'indexc',
+    'indexw',
+    'input',
+    'kcmpres',
+    'kindex',
+    'kleft',
+    'klength',
+    'klowcase',
+    'kscan',
+    'ksubstr',
+    'ktrim',
+    'kupcase',
+    'kverify',
+    'left',
+    'length',
+    'let',
+    'list',
+    'local',
+    'lowcase',
+    'macro',
+    'mend',
+    'nrbquote',
+    'nrquote',
+    'nrstr',
+    'perfend',
+    'perfinit',
+    'perfstop',
+    'perfstrt',
+    'put',
+    'qbquote',
+    'qcmpres',
+    'qdequote',
+    'qindex',
+    'qindexc',
+    'qindexw',
+    'qkcmpres',
+    'qkleft',
+    'qklowcas',
+    'qklowcase',
+    'qkscan',
+    'qksubstr',
+    'qktrim',
+    'qkupcase',
+    'qleft',
+    'qlowcase',
+    'qscan',
+    'qsubstr',
+    'qsysfunc',
+    'qtrim',
+    'quote',
+    'qupcase',
+    'return',
+    'run',
+    'scan',
+    'str',
+    'substr',
+    'superq',
+    'symdel',
+    'symexist',
+    'symglobl',
+    'symlocal',
+    'syscall',
+    'sysevalf',
+    'sysexec',
+    'sysfunc',
+    'sysget',
+    'syslput',
+    'sysmacdelete',
+    'sysmacexec',
+    'sysmacexist',
+    'sysmexecdepth',
+    'sysmexecname',
+    'sysmstoreclear',
+    'sysprod',
+    'sysrc',
+    'sysrput',
+    'then',
+    'to',
+    'tplot',
+    'translate',
+    'tranwrd',
+    'trim',
+    'trimn',
+    'unquote',
+    'until',
+    'upcase',
+    'validchs',
+    'verify',
+    'while',
+    'window'
+];
+//# sourceMappingURL=sasMacros.generated.js.map

package/utils/sasMacros.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sasMacros.generated.js","sourceRoot":"","sources":["../../src/utils/sasMacros.generated.ts"],"names":[],"mappings":";AAAA,0EAA0E;AAC1E,0DAA0D;;;AAE1D;;;;GAIG;AACU,QAAA,SAAS,GAAsB;IAC1C,OAAO;IACP,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,QAAQ;IACR,IAAI;IACJ,QAAQ;IACR,UAAU;IACV,UAAU;IACV,MAAM;IACN,SAAS;IACT,SAAS;IACT,SAAS;IACT,IAAI;IACJ,QAAQ;IACR,UAAU;IACV,UAAU;IACV,MAAM;IACN,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM;IACN,SAAS;IACT,IAAI;IACJ,KAAK;IACL,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,SAAS;IACT,UAAU;IACV,OAAO;IACP,SAAS;IACT,OAAO;IACP,SAAS;IACT,SAAS;IACT,MAAM;IACN,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,SAAS;IACT,OAAO;IACP,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;IACP,SAAS;IACT,UAAU;IACV,UAAU;IACV,UAAU;IACV,KAAK;IACL,SAAS;IACT,SAAS;IACT,UAAU;IACV,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,QAAQ;IACR,UAAU;IACV,WAAW;IACX,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,UAAU;IACV,OAAO;IACP,UAAU;IACV,OAAO;IACP,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;IACP,SAAS;IACT,QAAQ;IACR,KAAK;IACL,MAAM;IACN,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,UAAU;IACV,UAAU;IACV,SAAS;IACT,UAAU;IACV,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,cAAc;IACd,YAAY;IACZ,aAAa;IACb,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,SAAS;IACT,OAAO;IACP,SAAS;IACT,MAAM;IACN,IAAI;IACJ,OAAO;IACP,WAAW;IACX,SAAS;IACT,MAAM;IACN,OAAO;IACP,SAAS;IACT,OAAO;IACP,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,OAAO;IACP,QAAQ;CACT,CAAA"}

package/utils/sasMacros.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSasMacro = exports.sasMacros = void 0;
+const sasMacros_generated_1 = require("./sasMacros.generated");
+/**
+ * The set of macro names that ship with SAS, lower-cased for comparison.
+ *
+ * The names are generated from the macroStatements and macroFunctions groups of
+ * `@sasjs/sas-language`, which owns the SAS language data - see
+ * `scripts/generate-macro-names.mjs`. A macro matching one of these names is
+ * treated as declared, so it is never reported by `noUndeclaredMacros` and
+ * never written to a file header by the formatter.
+ */
+exports.sasMacros = new Set(sasMacros_generated_1.sasMacros);
+/**
+ * Reports whether a macro name is one of the macros that ship with SAS.
+ * @param {string} name - the macro name to test.
+ * @returns {boolean} true when the name belongs to a SAS-provided macro.
+ */
+const isSasMacro = (name) => exports.sasMacros.has(name.toLowerCase());
+exports.isSasMacro = isSasMacro;
+//# sourceMappingURL=sasMacros.js.map

package/utils/sasMacros.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sasMacros.js","sourceRoot":"","sources":["../../src/utils/sasMacros.ts"],"names":[],"mappings":";;;AAAA,+DAA0D;AAE1D;;;;;;;;GAQG;AACU,QAAA,SAAS,GAAgB,IAAI,GAAG,CAAC,+BAAK,CAAC,CAAA;AAEpD;;;;GAIG;AACI,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE,CAClD,iBAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;AADtB,QAAA,UAAU,cACY"}