uilint-vision 0.2.138 → 0.2.139

package/dist/chunk-XELUGF6W.js

@@ -0,0 +1,233 @@
+// src/eslint-rules/semantic-vision.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { dirname, join, relative } from "path";
+import { createRule, defineRuleMeta } from "uilint-eslint";
+var meta = defineRuleMeta({
+  id: "semantic-vision",
+  version: "1.0.0",
+  name: "Vision Analysis",
+  description: "Report cached vision analysis results from UILint browser overlay",
+  defaultSeverity: "warn",
+  category: "semantic",
+  icon: "\u{1F441}\uFE0F",
+  hint: "Vision AI for rendered UI",
+  defaultEnabled: false,
+  requiresStyleguide: false,
+  plugin: "vision",
+  eslintImport: "uilint-vision/eslint-rules/semantic-vision",
+  customInspector: "vision-issue",
+  heatmapColor: "#8B5CF6",
+  postInstallInstructions: "Add the UILint browser overlay to your app and run analysis from the browser to generate cached results.",
+  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"
+      }
+    ]
+  },
+  docs: `
+## What it does
+
+Reports UI issues found by the UILint browser overlay's vision analysis. The overlay
+captures screenshots and analyzes them using vision AI, then caches the results.
+This ESLint rule reads those cached results and reports them as linting errors.
+
+## How it works
+
+1. **Browser overlay**: When running your dev server with the UILint overlay, it captures
+   screenshots and analyzes them using vision AI
+2. **Results cached**: Analysis results are saved to \`.uilint/screenshots/*.json\`
+3. **ESLint reports**: This rule reads cached results and reports issues at the correct
+   source locations using \`data-loc\` attributes
+
+## Why it's useful
+
+- **Visual issues**: Catches problems that can only be seen in rendered UI
+- **Continuous feedback**: Issues appear in your editor as you develop
+- **No manual review**: AI spots spacing, alignment, and consistency issues automatically
+
+## Prerequisites
+
+1. **UILint overlay installed**: Add the overlay component to your app
+2. **Run analysis**: Load pages in the browser with the overlay active
+3. **Results cached**: Wait for analysis to complete and cache results
+
+## Configuration
+
+\`\`\`js
+// eslint.config.js
+"uilint/semantic-vision": ["warn", {
+  maxAgeMs: 3600000,                    // Ignore results older than 1 hour
+  screenshotsPath: ".uilint/screenshots" // Where cached results are stored
+}]
+\`\`\`
+
+## Notes
+
+- If no cached results exist, the rule passes silently
+- Results are matched to source files using \`data-loc\` attributes
+- Stale results (older than \`maxAgeMs\`) are reported as warnings
+- Run the browser overlay to refresh cached analysis
+`
+});
+function findProjectRoot(startDir) {
+  let dir = startDir;
+  for (let i = 0; i < 20; i++) {
+    if (existsSync(join(dir, "package.json"))) {
+      return dir;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return startDir;
+}
+function getVisionResultFiles(screenshotsDir) {
+  if (!existsSync(screenshotsDir)) {
+    return [];
+  }
+  try {
+    const files = readdirSync(screenshotsDir);
+    return files.filter((f) => f.endsWith(".json")).map((f) => join(screenshotsDir, f)).sort().reverse();
+  } catch {
+    return [];
+  }
+}
+function loadVisionResult(filePath) {
+  try {
+    const content = readFileSync(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 relative(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 = dirname(filePath);
+    const projectRoot = findProjectRoot(fileDir);
+    const screenshotsDir = options.screenshotsPath ? join(projectRoot, options.screenshotsPath) : join(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 }
+          });
+        }
+      }
+    };
+  }
+});
+
+export {
+  meta,
+  semantic_vision_default
+};
+//# sourceMappingURL=chunk-XELUGF6W.js.map

package/dist/chunk-XELUGF6W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/eslint-rules/semantic-vision.ts"],"sourcesContent":["/**\n * Rule: semantic-vision\n *\n * ESLint rule that reports cached vision analysis results for UI elements.\n * Vision analysis is performed by the UILint browser overlay and results are\n * cached in .uilint/screenshots/{timestamp}-{route}.json files.\n *\n * This rule:\n * 1. Finds cached vision analysis results for the current file\n * 2. Reports any issues that match elements in this file (by data-loc)\n * 3. If no cached results exist, silently passes (analysis is triggered by browser)\n */\n\nimport { existsSync, readdirSync, readFileSync } from \"fs\";\nimport { dirname, join, relative } from \"path\";\nimport { createRule, defineRuleMeta } from \"uilint-eslint\";\n\ntype MessageIds = \"visionIssue\" | \"analysisStale\";\n\ntype Options = [\n  {\n    /** Maximum age of cached results in milliseconds (default: 1 hour) */\n    maxAgeMs?: number;\n    /** Path to screenshots directory (default: .uilint/screenshots) */\n    screenshotsPath?: string;\n  }\n];\n\n/**\n * Rule metadata - colocated with implementation for maintainability\n */\nexport const meta = defineRuleMeta({\n  id: \"semantic-vision\",\n  version: \"1.0.0\",\n  name: \"Vision Analysis\",\n  description: \"Report cached vision analysis results from UILint browser overlay\",\n  defaultSeverity: \"warn\",\n  category: \"semantic\",\n  icon: \"👁️\",\n  hint: \"Vision AI for rendered UI\",\n  defaultEnabled: false,\n  requiresStyleguide: false,\n  plugin: \"vision\",\n  eslintImport: \"uilint-vision/eslint-rules/semantic-vision\",\n  customInspector: \"vision-issue\",\n  heatmapColor: \"#8B5CF6\",\n  postInstallInstructions: \"Add the UILint browser overlay to your app and run analysis from the browser to generate cached results.\",\n  defaultOptions: [{ maxAgeMs: 3600000, screenshotsPath: \".uilint/screenshots\" }],\n  optionSchema: {\n    fields: [\n      {\n        key: \"maxAgeMs\",\n        label: \"Max cache age (milliseconds)\",\n        type: \"number\",\n        defaultValue: 3600000,\n        placeholder: \"3600000\",\n        description: \"Maximum age of cached results in milliseconds (default: 1 hour)\",\n      },\n      {\n        key: \"screenshotsPath\",\n        label: \"Screenshots directory path\",\n        type: \"text\",\n        defaultValue: \".uilint/screenshots\",\n        placeholder: \".uilint/screenshots\",\n        description: \"Relative path to the screenshots directory containing analysis results\",\n      },\n    ],\n  },\n  docs: `\n## What it does\n\nReports UI issues found by the UILint browser overlay's vision analysis. The overlay\ncaptures screenshots and analyzes them using vision AI, then caches the results.\nThis ESLint rule reads those cached results and reports them as linting errors.\n\n## How it works\n\n1. **Browser overlay**: When running your dev server with the UILint overlay, it captures\n   screenshots and analyzes them using vision AI\n2. **Results cached**: Analysis results are saved to \\`.uilint/screenshots/*.json\\`\n3. **ESLint reports**: This rule reads cached results and reports issues at the correct\n   source locations using \\`data-loc\\` attributes\n\n## Why it's useful\n\n- **Visual issues**: Catches problems that can only be seen in rendered UI\n- **Continuous feedback**: Issues appear in your editor as you develop\n- **No manual review**: AI spots spacing, alignment, and consistency issues automatically\n\n## Prerequisites\n\n1. **UILint overlay installed**: Add the overlay component to your app\n2. **Run analysis**: Load pages in the browser with the overlay active\n3. **Results cached**: Wait for analysis to complete and cache results\n\n## Configuration\n\n\\`\\`\\`js\n// eslint.config.js\n\"uilint/semantic-vision\": [\"warn\", {\n  maxAgeMs: 3600000,                    // Ignore results older than 1 hour\n  screenshotsPath: \".uilint/screenshots\" // Where cached results are stored\n}]\n\\`\\`\\`\n\n## Notes\n\n- If no cached results exist, the rule passes silently\n- Results are matched to source files using \\`data-loc\\` attributes\n- Stale results (older than \\`maxAgeMs\\`) are reported as warnings\n- Run the browser overlay to refresh cached analysis\n`,\n});\n\n/**\n * Vision analysis result structure stored in JSON files\n */\ninterface VisionAnalysisResult {\n  /** Timestamp when analysis was performed */\n  timestamp: number;\n  /** Route that was analyzed (e.g., \"/\", \"/profile\") */\n  route: string;\n  /** Screenshot filename (for reference) */\n  screenshotFile?: string;\n  /** Issues found by vision analysis */\n  issues: VisionIssue[];\n}\n\n/**\n * Individual issue from vision analysis\n */\ninterface VisionIssue {\n  /** Element text that the LLM referenced */\n  elementText?: string;\n  /** data-loc reference (format: \"path:line:column\") */\n  dataLoc?: string;\n  /** Human-readable description of the issue */\n  message: string;\n  /** Issue category */\n  category?: \"spacing\" | \"color\" | \"typography\" | \"alignment\" | \"accessibility\" | \"layout\" | \"other\";\n  /** Severity level */\n  severity?: \"error\" | \"warning\" | \"info\";\n}\n\n/**\n * Find project root by looking for package.json\n */\nfunction findProjectRoot(startDir: string): string {\n  let dir = startDir;\n  for (let i = 0; i < 20; i++) {\n    if (existsSync(join(dir, \"package.json\"))) {\n      return dir;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return startDir;\n}\n\n/**\n * Get all vision analysis result files from screenshots directory\n */\nfunction getVisionResultFiles(screenshotsDir: string): string[] {\n  if (!existsSync(screenshotsDir)) {\n    return [];\n  }\n\n  try {\n    const files = readdirSync(screenshotsDir);\n    return files\n      .filter((f) => f.endsWith(\".json\"))\n      .map((f) => join(screenshotsDir, f))\n      .sort()\n      .reverse(); // Most recent first\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Load and parse a vision analysis result file\n */\nfunction loadVisionResult(filePath: string): VisionAnalysisResult | null {\n  try {\n    const content = readFileSync(filePath, \"utf-8\");\n    return JSON.parse(content) as VisionAnalysisResult;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Parse a data-loc string into file path and location\n * Format: \"path/to/file.tsx:line:column\"\n */\nfunction parseDataLoc(dataLoc: string): { filePath: string; line: number; column: number } | null {\n  // Match pattern: path:line:column (line and column are numbers)\n  const match = dataLoc.match(/^(.+):(\\d+):(\\d+)$/);\n  if (!match) return null;\n\n  return {\n    filePath: match[1]!,\n    line: parseInt(match[2]!, 10),\n    column: parseInt(match[3]!, 10),\n  };\n}\n\n/**\n * Normalize file path for comparison (handle relative vs absolute paths)\n */\nfunction normalizeFilePath(filePath: string, projectRoot: string): string {\n  // If it's already a relative path, return as-is\n  if (!filePath.startsWith(\"/\")) {\n    return filePath;\n  }\n  // Convert absolute to relative\n  return relative(projectRoot, filePath);\n}\n\nexport default createRule<Options, MessageIds>({\n  name: \"semantic-vision\",\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description:\n        \"Report cached vision analysis results from UILint browser overlay\",\n    },\n    messages: {\n      visionIssue: \"[Vision] {{message}}\",\n      analysisStale:\n        \"Vision analysis results are stale (older than {{age}}). Re-run analysis in browser.\",\n    },\n    schema: [\n      {\n        type: \"object\",\n        properties: {\n          maxAgeMs: {\n            type: \"number\",\n            description:\n              \"Maximum age of cached results in milliseconds (default: 1 hour)\",\n          },\n          screenshotsPath: {\n            type: \"string\",\n            description:\n              \"Path to screenshots directory (default: .uilint/screenshots)\",\n          },\n        },\n        additionalProperties: false,\n      },\n    ],\n  },\n  defaultOptions: [{ maxAgeMs: 60 * 60 * 1000 }], // 1 hour default\n  create(context) {\n    const options = context.options[0] || {};\n    const maxAgeMs = options.maxAgeMs ?? 60 * 60 * 1000;\n    const filePath = context.filename;\n    const fileDir = dirname(filePath);\n\n    // Find project root and screenshots directory\n    const projectRoot = findProjectRoot(fileDir);\n    const screenshotsDir = options.screenshotsPath\n      ? join(projectRoot, options.screenshotsPath)\n      : join(projectRoot, \".uilint\", \"screenshots\");\n\n    // Get the relative path of the current file for matching against data-loc\n    const relativeFilePath = normalizeFilePath(filePath, projectRoot);\n\n    // Find all vision result files\n    const resultFiles = getVisionResultFiles(screenshotsDir);\n    if (resultFiles.length === 0) {\n      // No cached results - silently pass (analysis happens in browser)\n      return {};\n    }\n\n    // Collect issues that match this file from all recent results\n    const matchingIssues: Array<{\n      issue: VisionIssue;\n      line: number;\n      column: number;\n      isStale: boolean;\n    }> = [];\n\n    const now = Date.now();\n\n    for (const resultFile of resultFiles) {\n      const result = loadVisionResult(resultFile);\n      if (!result || !result.issues) continue;\n\n      const isStale = now - result.timestamp > maxAgeMs;\n\n      for (const issue of result.issues) {\n        if (!issue.dataLoc) continue;\n\n        const parsed = parseDataLoc(issue.dataLoc);\n        if (!parsed) continue;\n\n        // Check if this issue is for the current file\n        const issueFilePath = normalizeFilePath(parsed.filePath, projectRoot);\n        if (issueFilePath === relativeFilePath) {\n          matchingIssues.push({\n            issue,\n            line: parsed.line,\n            column: parsed.column,\n            isStale,\n          });\n        }\n      }\n    }\n\n    // De-duplicate issues by line:column:message\n    const seenIssues = new Set<string>();\n    const uniqueIssues = matchingIssues.filter((item) => {\n      const key = `${item.line}:${item.column}:${item.issue.message}`;\n      if (seenIssues.has(key)) return false;\n      seenIssues.add(key);\n      return true;\n    });\n\n    return {\n      Program(node) {\n        for (const { issue, line, column, isStale } of uniqueIssues) {\n          // Build message with category prefix if available\n          const categoryPrefix = issue.category\n            ? `[${issue.category}] `\n            : \"\";\n          const message = `${categoryPrefix}${issue.message}`;\n\n          // Report stale warning separately if enabled\n          if (isStale) {\n            const ageHours = Math.round(maxAgeMs / (60 * 60 * 1000));\n            context.report({\n              node,\n              loc: { line, column },\n              messageId: \"analysisStale\",\n              data: { age: `${ageHours}h` },\n            });\n          }\n\n          context.report({\n            node,\n            loc: { line, column },\n            messageId: \"visionIssue\",\n            data: { message },\n          });\n        }\n      },\n    };\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-XPBTVJRY.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-XPBTVJRY.js.map

package/dist/chunk-XPBTVJRY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/eslint-rules/index.d.ts

@@ -0,0 +1,3 @@
+export { meta as semanticVisionMeta, default as semanticVisionRule } from './semantic-vision.js';
+import '@typescript-eslint/utils/ts-eslint';
+import 'uilint-eslint';

package/dist/eslint-rules/index.js

@@ -0,0 +1,10 @@
+import "../chunk-XPBTVJRY.js";
+import {
+  meta,
+  semantic_vision_default
+} from "../chunk-XELUGF6W.js";
+export {
+  meta as semanticVisionMeta,
+  semantic_vision_default as semanticVisionRule
+};
+//# sourceMappingURL=index.js.map

package/dist/eslint-rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/eslint-rules/register.d.ts

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

package/dist/eslint-rules/register.js

@@ -0,0 +1,18 @@
+import "../chunk-XPBTVJRY.js";
+import {
+  meta,
+  semantic_vision_default
+} from "../chunk-XELUGF6W.js";
+
+// src/eslint-rules/register.ts
+import { registerRuleMeta, registerESLintRule, registerCategory } from "uilint-eslint";
+registerCategory({
+  id: "vision",
+  name: "Vision Rules",
+  description: "AI-powered visual analysis",
+  icon: "\u{1F441}\uFE0F",
+  defaultEnabled: false
+});
+registerRuleMeta(meta);
+registerESLintRule("semantic-vision", semantic_vision_default);
+//# sourceMappingURL=register.js.map

package/dist/eslint-rules/register.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/eslint-rules/register.ts"],"sourcesContent":["/**\n * Auto-registration of uilint-vision ESLint rules.\n *\n * Importing this module registers the vision ESLint rules with the\n * uilint-eslint rule registry. This is called by the CLI when vision\n * is installed.\n */\n\nimport { registerRuleMeta, registerESLintRule, registerCategory } from \"uilint-eslint\";\nimport { semanticVisionMeta } from \"./index.js\";\nimport semanticVisionRule from \"./semantic-vision.js\";\n\n// Register the vision category\nregisterCategory({\n  id: \"vision\",\n  name: \"Vision Rules\",\n  description: \"AI-powered visual analysis\",\n  icon: \"👁️\",\n  defaultEnabled: false,\n});\n\n// Register rule metadata and implementation\nregisterRuleMeta(semanticVisionMeta);\nregisterESLintRule(\"semantic-vision\", semanticVisionRule);\n"],"mappings":";;;;;;;AAQA,SAAS,kBAAkB,oBAAoB,wBAAwB;AAKvE,iBAAiB;AAAA,EACf,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,aAAa;AAAA,EACb,MAAM;AAAA,EACN,gBAAgB;AAClB,CAAC;AAGD,iBAAiB,IAAkB;AACnC,mBAAmB,mBAAmB,uBAAkB;","names":[]}

package/dist/eslint-rules/semantic-vision.d.ts

@@ -0,0 +1,33 @@
+import * as _typescript_eslint_utils_ts_eslint from '@typescript-eslint/utils/ts-eslint';
+import * as uilint_eslint from 'uilint-eslint';
+
+/**
+ * Rule: semantic-vision
+ *
+ * ESLint rule that reports cached vision analysis results for UI elements.
+ * Vision analysis is performed by the UILint browser overlay and results are
+ * cached in .uilint/screenshots/{timestamp}-{route}.json files.
+ *
+ * This rule:
+ * 1. Finds cached vision analysis results for the current file
+ * 2. Reports any issues that match elements in this file (by data-loc)
+ * 3. If no cached results exist, silently passes (analysis is triggered by browser)
+ */
+type MessageIds = "visionIssue" | "analysisStale";
+type Options = [
+    {
+        /** Maximum age of cached results in milliseconds (default: 1 hour) */
+        maxAgeMs?: number;
+        /** Path to screenshots directory (default: .uilint/screenshots) */
+        screenshotsPath?: string;
+    }
+];
+/**
+ * Rule metadata - colocated with implementation for maintainability
+ */
+declare const meta: uilint_eslint.RuleMeta;
+declare const _default: _typescript_eslint_utils_ts_eslint.RuleModule<MessageIds, Options, unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+    name: string;
+};
+
+export { _default as default, meta };

package/dist/eslint-rules/semantic-vision.js

@@ -0,0 +1,9 @@
+import {
+  meta,
+  semantic_vision_default
+} from "../chunk-XELUGF6W.js";
+export {
+  semantic_vision_default as default,
+  meta
+};
+//# sourceMappingURL=semantic-vision.js.map

package/dist/eslint-rules/semantic-vision.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uilint-vision",
-  "version": "0.2.138",
+  "version": "0.2.139",
   "description": "Vision-based UI consistency analysis for UILint",
   "author": "Peter Suggate",
   "repository": {
@@ -28,13 +28,26 @@
     "./plugin": {
       "types": "./dist/plugin/index.d.ts",
       "import": "./dist/plugin/index.js"
+    },
+    "./eslint-rules": {
+      "types": "./dist/eslint-rules/index.d.ts",
+      "import": "./dist/eslint-rules/index.js"
+    },
+    "./eslint-rules/register": {
+      "types": "./dist/eslint-rules/register.d.ts",
+      "import": "./dist/eslint-rules/register.js"
+    },
+    "./eslint-rules/semantic-vision": {
+      "types": "./dist/eslint-rules/semantic-vision.d.ts",
+      "import": "./dist/eslint-rules/semantic-vision.js"
     }
   },
   "files": [
     "dist"
   ],
   "peerDependencies": {
-    "uilint-core": "0.2.138"
+    "uilint-core": "0.2.139",
+    "uilint-eslint": "0.2.139"
   },
   "dependencies": {
     "html-to-image": "^1.11.13"