@spectratools/graphic-designer-cli 0.3.2 → 0.6.0

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { Cli } from 'incur';
-import { T as ThemeInput, D as DesignSpec, a as Rect, b as DrawCommand, c as Theme, d as RenderedElement } from './spec.schema-DhAI-tE8.js';
-export { A as AutoLayoutConfig, B as BuiltInTheme, C as CardElement, e as CodeBlockElement, f as ConnectionElement, g as ConstraintSpec, h as DEFAULT_GENERATOR_VERSION, i as DEFAULT_RAINBOW_COLORS, j as Decorator, k as DesignSafeFrame, l as DrawBadge, m as DrawBezier, n as DrawCircle, o as DrawFontFamily, p as DrawGradientRect, q as DrawLine, r as DrawPath, s as DrawPoint, t as DrawRect, u as DrawText, E as Element, F as FlowNodeElement, G as Gradient, v as GradientOverlayDecorator, w as GradientSpec, x as GradientStop, y as GridLayoutConfig, I as ImageElement, L as LayoutConfig, z as LayoutSnapshot, M as ManualLayoutConfig, H as RainbowRuleDecorator, R as RenderMetadata, J as RenderResult, S as ShapeElement, K as StackLayoutConfig, N as TerminalElement, O as TextElement, P as ThemeInput, V as VignetteDecorator, W as WrittenArtifacts, Q as builtInThemeBackgrounds, U as builtInThemes, X as computeSpecHash, Y as defaultAutoLayout, Z as defaultCanvas, _ as defaultConstraints, $ as defaultGridLayout, a0 as defaultLayout, a1 as defaultStackLayout, a2 as defaultTheme, a3 as deriveSafeFrame, a4 as designSpecSchema, a5 as drawGradientRect, a6 as drawRainbowRule, a7 as drawVignette, a8 as inferLayout, a9 as inferSidecarPath, aa as parseDesignSpec, ab as renderDesign, ac as resolveTheme, ad as writeRenderArtifacts } from './spec.schema-DhAI-tE8.js';
+import { T as ThemeInput, D as DesignSpec, a as Rect$1, b as DrawCommand, c as Theme, d as RenderedElement, C as ConnectionElement } from './spec.schema-Dm_wOLTd.js';
+export { A as AutoLayoutConfig, B as BuiltInTheme, e as CardElement, f as CodeBlockElement, g as ConstraintSpec, h as DEFAULT_GENERATOR_VERSION, i as DEFAULT_RAINBOW_COLORS, j as Decorator, k as DesignCardSpec, l as DesignSafeFrame, m as DesignTheme, n as DiagramElement, o as DiagramLayout, p as DiagramSpec, q as DrawBadge, r as DrawBezier, s as DrawCircle, t as DrawFontFamily, u as DrawGradientRect, v as DrawLine, w as DrawPath, x as DrawPoint, y as DrawRect, z as DrawText, E as Element, F as FlowNodeElement, G as Gradient, H as GradientOverlayDecorator, I as GradientSpec, J as GradientStop, K as GridLayoutConfig, L as ImageElement, M as LayoutConfig, N as LayoutSnapshot, O as ManualLayoutConfig, P as RainbowRuleDecorator, R as RenderMetadata, Q as RenderResult, S as ShapeElement, U as StackLayoutConfig, V as TerminalElement, W as TextElement, X as ThemeInput, Y as VignetteDecorator, Z as WrittenArtifacts, _ as builtInThemeBackgrounds, $ as builtInThemes, a0 as computeSpecHash, a1 as connectionElementSchema, a2 as defaultAutoLayout, a3 as defaultCanvas, a4 as defaultConstraints, a5 as defaultGridLayout, a6 as defaultLayout, a7 as defaultStackLayout, a8 as defaultTheme, a9 as deriveSafeFrame, aa as designSpecSchema, ab as diagramElementSchema, ac as diagramLayoutSchema, ad as diagramSpecSchema, ae as drawGradientRect, af as drawRainbowRule, ag as drawVignette, ah as flowNodeElementSchema, ai as inferLayout, aj as inferSidecarPath, ak as parseDesignSpec, al as parseDiagramSpec, am as renderDesign, an as resolveTheme, ao as writeRenderArtifacts } from './spec.schema-Dm_wOLTd.js';
 import { SKRSContext2D } from '@napi-rs/canvas';
-export { QaIssue, QaReport, QaSeverity, readMetadata, runQa } from './qa.js';
+export { QaIssue, QaReferenceResult, QaReport, QaSeverity, readMetadata, runQa } from './qa.js';
 import { Highlighter } from 'shiki';
 export { GistPublishOptions, GistPublishResult, GitHubPublishOptions, GitHubPublishResult, publishToGist, publishToGitHub } from './publish/index.js';
 import 'zod';
@@ -10,6 +10,43 @@ import '@spectratools/cli-shared/middleware';
 
 declare const cli: Cli.Cli<{}, undefined, undefined>;
 
+type CompareVerdict = 'match' | 'close' | 'mismatch';
+type CompareImagesOptions = {
+    grid?: number;
+    threshold?: number;
+    closeMargin?: number;
+};
+type CompareRegionScore = {
+    label: string;
+    row: number;
+    column: number;
+    similarity: number;
+};
+type CompareImagesReport = {
+    targetPath: string;
+    renderedPath: string;
+    targetDimensions: {
+        width: number;
+        height: number;
+    };
+    renderedDimensions: {
+        width: number;
+        height: number;
+    };
+    normalizedDimensions: {
+        width: number;
+        height: number;
+    };
+    dimensionMismatch: boolean;
+    grid: number;
+    threshold: number;
+    closeThreshold: number;
+    similarity: number;
+    verdict: CompareVerdict;
+    regions: CompareRegionScore[];
+};
+declare function compareImages(target: string, rendered: string, options?: CompareImagesOptions): Promise<CompareImagesReport>;
+
 declare const themeToShikiMap: Record<string, string>;
 declare function resolveShikiTheme(theme: ThemeInput): string;
 
@@ -173,7 +210,7 @@ type EdgeRoute = {
     }>;
 };
 type LayoutResult = {
-    positions: Map<string, Rect>;
+    positions: Map<string, Rect$1>;
     canvasSize?: {
         width: number;
         height: number;
@@ -201,6 +238,69 @@ type ElkLayoutResult = LayoutResult & {
  */
 declare function renderDrawCommands(ctx: SKRSContext2D, commands: DrawCommand[], theme: Theme): RenderedElement[];
 
+type Point$1 = {
+    x: number;
+    y: number;
+};
+
+type Point = Point$1;
+type Rect = Rect$1;
+type ConnectionRouting = 'auto' | 'orthogonal' | 'curve' | 'arc';
+type ConnectionArrow = 'none' | 'end' | 'start' | 'both';
+type ConnectionStrokeStyle = 'solid' | 'dashed' | 'dotted';
+type ConnectionRenderOptions = {
+    fromBounds: Rect;
+    toBounds: Rect;
+    routing: ConnectionRouting;
+    tension: number;
+    color: string;
+    strokeWidth: number;
+    strokeStyle: ConnectionStrokeStyle;
+    arrow: ConnectionArrow;
+    label?: string;
+    diagramCenter: Point;
+    elkRoute?: Point[];
+};
+type CubicBezierSegment = [Point, Point, Point, Point];
+declare function rectCenter(rect: Rect): Point;
+/**
+ * Compute the point where a ray from the center of `bounds` toward `target`
+ * exits the bounding rectangle.
+ */
+declare function edgeAnchor(bounds: Rect, target: Point): Point;
+/**
+ * Unit vector pointing outward from `diagramCenter` through `point`.
+ */
+declare function outwardNormal(point: Point, diagramCenter: Point): Point;
+/**
+ * Compute a cubic bezier curve that bows outward from the diagram center.
+ * Returns `[startPoint, controlPoint1, controlPoint2, endPoint]`.
+ */
+declare function curveRoute(fromBounds: Rect, toBounds: Rect, diagramCenter: Point, tension: number): [Point, Point, Point, Point];
+/**
+ * Approximate an outward-bowing half-ellipse with two cubic bezier segments.
+ *
+ * Uses the classic kappa constant (`4 * (sqrt(2) - 1) / 3`) for quarter-ellipse
+ * control points, producing a stable arc from source edge anchor to target edge
+ * anchor.
+ */
+declare function arcRoute(fromBounds: Rect, toBounds: Rect, diagramCenter: Point, tension: number): [CubicBezierSegment, CubicBezierSegment];
+/**
+ * Compute an orthogonal (right-angle) path between two rectangles.
+ * Returns an array of waypoints forming a 3-segment path.
+ */
+declare function orthogonalRoute(fromBounds: Rect, toBounds: Rect): Point[];
+/** Evaluate cubic bezier at parameter `t`. */
+declare function bezierPointAt(p0: Point, cp1: Point, cp2: Point, p3: Point, t: number): Point;
+/**
+ * Compute the centroid of all node bounding boxes. Falls back to the
+ * provided `canvasCenter` when no nodes are supplied.
+ */
+declare function computeDiagramCenter(nodeBounds: Rect[], canvasCenter?: Point): Point;
+declare function renderConnection(ctx: SKRSContext2D, conn: ConnectionElement, fromBounds: Rect, toBounds: Rect, theme: Theme, edgeRoute?: EdgeRoute, options?: {
+    diagramCenter?: Point;
+}): RenderedElement[];
+
 /**
  * Register the bundled font families (Inter, JetBrains Mono, Space Grotesk)
  * with the global `@napi-rs/canvas` font registry.
@@ -256,4 +356,4 @@ declare function highlightCode(code: string, language: string, themeName: string
  */
 declare function disposeHighlighter(): void;
 
-export { DesignSpec, DrawCommand, type EdgeRoute, type ElkLayoutResult, type HighlightedLine, type LayoutResult, Rect, RenderedElement, Theme, buildCardsSpec, buildCodeSpec, buildFlowchartSpec, buildTerminalSpec, cli, disposeHighlighter, highlightCode, initHighlighter, loadFonts, renderDrawCommands, resolveShikiTheme, themeToShikiMap };
+export { type CompareImagesOptions, type CompareImagesReport, type CompareRegionScore, type CompareVerdict, type ConnectionArrow, ConnectionElement, type ConnectionRenderOptions, type ConnectionRouting, type ConnectionStrokeStyle, type CubicBezierSegment, DesignSpec, DrawCommand, type EdgeRoute, type ElkLayoutResult, type HighlightedLine, type LayoutResult, type Point, Rect$1 as Rect, RenderedElement, Theme, arcRoute, bezierPointAt, buildCardsSpec, buildCodeSpec, buildFlowchartSpec, buildTerminalSpec, cli, compareImages, computeDiagramCenter, curveRoute, disposeHighlighter, edgeAnchor, highlightCode, initHighlighter, loadFonts, orthogonalRoute, outwardNormal, rectCenter, renderConnection, renderDrawCommands, resolveShikiTheme, themeToShikiMap };