vigthoria-cli 1.13.34 → 1.13.42

package/dist/utils/preview-screenshot-adapter.d.ts

@@ -1,8 +1,35 @@
+import WebSocket from 'ws';
 export type PreviewRuntimeInteractionOptions = {
     key?: string;
     expectText?: string;
     requireStateChange?: boolean;
     waitMs?: number;
+    timeoutMs?: number;
+    steps?: PreviewRuntimeStep[];
+    workspaceRoot?: string;
+};
+export type PreviewRuntimeStep = {
+    action: 'assert' | 'click' | 'fill' | 'select' | 'press' | 'focus' | 'wait' | 'reload';
+    selector?: string;
+    value?: string;
+    wait_ms?: number;
+    offset_x_ratio?: number;
+    offset_y_ratio?: number;
+    expect_selector?: string;
+    expect_count?: number;
+    expect_text?: string;
+    expect_text_not?: string;
+    expect_canvas_nonblank?: boolean;
+    expect_value?: string;
+    expect_visible?: boolean;
+    expect_hidden?: boolean;
+    expect_attribute?: string;
+    expect_attribute_value?: string;
+    expect_attribute_absent?: string;
+    expect_attribute_token?: string;
+    expect_attribute_token_absent?: string;
+    expect_focused?: boolean;
+    expect_focus_within?: string;
 };
 export type PreviewScreenshotResult = {
     captured: boolean;
@@ -16,6 +43,9 @@ export type PreviewRuntimeInteractionResult = PreviewScreenshotResult & {
     bodyChanged?: boolean;
     visualChanged?: boolean;
     runtimeErrors?: string[];
+    interactionStepsRequested?: number;
+    interactionStepsPassed?: number;
+    interactionFailures?: string[];
 };
 export interface PreviewScreenshotPort {
     capture(entryAbsolutePath: string, screenshotPath: string): Promise<PreviewScreenshotResult>;
@@ -33,10 +63,61 @@ type PreviewRuntimeBrowserObservation = {
     bodyChanged: boolean;
     visualChanged: boolean;
     runtimeErrors: string[];
+    interactionStepsRequested?: number;
+    interactionStepsPassed?: number;
+    interactionFailures?: string[];
 };
 export type PreviewRuntimeBrowserRunner = (executablePath: string, args: readonly string[], platform: NodeJS.Platform, environment: NodeJS.ProcessEnv, screenshotPath: string, options: PreviewRuntimeInteractionOptions) => Promise<PreviewRuntimeBrowserObservation>;
+export declare function assertPreviewBrowserSandboxUser(platform?: NodeJS.Platform, effectiveUserId?: number | undefined): void;
 export declare function resolvePreviewBrowserExecutable(environment?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, exists?: (candidate: string) => boolean): PreviewBrowserResolution | null;
 export declare const runPreviewBrowser: PreviewBrowserRunner;
+type CdpResponse = {
+    id?: number;
+    method?: string;
+    params?: Record<string, any>;
+    result?: Record<string, any>;
+    error?: {
+        message?: string;
+    };
+    sessionId?: string;
+};
+declare class PreviewCdpClient {
+    private readonly socket;
+    private nextId;
+    private readonly pending;
+    private readonly eventListeners;
+    constructor(socket: WebSocket);
+    onEvent(listener: (event: CdpResponse) => void): () => void;
+    send(method: string, params?: Record<string, any>, sessionId?: string): Promise<Record<string, any>>;
+    close(): void;
+    private rejectPending;
+}
+type RuntimeKeyDefinition = {
+    key: string;
+    code: string;
+    virtualKeyCode: number;
+    text?: string;
+};
+type RuntimeModifierDefinition = RuntimeKeyDefinition & {
+    bit: number;
+};
+export declare function runtimeKeyChordDefinition(rawKey?: string): {
+    key: RuntimeKeyDefinition;
+    modifiers: RuntimeModifierDefinition[];
+    modifierMask: number;
+} | null;
+export declare function applyRuntimeStepAction(client: PreviewCdpClient, sessionId: string, step: PreviewRuntimeStep): Promise<void>;
+export declare function waitForRuntimeActionTarget(client: PreviewCdpClient, sessionId: string, selector: string, scenarioDeadline: number): Promise<void>;
+export declare function runtimeAttributeExpectationFailures(step: Pick<PreviewRuntimeStep, 'expect_attribute' | 'expect_attribute_value' | 'expect_attribute_absent' | 'expect_attribute_token' | 'expect_attribute_token_absent'>, snapshot: {
+    attributeValue: string | null;
+    absentAttributeValue: string | null;
+}): string[];
+export declare function runtimeVisibilityExpectationFailures(step: Pick<PreviewRuntimeStep, 'expect_visible' | 'expect_hidden'>, snapshot: {
+    visible: boolean;
+    hiddenAttribute: boolean;
+    hiddenProperty: boolean;
+    computedDisplay: string;
+}): string[];
 export declare const runPreviewRuntimeBrowser: PreviewRuntimeBrowserRunner;
 /** Dependency-free system-browser adapter. No browser download or archive
  * extractor is shipped, and only fixed operating-system installation paths