@bridge-ds/visual 0.0.0-stage → 0.2.1

package/dist/capture.d.ts

@@ -0,0 +1,40 @@
+import { type Browser, type BrowserContext, type Page } from 'playwright-core';
+import type { Viewport } from './types.js';
+export declare const FROZEN_TIME = "2026-01-15T10:00:00.000Z";
+export interface LaunchOptions {
+    /** Path to a Chrome or Chromium binary; otherwise the installed Chrome (channel "chrome"). */
+    executablePath?: string;
+    channel?: string;
+}
+export declare function launch(o?: LaunchOptions): Promise<Browser>;
+export declare function newContext(browser: Browser, viewport: Viewport): Promise<BrowserContext>;
+export declare function newPage(ctx: BrowserContext): Promise<Page>;
+/** Waits for fonts, images, two frames, and a DOM whose markup stops changing (bounded). */
+export declare function settle(page: Page, o?: {
+    timeout?: number;
+    network?: boolean;
+    quiet?: number;
+    interval?: number;
+    busy?: boolean;
+}): Promise<void>;
+export interface ShotRequest {
+    url: string;
+    /** Replaces page.goto(url): e.g. switching stories inside an already loaded Storybook. */
+    navigate?: (page: Page) => Promise<void>;
+    /** Settle options; app screens wait for the network, story switches do not. */
+    settle?: Parameters<typeof settle>[1];
+    file: string;
+    fullPage: boolean;
+    waitFor?: string;
+    ready?: string;
+    /** JS expression polled until truthy before settling (story rendered, app mounted). */
+    readyFn?: string;
+    mask?: string[];
+}
+/** Navigates, settles and writes a PNG. Returns an error message instead of throwing. */
+export declare function shoot(page: Page, r: ShotRequest): Promise<string | null>;
+/**
+ * Shows a story in an already loaded Storybook preview through its channel (what the manager does when you
+ * click a story), much faster than a page load per story. Resolves once the story rendered or failed.
+ */
+export declare function switchStory(page: Page, storyId: string): Promise<void>;

package/dist/composite.d.ts

@@ -0,0 +1,16 @@
+import type { Page } from 'playwright-core';
+import type { Box } from './types.js';
+export interface CompositeInput {
+    title: string;
+    subtitle: string;
+    before: string | null;
+    after: string | null;
+    diff: string | null;
+    width: number;
+    height: number;
+    boxes: Box[];
+    out: string;
+    /** Column width in CSS px; images wider than this are scaled down. */
+    column?: number;
+}
+export declare function composite(page: Page, c: CompositeInput): Promise<void>;

package/dist/diff.d.ts

@@ -0,0 +1,28 @@
+import { PNG } from 'pngjs';
+import type { Box } from './types.js';
+export interface DiffResult {
+    changedPixels: number;
+    totalPixels: number;
+    percent: number;
+    boxes: Box[];
+    /** Diff image: the after image faded, changed pixels in red. Null when nothing changed. */
+    diff: PNG | null;
+    width: number;
+    height: number;
+}
+export declare const decodePng: (buf: Buffer) => PNG;
+export declare const encodePng: (png: PNG) => Buffer;
+/** Copies `src` onto a `width` x `height` canvas filled with an opaque neutral, so sizes can differ. */
+export declare function padTo(src: PNG, width: number, height: number): PNG;
+/**
+ * Compares two screenshots. `threshold` is pixelmatch's per-pixel color distance (0..1, 0.03 by default: low enough to catch one step of a color ramp);
+ * anti-aliasing differences are ignored. Area that exists in only one image (a taller story) counts as changed.
+ */
+export declare function diffPngs(before: PNG, after: PNG, threshold?: number, cell?: number): DiffResult;
+/**
+ * Bounding boxes of changed regions: the diff mask is bucketed into `cell` px cells, neighbouring cells
+ * (8-connected, one empty cell of slack) are merged, and each group gives one box. At most `max` boxes;
+ * beyond that the smallest are merged into their nearest neighbour.
+ */
+export declare function boxesFromDiff(diff: PNG, cell?: number, max?: number): Box[];
+export declare function boxesFromCells(hot: Uint8Array, cols: number, rows: number, cell: number, width: number, height: number, max?: number): Box[];

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { runImpact, planImpact, changedTokens, type ImpactOptions, type ImpactResult, type Plan } from './run.js';
+export { selectImpact, storiesFromSource, storyId, storyComponent, type SelectInput } from './select.js';
+export { diffPngs, boxesFromDiff, boxesFromCells, padTo, decodePng, encodePng, type DiffResult } from './diff.js';
+export { COMMENT_MARKER, hasVisualChange, rankShots, renderComment, summarize, summaryLine, type CommentOptions } from './manifest.js';
+export { DEFAULT_ROUTES, DEFAULT_TENANTS, routeUrl, storyUrl, shotKey } from './routes.js';
+export { linkNodeModules } from './workspace.js';
+export type * from './types.js';