@tracelane/report 0.1.0-alpha.1

package/NOTICE

@@ -0,0 +1,15 @@
+rrweb-stack
+Copyright 2026 Cubenest
+
+This product includes software developed by:
+- PostHog (https://posthog.com) — vendored rrweb fork:
+    @posthog/rrweb 0.0.34 (MIT License)
+    @posthog/rrweb-types 0.0.24 (MIT License)
+  Forked from upstream rrweb-io/rrweb 2.0.0-alpha.17.
+- rrweb contributors (https://github.com/rrweb-io/rrweb) — rrweb-player:
+    rrweb-player 1.0.0-alpha.4 (MIT License) — UMD + CSS inlined into report HTML.
+- fflate (https://github.com/101arrowz/fflate) 0.8.x (MIT License) —
+    browser gunzip build inlined into report HTML for offline decompression.
+
+This product is licensed under the Apache License, Version 2.0.
+See the LICENSE file for details.

package/README.md

@@ -0,0 +1,41 @@
+# @tracelane/report
+
+The self-contained, offline HTML report builder for [`tracelane`](https://github.com/Cubenest/rrweb-stack/tree/main/packages/tracelane-core). Given a captured rrweb event stream plus test metadata, it produces a **single `.html` file** that:
+
+- opens in any browser, fully offline (no network fetch at view time);
+- embeds the [`rrweb-player`](https://www.npmjs.com/package/rrweb-player) UMD + CSS inline;
+- embeds the events as a gzipped, base64-encoded blob that is decompressed in-page with an inlined [`fflate`](https://github.com/101arrowz/fflate) gunzip;
+- renders console + network panels, a metadata header, and a "Copy as Markdown for AI paste" button.
+
+Not generally intended for direct consumption — depend on a product package (`@tracelane/wdio`) instead.
+
+## Usage
+
+```ts
+import { buildReport } from '@tracelane/report';
+
+const html = buildReport(events, {
+  spec: 'login.spec.ts',
+  title: 'logs in with valid credentials',
+  status: 'failed',
+  error: 'expected element to be visible',
+  durationMs: 4210,
+  browserName: 'chrome',
+  browserVersion: '124.0',
+  viewport: { width: 1280, height: 720 },
+  // commitSha / buildUrl auto-detected from CI env when omitted
+});
+// write `html` to ./tracelane-reports/<spec>--<title>.html
+```
+
+## Design
+
+See [P1 PRD §F](https://github.com/Cubenest/rrweb-stack/blob/main/prds/compass_artifact_wf-d53d32da-17e9-41b5-bb70-21dd1bf648c6_text_markdown.md) and [ADR-0005](https://github.com/Cubenest/rrweb-stack/blob/main/prds/adrs/0005-p1-failed-only-self-contained-html.md).
+
+- **Player:** `rrweb-player@1.0.0-alpha.4` (upstream). `@posthog/rrweb-player` was the natural lineage match for the `@cubenest/rrweb-core` substrate fork, but every published version pins an unpublished dependency (`@posthog/rrweb-packer@0.0.0`, 404) and is therefore uninstallable. Upstream `rrweb-player` descends from the same rrweb 2.x line (`2.0.0-alpha.x`) that the substrate's `@posthog/rrweb@0.0.34` was forked from (`2.0.0-alpha.17`), so the recorded event shape replays correctly.
+- **Decompression:** the build side uses `@cubenest/rrweb-core`'s `compress()` (fflate gzip); the view side inlines fflate's browser `gunzipSync` for a small (~8 KB) offline decompressor.
+- **Asset inlining:** the player UMD/CSS and the fflate gunzip source are read from `node_modules` at build time (`fs.readFileSync`) — never hand-pasted into source.
+
+## License
+
+Apache 2.0. The inlined rrweb player and fflate remain MIT-licensed; see NOTICE.

package/dist/assets.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The rrweb-player UMD bundle (~115 KB). Inlined verbatim into a top-level
+ * `<script>` in the report; its `var rrwebPlayer = (function(){…})()` IIFE then
+ * exposes `window.rrwebPlayer` for the bootstrap script to instantiate.
+ */
+export declare function loadPlayerUmd(): string;
+/**
+ * The rrweb-player stylesheet (~5 KB). Self-contained (cursor SVGs are inline
+ * data URIs), so it inlines into a `<style>` with no external fetches.
+ */
+export declare function loadPlayerCss(): string;
+/**
+ * The fflate UMD (~33 KB). Inlined into a top-level `<script>`; its UMD wrapper
+ * assigns `window.fflate` (with `gunzipSync` + `strFromU8`) so the bootstrap
+ * script can decompress the embedded event blob in-page (Task 2.9). Chosen over
+ * pako for consistency with `@cubenest/rrweb-core`'s fflate-based `compress()`.
+ */
+export declare function loadFflateGunzipSource(): string;
+//# sourceMappingURL=assets.d.ts.map

package/dist/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAqDA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/dist/assets.js

@@ -0,0 +1,73 @@
+// Build-time asset loaders (Task 2.8 + 2.9).
+//
+// The self-contained report inlines three vendored assets so it opens fully
+// offline with nothing fetched at view time:
+//   1. the rrweb-player UMD  (defines `window.rrwebPlayer`)   — Task 2.8
+//   2. the rrweb-player CSS                                    — Task 2.8
+//   3. the fflate UMD gunzip (defines `window.fflate`)         — Task 2.9
+//
+// Each is read from the installed package via `require.resolve`, NOT hand-pasted
+// into source (the assets are large and would bloat/obscure the diff, and they
+// must track the pinned dependency versions). The reads happen at report-build
+// time in Node, so they cost nothing at view time.
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+// A CJS-style require rooted at this module's location, so `require.resolve`
+// finds the dependencies through the normal node_modules resolution that pnpm
+// set up — robust to where the compiled `dist/` ends up on disk.
+const localRequire = createRequire(import.meta.url);
+function readAsset(specifier) {
+    return readFileSync(localRequire.resolve(specifier), 'utf8');
+}
+/**
+ * Resolve a UMD entry that the package's `exports` map hides behind a deep path
+ * (fflate exports only `.` / `./browser` / `./node`, so
+ * `require.resolve('fflate/umd/index.js')` is blocked). We resolve the always-
+ * exported `package.json`, read its `unpkg` (the declared CDN/UMD entry), and
+ * resolve it against the package directory's `file:` URL — `new URL` normalizes
+ * the relative path (no manual string join), and a containment check rejects a
+ * `unpkg` value that would escape the package directory.
+ */
+function readUmdViaUnpkg(packageName) {
+    const pkgJsonPath = localRequire.resolve(`${packageName}/package.json`);
+    const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf8'));
+    const unpkg = pkg.unpkg;
+    if (typeof unpkg !== 'string') {
+        throw new Error(`${packageName}: package.json has no "unpkg" UMD entry to inline`);
+    }
+    // Resolve `unpkg` relative to the package.json file URL (its last segment is
+    // replaced), then re-derive a normalized path.
+    const pkgDirUrl = pathToFileURL(pkgJsonPath.slice(0, pkgJsonPath.lastIndexOf('/') + 1));
+    const assetPath = fileURLToPath(new URL(unpkg, pkgDirUrl));
+    const pkgDirPath = fileURLToPath(pkgDirUrl);
+    if (!assetPath.startsWith(pkgDirPath)) {
+        throw new Error(`${packageName}: "unpkg" entry escapes the package directory`);
+    }
+    return readFileSync(assetPath, 'utf8');
+}
+/**
+ * The rrweb-player UMD bundle (~115 KB). Inlined verbatim into a top-level
+ * `<script>` in the report; its `var rrwebPlayer = (function(){…})()` IIFE then
+ * exposes `window.rrwebPlayer` for the bootstrap script to instantiate.
+ */
+export function loadPlayerUmd() {
+    return readAsset('rrweb-player/dist/index.js');
+}
+/**
+ * The rrweb-player stylesheet (~5 KB). Self-contained (cursor SVGs are inline
+ * data URIs), so it inlines into a `<style>` with no external fetches.
+ */
+export function loadPlayerCss() {
+    return readAsset('rrweb-player/dist/style.css');
+}
+/**
+ * The fflate UMD (~33 KB). Inlined into a top-level `<script>`; its UMD wrapper
+ * assigns `window.fflate` (with `gunzipSync` + `strFromU8`) so the bootstrap
+ * script can decompress the embedded event blob in-page (Task 2.9). Chosen over
+ * pako for consistency with `@cubenest/rrweb-core`'s fflate-based `compress()`.
+ */
+export function loadFflateGunzipSource() {
+    return readUmdViaUnpkg('fflate');
+}
+//# sourceMappingURL=assets.js.map

package/dist/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,4EAA4E;AAC5E,6CAA6C;AAC7C,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,+EAA+E;AAC/E,mDAAmD;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,6EAA6E;AAC7E,8EAA8E;AAC9E,iEAAiE;AACjE,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEpD,SAAS,SAAS,CAAC,SAAiB;IAClC,OAAO,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CAAC,WAAmB;IAC1C,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAuB,CAAC;IAChF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,mDAAmD,CAAC,CAAC;IACrF,CAAC;IACD,6EAA6E;IAC7E,+CAA+C;IAC/C,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,+CAA+C,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC,4BAA4B,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC,6BAA6B,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/dist/build-report.d.ts

@@ -0,0 +1,19 @@
+import type { eventWithTime } from '@cubenest/rrweb-core';
+import type { ReportMeta } from './types.js';
+/** Options for {@link buildReport}. */
+export interface BuildReportOptions {
+    /**
+     * Prune events to the 25 MB budget before embedding (ADR-0005). Default true.
+     * Pass `false` only when the caller has already applied the size guard.
+     */
+    enforceSizeBudget?: boolean;
+}
+/**
+ * Build a self-contained HTML report for one test run.
+ *
+ * @param events  the captured rrweb event stream (chronological)
+ * @param meta    test metadata; CI provenance is auto-filled from the env
+ * @returns a complete `.html` document string — write it to disk as-is
+ */
+export declare function buildReport(events: eventWithTime[], meta: ReportMeta, options?: BuildReportOptions): string;
+//# sourceMappingURL=build-report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-report.d.ts","sourceRoot":"","sources":["../src/build-report.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EAAE,EACvB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAsBR"}

package/dist/build-report.js

@@ -0,0 +1,49 @@
+// buildReport — the package entry point.
+//
+// Given a captured rrweb event stream + test metadata, produce a single,
+// self-contained, offline HTML report string (P1 PRD §F). Orchestration only;
+// each concern lives in its own module:
+//   • size-budget prune ............ @tracelane/core (pruneToSizeBudget)
+//   • events → gzip → base64 ....... embed.ts        (Task 2.9)
+//   • console / network extraction . panels.ts       (Task 2.10)
+//   • CI metadata + header ......... metadata.ts     (Task 2.11)
+//   • copy-as-markdown payload ..... markdown.ts     (Task 2.12)
+//   • HTML composition ............. template.ts
+//
+// The size guard reuses @tracelane/core's pruneToSizeBudget so the report never
+// exceeds the 25 MB budget (ADR-0005); the report renders a banner when a prune
+// fired so the truncation is visible to the user.
+import { pruneToSizeBudget } from '@tracelane/core';
+import { encodeEventsBlob } from './embed.js';
+import { buildMarkdown, extractActionLog } from './markdown.js';
+import { resolveCiMetadata } from './metadata.js';
+import { extractConsole, extractNetwork } from './panels.js';
+import { renderReportHtml } from './template.js';
+/**
+ * Build a self-contained HTML report for one test run.
+ *
+ * @param events  the captured rrweb event stream (chronological)
+ * @param meta    test metadata; CI provenance is auto-filled from the env
+ * @returns a complete `.html` document string — write it to disk as-is
+ */
+export function buildReport(events, meta, options = {}) {
+    const { enforceSizeBudget = true } = options;
+    // Keep the report within budget; surface a banner if anything was dropped.
+    const { events: sized, pruned } = enforceSizeBudget
+        ? pruneToSizeBudget(events)
+        : { events, pruned: false };
+    const resolvedMeta = resolveCiMetadata(meta);
+    const consoleRows = extractConsole(sized);
+    const networkRows = extractNetwork(sized);
+    const actions = extractActionLog(sized);
+    const markdown = buildMarkdown(resolvedMeta, consoleRows, networkRows, actions);
+    return renderReportHtml({
+        meta: resolvedMeta,
+        eventsGzB64: encodeEventsBlob(sized),
+        console: consoleRows,
+        network: networkRows,
+        markdown,
+        pruned,
+    });
+}
+//# sourceMappingURL=build-report.js.map

package/dist/build-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-report.js","sourceRoot":"","sources":["../src/build-report.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,wCAAwC;AACxC,yEAAyE;AACzE,gEAAgE;AAChE,iEAAiE;AACjE,iEAAiE;AACjE,iEAAiE;AACjE,iDAAiD;AACjD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,kDAAkD;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYjD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,MAAuB,EACvB,IAAgB,EAChB,UAA8B,EAAE;IAEhC,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE7C,2EAA2E;IAC3E,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,iBAAiB;QACjD,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAC3B,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAE9B,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAEhF,OAAO,gBAAgB,CAAC;QACtB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC;QACpC,OAAO,EAAE,WAAW;QACpB,OAAO,EAAE,WAAW;QACpB,QAAQ;QACR,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/embed.d.ts

@@ -0,0 +1,14 @@
+import type { eventWithTime } from '@cubenest/rrweb-core';
+/**
+ * Encode an rrweb event array to the base64-of-gzip string embedded in the
+ * report as `EVENTS_GZ_B64`. The string uses only the standard base64 alphabet,
+ * so it is safe inside a double-quoted JS string literal in the HTML.
+ */
+export declare function encodeEventsBlob(events: eventWithTime[]): string;
+/**
+ * Decode the embedded blob back to the event array. Node-side mirror of the
+ * in-page decompress path; used for the build→embed→decode round-trip test and
+ * available to consumers that want to re-read a report's events.
+ */
+export declare function decodeEventsBlob(b64: string): eventWithTime[];
+//# sourceMappingURL=embed.d.ts.map

package/dist/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA2B1D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAE7D"}

package/dist/embed.js

@@ -0,0 +1,51 @@
+// Events blob embedding (Task 2.9).
+//
+// The pipeline:   events --JSON--> gzip (@cubenest/rrweb-core.compress)
+//                        --base64--> EVENTS_GZ_B64 string in the report.
+//
+// At view time the inlined fflate gunzips the decoded bytes and JSON.parses
+// them — so the report decompresses fully offline (Task 2.9). The wire format
+// is deliberately interoperable with the substrate's compress/decompress pair:
+// base64(compress(events)) on the way in, decompress(base64-decode) on the way
+// out. `decodeEventsBlob` here mirrors what the in-page bootstrap does, and the
+// round-trip is asserted in tests.
+import { compress, decompress } from '@cubenest/rrweb-core';
+// Base64 in 8 KB chunks: `btoa(String.fromCharCode(...all))` overflows the call
+// stack on multi-MB reports (events can approach the 25 MB cap). `btoa` is a
+// web standard available in both Node (16+) and the browser/jsdom.
+const CHUNK = 0x8000;
+/** base64-encode raw bytes without a Buffer dependency or a stack-blowing spread. */
+function bytesToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i += CHUNK) {
+        const slice = bytes.subarray(i, i + CHUNK);
+        binary += String.fromCharCode(...slice);
+    }
+    return btoa(binary);
+}
+/** Inverse of {@link bytesToBase64}. */
+function base64ToBytes(b64) {
+    const binary = atob(b64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Encode an rrweb event array to the base64-of-gzip string embedded in the
+ * report as `EVENTS_GZ_B64`. The string uses only the standard base64 alphabet,
+ * so it is safe inside a double-quoted JS string literal in the HTML.
+ */
+export function encodeEventsBlob(events) {
+    return bytesToBase64(compress(events));
+}
+/**
+ * Decode the embedded blob back to the event array. Node-side mirror of the
+ * in-page decompress path; used for the build→embed→decode round-trip test and
+ * available to consumers that want to re-read a report's events.
+ */
+export function decodeEventsBlob(b64) {
+    return decompress(base64ToBytes(b64));
+}
+//# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,mCAAmC;AAEnC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG5D,gFAAgF;AAChF,6EAA6E;AAC7E,mEAAmE;AACnE,MAAM,KAAK,GAAG,MAAM,CAAC;AAErB,qFAAqF;AACrF,SAAS,aAAa,CAAC,KAAiB;IACtC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;QAC3C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,wCAAwC;AACxC,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/html.d.ts

@@ -0,0 +1,10 @@
+/** HTML-escape a string for safe interpolation into element text / attributes. */
+export declare function escapeHtml(value: string): string;
+/**
+ * Serialize a value to JSON safe to embed inside an inline `<script>`. Escapes
+ * `<` (covers `</script>` and `<!--`) and the U+2028/U+2029 line terminators
+ * that are illegal in JS string literals. The result is valid JSON that direct
+ * JS evaluation (or `JSON.parse`) reads back intact.
+ */
+export declare function serializeForScript(value: unknown): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAWA,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKzD"}

package/dist/html.js

@@ -0,0 +1,32 @@
+// Small HTML/JSON escaping helpers for safe report composition.
+//
+// Two distinct hazards are handled:
+//   1. User/test metadata rendered as HTML text (titles, errors, console
+//      messages) must be HTML-escaped so a `<` in an error message can't inject
+//      markup — see {@link escapeHtml}.
+//   2. JSON embedded inside an inline `<script>` must have its `</` sequences
+//      neutralised so a `</script>` inside string data can't terminate the
+//      script element early (the classic inline-JSON XSS) — see
+//      {@link serializeForScript}.
+/** HTML-escape a string for safe interpolation into element text / attributes. */
+export function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * Serialize a value to JSON safe to embed inside an inline `<script>`. Escapes
+ * `<` (covers `</script>` and `<!--`) and the U+2028/U+2029 line terminators
+ * that are illegal in JS string literals. The result is valid JSON that direct
+ * JS evaluation (or `JSON.parse`) reads back intact.
+ */
+export function serializeForScript(value) {
+    return JSON.stringify(value)
+        .replace(/</g, '\\u003c')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,oCAAoC;AACpC,yEAAyE;AACzE,gFAAgF;AAChF,wCAAwC;AACxC,8EAA8E;AAC9E,2EAA2E;AAC3E,gEAAgE;AAChE,mCAAmC;AAEnC,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SACzB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;SAC7B,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { buildReport } from './build-report.js';
+export type { BuildReportOptions } from './build-report.js';
+export type { ReportMeta, ReportStatus, Viewport } from './types.js';
+export { decodeEventsBlob, encodeEventsBlob } from './embed.js';
+export { extractConsole, extractNetwork, CONSOLE_PLUGIN, NETWORK_EVENT_TAG, NETWORK_CONSOLE_PREFIX, } from './panels.js';
+export type { ConsoleEntry, NetworkEntry } from './panels.js';
+export { resolveCiMetadata } from './metadata.js';
+export { buildMarkdown, extractActionLog, MAX_CONSOLE_MESSAGES, MAX_ACTIONS } from './markdown.js';
+export type { ActionEntry } from './markdown.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACnG,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// Public API surface for @tracelane/report.
+// The report builder: events + metadata -> self-contained offline HTML string.
+export { buildReport } from './build-report.js';
+// Events blob round-trip (Task 2.9) — useful for re-reading a report's events.
+export { decodeEventsBlob, encodeEventsBlob } from './embed.js';
+// Console + network panel extraction (Task 2.10).
+export { extractConsole, extractNetwork, CONSOLE_PLUGIN, NETWORK_EVENT_TAG, NETWORK_CONSOLE_PREFIX, } from './panels.js';
+// CI metadata resolution (Task 2.11).
+export { resolveCiMetadata } from './metadata.js';
+// Copy-as-Markdown payload (Task 2.12).
+export { buildMarkdown, extractActionLog, MAX_CONSOLE_MESSAGES, MAX_ACTIONS } from './markdown.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE,kDAAkD;AAClD,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,sCAAsC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,22 @@
+import type { eventWithTime } from '@cubenest/rrweb-core';
+import type { ConsoleEntry, NetworkEntry } from './panels.js';
+import type { ReportMeta } from './types.js';
+/** Max console messages included in the prompt (P1 PRD §F.3: "last 30"). */
+export declare const MAX_CONSOLE_MESSAGES = 30;
+/** Max user actions included in the "steps before failure" section. */
+export declare const MAX_ACTIONS = 20;
+/** One human-readable user action derived from the rrweb stream. */
+export interface ActionEntry {
+    description: string;
+    timestamp: number;
+}
+/**
+ * Walk the event stream for discrete user actions: meaningful mouse
+ * interactions (clicks/taps/focus, not raw moves), text input, and
+ * `tracelane.nav` navigation boundaries. Mouse-move / scroll noise is excluded —
+ * the prompt wants the semantic steps a human or AI would narrate.
+ */
+export declare function extractActionLog(events: readonly eventWithTime[]): ActionEntry[];
+/** Build the Markdown prompt (P1 PRD §F.3). */
+export declare function buildMarkdown(meta: ReportMeta, consoleRows: readonly ConsoleEntry[], networkRows: readonly NetworkEntry[], actions: readonly ActionEntry[]): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,uEAAuE;AACvE,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAqBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,WAAW,EAAE,CAsBhF;AAMD,+CAA+C;AAC/C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,SAAS,YAAY,EAAE,EACpC,WAAW,EAAE,SAAS,YAAY,EAAE,EACpC,OAAO,EAAE,SAAS,WAAW,EAAE,GAC9B,MAAM,CA4CR"}

package/dist/markdown.js

@@ -0,0 +1,101 @@
+// "Copy as Markdown for AI paste" payload (Task 2.12 / P1 PRD §F.3).
+//
+// Emits the structured prompt that is the product differentiator: failing-test
+// metadata, the last 30 console messages, failed network requests, and the
+// user-action log just before the failure. Built at report-build time and
+// embedded as the `MARKDOWN` const the copy button writes to the clipboard.
+import { EventType, IncrementalSource, MouseInteractions } from '@cubenest/rrweb-core';
+/** Max console messages included in the prompt (P1 PRD §F.3: "last 30"). */
+export const MAX_CONSOLE_MESSAGES = 30;
+/** Max user actions included in the "steps before failure" section. */
+export const MAX_ACTIONS = 20;
+const MOUSE_INTERACTION_LABEL = {
+    [MouseInteractions.Click]: 'Click',
+    [MouseInteractions.DblClick]: 'Double-click',
+    [MouseInteractions.ContextMenu]: 'Right-click',
+    [MouseInteractions.Focus]: 'Focus',
+    [MouseInteractions.Blur]: 'Blur',
+    [MouseInteractions.TouchStart]: 'Touch',
+    [MouseInteractions.TouchEnd]: 'Touch end',
+};
+/**
+ * Walk the event stream for discrete user actions: meaningful mouse
+ * interactions (clicks/taps/focus, not raw moves), text input, and
+ * `tracelane.nav` navigation boundaries. Mouse-move / scroll noise is excluded —
+ * the prompt wants the semantic steps a human or AI would narrate.
+ */
+export function extractActionLog(events) {
+    const actions = [];
+    for (const e of events) {
+        if (e.type === EventType.Custom) {
+            const data = e.data;
+            if (data.tag === 'tracelane.nav') {
+                const url = typeof data.payload?.url === 'string' ? data.payload.url : '(unknown)';
+                actions.push({ description: `Navigate to ${url}`, timestamp: e.timestamp });
+            }
+            continue;
+        }
+        if (e.type !== EventType.IncrementalSnapshot)
+            continue;
+        const data = e.data;
+        if (data.source === IncrementalSource.MouseInteraction) {
+            const kind = typeof data.type === 'number' ? data.type : -1;
+            const label = MOUSE_INTERACTION_LABEL[kind];
+            if (label)
+                actions.push({ description: label, timestamp: e.timestamp });
+        }
+        else if (data.source === IncrementalSource.Input) {
+            actions.push({ description: 'Input text', timestamp: e.timestamp });
+        }
+    }
+    return actions;
+}
+function bullet(line) {
+    return `- ${line}`;
+}
+/** Build the Markdown prompt (P1 PRD §F.3). */
+export function buildMarkdown(meta, consoleRows, networkRows, actions) {
+    const out = [];
+    out.push('## Failing test');
+    out.push(bullet(`Spec: ${meta.spec ?? '(unknown)'}`));
+    out.push(bullet(`Title: ${meta.title}`));
+    out.push(bullet(`Status: ${meta.status}`));
+    if (meta.browserName) {
+        out.push(bullet(`Browser: ${[meta.browserName, meta.browserVersion].filter(Boolean).join(' ')}`));
+    }
+    if (meta.commitSha)
+        out.push(bullet(`Commit: ${meta.commitSha}`));
+    if (meta.error)
+        out.push(bullet(`Error: ${meta.error}`));
+    out.push('');
+    const lastConsole = consoleRows.slice(-MAX_CONSOLE_MESSAGES);
+    out.push(`## Last ${lastConsole.length} console messages`);
+    if (lastConsole.length === 0) {
+        out.push('_None captured._');
+    }
+    else {
+        for (const c of lastConsole)
+            out.push(bullet(`[${c.level}] ${c.message}`));
+    }
+    out.push('');
+    out.push('## Failed network requests');
+    if (networkRows.length === 0) {
+        out.push('_None captured._');
+    }
+    else {
+        for (const n of networkRows) {
+            out.push(bullet(`${n.status} ${n.method ? `${n.method} ` : ''}${n.url}`));
+        }
+    }
+    out.push('');
+    const lastActions = actions.slice(-MAX_ACTIONS);
+    out.push('## Steps just before failure (rrweb action log)');
+    if (lastActions.length === 0) {
+        out.push('_No user actions captured._');
+    }
+    else {
+        lastActions.forEach((a, i) => out.push(`${i + 1}. ${a.description}`));
+    }
+    return `${out.join('\n')}\n`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/metadata.d.ts

@@ -0,0 +1,9 @@
+import type { ReportMeta } from './types.js';
+/**
+ * Return `meta` with `commitSha` / `buildUrl` filled from the environment when
+ * absent. Explicit values always win; auto-detection only fills gaps.
+ */
+export declare function resolveCiMetadata(meta: ReportMeta): ReportMeta;
+/** Render the metadata header markup (P1 PRD §F.1). */
+export declare function renderMetaHeader(meta: ReportMeta): string;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA4B7C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAQ9D;AA8BD,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA2BzD"}

package/dist/metadata.js

@@ -0,0 +1,105 @@
+// Metadata header (Task 2.11).
+//
+// Two responsibilities:
+//   • resolveCiMetadata — fill commit SHA + build URL from CI env vars when the
+//     caller didn't supply them (GITHUB_SHA / CI_COMMIT_SHA, and common build
+//     URL conventions for GitHub Actions + GitLab CI).
+//   • renderMetaHeader — the <header class="meta"> markup (spec, title, status,
+//     duration, browser, viewport, commit, build URL), HTML-escaped.
+import { escapeHtml } from './html.js';
+/** Read an env var without a hard `@types/node` dependency (platform-light). */
+function readEnv(name) {
+    const proc = globalThis.process;
+    return proc?.env?.[name];
+}
+/** First defined, non-empty env value among `names`. */
+function firstEnv(names) {
+    for (const name of names) {
+        const v = readEnv(name);
+        if (v !== undefined && v !== '')
+            return v;
+    }
+    return undefined;
+}
+/** Derive a CI build/run URL from common provider env vars. */
+function detectBuildUrl() {
+    // GitHub Actions: assemble the run URL from the documented pieces.
+    const server = readEnv('GITHUB_SERVER_URL');
+    const repo = readEnv('GITHUB_REPOSITORY');
+    const runId = readEnv('GITHUB_RUN_ID');
+    if (server && repo && runId)
+        return `${server}/${repo}/actions/runs/${runId}`;
+    // GitLab CI exposes the job URL directly.
+    return firstEnv(['CI_JOB_URL', 'CI_PIPELINE_URL', 'BUILD_URL']);
+}
+/**
+ * Return `meta` with `commitSha` / `buildUrl` filled from the environment when
+ * absent. Explicit values always win; auto-detection only fills gaps.
+ */
+export function resolveCiMetadata(meta) {
+    const commitSha = meta.commitSha ?? firstEnv(['GITHUB_SHA', 'CI_COMMIT_SHA']);
+    const buildUrl = meta.buildUrl ?? detectBuildUrl();
+    return {
+        ...meta,
+        ...(commitSha !== undefined ? { commitSha } : {}),
+        ...(buildUrl !== undefined ? { buildUrl } : {}),
+    };
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms} ms`;
+    const s = ms / 1000;
+    if (s < 60)
+        return `${s.toFixed(s < 10 ? 2 : 1)} s`;
+    const m = Math.floor(s / 60);
+    return `${m}m ${Math.round(s - m * 60)}s`;
+}
+function row(term, value) {
+    return `<dt>${escapeHtml(term)}</dt><dd>${value}</dd>`;
+}
+/**
+ * Whether `url` is safe to use as an `href`. Only http(s) — blocks `javascript:`,
+ * `data:`, `vbscript:` etc. The build URL is sourced from CI env vars
+ * (CI_JOB_URL / BUILD_URL), which a hostile or misconfigured CI could set, so a
+ * crafted `javascript:` value must never become a clickable link in the saved
+ * report's origin. (HTML-escaping alone doesn't help — `javascript:alert(1)`
+ * has none of the escaped characters.)
+ */
+function isSafeUrl(url) {
+    try {
+        return /^https?:$/i.test(new URL(url).protocol);
+    }
+    catch {
+        return false;
+    }
+}
+/** Render the metadata header markup (P1 PRD §F.1). */
+export function renderMetaHeader(meta) {
+    const rows = [];
+    if (meta.spec)
+        rows.push(row('Spec', escapeHtml(meta.spec)));
+    if (meta.durationMs !== undefined)
+        rows.push(row('Duration', escapeHtml(formatDuration(meta.durationMs))));
+    const browser = [meta.browserName, meta.browserVersion].filter(Boolean).join(' ');
+    if (browser)
+        rows.push(row('Browser', escapeHtml(browser)));
+    if (meta.viewport) {
+        rows.push(row('Viewport', escapeHtml(`${meta.viewport.width} × ${meta.viewport.height}`)));
+    }
+    if (meta.commitSha)
+        rows.push(row('Commit', `<code>${escapeHtml(meta.commitSha)}</code>`));
+    if (meta.buildUrl) {
+        const escaped = escapeHtml(meta.buildUrl);
+        // Only render a clickable link for http(s); a non-http(s) URL (e.g. a
+        // crafted `javascript:`) is shown as escaped text with no href.
+        const value = isSafeUrl(meta.buildUrl) ? `<a href="${escaped}">${escaped}</a>` : escaped;
+        rows.push(row('Build', value));
+    }
+    const error = meta.error ? `<div class="error">${escapeHtml(meta.error)}</div>` : '';
+    return `<header class="meta">
+<h1>${escapeHtml(meta.title)} <span class="status ${escapeHtml(meta.status)}">${escapeHtml(meta.status)}</span></h1>
+${rows.length ? `<dl>${rows.join('')}</dl>` : ''}
+${error}
+</header>`;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

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

package/dist/panels.d.ts

@@ -0,0 +1,32 @@
+import type { eventWithTime } from '@cubenest/rrweb-core';
+/** A console panel row. */
+export interface ConsoleEntry {
+    level: string;
+    message: string;
+    timestamp: number;
+}
+/** A network-error panel row. */
+export interface NetworkEntry {
+    method?: string;
+    url: string;
+    status: number;
+    timestamp: number;
+}
+/** rrweb console plugin tag (P1 PRD §F.3). */
+export declare const CONSOLE_PLUGIN = "rrweb/console@1";
+/** Custom-event tag for the v1.1 rich network path (P1 PRD §E.3). */
+export declare const NETWORK_EVENT_TAG = "tracelane.test.network-error";
+/** console.error prefix for the v1 network fallback (P1 PRD §E.2). */
+export declare const NETWORK_CONSOLE_PREFIX = "[tracelane.net]";
+/**
+ * Extract console rows: EventType.Plugin events emitted by the rrweb console
+ * plugin. The plugin nests the level + serialized args under `data.payload`.
+ */
+export declare function extractConsole(events: readonly eventWithTime[]): ConsoleEntry[];
+/**
+ * Extract network-error rows. Prefers the v1.1 custom-event path
+ * (EventType.Custom, tag 'tracelane.test.network-error'); when none are present,
+ * falls back to scraping console.error lines prefixed '[tracelane.net]' (v1).
+ */
+export declare function extractNetwork(events: readonly eventWithTime[]): NetworkEntry[];
+//# sourceMappingURL=panels.d.ts.map

package/dist/panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,2BAA2B;AAC3B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8CAA8C;AAC9C,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAChD,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAChE,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAkDxD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,YAAY,EAAE,CAW/E;AAkBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,YAAY,EAAE,CA2B/E"}

package/dist/panels.js

@@ -0,0 +1,125 @@
+// Console + network panel extraction (Task 2.10).
+//
+// Pure, build-time functions that walk the rrweb event stream and produce the
+// compact row arrays embedded into the report (the in-page bootstrap only
+// renders them — no event filtering happens in the browser). Extracting at
+// build time keeps all the parsing logic unit-testable and the runtime thin.
+//
+// Sources (P1 PRD §F.3 / §E.2):
+//   • Console — EventType.Plugin (6) with data.plugin === 'rrweb/console@1'.
+//   • Network — EventType.Custom (5) with data.tag === 'tracelane.test.network-error'
+//     (the v1.1 rich path); falls back to scraping console.error messages
+//     prefixed '[tracelane.net]' (the v1 path) when no custom events exist.
+import { EventType } from '@cubenest/rrweb-core';
+/** rrweb console plugin tag (P1 PRD §F.3). */
+export const CONSOLE_PLUGIN = 'rrweb/console@1';
+/** Custom-event tag for the v1.1 rich network path (P1 PRD §E.3). */
+export const NETWORK_EVENT_TAG = 'tracelane.test.network-error';
+/** console.error prefix for the v1 network fallback (P1 PRD §E.2). */
+export const NETWORK_CONSOLE_PREFIX = '[tracelane.net]';
+function isPlugin(e) {
+    return e.type === EventType.Plugin;
+}
+function isCustom(e) {
+    return e.type === EventType.Custom;
+}
+/** Coerce an arbitrary console-arg payload into a flat display string. */
+function stringifyArgs(payload) {
+    if (Array.isArray(payload)) {
+        return payload
+            .map((a) => (typeof a === 'string' ? stripQuotes(a) : safeStringify(a)))
+            .join(' ');
+    }
+    return typeof payload === 'string' ? payload : safeStringify(payload);
+}
+// The console plugin serializes string args as JSON (so they arrive quoted,
+// e.g. '"hello"'); unwrap a single layer of quoting for readability.
+function stripQuotes(s) {
+    if (s.length >= 2 && s[0] === '"' && s[s.length - 1] === '"') {
+        try {
+            const parsed = JSON.parse(s);
+            if (typeof parsed === 'string')
+                return parsed;
+        }
+        catch {
+            // not JSON — fall through
+        }
+    }
+    return s;
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Extract console rows: EventType.Plugin events emitted by the rrweb console
+ * plugin. The plugin nests the level + serialized args under `data.payload`.
+ */
+export function extractConsole(events) {
+    const rows = [];
+    for (const e of events) {
+        if (!isPlugin(e))
+            continue;
+        const data = e.data;
+        if (data.plugin !== CONSOLE_PLUGIN)
+            continue;
+        const level = typeof data.payload?.level === 'string' ? data.payload.level : 'log';
+        const message = stringifyArgs(data.payload?.payload);
+        rows.push({ level, message, timestamp: e.timestamp });
+    }
+    return rows;
+}
+/** Parse a '[tracelane.net] <METHOD> <STATUS> <URL>' console line, if it is one. */
+function parseNetConsoleLine(message, timestamp) {
+    const idx = message.indexOf(NETWORK_CONSOLE_PREFIX);
+    if (idx === -1)
+        return undefined;
+    const rest = message.slice(idx + NETWORK_CONSOLE_PREFIX.length).trim();
+    // "GET 404 https://…"  or  "404 https://…"
+    const m = rest.match(/^(?:([A-Z]+)\s+)?(\d{3})\s+(\S+)/);
+    if (!m)
+        return undefined;
+    return {
+        ...(m[1] !== undefined ? { method: m[1] } : {}),
+        status: Number(m[2]),
+        url: m[3] ?? '',
+        timestamp,
+    };
+}
+/**
+ * Extract network-error rows. Prefers the v1.1 custom-event path
+ * (EventType.Custom, tag 'tracelane.test.network-error'); when none are present,
+ * falls back to scraping console.error lines prefixed '[tracelane.net]' (v1).
+ */
+export function extractNetwork(events) {
+    const rich = [];
+    for (const e of events) {
+        if (!isCustom(e))
+            continue;
+        const data = e.data;
+        if (data.tag !== NETWORK_EVENT_TAG)
+            continue;
+        const p = (data.payload ?? {});
+        rich.push({
+            ...(typeof p.method === 'string' ? { method: p.method } : {}),
+            url: typeof p.url === 'string' ? p.url : '',
+            status: typeof p.status === 'number' ? p.status : 0,
+            timestamp: e.timestamp,
+        });
+    }
+    if (rich.length > 0)
+        return rich;
+    // v1 fallback: scrape the console.
+    const scraped = [];
+    for (const row of extractConsole(events)) {
+        const parsed = parseNetConsoleLine(row.message, row.timestamp);
+        if (parsed)
+            scraped.push(parsed);
+    }
+    return scraped;
+}
+//# sourceMappingURL=panels.js.map

package/dist/panels.js.map

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

package/dist/template.d.ts

@@ -0,0 +1,19 @@
+import type { ConsoleEntry, NetworkEntry } from './panels.js';
+import type { ReportMeta } from './types.js';
+/** Everything `renderReportHtml` needs; build-report.ts prepares it. */
+export interface ReportTemplateData {
+    meta: ReportMeta;
+    /** base64(gzip(events)) — decompressed in-page for the player. */
+    eventsGzB64: string;
+    /** Extracted console panel rows (Task 2.10). */
+    console: ConsoleEntry[];
+    /** Extracted network panel rows (Task 2.10). */
+    network: NetworkEntry[];
+    /** Pre-rendered "Copy as Markdown for AI paste" payload (Task 2.12). */
+    markdown: string;
+    /** Whether the events were pruned to fit the size budget (ADR-0005 banner). */
+    pruned: boolean;
+}
+/** Compose the full self-contained HTML document. */
+export declare function renderReportHtml(data: ReportTemplateData): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,gDAAgD;IAChD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAC;CACjB;AA6GD,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CA4CjE"}

package/dist/template.js

@@ -0,0 +1,158 @@
+// HTML composition for the self-contained report (P1 PRD §F.1).
+//
+// `renderReportHtml` assembles the single-file document from already-prepared
+// pieces (the caller — build-report.ts — does the extraction + encoding). This
+// module owns the static shell: the report CSS, the metadata header markup, the
+// panel containers, and the in-page bootstrap script. The large vendored assets
+// (player UMD/CSS, fflate UMD) and the data payloads are passed in.
+import { loadFflateGunzipSource, loadPlayerCss, loadPlayerUmd } from './assets.js';
+import { escapeHtml, serializeForScript } from './html.js';
+import { renderMetaHeader } from './metadata.js';
+/** Report shell CSS (~ a few KB). Kept terse; no external fonts or assets. */
+const SHELL_CSS = `
+:root { color-scheme: light dark; --fg:#1a1a1a; --bg:#fff; --muted:#666; --border:#e2e2e2; --accent:#2563eb; --err:#dc2626; --warn:#d97706; --panel:#fafafa; }
+@media (prefers-color-scheme: dark){ :root { --fg:#e6e6e6; --bg:#161616; --muted:#9a9a9a; --border:#2c2c2c; --accent:#60a5fa; --err:#f87171; --warn:#fbbf24; --panel:#1e1e1e; } }
+* { box-sizing: border-box; }
+body { margin:0; font:14px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif; color:var(--fg); background:var(--bg); }
+header.meta { padding:12px 16px; border-bottom:1px solid var(--border); }
+header.meta h1 { margin:0 0 6px; font-size:16px; }
+header.meta .status { display:inline-block; padding:1px 8px; border-radius:10px; font-size:12px; font-weight:600; text-transform:uppercase; }
+header.meta .status.failed,header.meta .status.broken { background:var(--err); color:#fff; }
+header.meta .status.passed { background:#16a34a; color:#fff; }
+header.meta .status.skipped { background:var(--muted); color:#fff; }
+header.meta dl { display:grid; grid-template-columns:max-content 1fr; gap:2px 12px; margin:8px 0 0; font-size:13px; }
+header.meta dt { color:var(--muted); }
+header.meta dd { margin:0; word-break:break-word; }
+header.meta .error { margin-top:8px; padding:8px; border-left:3px solid var(--err); background:var(--panel); white-space:pre-wrap; font-family:ui-monospace,SFMono-Regular,Menlo,monospace; font-size:12px; }
+.banner { padding:6px 16px; background:var(--warn); color:#1a1a1a; font-size:13px; }
+.toolbar { padding:8px 16px; border-bottom:1px solid var(--border); }
+button.copy-md { font:inherit; padding:6px 12px; border:1px solid var(--accent); background:var(--accent); color:#fff; border-radius:6px; cursor:pointer; }
+button.copy-md:active { opacity:.8; }
+main { display:flex; gap:0; align-items:stretch; min-height:60vh; }
+#player { flex:1 1 auto; min-width:0; padding:12px; overflow:auto; }
+aside#panels { flex:0 0 360px; border-left:1px solid var(--border); display:flex; flex-direction:column; overflow:hidden; }
+aside#panels section { display:flex; flex-direction:column; min-height:0; flex:1 1 50%; }
+aside#panels h2 { margin:0; padding:8px 12px; font-size:13px; background:var(--panel); border-bottom:1px solid var(--border); position:sticky; top:0; }
+.rows { overflow:auto; font-family:ui-monospace,SFMono-Regular,Menlo,monospace; font-size:12px; }
+.row { padding:4px 12px; border-bottom:1px solid var(--border); white-space:pre-wrap; word-break:break-word; }
+.row.error { color:var(--err); } .row.warn { color:var(--warn); }
+.row .lvl { font-weight:600; margin-right:6px; }
+.row .st { font-weight:600; margin-right:6px; } .row .st4,.row .st5 { color:var(--err); }
+.empty { padding:12px; color:var(--muted); font-style:italic; }
+`;
+/**
+ * The in-page bootstrap (runs at view time, plain ES5-ish JS so it executes in
+ * any browser without a build step). Reads the embedded payloads, decompresses
+ * the events with the inlined fflate, mounts rrweb-player, renders the panels,
+ * and wires the copy-as-markdown button. Authored as a single string so it ships
+ * verbatim in a `<script>` — it must not reference any TS/Node symbol.
+ */
+const BOOTSTRAP = `
+(function () {
+  function decodeEvents(b64) {
+    var bin = atob(b64);
+    var bytes = new Uint8Array(bin.length);
+    for (var i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+    var json = fflate.strFromU8(fflate.gunzipSync(bytes));
+    return JSON.parse(json);
+  }
+
+  var events = decodeEvents(EVENTS_GZ_B64);
+
+  // rrweb-player needs at least two events to compute a timeline; guard so a
+  // truncated/empty capture degrades to a message instead of throwing.
+  var playerEl = document.getElementById('player');
+  if (events.length >= 2 && typeof rrwebPlayer !== 'undefined') {
+    new rrwebPlayer({ target: playerEl, props: { events: events, showController: true, autoPlay: false } });
+  } else {
+    playerEl.innerHTML = '<p class="empty">Not enough recorded events to replay.</p>';
+  }
+
+  function el(tag, cls, text) {
+    var n = document.createElement(tag);
+    if (cls) n.className = cls;
+    if (text != null) n.textContent = text;
+    return n;
+  }
+
+  function renderConsole(container, rows) {
+    if (!rows.length) { container.appendChild(el('div', 'empty', 'No console output captured.')); return; }
+    for (var i = 0; i < rows.length; i++) {
+      var r = rows[i];
+      var row = el('div', 'row ' + (r.level || 'log'));
+      row.appendChild(el('span', 'lvl', (r.level || 'log').toUpperCase()));
+      row.appendChild(document.createTextNode(r.message));
+      container.appendChild(row);
+    }
+  }
+
+  function renderNetwork(container, rows) {
+    if (!rows.length) { container.appendChild(el('div', 'empty', 'No failed network requests captured.')); return; }
+    for (var i = 0; i < rows.length; i++) {
+      var r = rows[i];
+      var row = el('div', 'row');
+      row.appendChild(el('span', 'st st' + String(r.status).charAt(0), String(r.status)));
+      row.appendChild(document.createTextNode((r.method ? r.method + ' ' : '') + r.url));
+      container.appendChild(row);
+    }
+  }
+
+  renderConsole(document.getElementById('console-rows'), CONSOLE);
+  renderNetwork(document.getElementById('network-rows'), NETWORK);
+
+  var btn = document.getElementById('copy-md');
+  if (btn) {
+    btn.addEventListener('click', function () {
+      var done = function () { var t = btn.textContent; btn.textContent = 'Copied!'; setTimeout(function () { btn.textContent = t; }, 1500); };
+      if (navigator.clipboard && navigator.clipboard.writeText) {
+        navigator.clipboard.writeText(MARKDOWN).then(done, function () { window.prompt('Copy the Markdown below:', MARKDOWN); });
+      } else {
+        window.prompt('Copy the Markdown below:', MARKDOWN);
+      }
+    });
+  }
+})();
+`;
+/** Compose the full self-contained HTML document. */
+export function renderReportHtml(data) {
+    const { meta, eventsGzB64, console: consoleRows, network, markdown, pruned } = data;
+    const title = `tracelane — ${meta.spec ?? '(no spec)'} :: ${meta.title} (${meta.status})`;
+    const banner = pruned
+        ? '<div class="banner">Some recorded events were pruned to fit the 25 MB report budget — replay may skip detail.</div>'
+        : '';
+    // Data payloads embedded as JS consts, all escaped for inline-script safety.
+    // The events blob is base64 (already inline-safe); the rest go through
+    // serializeForScript to neutralise any `</script>` in user data.
+    const dataScript = `const META = ${serializeForScript(meta)};\n` +
+        `const EVENTS_GZ_B64 = "${eventsGzB64}";\n` +
+        `const CONSOLE = ${serializeForScript(consoleRows)};\n` +
+        `const NETWORK = ${serializeForScript(network)};\n` +
+        `const MARKDOWN = ${serializeForScript(markdown)};`;
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(title)}</title>
+<style>${loadPlayerCss()}</style>
+<style>${SHELL_CSS}</style>
+</head>
+<body>
+${renderMetaHeader(meta)}
+${banner}
+<div class="toolbar"><button id="copy-md" class="copy-md" type="button">Copy as Markdown for AI paste</button></div>
+<main>
+<section id="player" aria-label="Session replay"></section>
+<aside id="panels">
+<section aria-label="Console"><h2>Console</h2><div id="console-rows" class="rows"></div></section>
+<section aria-label="Network"><h2>Network errors</h2><div id="network-rows" class="rows"></div></section>
+</aside>
+</main>
+<script>${loadFflateGunzipSource()}</script>
+<script>${loadPlayerUmd()}</script>
+<script>${dataScript}</script>
+<script>${BOOTSTRAP}</script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,oEAAoE;AAEpE,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAmBjD,8EAA8E;AAC9E,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BjB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEjB,CAAC;AAEF,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEpF,MAAM,KAAK,GAAG,eAAe,IAAI,CAAC,IAAI,IAAI,WAAW,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;IAC1F,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC,qHAAqH;QACvH,CAAC,CAAC,EAAE,CAAC;IAEP,6EAA6E;IAC7E,uEAAuE;IACvE,iEAAiE;IACjE,MAAM,UAAU,GACd,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,KAAK;QAC7C,0BAA0B,WAAW,MAAM;QAC3C,mBAAmB,kBAAkB,CAAC,WAAW,CAAC,KAAK;QACvD,mBAAmB,kBAAkB,CAAC,OAAO,CAAC,KAAK;QACnD,oBAAoB,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC;IAEtD,OAAO;;;;;SAKA,UAAU,CAAC,KAAK,CAAC;SACjB,aAAa,EAAE;SACf,SAAS;;;EAGhB,gBAAgB,CAAC,IAAI,CAAC;EACtB,MAAM;;;;;;;;;UASE,sBAAsB,EAAE;UACxB,aAAa,EAAE;UACf,UAAU;UACV,SAAS;;QAEX,CAAC;AACT,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+/** Test outcome rendered in the report header + markdown export. */
+export type ReportStatus = 'passed' | 'failed' | 'skipped' | 'broken';
+/** Recording viewport, surfaced in the metadata header. */
+export interface Viewport {
+    width: number;
+    height: number;
+}
+/**
+ * Metadata for a single test report (P1 PRD §F.1 / §F.3). All fields except
+ * `title` and `status` are optional — adapters fill what they can, and CI
+ * provenance (commit SHA, build URL) is auto-detected from the environment
+ * when omitted (see {@link resolveCiMetadata}).
+ */
+export interface ReportMeta {
+    /** Spec file path, e.g. `test/login.spec.ts`. */
+    spec?: string;
+    /** Test title, e.g. `logs in with valid credentials`. */
+    title: string;
+    /** Test outcome. */
+    status: ReportStatus;
+    /** Failure message, when the test failed/broke. */
+    error?: string;
+    /** Total test duration in milliseconds. */
+    durationMs?: number;
+    /** Browser name, e.g. `chrome`. */
+    browserName?: string;
+    /** Browser version, e.g. `124.0.6367.78`. */
+    browserVersion?: string;
+    /** Recording viewport. */
+    viewport?: Viewport;
+    /** Commit SHA. Auto-detected from `GITHUB_SHA` / `CI_COMMIT_SHA` when omitted. */
+    commitSha?: string;
+    /** CI build URL. Auto-detected from common CI env vars when omitted. */
+    buildUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtE,2DAA2D;AAC3D,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Public types for the report builder.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@tracelane/report",
+  "version": "0.1.0-alpha.1",
+  "description": "Self-contained, offline HTML report builder for tracelane. Embeds the rrweb player and a gzipped event blob into a single .html file.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "NOTICE", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "@cubenest/rrweb-core": "workspace:*",
+    "@tracelane/core": "workspace:*",
+    "fflate": "^0.8.2",
+    "rrweb-player": "1.0.0-alpha.4"
+  },
+  "devDependencies": {
+    "jsdom": "^25.0.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cubenest/rrweb-stack.git",
+    "directory": "packages/tracelane-report"
+  },
+  "homepage": "https://github.com/Cubenest/rrweb-stack/tree/main/packages/tracelane-report#readme"
+}