@trackunit/eslint-plugin-trackunit 0.0.2

package/src/lib/rules/require-classname-alternatives/require-classname-alternatives.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireClassnameAlternatives = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const classname_utils_1 = require("../../utils/classname-utils");
+const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}.ts`);
+/**
+ * Replace a specific pattern in a string with its replacement.
+ * Handles both prefix-based patterns (e.g., bg-red-500 -> bg-danger-500)
+ * and exact matches.
+ */
+function replacePattern(value, oldPattern, newPattern, hasPrefixes) {
+    if (hasPrefixes) {
+        // With prefixes, replace -oldPattern- with -newPattern-
+        const pattern = new RegExp(`-${oldPattern}(-|$|/)`, "g");
+        return value.replace(pattern, `-${newPattern}$1`);
+    }
+    else {
+        // Without prefixes, replace exact word boundaries
+        const pattern = new RegExp(`(^|\\s)${oldPattern}($|\\s)`, "g");
+        return value.replace(pattern, `$1${newPattern}$2`);
+    }
+}
+/**
+ * Build a regex pattern that matches class names based on configuration.
+ *
+ * With prefixes: Matches patterns like bg-red-500, text-blue-200, hover:border-green-400
+ * Without prefixes: Matches exact class names as standalone words
+ */
+function buildBannedPattern(bannedPatterns, prefixes) {
+    const patternList = bannedPatterns.join("|");
+    const variantPrefixes = "(?:hover:|focus:|focus-visible:|focus-within:|active:|disabled:|group-hover:|peer-hover:|dark:|light:|sm:|md:|lg:|xl:|2xl:)*";
+    if (prefixes && prefixes.length > 0) {
+        const prefixPattern = prefixes.join("|");
+        // Match: [variant:]prefix-banned[-suffix][/opacity]
+        return new RegExp(`(?:^|\\s)(${variantPrefixes}(?:${prefixPattern})-(${patternList})(?:-[a-zA-Z0-9]+)?(?:\\/\\d+)?)(?=\\s|$|")`, "g");
+    }
+    else {
+        // Exact match: standalone class name
+        return new RegExp(`(?:^|\\s)(${variantPrefixes}(${patternList}))(?=\\s|$|")`, "g");
+    }
+}
+exports.requireClassnameAlternatives = createRule({
+    name: "require-classname-alternatives",
+    meta: {
+        type: "problem",
+        fixable: "code",
+        hasSuggestions: true,
+        docs: {
+            description: "Require specific class names to be replaced with alternatives. Configurable via rule options.",
+        },
+        messages: {
+            bannedClassAutoFix: '"{{match}}" is not allowed. Use "{{alternative}}" instead.',
+            bannedClassSuggest: '"{{match}}" is not allowed. Consider using: {{alternatives}}.',
+            suggestReplacement: 'Replace with "{{replacement}}"',
+        },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    alternatives: {
+                        type: "object",
+                        description: "Map of banned patterns to their allowed alternatives (array of strings)",
+                        additionalProperties: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
+                    },
+                    prefixes: {
+                        type: "array",
+                        description: "Prefixes to match (e.g., 'bg', 'text'). If not provided, matches exact class names.",
+                        items: { type: "string" },
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [],
+    create(context) {
+        const options = context.options[0];
+        // Return early if no options or empty alternatives to save compute
+        if (!options || Object.keys(options.alternatives).length === 0) {
+            return {};
+        }
+        const { alternatives, prefixes } = options;
+        const bannedPatterns = Object.keys(alternatives);
+        const hasPrefixes = prefixes !== undefined && prefixes.length > 0;
+        const isBannedPattern = (pattern) => pattern in alternatives;
+        const getAlternatives = (pattern) => {
+            return alternatives[pattern] ?? [];
+        };
+        const isAutoFixable = (pattern) => getAlternatives(pattern).length === 1;
+        const BANNED_PATTERN = buildBannedPattern(bannedPatterns, prefixes);
+        /**
+         * Find all banned pattern usages in a string value
+         */
+        function findBannedUsages(value) {
+            const results = [];
+            BANNED_PATTERN.lastIndex = 0;
+            let regexMatch;
+            while ((regexMatch = BANNED_PATTERN.exec(value)) !== null) {
+                const matchedClass = regexMatch[1];
+                const matchedPattern = regexMatch[2];
+                if (matchedClass !== undefined && matchedPattern !== undefined && isBannedPattern(matchedPattern)) {
+                    results.push({
+                        match: matchedClass.trim(),
+                        pattern: matchedPattern,
+                    });
+                }
+            }
+            return results;
+        }
+        /**
+         * Replace ALL auto-fixable patterns in a string at once
+         */
+        function replaceAllAutoFixablePatterns(value) {
+            let result = value;
+            for (const [pattern, alts] of Object.entries(alternatives)) {
+                const singleAlternative = alts.length === 1 ? alts[0] : undefined;
+                if (singleAlternative) {
+                    result = replacePattern(result, pattern, singleAlternative, hasPrefixes);
+                }
+            }
+            return result;
+        }
+        // Track which string literals have already had a fix generated
+        // to avoid duplicate/conflicting fixes for the same literal
+        const fixedLiterals = new WeakSet();
+        /**
+         * Create a fixer function that replaces all auto-fixable patterns in a string literal
+         */
+        function createFixer(stringLiteralNode) {
+            return (fixer) => {
+                switch (stringLiteralNode.type) {
+                    case utils_1.AST_NODE_TYPES.Literal: {
+                        const originalValue = stringLiteralNode.value;
+                        if (typeof originalValue !== "string") {
+                            return null;
+                        }
+                        const fixedValue = replaceAllAutoFixablePatterns(originalValue);
+                        const raw = stringLiteralNode.raw;
+                        const quote = raw.charAt(0);
+                        return fixer.replaceText(stringLiteralNode, `${quote}${fixedValue}${quote}`);
+                    }
+                    case utils_1.AST_NODE_TYPES.TemplateLiteral: {
+                        const fixes = [];
+                        const autoFixablePatterns = Object.entries(alternatives)
+                            .filter(([, alts]) => alts.length === 1)
+                            .map(([pattern]) => pattern);
+                        for (const quasi of stringLiteralNode.quasis) {
+                            const hasFixablePattern = autoFixablePatterns.some(pattern => hasPrefixes ? quasi.value.raw.includes(`-${pattern}`) : quasi.value.raw.includes(pattern));
+                            if (hasFixablePattern) {
+                                const fixedRaw = replaceAllAutoFixablePatterns(quasi.value.raw);
+                                const rangeStart = quasi.range[0] + (quasi.tail ? 1 : 0);
+                                const rangeEnd = quasi.range[1] - (quasi.tail ? 1 : 0);
+                                fixes.push(fixer.replaceTextRange([rangeStart, rangeEnd], quasi.tail ? fixedRaw : fixedRaw + (quasi.value.raw.endsWith(" ") ? "" : "")));
+                            }
+                        }
+                        return fixes.length > 0 ? fixes : null;
+                    }
+                    default:
+                        return null;
+                }
+            };
+        }
+        /**
+         * Create a suggestion fixer for a specific pattern replacement
+         */
+        function createSuggestionFixer(stringLiteralNode, oldPattern, newPattern) {
+            return (fixer) => {
+                switch (stringLiteralNode.type) {
+                    case utils_1.AST_NODE_TYPES.Literal: {
+                        const originalValue = stringLiteralNode.value;
+                        if (typeof originalValue !== "string") {
+                            return null;
+                        }
+                        const fixedValue = replacePattern(originalValue, oldPattern, newPattern, hasPrefixes);
+                        const raw = stringLiteralNode.raw;
+                        const quote = raw.charAt(0);
+                        return fixer.replaceText(stringLiteralNode, `${quote}${fixedValue}${quote}`);
+                    }
+                    case utils_1.AST_NODE_TYPES.TemplateLiteral: {
+                        const fixes = [];
+                        for (const quasi of stringLiteralNode.quasis) {
+                            const containsPattern = hasPrefixes
+                                ? quasi.value.raw.includes(`-${oldPattern}`)
+                                : quasi.value.raw.includes(oldPattern);
+                            if (containsPattern) {
+                                const fixedRaw = replacePattern(quasi.value.raw, oldPattern, newPattern, hasPrefixes);
+                                const rangeStart = quasi.range[0] + (quasi.tail ? 1 : 0);
+                                const rangeEnd = quasi.range[1] - (quasi.tail ? 1 : 0);
+                                fixes.push(fixer.replaceTextRange([rangeStart, rangeEnd], quasi.tail ? fixedRaw : fixedRaw + (quasi.value.raw.endsWith(" ") ? "" : "")));
+                            }
+                        }
+                        return fixes.length > 0 ? fixes : null;
+                    }
+                    default:
+                        return null;
+                }
+            };
+        }
+        /**
+         * Report banned pattern usages for a given node and value.
+         * - Auto-fixable patterns (1 alternative): applies fix automatically
+         * - Multi-alternative patterns: shows suggestions in editor quick-fix menu
+         */
+        function checkAndReport(node, value, stringLiteralNode) {
+            const usages = findBannedUsages(value);
+            let fixProvided = false;
+            for (const usage of usages) {
+                const patternIsAutoFixable = isAutoFixable(usage.pattern);
+                const patternAlternatives = getAlternatives(usage.pattern);
+                let fix;
+                let suggest;
+                if (stringLiteralNode) {
+                    if (patternIsAutoFixable && !fixProvided && !fixedLiterals.has(stringLiteralNode)) {
+                        fixedLiterals.add(stringLiteralNode);
+                        fixProvided = true;
+                        fix = createFixer(stringLiteralNode);
+                    }
+                    if (!patternIsAutoFixable) {
+                        suggest = patternAlternatives.map(alternative => ({
+                            messageId: "suggestReplacement",
+                            data: { replacement: replacePattern(usage.match, usage.pattern, alternative, hasPrefixes) },
+                            fix: createSuggestionFixer(stringLiteralNode, usage.pattern, alternative),
+                        }));
+                    }
+                }
+                if (patternIsAutoFixable) {
+                    const singleAlternative = patternAlternatives[0];
+                    context.report({
+                        node,
+                        messageId: "bannedClassAutoFix",
+                        data: {
+                            match: usage.match,
+                            alternative: singleAlternative ?? "",
+                        },
+                        fix,
+                    });
+                }
+                else {
+                    context.report({
+                        node,
+                        messageId: "bannedClassSuggest",
+                        data: {
+                            match: usage.match,
+                            alternatives: patternAlternatives.join(", "),
+                        },
+                        suggest,
+                    });
+                }
+            }
+        }
+        return {
+            JSXAttribute(node) {
+                const locations = (0, classname_utils_1.findClassnameStringsInAttribute)(node);
+                for (const location of locations) {
+                    checkAndReport(location.reportNode, location.value, location.fixNode);
+                }
+            },
+            CallExpression(node) {
+                const locations = (0, classname_utils_1.findClassnameStringsInCall)(node);
+                for (const location of locations) {
+                    checkAndReport(location.reportNode, location.value, location.fixNode);
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=require-classname-alternatives.js.map

package/src/lib/rules/require-classname-alternatives/require-classname-alternatives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-classname-alternatives.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/require-classname-alternatives/require-classname-alternatives.ts"],"names":[],"mappings":"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","sourcesContent":["import { AST_NODE_TYPES, ESLintUtils, TSESTree } from \"@typescript-eslint/utils\";\nimport { findClassnameStringsInAttribute, findClassnameStringsInCall } from \"../../utils/classname-utils\";\n\nconst createRule = ESLintUtils.RuleCreator(\n  name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}.ts`\n);\n\ntype MessageIds = \"bannedClassAutoFix\" | \"bannedClassSuggest\" | \"suggestReplacement\";\n\ntype RuleConfig = {\n  /** Map of banned class name patterns to their allowed alternatives */\n  alternatives: Record<string, Array<string>>;\n  /** Optional prefixes to match (e.g., \"bg\", \"text\", \"border\"). If not provided, matches exact class names. */\n  prefixes?: Array<string>;\n};\n\ntype Options = [RuleConfig?];\n\n/**\n * Replace a specific pattern in a string with its replacement.\n * Handles both prefix-based patterns (e.g., bg-red-500 -> bg-danger-500)\n * and exact matches.\n */\nfunction replacePattern(value: string, oldPattern: string, newPattern: string, hasPrefixes: boolean): string {\n  if (hasPrefixes) {\n    // With prefixes, replace -oldPattern- with -newPattern-\n    const pattern = new RegExp(`-${oldPattern}(-|$|/)`, \"g\");\n    return value.replace(pattern, `-${newPattern}$1`);\n  } else {\n    // Without prefixes, replace exact word boundaries\n    const pattern = new RegExp(`(^|\\\\s)${oldPattern}($|\\\\s)`, \"g\");\n    return value.replace(pattern, `$1${newPattern}$2`);\n  }\n}\n\n/**\n * Build a regex pattern that matches class names based on configuration.\n *\n * With prefixes: Matches patterns like bg-red-500, text-blue-200, hover:border-green-400\n * Without prefixes: Matches exact class names as standalone words\n */\nfunction buildBannedPattern(bannedPatterns: Array<string>, prefixes?: Array<string>): RegExp {\n  const patternList = bannedPatterns.join(\"|\");\n  const variantPrefixes =\n    \"(?:hover:|focus:|focus-visible:|focus-within:|active:|disabled:|group-hover:|peer-hover:|dark:|light:|sm:|md:|lg:|xl:|2xl:)*\";\n\n  if (prefixes && prefixes.length > 0) {\n    const prefixPattern = prefixes.join(\"|\");\n    // Match: [variant:]prefix-banned[-suffix][/opacity]\n    return new RegExp(\n      `(?:^|\\\\s)(${variantPrefixes}(?:${prefixPattern})-(${patternList})(?:-[a-zA-Z0-9]+)?(?:\\\\/\\\\d+)?)(?=\\\\s|$|\")`,\n      \"g\"\n    );\n  } else {\n    // Exact match: standalone class name\n    return new RegExp(`(?:^|\\\\s)(${variantPrefixes}(${patternList}))(?=\\\\s|$|\")`, \"g\");\n  }\n}\n\nexport const requireClassnameAlternatives = createRule<Options, MessageIds>({\n  name: \"require-classname-alternatives\",\n  meta: {\n    type: \"problem\",\n    fixable: \"code\",\n    hasSuggestions: true,\n    docs: {\n      description: \"Require specific class names to be replaced with alternatives. Configurable via rule options.\",\n    },\n    messages: {\n      bannedClassAutoFix: '\"{{match}}\" is not allowed. Use \"{{alternative}}\" instead.',\n      bannedClassSuggest: '\"{{match}}\" is not allowed. Consider using: {{alternatives}}.',\n      suggestReplacement: 'Replace with \"{{replacement}}\"',\n    },\n    schema: [\n      {\n        type: \"object\",\n        properties: {\n          alternatives: {\n            type: \"object\",\n            description: \"Map of banned patterns to their allowed alternatives (array of strings)\",\n            additionalProperties: {\n              type: \"array\",\n              items: { type: \"string\" },\n            },\n          },\n          prefixes: {\n            type: \"array\",\n            description: \"Prefixes to match (e.g., 'bg', 'text'). If not provided, matches exact class names.\",\n            items: { type: \"string\" },\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n  },\n  defaultOptions: [],\n  create(context) {\n    const options = context.options[0];\n\n    // Return early if no options or empty alternatives to save compute\n    if (!options || Object.keys(options.alternatives).length === 0) {\n      return {};\n    }\n\n    const { alternatives, prefixes } = options;\n    const bannedPatterns = Object.keys(alternatives);\n    const hasPrefixes = prefixes !== undefined && prefixes.length > 0;\n\n    const isBannedPattern = (pattern: string): boolean => pattern in alternatives;\n\n    const getAlternatives = (pattern: string): Array<string> => {\n      return alternatives[pattern] ?? [];\n    };\n\n    const isAutoFixable = (pattern: string): boolean => getAlternatives(pattern).length === 1;\n\n    const BANNED_PATTERN = buildBannedPattern(bannedPatterns, prefixes);\n\n    /**\n     * Find all banned pattern usages in a string value\n     */\n    function findBannedUsages(value: string): Array<{ match: string; pattern: string }> {\n      const results: Array<{ match: string; pattern: string }> = [];\n      BANNED_PATTERN.lastIndex = 0;\n\n      let regexMatch;\n      while ((regexMatch = BANNED_PATTERN.exec(value)) !== null) {\n        const matchedClass = regexMatch[1];\n        const matchedPattern = regexMatch[2];\n        if (matchedClass !== undefined && matchedPattern !== undefined && isBannedPattern(matchedPattern)) {\n          results.push({\n            match: matchedClass.trim(),\n            pattern: matchedPattern,\n          });\n        }\n      }\n\n      return results;\n    }\n\n    /**\n     * Replace ALL auto-fixable patterns in a string at once\n     */\n    function replaceAllAutoFixablePatterns(value: string): string {\n      let result = value;\n      for (const [pattern, alts] of Object.entries(alternatives)) {\n        const singleAlternative = alts.length === 1 ? alts[0] : undefined;\n        if (singleAlternative) {\n          result = replacePattern(result, pattern, singleAlternative, hasPrefixes);\n        }\n      }\n      return result;\n    }\n\n    // Track which string literals have already had a fix generated\n    // to avoid duplicate/conflicting fixes for the same literal\n    const fixedLiterals = new WeakSet<TSESTree.Literal | TSESTree.TemplateLiteral>();\n\n    /**\n     * Create a fixer function that replaces all auto-fixable patterns in a string literal\n     */\n    function createFixer(stringLiteralNode: TSESTree.Literal | TSESTree.TemplateLiteral) {\n      return (fixer: Parameters<NonNullable<Parameters<typeof context.report>[0][\"fix\"]>>[0]) => {\n        switch (stringLiteralNode.type) {\n          case AST_NODE_TYPES.Literal: {\n            const originalValue = stringLiteralNode.value;\n            if (typeof originalValue !== \"string\") {\n              return null;\n            }\n            const fixedValue = replaceAllAutoFixablePatterns(originalValue);\n            const raw = stringLiteralNode.raw;\n            const quote = raw.charAt(0);\n            return fixer.replaceText(stringLiteralNode, `${quote}${fixedValue}${quote}`);\n          }\n          case AST_NODE_TYPES.TemplateLiteral: {\n            const fixes: Array<ReturnType<typeof fixer.replaceTextRange>> = [];\n            const autoFixablePatterns = Object.entries(alternatives)\n              .filter(([, alts]) => alts.length === 1)\n              .map(([pattern]) => pattern);\n\n            for (const quasi of stringLiteralNode.quasis) {\n              const hasFixablePattern = autoFixablePatterns.some(pattern =>\n                hasPrefixes ? quasi.value.raw.includes(`-${pattern}`) : quasi.value.raw.includes(pattern)\n              );\n              if (hasFixablePattern) {\n                const fixedRaw = replaceAllAutoFixablePatterns(quasi.value.raw);\n                const rangeStart = quasi.range[0] + (quasi.tail ? 1 : 0);\n                const rangeEnd = quasi.range[1] - (quasi.tail ? 1 : 0);\n                fixes.push(\n                  fixer.replaceTextRange(\n                    [rangeStart, rangeEnd],\n                    quasi.tail ? fixedRaw : fixedRaw + (quasi.value.raw.endsWith(\" \") ? \"\" : \"\")\n                  )\n                );\n              }\n            }\n            return fixes.length > 0 ? fixes : null;\n          }\n          default:\n            return null;\n        }\n      };\n    }\n\n    /**\n     * Create a suggestion fixer for a specific pattern replacement\n     */\n    function createSuggestionFixer(\n      stringLiteralNode: TSESTree.Literal | TSESTree.TemplateLiteral,\n      oldPattern: string,\n      newPattern: string\n    ) {\n      return (fixer: Parameters<NonNullable<Parameters<typeof context.report>[0][\"fix\"]>>[0]) => {\n        switch (stringLiteralNode.type) {\n          case AST_NODE_TYPES.Literal: {\n            const originalValue = stringLiteralNode.value;\n            if (typeof originalValue !== \"string\") {\n              return null;\n            }\n            const fixedValue = replacePattern(originalValue, oldPattern, newPattern, hasPrefixes);\n            const raw = stringLiteralNode.raw;\n            const quote = raw.charAt(0);\n            return fixer.replaceText(stringLiteralNode, `${quote}${fixedValue}${quote}`);\n          }\n          case AST_NODE_TYPES.TemplateLiteral: {\n            const fixes: Array<ReturnType<typeof fixer.replaceTextRange>> = [];\n            for (const quasi of stringLiteralNode.quasis) {\n              const containsPattern = hasPrefixes\n                ? quasi.value.raw.includes(`-${oldPattern}`)\n                : quasi.value.raw.includes(oldPattern);\n              if (containsPattern) {\n                const fixedRaw = replacePattern(quasi.value.raw, oldPattern, newPattern, hasPrefixes);\n                const rangeStart = quasi.range[0] + (quasi.tail ? 1 : 0);\n                const rangeEnd = quasi.range[1] - (quasi.tail ? 1 : 0);\n                fixes.push(\n                  fixer.replaceTextRange(\n                    [rangeStart, rangeEnd],\n                    quasi.tail ? fixedRaw : fixedRaw + (quasi.value.raw.endsWith(\" \") ? \"\" : \"\")\n                  )\n                );\n              }\n            }\n            return fixes.length > 0 ? fixes : null;\n          }\n          default:\n            return null;\n        }\n      };\n    }\n\n    /**\n     * Report banned pattern usages for a given node and value.\n     * - Auto-fixable patterns (1 alternative): applies fix automatically\n     * - Multi-alternative patterns: shows suggestions in editor quick-fix menu\n     */\n    function checkAndReport(\n      node: TSESTree.Node,\n      value: string,\n      stringLiteralNode?: TSESTree.Literal | TSESTree.TemplateLiteral\n    ): void {\n      const usages = findBannedUsages(value);\n      let fixProvided = false;\n\n      for (const usage of usages) {\n        const patternIsAutoFixable = isAutoFixable(usage.pattern);\n        const patternAlternatives = getAlternatives(usage.pattern);\n\n        let fix: Parameters<typeof context.report>[0][\"fix\"];\n        let suggest: Parameters<typeof context.report>[0][\"suggest\"];\n\n        if (stringLiteralNode) {\n          if (patternIsAutoFixable && !fixProvided && !fixedLiterals.has(stringLiteralNode)) {\n            fixedLiterals.add(stringLiteralNode);\n            fixProvided = true;\n            fix = createFixer(stringLiteralNode);\n          }\n\n          if (!patternIsAutoFixable) {\n            suggest = patternAlternatives.map(alternative => ({\n              messageId: \"suggestReplacement\" as const,\n              data: { replacement: replacePattern(usage.match, usage.pattern, alternative, hasPrefixes) },\n              fix: createSuggestionFixer(stringLiteralNode, usage.pattern, alternative),\n            }));\n          }\n        }\n\n        if (patternIsAutoFixable) {\n          const singleAlternative = patternAlternatives[0];\n          context.report({\n            node,\n            messageId: \"bannedClassAutoFix\",\n            data: {\n              match: usage.match,\n              alternative: singleAlternative ?? \"\",\n            },\n            fix,\n          });\n        } else {\n          context.report({\n            node,\n            messageId: \"bannedClassSuggest\",\n            data: {\n              match: usage.match,\n              alternatives: patternAlternatives.join(\", \"),\n            },\n            suggest,\n          });\n        }\n      }\n    }\n\n    return {\n      JSXAttribute(node: TSESTree.JSXAttribute) {\n        const locations = findClassnameStringsInAttribute(node);\n        for (const location of locations) {\n          checkAndReport(location.reportNode, location.value, location.fixNode);\n        }\n      },\n\n      CallExpression(node: TSESTree.CallExpression) {\n        const locations = findClassnameStringsInCall(node);\n        for (const location of locations) {\n          checkAndReport(location.reportNode, location.value, location.fixNode);\n        }\n      },\n    };\n  },\n});\n"]}

package/src/lib/rules/require-list-item-virtualization-props/require-list-item-virtualization-props.d.ts

@@ -0,0 +1,15 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+type Options = [
+    {
+        /**
+         * Whether to allow custom components that extend VirtualizationListItemProps
+         * instead of requiring explicit spreading of listItemProps
+         */
+        allowCustomComponents?: boolean;
+    }
+];
+type MessageIds = "requireVirtualizationProps" | "spreadListItemProps" | "useSemanticListItem";
+export declare const requireListItemVirtualizationProps: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};

package/src/lib/rules/require-list-item-virtualization-props/require-list-item-virtualization-props.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireListItemVirtualizationProps = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}.ts`);
+/**
+ * Check if a spread attribute argument contains listItemProps
+ */
+const isListItemPropsSpread = (argument) => {
+    // Direct identifier: {...listItemProps}
+    if (argument.type === utils_1.AST_NODE_TYPES.Identifier) {
+        return argument.name === "listItemProps" || argument.name.includes("ItemProps");
+    }
+    // Member expression: {...params.listItemProps}
+    if (argument.type === utils_1.AST_NODE_TYPES.MemberExpression) {
+        // Check if property is an identifier (not computed like params["listItemProps"])
+        if (!argument.computed && argument.property.type === utils_1.AST_NODE_TYPES.Identifier) {
+            const propertyName = argument.property.name;
+            if (propertyName === "listItemProps" || propertyName.includes("ItemProps")) {
+                return true;
+            }
+        }
+    }
+    return false;
+};
+/**
+ * Check if a JSX element has the required virtualization props
+ */
+const hasRequiredVirtualizationProps = (element, context) => {
+    // ref is functionally required for virtualization even though TypeScript marks it optional
+    const requiredProps = ["className", "data-index", "tabIndex", "ref"];
+    const attributes = element.openingElement.attributes;
+    const propNames = new Set();
+    let hasSpreadListItemProps = false;
+    for (const attr of attributes) {
+        if (attr.type === utils_1.AST_NODE_TYPES.JSXAttribute && attr.name.type === utils_1.AST_NODE_TYPES.JSXIdentifier) {
+            propNames.add(attr.name.name);
+        }
+        else if (attr.type === utils_1.AST_NODE_TYPES.JSXSpreadAttribute) {
+            // Check if spreading listItemProps or similar
+            if (isListItemPropsSpread(attr.argument)) {
+                hasSpreadListItemProps = true;
+            }
+            else {
+                // Fallback: check source code text for listItemProps
+                // This handles edge cases where AST structure might be different
+                const sourceCode = context.sourceCode.getText(attr.argument);
+                const hasListItemProps = sourceCode.includes("listItemProps");
+                const hasItemProps = sourceCode.includes("ItemProps");
+                if (hasListItemProps || hasItemProps) {
+                    hasSpreadListItemProps = true;
+                }
+            }
+        }
+    }
+    // If spreading listItemProps, assume it has all required props
+    if (hasSpreadListItemProps) {
+        return true;
+    }
+    // Check if all required props are present
+    return requiredProps.every(prop => propNames.has(prop));
+};
+/**
+ * Check if we're inside a List component's render function
+ */
+const isInsideListRenderFunction = (node) => {
+    let current = node.parent;
+    while (current) {
+        // Look for JSX element named "List"
+        if (current.type === utils_1.AST_NODE_TYPES.JSXElement &&
+            current.openingElement.name.type === utils_1.AST_NODE_TYPES.JSXIdentifier &&
+            current.openingElement.name.name === "List") {
+            return true;
+        }
+        current = current.parent;
+    }
+    return false;
+};
+/**
+ * Check if a JSX element is a direct list item (directly returned from List render function)
+ */
+const isListItemElement = (element) => {
+    // Check if this element is the direct return value from a List render function
+    const current = element.parent;
+    // We need to find if this element is DIRECTLY returned from the render function
+    // This means it should be the immediate child of a return statement or arrow function body
+    // Case 1: Direct return statement - return (<li>...</li>)
+    if (current.type === utils_1.AST_NODE_TYPES.ReturnStatement) {
+        return isInsideListRenderFunction(current);
+    }
+    // Case 2: Arrow function body - ({ key, listItemProps, item }) => (<li>...</li>)
+    if (current.type === utils_1.AST_NODE_TYPES.ArrowFunctionExpression) {
+        return isInsideListRenderFunction(current);
+    }
+    // Case 3: Conditional expression - item ? <li>...</li> : null
+    if (current.type === utils_1.AST_NODE_TYPES.ConditionalExpression) {
+        // Check if the conditional is directly returned or is the arrow function body
+        const conditionalParent = current.parent;
+        if (conditionalParent.type === utils_1.AST_NODE_TYPES.ReturnStatement ||
+            conditionalParent.type === utils_1.AST_NODE_TYPES.ArrowFunctionExpression) {
+            return isInsideListRenderFunction(conditionalParent);
+        }
+    }
+    return false;
+};
+/**
+ * Get the name of a JSX element
+ */
+const getJSXElementName = (element) => {
+    if (element.openingElement.name.type === utils_1.AST_NODE_TYPES.JSXIdentifier) {
+        return element.openingElement.name.name;
+    }
+    return null;
+};
+/**
+ * Check if element is a semantic list item element
+ */
+const isSemanticListItem = (elementName) => {
+    return elementName.toLowerCase() === "li";
+};
+/**
+ * Check if element name is a built-in HTML element (vs custom React component)
+ */
+const isHTMLElement = (elementName) => {
+    // HTML elements are lowercase, React components start with uppercase
+    if (elementName.length === 0) {
+        return false;
+    }
+    const firstChar = elementName[0];
+    if (!firstChar) {
+        return false;
+    }
+    return firstChar === firstChar.toLowerCase();
+};
+exports.requireListItemVirtualizationProps = createRule({
+    name: "require-list-item-virtualization-props",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Require list items within <List> to have VirtualizationListItemProps",
+        },
+        hasSuggestions: true,
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    allowCustomComponents: { type: "boolean" },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            requireVirtualizationProps: "List item '{{elementName}}' must include VirtualizationListItemProps. " +
+                "Spread {{...listItemProps}} or manually specify className, data-index, tabIndex, ref props.",
+            spreadListItemProps: "Spread {...listItemProps} on this element",
+            useSemanticListItem: "Use semantic <li> elements for list items instead of '{{elementName}}'. " +
+                "List items should be <li> elements with proper VirtualizationListItemProps.",
+        },
+    },
+    defaultOptions: [
+        {
+            allowCustomComponents: true,
+        },
+    ],
+    create(context, options) {
+        const config = options[0];
+        return {
+            JSXElement(node) {
+                // Skip if not inside a List render function
+                if (!isListItemElement(node)) {
+                    return;
+                }
+                const elementName = getJSXElementName(node);
+                if (!elementName) {
+                    return;
+                }
+                // Check element type and apply appropriate rules
+                if (isHTMLElement(elementName)) {
+                    // For HTML elements, enforce semantic list items
+                    if (!isSemanticListItem(elementName)) {
+                        context.report({
+                            node: node.openingElement,
+                            messageId: "useSemanticListItem",
+                            data: { elementName },
+                        });
+                        return;
+                    }
+                    // For <li> elements, require virtualization props
+                    if (!hasRequiredVirtualizationProps(node, context)) {
+                        context.report({
+                            node: node.openingElement,
+                            messageId: "requireVirtualizationProps",
+                            data: { elementName },
+                            suggest: [
+                                {
+                                    messageId: "spreadListItemProps",
+                                    fix(fixer) {
+                                        // Add {...listItemProps} as the first attribute
+                                        const openingTag = node.openingElement;
+                                        const firstAttr = openingTag.attributes[0];
+                                        if (firstAttr) {
+                                            return fixer.insertTextBefore(firstAttr, "{...listItemProps} ");
+                                        }
+                                        else {
+                                            // Insert after the element name
+                                            return fixer.insertTextAfter(openingTag.name, " {...listItemProps}");
+                                        }
+                                    },
+                                },
+                            ],
+                        });
+                    }
+                }
+                else {
+                    // For custom components, check allowCustomComponents setting
+                    if (config.allowCustomComponents === false && !hasRequiredVirtualizationProps(node, context)) {
+                        context.report({
+                            node: node.openingElement,
+                            messageId: "requireVirtualizationProps",
+                            data: { elementName },
+                            suggest: [
+                                {
+                                    messageId: "spreadListItemProps",
+                                    fix(fixer) {
+                                        // Add {...listItemProps} as the first attribute
+                                        const openingTag = node.openingElement;
+                                        const firstAttr = openingTag.attributes[0];
+                                        if (firstAttr) {
+                                            return fixer.insertTextBefore(firstAttr, "{...listItemProps} ");
+                                        }
+                                        else {
+                                            // Insert after the element name
+                                            return fixer.insertTextAfter(openingTag.name, " {...listItemProps}");
+                                        }
+                                    },
+                                },
+                            ],
+                        });
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=require-list-item-virtualization-props.js.map

package/src/lib/rules/require-list-item-virtualization-props/require-list-item-virtualization-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-list-item-virtualization-props.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/require-list-item-virtualization-props/require-list-item-virtualization-props.ts"],"names":[],"mappings":"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","sourcesContent":["import { AST_NODE_TYPES, ESLintUtils, TSESLint, TSESTree } from \"@typescript-eslint/utils\";\n\nconst createRule = ESLintUtils.RuleCreator(\n  name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}.ts`\n);\n\ntype Options = [\n  {\n    /**\n     * Whether to allow custom components that extend VirtualizationListItemProps\n     * instead of requiring explicit spreading of listItemProps\n     */\n    allowCustomComponents?: boolean;\n  },\n];\n\ntype MessageIds = \"requireVirtualizationProps\" | \"spreadListItemProps\" | \"useSemanticListItem\";\n\n/**\n * Check if a spread attribute argument contains listItemProps\n */\nconst isListItemPropsSpread = (argument: TSESTree.Expression): boolean => {\n  // Direct identifier: {...listItemProps}\n  if (argument.type === AST_NODE_TYPES.Identifier) {\n    return argument.name === \"listItemProps\" || argument.name.includes(\"ItemProps\");\n  }\n\n  // Member expression: {...params.listItemProps}\n  if (argument.type === AST_NODE_TYPES.MemberExpression) {\n    // Check if property is an identifier (not computed like params[\"listItemProps\"])\n    if (!argument.computed && argument.property.type === AST_NODE_TYPES.Identifier) {\n      const propertyName = argument.property.name;\n      if (propertyName === \"listItemProps\" || propertyName.includes(\"ItemProps\")) {\n        return true;\n      }\n    }\n  }\n\n  return false;\n};\n\n/**\n * Check if a JSX element has the required virtualization props\n */\nconst hasRequiredVirtualizationProps = (\n  element: TSESTree.JSXElement,\n  context: TSESLint.RuleContext<string, ReadonlyArray<unknown>>\n): boolean => {\n  // ref is functionally required for virtualization even though TypeScript marks it optional\n  const requiredProps = [\"className\", \"data-index\", \"tabIndex\", \"ref\"];\n\n  const attributes = element.openingElement.attributes;\n  const propNames = new Set<string>();\n  let hasSpreadListItemProps = false;\n\n  for (const attr of attributes) {\n    if (attr.type === AST_NODE_TYPES.JSXAttribute && attr.name.type === AST_NODE_TYPES.JSXIdentifier) {\n      propNames.add(attr.name.name);\n    } else if (attr.type === AST_NODE_TYPES.JSXSpreadAttribute) {\n      // Check if spreading listItemProps or similar\n      if (isListItemPropsSpread(attr.argument)) {\n        hasSpreadListItemProps = true;\n      } else {\n        // Fallback: check source code text for listItemProps\n        // This handles edge cases where AST structure might be different\n        const sourceCode = context.sourceCode.getText(attr.argument);\n        const hasListItemProps = sourceCode.includes(\"listItemProps\");\n        const hasItemProps = sourceCode.includes(\"ItemProps\");\n        if (hasListItemProps || hasItemProps) {\n          hasSpreadListItemProps = true;\n        }\n      }\n    }\n  }\n\n  // If spreading listItemProps, assume it has all required props\n  if (hasSpreadListItemProps) {\n    return true;\n  }\n\n  // Check if all required props are present\n  return requiredProps.every(prop => propNames.has(prop));\n};\n\n/**\n * Check if we're inside a List component's render function\n */\nconst isInsideListRenderFunction = (node: TSESTree.Node): boolean => {\n  let current: TSESTree.Node | undefined = node.parent;\n\n  while (current) {\n    // Look for JSX element named \"List\"\n    if (\n      current.type === AST_NODE_TYPES.JSXElement &&\n      current.openingElement.name.type === AST_NODE_TYPES.JSXIdentifier &&\n      current.openingElement.name.name === \"List\"\n    ) {\n      return true;\n    }\n    current = current.parent;\n  }\n\n  return false;\n};\n\n/**\n * Check if a JSX element is a direct list item (directly returned from List render function)\n */\nconst isListItemElement = (element: TSESTree.JSXElement): boolean => {\n  // Check if this element is the direct return value from a List render function\n  const current: TSESTree.Node | undefined = element.parent;\n\n  // We need to find if this element is DIRECTLY returned from the render function\n  // This means it should be the immediate child of a return statement or arrow function body\n\n  // Case 1: Direct return statement - return (<li>...</li>)\n  if (current.type === AST_NODE_TYPES.ReturnStatement) {\n    return isInsideListRenderFunction(current);\n  }\n\n  // Case 2: Arrow function body - ({ key, listItemProps, item }) => (<li>...</li>)\n  if (current.type === AST_NODE_TYPES.ArrowFunctionExpression) {\n    return isInsideListRenderFunction(current);\n  }\n\n  // Case 3: Conditional expression - item ? <li>...</li> : null\n  if (current.type === AST_NODE_TYPES.ConditionalExpression) {\n    // Check if the conditional is directly returned or is the arrow function body\n    const conditionalParent = current.parent;\n    if (\n      conditionalParent.type === AST_NODE_TYPES.ReturnStatement ||\n      conditionalParent.type === AST_NODE_TYPES.ArrowFunctionExpression\n    ) {\n      return isInsideListRenderFunction(conditionalParent);\n    }\n  }\n\n  return false;\n};\n\n/**\n * Get the name of a JSX element\n */\nconst getJSXElementName = (element: TSESTree.JSXElement): string | null => {\n  if (element.openingElement.name.type === AST_NODE_TYPES.JSXIdentifier) {\n    return element.openingElement.name.name;\n  }\n  return null;\n};\n\n/**\n * Check if element is a semantic list item element\n */\nconst isSemanticListItem = (elementName: string): boolean => {\n  return elementName.toLowerCase() === \"li\";\n};\n\n/**\n * Check if element name is a built-in HTML element (vs custom React component)\n */\nconst isHTMLElement = (elementName: string): boolean => {\n  // HTML elements are lowercase, React components start with uppercase\n  if (elementName.length === 0) {\n    return false;\n  }\n  const firstChar = elementName[0];\n  if (!firstChar) {\n    return false;\n  }\n  return firstChar === firstChar.toLowerCase();\n};\n\nexport const requireListItemVirtualizationProps = createRule<Options, MessageIds>({\n  name: \"require-list-item-virtualization-props\",\n  meta: {\n    type: \"problem\",\n    docs: {\n      description: \"Require list items within <List> to have VirtualizationListItemProps\",\n    },\n    hasSuggestions: true,\n    schema: [\n      {\n        type: \"object\",\n        properties: {\n          allowCustomComponents: { type: \"boolean\" },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      requireVirtualizationProps:\n        \"List item '{{elementName}}' must include VirtualizationListItemProps. \" +\n        \"Spread {{...listItemProps}} or manually specify className, data-index, tabIndex, ref props.\",\n      spreadListItemProps: \"Spread {...listItemProps} on this element\",\n      useSemanticListItem:\n        \"Use semantic <li> elements for list items instead of '{{elementName}}'. \" +\n        \"List items should be <li> elements with proper VirtualizationListItemProps.\",\n    },\n  },\n  defaultOptions: [\n    {\n      allowCustomComponents: true,\n    },\n  ],\n  create(context, options) {\n    const config = options[0];\n\n    return {\n      JSXElement(node: TSESTree.JSXElement) {\n        // Skip if not inside a List render function\n        if (!isListItemElement(node)) {\n          return;\n        }\n\n        const elementName = getJSXElementName(node);\n        if (!elementName) {\n          return;\n        }\n\n        // Check element type and apply appropriate rules\n        if (isHTMLElement(elementName)) {\n          // For HTML elements, enforce semantic list items\n          if (!isSemanticListItem(elementName)) {\n            context.report({\n              node: node.openingElement,\n              messageId: \"useSemanticListItem\",\n              data: { elementName },\n            });\n            return;\n          }\n\n          // For <li> elements, require virtualization props\n          if (!hasRequiredVirtualizationProps(node, context)) {\n            context.report({\n              node: node.openingElement,\n              messageId: \"requireVirtualizationProps\",\n              data: { elementName },\n              suggest: [\n                {\n                  messageId: \"spreadListItemProps\",\n                  fix(fixer) {\n                    // Add {...listItemProps} as the first attribute\n                    const openingTag = node.openingElement;\n                    const firstAttr = openingTag.attributes[0];\n\n                    if (firstAttr) {\n                      return fixer.insertTextBefore(firstAttr, \"{...listItemProps} \");\n                    } else {\n                      // Insert after the element name\n                      return fixer.insertTextAfter(openingTag.name, \" {...listItemProps}\");\n                    }\n                  },\n                },\n              ],\n            });\n          }\n        } else {\n          // For custom components, check allowCustomComponents setting\n          if (config.allowCustomComponents === false && !hasRequiredVirtualizationProps(node, context)) {\n            context.report({\n              node: node.openingElement,\n              messageId: \"requireVirtualizationProps\",\n              data: { elementName },\n              suggest: [\n                {\n                  messageId: \"spreadListItemProps\",\n                  fix(fixer) {\n                    // Add {...listItemProps} as the first attribute\n                    const openingTag = node.openingElement;\n                    const firstAttr = openingTag.attributes[0];\n\n                    if (firstAttr) {\n                      return fixer.insertTextBefore(firstAttr, \"{...listItemProps} \");\n                    } else {\n                      // Insert after the element name\n                      return fixer.insertTextAfter(openingTag.name, \" {...listItemProps}\");\n                    }\n                  },\n                },\n              ],\n            });\n          }\n        }\n      },\n    };\n  },\n});\n"]}

package/src/lib/rules/require-optional-prop-initialization/require-optional-prop-initialization.d.ts

@@ -0,0 +1,17 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { type MessageIds } from "./suggestion-utils";
+type Options = [
+    {
+        allowNullableObject?: boolean;
+        allowNullableBoolean?: boolean;
+        allowNullableString?: boolean;
+        allowNullableNumber?: boolean;
+        allowNullableEnum?: boolean;
+        allowNullableStringLiteralUnion?: boolean;
+        onlyRequireUsedProps?: boolean;
+    }
+];
+export declare const requireOptionalPropInitialization: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};