uilint-eslint 0.2.1 → 0.2.4

package/dist/chunk-IL6RYCMD.js

@@ -0,0 +1,10 @@
+// src/utils/create-rule.ts
+import { ESLintUtils } from "@typescript-eslint/utils";
+var createRule = ESLintUtils.RuleCreator(
+  (name) => `https://github.com/peter-suggate/uilint/blob/main/packages/uilint-eslint/docs/rules/${name}.md`
+);
+
+export {
+  createRule
+};
+//# sourceMappingURL=chunk-IL6RYCMD.js.map

package/dist/chunk-IL6RYCMD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/create-rule.ts"],"sourcesContent":["/**\n * Rule creation helper using @typescript-eslint/utils\n */\n\nimport { ESLintUtils } from \"@typescript-eslint/utils\";\n\nexport const createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/peter-suggate/uilint/blob/main/packages/uilint-eslint/docs/rules/${name}.md`\n);\n"],"mappings":";AAIA,SAAS,mBAAmB;AAErB,IAAM,aAAa,YAAY;AAAA,EACpC,CAAC,SACC,uFAAuF,IAAI;AAC/F;","names":[]}

package/dist/index.d.ts

@@ -2,18 +2,6 @@ import * as _typescript_eslint_utils_ts_eslint from '@typescript-eslint/utils/ts
 import { Linter } from 'eslint';
 import { ESLintUtils } from '@typescript-eslint/utils';
 
-/**
- * Component Parser
- *
- * Parses a single component's body to extract styling information
- * and identify nested component usage.
- */
-
-/**
- * Known UI library import patterns
- */
-type LibraryName = "shadcn" | "mui" | "chakra" | "antd";
-
 /**
  * Rule creation helper using @typescript-eslint/utils
  */
@@ -96,7 +84,56 @@ declare function clearCacheEntry(projectRoot: string, filePath: string): void;
 /**
  * Clear entire cache
  */
-declare function clearCache(projectRoot: string): void;
+declare function clearCache$1(projectRoot: string): void;
+
+/**
+ * Component Parser
+ *
+ * Parses a single component's body to extract styling information
+ * and identify nested component usage.
+ */
+
+/**
+ * Known UI library import patterns
+ */
+type LibraryName = "shadcn" | "mui" | "chakra" | "antd";
+
+/**
+ * Import Graph Service
+ *
+ * Provides demand-driven cross-file analysis to detect UI library usage
+ * across component trees. Uses in-memory caching for performance.
+ */
+
+/**
+ * Information about a component's UI library usage
+ */
+interface ComponentLibraryInfo {
+    /** Direct library (from import source, e.g., "@mui/material" -> "mui") */
+    library: LibraryName | null;
+    /** Libraries used internally by this component (for local components) */
+    internalLibraries: Set<LibraryName>;
+    /** Evidence of which internal components caused the library detection */
+    libraryEvidence: Array<{
+        componentName: string;
+        library: LibraryName;
+    }>;
+    /** Whether this is a local component (resolved from project files) */
+    isLocalComponent: boolean;
+}
+/**
+ * Analyze a component's library usage, including transitive dependencies
+ *
+ * @param contextFilePath - The file where the component is used (for resolving relative imports)
+ * @param componentName - The name of the component (e.g., "Button", "MyCard")
+ * @param importSource - The import source (e.g., "@mui/material", "./components/cards")
+ * @returns Library information including direct and transitive library usage
+ */
+declare function getComponentLibrary(contextFilePath: string, componentName: string, importSource: string): ComponentLibraryInfo;
+/**
+ * Clear all caches (useful for testing or between ESLint runs)
+ */
+declare function clearCache(): void;
 
 /**
  * Rule Registry
@@ -213,6 +250,12 @@ declare const rules: {
     }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
+    "semantic-vision": _typescript_eslint_utils_ts_eslint.RuleModule<"visionIssue" | "analysisStale", [{
+        maxAgeMs?: number;
+        screenshotsPath?: string;
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
 };
 /**
  * Plugin metadata
@@ -268,6 +311,12 @@ declare const plugin: {
         }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
+        "semantic-vision": _typescript_eslint_utils_ts_eslint.RuleModule<"visionIssue" | "analysisStale", [{
+            maxAgeMs?: number;
+            screenshotsPath?: string;
+        }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
     };
 };
 /**
@@ -288,4 +337,4 @@ interface UILintESLint {
  */
 declare const uilintEslint: UILintESLint;
 
-export { type CacheEntry, type CacheStore, type CachedIssue, type OptionFieldSchema, type RuleMetadata, type RuleOptionSchema, type UILintESLint, clearCache, clearCacheEntry, configs, createRule, uilintEslint as default, findStyleguidePath, getCacheEntry, getRuleMetadata, getRulesByCategory, getStyleguide, hashContent, hashContentSync, loadCache, loadStyleguide, meta, plugin, ruleRegistry, rules, saveCache, setCacheEntry };
+export { type CacheEntry, type CacheStore, type CachedIssue, type LibraryName, type OptionFieldSchema, type RuleMetadata, type RuleOptionSchema, type UILintESLint, clearCache$1 as clearCache, clearCacheEntry, clearCache as clearImportGraphCache, configs, createRule, uilintEslint as default, findStyleguidePath, getCacheEntry, getComponentLibrary, getRuleMetadata, getRulesByCategory, getStyleguide, hashContent, hashContentSync, loadCache, loadStyleguide, meta, plugin, ruleRegistry, rules, saveCache, setCacheEntry };

package/dist/index.js

@@ -1004,6 +1004,11 @@ function resolveExport(exportName, filePath, visited = /* @__PURE__ */ new Set()
     isReexport: false
   };
 }
+function clearResolverCaches() {
+  exportCache.clear();
+  astCache.clear();
+  resolvedPathCache.clear();
+}
 
 // src/utils/component-parser.ts
 var LIBRARY_PATTERNS = {
@@ -1298,6 +1303,10 @@ function analyzeComponentLibraries(filePath, componentName, visited) {
     isLocalComponent: true
   };
 }
+function clearCache() {
+  componentLibraryCache.clear();
+  clearResolverCaches();
+}
 
 // src/rules/no-mixed-component-libraries.ts
 var no_mixed_component_libraries_default = createRule({
@@ -1510,7 +1519,7 @@ function clearCacheEntry(projectRoot, filePath) {
   delete cache.entries[filePath];
   saveCache(projectRoot, cache);
 }
-function clearCache(projectRoot) {
+function clearCache2(projectRoot) {
   saveCache(projectRoot, { version: CACHE_VERSION, entries: {} });
 }
 
@@ -1838,6 +1847,151 @@ function runSemanticAnalysisSync(sourceCode, styleguide, model, filePath) {
   }
 }
 
+// src/rules/semantic-vision.ts
+import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync5 } from "fs";
+import { dirname as dirname5, join as join5, relative as relative2 } from "path";
+function findProjectRoot3(startDir) {
+  let dir = startDir;
+  for (let i = 0; i < 20; i++) {
+    if (existsSync5(join5(dir, "package.json"))) {
+      return dir;
+    }
+    const parent = dirname5(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return startDir;
+}
+function getVisionResultFiles(screenshotsDir) {
+  if (!existsSync5(screenshotsDir)) {
+    return [];
+  }
+  try {
+    const files = readdirSync(screenshotsDir);
+    return files.filter((f) => f.endsWith(".json")).map((f) => join5(screenshotsDir, f)).sort().reverse();
+  } catch {
+    return [];
+  }
+}
+function loadVisionResult(filePath) {
+  try {
+    const content = readFileSync5(filePath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function parseDataLoc(dataLoc) {
+  const match = dataLoc.match(/^(.+):(\d+):(\d+)$/);
+  if (!match) return null;
+  return {
+    filePath: match[1],
+    line: parseInt(match[2], 10),
+    column: parseInt(match[3], 10)
+  };
+}
+function normalizeFilePath(filePath, projectRoot) {
+  if (!filePath.startsWith("/")) {
+    return filePath;
+  }
+  return relative2(projectRoot, filePath);
+}
+var semantic_vision_default = createRule({
+  name: "semantic-vision",
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "Report cached vision analysis results from UILint browser overlay"
+    },
+    messages: {
+      visionIssue: "[Vision] {{message}}",
+      analysisStale: "Vision analysis results are stale (older than {{age}}). Re-run analysis in browser."
+    },
+    schema: [
+      {
+        type: "object",
+        properties: {
+          maxAgeMs: {
+            type: "number",
+            description: "Maximum age of cached results in milliseconds (default: 1 hour)"
+          },
+          screenshotsPath: {
+            type: "string",
+            description: "Path to screenshots directory (default: .uilint/screenshots)"
+          }
+        },
+        additionalProperties: false
+      }
+    ]
+  },
+  defaultOptions: [{ maxAgeMs: 60 * 60 * 1e3 }],
+  // 1 hour default
+  create(context) {
+    const options = context.options[0] || {};
+    const maxAgeMs = options.maxAgeMs ?? 60 * 60 * 1e3;
+    const filePath = context.filename;
+    const fileDir = dirname5(filePath);
+    const projectRoot = findProjectRoot3(fileDir);
+    const screenshotsDir = options.screenshotsPath ? join5(projectRoot, options.screenshotsPath) : join5(projectRoot, ".uilint", "screenshots");
+    const relativeFilePath = normalizeFilePath(filePath, projectRoot);
+    const resultFiles = getVisionResultFiles(screenshotsDir);
+    if (resultFiles.length === 0) {
+      return {};
+    }
+    const matchingIssues = [];
+    const now = Date.now();
+    for (const resultFile of resultFiles) {
+      const result = loadVisionResult(resultFile);
+      if (!result || !result.issues) continue;
+      const isStale = now - result.timestamp > maxAgeMs;
+      for (const issue of result.issues) {
+        if (!issue.dataLoc) continue;
+        const parsed = parseDataLoc(issue.dataLoc);
+        if (!parsed) continue;
+        const issueFilePath = normalizeFilePath(parsed.filePath, projectRoot);
+        if (issueFilePath === relativeFilePath) {
+          matchingIssues.push({
+            issue,
+            line: parsed.line,
+            column: parsed.column,
+            isStale
+          });
+        }
+      }
+    }
+    const seenIssues = /* @__PURE__ */ new Set();
+    const uniqueIssues = matchingIssues.filter((item) => {
+      const key = `${item.line}:${item.column}:${item.issue.message}`;
+      if (seenIssues.has(key)) return false;
+      seenIssues.add(key);
+      return true;
+    });
+    return {
+      Program(node) {
+        for (const { issue, line, column, isStale } of uniqueIssues) {
+          const categoryPrefix = issue.category ? `[${issue.category}] ` : "";
+          const message = `${categoryPrefix}${issue.message}`;
+          if (isStale) {
+            const ageHours = Math.round(maxAgeMs / (60 * 60 * 1e3));
+            context.report({
+              node,
+              loc: { line, column },
+              messageId: "analysisStale",
+              data: { age: `${ageHours}h` }
+            });
+          }
+          context.report({
+            node,
+            loc: { line, column },
+            messageId: "visionIssue",
+            data: { message }
+          });
+        }
+      }
+    };
+  }
+});
+
 // src/rule-registry.ts
 var ruleRegistry = [
   {
@@ -2004,6 +2158,37 @@ var ruleRegistry = [
     },
     requiresStyleguide: true,
     category: "semantic"
+  },
+  {
+    id: "semantic-vision",
+    name: "Vision Analysis",
+    description: "Report cached vision analysis results from UILint browser overlay",
+    defaultSeverity: "warn",
+    defaultOptions: [
+      { maxAgeMs: 36e5, screenshotsPath: ".uilint/screenshots" }
+    ],
+    optionSchema: {
+      fields: [
+        {
+          key: "maxAgeMs",
+          label: "Max cache age (milliseconds)",
+          type: "number",
+          defaultValue: 36e5,
+          placeholder: "3600000",
+          description: "Maximum age of cached results in milliseconds (default: 1 hour)"
+        },
+        {
+          key: "screenshotsPath",
+          label: "Screenshots directory path",
+          type: "text",
+          defaultValue: ".uilint/screenshots",
+          placeholder: ".uilint/screenshots",
+          description: "Relative path to the screenshots directory containing analysis results"
+        }
+      ]
+    },
+    requiresStyleguide: false,
+    category: "semantic"
   }
 ];
 function getRuleMetadata(id) {
@@ -2021,7 +2206,8 @@ var rules = {
   "no-direct-store-import": no_direct_store_import_default,
   "prefer-zustand-state-management": prefer_zustand_state_management_default,
   "no-mixed-component-libraries": no_mixed_component_libraries_default,
-  "semantic": semantic_default
+  "semantic": semantic_default,
+  "semantic-vision": semantic_vision_default
 };
 var version = "0.1.0";
 var meta = {
@@ -2152,6 +2338,12 @@ var strictConfig = {
         "model": "qwen3-coder:30b",
         "styleguidePath": ".uilint/styleguide.md"
       }
+    ]],
+    "uilint/semantic-vision": ["warn", ...[
+      {
+        "maxAgeMs": 36e5,
+        "screenshotsPath": ".uilint/screenshots"
+      }
     ]]
   }
 };
@@ -2167,13 +2359,15 @@ var uilintEslint = {
 };
 var index_default = uilintEslint;
 export {
-  clearCache,
+  clearCache2 as clearCache,
   clearCacheEntry,
+  clearCache as clearImportGraphCache,
   configs,
   createRule,
   index_default as default,
   findStyleguidePath,
   getCacheEntry,
+  getComponentLibrary,
   getRuleMetadata,
   getRulesByCategory,
   getStyleguide,