@sun-asterisk/sungen 3.2.35 → 3.3.0-alpha.10

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"}

package/dist/contract/trace/target-identity.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRUSTED_RESOLVER = void 0;
+exports.heuristicIdentity = heuristicIdentity;
+exports.validIdentityResult = validIdentityResult;
+const INPUT_ROLE = {
+    checkbox: 'checkbox', radio: 'radio', submit: 'button', button: 'button', reset: 'button', image: 'button',
+    search: 'searchbox', number: 'spinbutton', range: 'slider',
+};
+function heuristicRole(f) {
+    if (f.attrs.role)
+        return f.attrs.role.split(/\s+/)[0].toLowerCase();
+    const tag = f.tag.toUpperCase();
+    if (tag === 'A' && f.attrs.href !== undefined)
+        return 'link';
+    if (tag === 'BUTTON')
+        return 'button';
+    if (tag === 'INPUT')
+        return INPUT_ROLE[(f.attrs.type || 'text').toLowerCase()] ?? 'textbox';
+    if (tag === 'SELECT')
+        return 'combobox';
+    if (tag === 'TEXTAREA')
+        return 'textbox';
+    if (/^H[1-6]$/.test(tag))
+        return 'heading';
+    if (tag === 'IMG')
+        return 'img';
+    return 'generic';
+}
+/** Core's own reading of the snapshot — never better than `low`. */
+function heuristicIdentity(f, why) {
+    if (!f)
+        return { role: 'generic', name: '', identityConfidence: 'low', reasons: [why, 'no-target-in-snapshot'], source: 'heuristic' };
+    const role = heuristicRole(f);
+    const named = role === 'button' || role === 'link' || role === 'heading';
+    const name = f.attrs['aria-label'] || f.labelText || (named ? f.text : '') || f.attrs.placeholder || f.attrs.alt || f.attrs.title || '';
+    const level = /^H([1-6])$/i.exec(f.tag)?.[1];
+    return { role, name: name.replace(/\s+/g, ' ').trim(), ...(level ? { level: Number(level) } : {}), identityConfidence: 'low', reasons: [why], source: 'heuristic' };
+}
+const RESULT_KEYS = new Set(['key', 'role', 'name', 'level', 'scope', 'identityConfidence', 'reasons']);
+const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** Bounded strings: an identity is a role and a name, never a payload. */
+const str = (v, max) => typeof v === 'string' && v.length <= max;
+const ROLE_MAX = 64;
+const NAME_MAX = 1000;
+/** The only resolver whose answers the identity cache keeps (driver-ui's Playwright replay). */
+exports.TRUSTED_RESOLVER = /^driver-ui\/playwright-aria@\d+$/;
+/** A resolver's result, checked strictly (unknown keys rejected) — null when it is not well-formed. */
+function validIdentityResult(raw) {
+    if (!isObj(raw) || Object.keys(raw).some((k) => !RESULT_KEYS.has(k)))
+        return null;
+    const { key, role, name, level, scope, identityConfidence, reasons } = raw;
+    if (!str(key, 128) || !str(role, ROLE_MAX) || !str(name, NAME_MAX))
+        return null;
+    if (identityConfidence !== 'high' && identityConfidence !== 'low')
+        return null;
+    if (!Array.isArray(reasons) || reasons.length > 20 || !reasons.every((r) => str(r, 300)))
+        return null;
+    if (level !== undefined && !(Number.isInteger(level) && level >= 1 && level <= 6))
+        return null;
+    if (scope !== undefined && !(isObj(scope) && str(scope.role, ROLE_MAX) && str(scope.name, NAME_MAX) && Object.keys(scope).length === 2))
+        return null;
+    // `high` with a reason is a contradiction: a reason is what makes an identity low.
+    if (identityConfidence === 'high' && reasons.length)
+        return null;
+    return { key, role, name, ...(level !== undefined ? { level: level } : {}), ...(scope ? { scope: scope } : {}), identityConfidence, reasons: reasons };
+}
+//# sourceMappingURL=target-identity.js.map

package/dist/contract/trace/target-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-identity.js","sourceRoot":"","sources":["../../../src/contract/trace/target-identity.ts"],"names":[],"mappings":";;;AAwEA,8CAOC;AAaD,kDAWC;AAlDD,MAAM,UAAU,GAA2B;IACzC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;IAC1G,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ;CAC3D,CAAC;AAEF,SAAS,aAAa,CAAC,CAAc;IACnC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC7D,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,SAAS,CAAC;IAC5F,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC;IACxC,IAAI,GAAG,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oEAAoE;AACpE,SAAgB,iBAAiB,CAAC,CAAqB,EAAE,GAAW;IAClE,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,uBAAuB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtI,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,SAAS,CAAC;IACzE,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IACxI,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACtK,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC,CAAC;AACxG,MAAM,KAAK,GAAG,CAAC,CAAU,EAAgC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC9G,0EAA0E;AAC1E,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,GAAW,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;AAC/F,MAAM,QAAQ,GAAG,EAAE,CAAC;AACpB,MAAM,QAAQ,GAAG,IAAI,CAAC;AAEtB,gGAAgG;AACnF,QAAA,gBAAgB,GAAG,kCAAkC,CAAC;AAEnE,uGAAuG;AACvG,SAAgB,mBAAmB,CAAC,GAAY;IAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClF,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IAC3E,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,IAAI,kBAAkB,KAAK,MAAM,IAAI,kBAAkB,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC/E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACtG,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,CAAC,IAAK,KAAgB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACvH,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrJ,mFAAmF;IACnF,IAAI,kBAAkB,KAAK,MAAM,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAiC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAmB,EAAE,CAAC;AAC3M,CAAC"}

package/dist/contract/trace/test-step-join.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Join the test runner's steps (test.trace) with the browser calls (<N>-trace.trace) — phase 07
+ * criterion 2, proven 114/114 on a real app. Up to format 9 a library call's `stepId` is the runner
+ * step's `callId`; from format 10 (Playwright 1.64) the two share ONE id and `stepId` is gone, so the
+ * call's own `callId` is the step. Walking the runner's `parentId` chain says where the call ran:
+ *
+ *   body       the test function itself, with the path of enclosing `test.step` titles
+ *   hook       a user `beforeEach` / `afterEach` (stage setup | teardown)
+ *   fixture    a fixture's setup or teardown (`Fixture "signedInPage"`)
+ *   runner     the runner's own Before/After Hooks plumbing (browser launch, context close)
+ *
+ * Only body and user `beforeEach` calls are the test's behaviour; fixtures and teardown are
+ * environment, kept apart so a shared fixture cannot leak into every test's contract.
+ */
+import type { ParsedTrace, StackFrame, TraceEvent } from './trace-file-reader';
+export interface RunnerStep {
+    id: string;
+    parentId?: string;
+    method: string;
+    title: string;
+    params: Record<string, unknown>;
+    stack: StackFrame[];
+    failed: boolean;
+}
+export type CallPhase = {
+    phase: 'body';
+    stepPath: string[];
+} | {
+    phase: 'hook';
+    stage: 'setup' | 'teardown';
+    name: string;
+} | {
+    phase: 'fixture';
+    stage: 'setup' | 'teardown';
+    name: string;
+} | {
+    phase: 'runner';
+    stage: 'setup' | 'teardown';
+    name: string;
+} | {
+    phase: 'unjoined';
+};
+export interface JoinedCall {
+    part: string;
+    callId: string;
+    class: string;
+    method: string;
+    params: Record<string, unknown>;
+    stepId?: string;
+    where: CallPhase;
+    failed: boolean;
+    startTime: number;
+}
+export declare function indexRunnerSteps(runner: TraceEvent[]): Map<string, RunnerStep>;
+/** The runner steps from `id` up to the root (self first). Cycles end the walk. */
+export declare function ancestry(steps: Map<string, RunnerStep>, id: string): RunnerStep[];
+export declare function classifyStep(steps: Map<string, RunnerStep>, stepId: string): CallPhase;
+/** Is this phase the test's own behaviour (body, or a user `beforeEach`)? */
+export declare const isBehaviour: (w: CallPhase) => boolean;
+/** Every library call, joined to its runner step, in start order across parts. */
+export declare function joinCalls(trace: ParsedTrace): {
+    steps: Map<string, RunnerStep>;
+    calls: JoinedCall[];
+};
+//# sourceMappingURL=test-step-join.d.ts.map

package/dist/contract/trace/test-step-join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-step-join.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/test-step-join.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAC7D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;CACvE;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;CACxG;AAWD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAa9E;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,EAAE,CAQjF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAWtF;AAED,6EAA6E;AAC7E,eAAO,MAAM,WAAW,GAAI,GAAG,SAAS,KAAG,OAA4E,CAAC;AAExH,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAkBrG"}

package/dist/contract/trace/test-step-join.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBehaviour = void 0;
+exports.indexRunnerSteps = indexRunnerSteps;
+exports.ancestry = ancestry;
+exports.classifyStep = classifyStep;
+exports.joinCalls = joinCalls;
+const str = (v) => (typeof v === 'string' ? v : '');
+const RUNNER_HOOKS = /^(Before Hooks|After Hooks|Worker Cleanup)$/;
+function stackOf(e) {
+    const raw = Array.isArray(e.stack) ? e.stack : [];
+    return raw.filter((f) => !!f && typeof f === 'object')
+        .map((f) => ({ file: str(f.file), line: Number(f.line) || 0, column: Number(f.column) || 0 }));
+}
+function indexRunnerSteps(runner) {
+    const steps = new Map();
+    for (const e of runner) {
+        const id = str(e.callId);
+        if (e.type === 'before' && id) {
+            steps.set(id, {
+                id, parentId: str(e.parentId) || undefined, method: str(e.method), title: str(e.title),
+                params: (e.params && typeof e.params === 'object' ? e.params : {}), stack: stackOf(e), failed: false,
+            });
+        }
+        if (e.type === 'after' && steps.has(id) && e.error)
+            steps.get(id).failed = true;
+    }
+    return steps;
+}
+/** The runner steps from `id` up to the root (self first). Cycles end the walk. */
+function ancestry(steps, id) {
+    const chain = [];
+    const seen = new Set();
+    for (let cur = steps.get(id); cur && !seen.has(cur.id); cur = cur.parentId ? steps.get(cur.parentId) : undefined) {
+        seen.add(cur.id);
+        chain.push(cur);
+    }
+    return chain;
+}
+function classifyStep(steps, stepId) {
+    const chain = ancestry(steps, stepId);
+    if (!chain.length)
+        return { phase: 'unjoined' };
+    const root = chain[chain.length - 1];
+    const stage = root.method === 'hook' && root.title === 'After Hooks' ? 'teardown' : 'setup';
+    const fixture = chain.find((s) => s.method === 'fixture');
+    if (fixture)
+        return { phase: 'fixture', stage, name: fixture.title.replace(/^Fixture "(.*)"$/, '$1') };
+    const userHook = chain.find((s) => s.method === 'hook' && !RUNNER_HOOKS.test(s.title));
+    if (userHook)
+        return { phase: 'hook', stage, name: userHook.title };
+    if (root.method === 'hook')
+        return { phase: 'runner', stage, name: root.title };
+    return { phase: 'body', stepPath: chain.filter((s) => s.method === 'test.step').map((s) => s.title).reverse() };
+}
+/** Is this phase the test's own behaviour (body, or a user `beforeEach`)? */
+const isBehaviour = (w) => w.phase === 'body' || (w.phase === 'hook' && w.stage === 'setup');
+exports.isBehaviour = isBehaviour;
+/** Every library call, joined to its runner step, in start order across parts. */
+function joinCalls(trace) {
+    const steps = indexRunnerSteps(trace.runner);
+    const calls = [];
+    for (const part of trace.library) {
+        const failed = new Set(part.events.filter((e) => e.type === 'after' && e.error).map((e) => str(e.callId)));
+        for (const e of part.events) {
+            if (e.type !== 'before')
+                continue;
+            const callId = str(e.callId);
+            const stepId = str(e.stepId) || (part.version >= 10 ? callId : '') || undefined;
+            calls.push({
+                part: part.name, callId, class: str(e.class), method: str(e.method),
+                params: (e.params && typeof e.params === 'object' ? e.params : {}),
+                stepId, where: stepId ? classifyStep(steps, stepId) : { phase: 'unjoined' }, failed: failed.has(callId), startTime: Number(e.startTime) || 0,
+            });
+        }
+    }
+    calls.sort((a, b) => a.startTime - b.startTime);
+    return { steps, calls };
+}
+//# sourceMappingURL=test-step-join.js.map

package/dist/contract/trace/test-step-join.js.map

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

package/dist/contract/trace/trace-binding.d.ts

@@ -0,0 +1,22 @@
+import type { ParsedTrace } from './trace-file-reader';
+import { UnitContract } from './trace-freshness';
+import type { RunRecord } from './trace-run-record';
+import type { ReportResult, ReportTest } from './select-final-attempt';
+export interface BindingInput {
+    projectRoot: string;
+    test: ReportTest;
+    result: ReportResult;
+    record: RunRecord;
+    trace: ParsedTrace;
+    /** The unit's contract as it is now; null when no contract is proven (derive reads traces to write one). */
+    contract: UnitContract | null;
+}
+export type Binding = {
+    ok: true;
+    specFile: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function bindTrace(i: BindingInput): Binding;
+//# sourceMappingURL=trace-binding.d.ts.map

package/dist/contract/trace/trace-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-binding.d.ts","sourceRoot":"","sources":["../../../src/contract/trace/trace-binding.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAe,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,4GAA4G;IAC5G,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;CAC/B;AACD,MAAM,MAAM,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAIrF,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAwBlD"}