@visual-layer/grounding 1.0.0

package/dist/compare.d.ts

@@ -0,0 +1,34 @@
+/**
+ * compare_graphs — deterministic structural comparison of two ScreenGraphs.
+ * MVP supports only `mode=fixture-v0`: match interactables by normalized text,
+ * report missing/extra and bbox deltas. Production-scale modes are post-MVP.
+ */
+import { type ScreenGraph, type Warning, type Transform } from '@visual-layer/core';
+export type CompareMode = 'fixture-v0';
+export interface BboxDelta {
+    interactableId: string;
+    dx: number;
+    dy: number;
+    dw: number;
+    dh: number;
+}
+export interface CompareOptions {
+    mode?: CompareMode;
+    /** Required when graphs live in different coordinate spaces. */
+    transform?: Transform;
+    /** Cap on candidate pairs scored; emit compare_truncated when exceeded. */
+    maxPairs?: number;
+    /** Minimum text similarity to consider two interactables a match. */
+    matchThreshold?: number;
+}
+export interface CompareResult {
+    missingFromActual: string[];
+    extraInActual: string[];
+    bboxDeltas: BboxDelta[];
+    warnings: Warning[];
+}
+export declare function compareGraphs(expected: ScreenGraph, actual: ScreenGraph, opts?: CompareOptions): CompareResult;
+declare function unsupported(detail: string): Error;
+declare function transformMissing(detail: string): Error;
+export { unsupported, transformMissing };
+//# sourceMappingURL=compare.d.ts.map

package/dist/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,OAAO,EAEZ,KAAK,SAAS,EAMf,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC;AAEvC,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,gEAAgE;IAChE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAKD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,cAAmB,GACxB,aAAa,CAqEf;AAwCD,iBAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAI1C;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAI/C;AAMD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/compare.js

@@ -0,0 +1,112 @@
+/**
+ * compare_graphs — deterministic structural comparison of two ScreenGraphs.
+ * MVP supports only `mode=fixture-v0`: match interactables by normalized text,
+ * report missing/extra and bbox deltas. Production-scale modes are post-MVP.
+ */
+import { compareText, normalizeText, convertBbox, warn, } from '@visual-layer/core';
+const DEFAULT_MAX_PAIRS = 5000;
+const DEFAULT_MATCH = 0.6;
+export function compareGraphs(expected, actual, opts = {}) {
+    const mode = opts.mode ?? 'fixture-v0';
+    if (mode !== 'fixture-v0') {
+        throw unsupported(`mode "${mode}" not supported in MVP; use fixture-v0`);
+    }
+    const warnings = [];
+    const expSpace = dominantSpace(expected);
+    const actSpace = dominantSpace(actual);
+    if (expSpace && actSpace && expSpace !== actSpace && !opts.transform) {
+        throw transformMissing(`expected space "${expSpace}" != actual space "${actSpace}"; supply a transform`);
+    }
+    // Validate a supplied transform maps actual -> expected space (prevents silently
+    // applying a factor in the wrong direction).
+    if (opts.transform && expSpace && actSpace) {
+        const t = opts.transform;
+        if (t.from !== actSpace || t.to !== expSpace) {
+            throw transformMissing(`transform ${t.from}->${t.to} does not match actual(${actSpace})->expected(${expSpace})`);
+        }
+    }
+    const exInts = expected.interactables;
+    const acInts = actual.interactables;
+    const maxPairs = opts.maxPairs ?? DEFAULT_MAX_PAIRS;
+    const matchThreshold = opts.matchThreshold ?? DEFAULT_MATCH;
+    const matchedActual = new Set();
+    const bboxDeltas = [];
+    const compared = new Set();
+    // Honest truncation: stop scoring once the pair budget is exhausted, and report
+    // how many expected interactables were skipped (skipped are NOT counted as missing).
+    let pairsBudget = maxPairs;
+    let skipped = 0;
+    for (const ex of exInts) {
+        if (pairsBudget <= 0) {
+            skipped++;
+            continue;
+        }
+        compared.add(ex.id);
+        const best = bestMatch(ex, acInts, matchThreshold, matchedActual);
+        pairsBudget -= acInts.length;
+        if (!best)
+            continue;
+        matchedActual.add(best.match.id);
+        const actualBbox = opts.transform ? convertBbox(best.match.bbox, opts.transform) : best.match.bbox;
+        bboxDeltas.push({
+            interactableId: ex.id,
+            dx: round1(ex.bbox[0] - actualBbox[0]),
+            dy: round1(ex.bbox[1] - actualBbox[1]),
+            dw: round1(ex.bbox[2] - actualBbox[2]),
+            dh: round1(ex.bbox[3] - actualBbox[3]),
+        });
+    }
+    if (skipped > 0) {
+        warnings.push(warn('compare_truncated', `${skipped} expected interactables skipped (pairs cap ${maxPairs})`, undefined));
+    }
+    // missing = compared expected that found no match; un-compared (skipped) excluded
+    const missingFromActual = exInts
+        .filter((e) => compared.has(e.id) && !bboxDeltas.some((d) => d.interactableId === e.id))
+        .map((e) => e.id);
+    const extraInActual = acInts.filter((a) => !matchedActual.has(a.id)).map((a) => a.id);
+    return { missingFromActual, extraInActual, bboxDeltas, warnings };
+}
+function bestMatch(ex, candidates, threshold, used) {
+    let best = null;
+    for (const c of candidates) {
+        if (used.has(c.id))
+            continue;
+        const score = compareText(labelFor(ex), labelFor(c));
+        // role agreement is a hard precondition — different role = not the same element
+        if (ex.role && c.role && ex.role.toLowerCase() !== c.role.toLowerCase())
+            continue;
+        if (score >= threshold && (!best || score > best.score)) {
+            best = { match: c, score };
+        }
+    }
+    return best;
+}
+function labelFor(i) {
+    const raw = i.text ?? i.name ?? '';
+    const n = normalizeText(raw);
+    // fall back to a role-only key when there's no text — keeps role-only elements matchable
+    return n.length > 0 ? n : (i.role ?? '');
+}
+function dominantSpace(g) {
+    if (g.interactables.length === 0)
+        return undefined; // empty graph imposes no space constraint
+    const spaces = new Set(g.interactables.map((i) => i.coordinateSpace));
+    if (spaces.size === 1)
+        return [...spaces][0];
+    return 'mixed';
+}
+function unsupported(detail) {
+    const e = new Error(`unsupported_compare_mode: ${detail}`);
+    e.code = 'unsupported_compare_mode';
+    return e;
+}
+function transformMissing(detail) {
+    const e = new Error(`coordinate_transform_missing: ${detail}`);
+    e.code = 'coordinate_transform_missing';
+    return e;
+}
+function round1(n) {
+    return Math.round(n * 10) / 10;
+}
+export { unsupported, transformMissing };
+//# sourceMappingURL=compare.js.map

package/dist/compare.js.map

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

package/dist/eval.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Fixture-only grounding eval harness (regression block alpha, §18.1).
+ * No live capture — drives groundInstruction over golden fixtures and reports
+ * top-K accuracy. A regression in fixture accuracy blocks alpha release.
+ */
+import { type ScreenGraph, type Warning } from '@visual-layer/core';
+import { type GroundOptions } from './score.js';
+export interface EvalFixture {
+    id: string;
+    graph: ScreenGraph;
+    instruction: string;
+    /** The interactable id that SHOULD rank first / within topK. */
+    expectedInteractableId: string;
+    topK?: number;
+}
+export interface EvalFailure {
+    fixtureId: string;
+    expectedInteractableId: string;
+    returnedIds: string[];
+}
+export interface EvalOptions extends GroundOptions {
+    topK?: number;
+    /** Block threshold for top-1 accuracy (warning when below). Default 1.0 for happy-path fixtures. */
+    minTop1Accuracy?: number;
+    /** Minimum confidence for a rank-0 match to count as a top-1 hit. Default 0.5. */
+    hitConfidence?: number;
+}
+export interface EvalResult {
+    cases: number;
+    top1Accuracy: number;
+    topKAccuracy: number;
+    failures: EvalFailure[];
+    warnings: Warning[];
+}
+export declare function evalGrounding(fixtures: readonly EvalFixture[], opts?: EvalOptions): EvalResult;
+//# sourceMappingURL=eval.d.ts.map

package/dist/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../src/eval.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAQ,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,UAAU,CAiDlG"}

package/dist/eval.js

@@ -0,0 +1,56 @@
+/**
+ * Fixture-only grounding eval harness (regression block alpha, §18.1).
+ * No live capture — drives groundInstruction over golden fixtures and reports
+ * top-K accuracy. A regression in fixture accuracy blocks alpha release.
+ */
+import { warn } from '@visual-layer/core';
+import { groundInstruction } from './score.js';
+export function evalGrounding(fixtures, opts = {}) {
+    const topK = opts.topK ?? 1;
+    const minTop1 = opts.minTop1Accuracy ?? 1.0;
+    const hitConfidence = opts.hitConfidence ?? 0.5;
+    const warnings = [];
+    const failures = [];
+    let top1Hits = 0;
+    let topKHits = 0;
+    let valid = 0;
+    for (const f of fixtures) {
+        if (!f.graph || !f.instruction || !f.expectedInteractableId) {
+            throw invalid(`fixture "${f.id}" missing graph/instruction/expectedInteractableId`);
+        }
+        const ids = new Set(f.graph.interactables.map((i) => i.id));
+        if (!ids.has(f.expectedInteractableId)) {
+            throw invalid(`fixture "${f.id}" expectedInteractableId not present in graph`);
+        }
+        const k = f.topK ?? topK;
+        const { candidates } = groundInstruction(f.graph, f.instruction, { ...opts, topK: k });
+        const returned = candidates.map((c) => c.interactableId);
+        const top = candidates[0];
+        const matched = candidates.find((c) => c.interactableId === f.expectedInteractableId);
+        const matchedConf = matched?.confidence ?? 0;
+        valid++;
+        // top-1 hit requires correct id at rank 0 AND sufficient confidence — weak matches do not count
+        const isTop1Hit = !!top && top.interactableId === f.expectedInteractableId && top.confidence >= hitConfidence;
+        if (isTop1Hit)
+            top1Hits++;
+        // top-K hit requires the expected id within top-K AND the expected's own confidence >= gate
+        if (matched && returned.slice(0, k).includes(f.expectedInteractableId) && matchedConf >= hitConfidence)
+            topKHits++;
+        if (!isTop1Hit) {
+            failures.push({ fixtureId: f.id, expectedInteractableId: f.expectedInteractableId, returnedIds: returned });
+        }
+    }
+    const cases = valid;
+    const top1Accuracy = cases === 0 ? 0 : top1Hits / cases;
+    const topKAccuracy = cases === 0 ? 0 : topKHits / cases;
+    if (cases > 0 && top1Accuracy < minTop1) {
+        warnings.push(warn('eval_below_threshold', `top-1 accuracy ${(top1Accuracy * 100).toFixed(1)}% < ${(minTop1 * 100).toFixed(1)}% threshold`, undefined));
+    }
+    return { cases, top1Accuracy, topKAccuracy, failures, warnings };
+}
+function invalid(detail) {
+    const e = new Error(`fixture_invalid: ${detail}`);
+    e.code = 'fixture_invalid';
+    return e;
+}
+//# sourceMappingURL=eval.js.map

package/dist/eval.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @visual-layer/grounding public surface.
+ */
+export * from './score.js';
+export * from './compare.js';
+export * from './eval.js';
+export declare const GROUNDING_VERSION = "0.1.0";
+//# 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":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,eAAO,MAAM,iBAAiB,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @visual-layer/grounding public surface.
+ */
+export * from './score.js';
+export * from './compare.js';
+export * from './eval.js';
+export const GROUNDING_VERSION = '0.1.0';
+//# 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;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC"}

package/dist/score.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Deterministic grounding scorer. Ranks interactables against a natural-language
+ * instruction using structure-first signals: text similarity, role match, bbox
+ * visibility, source confidence. No model calls (§5 grounding responsibilities).
+ */
+import { type ScreenGraph, type Interactable, type Warning, type Bbox, type ScoreBreakdown } from '@visual-layer/core';
+export interface GroundCandidate {
+    interactableId: string;
+    role?: string;
+    name?: string;
+    bbox: Bbox;
+    confidence: number;
+    scoreBreakdown: ScoreBreakdown;
+    sources: Interactable['source'];
+}
+export interface GroundOptions {
+    topK?: number;
+    /** Minimum composite score to be returned. Default 0.1. */
+    minScore?: number;
+    /** Weights for the composite blend. Need not sum to 1. */
+    weights?: Partial<Record<keyof ScoreBreakdown, number>>;
+}
+export interface GroundResult {
+    candidates: GroundCandidate[];
+    warnings: Warning[];
+}
+export declare function groundInstruction(graph: ScreenGraph, instruction: string, opts?: GroundOptions): GroundResult;
+//# sourceMappingURL=score.d.ts.map

package/dist/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,cAAc,EAMpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAaD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAqEjH"}

package/dist/score.js

@@ -0,0 +1,117 @@
+/**
+ * Deterministic grounding scorer. Ranks interactables against a natural-language
+ * instruction using structure-first signals: text similarity, role match, bbox
+ * visibility, source confidence. No model calls (§5 grounding responsibilities).
+ */
+import { compareText, contains as bboxContains, hasArea, blendConfidence, warn, } from '@visual-layer/core';
+const DEFAULT_WEIGHTS = { text: 0.6, role: 0.15, bbox: 0.1, source: 0.15 };
+const ROLE_HINTS = [
+    { re: /\b(click|press|tap|hit)\b/i, roles: ['button', 'menuitem', 'menuitemcheckbox', 'menuitemradio', 'tab', 'treeitem'] },
+    { re: /\b(open|follow|visit|go to)\b/i, roles: ['link'] },
+    { re: /\b(type|enter|input|fill|fill in|email|password|write)\b/i, roles: ['textbox', 'searchbox', 'spinbutton'] },
+    { re: /\b(search)\b/i, roles: ['searchbox', 'textbox'] },
+    { re: /\b(select|choose|pick|dropdown)\b/i, roles: ['combobox', 'listbox', 'option'] },
+    { re: /\b(check|uncheck|toggle|checkbox)\b/i, roles: ['checkbox', 'switch', 'menuitemcheckbox'] },
+];
+export function groundInstruction(graph, instruction, opts = {}) {
+    const topK = opts.topK ?? 5;
+    const minScore = opts.minScore ?? 0.1;
+    const weights = { ...DEFAULT_WEIGHTS, ...(opts.weights ?? {}) };
+    const warnings = [];
+    if (graph.interactables.length === 0) {
+        return {
+            candidates: [],
+            warnings: [warn('no_candidates', 'graph has no interactables', undefined)],
+        };
+    }
+    const hintedRoles = roleHintsFor(instruction);
+    const scored = graph.interactables.map((i) => {
+        const label = labelFor(i);
+        const text = compareText(instruction, label);
+        const role = roleScore(i, hintedRoles);
+        const bbox = bboxScore(i, graph.viewport);
+        const source = sourceScore(i);
+        const confidence = blendConfidence([
+            { value: text, weight: weights.text ?? 0 },
+            { value: role, weight: weights.role ?? 0 },
+            { value: bbox, weight: weights.bbox ?? 0 },
+            { value: source, weight: weights.source ?? 0 },
+        ]);
+        return { inter: i, confidence, breakdown: { text, role, bbox, source } };
+    });
+    scored.sort((a, b) => b.confidence - a.confidence);
+    // duplicate-label detection among high scorers
+    const labelCounts = new Map();
+    for (const s of scored) {
+        if (s.confidence >= minScore) {
+            const l = labelFor(s.inter);
+            if (l)
+                labelCounts.set(l, (labelCounts.get(l) ?? 0) + 1);
+        }
+    }
+    for (const [label, count] of labelCounts) {
+        if (count > 1)
+            warnings.push(warn('duplicate_label', `"${label}" matched ${count}x`, undefined));
+    }
+    const candidates = scored
+        .filter((s) => s.confidence >= minScore)
+        .slice(0, topK)
+        .map((s) => ({
+        interactableId: s.inter.id,
+        role: s.inter.role,
+        name: s.inter.name,
+        bbox: s.inter.bbox,
+        confidence: round3(s.confidence),
+        scoreBreakdown: {
+            text: round3(s.breakdown.text),
+            role: round3(s.breakdown.role),
+            bbox: round3(s.breakdown.bbox),
+            source: round3(s.breakdown.source),
+        },
+        sources: s.inter.source,
+    }));
+    if (candidates.length === 0) {
+        warnings.push(warn('no_candidates', `no interactable matched "${instruction}"`, undefined));
+    }
+    else if (candidates[0].confidence < 0.5) {
+        warnings.push(warn('low_confidence', `top candidate confidence ${candidates[0].confidence.toFixed(2)} < 0.5`, undefined));
+    }
+    return { candidates, warnings };
+}
+function labelFor(i) {
+    return (i.text ?? i.name ?? '').toString();
+}
+function roleHintsFor(instruction) {
+    for (const h of ROLE_HINTS) {
+        if (h.re.test(instruction))
+            return h.roles;
+    }
+    return null;
+}
+function roleScore(i, hinted) {
+    if (!i.role)
+        return 0.5;
+    if (hinted === null)
+        return 0.7; // neutral — no verb hint in instruction
+    return hinted.includes(i.role.toLowerCase()) ? 1.0 : 0.1;
+}
+function bboxScore(i, viewport) {
+    if (!hasArea(i.bbox))
+        return 0;
+    if (!viewport)
+        return 0.8; // no viewport to test against
+    const vpBbox = [0, 0, viewport.width, viewport.height];
+    return bboxContains(vpBbox, i.bbox) ? 1.0 : 0.4;
+}
+function sourceScore(i) {
+    // more sources = more corroboration
+    if (i.source.includes('dom') && i.source.includes('ax'))
+        return 1.0;
+    if (i.source.length >= 2)
+        return 0.9;
+    return 0.8;
+}
+function round3(n) {
+    return Math.round(n * 1000) / 1000;
+}
+//# sourceMappingURL=score.js.map

package/dist/score.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@visual-layer/grounding",
+  "version": "1.0.0",
+  "description": "Deterministic grounding scorer, compare_graphs, eval_grounding",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/locotine/vision-layer.git",
+    "directory": "packages/grounding"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@visual-layer/core": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b"
+  }
+}