device-passport 1.0.0 → 1.2.0

package/dist/evaluator/index.d.cts

@@ -0,0 +1,204 @@
+import { DevicePassport } from '../types/index.cjs';
+import '../shared/device-passport.C_F1vBE8.cjs';
+
+/**
+ * Contradiction Detection Engine for Device Passport.
+ *
+ * Evaluates cross-layer integrity across the 4-tuple formal model:
+ * P = ⟨H, S, G, C⟩ (Hardware, System, Geo, Client-Hints).
+ *
+ * Implements deterministic anomaly and anti-fingerprinting rules based on
+ * empirical browser telemetry, W3C Client Hints RFCs, and anti-bot heuristic vectors.
+ */
+
+type ContradictionSeverity = 'fatal' | 'high' | 'medium' | 'low';
+type ContradictionCategory = 'hardware_system' | 'os_browser' | 'geo_chrono' | 'client_hints' | 'entropy';
+interface Contradiction {
+    id: string;
+    category: ContradictionCategory;
+    severity: ContradictionSeverity;
+    description: string;
+    fields: string[];
+    actual: unknown;
+    expected: unknown;
+    impactPenalty: number;
+}
+declare const COUNTRY_TIMEZONE_MAP: Record<string, string[]>;
+declare const COUNTRY_PRIMARY_LANGUAGES: Record<string, string[]>;
+/**
+ * Detect OS vs Browser compatibility contradictions.
+ */
+declare function detectOSBrowserContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect Hardware vs System cross-layer contradictions.
+ */
+declare function detectHardwareContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect Geographic, Locale, and Chronological (Geo-Chrono) Contradictions.
+ */
+declare function detectGeoChronoContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect W3C Client Hints Internal Consistency Contradictions.
+ */
+declare function detectClientHintsContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Master contradiction detection runner across all 4 sub-spaces:
+ * P = ⟨H, S, G, C⟩.
+ */
+declare function detectAllContradictions(passport: DevicePassport): Contradiction[];
+
+/**
+ * Shannon Entropy Analyzer for Device Passport HTTP Headers.
+ *
+ * Grounded in Information Theory (Shannon, 1948: "A Mathematical Theory of Communication"):
+ * H(X) = - \sum_{i=1}^{n} P(x_i) \log_2 P(x_i)
+ *
+ * Evaluates generated header distributions against empirical modern browser baselines
+ * to detect:
+ * 1. Under-parameterized / Low-entropy signatures (naive scrapers, curl, missing sec-ch headers)
+ * 2. Over-parameterized / High-entropy anomalies (random noise injection, spoofing artifacts)
+ * 3. Relative Entropy (Kullback-Leibler Divergence) against empirical Chrome/Edge/Safari profiles
+ */
+interface HeaderEntropyProfile {
+    characterEntropy: number;
+    structuralEntropy: number;
+    klDivergence: number;
+    totalHeaderBytes: number;
+    headerCount: number;
+}
+interface EntropyAnalysisResult {
+    entropyScore: number;
+    estimatedBits: number;
+    klDivergence: number;
+    anomaly: 'too_low' | 'too_high' | 'optimal';
+    collisionRisk: 'very_low' | 'low' | 'moderate' | 'high';
+    verdict: string;
+    details: {
+        characterEntropy: number;
+        structuralEntropy: number;
+        baselineEntropy: number;
+        deltaFromOptimal: number;
+    };
+}
+/**
+ * Empirical baseline frequency distribution of headers in real modern desktop browsers (Chromium 120+).
+ * Baseline average entropy is calibrated at 4.45 bits/char.
+ */
+declare const BROWSER_BASELINE_FREQUENCIES: Record<string, number>;
+declare const OPTIMAL_CHAR_ENTROPY_MIN = 4.6;
+declare const OPTIMAL_CHAR_ENTROPY_MAX = 5.6;
+declare const OPTIMAL_ENTROPY_MIN = 4.6;
+declare const OPTIMAL_ENTROPY_MAX = 5.6;
+declare const BASELINE_OPTIMAL_ENTROPY = 5.25;
+declare const MIN_STRUCTURAL_ENTROPY = 3.5;
+/**
+ * Calculates fundamental Shannon Information Entropy (in bits) of any string input.
+ * H(X) = -\sum_{i=1}^n P(x_i) \log_2 P(x_i)
+ */
+declare function calculateShannonEntropy(data: string): number;
+/**
+ * Calculates structural header presence entropy across expected browser header space.
+ */
+declare function calculateStructuralEntropy(headers: Record<string, string>): number;
+/**
+ * Calculates Kullback-Leibler (KL) Divergence:
+ * D_KL(P || Q) = \sum P(x) * log2(P(x) / Q(x))
+ * Measures informational distance between current header distribution and natural browser baseline.
+ */
+declare function calculateKLDivergence(headers: Record<string, string>): number;
+/**
+ * Analyzes the entropy of an HTTP header dictionary.
+ * Evaluates whether entropy is in the realistic "sweet spot" of real browser traffic.
+ */
+declare function analyzeHeaderEntropy(headers: Record<string, string>): EntropyAnalysisResult;
+
+/**
+ * Academic Coherence Evaluator for Device Passport.
+ *
+ * Implements the Formal Mathematical Model:
+ * P = ⟨H, S, G, C⟩
+ *
+ * Where:
+ * - H ∈ Ω_H: Hardware Sub-space ⟨Screen, CPU, Memory, GPU⟩
+ * - S ∈ Ω_S: System Sub-space ⟨OS, Browser, UserAgent⟩
+ * - G ∈ Ω_G: Geo-Chrono Sub-space ⟨Country, Timezone, Locale, Languages, Coordinates⟩
+ * - C ∈ Ω_C: Client-Hints Sub-space ⟨Sec-CH-UA*, Low & High Entropy Hints⟩
+ *
+ * The coherence evaluation function Φ(P) maps P into [0, 100%], quantifying
+ * cross-subspace plausibility and absence of anti-bot contradiction signatures.
+ */
+
+interface SubspaceEvaluation {
+    valid: boolean;
+    score: number;
+    notes: string[];
+}
+interface MathematicalModelFormalism {
+    formalism: string;
+    definition: {
+        H: string;
+        S: string;
+        G: string;
+        C: string;
+    };
+    subspaces: {
+        H: SubspaceEvaluation;
+        S: SubspaceEvaluation;
+        G: SubspaceEvaluation;
+        C: SubspaceEvaluation;
+    };
+}
+interface CoherenceEvaluationResult {
+    /** Overall cross-layer coherence score (0 - 100%) */
+    coherenceScore: number;
+    /** Specific geo-temporal-linguistic alignment score (0 - 100%) */
+    geoAlignmentScore: number;
+    /** Shannon entropy realistic score (0 - 100%) */
+    entropyScore: number;
+    /** List of detected contradictions and anomalies */
+    contradictions: Contradiction[];
+    /** Mathematical formalization of the evaluation state */
+    mathematicalModel: MathematicalModelFormalism;
+    /** Entropy analysis breakdown */
+    entropyAnalysis: EntropyAnalysisResult;
+    /** Evaluation summary and grade */
+    summary: {
+        passed: boolean;
+        fatalCount: number;
+        warningCount: number;
+        grade: 'A+' | 'A' | 'B' | 'C' | 'F';
+        verdict: string;
+    };
+}
+/**
+ * Calculates Geo-Alignment score between Geographic Country, Timezone, and Accept-Language.
+ */
+declare function evaluateGeoAlignment(passport: DevicePassport): number;
+/**
+ * Evaluates the complete internal consistency and coherence of a Device Passport.
+ *
+ * Implements:
+ * Φ: Ω_H × Ω_S × Ω_G × Ω_C → [0, 100%]
+ */
+declare function evaluateCoherence(passport: DevicePassport): CoherenceEvaluationResult;
+
+/**
+ * Academic Evaluation Engine for Device Passport.
+ *
+ * Implements verification algorithms for the formal model:
+ * P = ⟨H, S, G, C⟩
+ *
+ * Evaluates:
+ * 1. Internal Coherence Score (0 - 100%)
+ * 2. Geo-Chrono-Linguistic Alignment Score (0 - 100%)
+ * 3. Shannon Entropy Analyzer for HTTP Header Distributions
+ * 4. Cross-layer Contradiction and Detection Anomaly Detection
+ */
+
+/**
+ * High-level evaluation entry point for any DevicePassport instance.
+ */
+declare function evaluatePassport(passport: DevicePassport): CoherenceEvaluationResult;
+
+export { BASELINE_OPTIMAL_ENTROPY, BROWSER_BASELINE_FREQUENCIES, COUNTRY_PRIMARY_LANGUAGES, COUNTRY_TIMEZONE_MAP, MIN_STRUCTURAL_ENTROPY, OPTIMAL_CHAR_ENTROPY_MAX, OPTIMAL_CHAR_ENTROPY_MIN, OPTIMAL_ENTROPY_MAX, OPTIMAL_ENTROPY_MIN, analyzeHeaderEntropy, calculateKLDivergence, calculateShannonEntropy, calculateStructuralEntropy, detectAllContradictions, detectClientHintsContradictions, detectGeoChronoContradictions, detectHardwareContradictions, detectOSBrowserContradictions, evaluateCoherence, evaluateGeoAlignment, evaluatePassport };
+export type { CoherenceEvaluationResult, Contradiction, ContradictionCategory, ContradictionSeverity, EntropyAnalysisResult, HeaderEntropyProfile, MathematicalModelFormalism, SubspaceEvaluation };

package/dist/evaluator/index.d.mts

@@ -0,0 +1,204 @@
+import { DevicePassport } from '../types/index.mjs';
+import '../shared/device-passport.C_F1vBE8.mjs';
+
+/**
+ * Contradiction Detection Engine for Device Passport.
+ *
+ * Evaluates cross-layer integrity across the 4-tuple formal model:
+ * P = ⟨H, S, G, C⟩ (Hardware, System, Geo, Client-Hints).
+ *
+ * Implements deterministic anomaly and anti-fingerprinting rules based on
+ * empirical browser telemetry, W3C Client Hints RFCs, and anti-bot heuristic vectors.
+ */
+
+type ContradictionSeverity = 'fatal' | 'high' | 'medium' | 'low';
+type ContradictionCategory = 'hardware_system' | 'os_browser' | 'geo_chrono' | 'client_hints' | 'entropy';
+interface Contradiction {
+    id: string;
+    category: ContradictionCategory;
+    severity: ContradictionSeverity;
+    description: string;
+    fields: string[];
+    actual: unknown;
+    expected: unknown;
+    impactPenalty: number;
+}
+declare const COUNTRY_TIMEZONE_MAP: Record<string, string[]>;
+declare const COUNTRY_PRIMARY_LANGUAGES: Record<string, string[]>;
+/**
+ * Detect OS vs Browser compatibility contradictions.
+ */
+declare function detectOSBrowserContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect Hardware vs System cross-layer contradictions.
+ */
+declare function detectHardwareContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect Geographic, Locale, and Chronological (Geo-Chrono) Contradictions.
+ */
+declare function detectGeoChronoContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect W3C Client Hints Internal Consistency Contradictions.
+ */
+declare function detectClientHintsContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Master contradiction detection runner across all 4 sub-spaces:
+ * P = ⟨H, S, G, C⟩.
+ */
+declare function detectAllContradictions(passport: DevicePassport): Contradiction[];
+
+/**
+ * Shannon Entropy Analyzer for Device Passport HTTP Headers.
+ *
+ * Grounded in Information Theory (Shannon, 1948: "A Mathematical Theory of Communication"):
+ * H(X) = - \sum_{i=1}^{n} P(x_i) \log_2 P(x_i)
+ *
+ * Evaluates generated header distributions against empirical modern browser baselines
+ * to detect:
+ * 1. Under-parameterized / Low-entropy signatures (naive scrapers, curl, missing sec-ch headers)
+ * 2. Over-parameterized / High-entropy anomalies (random noise injection, spoofing artifacts)
+ * 3. Relative Entropy (Kullback-Leibler Divergence) against empirical Chrome/Edge/Safari profiles
+ */
+interface HeaderEntropyProfile {
+    characterEntropy: number;
+    structuralEntropy: number;
+    klDivergence: number;
+    totalHeaderBytes: number;
+    headerCount: number;
+}
+interface EntropyAnalysisResult {
+    entropyScore: number;
+    estimatedBits: number;
+    klDivergence: number;
+    anomaly: 'too_low' | 'too_high' | 'optimal';
+    collisionRisk: 'very_low' | 'low' | 'moderate' | 'high';
+    verdict: string;
+    details: {
+        characterEntropy: number;
+        structuralEntropy: number;
+        baselineEntropy: number;
+        deltaFromOptimal: number;
+    };
+}
+/**
+ * Empirical baseline frequency distribution of headers in real modern desktop browsers (Chromium 120+).
+ * Baseline average entropy is calibrated at 4.45 bits/char.
+ */
+declare const BROWSER_BASELINE_FREQUENCIES: Record<string, number>;
+declare const OPTIMAL_CHAR_ENTROPY_MIN = 4.6;
+declare const OPTIMAL_CHAR_ENTROPY_MAX = 5.6;
+declare const OPTIMAL_ENTROPY_MIN = 4.6;
+declare const OPTIMAL_ENTROPY_MAX = 5.6;
+declare const BASELINE_OPTIMAL_ENTROPY = 5.25;
+declare const MIN_STRUCTURAL_ENTROPY = 3.5;
+/**
+ * Calculates fundamental Shannon Information Entropy (in bits) of any string input.
+ * H(X) = -\sum_{i=1}^n P(x_i) \log_2 P(x_i)
+ */
+declare function calculateShannonEntropy(data: string): number;
+/**
+ * Calculates structural header presence entropy across expected browser header space.
+ */
+declare function calculateStructuralEntropy(headers: Record<string, string>): number;
+/**
+ * Calculates Kullback-Leibler (KL) Divergence:
+ * D_KL(P || Q) = \sum P(x) * log2(P(x) / Q(x))
+ * Measures informational distance between current header distribution and natural browser baseline.
+ */
+declare function calculateKLDivergence(headers: Record<string, string>): number;
+/**
+ * Analyzes the entropy of an HTTP header dictionary.
+ * Evaluates whether entropy is in the realistic "sweet spot" of real browser traffic.
+ */
+declare function analyzeHeaderEntropy(headers: Record<string, string>): EntropyAnalysisResult;
+
+/**
+ * Academic Coherence Evaluator for Device Passport.
+ *
+ * Implements the Formal Mathematical Model:
+ * P = ⟨H, S, G, C⟩
+ *
+ * Where:
+ * - H ∈ Ω_H: Hardware Sub-space ⟨Screen, CPU, Memory, GPU⟩
+ * - S ∈ Ω_S: System Sub-space ⟨OS, Browser, UserAgent⟩
+ * - G ∈ Ω_G: Geo-Chrono Sub-space ⟨Country, Timezone, Locale, Languages, Coordinates⟩
+ * - C ∈ Ω_C: Client-Hints Sub-space ⟨Sec-CH-UA*, Low & High Entropy Hints⟩
+ *
+ * The coherence evaluation function Φ(P) maps P into [0, 100%], quantifying
+ * cross-subspace plausibility and absence of anti-bot contradiction signatures.
+ */
+
+interface SubspaceEvaluation {
+    valid: boolean;
+    score: number;
+    notes: string[];
+}
+interface MathematicalModelFormalism {
+    formalism: string;
+    definition: {
+        H: string;
+        S: string;
+        G: string;
+        C: string;
+    };
+    subspaces: {
+        H: SubspaceEvaluation;
+        S: SubspaceEvaluation;
+        G: SubspaceEvaluation;
+        C: SubspaceEvaluation;
+    };
+}
+interface CoherenceEvaluationResult {
+    /** Overall cross-layer coherence score (0 - 100%) */
+    coherenceScore: number;
+    /** Specific geo-temporal-linguistic alignment score (0 - 100%) */
+    geoAlignmentScore: number;
+    /** Shannon entropy realistic score (0 - 100%) */
+    entropyScore: number;
+    /** List of detected contradictions and anomalies */
+    contradictions: Contradiction[];
+    /** Mathematical formalization of the evaluation state */
+    mathematicalModel: MathematicalModelFormalism;
+    /** Entropy analysis breakdown */
+    entropyAnalysis: EntropyAnalysisResult;
+    /** Evaluation summary and grade */
+    summary: {
+        passed: boolean;
+        fatalCount: number;
+        warningCount: number;
+        grade: 'A+' | 'A' | 'B' | 'C' | 'F';
+        verdict: string;
+    };
+}
+/**
+ * Calculates Geo-Alignment score between Geographic Country, Timezone, and Accept-Language.
+ */
+declare function evaluateGeoAlignment(passport: DevicePassport): number;
+/**
+ * Evaluates the complete internal consistency and coherence of a Device Passport.
+ *
+ * Implements:
+ * Φ: Ω_H × Ω_S × Ω_G × Ω_C → [0, 100%]
+ */
+declare function evaluateCoherence(passport: DevicePassport): CoherenceEvaluationResult;
+
+/**
+ * Academic Evaluation Engine for Device Passport.
+ *
+ * Implements verification algorithms for the formal model:
+ * P = ⟨H, S, G, C⟩
+ *
+ * Evaluates:
+ * 1. Internal Coherence Score (0 - 100%)
+ * 2. Geo-Chrono-Linguistic Alignment Score (0 - 100%)
+ * 3. Shannon Entropy Analyzer for HTTP Header Distributions
+ * 4. Cross-layer Contradiction and Detection Anomaly Detection
+ */
+
+/**
+ * High-level evaluation entry point for any DevicePassport instance.
+ */
+declare function evaluatePassport(passport: DevicePassport): CoherenceEvaluationResult;
+
+export { BASELINE_OPTIMAL_ENTROPY, BROWSER_BASELINE_FREQUENCIES, COUNTRY_PRIMARY_LANGUAGES, COUNTRY_TIMEZONE_MAP, MIN_STRUCTURAL_ENTROPY, OPTIMAL_CHAR_ENTROPY_MAX, OPTIMAL_CHAR_ENTROPY_MIN, OPTIMAL_ENTROPY_MAX, OPTIMAL_ENTROPY_MIN, analyzeHeaderEntropy, calculateKLDivergence, calculateShannonEntropy, calculateStructuralEntropy, detectAllContradictions, detectClientHintsContradictions, detectGeoChronoContradictions, detectHardwareContradictions, detectOSBrowserContradictions, evaluateCoherence, evaluateGeoAlignment, evaluatePassport };
+export type { CoherenceEvaluationResult, Contradiction, ContradictionCategory, ContradictionSeverity, EntropyAnalysisResult, HeaderEntropyProfile, MathematicalModelFormalism, SubspaceEvaluation };

package/dist/evaluator/index.d.ts

@@ -0,0 +1,204 @@
+import { DevicePassport } from '../types/index.js';
+import '../shared/device-passport.C_F1vBE8.js';
+
+/**
+ * Contradiction Detection Engine for Device Passport.
+ *
+ * Evaluates cross-layer integrity across the 4-tuple formal model:
+ * P = ⟨H, S, G, C⟩ (Hardware, System, Geo, Client-Hints).
+ *
+ * Implements deterministic anomaly and anti-fingerprinting rules based on
+ * empirical browser telemetry, W3C Client Hints RFCs, and anti-bot heuristic vectors.
+ */
+
+type ContradictionSeverity = 'fatal' | 'high' | 'medium' | 'low';
+type ContradictionCategory = 'hardware_system' | 'os_browser' | 'geo_chrono' | 'client_hints' | 'entropy';
+interface Contradiction {
+    id: string;
+    category: ContradictionCategory;
+    severity: ContradictionSeverity;
+    description: string;
+    fields: string[];
+    actual: unknown;
+    expected: unknown;
+    impactPenalty: number;
+}
+declare const COUNTRY_TIMEZONE_MAP: Record<string, string[]>;
+declare const COUNTRY_PRIMARY_LANGUAGES: Record<string, string[]>;
+/**
+ * Detect OS vs Browser compatibility contradictions.
+ */
+declare function detectOSBrowserContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect Hardware vs System cross-layer contradictions.
+ */
+declare function detectHardwareContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect Geographic, Locale, and Chronological (Geo-Chrono) Contradictions.
+ */
+declare function detectGeoChronoContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Detect W3C Client Hints Internal Consistency Contradictions.
+ */
+declare function detectClientHintsContradictions(passport: DevicePassport): Contradiction[];
+/**
+ * Master contradiction detection runner across all 4 sub-spaces:
+ * P = ⟨H, S, G, C⟩.
+ */
+declare function detectAllContradictions(passport: DevicePassport): Contradiction[];
+
+/**
+ * Shannon Entropy Analyzer for Device Passport HTTP Headers.
+ *
+ * Grounded in Information Theory (Shannon, 1948: "A Mathematical Theory of Communication"):
+ * H(X) = - \sum_{i=1}^{n} P(x_i) \log_2 P(x_i)
+ *
+ * Evaluates generated header distributions against empirical modern browser baselines
+ * to detect:
+ * 1. Under-parameterized / Low-entropy signatures (naive scrapers, curl, missing sec-ch headers)
+ * 2. Over-parameterized / High-entropy anomalies (random noise injection, spoofing artifacts)
+ * 3. Relative Entropy (Kullback-Leibler Divergence) against empirical Chrome/Edge/Safari profiles
+ */
+interface HeaderEntropyProfile {
+    characterEntropy: number;
+    structuralEntropy: number;
+    klDivergence: number;
+    totalHeaderBytes: number;
+    headerCount: number;
+}
+interface EntropyAnalysisResult {
+    entropyScore: number;
+    estimatedBits: number;
+    klDivergence: number;
+    anomaly: 'too_low' | 'too_high' | 'optimal';
+    collisionRisk: 'very_low' | 'low' | 'moderate' | 'high';
+    verdict: string;
+    details: {
+        characterEntropy: number;
+        structuralEntropy: number;
+        baselineEntropy: number;
+        deltaFromOptimal: number;
+    };
+}
+/**
+ * Empirical baseline frequency distribution of headers in real modern desktop browsers (Chromium 120+).
+ * Baseline average entropy is calibrated at 4.45 bits/char.
+ */
+declare const BROWSER_BASELINE_FREQUENCIES: Record<string, number>;
+declare const OPTIMAL_CHAR_ENTROPY_MIN = 4.6;
+declare const OPTIMAL_CHAR_ENTROPY_MAX = 5.6;
+declare const OPTIMAL_ENTROPY_MIN = 4.6;
+declare const OPTIMAL_ENTROPY_MAX = 5.6;
+declare const BASELINE_OPTIMAL_ENTROPY = 5.25;
+declare const MIN_STRUCTURAL_ENTROPY = 3.5;
+/**
+ * Calculates fundamental Shannon Information Entropy (in bits) of any string input.
+ * H(X) = -\sum_{i=1}^n P(x_i) \log_2 P(x_i)
+ */
+declare function calculateShannonEntropy(data: string): number;
+/**
+ * Calculates structural header presence entropy across expected browser header space.
+ */
+declare function calculateStructuralEntropy(headers: Record<string, string>): number;
+/**
+ * Calculates Kullback-Leibler (KL) Divergence:
+ * D_KL(P || Q) = \sum P(x) * log2(P(x) / Q(x))
+ * Measures informational distance between current header distribution and natural browser baseline.
+ */
+declare function calculateKLDivergence(headers: Record<string, string>): number;
+/**
+ * Analyzes the entropy of an HTTP header dictionary.
+ * Evaluates whether entropy is in the realistic "sweet spot" of real browser traffic.
+ */
+declare function analyzeHeaderEntropy(headers: Record<string, string>): EntropyAnalysisResult;
+
+/**
+ * Academic Coherence Evaluator for Device Passport.
+ *
+ * Implements the Formal Mathematical Model:
+ * P = ⟨H, S, G, C⟩
+ *
+ * Where:
+ * - H ∈ Ω_H: Hardware Sub-space ⟨Screen, CPU, Memory, GPU⟩
+ * - S ∈ Ω_S: System Sub-space ⟨OS, Browser, UserAgent⟩
+ * - G ∈ Ω_G: Geo-Chrono Sub-space ⟨Country, Timezone, Locale, Languages, Coordinates⟩
+ * - C ∈ Ω_C: Client-Hints Sub-space ⟨Sec-CH-UA*, Low & High Entropy Hints⟩
+ *
+ * The coherence evaluation function Φ(P) maps P into [0, 100%], quantifying
+ * cross-subspace plausibility and absence of anti-bot contradiction signatures.
+ */
+
+interface SubspaceEvaluation {
+    valid: boolean;
+    score: number;
+    notes: string[];
+}
+interface MathematicalModelFormalism {
+    formalism: string;
+    definition: {
+        H: string;
+        S: string;
+        G: string;
+        C: string;
+    };
+    subspaces: {
+        H: SubspaceEvaluation;
+        S: SubspaceEvaluation;
+        G: SubspaceEvaluation;
+        C: SubspaceEvaluation;
+    };
+}
+interface CoherenceEvaluationResult {
+    /** Overall cross-layer coherence score (0 - 100%) */
+    coherenceScore: number;
+    /** Specific geo-temporal-linguistic alignment score (0 - 100%) */
+    geoAlignmentScore: number;
+    /** Shannon entropy realistic score (0 - 100%) */
+    entropyScore: number;
+    /** List of detected contradictions and anomalies */
+    contradictions: Contradiction[];
+    /** Mathematical formalization of the evaluation state */
+    mathematicalModel: MathematicalModelFormalism;
+    /** Entropy analysis breakdown */
+    entropyAnalysis: EntropyAnalysisResult;
+    /** Evaluation summary and grade */
+    summary: {
+        passed: boolean;
+        fatalCount: number;
+        warningCount: number;
+        grade: 'A+' | 'A' | 'B' | 'C' | 'F';
+        verdict: string;
+    };
+}
+/**
+ * Calculates Geo-Alignment score between Geographic Country, Timezone, and Accept-Language.
+ */
+declare function evaluateGeoAlignment(passport: DevicePassport): number;
+/**
+ * Evaluates the complete internal consistency and coherence of a Device Passport.
+ *
+ * Implements:
+ * Φ: Ω_H × Ω_S × Ω_G × Ω_C → [0, 100%]
+ */
+declare function evaluateCoherence(passport: DevicePassport): CoherenceEvaluationResult;
+
+/**
+ * Academic Evaluation Engine for Device Passport.
+ *
+ * Implements verification algorithms for the formal model:
+ * P = ⟨H, S, G, C⟩
+ *
+ * Evaluates:
+ * 1. Internal Coherence Score (0 - 100%)
+ * 2. Geo-Chrono-Linguistic Alignment Score (0 - 100%)
+ * 3. Shannon Entropy Analyzer for HTTP Header Distributions
+ * 4. Cross-layer Contradiction and Detection Anomaly Detection
+ */
+
+/**
+ * High-level evaluation entry point for any DevicePassport instance.
+ */
+declare function evaluatePassport(passport: DevicePassport): CoherenceEvaluationResult;
+
+export { BASELINE_OPTIMAL_ENTROPY, BROWSER_BASELINE_FREQUENCIES, COUNTRY_PRIMARY_LANGUAGES, COUNTRY_TIMEZONE_MAP, MIN_STRUCTURAL_ENTROPY, OPTIMAL_CHAR_ENTROPY_MAX, OPTIMAL_CHAR_ENTROPY_MIN, OPTIMAL_ENTROPY_MAX, OPTIMAL_ENTROPY_MIN, analyzeHeaderEntropy, calculateKLDivergence, calculateShannonEntropy, calculateStructuralEntropy, detectAllContradictions, detectClientHintsContradictions, detectGeoChronoContradictions, detectHardwareContradictions, detectOSBrowserContradictions, evaluateCoherence, evaluateGeoAlignment, evaluatePassport };
+export type { CoherenceEvaluationResult, Contradiction, ContradictionCategory, ContradictionSeverity, EntropyAnalysisResult, HeaderEntropyProfile, MathematicalModelFormalism, SubspaceEvaluation };