uilint-react 0.1.35 → 0.1.38

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { AnalysisResult, ConsistencyResult, DOMSnapshot, ElementRole, ElementSna
  * Types for UILint Source Visualization
  */
 /**
- * Source location from React Fiber _debugSource
+ * Source location from data-loc attribute
  */
 interface SourceLocation {
     fileName: string;
@@ -15,22 +15,17 @@ interface SourceLocation {
     columnNumber?: number;
 }
 /**
- * Component information extracted from React Fiber
- */
-interface ComponentInfo {
-    name: string;
-    source: SourceLocation | null;
-}
-/**
- * A scanned DOM element with its React source information
+ * A scanned DOM element with its source information
+ * Source is always present from data-loc attribute
  */
 interface ScannedElement {
+    /** Unique ID from data-loc value (format: "loc:path:line:column") */
     id: string;
     element: Element;
     tagName: string;
     className: string;
-    source: SourceLocation | null;
-    componentStack: ComponentInfo[];
+    /** Source location (always present from data-loc) */
+    source: SourceLocation;
     rect: DOMRect;
 }
 /**
@@ -87,19 +82,15 @@ interface ElementIssue {
  */
 interface LocatorTarget {
     element: Element;
-    source: SourceLocation | null;
-    componentStack: ComponentInfo[];
+    source: SourceLocation;
     rect: DOMRect;
-    /** Index in the component stack (0 = current element, higher = parent) */
-    stackIndex: number;
 }
 /**
  * Element being inspected in the sidebar
  */
 interface InspectedElement {
     element: Element;
-    source: SourceLocation | null;
-    componentStack: ComponentInfo[];
+    source: SourceLocation;
     rect: DOMRect;
     /** Optional ID from auto-scan to link to cached results */
     scannedElementId?: string;
@@ -114,10 +105,6 @@ interface UILintContextValue {
     altKeyHeld: boolean;
     /** Current element under cursor when Alt is held */
     locatorTarget: LocatorTarget | null;
-    /** Navigate to parent component in locator mode */
-    locatorGoUp: () => void;
-    /** Navigate to child component in locator mode */
-    locatorGoDown: () => void;
     /** Element currently being inspected in sidebar */
     inspectedElement: InspectedElement | null;
     /** Set the element to inspect (opens sidebar) */
@@ -181,11 +168,17 @@ declare function useUILintContext(): UILintContextValue;
 declare function UILintProvider({ children, enabled, }: UILintProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
- * UILint Toolbar - Simple floating button with settings popover
+ * UILint Toolbar - Segmented pill with Scan button and settings
+ *
+ * Design:
+ * ┌─────────────────────────────────────┐
+ * │  [🔍 Scan]  │  [...]               │
+ * └─────────────────────────────────────┘
+ *        ⌥+Click to inspect
  */
 
 /**
- * Main Toolbar Component - Simple floating button with settings popover
+ * Main Toolbar Component - Segmented pill with Scan + Settings
  */
 declare function UILintToolbar(): React$1.ReactPortal | null;
 
@@ -202,6 +195,8 @@ declare function InspectionPanel(): React$1.ReactPortal | null;
 /**
  * Locator Overlay - Shows element info when Alt/Option key is held
  * Inspired by LocatorJS for a quick "hover to find source" experience
+ *
+ * Uses data-loc attributes only (no React Fiber).
  */
 
 /**
@@ -210,45 +205,18 @@ declare function InspectionPanel(): React$1.ReactPortal | null;
 declare function LocatorOverlay(): React$1.ReactPortal | null;
 
 /**
- * React Fiber inspection utilities for source file visualization
+ * DOM utilities for UILint source file visualization
  *
- * In development mode, React attaches debug information to Fiber nodes:
- * - _debugSource: { fileName, lineNumber, columnNumber }
- * - _debugOwner: The component that rendered this element
- * - return: Parent fiber in the tree
+ * Uses data-loc attributes injected by the jsx-loc-plugin build transform.
+ * This works uniformly for both server and client components in Next.js 15+.
  */
 
-/** React Fiber type (simplified) */
-interface Fiber {
-    tag: number;
-    type: string | Function | null;
-    stateNode: Element | null;
-    return: Fiber | null;
-    _debugSource?: {
-        fileName: string;
-        lineNumber: number;
-        columnNumber?: number;
-    } | null;
-    _debugOwner?: Fiber | null;
-}
-/**
- * Get React Fiber from a DOM element
- * React attaches fiber via __reactFiber$xxx key
- */
-declare function getFiberFromElement(element: Element): Fiber | null;
-/**
- * Extract source location from a fiber's _debugSource
- */
-declare function getDebugSource(fiber: Fiber): SourceLocation | null;
-/**
- * Get the debug owner fiber (component that rendered this element)
- */
-declare function getDebugOwner(fiber: Fiber): Fiber | null;
 /**
- * Build a component stack by walking up the fiber tree
- * Returns an array from innermost to outermost component
+ * Parse source location from data-loc attribute
+ * Format: "path/to/file.tsx:line:column" (injected by jsx-loc-plugin)
+ * Also supports legacy format: "path/to/file.tsx:line"
  */
-declare function getComponentStack(fiber: Fiber): ComponentInfo[];
+declare function getSourceFromDataLoc(element: Element): SourceLocation | null;
 /**
  * Check if a file path is from node_modules
  */
@@ -258,7 +226,7 @@ declare function isNodeModulesPath(path: string): boolean;
  */
 declare function getDisplayName(path: string): string;
 /**
- * Scan the DOM tree and extract React source information
+ * Scan the DOM tree and extract elements with data-loc attributes
  */
 declare function scanDOMForSources(root?: Element, hideNodeModules?: boolean): ScannedElement[];
 /**
@@ -366,4 +334,4 @@ declare function isJSDOM(): boolean;
  */
 declare function isNode(): boolean;
 
-export { type CachedSource, type ComponentInfo, ConsistencyHighlighter, DATA_UILINT_ID, DEFAULT_SETTINGS, FILE_COLORS, type InspectedElement, InspectionPanel, LocatorOverlay, type LocatorTarget, type ScannedElement, type SourceApiResponse, type SourceFile, type SourceLocation, type UILintContextValue, UILintProvider, type UILintProviderProps, type UILintSettings, UILintToolbar, buildEditorUrl, cleanupDataAttributes, cleanupDataElements, clearSourceCache, createSnapshot, fetchSource, fetchSourceWithContext, getCachedSource, getComponentStack, getDebugOwner, getDebugSource, getDisplayName, getElementById, getElementBySnapshotId, getFiberFromElement, groupBySourceFile, isBrowser, isJSDOM, isNode, isNodeModulesPath, prefetchSources, scanDOM, scanDOMForSources, updateElementRects, useUILintContext };
+export { type CachedSource, ConsistencyHighlighter, DATA_UILINT_ID, DEFAULT_SETTINGS, FILE_COLORS, type InspectedElement, InspectionPanel, LocatorOverlay, type LocatorTarget, type ScannedElement, type SourceApiResponse, type SourceFile, type SourceLocation, type UILintContextValue, UILintProvider, type UILintProviderProps, type UILintSettings, UILintToolbar, buildEditorUrl, cleanupDataAttributes, cleanupDataElements, clearSourceCache, createSnapshot, fetchSource, fetchSourceWithContext, getCachedSource, getDisplayName, getElementById, getElementBySnapshotId, getSourceFromDataLoc, groupBySourceFile, isBrowser, isJSDOM, isNode, isNodeModulesPath, prefetchSources, scanDOM, scanDOMForSources, updateElementRects, useUILintContext };

package/dist/index.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   UILintToolbar
-} from "./chunk-IGVNY64A.js";
+} from "./chunk-WEBVLQL5.js";
 import {
   InspectionPanel,
   clearSourceCache,
@@ -9,10 +9,10 @@ import {
   fetchSourceWithContext,
   getCachedSource,
   prefetchSources
-} from "./chunk-GKYWTCFU.js";
+} from "./chunk-GZOQ6QWC.js";
 import {
   LocatorOverlay
-} from "./chunk-3YZH4UAT.js";
+} from "./chunk-V4273T5B.js";
 import {
   DATA_UILINT_ID,
   DEFAULT_SETTINGS,
@@ -20,18 +20,15 @@ import {
   UILintProvider,
   buildEditorUrl,
   cleanupDataAttributes,
-  getComponentStack,
-  getDebugOwner,
-  getDebugSource,
   getDisplayName,
   getElementById,
-  getFiberFromElement,
+  getSourceFromDataLoc,
   groupBySourceFile,
   isNodeModulesPath,
   scanDOMForSources,
   updateElementRects,
   useUILintContext
-} from "./chunk-I4JDR36K.js";
+} from "./chunk-PU6XPNPN.js";
 
 // src/consistency/snapshot.ts
 var DATA_ELEMENTS_ATTR = "data-elements";
@@ -465,13 +462,10 @@ export {
   fetchSourceWithContext,
   generateStyleGuideFromStyles as generateStyleGuide,
   getCachedSource,
-  getComponentStack,
-  getDebugOwner,
-  getDebugSource,
   getDisplayName,
   getElementById,
   getElementBySnapshotId,
-  getFiberFromElement,
+  getSourceFromDataLoc,
   groupBySourceFile,
   isBrowser,
   isJSDOM,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uilint-react",
-  "version": "0.1.35",
+  "version": "0.1.38",
   "description": "React component for AI-powered UI consistency checking",
   "author": "Peter Suggate",
   "repository": {
@@ -34,7 +34,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "uilint-core": "^0.1.35",
+    "uilint-core": "^0.1.38",
     "zustand": "^5.0.5"
   },
   "peerDependencies": {