@supernal/interface 1.0.8 → 1.0.11

package/dist/esm/src/testing/graph-tester/screenshot/types.d.ts

@@ -0,0 +1,331 @@
+/**
+ * Types for screenshot annotation system.
+ *
+ * This defines the structure of annotated screenshots with element metadata,
+ * bounding boxes, and AI-ready output format.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Complete annotated screenshot with metadata and element annotations.
+ */
+export interface AnnotatedScreenshot {
+    /** Route that was captured */
+    route: string;
+    /** Screenshot buffer (PNG) */
+    screenshot: Buffer;
+    /** Path where screenshot was saved */
+    screenshotPath: string;
+    /** Array of element annotations */
+    annotations: ElementAnnotation[];
+    /** Page metadata */
+    pageMetadata: PageMetadata;
+    /** Timestamp */
+    timestamp: Date;
+    /** AI analysis results (if analyzed) */
+    aiAnalysis?: AIAnalysisResults;
+}
+/**
+ * Annotation for a single element.
+ */
+export interface ElementAnnotation {
+    /** Unique identifier for this element */
+    id: string;
+    /** Element selector (CSS selector or XPath) */
+    selector: string;
+    /** data-testid attribute value (if present) */
+    testId?: string;
+    /** Element tag name (div, button, input, etc.) */
+    tagName: string;
+    /** Bounding box in viewport coordinates */
+    boundingBox: BoundingBox;
+    /** Bounding box in page coordinates (for full-page screenshots) */
+    pageBoundingBox?: BoundingBox;
+    /** Computed styles relevant for AI analysis */
+    computedStyles: ComputedStyles;
+    /** Element text content */
+    textContent?: string;
+    /** Element attributes */
+    attributes: Record<string, string>;
+    /** Whether element is interactive (clickable, focusable) */
+    isInteractive: boolean;
+    /** Interaction capabilities */
+    interactions: InteractionCapability[];
+    /** Navigation target (if element triggers navigation) */
+    navigationTarget?: NavigationTarget;
+    /** Parent element ID (for hierarchy) */
+    parentId?: string;
+    /** Child element IDs (for hierarchy) */
+    childIds: string[];
+    /** ARIA attributes for accessibility analysis */
+    ariaAttributes: Record<string, string>;
+    /** Whether element is visible */
+    isVisible: boolean;
+    /** Z-index for layering analysis */
+    zIndex: number;
+}
+/**
+ * Bounding box coordinates.
+ */
+export interface BoundingBox {
+    /** X coordinate (left edge) */
+    x: number;
+    /** Y coordinate (top edge) */
+    y: number;
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+}
+/**
+ * Computed styles relevant for AI analysis.
+ */
+export interface ComputedStyles {
+    /** Background color (RGB) */
+    backgroundColor: string;
+    /** Text color (RGB) */
+    color: string;
+    /** Font family */
+    fontFamily: string;
+    /** Font size (px) */
+    fontSize: string;
+    /** Font weight */
+    fontWeight: string;
+    /** Display type */
+    display: string;
+    /** Position type */
+    position: string;
+    /** Opacity */
+    opacity: string;
+    /** Visibility */
+    visibility: string;
+    /** Border */
+    border?: string;
+    /** Border radius */
+    borderRadius?: string;
+    /** Padding */
+    padding?: string;
+    /** Margin */
+    margin?: string;
+}
+/**
+ * Interaction capability for an element.
+ */
+export interface InteractionCapability {
+    /** Type of interaction */
+    type: 'click' | 'hover' | 'focus' | 'input' | 'select' | 'drag' | 'scroll';
+    /** Event handler attached (if detectable) */
+    hasHandler: boolean;
+    /** Description of what happens on interaction */
+    description?: string;
+}
+/**
+ * Navigation target if element triggers navigation.
+ */
+export interface NavigationTarget {
+    /** Target URL or route */
+    target: string;
+    /** Navigation method */
+    method: 'link' | 'button' | 'form' | 'javascript';
+    /** href attribute (for links) */
+    href?: string;
+    /** Whether navigation opens in new tab */
+    opensInNewTab: boolean;
+}
+/**
+ * Page metadata.
+ */
+export interface PageMetadata {
+    /** Page title */
+    title: string;
+    /** Page URL */
+    url: string;
+    /** Viewport size */
+    viewport: {
+        width: number;
+        height: number;
+    };
+    /** Full page size (for scroll) */
+    pageSize: {
+        width: number;
+        height: number;
+    };
+    /** Page meta tags */
+    metaTags: Record<string, string>;
+    /** Page load metrics */
+    loadMetrics?: {
+        /** DOM content loaded (ms) */
+        domContentLoaded: number;
+        /** Load complete (ms) */
+        loadComplete: number;
+    };
+}
+/**
+ * AI analysis results for annotated screenshot.
+ */
+export interface AIAnalysisResults {
+    /** Layout analysis */
+    layout: LayoutAnalysis;
+    /** Accessibility analysis */
+    accessibility: AccessibilityAnalysis;
+    /** Design analysis */
+    design: DesignAnalysis;
+    /** Navigation analysis */
+    navigation: NavigationAnalysis;
+    /** Overall suggestions */
+    suggestions: Suggestion[];
+    /** AI model used */
+    model: string;
+    /** Timestamp */
+    timestamp: Date;
+}
+/**
+ * Layout analysis.
+ */
+export interface LayoutAnalysis {
+    /** Grid detection */
+    hasGrid: boolean;
+    /** Grid type (if detected) */
+    gridType?: 'css-grid' | 'flexbox' | 'table' | 'float';
+    /** Symmetry score (0-100) */
+    symmetryScore: number;
+    /** Whitespace usage score (0-100) */
+    whitespaceScore: number;
+    /** Visual hierarchy clarity (0-100) */
+    hierarchyScore: number;
+    /** Issues detected */
+    issues: string[];
+}
+/**
+ * Accessibility analysis.
+ */
+export interface AccessibilityAnalysis {
+    /** WCAG compliance level */
+    wcagLevel?: 'A' | 'AA' | 'AAA';
+    /** Contrast ratio violations */
+    contrastViolations: ContrastViolation[];
+    /** Missing ARIA labels */
+    missingAriaLabels: string[];
+    /** Interactive elements without labels */
+    unlabeledInteractiveElements: string[];
+    /** Keyboard navigation issues */
+    keyboardNavigationIssues: string[];
+    /** Screen reader issues */
+    screenReaderIssues: string[];
+    /** Overall accessibility score (0-100) */
+    accessibilityScore: number;
+}
+/**
+ * Contrast violation.
+ */
+export interface ContrastViolation {
+    /** Element selector */
+    selector: string;
+    /** Foreground color */
+    foregroundColor: string;
+    /** Background color */
+    backgroundColor: string;
+    /** Contrast ratio */
+    contrastRatio: number;
+    /** Required ratio for WCAG level */
+    requiredRatio: number;
+    /** WCAG level */
+    wcagLevel: 'AA' | 'AAA';
+}
+/**
+ * Design analysis.
+ */
+export interface DesignAnalysis {
+    /** Color palette detected */
+    colorPalette: string[];
+    /** Color harmony score (0-100) */
+    colorHarmonyScore: number;
+    /** Typography consistency score (0-100) */
+    typographyScore: number;
+    /** Visual consistency score (0-100) */
+    consistencyScore: number;
+    /** Spacing consistency score (0-100) */
+    spacingScore: number;
+    /** Design issues */
+    issues: string[];
+}
+/**
+ * Navigation analysis.
+ */
+export interface NavigationAnalysis {
+    /** User flow clarity score (0-100) */
+    flowClarityScore: number;
+    /** CTA detection */
+    callToActionElements: string[];
+    /** Navigation patterns detected */
+    navigationPatterns: string[];
+    /** Breadcrumb navigation detected */
+    hasBreadcrumbs: boolean;
+    /** Back button detected */
+    hasBackButton: boolean;
+    /** Navigation issues */
+    issues: string[];
+}
+/**
+ * Actionable suggestion.
+ */
+export interface Suggestion {
+    /** Suggestion priority */
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    /** Category */
+    category: 'layout' | 'accessibility' | 'design' | 'navigation' | 'performance';
+    /** Suggestion title */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** Element selector (if applicable) */
+    selector?: string;
+    /** Remediation steps */
+    remediation?: string[];
+}
+/**
+ * Configuration for HTML annotation renderer.
+ */
+export interface HTMLRendererConfig {
+    /** Whether to include sidebar with annotation details */
+    includeSidebar?: boolean;
+    /** Whether to make bounding boxes hoverable */
+    enableHover?: boolean;
+    /** Whether to allow click-to-highlight */
+    enableClickToHighlight?: boolean;
+    /** Bounding box color */
+    boundingBoxColor?: string;
+    /** Bounding box width (px) */
+    boundingBoxWidth?: number;
+    /** Output file path */
+    outputPath: string;
+}
+/**
+ * Configuration for canvas annotation renderer.
+ */
+export interface CanvasRendererConfig {
+    /** Whether to draw element labels */
+    drawLabels?: boolean;
+    /** Label font size (px) */
+    labelFontSize?: number;
+    /** Bounding box color */
+    boundingBoxColor?: string;
+    /** Bounding box width (px) */
+    boundingBoxWidth?: number;
+    /** Output file path */
+    outputPath: string;
+}
+/**
+ * Annotation rendering result.
+ */
+export interface AnnotationRenderResult {
+    /** Output file path */
+    outputPath: string;
+    /** Renderer type */
+    rendererType: 'html' | 'canvas';
+    /** File size (bytes) */
+    fileSize: number;
+    /** Rendering duration (ms) */
+    duration: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/src/testing/graph-tester/screenshot/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/screenshot/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/testing/graph-tester/screenshot/types.js

@@ -0,0 +1,10 @@
+/**
+ * Types for screenshot annotation system.
+ *
+ * This defines the structure of annotated screenshots with element metadata,
+ * bounding boxes, and AI-ready output format.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/src/testing/graph-tester/screenshot/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/screenshot/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/esm/src/testing/selectors.d.ts

@@ -9,7 +9,7 @@
  *
  * @example
  * ```typescript
- * import { Chat } from '../architecture/DemoComponentNames';
+ * import { Chat } from '../architecture/ComponentNames';
  * import { testId } from '@supernal-interface/core/testing';
  *
  * const input = page.locator(testId(Chat.input));

package/dist/esm/src/testing/selectors.js

@@ -9,7 +9,7 @@
  *
  * @example
  * ```typescript
- * import { Chat } from '../architecture/DemoComponentNames.js';
+ * import { Chat } from '../architecture/ComponentNames.js';
  * import { testId } from '@supernal-interface/core/testing';
  *
  * const input = page.locator(testId(Chat.input));

package/dist/esm/src/types/ComponentState.d.ts

@@ -54,10 +54,6 @@ export interface BaseComponentState {
      * Human-readable description
      */
     description?: string;
-    /**
-     * Container this component belongs to
-     */
-    containerId?: string;
     /**
      * Current state version for migration
      */

package/dist/esm/src/types/ComponentState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentState.d.ts","sourceRoot":"","sources":["../../../../src/types/ComponentState.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ComponentState.d.ts","sourceRoot":"","sources":["../../../../src/types/ComponentState.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/types/ComponentState.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentState.js","sourceRoot":"","sources":["../../../../src/types/ComponentState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwTH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IACtD,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAqB;IACvD,OAAO,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IACtD,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;AACtC,CAAC"}
+{"version":3,"file":"ComponentState.js","sourceRoot":"","sources":["../../../../src/types/ComponentState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmTH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IACtD,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAqB;IACvD,OAAO,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IACtD,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@supernal/interface",
-  "version": "1.0.8",
+  "version": "1.0.11",
   "description": "Universal AI Interface - Make any application AI-controllable with decorators (Open Source Edition)",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",
   "types": "./dist/esm/src/index.d.ts",
   "exports": {
     ".": {
+      "browser": "./dist/esm/src/browser.js",
       "types": "./dist/esm/src/index.d.ts",
       "import": "./dist/esm/src/index.js",
       "require": "./dist/cjs/src/index.js"
@@ -31,6 +32,16 @@
       "import": "./dist/esm/src/testing/index.js",
       "require": "./dist/cjs/src/testing/index.js"
     },
+    "./testing/graph-tester": {
+      "types": "./dist/esm/src/testing/graph-tester/index.d.ts",
+      "import": "./dist/esm/src/testing/graph-tester/index.js",
+      "require": "./dist/cjs/src/testing/graph-tester/index.js"
+    },
+    "./testing/graph-tester/fixtures": {
+      "types": "./dist/esm/src/testing/graph-tester/fixtures/index.d.ts",
+      "import": "./dist/esm/src/testing/graph-tester/fixtures/index.js",
+      "require": "./dist/cjs/src/testing/graph-tester/fixtures/index.js"
+    },
     "./testing/ComponentStateHelpers": {
       "types": "./dist/esm/src/testing/ComponentStateHelpers.d.ts",
       "import": "./dist/esm/src/testing/ComponentStateHelpers.js",
@@ -53,15 +64,16 @@
     }
   },
   "scripts": {
-    "clean": "rm -rf dist",
+    "clean": "rm -rf dist node_modules/.cache",
     "build": "npm run clean && npm run build:esm && npm run fix-esm && npm run build:cjs",
     "build:esm": "tsc -p tsconfig.json",
     "fix-esm": "node scripts/fix-esm-imports.js",
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "build:watch": "tsc -p tsconfig.json --watch",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "NODE_ENV=test npx jest",
+    "test:watch": "NODE_ENV=test npx jest --watch",
+    "test:coverage": "NODE_ENV=test npx jest --coverage",
     "lint": "eslint src --ext .ts,.tsx",
     "lint:fix": "eslint src --ext .ts,.tsx --fix",
     "prepack": "npm run build"
@@ -85,7 +97,7 @@
   },
   "dependencies": {
     "@ai-sdk/mcp": "^0.0.8",
-    "@playwright/test": "^1.57.0",
+    "cac": "^6.7.14",
     "glob": "^13.0.0",
     "reflect-metadata": "^0.2.2"
   },
@@ -103,9 +115,11 @@
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",
-    "@testing-library/react": "^16.3.1",
+    "@playwright/test": "^1.57.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
     "@types/glob": "^8.1.0",
-    "@types/jest": "^29.5.8",
+    "@types/jest": "^29.5.14",
     "@types/node": "^25.0.2",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",