@komaci/static-analyzer 240.1.3

package/build/invariantFunctions/memberExpressionInvariantFunctions.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkForUnsupportedGlobalRef = exports.checkForNoUseOfSuper = exports.checkNoUsageOfDocumentOrWindow = exports.checkMemberExpressionForNonSupportedNamespaceRefs = exports.checkForNonExistentMemberRefs = exports.checkForNonSupportedMemberRefs = void 0;
+const t = __importStar(require("@babel/types"));
+const shared_1 = require("../shared");
+const common_shared_1 = require("@komaci/common-shared");
+const rules_1 = require("../rules");
+/**
+ * Invariant function for checking if a member expression references a non decorated member var.
+ * @param path the babel path object for the current member expressoin
+ * @param memberVars a set of approved member variable names.
+ * @returns undefined if the member expression does NOT reference an unsupported member var, PrimingDiagnostic object if an unsuppported
+ *          member variable is referenced
+ */
+function checkForNonSupportedMemberRefs(path, memberVars) {
+    const memberExprNode = path.node;
+    if (memberExprNode.object.type == 'ThisExpression') {
+        const memberExprProperty = memberExprNode.property;
+        if (memberVars.find((classPropInfo) => classPropInfo.classPropId === memberExprProperty.name &&
+            !classPropInfo.isDecorated &&
+            !classPropInfo.hasInitialValue &&
+            !t.isClassMethod(classPropInfo.classProp))) {
+            if (memberExprProperty.loc !== null) {
+                return (0, rules_1.getPrimingDiagnostic)(rules_1.diagnosticMessages.NO_UNSUPPORTED_MEMBER_VARIABLE_IN_MEMBER_EXPRESSION, shared_1.LLSRange.fromBabelSourceLocation(memberExprProperty.loc), [memberExprProperty.name]);
+            }
+        }
+    }
+    return undefined;
+}
+exports.checkForNonSupportedMemberRefs = checkForNonSupportedMemberRefs;
+/**
+ * Invariant function for checking if a member expression references a non-existent member property variable
+ * @param {NodePath<MemberExpression>} path babel/types path object representing the current member expression
+ * @param {string[]} memberVars an string[] of member variable names
+ * @param {Set<string>} thisAliases a Set of the aliases of `this` used. ex: in `let that = this;`, `that` would be an alias.
+ * @returns {(PrimingDiagnostic | undefined)} undefined if the member expression does NOT reference a non-existent member property variable. Returns a
+ *           PrimingDiagnostic object if a non-existent member property variable is referenced
+ */
+function checkForNonExistentMemberRefs(path, memberVars, thisAliases) {
+    const memberExprNode = path.node;
+    const memberExprProperty = memberExprNode.property;
+    const parentNode = path.parent;
+    if ((0, common_shared_1.isExpressionThisOrAlias)(thisAliases, memberExprNode.object) && // check that the MemberExpression starts with a `this.` or an equivalent alias
+        parentNode.type !== 'CallExpression' // check that this is not a part of a function call, which is already handled by invariant: `checkForNoReferenceToClassFunctions`
+    ) {
+        const memberExprValue = (0, common_shared_1.getFromIdentifierOrStringLiteral)(memberExprProperty);
+        if (!memberVars.find((classPropInfo) => classPropInfo.classPropId === memberExprValue)) {
+            const sourceLoc = memberExprProperty.loc;
+            if (sourceLoc !== null) {
+                return (0, rules_1.getPrimingDiagnostic)(rules_1.diagnosticMessages.NO_MEMBER_EXPRESSION_REFERENCE_TO_NON_EXISTENT_MEMBER_VARIABLE, shared_1.LLSRange.fromBabelSourceLocation(sourceLoc), [memberExprValue]);
+            }
+        }
+    }
+    return undefined;
+}
+exports.checkForNonExistentMemberRefs = checkForNonExistentMemberRefs;
+/**
+ * Invariant function to check if a member expression references an unsupported import.
+ * @param path the babel path object for the current member expression
+ * @param supportedImportRefs a set of supported import references.
+ * @returns undefined if a member expression does NOT reference an unsuppoerted import, PrimingDiagnostic object
+ *          if an unsupported import is reference.
+ */
+function checkMemberExpressionForNonSupportedNamespaceRefs(path, importReferences) {
+    const mememberExprNode = path.node;
+    const objectIdentifier = mememberExprNode.object;
+    if (importReferences.get(objectIdentifier.name)) {
+        if (!importReferences.get(objectIdentifier.name)?.isSupported) {
+            if (objectIdentifier.loc !== null) {
+                return (0, rules_1.getPrimingDiagnostic)(rules_1.diagnosticMessages.NO_MEMBER_EXPRESSION_REFERENCE_TO_UNSUPPORTED_NAMESPACE_REFERENCE, shared_1.LLSRange.fromBabelSourceLocation(objectIdentifier.loc), [objectIdentifier.name]);
+            }
+        }
+    }
+    return undefined;
+}
+exports.checkMemberExpressionForNonSupportedNamespaceRefs = checkMemberExpressionForNonSupportedNamespaceRefs;
+/**
+ * Validates whether a MemberExpression Node on the AST adheres to a portability invariant (whether it doesn't
+ * contain 'document', 'window' indentifiers within an expression).
+ * @param path NodePath<MemberExpression> containing a MemberExpression to analyze for invariants
+ * @returns PrimingDiagnostic of the MemberExpression if an invariant is detected, or undefined if none was found
+ */
+function checkNoUsageOfDocumentOrWindow(path) {
+    const memberExpr = path.node;
+    if (memberExpr.object.type === 'Identifier' &&
+        (memberExpr.object.name === 'window' || memberExpr.object.name === 'document')) {
+        if (memberExpr.loc !== null) {
+            return (0, rules_1.getPrimingDiagnostic)(rules_1.diagnosticMessages.NO_MEMBER_EXPRESSION_CONTAINS_NON_PORTABLE_IDENTIFIER, shared_1.LLSRange.fromBabelSourceLocation(memberExpr.loc), [memberExpr.object.name]);
+        }
+    }
+    return undefined;
+}
+exports.checkNoUsageOfDocumentOrWindow = checkNoUsageOfDocumentOrWindow;
+/**
+ * Invariant function to check weather a member expression contains a call to super.
+ * @param path the babel path object for the current member expressoin
+ * @returns undefined if the member expressoin does NOT contain a reference to a super var or function. Location object if there is a super reference.
+ */
+function checkForNoUseOfSuper(path) {
+    const memberExpr = path.node;
+    if (memberExpr.object.type === 'Super') {
+        if (memberExpr.loc !== null) {
+            return (0, rules_1.getPrimingDiagnostic)(rules_1.diagnosticMessages.NO_MEMBER_EXPRESSION_REFERENCE_TO_SUPER_CLASS, shared_1.LLSRange.fromBabelSourceLocation(memberExpr.loc), [memberExpr.property.name]);
+        }
+    }
+    return undefined;
+}
+exports.checkForNoUseOfSuper = checkForNoUseOfSuper;
+/**
+ * Function to check if there is an reference to an unsupported global reference.
+ * @param path the member expression path node
+ * @param astContext the ast context that holds meta data about the scr code.
+ * @returns a Priming Diagnostic if there is a global reference undefined if none
+ */
+function checkForUnsupportedGlobalRef(path, astContext, declaredGetterVars) {
+    const memberExpr = path.node;
+    const memberObj = memberExpr.object;
+    if (memberObj.type === 'Identifier' &&
+        !(0, common_shared_1.isDeclaredInAst)(astContext, declaredGetterVars, memberObj.name) &&
+        !common_shared_1.allowlistGlobals.globals.has(memberObj.name) &&
+        memberExpr.loc !== null) {
+        return (0, rules_1.getPrimingDiagnostic)(rules_1.diagnosticMessages.NO_MEMBER_EXPRESSION_REFERENCE_TO_UNSUPPORTED_GLOBAL, shared_1.LLSRange.fromBabelSourceLocation(memberExpr.loc), [memberObj.name]);
+    }
+    return undefined;
+}
+exports.checkForUnsupportedGlobalRef = checkForUnsupportedGlobalRef;
+//# sourceMappingURL=memberExpressionInvariantFunctions.js.map

package/build/invariantFunctions/returnStatementInvariantFunctions.d.ts

@@ -0,0 +1,12 @@
+import { NodePath } from '@babel/traverse';
+import * as t from '@babel/types';
+import { PrimingDiagnostic } from '../types';
+/**
+ * Invariant function for checking if an getter defined in an external module has only a
+ * statement in it, a return statement.
+ * @param blockStatement the babel path object for the BlockStatement representing the contents of the getter
+ * @param statements the babel path object array for all of the Statements in the getter
+ * @returns PrimingDiagnostic of the BlockStatement if the invariant is detected, or undefined if the invariant wasn't found
+ */
+export declare function checkExternalModuleGetterReturnStatement(blockStatement: NodePath<t.BlockStatement>, statements: NodePath<t.Statement>[]): PrimingDiagnostic | undefined;
+//# sourceMappingURL=returnStatementInvariantFunctions.d.ts.map

package/build/invariantFunctions/returnStatementInvariantFunctions.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkExternalModuleGetterReturnStatement = void 0;
+const shared_1 = require("../shared");
+const rules_1 = require("../rules");
+/**
+ * Invariant function for checking if an getter defined in an external module has only a
+ * statement in it, a return statement.
+ * @param blockStatement the babel path object for the BlockStatement representing the contents of the getter
+ * @param statements the babel path object array for all of the Statements in the getter
+ * @returns PrimingDiagnostic of the BlockStatement if the invariant is detected, or undefined if the invariant wasn't found
+ */
+function checkExternalModuleGetterReturnStatement(blockStatement, statements) {
+    // the getter doesn't only have a return method as expected. Skip traversal, then return from this method here
+    if (!(statements.length === 1 && statements[0].isReturnStatement())) {
+        if (blockStatement.node.loc) {
+            return (0, rules_1.getPrimingDiagnostic)(rules_1.diagnosticMessages.NO_GETTER_CONTAINS_MORE_THAN_RETURN_STATEMENT, shared_1.LLSRange.fromBabelSourceLocation(blockStatement.node.loc), []);
+        }
+    }
+    return undefined;
+}
+exports.checkExternalModuleGetterReturnStatement = checkExternalModuleGetterReturnStatement;
+//# sourceMappingURL=returnStatementInvariantFunctions.js.map

package/build/invariantFunctions/taggedTemplateExpressionInvariantFunctions.d.ts

@@ -0,0 +1,12 @@
+import { NodePath } from '@babel/traverse';
+import * as t from '@babel/types';
+import { ImportDeclarationInfo } from '@komaci/common-shared';
+import { PrimingDiagnostic } from '../types';
+/**
+ * Invariant function for checking if a tagged template expression contains a reference to an unsupported namespace.
+ * @param path the babel path object for the current TaggedTemplateExpression
+ * @param decoratedMemberVars a set of approved member variable names.
+ * @returns undefined if the member expressoin does NOT reference an unsupported member var, a location obj if an unsuppported namespace is referenced.
+ */
+export declare function checkTaggedTemplateExprForNonSupportedNamespaceRefs(path: NodePath<t.TaggedTemplateExpression>, importReferences: Map<string, ImportDeclarationInfo>): PrimingDiagnostic | undefined;
+//# sourceMappingURL=taggedTemplateExpressionInvariantFunctions.d.ts.map

package/build/invariantFunctions/taggedTemplateExpressionInvariantFunctions.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkTaggedTemplateExprForNonSupportedNamespaceRefs = void 0;
+const rules_1 = require("../rules");
+const shared_1 = require("../shared");
+/**
+ * Invariant function for checking if a tagged template expression contains a reference to an unsupported namespace.
+ * @param path the babel path object for the current TaggedTemplateExpression
+ * @param decoratedMemberVars a set of approved member variable names.
+ * @returns undefined if the member expressoin does NOT reference an unsupported member var, a location obj if an unsuppported namespace is referenced.
+ */
+function checkTaggedTemplateExprForNonSupportedNamespaceRefs(path, importReferences) {
+    const taggedTemplateExpr = path.node;
+    const identifier = taggedTemplateExpr.tag;
+    if (importReferences.has(identifier.name)) {
+        if (!importReferences.get(identifier.name)?.isSupported) {
+            if (identifier.loc !== null) {
+                return (0, rules_1.getPrimingDiagnostic)(rules_1.diagnosticMessages.NO_TAGGED_TEMPLATE_EXPRESSION_CONTAINS_UNSUPPORTED_NAMESPACE, shared_1.LLSRange.fromBabelSourceLocation(identifier.loc), [identifier.name]);
+            }
+        }
+    }
+    return undefined;
+}
+exports.checkTaggedTemplateExprForNonSupportedNamespaceRefs = checkTaggedTemplateExprForNonSupportedNamespaceRefs;
+//# sourceMappingURL=taggedTemplateExpressionInvariantFunctions.js.map

package/build/komaci-mapping.json

@@ -0,0 +1,288 @@
+{
+    "lightning/uiRecordActionsApi": {
+        "getRecordActions": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRecordActionsApi",
+                "identifier": "unstable_getRecordActions_imperative"
+            }
+        },
+        "getRelatedListsActions": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRecordActionsApi",
+                "identifier": "unstable_getRelatedListsActions_imperative"
+            }
+        },
+        "getRelatedListActions": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRecordActionsApi",
+                "identifier": "unstable_getRelatedListActions_imperative"
+            },
+            "batch": {
+                "prime": {
+                    "importPath": "lightning/unstable_uiRecordActionsApi",
+                    "identifier": "unstable_getRelatedListsActions_imperative"
+                },
+                "reducer": {
+                    "importPath": "laf/batchingPortable",
+                    "identifier": "RelatedListActionsBatchReducer"
+                }
+            }
+        }
+    },
+    "lightning/uiLayoutApi": {
+        "getLayout": {
+            "prime": {
+                "importPath": "lightning/unstable_uiLayoutApi",
+                "identifier": "unstable_getLayout_imperative"
+            }
+        },
+        "getLayoutUserState": {
+            "prime": {
+                "importPath": "lightning/unstable_uiLayoutApi",
+                "identifier": "unstable_getLayoutUserState_imperative"
+            }
+        }
+    },
+    "lightning/uiListsApi": {
+        "getListInfoByName": {
+            "prime": {
+                "importPath": "lightning/unstable_uiListsApi",
+                "identifier": "unstable_getListInfoByName_imperative"
+            }
+        }
+    },
+    "lightning/uiAppsApi": {
+        "getNavItems": {
+            "prime": {
+                "importPath": "lightning/unstable_uiAppsApi",
+                "identifier": "unstable_getNavItems_imperative"
+            }
+        }
+    },
+    "lightning/uiObjectInfoApi": {
+        "getObjectInfos": {
+            "prime": {
+                "importPath": "lightning/unstable_uiObjectInfoApi",
+                "identifier": "unstable_getObjectInfos_imperative"
+            },
+            "batch": {
+                "prime": {
+                    "importPath": "lightning/unstable_uiObjectInfoApi",
+                    "identifier": "unstable_getObjectInfos_imperative"
+                },
+                "reducer": {
+                    "importPath": "laf/batchingPortable",
+                    "identifier": "ObjectInfosBatchReducer"
+                }
+            }
+        },
+        "getObjectInfo": {
+            "prime": {
+                "importPath": "lightning/unstable_uiObjectInfoApi",
+                "identifier": "unstable_getObjectInfo_imperative"
+            },
+            "batch": {
+                "prime": {
+                    "importPath": "lightning/unstable_uiObjectInfoApi",
+                    "identifier": "unstable_getObjectInfos_imperative"
+                },
+                "reducer": {
+                    "importPath": "laf/batchingPortable",
+                    "identifier": "ObjectInfoBatchReducer"
+                }
+            }
+        },
+        "getPicklistValuesByRecordType": {
+            "prime": {
+                "importPath": "lightning/unstable_uiObjectInfoApi",
+                "identifier": "unstable_getPicklistValuesByRecordType_imperative"
+            }
+        },
+        "getPicklistValues": {
+            "prime": {
+                "importPath": "lightning/unstable_uiObjectInfoApi",
+                "identifier": "unstable_getPicklistValues_imperative"
+            }
+        }
+    },
+    "lightning/uiRecordAvatarApi": {
+        "getRecordAvatars": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRecordAvatarApi",
+                "identifier": "unstable_getRecordAvatars_imperative"
+            },
+            "batch": {
+                "prime": {
+                    "importPath": "lightning/unstable_uiRecordAvatarApi",
+                    "identifier": "unstable_getRecordAvatars_imperative"
+                },
+                "reducer": {
+                    "importPath": "laf/batchingPortable",
+                    "identifier": "RecordAvatarBatchReducer"
+                }
+            }
+        }
+    },
+    "lightning/uiRecordApi": {
+        "getRecordCreateDefaults": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRecordApi",
+                "identifier": "unstable_getRecordCreateDefaults_imperative"
+            }
+        },
+        "getRecordUi": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRecordApi",
+                "identifier": "unstable_getRecordUi_imperative"
+            }
+        },
+        "getRecords": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRecordApi",
+                "identifier": "unstable_getRecords_imperative"
+            }
+        },
+        "getRecord": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRecordApi",
+                "identifier": "unstable_getRecord_imperative"
+            },
+            "batch": {
+                "prime": {
+                    "importPath": "lightning/unstable_uiRecordApi",
+                    "identifier": "unstable_getRecords_imperative"
+                },
+                "reducer": {
+                    "importPath": "laf/batchingPortable",
+                    "identifier": "GetRecordBatchReducer"
+                }
+            }
+        }
+    },
+    "lightning/uiRelatedListApi": {
+        "getRelatedListsCount": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListsCount_imperative"
+            }
+        },
+        "getRelatedListCount": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListCount_imperative"
+            }
+        },
+        "getRelatedListInfoBatch": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListInfoBatch_imperative"
+            }
+        },
+        "getRelatedListsInfo": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListsInfo_imperative"
+            }
+        },
+        "getRelatedListInfo": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListInfo_imperative"
+            },
+            "batch": {
+                "prime": {
+                    "importPath": "lightning/unstable_uiRelatedListApi",
+                    "identifier": "unstable_getRelatedListInfoBatch_imperative"
+                },
+                "reducer": {
+                    "importPath": "laf/batchingPortable",
+                    "identifier": "RelatedListInfoBatchReducer"
+                }
+            }
+        },
+        "getRelatedListRecordsBatch": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListRecordsBatch_imperative"
+            }
+        },
+        "getRelatedListRecords": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListRecords_imperative"
+            },
+            "batch": {
+                "prime": {
+                    "importPath": "lightning/unstable_uiRelatedListApi",
+                    "identifier": "unstable_getRelatedListRecordsBatch_imperative"
+                },
+                "reducer": {
+                    "importPath": "laf/batchingPortable",
+                    "identifier": "RelatedListRecordsBatchReducer"
+                }
+            }
+        }
+    },
+    "lightning/unstable_uiRelatedListApi": {
+        "unstable_getRelatedListInfoBatch": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListInfoBatch_imperative"
+            }
+        },
+        "unstable_getRelatedListRecordsBatch": {
+            "prime": {
+                "importPath": "lightning/unstable_uiRelatedListApi",
+                "identifier": "unstable_getRelatedListRecordsBatch_imperative"
+            }
+        }
+    },
+    "lightning/uiSearchApi": {
+        "getSearchFilterOptions": {
+            "prime": {
+                "importPath": "lightning/unstable_uiSearchApi",
+                "identifier": "unstable_getSearchFilterOptions_imperative"
+            }
+        },
+        "getSearchResults": {
+            "prime": {
+                "importPath": "lightning/unstable_uiSearchApi",
+                "identifier": "unstable_getSearchResults_imperative"
+            }
+        },
+        "getKeywordSearchResults": {
+            "prime": {
+                "importPath": "lightning/unstable_uiSearchApi",
+                "identifier": "unstable_getKeywordSearchResults_imperative"
+            }
+        }
+    },
+    "lightning/unstable_uiSearchApi": {
+        "unstable_getSearchFilterOptions": {
+            "prime": {
+                "importPath": "lightning/unstable_uiSearchApi",
+                "identifier": "unstable_getSearchFilterOptions_imperative"
+            }
+        },
+        "unstable_getSearchResults": {
+            "prime": {
+                "importPath": "lightning/unstable_uiSearchApi",
+                "identifier": "unstable_getSearchResults_imperative"
+            }
+        },
+        "unstable_getKeywordSearchResults": {
+            "prime": {
+                "importPath": "lightning/unstable_uiSearchApi",
+                "identifier": "unstable_getKeywordSearchResults_imperative"
+            }
+        }
+    },
+    "lightning/unstable_uiGraphQLApi": {
+        "graphQL": {
+            "prime": {
+                "importPath": "lightning/unstable_uiGraphQLApi",
+                "identifier": "unstable_graphQL_imperative"
+            }
+        }
+    }
+}

package/build/rules.d.ts

@@ -0,0 +1,22 @@
+import { DiagnosticMessage, PrimingDiagnostic, Range } from './types';
+/**
+ * Returns the processed PrimingDiagnostic for a given DianosticMessage message key. If {args} are passed in, they will be substituted into
+ * the message string in the order of the array. If a {filename} is passed in, a {Uri} will be generated that will be included in the DiagnosticMessage
+ * in the format expected by the VSCode language server
+ * @param {DiagnosticMessage} diagnosticMessage the unprocessed diagnostic message (the caller of this method looks up the message with a key)
+ * @param {Range} range the line numbers and column numbers for the starting and endline line and starting and ending columns of the cause of the diagnostic
+ * message in the code, respectively.
+ * @param {Array<string>} args arguments to substitute into the message string
+ * @returns a new, processed instance of PrimingDiagnostic (with arguments substituted in, and Uri set) which is compatible with the VSCode language server
+ */
+export declare function getPrimingDiagnostic(diagnosticMessage: DiagnosticMessage, range: Range, args?: string[]): PrimingDiagnostic;
+/**
+ * This method augments the PrimingDiagnostic with filename information. It augments the
+ * object by reference and does not return a modified object.
+ * @param {PrimingDiagnostic} primingDiagnostic The PrimingDiagnostic that needs to be augmented with filename informations
+ * @param {string | undefined} filename The name of the file that the PrimingDiagnostic is for
+ * @returns {PrimingDiagnostic} a PrimingDiagnostic (this is optional to use)
+ */
+export declare function updatePrimingDiagnosticWithFileInfo(primingDiagnostic: PrimingDiagnostic, filename: string | undefined): PrimingDiagnostic;
+export declare const diagnosticMessages: Record<string, DiagnosticMessage>;
+//# sourceMappingURL=rules.d.ts.map