@unotest/web 0.29.0 → 0.31.0

package/types/unotest-dsl.d.ts

@@ -120,9 +120,9 @@ declare function check(locator: Locator, options?: any): void;
 declare function uncheck(locator: Locator, options?: any): void;
 
 /**
- * hover(locator, { force?, timeout? })
+ * hover(locator, { force?, position?, timeout? })
  *
- * Hover over an element.
+ * Hover over an element. `position` is an {x, y} offset inside it — for a menu that only appears at one edge of a tall element.
  */
 declare function hover(locator: Locator, options?: any): void;
 
@@ -281,9 +281,16 @@ declare function randomNth(receiver: Locator): Locator;
 declare function screenshot(name?: string, options?: any): string;
 
 /**
- * evaluate(js, ...args) → any
+ * note(label, value)
  *
- * Run raw JS in the page context. Last resort — prefer typed helpers. Returns JSON-serializable values only.
+ * Attach a labelled value to the current step: shown in the viewer under the step (also after the run) and kept in the run journal. Any value — a string, a number, an object (recorded as JSON). Secrets are masked; long values are cut at 4 KB. Use it for the question a data-driven case asked and the answer it got.
+ */
+declare function note(label: string, value: any): void;
+
+/**
+ * evaluate(js, arg?) → any
+ *
+ * Run raw JS in the page context. Last resort — prefer typed helpers. Returns JSON-serializable values only. Extra arguments reach the body as: none → nothing, exactly one → the value itself, two or more → ONE array (destructure `([a, b]) => …`).
  */
 declare function evaluate(jsBody: string, ...args: unknown[]): any;
 
@@ -511,6 +518,13 @@ declare function waitForJsonLine(path: string, filter: any, options?: any): any;
  */
 declare function assertNoJsonLine(path: string, filter: any, options?: any): void;
 
+/**
+ * readJsonLine(path, filter) → object
+ *
+ * First matching line of a JSONL file that already exists, no wait: one read, same key filter as waitForJsonLine. FAILS at once when the file is missing or no line matches — use it for fixtures and finished exports, waitForJsonLine for a file still being written.
+ */
+declare function readJsonLine(path: string, filter: any): any;
+
 /**
  * waitForFileCount(path, pattern, count, options?) → number
  *
@@ -654,7 +668,7 @@ declare function getUrl(): string;
 /**
  * log(...args)
  *
- * Write to the run trace.
+ * Write a line to the runner's output AND to the run journal, under the current step — visible in the viewer's System pane after the run too.
  */
 declare function log(message: any, ...args: unknown[]): void;
 
@@ -714,8 +728,18 @@ declare function waitForCount(locator: Locator, count: number, options?: any): v
  */
 declare function pause(ms: number): void;
 
-/** step(label, body)
+/** step(label, [options,] body)
  *
  *  Groups statements under a labelled block. Every direct child of a
- *  test_* function must sit inside a step(...). */
+ *  test_* function must sit inside a step(...). `{tag}` names the case a
+ *  data-driven step is on. */
 declare function step(label: string, body: () => void): void;
+declare function step(label: string, options: { tag: unknown }, body: () => void): void;
+declare namespace step {
+  /** step.soft(label, [options,] body)
+   *
+   *  A failure inside is recorded and the run continues after the block;
+   *  the test still ends failed. Allowed inside test_* only. */
+  function soft(label: string, body: () => void): void;
+  function soft(label: string, options: { tag: unknown }, body: () => void): void;
+}

package/dist/linter-CM2CpIyW.d.ts

@@ -1,21 +0,0 @@
-import { BlockStatement } from '@unotest/dsl';
-
-type LintSeverity = 'error' | 'warning' | 'info';
-interface LintDiagnostic {
-    rule: string;
-    severity: LintSeverity;
-    message: string;
-    line: number;
-    col: number;
-}
-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;
-}
-declare function lintAst(ast: BlockStatement, opts?: LintOptions): LintDiagnostic[];
-
-export { type LintDiagnostic as L, type LintSeverity as a, type LintOptions as b, lintAst as l };