my-frontend-observer 0.2.0 → 0.4.0

package/dist/domain/comparison.js

@@ -0,0 +1,324 @@
+/**
+ * v0.4 Batch 1 comparison contract. Frozen here as pure
+ * types/constants/structural validators only - comparison is downstream of
+ * observation (real Chromium -> ObservationArtifact -> relationship
+ * derivation -> comparability analysis -> comparison -> ComparisonArtifact,
+ * see docs/ARCHITECTURE.md) and this batch implements neither relationship
+ * derivation, real comparison, nor persistence. Batch 2 owns relationship
+ * derivation; Batch 3 owns `compareObservations()` and comparison
+ * persistence; Batch 4 owns CLI exposure.
+ *
+ * Comparison and observation are different evidence products: this module
+ * never reuses `ARTIFACT_KIND`/`SCHEMA_VERSION` from `./schema.js`, and
+ * `isValidComparisonArtifact` never delegates to `isValidObservationArtifact`.
+ */
+import { PRODUCER_NAME, SCHEMA_VERSION as OBSERVATION_SCHEMA_VERSION } from './schema.js';
+import { DIAGNOSTIC_CODES, DIAGNOSTIC_SEVERITY } from './diagnostics.js';
+import { PAGE_LEVEL_RELATIONSHIP_KINDS, PAIRWISE_RELATIONSHIP_KINDS, isValidEvidenceReference, isValidLayoutRelationshipGraph, isValidGeometryTolerancePx, } from './relationships.js';
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isEvidenceReferenceArray(value) {
+    return Array.isArray(value) && value.every((entry) => isValidEvidenceReference(entry));
+}
+export const COMPARISON_ARTIFACT_KIND = 'my-frontend-observer/comparison';
+export const COMPARISON_SCHEMA_VERSION = '1.0.0';
+/**
+ * Geometry tolerance is owned by domain/relationships.ts (the relationship
+ * derivation engine needs it directly, and that module must not import this
+ * one back - relationships.ts is the lower-level module). Re-exported here
+ * unchanged so every pre-Batch-2 consumer of these names from
+ * domain/comparison.ts keeps working.
+ */
+export { GEOMETRY_TOLERANCE_DEFAULT_PX, GEOMETRY_TOLERANCE_MIN_PX, GEOMETRY_TOLERANCE_MAX_PX, isValidGeometryTolerancePx } from './relationships.js';
+// --- Expected dependency declarations (explicit, non-causal) ---------------
+export const DEPENDENCY_PROPERTIES = ['x', 'y', 'width', 'height'];
+export const DEPENDENCY_DIRECTIONS = ['increase', 'decrease', 'change', 'unchanged'];
+/** The observer never generates a dependency declaration from co-change; every declaration must explicitly identify that it was supplied externally. */
+export const EXPECTED_DEPENDENCY_SOURCES = ['explicit-config'];
+const DEPENDENCY_TARGET_NAME_RE = /^[A-Za-z0-9_-]{1,64}$/;
+function isValidDependencyTermDeclaration(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.target !== 'string' || !DEPENDENCY_TARGET_NAME_RE.test(value.target))
+        return false;
+    if (typeof value.property !== 'string' || !DEPENDENCY_PROPERTIES.includes(value.property))
+        return false;
+    return typeof value.direction === 'string' && DEPENDENCY_DIRECTIONS.includes(value.direction);
+}
+export function isValidExpectedDependencyDeclaration(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (!isValidDependencyTermDeclaration(value.cause) || !isValidDependencyTermDeclaration(value.effect))
+        return false;
+    return typeof value.source === 'string' && EXPECTED_DEPENDENCY_SOURCES.includes(value.source);
+}
+/**
+ * Non-causal evaluation outcomes only - describes the relationship between a
+ * declared expectation and observed differences, never an implementation
+ * verdict (no PASS/FAIL/approved/regression/allowed/protected vocabulary).
+ */
+export const DEPENDENCY_EVIDENCE_OUTCOMES = ['consistent', 'not-observed', 'contradictory-to-declaration', 'unavailable'];
+export function isValidExpectedDependencyEvidence(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (!isValidExpectedDependencyDeclaration(value.declaration))
+        return false;
+    if (typeof value.outcome !== 'string' || !DEPENDENCY_EVIDENCE_OUTCOMES.includes(value.outcome))
+        return false;
+    return isEvidenceReferenceArray(value.supportingEvidence);
+}
+const COMPARISON_CONFIG_KEYS = ['geometryTolerancePx', 'expectedDependencies'];
+export function isValidComparisonConfig(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (!Object.keys(value).every((key) => COMPARISON_CONFIG_KEYS.includes(key)))
+        return false;
+    if (!isValidGeometryTolerancePx(value.geometryTolerancePx))
+        return false;
+    if ('expectedDependencies' in value && value.expectedDependencies !== undefined) {
+        if (!Array.isArray(value.expectedDependencies) || !value.expectedDependencies.every((d) => isValidExpectedDependencyDeclaration(d))) {
+            return false;
+        }
+    }
+    return true;
+}
+// --- Comparability -----------------------------------------------------------
+export const COMPARABILITY_STATES = ['comparable', 'comparable-with-warnings', 'incomparable'];
+/**
+ * Hard-incompatibility reason codes are `blocking` (force `incomparable`
+ * unless the repository can prove a dimension cannot be evaluated
+ * reliably); warning-only differences are `warning` (do not by themselves
+ * prevent useful page-level comparison); dimensions the observer does not
+ * yet model (theme/authenticated-state/application-state identity) are
+ * `unassessed` and never claimed identical without evidence.
+ */
+export const COMPARABILITY_REASON_CODES = [
+    'artifact-kind-mismatch',
+    'schema-version-mismatch',
+    'page-url-mismatch',
+    'viewport-mismatch',
+    'scroll-scenario-mismatch',
+    'browser-engine-mismatch',
+    'producer-version-mismatch',
+    'browser-version-mismatch',
+    'target-set-mismatch',
+    'target-locator-mismatch',
+    'theme-unassessed',
+    'authenticated-state-unassessed',
+    'application-state-unassessed',
+];
+export const COMPARABILITY_REASON_SEVERITY = {
+    'artifact-kind-mismatch': 'blocking',
+    'schema-version-mismatch': 'blocking',
+    'page-url-mismatch': 'blocking',
+    'viewport-mismatch': 'blocking',
+    'scroll-scenario-mismatch': 'blocking',
+    'browser-engine-mismatch': 'blocking',
+    'producer-version-mismatch': 'warning',
+    'browser-version-mismatch': 'warning',
+    'target-set-mismatch': 'warning',
+    'target-locator-mismatch': 'warning',
+    'theme-unassessed': 'unassessed',
+    'authenticated-state-unassessed': 'unassessed',
+    'application-state-unassessed': 'unassessed',
+};
+function isValidComparabilityReason(value) {
+    if (!isPlainObject(value))
+        return false;
+    const code = value.code;
+    if (typeof code !== 'string' || !COMPARABILITY_REASON_CODES.includes(code))
+        return false;
+    if (value.severity !== COMPARABILITY_REASON_SEVERITY[code])
+        return false;
+    return typeof value.message === 'string';
+}
+/** `incomparable` requires at least one `blocking` reason; a `blocking` reason forces `incomparable` - the two invariants are enforced together. */
+export function isValidComparabilityResult(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.state !== 'string' || !COMPARABILITY_STATES.includes(value.state))
+        return false;
+    if (!Array.isArray(value.reasons) || !value.reasons.every((r) => isValidComparabilityReason(r)))
+        return false;
+    const reasons = value.reasons;
+    const hasBlocking = reasons.some((r) => r.severity === 'blocking');
+    if (value.state === 'incomparable' && !hasBlocking)
+        return false;
+    if (value.state !== 'incomparable' && hasBlocking)
+        return false;
+    return true;
+}
+// --- Target-configuration change (never conflated with appeared/disappeared) --
+export const TARGET_CONFIGURATION_CHANGE_KINDS = ['added', 'removed', 'locator-changed'];
+export function isValidTargetConfigurationChange(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.kind !== 'string' || !TARGET_CONFIGURATION_CHANGE_KINDS.includes(value.kind))
+        return false;
+    return typeof value.target === 'string' && value.target.length > 0;
+}
+// --- Difference vocabulary ---------------------------------------------------
+export const DIFFERENCE_KINDS = [
+    'appeared',
+    'disappeared',
+    'moved',
+    'resized',
+    'visibility-changed',
+    'clipping-changed',
+    'containment-changed',
+    'horizontal-overflow-changed',
+    'vertical-overflow-changed',
+    'page-size-changed',
+    'scroll-owner-changed',
+    'relative-position-changed',
+    'relationship-changed',
+];
+function isValidComparisonDifferenceSubject(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (value.type === 'target')
+        return typeof value.target === 'string' && value.target.length > 0;
+    if (value.type === 'page')
+        return Object.keys(value).length === 1;
+    if (value.type === 'relationship') {
+        const allKinds = [...PAIRWISE_RELATIONSHIP_KINDS, ...PAGE_LEVEL_RELATIONSHIP_KINDS];
+        if (typeof value.kind !== 'string' || !allKinds.includes(value.kind))
+            return false;
+        if ('subjectTarget' in value && value.subjectTarget !== undefined && typeof value.subjectTarget !== 'string')
+            return false;
+        if ('relatedTarget' in value && value.relatedTarget !== undefined && typeof value.relatedTarget !== 'string')
+            return false;
+        return true;
+    }
+    return false;
+}
+export function isValidComparisonDifference(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.kind !== 'string' || !DIFFERENCE_KINDS.includes(value.kind))
+        return false;
+    if (!isValidComparisonDifferenceSubject(value.subject))
+        return false;
+    if (!('before' in value) || !('after' in value))
+        return false;
+    if (typeof value.classification !== 'string' || value.classification.length === 0)
+        return false;
+    if (typeof value.beforeObservationId !== 'string' || value.beforeObservationId.length === 0)
+        return false;
+    if (typeof value.afterObservationId !== 'string' || value.afterObservationId.length === 0)
+        return false;
+    return isEvidenceReferenceArray(value.evidence);
+}
+function isValidRelationshipChangeRecord(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (value.scope !== 'pairwise' && value.scope !== 'page')
+        return false;
+    const allKinds = [...PAIRWISE_RELATIONSHIP_KINDS, ...PAGE_LEVEL_RELATIONSHIP_KINDS];
+    const allValues = [...allKinds, 'unavailable'];
+    if (typeof value.kind !== 'string' || !allKinds.includes(value.kind))
+        return false;
+    if (value.scope === 'pairwise') {
+        if (typeof value.subjectTarget !== 'string' || value.subjectTarget.length === 0)
+            return false;
+        if (typeof value.relatedTarget !== 'string' || value.relatedTarget.length === 0)
+            return false;
+    }
+    else if ('subjectTarget' in value || 'relatedTarget' in value) {
+        return false;
+    }
+    if (typeof value.before !== 'string' || !allValues.includes(value.before))
+        return false;
+    if (typeof value.after !== 'string' || !allValues.includes(value.after))
+        return false;
+    if (typeof value.beforeObservationId !== 'string' || value.beforeObservationId.length === 0)
+        return false;
+    return typeof value.afterObservationId === 'string' && value.afterObservationId.length > 0;
+}
+export function isValidComparisonSourceObservationReference(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.observationId !== 'string' || value.observationId.length === 0)
+        return false;
+    if (typeof value.requestId !== 'string' || value.requestId.length === 0)
+        return false;
+    if (!isPlainObject(value.producer) || value.producer.name !== PRODUCER_NAME || typeof value.producer.version !== 'string' || value.producer.version.length === 0) {
+        return false;
+    }
+    if (value.observationSchemaVersion !== OBSERVATION_SCHEMA_VERSION)
+        return false;
+    return isPlainObject(value.screenshot) && typeof value.screenshot.path === 'string' && value.screenshot.path.length > 0;
+}
+function isValidDiagnostic(value) {
+    if (!isPlainObject(value))
+        return false;
+    const code = value.code;
+    if (typeof code !== 'string' || !DIAGNOSTIC_CODES.includes(code))
+        return false;
+    if (value.severity !== DIAGNOSTIC_SEVERITY[code])
+        return false;
+    if (typeof value.message !== 'string')
+        return false;
+    if ('targetName' in value && value.targetName !== undefined && typeof value.targetName !== 'string')
+        return false;
+    return true;
+}
+/** Structural validator for the frozen ComparisonArtifact contract. Never delegates to `isValidObservationArtifact` - comparison and observation are different artifact kinds/schemas. */
+export function isValidComparisonArtifact(value) {
+    if (!isPlainObject(value))
+        return { valid: false, reason: 'artifact must be an object' };
+    if (value.artifactKind !== COMPARISON_ARTIFACT_KIND)
+        return { valid: false, reason: 'artifactKind mismatch' };
+    if (value.schemaVersion !== COMPARISON_SCHEMA_VERSION)
+        return { valid: false, reason: 'schemaVersion mismatch' };
+    if (typeof value.comparisonId !== 'string' || value.comparisonId.length === 0)
+        return { valid: false, reason: 'comparisonId must be a non-empty string' };
+    if (typeof value.comparisonRequestId !== 'string' || value.comparisonRequestId.length === 0) {
+        return { valid: false, reason: 'comparisonRequestId must be a non-empty string' };
+    }
+    if (!isPlainObject(value.producer) || value.producer.name !== PRODUCER_NAME || typeof value.producer.version !== 'string' || value.producer.version.length === 0) {
+        return { valid: false, reason: 'producer must be { name: "my-frontend-observer", version: string }' };
+    }
+    if (!isPlainObject(value.provenance) || typeof value.provenance.comparedAt !== 'string' || value.provenance.comparedAt.length === 0) {
+        return { valid: false, reason: 'provenance.comparedAt must be a non-empty string' };
+    }
+    if (!isValidComparisonSourceObservationReference(value.before))
+        return { valid: false, reason: 'before source observation reference is invalid' };
+    if (!isValidComparisonSourceObservationReference(value.after))
+        return { valid: false, reason: 'after source observation reference is invalid' };
+    if (!isValidComparisonConfig(value.config))
+        return { valid: false, reason: 'config is invalid' };
+    if (!isValidComparabilityResult(value.comparability))
+        return { valid: false, reason: 'comparability is invalid' };
+    if (!Array.isArray(value.configurationChanges) || !value.configurationChanges.every((c) => isValidTargetConfigurationChange(c))) {
+        return { valid: false, reason: 'configurationChanges must be an array of valid TargetConfigurationChange values' };
+    }
+    if (!isValidLayoutRelationshipGraph(value.relationshipsBefore))
+        return { valid: false, reason: 'relationshipsBefore is invalid' };
+    if (!isValidLayoutRelationshipGraph(value.relationshipsAfter))
+        return { valid: false, reason: 'relationshipsAfter is invalid' };
+    if (!Array.isArray(value.differences) || !value.differences.every((d) => isValidComparisonDifference(d))) {
+        return { valid: false, reason: 'differences must be an array of valid ComparisonDifference values' };
+    }
+    if (!Array.isArray(value.relationshipChanges) || !value.relationshipChanges.every((r) => isValidRelationshipChangeRecord(r))) {
+        return { valid: false, reason: 'relationshipChanges must be an array of valid RelationshipChangeRecord values' };
+    }
+    if (!Array.isArray(value.expectedDependencyEvidence) || !value.expectedDependencyEvidence.every((e) => isValidExpectedDependencyEvidence(e))) {
+        return { valid: false, reason: 'expectedDependencyEvidence must be an array of valid ExpectedDependencyEvidence values' };
+    }
+    if (!Array.isArray(value.diagnostics) || !value.diagnostics.every((d) => isValidDiagnostic(d))) {
+        return { valid: false, reason: 'diagnostics must be an array of valid Diagnostic values' };
+    }
+    const limits = value.limits;
+    if (!isPlainObject(limits) ||
+        typeof limits.truncated !== 'boolean' ||
+        !Array.isArray(limits.omittedFields) ||
+        !limits.omittedFields.every((f) => typeof f === 'string') ||
+        !Array.isArray(limits.omittedTargetPairs) ||
+        !limits.omittedTargetPairs.every((f) => typeof f === 'string')) {
+        return { valid: false, reason: 'limits must be { truncated: boolean; omittedFields: string[]; omittedTargetPairs: string[] }' };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=comparison.js.map

package/dist/domain/comparison.js.map

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

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;