@sun-asterisk/sungen 3.2.34 → 3.3.0-alpha.2

package/dist/contract/trace/snapshot-html-renderer.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPLAY_CSP = void 0;
+exports.sanitizeCss = sanitizeCss;
+exports.renderSnapshot = renderSnapshot;
+/**
+ * A frame snapshot → static, INERT HTML for identity replay (DOS-14.5, DOS-14.7). Port of the
+ * phase 07 spike renderer (refs resolved per frame; 1684 refs, 0 broken on the real app).
+ *
+ *   state     what the viewer's in-page script restores is applied statically (JS is off in the
+ *             replay): input values, checked / selected, open dialogs and popovers
+ *   CSS       stylesheets are INLINED from the trace's own resources (G1). A sheet that cannot be
+ *             found is counted: without the page's CSS, accessible names built from `display`
+ *             spacing or `::before` glyphs come out wrong (3/89 and 9/27 in the spike), so a
+ *             missing sheet caps identity at `low`
+ *   inert     no scripts, no `on*` handlers, no URL-bearing attribute, CSS `url()` / `@import`
+ *             stripped, a CSP meta that forbids every fetch, `<base>` / refresh dropped
+ */
+const snapshot_store_1 = require("./snapshot-store");
+const AUTO_CLOSING = new Set(['AREA', 'BASE', 'BR', 'COL', 'COMMAND', 'EMBED', 'HR', 'IMG', 'INPUT', 'KEYGEN', 'LINK', 'MENUITEM', 'META', 'PARAM', 'SOURCE', 'TRACK', 'WBR']);
+const URL_ATTRS = new Set(['src', 'srcset', 'href', 'action', 'formaction', 'poster', 'data', 'background', 'xlink:href', 'ping', 'longdesc', 'cite', 'manifest', 'codebase', 'archive', 'lowsrc', 'dynsrc', 'srcdoc', 'imagesrcset']);
+exports.REPLAY_CSP = "default-src 'none'; style-src 'unsafe-inline'; img-src 'none'; font-src 'none'; media-src 'none'; frame-src 'none'; child-src 'none'; object-src 'none'; form-action 'none'; base-uri 'none'; connect-src 'none'; script-src 'none'";
+const escapeHtml = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+const escapeAttr = (s) => String(s).replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+/** A tag name that is only a name — anything else in a trace is markup smuggled into the name. */
+const TAG_NAME = /^[A-Za-z][A-Za-z0-9-]*$/;
+/** CSS escapes decoded (`\75 ` → `u`, `\r` → `r`) and comments removed — what the CSS parser sees. */
+const decodeCss = (css) => css
+    .replace(/\\([0-9a-fA-F]{1,6})[ \t\n\r\f]?/g, (_m, hex) => {
+    const cp = parseInt(hex, 16);
+    return cp > 0 && cp <= 0x10ffff ? String.fromCodePoint(cp) : '�';
+})
+    .replace(/\\([^\n0-9a-fA-F])/g, '$1')
+    .replace(/\/\*[\s\S]*?\*\//g, '');
+const FETCHING = /url\s*\(|@import|image-set\s*\(/i;
+const stripFetches = (css) => css
+    .replace(/@import[^;]*;?/gi, '')
+    .replace(/(-webkit-)?image-set\((?:[^()]|\([^)]*\))*\)/gi, 'none')
+    .replace(/url\(\s*(?:"[^"]*"|'[^']*'|[^)]*)\s*\)/gi, 'none');
+/**
+ * CSS with every fetch removed. A URL hidden behind escapes or comments (`u\72l(`, `@\69mport`) is
+ * caught on the decoded text, and then the DECODED text is what is kept; CSS that hides nothing
+ * stays byte-identical (icon-font `content: "\f101"` escapes matter for accessible names, R4).
+ */
+function sanitizeCss(css) {
+    const decoded = css.includes('\\') || css.includes('/*') ? decodeCss(css) : css;
+    const base = decoded !== css && FETCHING.test(decoded) ? decoded : css;
+    return stripFetches(base).replace(/<\/style/gi, '<\\/style');
+}
+/** Static equivalents of the viewer's in-page state restoration, applied to a copy of the attrs. */
+function restoredState(name, raw) {
+    const attrs = { ...raw };
+    let textarea;
+    if (attrs.__playwright_value_ !== undefined) {
+        if (name === 'INPUT' && !/^(checkbox|radio|file)$/i.test(attrs.type || ''))
+            attrs.value = attrs.__playwright_value_;
+        if (name === 'TEXTAREA')
+            textarea = attrs.__playwright_value_;
+    }
+    if (attrs.__playwright_checked_ !== undefined) {
+        if (attrs.__playwright_checked_ === 'true')
+            attrs.checked = '';
+        else
+            delete attrs.checked;
+    }
+    if (attrs.__playwright_selected_ !== undefined) {
+        if (attrs.__playwright_selected_ === 'true')
+            attrs.selected = '';
+        else
+            delete attrs.selected;
+    }
+    if (attrs.__playwright_popover_open_ !== undefined)
+        delete attrs.popover;
+    if (name === 'DIALOG' && attrs.__playwright_dialog_open_ !== undefined)
+        attrs.open = '';
+    return { attrs, textarea };
+}
+function attrText(name, attrs) {
+    const out = [];
+    for (const [k, v] of Object.entries(attrs)) {
+        const lk = k.toLowerCase();
+        if (lk.startsWith('__playwright_') && lk !== '__playwright_target__')
+            continue;
+        if (lk.startsWith('on') || !/^[A-Za-z_:][-A-Za-z0-9_:.]*$/.test(k))
+            continue;
+        if (URL_ATTRS.has(lk)) {
+            // A link without href loses its role; keep the attribute, drop the URL.
+            if ((name === 'A' || name === 'AREA') && lk === 'href')
+                out.push(' href="#"');
+            continue;
+        }
+        out.push(' ', k, '="', escapeAttr(lk === 'style' ? sanitizeCss(String(v)) : String(v)), '"');
+    }
+    return out.join('');
+}
+function renderSnapshot(store, snapshot, readResource) {
+    const stats = { refs: 0, brokenRefs: 0, stylesheets: 0, stylesheetsMissing: 0 };
+    const out = [];
+    const sheets = [];
+    let headSeen = false;
+    const visit = (n, snap, parent) => {
+        if ((0, snapshot_store_1.isRef)(n)) {
+            const d = store.deref(n, snap, stats);
+            if (d)
+                visit(d.n, d.snap, parent);
+            return;
+        }
+        if (typeof n === 'string') {
+            out.push(parent === 'STYLE' ? sanitizeCss(n) : escapeHtml(n));
+            return;
+        }
+        if (!(0, snapshot_store_1.isEl)(n) || !TAG_NAME.test(n[0]))
+            return;
+        const name = n[0].toUpperCase();
+        const raw = (0, snapshot_store_1.attrsOf)(n);
+        if (name === 'SCRIPT' || name === 'NOSCRIPT' || name === 'BASE' || (name === 'META' && raw['http-equiv'] !== undefined))
+            return;
+        if (name === 'LINK') {
+            if ((raw.rel || '').toLowerCase().split(/\s+/).includes('stylesheet') && raw.href) {
+                out.push(`<!--SUNGEN_SHEET_${sheets.length}-->`);
+                sheets.push({ snap, href: raw.href, media: raw.media });
+            }
+            return;
+        }
+        if (name === 'TEMPLATE' && raw.__playwright_style_sheet_ !== undefined) {
+            out.push('<style>', sanitizeCss(raw.__playwright_style_sheet_), '</style>');
+            return;
+        }
+        if (name === 'TEMPLATE' && raw.__playwright_shadow_root_ !== undefined) {
+            out.push('<template shadowrootmode="open">');
+            (0, snapshot_store_1.kidsOf)(n).forEach((k) => visit(k, snap, 'TEMPLATE'));
+            out.push('</template>');
+            return;
+        }
+        const { attrs, textarea } = restoredState(name, raw);
+        // Only THIS call's target keeps the marker, as `__playwright_target__="<callId>"` (v9 writes "").
+        const mark = attrs.__playwright_target__;
+        if (mark !== undefined) {
+            if (mark === snapshot.callId || (mark === '' && snap.callId === snapshot.callId))
+                attrs.__playwright_target__ = snapshot.callId;
+            else
+                delete attrs.__playwright_target__;
+        }
+        out.push('<', name, attrText(name, attrs), '>');
+        if (name === 'HEAD' && !headSeen) {
+            headSeen = true;
+            out.push(`<meta http-equiv="Content-Security-Policy" content="${exports.REPLAY_CSP}">`);
+        }
+        if (textarea !== undefined)
+            out.push(escapeHtml(textarea));
+        else
+            (0, snapshot_store_1.kidsOf)(n).forEach((k) => visit(k, snap, name));
+        if (!AUTO_CLOSING.has(name))
+            out.push('</', name, '>');
+    };
+    visit(snapshot.html, snapshot, undefined);
+    let html = out.join('');
+    sheets.forEach((s, i) => {
+        const sha1 = store.stylesheetSha1(s.snap, s.href);
+        const css = sha1 ? readResource(sha1) : null;
+        if (css === null)
+            stats.stylesheetsMissing++;
+        else
+            stats.stylesheets++;
+        const media = s.media ? ` media="${escapeAttr(s.media)}"` : '';
+        html = html.replace(`<!--SUNGEN_SHEET_${i}-->`, () => (css === null ? '' : `<style${media}>${sanitizeCss(css)}</style>`));
+    });
+    const csp = headSeen ? '' : `<meta http-equiv="Content-Security-Policy" content="${exports.REPLAY_CSP}">`;
+    const doctype = snapshot.doctype ? `<!DOCTYPE ${escapeHtml(snapshot.doctype)}>` : '';
+    return { html: doctype + csp + html, stats };
+}
+//# sourceMappingURL=snapshot-html-renderer.js.map

package/dist/contract/trace/snapshot-html-renderer.js.map

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

package/dist/contract/trace/snapshot-resolver.d.ts

@@ -0,0 +1,21 @@
+import type { ParsedTrace } from './trace-file-reader';
+import { RenderStats } from './snapshot-html-renderer';
+import { SnapshotStore } from './snapshot-store';
+import type { TargetFacts } from './target-identity';
+export interface CallTarget {
+    callId: string;
+    snapshotKey: string;
+    html: string;
+    /** sha256 of the rendered HTML — the key a driver identity is cached under. */
+    snapshotSha256: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    stats: RenderStats;
+    /** What already forces `low`, whatever the driver says. */
+    capReasons: string[];
+    facts: TargetFacts;
+}
+export declare function resolveCallTarget(store: SnapshotStore, trace: ParsedTrace, callId: string): CallTarget | null;
+//# sourceMappingURL=snapshot-resolver.d.ts.map

package/dist/contract/trace/snapshot-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-resolver.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/snapshot-resolver.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAkB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAyD,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;CACpB;AAoBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAmB7G"}

package/dist/contract/trace/snapshot-resolver.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCallTarget = resolveCallTarget;
+/**
+ * The snapshot that shows a call's target, rendered for replay (DOS-14.5; spike criterion 6).
+ *
+ * Playwright marks the element a call acted on with `__playwright_target__="<callId>"`. For an
+ * action that is the `input@` (v9: `action`) snapshot — the moment of the action; for a check the
+ * `after@` snapshot (the state it passed on). The order `input → before → after` is the spike's
+ * (R10: a child frame sometimes lacks one snapshot name; the fallback still found every target).
+ * No marked element in any snapshot → no target (identity `low`).
+ */
+const crypto_1 = require("crypto");
+const snapshot_html_renderer_1 = require("./snapshot-html-renderer");
+const snapshot_store_1 = require("./snapshot-store");
+const ORDER = ['input', 'before', 'after'];
+/** `label[for]` texts of a snapshot, for the heuristic name of a labelled control. */
+function labelTexts(store, snap) {
+    const out = new Map();
+    const stats = { refs: 0, brokenRefs: 0 };
+    const stack = [{ n: snap.html, s: snap }];
+    while (stack.length) {
+        let { n, s } = stack.pop();
+        if ((0, snapshot_store_1.isRef)(n)) {
+            const d = store.deref(n, s, stats);
+            if (!d)
+                continue;
+            n = d.n;
+            s = d.snap;
+        }
+        if (!(0, snapshot_store_1.isEl)(n))
+            continue;
+        const a = (0, snapshot_store_1.attrsOf)(n);
+        if (n[0].toUpperCase() === 'LABEL' && a.for)
+            out.set(a.for, store.textOf(n, s));
+        for (const k of (0, snapshot_store_1.kidsOf)(n))
+            stack.push({ n: k, s });
+    }
+    return out;
+}
+function resolveCallTarget(store, trace, callId) {
+    for (const phase of ORDER) {
+        for (const snap of store.byKey.get(`${phase}@${callId}`) ?? []) {
+            const hit = store.findTarget(snap, callId);
+            if (!hit)
+                continue;
+            const { html, stats } = (0, snapshot_html_renderer_1.renderSnapshot)(store, snap, (sha1) => trace.readResource(sha1));
+            const capReasons = [];
+            if (stats.stylesheetsMissing > 0)
+                capReasons.push(`stylesheet-missing(${stats.stylesheetsMissing})`);
+            if (stats.brokenRefs > 0)
+                capReasons.push(`broken-snapshot-refs(${stats.brokenRefs})`);
+            const attrs = Object.fromEntries(Object.entries((0, snapshot_store_1.attrsOf)(hit.el)).filter(([k]) => !k.startsWith('__playwright_')));
+            const facts = { tag: hit.el[0], attrs, text: store.textOf(hit.el, hit.snap) };
+            if (attrs.id)
+                facts.labelText = labelTexts(store, snap).get(attrs.id);
+            return {
+                callId, snapshotKey: snap.key, html, snapshotSha256: (0, crypto_1.createHash)('sha256').update(html).digest('hex'),
+                viewport: snap.viewport, stats, capReasons, facts,
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=snapshot-resolver.js.map

package/dist/contract/trace/snapshot-resolver.js.map

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

package/dist/contract/trace/snapshot-store.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The frame snapshots of a trace, indexed the way Playwright's trace viewer indexes them, so a
+ * snapshot can be rebuilt as static HTML for identity replay (DOS-14.5; phase 07 criterion 6).
+ *
+ * A snapshot reuses unchanged subtrees of an EARLIER snapshot of the same frame as `[[ago, idx]]`
+ * references; `idx` counts nodes in post-order (children first, then the element), exactly as the
+ * viewer numbers them. A reference that points outside its frame's history is counted as broken —
+ * a broken replay caps identity at `low`, never guesses.
+ *
+ * Snapshot naming differs by format: v8 names it `input@call@12`, v9 gives `{callId, phase}` with
+ * phase `before | action | after`. Both are keyed here as `<before|input|after>@<callId>`.
+ */
+import type { LibraryPart } from './trace-file-reader';
+export type SnapNode = string | [[number, number]] | [string, Record<string, string>?, ...SnapNode[]];
+export interface FrameSnapshot {
+    key: string;
+    callId: string;
+    frameId: string;
+    frameUrl: string;
+    doctype?: string;
+    html: SnapNode;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    timestamp: number;
+    isMainFrame: boolean;
+    resourceOverrides: Array<{
+        url: string;
+        sha1?: string;
+        ref?: number;
+    }>;
+    part: LibraryPart;
+    index: number;
+}
+export interface RefStats {
+    refs: number;
+    brokenRefs: number;
+}
+export declare const isRef: (n: unknown) => n is [[number, number]];
+export declare const isEl: (n: unknown) => n is [string, Record<string, string>?, ...SnapNode[]];
+export declare const attrsOf: (n: [string, Record<string, string>?, ...SnapNode[]]) => Record<string, string>;
+export declare const kidsOf: (n: [string, Record<string, string>?, ...SnapNode[]]) => SnapNode[];
+export declare class SnapshotStore {
+    readonly frames: Map<string, FrameSnapshot[]>;
+    readonly byKey: Map<string, FrameSnapshot[]>;
+    private nodeCache;
+    constructor(parts: LibraryPart[]);
+    /** Non-reference nodes of a snapshot in post-order — Playwright's numbering for `[[ago, idx]]`. */
+    nodes(snap: FrameSnapshot): SnapNode[];
+    /** Follow references to a concrete node, or null (counted as broken). */
+    deref(n: SnapNode, snap: FrameSnapshot, stats: RefStats): {
+        n: SnapNode;
+        snap: FrameSnapshot;
+    } | null;
+    /** The element Playwright marked as the target of `callId` in this snapshot, if any. */
+    findTarget(snap: FrameSnapshot, callId: string): {
+        el: [string, Record<string, string>?, ...SnapNode[]];
+        snap: FrameSnapshot;
+    } | null;
+    /** The visible text under a node (references resolved), whitespace collapsed. */
+    textOf(n: SnapNode, snap: FrameSnapshot): string;
+    /** The stylesheet body for `href` as the page had it at this snapshot: override first, then network. */
+    stylesheetSha1(snap: FrameSnapshot, href: string): string | null;
+}
+//# sourceMappingURL=snapshot-store.d.ts.map

package/dist/contract/trace/snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/snapshot-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;AACtG,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IACjG,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IACrF,iBAAiB,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAClC;AACD,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAE9D,eAAO,MAAM,KAAK,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAA4C,CAAC;AACtG,eAAO,MAAM,IAAI,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAiD,CAAC;AACxI,eAAO,MAAM,OAAO,GAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CACD,CAAC;AACnG,eAAO,MAAM,MAAM,GAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,KAAG,QAAQ,EAA8B,CAAC;AAUpH,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,+BAAsC;IACrD,QAAQ,CAAC,KAAK,+BAAsC;IACpD,OAAO,CAAC,SAAS,CAAwC;gBAE7C,KAAK,EAAE,WAAW,EAAE;IAuBhC,mGAAmG;IACnG,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,EAAE;IAatC,yEAAyE;IACzE,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,GAAG;QAAE,CAAC,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI;IAiBrG,wFAAwF;IACxF,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI;IAerI,iFAAiF;IACjF,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM;IAYhD,wGAAwG;IACxG,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAuBjE"}

package/dist/contract/trace/snapshot-store.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotStore = exports.kidsOf = exports.attrsOf = exports.isEl = exports.isRef = void 0;
+const isRef = (n) => Array.isArray(n) && Array.isArray(n[0]);
+exports.isRef = isRef;
+const isEl = (n) => Array.isArray(n) && typeof n[0] === 'string';
+exports.isEl = isEl;
+const attrsOf = (n) => (n[1] && typeof n[1] === 'object' && !Array.isArray(n[1]) ? n[1] : {});
+exports.attrsOf = attrsOf;
+const kidsOf = (n) => n.slice(2);
+exports.kidsOf = kidsOf;
+const PHASE = { before: 'before', action: 'input', input: 'input', after: 'after' };
+function keyOf(s) {
+    if (typeof s.snapshotName === 'string')
+        return s.snapshotName;
+    if (typeof s.callId === 'string' && typeof s.phase === 'string' && PHASE[s.phase])
+        return `${PHASE[s.phase]}@${s.callId}`;
+    return null;
+}
+class SnapshotStore {
+    constructor(parts) {
+        this.frames = new Map();
+        this.byKey = new Map();
+        this.nodeCache = new Map();
+        for (const part of parts) {
+            for (const e of part.events) {
+                if (e.type !== 'frame-snapshot' || !e.snapshot || typeof e.snapshot !== 'object')
+                    continue;
+                const s = e.snapshot;
+                const key = keyOf(s);
+                if (!key || typeof s.frameId !== 'string')
+                    continue;
+                const list = this.frames.get(s.frameId) ?? [];
+                const vp = (s.viewport ?? {});
+                const snap = {
+                    key, callId: key.slice(key.indexOf('@') + 1), frameId: s.frameId, frameUrl: String(s.frameUrl ?? ''),
+                    doctype: typeof s.doctype === 'string' ? s.doctype : undefined, html: s.html,
+                    viewport: { width: Number(vp.width) || 1280, height: Number(vp.height) || 800 }, timestamp: Number(s.timestamp) || 0,
+                    isMainFrame: s.isMainFrame !== false, resourceOverrides: Array.isArray(s.resourceOverrides) ? s.resourceOverrides : [],
+                    part, index: list.length,
+                };
+                list.push(snap);
+                this.frames.set(s.frameId, list);
+                this.byKey.set(key, [...(this.byKey.get(key) ?? []), snap]);
+            }
+        }
+    }
+    /** Non-reference nodes of a snapshot in post-order — Playwright's numbering for `[[ago, idx]]`. */
+    nodes(snap) {
+        const cached = this.nodeCache.get(snap);
+        if (cached)
+            return cached;
+        const out = [];
+        const visit = (n) => {
+            if (typeof n === 'string')
+                out.push(n);
+            else if ((0, exports.isEl)(n)) {
+                (0, exports.kidsOf)(n).forEach(visit);
+                out.push(n);
+            }
+        };
+        visit(snap.html);
+        this.nodeCache.set(snap, out);
+        return out;
+    }
+    /** Follow references to a concrete node, or null (counted as broken). */
+    deref(n, snap, stats) {
+        let cur = n;
+        let at = snap;
+        for (let guard = 0; (0, exports.isRef)(cur) && guard < 10000; guard++) {
+            const [ago, idx] = cur[0];
+            const list = this.frames.get(at.frameId) ?? [];
+            const target = list[at.index - ago];
+            if (!Number.isInteger(ago) || ago < 0 || !target) {
+                stats.brokenRefs++;
+                return null;
+            }
+            const nodes = this.nodes(target);
+            if (!Number.isInteger(idx) || idx < 0 || idx >= nodes.length) {
+                stats.brokenRefs++;
+                return null;
+            }
+            cur = nodes[idx];
+            at = target;
+            stats.refs++;
+        }
+        return (0, exports.isRef)(cur) ? null : { n: cur, snap: at };
+    }
+    /** The element Playwright marked as the target of `callId` in this snapshot, if any. */
+    findTarget(snap, callId) {
+        const stats = { refs: 0, brokenRefs: 0 };
+        const stack = [{ n: snap.html, snap }];
+        while (stack.length) {
+            let { n, snap: at } = stack.pop();
+            if ((0, exports.isRef)(n)) {
+                const d = this.deref(n, at, stats);
+                if (!d)
+                    continue;
+                n = d.n;
+                at = d.snap;
+            }
+            if (!(0, exports.isEl)(n))
+                continue;
+            // v8 marks the target with its call id; v9 snapshots belong to one call and mark it with ''.
+            const mark = (0, exports.attrsOf)(n).__playwright_target__;
+            if (mark === callId || (mark === '' && snap.callId === callId))
+                return { el: n, snap: at };
+            for (const k of (0, exports.kidsOf)(n))
+                stack.push({ n: k, snap: at });
+        }
+        return null;
+    }
+    /** The visible text under a node (references resolved), whitespace collapsed. */
+    textOf(n, snap) {
+        const stats = { refs: 0, brokenRefs: 0 };
+        const out = [];
+        const visit = (x, at) => {
+            if ((0, exports.isRef)(x)) {
+                const d = this.deref(x, at, stats);
+                if (d)
+                    visit(d.n, d.snap);
+                return;
+            }
+            if (typeof x === 'string') {
+                out.push(x);
+                return;
+            }
+            if ((0, exports.isEl)(x) && !/^(SCRIPT|STYLE|NOSCRIPT|TEMPLATE)$/i.test(x[0]))
+                (0, exports.kidsOf)(x).forEach((k) => visit(k, at));
+        };
+        visit(n, snap);
+        return out.join(' ').replace(/\s+/g, ' ').trim();
+    }
+    /** The stylesheet body for `href` as the page had it at this snapshot: override first, then network. */
+    stylesheetSha1(snap, href) {
+        let abs;
+        try {
+            abs = new URL(href, snap.frameUrl).href.replace(/#.*$/, '');
+        }
+        catch {
+            return null;
+        }
+        const list = this.frames.get(snap.frameId) ?? [];
+        let idx = snap.index;
+        for (let guard = 0; guard < 10000 && list[idx]; guard++) {
+            const o = list[idx].resourceOverrides.find((x) => x.url === abs);
+            if (!o)
+                break;
+            if (o.sha1)
+                return o.sha1;
+            if (typeof o.ref !== 'number')
+                break;
+            idx -= o.ref;
+        }
+        let same = null;
+        let other = null;
+        for (const r of snap.part.network) {
+            const s = (r.snapshot ?? {});
+            const body = s.response?.content?._sha1 ?? s.response?.content?._file; // v8: sha1 · v9: resources/<sha1>.<ext>
+            if (typeof s._monotonicTime === 'number' && s._monotonicTime >= snap.timestamp)
+                continue;
+            if (s.request?.url !== abs || s.request?.method !== 'GET' || s.response?.status === 304 || !body)
+                continue;
+            if (s._frameref === snap.frameId)
+                same = body;
+            else
+                other = body;
+        }
+        return same ?? other;
+    }
+}
+exports.SnapshotStore = SnapshotStore;
+//# sourceMappingURL=snapshot-store.js.map

package/dist/contract/trace/snapshot-store.js.map

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

package/dist/contract/trace/target-identity.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Who an action or a check was aimed at (DOS-14.5, SPI §4.5 `traceIdentity`).
+ *
+ * The identity of a target is role + accessible name from the RUNTIME's own accessibility engine:
+ * `@sungen/driver-ui` replays the snapshot in a real browser (Playwright `ariaSnapshot` +
+ * `getByRole`) through the `traceIdentity` slot, with `identityConfidence: high | low`. Core
+ * cannot run a browser; its own reading of the snapshot (below) is a HEURISTIC and therefore
+ * always `low` — and `low` is never `match` (red-team #4).
+ *
+ * `high` also needs: the page's stylesheets all found (G1), no broken snapshot reference, a semantic
+ * role with a non-empty name, and role+name resolving back to exactly the marked element — or,
+ * when it does not (G3, ~12% of actions: "Add to cart" ×34), a named scope (row, landmark, dialog)
+ * inside which it does.
+ */
+export type IdentityConfidence = 'high' | 'low';
+export interface IdentityScope {
+    role: string;
+    name: string;
+}
+export interface TargetIdentity {
+    role: string;
+    name: string;
+    level?: number;
+    scope?: IdentityScope;
+    identityConfidence: IdentityConfidence;
+    reasons: string[];
+    source: 'driver' | 'heuristic';
+}
+/** One snapshot to replay. `capReasons` are what core already knows forces `low` (missing CSS…). */
+export interface TraceIdentityRequest {
+    key: string;
+    html: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    targetSelector: string;
+    capReasons: string[];
+}
+export interface TraceIdentityInput {
+    requests: TraceIdentityRequest[];
+}
+export interface TraceIdentityResult {
+    key: string;
+    role: string;
+    name: string;
+    level?: number;
+    scope?: IdentityScope;
+    identityConfidence: IdentityConfidence;
+    reasons: string[];
+}
+export interface TraceIdentityOutput {
+    resolver: string;
+    /** The browser build that judged every result (e.g. `chromium 143.0.7499.4`), kept per cache entry. */
+    browser: string;
+    results: TraceIdentityResult[];
+    /** Requests the replay page attempted (all blocked). Reported, never trusted for anything. */
+    blockedRequests?: number;
+}
+export type TraceIdentityResolver = (input: TraceIdentityInput) => Promise<TraceIdentityOutput>;
+/** What core can read off the snapshot about the marked element. */
+export interface TargetFacts {
+    tag: string;
+    attrs: Record<string, string>;
+    text: string;
+    labelText?: string;
+}
+/** Core's own reading of the snapshot — never better than `low`. */
+export declare function heuristicIdentity(f: TargetFacts | null, why: string): TargetIdentity;
+/** The only resolver whose answers the identity cache keeps (driver-ui's Playwright replay). */
+export declare const TRUSTED_RESOLVER: RegExp;
+/** A resolver's result, checked strictly (unknown keys rejected) — null when it is not well-formed. */
+export declare function validIdentityResult(raw: unknown): TraceIdentityResult | null;
+//# sourceMappingURL=target-identity.d.ts.map

package/dist/contract/trace/target-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-identity.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/target-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,CAAC;AAChD,MAAM,WAAW,aAAa;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAE7D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAChC;AAED,oGAAoG;AACpG,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AACD,MAAM,WAAW,kBAAkB;IAAG,QAAQ,EAAE,oBAAoB,EAAE,CAAA;CAAE;AACxE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/E,kBAAkB,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC3D;AACD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,8FAA8F;IAC9F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEhG,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAoB7G,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAOpF;AASD,gGAAgG;AAChG,eAAO,MAAM,gBAAgB,QAAqC,CAAC;AAEnE,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAW5E"}