@trackunit/eslint-plugin-trackunit 0.0.2

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

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noInternalBarrelFiles = void 0;
+const tslib_1 = require("tslib");
+/**
+ * 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 ❌
+ */
+const utils_1 = require("@typescript-eslint/utils");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const zod_1 = require("zod");
+const file_utils_1 = require("../../utils/file-utils");
+const projectJsonSchema = zod_1.z.object({
+    sourceRoot: zod_1.z.string().optional(),
+});
+const tsconfigSchema = zod_1.z.object({
+    compilerOptions: zod_1.z
+        .object({
+        paths: zod_1.z.record(zod_1.z.array(zod_1.z.string())).optional(),
+    })
+        .optional(),
+});
+/**
+ * Cache for tsconfig.base.json secondary entry points.
+ * Key: workspace root path
+ * Value: Set of absolute paths to allowed secondary entry points
+ */
+const secondaryEntryPointsCache = new Map();
+/**
+ * Find the workspace root by looking for nx.json
+ */
+const findWorkspaceRoot = (startPath) => {
+    const nxJsonPath = (0, file_utils_1.findNearestFile)(startPath, "nx.json");
+    return nxJsonPath ? path.dirname(nxJsonPath) : null;
+};
+/**
+ * Get secondary entry points from tsconfig.base.json.
+ * These are path mappings that point to index.ts files inside src/ subdirectories.
+ * Results are cached per workspace root.
+ */
+const getSecondaryEntryPoints = (workspaceRoot) => {
+    const cached = secondaryEntryPointsCache.get(workspaceRoot);
+    if (cached) {
+        return cached;
+    }
+    const entryPoints = new Set();
+    const tsconfigPath = path.join(workspaceRoot, "tsconfig.base.json");
+    try {
+        const tsconfigContent = fs.readFileSync(tsconfigPath, "utf-8");
+        const parsed = tsconfigSchema.safeParse(JSON.parse(tsconfigContent));
+        if (parsed.success && parsed.data.compilerOptions?.paths) {
+            const paths = parsed.data.compilerOptions.paths;
+            for (const pathMappings of Object.values(paths)) {
+                for (const mapping of pathMappings) {
+                    // Only consider mappings that point to index.ts files
+                    if (mapping.endsWith("/index.ts") || mapping.endsWith("/index.tsx")) {
+                        const absolutePath = path.normalize(path.join(workspaceRoot, mapping));
+                        entryPoints.add(absolutePath);
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // If we can't read tsconfig.base.json, return empty set
+    }
+    secondaryEntryPointsCache.set(workspaceRoot, entryPoints);
+    return entryPoints;
+};
+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 file is a barrel file (index.ts or index.tsx).
+ */
+const isBarrelFile = (filePath) => {
+    const basename = path.basename(filePath);
+    return basename === "index.ts" || basename === "index.tsx";
+};
+/**
+ * Normalize file path for comparison (handles potential trailing slashes, etc.)
+ */
+const normalizePath = (filePath) => {
+    return path.normalize(filePath);
+};
+exports.noInternalBarrelFiles = createRule({
+    name: "no-internal-barrel-files",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Disallow internal barrel files (index.ts) that are not at the library root or configured as secondary entry points",
+        },
+        schema: [],
+        messages: {
+            noInternalBarrel: "Internal barrel files are not allowed. Move exports to the root barrel file (src/index.ts) instead. Use the flatten-barrel-exports tool: yarn ts-node devtools/flatten-barrel-exports/flatten-barrel-exports.ts",
+        },
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            Program(node) {
+                const currentFile = context.filename;
+                // Only analyze barrel files (index.ts/tsx)
+                if (!isBarrelFile(currentFile)) {
+                    return;
+                }
+                // Find the project root by looking for project.json
+                const projectJsonPath = (0, file_utils_1.findNearestFile)(currentFile, "project.json");
+                if (projectJsonPath === null) {
+                    // Not in an NX project, skip
+                    return;
+                }
+                const projectRoot = path.dirname(projectJsonPath);
+                const workspaceRoot = findWorkspaceRoot(currentFile);
+                // Read sourceRoot from project.json, defaulting to "src" if not specified
+                // sourceRoot in project.json is relative to workspace root (e.g., "libs/my-lib/src")
+                let sourceRootAbsolute = path.join(projectRoot, "src");
+                try {
+                    const projectJsonContent = fs.readFileSync(projectJsonPath, "utf-8");
+                    const parsed = projectJsonSchema.safeParse(JSON.parse(projectJsonContent));
+                    if (parsed.success && parsed.data.sourceRoot && workspaceRoot) {
+                        // sourceRoot is relative to workspace root, so resolve it
+                        sourceRootAbsolute = path.join(workspaceRoot, parsed.data.sourceRoot);
+                    }
+                }
+                catch {
+                    // If we can't read project.json, fall back to projectRoot/src
+                }
+                // The root barrel is at {sourceRoot}/index.ts or {sourceRoot}/index.tsx
+                const rootBarrelTs = normalizePath(path.join(sourceRootAbsolute, "index.ts"));
+                const rootBarrelTsx = normalizePath(path.join(sourceRootAbsolute, "index.tsx"));
+                const normalizedCurrentFile = normalizePath(currentFile);
+                // If this IS the root barrel, it's allowed
+                if (normalizedCurrentFile === rootBarrelTs || normalizedCurrentFile === rootBarrelTsx) {
+                    return;
+                }
+                // Check if this is a secondary entry point configured in tsconfig.base.json
+                if (workspaceRoot) {
+                    const secondaryEntryPoints = getSecondaryEntryPoints(workspaceRoot);
+                    if (secondaryEntryPoints.has(normalizedCurrentFile)) {
+                        // This is a configured secondary entry point, allow it
+                        return;
+                    }
+                }
+                // This is an internal barrel file - flag it
+                // Note: No autofix or suggestion is provided because:
+                // 1. The exports need to be moved to the root barrel
+                // 2. Imports throughout the codebase may need updating
+                // 3. The flatten-barrel-exports tool handles this properly
+                context.report({
+                    node,
+                    messageId: "noInternalBarrel",
+                });
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-internal-barrel-files.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"no-internal-barrel-files.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/no-internal-barrel-files/no-internal-barrel-files.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ESLint rule to disallow internal barrel files.\n *\n * Internal barrel files (any index.ts or index.tsx that is not at the library root) cause:\n * - Multiple import paths to the same module\n * - Slower builds (bundlers must traverse more barrel files)\n * - Confusion about canonical import paths\n * - Potential bundle size issues\n * - Module identity problems\n *\n * EXCEPTION: Secondary entry points configured in tsconfig.base.json are allowed.\n * These are intentional barrel files that provide separate package imports\n * (e.g., @trackunit/react-core-contexts-host-test pointing to src/test/index.ts).\n *\n * @example\n * // Valid - Root barrel file\n * // libs/my-lib/src/index.ts ✅\n *\n * // Valid - Secondary entry point configured in tsconfig.base.json\n * // libs/my-lib/src/test/index.ts ✅ (if configured as @trackunit/my-lib-test)\n *\n * // Invalid - Internal barrel file\n * // libs/my-lib/src/components/index.ts ❌\n * // libs/my-lib/src/utils/helpers/index.ts ❌\n */\nimport { ESLintUtils } from \"@typescript-eslint/utils\";\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { z } from \"zod\";\nimport { findNearestFile } from \"../../utils/file-utils\";\n\nconst projectJsonSchema = z.object({\n  sourceRoot: z.string().optional(),\n});\n\nconst tsconfigSchema = z.object({\n  compilerOptions: z\n    .object({\n      paths: z.record(z.array(z.string())).optional(),\n    })\n    .optional(),\n});\n\n/**\n * Cache for tsconfig.base.json secondary entry points.\n * Key: workspace root path\n * Value: Set of absolute paths to allowed secondary entry points\n */\nconst secondaryEntryPointsCache = new Map<string, Set<string>>();\n\n/**\n * Find the workspace root by looking for nx.json\n */\nconst findWorkspaceRoot = (startPath: string): string | null => {\n  const nxJsonPath = findNearestFile(startPath, \"nx.json\");\n  return nxJsonPath ? path.dirname(nxJsonPath) : null;\n};\n\n/**\n * Get secondary entry points from tsconfig.base.json.\n * These are path mappings that point to index.ts files inside src/ subdirectories.\n * Results are cached per workspace root.\n */\nconst getSecondaryEntryPoints = (workspaceRoot: string): Set<string> => {\n  const cached = secondaryEntryPointsCache.get(workspaceRoot);\n  if (cached) {\n    return cached;\n  }\n\n  const entryPoints = new Set<string>();\n  const tsconfigPath = path.join(workspaceRoot, \"tsconfig.base.json\");\n\n  try {\n    const tsconfigContent = fs.readFileSync(tsconfigPath, \"utf-8\");\n    const parsed = tsconfigSchema.safeParse(JSON.parse(tsconfigContent));\n\n    if (parsed.success && parsed.data.compilerOptions?.paths) {\n      const paths = parsed.data.compilerOptions.paths;\n\n      for (const pathMappings of Object.values(paths)) {\n        for (const mapping of pathMappings) {\n          // Only consider mappings that point to index.ts files\n          if (mapping.endsWith(\"/index.ts\") || mapping.endsWith(\"/index.tsx\")) {\n            const absolutePath = path.normalize(path.join(workspaceRoot, mapping));\n            entryPoints.add(absolutePath);\n          }\n        }\n      }\n    }\n  } catch {\n    // If we can't read tsconfig.base.json, return empty set\n  }\n\n  secondaryEntryPointsCache.set(workspaceRoot, entryPoints);\n  return entryPoints;\n};\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 = \"noInternalBarrel\";\ntype Options = [];\n\n/**\n * Check if a file is a barrel file (index.ts or index.tsx).\n */\nconst isBarrelFile = (filePath: string): boolean => {\n  const basename = path.basename(filePath);\n  return basename === \"index.ts\" || basename === \"index.tsx\";\n};\n\n/**\n * Normalize file path for comparison (handles potential trailing slashes, etc.)\n */\nconst normalizePath = (filePath: string): string => {\n  return path.normalize(filePath);\n};\n\nexport const noInternalBarrelFiles = createRule<Options, MessageIds>({\n  name: \"no-internal-barrel-files\",\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description:\n        \"Disallow internal barrel files (index.ts) that are not at the library root or configured as secondary entry points\",\n    },\n    schema: [],\n    messages: {\n      noInternalBarrel:\n        \"Internal barrel files are not allowed. Move exports to the root barrel file (src/index.ts) instead. Use the flatten-barrel-exports tool: yarn ts-node devtools/flatten-barrel-exports/flatten-barrel-exports.ts\",\n    },\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      Program(node) {\n        const currentFile = context.filename;\n\n        // Only analyze barrel files (index.ts/tsx)\n        if (!isBarrelFile(currentFile)) {\n          return;\n        }\n\n        // Find the project root by looking for project.json\n        const projectJsonPath = findNearestFile(currentFile, \"project.json\");\n        if (projectJsonPath === null) {\n          // Not in an NX project, skip\n          return;\n        }\n\n        const projectRoot = path.dirname(projectJsonPath);\n        const workspaceRoot = findWorkspaceRoot(currentFile);\n\n        // Read sourceRoot from project.json, defaulting to \"src\" if not specified\n        // sourceRoot in project.json is relative to workspace root (e.g., \"libs/my-lib/src\")\n        let sourceRootAbsolute = path.join(projectRoot, \"src\");\n        try {\n          const projectJsonContent = fs.readFileSync(projectJsonPath, \"utf-8\");\n          const parsed = projectJsonSchema.safeParse(JSON.parse(projectJsonContent));\n          if (parsed.success && parsed.data.sourceRoot && workspaceRoot) {\n            // sourceRoot is relative to workspace root, so resolve it\n            sourceRootAbsolute = path.join(workspaceRoot, parsed.data.sourceRoot);\n          }\n        } catch {\n          // If we can't read project.json, fall back to projectRoot/src\n        }\n\n        // The root barrel is at {sourceRoot}/index.ts or {sourceRoot}/index.tsx\n        const rootBarrelTs = normalizePath(path.join(sourceRootAbsolute, \"index.ts\"));\n        const rootBarrelTsx = normalizePath(path.join(sourceRootAbsolute, \"index.tsx\"));\n        const normalizedCurrentFile = normalizePath(currentFile);\n\n        // If this IS the root barrel, it's allowed\n        if (normalizedCurrentFile === rootBarrelTs || normalizedCurrentFile === rootBarrelTsx) {\n          return;\n        }\n\n        // Check if this is a secondary entry point configured in tsconfig.base.json\n        if (workspaceRoot) {\n          const secondaryEntryPoints = getSecondaryEntryPoints(workspaceRoot);\n          if (secondaryEntryPoints.has(normalizedCurrentFile)) {\n            // This is a configured secondary entry point, allow it\n            return;\n          }\n        }\n\n        // This is an internal barrel file - flag it\n        // Note: No autofix or suggestion is provided because:\n        // 1. The exports need to be moved to the root barrel\n        // 2. Imports throughout the codebase may need updating\n        // 3. The flatten-barrel-exports tool handles this properly\n        context.report({\n          node,\n          messageId: \"noInternalBarrel\",\n        });\n      },\n    };\n  },\n});\n"]}

package/src/lib/rules/no-internal-graphql-when-tagged-with-gql-public/no-internal-graphql-when-tagged-with-gql-public.d.ts

@@ -0,0 +1,5 @@
+import { Rule } from "eslint";
+export declare const noInternalGraphqlWhenTaggedWithGqlPublic: {
+    meta: Rule.RuleMetaData;
+    create: (context: Rule.RuleContext) => Rule.RuleListener;
+};

package/src/lib/rules/no-internal-graphql-when-tagged-with-gql-public/no-internal-graphql-when-tagged-with-gql-public.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noInternalGraphqlWhenTaggedWithGqlPublic = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const meta = {
+    type: "problem",
+    docs: {
+        description: "Disallow '-internal.graphql' files in projects tagged with 'gql:public'",
+    },
+    messages: {
+        internalGraphqlFileFound: "'-internal.graphql' file found in a 'gql:public' tagged project.",
+    },
+    schema: [],
+};
+const create = (context) => {
+    const getLineAndColumnFromPosition = (content, position) => {
+        const lines = content.substring(0, position).split("\n");
+        const line = lines.length;
+        const column = lines[lines.length - 1]?.length ?? 0;
+        return { line, column };
+    };
+    const checkDirectoryForInternalGraphQLFiles = (directory, projectJson) => {
+        const files = fs.readdirSync(directory);
+        for (const file of files) {
+            const fullPath = path.join(directory, file);
+            // Handle broken symlinks or inaccessible paths gracefully
+            let stat;
+            try {
+                stat = fs.statSync(fullPath);
+            }
+            catch {
+                // Skip paths that can't be accessed (broken symlinks, permission issues, etc.)
+                continue;
+            }
+            if (stat.isDirectory()) {
+                checkDirectoryForInternalGraphQLFiles(fullPath, projectJson);
+            }
+            else if (file.endsWith("-internal.graphql")) {
+                context.report({
+                    message: `'*-internal.graphql' file found in a 'gql:public' tagged project. - ${fullPath}`,
+                    loc: getLineAndColumnFromPosition(projectJson, projectJson.indexOf("gql:public")),
+                });
+                return;
+            }
+        }
+    };
+    return {
+        Program: _node => {
+            const sourceFilePath = context.getFilename();
+            if (sourceFilePath.endsWith("/project.json")) {
+                const projectJsonString = fs.readFileSync(sourceFilePath, "utf8");
+                const projectJson = JSON.parse(projectJsonString);
+                if (Array.isArray(projectJson.tags) && projectJson.tags.includes("gql:public")) {
+                    const projectDir = path.dirname(sourceFilePath);
+                    checkDirectoryForInternalGraphQLFiles(projectDir, projectJsonString);
+                }
+            }
+        },
+    };
+};
+exports.noInternalGraphqlWhenTaggedWithGqlPublic = {
+    meta,
+    create,
+};
+//# sourceMappingURL=no-internal-graphql-when-tagged-with-gql-public.js.map

package/src/lib/rules/no-internal-graphql-when-tagged-with-gql-public/no-internal-graphql-when-tagged-with-gql-public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-internal-graphql-when-tagged-with-gql-public.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/no-internal-graphql-when-tagged-with-gql-public/no-internal-graphql-when-tagged-with-gql-public.ts"],"names":[],"mappings":";;;;AACA,+CAAyB;AACzB,mDAA6B;AAE7B,MAAM,IAAI,GAAsB;IAC9B,IAAI,EAAE,SAAS;IACf,IAAI,EAAE;QACJ,WAAW,EAAE,yEAAyE;KACvF;IACD,QAAQ,EAAE;QACR,wBAAwB,EAAE,kEAAkE;KAC7F;IACD,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,OAAyB,EAAqB,EAAE;IAC9D,MAAM,4BAA4B,GAAG,CAAC,OAAe,EAAE,QAAgB,EAAE,EAAE;QACzE,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,qCAAqC,GAAG,CAAC,SAAiB,EAAE,WAAmB,EAAE,EAAE;QACvF,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAE5C,0DAA0D;YAC1D,IAAI,IAAc,CAAC;YACnB,IAAI,CAAC;gBACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,+EAA+E;gBAC/E,SAAS;YACX,CAAC;YAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,qCAAqC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC/D,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBAC9C,OAAO,CAAC,MAAM,CAAC;oBACb,OAAO,EAAE,uEAAuE,QAAQ,EAAE;oBAC1F,GAAG,EAAE,4BAA4B,CAAC,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;iBAClF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,EAAE;YACf,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7C,IAAI,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC7C,MAAM,iBAAiB,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;gBAClE,MAAM,WAAW,GAA6B,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;oBAChD,qCAAqC,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEW,QAAA,wCAAwC,GAAG;IACtD,IAAI;IACJ,MAAM;CACP,CAAC","sourcesContent":["import { Rule } from \"eslint\";\nimport * as fs from \"fs\";\nimport * as path from \"path\";\n\nconst meta: Rule.RuleMetaData = {\n  type: \"problem\",\n  docs: {\n    description: \"Disallow '-internal.graphql' files in projects tagged with 'gql:public'\",\n  },\n  messages: {\n    internalGraphqlFileFound: \"'-internal.graphql' file found in a 'gql:public' tagged project.\",\n  },\n  schema: [],\n};\n\nconst create = (context: Rule.RuleContext): Rule.RuleListener => {\n  const getLineAndColumnFromPosition = (content: string, position: number) => {\n    const lines = content.substring(0, position).split(\"\\n\");\n    const line = lines.length;\n    const column = lines[lines.length - 1]?.length ?? 0;\n    return { line, column };\n  };\n\n  const checkDirectoryForInternalGraphQLFiles = (directory: string, projectJson: string) => {\n    const files = fs.readdirSync(directory);\n    for (const file of files) {\n      const fullPath = path.join(directory, file);\n\n      // Handle broken symlinks or inaccessible paths gracefully\n      let stat: fs.Stats;\n      try {\n        stat = fs.statSync(fullPath);\n      } catch {\n        // Skip paths that can't be accessed (broken symlinks, permission issues, etc.)\n        continue;\n      }\n\n      if (stat.isDirectory()) {\n        checkDirectoryForInternalGraphQLFiles(fullPath, projectJson);\n      } else if (file.endsWith(\"-internal.graphql\")) {\n        context.report({\n          message: `'*-internal.graphql' file found in a 'gql:public' tagged project. - ${fullPath}`,\n          loc: getLineAndColumnFromPosition(projectJson, projectJson.indexOf(\"gql:public\")),\n        });\n        return;\n      }\n    }\n  };\n  return {\n    Program: _node => {\n      const sourceFilePath = context.getFilename();\n      if (sourceFilePath.endsWith(\"/project.json\")) {\n        const projectJsonString = fs.readFileSync(sourceFilePath, \"utf8\");\n        const projectJson: { tags?: Array<string> } = JSON.parse(projectJsonString);\n        if (Array.isArray(projectJson.tags) && projectJson.tags.includes(\"gql:public\")) {\n          const projectDir = path.dirname(sourceFilePath);\n          checkDirectoryForInternalGraphQLFiles(projectDir, projectJsonString);\n        }\n      }\n    },\n  };\n};\n\nexport const noInternalGraphqlWhenTaggedWithGqlPublic = {\n  meta,\n  create,\n};\n"]}

package/src/lib/rules/no-jest-mock-trackunit-react-core-hooks/no-jest-mock-trackunit-react-core-hooks.d.ts

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

package/src/lib/rules/no-jest-mock-trackunit-react-core-hooks/no-jest-mock-trackunit-react-core-hooks.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noJestMockTrackunitReactCoreHooks = void 0;
+exports.noJestMockTrackunitReactCoreHooks = {
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Disallow direct jest.mock() of @trackunit/react-core-hooks",
+        },
+        messages: {
+            noDirectMock: 'Don\'t use jest.mock("@trackunit/react-core-hooks"). Use mock builder from trackunitProviders(), trackunitProvidersInternal() or trackunitProvidersHost() instead.',
+        },
+        schema: [],
+    },
+    create(context) {
+        return {
+            CallExpression(node) {
+                if (node.callee.type === "MemberExpression" &&
+                    node.callee.object.type === "Identifier" &&
+                    node.callee.object.name === "jest" &&
+                    node.callee.property.type === "Identifier" &&
+                    node.callee.property.name === "mock" &&
+                    node.arguments[0]?.type === "Literal" &&
+                    node.arguments[0].value === "@trackunit/react-core-hooks") {
+                    context.report({
+                        node,
+                        messageId: "noDirectMock",
+                    });
+                }
+            },
+        };
+    },
+};
+//# sourceMappingURL=no-jest-mock-trackunit-react-core-hooks.js.map

package/src/lib/rules/no-jest-mock-trackunit-react-core-hooks/no-jest-mock-trackunit-react-core-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-jest-mock-trackunit-react-core-hooks.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/no-jest-mock-trackunit-react-core-hooks/no-jest-mock-trackunit-react-core-hooks.ts"],"names":[],"mappings":";;;AAEa,QAAA,iCAAiC,GAAoB;IAChE,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EAAE,4DAA4D;SAC1E;QACD,QAAQ,EAAE;YACR,YAAY,EACV,oKAAoK;SACvK;QACD,MAAM,EAAE,EAAE;KACX;IACD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,IACE,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,kBAAkB;oBACvC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;oBACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;oBAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;oBAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM;oBACpC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,SAAS;oBACrC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,6BAA6B,EACzD,CAAC;oBACD,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI;wBACJ,SAAS,EAAE,cAAc;qBAC1B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC","sourcesContent":["import type { Rule } from \"eslint\";\n\nexport const noJestMockTrackunitReactCoreHooks: Rule.RuleModule = {\n  meta: {\n    type: \"problem\",\n    docs: {\n      description: \"Disallow direct jest.mock() of @trackunit/react-core-hooks\",\n    },\n    messages: {\n      noDirectMock:\n        'Don\\'t use jest.mock(\"@trackunit/react-core-hooks\"). Use mock builder from trackunitProviders(), trackunitProvidersInternal() or trackunitProvidersHost() instead.',\n    },\n    schema: [],\n  },\n  create(context) {\n    return {\n      CallExpression(node) {\n        if (\n          node.callee.type === \"MemberExpression\" &&\n          node.callee.object.type === \"Identifier\" &&\n          node.callee.object.name === \"jest\" &&\n          node.callee.property.type === \"Identifier\" &&\n          node.callee.property.name === \"mock\" &&\n          node.arguments[0]?.type === \"Literal\" &&\n          node.arguments[0].value === \"@trackunit/react-core-hooks\"\n        ) {\n          context.report({\n            node,\n            messageId: \"noDirectMock\",\n          });\n        }\n      },\n    };\n  },\n};\n"]}

package/src/lib/rules/no-template-strings-in-classname-prop/no-template-strings-in-classname-prop.d.ts

@@ -0,0 +1,16 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+/**
+ * ESLint rule to disallow template strings in className prop.
+ *
+ * @example
+ * // Bad
+ * <div className={`${dynamicClass} staticClass`}>Content</div>
+ *
+ * // Good
+ * <div className={twMerge(dynamicClassName, "staticClassName")}>Content</div>
+ * // or
+ * <div className={yourCvaMergeFunction({ yourVariantProp, className: "extraClassName" })}>Content</div>
+ */
+export declare const noTemplateStringsInClassName: ESLintUtils.RuleModule<"templateStringInClassName", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};

package/src/lib/rules/no-template-strings-in-classname-prop/no-template-strings-in-classname-prop.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noTemplateStringsInClassName = 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 to disallow template strings in className prop.
+ *
+ * @example
+ * // Bad
+ * <div className={`${dynamicClass} staticClass`}>Content</div>
+ *
+ * // Good
+ * <div className={twMerge(dynamicClassName, "staticClassName")}>Content</div>
+ * // or
+ * <div className={yourCvaMergeFunction({ yourVariantProp, className: "extraClassName" })}>Content</div>
+ */
+exports.noTemplateStringsInClassName = createRule({
+    name: "no-template-strings-in-classname-prop",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Disallow the use of template strings in className prop to encourage better class management.",
+        },
+        messages: {
+            templateStringInClassName: "Do not use template strings in className prop. If you wish to merge classes from different sources, use twMerge() for simple inline merging or make a cvaMerge() function if it has variants.",
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            /**
+             * Handle JSXAttribute with className prop that uses template strings.
+             *
+             * @example
+             * // Bad
+             * <div className={`${dynamicClass} staticClass`}>Content</div>
+             */
+            JSXAttribute(node) {
+                // Check if this is a classname attribute (className or class)
+                if (node.name.type !== utils_1.AST_NODE_TYPES.JSXIdentifier || !(0, classname_utils_1.isClassnameAttribute)(node.name.name)) {
+                    return;
+                }
+                // Check if the value is a template literal in a JSX expression container
+                if (node.value?.type === utils_1.AST_NODE_TYPES.JSXExpressionContainer &&
+                    node.value.expression.type === utils_1.AST_NODE_TYPES.TemplateLiteral) {
+                    context.report({ node, messageId: "templateStringInClassName" });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-template-strings-in-classname-prop.js.map

package/src/lib/rules/no-template-strings-in-classname-prop/no-template-strings-in-classname-prop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-template-strings-in-classname-prop.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/no-template-strings-in-classname-prop/no-template-strings-in-classname-prop.ts"],"names":[],"mappings":";;;AAAA,oDAAiF;AACjF,iEAAmE;AAEnE,MAAM,UAAU,GAAG,mBAAW,CAAC,WAAW,CACxC,IAAI,CAAC,EAAE,CAAC,6FAA6F,IAAI,KAAK,CAC/G,CAAC;AAKF;;;;;;;;;;;GAWG;AACU,QAAA,4BAA4B,GAAG,UAAU,CAAsB;IAC1E,IAAI,EAAE,uCAAuC;IAC7C,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EAAE,8FAA8F;SAC5G;QACD,QAAQ,EAAE;YACR,yBAAyB,EACvB,+LAA+L;SAClM;QACD,MAAM,EAAE,EAAE;KACX;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,OAAO;QACZ,OAAO;YACL;;;;;;eAMG;YACH,YAAY,CAAC,IAA2B;gBACtC,8DAA8D;gBAC9D,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,sBAAc,CAAC,aAAa,IAAI,CAAC,IAAA,sCAAoB,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7F,OAAO;gBACT,CAAC;gBAED,yEAAyE;gBACzE,IACE,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,sBAAc,CAAC,sBAAsB;oBAC1D,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,sBAAc,CAAC,eAAe,EAC7D,CAAC;oBACD,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { AST_NODE_TYPES, ESLintUtils, TSESTree } from \"@typescript-eslint/utils\";\nimport { isClassnameAttribute } 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 = \"templateStringInClassName\";\ntype Options = [];\n\n/**\n * ESLint rule to disallow template strings in className prop.\n *\n * @example\n * // Bad\n * <div className={`${dynamicClass} staticClass`}>Content</div>\n *\n * // Good\n * <div className={twMerge(dynamicClassName, \"staticClassName\")}>Content</div>\n * // or\n * <div className={yourCvaMergeFunction({ yourVariantProp, className: \"extraClassName\" })}>Content</div>\n */\nexport const noTemplateStringsInClassName = createRule<Options, MessageIds>({\n  name: \"no-template-strings-in-classname-prop\",\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description: \"Disallow the use of template strings in className prop to encourage better class management.\",\n    },\n    messages: {\n      templateStringInClassName:\n        \"Do not use template strings in className prop. If you wish to merge classes from different sources, use twMerge() for simple inline merging or make a cvaMerge() function if it has variants.\",\n    },\n    schema: [],\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      /**\n       * Handle JSXAttribute with className prop that uses template strings.\n       *\n       * @example\n       * // Bad\n       * <div className={`${dynamicClass} staticClass`}>Content</div>\n       */\n      JSXAttribute(node: TSESTree.JSXAttribute) {\n        // Check if this is a classname attribute (className or class)\n        if (node.name.type !== AST_NODE_TYPES.JSXIdentifier || !isClassnameAttribute(node.name.name)) {\n          return;\n        }\n\n        // Check if the value is a template literal in a JSX expression container\n        if (\n          node.value?.type === AST_NODE_TYPES.JSXExpressionContainer &&\n          node.value.expression.type === AST_NODE_TYPES.TemplateLiteral\n        ) {\n          context.report({ node, messageId: \"templateStringInClassName\" });\n        }\n      },\n    };\n  },\n});\n"]}

package/src/lib/rules/no-typescript-assertion/examples.d.ts

@@ -0,0 +1 @@
+export {};

package/src/lib/rules/no-typescript-assertion/examples.js

@@ -0,0 +1,45 @@
+"use strict";
+// To test this rule: comment out the eslint-disable line below and run: yarn nx run eslint-plugin-trackunit:lint
+/* eslint-disable @trackunit/no-typescript-assertion */
+// This file demonstrates the no-typescript-assertion rule
+Object.defineProperty(exports, "__esModule", { value: true });
+// ✅ VALID - Using as const (allowed exception)
+const _config = { name: "test", value: 123 };
+const _colors = ["red", "green", "blue"];
+// ✅ VALID - Using as unknown as intermediate (allowed exception, but still discouraged)
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
+const _data = someValue;
+// ✅ VALID - Proper type guard
+function isString(val) {
+    return typeof val === "string";
+}
+const _validValue = isString(something) ? something : "default";
+// ✅ VALID - Explicit null/undefined handling
+const _validOptional = maybeValue ?? "default";
+// ❌ INVALID - Angle bracket assertion (SHOULD be flagged)
+const _angleExample = someValue;
+// ❌ INVALID - 'as' keyword assertion (SHOULD be flagged)
+const _asExample = someValue;
+const _asNumber = userInput;
+const _asObject = response;
+// ❌ INVALID - Non-null assertion (SHOULD be flagged)
+// These are intentionally invalid examples - the rule should catch these
+// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+const _nonNullExample = maybeNull;
+// eslint-disable-next-line @typescript-eslint/no-non-null-assertion, @typescript-eslint/no-unnecessary-type-assertion
+const _chainedNonNull = obj.prop.value;
+// eslint-disable-next-line @typescript-eslint/no-non-null-assertion, @typescript-eslint/no-unnecessary-type-assertion
+const _arrayNonNull = arr[0];
+// ❌ INVALID - Multiple assertion types in one file
+const _mixed1 = value;
+// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+const _mixed2 = anotherValue;
+const _mixed3 = yetAnotherValue;
+// ❌ INVALID - Common real-world cases that should be caught
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
+const _apiResponse = fetch("/api/data");
+const _jsonData = JSON.parse(str);
+// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+const _element = document.getElementById("root");
+const _typedArray = Array.from(collection);
+//# sourceMappingURL=examples.js.map

package/src/lib/rules/no-typescript-assertion/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/no-typescript-assertion/examples.ts"],"names":[],"mappings":";AAAA,iHAAiH;AACjH,uDAAuD;AACvD,0DAA0D;;AAuB1D,+CAA+C;AAC/C,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAW,CAAC;AACtD,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAElD,wFAAwF;AACxF,4EAA4E;AAC5E,MAAM,KAAK,GAAG,SAAoB,CAAC;AAEnC,8BAA8B;AAC9B,SAAS,QAAQ,CAAC,GAAY;IAC5B,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC;AACjC,CAAC;AACD,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAEhE,6CAA6C;AAC7C,MAAM,cAAc,GAAG,UAAU,IAAI,SAAS,CAAC;AAE/C,0DAA0D;AAC1D,MAAM,aAAa,GAAW,SAAS,CAAC;AAExC,yDAAyD;AACzD,MAAM,UAAU,GAAG,SAAmB,CAAC;AACvC,MAAM,SAAS,GAAG,SAAmB,CAAC;AACtC,MAAM,SAAS,GAAG,QAAwC,CAAC;AAE3D,qDAAqD;AACrD,yEAAyE;AACzE,oEAAoE;AACpE,MAAM,eAAe,GAAG,SAAU,CAAC;AACnC,sHAAsH;AACtH,MAAM,eAAe,GAAG,GAAI,CAAC,IAAK,CAAC,KAAM,CAAC;AAC1C,sHAAsH;AACtH,MAAM,aAAa,GAAG,GAAI,CAAC,CAAC,CAAC,CAAC;AAE9B,mDAAmD;AACnD,MAAM,OAAO,GAAG,KAAiB,CAAC;AAClC,oEAAoE;AACpE,MAAM,OAAO,GAAG,YAAa,CAAC;AAC9B,MAAM,OAAO,GAAc,eAAe,CAAC;AAE3C,4DAA4D;AAC5D,4EAA4E;AAC5E,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAsB,CAAC;AAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;AACjD,oEAAoE;AACpE,MAAM,QAAQ,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAE,CAAC;AAClD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAqB,CAAC","sourcesContent":["// To test this rule: comment out the eslint-disable line below and run: yarn nx run eslint-plugin-trackunit:lint\n/* eslint-disable @trackunit/no-typescript-assertion */\n// This file demonstrates the no-typescript-assertion rule\n\n// Declare variables used in examples\ndeclare const someValue: unknown;\ndeclare const something: unknown;\ndeclare const maybeValue: unknown;\ndeclare const userInput: unknown;\ndeclare const response: unknown;\ndeclare const maybeNull: unknown;\ndeclare const obj: { prop?: { value?: unknown } };\ndeclare const arr: Array<unknown>;\ndeclare const value: unknown;\ndeclare const anotherValue: unknown;\ndeclare const yetAnotherValue: unknown;\ndeclare const str: string;\ndeclare const collection: Iterable<unknown>;\n\ntype SomeType = Record<string, unknown>;\ntype MyInterface = { id: number; name: string };\ntype _ApiData = { data: unknown };\ntype ThirdType = Record<string, unknown>;\ntype TypedItem = { id: string };\n\n// ✅ VALID - Using as const (allowed exception)\nconst _config = { name: \"test\", value: 123 } as const;\nconst _colors = [\"red\", \"green\", \"blue\"] as const;\n\n// ✅ VALID - Using as unknown as intermediate (allowed exception, but still discouraged)\n// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\nconst _data = someValue as unknown;\n\n// ✅ VALID - Proper type guard\nfunction isString(val: unknown): val is string {\n  return typeof val === \"string\";\n}\nconst _validValue = isString(something) ? something : \"default\";\n\n// ✅ VALID - Explicit null/undefined handling\nconst _validOptional = maybeValue ?? \"default\";\n\n// ❌ INVALID - Angle bracket assertion (SHOULD be flagged)\nconst _angleExample = <string>someValue;\n\n// ❌ INVALID - 'as' keyword assertion (SHOULD be flagged)\nconst _asExample = someValue as string;\nconst _asNumber = userInput as number;\nconst _asObject = response as { id: number; name: string };\n\n// ❌ INVALID - Non-null assertion (SHOULD be flagged)\n// These are intentionally invalid examples - the rule should catch these\n// eslint-disable-next-line @typescript-eslint/no-non-null-assertion\nconst _nonNullExample = maybeNull!;\n// eslint-disable-next-line @typescript-eslint/no-non-null-assertion, @typescript-eslint/no-unnecessary-type-assertion\nconst _chainedNonNull = obj!.prop!.value!;\n// eslint-disable-next-line @typescript-eslint/no-non-null-assertion, @typescript-eslint/no-unnecessary-type-assertion\nconst _arrayNonNull = arr![0];\n\n// ❌ INVALID - Multiple assertion types in one file\nconst _mixed1 = value as SomeType;\n// eslint-disable-next-line @typescript-eslint/no-non-null-assertion\nconst _mixed2 = anotherValue!;\nconst _mixed3 = <ThirdType>yetAnotherValue;\n\n// ❌ INVALID - Common real-world cases that should be caught\n// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\nconst _apiResponse = fetch(\"/api/data\") as Promise<Response>;\nconst _jsonData = JSON.parse(str) as MyInterface;\n// eslint-disable-next-line @typescript-eslint/no-non-null-assertion\nconst _element = document.getElementById(\"root\")!;\nconst _typedArray = Array.from(collection) as Array<TypedItem>;\n\nexport {};\n"]}

package/src/lib/rules/no-typescript-assertion/no-typescript-assertion.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ESLint rule to disallow type assertions in TypeScript.
+ * Initial implementation based on eslint-plugin-no-type-assertion
+ * https://github.com/Dremora/eslint-plugin-no-type-assertion/blob/master/lib/rules/no-type-assertion.js
+ *
+ * @example
+ * // Bad - type assertions bypass type checking
+ * const foo = <string> bar;
+ * const baz = bar as string;
+ * const qux = bar!;
+ *
+ * // Good - proper typing or const assertions
+ * const foo = bar;
+ * const options = ["a", "b"] as const;
+ */
+import { Rule } from "eslint";
+export declare const noTypescriptAssertion: {
+    meta: Rule.RuleMetaData;
+    create: (context: Rule.RuleContext) => Rule.RuleListener;
+};

package/src/lib/rules/no-typescript-assertion/no-typescript-assertion.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noTypescriptAssertion = void 0;
+const meta = {
+    type: "suggestion",
+    docs: {
+        description: "Prevent the use of type assertions to encourage better type safety.",
+    },
+    messages: {
+        angleBracketAssertion: "Avoid using angle bracket for type casting. It bypasses type checking.",
+        asAssertion: "Avoid using the `as` keyword for type casting. It bypasses type checking.",
+        nonNullAssertion: "Avoid using the non-null assertion operator (!). It can lead to runtime errors.",
+    },
+    schema: [],
+};
+/**
+ * Create ESLint rule listener.
+ *
+ * @param {Rule.RuleContext} context - The ESLint rule context.
+ * @returns {Rule.RuleListener} - The listener object for this rule.
+ */
+const create = (context) => {
+    return {
+        /**
+         * Handle TypeScript type assertions using angle brackets.
+         *
+         * @example
+         * // Bad
+         * const foo = <string> bar;
+         * @param {any} node - The AST node.
+         */
+        TSTypeAssertion(node) {
+            const { typeAnnotation } = node;
+            if (typeAnnotation.type === "TSUnknownKeyword") {
+                return;
+            }
+            if (typeAnnotation.type === "TSTypeReference") {
+                const { typeName } = typeAnnotation;
+                if (typeName.type === "Identifier" && typeName.name === "const") {
+                    return;
+                }
+            }
+            context.report({ node, messageId: "angleBracketAssertion" });
+        },
+        /**
+         * Handle TypeScript 'as' expressions for type assertions.
+         *
+         * @example
+         * // Bad
+         * const baz = bar as string;
+         * @param {any} node - The AST node.
+         */
+        TSAsExpression(node) {
+            const { typeAnnotation } = node;
+            if (typeAnnotation.type === "TSUnknownKeyword") {
+                return;
+            }
+            if (typeAnnotation.type === "TSTypeReference") {
+                const { typeName } = typeAnnotation;
+                if (typeName.type === "Identifier" && typeName.name === "const") {
+                    return;
+                }
+            }
+            context.report({ node, messageId: "asAssertion" });
+        },
+        /**
+         * Handle TypeScript non-null expressions using the postfix expression '!'.
+         *
+         * @example
+         * // Bad
+         * const qux = bar!;
+         * @param {any} node - The AST node.
+         */
+        TSNonNullExpression(node) {
+            context.report({ node, messageId: "nonNullAssertion" });
+        },
+    };
+};
+exports.noTypescriptAssertion = {
+    meta,
+    create,
+};
+//# sourceMappingURL=no-typescript-assertion.js.map

package/src/lib/rules/no-typescript-assertion/no-typescript-assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-typescript-assertion.js","sourceRoot":"","sources":["../../../../../../../../libs/eslint/plugin-trackunit/src/lib/rules/no-typescript-assertion/no-typescript-assertion.ts"],"names":[],"mappings":";;;AAkBA,MAAM,IAAI,GAAsB;IAC9B,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE;QACJ,WAAW,EAAE,qEAAqE;KACnF;IACD,QAAQ,EAAE;QACR,qBAAqB,EAAE,wEAAwE;QAC/F,WAAW,EAAE,2EAA2E;QACxF,gBAAgB,EAAE,iFAAiF;KACpG;IACD,MAAM,EAAE,EAAE;CACX,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,GAAG,CAAC,OAAyB,EAAqB,EAAE;IAC9D,OAAO;QACL;;;;;;;WAOG;QACH,eAAe,CAAC,IAAS;YACvB,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;YAEhC,IAAI,cAAc,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC/C,OAAO;YACT,CAAC;YAED,IAAI,cAAc,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC9C,MAAM,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC;gBACpC,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAChE,OAAO;gBACT,CAAC;YACH,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD;;;;;;;WAOG;QACH,cAAc,CAAC,IAAS;YACtB,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;YAEhC,IAAI,cAAc,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC/C,OAAO;YACT,CAAC;YAED,IAAI,cAAc,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC9C,MAAM,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC;gBACpC,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAChE,OAAO;gBACT,CAAC;YACH,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;QACrD,CAAC;QACD;;;;;;;WAOG;QACH,mBAAmB,CAAC,IAAS;YAC3B,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEW,QAAA,qBAAqB,GAAG;IACnC,IAAI;IACJ,MAAM;CACP,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * ESLint rule to disallow type assertions in TypeScript.\n * Initial implementation based on eslint-plugin-no-type-assertion\n * https://github.com/Dremora/eslint-plugin-no-type-assertion/blob/master/lib/rules/no-type-assertion.js\n *\n * @example\n * // Bad - type assertions bypass type checking\n * const foo = <string> bar;\n * const baz = bar as string;\n * const qux = bar!;\n *\n * // Good - proper typing or const assertions\n * const foo = bar;\n * const options = [\"a\", \"b\"] as const;\n */\nimport { Rule } from \"eslint\";\n\nconst meta: Rule.RuleMetaData = {\n  type: \"suggestion\",\n  docs: {\n    description: \"Prevent the use of type assertions to encourage better type safety.\",\n  },\n  messages: {\n    angleBracketAssertion: \"Avoid using angle bracket for type casting. It bypasses type checking.\",\n    asAssertion: \"Avoid using the `as` keyword for type casting. It bypasses type checking.\",\n    nonNullAssertion: \"Avoid using the non-null assertion operator (!). It can lead to runtime errors.\",\n  },\n  schema: [],\n};\n\n/**\n * Create ESLint rule listener.\n *\n * @param {Rule.RuleContext} context - The ESLint rule context.\n * @returns {Rule.RuleListener} - The listener object for this rule.\n */\nconst create = (context: Rule.RuleContext): Rule.RuleListener => {\n  return {\n    /**\n     * Handle TypeScript type assertions using angle brackets.\n     *\n     * @example\n     * // Bad\n     * const foo = <string> bar;\n     * @param {any} node - The AST node.\n     */\n    TSTypeAssertion(node: any) {\n      const { typeAnnotation } = node;\n\n      if (typeAnnotation.type === \"TSUnknownKeyword\") {\n        return;\n      }\n\n      if (typeAnnotation.type === \"TSTypeReference\") {\n        const { typeName } = typeAnnotation;\n        if (typeName.type === \"Identifier\" && typeName.name === \"const\") {\n          return;\n        }\n      }\n\n      context.report({ node, messageId: \"angleBracketAssertion\" });\n    },\n    /**\n     * Handle TypeScript 'as' expressions for type assertions.\n     *\n     * @example\n     * // Bad\n     * const baz = bar as string;\n     * @param {any} node - The AST node.\n     */\n    TSAsExpression(node: any) {\n      const { typeAnnotation } = node;\n\n      if (typeAnnotation.type === \"TSUnknownKeyword\") {\n        return;\n      }\n\n      if (typeAnnotation.type === \"TSTypeReference\") {\n        const { typeName } = typeAnnotation;\n        if (typeName.type === \"Identifier\" && typeName.name === \"const\") {\n          return;\n        }\n      }\n\n      context.report({ node, messageId: \"asAssertion\" });\n    },\n    /**\n     * Handle TypeScript non-null expressions using the postfix expression '!'.\n     *\n     * @example\n     * // Bad\n     * const qux = bar!;\n     * @param {any} node - The AST node.\n     */\n    TSNonNullExpression(node: any) {\n      context.report({ node, messageId: \"nonNullAssertion\" });\n    },\n  };\n};\n\nexport const noTypescriptAssertion = {\n  meta,\n  create,\n};\n"]}