my-frontend-observer 0.3.0 → 0.5.0

package/dist/domain/comparisonEngine.d.ts

@@ -0,0 +1,48 @@
+import type { ObservationArtifact } from './schema.js';
+import type { ComparisonConfig, ComparabilityResult, TargetConfigurationChange, ExpectedDependencyDeclaration, ExpectedDependencyEvidence, ComparisonArtifact } from './comparison.js';
+/**
+ * Configuration-change evidence: `removed`/`locator-changed` in before's
+ * configured order, then `added` in after's configured order (Batch 1's
+ * frozen ordering guidance) - never a source of appeared/disappeared
+ * rendered-state differences by itself.
+ */
+export declare function compareTargetConfiguration(before: ObservationArtifact, after: ObservationArtifact): TargetConfigurationChange[];
+/**
+ * Evaluates comparability before any rendered difference is calculated
+ * (Batch 1's frozen `ComparabilityResult`/reason vocabulary). Hard
+ * incompatibilities (`blocking`) force `incomparable`; producer/browser
+ * version and target-configuration mismatches are `warning`-only; the three
+ * state dimensions the observer never models (theme, authenticated-state,
+ * application-state) are always recorded as `unassessed` - never silently
+ * claimed identical.
+ */
+export declare function evaluateComparability(before: ObservationArtifact, after: ObservationArtifact): ComparabilityResult;
+/**
+ * Evaluates only explicitly-declared dependencies (`config.expectedDependencies`,
+ * in declared order) - never synthesizes a declaration from observed
+ * co-change (Batch 1's hard non-causal boundary). Each declared side is
+ * evaluated independently from the target's own before/after geometry;
+ * `unavailable` when either side's required property evidence cannot be
+ * read, `contradictory-to-declaration` when either side's actual direction
+ * is the strict opposite of what was declared, `consistent` when both sides
+ * match their declared direction, `not-observed` otherwise. No causal claim
+ * is ever produced.
+ */
+export declare function evaluateExpectedDependencies(before: ObservationArtifact, after: ObservationArtifact, declarations: readonly ExpectedDependencyDeclaration[], tolerance: number): ExpectedDependencyEvidence[];
+export type CompareObservationsResult = {
+    ok: true;
+    artifact: ComparisonArtifact;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * The one canonical pure comparison entry point (real Chromium ->
+ * ObservationArtifact -> relationship derivation -> **comparability ->
+ * comparison** -> ComparisonArtifact, see docs/ARCHITECTURE.md). Comparison
+ * is ordered: `compareObservations(a, b)` and `compareObservations(b, a)`
+ * produce different `comparisonRequestId`s and reversed-sign
+ * moved/resized deltas - `before`/`after` are never treated as an
+ * unordered pair.
+ */
+export declare function compareObservations(before: ObservationArtifact, after: ObservationArtifact, configInput?: Partial<ComparisonConfig>): CompareObservationsResult;