@trackunit/eslint-plugin-trackunit 0.0.2

package/src/lib/config/presets/react.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reactPreset = void 0;
+const react_rules_1 = require("../fragments/react-rules");
+const testing_library_1 = require("../fragments/testing-library");
+const plugins_1 = require("../plugins");
+exports.reactPreset = [
+    ...(plugins_1.storybook.configs["flat/recommended"] ?? []),
+    {
+        plugins: {
+            "@trackunit": plugins_1.localRulesPlugin,
+            "@typescript-eslint": plugins_1.typescriptEslint,
+            jsdoc: plugins_1.jsdoc,
+            react: plugins_1.react,
+            "react-hooks": plugins_1.reactHooks,
+            "testing-library": plugins_1.testingLibrary,
+            "@nx": plugins_1.nx,
+        },
+        settings: {
+            react: {
+                version: "detect",
+            },
+        },
+        languageOptions: {
+            globals: {
+                ...plugins_1.globals.browser,
+                ...plugins_1.jest.environments.globals.globals,
+                ...plugins_1.globals.node,
+                Text: "writable",
+                screen: "writable",
+            },
+            parser: plugins_1.tsParser,
+            ecmaVersion: 2022,
+            sourceType: "commonjs",
+            parserOptions: {
+                ecmaFeatures: {
+                    jsx: true,
+                },
+            },
+        },
+    },
+    {
+        files: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"],
+        rules: {
+            ...react_rules_1.reactCustomRules,
+            "no-multiple-empty-lines": [
+                "error",
+                {
+                    max: 1,
+                },
+            ],
+            "no-unreachable": "error",
+            "prefer-spread": "error",
+            ...react_rules_1.reactRules,
+            "no-restricted-syntax": [
+                "warn",
+                {
+                    selector: "TSEnumDeclaration",
+                    message: "Please use string literal union or objects instead of enums.",
+                },
+            ],
+        },
+    },
+    {
+        files: ["**/*.stories.ts", "**/*.stories.tsx"],
+        rules: {
+            "jsdoc/require-jsdoc": "off",
+            "no-console": "off",
+            "@typescript-eslint/no-empty-function": "off",
+        },
+    },
+    {
+        files: ["**/*.spec.ts", "**/*.spec.tsx"],
+        plugins: {
+            jest: plugins_1.jest,
+            "testing-library": plugins_1.testingLibrary,
+        },
+        languageOptions: {
+            globals: {
+                ...plugins_1.globals.browser,
+                ...plugins_1.jest.environments.globals.globals,
+                ...plugins_1.globals.node,
+                Text: "writable",
+                screen: "writable",
+            },
+            parser: plugins_1.tsParser,
+        },
+        rules: {
+            ...plugins_1.jest.configs.recommended.rules,
+            ...plugins_1.jest.configs.style.rules,
+            ...testing_library_1.reactTestingLibraryRules,
+            "jest/no-commented-out-tests": "error",
+            "jest/expect-expect": "error",
+        },
+    },
+];
+//# sourceMappingURL=react.js.map

package/src/lib/config/presets/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/config/presets/react.ts"],"names":[],"mappings":";;;AAAA,0DAAwE;AACxE,kEAAwE;AACxE,wCAYoB;AAEP,QAAA,WAAW,GAAG;IACzB,GAAG,CAAC,mBAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC;IAChD;QACE,OAAO,EAAE;YACP,YAAY,EAAE,0BAAgB;YAC9B,oBAAoB,EAAE,0BAAgB;YACtC,KAAK,EAAL,eAAK;YACL,KAAK,EAAL,eAAK;YACL,aAAa,EAAE,oBAAU;YACzB,iBAAiB,EAAE,wBAAc;YACjC,KAAK,EAAE,YAAE;SACV;QAED,QAAQ,EAAE;YACR,KAAK,EAAE;gBACL,OAAO,EAAE,QAAQ;aAClB;SACF;QACD,eAAe,EAAE;YACf,OAAO,EAAE;gBACP,GAAG,iBAAO,CAAC,OAAO;gBAClB,GAAG,cAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO;gBACpC,GAAG,iBAAO,CAAC,IAAI;gBACf,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,UAAU;aACnB;YACD,MAAM,EAAE,kBAAQ;YAChB,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,UAAU;YACtB,aAAa,EAAE;gBACb,YAAY,EAAE;oBACZ,GAAG,EAAE,IAAI;iBACV;aACF;SACF;KACF;IACD;QACE,KAAK,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC;QACrD,KAAK,EAAE;YACL,GAAG,8BAAgB;YAEnB,yBAAyB,EAAE;gBACzB,OAAO;gBACP;oBACE,GAAG,EAAE,CAAC;iBACP;aACF;YAED,gBAAgB,EAAE,OAAO;YACzB,eAAe,EAAE,OAAO;YAExB,GAAG,wBAAU;YAEb,sBAAsB,EAAE;gBACtB,MAAM;gBACN;oBACE,QAAQ,EAAE,mBAAmB;oBAC7B,OAAO,EAAE,8DAA8D;iBACxE;aACF;SACF;KACF;IACD;QACE,KAAK,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;QAC9C,KAAK,EAAE;YACL,qBAAqB,EAAE,KAAK;YAC5B,YAAY,EAAE,KAAK;YACnB,sCAAsC,EAAE,KAAK;SAC9C;KACF;IACD;QACE,KAAK,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;QAExC,OAAO,EAAE;YACP,IAAI,EAAJ,cAAI;YACJ,iBAAiB,EAAE,wBAAc;SAClC;QACD,eAAe,EAAE;YACf,OAAO,EAAE;gBACP,GAAG,iBAAO,CAAC,OAAO;gBAClB,GAAG,cAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO;gBACpC,GAAG,iBAAO,CAAC,IAAI;gBACf,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,UAAU;aACnB;YAED,MAAM,EAAE,kBAAQ;SACjB;QAED,KAAK,EAAE;YACL,GAAG,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK;YACjC,GAAG,cAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;YAC3B,GAAG,0CAAwB;YAC3B,6BAA6B,EAAE,OAAO;YACtC,oBAAoB,EAAE,OAAO;SAC9B;KACF;CACF,CAAC","sourcesContent":["import { reactCustomRules, reactRules } from \"../fragments/react-rules\";\nimport { reactTestingLibraryRules } from \"../fragments/testing-library\";\nimport {\n  globals,\n  jest,\n  jsdoc,\n  localRulesPlugin,\n  nx,\n  react,\n  reactHooks,\n  storybook,\n  testingLibrary,\n  tsParser,\n  typescriptEslint,\n} from \"../plugins\";\n\nexport const reactPreset = [\n  ...(storybook.configs[\"flat/recommended\"] ?? []),\n  {\n    plugins: {\n      \"@trackunit\": localRulesPlugin,\n      \"@typescript-eslint\": typescriptEslint,\n      jsdoc,\n      react,\n      \"react-hooks\": reactHooks,\n      \"testing-library\": testingLibrary,\n      \"@nx\": nx,\n    },\n\n    settings: {\n      react: {\n        version: \"detect\",\n      },\n    },\n    languageOptions: {\n      globals: {\n        ...globals.browser,\n        ...jest.environments.globals.globals,\n        ...globals.node,\n        Text: \"writable\",\n        screen: \"writable\",\n      },\n      parser: tsParser,\n      ecmaVersion: 2022,\n      sourceType: \"commonjs\",\n      parserOptions: {\n        ecmaFeatures: {\n          jsx: true,\n        },\n      },\n    },\n  },\n  {\n    files: [\"**/*.ts\", \"**/*.tsx\", \"**/*.js\", \"**/*.jsx\"],\n    rules: {\n      ...reactCustomRules,\n\n      \"no-multiple-empty-lines\": [\n        \"error\",\n        {\n          max: 1,\n        },\n      ],\n\n      \"no-unreachable\": \"error\",\n      \"prefer-spread\": \"error\",\n\n      ...reactRules,\n\n      \"no-restricted-syntax\": [\n        \"warn\",\n        {\n          selector: \"TSEnumDeclaration\",\n          message: \"Please use string literal union or objects instead of enums.\",\n        },\n      ],\n    },\n  },\n  {\n    files: [\"**/*.stories.ts\", \"**/*.stories.tsx\"],\n    rules: {\n      \"jsdoc/require-jsdoc\": \"off\",\n      \"no-console\": \"off\",\n      \"@typescript-eslint/no-empty-function\": \"off\",\n    },\n  },\n  {\n    files: [\"**/*.spec.ts\", \"**/*.spec.tsx\"],\n\n    plugins: {\n      jest,\n      \"testing-library\": testingLibrary,\n    },\n    languageOptions: {\n      globals: {\n        ...globals.browser,\n        ...jest.environments.globals.globals,\n        ...globals.node,\n        Text: \"writable\",\n        screen: \"writable\",\n      },\n\n      parser: tsParser,\n    },\n\n    rules: {\n      ...jest.configs.recommended.rules,\n      ...jest.configs.style.rules,\n      ...reactTestingLibraryRules,\n      \"jest/no-commented-out-tests\": \"error\",\n      \"jest/expect-expect\": \"error\",\n    },\n  },\n];\n"]}

package/src/lib/config/presets/server.d.ts

@@ -0,0 +1,36 @@
+export declare const server: ({
+    languageOptions: {
+        globals: {
+            [x: string]: boolean | "readonly" | "writable";
+        };
+        parser: import("eslint").Linter.Parser;
+        parserOptions?: undefined;
+    };
+    files?: undefined;
+    plugins?: undefined;
+    rules?: undefined;
+} | {
+    files: string[];
+    plugins: {
+        jsdoc: {
+            rules: Record<string, import("eslint").Rule.RuleModule>;
+            configs: Record<string, import("eslint").Linter.Config>;
+        };
+        "type-graphql": {
+            rules: Record<string, import("eslint").Rule.RuleModule>;
+        };
+    };
+    languageOptions: {
+        parserOptions: {
+            project: string[];
+        };
+        globals?: undefined;
+        parser?: undefined;
+    };
+    rules: {
+        "type-graphql/missing-decorator-type": string[];
+        "type-graphql/invalid-nullable-output-type": string;
+        "type-graphql/wrong-decorator-signature": string;
+        "type-graphql/invalid-nullable-input-type": string;
+    };
+})[];

package/src/lib/config/presets/server.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.server = void 0;
+const tslib_1 = require("tslib");
+const compat_1 = require("@eslint/compat");
+const typeGraphql = tslib_1.__importStar(require("eslint-plugin-type-graphql"));
+const plugins_1 = require("../plugins");
+exports.server = [
+    {
+        languageOptions: {
+            globals: {
+                ...plugins_1.globals.browser,
+            },
+            parser: plugins_1.tsParser,
+        },
+    },
+    {
+        files: ["**/*.ts", "**/*.js"],
+        plugins: {
+            jsdoc: plugins_1.jsdoc,
+            "type-graphql": (0, compat_1.fixupPluginRules)(typeGraphql),
+        },
+        languageOptions: {
+            parserOptions: {
+                project: ["./tsconfig.*?.json"],
+            },
+        },
+        rules: {
+            ...typeGraphql.configs.recommended.rules,
+            "type-graphql/missing-decorator-type": ["error", "all"],
+            "type-graphql/invalid-nullable-output-type": "off",
+            "type-graphql/wrong-decorator-signature": "error",
+            "type-graphql/invalid-nullable-input-type": "off",
+        },
+    },
+];
+//# sourceMappingURL=server.js.map

package/src/lib/config/presets/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/config/presets/server.ts"],"names":[],"mappings":";;;;AAAA,2CAAkD;AAClD,gFAA0D;AAE1D,wCAAsD;AAEzC,QAAA,MAAM,GAAG;IACpB;QACE,eAAe,EAAE;YACf,OAAO,EAAE;gBACP,GAAG,iBAAO,CAAC,OAAO;aACnB;YAED,MAAM,EAAE,kBAAQ;SACjB;KACF;IACD;QACE,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC7B,OAAO,EAAE;YACP,KAAK,EAAL,eAAK;YACL,cAAc,EAAE,IAAA,yBAAgB,EAAC,WAAW,CAAC;SAC9C;QACD,eAAe,EAAE;YACf,aAAa,EAAE;gBACb,OAAO,EAAE,CAAC,oBAAoB,CAAC;aAChC;SACF;QAED,KAAK,EAAE;YACL,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK;YACxC,qCAAqC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;YACvD,2CAA2C,EAAE,KAAK;YAClD,wCAAwC,EAAE,OAAO;YACjD,0CAA0C,EAAE,KAAK;SAClD;KACF;CACF,CAAC","sourcesContent":["import { fixupPluginRules } from \"@eslint/compat\";\nimport * as typeGraphql from \"eslint-plugin-type-graphql\";\n\nimport { globals, jsdoc, tsParser } from \"../plugins\";\n\nexport const server = [\n  {\n    languageOptions: {\n      globals: {\n        ...globals.browser,\n      },\n\n      parser: tsParser,\n    },\n  },\n  {\n    files: [\"**/*.ts\", \"**/*.js\"],\n    plugins: {\n      jsdoc,\n      \"type-graphql\": fixupPluginRules(typeGraphql),\n    },\n    languageOptions: {\n      parserOptions: {\n        project: [\"./tsconfig.*?.json\"],\n      },\n    },\n\n    rules: {\n      ...typeGraphql.configs.recommended.rules,\n      \"type-graphql/missing-decorator-type\": [\"error\", \"all\"],\n      \"type-graphql/invalid-nullable-output-type\": \"off\",\n      \"type-graphql/wrong-decorator-signature\": \"error\",\n      \"type-graphql/invalid-nullable-input-type\": \"off\",\n    },\n  },\n];\n"]}

package/src/lib/config/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Finds the monorepo root by walking up from the config package directory
+ * until a directory containing nx.json is found.
+ * Falls back to process.cwd() if no nx.json is found.
+ */
+export declare function findMonorepoRoot(): string;

package/src/lib/config/utils.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findMonorepoRoot = findMonorepoRoot;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+let cachedRoot;
+/**
+ * Finds the monorepo root by walking up from the config package directory
+ * until a directory containing nx.json is found.
+ * Falls back to process.cwd() if no nx.json is found.
+ */
+function findMonorepoRoot() {
+    if (cachedRoot !== undefined) {
+        return cachedRoot;
+    }
+    let dir = __dirname;
+    while (dir !== path.dirname(dir)) {
+        if (fs.existsSync(path.join(dir, "nx.json"))) {
+            cachedRoot = dir;
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    cachedRoot = process.cwd();
+    return cachedRoot;
+}
+//# sourceMappingURL=utils.js.map

package/src/lib/config/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../../libs/eslint/plugin-trackunit/src/lib/config/utils.ts"],"names":[],"mappings":";;AAUA,4CAcC;;AAxBD,+CAAyB;AACzB,mDAA6B;AAE7B,IAAI,UAA8B,CAAC;AAEnC;;;;GAIG;AACH,SAAgB,gBAAgB;IAC9B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,OAAO,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YAC7C,UAAU,GAAG,GAAG,CAAC;YACjB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\n\nlet cachedRoot: string | undefined;\n\n/**\n * Finds the monorepo root by walking up from the config package directory\n * until a directory containing nx.json is found.\n * Falls back to process.cwd() if no nx.json is found.\n */\nexport function findMonorepoRoot(): string {\n  if (cachedRoot !== undefined) {\n    return cachedRoot;\n  }\n  let dir = __dirname;\n  while (dir !== path.dirname(dir)) {\n    if (fs.existsSync(path.join(dir, \"nx.json\"))) {\n      cachedRoot = dir;\n      return dir;\n    }\n    dir = path.dirname(dir);\n  }\n  cachedRoot = process.cwd();\n  return cachedRoot;\n}\n"]}

package/src/lib/config-helpers/create-skip-when.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Helper to create ESLint config that wraps rules with skip-when-lib-has-tag-tool logic.
+ *
+ * This provides a cleaner API than manually using the skip-when-lib-has-tag-tool/ prefix.
+ *
+ * @example
+ * createSkipWhen({
+ *   when: { tags: ['scope:tool'] },
+ *   plugins: {
+ *     'import-x': importXPlugin,
+ *   },
+ *   rules: {
+ *     'import-x/no-extraneous-dependencies': ["error", { ... }],
+ *   }
+ * })
+ *
+ * Returns a config object with:
+ * - A unique plugin containing the wrapped rules for this specific config
+ * - Rules configured to use the wrapped versions
+ */
+import type { Linter, Rule } from "eslint";
+import { type MatchCriteria } from "../utils/nx-utils";
+type PluginMap = Record<string, {
+    rules: Record<string, Rule.RuleModule>;
+}>;
+type CreateSkipWhenOptions = {
+    when: MatchCriteria;
+    plugins: PluginMap;
+    rules: Linter.RulesRecord;
+};
+/**
+ * Creates an ESLint config that wraps rules to skip enforcement based on NX project criteria.
+ */
+export declare const createSkipWhen: (options: CreateSkipWhenOptions) => Linter.FlatConfig;
+export {};

package/src/lib/config-helpers/create-skip-when.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkipWhen = void 0;
+const nx_utils_1 = require("../utils/nx-utils");
+let skipWhenCounter = 0;
+/**
+ * Creates an ESLint config that wraps rules to skip enforcement based on NX project criteria.
+ */
+const createSkipWhen = (options) => {
+    const { when, plugins, rules } = options;
+    // Create a unique plugin name for this config
+    const pluginName = `skip-when-${skipWhenCounter++}`;
+    // Build wrapped rules from provided plugins
+    const wrappedRules = {};
+    for (const [originalPluginName, plugin] of Object.entries(plugins)) {
+        for (const [ruleName, originalRule] of Object.entries(plugin.rules)) {
+            const fullRuleName = `${originalPluginName}/${ruleName}`;
+            // Create wrapped version of this rule
+            wrappedRules[fullRuleName] = {
+                meta: originalRule.meta,
+                create(context) {
+                    // Check if this file belongs to a project matching the criteria
+                    const filename = context.filename || context.getFilename();
+                    const metadata = (0, nx_utils_1.getProjectMetadata)(filename);
+                    // Check if project matches the skip criteria
+                    if (metadata && (0, nx_utils_1.projectMatchesCriteria)(metadata, when)) {
+                        // Skip enforcement - return empty visitor
+                        return {};
+                    }
+                    // Otherwise, delegate to the original rule
+                    return originalRule.create(context);
+                },
+            };
+        }
+    }
+    // Build the rules config
+    const rulesConfig = {};
+    for (const [ruleName, ruleConfig] of Object.entries(rules)) {
+        // Disable the original rule
+        rulesConfig[ruleName] = "off";
+        // Enable our wrapped version
+        rulesConfig[`${pluginName}/${ruleName}`] = ruleConfig;
+    }
+    return {
+        plugins: {
+            [pluginName]: {
+                rules: wrappedRules,
+            },
+        },
+        rules: rulesConfig,
+    };
+};
+exports.createSkipWhen = createSkipWhen;
+//# sourceMappingURL=create-skip-when.js.map

package/src/lib/config-helpers/create-skip-when.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skip-when.js","sourceRoot":"","sources":["../../../../../../../libs/eslint/plugin-trackunit/src/lib/config-helpers/create-skip-when.ts"],"names":[],"mappings":";;;AAqBA,gDAAmG;AAUnG,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB;;GAEG;AACI,MAAM,cAAc,GAAG,CAAC,OAA8B,EAAqB,EAAE;IAClF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAEzC,8CAA8C;IAC9C,MAAM,UAAU,GAAG,aAAa,eAAe,EAAE,EAAE,CAAC;IAEpD,4CAA4C;IAC5C,MAAM,YAAY,GAAoC,EAAE,CAAC;IAEzD,KAAK,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnE,KAAK,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACpE,MAAM,YAAY,GAAG,GAAG,kBAAkB,IAAI,QAAQ,EAAE,CAAC;YAEzD,sCAAsC;YACtC,YAAY,CAAC,YAAY,CAAC,GAAG;gBAC3B,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,MAAM,CAAC,OAAyB;oBAC9B,gEAAgE;oBAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBAC3D,MAAM,QAAQ,GAAG,IAAA,6BAAkB,EAAC,QAAQ,CAAC,CAAC;oBAE9C,6CAA6C;oBAC7C,IAAI,QAAQ,IAAI,IAAA,iCAAsB,EAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;wBACvD,0CAA0C;wBAC1C,OAAO,EAAE,CAAC;oBACZ,CAAC;oBAED,2CAA2C;oBAC3C,OAAO,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACtC,CAAC;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAuB,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,4BAA4B;QAC5B,WAAW,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QAE9B,6BAA6B;QAC7B,WAAW,CAAC,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC,GAAG,UAAU,CAAC;IACxD,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,CAAC,UAAU,CAAC,EAAE;gBACZ,KAAK,EAAE,YAAY;aACpB;SACF;QACD,KAAK,EAAE,WAAW;KACnB,CAAC;AACJ,CAAC,CAAC;AArDW,QAAA,cAAc,kBAqDzB","sourcesContent":["/**\n * Helper to create ESLint config that wraps rules with skip-when-lib-has-tag-tool logic.\n *\n * This provides a cleaner API than manually using the skip-when-lib-has-tag-tool/ prefix.\n *\n * @example\n * createSkipWhen({\n *   when: { tags: ['scope:tool'] },\n *   plugins: {\n *     'import-x': importXPlugin,\n *   },\n *   rules: {\n *     'import-x/no-extraneous-dependencies': [\"error\", { ... }],\n *   }\n * })\n *\n * Returns a config object with:\n * - A unique plugin containing the wrapped rules for this specific config\n * - Rules configured to use the wrapped versions\n */\nimport type { Linter, Rule } from \"eslint\";\nimport { getProjectMetadata, projectMatchesCriteria, type MatchCriteria } from \"../utils/nx-utils\";\n\ntype PluginMap = Record<string, { rules: Record<string, Rule.RuleModule> }>;\n\ntype CreateSkipWhenOptions = {\n  when: MatchCriteria;\n  plugins: PluginMap;\n  rules: Linter.RulesRecord;\n};\n\nlet skipWhenCounter = 0;\n\n/**\n * Creates an ESLint config that wraps rules to skip enforcement based on NX project criteria.\n */\nexport const createSkipWhen = (options: CreateSkipWhenOptions): Linter.FlatConfig => {\n  const { when, plugins, rules } = options;\n\n  // Create a unique plugin name for this config\n  const pluginName = `skip-when-${skipWhenCounter++}`;\n\n  // Build wrapped rules from provided plugins\n  const wrappedRules: Record<string, Rule.RuleModule> = {};\n\n  for (const [originalPluginName, plugin] of Object.entries(plugins)) {\n    for (const [ruleName, originalRule] of Object.entries(plugin.rules)) {\n      const fullRuleName = `${originalPluginName}/${ruleName}`;\n\n      // Create wrapped version of this rule\n      wrappedRules[fullRuleName] = {\n        meta: originalRule.meta,\n        create(context: Rule.RuleContext) {\n          // Check if this file belongs to a project matching the criteria\n          const filename = context.filename || context.getFilename();\n          const metadata = getProjectMetadata(filename);\n\n          // Check if project matches the skip criteria\n          if (metadata && projectMatchesCriteria(metadata, when)) {\n            // Skip enforcement - return empty visitor\n            return {};\n          }\n\n          // Otherwise, delegate to the original rule\n          return originalRule.create(context);\n        },\n      };\n    }\n  }\n\n  // Build the rules config\n  const rulesConfig: Linter.RulesRecord = {};\n\n  for (const [ruleName, ruleConfig] of Object.entries(rules)) {\n    // Disable the original rule\n    rulesConfig[ruleName] = \"off\";\n\n    // Enable our wrapped version\n    rulesConfig[`${pluginName}/${ruleName}`] = ruleConfig;\n  }\n\n  return {\n    plugins: {\n      [pluginName]: {\n        rules: wrappedRules,\n      },\n    },\n    rules: rulesConfig,\n  };\n};\n"]}

package/src/lib/rules/cva-merge-base-classes-as-array/cva-merge-base-classes-as-array.d.ts

@@ -0,0 +1,16 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+type MessageIds = "stringNeedsArray" | "arrayNeedsSplit";
+/**
+ * ESLint rule that converts cvaMerge base styles to arrays if more than one class is used.
+ *
+ * @example
+ *  Invalid:
+ *    const cvaMyComponent = cvaMerge("text-danger-600 mb-4 font-semibold");
+ *    const cvaMyComponent = cvaMerge(["text-danger-600 mb-4","font-semibold"]);
+ *  Valid:
+ *    const cvaMyComponent = cvaMerge(["text-danger-600", "mb-4", "font-semibold"]);
+ */
+export declare const cvaMergeBaseClassesAsArray: ESLintUtils.RuleModule<MessageIds, [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};

package/src/lib/rules/cva-merge-base-classes-as-array/cva-merge-base-classes-as-array.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cvaMergeBaseClassesAsArray = 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`);
+/**
+ * ESLint rule that converts cvaMerge base styles to arrays if more than one class is used.
+ *
+ * @example
+ *  Invalid:
+ *    const cvaMyComponent = cvaMerge("text-danger-600 mb-4 font-semibold");
+ *    const cvaMyComponent = cvaMerge(["text-danger-600 mb-4","font-semibold"]);
+ *  Valid:
+ *    const cvaMyComponent = cvaMerge(["text-danger-600", "mb-4", "font-semibold"]);
+ */
+exports.cvaMergeBaseClassesAsArray = createRule({
+    name: "cva-merge-base-classes-as-array",
+    meta: {
+        type: "layout",
+        docs: {
+            description: "Convert cvaMerge base styles to arrays if more than one class is used.",
+        },
+        fixable: "code",
+        messages: {
+            stringNeedsArray: "[cvaMerge] The first argument of cvaMerge should be an array if multiple classes are used.",
+            arrayNeedsSplit: "[cvaMerge] Only one class per array item is allowed.",
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            CallExpression(node) {
+                const calleeName = (0, classname_utils_1.getCalleeName)(node.callee);
+                if (calleeName !== "cvaMerge" || node.arguments.length === 0) {
+                    return;
+                }
+                const firstArg = node.arguments[0];
+                if (!firstArg) {
+                    return;
+                }
+                // Handle string literal: cvaMerge("class1 class2")
+                if (firstArg.type === utils_1.AST_NODE_TYPES.Literal && typeof firstArg.value === "string") {
+                    const value = firstArg.value;
+                    if (value.includes(" ")) {
+                        context.report({
+                            node,
+                            messageId: "stringNeedsArray",
+                            fix(fixer) {
+                                return fixer.replaceText(firstArg, (0, classname_utils_1.formatAsArray)((0, classname_utils_1.splitClasses)(value)));
+                            },
+                        });
+                    }
+                    return;
+                }
+                // Handle array: cvaMerge(["class1 class2", "class3"])
+                if (firstArg.type === utils_1.AST_NODE_TYPES.ArrayExpression) {
+                    const hasMultiClassElement = firstArg.elements.some(element => element?.type === utils_1.AST_NODE_TYPES.Literal &&
+                        typeof element.value === "string" &&
+                        element.value.includes(" "));
+                    if (hasMultiClassElement) {
+                        context.report({
+                            node,
+                            messageId: "arrayNeedsSplit",
+                            fix(fixer) {
+                                // Extract all string values and split them into individual classes
+                                const allClasses = [];
+                                for (const element of firstArg.elements) {
+                                    if (element?.type === utils_1.AST_NODE_TYPES.Literal && typeof element.value === "string") {
+                                        allClasses.push(...(0, classname_utils_1.splitClasses)(element.value));
+                                    }
+                                }
+                                return fixer.replaceText(firstArg, (0, classname_utils_1.formatAsArray)(allClasses));
+                            },
+                        });
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=cva-merge-base-classes-as-array.js.map

package/src/lib/rules/cva-merge-base-classes-as-array/cva-merge-base-classes-as-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cva-merge-base-classes-as-array.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/cva-merge-base-classes-as-array/cva-merge-base-classes-as-array.ts"],"names":[],"mappings":"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","sourcesContent":["import { AST_NODE_TYPES, ESLintUtils, TSESTree } from \"@typescript-eslint/utils\";\nimport { formatAsArray, getCalleeName, splitClasses } 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 = \"stringNeedsArray\" | \"arrayNeedsSplit\";\ntype Options = [];\n\n/**\n * ESLint rule that converts cvaMerge base styles to arrays if more than one class is used.\n *\n * @example\n *  Invalid:\n *    const cvaMyComponent = cvaMerge(\"text-danger-600 mb-4 font-semibold\");\n *    const cvaMyComponent = cvaMerge([\"text-danger-600 mb-4\",\"font-semibold\"]);\n *  Valid:\n *    const cvaMyComponent = cvaMerge([\"text-danger-600\", \"mb-4\", \"font-semibold\"]);\n */\nexport const cvaMergeBaseClassesAsArray = createRule<Options, MessageIds>({\n  name: \"cva-merge-base-classes-as-array\",\n  meta: {\n    type: \"layout\",\n    docs: {\n      description: \"Convert cvaMerge base styles to arrays if more than one class is used.\",\n    },\n    fixable: \"code\",\n    messages: {\n      stringNeedsArray: \"[cvaMerge] The first argument of cvaMerge should be an array if multiple classes are used.\",\n      arrayNeedsSplit: \"[cvaMerge] Only one class per array item is allowed.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      CallExpression(node: TSESTree.CallExpression) {\n        const calleeName = getCalleeName(node.callee);\n\n        if (calleeName !== \"cvaMerge\" || node.arguments.length === 0) {\n          return;\n        }\n\n        const firstArg = node.arguments[0];\n        if (!firstArg) {\n          return;\n        }\n\n        // Handle string literal: cvaMerge(\"class1 class2\")\n        if (firstArg.type === AST_NODE_TYPES.Literal && typeof firstArg.value === \"string\") {\n          const value = firstArg.value;\n          if (value.includes(\" \")) {\n            context.report({\n              node,\n              messageId: \"stringNeedsArray\",\n              fix(fixer) {\n                return fixer.replaceText(firstArg, formatAsArray(splitClasses(value)));\n              },\n            });\n          }\n          return;\n        }\n\n        // Handle array: cvaMerge([\"class1 class2\", \"class3\"])\n        if (firstArg.type === AST_NODE_TYPES.ArrayExpression) {\n          const hasMultiClassElement = firstArg.elements.some(\n            element =>\n              element?.type === AST_NODE_TYPES.Literal &&\n              typeof element.value === \"string\" &&\n              element.value.includes(\" \")\n          );\n\n          if (hasMultiClassElement) {\n            context.report({\n              node,\n              messageId: \"arrayNeedsSplit\",\n              fix(fixer) {\n                // Extract all string values and split them into individual classes\n                const allClasses: Array<string> = [];\n                for (const element of firstArg.elements) {\n                  if (element?.type === AST_NODE_TYPES.Literal && typeof element.value === \"string\") {\n                    allClasses.push(...splitClasses(element.value));\n                  }\n                }\n                return fixer.replaceText(firstArg, formatAsArray(allClasses));\n              },\n            });\n          }\n        }\n      },\n    };\n  },\n});\n"]}

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

@@ -0,0 +1,4 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+export declare const designGuidelineButtonIconSizeMatch: ESLintUtils.RuleModule<"incorrectIconSize", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};