@lingxia/test 0.18.0 → 0.20.0

package/dist/remote.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Function-form eval: a spec passes a function, the fixture sends its source.
+ *
+ * Both targets already accept a script string, but they classify it with
+ * different heuristics (Logic tries an expression, then a function body; the
+ * WebView awaits an expression unless it starts with a statement keyword).
+ * The script built here is one parenthesised call expression, which both read
+ * the same way, so a spec never meets either heuristic.
+ */
+export type RemoteTarget = "logic" | "page";
+/** `fn.toString()`, rejecting what cannot be re-evaluated as an expression. */
+export declare function functionSource(fn: unknown, api: string): string;
+export declare function checkJsonArgs(args: readonly unknown[], api: string): void;
+/**
+ * Logic: a direct `eval` in the runtime, so `lx` here is the runtime's
+ * recording binding and `lx.*` coverage keeps working. `getApp` and
+ * `getCurrentPages` are read defensively: a missing one must surface as
+ * `undefined` in the scope, not as a ReferenceError blamed on the spec.
+ */
+export declare function logicScript(fn: unknown, args: readonly unknown[], api?: string, result?: "strict" | "snapshot"): string;
+/** WebView: evaluated as `await (<expression>)`. */
+export declare function pageScript(fn: unknown, args: readonly unknown[], api?: string): string;
+export declare function isRetryableRemoteError(error: unknown): boolean;
+/**
+ * The usual way a function-form eval fails: it closed over something from
+ * the spec, which does not exist where it runs. Say so, keeping the original
+ * error's code and data.
+ */
+export declare function explainRemoteError(error: unknown, api: string, target: RemoteTarget): unknown;
+/** Report detail for a function-form eval: its source, whitespace-collapsed. */
+export declare function functionDetail(fn: unknown): string;
+//# sourceMappingURL=remote.d.ts.map

package/dist/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAK5C,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB/D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAEzE;AAQD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,GAAG,SAAqB,EAAE,MAAM,GAAE,QAAQ,GAAG,UAAqB,GAAG,MAAM,CAY7I;AAQD,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,GAAG,SAAoB,GAAG,MAAM,CAOjG;AAGD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CA2B7F;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAMlD"}

package/dist/remote.js

@@ -0,0 +1,117 @@
+/**
+ * Function-form eval: a spec passes a function, the fixture sends its source.
+ *
+ * Both targets already accept a script string, but they classify it with
+ * different heuristics (Logic tries an expression, then a function body; the
+ * WebView awaits an expression unless it starts with a statement keyword).
+ * The script built here is one parenthesised call expression, which both read
+ * the same way, so a spec never meets either heuristic.
+ */
+import { jsonResult } from "./json-result.js";
+const FUNCTION_SOURCE = /^\s*(?:async\s*)?(?:function\b|\(|[A-Za-z_$][\w$]*\s*=>)/;
+/** `fn.toString()`, rejecting what cannot be re-evaluated as an expression. */
+export function functionSource(fn, api) {
+    if (typeof fn !== "function") {
+        throw new TypeError(`${api} expects a function or { script }`);
+    }
+    const source = Function.prototype.toString.call(fn);
+    if (/\{\s*\[native code\]\s*\}\s*$/.test(source)) {
+        throw new TypeError(`${api}: a bound or native function has no source to send; pass an inline function`);
+    }
+    if (!FUNCTION_SOURCE.test(source)) {
+        throw new TypeError(`${api}: pass an arrow or function expression, not a method or class ` +
+            `(received ${JSON.stringify(source.slice(0, 40))})`);
+    }
+    return source;
+}
+export function checkJsonArgs(args, api) {
+    args.forEach((value, index) => jsonResult(value, api, false, `args[${index}]`));
+}
+function argsLiteral(args, api) {
+    const json = JSON.stringify(args.map((value, index) => jsonResult(value, api, false, `args[${index}]`)));
+    // JSON object keys such as __proto__ must remain data in the target realm.
+    return `JSON.parse(${JSON.stringify(json)})`;
+}
+/**
+ * Logic: a direct `eval` in the runtime, so `lx` here is the runtime's
+ * recording binding and `lx.*` coverage keeps working. `getApp` and
+ * `getCurrentPages` are read defensively: a missing one must surface as
+ * `undefined` in the scope, not as a ReferenceError blamed on the spec.
+ */
+export function logicScript(fn, args, api = "t.app.logic.eval", result = "strict") {
+    const source = functionSource(fn, api);
+    return [
+        "((__lxFn, __lxArgs, __lxResult) => Promise.resolve(__lxFn({",
+        "  lx,",
+        '  getPage: typeof __lxGetPage === "function" ? __lxGetPage : undefined,',
+        '  getApp: typeof getApp === "function" ? getApp : undefined,',
+        '  getCurrentPages: typeof getCurrentPages === "function" ? getCurrentPages : undefined,',
+        `}, ...__lxArgs)).then(value => __lxResult(value, ${JSON.stringify(api)})))(`,
+        source,
+        `, ${argsLiteral(args, api)}, ${(result === "snapshot" ? jsonSnapshot : jsonResult).toString()})`,
+    ].join("\n");
+}
+/** Page data crosses the same JSON boundary as setData. Sent as source. */
+function jsonSnapshot(value) {
+    if (value === undefined)
+        return undefined;
+    return JSON.parse(JSON.stringify(value));
+}
+/** WebView: evaluated as `await (<expression>)`. */
+export function pageScript(fn, args, api = "t.app.view.eval") {
+    const source = functionSource(fn, api);
+    return [
+        `((__lxFn, __lxArgs, __lxResult) => Promise.resolve(__lxFn({ document, window }, ...__lxArgs)).then(value => __lxResult(value, ${JSON.stringify(api)})))(`,
+        source,
+        `, ${argsLiteral(args, api)}, ${jsonResult.toString()})`,
+    ].join("\n");
+}
+const retryableRemoteErrors = new WeakSet();
+export function isRetryableRemoteError(error) {
+    return typeof error === "object" && error !== null && retryableRemoteErrors.has(error);
+}
+/**
+ * The usual way a function-form eval fails: it closed over something from
+ * the spec, which does not exist where it runs. Say so, keeping the original
+ * error's code and data.
+ */
+export function explainRemoteError(error, api, target) {
+    const message = error instanceof Error ? error.message : String(error);
+    const name = error instanceof Error ? error.name : "";
+    const remoteName = ["ReferenceError", "TypeError", "SyntaxError"].find((candidate) => name === candidate || new RegExp(`\\b${candidate}:`).test(message));
+    if (remoteName === undefined)
+        return error;
+    const where = target === "logic" ? "the app's Logic runtime" : "the page WebView";
+    const explained = new Error(remoteName === "ReferenceError"
+        ? `${message}\n${api}(fn) runs fn in ${where} from its source text, so it cannot ` +
+            "use variables, imports or helpers of the spec. Pass values as JSON " +
+            `arguments: ${api}((scope, value) => ..., value).`
+        : message);
+    // Keep programming failures recognizable to retrying reads.
+    explained.name = remoteName;
+    const details = error;
+    if (details && typeof details === "object") {
+        if (details.code !== undefined)
+            explained.code = details.code;
+        if (details.data !== undefined)
+            explained.data = details.data;
+    }
+    // A DOM null read can throw TypeError until rendering catches up; in Logic
+    // a TypeError is a programming mistake. JSON validation errors carry a
+    // marker that survives the native error string.
+    if (target === "page" && remoteName === "TypeError" && !message.includes("[E_NON_JSON_VALUE]")) {
+        retryableRemoteErrors.add(explained);
+    }
+    explained.cause = error;
+    return explained;
+}
+/** Report detail for a function-form eval: its source, whitespace-collapsed. */
+export function functionDetail(fn) {
+    try {
+        return Function.prototype.toString.call(fn).replace(/\s+/g, " ").trim();
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=remote.js.map

package/dist/remote.js.map

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

package/dist/report-extras.d.ts

@@ -0,0 +1,16 @@
+import type { CaseRecord, CoverageSummary, JsonReport, OpenApiSummary, TagSummary } from "./report-types.js";
+/** One row per tag, so a failing `live` group cannot hide a clean `routed` one. */
+export declare function renderTagSummary(rows: readonly TagSummary[] | undefined): string;
+/** Manifest ids: covered by which specs and how they fared, and the holes. */
+export declare function renderManifestCoverage(coverage: CoverageSummary | undefined): string;
+/** The `--openapi` run summary. */
+export declare function renderContract(openapi: OpenApiSummary | undefined): string;
+/** Tag chips for a case. */
+export declare function renderCaseTags(item: CaseRecord): string;
+/** Contract warnings for a case (violations already are its error). */
+export declare function renderCaseContract(item: CaseRecord): string;
+/** Extra search terms for a case. */
+export declare function caseSearchTerms(item: CaseRecord): string[];
+export declare function hasExtras(report: JsonReport): boolean;
+export declare const EXTRA_STYLE = "\ntable.tagsum { width:100%; border-collapse:collapse; font-size:13px; }\ntable.tagsum th, table.tagsum td { text-align:left; padding:5px 8px; border-bottom:1px solid var(--line); vertical-align:top; }\ntable.tagsum th { color:var(--muted); font-size:11px; text-transform:uppercase; letter-spacing:.05em; }\ntable.tagsum td.num { text-align:right; font-family:var(--mono); width:4em; }\ntable.tagsum td .mini { margin-right:4px; display:inline-block; text-decoration:none; }\ntr.row-fail td:first-child { border-left:3px solid var(--fail); }\ntr.row-ok td:first-child { border-left:3px solid var(--pass); }\n.tag-sel { color:var(--accent); }\n.muted { color:var(--muted); }\n.warn-line { color:var(--skip); margin:0 0 10px; }\nul.plain { margin:4px 0 12px; padding-left:18px; }\n.contract { margin:8px 0; }\n.contract h4, .panel-body h4 { margin:10px 0 4px; font-size:12px; color:var(--muted); text-transform:uppercase; letter-spacing:.05em; }\n";
+//# sourceMappingURL=report-extras.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report-extras.d.ts","sourceRoot":"","sources":["../src/report-extras.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAiB,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS5H,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,GAAG,MAAM,CAoBhF;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAyBpF;AAED,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAsB1E;AASD,4BAA4B;AAC5B,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGvD;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAI3D;AAED,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAE1D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAErD;AAED,eAAO,MAAM,WAAW,s7BAcvB,CAAC"}

package/dist/report-extras.js

@@ -0,0 +1,125 @@
+/**
+ * Report panels for tags, the `--covers-manifest` summary and the
+ * `--openapi` contract, kept apart from the core report renderer.
+ */
+import { escapeHtml } from "./format.js";
+function toneOf(status) {
+    if (status === "passed" || status === "xfail")
+        return "pass";
+    if (status === "skipped" || status === "not_run")
+        return "skip";
+    if (status === "uncovered")
+        return "none";
+    return "fail";
+}
+/** One row per tag, so a failing `live` group cannot hide a clean `routed` one. */
+export function renderTagSummary(rows) {
+    if (!rows || rows.length === 0)
+        return "";
+    const failing = rows.filter((row) => !row.ok).length;
+    const body = rows.map((row) => {
+        const counts = ["passed", "failed", "timeout", "xpass", "xfail", "skipped"]
+            .filter((status) => row[status] > 0)
+            .map((status) => `<span class="mini ${toneOf(status)}">${row[status]} ${status}</span>`)
+            .join("");
+        const flaky = row.flaky > 0 ? `<span class="mini skip">${row.flaky} flaky</span>` : "";
+        return `<tr class="${row.ok ? "row-ok" : "row-fail"}">
+      <td><span class="tag">${escapeHtml(row.tag)}</span></td>
+      <td class="num">${row.total}</td>
+      <td>${counts}${flaky}</td>
+    </tr>`;
+    }).join("");
+    return `<details class="panel" open>
+    <summary><span class="panel-title">By tag</span>
+      <span class="panel-sub">${rows.length} tag${rows.length === 1 ? "" : "s"}${failing > 0 ? `, ${failing} failing` : ", all passing"}</span></summary>
+    <div class="panel-body"><table class="tagsum"><thead><tr><th>tag</th><th>specs</th><th>outcome</th></tr></thead><tbody>${body}</tbody></table></div>
+  </details>`;
+}
+/** Manifest ids: covered by which specs and how they fared, and the holes. */
+export function renderManifestCoverage(coverage) {
+    if (!coverage)
+        return "";
+    const rows = coverage.ids.map((entry) => {
+        const specs = entry.specs.length === 0
+            ? `<span class="muted">no spec</span>`
+            : entry.specs.map((spec) => `<a class="mini ${toneOf(spec.status)}" href="#case-${escapeHtml(spec.id)}" title="${escapeHtml(spec.title)}">${escapeHtml(spec.id)} · ${escapeHtml(spec.status.replace("_", " "))}</a>`).join(" ");
+        return `<tr data-search="${escapeHtml(`${entry.id} ${entry.title ?? ""}`)}">
+      <td><span class="cover cover-${entry.status === "passed" ? "ok" : entry.status === "uncovered" ? "none" : entry.status === "failed" ? "claimed" : "pending"}">${escapeHtml(entry.id)}</span></td>
+      <td>${escapeHtml(entry.title ?? "")}</td>
+      <td>${specs}</td>
+    </tr>`;
+    }).join("");
+    const unknown = coverage.unknown.length > 0
+        ? `<p class="warn-line">Not in the manifest: ${coverage.unknown.map((entry) => `<code>${escapeHtml(entry.id)}</code> (${entry.specs.map(escapeHtml).join(", ")})`).join(", ")}</p>`
+        : "";
+    return `<details class="panel" open>
+    <summary><span class="panel-title">Coverage manifest</span>
+      <span class="panel-sub">${coverage.covered}/${coverage.total} ids covered · ${coverage.passing} passing · ${coverage.failing} failing · ${coverage.uncovered.length} without a spec</span></summary>
+    <div class="panel-body">
+      ${unknown}
+      <table class="tagsum"><thead><tr><th>id</th><th>title</th><th>specs</th></tr></thead><tbody>${rows}</tbody></table>
+    </div>
+  </details>`;
+}
+/** The `--openapi` run summary. */
+export function renderContract(openapi) {
+    if (!openapi)
+        return "";
+    const docs = openapi.documents.map((doc) => `<span class="chip"><b>${escapeHtml(doc.name)}</b>${escapeHtml(`${doc.title ? `${doc.title} · ` : ""}OpenAPI ${doc.version} · ${doc.operations} operations`)}</span>`).join("");
+    const skipped = Object.entries(openapi.skipped).filter(([, count]) => count > 0)
+        .map(([reason, count]) => `${count} ${reason.replace("_", " ")}`).join(", ");
+    const list = (title, items) => items.length === 0 ? "" : `<h4>${escapeHtml(title)}</h4><ul class="plain">${items.join("")}</ul>`;
+    const undocumented = list("Statuses the contract does not document", openapi.undocumented.map((entry) => `<li><code>${escapeHtml(entry.operation)} → ${entry.status}</code> <span class="muted">${escapeHtml(entry.source)} ×${entry.count}</span></li>`));
+    const unmatched = list("Requests no operation describes", openapi.unmatched.map((entry) => `<li><code>${escapeHtml(`${entry.method} ${entry.path}`)}</code> <span class="muted">×${entry.count}</span></li>`));
+    const warnings = list("Server responses that break the contract (warnings)", openapi.warnings.map((issue) => `<li>${renderIssue(issue)}</li>`));
+    const failed = openapi.routed.failed > 0;
+    return `<details class="panel"${failed || openapi.warnings.length > 0 ? " open" : ""}>
+    <summary><span class="panel-title">OpenAPI contract</span>
+      <span class="panel-sub">${openapi.validated}/${openapi.responses} responses validated · routed ${openapi.routed.validated - openapi.routed.failed}/${openapi.routed.validated} ok · server ${openapi.network.validated - openapi.network.mismatched}/${openapi.network.validated} ok${skipped ? ` · skipped: ${escapeHtml(skipped)}` : ""}</span></summary>
+    <div class="panel-body">
+      <div class="chips">${docs}</div>
+      ${warnings}${undocumented}${unmatched}
+    </div>
+  </details>`;
+}
+function renderIssue(issue) {
+    const lines = issue.issues.map((entry) => `at ${entry.path || "/"}: ${entry.message} (${entry.schema})`).join("\n");
+    return `<a href="#case-${escapeHtml(issue.case)}"><code>${escapeHtml(issue.case)}</code></a>
+    <code>${escapeHtml(`${issue.operation} → ${issue.status}`)}</code> against <code>${escapeHtml(issue.schema)}</code>
+    <pre class="message">${escapeHtml(lines)}</pre>`;
+}
+/** Tag chips for a case. */
+export function renderCaseTags(item) {
+    const tags = item.tags ?? [];
+    return tags.length === 0 ? "" : `<div class="covers">${tags.map((tag) => `<span class="tag tag-sel">#${escapeHtml(tag)}</span>`).join("")}</div>`;
+}
+/** Contract warnings for a case (violations already are its error). */
+export function renderCaseContract(item) {
+    const contract = item.contract;
+    if (!contract || contract.warnings.length === 0)
+        return "";
+    return `<div class="contract"><h4>OpenAPI warnings (server responses)</h4>${contract.warnings.map(renderIssue).join("")}</div>`;
+}
+/** Extra search terms for a case. */
+export function caseSearchTerms(item) {
+    return (item.tags ?? []).flatMap((tag) => [tag, `#${tag}`]);
+}
+export function hasExtras(report) {
+    return Boolean(report.tag_summary?.length || report.coverage || report.openapi);
+}
+export const EXTRA_STYLE = `
+table.tagsum { width:100%; border-collapse:collapse; font-size:13px; }
+table.tagsum th, table.tagsum td { text-align:left; padding:5px 8px; border-bottom:1px solid var(--line); vertical-align:top; }
+table.tagsum th { color:var(--muted); font-size:11px; text-transform:uppercase; letter-spacing:.05em; }
+table.tagsum td.num { text-align:right; font-family:var(--mono); width:4em; }
+table.tagsum td .mini { margin-right:4px; display:inline-block; text-decoration:none; }
+tr.row-fail td:first-child { border-left:3px solid var(--fail); }
+tr.row-ok td:first-child { border-left:3px solid var(--pass); }
+.tag-sel { color:var(--accent); }
+.muted { color:var(--muted); }
+.warn-line { color:var(--skip); margin:0 0 10px; }
+ul.plain { margin:4px 0 12px; padding-left:18px; }
+.contract { margin:8px 0; }
+.contract h4, .panel-body h4 { margin:10px 0 4px; font-size:12px; color:var(--muted); text-transform:uppercase; letter-spacing:.05em; }
+`;
+//# sourceMappingURL=report-extras.js.map

package/dist/report-extras.js.map

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