cbrowser 18.76.0 → 18.78.0

package/dist/visual/attention-ai-layer.js

@@ -0,0 +1,233 @@
+/**
+ * AI attention layer — persona-aware semantic reading of the rendered page.
+ *
+ * WHAT THE EXISTING TWO LAYERS CANNOT SEE
+ *
+ * Layer 1 (bottom-up saliency) knows where colour and texture pop. Layer 2
+ * (DOM semantics) knows element TYPE — CTA, heading, nav — times persona
+ * priority, plus keyword overlap with the goal. Neither knows what the content
+ * MEANS to this particular person. "Start free trial" and "Contact enterprise
+ * sales" are both CTAs of identical type and similar contrast; to a
+ * price-anxious first-timer they are not remotely the same object. Nor do the
+ * first two layers read text baked into images, judge compositional hierarchy
+ * (size, whitespace, alignment), or model reading order.
+ *
+ * That is the headroom this layer addresses: meaning, weighted by what this
+ * persona values.
+ *
+ * WHY IT IS A SEPARATE LAYER AND NOT A BLEND
+ *
+ * The deliberate design choice, and the one worth defending. Layers 1 and 2 are
+ * deterministic — the same screenshot yields the same map, which is what makes
+ * visual baselines and regression comparisons meaningful. An LLM's opinion is
+ * not deterministic, and silently averaging it into the same `saliency` number
+ * would make every downstream metric unreproducible while looking unchanged.
+ * This codebase has repeatedly shipped exactly that shape: a value quietly
+ * folded in under a name that already meant something else.
+ *
+ * So the AI regions are returned ALONGSIDE, named, with the model's own
+ * reasoning attached, and a caller opts in explicitly. A blended convenience
+ * field exists but says so in `attentionModel`.
+ *
+ * WHAT WE CANNOT CURRENTLY CLAIM
+ *
+ * There is no eye-tracking ground truth in this repository, so there is no
+ * measurement that says this layer makes the map more accurate — only that it
+ * makes it different. It is offered as an interpretive aid, and its output is
+ * labelled as a model's judgement rather than a measurement. Validating it
+ * needs a fixation dataset; until then, treat confident agreement between this
+ * layer and the other two as the useful signal, and disagreement as a question,
+ * not an answer.
+ *
+ * @copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com https://cbrowser.ai
+ * @license MIT
+ */
+import { createHash } from "crypto";
+import { readFileSync, existsSync, mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const CACHE_DIR = join(process.env.CBROWSER_DATA_DIR || join(homedir(), ".cbrowser"), "ai-attention-cache");
+/**
+ * Cache key covers everything that can change the answer: the exact image, the
+ * persona, the goal, the values and the model. An LLM layer is only usable in a
+ * regression context if repeating a run repeats the answer — and it makes the
+ * layer nearly free on re-analysis of an unchanged page.
+ */
+function cacheKey(imageBytes, persona, goal, values, model) {
+    const h = createHash("sha256");
+    h.update(imageBytes);
+    h.update(`|${persona}|${goal ?? ""}|${model}|`);
+    h.update(JSON.stringify(values ?? {}));
+    return h.digest("hex").slice(0, 32);
+}
+function readCache(key) {
+    try {
+        const p = join(CACHE_DIR, `${key}.json`);
+        if (!existsSync(p))
+            return null;
+        return { ...JSON.parse(readFileSync(p, "utf8")), cached: true };
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(key, value) {
+    try {
+        if (!existsSync(CACHE_DIR))
+            mkdirSync(CACHE_DIR, { recursive: true });
+        writeFileSync(join(CACHE_DIR, `${key}.json`), JSON.stringify(value));
+    }
+    catch {
+        /* cache is an optimisation; never fail the analysis for it */
+    }
+}
+/** Describe persona values in words the model can act on. */
+function describeValues(values) {
+    if (!values)
+        return "No specific motivational profile supplied.";
+    const notable = Object.entries(values)
+        .filter(([, v]) => typeof v === "number" && (v >= 0.7 || v <= 0.3))
+        .map(([k, v]) => `${k}=${v.toFixed(2)} (${v >= 0.7 ? "high" : "low"})`);
+    return notable.length ? notable.join(", ") : "Values are mid-range across the board.";
+}
+/**
+ * Ask the model where this persona looks and why.
+ *
+ * Returns `unavailable` rather than throwing when there is no key or the call
+ * fails: this layer is additive, and an attention map without it is the same
+ * map the product shipped before it existed.
+ */
+export async function analyzeAttentionWithAI(screenshotPath, persona, options = {}) {
+    const { getAnthropicApiKey, getAnthropicModel, isApiKeyConfigured } = await import("../cognitive/index.js");
+    if (!isApiKeyConfigured()) {
+        return {
+            regions: [],
+            narrative: "",
+            model: "",
+            cached: false,
+            unavailable: "No Anthropic API key configured. The AI attention layer is opt-in and keyed; the visual and semantic layers are unaffected.",
+        };
+    }
+    let bytes;
+    try {
+        bytes = readFileSync(screenshotPath);
+    }
+    catch {
+        return { regions: [], narrative: "", model: "", cached: false, unavailable: `Could not read ${screenshotPath}` };
+    }
+    const model = getAnthropicModel();
+    const key = cacheKey(bytes, persona, options.goal, options.values, model);
+    const hit = readCache(key);
+    if (hit)
+        return hit;
+    const dims = options.imageWidth && options.imageHeight
+        ? `The image is ${options.imageWidth}x${options.imageHeight} pixels.`
+        : "Coordinates must be in the image's own pixel space.";
+    const system = `You model visual attention for a specific person looking at a web page. You are not describing what is on the page — you are predicting where THIS person's eyes go, and why, given who they are.
+
+Return ONLY a JSON object, no prose outside it:
+{"regions":[{"rect":{"x":0,"y":0,"width":0,"height":0},"weight":0.0,"label":"","reasoning":""}],"narrative":""}
+
+Rules:
+- ${dims} Coordinates are top-left origin.
+- weight is 0-1: how strongly this person attends, relative to everything else on the page.
+- Return at most 8 regions. Fewer is better than padding.
+- reasoning must name something about THIS PERSON, not the page in general. "Large red button" is a description; "a price-anxious first-timer checks cost before anything else, so the pricing link pulls first" is a prediction.
+- Attend to what the DOM cannot express: what the copy MEANS to them, text inside images, compositional hierarchy, and what they will deliberately SKIP.
+- narrative: 2-4 sentences on how this person reads this page.`;
+    const goalLine = options.goal
+        ? `They are trying to: ${options.goal}. Goal-relevant content should dominate.`
+        : `They have no specific task — this is undirected first-contact browsing.`;
+    const user = `Person: ${persona}
+${options.personaDescription ? `Who they are: ${options.personaDescription}` : ""}
+Motivational profile: ${describeValues(options.values)}
+${goalLine}
+
+Where do their eyes go on this page, and why?`;
+    try {
+        const { default: Anthropic } = await import("@anthropic-ai/sdk");
+        const client = new Anthropic({ apiKey: getAnthropicApiKey() });
+        const response = await client.messages.create({
+            model,
+            max_tokens: 1500,
+            system,
+            messages: [
+                {
+                    role: "user",
+                    content: [
+                        {
+                            type: "image",
+                            source: { type: "base64", media_type: "image/png", data: bytes.toString("base64") },
+                        },
+                        { type: "text", text: user },
+                    ],
+                },
+            ],
+        });
+        const text = response.content[0]?.type === "text" ? response.content[0].text : "";
+        const match = text.match(/\{[\s\S]*\}/);
+        if (!match) {
+            return { regions: [], narrative: "", model, cached: false, unavailable: "Model returned no parseable JSON" };
+        }
+        const parsed = JSON.parse(match[0]);
+        const result = {
+            // Clamp rather than trust: a hallucinated weight of 12 would silently
+            // dominate any blend it is fed into.
+            regions: (parsed.regions ?? []).slice(0, 8).map((r) => ({
+                rect: {
+                    x: Math.max(0, Math.round(r.rect?.x ?? 0)),
+                    y: Math.max(0, Math.round(r.rect?.y ?? 0)),
+                    width: Math.max(1, Math.round(r.rect?.width ?? 1)),
+                    height: Math.max(1, Math.round(r.rect?.height ?? 1)),
+                },
+                weight: Math.min(1, Math.max(0, Number(r.weight) || 0)),
+                label: String(r.label ?? "").slice(0, 120),
+                reasoning: String(r.reasoning ?? "").slice(0, 400),
+            })),
+            narrative: String(parsed.narrative ?? "").slice(0, 1200),
+            model,
+            cached: false,
+        };
+        writeCache(key, result);
+        return result;
+    }
+    catch (err) {
+        return {
+            regions: [],
+            narrative: "",
+            model,
+            cached: false,
+            unavailable: `AI attention layer failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/**
+ * Rasterise AI regions onto the analysis grid so they can be compared with, or
+ * blended into, the existing saliency cells.
+ *
+ * Kept separate from the fetch so a caller can display the regions and their
+ * reasoning WITHOUT blending — which is the recommended use, since the blend
+ * makes the map non-deterministic.
+ */
+export function aiRegionsToGrid(regions, rows, cols, imageWidth, imageHeight) {
+    const grid = new Float64Array(rows * cols);
+    if (regions.length === 0 || imageWidth <= 0 || imageHeight <= 0)
+        return grid;
+    for (const region of regions) {
+        const c0 = Math.max(0, Math.floor((region.rect.x / imageWidth) * cols));
+        const c1 = Math.min(cols - 1, Math.ceil(((region.rect.x + region.rect.width) / imageWidth) * cols) - 1);
+        const r0 = Math.max(0, Math.floor((region.rect.y / imageHeight) * rows));
+        const r1 = Math.min(rows - 1, Math.ceil(((region.rect.y + region.rect.height) / imageHeight) * rows) - 1);
+        for (let r = r0; r <= r1; r++) {
+            for (let c = c0; c <= c1; c++) {
+                const i = r * cols + c;
+                // Max, not sum: overlapping regions should not compound into a hotspot
+                // that neither region claimed on its own.
+                if (region.weight > grid[i])
+                    grid[i] = region.weight;
+            }
+        }
+    }
+    return grid;
+}
+//# sourceMappingURL=attention-ai-layer.js.map

package/dist/visual/attention-ai-layer.js.map

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

package/dist/visual/fixation-corpus.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Fixation corpora — human eye-tracking ground truth, in one shape.
+ *
+ * WHAT A CORPUS IS FOR HERE
+ *
+ * Three distinct uses, and conflating them is how saliency work goes wrong:
+ *
+ *   1. VALIDATION — score the shipped model against human fixations. This is
+ *      what makes an accuracy claim sayable out loud. Study 1 did this against
+ *      UEyes and reported AUC-Judd 0.663 / NSS 0.544 / CC 0.216.
+ *   2. CALIBRATION — tune model parameters (channel weights, surround radius,
+ *      cell size) to maximise those metrics. Legitimate, but it spends the
+ *      corpus: a model tuned on a set can no longer be honestly validated on
+ *      that same set, which is why `split` exists below.
+ *   3. PRIORS — derive empirical structure from the corpus and bake it into the
+ *      model. A centre-bias prior alone lifts AUC substantially on almost any
+ *      dataset, because humans fixate the middle regardless of content.
+ *
+ * The interface is deliberately corpus-agnostic. UEyes is what is on disk
+ * today; MIT1003, CAT2000 and SALICON have the same shape (images + fixation
+ * points + density maps) and should not need new plumbing.
+ *
+ * WHAT UEYES GIVES THAT MOST CORPORA DO NOT
+ *
+ * - It is WEB PAGES (1980 of them), not natural scenes. Saliency models tuned on
+ *   photographs transfer poorly to interfaces, where text and affordances
+ *   dominate.
+ * - Fixation maps at 1s / 3s / 7s separately. Attention at first impression is
+ *   not attention after consideration, and cbrowser's personas differ precisely
+ *   on patience — an impatient persona should be scored against 1s, a thorough
+ *   one against 7s. Scoring every persona against one horizon throws that away.
+ * - Per-fixation logs with duration and saccade magnitude/direction, so scanpath
+ *   ORDER is available, not just aggregate density.
+ *
+ * @copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com https://cbrowser.ai
+ * @license MIT
+ */
+import type { Fixation, SaliencyGrid } from "./saliency-metrics.js";
+/** Viewing durations UEyes separates. Others may expose only one. */
+export type FixationHorizon = "1s" | "3s" | "7s";
+export interface CorpusStimulus {
+    /** Stable id — the image filename without extension. */
+    id: string;
+    /** Absolute path to the stimulus image. */
+    imagePath: string;
+    /** Ground-truth fixation density map per horizon, when the corpus has them. */
+    fixationMaps: Partial<Record<FixationHorizon, string>>;
+}
+export interface CorpusInfo {
+    name: string;
+    root: string;
+    stimuli: CorpusStimulus[];
+    horizons: FixationHorizon[];
+    /** Absent when the corpus ships only density maps and no raw logs. */
+    fixationLogDir?: string;
+    citation: string;
+}
+/**
+ * One participant fixation as recorded by the tracker.
+ *
+ * Coordinates are NORMALIZED 0-1 in the source logs and stay that way here.
+ * Converting to pixels requires the stimulus dimensions, and doing it at load
+ * time — before the caller says which grid they are scoring against — is how
+ * coordinate-space bugs get baked in. `fixationsToGrid` does the conversion at
+ * the point the target size is actually known.
+ */
+export interface RawFixation {
+    /** 0-1, left to right. */
+    xNorm: number;
+    /** 0-1, top to bottom. */
+    yNorm: number;
+    /** Dwell in seconds. */
+    duration: number;
+    /** Seconds since stimulus onset — this is what makes horizon filtering possible. */
+    startTime: number;
+    participantId: string;
+    stimulusId: string;
+}
+/**
+ * Discover a UEyes-layout corpus.
+ *
+ * Returns null rather than throwing when the directory is absent: the corpus is
+ * 13GB and is not, and should not be, a dependency of the shipped package.
+ * Anything that needs it degrades to "not available" rather than failing.
+ */
+export declare function loadUEyesCorpus(root: string): CorpusInfo | null;
+/**
+ * Parse one Gazepoint-format tracker log.
+ *
+ * The columns that matter: MEDIA_NAME (which stimulus), FPOGX/FPOGY (gaze point
+ * of regard, normalized), FPOGD (duration), FPOGS (start time), FPOGV (valid).
+ *
+ * INVALID SAMPLES ARE DROPPED, not clamped. FPOGV=0 means the tracker lost the
+ * eye — a blink, a look away, a calibration slip. Those rows still carry
+ * coordinates, and treating them as fixations manufactures ground truth from
+ * noise. Off-screen coordinates are dropped for the same reason.
+ */
+export declare function parseGazepointLog(logPath: string): RawFixation[];
+/**
+ * Keep only fixations that occurred within `seconds` of stimulus onset.
+ *
+ * This is what lets a persona be scored against the horizon that matches it: an
+ * impatient persona compared to 1s of human viewing, a thorough one to 7s.
+ * Comparing every persona to the same aggregate map discards the one dimension
+ * this corpus was built to expose.
+ */
+export declare function filterByHorizon(fixations: RawFixation[], seconds: number): RawFixation[];
+/** Convert normalized fixations to a grid's pixel space. */
+export declare function toGridFixations(fixations: RawFixation[], gridWidth: number, gridHeight: number): Fixation[];
+/**
+ * Build a fixation density map by accumulating Gaussian blobs.
+ *
+ * Ground-truth maps ship with UEyes, but a corpus that provides only raw logs
+ * needs this to score CC at all. Sigma is in grid cells; the literature
+ * convention is roughly one degree of visual angle, and for a 32x32 analysis
+ * grid that lands near 1.
+ */
+export declare function fixationsToGrid(fixations: Fixation[], width: number, height: number, sigma?: number): SaliencyGrid;
+/**
+ * Deterministic train/test split.
+ *
+ * Calibrating on a corpus and then reporting accuracy on the same corpus is
+ * measuring how well the parameters were fitted, not how well the model
+ * generalises — and it is the single easiest way to publish a number that does
+ * not survive review. The split is by stimulus id hash so it is stable across
+ * runs and machines without storing a manifest.
+ */
+export declare function splitCorpus(corpus: CorpusInfo, testFraction?: number): {
+    train: CorpusStimulus[];
+    test: CorpusStimulus[];
+};
+//# sourceMappingURL=fixation-corpus.d.ts.map

package/dist/visual/fixation-corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixation-corpus.d.ts","sourceRoot":"","sources":["../../src/visual/fixation-corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEpE,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAgC/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CA+ChE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAExF;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAC7B,SAAS,EAAE,WAAW,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,QAAQ,EAAE,CAMZ;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,SAAM,GACV,YAAY,CAoBd;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,YAAY,SAAM,GACjB;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,IAAI,EAAE,cAAc,EAAE,CAAA;CAAE,CAarD"}

package/dist/visual/fixation-corpus.js

@@ -0,0 +1,212 @@
+/**
+ * Fixation corpora — human eye-tracking ground truth, in one shape.
+ *
+ * WHAT A CORPUS IS FOR HERE
+ *
+ * Three distinct uses, and conflating them is how saliency work goes wrong:
+ *
+ *   1. VALIDATION — score the shipped model against human fixations. This is
+ *      what makes an accuracy claim sayable out loud. Study 1 did this against
+ *      UEyes and reported AUC-Judd 0.663 / NSS 0.544 / CC 0.216.
+ *   2. CALIBRATION — tune model parameters (channel weights, surround radius,
+ *      cell size) to maximise those metrics. Legitimate, but it spends the
+ *      corpus: a model tuned on a set can no longer be honestly validated on
+ *      that same set, which is why `split` exists below.
+ *   3. PRIORS — derive empirical structure from the corpus and bake it into the
+ *      model. A centre-bias prior alone lifts AUC substantially on almost any
+ *      dataset, because humans fixate the middle regardless of content.
+ *
+ * The interface is deliberately corpus-agnostic. UEyes is what is on disk
+ * today; MIT1003, CAT2000 and SALICON have the same shape (images + fixation
+ * points + density maps) and should not need new plumbing.
+ *
+ * WHAT UEYES GIVES THAT MOST CORPORA DO NOT
+ *
+ * - It is WEB PAGES (1980 of them), not natural scenes. Saliency models tuned on
+ *   photographs transfer poorly to interfaces, where text and affordances
+ *   dominate.
+ * - Fixation maps at 1s / 3s / 7s separately. Attention at first impression is
+ *   not attention after consideration, and cbrowser's personas differ precisely
+ *   on patience — an impatient persona should be scored against 1s, a thorough
+ *   one against 7s. Scoring every persona against one horizon throws that away.
+ * - Per-fixation logs with duration and saccade magnitude/direction, so scanpath
+ *   ORDER is available, not just aggregate density.
+ *
+ * @copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com https://cbrowser.ai
+ * @license MIT
+ */
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join, basename, extname } from "path";
+/**
+ * Discover a UEyes-layout corpus.
+ *
+ * Returns null rather than throwing when the directory is absent: the corpus is
+ * 13GB and is not, and should not be, a dependency of the shipped package.
+ * Anything that needs it degrades to "not available" rather than failing.
+ */
+export function loadUEyesCorpus(root) {
+    const imagesDir = join(root, "images");
+    if (!existsSync(imagesDir))
+        return null;
+    const horizons = [];
+    for (const h of ["1s", "3s", "7s"]) {
+        if (existsSync(join(root, "saliency_maps", `fixmaps_${h}`)))
+            horizons.push(h);
+    }
+    const stimuli = [];
+    for (const file of readdirSync(imagesDir)) {
+        const ext = extname(file).toLowerCase();
+        if (ext !== ".jpg" && ext !== ".png" && ext !== ".jpeg")
+            continue;
+        const id = basename(file, ext);
+        const fixationMaps = {};
+        for (const h of horizons) {
+            const candidate = join(root, "saliency_maps", `fixmaps_${h}`, file);
+            if (existsSync(candidate))
+                fixationMaps[h] = candidate;
+        }
+        stimuli.push({ id, imagePath: join(imagesDir, file), fixationMaps });
+    }
+    const logDir = join(root, "eyetracker_logs");
+    return {
+        name: "UEyes",
+        root,
+        stimuli: stimuli.sort((a, b) => a.id.localeCompare(b.id)),
+        horizons,
+        fixationLogDir: existsSync(logDir) ? logDir : undefined,
+        citation: "Jiang et al., UEyes: Understanding Visual Saliency across User Interface Types. CHI 2023.",
+    };
+}
+/**
+ * Parse one Gazepoint-format tracker log.
+ *
+ * The columns that matter: MEDIA_NAME (which stimulus), FPOGX/FPOGY (gaze point
+ * of regard, normalized), FPOGD (duration), FPOGS (start time), FPOGV (valid).
+ *
+ * INVALID SAMPLES ARE DROPPED, not clamped. FPOGV=0 means the tracker lost the
+ * eye — a blink, a look away, a calibration slip. Those rows still carry
+ * coordinates, and treating them as fixations manufactures ground truth from
+ * noise. Off-screen coordinates are dropped for the same reason.
+ */
+export function parseGazepointLog(logPath) {
+    const text = readFileSync(logPath, "utf8");
+    const lines = text.split("\n").filter((l) => l.trim().length > 0);
+    if (lines.length < 2)
+        return [];
+    const header = lines[0].split(",").map((h) => h.trim());
+    const col = (name) => header.findIndex((h) => h === name || h.startsWith(`${name}(`));
+    const iMedia = col("MEDIA_NAME");
+    const iX = col("FPOGX");
+    const iY = col("FPOGY");
+    const iD = col("FPOGD");
+    const iS = col("FPOGS");
+    const iV = col("FPOGV");
+    const iId = col("FPOGID");
+    if (iX < 0 || iY < 0)
+        return [];
+    const participantId = basename(logPath).replace(/_fixations\.csv$/i, "");
+    const out = [];
+    const seen = new Set();
+    for (let i = 1; i < lines.length; i++) {
+        const parts = lines[i].split(",");
+        if (iV >= 0 && parts[iV]?.trim() !== "1")
+            continue; // tracker lost the eye
+        const xNorm = Number(parts[iX]);
+        const yNorm = Number(parts[iY]);
+        if (!Number.isFinite(xNorm) || !Number.isFinite(yNorm))
+            continue;
+        if (xNorm < 0 || xNorm > 1 || yNorm < 0 || yNorm > 1)
+            continue; // off-stimulus
+        // One row per SAMPLE, many samples per fixation. Deduplicate on FPOGID so a
+        // long fixation counts once — otherwise dwell time silently becomes a vote
+        // multiplier and every metric is weighted by how long the tracker sampled.
+        const fixId = iId >= 0 ? parts[iId]?.trim() : undefined;
+        const media = iMedia >= 0 ? (parts[iMedia] ?? "").trim() : "";
+        const key = `${media}|${fixId ?? `${i}`}`;
+        if (fixId && seen.has(key))
+            continue;
+        if (fixId)
+            seen.add(key);
+        out.push({
+            xNorm,
+            yNorm,
+            duration: iD >= 0 ? Number(parts[iD]) || 0 : 0,
+            startTime: iS >= 0 ? Number(parts[iS]) || 0 : 0,
+            participantId,
+            stimulusId: media ? basename(media, extname(media)) : "",
+        });
+    }
+    return out;
+}
+/**
+ * Keep only fixations that occurred within `seconds` of stimulus onset.
+ *
+ * This is what lets a persona be scored against the horizon that matches it: an
+ * impatient persona compared to 1s of human viewing, a thorough one to 7s.
+ * Comparing every persona to the same aggregate map discards the one dimension
+ * this corpus was built to expose.
+ */
+export function filterByHorizon(fixations, seconds) {
+    return fixations.filter((f) => f.startTime <= seconds);
+}
+/** Convert normalized fixations to a grid's pixel space. */
+export function toGridFixations(fixations, gridWidth, gridHeight) {
+    return fixations.map((f) => ({
+        x: f.xNorm * gridWidth,
+        y: f.yNorm * gridHeight,
+        duration: f.duration * 1000,
+    }));
+}
+/**
+ * Build a fixation density map by accumulating Gaussian blobs.
+ *
+ * Ground-truth maps ship with UEyes, but a corpus that provides only raw logs
+ * needs this to score CC at all. Sigma is in grid cells; the literature
+ * convention is roughly one degree of visual angle, and for a 32x32 analysis
+ * grid that lands near 1.
+ */
+export function fixationsToGrid(fixations, width, height, sigma = 1.0) {
+    const values = new Float64Array(width * height);
+    const radius = Math.max(1, Math.ceil(sigma * 3));
+    const twoSigmaSq = 2 * sigma * sigma;
+    for (const f of fixations) {
+        const cx = f.x;
+        const cy = f.y;
+        const x0 = Math.max(0, Math.floor(cx - radius));
+        const x1 = Math.min(width - 1, Math.ceil(cx + radius));
+        const y0 = Math.max(0, Math.floor(cy - radius));
+        const y1 = Math.min(height - 1, Math.ceil(cy + radius));
+        for (let y = y0; y <= y1; y++) {
+            for (let x = x0; x <= x1; x++) {
+                const d2 = (x + 0.5 - cx) ** 2 + (y + 0.5 - cy) ** 2;
+                values[y * width + x] += Math.exp(-d2 / twoSigmaSq);
+            }
+        }
+    }
+    return { values, width, height };
+}
+/**
+ * Deterministic train/test split.
+ *
+ * Calibrating on a corpus and then reporting accuracy on the same corpus is
+ * measuring how well the parameters were fitted, not how well the model
+ * generalises — and it is the single easiest way to publish a number that does
+ * not survive review. The split is by stimulus id hash so it is stable across
+ * runs and machines without storing a manifest.
+ */
+export function splitCorpus(corpus, testFraction = 0.3) {
+    const hash = (s) => {
+        let h = 2166136261;
+        for (let i = 0; i < s.length; i++) {
+            h ^= s.charCodeAt(i);
+            h = Math.imul(h, 16777619);
+        }
+        return (h >>> 0) / 4294967296;
+    };
+    const train = [];
+    const test = [];
+    for (const s of corpus.stimuli)
+        (hash(s.id) < testFraction ? test : train).push(s);
+    return { train, test };
+}
+//# sourceMappingURL=fixation-corpus.js.map

package/dist/visual/fixation-corpus.js.map

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