cbrowser 18.40.0 → 18.41.0

package/dist/visual/cognitive-models.js

@@ -0,0 +1,447 @@
+/**
+ * Cognitive Models — Formal implementations from cognitive science
+ *
+ * Layer 4: Grossman & Balakrishnan (2005) probabilistic pointing model
+ * Layer 6: Perry, Zorzi & Ziegler (2019) multi-deficit reading model
+ *
+ * These replace the heuristic multipliers in cognitive-transport.ts
+ * with empirically grounded computational models.
+ *
+ * @see Grossman & Balakrishnan (2005) ACM TOCHI — probabilistic 2D pointing
+ * @see Perry, Zorzi & Ziegler (2019) Psychological Science — personalized dyslexia models
+ * @since v18.39.0
+ */
+// ── Mathematical Primitives ──
+/**
+ * Standard normal CDF (cumulative distribution function).
+ * Abramowitz and Stegun approximation (7.1.26), error < 7.5e-8.
+ */
+function normalCDF(x) {
+    const a1 = 0.254829592;
+    const a2 = -0.284496736;
+    const a3 = 1.421413741;
+    const a4 = -1.453152027;
+    const a5 = 1.061405429;
+    const p = 0.3275911;
+    const sign = x < 0 ? -1 : 1;
+    const absX = Math.abs(x) / Math.SQRT2;
+    const t = 1 / (1 + p * absX);
+    const y = 1 - (((((a5 * t + a4) * t) + a3) * t + a2) * t + a1) * t * Math.exp(-absX * absX);
+    return 0.5 * (1 + sign * y);
+}
+/**
+ * Standard normal PDF (probability density function).
+ */
+function normalPDF(x) {
+    return Math.exp(-0.5 * x * x) / Math.sqrt(2 * Math.PI);
+}
+/**
+ * Known pointing profiles from the empirical literature.
+ *
+ * - Neurotypical baseline: MacKenzie (1992), Soukoreff & MacKenzie (2004)
+ * - Motor tremor: Hwang et al. (2004) ACM ASSETS
+ * - Elderly 65+: Chaparro et al. (1999), Ketcham et al. (2002)
+ * - ADHD: Flapper et al. (2006) — impulsive timing, near-normal precision
+ */
+const KNOWN_POINTING_PROFILES = {
+    neurotypical: { sigmaX: 4, sigmaY: 4, rho: 0.0, throughput: 4.9 },
+    tremor: { sigmaX: 12, sigmaY: 12, rho: 0.3, throughput: 2.1 },
+    elderly: { sigmaX: 7.2, sigmaY: 7.2, rho: 0.1, throughput: 3.2 },
+    adhd: { sigmaX: 5.5, sigmaY: 5.5, rho: 0.0, throughput: 4.2 },
+};
+/**
+ * Derive a pointing profile from persona traits.
+ *
+ * Maps cognitive trait values to motor parameters by interpolating
+ * between known empirical profiles. Uses `motorPrecision` (derived from
+ * proceduralFluency and patience) as the primary interpolation axis.
+ *
+ * @param persona - Persona traits object with cognitive dimensions
+ * @returns Empirically calibrated pointing profile
+ */
+export function getPointingProfile(persona) {
+    const traits = persona.traits ?? {};
+    const a11y = persona.accessibilityTraits ?? {};
+    // Check for explicit tremor trait
+    if (a11y.tremor) {
+        return { ...KNOWN_POINTING_PROFILES.tremor };
+    }
+    // Check for persona name hints
+    const name = (persona.name ?? '').toLowerCase();
+    if (name.includes('tremor') || name.includes('parkinson')) {
+        return { ...KNOWN_POINTING_PROFILES.tremor };
+    }
+    if (name.includes('elderly') || name.includes('senior') || name.includes('aging')) {
+        return { ...KNOWN_POINTING_PROFILES.elderly };
+    }
+    if (name.includes('adhd')) {
+        return { ...KNOWN_POINTING_PROFILES.adhd };
+    }
+    // Derive motorPrecision from available traits
+    // motorPrecision is a composite of fine motor control indicators
+    const motorPrecision = traits.motorPrecision
+        ?? (traits.proceduralFluency !== undefined && traits.patience !== undefined
+            ? (traits.proceduralFluency * 0.6 + traits.patience * 0.4)
+            : undefined);
+    if (motorPrecision === undefined) {
+        return { ...KNOWN_POINTING_PROFILES.neurotypical };
+    }
+    // Interpolate between profiles based on motorPrecision (0-1)
+    // 1.0 = neurotypical, 0.0 = severe impairment (tremor)
+    const clamped = Math.max(0, Math.min(1, motorPrecision));
+    const neuro = KNOWN_POINTING_PROFILES.neurotypical;
+    const impaired = KNOWN_POINTING_PROFILES.tremor;
+    return {
+        sigmaX: neuro.sigmaX + (impaired.sigmaX - neuro.sigmaX) * (1 - clamped),
+        sigmaY: neuro.sigmaY + (impaired.sigmaY - neuro.sigmaY) * (1 - clamped),
+        rho: neuro.rho + (impaired.rho - neuro.rho) * (1 - clamped),
+        throughput: neuro.throughput + (impaired.throughput - neuro.throughput) * (1 - clamped),
+    };
+}
+/**
+ * Compute the probability that a user hits a rectangular target.
+ *
+ * Grossman & Balakrishnan (2005) bivariate normal integral over target rectangle.
+ * For independent axes (rho=0): P(hit) = Phi(W/(2*sigmaX)) * Phi(H/(2*sigmaY))
+ * For correlated axes (rho!=0): applies the Plackett (1954) correction term.
+ *
+ * Assumes the user aims at the target center (optimal aiming point).
+ *
+ * @param target - Target element dimensions
+ * @param profile - User's pointing profile
+ * @returns Hit probability in [0, 1]
+ */
+export function computeHitProbability(target, profile) {
+    const { width, height } = target;
+    const { sigmaX, sigmaY, rho } = profile;
+    // Guard: degenerate targets
+    if (width <= 0 || height <= 0)
+        return 0;
+    if (sigmaX <= 0 || sigmaY <= 0)
+        return 1;
+    // Standardized half-widths
+    const zx = width / (2 * sigmaX);
+    const zy = height / (2 * sigmaY);
+    // CDF of standard normal at the standardized edges
+    // P(|X| < W/2) = 2*Phi(W/(2*sigma)) - 1
+    const pX = 2 * normalCDF(zx) - 1;
+    const pY = 2 * normalCDF(zy) - 1;
+    // Independent-axis approximation (exact for rho=0)
+    const pIndependent = pX * pY;
+    if (Math.abs(rho) < 1e-6) {
+        return pIndependent;
+    }
+    // Correlated correction (Grossman & Balakrishnan's approximation)
+    // P(hit) ~= Phi_x * Phi_y * (1 + rho * phi(zx) * phi(zy) / (Phi_x * Phi_y))
+    // where phi is PDF and Phi is the one-sided CDF P(|X| < ...)
+    const phiX = normalPDF(zx);
+    const phiY = normalPDF(zy);
+    if (pX < 1e-10 || pY < 1e-10) {
+        return pIndependent;
+    }
+    const correction = 1 + rho * phiX * phiY / (pX * pY);
+    // Clamp to valid probability range
+    return Math.max(0, Math.min(1, pIndependent * correction));
+}
+/**
+ * Compute Fitts' Law movement time for reaching a target.
+ *
+ * Uses the Shannon formulation (MacKenzie 1992, ISO 9241-9):
+ *   MT = (1/throughput) * log2(D/W + 1)
+ *
+ * @param distance - Distance to target center in pixels
+ * @param width - Effective target width in the movement direction (pixels)
+ * @param throughput - User's Fitts' throughput in bits/s
+ * @returns Movement time in milliseconds
+ */
+export function computeFittsTime(distance, width, throughput) {
+    if (distance <= 0 || width <= 0 || throughput <= 0)
+        return 0;
+    const indexOfDifficulty = Math.log2(distance / width + 1);
+    return (1 / throughput) * indexOfDifficulty * 1000;
+}
+/**
+ * Compute motor accessibility for a set of target elements.
+ *
+ * For each element, computes hit probability and movement time using the
+ * Grossman & Balakrishnan pointing model and Fitts' Law. Identifies
+ * motor barriers: elements where P(hit) falls below a persona-adjusted threshold.
+ *
+ * Barrier thresholds (from WCAG 2.5 / AAA guidance):
+ * - Neurotypical (throughput >= 4.0): P(hit) < 0.85 is a barrier
+ * - Impaired (throughput < 4.0): P(hit) < 0.70 is a barrier (relaxed standard)
+ *
+ * @param targets - Interactive elements on the page
+ * @param persona - Persona to evaluate for
+ * @returns Motor accessibility result with per-element breakdown
+ */
+export function motorAccessibility(targets, persona) {
+    if (targets.length === 0) {
+        return { elements: [], score: 1, barrierCount: 0, transportCost: 0 };
+    }
+    const profile = getPointingProfile(persona);
+    const barrierThreshold = profile.throughput >= 4.0 ? 0.85 : 0.70;
+    const elements = targets.map(target => {
+        const hitProbability = computeHitProbability(target, profile);
+        // Use geometric mean of width and height as effective width for Fitts
+        const effectiveWidth = Math.sqrt(target.width * target.height);
+        const movementTime = computeFittsTime(target.distance, effectiveWidth, profile.throughput);
+        return {
+            selector: target.selector,
+            hitProbability: Math.round(hitProbability * 10000) / 10000,
+            movementTime: Math.round(movementTime),
+            isBarrier: hitProbability < barrierThreshold,
+        };
+    });
+    const barrierCount = elements.filter(e => e.isBarrier).length;
+    const meanHitProbability = elements.reduce((sum, e) => sum + e.hitProbability, 0) / elements.length;
+    const score = Math.round(meanHitProbability * 10000) / 10000;
+    const transportCost = Math.round((1 - score) * 10000) / 10000;
+    return { elements, score, barrierCount, transportCost };
+}
+/**
+ * Known reading profiles from the empirical literature.
+ *
+ * - Neurotypical: Rayner (2009) — typical college reader
+ * - Dyslexic: Perry, Zorzi & Ziegler (2019) Psychological Science
+ * - Low vision: Legge et al. (2007) — central scotoma and crowding
+ * - ADHD: Dhar et al. (2010) — intact decoding, reduced sustained attention
+ * - Elderly: Rayner et al. (2006) — aging effects on eye movements
+ */
+const KNOWN_READING_PROFILES = {
+    neurotypical: { orthographic: 0.85, phonological: 0.80, visualSpan: 7, vocabulary: 0.75, crowding: 0.15 },
+    dyslexic: { orthographic: 0.40, phonological: 0.35, visualSpan: 4, vocabulary: 0.65, crowding: 0.55 },
+    lowVision: { orthographic: 0.60, phonological: 0.75, visualSpan: 3, vocabulary: 0.75, crowding: 0.70 },
+    adhd: { orthographic: 0.80, phonological: 0.75, visualSpan: 6, vocabulary: 0.70, crowding: 0.20 },
+    elderly: { orthographic: 0.70, phonological: 0.65, visualSpan: 5, vocabulary: 0.85, crowding: 0.30 },
+};
+/**
+ * Derive a reading profile from persona traits.
+ *
+ * Maps cognitive trait values to reading parameters by selecting the
+ * closest known profile and interpolating with the neurotypical baseline.
+ *
+ * @param persona - Persona traits object
+ * @returns Empirically calibrated reading profile
+ */
+export function getReadingProfile(persona) {
+    const traits = persona.traits ?? {};
+    const name = (persona.name ?? '').toLowerCase();
+    // Direct name matching for known profiles
+    if (name.includes('dyslexic') || name.includes('dyslexia')) {
+        return { ...KNOWN_READING_PROFILES.dyslexic };
+    }
+    if (name.includes('low-vision') || name.includes('low vision') || name.includes('magnified')) {
+        return { ...KNOWN_READING_PROFILES.lowVision };
+    }
+    if (name.includes('adhd') || name.includes('attention deficit')) {
+        return { ...KNOWN_READING_PROFILES.adhd };
+    }
+    if (name.includes('elderly') || name.includes('senior') || name.includes('aging')) {
+        return { ...KNOWN_READING_PROFILES.elderly };
+    }
+    // Trait-based interpolation
+    const textProcessing = traits.textProcessing;
+    const comprehension = traits.comprehension;
+    if (textProcessing === undefined && comprehension === undefined) {
+        return { ...KNOWN_READING_PROFILES.neurotypical };
+    }
+    // Use textProcessing as primary axis, comprehension as secondary
+    const readingAbility = textProcessing !== undefined && comprehension !== undefined
+        ? textProcessing * 0.6 + comprehension * 0.4
+        : (textProcessing ?? comprehension ?? 0.75);
+    const clamped = Math.max(0, Math.min(1, readingAbility));
+    const neuro = KNOWN_READING_PROFILES.neurotypical;
+    const impaired = KNOWN_READING_PROFILES.dyslexic;
+    return {
+        orthographic: impaired.orthographic + (neuro.orthographic - impaired.orthographic) * clamped,
+        phonological: impaired.phonological + (neuro.phonological - impaired.phonological) * clamped,
+        visualSpan: Math.round(impaired.visualSpan + (neuro.visualSpan - impaired.visualSpan) * clamped),
+        vocabulary: impaired.vocabulary + (neuro.vocabulary - impaired.vocabulary) * clamped,
+        crowding: neuro.crowding + (impaired.crowding - neuro.crowding) * (1 - clamped),
+    };
+}
+/**
+ * Irregular word patterns in English.
+ *
+ * These are grapheme-phoneme correspondence violations — words containing
+ * these patterns violate standard decoding rules and require whole-word
+ * (orthographic) recognition. Dyslexic readers with impaired orthographic
+ * processing are disproportionately slowed by these.
+ *
+ * Source: Plaut et al. (1996), Coltheart et al. (2001) DRC model.
+ */
+const IRREGULAR_PATTERN = /\b\w*(ough|tion|sion|ight|ould|alk|omb|wr|kn|gn|pn|ps|mn)\w*\b/gi;
+/**
+ * Estimate the proportion of irregular words in a text passage.
+ *
+ * Returns the fraction of words that contain irregular grapheme-phoneme
+ * correspondences. This determines the orthographic processing demand:
+ * higher irregularity = more reliance on whole-word recognition.
+ *
+ * @param text - Text passage to analyze
+ * @returns Proportion of irregular words (0-1)
+ */
+export function estimateIrregularity(text) {
+    const words = text.trim().split(/\s+/);
+    if (words.length === 0)
+        return 0;
+    // Reset regex state (global flag)
+    IRREGULAR_PATTERN.lastIndex = 0;
+    const matches = text.match(IRREGULAR_PATTERN);
+    const irregularCount = matches ? matches.length : 0;
+    return Math.min(1, irregularCount / words.length);
+}
+/**
+ * Compute reading difficulty for a text block using the multi-deficit model.
+ *
+ * The Perry, Zorzi & Ziegler (2019) framework models dyslexia as the
+ * intersection of multiple independent deficits. Each deficit independently
+ * increases fixation duration. The total penalty is additive (not multiplicative)
+ * because deficits affect different processing stages in the reading pipeline:
+ *
+ *   Visual input -> Visual span (crowding) -> Orthographic processing ->
+ *   Phonological decoding -> Lexical access (vocabulary) -> Comprehension
+ *
+ * Additional penalties from Rello & Baeza-Yates (2016) for font effects
+ * and WCAG 2.1 contrast requirements.
+ *
+ * @param text - Text content to analyze
+ * @param profile - Reader's deficit profile
+ * @param textBlock - Typographic properties of the text
+ * @returns Reading difficulty (0-1) and fixation duration
+ */
+export function computeReadingDifficulty(text, profile, textBlock) {
+    const words = text.trim().split(/\s+/);
+    const wordCount = Math.max(1, words.length);
+    const penalties = [];
+    // Base fixation duration: fluent adult reader (Rayner 2009)
+    const baseFixation = 250; // ms per word
+    // 1. Orthographic deficit: irregular words take longer to process
+    // When orthographic route is impaired, the reader must fall back to
+    // phonological decoding for irregular words, which is slower.
+    const irregularWordRatio = estimateIrregularity(text);
+    const orthoPenalty = (1 - profile.orthographic) * irregularWordRatio * 150;
+    if (orthoPenalty > 10) {
+        penalties.push(`orthographic: +${Math.round(orthoPenalty)}ms (${Math.round(irregularWordRatio * 100)}% irregular words)`);
+    }
+    // 2. Phonological deficit: all words require phonological activation
+    // Even for skilled readers, phonological codes are activated automatically.
+    // Impaired phonological processing slows all word recognition.
+    const phonoPenalty = (1 - profile.phonological) * 100;
+    if (phonoPenalty > 10) {
+        penalties.push(`phonological: +${Math.round(phonoPenalty)}ms`);
+    }
+    // 3. Visual span: fewer characters per fixation = more fixations per word
+    // Normal visual span ~7 characters (Legge et al. 2007).
+    // Reduced span means more saccades to read the same word.
+    const spanRatio = 7 / profile.visualSpan;
+    const spanPenalty = (spanRatio - 1) * 80;
+    if (spanPenalty > 5) {
+        penalties.push(`visual span: +${Math.round(spanPenalty)}ms (${profile.visualSpan} chars/fixation)`);
+    }
+    // 4. Vocabulary: unknown/rare words require additional processing
+    // Long words are more likely to be uncommon (Zipf's law correlation).
+    // Vocabulary deficit amplifies this effect.
+    const avgWordLength = words.reduce((sum, w) => sum + w.length, 0) / wordCount;
+    const vocabPenalty = (1 - profile.vocabulary) * Math.max(0, avgWordLength - 5) * 30;
+    if (vocabPenalty > 5) {
+        penalties.push(`vocabulary: +${Math.round(vocabPenalty)}ms (avg word length ${avgWordLength.toFixed(1)})`);
+    }
+    // 5. Crowding: small or dense text increases lateral masking
+    // Below 16px, crowding effects increase substantially.
+    // Pelli et al. (2004, 2007) established the critical spacing formula.
+    const crowdingPenalty = profile.crowding * Math.max(0, 16 - textBlock.fontSize) * 10;
+    if (crowdingPenalty > 5) {
+        penalties.push(`crowding: +${Math.round(crowdingPenalty)}ms (${textBlock.fontSize}px font)`);
+    }
+    // 6. Font penalty: serif fonts penalize dyslexic readers
+    // Rello & Baeza-Yates (2016): sans-serif fonts reduce fixation time
+    // for readers with orthographic processing below 0.6.
+    const fontPenalty = textBlock.isSerif && profile.orthographic < 0.6 ? 50 : 0;
+    if (fontPenalty > 0) {
+        penalties.push(`serif font: +${fontPenalty}ms (orthographic deficit)`);
+    }
+    // 7. Contrast penalty: low contrast increases fixation duration
+    // WCAG 2.1 SC 1.4.3 minimum is 4.5:1 for normal text.
+    // Below this threshold, all readers are affected, but impaired readers more so.
+    const contrastPenalty = textBlock.contrastRatio < 4.5
+        ? (4.5 - textBlock.contrastRatio) * 40
+        : 0;
+    if (contrastPenalty > 0) {
+        penalties.push(`low contrast: +${Math.round(contrastPenalty)}ms (${textBlock.contrastRatio.toFixed(1)}:1 ratio)`);
+    }
+    // Total fixation duration per word
+    const totalFixation = baseFixation + orthoPenalty + phonoPenalty + spanPenalty + vocabPenalty + crowdingPenalty + fontPenalty + contrastPenalty;
+    // Words per minute
+    const wpm = Math.round(60000 / totalFixation);
+    // Normalize difficulty: 250ms = 0.0 (fluent), 750ms+ = 1.0 (severe)
+    const difficulty = Math.max(0, Math.min(1, (totalFixation - 250) / 500));
+    return {
+        difficulty: Math.round(difficulty * 10000) / 10000,
+        fixationDuration: Math.round(totalFixation),
+        wordsPerMinute: wpm,
+        penalties,
+    };
+}
+/**
+ * Compute readability for multiple text blocks using the multi-deficit model.
+ *
+ * Evaluates each text block independently, then computes an aggregate
+ * readability score weighted by text length (longer blocks matter more).
+ *
+ * @param blocks - Array of text blocks with typographic properties
+ * @param persona - Persona to evaluate for
+ * @returns Readability result with per-block breakdown and aggregate score
+ */
+export function readability(blocks, persona) {
+    if (blocks.length === 0) {
+        return { blocks: [], score: 1, transportCost: 0 };
+    }
+    const profile = getReadingProfile(persona);
+    const results = blocks.map(block => {
+        const { difficulty, fixationDuration, wordsPerMinute, penalties } = computeReadingDifficulty(block.text, profile, block);
+        return {
+            text: block.text.length > 100 ? block.text.slice(0, 100) + '...' : block.text,
+            difficulty,
+            fixationDuration,
+            wordsPerMinute,
+            penalties,
+        };
+    });
+    // Weighted average by text length (longer blocks count more)
+    const totalChars = blocks.reduce((sum, b) => sum + b.text.length, 0) || 1;
+    const weightedDifficulty = results.reduce((sum, r, i) => {
+        const weight = blocks[i].text.length / totalChars;
+        return sum + r.difficulty * weight;
+    }, 0);
+    const score = Math.round((1 - weightedDifficulty) * 10000) / 10000;
+    const transportCost = Math.round(weightedDifficulty * 10000) / 10000;
+    return { blocks: results, score, transportCost };
+}
+// ── Unified Access ──
+/**
+ * Compute both motor and reading accessibility for a persona.
+ *
+ * Combines Layer 4 (pointing model) and Layer 6 (reading model) into
+ * a single assessment. Each layer contributes independently to the
+ * total transport cost.
+ *
+ * @param targets - Interactive elements for motor assessment
+ * @param textBlocks - Text blocks for reading assessment
+ * @param persona - Persona to evaluate
+ * @returns Combined accessibility result
+ */
+export function cognitiveAccessibility(targets, textBlocks, persona) {
+    const motor = motorAccessibility(targets, persona);
+    const reading = readability(textBlocks, persona);
+    // Combined score: geometric mean (penalizes severe deficits in either domain)
+    const combinedScore = Math.round(Math.sqrt(motor.score * reading.score) * 10000) / 10000;
+    // Combined transport cost: sum of independent layer costs (clamped to [0,1])
+    const combinedTransportCost = Math.round(Math.min(1, motor.transportCost + reading.transportCost) * 10000) / 10000;
+    return { motor, reading, combinedScore, combinedTransportCost };
+}
+// ── Exports for testing ──
+export { normalCDF as _normalCDF, normalPDF as _normalPDF };
+export { KNOWN_POINTING_PROFILES, KNOWN_READING_PROFILES };
+//# sourceMappingURL=cognitive-models.js.map

package/dist/visual/cognitive-models.js.map

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

package/dist/visual/cognitive-transport-chain.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Cognitive Optimal Transport — Sequential Transport Chain
+ *
+ * Implements the CHI 2027 paper's core contribution:
+ * - 26-dimensional demand distribution computed from page features
+ * - Sequential transport chain where each layer depletes capacity
+ * - Asymmetric deficit-surplus cost
+ * - Layer interaction terms
+ *
+ * Mathematical foundation: The total Cognitive Transport Cost is NOT
+ * the sum of independent layers. Each layer receives the user's RESIDUAL
+ * capacity after prior layers have consumed resources.
+ *
+ * @see Section 3.4 of "Cognitive Optimal Transport: A Unified Framework"
+ * @since v18.39.0
+ */
+import { type OTCognitiveProfile } from './cognitive-transport.js';
+/** Page metrics extracted from a live page (matches extractPageMetrics return) */
+export interface PageMetrics {
+    informationDensity: number;
+    visualComplexity: number;
+    interactiveElementCount: number;
+    textDensity: number;
+    animationLevel: number;
+    choiceCount: number;
+    navigationDepth: number;
+}
+export interface DemandDistribution {
+    /** 26-dimensional demand vector (0-1 per trait) */
+    demands: Record<string, number>;
+    /** Per-dimension demand variance (from spatial variability across page) */
+    variance: Record<string, number>;
+}
+export interface LayerResult {
+    name: string;
+    transportCost: number;
+    capacityConsumed: number;
+    residualCapacity: Record<string, number>;
+}
+export interface SequentialTransportResult {
+    /** Total Cognitive Transport Cost */
+    totalCTC: number;
+    /** Per-layer results in sequential order */
+    layers: LayerResult[];
+    /** Pairwise interaction terms */
+    interactions: Record<string, number>;
+    /** Additive-only CTC for comparison */
+    additiveCTC: number;
+    /** Asymmetric deficit-surplus breakdown */
+    deficitCost: number;
+    surplusCost: number;
+    /** Per-trait transport cost */
+    traitCosts: Record<string, number>;
+    /** Bottleneck layer (highest cost) */
+    bottleneckLayer: string;
+    /** Predicted abandonment probability (0-1) */
+    abandonmentRisk: number;
+}
+/**
+ * The 26 demand dimensions used by the sequential transport chain.
+ * Superset of the base 25 OT cognitive traits — includes extended traits
+ * from CognitiveTraits that capture decision biases, learning transfer,
+ * and emotional regulation.
+ */
+export declare const DEMAND_DIMENSIONS: readonly ["patience", "riskTolerance", "comprehension", "persistence", "workingMemory", "readingTendency", "resilience", "selfEfficacy", "emotionalContagion", "satisficing", "anchoringBias", "fearOfMissingOut", "socialProofSensitivity", "changeBlindness", "attentionPattern", "motorPrecision", "proceduralFluency", "informationForaging", "metacognitivePlanning", "transferLearning", "interruptRecovery", "trustCalibration", "mentalModelRigidity", "curiosity", "processingSpeed", "textProcessing"];
+/**
+ * Compute the 26-dimensional demand distribution from page metrics.
+ *
+ * Each page feature maps to specific trait dimensions via calibrated
+ * sigmoid functions. The mapping encodes HOW each page characteristic
+ * creates cognitive demand on specific user capacities.
+ *
+ * Traits not affected by any page feature receive demand = 0.0 (no demand).
+ *
+ * @param pageMetrics - Extracted page analysis metrics
+ * @returns DemandDistribution with per-trait demand and variance
+ */
+export declare function computeDemandDistribution(pageMetrics: PageMetrics): DemandDistribution;
+/**
+ * Compute the Sequential Cognitive Transport Cost (CTC).
+ *
+ * Unlike additive cognitive load models, the sequential chain depletes
+ * capacity at each processing layer. A user who spends cognitive resources
+ * on saliency detection has LESS available for subsequent decision-making.
+ *
+ * The algorithm processes layers in temporal order:
+ *   Saliency -> Cognitive Load -> Decision -> Motor -> Frustration -> Readability
+ *
+ * Each layer:
+ * 1. Computes asymmetric transport cost (deficit is expensive, surplus is cheap)
+ * 2. Depletes residual capacity proportional to cost incurred
+ * 3. Records the remaining capacity for downstream layers
+ *
+ * @param persona - OTCognitiveProfile with trait values
+ * @param demand - 26D demand distribution from page analysis
+ * @param options - Enable/disable asymmetric costs and interaction terms
+ * @returns Complete sequential transport result with per-layer breakdown
+ */
+export declare function computeSequentialCTC(persona: OTCognitiveProfile, demand: DemandDistribution, options?: {
+    asymmetric?: boolean;
+    interactions?: boolean;
+}): SequentialTransportResult;
+/**
+ * End-to-end Cognitive Optimal Transport computation.
+ *
+ * Extracts page metrics from a live Playwright page, computes the
+ * 26D demand distribution, and runs the full sequential transport chain.
+ *
+ * This is the primary entry point for MCP tools that need a single
+ * CTC score with full breakdown.
+ *
+ * @param persona - OTCognitiveProfile with trait values
+ * @param page - Playwright Page object (or any object with evaluate())
+ * @returns Complete sequential transport result
+ */
+export declare function computeFullCOT(persona: OTCognitiveProfile, page: any): Promise<SequentialTransportResult>;
+/**
+ * Compute demand distribution from raw metric values (no page required).
+ * Useful for testing, simulation, and sensitivity analysis.
+ */
+export declare function computeDemandFromRawMetrics(informationDensity: number, visualComplexity: number, interactiveElementCount: number, textDensity: number, animationLevel: number, choiceCount: number, navigationDepth: number): DemandDistribution;
+/**
+ * Compare sequential vs. additive CTC to quantify the sequential effect.
+ *
+ * Returns the ratio (sequential / additive). Values > 1.0 indicate that
+ * capacity depletion and interactions amplify the total cost beyond what
+ * independent layers would predict.
+ */
+export declare function sequentialAmplification(result: SequentialTransportResult): number;
+/**
+ * Identify the top N most costly traits across all layers.
+ * Useful for targeted remediation — fix the traits that hurt most.
+ */
+export declare function topCostlyTraits(result: SequentialTransportResult, n?: number): Array<{
+    trait: string;
+    cost: number;
+}>;
+/**
+ * Compute CTC for a minimal/empty page (baseline).
+ * Useful for normalizing CTC scores against the best-case scenario.
+ */
+export declare function baselineCTC(persona: OTCognitiveProfile): SequentialTransportResult;
+//# sourceMappingURL=cognitive-transport-chain.d.ts.map

package/dist/visual/cognitive-transport-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-transport-chain.d.ts","sourceRoot":"","sources":["../../src/visual/cognitive-transport-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAIlC,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;CACzB;AAID;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,kfAsBpB,CAAC;AAuEX;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,kBAAkB,CAyGtF;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD,yBAAyB,CAiI3B;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,yBAAyB,CAAC,CAYpC;AAID;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,MAAM,EAC1B,gBAAgB,EAAE,MAAM,EACxB,uBAAuB,EAAE,MAAM,EAC/B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,kBAAkB,CAUpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAGjF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,yBAAyB,EACjC,CAAC,GAAE,MAAU,GACZ,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAMxC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,yBAAyB,CAUlF"}