@trackunit/eslint-plugin-trackunit 0.0.2

package/src/lib/rules/design-guideline-button-icon-size-match/design-guideline-button-icon-size-match.js

@@ -0,0 +1,297 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.designGuidelineButtonIconSizeMatch = void 0;
+const tslib_1 = require("tslib");
+const utils_1 = require("@typescript-eslint/utils");
+const ts = tslib_1.__importStar(require("typescript"));
+const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/docs/rules/${name}.md`);
+// Helper to get possible string literal values from a variable's type
+function getPossibleStringLiterals(context, identifier) {
+    try {
+        const services = utils_1.ESLintUtils.getParserServices(context);
+        const checker = services.program.getTypeChecker();
+        const tsNode = services.esTreeNodeToTSNodeMap.get(identifier);
+        const type = checker.getTypeAtLocation(tsNode);
+        const literalValues = [];
+        // Type guard for string literal types
+        const isStringLiteralType = (t) => {
+            if ((t.flags & ts.TypeFlags.StringLiteral) === 0) {
+                return false;
+            }
+            // Check if the type has a value property and it's a string
+            // eslint-disable-next-line @trackunit/no-typescript-assertion
+            const typeWithValue = t;
+            return "value" in typeWithValue && typeof typeWithValue.value === "string";
+        };
+        if (type.isUnion()) {
+            for (const unionType of type.types) {
+                if (isStringLiteralType(unionType)) {
+                    literalValues.push(unionType.value);
+                }
+            }
+        }
+        else if (isStringLiteralType(type)) {
+            literalValues.push(type.value);
+        }
+        return literalValues.length > 0 ? literalValues : null;
+    }
+    catch {
+        return null;
+    }
+}
+// Helper to check if a conditional expression matches the expected button-icon size pattern
+function isCorrectConditionalExpression(expression, buttonVariableName) {
+    if (expression.type !== "ConditionalExpression") {
+        return false;
+    }
+    const { test, consequent, alternate } = expression;
+    // Check if test is: variable === "large"
+    if (test.type === "BinaryExpression" &&
+        test.operator === "===" &&
+        test.left.type === "Identifier" &&
+        test.left.name === buttonVariableName &&
+        test.right.type === "Literal" &&
+        test.right.value === "large") {
+        // Check if consequent is "medium" and alternate is "small"
+        return (consequent.type === "Literal" &&
+            consequent.value === "medium" &&
+            alternate.type === "Literal" &&
+            alternate.value === "small");
+    }
+    return false;
+}
+exports.designGuidelineButtonIconSizeMatch = createRule({
+    name: "design-guideline-button-icon-size-match",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Ensure Icon components within Button have the correct size prop based on the Button's size.",
+        },
+        fixable: "code",
+        schema: [],
+        messages: {
+            incorrectIconSize: "Expected Icon size to be '{{expectedSize}}' for Button size '{{buttonSize}}', found '{{iconSize}}'.",
+        },
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            JSXOpeningElement(node) {
+                if (node.name.type === "JSXIdentifier" && node.name.name === "Button") {
+                    const sizeAttr = node.attributes.find((attr) => attr.type === "JSXAttribute" && attr.name.type === "JSXIdentifier" && attr.name.name === "size");
+                    const buttonSizeInfo = (() => {
+                        if (!sizeAttr?.value)
+                            return { type: "implicit", value: null };
+                        if (sizeAttr.value.type === "Literal" && typeof sizeAttr.value.value === "string") {
+                            return { type: "literal", value: sizeAttr.value.value };
+                        }
+                        if (sizeAttr.value.type === "JSXExpressionContainer") {
+                            const expr = sizeAttr.value.expression;
+                            if (expr.type === "Identifier") {
+                                return { type: "variable", value: expr.name, expression: expr };
+                            }
+                            return { type: "expression", value: null, expression: expr };
+                        }
+                        return { type: "implicit", value: null };
+                    })();
+                    node.attributes.forEach(attr => {
+                        if (attr.type === "JSXAttribute" &&
+                            attr.name.type === "JSXIdentifier" &&
+                            (attr.name.name === "prefix" || attr.name.name === "suffix") &&
+                            attr.value?.type === "JSXExpressionContainer") {
+                            // Find Icon element - could be direct or inside conditional
+                            const findIconElement = (expression) => {
+                                if (expression.type === "JSXElement" &&
+                                    expression.openingElement.name.type === "JSXIdentifier" &&
+                                    expression.openingElement.name.name === "Icon") {
+                                    return expression.openingElement;
+                                }
+                                if (expression.type === "ConditionalExpression") {
+                                    // Check both consequent and alternate
+                                    const consequent = findIconElement(expression.consequent);
+                                    if (consequent)
+                                        return consequent;
+                                    const alternate = findIconElement(expression.alternate);
+                                    if (alternate)
+                                        return alternate;
+                                }
+                                return null;
+                            };
+                            // Skip empty JSX expressions like {}
+                            if (attr.value.expression.type === "JSXEmptyExpression")
+                                return;
+                            const iconElement = findIconElement(attr.value.expression);
+                            if (!iconElement)
+                                return;
+                            const iconSizeAttr = iconElement.attributes.find((iconAttr) => iconAttr.type === "JSXAttribute" &&
+                                iconAttr.name.type === "JSXIdentifier" &&
+                                iconAttr.name.name === "size");
+                            const iconSizeInfo = (() => {
+                                if (!iconSizeAttr?.value)
+                                    return { type: "implicit", value: null };
+                                if (iconSizeAttr.value.type === "Literal" && typeof iconSizeAttr.value.value === "string") {
+                                    return { type: "literal", value: iconSizeAttr.value.value };
+                                }
+                                if (iconSizeAttr.value.type === "JSXExpressionContainer") {
+                                    const expr = iconSizeAttr.value.expression;
+                                    if (expr.type === "Identifier") {
+                                        return { type: "variable", value: expr.name, expression: expr };
+                                    }
+                                    return { type: "expression", value: null, expression: expr };
+                                }
+                                return { type: "implicit", value: null };
+                            })();
+                            // Rule: large buttons → medium icons, small/medium buttons → small icons
+                            const getExpectedIconSize = (buttonSize) => {
+                                if (buttonSize === "large")
+                                    return "medium";
+                                return "small"; // both "small" and "medium" buttons get "small" icons
+                            };
+                            const shouldReport = (() => {
+                                // For complex expressions, always warn but don't autofix
+                                if (buttonSizeInfo.type === "expression") {
+                                    return true;
+                                }
+                                // For variables, check if icon already has the correct size
+                                if (buttonSizeInfo.type === "variable" && buttonSizeInfo.expression?.type === "Identifier") {
+                                    const possibleSizes = getPossibleStringLiterals(context, buttonSizeInfo.expression);
+                                    if (possibleSizes) {
+                                        // Check if all possible button sizes map to the same icon size
+                                        const iconSizes = possibleSizes.map(getExpectedIconSize);
+                                        const uniqueIconSizes = [...new Set(iconSizes)];
+                                        if (uniqueIconSizes.length === 1) {
+                                            // All map to same icon size - check if icon already has correct literal
+                                            const variableExpectedIconSize = uniqueIconSizes[0];
+                                            const variableIconEffectiveSize = iconSizeInfo.value || "medium";
+                                            if (variableIconEffectiveSize === variableExpectedIconSize) {
+                                                return false; // Icon already has correct literal size
+                                            }
+                                        }
+                                        else {
+                                            // Mixed mapping - check if icon has correct conditional expression
+                                            if (iconSizeInfo.type === "expression" &&
+                                                iconSizeInfo.expression &&
+                                                iconSizeInfo.expression.type !== "JSXEmptyExpression" &&
+                                                buttonSizeInfo.value &&
+                                                isCorrectConditionalExpression(iconSizeInfo.expression, buttonSizeInfo.value)) {
+                                                return false; // Icon already has correct conditional
+                                            }
+                                        }
+                                    }
+                                    // Mixed mapping or can't determine - always warn
+                                    return true;
+                                }
+                                // For literals and implicit, check the mapping
+                                const buttonEffectiveSize = buttonSizeInfo.value || "medium";
+                                const iconEffectiveSize = iconSizeInfo.value || "medium";
+                                const expectedIconSize = getExpectedIconSize(buttonEffectiveSize);
+                                return iconEffectiveSize !== expectedIconSize;
+                            })();
+                            if (shouldReport) {
+                                context.report({
+                                    node: iconElement,
+                                    messageId: "incorrectIconSize",
+                                    data: {
+                                        expectedSize: (() => {
+                                            if (buttonSizeInfo.type === "variable" && buttonSizeInfo.expression?.type === "Identifier") {
+                                                // Analyze the variable's type to determine expected message
+                                                const possibleSizes = getPossibleStringLiterals(context, buttonSizeInfo.expression);
+                                                if (possibleSizes) {
+                                                    const iconSizes = possibleSizes.map(getExpectedIconSize);
+                                                    const uniqueIconSizes = [...new Set(iconSizes)];
+                                                    if (uniqueIconSizes.length === 1) {
+                                                        return uniqueIconSizes[0];
+                                                    }
+                                                }
+                                                return `{${buttonSizeInfo.value} === "large" ? "medium" : "small"}`;
+                                            }
+                                            if (buttonSizeInfo.type === "expression") {
+                                                return "small (for small/medium buttons) or medium (for large buttons)";
+                                            }
+                                            const buttonEffectiveSize = buttonSizeInfo.value || "medium";
+                                            return getExpectedIconSize(buttonEffectiveSize);
+                                        })(),
+                                        buttonSize: buttonSizeInfo.type === "implicit"
+                                            ? "medium (default)"
+                                            : buttonSizeInfo.type === "literal"
+                                                ? buttonSizeInfo.value
+                                                : buttonSizeInfo.type === "variable"
+                                                    ? (() => {
+                                                        if (buttonSizeInfo.expression?.type === "Identifier") {
+                                                            const possibleSizes = getPossibleStringLiterals(context, buttonSizeInfo.expression);
+                                                            if (possibleSizes && possibleSizes.length > 0) {
+                                                                const sizeList = possibleSizes.map(s => `"${s}"`).join(" | ");
+                                                                return `{${buttonSizeInfo.value}} (of type ${sizeList})`;
+                                                            }
+                                                        }
+                                                        return `{${buttonSizeInfo.value}}`;
+                                                    })()
+                                                    : "expression",
+                                        iconSize: iconSizeInfo.type === "implicit"
+                                            ? "medium (default)"
+                                            : iconSizeInfo.type === "literal"
+                                                ? iconSizeInfo.value
+                                                : iconSizeInfo.type === "variable"
+                                                    ? `{${iconSizeInfo.value}}`
+                                                    : "expression",
+                                    },
+                                    fix(fixer) {
+                                        // Don't autofix complex expressions, only variables and literals
+                                        if (buttonSizeInfo.type === "expression") {
+                                            return null;
+                                        }
+                                        let targetSizeValue;
+                                        if (buttonSizeInfo.type === "variable" && buttonSizeInfo.expression?.type === "Identifier") {
+                                            // Analyze the variable's type to determine optimal autofix
+                                            const possibleSizes = getPossibleStringLiterals(context, buttonSizeInfo.expression);
+                                            if (possibleSizes) {
+                                                // Check if all possible button sizes map to the same icon size
+                                                const iconSizes = possibleSizes.map(getExpectedIconSize);
+                                                const uniqueIconSizes = [...new Set(iconSizes)];
+                                                if (uniqueIconSizes.length === 1) {
+                                                    // All possible button sizes map to the same icon size
+                                                    targetSizeValue = `"${uniqueIconSizes[0]}"`;
+                                                }
+                                                else {
+                                                    // Mixed mapping, use conditional
+                                                    targetSizeValue = `{${buttonSizeInfo.value} === "large" ? "medium" : "small"}`;
+                                                }
+                                            }
+                                            else {
+                                                // Can't determine type, use conditional
+                                                targetSizeValue = `{${buttonSizeInfo.value} === "large" ? "medium" : "small"}`;
+                                            }
+                                        }
+                                        else {
+                                            // Calculate target icon size based on button size (literal or implicit)
+                                            const buttonEffectiveSize = buttonSizeInfo.value || "medium";
+                                            const targetIconSize = getExpectedIconSize(buttonEffectiveSize);
+                                            targetSizeValue = `"${targetIconSize}"`;
+                                        }
+                                        if (iconSizeAttr) {
+                                            // Replace existing size attribute
+                                            if (!iconSizeAttr.value)
+                                                return null;
+                                            return fixer.replaceText(iconSizeAttr.value, targetSizeValue);
+                                        }
+                                        else {
+                                            // Add size attribute
+                                            const lastAttr = iconElement.attributes[iconElement.attributes.length - 1];
+                                            if (lastAttr) {
+                                                return fixer.insertTextAfter(lastAttr, ` size=${targetSizeValue}`);
+                                            }
+                                            else {
+                                                return fixer.insertTextAfter(iconElement.name, ` size=${targetSizeValue}`);
+                                            }
+                                        }
+                                    },
+                                });
+                            }
+                        }
+                    });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=design-guideline-button-icon-size-match.js.map

package/src/lib/rules/design-guideline-button-icon-size-match/design-guideline-button-icon-size-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-guideline-button-icon-size-match.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/design-guideline-button-icon-size-match/design-guideline-button-icon-size-match.ts"],"names":[],"mappings":"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","sourcesContent":["import { ESLintUtils, type TSESLint, type TSESTree } from \"@typescript-eslint/utils\";\nimport * as ts from \"typescript\";\n\nconst createRule = ESLintUtils.RuleCreator(\n  name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/docs/rules/${name}.md`\n);\n\n// Helper to get possible string literal values from a variable's type\nfunction getPossibleStringLiterals(\n  context: TSESLint.RuleContext<string, ReadonlyArray<unknown>>,\n  identifier: TSESTree.Identifier\n): Array<string> | null {\n  try {\n    const services = ESLintUtils.getParserServices(context);\n    const checker = services.program.getTypeChecker();\n    const tsNode = services.esTreeNodeToTSNodeMap.get(identifier);\n    const type = checker.getTypeAtLocation(tsNode);\n\n    const literalValues: Array<string> = [];\n\n    // Type guard for string literal types\n    const isStringLiteralType = (t: ts.Type): t is ts.Type & { value: string } => {\n      if ((t.flags & ts.TypeFlags.StringLiteral) === 0) {\n        return false;\n      }\n      // Check if the type has a value property and it's a string\n      // eslint-disable-next-line @trackunit/no-typescript-assertion\n      const typeWithValue = t as { value?: unknown };\n      return \"value\" in typeWithValue && typeof typeWithValue.value === \"string\";\n    };\n\n    if (type.isUnion()) {\n      for (const unionType of type.types) {\n        if (isStringLiteralType(unionType)) {\n          literalValues.push(unionType.value);\n        }\n      }\n    } else if (isStringLiteralType(type)) {\n      literalValues.push(type.value);\n    }\n\n    return literalValues.length > 0 ? literalValues : null;\n  } catch {\n    return null;\n  }\n}\n\n// Helper to check if a conditional expression matches the expected button-icon size pattern\nfunction isCorrectConditionalExpression(expression: TSESTree.Expression, buttonVariableName: string): boolean {\n  if (expression.type !== \"ConditionalExpression\") {\n    return false;\n  }\n\n  const { test, consequent, alternate } = expression;\n\n  // Check if test is: variable === \"large\"\n  if (\n    test.type === \"BinaryExpression\" &&\n    test.operator === \"===\" &&\n    test.left.type === \"Identifier\" &&\n    test.left.name === buttonVariableName &&\n    test.right.type === \"Literal\" &&\n    test.right.value === \"large\"\n  ) {\n    // Check if consequent is \"medium\" and alternate is \"small\"\n    return (\n      consequent.type === \"Literal\" &&\n      consequent.value === \"medium\" &&\n      alternate.type === \"Literal\" &&\n      alternate.value === \"small\"\n    );\n  }\n\n  return false;\n}\n\nexport const designGuidelineButtonIconSizeMatch = createRule({\n  name: \"design-guideline-button-icon-size-match\",\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description: \"Ensure Icon components within Button have the correct size prop based on the Button's size.\",\n    },\n    fixable: \"code\",\n    schema: [],\n    messages: {\n      incorrectIconSize:\n        \"Expected Icon size to be '{{expectedSize}}' for Button size '{{buttonSize}}', found '{{iconSize}}'.\",\n    },\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      JSXOpeningElement(node: TSESTree.JSXOpeningElement) {\n        if (node.name.type === \"JSXIdentifier\" && node.name.name === \"Button\") {\n          const sizeAttr = node.attributes.find(\n            (attr): attr is TSESTree.JSXAttribute =>\n              attr.type === \"JSXAttribute\" && attr.name.type === \"JSXIdentifier\" && attr.name.name === \"size\"\n          );\n\n          const buttonSizeInfo = (() => {\n            if (!sizeAttr?.value) return { type: \"implicit\", value: null };\n\n            if (sizeAttr.value.type === \"Literal\" && typeof sizeAttr.value.value === \"string\") {\n              return { type: \"literal\", value: sizeAttr.value.value };\n            }\n\n            if (sizeAttr.value.type === \"JSXExpressionContainer\") {\n              const expr = sizeAttr.value.expression;\n              if (expr.type === \"Identifier\") {\n                return { type: \"variable\", value: expr.name, expression: expr };\n              }\n              return { type: \"expression\", value: null, expression: expr };\n            }\n\n            return { type: \"implicit\", value: null };\n          })();\n\n          node.attributes.forEach(attr => {\n            if (\n              attr.type === \"JSXAttribute\" &&\n              attr.name.type === \"JSXIdentifier\" &&\n              (attr.name.name === \"prefix\" || attr.name.name === \"suffix\") &&\n              attr.value?.type === \"JSXExpressionContainer\"\n            ) {\n              // Find Icon element - could be direct or inside conditional\n              const findIconElement = (expression: TSESTree.Expression): TSESTree.JSXOpeningElement | null => {\n                if (\n                  expression.type === \"JSXElement\" &&\n                  expression.openingElement.name.type === \"JSXIdentifier\" &&\n                  expression.openingElement.name.name === \"Icon\"\n                ) {\n                  return expression.openingElement;\n                }\n\n                if (expression.type === \"ConditionalExpression\") {\n                  // Check both consequent and alternate\n                  const consequent = findIconElement(expression.consequent);\n                  if (consequent) return consequent;\n\n                  const alternate = findIconElement(expression.alternate);\n                  if (alternate) return alternate;\n                }\n\n                return null;\n              };\n\n              // Skip empty JSX expressions like {}\n              if (attr.value.expression.type === \"JSXEmptyExpression\") return;\n\n              const iconElement = findIconElement(attr.value.expression);\n              if (!iconElement) return;\n              const iconSizeAttr = iconElement.attributes.find(\n                (iconAttr): iconAttr is TSESTree.JSXAttribute =>\n                  iconAttr.type === \"JSXAttribute\" &&\n                  iconAttr.name.type === \"JSXIdentifier\" &&\n                  iconAttr.name.name === \"size\"\n              );\n\n              const iconSizeInfo = (() => {\n                if (!iconSizeAttr?.value) return { type: \"implicit\", value: null };\n\n                if (iconSizeAttr.value.type === \"Literal\" && typeof iconSizeAttr.value.value === \"string\") {\n                  return { type: \"literal\", value: iconSizeAttr.value.value };\n                }\n\n                if (iconSizeAttr.value.type === \"JSXExpressionContainer\") {\n                  const expr = iconSizeAttr.value.expression;\n                  if (expr.type === \"Identifier\") {\n                    return { type: \"variable\", value: expr.name, expression: expr };\n                  }\n                  return { type: \"expression\", value: null, expression: expr };\n                }\n\n                return { type: \"implicit\", value: null };\n              })();\n\n              // Rule: large buttons → medium icons, small/medium buttons → small icons\n              const getExpectedIconSize = (buttonSize: string): string => {\n                if (buttonSize === \"large\") return \"medium\";\n                return \"small\"; // both \"small\" and \"medium\" buttons get \"small\" icons\n              };\n\n              const shouldReport = (() => {\n                // For complex expressions, always warn but don't autofix\n                if (buttonSizeInfo.type === \"expression\") {\n                  return true;\n                }\n\n                // For variables, check if icon already has the correct size\n                if (buttonSizeInfo.type === \"variable\" && buttonSizeInfo.expression?.type === \"Identifier\") {\n                  const possibleSizes = getPossibleStringLiterals(context, buttonSizeInfo.expression);\n\n                  if (possibleSizes) {\n                    // Check if all possible button sizes map to the same icon size\n                    const iconSizes = possibleSizes.map(getExpectedIconSize);\n                    const uniqueIconSizes = [...new Set(iconSizes)];\n\n                    if (uniqueIconSizes.length === 1) {\n                      // All map to same icon size - check if icon already has correct literal\n                      const variableExpectedIconSize = uniqueIconSizes[0];\n                      const variableIconEffectiveSize = iconSizeInfo.value || \"medium\";\n\n                      if (variableIconEffectiveSize === variableExpectedIconSize) {\n                        return false; // Icon already has correct literal size\n                      }\n                    } else {\n                      // Mixed mapping - check if icon has correct conditional expression\n                      if (\n                        iconSizeInfo.type === \"expression\" &&\n                        iconSizeInfo.expression &&\n                        iconSizeInfo.expression.type !== \"JSXEmptyExpression\" &&\n                        buttonSizeInfo.value &&\n                        isCorrectConditionalExpression(iconSizeInfo.expression, buttonSizeInfo.value)\n                      ) {\n                        return false; // Icon already has correct conditional\n                      }\n                    }\n                  }\n\n                  // Mixed mapping or can't determine - always warn\n                  return true;\n                }\n\n                // For literals and implicit, check the mapping\n                const buttonEffectiveSize = buttonSizeInfo.value || \"medium\";\n                const iconEffectiveSize = iconSizeInfo.value || \"medium\";\n                const expectedIconSize = getExpectedIconSize(buttonEffectiveSize);\n\n                return iconEffectiveSize !== expectedIconSize;\n              })();\n\n              if (shouldReport) {\n                context.report({\n                  node: iconElement,\n                  messageId: \"incorrectIconSize\",\n                  data: {\n                    expectedSize: (() => {\n                      if (buttonSizeInfo.type === \"variable\" && buttonSizeInfo.expression?.type === \"Identifier\") {\n                        // Analyze the variable's type to determine expected message\n                        const possibleSizes = getPossibleStringLiterals(context, buttonSizeInfo.expression);\n\n                        if (possibleSizes) {\n                          const iconSizes = possibleSizes.map(getExpectedIconSize);\n                          const uniqueIconSizes = [...new Set(iconSizes)];\n\n                          if (uniqueIconSizes.length === 1) {\n                            return uniqueIconSizes[0];\n                          }\n                        }\n\n                        return `{${buttonSizeInfo.value} === \"large\" ? \"medium\" : \"small\"}`;\n                      }\n                      if (buttonSizeInfo.type === \"expression\") {\n                        return \"small (for small/medium buttons) or medium (for large buttons)\";\n                      }\n                      const buttonEffectiveSize = buttonSizeInfo.value || \"medium\";\n                      return getExpectedIconSize(buttonEffectiveSize);\n                    })(),\n                    buttonSize:\n                      buttonSizeInfo.type === \"implicit\"\n                        ? \"medium (default)\"\n                        : buttonSizeInfo.type === \"literal\"\n                          ? buttonSizeInfo.value\n                          : buttonSizeInfo.type === \"variable\"\n                            ? (() => {\n                                if (buttonSizeInfo.expression?.type === \"Identifier\") {\n                                  const possibleSizes = getPossibleStringLiterals(context, buttonSizeInfo.expression);\n                                  if (possibleSizes && possibleSizes.length > 0) {\n                                    const sizeList = possibleSizes.map(s => `\"${s}\"`).join(\" | \");\n                                    return `{${buttonSizeInfo.value}} (of type ${sizeList})`;\n                                  }\n                                }\n                                return `{${buttonSizeInfo.value}}`;\n                              })()\n                            : \"expression\",\n                    iconSize:\n                      iconSizeInfo.type === \"implicit\"\n                        ? \"medium (default)\"\n                        : iconSizeInfo.type === \"literal\"\n                          ? iconSizeInfo.value\n                          : iconSizeInfo.type === \"variable\"\n                            ? `{${iconSizeInfo.value}}`\n                            : \"expression\",\n                  },\n                  fix(fixer) {\n                    // Don't autofix complex expressions, only variables and literals\n                    if (buttonSizeInfo.type === \"expression\") {\n                      return null;\n                    }\n\n                    let targetSizeValue: string;\n\n                    if (buttonSizeInfo.type === \"variable\" && buttonSizeInfo.expression?.type === \"Identifier\") {\n                      // Analyze the variable's type to determine optimal autofix\n                      const possibleSizes = getPossibleStringLiterals(context, buttonSizeInfo.expression);\n\n                      if (possibleSizes) {\n                        // Check if all possible button sizes map to the same icon size\n                        const iconSizes = possibleSizes.map(getExpectedIconSize);\n                        const uniqueIconSizes = [...new Set(iconSizes)];\n\n                        if (uniqueIconSizes.length === 1) {\n                          // All possible button sizes map to the same icon size\n                          targetSizeValue = `\"${uniqueIconSizes[0]}\"`;\n                        } else {\n                          // Mixed mapping, use conditional\n                          targetSizeValue = `{${buttonSizeInfo.value} === \"large\" ? \"medium\" : \"small\"}`;\n                        }\n                      } else {\n                        // Can't determine type, use conditional\n                        targetSizeValue = `{${buttonSizeInfo.value} === \"large\" ? \"medium\" : \"small\"}`;\n                      }\n                    } else {\n                      // Calculate target icon size based on button size (literal or implicit)\n                      const buttonEffectiveSize = buttonSizeInfo.value || \"medium\";\n                      const targetIconSize = getExpectedIconSize(buttonEffectiveSize);\n                      targetSizeValue = `\"${targetIconSize}\"`;\n                    }\n\n                    if (iconSizeAttr) {\n                      // Replace existing size attribute\n                      if (!iconSizeAttr.value) return null;\n                      return fixer.replaceText(iconSizeAttr.value, targetSizeValue);\n                    } else {\n                      // Add size attribute\n                      const lastAttr = iconElement.attributes[iconElement.attributes.length - 1];\n                      if (lastAttr) {\n                        return fixer.insertTextAfter(lastAttr, ` size=${targetSizeValue}`);\n                      } else {\n                        return fixer.insertTextAfter(iconElement.name, ` size=${targetSizeValue}`);\n                      }\n                    }\n                  },\n                });\n              }\n            }\n          });\n        }\n      },\n    };\n  },\n});\n"]}

package/src/lib/rules/no-internal-barrel-files/examples.d.ts

@@ -0,0 +1,80 @@
+/**
+ * This file documents the no-internal-barrel-files rule.
+ *
+ * Unlike other ESLint rules that check code patterns, this rule checks FILE LOCATION.
+ * The rule triggers on any index.ts or index.tsx file that is NOT the root barrel
+ * of an NX project (i.e., not at src/index.ts or src/index.tsx).
+ *
+ * This examples.ts file itself will NOT trigger the rule because it's not named index.ts.
+ *
+ * ## ✅ VALID - Root barrel file (allowed)
+ *
+ * ```
+ * libs/my-lib/
+ * ├── project.json
+ * └── src/
+ *     └── index.ts          ← This is the root barrel, allowed
+ * ```
+ *
+ * Content of src/index.ts:
+ * ```ts
+ * export { Button } from "./components/Button";
+ * export { useHook } from "./hooks/useHook";
+ * export type { ButtonProps } from "./components/Button";
+ * ```
+ *
+ * ## ❌ INVALID - Internal barrel files (SHOULD be flagged)
+ *
+ * ```
+ * libs/my-lib/
+ * ├── project.json
+ * └── src/
+ *     ├── index.ts          ← Root barrel (allowed)
+ *     ├── components/
+ *     │   ├── index.ts      ← VIOLATION: Internal barrel
+ *     │   └── Button.tsx
+ *     └── utils/
+ *         ├── index.ts      ← VIOLATION: Internal barrel
+ *         └── helpers.ts
+ * ```
+ *
+ * ## ❌ INVALID - Deeply nested barrel files (SHOULD be flagged)
+ *
+ * ```
+ * libs/my-lib/
+ * ├── project.json
+ * └── src/
+ *     └── features/
+ *         └── auth/
+ *             └── index.ts  ← VIOLATION: Internal barrel
+ * ```
+ *
+ * ## How to fix violations
+ *
+ * Option 1: Use the flatten-barrel-exports tool
+ * ```bash
+ * yarn ts-node devtools/flatten-barrel-exports/flatten-barrel-exports.ts --project=my-lib
+ * ```
+ *
+ * Option 2: Manually move exports to the root barrel
+ *
+ * Before (with internal barrel):
+ * ```ts
+ * // src/components/index.ts
+ * export { Button } from "./Button";
+ * export { Input } from "./Input";
+ *
+ * // src/index.ts
+ * export * from "./components";  // Re-exports the internal barrel
+ * ```
+ *
+ * After (flattened):
+ * ```ts
+ * // src/index.ts
+ * export { Button } from "./components/Button";
+ * export { Input } from "./components/Input";
+ *
+ * // src/components/index.ts - DELETE THIS FILE
+ * ```
+ */
+export {};

package/src/lib/rules/no-internal-barrel-files/examples.js

@@ -0,0 +1,84 @@
+"use strict";
+// To test this rule: create an index.ts file in a subdirectory and run lint
+// Note: eslint-disable is not needed here because this file is not named index.ts
+/**
+ * This file documents the no-internal-barrel-files rule.
+ *
+ * Unlike other ESLint rules that check code patterns, this rule checks FILE LOCATION.
+ * The rule triggers on any index.ts or index.tsx file that is NOT the root barrel
+ * of an NX project (i.e., not at src/index.ts or src/index.tsx).
+ *
+ * This examples.ts file itself will NOT trigger the rule because it's not named index.ts.
+ *
+ * ## ✅ VALID - Root barrel file (allowed)
+ *
+ * ```
+ * libs/my-lib/
+ * ├── project.json
+ * └── src/
+ *     └── index.ts          ← This is the root barrel, allowed
+ * ```
+ *
+ * Content of src/index.ts:
+ * ```ts
+ * export { Button } from "./components/Button";
+ * export { useHook } from "./hooks/useHook";
+ * export type { ButtonProps } from "./components/Button";
+ * ```
+ *
+ * ## ❌ INVALID - Internal barrel files (SHOULD be flagged)
+ *
+ * ```
+ * libs/my-lib/
+ * ├── project.json
+ * └── src/
+ *     ├── index.ts          ← Root barrel (allowed)
+ *     ├── components/
+ *     │   ├── index.ts      ← VIOLATION: Internal barrel
+ *     │   └── Button.tsx
+ *     └── utils/
+ *         ├── index.ts      ← VIOLATION: Internal barrel
+ *         └── helpers.ts
+ * ```
+ *
+ * ## ❌ INVALID - Deeply nested barrel files (SHOULD be flagged)
+ *
+ * ```
+ * libs/my-lib/
+ * ├── project.json
+ * └── src/
+ *     └── features/
+ *         └── auth/
+ *             └── index.ts  ← VIOLATION: Internal barrel
+ * ```
+ *
+ * ## How to fix violations
+ *
+ * Option 1: Use the flatten-barrel-exports tool
+ * ```bash
+ * yarn ts-node devtools/flatten-barrel-exports/flatten-barrel-exports.ts --project=my-lib
+ * ```
+ *
+ * Option 2: Manually move exports to the root barrel
+ *
+ * Before (with internal barrel):
+ * ```ts
+ * // src/components/index.ts
+ * export { Button } from "./Button";
+ * export { Input } from "./Input";
+ *
+ * // src/index.ts
+ * export * from "./components";  // Re-exports the internal barrel
+ * ```
+ *
+ * After (flattened):
+ * ```ts
+ * // src/index.ts
+ * export { Button } from "./components/Button";
+ * export { Input } from "./components/Input";
+ *
+ * // src/components/index.ts - DELETE THIS FILE
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=examples.js.map

package/src/lib/rules/no-internal-barrel-files/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/no-internal-barrel-files/examples.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,kFAAkF;AAClF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG","sourcesContent":["// To test this rule: create an index.ts file in a subdirectory and run lint\n// Note: eslint-disable is not needed here because this file is not named index.ts\n/**\n * This file documents the no-internal-barrel-files rule.\n *\n * Unlike other ESLint rules that check code patterns, this rule checks FILE LOCATION.\n * The rule triggers on any index.ts or index.tsx file that is NOT the root barrel\n * of an NX project (i.e., not at src/index.ts or src/index.tsx).\n *\n * This examples.ts file itself will NOT trigger the rule because it's not named index.ts.\n *\n * ## ✅ VALID - Root barrel file (allowed)\n *\n * ```\n * libs/my-lib/\n * ├── project.json\n * └── src/\n *     └── index.ts          ← This is the root barrel, allowed\n * ```\n *\n * Content of src/index.ts:\n * ```ts\n * export { Button } from \"./components/Button\";\n * export { useHook } from \"./hooks/useHook\";\n * export type { ButtonProps } from \"./components/Button\";\n * ```\n *\n * ## ❌ INVALID - Internal barrel files (SHOULD be flagged)\n *\n * ```\n * libs/my-lib/\n * ├── project.json\n * └── src/\n *     ├── index.ts          ← Root barrel (allowed)\n *     ├── components/\n *     │   ├── index.ts      ← VIOLATION: Internal barrel\n *     │   └── Button.tsx\n *     └── utils/\n *         ├── index.ts      ← VIOLATION: Internal barrel\n *         └── helpers.ts\n * ```\n *\n * ## ❌ INVALID - Deeply nested barrel files (SHOULD be flagged)\n *\n * ```\n * libs/my-lib/\n * ├── project.json\n * └── src/\n *     └── features/\n *         └── auth/\n *             └── index.ts  ← VIOLATION: Internal barrel\n * ```\n *\n * ## How to fix violations\n *\n * Option 1: Use the flatten-barrel-exports tool\n * ```bash\n * yarn ts-node devtools/flatten-barrel-exports/flatten-barrel-exports.ts --project=my-lib\n * ```\n *\n * Option 2: Manually move exports to the root barrel\n *\n * Before (with internal barrel):\n * ```ts\n * // src/components/index.ts\n * export { Button } from \"./Button\";\n * export { Input } from \"./Input\";\n *\n * // src/index.ts\n * export * from \"./components\";  // Re-exports the internal barrel\n * ```\n *\n * After (flattened):\n * ```ts\n * // src/index.ts\n * export { Button } from \"./components/Button\";\n * export { Input } from \"./components/Input\";\n *\n * // src/components/index.ts - DELETE THIS FILE\n * ```\n */\n\nexport {};\n"]}

package/src/lib/rules/no-internal-barrel-files/no-internal-barrel-files.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ESLint rule to disallow internal barrel files.
+ *
+ * Internal barrel files (any index.ts or index.tsx that is not at the library root) cause:
+ * - Multiple import paths to the same module
+ * - Slower builds (bundlers must traverse more barrel files)
+ * - Confusion about canonical import paths
+ * - Potential bundle size issues
+ * - Module identity problems
+ *
+ * EXCEPTION: Secondary entry points configured in tsconfig.base.json are allowed.
+ * These are intentional barrel files that provide separate package imports
+ * (e.g., @trackunit/react-core-contexts-host-test pointing to src/test/index.ts).
+ *
+ * @example
+ * // Valid - Root barrel file
+ * // libs/my-lib/src/index.ts ✅
+ *
+ * // Valid - Secondary entry point configured in tsconfig.base.json
+ * // libs/my-lib/src/test/index.ts ✅ (if configured as @trackunit/my-lib-test)
+ *
+ * // Invalid - Internal barrel file
+ * // libs/my-lib/src/components/index.ts ❌
+ * // libs/my-lib/src/utils/helpers/index.ts ❌
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+export declare const noInternalBarrelFiles: ESLintUtils.RuleModule<"noInternalBarrel", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};