@photivra/engine 0.6.0 → 1.0.0

package/dist/exposure/metering.js

@@ -0,0 +1,422 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses one generic relative exposure-metering profile. Schema 0.1.0 is approximation-only and
+ * consumes relative pre-exposure linear signal. It deliberately does not claim luminance, spectral
+ * radiance, sensor-plane irradiance, or a specific manufacturer's meter calibration.
+ * Meters relative pre-exposure linear signal over the actual oriented active capture frame. The first
+ * contract is an educational/relative approximation. It is intentionally independent of final output
+ * crop, display/tone mapping, exposure compensation, and automatic exposure setting resolution.
+ * @see docs/USAGE.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";
+export const EXPOSURE_METERING_PROFILE_SCHEMA_VERSION = "0.1.0";
+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.trim();
+}
+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 requireFraction(value, path) {
+    const parsed = requireFinite(value, path);
+    if (parsed < 0 || parsed > 1) {
+        throw new InvalidConfigurationError(path +
+            " must be a finite fraction from 0 through 1.");
+    }
+    return parsed;
+}
+function parseUv(value, path) {
+    const record = requireRecord(value, path);
+    const u = requireFinite(record.u, path + ".u");
+    const v = requireFinite(record.v, path + ".v");
+    if (u < 0 ||
+        u > 1 ||
+        v < 0 ||
+        v > 1) {
+        throw new InvalidConfigurationError(path +
+            " coordinates must lie within [0, 1].");
+    }
+    return { u, v };
+}
+function parseLimitations(value, path) {
+    if (!Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an array.");
+    }
+    const limitations = value.map((entry, index) => requireNonEmptyString(entry, path + "[" + index + "]"));
+    if (new Set(limitations).size !==
+        limitations.length) {
+        throw new InvalidConfigurationError(path + " must not contain duplicates.");
+    }
+    return limitations;
+}
+function parsePolicy(value, path) {
+    const record = requireRecord(value, path);
+    if (record.kind ===
+        "multi-zone-uniform") {
+        return {
+            kind: "multi-zone-uniform"
+        };
+    }
+    if (record.kind ===
+        "center-weighted-radial") {
+        return {
+            kind: "center-weighted-radial",
+            edgeWeight: requireFraction(record.edgeWeight, path + ".edgeWeight"),
+            exponent: requirePositiveFinite(record.exponent, path + ".exponent")
+        };
+    }
+    if (record.kind === "spot") {
+        const radius = requirePositiveFinite(record
+            .radiusFractionOfCaptureDiagonal, path +
+            ".radiusFractionOfCaptureDiagonal");
+        if (radius > 1) {
+            throw new InvalidConfigurationError(path +
+                ".radiusFractionOfCaptureDiagonal must be at most 1.");
+        }
+        return {
+            kind: "spot",
+            centerOrientedCaptureUv: parseUv(record
+                .centerOrientedCaptureUv, path +
+                ".centerOrientedCaptureUv"),
+            radiusFractionOfCaptureDiagonal: radius
+        };
+    }
+    if (record.kind ===
+        "highlight-weighted") {
+        return {
+            kind: "highlight-weighted",
+            minimumWeightFraction: requireFraction(record
+                .minimumWeightFraction, path +
+                ".minimumWeightFraction"),
+            exponent: requirePositiveFinite(record.exponent, path + ".exponent")
+        };
+    }
+    throw new InvalidConfigurationError(path + ".kind is invalid.");
+}
+/**
+ * Parses one generic relative exposure-metering profile.
+ *
+ * Schema 0.1.0 is approximation-only and consumes relative pre-exposure
+ * linear signal. It deliberately does not claim luminance, spectral radiance,
+ * sensor-plane irradiance, or a specific manufacturer's meter calibration.
+ */
+export function parseExposureMeteringProfile(value) {
+    const record = requireRecord(value, "exposureMeteringProfile");
+    if (record.schemaVersion !==
+        EXPOSURE_METERING_PROFILE_SCHEMA_VERSION) {
+        throw new InvalidConfigurationError('exposureMeteringProfile.schemaVersion must be "' +
+            EXPOSURE_METERING_PROFILE_SCHEMA_VERSION +
+            '".');
+    }
+    if (record.scientificStatus !==
+        "approximation") {
+        throw new InvalidConfigurationError('exposureMeteringProfile.scientificStatus must be "approximation" in schema 0.1.0.');
+    }
+    if (record.inputDomain !==
+        "relative-pre-exposure-linear-signal") {
+        throw new InvalidConfigurationError('exposureMeteringProfile.inputDomain must be "relative-pre-exposure-linear-signal".');
+    }
+    if (record.captureRegion !==
+        "oriented-active-capture") {
+        throw new InvalidConfigurationError('exposureMeteringProfile.captureRegion must be "oriented-active-capture".');
+    }
+    const target = requireRecord(record.target, "exposureMeteringProfile.target");
+    if (target.kind !==
+        "relative-signal-reference") {
+        throw new InvalidConfigurationError('exposureMeteringProfile.target.kind must be "relative-signal-reference".');
+    }
+    return {
+        schemaVersion: EXPOSURE_METERING_PROFILE_SCHEMA_VERSION,
+        profileId: requireNonEmptyString(record.profileId, "exposureMeteringProfile.profileId"),
+        scientificStatus: "approximation",
+        inputDomain: "relative-pre-exposure-linear-signal",
+        captureRegion: "oriented-active-capture",
+        policy: parsePolicy(record.policy, "exposureMeteringProfile.policy"),
+        target: {
+            kind: "relative-signal-reference",
+            targetRelativeSignal: requirePositiveFinite(target.targetRelativeSignal, "exposureMeteringProfile.target.targetRelativeSignal"),
+            evidence: parseEvidenceList(target.evidence, "exposureMeteringProfile.target.evidence")
+        },
+        evidence: parseEvidenceList(record.evidence, "exposureMeteringProfile.evidence"),
+        limitations: parseLimitations(record.limitations, "exposureMeteringProfile.limitations")
+    };
+}
+function requireInputString(value, path) {
+    if (typeof value !== "string" ||
+        value.trim().length === 0) {
+        throw new InvalidScientificInputError(path + " must be a non-empty string.");
+    }
+    return value.trim();
+}
+function requireInputFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value)) {
+        throw new InvalidScientificInputError(path + " must be finite.");
+    }
+    return value;
+}
+function requireInputPositiveFinite(value, path) {
+    const parsed = requireInputFinite(value, path);
+    if (parsed <= 0) {
+        throw new InvalidScientificInputError(path + " must be greater than zero.");
+    }
+    return parsed;
+}
+function requireInputNonNegativeFinite(value, path) {
+    const parsed = requireInputFinite(value, path);
+    if (parsed < 0) {
+        throw new InvalidScientificInputError(path +
+            " must be greater than or equal to zero.");
+    }
+    return parsed;
+}
+function validateSampleUv(uv, path) {
+    const u = requireInputFinite(uv.u, path + ".u");
+    const v = requireInputFinite(uv.v, path + ".v");
+    if (u < 0 ||
+        u > 1 ||
+        v < 0 ||
+        v > 1) {
+        throw new InvalidScientificInputError(path +
+            " coordinates must lie within [0, 1].");
+    }
+}
+function validateCaptureGeometry(geometry) {
+    const width = requireInputPositiveFinite(geometry.orientedCapture
+        .imagingArea.widthMm, "sampleSet.captureGeometry.orientedCapture.imagingArea.widthMm");
+    const height = requireInputPositiveFinite(geometry.orientedCapture
+        .imagingArea.heightMm, "sampleSet.captureGeometry.orientedCapture.imagingArea.heightMm");
+    const diagonal = Math.hypot(width, height);
+    if (!Number.isFinite(diagonal)) {
+        throw new InvalidScientificInputError("sampleSet.captureGeometry oriented capture diagonal must remain finite.");
+    }
+}
+function validateProcessingState(sampleSet) {
+    const state = sampleSet.processingState;
+    if (state.exposureSettingsApplied !==
+        false ||
+        state.whiteBalanceApplied !==
+            false ||
+        state.toneMappingApplied !==
+            false ||
+        state.displayGammaApplied !==
+            false ||
+        state.sharpeningApplied !==
+            false) {
+        throw new InvalidScientificInputError("Relative exposure metering requires pre-exposure linear samples before exposure settings, white balance, tone mapping, display gamma, and sharpening.");
+    }
+}
+function physicalNormalizedDistanceFromCenter(uv, widthMm, heightMm) {
+    const x = (uv.u - 0.5) * widthMm;
+    const y = (uv.v - 0.5) * heightMm;
+    const halfDiagonal = Math.hypot(widthMm, heightMm) / 2;
+    return Math.hypot(x, y) /
+        halfDiagonal;
+}
+function physicalDistanceFractionOfDiagonal(a, b, widthMm, heightMm) {
+    const dx = (a.u - b.u) * widthMm;
+    const dy = (a.v - b.v) * heightMm;
+    const diagonal = Math.hypot(widthMm, heightMm);
+    return Math.hypot(dx, dy) /
+        diagonal;
+}
+function policyWeight(policy, sample, widthMm, heightMm, maximumSignal) {
+    if (policy.kind ===
+        "multi-zone-uniform") {
+        return 1;
+    }
+    if (policy.kind ===
+        "center-weighted-radial") {
+        const radialPhase = Math.min(1, physicalNormalizedDistanceFromCenter(sample
+            .positionOrientedCaptureUv, widthMm, heightMm));
+        return (policy.edgeWeight +
+            (1 - policy.edgeWeight) *
+                Math.pow(1 - radialPhase, policy.exponent));
+    }
+    if (policy.kind === "spot") {
+        const distance = physicalDistanceFractionOfDiagonal(sample
+            .positionOrientedCaptureUv, policy
+            .centerOrientedCaptureUv, widthMm, heightMm);
+        return distance <=
+            policy
+                .radiusFractionOfCaptureDiagonal
+            ? 1
+            : 0;
+    }
+    if (maximumSignal <= 0) {
+        return policy
+            .minimumWeightFraction;
+    }
+    const normalizedHighlight = sample.relativeLinearSignal /
+        maximumSignal;
+    return (policy.minimumWeightFraction +
+        (1 -
+            policy.minimumWeightFraction) *
+            Math.pow(normalizedHighlight, policy.exponent));
+}
+/**
+ * Meters relative pre-exposure linear signal over the actual oriented active
+ * capture frame.
+ *
+ * The first contract is an educational/relative approximation. It is
+ * intentionally independent of final output crop, display/tone mapping,
+ * exposure compensation, and automatic exposure setting resolution.
+ */
+export function meterRelativeExposure(input) {
+    const profile = parseExposureMeteringProfile(input.profile);
+    const sampleSet = input.sampleSet;
+    requireInputString(sampleSet.measurementId, "sampleSet.measurementId");
+    requireInputString(sampleSet.sceneStateId, "sampleSet.sceneStateId");
+    if (sampleSet.inputDomain !==
+        profile.inputDomain) {
+        throw new InvalidScientificInputError("sampleSet.inputDomain must match the metering profile.");
+    }
+    if (sampleSet.captureRegion !==
+        profile.captureRegion) {
+        throw new InvalidScientificInputError("sampleSet.captureRegion must match the metering profile.");
+    }
+    validateCaptureGeometry(sampleSet.captureGeometry);
+    validateProcessingState(sampleSet);
+    if (!Array.isArray(sampleSet.samples) ||
+        sampleSet.samples.length === 0) {
+        throw new InvalidScientificInputError("sampleSet.samples must be a non-empty array.");
+    }
+    const sampleIds = [];
+    let maximumSignal = 0;
+    for (let index = 0; index < sampleSet.samples.length; index += 1) {
+        const sample = sampleSet.samples[index];
+        const path = "sampleSet.samples[" +
+            index +
+            "]";
+        sampleIds.push(requireInputString(sample.sampleId, path + ".sampleId"));
+        validateSampleUv(sample
+            .positionOrientedCaptureUv, path +
+            ".positionOrientedCaptureUv");
+        const signal = requireInputNonNegativeFinite(sample.relativeLinearSignal, path +
+            ".relativeLinearSignal");
+        requireInputPositiveFinite(sample.areaWeight, path + ".areaWeight");
+        maximumSignal = Math.max(maximumSignal, signal);
+    }
+    if (new Set(sampleIds).size !==
+        sampleIds.length) {
+        throw new InvalidScientificInputError("sampleSet.samples[].sampleId must not contain duplicates.");
+    }
+    const widthMm = sampleSet.captureGeometry
+        .orientedCapture.imagingArea
+        .widthMm;
+    const heightMm = sampleSet.captureGeometry
+        .orientedCapture.imagingArea
+        .heightMm;
+    let weightedSignal = 0;
+    let weightSum = 0;
+    let selectedSampleCount = 0;
+    for (const sample of sampleSet.samples) {
+        const policyMultiplier = policyWeight(profile.policy, sample, widthMm, heightMm, maximumSignal);
+        if (policyMultiplier <= 0) {
+            continue;
+        }
+        const weight = sample.areaWeight *
+            policyMultiplier;
+        weightedSignal +=
+            sample.relativeLinearSignal *
+                weight;
+        weightSum += weight;
+        selectedSampleCount += 1;
+    }
+    if (!Number.isFinite(weightedSignal) ||
+        !Number.isFinite(weightSum)) {
+        throw new InvalidScientificInputError("Metering weighted sums must remain finite.");
+    }
+    if (weightSum <= 0) {
+        throw new InvalidScientificInputError("Metering policy selected no samples with positive weight.");
+    }
+    const meteredRelativeSignal = weightedSignal / weightSum;
+    if (!Number.isFinite(meteredRelativeSignal) ||
+        meteredRelativeSignal < 0) {
+        throw new InvalidScientificInputError("Metered relative signal must remain finite and non-negative.");
+    }
+    const base = {
+        measurementId: sampleSet.measurementId,
+        sceneStateId: sampleSet.sceneStateId,
+        profileId: profile.profileId,
+        scientificStatus: "approximation",
+        inputDomain: "relative-pre-exposure-linear-signal",
+        captureRegion: "oriented-active-capture",
+        orientation: sampleSet.captureGeometry
+            .orientedCapture.orientation,
+        activeCaptureImagingAreaMm: {
+            width: widthMm,
+            height: heightMm
+        },
+        policyKind: profile.policy.kind,
+        targetRelativeSignal: profile.target
+            .targetRelativeSignal,
+        meteredRelativeSignal,
+        totalSampleCount: sampleSet.samples.length,
+        selectedSampleCount,
+        normalizedWeightSum: 1,
+        outputCropUsedForMetering: false,
+        exposureCompensationApplied: false,
+        finalToneMappingUsed: false,
+        displayGammaUsed: false,
+        calibratedLuminanceClaimAuthorized: false,
+        calibratedSceneRadianceClaimAuthorized: false,
+        automaticExposureResolved: false,
+        resultReusableForAeLock: true
+    };
+    const value = meteredRelativeSignal === 0
+        ? {
+            ...base,
+            status: "no-signal",
+            requiredExposureScaleResolved: false,
+            exposureOffsetStopsResolved: false
+        }
+        : {
+            ...base,
+            status: "resolved",
+            requiredExposureScaleToTarget: profile.target
+                .targetRelativeSignal /
+                meteredRelativeSignal,
+            exposureOffsetStopsToTarget: Math.log2(profile.target
+                .targetRelativeSignal /
+                meteredRelativeSignal)
+        };
+    return approximationResult(value, "relative-pre-exposure-metering", "1.0.0", [
+        "Input samples are relative pre-exposure linear signal, not calibrated luminance, scene spectral radiance, sensor-plane irradiance, or final rendered output.",
+        "Sample areaWeight is supplied by the producer and is assumed to represent the active capture frame consistently.",
+        "Metering coordinates are normalized over the physically oriented active capture frame, not the final output crop or CSS/display box.",
+        "Multi-zone, center-weighted, spot, and highlight-weighted policies are generic explicit approximations and do not claim to reproduce a specific commercial camera.",
+        "The declared relative target is profile policy, not a universal 18% gray truth.",
+        "Exposure compensation is not applied by the meter.",
+        "Automatic aperture, shutter, and ISO resolution remains downstream.",
+        "White balance, tone mapping, display gamma, sharpening, and final output crop do not participate in this metering calculation.",
+        "A no-signal result does not fabricate an infinite exposure correction."
+    ]);
+}
+//# sourceMappingURL=metering.js.map

package/dist/exposure/metering.js.map

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

package/dist/exposure/program-line.d.ts

@@ -0,0 +1,29 @@
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+export declare const EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION: "0.1.0";
+export interface ExposureProgramLineNode {
+    nodeId: string;
+    opticalExposureStopsFromReference: number;
+    aperture: number;
+    shutterSeconds: number;
+}
+export interface ExposureProgramLineProfile {
+    schemaVersion: typeof EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION;
+    profileId: string;
+    profileVersion: string;
+    scientificStatus: "approximation";
+    policyKind: "generic-program-line";
+    interpolation: "log2-aperture-shutter";
+    evidence: readonly EvidenceProvenance[];
+    limitations: readonly string[];
+    nodes: readonly ExposureProgramLineNode[];
+}
+/**
+ * Parses a generic educational/product exposure program line.
+ *
+ * A program line is control policy, not physics. Nodes declare desired
+ * aperture/shutter pairs at explicit optical-exposure stops relative to the
+ * resolver's reference exposure. Resolution later verifies that every node is
+ * physically consistent with that reference and current equipment capability.
+ */
+export declare function parseExposureProgramLineProfile(value: unknown): ExposureProgramLineProfile;
+//# sourceMappingURL=program-line.d.ts.map

package/dist/exposure/program-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-line.d.ts","sourceRoot":"","sources":["../../src/exposure/program-line.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAIxC,eAAO,MAAM,oCAAoC,EAC/C,OAAgB,CAAC;AAEnB,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC,EAAE,MAAM,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EACX,OAAO,oCAAoC,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,eAAe,CAAC;IAClC,UAAU,EACR,sBAAsB,CAAC;IACzB,aAAa,EACX,uBAAuB,CAAC;IAC1B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,KAAK,EACH,SAAS,uBAAuB,EAAE,CAAC;CACtC;AA2FD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,0BAA0B,CA0I5B"}

package/dist/exposure/program-line.js

@@ -0,0 +1,126 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses a generic educational/product exposure program line. A program line is control policy, not
+ * physics. Nodes declare desired aperture/shutter pairs at explicit optical-exposure stops relative to
+ * the resolver's reference exposure. Resolution later verifies that every node is physically
+ * consistent with that reference and current equipment capability.
+ * @see docs/USAGE.md for equations, coordinate/unit conventions, blockers and support limits.
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+export const EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION = "0.1.0";
+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.trim();
+}
+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 parseLimitations(value, path) {
+    if (!Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an array.");
+    }
+    const parsed = value.map((entry, index) => requireNonEmptyString(entry, path + "[" + index + "]"));
+    if (new Set(parsed).size !==
+        parsed.length) {
+        throw new InvalidConfigurationError(path +
+            " must not contain duplicates.");
+    }
+    return parsed;
+}
+/**
+ * Parses a generic educational/product exposure program line.
+ *
+ * A program line is control policy, not physics. Nodes declare desired
+ * aperture/shutter pairs at explicit optical-exposure stops relative to the
+ * resolver's reference exposure. Resolution later verifies that every node is
+ * physically consistent with that reference and current equipment capability.
+ */
+export function parseExposureProgramLineProfile(value) {
+    const record = requireRecord(value, "exposureProgramLineProfile");
+    if (record.schemaVersion !==
+        EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION) {
+        throw new InvalidConfigurationError('exposureProgramLineProfile.schemaVersion must be "' +
+            EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION +
+            '".');
+    }
+    if (record.scientificStatus !==
+        "approximation") {
+        throw new InvalidConfigurationError('exposureProgramLineProfile.scientificStatus must be "approximation".');
+    }
+    if (record.policyKind !==
+        "generic-program-line") {
+        throw new InvalidConfigurationError('exposureProgramLineProfile.policyKind must be "generic-program-line".');
+    }
+    if (record.interpolation !==
+        "log2-aperture-shutter") {
+        throw new InvalidConfigurationError('exposureProgramLineProfile.interpolation must be "log2-aperture-shutter".');
+    }
+    if (!Array.isArray(record.nodes) ||
+        record.nodes.length < 2) {
+        throw new InvalidConfigurationError("exposureProgramLineProfile.nodes must contain at least two nodes.");
+    }
+    let previousStops = Number.NEGATIVE_INFINITY;
+    const ids = [];
+    const nodes = record.nodes.map((entry, index) => {
+        const path = "exposureProgramLineProfile.nodes[" +
+            index +
+            "]";
+        const node = requireRecord(entry, path);
+        const nodeId = requireNonEmptyString(node.nodeId, path + ".nodeId");
+        const stops = requireFinite(node
+            .opticalExposureStopsFromReference, path +
+            ".opticalExposureStopsFromReference");
+        if (stops <= previousStops) {
+            throw new InvalidConfigurationError("exposureProgramLineProfile.nodes opticalExposureStopsFromReference must be strictly increasing.");
+        }
+        previousStops = stops;
+        ids.push(nodeId);
+        return {
+            nodeId,
+            opticalExposureStopsFromReference: stops,
+            aperture: requirePositiveFinite(node.aperture, path + ".aperture"),
+            shutterSeconds: requirePositiveFinite(node.shutterSeconds, path +
+                ".shutterSeconds")
+        };
+    });
+    if (new Set(ids).size !== ids.length) {
+        throw new InvalidConfigurationError("exposureProgramLineProfile.nodes[].nodeId must not contain duplicates.");
+    }
+    return {
+        schemaVersion: EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION,
+        profileId: requireNonEmptyString(record.profileId, "exposureProgramLineProfile.profileId"),
+        profileVersion: requireNonEmptyString(record.profileVersion, "exposureProgramLineProfile.profileVersion"),
+        scientificStatus: "approximation",
+        policyKind: "generic-program-line",
+        interpolation: "log2-aperture-shutter",
+        evidence: parseEvidenceList(record.evidence, "exposureProgramLineProfile.evidence"),
+        limitations: parseLimitations(record.limitations, "exposureProgramLineProfile.limitations"),
+        nodes
+    };
+}
+//# sourceMappingURL=program-line.js.map

package/dist/exposure/program-line.js.map

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