@photivra/engine 0.5.1 → 1.0.0

package/dist/sensor/camera-saturation-capacity.js

@@ -0,0 +1,356 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary. Camera saturation
+ * capacity is a dark-corrected photo-signal electron-equivalent limit. It is not physical total-charge
+ * storage capacity, ADC maximum or evidence of the limiting hardware stage. This assessment compares
+ * expectations and does not synthesize post-saturation codes.
+ * Compare dark-corrected expected photo signal with the declared camera response-chain capacity
+ * without adding dark charge or identifying a hardware clamp. Camera saturation capacity is a
+ * dark-corrected photo-signal electron-equivalent limit. It is not physical total-charge storage
+ * capacity, ADC maximum or evidence of the limiting hardware stage. This assessment compares
+ * expectations and does not synthesize post-saturation codes.
+ * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { approximationResult } from "../core/calculation-result.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+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 requireFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value)) {
+        throw new InvalidConfigurationError(path + " must be finite.");
+    }
+    return value;
+}
+function requirePositiveFinite(value, path) {
+    const parsed = requireFinite(value, path);
+    if (parsed <= 0) {
+        throw new InvalidConfigurationError(path +
+            " must be greater than zero.");
+    }
+    return parsed;
+}
+function requireNonNegativeFiniteInput(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value < 0) {
+        throw new InvalidScientificInputError(path +
+            " must be finite and greater than or equal to zero.");
+    }
+    return value;
+}
+function requireSiteIndex(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value < 0) {
+        throw new InvalidConfigurationError(path +
+            " must be a non-negative safe integer.");
+    }
+    return value;
+}
+function parseUncertainty(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "relative") {
+        const fraction = requireFinite(record.fraction, path + ".fraction");
+        if (fraction < 0) {
+            throw new InvalidConfigurationError(path +
+                ".fraction must be nonnegative.");
+        }
+        return {
+            kind: "relative",
+            fraction,
+            basis: requireNonEmptyString(record.basis, path + ".basis")
+        };
+    }
+    if (record.kind === "not-quantified") {
+        return {
+            kind: "not-quantified",
+            limitation: requireNonEmptyString(record.limitation, path + ".limitation")
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+function parseSiteApplicability(value) {
+    const record = requireRecord(value, "sensorCameraSaturation.siteApplicability");
+    if (record.kind === "exact-site") {
+        const site = requireRecord(record.site, "sensorCameraSaturation.siteApplicability.site");
+        return {
+            kind: "exact-site",
+            site: {
+                x: requireSiteIndex(site.x, "sensorCameraSaturation.siteApplicability.site.x"),
+                y: requireSiteIndex(site.y, "sensorCameraSaturation.siteApplicability.site.y")
+            }
+        };
+    }
+    if (record.kind ===
+        "channel-population-mean-approximation") {
+        return {
+            kind: "channel-population-mean-approximation",
+            limitation: requireNonEmptyString(record.limitation, "sensorCameraSaturation.siteApplicability.limitation"),
+            evidence: parseEvidenceList(record.evidence, "sensorCameraSaturation.siteApplicability.evidence")
+        };
+    }
+    throw new InvalidConfigurationError("sensorCameraSaturation.siteApplicability.kind is invalid.");
+}
+function parseTemperatureApplicability(value) {
+    const record = requireRecord(value, "sensorCameraSaturation.temperatureApplicability");
+    if (record.kind ===
+        "exact-reference-temperature") {
+        return {
+            kind: "exact-reference-temperature",
+            temperatureC: requireFinite(record.temperatureC, "sensorCameraSaturation.temperatureApplicability.temperatureC")
+        };
+    }
+    if (record.kind === "not-modeled") {
+        return {
+            kind: "not-modeled",
+            limitation: requireNonEmptyString(record.limitation, "sensorCameraSaturation.temperatureApplicability.limitation"),
+            evidence: parseEvidenceList(record.evidence, "sensorCameraSaturation.temperatureApplicability.evidence")
+        };
+    }
+    throw new InvalidConfigurationError("sensorCameraSaturation.temperatureApplicability.kind is invalid.");
+}
+/**
+ * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
+ * missing required fields and incompatible scientific data fail at this boundary.
+ *
+ * Camera saturation capacity is a dark-corrected photo-signal electron-equivalent limit. It is not
+ * physical total-charge storage capacity, ADC maximum or evidence of the limiting hardware stage. This
+ * assessment compares expectations and does not synthesize post-saturation codes.
+ * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
+ * @returns SensorCameraSaturationCapacityProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export function parseSensorCameraSaturationCapacityProfile(value) {
+    const record = requireRecord(value, "sensorCameraSaturation");
+    if (record.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('sensorCameraSaturation.schemaVersion must be "0.1.0".');
+    }
+    if (record.capacityMeaning !==
+        "camera-signal-saturation-capacity-electrons") {
+        throw new InvalidConfigurationError("sensorCameraSaturation.capacityMeaning is invalid.");
+    }
+    if (record.signalDomain !==
+        "dark-corrected-photo-generated-electron-equivalent") {
+        throw new InvalidConfigurationError("sensorCameraSaturation.signalDomain is invalid.");
+    }
+    if (record.scientificStatus !==
+        "calibrated" &&
+        record.scientificStatus !==
+            "approximation") {
+        throw new InvalidConfigurationError("sensorCameraSaturation.scientificStatus is invalid.");
+    }
+    const uncertainty = parseUncertainty(record.uncertainty, "sensorCameraSaturation.uncertainty");
+    if (record.scientificStatus ===
+        "calibrated" &&
+        uncertainty.kind ===
+            "not-quantified") {
+        throw new InvalidConfigurationError("A calibrated camera saturation-capacity profile must declare quantified relative uncertainty.");
+    }
+    const siteApplicability = parseSiteApplicability(record.siteApplicability);
+    const temperatureApplicability = parseTemperatureApplicability(record.temperatureApplicability);
+    if (siteApplicability.kind ===
+        "channel-population-mean-approximation" &&
+        record.scientificStatus !==
+            "approximation") {
+        throw new InvalidConfigurationError("A channel-population mean camera saturation capacity must remain an approximation when applied to one site.");
+    }
+    if (temperatureApplicability.kind ===
+        "not-modeled" &&
+        record.scientificStatus !==
+            "approximation") {
+        throw new InvalidConfigurationError("A camera saturation capacity with unmodeled temperature dependence must remain an approximation.");
+    }
+    const state = requireRecord(record.operatingState, "sensorCameraSaturation.operatingState");
+    return {
+        schemaVersion: "0.1.0",
+        profileId: requireNonEmptyString(record.profileId, "sensorCameraSaturation.profileId"),
+        colorSamplingProfileId: requireNonEmptyString(record.colorSamplingProfileId, "sensorCameraSaturation.colorSamplingProfileId"),
+        channelId: requireNonEmptyString(record.channelId, "sensorCameraSaturation.channelId"),
+        capacityMeaning: "camera-signal-saturation-capacity-electrons",
+        signalDomain: "dark-corrected-photo-generated-electron-equivalent",
+        saturationCapacityElectrons: requirePositiveFinite(record.saturationCapacityElectrons, "sensorCameraSaturation.saturationCapacityElectrons"),
+        scientificStatus: record.scientificStatus,
+        uncertainty,
+        evidence: parseEvidenceList(record.evidence, "sensorCameraSaturation.evidence"),
+        measurementMethodId: requireNonEmptyString(record.measurementMethodId, "sensorCameraSaturation.measurementMethodId"),
+        measurementMethodEvidence: parseEvidenceList(record.measurementMethodEvidence, "sensorCameraSaturation.measurementMethodEvidence"),
+        siteApplicability,
+        operatingState: {
+            stateId: requireNonEmptyString(state.stateId, "sensorCameraSaturation.operatingState.stateId"),
+            evidence: parseEvidenceList(state.evidence, "sensorCameraSaturation.operatingState.evidence")
+        },
+        temperatureApplicability
+    };
+}
+function sameSite(a, b) {
+    return a.x === b.x && a.y === b.y;
+}
+function validateCharge(charge) {
+    if (charge.accumulatedChargeCompleteness !==
+        "complete-for-physical-storage-capacity-assessment" ||
+        charge.saturationAssessed !==
+            false ||
+        charge.adcQuantizationApplied !==
+            false ||
+        charge.rawCodeValueProduced !==
+            false) {
+        throw new InvalidScientificInputError("Camera saturation assessment requires an unmodified pre-saturation accumulated-charge composition.");
+    }
+    return {
+        photo: requireNonNegativeFiniteInput(charge.photoExpectedElectronCount, "accumulatedCharge.photoExpectedElectronCount"),
+        total: requireNonNegativeFiniteInput(charge.totalExpectedStoredElectronCount, "accumulatedCharge.totalExpectedStoredElectronCount")
+    };
+}
+/**
+ * Compare dark-corrected expected photo signal with the declared camera response-chain capacity
+ * without adding dark charge or identifying a hardware clamp.
+ *
+ * Camera saturation capacity is a dark-corrected photo-signal electron-equivalent limit. It is not
+ * physical total-charge storage capacity, ADC maximum or evidence of the limiting hardware stage. This
+ * assessment compares expectations and does not synthesize post-saturation codes.
+ * @param input - AssessSensorCameraSaturationCapacityInput. See the linked contract for coordinate, unit and profile binding semantics.
+ * @returns CalculationResult<SensorCameraSaturationCapacityAssessment>. Read structured blockers before consuming an authorization.
+ *
+ * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ */
+export function assessSensorCameraSaturationCapacity(input) {
+    const charge = validateCharge(input.accumulatedCharge);
+    const profile = parseSensorCameraSaturationCapacityProfile(input.saturationProfile);
+    if (profile.colorSamplingProfileId !==
+        input.accumulatedCharge
+            .colorSamplingProfileId ||
+        profile.channelId !==
+            input.accumulatedCharge.channelId) {
+        throw new InvalidScientificInputError("Camera saturation-capacity profile color/channel identity must match the accumulated charge.");
+    }
+    if (profile.siteApplicability.kind ===
+        "exact-site" &&
+        !sameSite(profile.siteApplicability.site, input.accumulatedCharge.site)) {
+        throw new InvalidScientificInputError("Exact-site camera saturation capacity does not apply to the accumulated-charge site.");
+    }
+    if (typeof input.operatingStateId !==
+        "string" ||
+        input.operatingStateId.trim().length ===
+            0 ||
+        input.operatingStateId !==
+            profile.operatingState.stateId) {
+        throw new InvalidScientificInputError("operatingStateId must exactly match the camera saturation-capacity calibration state.");
+    }
+    if (typeof input.operatingTemperatureC !==
+        "number" ||
+        !Number.isFinite(input.operatingTemperatureC)) {
+        throw new InvalidScientificInputError("operatingTemperatureC must be finite.");
+    }
+    if (profile.temperatureApplicability.kind ===
+        "exact-reference-temperature" &&
+        input.operatingTemperatureC !==
+            profile.temperatureApplicability
+                .temperatureC) {
+        throw new InvalidScientificInputError("operatingTemperatureC must exactly match the camera saturation-capacity reference temperature.");
+    }
+    const capacity = profile.saturationCapacityElectrons;
+    const ratio = charge.photo / capacity;
+    const headroom = capacity - charge.photo;
+    if (!Number.isFinite(ratio) ||
+        !Number.isFinite(headroom)) {
+        throw new InvalidScientificInputError("Camera saturation-capacity comparison must remain finite.");
+    }
+    const status = charge.photo < capacity
+        ? "below-capacity"
+        : charge.photo === capacity
+            ? "at-capacity"
+            : "above-capacity";
+    return approximationResult({
+        saturationProfileId: profile.profileId,
+        completenessProfileId: input.accumulatedCharge
+            .completenessProfileId,
+        colorSamplingProfileId: input.accumulatedCharge
+            .colorSamplingProfileId,
+        channelId: input.accumulatedCharge.channelId,
+        site: {
+            ...input.accumulatedCharge.site
+        },
+        bindingId: input.accumulatedCharge.bindingId,
+        operatingStateId: input.operatingStateId,
+        operatingTemperatureC: input.operatingTemperatureC,
+        capacityMeaning: "camera-signal-saturation-capacity-electrons",
+        signalDomain: "dark-corrected-photo-generated-electron-equivalent",
+        cameraSignalSaturationCapacityElectrons: capacity,
+        expectedPhotoSignalElectronCount: charge.photo,
+        totalExpectedStoredElectronCountDiagnostic: charge.total,
+        totalStoredChargeUsedForCameraSaturationComparison: false,
+        expectedSignalToCameraSaturationRatio: ratio,
+        expectedSignalHeadroomElectrons: headroom,
+        expectedCameraSignalCapacityStatus: status,
+        expectedPhotoSignalExceedsCameraCapacity: status === "above-capacity",
+        cameraSaturationCapacityAssessmentPerformed: true,
+        assessmentMeaning: "expected-dark-corrected-photo-signal-vs-camera-saturation-capacity",
+        physicalChargeCapacityUsed: false,
+        limitingSaturationMechanismResolved: false,
+        analogClippingThresholdModeled: false,
+        digitalClippingThresholdModeled: false,
+        adcMaximumCodeUsed: false,
+        actualStochasticSaturationStateKnown: false,
+        stochasticSaturationProbabilityAssessed: false,
+        outputSignalAfterSaturationCalculated: false,
+        clampApplied: false,
+        physicalStoredChargeModified: false,
+        adcQuantizationApplied: false,
+        rawCodeValueProduced: false,
+        saturationCapacityUncertaintyPropagated: false,
+        photoSignalUncertaintyPropagated: false,
+        componentEvidence: {
+            saturationCapacity: profile.evidence,
+            measurementMethod: profile
+                .measurementMethodEvidence,
+            operatingState: profile.operatingState
+                .evidence,
+            siteApproximation: profile.siteApplicability.kind ===
+                "channel-population-mean-approximation"
+                ? profile
+                    .siteApplicability
+                    .evidence
+                : [],
+            temperatureApproximation: profile.temperatureApplicability.kind ===
+                "not-modeled"
+                ? profile
+                    .temperatureApplicability
+                    .evidence
+                : [],
+            chargeCompleteness: input.accumulatedCharge
+                .componentEvidence
+                .completeness
+        }
+    }, "sensor-camera-saturation-capacity-assessment", "1.0.0", [
+        "The camera saturation capacity is a measured/calibrated dark-corrected photo-signal capacity in electron-equivalent signal units; total stored charge is deliberately not used for this comparison.",
+        "Physical charge-storage capacity is a separate sensor property and is not used by this assessment.",
+        "The camera saturation capacity may be limited by a downstream camera stage before physical pixel storage is full; this contract does not infer which analog or digital stage is limiting.",
+        "The operating-state identifier is an exact calibration-state key covering the source-specific camera/readout configuration; Photivra does not infer equivalence from ISO, gain or bit-depth labels.",
+        "A channel-population mean applied to one site or unmodeled temperature dependence remains an explicit approximation.",
+        "Expected photo signal below the measured capacity does not establish the actual stochastic saturation state; no saturation probability is calculated.",
+        "No signal clamp, analog clipping transfer, ADC maximum code, RAW code or post-saturation output is calculated.",
+        "Dark and other stored charge remain diagnostics for physical storage accounting and are not silently added to a dark-corrected camera-signal capacity.",
+        "Capacity and photo-signal uncertainties are not propagated into a saturation probability or confidence interval by this version."
+    ]);
+}
+//# sourceMappingURL=camera-saturation-capacity.js.map

package/dist/sensor/camera-saturation-capacity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-saturation-capacity.js","sourceRoot":"","sources":["../../src/sensor/camera-saturation-capacity.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,mBAAmB,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AA8JpE,SAAS,aAAa,CACpB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,qBAAqB,CAC7B,CAAC;IACJ,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EACzB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,8BAA8B,CACtC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CACpB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EACvB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,kBAAkB,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,MAAM,MAAM,GAAG,aAAa,CAC1B,KAAK,EACL,IAAI,CACL,CAAC;IACF,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,6BAA6B,CAChC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,6BAA6B,CACpC,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,GAAG,CAAC,EACT,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,IAAI;YACF,oDAAoD,CACvD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,KAAK,GAAG,CAAC,EACT,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,uCAAuC,CAC1C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,IAAY;IAEZ,MAAM,MAAM,GAAG,aAAa,CAC1B,KAAK,EACL,IAAI,CACL,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,aAAa,CAC5B,MAAM,CAAC,QAAQ,EACf,IAAI,GAAG,WAAW,CACnB,CAAC;QACF,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,yBAAyB,CACjC,IAAI;gBACF,gCAAgC,CACnC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,QAAQ;YACR,KAAK,EAAE,qBAAqB,CAC1B,MAAM,CAAC,KAAK,EACZ,IAAI,GAAG,QAAQ,CAChB;SACF,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,IAAI,KAAK,gBAAgB,EAChC,CAAC;QACD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,UAAU,EACR,qBAAqB,CACnB,MAAM,CAAC,UAAU,EACjB,IAAI,GAAG,aAAa,CACrB;SACJ,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,mBAAmB,CAC3B,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAC1B,KAAK,EACL,0CAA0C,CAC3C,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,aAAa,CACxB,MAAM,CAAC,IAAI,EACX,+CAA+C,CAChD,CAAC;QACF,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE;gBACJ,CAAC,EAAE,gBAAgB,CACjB,IAAI,CAAC,CAAC,EACN,iDAAiD,CAClD;gBACD,CAAC,EAAE,gBAAgB,CACjB,IAAI,CAAC,CAAC,EACN,iDAAiD,CAClD;aACF;SACF,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,IAAI;QACT,uCAAuC,EACzC,CAAC;QACD,OAAO;YACL,IAAI,EACF,uCAAuC;YACzC,UAAU,EACR,qBAAqB,CACnB,MAAM,CAAC,UAAU,EACjB,qDAAqD,CACtD;YACH,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,mDAAmD,CACpD;SACF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,yBAAyB,CACjC,2DAA2D,CAC5D,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CACpC,KAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAC1B,KAAK,EACL,iDAAiD,CAClD,CAAC;IACF,IACE,MAAM,CAAC,IAAI;QACT,6BAA6B,EAC/B,CAAC;QACD,OAAO;YACL,IAAI,EACF,6BAA6B;YAC/B,YAAY,EACV,aAAa,CACX,MAAM,CAAC,YAAY,EACnB,8DAA8D,CAC/D;SACJ,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,UAAU,EACR,qBAAqB,CACnB,MAAM,CAAC,UAAU,EACjB,4DAA4D,CAC7D;YACH,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,0DAA0D,CAC3D;SACF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,yBAAyB,CACjC,kEAAkE,CACnE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0CAA0C,CACxD,KAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAC1B,KAAK,EACL,wBAAwB,CACzB,CAAC;IAEF,IACE,MAAM,CAAC,aAAa,KAAK,OAAO,EAChC,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,eAAe;QACpB,6CAA6C,EAC/C,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,oDAAoD,CACrD,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,YAAY;QACjB,oDAAoD,EACtD,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,iDAAiD,CAClD,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,gBAAgB;QACrB,YAAY;QACd,MAAM,CAAC,gBAAgB;YACrB,eAAe,EACjB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,qDAAqD,CACtD,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GACf,gBAAgB,CACd,MAAM,CAAC,WAAW,EAClB,oCAAoC,CACrC,CAAC;IACJ,IACE,MAAM,CAAC,gBAAgB;QACrB,YAAY;QACd,WAAW,CAAC,IAAI;YACd,gBAAgB,EAClB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,+FAA+F,CAChG,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GACrB,sBAAsB,CACpB,MAAM,CAAC,iBAAiB,CACzB,CAAC;IACJ,MAAM,wBAAwB,GAC5B,6BAA6B,CAC3B,MAAM,CAAC,wBAAwB,CAChC,CAAC;IAEJ,IACE,iBAAiB,CAAC,IAAI;QACpB,uCAAuC;QACzC,MAAM,CAAC,gBAAgB;YACrB,eAAe,EACjB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,6GAA6G,CAC9G,CAAC;IACJ,CAAC;IACD,IACE,wBAAwB,CAAC,IAAI;QAC3B,aAAa;QACf,MAAM,CAAC,gBAAgB;YACrB,eAAe,EACjB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CACzB,MAAM,CAAC,cAAc,EACrB,uCAAuC,CACxC,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,OAAO;QACtB,SAAS,EACP,qBAAqB,CACnB,MAAM,CAAC,SAAS,EAChB,kCAAkC,CACnC;QACH,sBAAsB,EACpB,qBAAqB,CACnB,MAAM,CAAC,sBAAsB,EAC7B,+CAA+C,CAChD;QACH,SAAS,EACP,qBAAqB,CACnB,MAAM,CAAC,SAAS,EAChB,kCAAkC,CACnC;QACH,eAAe,EACb,6CAA6C;QAC/C,YAAY,EACV,oDAAoD;QACtD,2BAA2B,EACzB,qBAAqB,CACnB,MAAM,CAAC,2BAA2B,EAClC,oDAAoD,CACrD;QACH,gBAAgB,EACd,MAAM,CAAC,gBAAgB;QACzB,WAAW;QACX,QAAQ,EAAE,iBAAiB,CACzB,MAAM,CAAC,QAAQ,EACf,iCAAiC,CAClC;QACD,mBAAmB,EACjB,qBAAqB,CACnB,MAAM,CAAC,mBAAmB,EAC1B,4CAA4C,CAC7C;QACH,yBAAyB,EACvB,iBAAiB,CACf,MAAM,CAAC,yBAAyB,EAChC,kDAAkD,CACnD;QACH,iBAAiB;QACjB,cAAc,EAAE;YACd,OAAO,EACL,qBAAqB,CACnB,KAAK,CAAC,OAAO,EACb,+CAA+C,CAChD;YACH,QAAQ,EAAE,iBAAiB,CACzB,KAAK,CAAC,QAAQ,EACd,gDAAgD,CACjD;SACF;QACD,wBAAwB;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CACf,CAA2B,EAC3B,CAA2B;IAE3B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,cAAc,CACrB,MACoC;IAKpC,IACE,MAAM,CAAC,6BAA6B;QAClC,mDAAmD;QACrD,MAAM,CAAC,kBAAkB;YACvB,KAAK;QACP,MAAM,CAAC,sBAAsB;YAC3B,KAAK;QACP,MAAM,CAAC,oBAAoB;YACzB,KAAK,EACP,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,oGAAoG,CACrG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,6BAA6B,CAClC,MAAM,CAAC,0BAA0B,EACjC,8CAA8C,CAC/C;QACD,KAAK,EAAE,6BAA6B,CAClC,MAAM,CAAC,gCAAgC,EACvC,oDAAoD,CACrD;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oCAAoC,CAClD,KAC2C;IAE3C,MAAM,MAAM,GACV,cAAc,CACZ,KAAK,CAAC,iBAAiB,CACxB,CAAC;IACJ,MAAM,OAAO,GACX,0CAA0C,CACxC,KAAK,CAAC,iBAAiB,CACxB,CAAC;IAEJ,IACE,OAAO,CAAC,sBAAsB;QAC5B,KAAK,CAAC,iBAAiB;aACpB,sBAAsB;QAC3B,OAAO,CAAC,SAAS;YACf,KAAK,CAAC,iBAAiB,CAAC,SAAS,EACnC,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,8FAA8F,CAC/F,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,iBAAiB,CAAC,IAAI;QAC5B,YAAY;QACd,CAAC,QAAQ,CACP,OAAO,CAAC,iBAAiB,CAAC,IAAI,EAC9B,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAC7B,EACD,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,IACE,OAAO,KAAK,CAAC,gBAAgB;QAC3B,QAAQ;QACV,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM;YAClC,CAAC;QACH,KAAK,CAAC,gBAAgB;YACpB,OAAO,CAAC,cAAc,CAAC,OAAO,EAChC,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,IACE,OAAO,KAAK,CAAC,qBAAqB;QAChC,QAAQ;QACV,CAAC,MAAM,CAAC,QAAQ,CACd,KAAK,CAAC,qBAAqB,CAC5B,EACD,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,uCAAuC,CACxC,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,wBAAwB,CAAC,IAAI;QACnC,6BAA6B;QAC/B,KAAK,CAAC,qBAAqB;YACzB,OAAO,CAAC,wBAAwB;iBAC7B,YAAY,EACjB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,gGAAgG,CACjG,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GACZ,OAAO,CAAC,2BAA2B,CAAC;IACtC,MAAM,KAAK,GACT,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC;IAC1B,MAAM,QAAQ,GACZ,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;IAE1B,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC1B,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GACV,MAAM,CAAC,KAAK,GAAG,QAAQ;QACrB,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,gBAAgB,CAAC;IAEzB,OAAO,mBAAmB,CACxB;QACE,mBAAmB,EACjB,OAAO,CAAC,SAAS;QACnB,qBAAqB,EACnB,KAAK,CAAC,iBAAiB;aACpB,qBAAqB;QAC1B,sBAAsB,EACpB,KAAK,CAAC,iBAAiB;aACpB,sBAAsB;QAC3B,SAAS,EACP,KAAK,CAAC,iBAAiB,CAAC,SAAS;QACnC,IAAI,EAAE;YACJ,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI;SAChC;QACD,SAAS,EACP,KAAK,CAAC,iBAAiB,CAAC,SAAS;QACnC,gBAAgB,EACd,KAAK,CAAC,gBAAgB;QACxB,qBAAqB,EACnB,KAAK,CAAC,qBAAqB;QAC7B,eAAe,EACb,6CAA6C;QAC/C,YAAY,EACV,oDAAoD;QACtD,uCAAuC,EACrC,QAAQ;QACV,gCAAgC,EAC9B,MAAM,CAAC,KAAK;QACd,0CAA0C,EACxC,MAAM,CAAC,KAAK;QACd,kDAAkD,EAChD,KAAK;QACP,qCAAqC,EACnC,KAAK;QACP,+BAA+B,EAC7B,QAAQ;QACV,kCAAkC,EAChC,MAAM;QACR,wCAAwC,EACtC,MAAM,KAAK,gBAAgB;QAC7B,2CAA2C,EACzC,IAAI;QACN,iBAAiB,EACf,oEAAoE;QACtE,0BAA0B,EAAE,KAAK;QACjC,mCAAmC,EACjC,KAAK;QACP,8BAA8B,EAC5B,KAAK;QACP,+BAA+B,EAC7B,KAAK;QACP,kBAAkB,EAAE,KAAK;QACzB,oCAAoC,EAClC,KAAK;QACP,uCAAuC,EACrC,KAAK;QACP,qCAAqC,EACnC,KAAK;QACP,YAAY,EAAE,KAAK;QACnB,4BAA4B,EAC1B,KAAK;QACP,sBAAsB,EAAE,KAAK;QAC7B,oBAAoB,EAAE,KAAK;QAC3B,uCAAuC,EACrC,KAAK;QACP,gCAAgC,EAC9B,KAAK;QACP,iBAAiB,EAAE;YACjB,kBAAkB,EAChB,OAAO,CAAC,QAAQ;YAClB,iBAAiB,EACf,OAAO;iBACJ,yBAAyB;YAC9B,cAAc,EACZ,OAAO,CAAC,cAAc;iBACnB,QAAQ;YACb,iBAAiB,EACf,OAAO,CAAC,iBAAiB,CAAC,IAAI;gBAC5B,uCAAuC;gBACvC,CAAC,CAAC,OAAO;qBACJ,iBAAiB;qBACjB,QAAQ;gBACb,CAAC,CAAC,EAAE;YACR,wBAAwB,EACtB,OAAO,CAAC,wBAAwB,CAAC,IAAI;gBACnC,aAAa;gBACb,CAAC,CAAC,OAAO;qBACJ,wBAAwB;qBACxB,QAAQ;gBACb,CAAC,CAAC,EAAE;YACR,kBAAkB,EAChB,KAAK,CAAC,iBAAiB;iBACpB,iBAAiB;iBACjB,YAAY;SAClB;KACF,EACD,8CAA8C,EAC9C,OAAO,EACP;QACE,qMAAqM;QACrM,oGAAoG;QACpG,2LAA2L;QAC3L,qMAAqM;QACrM,sHAAsH;QACtH,uJAAuJ;QACvJ,gHAAgH;QAChH,wJAAwJ;QACxJ,kIAAkI;KACnI,CACF,CAAC;AACJ,CAAC"}

package/dist/sensor/capture-color-sampling-binding.d.ts

@@ -0,0 +1,212 @@
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+import { type CaptureModeProfile, type CaptureModeSampleCombinationDomain, type CaptureModeSensorOffsetNativeSamples, type SourcedCaptureModeFact } from "./capture-mode.js";
+import { type SensorColorSamplingProfile } from "./color-sampling.js";
+import type { NativeImageRaster } from "./sensor-geometry.js";
+export interface NativeEffectiveRasterColorSamplingBindingProfile {
+    schemaVersion: "0.1.0";
+    bindingId: string;
+    colorSamplingProfileId: string;
+    /**
+     * Exact canonical native effective raster this binding was evidenced for.
+     * The binding must not be reused against a different raster merely because
+     * another sensor/mode has similar dimensions or a matching aspect ratio.
+     */
+    nativeRaster: NativeImageRaster;
+    /**
+     * Evidence supporting the native-effective-grid ↔ color-site-grid
+     * relationship itself.
+     *
+     * Capture-mode and color-topology facts retain separate provenance.
+     */
+    evidence: readonly EvidenceProvenance[];
+    relationship: {
+        kind: "regular-native-effective-sample-blocks";
+        /**
+         * Number of abstract color-sampling sites spanned horizontally by one
+         * native effective image sample.
+         */
+        sitesPerNativeSampleX: number;
+        /**
+         * Number of abstract color-sampling sites spanned vertically by one
+         * native effective image sample.
+         */
+        sitesPerNativeSampleY: number;
+        /**
+         * Both grids are anchored to the same native sensor top-left.
+         *
+         * This keeps phase absolute across later active crops/orientation.
+         */
+        anchor: "shared-native-top-left";
+    };
+}
+export interface ColorSamplingSiteGridDimensions {
+    widthSites: number;
+    heightSites: number;
+}
+export interface ResolvedNativeEffectiveRasterColorSamplingBinding {
+    bindingId: string;
+    colorSamplingProfileId: string;
+    nativeRaster: NativeImageRaster;
+    relationshipMeaning: "one-native-effective-sample-to-one-color-site" | "one-native-effective-sample-to-rectangular-color-site-block";
+    relationship: {
+        kind: "regular-native-effective-sample-blocks";
+        sitesPerNativeSampleX: number;
+        sitesPerNativeSampleY: number;
+        anchor: "shared-native-top-left";
+    };
+    colorSamplingSiteGrid: ColorSamplingSiteGridDimensions;
+    totalColorSamplingSites: number;
+    nativeImageRasterBindingEstablished: true;
+    physicalPhotodiodeBindingEstablished: false;
+    physicalPhotodiodeCountInference: "not-permitted";
+    spectralResponseEstablished: false;
+    componentEvidence: {
+        binding: readonly EvidenceProvenance[];
+        colorSamplingProfile: readonly EvidenceProvenance[];
+    };
+}
+export interface NativeEffectiveSampleRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ColorSamplingSiteRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface CaptureModeFullFrameSampleIndex {
+    /**
+     * Zero-based index in the selected mode's full-frame per-frame effective
+     * sampling raster. Crop-local coordinates must be translated to absolute
+     * full-frame mode indices before calling this API.
+     */
+    x: number;
+    y: number;
+}
+export interface ColorSamplingChannelSiteCount {
+    channelId: string;
+    siteCount: number;
+}
+export type ColorSamplingChannelComposition = {
+    kind: "single-channel";
+    channelId: string;
+} | {
+    kind: "mixed-channels";
+    channelIds: readonly string[];
+};
+export interface GroupedCaptureModeSamplingAnchorDeclaration {
+    anchor: "native-effective-raster-top-left";
+    evidence: readonly EvidenceProvenance[];
+}
+export interface ResolveCaptureModeColorSamplingContributorsInput {
+    nativeRaster: NativeImageRaster;
+    captureModeProfile: CaptureModeProfile;
+    modeId: string;
+    colorSamplingProfile: SensorColorSamplingProfile;
+    bindingProfile: NativeEffectiveRasterColorSamplingBindingProfile;
+    modeSampleIndexFullFrame: CaptureModeFullFrameSampleIndex;
+    /**
+     * Required for grouped-native-samples modes because #68 declares grouping
+     * factors but does not itself prove the grouping phase/origin.
+     */
+    groupedSamplingAnchor?: GroupedCaptureModeSamplingAnchorDeclaration;
+}
+export interface ResolvedCaptureModeColorSamplingContributors {
+    modeId: string;
+    colorSamplingProfileId: string;
+    modeSampleCoordinateSystem: "capture-mode-full-frame-effective-sample-index";
+    modeSampleIndexFullFrame: CaptureModeFullFrameSampleIndex;
+    modeSampleRaster: {
+        pixelWidth: number;
+        pixelHeight: number;
+    };
+    modeSamplingKind: "native-effective-raster" | "grouped-native-samples";
+    nativeEffectiveSampleRect: NativeEffectiveSampleRect;
+    colorSamplingSiteRect: ColorSamplingSiteRect;
+    colorSamplingSiteGrid: ColorSamplingSiteGridDimensions;
+    totalContributorSites: number;
+    channelSiteCounts: readonly ColorSamplingChannelSiteCount[];
+    channelComposition: ColorSamplingChannelComposition;
+    /**
+     * Present only when the selected capture mode groups native effective
+     * samples before producing one per-frame effective sample.
+     */
+    grouping: {
+        groupWidthSamples: SourcedCaptureModeFact<number>;
+        groupHeightSamples: SourcedCaptureModeFact<number>;
+        combinationDomain?: SourcedCaptureModeFact<CaptureModeSampleCombinationDomain>;
+        anchor: "native-effective-raster-top-left";
+        anchorEvidence: readonly EvidenceProvenance[];
+    } | null;
+    /**
+     * Sensor-shift sequence remains attached to the sensor/capture mode.
+     *
+     * The sensor and its CFA move together, so these offsets must not be applied
+     * as changes to color-site channel assignment.
+     */
+    interFrameSensorOffsetsNativeSamples?: SourcedCaptureModeFact<readonly CaptureModeSensorOffsetNativeSamples[]>;
+    sensorShiftChangesColorSiteAssignment: false;
+    sensorShiftOpticalRegistration: "outside-this-contract";
+    structuralSourceStage: "pre-reconstruction";
+    completeDownstreamPixelDependencyEstablished: false;
+    signalCombinationWeightingEstablished: false;
+    spectralResponseEstablished: false;
+    physicalPhotodiodeBindingEstablished: false;
+    physicalPhotodiodeCountInference: "not-permitted";
+    componentEvidence: {
+        binding: readonly EvidenceProvenance[];
+        colorSamplingProfile: readonly EvidenceProvenance[];
+        captureMode: readonly EvidenceProvenance[];
+    };
+}
+/**
+ * Parses the explicit relationship between the canonical native effective image
+ * raster and the separate native sensor color-sampling-site lattice.
+ *
+ * This first binding supports only regular rectangular site blocks with a
+ * shared native top-left anchor. Irregular mappings, sparse exceptions and
+ * mode-specific declared-effective rasters require later explicit contracts.
+ */
+export declare function parseNativeEffectiveRasterColorSamplingBindingProfile(value: unknown): NativeEffectiveRasterColorSamplingBindingProfile;
+/**
+ * Validates and resolves the sensor-level binding between NativeImageRaster and
+ * an exact monochrome/periodic color-sampling topology.
+ *
+ * Matching dimensions are never treated as proof of a 1:1 relationship. The
+ * relationship exists only because the caller supplied this evidence-backed
+ * binding profile.
+ */
+export declare function resolveNativeEffectiveRasterColorSamplingBinding(input: {
+    nativeRaster: NativeImageRaster;
+    colorSamplingProfile: SensorColorSamplingProfile;
+    bindingProfile: NativeEffectiveRasterColorSamplingBindingProfile;
+}): ResolvedNativeEffectiveRasterColorSamplingBinding;
+/**
+ * Resolves which color-sampling sites form the pre-reconstruction structural source region for one selected
+ * capture-mode effective sample.
+ *
+ * The mode sample index is always absolute in the selected mode's full-frame
+ * per-frame raster. The API intentionally does not accept crop-local indices,
+ * preventing active-crop origins from silently resetting CFA phase.
+ *
+ * For grouped-native-sample modes, the returned site rectangle covers all
+ * native effective samples in the declared regular group. This is a structural
+ * pre-reconstruction association only: the engine reports channel-site counts
+ * but never claims complete downstream digital-pixel dependency or invents
+ * signal-combination weights, sum/average semantics, spectral response, or
+ * photon/electron values.
+ *
+ * Declared-effective-raster modes fail closed because #68 explicitly says
+ * their relationship to the native effective grid is not safely expressible as
+ * simple integer grouping.
+ *
+ * Inter-frame sensor shifts are preserved as capture-mode metadata only. The
+ * sensor and CFA move together, so those offsets do not change site channel
+ * assignment; their optical-registration effect belongs to a later spatial
+ * sampling/image-formation contract.
+ */
+export declare function resolveCaptureModeColorSamplingContributors(input: ResolveCaptureModeColorSamplingContributorsInput): ResolvedCaptureModeColorSamplingContributors;
+//# sourceMappingURL=capture-color-sampling-binding.d.ts.map

package/dist/sensor/capture-color-sampling-binding.d.ts.map

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