uilint-vision 0.2.136

package/README.md

@@ -0,0 +1,105 @@
+# uilint-vision
+
+Vision analysis plugin for UILint. Provides AI-powered visual consistency checking using Ollama vision models.
+
+## Installation
+
+```bash
+pnpm add uilint-vision
+```
+
+## Usage
+
+### Browser (Client-Side)
+
+Import browser utilities for screenshot capture and manifest collection:
+
+```typescript
+import {
+  captureScreenshot,
+  collectElementManifest,
+  getCurrentRoute,
+  matchIssuesToManifest,
+} from "uilint-vision";
+```
+
+### Node.js (Server-Side)
+
+Import the VisionAnalyzer for server-side analysis:
+
+```typescript
+import {
+  VisionAnalyzer,
+  getVisionAnalyzer,
+  UILINT_DEFAULT_VISION_MODEL,
+} from "uilint-vision/node";
+
+// Create analyzer instance
+const analyzer = new VisionAnalyzer({
+  baseUrl: "http://localhost:11434",
+  visionModel: UILINT_DEFAULT_VISION_MODEL,
+});
+
+// Analyze a screenshot
+const result = await analyzer.analyzeScreenshot(
+  imageBase64,
+  elementManifest,
+  { styleGuide: "..." }
+);
+```
+
+### Plugin System
+
+The vision plugin auto-registers with the UILint plugin registry:
+
+```typescript
+import "uilint-vision"; // Auto-registers plugin
+
+import { pluginRegistry } from "uilint-core";
+const visionPlugin = pluginRegistry.get("vision");
+```
+
+## Features
+
+- **Screenshot Capture**: Full page and region-based capture
+- **Element Manifest**: Collects data-loc elements for analysis mapping
+- **Vision Analysis**: AI-powered visual consistency detection
+- **Issue Matching**: Maps detected issues back to source code locations
+
+## Types
+
+Key types exported:
+
+- `VisionIssue` - Detected visual issue
+- `ElementManifest` - DOM element with data-loc
+- `ScreenshotCapture` - Captured screenshot metadata
+- `VisionAnalysisResult` - Analysis result with issues
+
+## Browser Utilities
+
+| Function | Description |
+|----------|-------------|
+| `captureScreenshot()` | Capture full page screenshot |
+| `captureRegion(region)` | Capture specific region |
+| `collectElementManifest()` | Collect data-loc elements |
+| `getCurrentRoute()` | Get current browser route |
+| `matchIssuesToManifest()` | Match issues to elements |
+| `buildVisionAnalysisPayload()` | Build WebSocket message |
+
+## Plugin Definition
+
+The vision plugin provides:
+
+- **Commands**: Capture full page, capture region, clear screenshots
+- **Panels**: Vision issue inspector, screenshot gallery
+- **Rules**: `semantic-vision` rule for ESLint integration
+- **Toolbar**: Vision capture actions
+
+## Requirements
+
+- **Ollama**: Required for vision analysis (server-side)
+- **Recommended Model**: `qwen3-vl:8b-instruct`
+
+## License
+
+MIT

package/dist/browser/index.d.ts

@@ -0,0 +1,79 @@
+import { C as CaptureRegion, E as ElementManifest, V as VisionIssue } from '../types-CN_T7-PU.js';
+
+/**
+ * Element Manifest Collection
+ *
+ * Collects visible elements with data-loc attributes for vision analysis.
+ * Uses DOM APIs - no React.
+ */
+
+/**
+ * Collect element manifest from the DOM
+ *
+ * @param region - Optional region to filter elements
+ * @returns Array of element manifest entries
+ */
+declare function collectElementManifest(region?: CaptureRegion | null): ElementManifest[];
+
+/**
+ * Screenshot Capture
+ *
+ * Captures screenshots using html-to-image.
+ * Browser-only - no React.
+ */
+
+/**
+ * Capture full page screenshot
+ *
+ * @returns Base64 data URL of the screenshot
+ */
+declare function captureScreenshot(): Promise<string>;
+/**
+ * Capture a specific region of the page
+ *
+ * @param region - Region bounds to capture
+ * @returns Base64 data URL of the screenshot
+ */
+declare function captureRegion(region: CaptureRegion): Promise<string>;
+
+/**
+ * Vision Browser Utilities
+ *
+ * Utility functions for vision analysis in the browser.
+ */
+
+/**
+ * Get the current route/URL path
+ */
+declare function getCurrentRoute(): string;
+/**
+ * Generate a timestamp string
+ */
+declare function generateTimestamp(): string;
+/**
+ * Match vision issues to manifest elements by their dataLoc
+ *
+ * @param issues - Vision issues from analysis
+ * @param manifest - Element manifest
+ * @returns Issues with element references attached
+ */
+declare function matchIssuesToManifest(issues: VisionIssue[], manifest: ElementManifest[]): VisionIssue[];
+/**
+ * Build vision analysis payload for WebSocket
+ */
+declare function buildVisionAnalysisPayload(options: {
+    route: string;
+    timestamp: number;
+    screenshot: string;
+    manifest: ElementManifest[];
+    requestId?: string;
+}): {
+    type: "vision:analyze";
+    route: string;
+    timestamp: number;
+    screenshot: string;
+    manifest: ElementManifest[];
+    requestId?: string;
+};
+
+export { buildVisionAnalysisPayload, captureRegion, captureScreenshot, captureRegion as captureScreenshotRegion, collectElementManifest, generateTimestamp, getCurrentRoute, matchIssuesToManifest };

package/dist/browser/index.js

@@ -0,0 +1,20 @@
+import {
+  buildVisionAnalysisPayload,
+  captureRegion,
+  captureScreenshot,
+  collectElementManifest,
+  generateTimestamp,
+  getCurrentRoute,
+  matchIssuesToManifest
+} from "../chunk-IHYJU45M.js";
+export {
+  buildVisionAnalysisPayload,
+  captureRegion,
+  captureScreenshot,
+  captureRegion as captureScreenshotRegion,
+  collectElementManifest,
+  generateTimestamp,
+  getCurrentRoute,
+  matchIssuesToManifest
+};
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

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