@trackunit/eslint-plugin-trackunit 0.0.2

package/src/lib/utils/nx-utils.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearMetadataCache = exports.projectMatchesCriteria = exports.getProjectMetadata = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const file_utils_1 = require("./file-utils");
+/**
+ * Cache for project metadata to avoid reading files multiple times.
+ * Key is the absolute path to project.json, value is the parsed metadata.
+ */
+const metadataCache = new Map();
+/**
+ * Get NX project metadata from the nearest project.json file.
+ *
+ * @param filePath - Absolute path to a file in the project
+ * @returns Project metadata or null if no project.json found
+ * @example
+ * const metadata = getProjectMetadata("/workspace/libs/my-lib/src/index.ts");
+ * // Returns: { name: "my-lib", tags: ["type:react"], targets: ["build", "test"], ... }
+ */
+const getProjectMetadata = (filePath) => {
+    const projectJsonPath = (0, file_utils_1.findNearestFile)(filePath, "project.json");
+    if (!projectJsonPath) {
+        return null;
+    }
+    // Check cache first
+    if (metadataCache.has(projectJsonPath)) {
+        return metadataCache.get(projectJsonPath) ?? null;
+    }
+    try {
+        const content = fs.readFileSync(projectJsonPath, "utf8");
+        const projectJson = JSON.parse(content);
+        const metadata = {
+            name: projectJson.name ?? "",
+            tags: projectJson.tags ?? [],
+            targets: typeof projectJson.targets === "object" && projectJson.targets !== null ? Object.keys(projectJson.targets) : [],
+            projectJsonPath,
+        };
+        // Cache the result
+        metadataCache.set(projectJsonPath, metadata);
+        return metadata;
+    }
+    catch {
+        return null;
+    }
+};
+exports.getProjectMetadata = getProjectMetadata;
+/**
+ * Check if project metadata matches the given criteria.
+ *
+ * @param metadata - Project metadata to check
+ * @param criteria - Criteria to match against
+ * @returns True if metadata matches all criteria
+ * @example
+ * // Check if project has the "scope:tool" tag
+ * projectMatchesCriteria(metadata, { tags: ["scope:tool"] })
+ * @example
+ * // Check if project has ALL specified tags
+ * projectMatchesCriteria(metadata, {
+ *   tags: ["scope:tool", "type:vanilla"],
+ *   tagsMatchMode: "every"
+ * })
+ * @example
+ * // Check if project has ANY of the specified tags
+ * projectMatchesCriteria(metadata, {
+ *   tags: ["scope:tool", "scope:client"],
+ *   tagsMatchMode: "some"
+ * })
+ * @example
+ * // Check if project has specific targets
+ * projectMatchesCriteria(metadata, { targets: ["build", "test"] })
+ */
+const projectMatchesCriteria = (metadata, criteria) => {
+    const { tags, targets, tagsMatchMode = "some", targetsMatchMode = "some" } = criteria;
+    // Check tags if specified
+    if (tags && tags.length > 0) {
+        const hasMatchingTags = tagsMatchMode === "every"
+            ? tags.every(tag => metadata.tags.includes(tag))
+            : tags.some(tag => metadata.tags.includes(tag));
+        if (!hasMatchingTags) {
+            return false;
+        }
+    }
+    // Check targets if specified
+    if (targets && targets.length > 0) {
+        const hasMatchingTargets = targetsMatchMode === "every"
+            ? targets.every(target => metadata.targets.includes(target))
+            : targets.some(target => metadata.targets.includes(target));
+        if (!hasMatchingTargets) {
+            return false;
+        }
+    }
+    return true;
+};
+exports.projectMatchesCriteria = projectMatchesCriteria;
+/**
+ * Clear the metadata cache. Useful for testing.
+ */
+const clearMetadataCache = () => {
+    metadataCache.clear();
+};
+exports.clearMetadataCache = clearMetadataCache;
+//# sourceMappingURL=nx-utils.js.map

package/src/lib/utils/nx-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nx-utils.js","sourceRoot":"","sources":["../../../../../../../libs/eslint/plugin-trackunit/src/lib/utils/nx-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"fs\";\nimport { findNearestFile } from \"./file-utils\";\n\n/**\n * Utility functions for working with NX project metadata in ESLint rules.\n *\n * ## Main Functions\n * - `getProjectMetadata()` - Get NX project metadata from project.json\n * - `projectMatchesCriteria()` - Check if project matches given criteria\n */\n\nexport type ProjectMetadata = {\n  name: string;\n  tags: Array<string>;\n  targets: Array<string>;\n  projectJsonPath: string;\n};\n\nexport type MatchCriteria = {\n  tags?: Array<string>;\n  targets?: Array<string>;\n  tagsMatchMode?: \"some\" | \"every\";\n  targetsMatchMode?: \"some\" | \"every\";\n};\n\n/**\n * Cache for project metadata to avoid reading files multiple times.\n * Key is the absolute path to project.json, value is the parsed metadata.\n */\nconst metadataCache = new Map<string, ProjectMetadata>();\n\n/**\n * Get NX project metadata from the nearest project.json file.\n *\n * @param filePath - Absolute path to a file in the project\n * @returns Project metadata or null if no project.json found\n * @example\n * const metadata = getProjectMetadata(\"/workspace/libs/my-lib/src/index.ts\");\n * // Returns: { name: \"my-lib\", tags: [\"type:react\"], targets: [\"build\", \"test\"], ... }\n */\nexport const getProjectMetadata = (filePath: string): ProjectMetadata | null => {\n  const projectJsonPath = findNearestFile(filePath, \"project.json\");\n\n  if (!projectJsonPath) {\n    return null;\n  }\n\n  // Check cache first\n  if (metadataCache.has(projectJsonPath)) {\n    return metadataCache.get(projectJsonPath) ?? null;\n  }\n\n  try {\n    const content = fs.readFileSync(projectJsonPath, \"utf8\");\n    const projectJson = JSON.parse(content);\n\n    const metadata: ProjectMetadata = {\n      name: projectJson.name ?? \"\",\n      tags: projectJson.tags ?? [],\n      targets:\n        typeof projectJson.targets === \"object\" && projectJson.targets !== null ? Object.keys(projectJson.targets) : [],\n      projectJsonPath,\n    };\n\n    // Cache the result\n    metadataCache.set(projectJsonPath, metadata);\n\n    return metadata;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Check if project metadata matches the given criteria.\n *\n * @param metadata - Project metadata to check\n * @param criteria - Criteria to match against\n * @returns True if metadata matches all criteria\n * @example\n * // Check if project has the \"scope:tool\" tag\n * projectMatchesCriteria(metadata, { tags: [\"scope:tool\"] })\n * @example\n * // Check if project has ALL specified tags\n * projectMatchesCriteria(metadata, {\n *   tags: [\"scope:tool\", \"type:vanilla\"],\n *   tagsMatchMode: \"every\"\n * })\n * @example\n * // Check if project has ANY of the specified tags\n * projectMatchesCriteria(metadata, {\n *   tags: [\"scope:tool\", \"scope:client\"],\n *   tagsMatchMode: \"some\"\n * })\n * @example\n * // Check if project has specific targets\n * projectMatchesCriteria(metadata, { targets: [\"build\", \"test\"] })\n */\nexport const projectMatchesCriteria = (metadata: ProjectMetadata, criteria: MatchCriteria): boolean => {\n  const { tags, targets, tagsMatchMode = \"some\", targetsMatchMode = \"some\" } = criteria;\n\n  // Check tags if specified\n  if (tags && tags.length > 0) {\n    const hasMatchingTags =\n      tagsMatchMode === \"every\"\n        ? tags.every(tag => metadata.tags.includes(tag))\n        : tags.some(tag => metadata.tags.includes(tag));\n\n    if (!hasMatchingTags) {\n      return false;\n    }\n  }\n\n  // Check targets if specified\n  if (targets && targets.length > 0) {\n    const hasMatchingTargets =\n      targetsMatchMode === \"every\"\n        ? targets.every(target => metadata.targets.includes(target))\n        : targets.some(target => metadata.targets.includes(target));\n\n    if (!hasMatchingTargets) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Clear the metadata cache. Useful for testing.\n */\nexport const clearMetadataCache = (): void => {\n  metadataCache.clear();\n};\n"]}

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

@@ -0,0 +1,38 @@
+/**
+ * Utility functions for working with package.json and npm packages in ESLint rules.
+ *
+ * ## Main Functions
+ * - `getDependencies()` - Get dependencies of a specific type from package.json
+ * - `getPackageNameFromImport()` - Extract base package name from import source
+ */
+export type DependencyType = "dependencies" | "devDependencies" | "all";
+/**
+ * Get dependencies from package.json based on the specified type.
+ *
+ * @param packageJsonPath - Absolute path to package.json
+ * @param type - Type of dependencies to retrieve
+ * @returns Set of package names
+ * @example
+ * // Get only production dependencies
+ * const deps = getDependencies("/path/to/package.json", "dependencies");
+ * @example
+ * // Get only dev dependencies
+ * const devDeps = getDependencies("/path/to/package.json", "devDependencies");
+ * @example
+ * // Get all dependencies (union of both)
+ * const allDeps = getDependencies("/path/to/package.json", "all");
+ */
+export declare const getDependencies: (packageJsonPath: string, type: DependencyType) => Set<string>;
+/**
+ * Extract the base package name from an import source.
+ * Handles scoped packages and sub-path imports.
+ *
+ * @param importSource - The import source from an ImportDeclaration node
+ * @returns The base package name
+ * @example
+ * getPackageNameFromImport("lodash/fp") // → "lodash"
+ * getPackageNameFromImport("@scope/package/sub") // → "@scope/package"
+ * getPackageNameFromImport("react") // → "react"
+ * getPackageNameFromImport("./relative") // → "./relative" (caller should filter)
+ */
+export declare const getPackageNameFromImport: (importSource: string) => string;

package/src/lib/utils/package-utils.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPackageNameFromImport = exports.getDependencies = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+/**
+ * Get dependencies from package.json based on the specified type.
+ *
+ * @param packageJsonPath - Absolute path to package.json
+ * @param type - Type of dependencies to retrieve
+ * @returns Set of package names
+ * @example
+ * // Get only production dependencies
+ * const deps = getDependencies("/path/to/package.json", "dependencies");
+ * @example
+ * // Get only dev dependencies
+ * const devDeps = getDependencies("/path/to/package.json", "devDependencies");
+ * @example
+ * // Get all dependencies (union of both)
+ * const allDeps = getDependencies("/path/to/package.json", "all");
+ */
+const getDependencies = (packageJsonPath, type) => {
+    const packageJsonContent = fs.readFileSync(packageJsonPath, "utf8");
+    const packageJson = JSON.parse(packageJsonContent);
+    const dependencies = packageJson.dependencies ?? {};
+    const devDependencies = packageJson.devDependencies ?? {};
+    switch (type) {
+        case "dependencies":
+            return new Set(Object.keys(dependencies));
+        case "devDependencies":
+            return new Set(Object.keys(devDependencies));
+        case "all":
+            return new Set([...Object.keys(dependencies), ...Object.keys(devDependencies)]);
+        default: {
+            const exhaustiveCheck = type;
+            throw new Error(`Unknown dependency type: ${exhaustiveCheck}`);
+        }
+    }
+};
+exports.getDependencies = getDependencies;
+/**
+ * Extract the base package name from an import source.
+ * Handles scoped packages and sub-path imports.
+ *
+ * @param importSource - The import source from an ImportDeclaration node
+ * @returns The base package name
+ * @example
+ * getPackageNameFromImport("lodash/fp") // → "lodash"
+ * getPackageNameFromImport("@scope/package/sub") // → "@scope/package"
+ * getPackageNameFromImport("react") // → "react"
+ * getPackageNameFromImport("./relative") // → "./relative" (caller should filter)
+ */
+const getPackageNameFromImport = (importSource) => {
+    // Handle relative imports - return as-is, caller should filter
+    if (importSource.startsWith(".") || importSource.startsWith("/")) {
+        return importSource;
+    }
+    // Handle scoped packages: @scope/package/sub-path → @scope/package
+    if (importSource.startsWith("@")) {
+        const parts = importSource.split("/");
+        if (parts.length >= 2) {
+            return `${parts[0]}/${parts[1]}`;
+        }
+        return importSource;
+    }
+    // Handle regular packages: package/sub-path → package
+    const firstSlash = importSource.indexOf("/");
+    if (firstSlash !== -1) {
+        return importSource.substring(0, firstSlash);
+    }
+    return importSource;
+};
+exports.getPackageNameFromImport = getPackageNameFromImport;
+//# sourceMappingURL=package-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-utils.js","sourceRoot":"","sources":["../../../../../../../libs/eslint/plugin-trackunit/src/lib/utils/package-utils.ts"],"names":[],"mappings":";;;;AAAA,+CAAyB;AAiBzB;;;;;;;;;;;;;;;GAeG;AACI,MAAM,eAAe,GAAG,CAAC,eAAuB,EAAE,IAAoB,EAAe,EAAE;IAC5F,MAAM,kBAAkB,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACpE,MAAM,WAAW,GAAgB,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAEhE,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,IAAI,EAAE,CAAC;IACpD,MAAM,eAAe,GAAG,WAAW,CAAC,eAAe,IAAI,EAAE,CAAC;IAE1D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc;YACjB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC5C,KAAK,iBAAiB;YACpB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;QAC/C,KAAK,KAAK;YACR,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,eAAe,GAAU,IAAI,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,4BAA4B,eAAe,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAnBW,QAAA,eAAe,mBAmB1B;AAEF;;;;;;;;;;;GAWG;AACI,MAAM,wBAAwB,GAAG,CAAC,YAAoB,EAAU,EAAE;IACvE,+DAA+D;IAC/D,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,sDAAsD;IACtD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAtBW,QAAA,wBAAwB,4BAsBnC","sourcesContent":["import * as fs from \"fs\";\n\n/**\n * Utility functions for working with package.json and npm packages in ESLint rules.\n *\n * ## Main Functions\n * - `getDependencies()` - Get dependencies of a specific type from package.json\n * - `getPackageNameFromImport()` - Extract base package name from import source\n */\n\nexport type DependencyType = \"dependencies\" | \"devDependencies\" | \"all\";\n\ntype PackageJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n};\n\n/**\n * Get dependencies from package.json based on the specified type.\n *\n * @param packageJsonPath - Absolute path to package.json\n * @param type - Type of dependencies to retrieve\n * @returns Set of package names\n * @example\n * // Get only production dependencies\n * const deps = getDependencies(\"/path/to/package.json\", \"dependencies\");\n * @example\n * // Get only dev dependencies\n * const devDeps = getDependencies(\"/path/to/package.json\", \"devDependencies\");\n * @example\n * // Get all dependencies (union of both)\n * const allDeps = getDependencies(\"/path/to/package.json\", \"all\");\n */\nexport const getDependencies = (packageJsonPath: string, type: DependencyType): Set<string> => {\n  const packageJsonContent = fs.readFileSync(packageJsonPath, \"utf8\");\n  const packageJson: PackageJson = JSON.parse(packageJsonContent);\n\n  const dependencies = packageJson.dependencies ?? {};\n  const devDependencies = packageJson.devDependencies ?? {};\n\n  switch (type) {\n    case \"dependencies\":\n      return new Set(Object.keys(dependencies));\n    case \"devDependencies\":\n      return new Set(Object.keys(devDependencies));\n    case \"all\":\n      return new Set([...Object.keys(dependencies), ...Object.keys(devDependencies)]);\n    default: {\n      const exhaustiveCheck: never = type;\n      throw new Error(`Unknown dependency type: ${exhaustiveCheck}`);\n    }\n  }\n};\n\n/**\n * Extract the base package name from an import source.\n * Handles scoped packages and sub-path imports.\n *\n * @param importSource - The import source from an ImportDeclaration node\n * @returns The base package name\n * @example\n * getPackageNameFromImport(\"lodash/fp\") // → \"lodash\"\n * getPackageNameFromImport(\"@scope/package/sub\") // → \"@scope/package\"\n * getPackageNameFromImport(\"react\") // → \"react\"\n * getPackageNameFromImport(\"./relative\") // → \"./relative\" (caller should filter)\n */\nexport const getPackageNameFromImport = (importSource: string): string => {\n  // Handle relative imports - return as-is, caller should filter\n  if (importSource.startsWith(\".\") || importSource.startsWith(\"/\")) {\n    return importSource;\n  }\n\n  // Handle scoped packages: @scope/package/sub-path → @scope/package\n  if (importSource.startsWith(\"@\")) {\n    const parts = importSource.split(\"/\");\n    if (parts.length >= 2) {\n      return `${parts[0]}/${parts[1]}`;\n    }\n    return importSource;\n  }\n\n  // Handle regular packages: package/sub-path → package\n  const firstSlash = importSource.indexOf(\"/\");\n  if (firstSlash !== -1) {\n    return importSource.substring(0, firstSlash);\n  }\n\n  return importSource;\n};\n"]}

package/src/lib/utils/typescript-utils.d.ts

@@ -0,0 +1,29 @@
+import { TSESLint, TSESTree } from "@typescript-eslint/utils";
+export type OptionalProp = {
+    name: string;
+    type: "boolean";
+} | {
+    name: string;
+    type: "string";
+} | {
+    name: string;
+    type: "number";
+} | {
+    name: string;
+    type: "object";
+} | {
+    name: string;
+    type: "stringLiteral";
+    stringLiterals: Array<string>;
+} | {
+    name: string;
+    type: "enum";
+    enumValues: Array<string | number>;
+} | {
+    name: string;
+    type: "unknown";
+};
+/**
+ * Helper function to extract optional properties from a TypeScript type annotation
+ */
+export declare const getOptionalPropsFromType: (context: TSESLint.RuleContext<string, ReadonlyArray<unknown>>, typeNode: TSESTree.TypeNode | undefined) => Array<OptionalProp>;

package/src/lib/utils/typescript-utils.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOptionalPropsFromType = void 0;
+const tslib_1 = require("tslib");
+const utils_1 = require("@typescript-eslint/utils");
+const ts = tslib_1.__importStar(require("typescript"));
+function isStringLiteralType(type) {
+    return (type.flags & ts.TypeFlags.StringLiteral) !== 0 && "value" in type;
+}
+function isEnumLiteralType(type) {
+    return (type.flags & ts.TypeFlags.EnumLiteral) !== 0 && "value" in type;
+}
+// Type guard for TSESTree literal nodes
+function isTSLiteralTypeWithStringLiteral(node) {
+    return (node.type === utils_1.AST_NODE_TYPES.TSLiteralType &&
+        node.literal.type === utils_1.AST_NODE_TYPES.Literal &&
+        typeof node.literal.value === "string");
+}
+function isTSLiteralTypeWithLiteral(node) {
+    return node.type === utils_1.AST_NODE_TYPES.TSLiteralType && node.literal.type === utils_1.AST_NODE_TYPES.Literal;
+}
+/**
+ * Unified helper function to analyze prop types
+ */
+const analyzeTypeProperties = (typeNode, tsType) => {
+    // Try TypeScript type checker first (more accurate)
+    if (tsType) {
+        const flags = tsType.getFlags();
+        // Check for string literal types (including unions like "a" | "b")
+        const isStringLiteral = (flags & ts.TypeFlags.StringLiteral) !== 0 ||
+            (tsType.isUnion() &&
+                tsType.types
+                    .filter(t => (t.getFlags() & ts.TypeFlags.Undefined) === 0)
+                    .every(t => (t.getFlags() & ts.TypeFlags.StringLiteral) !== 0) &&
+                tsType.types.some(t => (t.getFlags() & ts.TypeFlags.StringLiteral) !== 0));
+        if (isStringLiteral) {
+            let stringLiterals;
+            if (tsType.isUnion()) {
+                stringLiterals = tsType.types.filter(isStringLiteralType).map(t => t.value);
+            }
+            else if (isStringLiteralType(tsType)) {
+                stringLiterals = [tsType.value];
+            }
+            else {
+                stringLiterals = [];
+            }
+            return { type: "stringLiteral", stringLiterals };
+        }
+        // Check for enum types
+        if (isEnumLiteralType(tsType)) {
+            return { type: "enum", enumValues: [tsType.value] };
+        }
+        else if (tsType.isUnion()) {
+            const enumTypes = tsType.types.filter(isEnumLiteralType);
+            if (enumTypes.length > 0) {
+                const enumValues = enumTypes.map(t => t.value);
+                return { type: "enum", enumValues };
+            }
+        }
+        // Check for union types that contain specific primitives (e.g., boolean | undefined)
+        if (tsType.isUnion()) {
+            const nonUndefinedTypes = tsType.types.filter(t => (t.getFlags() & ts.TypeFlags.Undefined) === 0);
+            // Check if all non-undefined types are booleans
+            if (nonUndefinedTypes.length > 0 &&
+                nonUndefinedTypes.every(t => (t.getFlags() & ts.TypeFlags.Boolean) !== 0 || (t.getFlags() & ts.TypeFlags.BooleanLiteral) !== 0)) {
+                return { type: "boolean" };
+            }
+            // Check if all non-undefined types are strings
+            if (nonUndefinedTypes.length > 0 && nonUndefinedTypes.every(t => (t.getFlags() & ts.TypeFlags.String) !== 0)) {
+                return { type: "string" };
+            }
+            // Check if all non-undefined types are numbers
+            if (nonUndefinedTypes.length > 0 &&
+                nonUndefinedTypes.every(t => (t.getFlags() & ts.TypeFlags.Number) !== 0 || (t.getFlags() & ts.TypeFlags.NumberLiteral) !== 0)) {
+                return { type: "number" };
+            }
+        }
+        // Check for other primitive types
+        if ((flags & ts.TypeFlags.Boolean) !== 0 || (flags & ts.TypeFlags.BooleanLiteral) !== 0) {
+            return { type: "boolean" };
+        }
+        if ((flags & ts.TypeFlags.String) !== 0) {
+            return { type: "string" };
+        }
+        if ((flags & ts.TypeFlags.Number) !== 0 || (flags & ts.TypeFlags.NumberLiteral) !== 0) {
+            return { type: "number" };
+        }
+        if ((flags & ts.TypeFlags.Object) !== 0) {
+            return { type: "object" };
+        }
+        // If we couldn't identify the type, mark it as unknown
+        return { type: "unknown" };
+    }
+    // Fallback to AST-based analysis
+    if (!typeNode) {
+        return { type: "unknown" };
+    }
+    // Check for string literal types
+    const isStringLiteralAST = isTSLiteralTypeWithStringLiteral(typeNode) ||
+        (typeNode.type === utils_1.AST_NODE_TYPES.TSUnionType && typeNode.types.every(isTSLiteralTypeWithStringLiteral));
+    if (isStringLiteralAST) {
+        let stringLiterals;
+        if (typeNode.type === utils_1.AST_NODE_TYPES.TSUnionType) {
+            stringLiterals = typeNode.types.filter(isTSLiteralTypeWithStringLiteral).map(t => t.literal.value);
+        }
+        else if (isTSLiteralTypeWithStringLiteral(typeNode)) {
+            stringLiterals = [typeNode.literal.value];
+        }
+        else {
+            stringLiterals = [];
+        }
+        return { type: "stringLiteral", stringLiterals };
+    }
+    // Check for enum types (AST-based approximation)
+    if (typeNode.type === utils_1.AST_NODE_TYPES.TSUnionType &&
+        typeNode.types.every(t => t.type === utils_1.AST_NODE_TYPES.TSLiteralType &&
+            t.literal.type === utils_1.AST_NODE_TYPES.Literal &&
+            (typeof t.literal.value === "string" || typeof t.literal.value === "number"))) {
+        const enumValues = typeNode.types
+            .filter(isTSLiteralTypeWithLiteral)
+            .map(t => t.literal.value)
+            .filter((value) => typeof value === "string" || typeof value === "number");
+        return { type: "enum", enumValues };
+    }
+    // Check for other primitive types
+    if (typeNode.type === utils_1.AST_NODE_TYPES.TSBooleanKeyword ||
+        (typeNode.type === utils_1.AST_NODE_TYPES.TSLiteralType &&
+            typeNode.literal.type === utils_1.AST_NODE_TYPES.Literal &&
+            typeof typeNode.literal.value === "boolean")) {
+        return { type: "boolean" };
+    }
+    if (typeNode.type === utils_1.AST_NODE_TYPES.TSStringKeyword) {
+        return { type: "string" };
+    }
+    if (typeNode.type === utils_1.AST_NODE_TYPES.TSNumberKeyword ||
+        (typeNode.type === utils_1.AST_NODE_TYPES.TSLiteralType &&
+            typeNode.literal.type === utils_1.AST_NODE_TYPES.Literal &&
+            typeof typeNode.literal.value === "number")) {
+        return { type: "number" };
+    }
+    if (typeNode.type === utils_1.AST_NODE_TYPES.TSTypeLiteral ||
+        typeNode.type === utils_1.AST_NODE_TYPES.TSArrayType ||
+        (typeNode.type === utils_1.AST_NODE_TYPES.TSTypeReference &&
+            typeNode.typeName.type === utils_1.AST_NODE_TYPES.Identifier &&
+            /^(Array|Object|Record|Map|Set)$/.test(typeNode.typeName.name))) {
+        return { type: "object" };
+    }
+    return { type: "unknown" };
+};
+/**
+ * Helper function to extract optional properties from a TypeScript type annotation
+ */
+const getOptionalPropsFromType = (context, typeNode) => {
+    if (!typeNode)
+        return [];
+    const optionalProps = [];
+    const processType = (node) => {
+        if (node.type === utils_1.AST_NODE_TYPES.TSTypeReference && node.typeName.type === utils_1.AST_NODE_TYPES.Identifier) {
+            // Try to get type information using the type checker
+            const services = utils_1.ESLintUtils.getParserServices(context);
+            try {
+                const checker = services.program.getTypeChecker();
+                const tsNode = services.esTreeNodeToTSNodeMap.get(node);
+                const type = checker.getTypeFromTypeNode(tsNode);
+                // Get the symbol properties - this works for resolved intersection types
+                const props = checker.getPropertiesOfType(type);
+                props.forEach(prop => {
+                    const propType = checker.getTypeOfSymbolAtLocation(prop, tsNode);
+                    // Check if the property is optional by examining all declarations
+                    const isOptional = prop.declarations?.some(decl => "questionToken" in decl && decl.questionToken !== undefined) ?? false;
+                    if (isOptional) {
+                        const typeAnalysis = analyzeTypeProperties(undefined, propType);
+                        optionalProps.push({
+                            name: prop.getName(),
+                            ...typeAnalysis,
+                        });
+                    }
+                });
+            }
+            catch (_error) {
+                // If type checking fails, fall back to the original behavior
+                return;
+            }
+            return;
+        }
+        if (node.type === utils_1.AST_NODE_TYPES.TSTypeLiteral) {
+            node.members.forEach(member => {
+                if (member.type === utils_1.AST_NODE_TYPES.TSPropertySignature &&
+                    member.key.type === utils_1.AST_NODE_TYPES.Identifier &&
+                    member.optional) {
+                    const propName = member.key.name;
+                    const propType = member.typeAnnotation?.typeAnnotation;
+                    const typeAnalysis = analyzeTypeProperties(propType);
+                    optionalProps.push({
+                        name: propName,
+                        ...typeAnalysis,
+                    });
+                }
+            });
+        }
+        if (node.type === utils_1.AST_NODE_TYPES.TSIntersectionType) {
+            node.types.forEach(processType);
+        }
+        if (node.type === utils_1.AST_NODE_TYPES.TSUnionType) {
+            // For union types, we'll be conservative and process all types
+            node.types.forEach(processType);
+        }
+    };
+    processType(typeNode);
+    return optionalProps;
+};
+exports.getOptionalPropsFromType = getOptionalPropsFromType;
+//# sourceMappingURL=typescript-utils.js.map

package/src/lib/utils/typescript-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-utils.js","sourceRoot":"","sources":["../../../../../../../libs/eslint/plugin-trackunit/src/lib/utils/typescript-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { MappedOmit } from \"@trackunit/shared-utils\";\nimport { AST_NODE_TYPES, ESLintUtils, TSESLint, TSESTree } from \"@typescript-eslint/utils\";\nimport * as ts from \"typescript\";\n\n// Type guards for TypeScript API\ntype StringLiteralType = ts.Type & { value: string };\ntype EnumLiteralType = ts.Type & { value: string | number };\n\nfunction isStringLiteralType(type: ts.Type): type is StringLiteralType {\n  return (type.flags & ts.TypeFlags.StringLiteral) !== 0 && \"value\" in type;\n}\n\nfunction isEnumLiteralType(type: ts.Type): type is EnumLiteralType {\n  return (type.flags & ts.TypeFlags.EnumLiteral) !== 0 && \"value\" in type;\n}\n\n// Type guard for TSESTree literal nodes\nfunction isTSLiteralTypeWithStringLiteral(\n  node: TSESTree.TypeNode\n): node is TSESTree.TSLiteralType & { literal: TSESTree.Literal & { value: string } } {\n  return (\n    node.type === AST_NODE_TYPES.TSLiteralType &&\n    node.literal.type === AST_NODE_TYPES.Literal &&\n    typeof node.literal.value === \"string\"\n  );\n}\n\nfunction isTSLiteralTypeWithLiteral(\n  node: TSESTree.TypeNode\n): node is TSESTree.TSLiteralType & { literal: TSESTree.Literal } {\n  return node.type === AST_NODE_TYPES.TSLiteralType && node.literal.type === AST_NODE_TYPES.Literal;\n}\n\nexport type OptionalProp =\n  | { name: string; type: \"boolean\" }\n  | { name: string; type: \"string\" }\n  | { name: string; type: \"number\" }\n  | { name: string; type: \"object\" }\n  | { name: string; type: \"stringLiteral\"; stringLiterals: Array<string> }\n  | { name: string; type: \"enum\"; enumValues: Array<string | number> }\n  | { name: string; type: \"unknown\" };\n\n/**\n * Unified helper function to analyze prop types\n */\nconst analyzeTypeProperties = (\n  typeNode: TSESTree.TypeNode | undefined,\n  tsType?: ts.Type\n): MappedOmit<OptionalProp, \"name\"> => {\n  // Try TypeScript type checker first (more accurate)\n  if (tsType) {\n    const flags = tsType.getFlags();\n\n    // Check for string literal types (including unions like \"a\" | \"b\")\n    const isStringLiteral =\n      (flags & ts.TypeFlags.StringLiteral) !== 0 ||\n      (tsType.isUnion() &&\n        tsType.types\n          .filter(t => (t.getFlags() & ts.TypeFlags.Undefined) === 0)\n          .every(t => (t.getFlags() & ts.TypeFlags.StringLiteral) !== 0) &&\n        tsType.types.some(t => (t.getFlags() & ts.TypeFlags.StringLiteral) !== 0));\n\n    if (isStringLiteral) {\n      let stringLiterals: Array<string>;\n      if (tsType.isUnion()) {\n        stringLiterals = tsType.types.filter(isStringLiteralType).map(t => t.value);\n      } else if (isStringLiteralType(tsType)) {\n        stringLiterals = [tsType.value];\n      } else {\n        stringLiterals = [];\n      }\n      return { type: \"stringLiteral\", stringLiterals };\n    }\n\n    // Check for enum types\n    if (isEnumLiteralType(tsType)) {\n      return { type: \"enum\", enumValues: [tsType.value] };\n    } else if (tsType.isUnion()) {\n      const enumTypes = tsType.types.filter(isEnumLiteralType);\n      if (enumTypes.length > 0) {\n        const enumValues = enumTypes.map(t => t.value);\n        return { type: \"enum\", enumValues };\n      }\n    }\n\n    // Check for union types that contain specific primitives (e.g., boolean | undefined)\n    if (tsType.isUnion()) {\n      const nonUndefinedTypes = tsType.types.filter(t => (t.getFlags() & ts.TypeFlags.Undefined) === 0);\n\n      // Check if all non-undefined types are booleans\n      if (\n        nonUndefinedTypes.length > 0 &&\n        nonUndefinedTypes.every(\n          t => (t.getFlags() & ts.TypeFlags.Boolean) !== 0 || (t.getFlags() & ts.TypeFlags.BooleanLiteral) !== 0\n        )\n      ) {\n        return { type: \"boolean\" };\n      }\n\n      // Check if all non-undefined types are strings\n      if (nonUndefinedTypes.length > 0 && nonUndefinedTypes.every(t => (t.getFlags() & ts.TypeFlags.String) !== 0)) {\n        return { type: \"string\" };\n      }\n\n      // Check if all non-undefined types are numbers\n      if (\n        nonUndefinedTypes.length > 0 &&\n        nonUndefinedTypes.every(\n          t => (t.getFlags() & ts.TypeFlags.Number) !== 0 || (t.getFlags() & ts.TypeFlags.NumberLiteral) !== 0\n        )\n      ) {\n        return { type: \"number\" };\n      }\n    }\n\n    // Check for other primitive types\n    if ((flags & ts.TypeFlags.Boolean) !== 0 || (flags & ts.TypeFlags.BooleanLiteral) !== 0) {\n      return { type: \"boolean\" };\n    }\n    if ((flags & ts.TypeFlags.String) !== 0) {\n      return { type: \"string\" };\n    }\n    if ((flags & ts.TypeFlags.Number) !== 0 || (flags & ts.TypeFlags.NumberLiteral) !== 0) {\n      return { type: \"number\" };\n    }\n    if ((flags & ts.TypeFlags.Object) !== 0) {\n      return { type: \"object\" };\n    }\n\n    // If we couldn't identify the type, mark it as unknown\n    return { type: \"unknown\" };\n  }\n\n  // Fallback to AST-based analysis\n  if (!typeNode) {\n    return { type: \"unknown\" };\n  }\n\n  // Check for string literal types\n  const isStringLiteralAST =\n    isTSLiteralTypeWithStringLiteral(typeNode) ||\n    (typeNode.type === AST_NODE_TYPES.TSUnionType && typeNode.types.every(isTSLiteralTypeWithStringLiteral));\n\n  if (isStringLiteralAST) {\n    let stringLiterals: Array<string>;\n    if (typeNode.type === AST_NODE_TYPES.TSUnionType) {\n      stringLiterals = typeNode.types.filter(isTSLiteralTypeWithStringLiteral).map(t => t.literal.value);\n    } else if (isTSLiteralTypeWithStringLiteral(typeNode)) {\n      stringLiterals = [typeNode.literal.value];\n    } else {\n      stringLiterals = [];\n    }\n    return { type: \"stringLiteral\", stringLiterals };\n  }\n\n  // Check for enum types (AST-based approximation)\n  if (\n    typeNode.type === AST_NODE_TYPES.TSUnionType &&\n    typeNode.types.every(\n      t =>\n        t.type === AST_NODE_TYPES.TSLiteralType &&\n        t.literal.type === AST_NODE_TYPES.Literal &&\n        (typeof t.literal.value === \"string\" || typeof t.literal.value === \"number\")\n    )\n  ) {\n    const enumValues = typeNode.types\n      .filter(isTSLiteralTypeWithLiteral)\n      .map(t => t.literal.value)\n      .filter((value): value is string | number => typeof value === \"string\" || typeof value === \"number\");\n    return { type: \"enum\", enumValues };\n  }\n\n  // Check for other primitive types\n  if (\n    typeNode.type === AST_NODE_TYPES.TSBooleanKeyword ||\n    (typeNode.type === AST_NODE_TYPES.TSLiteralType &&\n      typeNode.literal.type === AST_NODE_TYPES.Literal &&\n      typeof typeNode.literal.value === \"boolean\")\n  ) {\n    return { type: \"boolean\" };\n  }\n\n  if (typeNode.type === AST_NODE_TYPES.TSStringKeyword) {\n    return { type: \"string\" };\n  }\n\n  if (\n    typeNode.type === AST_NODE_TYPES.TSNumberKeyword ||\n    (typeNode.type === AST_NODE_TYPES.TSLiteralType &&\n      typeNode.literal.type === AST_NODE_TYPES.Literal &&\n      typeof typeNode.literal.value === \"number\")\n  ) {\n    return { type: \"number\" };\n  }\n\n  if (\n    typeNode.type === AST_NODE_TYPES.TSTypeLiteral ||\n    typeNode.type === AST_NODE_TYPES.TSArrayType ||\n    (typeNode.type === AST_NODE_TYPES.TSTypeReference &&\n      typeNode.typeName.type === AST_NODE_TYPES.Identifier &&\n      /^(Array|Object|Record|Map|Set)$/.test(typeNode.typeName.name))\n  ) {\n    return { type: \"object\" };\n  }\n\n  return { type: \"unknown\" };\n};\n\n/**\n * Helper function to extract optional properties from a TypeScript type annotation\n */\nexport const getOptionalPropsFromType = (\n  context: TSESLint.RuleContext<string, ReadonlyArray<unknown>>,\n  typeNode: TSESTree.TypeNode | undefined\n): Array<OptionalProp> => {\n  if (!typeNode) return [];\n\n  const optionalProps: Array<OptionalProp> = [];\n\n  const processType = (node: TSESTree.TypeNode) => {\n    if (node.type === AST_NODE_TYPES.TSTypeReference && node.typeName.type === AST_NODE_TYPES.Identifier) {\n      // Try to get type information using the type checker\n      const services = ESLintUtils.getParserServices(context);\n\n      try {\n        const checker = services.program.getTypeChecker();\n        const tsNode = services.esTreeNodeToTSNodeMap.get(node);\n        const type = checker.getTypeFromTypeNode(tsNode);\n\n        // Get the symbol properties - this works for resolved intersection types\n        const props = checker.getPropertiesOfType(type);\n        props.forEach(prop => {\n          const propType = checker.getTypeOfSymbolAtLocation(prop, tsNode);\n\n          // Check if the property is optional by examining all declarations\n          const isOptional =\n            prop.declarations?.some(decl => \"questionToken\" in decl && decl.questionToken !== undefined) ?? false;\n\n          if (isOptional) {\n            const typeAnalysis = analyzeTypeProperties(undefined, propType);\n            optionalProps.push({\n              name: prop.getName(),\n              ...typeAnalysis,\n            });\n          }\n        });\n      } catch (_error) {\n        // If type checking fails, fall back to the original behavior\n        return;\n      }\n\n      return;\n    }\n\n    if (node.type === AST_NODE_TYPES.TSTypeLiteral) {\n      node.members.forEach(member => {\n        if (\n          member.type === AST_NODE_TYPES.TSPropertySignature &&\n          member.key.type === AST_NODE_TYPES.Identifier &&\n          member.optional\n        ) {\n          const propName = member.key.name;\n          const propType = member.typeAnnotation?.typeAnnotation;\n\n          const typeAnalysis = analyzeTypeProperties(propType);\n          optionalProps.push({\n            name: propName,\n            ...typeAnalysis,\n          });\n        }\n      });\n    }\n\n    if (node.type === AST_NODE_TYPES.TSIntersectionType) {\n      node.types.forEach(processType);\n    }\n\n    if (node.type === AST_NODE_TYPES.TSUnionType) {\n      // For union types, we'll be conservative and process all types\n      node.types.forEach(processType);\n    }\n  };\n\n  processType(typeNode);\n  return optionalProps;\n};\n"]}