@photivra/engine 0.6.0 → 1.0.0

package/dist/equipment/metering-capabilities.js

@@ -0,0 +1,151 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses generic body metering capability metadata. This profile declares which engine-owned metering
+ * profiles/modes a generic body can select. It deliberately does not duplicate target/calibration
+ * values from those metering profiles.
+ * Checks whether one engine metering profile is selectable on a generic body. Calibration/target
+ * policy remains authoritative in the metering profile and is never copied into equipment capability
+ * metadata.
+ * @see docs/GENERIC_TIER_PRESETS.md for equations, coordinate/unit conventions, blockers and support
+ * limits.
+ */
+import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+import { parseExposureMeteringProfile } from "../exposure/metering.js";
+export const GENERIC_BODY_METERING_CAPABILITY_SCHEMA_VERSION = "0.1.0";
+const POLICY_KINDS = new Set([
+    "multi-zone-uniform",
+    "center-weighted-radial",
+    "spot",
+    "highlight-weighted"
+]);
+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 parseAvailability(value, path) {
+    if (value !== "supported" &&
+        value !== "unsupported" &&
+        value !== "unknown") {
+        throw new InvalidConfigurationError(path + " is invalid.");
+    }
+    return value;
+}
+function parsePolicyKind(value, path) {
+    if (typeof value !== "string" ||
+        !POLICY_KINDS.has(value)) {
+        throw new InvalidConfigurationError(path + " is invalid.");
+    }
+    return value;
+}
+/**
+ * Parses generic body metering capability metadata.
+ *
+ * This profile declares which engine-owned metering profiles/modes a generic
+ * body can select. It deliberately does not duplicate target/calibration
+ * values from those metering profiles.
+ */
+export function parseGenericBodyMeteringCapabilityProfile(value) {
+    const record = requireRecord(value, "genericBodyMeteringCapabilityProfile");
+    if (record.schemaVersion !==
+        GENERIC_BODY_METERING_CAPABILITY_SCHEMA_VERSION) {
+        throw new InvalidConfigurationError('genericBodyMeteringCapabilityProfile.schemaVersion must be "' +
+            GENERIC_BODY_METERING_CAPABILITY_SCHEMA_VERSION +
+            '".');
+    }
+    if (record.scientificStatus !==
+        "approximation") {
+        throw new InvalidConfigurationError('genericBodyMeteringCapabilityProfile.scientificStatus must be "approximation".');
+    }
+    if (!Array.isArray(record.supportedMeteringProfiles) ||
+        record.supportedMeteringProfiles
+            .length === 0) {
+        throw new InvalidConfigurationError("genericBodyMeteringCapabilityProfile.supportedMeteringProfiles must be a non-empty array.");
+    }
+    const supported = record.supportedMeteringProfiles.map((entry, index) => {
+        const path = "genericBodyMeteringCapabilityProfile.supportedMeteringProfiles[" +
+            index +
+            "]";
+        const item = requireRecord(entry, path);
+        return {
+            meteringProfileId: requireNonEmptyString(item.meteringProfileId, path + ".meteringProfileId"),
+            policyKind: parsePolicyKind(item.policyKind, path + ".policyKind"),
+            evidence: parseEvidenceList(item.evidence, path + ".evidence")
+        };
+    });
+    const ids = supported.map((entry) => entry.meteringProfileId);
+    if (new Set(ids).size !==
+        ids.length) {
+        throw new InvalidConfigurationError("genericBodyMeteringCapabilityProfile.supportedMeteringProfiles must not contain duplicate meteringProfileId values.");
+    }
+    const spotLink = requireRecord(record.spotFocusPointLinkage, "genericBodyMeteringCapabilityProfile.spotFocusPointLinkage");
+    return {
+        schemaVersion: GENERIC_BODY_METERING_CAPABILITY_SCHEMA_VERSION,
+        profileId: requireNonEmptyString(record.profileId, "genericBodyMeteringCapabilityProfile.profileId"),
+        profileVersion: requireNonEmptyString(record.profileVersion, "genericBodyMeteringCapabilityProfile.profileVersion"),
+        scientificStatus: "approximation",
+        evidence: parseEvidenceList(record.evidence, "genericBodyMeteringCapabilityProfile.evidence"),
+        supportedMeteringProfiles: supported,
+        spotFocusPointLinkage: {
+            availability: parseAvailability(spotLink.availability, "genericBodyMeteringCapabilityProfile.spotFocusPointLinkage.availability"),
+            evidence: parseEvidenceList(spotLink.evidence, "genericBodyMeteringCapabilityProfile.spotFocusPointLinkage.evidence")
+        }
+    };
+}
+/**
+ * Checks whether one engine metering profile is selectable on a generic body.
+ *
+ * Calibration/target policy remains authoritative in the metering profile and
+ * is never copied into equipment capability metadata.
+ */
+export function assessExposureMeteringProfileCompatibility(input) {
+    const body = parseGenericBodyMeteringCapabilityProfile(input.bodyCapabilities);
+    const metering = parseExposureMeteringProfile(input.meteringProfile);
+    const declared = body.supportedMeteringProfiles.find((entry) => entry.meteringProfileId ===
+        metering.profileId);
+    const blockers = [];
+    if (declared === undefined) {
+        blockers.push("metering-profile-unsupported");
+    }
+    else if (declared.policyKind !==
+        metering.policy.kind) {
+        blockers.push("metering-policy-mismatch");
+    }
+    if (blockers.length >
+        new Set(blockers).size) {
+        throw new InvalidScientificInputError("Metering capability compatibility blockers must remain unique.");
+    }
+    return {
+        schemaVersion: GENERIC_BODY_METERING_CAPABILITY_SCHEMA_VERSION,
+        status: blockers.length === 0
+            ? "compatible"
+            : "blocked",
+        bodyProfile: {
+            profileId: body.profileId,
+            profileVersion: body.profileVersion
+        },
+        meteringProfile: {
+            profileId: metering.profileId,
+            policyKind: metering.policy.kind
+        },
+        targetPolicyOwnership: "metering-profile",
+        targetCalibrationDuplicatedInEquipmentProfile: false,
+        spotFocusPointLinkageAvailability: body.spotFocusPointLinkage
+            .availability,
+        blockers
+    };
+}
+//# sourceMappingURL=metering-capabilities.js.map

package/dist/equipment/metering-capabilities.js.map

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

package/dist/equipment/release-capabilities.d.ts

@@ -0,0 +1,33 @@
+import { type EvidenceBackedFact, type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { GenericCapabilityAvailability } from "./exposure-capabilities.js";
+export declare const GENERIC_RELEASE_CAPABILITY_SCHEMA_VERSION: "0.1.0";
+export type GenericReleaseDriveMode = "single" | "burst" | "self-timer";
+export type GenericExposureBracketAxis = "shutter" | "iso" | "aperture";
+export interface GenericReleaseCapabilityProfile {
+    schemaVersion: typeof GENERIC_RELEASE_CAPABILITY_SCHEMA_VERSION;
+    profileId: string;
+    profileVersion: string;
+    scientificStatus: "approximation";
+    evidence: readonly EvidenceProvenance[];
+    supportedDriveModes: EvidenceBackedFact<readonly GenericReleaseDriveMode[]>;
+    maximumLogicalFramesPerSequence: EvidenceBackedFact<number>;
+    maximumCadenceFps: EvidenceBackedFact<number>;
+    minimumInterFrameGapSeconds: EvidenceBackedFact<number>;
+    overlappingOrdinaryStillExposures: false;
+    exposureBracketing: {
+        availability: EvidenceBackedFact<GenericCapabilityAvailability>;
+        supportedAxes: readonly GenericExposureBracketAxis[];
+    };
+    focusBracketing: {
+        availability: EvidenceBackedFact<GenericCapabilityAvailability>;
+    };
+}
+/**
+ * Parses generic logical-release/drive capabilities.
+ *
+ * The first schema deliberately models non-overlapping ordinary still
+ * exposures only. Buffer/media/thermal slowdown and pre-release capture remain
+ * outside this profile.
+ */
+export declare function parseGenericReleaseCapabilityProfile(value: unknown): GenericReleaseCapabilityProfile;
+//# sourceMappingURL=release-capabilities.d.ts.map

package/dist/equipment/release-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-capabilities.d.ts","sourceRoot":"","sources":["../../src/equipment/release-capabilities.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAIhF,eAAO,MAAM,yCAAyC,EACpD,OAAgB,CAAC;AAEnB,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,GACR,OAAO,GACP,YAAY,CAAC;AAEjB,MAAM,MAAM,0BAA0B,GAClC,SAAS,GACT,KAAK,GACL,UAAU,CAAC;AAEf,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EACX,OAAO,yCAAyC,CAAC;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,eAAe,CAAC;IAClC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,mBAAmB,EACjB,kBAAkB,CAChB,SAAS,uBAAuB,EAAE,CACnC,CAAC;IACJ,+BAA+B,EAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,EACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7B,2BAA2B,EACzB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7B,iCAAiC,EAC/B,KAAK,CAAC;IACR,kBAAkB,EAAE;QAClB,YAAY,EACV,kBAAkB,CAChB,6BAA6B,CAC9B,CAAC;QACJ,aAAa,EACX,SAAS,0BAA0B,EAAE,CAAC;KACzC,CAAC;IACF,eAAe,EAAE;QACf,YAAY,EACV,kBAAkB,CAChB,6BAA6B,CAC9B,CAAC;KACL,CAAC;CACH;AA0ND;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,OAAO,GACb,+BAA+B,CA+HjC"}

package/dist/equipment/release-capabilities.js

@@ -0,0 +1,176 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Parses generic logical-release/drive capabilities. The first schema deliberately models
+ * non-overlapping ordinary still exposures only. Buffer/media/thermal slowdown and pre-release capture
+ * remain outside this profile.
+ * @see docs/GENERIC_TIER_PRESETS.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 GENERIC_RELEASE_CAPABILITY_SCHEMA_VERSION = "0.1.0";
+const DRIVE_MODES = new Set([
+    "single",
+    "burst",
+    "self-timer"
+]);
+const BRACKET_AXES = new Set([
+    "shutter",
+    "iso",
+    "aperture"
+]);
+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 requirePositiveFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value <= 0) {
+        throw new InvalidConfigurationError(path +
+            " must be finite and greater than zero.");
+    }
+    return value;
+}
+function requireNonNegativeFinite(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value < 0) {
+        throw new InvalidConfigurationError(path +
+            " must be finite and greater than or equal to zero.");
+    }
+    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 parseAvailability(value, path) {
+    if (value !== "supported" &&
+        value !== "unsupported" &&
+        value !== "unknown") {
+        throw new InvalidConfigurationError(path + " is invalid.");
+    }
+    return value;
+}
+function parseFact(value, path, parseValue) {
+    const record = requireRecord(value, path);
+    return {
+        value: parseValue(record.value, path + ".value"),
+        evidence: parseEvidenceList(record.evidence, path + ".evidence")
+    };
+}
+function parseDriveModes(value, path) {
+    if (!Array.isArray(value) ||
+        value.length === 0) {
+        throw new InvalidConfigurationError(path +
+            " must be a non-empty array.");
+    }
+    const parsed = value.map((entry, index) => {
+        if (typeof entry !== "string" ||
+            !DRIVE_MODES.has(entry)) {
+            throw new InvalidConfigurationError(path +
+                "[" +
+                index +
+                "] is invalid.");
+        }
+        return entry;
+    });
+    if (new Set(parsed).size !==
+        parsed.length) {
+        throw new InvalidConfigurationError(path +
+            " must not contain duplicates.");
+    }
+    return parsed;
+}
+function parseBracketAxes(value, path) {
+    if (!Array.isArray(value)) {
+        throw new InvalidConfigurationError(path + " must be an array.");
+    }
+    const parsed = value.map((entry, index) => {
+        if (typeof entry !== "string" ||
+            !BRACKET_AXES.has(entry)) {
+            throw new InvalidConfigurationError(path +
+                "[" +
+                index +
+                "] is invalid.");
+        }
+        return entry;
+    });
+    if (new Set(parsed).size !==
+        parsed.length) {
+        throw new InvalidConfigurationError(path +
+            " must not contain duplicates.");
+    }
+    return parsed;
+}
+/**
+ * Parses generic logical-release/drive capabilities.
+ *
+ * The first schema deliberately models non-overlapping ordinary still
+ * exposures only. Buffer/media/thermal slowdown and pre-release capture remain
+ * outside this profile.
+ */
+export function parseGenericReleaseCapabilityProfile(value) {
+    const record = requireRecord(value, "genericReleaseCapabilityProfile");
+    if (record.schemaVersion !==
+        GENERIC_RELEASE_CAPABILITY_SCHEMA_VERSION) {
+        throw new InvalidConfigurationError('genericReleaseCapabilityProfile.schemaVersion must be "' +
+            GENERIC_RELEASE_CAPABILITY_SCHEMA_VERSION +
+            '".');
+    }
+    if (record.scientificStatus !==
+        "approximation") {
+        throw new InvalidConfigurationError('genericReleaseCapabilityProfile.scientificStatus must be "approximation".');
+    }
+    if (record.overlappingOrdinaryStillExposures !==
+        false) {
+        throw new InvalidConfigurationError("genericReleaseCapabilityProfile.overlappingOrdinaryStillExposures must be false in schema 0.1.0.");
+    }
+    const exposureBracketing = requireRecord(record.exposureBracketing, "genericReleaseCapabilityProfile.exposureBracketing");
+    const focusBracketing = requireRecord(record.focusBracketing, "genericReleaseCapabilityProfile.focusBracketing");
+    const exposureAvailability = parseFact(exposureBracketing.availability, "genericReleaseCapabilityProfile.exposureBracketing.availability", parseAvailability);
+    const axes = parseBracketAxes(exposureBracketing.supportedAxes, "genericReleaseCapabilityProfile.exposureBracketing.supportedAxes");
+    if (exposureAvailability.value !==
+        "supported" &&
+        axes.length > 0) {
+        throw new InvalidConfigurationError("Unsupported/unknown exposure bracketing must not declare supported axes.");
+    }
+    return {
+        schemaVersion: GENERIC_RELEASE_CAPABILITY_SCHEMA_VERSION,
+        profileId: requireNonEmptyString(record.profileId, "genericReleaseCapabilityProfile.profileId"),
+        profileVersion: requireNonEmptyString(record.profileVersion, "genericReleaseCapabilityProfile.profileVersion"),
+        scientificStatus: "approximation",
+        evidence: parseEvidenceList(record.evidence, "genericReleaseCapabilityProfile.evidence"),
+        supportedDriveModes: parseFact(record.supportedDriveModes, "genericReleaseCapabilityProfile.supportedDriveModes", parseDriveModes),
+        maximumLogicalFramesPerSequence: parseFact(record.maximumLogicalFramesPerSequence, "genericReleaseCapabilityProfile.maximumLogicalFramesPerSequence", requirePositiveSafeInteger),
+        maximumCadenceFps: parseFact(record.maximumCadenceFps, "genericReleaseCapabilityProfile.maximumCadenceFps", requirePositiveFinite),
+        minimumInterFrameGapSeconds: parseFact(record.minimumInterFrameGapSeconds, "genericReleaseCapabilityProfile.minimumInterFrameGapSeconds", requireNonNegativeFinite),
+        overlappingOrdinaryStillExposures: false,
+        exposureBracketing: {
+            availability: exposureAvailability,
+            supportedAxes: axes
+        },
+        focusBracketing: {
+            availability: parseFact(focusBracketing.availability, "genericReleaseCapabilityProfile.focusBracketing.availability", parseAvailability)
+        }
+    };
+}
+//# sourceMappingURL=release-capabilities.js.map

package/dist/equipment/release-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-capabilities.js","sourceRoot":"","sources":["../../src/equipment/release-capabilities.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;GAOG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,iBAAiB,EAGlB,MAAM,gCAAgC,CAAC;AAKxC,MAAM,CAAC,MAAM,yCAAyC,GACpD,OAAgB,CAAC;AA+CnB,MAAM,WAAW,GACf,IAAI,GAAG,CAA0B;IAC/B,QAAQ;IACR,OAAO;IACP,YAAY;CACb,CAAC,CAAC;AAEL,MAAM,YAAY,GAChB,IAAI,GAAG,CAA6B;IAClC,SAAS;IACT,KAAK;IACL,UAAU;CACX,CAAC,CAAC;AAEL,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,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC,EACV,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,wCAAwC,CAC3C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,wBAAwB,CAC/B,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,yBAAyB,CACjC,IAAI;YACF,oDAAoD,CACvD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,0BAA0B,CACjC,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC5B,KAAK,IAAI,CAAC,EACV,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,mCAAmC,CACtC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAc,EACd,IAAY;IAEZ,IACE,KAAK,KAAK,WAAW;QACrB,KAAK,KAAK,aAAa;QACvB,KAAK,KAAK,SAAS,EACnB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,cAAc,CACtB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAChB,KAAc,EACd,IAAY,EACZ,UAGM;IAEN,MAAM,MAAM,GACV,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO;QACL,KAAK,EACH,UAAU,CACR,MAAM,CAAC,KAAK,EACZ,IAAI,GAAG,QAAQ,CAChB;QACH,QAAQ,EACN,iBAAiB,CACf,MAAM,CAAC,QAAQ,EACf,IAAI,GAAG,WAAW,CACnB;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,KAAc,EACd,IAAY;IAEZ,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,MAAM,KAAK,CAAC,EAClB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,6BAA6B,CAChC,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GACV,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACzB,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,WAAW,CAAC,GAAG,CACd,KAAgC,CACjC,EACD,CAAC;YACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;gBACF,GAAG;gBACH,KAAK;gBACL,eAAe,CAClB,CAAC;QACJ,CAAC;QACD,OAAO,KAAgC,CAAC;IAC1C,CAAC,CAAC,CAAC;IACL,IACE,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI;QACpB,MAAM,CAAC,MAAM,EACb,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,+BAA+B,CAClC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,IAAY;IAEZ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,oBAAoB,CAC5B,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GACV,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACzB,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,YAAY,CAAC,GAAG,CACf,KAAmC,CACpC,EACD,CAAC;YACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;gBACF,GAAG;gBACH,KAAK;gBACL,eAAe,CAClB,CAAC;QACJ,CAAC;QACD,OAAO,KAAmC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACL,IACE,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI;QACpB,MAAM,CAAC,MAAM,EACb,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;YACF,+BAA+B,CAClC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oCAAoC,CAClD,KAAc;IAEd,MAAM,MAAM,GACV,aAAa,CACX,KAAK,EACL,iCAAiC,CAClC,CAAC;IAEJ,IACE,MAAM,CAAC,aAAa;QACpB,yCAAyC,EACzC,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,yDAAyD;YACvD,yCAAyC;YACzC,IAAI,CACP,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,gBAAgB;QACvB,eAAe,EACf,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,iCAAiC;QACxC,KAAK,EACL,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GACtB,aAAa,CACX,MAAM,CAAC,kBAAkB,EACzB,oDAAoD,CACrD,CAAC;IACJ,MAAM,eAAe,GACnB,aAAa,CACX,MAAM,CAAC,eAAe,EACtB,iDAAiD,CAClD,CAAC;IAEJ,MAAM,oBAAoB,GACxB,SAAS,CACP,kBAAkB,CAAC,YAAY,EAC/B,iEAAiE,EACjE,iBAAiB,CAClB,CAAC;IACJ,MAAM,IAAI,GACR,gBAAgB,CACd,kBAAkB,CAAC,aAAa,EAChC,kEAAkE,CACnE,CAAC;IAEJ,IACE,oBAAoB,CAAC,KAAK;QACxB,WAAW;QACb,IAAI,CAAC,MAAM,GAAG,CAAC,EACf,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,aAAa,EACX,yCAAyC;QAC3C,SAAS,EACP,qBAAqB,CACnB,MAAM,CAAC,SAAS,EAChB,2CAA2C,CAC5C;QACH,cAAc,EACZ,qBAAqB,CACnB,MAAM,CAAC,cAAc,EACrB,gDAAgD,CACjD;QACH,gBAAgB,EACd,eAAe;QACjB,QAAQ,EACN,iBAAiB,CACf,MAAM,CAAC,QAAQ,EACf,0CAA0C,CAC3C;QACH,mBAAmB,EACjB,SAAS,CACP,MAAM,CAAC,mBAAmB,EAC1B,qDAAqD,EACrD,eAAe,CAChB;QACH,+BAA+B,EAC7B,SAAS,CACP,MAAM,CAAC,+BAA+B,EACtC,iEAAiE,EACjE,0BAA0B,CAC3B;QACH,iBAAiB,EACf,SAAS,CACP,MAAM,CAAC,iBAAiB,EACxB,mDAAmD,EACnD,qBAAqB,CACtB;QACH,2BAA2B,EACzB,SAAS,CACP,MAAM,CAAC,2BAA2B,EAClC,6DAA6D,EAC7D,wBAAwB,CACzB;QACH,iCAAiC,EAC/B,KAAK;QACP,kBAAkB,EAAE;YAClB,YAAY,EACV,oBAAoB;YACtB,aAAa,EAAE,IAAI;SACpB;QACD,eAAe,EAAE;YACf,YAAY,EACV,SAAS,CACP,eAAe,CAAC,YAAY,EAC5B,8DAA8D,EAC9D,iBAAiB,CAClB;SACJ;KACF,CAAC;AACJ,CAAC"}

package/dist/exposure/exposure-duration-control.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Module boundary and integration notes.
+ * Resolves shutter-duration control semantics to a concrete positive elapsed duration before physical
+ * exposure integration. Bulb and Time are control behaviors only. Neither implies a shutter mechanism,
+ * exposure-boundary topology, tripod, stabilization state, long exposure NR, or temperature model.
+ * Binds a resolved duration into the authoritative #12 exposure-window input. The existing shutter
+ * mechanism/opening/closing schedules remain untouched. Only the seconds-valued nominal duration is
+ * supplied here.
+ * @see docs/USAGE.md for equations, coordinate/unit conventions, blockers and support limits.
+ */
+import { type EvidenceProvenance } from "../core/evidence-provenance.js";
+import type { CalculateCaptureExposureWindowsInput } from "../sensor/exposure-window.js";
+export declare const EXPOSURE_DURATION_CONTROL_VERSION: "0.1.0";
+export type ExposureDurationControl = {
+    kind: "fixed-duration";
+    durationSeconds: number;
+} | {
+    kind: "bulb";
+    timeReference: "control-monotonic-seconds";
+    pressSeconds: number;
+    releaseSeconds?: number;
+} | {
+    kind: "time";
+    timeReference: "control-monotonic-seconds";
+    startSeconds: number;
+    stopSeconds?: number;
+};
+interface ExposureDurationControlResolutionBase {
+    version: typeof EXPOSURE_DURATION_CONTROL_VERSION;
+    controlKind: ExposureDurationControl["kind"];
+    shutterMechanismInferred: false;
+    exposureBoundaryTopologyInferred: false;
+    tripodSupportInferred: false;
+    stabilizationStateInferred: false;
+    longExposureNoiseReductionInferred: false;
+    sensorTemperatureBehaviorInferred: false;
+}
+export type ExposureDurationControlResolution = (ExposureDurationControlResolutionBase & {
+    status: "resolved";
+    durationSeconds: number;
+    physicalExposureIntegrationAuthorized: true;
+}) | (ExposureDurationControlResolutionBase & {
+    status: "active";
+    durationSeconds: null;
+    physicalExposureIntegrationAuthorized: false;
+    waitingFor: "bulb-release" | "time-stop";
+});
+export interface BindResolvedExposureDurationToCaptureExposureInput {
+    resolution: Extract<ExposureDurationControlResolution, {
+        status: "resolved";
+    }>;
+    durationEvidence: readonly EvidenceProvenance[];
+    exposureWindowInput: Omit<CalculateCaptureExposureWindowsInput, "nominalExposureDurationSeconds">;
+}
+/**
+ * Resolves shutter-duration control semantics to a concrete positive elapsed
+ * duration before physical exposure integration.
+ *
+ * Bulb and Time are control behaviors only. Neither implies a shutter
+ * mechanism, exposure-boundary topology, tripod, stabilization state, long
+ * exposure NR, or temperature model.
+ */
+export declare function resolveExposureDurationControl(control: ExposureDurationControl): ExposureDurationControlResolution;
+/**
+ * Binds a resolved duration into the authoritative #12 exposure-window input.
+ *
+ * The existing shutter mechanism/opening/closing schedules remain untouched.
+ * Only the seconds-valued nominal duration is supplied here.
+ */
+export declare function bindResolvedExposureDurationToCaptureExposureInput(input: BindResolvedExposureDurationToCaptureExposureInput): CalculateCaptureExposureWindowsInput;
+export {};
+//# sourceMappingURL=exposure-duration-control.d.ts.map

package/dist/exposure/exposure-duration-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposure-duration-control.d.ts","sourceRoot":"","sources":["../../src/exposure/exposure-duration-control.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,oCAAoC,EACrC,MAAM,8BAA8B,CAAC;AAEtC,eAAO,MAAM,iCAAiC,EAC5C,OAAgB,CAAC;AAEnB,MAAM,MAAM,uBAAuB,GAC/B;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EACX,2BAA2B,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EACX,2BAA2B,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,UAAU,qCAAqC;IAC7C,OAAO,EACL,OAAO,iCAAiC,CAAC;IAC3C,WAAW,EACT,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAClC,wBAAwB,EAAE,KAAK,CAAC;IAChC,gCAAgC,EAC9B,KAAK,CAAC;IACR,qBAAqB,EAAE,KAAK,CAAC;IAC7B,0BAA0B,EAAE,KAAK,CAAC;IAClC,kCAAkC,EAChC,KAAK,CAAC;IACR,iCAAiC,EAC/B,KAAK,CAAC;CACT;AAED,MAAM,MAAM,iCAAiC,GACzC,CAAC,qCAAqC,GAAG;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC,EACnC,IAAI,CAAC;CACR,CAAC,GACF,CAAC,qCAAqC,GAAG;IACvC,MAAM,EAAE,QAAQ,CAAC;IACjB,eAAe,EAAE,IAAI,CAAC;IACtB,qCAAqC,EACnC,KAAK,CAAC;IACR,UAAU,EACN,cAAc,GACd,WAAW,CAAC;CACjB,CAAC,CAAC;AAEP,MAAM,WAAW,kDAAkD;IACjE,UAAU,EACR,OAAO,CACL,iCAAiC,EACjC;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,CACvB,CAAC;IACJ,gBAAgB,EACd,SAAS,kBAAkB,EAAE,CAAC;IAChC,mBAAmB,EACjB,IAAI,CACF,oCAAoC,EACpC,gCAAgC,CACjC,CAAC;CACL;AA4FD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,uBAAuB,GAC/B,iCAAiC,CAwGnC;AAED;;;;;GAKG;AACH,wBAAgB,kDAAkD,CAChE,KAAK,EACH,kDAAkD,GACnD,oCAAoC,CA0DtC"}

package/dist/exposure/exposure-duration-control.js

@@ -0,0 +1,161 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Module boundary and integration notes.
+ * Resolves shutter-duration control semantics to a concrete positive elapsed duration before physical
+ * exposure integration. Bulb and Time are control behaviors only. Neither implies a shutter mechanism,
+ * exposure-boundary topology, tripod, stabilization state, long exposure NR, or temperature model.
+ * Binds a resolved duration into the authoritative #12 exposure-window input. The existing shutter
+ * mechanism/opening/closing schedules remain untouched. Only the seconds-valued nominal duration is
+ * supplied here.
+ * @see docs/USAGE.md for equations, coordinate/unit conventions, blockers and support limits.
+ */
+import { parseEvidenceList } from "../core/evidence-provenance.js";
+import { InvalidScientificInputError } from "../core/validation.js";
+export const EXPOSURE_DURATION_CONTROL_VERSION = "0.1.0";
+function requireFiniteSeconds(value, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value)) {
+        throw new InvalidScientificInputError(path + " must be finite.");
+    }
+    return value;
+}
+function requirePositiveSeconds(value, path) {
+    const parsed = requireFiniteSeconds(value, path);
+    if (parsed <= 0) {
+        throw new InvalidScientificInputError(path +
+            " must be greater than zero.");
+    }
+    return parsed;
+}
+function resolved(kind, durationSeconds) {
+    return {
+        version: EXPOSURE_DURATION_CONTROL_VERSION,
+        controlKind: kind,
+        status: "resolved",
+        durationSeconds,
+        physicalExposureIntegrationAuthorized: true,
+        shutterMechanismInferred: false,
+        exposureBoundaryTopologyInferred: false,
+        tripodSupportInferred: false,
+        stabilizationStateInferred: false,
+        longExposureNoiseReductionInferred: false,
+        sensorTemperatureBehaviorInferred: false
+    };
+}
+function active(kind) {
+    return {
+        version: EXPOSURE_DURATION_CONTROL_VERSION,
+        controlKind: kind,
+        status: "active",
+        durationSeconds: null,
+        physicalExposureIntegrationAuthorized: false,
+        waitingFor: kind === "bulb"
+            ? "bulb-release"
+            : "time-stop",
+        shutterMechanismInferred: false,
+        exposureBoundaryTopologyInferred: false,
+        tripodSupportInferred: false,
+        stabilizationStateInferred: false,
+        longExposureNoiseReductionInferred: false,
+        sensorTemperatureBehaviorInferred: false
+    };
+}
+/**
+ * Resolves shutter-duration control semantics to a concrete positive elapsed
+ * duration before physical exposure integration.
+ *
+ * Bulb and Time are control behaviors only. Neither implies a shutter
+ * mechanism, exposure-boundary topology, tripod, stabilization state, long
+ * exposure NR, or temperature model.
+ */
+export function resolveExposureDurationControl(control) {
+    if (typeof control !== "object" ||
+        control === null) {
+        throw new InvalidScientificInputError("control must be an object.");
+    }
+    if (control.kind ===
+        "fixed-duration") {
+        return resolved("fixed-duration", requirePositiveSeconds(control.durationSeconds, "control.durationSeconds"));
+    }
+    if (control.kind === "bulb") {
+        if (control.timeReference !==
+            "control-monotonic-seconds") {
+            throw new InvalidScientificInputError('Bulb control timeReference must be "control-monotonic-seconds".');
+        }
+        const start = requireFiniteSeconds(control.pressSeconds, "control.pressSeconds");
+        if (control.releaseSeconds ===
+            undefined) {
+            return active("bulb");
+        }
+        const stop = requireFiniteSeconds(control.releaseSeconds, "control.releaseSeconds");
+        const duration = stop - start;
+        if (duration <= 0) {
+            throw new InvalidScientificInputError("Bulb releaseSeconds must be greater than pressSeconds.");
+        }
+        return resolved("bulb", duration);
+    }
+    if (control.kind === "time") {
+        if (control.timeReference !==
+            "control-monotonic-seconds") {
+            throw new InvalidScientificInputError('Time control timeReference must be "control-monotonic-seconds".');
+        }
+        const start = requireFiniteSeconds(control.startSeconds, "control.startSeconds");
+        if (control.stopSeconds ===
+            undefined) {
+            return active("time");
+        }
+        const stop = requireFiniteSeconds(control.stopSeconds, "control.stopSeconds");
+        const duration = stop - start;
+        if (duration <= 0) {
+            throw new InvalidScientificInputError("Time stopSeconds must be greater than startSeconds.");
+        }
+        return resolved("time", duration);
+    }
+    throw new InvalidScientificInputError("control.kind is invalid.");
+}
+/**
+ * Binds a resolved duration into the authoritative #12 exposure-window input.
+ *
+ * The existing shutter mechanism/opening/closing schedules remain untouched.
+ * Only the seconds-valued nominal duration is supplied here.
+ */
+export function bindResolvedExposureDurationToCaptureExposureInput(input) {
+    const resolution = input.resolution;
+    if (resolution.version !==
+        EXPOSURE_DURATION_CONTROL_VERSION ||
+        resolution.status !==
+            "resolved" ||
+        resolution
+            .physicalExposureIntegrationAuthorized !==
+            true) {
+        throw new InvalidScientificInputError("resolution must be a resolved exposure-duration control result authorized for physical integration.");
+    }
+    const durationSeconds = requirePositiveSeconds(resolution.durationSeconds, "resolution.durationSeconds");
+    if (resolution.shutterMechanismInferred !==
+        false ||
+        resolution
+            .exposureBoundaryTopologyInferred !==
+            false ||
+        resolution.tripodSupportInferred !==
+            false ||
+        resolution
+            .stabilizationStateInferred !==
+            false ||
+        resolution
+            .longExposureNoiseReductionInferred !==
+            false ||
+        resolution
+            .sensorTemperatureBehaviorInferred !==
+            false) {
+        throw new InvalidScientificInputError("Resolved exposure duration must not carry inferred downstream camera/long-exposure state.");
+    }
+    return {
+        ...input.exposureWindowInput,
+        nominalExposureDurationSeconds: {
+            value: durationSeconds,
+            unit: "s",
+            evidence: parseEvidenceList(input.durationEvidence, "durationEvidence")
+        }
+    };
+}
+//# sourceMappingURL=exposure-duration-control.js.map

package/dist/exposure/exposure-duration-control.js.map

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