@photivra/engine 0.5.1 → 0.6.0

package/dist/sensor/optical-stack.js

@@ -0,0 +1,286 @@
+// SPDX-License-Identifier: Apache-2.0
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+const COMPONENT_ROLES = new Set([
+    "cover-glass",
+    "infrared-cut",
+    "ultraviolet-cut",
+    "anti-reflection",
+    "birefringent-low-pass",
+    "wave-plate",
+    "other-optical-filter"
+]);
+function requireRecord(value, path) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an object.");
+    }
+    return value;
+}
+function requireNonEmptyString(value, path) {
+    if (typeof value !== "string" ||
+        value.trim().length === 0) {
+        throw new InvalidConfigurationError(path + " must be a non-empty string.");
+    }
+    return value;
+}
+function parseComponentRoles(value, path) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new InvalidConfigurationError(path + " must be a non-empty array.");
+    }
+    const roles = value.map((entry, index) => {
+        if (typeof entry !== "string" ||
+            !COMPONENT_ROLES.has(entry)) {
+            throw new InvalidConfigurationError(path + "[" + index + "] is invalid.");
+        }
+        return entry;
+    });
+    if (new Set(roles).size !== roles.length) {
+        throw new InvalidConfigurationError(path + " must not contain duplicate roles.");
+    }
+    return roles;
+}
+function parseOrderedComponents(value, path) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new InvalidConfigurationError(path + " must be a non-empty array.");
+    }
+    const components = value.map((entry, index) => {
+        const record = requireRecord(entry, path + "[" + index + "]");
+        return {
+            componentId: requireNonEmptyString(record.componentId, path + "[" + index + "].componentId"),
+            roles: parseComponentRoles(record.roles, path + "[" + index + "].roles"),
+            evidence: parseEvidenceList(record.evidence, path + "[" + index + "].evidence")
+        };
+    });
+    const ids = components.map((component) => component.componentId);
+    if (new Set(ids).size !== ids.length) {
+        throw new InvalidConfigurationError(path + " must not contain duplicate componentId values.");
+    }
+    return components;
+}
+function requireFiniteNumber(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value)) {
+        throw new InvalidConfigurationError(path + " must be a finite number.");
+    }
+    return value;
+}
+function parsePointSplitComponents(value, path) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new InvalidConfigurationError(path + " must be a non-empty array.");
+    }
+    const components = value.map((entry, index) => {
+        const record = requireRecord(entry, path + "[" + index + "]");
+        const offset = requireRecord(record.offsetMicrometers, path + "[" + index + "].offsetMicrometers");
+        const normalizedWeight = requireFiniteNumber(record.normalizedWeight, path + "[" + index + "].normalizedWeight");
+        if (normalizedWeight <= 0) {
+            throw new InvalidConfigurationError(path +
+                "[" +
+                index +
+                "].normalizedWeight must be greater than zero.");
+        }
+        return {
+            offsetMicrometers: {
+                x: requireFiniteNumber(offset.x, path +
+                    "[" +
+                    index +
+                    "].offsetMicrometers.x"),
+                y: requireFiniteNumber(offset.y, path +
+                    "[" +
+                    index +
+                    "].offsetMicrometers.y")
+            },
+            normalizedWeight
+        };
+    });
+    const weightSum = components.reduce((sum, component) => sum + component.normalizedWeight, 0);
+    if (!Number.isFinite(weightSum) ||
+        Math.abs(weightSum - 1) > 1e-12) {
+        throw new InvalidConfigurationError(path +
+            " normalizedWeight values must sum to 1 within 1e-12.");
+    }
+    return components;
+}
+function parseAntiAliasingResponse(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "absent" ||
+        record.kind === "present-unresolved") {
+        if (record.coordinateSystem !== undefined ||
+            record.scope !== undefined ||
+            record.components !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " absent/present-unresolved responses must omit kernel fields.");
+        }
+        return {
+            kind: record.kind,
+            evidence: parseEvidenceList(record.evidence, path + ".evidence")
+        };
+    }
+    if (record.kind ===
+        "normalized-point-splitting-kernel") {
+        if (record.coordinateSystem !==
+            "native-sensor-physical") {
+            throw new InvalidConfigurationError(path +
+                '.coordinateSystem must be "native-sensor-physical".');
+        }
+        if (record.scope !==
+            "field-wavelength-polarization-invariant-approximation") {
+            throw new InvalidConfigurationError(path + ".scope is invalid.");
+        }
+        return {
+            kind: "normalized-point-splitting-kernel",
+            evidence: parseEvidenceList(record.evidence, path + ".evidence"),
+            coordinateSystem: "native-sensor-physical",
+            scope: "field-wavelength-polarization-invariant-approximation",
+            components: parsePointSplitComponents(record.components, path + ".components")
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+function parseMicrolens(value, path) {
+    const record = requireRecord(value, path);
+    if (record.presence !== "present" &&
+        record.presence !== "absent") {
+        throw new InvalidConfigurationError(path + ".presence is invalid.");
+    }
+    if (record.opticalEffectModel !== "unresolved") {
+        throw new InvalidConfigurationError(path +
+            '.opticalEffectModel must be "unresolved" in schema 0.1.0.');
+    }
+    return {
+        presence: record.presence,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence"),
+        opticalEffectModel: "unresolved"
+    };
+}
+/**
+ * Parses descriptive sensor optical-stack metadata plus an optional explicitly
+ * declared effective anti-aliasing spatial response.
+ *
+ * Unknown facts are omitted instead of inferred. Physical component presence
+ * is intentionally separate from effective anti-aliasing response so the
+ * schema can represent cancellation/neutralization designs without claiming
+ * the physical assembly is absent.
+ *
+ * Cover/filter-stack and microlens presence do not create optical effects in
+ * schema 0.1.0. Thickness, refractive index, spectral transmission, angular
+ * acceptance, focus shift and microlens collection behavior require later
+ * explicit models/calibration.
+ */
+export function parseSensorOpticalStackProfile(value) {
+    const profile = requireRecord(value, "sensorOpticalStack");
+    if (profile.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('sensorOpticalStack.schemaVersion must be "0.1.0".');
+    }
+    const orderedComponents = profile.orderedComponents === undefined
+        ? undefined
+        : parseOrderedComponents(profile.orderedComponents, "sensorOpticalStack.orderedComponents");
+    const effectiveAntiAliasingSpatialResponse = profile.effectiveAntiAliasingSpatialResponse ===
+        undefined
+        ? undefined
+        : parseAntiAliasingResponse(profile.effectiveAntiAliasingSpatialResponse, "sensorOpticalStack.effectiveAntiAliasingSpatialResponse");
+    const microlens = profile.microlens === undefined
+        ? undefined
+        : parseMicrolens(profile.microlens, "sensorOpticalStack.microlens");
+    if (orderedComponents === undefined &&
+        effectiveAntiAliasingSpatialResponse ===
+            undefined &&
+        microlens === undefined) {
+        throw new InvalidConfigurationError("sensorOpticalStack must assert at least one optical-stack fact.");
+    }
+    return {
+        schemaVersion: "0.1.0",
+        profileId: requireNonEmptyString(profile.profileId, "sensorOpticalStack.profileId"),
+        evidence: parseEvidenceList(profile.evidence, "sensorOpticalStack.evidence"),
+        ...(orderedComponents === undefined
+            ? {}
+            : { orderedComponents }),
+        ...(effectiveAntiAliasingSpatialResponse ===
+            undefined
+            ? {}
+            : {
+                effectiveAntiAliasingSpatialResponse
+            }),
+        ...(microlens === undefined
+            ? {}
+            : { microlens })
+    };
+}
+/**
+ * Resolves only the effective anti-aliasing spatial kernel.
+ *
+ * This is not a whole optical-stack PSF. Cover/filter transmission, refraction,
+ * microlens behavior, field/wavelength/polarization dependence, and total
+ * throughput remain excluded.
+ *
+ * A documented absent effective anti-aliasing response resolves to an identity
+ * component at zero offset. An unknown response (field omitted) or a
+ * present-but-unresolved response fails closed.
+ */
+export function resolveAntiAliasingSpatialKernel(profileInput) {
+    const profile = parseSensorOpticalStackProfile(profileInput);
+    const response = profile.effectiveAntiAliasingSpatialResponse;
+    if (response === undefined) {
+        throw new InvalidScientificInputError("Effective anti-aliasing spatial response is unknown/unasserted for this optical-stack profile.");
+    }
+    if (response.kind === "present-unresolved") {
+        throw new InvalidScientificInputError("Effective anti-aliasing spatial response is present but unresolved; a spatial kernel cannot be produced.");
+    }
+    if (response.kind === "absent") {
+        return {
+            profileId: profile.profileId,
+            effectiveResponse: "absent",
+            coordinateSystem: "native-sensor-physical",
+            components: [
+                {
+                    offsetMicrometers: {
+                        x: 0,
+                        y: 0
+                    },
+                    normalizedWeight: 1
+                }
+            ],
+            normalizedWeightSum: 1,
+            throughputIncluded: false,
+            spectralTransmissionIncluded: false,
+            fieldDependenceIncluded: false,
+            wavelengthDependenceIncluded: false,
+            polarizationDependenceIncluded: false,
+            microlensResponseIncluded: false,
+            coverFilterStackEffectsIncluded: false,
+            wholeSensorOpticalStackResponse: false,
+            provenance: {
+                profile: profile.evidence,
+                antiAliasingResponse: response.evidence
+            }
+        };
+    }
+    const normalizedWeightSum = response.components.reduce((sum, component) => sum + component.normalizedWeight, 0);
+    return {
+        profileId: profile.profileId,
+        effectiveResponse: "normalized-point-splitting-kernel",
+        coordinateSystem: "native-sensor-physical",
+        components: response.components.map((component) => ({
+            offsetMicrometers: {
+                ...component.offsetMicrometers
+            },
+            normalizedWeight: component.normalizedWeight
+        })),
+        normalizedWeightSum,
+        throughputIncluded: false,
+        spectralTransmissionIncluded: false,
+        fieldDependenceIncluded: false,
+        wavelengthDependenceIncluded: false,
+        polarizationDependenceIncluded: false,
+        microlensResponseIncluded: false,
+        coverFilterStackEffectsIncluded: false,
+        wholeSensorOpticalStackResponse: false,
+        provenance: {
+            profile: profile.evidence,
+            antiAliasingResponse: response.evidence
+        }
+    };
+}
+//# sourceMappingURL=optical-stack.js.map

package/dist/sensor/optical-stack.js.map

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

package/dist/sensor/readout-exposure-linkage.d.ts

@@ -0,0 +1,111 @@
+import { type CalculationProvenance, type CalculationResult } from "../core/calculation-result.js";
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { RasterPoint, RasterRect } from "../output/capture-geometry.js";
+import { type ExposureBoundarySchedule, type SourcedCaptureTimingSeconds } from "./exposure-window.js";
+import { type CaptureShutterMechanism, type NativeSensorReadoutScanDirection, type SensorReadoutTimingDeclaration, type SourcedSensorTimingSeconds } from "./readout-timing.js";
+import type { NativeImageRaster } from "./sensor-geometry.js";
+export type ReadoutExposureBoundaryId = "opening" | "closing";
+export type ReadoutExposureSpatialPhaseOrientation = "same" | "reversed";
+export interface ReadoutExposureBoundarySpatialLink {
+    boundary: ReadoutExposureBoundaryId;
+    /**
+     * Relationship between normalized rolling-readout scan phase and the
+     * selected electronic exposure-boundary scan phase.
+     *
+     * "same": boundary normalized phase = readout normalized phase.
+     * "reversed": boundary normalized phase = 1 - readout normalized phase.
+     *
+     * This does not establish absolute temporal synchronization.
+     */
+    phaseOrientation: ReadoutExposureSpatialPhaseOrientation;
+    /**
+     * Evidence supporting the relationship itself.
+     *
+     * The readout direction/timing and exposure-boundary direction/timing retain
+     * their own separate evidence.
+     */
+    evidence: readonly EvidenceProvenance[];
+}
+export type ReadoutExposureTimingLinkageDeclaration = {
+    /**
+     * Photivra asserts no readout↔exposure relationship for this capture.
+     * This is not evidence that the physical processes are independent.
+     */
+    kind: "unlinked";
+    links?: never;
+} | {
+    /**
+     * One or more exposure boundaries are explicitly related to rolling
+     * readout by normalized native-sensor spatial phase.
+     */
+    kind: "spatial-phase-linked";
+    links: readonly ReadoutExposureBoundarySpatialLink[];
+};
+export interface AssessReadoutExposureTimingLinkageInput {
+    nativeRaster: NativeImageRaster;
+    activeCaptureRect?: RasterRect;
+    shutterMechanism: CaptureShutterMechanism;
+    readout: SensorReadoutTimingDeclaration;
+    nominalExposureDurationSeconds: SourcedCaptureTimingSeconds;
+    opening: ExposureBoundarySchedule;
+    closing: ExposureBoundarySchedule;
+    linkage: ReadoutExposureTimingLinkageDeclaration;
+    samplePointsNative?: readonly RasterPoint[];
+}
+export interface ReadoutExposureBoundarySpatialLinkAssessment {
+    boundary: ReadoutExposureBoundaryId;
+    boundaryActuator: "electronic";
+    phaseOrientation: ReadoutExposureSpatialPhaseOrientation;
+    normalizedPhaseRelationship: "boundary-phase-equals-readout-phase" | "boundary-phase-equals-one-minus-readout-phase";
+    relationshipEvidence: readonly EvidenceProvenance[];
+    readoutDirectionNative: NativeSensorReadoutScanDirection;
+    boundaryDirectionNative: NativeSensorReadoutScanDirection;
+    /**
+     * First-to-last rolling sensor spatial sampling skew.
+     */
+    readoutSpatialSamplingSkewSeconds: SourcedSensorTimingSeconds;
+    /**
+     * First-to-last exposure-boundary traversal duration.
+     */
+    boundaryTraversalDurationSeconds: SourcedCaptureTimingSeconds;
+    /**
+     * Derived descriptive ratio only. A value of 1 does not prove temporal
+     * synchronization or a common clock origin.
+     */
+    boundaryTraversalToReadoutSpatialSkewRatio: number;
+    absoluteTemporalAlignment: "not-established";
+}
+export interface ReadoutExposureTimingLinkageAssessment {
+    linkageKind: ReadoutExposureTimingLinkageDeclaration["kind"];
+    relationshipMeaning: "no-readout-exposure-relationship-asserted" | "normalized-spatial-phase-relationship-asserted";
+    readoutMode: "rolling" | "global";
+    shutterMechanism: CaptureShutterMechanism;
+    activeCaptureRect: RasterRect;
+    absoluteTemporalAlignment: "not-established";
+    /**
+     * Capture data-readout duration is preserved for diagnostics but is not used
+     * to validate any exposure-boundary linkage.
+     */
+    captureReadoutDurationSeconds: SourcedSensorTimingSeconds;
+    links: readonly ReadoutExposureBoundarySpatialLinkAssessment[];
+    componentProvenance: {
+        sensorReadout: CalculationProvenance;
+        exposureWindows: CalculationProvenance;
+    };
+}
+/**
+ * Assesses an explicitly declared relationship between rolling sensor readout
+ * spatial phase and one or more electronic exposure-boundary scans.
+ *
+ * This contract is deliberately weaker than temporal synchronization. It can
+ * establish that two schedules traverse the same native spatial phase ordering
+ * (or its reverse), but it does not establish when sensor data readout occurs
+ * relative to exposure start/end.
+ *
+ * The total capture data-readout duration is preserved diagnostically and is
+ * never used to validate the relationship. Different rolling-readout spatial
+ * skew and exposure-boundary traversal durations are allowed; their ratio is
+ * reported without implying a shared clock origin.
+ */
+export declare function assessReadoutExposureTimingLinkage(input: AssessReadoutExposureTimingLinkageInput): CalculationResult<ReadoutExposureTimingLinkageAssessment>;
+//# sourceMappingURL=readout-exposure-linkage.d.ts.map

package/dist/sensor/readout-exposure-linkage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readout-exposure-linkage.d.ts","sourceRoot":"","sources":["../../src/sensor/readout-exposure-linkage.ts"],"names":[],"mappings":"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"}

package/dist/sensor/readout-exposure-linkage.js

@@ -0,0 +1,210 @@
+// SPDX-License-Identifier: Apache-2.0
+import { approximationResult } from "../core/calculation-result.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { calculateCaptureExposureWindows } from "./exposure-window.js";
+import { calculateSensorReadoutTiming } from "./readout-timing.js";
+const BOUNDARIES = new Set([
+    "opening",
+    "closing"
+]);
+const PHASE_ORIENTATIONS = new Set([
+    "same",
+    "reversed"
+]);
+function requireRecord(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new InvalidScientificInputError(path + " must be an object.");
+    }
+    return value;
+}
+function parseSpatialLink(value, path) {
+    const record = requireRecord(value, path);
+    if (typeof record.boundary !== "string" ||
+        !BOUNDARIES.has(record.boundary)) {
+        throw new InvalidScientificInputError(path + ".boundary is invalid.");
+    }
+    if (typeof record.phaseOrientation !== "string" ||
+        !PHASE_ORIENTATIONS.has(record.phaseOrientation)) {
+        throw new InvalidScientificInputError(path + ".phaseOrientation is invalid.");
+    }
+    return {
+        boundary: record.boundary,
+        phaseOrientation: record.phaseOrientation,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseLinkageDeclaration(value) {
+    const record = requireRecord(value, "linkage");
+    if (record.kind === "unlinked") {
+        if (record.links !== undefined) {
+            throw new InvalidScientificInputError("linkage.links must be omitted when linkage.kind is unlinked.");
+        }
+        return { kind: "unlinked" };
+    }
+    if (record.kind !== "spatial-phase-linked") {
+        throw new InvalidScientificInputError("linkage.kind is invalid.");
+    }
+    if (!Array.isArray(record.links) || record.links.length === 0) {
+        throw new InvalidScientificInputError("linkage.links must be a non-empty array for spatial-phase-linked linkage.");
+    }
+    const links = record.links.map((entry, index) => parseSpatialLink(entry, "linkage.links[" + index + "]"));
+    const seen = new Set();
+    for (const link of links) {
+        if (seen.has(link.boundary)) {
+            throw new InvalidScientificInputError("linkage.links must not contain duplicate boundary links.");
+        }
+        seen.add(link.boundary);
+    }
+    return {
+        kind: "spatial-phase-linked",
+        links
+    };
+}
+function oppositeDirection(direction) {
+    switch (direction) {
+        case "top-to-bottom":
+            return "bottom-to-top";
+        case "bottom-to-top":
+            return "top-to-bottom";
+        case "left-to-right":
+            return "right-to-left";
+        case "right-to-left":
+            return "left-to-right";
+    }
+}
+function expectedBoundaryDirection(readoutDirection, phaseOrientation) {
+    return phaseOrientation === "same"
+        ? readoutDirection
+        : oppositeDirection(readoutDirection);
+}
+/**
+ * Assesses an explicitly declared relationship between rolling sensor readout
+ * spatial phase and one or more electronic exposure-boundary scans.
+ *
+ * This contract is deliberately weaker than temporal synchronization. It can
+ * establish that two schedules traverse the same native spatial phase ordering
+ * (or its reverse), but it does not establish when sensor data readout occurs
+ * relative to exposure start/end.
+ *
+ * The total capture data-readout duration is preserved diagnostically and is
+ * never used to validate the relationship. Different rolling-readout spatial
+ * skew and exposure-boundary traversal durations are allowed; their ratio is
+ * reported without implying a shared clock origin.
+ */
+export function assessReadoutExposureTimingLinkage(input) {
+    const linkage = parseLinkageDeclaration(input.linkage);
+    const sensorReadout = calculateSensorReadoutTiming({
+        nativeRaster: input.nativeRaster,
+        ...(input.activeCaptureRect === undefined
+            ? {}
+            : { activeCaptureRect: input.activeCaptureRect }),
+        shutterMechanism: input.shutterMechanism,
+        readout: input.readout,
+        ...(input.samplePointsNative === undefined
+            ? {}
+            : { samplePointsNative: input.samplePointsNative })
+    });
+    const exposureWindows = calculateCaptureExposureWindows({
+        nativeRaster: input.nativeRaster,
+        ...(input.activeCaptureRect === undefined
+            ? {}
+            : { activeCaptureRect: input.activeCaptureRect }),
+        shutterMechanism: input.shutterMechanism,
+        nominalExposureDurationSeconds: input.nominalExposureDurationSeconds,
+        opening: input.opening,
+        closing: input.closing,
+        ...(input.samplePointsNative === undefined
+            ? {}
+            : { samplePointsNative: input.samplePointsNative })
+    });
+    if (linkage.kind === "unlinked") {
+        return approximationResult({
+            linkageKind: "unlinked",
+            relationshipMeaning: "no-readout-exposure-relationship-asserted",
+            readoutMode: sensorReadout.value.readoutMode,
+            shutterMechanism: input.shutterMechanism,
+            activeCaptureRect: {
+                ...sensorReadout.value.activeCaptureRect
+            },
+            absoluteTemporalAlignment: "not-established",
+            captureReadoutDurationSeconds: sensorReadout.value.captureReadoutDurationSeconds,
+            links: [],
+            componentProvenance: {
+                sensorReadout: sensorReadout.provenance,
+                exposureWindows: exposureWindows.provenance
+            }
+        }, "readout-exposure-spatial-linkage", "1.0.0", [
+            "Unlinked means Photivra asserts no readout-to-exposure relationship for this capture; it does not prove the physical processes are independent.",
+            "Sensor data-readout timing and exposure-window timing retain independent provenance and semantics.",
+            "Absolute temporal alignment between data readout and exposure boundaries is not established."
+        ]);
+    }
+    const readoutScan = sensorReadout.value.scan;
+    if (readoutScan === null) {
+        throw new InvalidScientificInputError("spatial-phase-linked linkage requires rolling sensor readout with a spatial scan.");
+    }
+    const assessments = linkage.links.map((link) => {
+        const boundary = link.boundary === "opening"
+            ? exposureWindows.value.opening
+            : exposureWindows.value.closing;
+        if (boundary.actuator !== "electronic") {
+            throw new InvalidScientificInputError("A readout spatial-phase link may target only an electronic exposure boundary.");
+        }
+        if (boundary.schedule.kind !==
+            "uniform-linear-native-scan") {
+            throw new InvalidScientificInputError("A readout spatial-phase link requires the selected exposure boundary to use a uniform-linear native scan.");
+        }
+        const readoutDirection = readoutScan.directionNative.value;
+        const boundaryDirection = boundary.schedule.directionNative.value;
+        const expectedDirection = expectedBoundaryDirection(readoutDirection, link.phaseOrientation);
+        if (boundaryDirection !== expectedDirection) {
+            throw new InvalidScientificInputError("Declared readout/exposure spatial phase orientation contradicts the readout and exposure-boundary scan directions.");
+        }
+        const readoutSpatialSamplingSkewSeconds = readoutScan.spatialSamplingSkewSeconds;
+        const boundaryTraversalDurationSeconds = boundary.schedule.traversalDurationSeconds;
+        return {
+            boundary: link.boundary,
+            boundaryActuator: "electronic",
+            phaseOrientation: link.phaseOrientation,
+            normalizedPhaseRelationship: link.phaseOrientation === "same"
+                ? "boundary-phase-equals-readout-phase"
+                : "boundary-phase-equals-one-minus-readout-phase",
+            relationshipEvidence: link.evidence,
+            readoutDirectionNative: readoutDirection,
+            boundaryDirectionNative: boundaryDirection,
+            readoutSpatialSamplingSkewSeconds,
+            boundaryTraversalDurationSeconds,
+            boundaryTraversalToReadoutSpatialSkewRatio: boundaryTraversalDurationSeconds.value /
+                readoutSpatialSamplingSkewSeconds.value,
+            absoluteTemporalAlignment: "not-established"
+        };
+    });
+    return approximationResult({
+        linkageKind: "spatial-phase-linked",
+        relationshipMeaning: "normalized-spatial-phase-relationship-asserted",
+        readoutMode: sensorReadout.value.readoutMode,
+        shutterMechanism: input.shutterMechanism,
+        activeCaptureRect: {
+            ...sensorReadout.value.activeCaptureRect
+        },
+        absoluteTemporalAlignment: "not-established",
+        captureReadoutDurationSeconds: sensorReadout.value.captureReadoutDurationSeconds,
+        links: assessments,
+        componentProvenance: {
+            sensorReadout: sensorReadout.provenance,
+            exposureWindows: exposureWindows.provenance
+        }
+    }, "readout-exposure-spatial-linkage", "1.0.0", [
+        "The linkage establishes normalized native-sensor spatial phase/order only, not absolute temporal synchronization.",
+        "Every asserted boundary link carries evidence separate from the evidence for the underlying readout and exposure timing facts.",
+        "Only electronic exposure boundaries may be linked to rolling sensor readout spatial phase.",
+        "Same phase orientation requires matching native scan direction; reversed phase orientation requires the exact opposite direction on the same native axis.",
+        "Rolling readout spatial skew and exposure-boundary traversal duration may differ; their ratio is descriptive and does not establish a common clock origin.",
+        "Capture data-readout duration is not used to validate exposure-boundary timing linkage.",
+        "Active capture, native coordinate semantics and shutter mechanism are shared because both component schedules are resolved from the same input.",
+        "Sensor readout and exposure-window component provenance remain visible; linkage does not upgrade either component to calibrated status.",
+        "No camera-specific timing relationship is inferred from shutter mechanism, sensor architecture metadata, output resolution or adjacent specifications."
+    ]);
+}
+//# sourceMappingURL=readout-exposure-linkage.js.map

package/dist/sensor/readout-exposure-linkage.js.map

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