@photivra/engine 0.5.1 → 0.6.0

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

@@ -0,0 +1,211 @@
+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;
+    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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"}

package/dist/sensor/capture-color-sampling-binding.js

@@ -0,0 +1,423 @@
+// SPDX-License-Identifier: Apache-2.0
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError, requirePositiveInteger } from "../core/validation.js";
+import { resolveCaptureMode } from "./capture-mode.js";
+import { parseSensorColorSamplingProfile } from "./color-sampling.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 requirePositiveSafeInteger(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value <= 0) {
+        throw new InvalidConfigurationError(path + " must be a positive safe integer.");
+    }
+    return value;
+}
+function parseBoundNativeRaster(value) {
+    const nativeRaster = requireRecord(value, "colorSamplingBinding.nativeRaster");
+    const pixelWidth = requirePositiveSafeInteger(nativeRaster.pixelWidth, "colorSamplingBinding.nativeRaster.pixelWidth");
+    const pixelHeight = requirePositiveSafeInteger(nativeRaster.pixelHeight, "colorSamplingBinding.nativeRaster.pixelHeight");
+    if (!Number.isSafeInteger(pixelWidth * pixelHeight)) {
+        throw new InvalidConfigurationError("colorSamplingBinding.nativeRaster total image-sample count must be a safe integer.");
+    }
+    return {
+        pixelWidth,
+        pixelHeight
+    };
+}
+function safeProduct(values, path) {
+    let result = 1;
+    for (const value of values) {
+        result *= value;
+        if (!Number.isSafeInteger(result)) {
+            throw new InvalidScientificInputError(path + " must remain a safe integer.");
+        }
+    }
+    return result;
+}
+function validateNativeRaster(raster) {
+    requirePositiveInteger("nativeRaster.pixelWidth", raster.pixelWidth);
+    requirePositiveInteger("nativeRaster.pixelHeight", raster.pixelHeight);
+    safeProduct([raster.pixelWidth, raster.pixelHeight], "nativeRaster total image-sample count");
+}
+function requireFullFrameSampleIndex(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value < 0) {
+        throw new InvalidScientificInputError(path +
+            " must be a non-negative safe integer full-frame mode sample index.");
+    }
+    return value;
+}
+/**
+ * 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 function parseNativeEffectiveRasterColorSamplingBindingProfile(value) {
+    const profile = requireRecord(value, "colorSamplingBinding");
+    if (profile.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('colorSamplingBinding.schemaVersion must be "0.1.0".');
+    }
+    const relationship = requireRecord(profile.relationship, "colorSamplingBinding.relationship");
+    if (relationship.kind !==
+        "regular-native-effective-sample-blocks") {
+        throw new InvalidConfigurationError("colorSamplingBinding.relationship.kind is invalid.");
+    }
+    if (relationship.anchor !==
+        "shared-native-top-left") {
+        throw new InvalidConfigurationError('colorSamplingBinding.relationship.anchor must be "shared-native-top-left".');
+    }
+    return {
+        schemaVersion: "0.1.0",
+        bindingId: requireNonEmptyString(profile.bindingId, "colorSamplingBinding.bindingId"),
+        colorSamplingProfileId: requireNonEmptyString(profile.colorSamplingProfileId, "colorSamplingBinding.colorSamplingProfileId"),
+        nativeRaster: parseBoundNativeRaster(profile.nativeRaster),
+        evidence: parseEvidenceList(profile.evidence, "colorSamplingBinding.evidence"),
+        relationship: {
+            kind: "regular-native-effective-sample-blocks",
+            sitesPerNativeSampleX: requirePositiveSafeInteger(relationship.sitesPerNativeSampleX, "colorSamplingBinding.relationship.sitesPerNativeSampleX"),
+            sitesPerNativeSampleY: requirePositiveSafeInteger(relationship.sitesPerNativeSampleY, "colorSamplingBinding.relationship.sitesPerNativeSampleY"),
+            anchor: "shared-native-top-left"
+        }
+    };
+}
+/**
+ * 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 function resolveNativeEffectiveRasterColorSamplingBinding(input) {
+    validateNativeRaster(input.nativeRaster);
+    const colorSamplingProfile = parseSensorColorSamplingProfile(input.colorSamplingProfile);
+    const bindingProfile = parseNativeEffectiveRasterColorSamplingBindingProfile(input.bindingProfile);
+    if (bindingProfile.colorSamplingProfileId !==
+        colorSamplingProfile.profileId) {
+        throw new InvalidScientificInputError("Binding colorSamplingProfileId must match colorSamplingProfile.profileId.");
+    }
+    if (bindingProfile.nativeRaster.pixelWidth !==
+        input.nativeRaster.pixelWidth ||
+        bindingProfile.nativeRaster.pixelHeight !==
+            input.nativeRaster.pixelHeight) {
+        throw new InvalidScientificInputError("Binding nativeRaster must exactly match the supplied canonical native effective raster.");
+    }
+    if (colorSamplingProfile.layout.kind === "layered") {
+        throw new InvalidScientificInputError("Layered color sampling cannot be bound to NativeImageRaster until its per-layer spatial sampling relationship is explicitly modeled.");
+    }
+    if (colorSamplingProfile.coordinateSystem !==
+        "native-sensor-color-sampling-site-index") {
+        throw new InvalidScientificInputError("Resolvable color sampling binding requires the native sensor color-sampling-site coordinate system.");
+    }
+    const widthSites = safeProduct([
+        input.nativeRaster.pixelWidth,
+        bindingProfile.relationship
+            .sitesPerNativeSampleX
+    ], "color-sampling site-grid width");
+    const heightSites = safeProduct([
+        input.nativeRaster.pixelHeight,
+        bindingProfile.relationship
+            .sitesPerNativeSampleY
+    ], "color-sampling site-grid height");
+    const totalColorSamplingSites = safeProduct([widthSites, heightSites], "color-sampling site-grid total site count");
+    const oneToOne = bindingProfile.relationship
+        .sitesPerNativeSampleX === 1 &&
+        bindingProfile.relationship
+            .sitesPerNativeSampleY === 1;
+    return {
+        bindingId: bindingProfile.bindingId,
+        colorSamplingProfileId: bindingProfile.colorSamplingProfileId,
+        nativeRaster: {
+            ...input.nativeRaster
+        },
+        relationshipMeaning: oneToOne
+            ? "one-native-effective-sample-to-one-color-site"
+            : "one-native-effective-sample-to-rectangular-color-site-block",
+        relationship: {
+            ...bindingProfile.relationship
+        },
+        colorSamplingSiteGrid: {
+            widthSites,
+            heightSites
+        },
+        totalColorSamplingSites,
+        nativeImageRasterBindingEstablished: true,
+        physicalPhotodiodeBindingEstablished: false,
+        physicalPhotodiodeCountInference: "not-permitted",
+        spectralResponseEstablished: false,
+        componentEvidence: {
+            binding: bindingProfile.evidence,
+            colorSamplingProfile: colorSamplingProfile.evidence
+        }
+    };
+}
+function countResidueInRange(start, length, period, residue) {
+    const startResidue = start % period;
+    const delta = (residue - startResidue + period) %
+        period;
+    if (delta >= length) {
+        return 0;
+    }
+    return (1 +
+        Math.floor((length - 1 - delta) / period));
+}
+function channelCountsForSiteRect(profile, rect) {
+    const totalSites = safeProduct([rect.width, rect.height], "color-sampling contributor site count");
+    if (profile.layout.kind === "layered") {
+        throw new InvalidScientificInputError("Layered color sampling does not have resolvable site contributors in schema 0.1.0.");
+    }
+    if (profile.layout.kind === "monochrome") {
+        return [
+            {
+                channelId: profile.layout.channelId,
+                siteCount: totalSites
+            }
+        ];
+    }
+    const counts = new Map();
+    for (let tileY = 0; tileY < profile.layout.repeatHeightSites; tileY += 1) {
+        const countY = countResidueInRange(rect.y, rect.height, profile.layout.repeatHeightSites, tileY);
+        if (countY === 0) {
+            continue;
+        }
+        for (let tileX = 0; tileX < profile.layout.repeatWidthSites; tileX += 1) {
+            const countX = countResidueInRange(rect.x, rect.width, profile.layout.repeatWidthSites, tileX);
+            if (countX === 0) {
+                continue;
+            }
+            const tileIndex = tileY *
+                profile.layout.repeatWidthSites +
+                tileX;
+            const channelId = profile.layout.siteChannelIds[tileIndex];
+            if (channelId === undefined) {
+                throw new InvalidScientificInputError("Periodic color-sampling tile resolution failed while calculating contributor counts.");
+            }
+            const siteCount = safeProduct([countX, countY], "per-channel contributor site count");
+            const prior = counts.get(channelId) ?? 0;
+            const next = prior + siteCount;
+            if (!Number.isSafeInteger(next)) {
+                throw new InvalidScientificInputError("Per-channel contributor site count must remain a safe integer.");
+            }
+            counts.set(channelId, next);
+        }
+    }
+    const result = Array.from(counts, ([channelId, siteCount]) => ({
+        channelId,
+        siteCount
+    }));
+    const countedTotal = result.reduce((sum, entry) => sum + entry.siteCount, 0);
+    if (countedTotal !== totalSites) {
+        throw new InvalidScientificInputError("Color-sampling contributor channel counts do not cover the complete contributor site rectangle.");
+    }
+    return result;
+}
+/**
+ * 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 function resolveCaptureModeColorSamplingContributors(input) {
+    const colorSamplingProfile = parseSensorColorSamplingProfile(input.colorSamplingProfile);
+    const binding = resolveNativeEffectiveRasterColorSamplingBinding({
+        nativeRaster: input.nativeRaster,
+        colorSamplingProfile,
+        bindingProfile: input.bindingProfile
+    });
+    const captureMode = resolveCaptureMode({
+        nativeRaster: input.nativeRaster,
+        profile: input.captureModeProfile,
+        modeId: input.modeId
+    });
+    if (!captureMode.dependencies.includes("color-sampling-model")) {
+        throw new InvalidScientificInputError("Selected capture mode must declare the color-sampling-model dependency before color-site contributors can be resolved.");
+    }
+    const modeX = requireFullFrameSampleIndex(input.modeSampleIndexFullFrame.x, "modeSampleIndexFullFrame.x");
+    const modeY = requireFullFrameSampleIndex(input.modeSampleIndexFullFrame.y, "modeSampleIndexFullFrame.y");
+    if (captureMode.perFrameSampling.kind ===
+        "declared-effective-raster") {
+        throw new InvalidScientificInputError("declared-effective-raster capture modes require a separate mode-specific color-site binding; no relationship may be inferred from raster dimensions alone.");
+    }
+    const modeSampleRaster = captureMode.perFrameSampling.raster;
+    if (modeX >= modeSampleRaster.pixelWidth ||
+        modeY >= modeSampleRaster.pixelHeight) {
+        throw new InvalidScientificInputError("modeSampleIndexFullFrame must lie within the selected mode's full-frame per-frame sampling raster.");
+    }
+    let nativeEffectiveSampleRect;
+    let grouping;
+    if (captureMode.perFrameSampling.kind ===
+        "native-effective-raster") {
+        if (input.groupedSamplingAnchor !== undefined) {
+            throw new InvalidScientificInputError("groupedSamplingAnchor must be omitted for native-effective-raster capture modes.");
+        }
+        nativeEffectiveSampleRect = {
+            x: modeX,
+            y: modeY,
+            width: 1,
+            height: 1
+        };
+        grouping = null;
+    }
+    else {
+        if (input.groupedSamplingAnchor === undefined ||
+            input.groupedSamplingAnchor.anchor !==
+                "native-effective-raster-top-left") {
+            throw new InvalidScientificInputError("grouped-native-samples capture modes require an explicit native-effective-raster-top-left grouping anchor declaration.");
+        }
+        const groupingAnchorEvidence = parseEvidenceList(input.groupedSamplingAnchor.evidence, "groupedSamplingAnchor.evidence");
+        const groupWidth = captureMode.perFrameSampling
+            .groupWidthSamples.value;
+        const groupHeight = captureMode.perFrameSampling
+            .groupHeightSamples.value;
+        nativeEffectiveSampleRect = {
+            x: safeProduct([modeX, groupWidth], "native effective sample rectangle x"),
+            y: safeProduct([modeY, groupHeight], "native effective sample rectangle y"),
+            width: groupWidth,
+            height: groupHeight
+        };
+        grouping = {
+            groupWidthSamples: captureMode.perFrameSampling
+                .groupWidthSamples,
+            groupHeightSamples: captureMode.perFrameSampling
+                .groupHeightSamples,
+            ...(captureMode.perFrameSampling
+                .combinationDomain === undefined
+                ? {}
+                : {
+                    combinationDomain: captureMode.perFrameSampling
+                        .combinationDomain
+                }),
+            anchor: "native-effective-raster-top-left",
+            anchorEvidence: groupingAnchorEvidence
+        };
+    }
+    const sitesPerNativeX = binding.relationship
+        .sitesPerNativeSampleX;
+    const sitesPerNativeY = binding.relationship
+        .sitesPerNativeSampleY;
+    const colorSamplingSiteRect = {
+        x: safeProduct([
+            nativeEffectiveSampleRect.x,
+            sitesPerNativeX
+        ], "color-sampling contributor rectangle x"),
+        y: safeProduct([
+            nativeEffectiveSampleRect.y,
+            sitesPerNativeY
+        ], "color-sampling contributor rectangle y"),
+        width: safeProduct([
+            nativeEffectiveSampleRect.width,
+            sitesPerNativeX
+        ], "color-sampling contributor rectangle width"),
+        height: safeProduct([
+            nativeEffectiveSampleRect.height,
+            sitesPerNativeY
+        ], "color-sampling contributor rectangle height")
+    };
+    if (colorSamplingSiteRect.x +
+        colorSamplingSiteRect.width >
+        binding.colorSamplingSiteGrid.widthSites ||
+        colorSamplingSiteRect.y +
+            colorSamplingSiteRect.height >
+            binding.colorSamplingSiteGrid.heightSites) {
+        throw new InvalidScientificInputError("Resolved color-sampling contributor rectangle exceeds the bound color-site grid.");
+    }
+    const totalContributorSites = safeProduct([
+        colorSamplingSiteRect.width,
+        colorSamplingSiteRect.height
+    ], "total contributor site count");
+    const channelSiteCounts = channelCountsForSiteRect(colorSamplingProfile, colorSamplingSiteRect);
+    const firstChannel = channelSiteCounts[0];
+    if (firstChannel === undefined) {
+        throw new InvalidScientificInputError("Resolved structural source region must contain at least one color-sampling channel.");
+    }
+    const channelComposition = channelSiteCounts.length === 1
+        ? {
+            kind: "single-channel",
+            channelId: firstChannel.channelId
+        }
+        : {
+            kind: "mixed-channels",
+            channelIds: channelSiteCounts.map((entry) => entry.channelId)
+        };
+    return {
+        modeId: captureMode.modeId,
+        modeSampleCoordinateSystem: "capture-mode-full-frame-effective-sample-index",
+        modeSampleIndexFullFrame: {
+            x: modeX,
+            y: modeY
+        },
+        modeSampleRaster: {
+            ...modeSampleRaster
+        },
+        modeSamplingKind: captureMode.perFrameSampling.kind,
+        nativeEffectiveSampleRect,
+        colorSamplingSiteRect,
+        colorSamplingSiteGrid: {
+            ...binding.colorSamplingSiteGrid
+        },
+        totalContributorSites,
+        channelSiteCounts,
+        channelComposition,
+        grouping,
+        ...(captureMode
+            .interFrameSensorOffsetsNativeSamples ===
+            undefined
+            ? {}
+            : {
+                interFrameSensorOffsetsNativeSamples: captureMode
+                    .interFrameSensorOffsetsNativeSamples
+            }),
+        sensorShiftChangesColorSiteAssignment: false,
+        sensorShiftOpticalRegistration: "outside-this-contract",
+        structuralSourceStage: "pre-reconstruction",
+        completeDownstreamPixelDependencyEstablished: false,
+        signalCombinationWeightingEstablished: false,
+        spectralResponseEstablished: false,
+        physicalPhotodiodeBindingEstablished: false,
+        physicalPhotodiodeCountInference: "not-permitted",
+        componentEvidence: {
+            binding: binding.componentEvidence.binding,
+            colorSamplingProfile: binding.componentEvidence
+                .colorSamplingProfile,
+            captureMode: captureMode.modeEvidence
+        }
+    };
+}
+//# sourceMappingURL=capture-color-sampling-binding.js.map

package/dist/sensor/capture-color-sampling-binding.js.map

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