uilint-vision 0.2.136

package/dist/types-CN_T7-PU.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Vision Plugin Types
+ *
+ * All types for vision-based UI consistency analysis.
+ * Consolidated from uilint-core and uilint-react.
+ */
+/**
+ * Vision issue category
+ */
+type VisionIssueCategory = "spacing" | "alignment" | "color" | "typography" | "layout" | "contrast" | "visual-hierarchy" | "other";
+/**
+ * Vision issue severity
+ */
+type VisionIssueSeverity = "error" | "warning" | "info";
+/**
+ * Vision analysis issue from the LLM
+ */
+interface VisionIssue {
+    /** Text of the element this issue refers to */
+    elementText: string;
+    /** Issue description */
+    message: string;
+    /** Issue category */
+    category: VisionIssueCategory;
+    /** Severity level */
+    severity: VisionIssueSeverity;
+    /** Matched dataLoc from manifest (filled in after text matching) */
+    dataLoc?: string;
+    /** Matched element ID (filled in after text matching) */
+    elementId?: string;
+    /** Suggested fix (optional) */
+    suggestion?: string;
+}
+/**
+ * Element manifest entry for vision analysis.
+ * Maps visible elements to their source locations.
+ */
+interface ElementManifest {
+    /** Unique ID (data-loc if present, otherwise generated) */
+    id: string;
+    /** Visible text content (truncated to 100 chars) */
+    text: string;
+    /** data-loc value: "path:line:column" */
+    dataLoc: string;
+    /** Bounding rectangle */
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** HTML tag name */
+    tagName: string;
+    /** Inferred semantic role (button, heading, link, etc.) */
+    role?: string;
+    /** Total instances with same dataLoc (if deduplicated) */
+    instanceCount?: number;
+}
+/**
+ * Region bounds for partial screenshot capture
+ */
+interface CaptureRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Capture mode for vision analysis
+ */
+type CaptureMode = "full" | "region";
+/**
+ * Screenshot capture entry for the gallery
+ */
+interface ScreenshotCapture {
+    /** Unique ID for this capture */
+    id: string;
+    /** Route where the capture was taken */
+    route: string;
+    /** Base64 data URL of the screenshot (for in-memory captures) */
+    dataUrl?: string;
+    /** Filename for persisted screenshots (used to fetch from API) */
+    filename?: string;
+    /** Unix timestamp when captured */
+    timestamp: number;
+    /** Type of capture */
+    type: CaptureMode;
+    /** Region bounds if type is 'region' */
+    region?: CaptureRegion;
+    /** Whether this is a persisted screenshot loaded from disk */
+    persisted?: boolean;
+    /** Vision issues specific to this capture */
+    issues?: VisionIssue[];
+}
+/**
+ * Vision analysis result from the analyzer
+ */
+interface VisionAnalysisResult {
+    /** Route/path that was analyzed */
+    route: string;
+    /** Timestamp of capture */
+    timestamp: number;
+    /** Screenshot as base64 data URL */
+    screenshotDataUrl?: string;
+    /** Element manifest */
+    manifest: ElementManifest[];
+    /** Issues found by vision analysis */
+    issues: VisionIssue[];
+    /** Analysis duration in ms */
+    analysisTime: number;
+    /** Error message if analysis failed */
+    error?: string;
+    /** Full prompt sent to the model (for debugging) */
+    prompt?: string;
+    /** Raw LLM response (for debugging) */
+    rawResponse?: string;
+}
+/**
+ * Auto-scan settings for Vision analysis.
+ * Persisted to localStorage.
+ */
+interface VisionAutoScanSettings {
+    /** Auto-capture and analyze on route change */
+    onRouteChange: boolean;
+    /** Auto-capture and analyze on initial page load */
+    onInitialLoad: boolean;
+}
+/**
+ * Default vision auto-scan settings
+ */
+declare const DEFAULT_VISION_AUTO_SCAN_SETTINGS: VisionAutoScanSettings;
+/**
+ * Vision pipeline stage (for error tracking)
+ */
+type VisionStage = "capture" | "manifest" | "ws" | "vision";
+/**
+ * Vision error information with stage context
+ */
+interface VisionErrorInfo {
+    /** The stage where the error occurred */
+    stage: VisionStage;
+    /** Human-readable error message */
+    message: string;
+    /** Route that was being analyzed */
+    route: string;
+    /** Timestamp of the error */
+    timestamp: number;
+}
+/**
+ * Persisted screenshot metadata from the API
+ */
+interface PersistedScreenshotMetadata {
+    filename: string;
+    timestamp: number;
+    screenshotFile: string;
+    route: string | null;
+    issues: VisionIssue[] | null;
+    manifest: ElementManifest[] | null;
+    analysisResult: {
+        route: string;
+        timestamp: number;
+        issues: VisionIssue[];
+        analysisTime: number;
+        error?: string;
+    } | null;
+}
+/**
+ * API response for listing screenshots
+ */
+interface ScreenshotListResponse {
+    screenshots: Array<{
+        filename: string;
+        metadata: PersistedScreenshotMetadata | null;
+    }>;
+    projectRoot: string;
+    screenshotsDir: string;
+}
+/**
+ * Client -> Server: Request vision analysis
+ */
+interface VisionAnalyzeMessage {
+    type: "vision:analyze";
+    route: string;
+    timestamp: number;
+    screenshot: string;
+    manifest: ElementManifest[];
+    requestId?: string;
+}
+/**
+ * Server -> Client: Vision analysis result
+ */
+interface VisionResultMessage {
+    type: "vision:result";
+    route: string;
+    issues: VisionIssue[];
+    analysisTime: number;
+    error?: string;
+    requestId?: string;
+}
+/**
+ * Server -> Client: Vision analysis progress
+ */
+interface VisionProgressMessage {
+    type: "vision:progress";
+    route: string;
+    phase: string;
+    requestId?: string;
+}
+/**
+ * Client -> Server: Check vision availability
+ */
+interface VisionCheckMessage {
+    type: "vision:check";
+    requestId?: string;
+}
+/**
+ * Server -> Client: Vision availability status
+ */
+interface VisionStatusMessage {
+    type: "vision:status";
+    available: boolean;
+    model?: string;
+    requestId?: string;
+}
+/**
+ * Union of all vision WebSocket messages
+ */
+type VisionMessage = VisionAnalyzeMessage | VisionResultMessage | VisionProgressMessage | VisionCheckMessage | VisionStatusMessage;
+
+export { type CaptureRegion as C, DEFAULT_VISION_AUTO_SCAN_SETTINGS as D, type ElementManifest as E, type PersistedScreenshotMetadata as P, type ScreenshotCapture as S, type VisionIssue as V, type VisionIssueCategory as a, type VisionIssueSeverity as b, type CaptureMode as c, type VisionAnalysisResult as d, type VisionAutoScanSettings as e, type VisionStage as f, type VisionErrorInfo as g, type ScreenshotListResponse as h, type VisionAnalyzeMessage as i, type VisionResultMessage as j, type VisionProgressMessage as k, type VisionCheckMessage as l, type VisionStatusMessage as m, type VisionMessage as n };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "uilint-vision",
+  "version": "0.2.136",
+  "description": "Vision-based UI consistency analysis for UILint",
+  "author": "Peter Suggate",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/peter-suggate/uilint.git",
+    "directory": "packages/uilint-vision"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "import": "./dist/browser/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "import": "./dist/plugin/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "uilint-core": "0.2.136"
+  },
+  "dependencies": {
+    "html-to-image": "^1.11.13"
+  },
+  "optionalDependencies": {
+    "ollama": "^0.6.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "tsup": "^8.0.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}