.gitignore added
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / eslint / lib / rules / no-inner-declarations.js
diff --git a/.config/coc/extensions/node_modules/coc-prettier/node_modules/eslint/lib/rules/no-inner-declarations.js b/.config/coc/extensions/node_modules/coc-prettier/node_modules/eslint/lib/rules/no-inner-declarations.js
new file mode 100644 (file)
index 0000000..0768bc6
--- /dev/null
@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Rule to enforce declarations in program or function body root.
+ * @author Brandon Mills
+ */
+
+"use strict";
+
+//------------------------------------------------------------------------------
+// Requirements
+//------------------------------------------------------------------------------
+
+const astUtils = require("./utils/ast-utils");
+
+//------------------------------------------------------------------------------
+// Rule Definition
+//------------------------------------------------------------------------------
+
+const validParent = new Set(["Program", "ExportNamedDeclaration", "ExportDefaultDeclaration"]);
+const validBlockStatementParent = new Set(["FunctionDeclaration", "FunctionExpression", "ArrowFunctionExpression"]);
+
+module.exports = {
+    meta: {
+        type: "problem",
+
+        docs: {
+            description: "disallow variable or `function` declarations in nested blocks",
+            category: "Possible Errors",
+            recommended: true,
+            url: "https://eslint.org/docs/rules/no-inner-declarations"
+        },
+
+        schema: [
+            {
+                enum: ["functions", "both"]
+            }
+        ],
+
+        messages: {
+            moveDeclToRoot: "Move {{type}} declaration to {{body}} root."
+        }
+    },
+
+    create(context) {
+
+        /**
+         * Ensure that a given node is at a program or function body's root.
+         * @param {ASTNode} node Declaration node to check.
+         * @returns {void}
+         */
+        function check(node) {
+            const parent = node.parent;
+
+            if (
+                parent.type === "BlockStatement" && validBlockStatementParent.has(parent.parent.type)
+            ) {
+                return;
+            }
+
+            if (validParent.has(parent.type)) {
+                return;
+            }
+
+            const upperFunction = astUtils.getUpperFunction(parent);
+
+            context.report({
+                node,
+                messageId: "moveDeclToRoot",
+                data: {
+                    type: (node.type === "FunctionDeclaration" ? "function" : "variable"),
+                    body: (upperFunction === null ? "program" : "function body")
+                }
+            });
+        }
+
+
+        return {
+
+            FunctionDeclaration: check,
+            VariableDeclaration(node) {
+                if (context.options[0] === "both" && node.kind === "var") {
+                    check(node);
+                }
+            }
+
+        };
+
+    }
+};