@photivra/engine 0.5.0 → 0.6.0

package/dist/sensor/capture-mode.d.ts

@@ -0,0 +1,157 @@
+import { type EvidenceBackedFact, type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { NativeImageRaster, RasterDimensions } from "./sensor-geometry.js";
+export type CaptureModeSampleCombinationDomain = "charge-domain" | "pre-conversion-analog" | "post-conversion-digital";
+export type CaptureModeReconstructionStage = "remosaic" | "pixel-shift-combination" | "multi-frame-computational-combination";
+export type CaptureModeDependency = "color-sampling-model" | "mode-specific-readout-timing" | "radiometric-calibration" | "inter-frame-registration";
+export interface CaptureModeSensorOffsetNativeSamples {
+    /**
+     * Horizontal sensor displacement in units of the native effective sampling
+     * pitch. This is not a claim about physical photodiode pitch.
+     */
+    x: number;
+    /**
+     * Vertical sensor displacement in units of the native effective sampling
+     * pitch. This is not a claim about physical photodiode pitch.
+     */
+    y: number;
+}
+export type SourcedCaptureModeFact<T> = EvidenceBackedFact<T>;
+export interface SingleFrameCaptureAcquisition {
+    kind: "single-frame";
+}
+export interface FixedMultiFrameCaptureAcquisition {
+    kind: "fixed-multi-frame";
+    frameCount: SourcedCaptureModeFact<number>;
+}
+export interface VariableMultiFrameCaptureAcquisition {
+    kind: "variable-multi-frame";
+    /**
+     * Evidence that the mode is variable/multi-frame, even when exact count
+     * bounds are not published.
+     */
+    evidence: readonly EvidenceProvenance[];
+    minimumFrameCount?: SourcedCaptureModeFact<number>;
+    maximumFrameCount?: SourcedCaptureModeFact<number>;
+}
+export type CaptureModeAcquisition = SingleFrameCaptureAcquisition | FixedMultiFrameCaptureAcquisition | VariableMultiFrameCaptureAcquisition;
+export interface NativeEffectiveCaptureSampling {
+    kind: "native-effective-raster";
+}
+export interface GroupedNativeCaptureSampling {
+    kind: "grouped-native-samples";
+    groupWidthSamples: SourcedCaptureModeFact<number>;
+    groupHeightSamples: SourcedCaptureModeFact<number>;
+    /**
+     * Omitted means unknown/unasserted. Do not infer where combination occurs
+     * from the word "binning" or from the raster ratio.
+     */
+    combinationDomain?: SourcedCaptureModeFact<CaptureModeSampleCombinationDomain>;
+}
+export interface DeclaredEffectiveCaptureSampling {
+    kind: "declared-effective-raster";
+    /**
+     * Per-frame effective sampling raster for a mode whose sampling relationship
+     * to the native grid is not safely expressible as simple integer grouping.
+     */
+    raster: SourcedCaptureModeFact<RasterDimensions>;
+}
+export type CaptureModePerFrameSampling = NativeEffectiveCaptureSampling | GroupedNativeCaptureSampling | DeclaredEffectiveCaptureSampling;
+export interface CaptureModeDefinition {
+    modeId: string;
+    /**
+     * Evidence supporting the existence/overall acquisition behavior of this
+     * mode. Field-level facts below retain their own evidence when needed.
+     */
+    evidence: readonly EvidenceProvenance[];
+    acquisition: CaptureModeAcquisition;
+    perFrameSampling: CaptureModePerFrameSampling;
+    /**
+     * Optional ordered sensor-displacement sequence for fixed multi-frame modes.
+     * The whole sequence is one evidence-backed fact because published mode
+     * documentation commonly describes the sequence as a unit.
+     */
+    interFrameSensorOffsetsNativeSamples?: SourcedCaptureModeFact<readonly CaptureModeSensorOffsetNativeSamples[]>;
+    /**
+     * Ordered reconstruction/combination stages owned by later reconstruction
+     * work. These labels reserve semantics; they do not implement algorithms.
+     */
+    reconstructionStages?: readonly SourcedCaptureModeFact<CaptureModeReconstructionStage>[];
+    /**
+     * Image raster produced by the capture-mode/reconstruction pipeline before
+     * final output crop/resampling.
+     *
+     * This raster does not redefine physical sensor geometry or field of view.
+     */
+    processedImageRaster: SourcedCaptureModeFact<RasterDimensions>;
+    /**
+     * Explicit downstream scientific/model dependencies for this mode.
+     */
+    dependencies?: readonly CaptureModeDependency[];
+}
+export interface CaptureModeProfile {
+    schemaVersion: "0.1.0";
+    modes: readonly CaptureModeDefinition[];
+}
+export interface ResolveCaptureModeInput {
+    nativeRaster: NativeImageRaster;
+    profile: CaptureModeProfile;
+    modeId: string;
+}
+export interface ResolvedCaptureMode {
+    modeId: string;
+    modeEvidence: readonly EvidenceProvenance[];
+    nativeRaster: NativeImageRaster;
+    nativeRasterSemantic: "effective-image-sampling-grid-not-photosite-count";
+    acquisition: {
+        kind: "single-frame";
+        frameCount: 1;
+    } | {
+        kind: "fixed-multi-frame";
+        frameCount: SourcedCaptureModeFact<number>;
+    } | {
+        kind: "variable-multi-frame";
+        evidence: readonly EvidenceProvenance[];
+        minimumFrameCount?: SourcedCaptureModeFact<number>;
+        maximumFrameCount?: SourcedCaptureModeFact<number>;
+    };
+    perFrameSampling: {
+        kind: "native-effective-raster";
+        raster: NativeImageRaster;
+    } | {
+        kind: "grouped-native-samples";
+        raster: RasterDimensions;
+        groupWidthSamples: SourcedCaptureModeFact<number>;
+        groupHeightSamples: SourcedCaptureModeFact<number>;
+        combinationDomain?: SourcedCaptureModeFact<CaptureModeSampleCombinationDomain>;
+    } | {
+        kind: "declared-effective-raster";
+        raster: SourcedCaptureModeFact<RasterDimensions>;
+    };
+    interFrameSensorOffsetsNativeSamples?: SourcedCaptureModeFact<readonly CaptureModeSensorOffsetNativeSamples[]>;
+    reconstructionStages: readonly SourcedCaptureModeFact<CaptureModeReconstructionStage>[];
+    processedImageRaster: SourcedCaptureModeFact<RasterDimensions>;
+    processedImageMegapixels: number;
+    dependencies: readonly CaptureModeDependency[];
+    physicalSensorGeometryMutation: false;
+    photositeCountInference: "not-permitted-from-native-or-processed-raster";
+    finalOutputRasterOwnership: "downstream-capture-output-geometry";
+}
+/**
+ * Parses a capture-mode profile without inferring sensor physics from output
+ * resolution or marketing mode names.
+ *
+ * The profile is intentionally orthogonal: acquisition frame sequence,
+ * per-frame sampling, optional inter-frame sensor shift, reconstruction stages,
+ * processed raster and downstream dependencies are independent axes.
+ */
+export declare function parseCaptureModeProfile(value: unknown): CaptureModeProfile;
+/**
+ * Resolves one capture mode against the selected sensor's native effective
+ * image-sampling raster.
+ *
+ * Resolution changes do not mutate physical sensor geometry. The returned
+ * processed raster is pre-output geometry and must not be used to infer crop
+ * factor, field of view or physical photosite count.
+ */
+export declare function resolveCaptureMode(input: ResolveCaptureModeInput): ResolvedCaptureMode;
+//# sourceMappingURL=capture-mode.d.ts.map

package/dist/sensor/capture-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-mode.d.ts","sourceRoot":"","sources":["../../src/sensor/capture-mode.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,MAAM,kCAAkC,GAC1C,eAAe,GACf,uBAAuB,GACvB,yBAAyB,CAAC;AAE9B,MAAM,MAAM,8BAA8B,GACtC,UAAU,GACV,yBAAyB,GACzB,uCAAuC,CAAC;AAE5C,MAAM,MAAM,qBAAqB,GAC7B,sBAAsB,GACtB,8BAA8B,GAC9B,yBAAyB,GACzB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,oCAAoC;IACnD;;;OAGG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;;OAGG;IACH,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,UAAU,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,oCAAoC;IACnD,IAAI,EAAE,sBAAsB,CAAC;IAC7B;;;OAGG;IACH,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACnD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B,iCAAiC,GACjC,oCAAoC,CAAC;AAEzC,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,yBAAyB,CAAC;CACjC;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,wBAAwB,CAAC;IAC/B,iBAAiB,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAClD,kBAAkB,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACnD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,kCAAkC,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,2BAA2B,CAAC;IAClC;;;OAGG;IACH,MAAM,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,2BAA2B,GACnC,8BAA8B,GAC9B,4BAA4B,GAC5B,gCAAgC,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,WAAW,EAAE,sBAAsB,CAAC;IACpC,gBAAgB,EAAE,2BAA2B,CAAC;IAC9C;;;;OAIG;IACH,oCAAoC,CAAC,EAAE,sBAAsB,CAC3D,SAAS,oCAAoC,EAAE,CAChD,CAAC;IACF;;;OAGG;IACH,oBAAoB,CAAC,EAAE,SAAS,sBAAsB,CAAC,8BAA8B,CAAC,EAAE,CAAC;IACzF;;;;;OAKG;IACH,oBAAoB,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAC/D;;OAEG;IACH,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,iBAAiB,CAAC;IAChC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC5C,YAAY,EAAE,iBAAiB,CAAC;IAChC,oBAAoB,EAClB,mDAAmD,CAAC;IACtD,WAAW,EACP;QACE,IAAI,EAAE,cAAc,CAAC;QACrB,UAAU,EAAE,CAAC,CAAC;KACf,GACD;QACE,IAAI,EAAE,mBAAmB,CAAC;QAC1B,UAAU,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;KAC5C,GACD;QACE,IAAI,EAAE,sBAAsB,CAAC;QAC7B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACxC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACnD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;KACpD,CAAC;IACN,gBAAgB,EACZ;QACE,IAAI,EAAE,yBAAyB,CAAC;QAChC,MAAM,EAAE,iBAAiB,CAAC;KAC3B,GACD;QACE,IAAI,EAAE,wBAAwB,CAAC;QAC/B,MAAM,EAAE,gBAAgB,CAAC;QACzB,iBAAiB,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAClD,kBAAkB,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACnD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,kCAAkC,CAAC,CAAC;KAChF,GACD;QACE,IAAI,EAAE,2BAA2B,CAAC;QAClC,MAAM,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;KAClD,CAAC;IACN,oCAAoC,CAAC,EAAE,sBAAsB,CAC3D,SAAS,oCAAoC,EAAE,CAChD,CAAC;IACF,oBAAoB,EAAE,SAAS,sBAAsB,CAAC,8BAA8B,CAAC,EAAE,CAAC;IACxF,oBAAoB,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAC/D,wBAAwB,EAAE,MAAM,CAAC;IACjC,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC/C,8BAA8B,EAAE,KAAK,CAAC;IACtC,uBAAuB,EACrB,+CAA+C,CAAC;IAClD,0BAA0B,EACxB,oCAAoC,CAAC;CACxC;AAuhBD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,kBAAkB,CAmCpB;AA0ED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,mBAAmB,CA4FrB"}

package/dist/sensor/capture-mode.js

@@ -0,0 +1,434 @@
+// 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";
+const COMBINATION_DOMAINS = new Set([
+    "charge-domain",
+    "pre-conversion-analog",
+    "post-conversion-digital"
+]);
+const RECONSTRUCTION_STAGES = new Set([
+    "remosaic",
+    "pixel-shift-combination",
+    "multi-frame-computational-combination"
+]);
+const DEPENDENCIES = new Set([
+    "color-sampling-model",
+    "mode-specific-readout-timing",
+    "radiometric-calibration",
+    "inter-frame-registration"
+]);
+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 requirePositiveSafeIntegerValue(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isSafeInteger(value) ||
+        value <= 0) {
+        throw new InvalidConfigurationError(path + " must be a positive safe integer.");
+    }
+    return value;
+}
+function parseIntegerFact(value, path) {
+    const record = requireRecord(value, path);
+    return {
+        value: requirePositiveSafeIntegerValue(record.value, path + ".value"),
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseRasterDimensions(value, path) {
+    const record = requireRecord(value, path);
+    const pixelWidth = requirePositiveSafeIntegerValue(record.pixelWidth, path + ".pixelWidth");
+    const pixelHeight = requirePositiveSafeIntegerValue(record.pixelHeight, path + ".pixelHeight");
+    const total = pixelWidth * pixelHeight;
+    if (!Number.isSafeInteger(total)) {
+        throw new InvalidConfigurationError(path + " total sample count must be a safe integer.");
+    }
+    return { pixelWidth, pixelHeight };
+}
+function parseRasterFact(value, path) {
+    const record = requireRecord(value, path);
+    return {
+        value: parseRasterDimensions(record.value, path + ".value"),
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseCombinationDomainFact(value, path) {
+    const record = requireRecord(value, path);
+    if (typeof record.value !== "string" ||
+        !COMBINATION_DOMAINS.has(record.value)) {
+        throw new InvalidConfigurationError(path + ".value is invalid.");
+    }
+    return {
+        value: record.value,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseAcquisition(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "single-frame") {
+        if (record.frameCount !== undefined ||
+            record.minimumFrameCount !== undefined ||
+            record.maximumFrameCount !== undefined ||
+            record.evidence !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " single-frame acquisition must omit frame-count and evidence fields.");
+        }
+        return { kind: "single-frame" };
+    }
+    if (record.kind === "fixed-multi-frame") {
+        if (record.minimumFrameCount !== undefined ||
+            record.maximumFrameCount !== undefined ||
+            record.evidence !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " fixed-multi-frame acquisition must use frameCount only.");
+        }
+        const frameCount = parseIntegerFact(record.frameCount, path + ".frameCount");
+        if (frameCount.value < 2) {
+            throw new InvalidConfigurationError(path +
+                ".frameCount.value must be at least 2 for fixed-multi-frame acquisition.");
+        }
+        return {
+            kind: "fixed-multi-frame",
+            frameCount
+        };
+    }
+    if (record.kind === "variable-multi-frame") {
+        if (record.frameCount !== undefined) {
+            throw new InvalidConfigurationError(path +
+                ".frameCount must be omitted for variable-multi-frame acquisition.");
+        }
+        const evidence = parseEvidenceList(record.evidence, path + ".evidence");
+        const minimumFrameCount = record.minimumFrameCount === undefined
+            ? undefined
+            : parseIntegerFact(record.minimumFrameCount, path + ".minimumFrameCount");
+        const maximumFrameCount = record.maximumFrameCount === undefined
+            ? undefined
+            : parseIntegerFact(record.maximumFrameCount, path + ".maximumFrameCount");
+        if (minimumFrameCount !== undefined &&
+            minimumFrameCount.value < 2) {
+            throw new InvalidConfigurationError(path +
+                ".minimumFrameCount.value must be at least 2 for variable-multi-frame acquisition.");
+        }
+        if (maximumFrameCount !== undefined &&
+            maximumFrameCount.value < 2) {
+            throw new InvalidConfigurationError(path +
+                ".maximumFrameCount.value must be at least 2 for variable-multi-frame acquisition.");
+        }
+        if (minimumFrameCount !== undefined &&
+            maximumFrameCount !== undefined &&
+            minimumFrameCount.value > maximumFrameCount.value) {
+            throw new InvalidConfigurationError(path +
+                ".minimumFrameCount.value must not exceed maximumFrameCount.value.");
+        }
+        return {
+            kind: "variable-multi-frame",
+            evidence,
+            ...(minimumFrameCount === undefined
+                ? {}
+                : { minimumFrameCount }),
+            ...(maximumFrameCount === undefined
+                ? {}
+                : { maximumFrameCount })
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+function parsePerFrameSampling(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind === "native-effective-raster") {
+        if (record.groupWidthSamples !== undefined ||
+            record.groupHeightSamples !== undefined ||
+            record.combinationDomain !== undefined ||
+            record.raster !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " native-effective-raster sampling must omit grouping/raster fields.");
+        }
+        return { kind: "native-effective-raster" };
+    }
+    if (record.kind === "grouped-native-samples") {
+        if (record.raster !== undefined) {
+            throw new InvalidConfigurationError(path +
+                ".raster must be omitted for grouped-native-samples sampling.");
+        }
+        return {
+            kind: "grouped-native-samples",
+            groupWidthSamples: parseIntegerFact(record.groupWidthSamples, path + ".groupWidthSamples"),
+            groupHeightSamples: parseIntegerFact(record.groupHeightSamples, path + ".groupHeightSamples"),
+            ...(record.combinationDomain === undefined
+                ? {}
+                : {
+                    combinationDomain: parseCombinationDomainFact(record.combinationDomain, path + ".combinationDomain")
+                })
+        };
+    }
+    if (record.kind === "declared-effective-raster") {
+        if (record.groupWidthSamples !== undefined ||
+            record.groupHeightSamples !== undefined ||
+            record.combinationDomain !== undefined) {
+            throw new InvalidConfigurationError(path +
+                " declared-effective-raster sampling must omit grouping fields.");
+        }
+        return {
+            kind: "declared-effective-raster",
+            raster: parseRasterFact(record.raster, path + ".raster")
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+function parseOffsetsFact(value, path) {
+    const record = requireRecord(value, path);
+    if (!Array.isArray(record.value) ||
+        record.value.length === 0) {
+        throw new InvalidConfigurationError(path + ".value must be a non-empty array.");
+    }
+    const offsets = record.value.map((entry, index) => {
+        const item = requireRecord(entry, path + ".value[" + index + "]");
+        if (typeof item.x !== "number" ||
+            !Number.isFinite(item.x) ||
+            typeof item.y !== "number" ||
+            !Number.isFinite(item.y)) {
+            throw new InvalidConfigurationError(path +
+                ".value[" +
+                index +
+                "] x/y must be finite numbers.");
+        }
+        return {
+            x: item.x,
+            y: item.y
+        };
+    });
+    return {
+        value: offsets,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseReconstructionStages(value, path) {
+    if (!Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an array.");
+    }
+    const stages = value.map((entry, index) => {
+        const record = requireRecord(entry, path + "[" + index + "]");
+        if (typeof record.value !== "string" ||
+            !RECONSTRUCTION_STAGES.has(record.value)) {
+            throw new InvalidConfigurationError(path + "[" + index + "].value is invalid.");
+        }
+        return {
+            value: record.value,
+            evidence: parseEvidenceList(record.evidence, path + "[" + index + "].evidence")
+        };
+    });
+    const values = stages.map((stage) => stage.value);
+    if (new Set(values).size !== values.length) {
+        throw new InvalidConfigurationError(path + " must not contain duplicate stages.");
+    }
+    return stages;
+}
+function parseDependencies(value, path) {
+    if (!Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an array.");
+    }
+    const dependencies = value.map((entry, index) => {
+        if (typeof entry !== "string" ||
+            !DEPENDENCIES.has(entry)) {
+            throw new InvalidConfigurationError(path + "[" + index + "] is invalid.");
+        }
+        return entry;
+    });
+    if (new Set(dependencies).size !== dependencies.length) {
+        throw new InvalidConfigurationError(path + " must not contain duplicates.");
+    }
+    return dependencies;
+}
+function parseModeDefinition(value, path) {
+    const record = requireRecord(value, path);
+    const modeId = requireNonEmptyString(record.modeId, path + ".modeId");
+    const acquisition = parseAcquisition(record.acquisition, path + ".acquisition");
+    const interFrameSensorOffsetsNativeSamples = record.interFrameSensorOffsetsNativeSamples === undefined
+        ? undefined
+        : parseOffsetsFact(record.interFrameSensorOffsetsNativeSamples, path + ".interFrameSensorOffsetsNativeSamples");
+    if (interFrameSensorOffsetsNativeSamples !== undefined &&
+        acquisition.kind !== "fixed-multi-frame") {
+        throw new InvalidConfigurationError(path +
+            ".interFrameSensorOffsetsNativeSamples is supported only for fixed-multi-frame acquisition.");
+    }
+    if (interFrameSensorOffsetsNativeSamples !== undefined &&
+        acquisition.kind === "fixed-multi-frame" &&
+        interFrameSensorOffsetsNativeSamples.value.length !==
+            acquisition.frameCount.value) {
+        throw new InvalidConfigurationError(path +
+            ".interFrameSensorOffsetsNativeSamples.value length must equal acquisition.frameCount.value.");
+    }
+    return {
+        modeId,
+        evidence: parseEvidenceList(record.evidence, path + ".evidence"),
+        acquisition,
+        perFrameSampling: parsePerFrameSampling(record.perFrameSampling, path + ".perFrameSampling"),
+        ...(interFrameSensorOffsetsNativeSamples === undefined
+            ? {}
+            : { interFrameSensorOffsetsNativeSamples }),
+        reconstructionStages: record.reconstructionStages === undefined
+            ? []
+            : parseReconstructionStages(record.reconstructionStages, path + ".reconstructionStages"),
+        processedImageRaster: parseRasterFact(record.processedImageRaster, path + ".processedImageRaster"),
+        dependencies: record.dependencies === undefined
+            ? []
+            : parseDependencies(record.dependencies, path + ".dependencies")
+    };
+}
+/**
+ * Parses a capture-mode profile without inferring sensor physics from output
+ * resolution or marketing mode names.
+ *
+ * The profile is intentionally orthogonal: acquisition frame sequence,
+ * per-frame sampling, optional inter-frame sensor shift, reconstruction stages,
+ * processed raster and downstream dependencies are independent axes.
+ */
+export function parseCaptureModeProfile(value) {
+    const profile = requireRecord(value, "captureModes");
+    if (profile.schemaVersion !== "0.1.0") {
+        throw new InvalidConfigurationError('captureModes.schemaVersion must be "0.1.0".');
+    }
+    if (!Array.isArray(profile.modes) ||
+        profile.modes.length === 0) {
+        throw new InvalidConfigurationError("captureModes.modes must be a non-empty array.");
+    }
+    const modes = profile.modes.map((mode, index) => parseModeDefinition(mode, "captureModes.modes[" + index + "]"));
+    const ids = modes.map((mode) => mode.modeId);
+    if (new Set(ids).size !== ids.length) {
+        throw new InvalidConfigurationError("captureModes.modes must not contain duplicate modeId values.");
+    }
+    return {
+        schemaVersion: "0.1.0",
+        modes
+    };
+}
+function validateNativeRaster(raster) {
+    requirePositiveInteger("nativeRaster.pixelWidth", raster.pixelWidth);
+    requirePositiveInteger("nativeRaster.pixelHeight", raster.pixelHeight);
+    const total = raster.pixelWidth * raster.pixelHeight;
+    if (!Number.isSafeInteger(total)) {
+        throw new InvalidScientificInputError("nativeRaster total image-sample count must be a safe integer.");
+    }
+}
+function resolvePerFrameSampling(sampling, nativeRaster) {
+    if (sampling.kind === "native-effective-raster") {
+        return {
+            kind: "native-effective-raster",
+            raster: { ...nativeRaster }
+        };
+    }
+    if (sampling.kind === "declared-effective-raster") {
+        return {
+            kind: "declared-effective-raster",
+            raster: {
+                value: { ...sampling.raster.value },
+                evidence: sampling.raster.evidence
+            }
+        };
+    }
+    const groupWidth = sampling.groupWidthSamples.value;
+    const groupHeight = sampling.groupHeightSamples.value;
+    if (nativeRaster.pixelWidth % groupWidth !== 0 ||
+        nativeRaster.pixelHeight % groupHeight !== 0) {
+        throw new InvalidScientificInputError("Grouped native sampling requires nativeRaster dimensions to be exactly divisible by the declared grouping factors.");
+    }
+    return {
+        kind: "grouped-native-samples",
+        raster: {
+            pixelWidth: nativeRaster.pixelWidth / groupWidth,
+            pixelHeight: nativeRaster.pixelHeight / groupHeight
+        },
+        groupWidthSamples: sampling.groupWidthSamples,
+        groupHeightSamples: sampling.groupHeightSamples,
+        ...(sampling.combinationDomain === undefined
+            ? {}
+            : {
+                combinationDomain: sampling.combinationDomain
+            })
+    };
+}
+/**
+ * Resolves one capture mode against the selected sensor's native effective
+ * image-sampling raster.
+ *
+ * Resolution changes do not mutate physical sensor geometry. The returned
+ * processed raster is pre-output geometry and must not be used to infer crop
+ * factor, field of view or physical photosite count.
+ */
+export function resolveCaptureMode(input) {
+    validateNativeRaster(input.nativeRaster);
+    if (typeof input.modeId !== "string" ||
+        input.modeId.trim().length === 0) {
+        throw new InvalidScientificInputError("modeId must be a non-empty string.");
+    }
+    const profile = parseCaptureModeProfile(input.profile);
+    const mode = profile.modes.find((candidate) => candidate.modeId === input.modeId);
+    if (mode === undefined) {
+        throw new InvalidScientificInputError("modeId does not exist in the supplied capture-mode profile.");
+    }
+    const processedTotal = mode.processedImageRaster.value.pixelWidth *
+        mode.processedImageRaster.value.pixelHeight;
+    if (!Number.isSafeInteger(processedTotal)) {
+        throw new InvalidScientificInputError("processedImageRaster total image-sample count must be a safe integer.");
+    }
+    const acquisition = mode.acquisition.kind === "single-frame"
+        ? {
+            kind: "single-frame",
+            frameCount: 1
+        }
+        : mode.acquisition.kind === "fixed-multi-frame"
+            ? {
+                kind: "fixed-multi-frame",
+                frameCount: mode.acquisition.frameCount
+            }
+            : {
+                kind: "variable-multi-frame",
+                evidence: mode.acquisition.evidence,
+                ...(mode.acquisition.minimumFrameCount === undefined
+                    ? {}
+                    : {
+                        minimumFrameCount: mode.acquisition.minimumFrameCount
+                    }),
+                ...(mode.acquisition.maximumFrameCount === undefined
+                    ? {}
+                    : {
+                        maximumFrameCount: mode.acquisition.maximumFrameCount
+                    })
+            };
+    return {
+        modeId: mode.modeId,
+        modeEvidence: mode.evidence,
+        nativeRaster: { ...input.nativeRaster },
+        nativeRasterSemantic: "effective-image-sampling-grid-not-photosite-count",
+        acquisition,
+        perFrameSampling: resolvePerFrameSampling(mode.perFrameSampling, input.nativeRaster),
+        ...(mode.interFrameSensorOffsetsNativeSamples === undefined
+            ? {}
+            : {
+                interFrameSensorOffsetsNativeSamples: mode.interFrameSensorOffsetsNativeSamples
+            }),
+        reconstructionStages: mode.reconstructionStages ?? [],
+        processedImageRaster: {
+            value: {
+                ...mode.processedImageRaster.value
+            },
+            evidence: mode.processedImageRaster.evidence
+        },
+        processedImageMegapixels: processedTotal / 1_000_000,
+        dependencies: mode.dependencies ?? [],
+        physicalSensorGeometryMutation: false,
+        photositeCountInference: "not-permitted-from-native-or-processed-raster",
+        finalOutputRasterOwnership: "downstream-capture-output-geometry"
+    };
+}
+//# sourceMappingURL=capture-mode.js.map

package/dist/sensor/capture-mode.js.map

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