@lingxia/test 0.17.0 → 0.19.0

package/dist/report-types.d.ts

@@ -0,0 +1,428 @@
+/**
+ * The shapes of `report.json` and of the run protocol lxdev reads, published
+ * as `@lingxia/test/report` for tools that read a report.
+ */
+export type SpecStatus = "passed" | "failed" | "skipped" | "timeout" | "xfail" | "xpass";
+export type StepStatus = "passed" | "failed" | "timeout" | "skipped";
+export interface AssertionRecord {
+    matcher: string;
+    expected: string;
+    actual: string;
+    passed: boolean;
+    step?: string;
+    /** The locator or poll description, when available. */
+    target?: string;
+    /** Optional business intent supplied by the spec author. */
+    message?: string;
+    /** Authored source location. */
+    location?: string;
+    duration_ms?: number;
+    /** First unequal path or string offset, computed before preview truncation. */
+    difference?: string;
+    /** Order within this spec's attempt, shared with steps and attachments. */
+    sequence?: number;
+    at_ms?: number;
+}
+export interface StepRecord {
+    name: string;
+    path: string;
+    /** `step` is authored with `t.step`; `action` is a recorded driver call. */
+    kind?: "step" | "action";
+    /** Short argument summary for an action — a selector, a page, a script head. */
+    detail?: string;
+    /** Identical consecutive actions collapse into one row with a count. */
+    repeat?: number;
+    status: StepStatus;
+    duration_ms: number;
+    /** Event-only recovery could not measure elapsed time; 0 is a placeholder. */
+    duration_unknown?: boolean;
+    sequence?: number;
+    at_ms?: number;
+    error?: ReportError;
+    steps: StepRecord[];
+    attachments: AttachmentRef[];
+    assertions: AssertionRecord[];
+}
+export interface AttachmentRef {
+    name: string;
+    path: string;
+    mimeType: string;
+    sequence?: number;
+    at_ms?: number;
+    /** Authored step in which the attachment was created. Failure evidence is attempt-scoped. */
+    step?: string;
+    /** Captured after an attempt failed, rather than attached by the spec body. */
+    purpose?: "failure_evidence";
+}
+/** A page instance, as a failure names it. */
+export interface FailurePage {
+    name: string | null;
+    instanceId: string | null;
+    /**
+     * Set when the page was hidden at the failure (window covered, minimized
+     * or display asleep): WebKit pauses animation frames, so rAF- and
+     * transition-driven UI never moved.
+     */
+    hidden?: string;
+}
+/** `document.visibilityState` and whether an animation frame arrived. */
+export interface PageVisibility {
+    state: string;
+    animationFrames: boolean;
+    /** The explanation, when the page was hidden or got no frame. */
+    note?: string;
+}
+/**
+ * One Logic `fetch` (or `Rong.SSE` connection) the app made, as a failed
+ * spec's report lists it: no bodies, no headers, credentials and
+ * `--secret-arg` values masked in the URL.
+ */
+export interface FailureNetworkCall {
+    /** Epoch milliseconds when the request started. */
+    time: number;
+    /** Milliseconds from this attempt's start when included in `network_calls`. */
+    at_ms?: number;
+    /** Deepest authored step active when the request started. Time overlap is not causation. */
+    observed_during?: string;
+    /** `function`: a Worker Function call the dev session's companion saw. */
+    kind: "fetch" | "sse" | "function";
+    /** Empty for a `function` call. */
+    method: string;
+    /** Empty for a `function` call. */
+    url: string;
+    /** `function` calls: the Function and `result`/`error`/`fault`/`default`. */
+    function?: string;
+    outcome?: string;
+    /** Response status; `null` when it failed or has not answered. */
+    status: number | null;
+    /** The rejection, e.g. `TypeError: fetch failed`. */
+    error?: string;
+    durationMs: number | null;
+    /** `route` when a test route answered; `network` when the request was real. */
+    source: "route" | "network";
+    /** The route that matched, including a `continue` pass-through. */
+    route?: {
+        pattern: string;
+        action: string;
+        rule?: number;
+        scenario?: string;
+    };
+    /** `rule 2 (name:variant)`, `route <pattern>`, `real`, or `companion default`. */
+    answeredBy?: string;
+    /** Why no scenario rule answered, when rules targeted the call. */
+    noMatch?: string;
+}
+/** The scenario a failed spec had installed, and what each rule answered. */
+export interface ScenarioReport {
+    /** `name:variant`. */
+    label: string;
+    name: string | null;
+    variant: string | null;
+    rules: {
+        index: number;
+        target: string;
+        kind: "http" | "function";
+        hits: number;
+    }[];
+}
+export interface ReportError {
+    code?: string;
+    data?: unknown;
+    phase?: string;
+    /** The app's last Logic network calls before the failure, oldest first. */
+    network?: FailureNetworkCall[];
+    /** The scenario installed with `t.scenario.use()` when the spec failed. */
+    scenario?: ScenarioReport;
+    /** The recorded driver action that failed, e.g. `page.click [data-testid=save]`. */
+    failedAction?: string;
+    /** The page that was current when the spec failed. */
+    page?: FailurePage;
+    name: string;
+    message: string;
+    stack?: string;
+    matcher?: string;
+    expected?: string;
+    actual?: string;
+    difference?: string;
+    location?: string;
+    step?: string;
+}
+export interface CaseRecord {
+    attempt?: number;
+    attempts?: CaseRecord[];
+    flaky?: boolean;
+    id: string;
+    title: string;
+    name: string;
+    full_name: string;
+    /** Which `--repeat-each` execution this is (1-based); absent without it. */
+    repeat?: number;
+    /** Source file the spec was registered from, remapped through the bundle map. */
+    file?: string;
+    line?: number;
+    /** Display group in the report — the spec file's path inside the project. */
+    suite?: string;
+    status: SpecStatus;
+    duration_ms: number;
+    covers: string[];
+    /** Selection tags: the file's `spec.configure` tags, then the spec's own. */
+    tags?: string[];
+    /**
+     * `lxdev test --openapi`: this spec's Logic `fetch` responses checked
+     * against the contract. `violations` (routed responses) failed the spec;
+     * `warnings` (the real server's) did not.
+     */
+    contract?: CaseContract;
+    /**
+     * `lx.*` members the spec's evals actually reached, observed by the runtime
+     * rather than declared. A `covers` tag absent from here was claimed but never
+     * exercised.
+     */
+    observed?: string[];
+    /** Scenario selected by this attempt, including passing attempts. */
+    scenario?: {
+        label: string;
+        name: string | null;
+        variant: string | null;
+    };
+    /** Bounded Logic call provenance, including passing attempts. */
+    network_summary?: {
+        observed: number;
+        routed: number;
+        real: number;
+        limit_reached: boolean;
+    };
+    /** Recent Logic calls made during this attempt, ordered by request start time.
+     * Time proximity to a step is evidence, not proof that the step caused it. */
+    network_calls?: FailureNetworkCall[];
+    /** The action trace hit its bounded record limit. */
+    trace_truncated?: boolean;
+    steps: StepRecord[];
+    assertions: AssertionRecord[];
+    attachments: AttachmentRef[];
+    error?: ReportError;
+    timeout_ms: number;
+    reason?: string;
+}
+/** One response that breaks the OpenAPI contract. */
+export interface ContractIssue {
+    /** The spec id. */
+    case: string;
+    /** `route`/`patch`: a route shaped it; `network`: the real server. */
+    source: "route" | "patch" | "network";
+    method: string;
+    /** Scheme, host and path only. */
+    url: string;
+    status: number;
+    /** `METHOD /path/{template}` as the document names it. */
+    operation: string;
+    /** The response schema, as a document pointer. */
+    schema: string;
+    /** The route that fulfilled or patched it. */
+    pattern?: string;
+    issues: Array<{
+        path: string;
+        message: string;
+        schema: string;
+    }>;
+}
+export interface CaseContract {
+    /** Responses captured during the spec. */
+    checked: number;
+    violations: ContractIssue[];
+    warnings: ContractIssue[];
+}
+/** `report.openapi`: what `--openapi` checked across the run. */
+export interface OpenApiSummary {
+    documents: Array<{
+        name: string;
+        version: string;
+        title?: string;
+        operations: number;
+    }>;
+    /** Captured responses. */
+    responses: number;
+    /** Responses with a documented JSON schema and a body, validated. */
+    validated: number;
+    routed: {
+        validated: number;
+        failed: number;
+    };
+    network: {
+        validated: number;
+        mismatched: number;
+    };
+    /** Matched an operation but not validated, by why. */
+    skipped: {
+        no_schema: number;
+        not_json: number;
+        empty: number;
+        truncated: number;
+    };
+    /** A status the operation does not document. */
+    undocumented: Array<{
+        operation: string;
+        status: number;
+        source: string;
+        count: number;
+    }>;
+    /** Requests no operation describes (another API, or a gap in the document). */
+    unmatched: Array<{
+        method: string;
+        path: string;
+        count: number;
+    }>;
+    /** Real-server mismatches (at most 100). */
+    warnings: ContractIssue[];
+}
+/** `report.tag_summary`: one row per tag, and `(untagged)` for the rest. */
+export interface TagSummary {
+    tag: string;
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    timeout: number;
+    xfail: number;
+    xpass: number;
+    flaky: number;
+    /** No failed, timed-out or xpass spec carries the tag. */
+    ok: boolean;
+}
+/** A spec covering a manifest id, with its outcome in this run. */
+export interface CoverageSpec {
+    id: string;
+    title: string;
+    /** `not_run`: registered, but outside this selection. */
+    status: SpecStatus | "not_run";
+}
+/** `report.coverage`: the `--covers-manifest` ids against the suite's `covers`. */
+export interface CoverageSummary {
+    total: number;
+    /** Ids at least one registered spec covers. */
+    covered: number;
+    /** Covered ids whose specs passed (none broke). */
+    passing: number;
+    /** Covered ids with a failed, timed-out or xpass spec. */
+    failing: number;
+    /** Manifest ids no spec covers. */
+    uncovered: Array<{
+        id: string;
+        title?: string;
+    }>;
+    /** `covers` ids used by specs but missing from the manifest. */
+    unknown: Array<{
+        id: string;
+        specs: string[];
+    }>;
+    ids: Array<{
+        id: string;
+        title?: string;
+        status: "passed" | "failed" | "xfail" | "skipped" | "not_run" | "uncovered";
+        specs: CoverageSpec[];
+    }>;
+}
+/** The app under test, so a report identifies its own subject. */
+export interface RunSubject {
+    appid?: string;
+    app_name?: string;
+    version?: string;
+    release_type?: string;
+    pages?: number;
+}
+export interface RunMeta {
+    started_at: string;
+    duration_ms: number;
+    /** User args; declared secrets and credential-named keys are `***`. */
+    args: Record<string, string>;
+    /** lxdev's run controls (grep, ids, shard, retries, …). */
+    run?: Record<string, string>;
+    platform?: string;
+    framework?: string;
+    subject?: RunSubject;
+    /** The suite opted into measuring the whole published `lx` surface. */
+    surface_coverage?: boolean;
+    /**
+     * The whole-run budget: fixed by `--timeout-secs`, or scaled to the
+     * planned executions (`auto`). `exhausted_after` counts the specs that
+     * finished before it ran out; the rest are skipped as not run.
+     */
+    budget?: {
+        ms: number;
+        auto: boolean;
+        planned: number;
+        exhausted_after?: number;
+    };
+    /** `--shuffle` seed; rerun with `--shuffle=<seed>` for the same order. */
+    shuffle_seed?: number;
+    /** `--repeat-each` count. */
+    repeat_each?: number;
+}
+/** One failed case, flat, for tools that only need what broke and where. */
+export interface FailureRecord {
+    id: string;
+    title: string;
+    file?: string;
+    line?: number;
+    phase?: string;
+    code?: string;
+    message: string;
+    failedAction?: string;
+    page?: FailurePage;
+    /** Report-relative path of the failure screenshot, when one was captured. */
+    screenshot?: string;
+    /** The app's last Logic network calls before the failure (up to 20). */
+    network?: FailureNetworkCall[];
+    /** The scenario installed when the spec failed. */
+    scenario?: ScenarioReport;
+}
+export interface JsonReport {
+    schema_version?: number;
+    /** Added by lxdev when the host run is finalized. */
+    run_id?: string;
+    state?: string;
+    error?: {
+        code?: string;
+        message: string;
+        data?: unknown;
+    } | null;
+    run_errors?: Array<{
+        message: string;
+    }>;
+    framework: {
+        name: string;
+        version: string;
+    };
+    meta: RunMeta;
+    partial: boolean;
+    filtered: boolean;
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    xfail: number;
+    xpass: number;
+    timeout: number;
+    duration_ms: number;
+    cases: CaseRecord[];
+    /** Every failed, timed-out or xpass case, flattened from `cases`. */
+    failures?: FailureRecord[];
+    /** Per-tag outcome, when any spec is tagged. */
+    tag_summary?: TagSummary[];
+    /** `--covers-manifest` summary. */
+    coverage?: CoverageSummary;
+    /** `--openapi` contract summary. */
+    openapi?: OpenApiSummary;
+    /** `lxdev test --list`: the selected specs; nothing ran. */
+    listed?: ListedSpec[];
+}
+/** A spec `lxdev test --list` shows. */
+export interface ListedSpec {
+    id: string;
+    title: string;
+    file: string;
+    line: number;
+    tags: string[];
+}
+export type ProtocolReport = JsonReport;
+//# sourceMappingURL=report-types.d.ts.map

package/dist/report-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-types.d.ts","sourceRoot":"","sources":["../src/report-types.ts"],"names":[],"mappings":"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"}

package/dist/report-types.js

@@ -0,0 +1,6 @@
+/**
+ * The shapes of `report.json` and of the run protocol lxdev reads, published
+ * as `@lingxia/test/report` for tools that read a report.
+ */
+export {};
+//# sourceMappingURL=report-types.js.map

package/dist/report-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-types.js","sourceRoot":"","sources":["../src/report-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/report.d.ts

@@ -1,5 +1,19 @@
-import type { CaseRecord, JsonReport } from "./types.js";
+import type { CaseRecord, JsonReport, FailureNetworkCall, ScenarioReport, ReportError } from "./report-types.js";
 export declare function renderHtml(report: JsonReport): string;
+/**
+ * The app's last Logic network calls before the failure: when each started
+ * relative to the first, what it asked, what came back and whether a route
+ * or the real network answered.
+ */
+/** The scenario a failed spec had installed: each rule and its hits. */
+export declare function renderScenario(scenario: ScenarioReport | undefined): string;
+export declare function renderNetwork(calls: FailureNetworkCall[] | undefined): string;
+/**
+ * One line naming the failed action, the page that was current and the code,
+ * e.g. `failed at page.click [data-testid=save] on page "devices" (#a1b2) — E_PAGE_NOT_ACTIVE`.
+ * `undefined` when the failure names neither an action nor a page.
+ */
+export declare function failedAt(error: Pick<ReportError, "code" | "failedAction" | "page">): string | undefined;
 export declare function formatDuration(ms: number): string;
 interface Inlined {
     /** `data:` URL for an image. */

package/dist/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,UAAU,EACV,UAAU,EAGX,MAAM,YAAY,CAAC;AA8DpB,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAmGrD;AAwjBD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,UAAU,OAAO;IACf,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAOnF;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAMD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EAAE,GAClB,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,OAAO,CAAC,CAW3F"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,WAAW,EAGZ,MAAM,mBAAmB,CAAC;AAuE3B,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAsGrD;AAikBD;;;;GAIG;AACH,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAW3E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,SAAS,GAAG,MAAM,CA4B7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAWvG;AA8ED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,UAAU,OAAO;IACf,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAOnF;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAOD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EAAE,GAClB,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,OAAO,CAAC,CAW3F"}