@pobammer-ts/eslint-cease-nonsense-rules 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 HowManySmall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# eslint-cease-nonsense-rules
+
+A bunch of lints to prevent idiot mistakes I encounter with frequency.
+
+Note: You said to create a README now; if you'd like a different structure or badges, say so and I’ll update it.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import type { Linter, Rule } from "eslint";
+interface Plugin {
+    readonly rules: Readonly<Record<string, Rule.RuleModule>>;
+    readonly configs: Readonly<{
+        readonly recommended: Linter.Config;
+    }>;
+}
+declare const plugin: Plugin;
+export default plugin;

package/dist/index.js

@@ -0,0 +1,56 @@
+import enforceIanitorCheckType from "./rules/enforce-ianitor-check-type";
+import noColor3Constructor from "./rules/no-color3-constructor";
+import noPrint from "./rules/no-print";
+import noShorthandNames from "./rules/no-shorthand-names";
+import noWarn from "./rules/no-warn";
+import requireReactComponentKeys from "./rules/require-react-component-keys";
+/**
+ * ESLint plugin entry for eslint-cease-nonsense-rules.
+ *
+ * Exposes rule implementations and configuration presets for ESLint flat config.
+ */
+const rules = {
+    "enforce-ianitor-check-type": enforceIanitorCheckType,
+    "no-color3-constructor": noColor3Constructor,
+    "no-print": noPrint,
+    "no-shorthand-names": noShorthandNames,
+    "no-warn": noWarn,
+    "require-react-component-keys": requireReactComponentKeys,
+};
+/**
+ * Recommended configuration for ESLint flat config.
+ *
+ * Enables all rules with recommended settings. Users should import this
+ * configuration and add it to their flat config array.
+ *
+ * @example
+ * ```typescript
+ * import ceaseNonsense from '@pobammer-ts/eslint-cease-nonsense-rules';
+ *
+ * export default [
+ *   ceaseNonsense.configs.recommended,
+ *   // ... other configs
+ * ];
+ * ```
+ */
+const recommended = {
+    plugins: {
+        "cease-nonsense": {
+            rules,
+        },
+    },
+    rules: {
+        "cease-nonsense/enforce-ianitor-check-type": "error",
+        "cease-nonsense/no-color3-constructor": "error",
+        "cease-nonsense/no-print": "error",
+        "cease-nonsense/no-shorthand-names": "error",
+        "cease-nonsense/no-warn": "error",
+        "cease-nonsense/require-react-component-keys": "error",
+    },
+};
+const plugin = {
+    configs: { recommended },
+    rules,
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,uBAAuB,MAAM,oCAAoC,CAAC;AACzE,OAAO,mBAAmB,MAAM,+BAA+B,CAAC;AAChE,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,gBAAgB,MAAM,4BAA4B,CAAC;AAC1D,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,yBAAyB,MAAM,sCAAsC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,KAAK,GAA8C;IACxD,4BAA4B,EAAE,uBAAuB;IACrD,uBAAuB,EAAE,mBAAmB;IAC5C,UAAU,EAAE,OAAO;IACnB,oBAAoB,EAAE,gBAAgB;IACtC,SAAS,EAAE,MAAM;IACjB,8BAA8B,EAAE,yBAAyB;CAChD,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,GAAkB;IAClC,OAAO,EAAE;QACR,gBAAgB,EAAE;YACjB,KAAK;SACL;KACD;IACD,KAAK,EAAE;QACN,2CAA2C,EAAE,OAAO;QACpD,sCAAsC,EAAE,OAAO;QAC/C,yBAAyB,EAAE,OAAO;QAClC,mCAAmC,EAAE,OAAO;QAC5C,wBAAwB,EAAE,OAAO;QACjC,6CAA6C,EAAE,OAAO;KACtD;CACQ,CAAC;AASX,MAAM,MAAM,GAAW;IACtB,OAAO,EAAE,EAAE,WAAW,EAAE;IACxB,KAAK;CACI,CAAC;AAEX,eAAe,MAAM,CAAC"}

package/dist/rules/enforce-ianitor-check-type.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "eslint";
+declare const enforceIanitorCheckType: Rule.RuleModule;
+export default enforceIanitorCheckType;

package/dist/rules/enforce-ianitor-check-type.js

@@ -0,0 +1,331 @@
+/**
+ * Default configuration values for the rule.
+ */
+const DEFAULT_CONFIG = {
+    baseThreshold: 10,
+    errorThreshold: 25,
+    interfacePenalty: 20,
+    performanceMode: true,
+    warnThreshold: 15,
+};
+/**
+ * Checks if a node has a type annotation.
+ *
+ * @param node - The node to check.
+ * @returns True if the node has a type annotation.
+ */
+function hasTypeAnnotation(node) {
+    const nodeObj = node;
+    if (nodeObj.type === "VariableDeclarator") {
+        const id = nodeObj.id;
+        return !!(id && "typeAnnotation" in id && id.typeAnnotation);
+    }
+    if (nodeObj.type === "FunctionDeclaration" || nodeObj.type === "FunctionExpression")
+        return !!nodeObj.returnType;
+    return false;
+}
+/**
+ * Extracts the type name from a TypeScript type node.
+ *
+ * @param node - The TypeScript AST node.
+ * @returns The type name or null if not applicable.
+ */
+function getTypeName(node) {
+    if (node.type === "TSInterfaceDeclaration")
+        return node.id.name;
+    if (node.type === "TSTypeAliasDeclaration")
+        return node.id.name;
+    return null;
+}
+/**
+ * Checks if a node is an Ianitor validator call.
+ *
+ * @param node - The node to check.
+ * @returns True if the node is an Ianitor validator.
+ */
+function isIanitorValidator(node) {
+    if (node.type !== "CallExpression")
+        return false;
+    const callee = node.callee;
+    if (callee && callee.type === "MemberExpression") {
+        const object = callee.object;
+        if (object && object.type === "Identifier" && object.name === "Ianitor")
+            return true;
+    }
+    return false;
+}
+/**
+ * Calculates the complexity score of an Ianitor validator.
+ *
+ * @param node - The Ianitor validator node.
+ * @returns The complexity score.
+ */
+function calculateIanitorComplexity(node) {
+    const callNode = node;
+    const callee = callNode.callee;
+    let score = 0;
+    if (callee?.type === "MemberExpression" && callee.property && callee.property.type === "Identifier") {
+        const method = callee.property.name;
+        switch (method) {
+            case "interface":
+            case "strictInterface": {
+                const props = callNode.arguments?.[0];
+                // Skip recursive property calculation for now to avoid type issues
+                if (props && props.type === "ObjectExpression")
+                    score = 10 + (props.properties?.length || 0) * 3;
+                break;
+            }
+            case "optional":
+            case "array":
+                score = 2;
+                break;
+            case "record":
+            case "map":
+                score = 3;
+                break;
+            case "union":
+            case "intersection":
+                score = (callNode.arguments?.length || 0) * 2;
+                break;
+            case "string":
+            case "number":
+            case "boolean":
+                score = 1;
+                break;
+            case "instanceIsA":
+            case "instanceOf":
+                score = 2;
+                break;
+            default:
+                score = 1;
+        }
+    }
+    return score;
+}
+const enforceIanitorCheckType = {
+    /**
+     * Creates the ESLint rule visitor.
+     *
+     * @param context - The ESLint rule context.
+     * @returns The visitor object with AST node handlers.
+     */
+    create(context) {
+        const config = { ...DEFAULT_CONFIG, ...context.options[0] };
+        const cache = {
+            nodeCache: new WeakMap(),
+            visitedNodes: new WeakSet(),
+        };
+        /**
+         * Calculates the structural complexity of a TypeScript type.
+         *
+         * @param node - The TypeScript AST node.
+         * @param depth - The current depth in the type tree.
+         * @returns The complexity score.
+         */
+        function calculateStructuralComplexity(node, depth = 0) {
+            // Performance: Cache everything
+            if (cache.nodeCache.has(node))
+                return cache.nodeCache.get(node);
+            // Cycle detection without TypeChecker
+            if (cache.visitedNodes.has(node))
+                return 50;
+            cache.visitedNodes.add(node);
+            let score = 0;
+            switch (node.type) {
+                // Primitives
+                case "TSStringKeyword":
+                case "TSNumberKeyword":
+                case "TSBooleanKeyword":
+                case "TSNullKeyword":
+                case "TSUndefinedKeyword":
+                case "TSVoidKeyword":
+                case "TSSymbolKeyword":
+                case "TSBigIntKeyword":
+                    score = 1;
+                    break;
+                // Short-circuits
+                case "TSNeverKeyword":
+                case "TSUnknownKeyword":
+                case "TSAnyKeyword":
+                    score = 0;
+                    break;
+                // INTERFACES - ALWAYS COMPLEX
+                case "TSInterfaceDeclaration": {
+                    const iface = node;
+                    score = config.interfacePenalty; // Base penalty
+                    // Add for extends
+                    if (iface.extends && iface.extends.length > 0)
+                        score += iface.extends.length * 5;
+                    // Add for members
+                    score += iface.body.body.length * 2;
+                    // Recurse on member types
+                    for (const member of iface.body.body)
+                        if ("typeAnnotation" in member && member.typeAnnotation)
+                            score += calculateStructuralComplexity(member.typeAnnotation.typeAnnotation, depth + 1);
+                    break;
+                }
+                // Type literals (object types)
+                case "TSTypeLiteral": {
+                    const literal = node;
+                    score = 2;
+                    score += literal.members.length * 0.5;
+                    for (const member of literal.members)
+                        if ("typeAnnotation" in member && member.typeAnnotation)
+                            score += calculateStructuralComplexity(member.typeAnnotation.typeAnnotation, depth + 1);
+                    break;
+                }
+                // Unions
+                case "TSUnionType": {
+                    const union = node;
+                    for (const type of union.types)
+                        score += calculateStructuralComplexity(type, depth + 1);
+                    score += 2 * (union.types.length - 1); // Branch penalty
+                    break;
+                }
+                // Intersections
+                case "TSIntersectionType": {
+                    const intersection = node;
+                    for (const type of intersection.types) {
+                        score += calculateStructuralComplexity(type, depth + 1);
+                    }
+                    score += 3 * intersection.types.length; // Overlap resolution penalty
+                    break;
+                }
+                // Arrays
+                case "TSArrayType": {
+                    const array = node;
+                    score = calculateStructuralComplexity(array.elementType, depth + 1) + 1;
+                    break;
+                }
+                // Tuples
+                case "TSTupleType": {
+                    const tuple = node;
+                    score = 1;
+                    for (const element of tuple.elementTypes)
+                        if (element.type !== "TSRestType" && element.type !== "TSOptionalType")
+                            score += calculateStructuralComplexity(element, depth + 1);
+                    score += 1.5 * tuple.elementTypes.length;
+                    break;
+                }
+                // Type references (including generics)
+                case "TSTypeReference": {
+                    const ref = node;
+                    score = 2;
+                    if (ref.typeArguments)
+                        for (const param of ref.typeArguments.params)
+                            score += calculateStructuralComplexity(param, depth + 1) + 2;
+                    break;
+                }
+                // Conditional types
+                case "TSConditionalType": {
+                    const conditional = node;
+                    score = 3;
+                    score += calculateStructuralComplexity(conditional.checkType, depth + 1);
+                    score += calculateStructuralComplexity(conditional.extendsType, depth + 1);
+                    score += calculateStructuralComplexity(conditional.trueType, depth + 1);
+                    score += calculateStructuralComplexity(conditional.falseType, depth + 1);
+                    break;
+                }
+                // Mapped types
+                case "TSMappedType": {
+                    const mapped = node;
+                    score = 5;
+                    if (mapped.typeParameter?.constraint)
+                        score += calculateStructuralComplexity(mapped.typeParameter.constraint, depth + 1);
+                    if (mapped.typeAnnotation)
+                        score += calculateStructuralComplexity(mapped.typeAnnotation, depth + 1);
+                    break;
+                }
+                // Function types
+                case "TSFunctionType":
+                case "TSMethodSignature": {
+                    const func = node;
+                    score = 2;
+                    for (const param of func.params)
+                        if ("typeAnnotation" in param && param.typeAnnotation)
+                            score += calculateStructuralComplexity(param.typeAnnotation.typeAnnotation, depth + 1);
+                    if (func.returnType)
+                        score += calculateStructuralComplexity(func.returnType.typeAnnotation, depth + 1);
+                    break;
+                }
+                default:
+                    score = 1;
+            }
+            // Apply depth multiplier (logarithmic to prevent explosion)
+            score *= Math.log2(depth + 1);
+            // Cache and return
+            cache.nodeCache.set(node, score);
+            cache.visitedNodes.delete(node);
+            return score;
+        }
+        return {
+            // Check interface declarations
+            TSInterfaceDeclaration(node) {
+                const complexity = calculateStructuralComplexity(node);
+                const name = getTypeName(node);
+                if (complexity >= config.interfacePenalty) {
+                    context.report({
+                        data: { name: name || "unknown" },
+                        messageId: "complexInterfaceNeedsCheck",
+                        node,
+                    });
+                }
+            },
+            // Check type alias declarations
+            TSTypeAliasDeclaration(node) {
+                const complexity = calculateStructuralComplexity(node.typeAnnotation);
+                if (complexity < config.baseThreshold)
+                    return;
+                context.report({
+                    data: { score: complexity.toFixed(1) },
+                    messageId: "missingIanitorCheckType",
+                    node,
+                });
+            },
+            // Check variable declarations with Ianitor validators
+            VariableDeclarator(node) {
+                if (!node.init || node.init.type !== "CallExpression")
+                    return;
+                if (!isIanitorValidator(node.init))
+                    return;
+                if (hasTypeAnnotation(node))
+                    return;
+                const complexity = calculateIanitorComplexity(node.init);
+                if (complexity < config.baseThreshold)
+                    return;
+                context.report({
+                    data: { score: complexity.toFixed(1) },
+                    messageId: "missingIanitorCheckType",
+                    node,
+                });
+            },
+        };
+    },
+    meta: {
+        docs: {
+            description: "Enforce Ianitor.Check<T> type annotations on complex TypeScript types",
+            recommended: false,
+        },
+        fixable: undefined,
+        messages: {
+            complexInterfaceNeedsCheck: "Interface '{{name}}' requires Ianitor.Check<T> annotation (interfaces always need explicit checking)",
+            missingIanitorCheckType: "Complex type (score: {{score}}) requires Ianitor.Check<T> annotation for type safety",
+        },
+        schema: [
+            {
+                additionalProperties: false,
+                properties: {
+                    baseThreshold: { minimum: 1, type: "number" },
+                    errorThreshold: { minimum: 1, type: "number" },
+                    interfacePenalty: { minimum: 1, type: "number" },
+                    performanceMode: { type: "boolean" },
+                    warnThreshold: { minimum: 1, type: "number" },
+                },
+                type: "object",
+            },
+        ],
+        type: "problem",
+    },
+};
+export default enforceIanitorCheckType;
+//# sourceMappingURL=enforce-ianitor-check-type.js.map

package/dist/rules/enforce-ianitor-check-type.js.map

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

package/dist/rules/no-color3-constructor.d.ts

@@ -0,0 +1,20 @@
+import type { Rule } from "eslint";
+/**
+ * Bans use of `new Color3(...)` except for `new Color3()` or `new Color3(0, 0, 0)`.
+ *
+ * The `new Color3()` constructor uses float values [0-1] and performs worse than
+ * `Color3.fromRGB()` which uses integer values [0-255].
+ *
+ * @example
+ * // ❌ Reports
+ * new Color3(255, 128, 64);
+ * new Color3(0.5);
+ * new Color3(1, 0);
+ *
+ * // ✅ OK
+ * new Color3();
+ * new Color3(0, 0, 0);
+ * Color3.fromRGB(255, 128, 64);
+ */
+declare const noColor3Constructor: Rule.RuleModule;
+export default noColor3Constructor;

package/dist/rules/no-color3-constructor.js

@@ -0,0 +1,69 @@
+/**
+ * Bans use of `new Color3(...)` except for `new Color3()` or `new Color3(0, 0, 0)`.
+ *
+ * The `new Color3()` constructor uses float values [0-1] and performs worse than
+ * `Color3.fromRGB()` which uses integer values [0-255].
+ *
+ * @example
+ * // ❌ Reports
+ * new Color3(255, 128, 64);
+ * new Color3(0.5);
+ * new Color3(1, 0);
+ *
+ * // ✅ OK
+ * new Color3();
+ * new Color3(0, 0, 0);
+ * Color3.fromRGB(255, 128, 64);
+ */
+const noColor3Constructor = {
+    /**
+     * Creates the ESLint rule visitor.
+     *
+     * @param context - The ESLint rule context.
+     * @returns The visitor object with AST node handlers.
+     */
+    create(context) {
+        return {
+            NewExpression(node) {
+                if (node.callee.type !== "Identifier" || node.callee.name !== "Color3")
+                    return;
+                const args = node.arguments;
+                // No arguments is allowed: new Color3()
+                if (args.length === 0)
+                    return;
+                // 1 or 2 arguments - always flag
+                if (args.length === 1 || args.length === 2) {
+                    context.report({
+                        messageId: "useFromRGB",
+                        node,
+                    });
+                    return;
+                }
+                // 3 arguments - only allow if all are literal 0
+                if (args.length === 3) {
+                    const allZero = args.every((arg) => arg.type === "Literal" && arg.value === 0);
+                    if (!allZero) {
+                        context.report({
+                            messageId: "onlyZeroArgs",
+                            node,
+                        });
+                    }
+                }
+            },
+        };
+    },
+    meta: {
+        docs: {
+            description: "Ban new Color3(...) except new Color3() or new Color3(0, 0, 0). Use Color3.fromRGB() instead.",
+            recommended: false,
+        },
+        messages: {
+            onlyZeroArgs: "Use Color3.fromRGB() instead of new Color3(). new Color3() uses floats [0-1] and performs worse than Color3.fromRGB() which uses [0-255]. Only 'new Color3()' or 'new Color3(0, 0, 0)' are allowed.",
+            useFromRGB: "Use Color3.fromRGB() instead of new Color3(). new Color3() uses floats [0-1] and performs worse than Color3.fromRGB() which uses [0-255].",
+        },
+        schema: [],
+        type: "problem",
+    },
+};
+export default noColor3Constructor;
+//# sourceMappingURL=no-color3-constructor.js.map

package/dist/rules/no-color3-constructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-color3-constructor.js","sourceRoot":"","sources":["../../src/rules/no-color3-constructor.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,mBAAmB,GAAoB;IAC5C;;;;;OAKG;IACH,MAAM,CAAC,OAAO;QACb,OAAO;YACN,aAAa,CAAC,IAAI;gBACjB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO;gBAE/E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;gBAE5B,wCAAwC;gBACxC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAE9B,iCAAiC;gBACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5C,OAAO,CAAC,MAAM,CAAC;wBACd,SAAS,EAAE,YAAY;wBACvB,IAAI;qBACJ,CAAC,CAAC;oBACH,OAAO;gBACR,CAAC;gBAED,gDAAgD;gBAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;oBAE/E,IAAI,CAAC,OAAO,EAAE,CAAC;wBACd,OAAO,CAAC,MAAM,CAAC;4BACd,SAAS,EAAE,cAAc;4BACzB,IAAI;yBACJ,CAAC,CAAC;oBACJ,CAAC;gBACF,CAAC;YACF,CAAC;SACD,CAAC;IACH,CAAC;IACD,IAAI,EAAE;QACL,IAAI,EAAE;YACL,WAAW,EACV,+FAA+F;YAChG,WAAW,EAAE,KAAK;SAClB;QACD,QAAQ,EAAE;YACT,YAAY,EACX,qMAAqM;YACtM,UAAU,EACT,2IAA2I;SAC5I;QACD,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,SAAS;KACf;CACD,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/rules/no-print.d.ts

@@ -0,0 +1,18 @@
+import type { Rule } from "eslint";
+/**
+ * Bans use of `print()` function calls. Use `Log` instead.
+ *
+ * The `print()` function is deprecated or discouraged in favor of a proper
+ * logging system like `Log`.
+ *
+ * @example
+ * // ❌ Reports
+ * print("Hello");
+ * print(value);
+ *
+ * // ✅ OK
+ * Log.info("Hello");
+ * Log.debug(value);
+ */
+declare const noPrint: Rule.RuleModule;
+export default noPrint;

package/dist/rules/no-print.js

@@ -0,0 +1,48 @@
+/**
+ * Bans use of `print()` function calls. Use `Log` instead.
+ *
+ * The `print()` function is deprecated or discouraged in favor of a proper
+ * logging system like `Log`.
+ *
+ * @example
+ * // ❌ Reports
+ * print("Hello");
+ * print(value);
+ *
+ * // ✅ OK
+ * Log.info("Hello");
+ * Log.debug(value);
+ */
+const noPrint = {
+    /**
+     * Creates the ESLint rule visitor.
+     *
+     * @param context - The ESLint rule context.
+     * @returns The visitor object with AST node handlers.
+     */
+    create(context) {
+        return {
+            CallExpression(node) {
+                if (node.callee.type !== "Identifier" || node.callee.name !== "print")
+                    return;
+                context.report({
+                    messageId: "useLog",
+                    node,
+                });
+            },
+        };
+    },
+    meta: {
+        docs: {
+            description: "Ban print() function calls. Use Log instead.",
+            recommended: false,
+        },
+        messages: {
+            useLog: "Use Log instead of print()",
+        },
+        schema: [],
+        type: "problem",
+    },
+};
+export default noPrint;
+//# sourceMappingURL=no-print.js.map

package/dist/rules/no-print.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-print.js","sourceRoot":"","sources":["../../src/rules/no-print.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,GAAoB;IAChC;;;;;OAKG;IACH,MAAM,CAAC,OAAO;QACb,OAAO;YACN,cAAc,CAAC,IAAI;gBAClB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO;oBAAE,OAAO;gBAE9E,OAAO,CAAC,MAAM,CAAC;oBACd,SAAS,EAAE,QAAQ;oBACnB,IAAI;iBACJ,CAAC,CAAC;YACJ,CAAC;SACD,CAAC;IACH,CAAC;IACD,IAAI,EAAE;QACL,IAAI,EAAE;YACL,WAAW,EAAE,8CAA8C;YAC3D,WAAW,EAAE,KAAK;SAClB;QACD,QAAQ,EAAE;YACT,MAAM,EAAE,4BAA4B;SACpC;QACD,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,SAAS;KACf;CACD,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/rules/no-shorthand-names.d.ts

@@ -0,0 +1,27 @@
+import type { Rule } from "eslint";
+/**
+ * Bans shorthand variable names in favor of descriptive full names.
+ *
+ * Enforces:
+ * - `plr` → `player` (or `localPlayer` for Players.LocalPlayer assignments)
+ * - `args` → `parameters`
+ * - `dt` → `deltaTime`
+ * - `char` → `character` (except when used as property access)
+ *
+ * @example
+ * // ❌ Reports
+ * const plr = getPlayer();
+ * const args = [1, 2, 3];
+ * const dt = 0.016;
+ * const char = getCharacter();
+ *
+ * // ✅ OK
+ * const player = getPlayer();
+ * const localPlayer = Players.LocalPlayer;
+ * const parameters = [1, 2, 3];
+ * const deltaTime = 0.016;
+ * const character = getCharacter();
+ * const model = entity.char; // property access is allowed
+ */
+declare const noShorthandNames: Rule.RuleModule;
+export default noShorthandNames;

package/dist/rules/no-shorthand-names.js

@@ -0,0 +1,133 @@
+const SHORTHANDS = [
+    { messageId: "useParameters", replacement: "parameters", shorthand: "args" },
+    { messageId: "useDeltaTime", replacement: "deltaTime", shorthand: "dt" },
+    { messageId: "useCharacter", replacement: "character", shorthand: "char" },
+];
+/**
+ * Checks if a node is Players.LocalPlayer member expression.
+ *
+ * @param node - The node to check.
+ * @returns True if node is Players.LocalPlayer.
+ */
+function isPlayersLocalPlayer(node) {
+    if (!node || typeof node !== "object")
+        return false;
+    const n = node;
+    if (n.type !== "MemberExpression")
+        return false;
+    const obj = n.object;
+    const prop = n.property;
+    if (!obj || typeof obj !== "object" || !prop || typeof prop !== "object")
+        return false;
+    const objNode = obj;
+    const propNode = prop;
+    return (objNode.type === "Identifier" &&
+        objNode.name === "Players" &&
+        propNode.type === "Identifier" &&
+        propNode.name === "LocalPlayer");
+}
+/**
+ * Checks if an identifier is used as a property access.
+ *
+ * @param node - The identifier node to check.
+ * @returns True if the identifier is a property in a member expression.
+ */
+function isPropertyAccess(node) {
+    const parent = node.parent;
+    if (!parent || typeof parent !== "object")
+        return false;
+    const p = parent;
+    return p.type === "MemberExpression" && p.property === node;
+}
+/**
+ * Bans shorthand variable names in favor of descriptive full names.
+ *
+ * Enforces:
+ * - `plr` → `player` (or `localPlayer` for Players.LocalPlayer assignments)
+ * - `args` → `parameters`
+ * - `dt` → `deltaTime`
+ * - `char` → `character` (except when used as property access)
+ *
+ * @example
+ * // ❌ Reports
+ * const plr = getPlayer();
+ * const args = [1, 2, 3];
+ * const dt = 0.016;
+ * const char = getCharacter();
+ *
+ * // ✅ OK
+ * const player = getPlayer();
+ * const localPlayer = Players.LocalPlayer;
+ * const parameters = [1, 2, 3];
+ * const deltaTime = 0.016;
+ * const character = getCharacter();
+ * const model = entity.char; // property access is allowed
+ */
+const noShorthandNames = {
+    /**
+     * Creates the ESLint rule visitor.
+     *
+     * @param context - The ESLint rule context.
+     * @returns The visitor object with AST node handlers.
+     */
+    create(context) {
+        return {
+            Identifier(node) {
+                const name = node.name;
+                // Special case: plr
+                if (name === "plr") {
+                    // Skip if it's a property access
+                    if (isPropertyAccess(node))
+                        return;
+                    // Check if this is a variable declarator with Players.LocalPlayer
+                    const parent = node.parent;
+                    if (parent?.type === "VariableDeclarator" &&
+                        parent.id === node &&
+                        isPlayersLocalPlayer(parent.init)) {
+                        context.report({
+                            messageId: "useLocalPlayer",
+                            node,
+                        });
+                        return;
+                    }
+                    // Default case: use player
+                    context.report({
+                        messageId: "usePlayer",
+                        node,
+                    });
+                    return;
+                }
+                // Check other shorthands
+                for (const { messageId, shorthand } of SHORTHANDS) {
+                    if (name === shorthand) {
+                        // Special case: char - skip property access
+                        if (shorthand === "char" && isPropertyAccess(node))
+                            continue;
+                        context.report({
+                            messageId,
+                            node,
+                        });
+                        return;
+                    }
+                }
+            },
+        };
+    },
+    meta: {
+        docs: {
+            description: "Ban shorthand variable names. Use descriptive full names instead.",
+            recommended: false,
+        },
+        messages: {
+            useCharacter: "Use 'character' instead of 'char' shorthand",
+            useDeltaTime: "Use 'deltaTime' instead of 'dt' shorthand",
+            useLocalPlayer: "Use 'localPlayer' instead of 'plr' when assigning Players.LocalPlayer",
+            useParameters: "Use 'parameters' instead of 'args' shorthand",
+            usePlayer: "Use 'player' instead of 'plr' shorthand",
+        },
+        schema: [],
+        type: "suggestion",
+    },
+};
+export default noShorthandNames;
+//# sourceMappingURL=no-shorthand-names.js.map

package/dist/rules/no-shorthand-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-shorthand-names.js","sourceRoot":"","sources":["../../src/rules/no-shorthand-names.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,GAA6B;IAC5C,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE;IAC5E,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE;IACxE,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE;CACjE,CAAC;AAEX;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,IAAa;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,CAAC,GAAG,IAA+D,CAAC;IAC1E,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB;QAAE,OAAO,KAAK,CAAC;IAEhD,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACrB,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC;IACxB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEvF,MAAM,OAAO,GAAG,GAAuC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAwC,CAAC;IAE1D,OAAO,CACN,OAAO,CAAC,IAAI,KAAK,YAAY;QAC7B,OAAO,CAAC,IAAI,KAAK,SAAS;QAC1B,QAAQ,CAAC,IAAI,KAAK,YAAY;QAC9B,QAAQ,CAAC,IAAI,KAAK,aAAa,CAC/B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,IAA0B;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAExD,MAAM,CAAC,GAAG,MAA+C,CAAC;IAC1D,OAAO,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,gBAAgB,GAAoB;IACzC;;;;;OAKG;IACH,MAAM,CAAC,OAAO;QACb,OAAO;YACN,UAAU,CAAC,IAAI;gBACd,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBAEvB,oBAAoB;gBACpB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;oBACpB,iCAAiC;oBACjC,IAAI,gBAAgB,CAAC,IAAI,CAAC;wBAAE,OAAO;oBAEnC,kEAAkE;oBAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;oBAC3B,IACC,MAAM,EAAE,IAAI,KAAK,oBAAoB;wBACrC,MAAM,CAAC,EAAE,KAAK,IAAI;wBAClB,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,EAChC,CAAC;wBACF,OAAO,CAAC,MAAM,CAAC;4BACd,SAAS,EAAE,gBAAgB;4BAC3B,IAAI;yBACJ,CAAC,CAAC;wBACH,OAAO;oBACR,CAAC;oBAED,2BAA2B;oBAC3B,OAAO,CAAC,MAAM,CAAC;wBACd,SAAS,EAAE,WAAW;wBACtB,IAAI;qBACJ,CAAC,CAAC;oBACH,OAAO;gBACR,CAAC;gBAED,yBAAyB;gBACzB,KAAK,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,UAAU,EAAE,CAAC;oBACnD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;wBACxB,4CAA4C;wBAC5C,IAAI,SAAS,KAAK,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC;4BAAE,SAAS;wBAE7D,OAAO,CAAC,MAAM,CAAC;4BACd,SAAS;4BACT,IAAI;yBACJ,CAAC,CAAC;wBACH,OAAO;oBACR,CAAC;gBACF,CAAC;YACF,CAAC;SACD,CAAC;IACH,CAAC;IACD,IAAI,EAAE;QACL,IAAI,EAAE;YACL,WAAW,EAAE,mEAAmE;YAChF,WAAW,EAAE,KAAK;SAClB;QACD,QAAQ,EAAE;YACT,YAAY,EAAE,6CAA6C;YAC3D,YAAY,EAAE,2CAA2C;YACzD,cAAc,EAAE,uEAAuE;YACvF,aAAa,EAAE,8CAA8C;YAC7D,SAAS,EAAE,yCAAyC;SACpD;QACD,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,YAAY;KAClB;CACD,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/rules/no-warn.d.ts

@@ -0,0 +1,18 @@
+import type { Rule } from "eslint";
+/**
+ * Bans use of `warn()` function calls. Use `Log` instead.
+ *
+ * The `warn()` function is deprecated or discouraged in favor of a proper
+ * logging system like `Log`.
+ *
+ * @example
+ * // ❌ Reports
+ * warn("Warning");
+ * warn(error);
+ *
+ * // ✅ OK
+ * Log.warn("Warning");
+ * Log.error(error);
+ */
+declare const noWarn: Rule.RuleModule;
+export default noWarn;

package/dist/rules/no-warn.js

@@ -0,0 +1,48 @@
+/**
+ * Bans use of `warn()` function calls. Use `Log` instead.
+ *
+ * The `warn()` function is deprecated or discouraged in favor of a proper
+ * logging system like `Log`.
+ *
+ * @example
+ * // ❌ Reports
+ * warn("Warning");
+ * warn(error);
+ *
+ * // ✅ OK
+ * Log.warn("Warning");
+ * Log.error(error);
+ */
+const noWarn = {
+    /**
+     * Creates the ESLint rule visitor.
+     *
+     * @param context - The ESLint rule context.
+     * @returns The visitor object with AST node handlers.
+     */
+    create(context) {
+        return {
+            CallExpression(node) {
+                if (node.callee.type !== "Identifier" || node.callee.name !== "warn")
+                    return;
+                context.report({
+                    messageId: "useLog",
+                    node,
+                });
+            },
+        };
+    },
+    meta: {
+        docs: {
+            description: "Ban warn() function calls. Use Log instead.",
+            recommended: false,
+        },
+        messages: {
+            useLog: "Use Log instead of warn()",
+        },
+        schema: [],
+        type: "problem",
+    },
+};
+export default noWarn;
+//# sourceMappingURL=no-warn.js.map

package/dist/rules/no-warn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-warn.js","sourceRoot":"","sources":["../../src/rules/no-warn.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,GAAoB;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,OAAO;QACb,OAAO;YACN,cAAc,CAAC,IAAI;gBAClB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO;gBAE7E,OAAO,CAAC,MAAM,CAAC;oBACd,SAAS,EAAE,QAAQ;oBACnB,IAAI;iBACJ,CAAC,CAAC;YACJ,CAAC;SACD,CAAC;IACH,CAAC;IACD,IAAI,EAAE;QACL,IAAI,EAAE;YACL,WAAW,EAAE,6CAA6C;YAC1D,WAAW,EAAE,KAAK;SAClB;QACD,QAAQ,EAAE;YACT,MAAM,EAAE,2BAA2B;SACnC;QACD,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,SAAS;KACf;CACD,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/rules/require-react-component-keys.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "eslint";
+declare const requireReactComponentKeys: Rule.RuleModule;
+export default requireReactComponentKeys;

package/dist/rules/require-react-component-keys.js

@@ -0,0 +1,98 @@
+/**
+ * Checks if a JSX element has a key attribute.
+ *
+ * @param node - The JSX element to check.
+ * @returns True if the element has a key attribute.
+ */
+function hasKeyAttribute(node) {
+    return node.openingElement.attributes.some((attr) => attr.type === "JSXAttribute" && attr.name.name === "key");
+}
+/**
+ * Checks if a JSX element is a top-level return from a component.
+ *
+ * @param node - The JSX element or fragment to check.
+ * @returns True if the element is directly returned from a component.
+ */
+function isTopLevelReturn(node) {
+    // Check if this element is a direct child of a return statement
+    let parent = node.parent;
+    if (!parent)
+        return false;
+    // Handle return with parentheses: return (<div>...)
+    if (parent.type === "JSXExpressionContainer")
+        parent = parent.parent;
+    // Handle direct return
+    if (parent?.type === "ReturnStatement")
+        return true;
+    // Handle arrow function direct return: () => <div>
+    if (parent?.type === "ArrowFunctionExpression")
+        return true;
+    return false;
+}
+const requireReactComponentKeys = {
+    /**
+     * Creates the ESLint rule visitor.
+     *
+     * @param context - The ESLint rule context.
+     * @returns The visitor object with AST node handlers.
+     */
+    create(context) {
+        const returnStack = new Array();
+        /**
+         * Checks a JSX element or fragment for required key prop.
+         *
+         * @param node - The JSX element or fragment to check.
+         */
+        function checkElement(node) {
+            // Top-level return doesn't need key
+            if (isTopLevelReturn(node))
+                return;
+            // Fragments always need keys when not top-level
+            if (node.type === "JSXFragment") {
+                context.report({
+                    messageId: "missingKey",
+                    node,
+                });
+                return;
+            }
+            // Check if element has key
+            if (hasKeyAttribute(node))
+                return;
+            context.report({
+                messageId: "missingKey",
+                node,
+            });
+        }
+        return {
+            // Track function/component boundaries for top-level detection
+            "FunctionDeclaration, FunctionExpression, ArrowFunctionExpression"(node) {
+                returnStack.push({ depth: returnStack.length, node });
+            },
+            "FunctionDeclaration, FunctionExpression, ArrowFunctionExpression:exit"() {
+                returnStack.pop();
+            },
+            // Check JSX elements
+            JSXElement(node) {
+                checkElement(node);
+            },
+            // Check JSX fragments
+            JSXFragment(node) {
+                checkElement(node);
+            },
+        };
+    },
+    meta: {
+        docs: {
+            description: "Enforce key props on all React elements except top-level returns",
+            recommended: false,
+        },
+        fixable: undefined,
+        messages: {
+            missingKey: "All React elements except top-level returns require a key prop",
+        },
+        schema: [],
+        type: "problem",
+    },
+};
+export default requireReactComponentKeys;
+//# sourceMappingURL=require-react-component-keys.js.map

package/dist/rules/require-react-component-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-react-component-keys.js","sourceRoot":"","sources":["../../src/rules/require-react-component-keys.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAAyB;IACjD,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;AAChH,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,IAAgD;IACzE,gEAAgE;IAChE,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzB,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,oDAAoD;IACpD,IAAI,MAAM,CAAC,IAAI,KAAK,wBAAwB;QAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAErE,uBAAuB;IACvB,IAAI,MAAM,EAAE,IAAI,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAEpD,mDAAmD;IACnD,IAAI,MAAM,EAAE,IAAI,KAAK,yBAAyB;QAAE,OAAO,IAAI,CAAC;IAE5D,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,yBAAyB,GAAoB;IAClD;;;;;OAKG;IACH,MAAM,CAAC,OAAO;QACb,MAAM,WAAW,GAAG,IAAI,KAAK,EAA0C,CAAC;QAExE;;;;WAIG;QACH,SAAS,YAAY,CAAC,IAAgD;YACrE,oCAAoC;YACpC,IAAI,gBAAgB,CAAC,IAAI,CAAC;gBAAE,OAAO;YAEnC,gDAAgD;YAChD,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjC,OAAO,CAAC,MAAM,CAAC;oBACd,SAAS,EAAE,YAAY;oBACvB,IAAI;iBACJ,CAAC,CAAC;gBACH,OAAO;YACR,CAAC;YAED,2BAA2B;YAC3B,IAAI,eAAe,CAAC,IAAI,CAAC;gBAAE,OAAO;YAClC,OAAO,CAAC,MAAM,CAAC;gBACd,SAAS,EAAE,YAAY;gBACvB,IAAI;aACJ,CAAC,CAAC;QACJ,CAAC;QAED,OAAO;YACN,8DAA8D;YAC9D,kEAAkE,CAAC,IAAmB;gBACrF,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;YAED,uEAAuE;gBACtE,WAAW,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;YAED,qBAAqB;YACrB,UAAU,CAAC,IAAI;gBACd,YAAY,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;YAED,sBAAsB;YACtB,WAAW,CAAC,IAAI;gBACf,YAAY,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;SACD,CAAC;IACH,CAAC;IACD,IAAI,EAAE;QACL,IAAI,EAAE;YACL,WAAW,EAAE,kEAAkE;YAC/E,WAAW,EAAE,KAAK;SAClB;QACD,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE;YACT,UAAU,EAAE,gEAAgE;SAC5E;QACD,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,SAAS;KACf;CACD,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+	"author": "HowManySmall",
+	"description": "A bunch of lints to prevent idiot mistakes I encounter with frequency.",
+	"devDependencies": {
+		"@biomejs/biome": "^2.2.4",
+		"@mitata/counters": "^0.0.8",
+		"@types/bun": "1.2.22",
+		"@types/node": "^20.14.11",
+		"@typescript-eslint/parser": "^8.0.0",
+		"@typescript-eslint/types": "^8.0.0",
+		"@typescript-eslint/utils": "^8.0.0",
+		"eslint": "9.35.0",
+		"jiti": "^2.4.2",
+		"knip": "^5.63.1",
+		"mitata": "^1.0.34",
+		"oxlint": "^1.15.0",
+		"oxlint-tsgolint": "^0.2.0",
+		"typescript": "^5.6.3"
+	},
+	"engines": {
+		"bun": ">=1.1.0",
+		"node": ">=18.18"
+	},
+	"exports": {
+		".": {
+			"default": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"files": ["dist"],
+	"license": "MIT",
+	"main": "./dist/index.js",
+	"name": "@pobammer-ts/eslint-cease-nonsense-rules",
+	"peerDependencies": {
+		"@typescript-eslint/parser": "^8.0.0",
+		"@typescript-eslint/utils": "^8.0.0",
+		"eslint": "^9.35.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/howmanysmall/eslint-cease-nonsense-rules.git"
+	},
+	"scripts": {
+		"add-tsgolint": "bun add -D oxlint-tsgolint@latest",
+		"biome": "bun x --bun biome lint",
+		"biome:ci": "bun x --bun biome ci",
+		"build": "bunx --bun tsc -p tsconfig.json",
+		"dev": "bunx --bun tsc -w",
+		"format": "bun x --bun. biome format --fix",
+		"format:report": "bun x --bun. biome format",
+		"lint": "bun x --bun oxlint . && bun x --bun biome lint .",
+		"oxc": "bun x --bun oxlint --type-aware",
+		"prepublishOnly": "bun run build",
+		"test": "bun test",
+		"typecheck": "bunx --bun tsc --noEmit"
+	},
+	"sideEffects": false,
+	"type": "module",
+	"types": "./dist/index.d.ts",
+	"version": "0.0.0"
+}