@unotest/web 0.29.0 → 0.31.0

package/dist/{interfaces-SzdtOj1F.d.ts → interfaces-B34N4rfI.d.ts}

@@ -226,6 +226,10 @@ interface ScreenshotOptions {
      *  pins that floor. */
     type?: "png" | "jpeg" | "webp";
 }
+/** Encoding options for an element capture — `ScreenshotOptions` minus
+ *  the page-geometry fields (`fullPage`, `clip`) that have no meaning for a
+ *  single element. */
+type ElementScreenshotOptions = Pick<ScreenshotOptions, "type" | "quality">;
 interface CookieOptions {
     domain?: string;
     path?: string;
@@ -234,6 +238,13 @@ interface CookieOptions {
     secure?: boolean;
     sameSite?: "Strict" | "Lax" | "None";
 }
+/** What an attaching client applies to a context it did not create. Only
+ *  the dialog policy: the rest of {@link ContextOptions} was decided by the
+ *  process that owns the browser. Without a `dialog` listener Playwright
+ *  dismisses every dialog on behalf of the client that has none — and a
+ *  second client watching the run's page would answer `confirm()` with
+ *  "no" before the run's own accept lands. */
+type AttachOptions = Pick<ContextOptions, "dialogPolicy">;
 
 interface WebDriver {
     /**
@@ -263,7 +274,7 @@ interface WebDriver {
      */
     wsEndpoint(): string | undefined;
     connectShared(wsEndpoint: string, browser: LaunchOptions["browser"]): Promise<void>;
-    attachExisting(): DriverContext;
+    attachExisting(opts?: AttachOptions): DriverContext;
 }
 /** One captured network request/response, recorded only under
  *  `UNOTEST_NETWORK`. `status`/`ok` come from the response; `failureText`
@@ -422,6 +433,10 @@ interface DriverPage {
     evaluate<T = unknown>(js: string, arg?: unknown): Promise<T>;
     evaluateOnLocator<T = unknown>(loc: LocatorValue, js: string): Promise<T>;
     screenshot(opts?: ScreenshotOptions): Promise<Buffer>;
+    /** Capture ONE element (first match, scrolled into view) instead of the
+     *  viewport — the evidence shot of a card / row / dialog. Same encoding
+     *  options as `screenshot`; `fullPage` / `clip` don't apply. */
+    screenshotElement(loc: LocatorValue, opts?: ElementScreenshotOptions): Promise<Buffer>;
     inspectElement(loc: LocatorValue): Promise<ElementHint | null>;
     /** outerHTML of the element the locator matches (first match), or null
      *  when it resolves to zero elements. Used by debug logging to persist
@@ -526,4 +541,4 @@ interface AncestorHint {
     className?: string;
 }
 
-export { type ActionTimeout as A, type ContextOptions as C, type DriverContext as D, type ElementHint as E, type FillOptions as F, type GotoOptions as G, type HoverOptions as H, type LaunchOptions as L, type NetworkEntry as N, type PressOptions as P, type ReloadOptions as R, type ScreenshotOptions as S, type Viewport as V, type WebDriver as W, type CheckOptions as a, type ClickOptions as b, type CookieOptions as c, type DriverPage as d, type NavigationOptions as e, type SelectOptions as f, type WaitOptions as g, type WaitState as h, type LocatorValue as i, type LocatorStep as j, appendStep as k, describeLocator as l, isLocatorValue as m, rootedAt as r };
+export { type AttachOptions as A, type ContextOptions as C, type DriverContext as D, type ElementHint as E, type FillOptions as F, type GotoOptions as G, type HoverOptions as H, type LaunchOptions as L, type NetworkEntry as N, type PressOptions as P, type ReloadOptions as R, type ScreenshotOptions as S, type Viewport as V, type WebDriver as W, type ActionTimeout as a, type CheckOptions as b, type ClickOptions as c, type CookieOptions as d, type DriverPage as e, type NavigationOptions as f, type SelectOptions as g, type WaitOptions as h, type WaitState as i, type LocatorValue as j, type LocatorStep as k, appendStep as l, describeLocator as m, isLocatorValue as n, rootedAt as r };

package/dist/legacy-layout-By62PkbP.d.ts

@@ -0,0 +1,8 @@
+interface LegacyLayout {
+    /** Root-relative config path that is no longer read, if there is one. */
+    configPath?: string;
+    /** True when the product's own manifest still carries the runner. */
+    pinInProductManifest: boolean;
+}
+
+export type { LegacyLayout as L };

package/dist/linter-Yf4gPe5J.d.ts

@@ -0,0 +1,36 @@
+import { BlockStatement } from '@unotest/dsl';
+
+type LintSeverity = 'error' | 'warning' | 'info';
+interface LintDiagnostic {
+    rule: string;
+    severity: LintSeverity;
+    message: string;
+    line: number;
+    col: number;
+}
+/** What the linter may ask about external variables (bare UPPER_SNAKE
+ *  identifiers). A predicate, not a list, because the two callers hold
+ *  different truths: `lint` knows the NAMES declared in the project's
+ *  files, a run knows what the runtime will actually RESOLVE (files plus
+ *  the ambient shell) — and the run-time store already answers `has`. */
+interface ExternalVariableLookup {
+    has(name: string): boolean;
+    /** Where `has` looked, for the diagnostic (`unotest/.env, unotest/.env.dev (no such file)`). */
+    describeSources?(): string;
+}
+interface LintOptions {
+    /** Per-rule severity override. Default severities live with each rule. */
+    ruleSeverity?: Partial<Record<string, LintSeverity>>;
+    /** Pass through if the agent provided documented justification — e.g. a
+     *  `// reason:` comment immediately above the line. The lexer doesn't
+     *  preserve comments today; for v1 we accept a flag from the caller. */
+    allowDisambigByIndex?: boolean;
+    /** Enables `lint:external-variable-undeclared`: every bare UPPER_SNAKE
+     *  identifier that is neither bound in this file nor known to the
+     *  lookup is an error. Absent → the rule is off (the caller has no
+     *  project to check against, e.g. an ad-hoc source string). */
+    externalVariables?: ExternalVariableLookup;
+}
+declare function lintAst(ast: BlockStatement, opts?: LintOptions): LintDiagnostic[];
+
+export { type ExternalVariableLookup as E, type LintDiagnostic as L, type LintSeverity as a, type LintOptions as b, lintAst as l };