@photivra/engine 1.5.0 → 2.0.0

package/dist/capture/focus-control.js

@@ -1,17 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary. Focus is a
- * longitudinal plane or explicit infinity state, never a screen-space distance. The ideal actuator
- * resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring scale or
- * acquisition latency. Target loss, reacquisition, focus lock and release priority remain separate
- * state transitions.
- * Create the initial ideal focus-controller state from an explicit profile, focus plane and public
- * state identity. Focus is a longitudinal plane or explicit infinity state, never a screen-space
- * distance. The ideal actuator resolves supplied target observations; it does not infer a commercial
- * AF sensor, focus-ring scale or acquisition latency. Target loss, reacquisition, focus lock and
- * release priority remain separate state transitions.
+ * Focus control: manual focus (MF), single autofocus (AF-S) and continuous autofocus (AF-C), focus
+ * lock, and the focus-priority or release-priority check before the shutter fires.
+ *
+ * Focus is always a distance along the optical axis (a focus plane) or infinity, never a distance
+ * on screen. The focus "actuator" is ideal: it focuses on the target observations it is given. It
+ * does not model a real AF sensor, a focus-ring scale or how long focusing takes. Losing a target,
+ * reacquiring it, locking focus and the release-priority decision are separate state changes.
  * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support
  * limits.
  */
@@ -19,6 +14,7 @@ import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError } from "../core/validation.js";
 import { parseFocusPlane } from "../optics/focus-state.js";
+import { requireInputObject, requireInputKeys, rejectUnknownFields } from "../core/record-validation.js";
 export const FOCUS_CONTROL_PROFILE_SCHEMA_VERSION = "0.1.0";
 export const FOCUS_CONTROL_STATE_VERSION = "0.1.0";
 const FOCUS_MODES = new Set([
@@ -37,12 +33,14 @@ const TARGET_LOSS_REASONS = new Set([
     "identity-lost",
     "outside-focus-area"
 ]);
-function requireRecord(value, path) {
+function requireRecord(value, path, allowedKeys) {
     if (typeof value !== "object" ||
         value === null ||
         Array.isArray(value)) {
         throw new InvalidConfigurationError(path + " must be an object.");
     }
+    if (allowedKeys !== null)
+        rejectUnknownFields(value, allowedKeys, path);
     return value;
 }
 function requireNonEmptyString(value, path) {
@@ -56,7 +54,7 @@ function requireNonEmptyString(value, path) {
 function requireScientificNonEmptyString(value, path) {
     if (typeof value !== "string" ||
         value.trim().length === 0) {
-        throw new InvalidScientificInputError(path +
+        throw new InvalidConfigurationError(path +
             " must be a non-empty string.");
     }
     return value.trim();
@@ -119,20 +117,19 @@ function parseUniqueEnumList(value, path, allowed) {
     return parsed;
 }
 /**
- * Validate an untrusted declaration and return the normalized typed contract. Unknown enum values,
- * missing required fields and incompatible scientific data fail at this boundary.
+ * Validates an untrusted focus-control profile and returns it normalized. Unknown enum values,
+ * missing required fields and inconsistent scientific data are rejected.
  *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param value - unknown. Treated as untrusted data; static typing alone is not validation.
- * @returns FocusControlProfile. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Focus is a distance along the optical axis or infinity, never a distance on screen. The ideal
+ * actuator focuses on the target observations it is given. It does not model a real AF sensor, a
+ * focus-ring scale or focusing time.
+ * @param value - Untrusted data. TypeScript types alone are not validation.
+ * @returns The validated profile. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function parseFocusControlProfile(value) {
-    const record = requireRecord(value, "focusControlProfile");
+    const record = requireRecord(value, "focusControlProfile", ["schemaVersion", "scientificStatus", "actuator", "continuousTargetLossPolicy", "profileId", "profileVersion", "supportedModes", "supportedReleasePriorities", "evidence", "limitations"]);
     if (record.schemaVersion !==
         FOCUS_CONTROL_PROFILE_SCHEMA_VERSION) {
         throw new InvalidConfigurationError('focusControlProfile.schemaVersion must be "' +
@@ -143,7 +140,7 @@ export function parseFocusControlProfile(value) {
         "approximation") {
         throw new InvalidConfigurationError('focusControlProfile.scientificStatus must be "approximation".');
     }
-    const actuator = requireRecord(record.actuator, "focusControlProfile.actuator");
+    const actuator = requireRecord(record.actuator, "focusControlProfile.actuator", ["kind", "evidence"]);
     if (actuator.kind !==
         "ideal-instantaneous") {
         throw new InvalidConfigurationError('focusControlProfile.actuator.kind must be "ideal-instantaneous" in schema 0.1.0.');
@@ -264,19 +261,15 @@ function verifyStateProfile(state, profile) {
     }
 }
 /**
- * Create the initial ideal focus-controller state from an explicit profile, focus plane and public
- * state identity.
- *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - CreateFocusControlStateInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusControlState. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Creates the initial ideal focus-controller state from a profile, a focus plane and a public
+ * state ID.
+ * @param input - New state ID, profile, focus mode, initial focus plane and optional start time.
+ * @returns The initial state. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function createFocusControlState(input) {
+    requireInputKeys(input, "createFocusControlState", ["stateId", "profile", "mode", "initialFocus", "initialTimeSeconds"]);
     const profile = parseFocusControlProfile(input.profile);
     requireSupportedMode(profile, input.mode);
     const time = input.initialTimeSeconds ===
@@ -312,19 +305,16 @@ function stateProfileView(state) {
     };
 }
 /**
- * Return a manual focus transition to the supplied finite/infinity plane without inventing a lens
- * actuator or focus-ring conversion.
+ * Returns the state after manually focusing on the given finite or infinity plane. No lens
+ * actuator or focus-ring conversion is modelled.
+ * @param input - Current state, new state ID, new focus plane and event time.
+ * @returns The new state. Success does not imply calibration.
  *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - SetManualFocusStateInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusControlState. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
- *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function setManualFocusState(input) {
+    requireInputKeys(input, "setManualFocusState", ["state", "stateId", "focus", "eventTimeSeconds", "commandId"]);
+    requireInputObject(input.state, "state");
     if (input.state.mode !==
         "manual") {
         throw new InvalidScientificInputError("setManualFocusState requires manual focus mode.");
@@ -393,7 +383,7 @@ function parseObservation(observation) {
             reason: observation.reason
         };
     }
-    throw new InvalidScientificInputError("observation.kind/reason is invalid.");
+    throw new InvalidConfigurationError("observation.kind/reason is invalid.");
 }
 function focusFromObservation(observation) {
     if (observation.kind ===
@@ -444,22 +434,21 @@ function unchangedResolution(input) {
     };
 }
 /**
- * Resolve an explicit available/lost target observation under the selected single/continuous AF
- * policy, retaining acquisition and reacquisition disposition.
+ * Applies one target observation (target available or lost) under the selected AF-S or AF-C
+ * policy, and records whether the target was acquired or reacquired.
  *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - ResolveFocusTargetObservationInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusTargetResolution. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * The ideal actuator focuses on the observation as given. Target loss, reacquisition, focus
+ * lock and release priority are separate state changes.
+ * @param input - Current state, new state ID, control event and target observation.
+ * @returns The resolution and new state. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function resolveFocusTargetObservation(input) {
+    requireInputKeys(input, "resolveFocusTargetObservation", ["state", "stateId", "event", "observation"]);
     if (input.event !== "acquire" &&
         input.event !== "update") {
-        throw new InvalidScientificInputError('Focus target event must be "acquire" or "update".');
+        throw new InvalidConfigurationError('Focus target event must be "acquire" or "update".');
     }
     if (input.state.mode ===
         "manual") {
@@ -535,18 +524,14 @@ export function resolveFocusTargetObservation(input) {
     return stateFromResolvedTarget(input, observation);
 }
 /**
- * Return an explicit lock/unlock transition without changing the underlying physical focus plane.
- *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - SetFocusLockInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusControlState. Return shape and scientific status are explicit; no calibration is inferred from successful execution.
+ * Locks or unlocks focus. The physical focus plane does not change.
+ * @param input - Current state, new state ID, lock setting and event time.
+ * @returns The new state. Success does not imply calibration.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function setFocusLock(input) {
+    requireInputKeys(input, "setFocusLock", ["state", "stateId", "locked", "eventTimeSeconds"]);
     const time = requireMonotonicEventTime(input.state, input.eventTimeSeconds);
     if (input.locked) {
         if (input.state.locked) {
@@ -575,19 +560,15 @@ export function setFocusLock(input) {
         .activeFocusAreaId);
 }
 /**
- * Report whether release may proceed under focus-priority or release-priority policy; this does not
- * operate a shutter.
- *
- * Focus is a longitudinal plane or explicit infinity state, never a screen-space distance. The ideal
- * actuator resolves supplied target observations; it does not infer a commercial AF sensor, focus-ring
- * scale or acquisition latency. Target loss, reacquisition, focus lock and release priority remain
- * separate state transitions.
- * @param input - AssessFocusReleaseGateInput. See the linked contract for coordinate, unit and profile binding semantics.
- * @returns FocusReleaseGateAssessment. Read structured blockers before consuming an authorization.
+ * Reports whether the shutter may be released under the focus-priority or release-priority
+ * policy. It does not operate the shutter.
+ * @param input - Current state, profile and release priority.
+ * @returns The assessment. Read its structured blockers before acting on an authorization.
  *
- * @see docs/API_REFERENCE.md for the root export and exact type graph.
+ * @see docs/API_REFERENCE.md for the package export and its full type definitions.
  */
 export function assessFocusReleaseGate(input) {
+    requireInputKeys(input, "assessFocusReleaseGate", ["state", "profile", "priority"]);
     const profile = parseFocusControlProfile(input.profile);
     verifyStateProfile(input.state, profile);
     if (!profile

package/dist/capture/focus-control.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus-control.js","sourceRoot":"","sources":["../../src/capture/focus-control.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,eAAe,EAEhB,MAAM,0BAA0B,CAAC;AAIlC,MAAM,CAAC,MAAM,oCAAoC,GAC/C,OAAgB,CAAC;AACnB,MAAM,CAAC,MAAM,2BAA2B,GACtC,OAAgB,CAAC;AA+MnB,MAAM,WAAW,GACf,IAAI,GAAG,CAAmB;IACxB,QAAQ;IACR,WAAW;IACX,eAAe;CAChB,CAAC,CAAC;AAEL,MAAM,kBAAkB,GACtB,IAAI,GAAG,CAAuB;IAC5B,gBAAgB;IAChB,kBAAkB;IAClB,UAAU;CACX,CAAC,CAAC;AAEL,MAAM,mBAAmB,GACvB,IAAI,GAAG,CAAwB;IAC7B,UAAU;IACV,cAAc;IACd,eAAe;IACf,oBAAoB;CACrB,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;YACF,8BAA8B,CACjC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,+BAA+B,CACtC,KAAa,EACb,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EACzB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,IAAI;YACF,8BAA8B,CACjC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,kCAAkC,CACzC,KAAa,EACb,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,GAAG,CAAC,EACT,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,IAAI;YACF,oDAAoD,CACvD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,+BAA+B,CACtC,KAAa,EACb,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC,EACV,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,IAAI;YACF,wCAAwC,CAC3C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,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,CACzB,qBAAqB,CACnB,KAAK,EACL,IAAI;QACF,GAAG;QACH,KAAK;QACL,GAAG,CACN,CACF,CAAC;IACJ,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,mBAAmB,CAC1B,KAAc,EACd,IAAY,EACZ,OAAuB;IAEvB,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;YACV,QAAQ;YACV,CAAC,OAAO,CAAC,GAAG,CAAC,KAAU,CAAC,EACxB,CAAC;YACD,MAAM,IAAI,yBAAyB,CACjC,IAAI;gBACF,GAAG;gBACH,KAAK;gBACL,eAAe,CAClB,CAAC;QACJ,CAAC;QACD,OAAO,KAAU,CAAC;IACpB,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;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAc;IAEd,MAAM,MAAM,GACV,aAAa,CACX,KAAK,EACL,qBAAqB,CACtB,CAAC;IAEJ,IACE,MAAM,CAAC,aAAa;QACpB,oCAAoC,EACpC,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,6CAA6C;YAC3C,oCAAoC;YACpC,IAAI,CACP,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,gBAAgB;QACvB,eAAe,EACf,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,+DAA+D,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GACZ,aAAa,CACX,MAAM,CAAC,QAAQ,EACf,8BAA8B,CAC/B,CAAC;IACJ,IACE,QAAQ,CAAC,IAAI;QACb,qBAAqB,EACrB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,kFAAkF,CACnF,CAAC;IACJ,CAAC;IACD,IACE,MAAM;SACH,0BAA0B;QAC7B,gDAAgD,EAChD,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IAED,OAAO;QACL,aAAa,EACX,oCAAoC;QACtC,SAAS,EACP,qBAAqB,CACnB,MAAM,CAAC,SAAS,EAChB,+BAA+B,CAChC;QACH,cAAc,EACZ,qBAAqB,CACnB,MAAM,CAAC,cAAc,EACrB,oCAAoC,CACrC;QACH,gBAAgB,EACd,eAAe;QACjB,cAAc,EACZ,mBAAmB,CACjB,MAAM,CAAC,cAAc,EACrB,oCAAoC,EACpC,WAAW,CACZ;QACH,QAAQ,EAAE;YACR,IAAI,EACF,qBAAqB;YACvB,QAAQ,EACN,iBAAiB,CACf,QAAQ,CAAC,QAAQ,EACjB,uCAAuC,CACxC;SACJ;QACD,0BAA0B,EACxB,gDAAgD;QAClD,0BAA0B,EACxB,mBAAmB,CACjB,MAAM;aACH,0BAA0B,EAC7B,gDAAgD,EAChD,kBAAkB,CACnB;QACH,QAAQ,EACN,iBAAiB,CACf,MAAM,CAAC,QAAQ,EACf,8BAA8B,CAC/B;QACH,WAAW,EACT,gBAAgB,CACd,MAAM,CAAC,WAAW,EAClB,iCAAiC,CAClC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,KAAQ;IAER,OAAO,IAAI,CAAC,KAAK,CACf,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CACjB,CAAC;AACT,CAAC;AAED,SAAS,UAAU,CACjB,KAAQ;IAER,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,KACE,MAAM,KAAK,IACX,MAAM,CAAC,MAAM,CACX,KAAsB,CACvB,EACD,CAAC;QACD,UAAU,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CACrB,KACmB;IAEnB,OAAO,UAAU,CACf,SAAS,CAAC,KAAK,CAAC,CACjB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,OAAe,EACf,OACqB,EACrB,IACkB,EAClB,KACY,EACZ,gBACuB,EACvB,gBAAwB,EACxB,sBACQ,EACR,cACQ,EACR,iBACQ,EACR,IAC2B;IAE3B,OAAO,cAAc,CAAC;QACpB,OAAO,EACL,2BAA2B;QAC7B,OAAO,EACL,+BAA+B,CAC7B,OAAO,EACP,SAAS,CACV;QACH,aAAa,EAAE;YACb,SAAS,EACP,OAAO,CAAC,SAAS;YACnB,cAAc,EACZ,OAAO,CAAC,cAAc;SACzB;QACD,kBAAkB,EAAE;YAClB,GAAG,OAAO,CAAC,WAAW;SACvB;QACD,IAAI;QACJ,gBAAgB;QAChB,KAAK,EACH,eAAe,CAAC,KAAK,CAAC;QACxB,GAAG,CAAC,cAAc;YAClB,SAAS;YACP,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,cAAc;aACf,CAAC;QACN,GAAG,CAAC,iBAAiB;YACrB,SAAS;YACP,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,iBAAiB;aAClB,CAAC;QACN,oBAAoB,EAClB,gBAAgB;QAClB,sBAAsB;QACtB,MAAM,EACJ,gBAAgB;YAChB,QAAQ;QACV,GAAG,CAAC,IAAI,KAAK,SAAS;YACpB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,IAAI;aACL,CAAC;QACN,aAAa,EACX,qBAAqB;QACvB,0BAA0B,EACxB,OAAO;aACJ,0BAA0B;QAC/B,gBAAgB,EAAE,KAAK;QACvB,gBAAgB,EAAE,KAAK;QACvB,oBAAoB,EAClB,KAAK;QACP,iCAAiC,EAC/B,KAAK;QACP,2BAA2B,EACzB,KAAK;QACP,WAAW,EAAE;YACX,GAAG,OAAO,CAAC,WAAW;YACtB,sGAAsG;YACtG,yJAAyJ;YACzJ,yFAAyF;SAC1F;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAC3B,OACqB,EACrB,IACkB;IAElB,IACE,CAAC,OAAO,CAAC,cAAc;SACpB,QAAQ,CAAC,IAAI,CAAC,EACjB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,8DAA8D,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAChC,OACmB,EACnB,gBAAwB;IAExB,MAAM,MAAM,GACV,kCAAkC,CAChC,gBAAgB,EAChB,kBAAkB,CACnB,CAAC;IACJ,IACE,MAAM;QACN,OAAO,CAAC,oBAAoB,EAC5B,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,kDAAkD,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CACzB,KACmB,EACnB,OACqB;IAErB,IACE,KAAK,CAAC,aAAa;SAChB,SAAS;QACV,OAAO,CAAC,SAAS;QACnB,KAAK,CAAC,aAAa;aAChB,cAAc;YACf,OAAO,CAAC,cAAc,EACxB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,sDAAsD,CACvD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAC8B;IAE9B,MAAM,OAAO,GACX,wBAAwB,CACtB,KAAK,CAAC,OAAO,CACd,CAAC;IACJ,oBAAoB,CAClB,OAAO,EACP,KAAK,CAAC,IAAI,CACX,CAAC;IACF,MAAM,IAAI,GACR,KAAK,CAAC,kBAAkB;QACxB,SAAS;QACP,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,kCAAkC,CAChC,KAAK,CAAC,kBAAkB,EACxB,oBAAoB,CACrB,CAAC;IAER,OAAO,SAAS,CACd,KAAK,CAAC,OAAO,EACb,OAAO,EACP,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,YAAY,EAClB,MAAM,EACN,IAAI,EACJ,IAAI,CACL,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,KACmB;IAEnB,OAAO;QACL,aAAa,EACX,oCAAoC;QACtC,SAAS,EACP,KAAK,CAAC,aAAa;aAChB,SAAS;QACd,cAAc,EACZ,KAAK,CAAC,aAAa;aAChB,cAAc;QACnB,gBAAgB,EACd,eAAe;QACjB,cAAc,EAAE;YACd,KAAK,CAAC,IAAI;SACX;QACD,QAAQ,EAAE;YACR,IAAI,EACF,qBAAqB;YACvB,QAAQ,EAAE,EAAE;SACb;QACD,0BAA0B,EACxB,KAAK;aACF,0BAA0B;QAC/B,0BAA0B,EAAE;YAC1B,gBAAgB;YAChB,kBAAkB;YAClB,UAAU;SACX;QACD,QAAQ,EAAE,EAAE;QACZ,WAAW,EACT,KAAK,CAAC,kBAAkB;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAC0B;IAE1B,IACE,KAAK,CAAC,KAAK,CAAC,IAAI;QAChB,QAAQ,EACR,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,iDAAiD,CAClD,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,2BAA2B,CACnC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,IACE,KAAK,CAAC,SAAS;QACf,SAAS,EACT,CAAC;QACD,+BAA+B,CAC7B,KAAK,CAAC,SAAS,EACf,WAAW,CACZ,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GACR,yBAAyB,CACvB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,gBAAgB,CACvB,CAAC;IAEJ,OAAO,SAAS,CACd,KAAK,CAAC,OAAO,EACb,gBAAgB,CACd,KAAK,CAAC,KAAK,CACZ,EACD,QAAQ,EACR,KAAK,CAAC,KAAK,EACX,MAAM,EACN,IAAI,EACJ,IAAI,CACL,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,WACwB;IAExB,MAAM,QAAQ,GACZ,+BAA+B,CAC7B,WAAW,CAAC,QAAQ,EACpB,sBAAsB,CACvB,CAAC;IACJ,MAAM,iBAAiB,GACrB,kCAAkC,CAChC,WAAW;SACR,iBAAiB,EACpB,+BAA+B,CAChC,CAAC;IACJ,MAAM,WAAW,GACf,WAAW,CAAC,WAAW;QACvB,SAAS;QACP,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,+BAA+B,CAC7B,WAAW,CAAC,WAAW,EACvB,yBAAyB,CAC1B,CAAC;IAER,IACE,WAAW,CAAC,IAAI;QAChB,gBAAgB,EAChB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,QAAQ;YACR,GAAG,CAAC,WAAW;gBACf,SAAS;gBACP,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,WAAW;iBACZ,CAAC;YACN,iBAAiB;YACjB,qBAAqB,EACnB,+BAA+B,CAC7B,WAAW;iBACR,qBAAqB,EACxB,mCAAmC,CACpC;SACJ,CAAC;IACJ,CAAC;IAED,IACE,WAAW,CAAC,IAAI;QAChB,sBAAsB,EACtB,CAAC;QACD,OAAO;YACL,IAAI,EACF,sBAAsB;YACxB,QAAQ;YACR,GAAG,CAAC,WAAW;gBACf,SAAS;gBACP,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,WAAW;iBACZ,CAAC;YACN,iBAAiB;SAClB,CAAC;IACJ,CAAC;IAED,IACE,WAAW,CAAC,IAAI;QACd,aAAa;QACf,mBAAmB,CAAC,GAAG,CACrB,WAAW,CAAC,MAAM,CACnB,EACD,CAAC;QACD,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,QAAQ;YACR,GAAG,CAAC,WAAW;gBACf,SAAS;gBACP,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,WAAW;iBACZ,CAAC;YACN,iBAAiB;YACjB,MAAM,EACJ,WAAW,CAAC,MAAM;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,2BAA2B,CACnC,qCAAqC,CACtC,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,WAMG;IAEH,IACE,WAAW,CAAC,IAAI;QAChB,sBAAsB,EACtB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,UAAU;SACjB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,SAAS,EACP,WAAW;aACR,qBAAqB;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,CAAa,EACb,CAAa;IAEb,IACE,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EACjB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IACE,CAAC,CAAC,IAAI,KAAK,UAAU;QACrB,CAAC,CAAC,IAAI,KAAK,UAAU,EACrB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,SAAS,CACZ,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,KACoC,EACpC,WAMG;IAEH,MAAM,KAAK,GACT,oBAAoB,CAClB,WAAW,CACZ,CAAC;IACJ,MAAM,KAAK,GACT,SAAS,CACP,KAAK,CAAC,OAAO,EACb,gBAAgB,CACd,KAAK,CAAC,KAAK,CACZ,EACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAChB,KAAK,EACL,UAAU,EACV,WAAW;SACR,iBAAiB,EACpB,WAAW;SACR,iBAAiB,EACpB,WAAW,CAAC,QAAQ,EACpB,WAAW,CAAC,WAAW,CACxB,CAAC;IACJ,OAAO;QACL,KAAK;QACL,wBAAwB,EACtB,IAAI;QACN,YAAY,EACV,CAAC,WAAW,CACV,KAAK,CAAC,KAAK,CAAC,KAAK,EACjB,KAAK,CACN;QACH,gBAAgB,EACd,KAAK,CAAC,KAAK;QACb,aAAa,EACX,qBAAqB;QACvB,0BAA0B,EACxB,KAAK;KACR,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,KACoC;IAEpC,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,wBAAwB,EACtB,KAAK;QACP,YAAY,EAAE,KAAK;QACnB,gBAAgB,EACd,KAAK,CAAC,KAAK;QACb,aAAa,EACX,qBAAqB;QACvB,0BAA0B,EACxB,KAAK;KACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KACoC;IAEpC,IACE,KAAK,CAAC,KAAK,KAAK,SAAS;QACzB,KAAK,CAAC,KAAK,KAAK,QAAQ,EACxB,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,mDAAmD,CACpD,CAAC;IACJ,CAAC;IACD,IACE,KAAK,CAAC,KAAK,CAAC,IAAI;QAChB,QAAQ,EACR,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GACf,gBAAgB,CACd,KAAK,CAAC,WAAW,CAClB,CAAC;IACJ,yBAAyB,CACvB,KAAK,CAAC,KAAK,EACX,WAAW;SACR,iBAAiB,CACrB,CAAC;IAEF,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,mBAAmB,CACxB,KAAK,CACN,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,KAAK,CAAC,IAAI;QAChB,WAAW,EACX,CAAC;QACD,IACE,KAAK,CAAC,KAAK;YACT,QAAQ;YACV,KAAK,CAAC,KAAK;iBACR,gBAAgB;gBACjB,UAAU,EACZ,CAAC;YACD,OAAO,mBAAmB,CACxB,KAAK,CACN,CAAC;QACJ,CAAC;QACD,IACE,KAAK,CAAC,KAAK;YACX,SAAS,EACT,CAAC;YACD,MAAM,IAAI,2BAA2B,CACnC,qEAAqE,CACtE,CAAC;QACJ,CAAC;QACD,IACE,WAAW,CAAC,IAAI;YAChB,aAAa,EACb,CAAC;YACD,MAAM,KAAK,GACT,SAAS,CACP,KAAK,CAAC,OAAO,EACb,gBAAgB,CACd,KAAK,CAAC,KAAK,CACZ,EACD,WAAW,EACX,KAAK,CAAC,KAAK,CAAC,KAAK,EACjB,aAAa,EACb,WAAW;iBACR,iBAAiB,EACpB,KAAK,CAAC,KAAK;iBACR,sBAAsB,EACzB,WAAW,CAAC,QAAQ,EACpB,WAAW,CAAC,WAAW,CACxB,CAAC;YACJ,OAAO;gBACL,KAAK;gBACL,wBAAwB,EACtB,IAAI;gBACN,YAAY,EAAE,KAAK;gBACnB,gBAAgB,EACd,KAAK,CAAC,KAAK;gBACb,aAAa,EACX,qBAAqB;gBACvB,0BAA0B,EACxB,KAAK;aACR,CAAC;QACJ,CAAC;QACD,OAAO,uBAAuB,CAC5B,KAAK,EACL,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,KAAK;QACX,QAAQ,EACR,CAAC;QACD,IACE,KAAK,CAAC,KAAK;aACR,cAAc;YACjB,SAAS,EACT,CAAC;YACD,MAAM,IAAI,2BAA2B,CACnC,kEAAkE,CACnE,CAAC;QACJ,CAAC;QACD,IACE,WAAW,CAAC,QAAQ;YACpB,KAAK,CAAC,KAAK;iBACR,cAAc,EACjB,CAAC;YACD,MAAM,IAAI,2BAA2B,CACnC,kGAAkG,CACnG,CAAC;QACJ,CAAC;QACD,IACE,KAAK,CAAC,KAAK;aACR,gBAAgB;YACnB,aAAa,EACb,CAAC;YACD,MAAM,IAAI,2BAA2B,CACnC,oFAAoF,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IACE,WAAW,CAAC,IAAI;QAChB,aAAa,EACb,CAAC;QACD,MAAM,KAAK,GACT,SAAS,CACP,KAAK,CAAC,OAAO,EACb,gBAAgB,CACd,KAAK,CAAC,KAAK,CACZ,EACD,eAAe,EACf,KAAK,CAAC,KAAK,CAAC,KAAK,EACjB,aAAa,EACb,WAAW;aACR,iBAAiB,EACpB,KAAK,CAAC,KAAK;aACR,sBAAsB,EACzB,WAAW,CAAC,QAAQ,EACpB,WAAW,CAAC,WAAW,CACxB,CAAC;QACJ,OAAO;YACL,KAAK;YACL,wBAAwB,EACtB,IAAI;YACN,YAAY,EAAE,KAAK;YACnB,gBAAgB,EACd,KAAK,CAAC,KAAK;YACb,aAAa,EACX,qBAAqB;YACvB,0BAA0B,EACxB,KAAK;SACR,CAAC;IACJ,CAAC;IAED,OAAO,uBAAuB,CAC5B,KAAK,EACL,WAAW,CACZ,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAC1B,KACmB;IAEnB,MAAM,IAAI,GACR,yBAAyB,CACvB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,gBAAgB,CACvB,CAAC;IAEJ,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,SAAS,CACd,KAAK,CAAC,OAAO,EACb,gBAAgB,CACd,KAAK,CAAC,KAAK,CACZ,EACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAChB,KAAK,CAAC,KAAK,CAAC,KAAK,EACjB,QAAQ,EACR,IAAI,EACJ,KAAK,CAAC,KAAK;aACR,sBAAsB,EACzB,KAAK,CAAC,KAAK;aACR,cAAc,EACjB,KAAK,CAAC,KAAK;aACR,iBAAiB,EACpB;YACE,eAAe,EACb,IAAI;YACN,sBAAsB,EACpB,KAAK,CAAC,KAAK;iBACR,gBAGA;SACN,CACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GACV,KAAK,CAAC,KAAK,CAAC,IAAI;QACd,EAAE,sBAAsB,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,2BAA2B,CACnC,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CACd,KAAK,CAAC,OAAO,EACb,gBAAgB,CACd,KAAK,CAAC,KAAK,CACZ,EACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAChB,KAAK,CAAC,KAAK,CAAC,KAAK,EACjB,MAAM,EACN,IAAI,EACJ,KAAK,CAAC,KAAK;SACR,sBAAsB,EACzB,KAAK,CAAC,KAAK;SACR,cAAc,EACjB,KAAK,CAAC,KAAK;SACR,iBAAiB,CACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAC6B;IAE7B,MAAM,OAAO,GACX,wBAAwB,CACtB,KAAK,CAAC,OAAO,CACd,CAAC;IACJ,kBAAkB,CAChB,KAAK,CAAC,KAAK,EACX,OAAO,CACR,CAAC;IAEF,IACE,CAAC,OAAO;SACL,0BAA0B;SAC1B,QAAQ,CACP,KAAK,CAAC,QAAQ,CACf,EACH,CAAC;QACD,MAAM,IAAI,2BAA2B,CACnC,kEAAkE,CACnE,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,QAAQ;QACd,kBAAkB,EAClB,CAAC;QACD,OAAO;YACL,QAAQ,EACN,KAAK,CAAC,QAAQ;YAChB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EACJ,sCAAsC;YACxC,qCAAqC,EACnC,KAAK;YACP,oBAAoB,EAClB,KAAK;YACP,gBAAgB,EACd,KAAK;SACR,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,QAAQ;QACd,UAAU,EACV,CAAC;QACD,OAAO;YACL,QAAQ,EACN,KAAK,CAAC,QAAQ;YAChB,iBAAiB,EACf,KAAK;YACP,MAAM,EACJ,6BAA6B;YAC/B,qCAAqC,EACnC,IAAI;YACN,oBAAoB,EAClB,KAAK;YACP,gBAAgB,EACd,KAAK;SACR,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,KAAK,CAAC,IAAI;QAChB,QAAQ,EACR,CAAC;QACD,OAAO;YACL,QAAQ,EACN,KAAK,CAAC,QAAQ;YAChB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EACJ,oBAAoB;YACtB,qCAAqC,EACnC,KAAK;YACP,oBAAoB,EAClB,KAAK;YACP,gBAAgB,EACd,KAAK;SACR,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,KAAK;SACR,gBAAgB;QACnB,QAAQ,EACR,CAAC;QACD,OAAO;YACL,QAAQ,EACN,KAAK,CAAC,QAAQ;YAChB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EACJ,cAAc;YAChB,qCAAqC,EACnC,KAAK;YACP,oBAAoB,EAClB,KAAK;YACP,gBAAgB,EACd,KAAK;SACR,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,KAAK;SACR,gBAAgB;QACnB,UAAU,EACV,CAAC;QACD,OAAO;YACL,QAAQ,EACN,KAAK,CAAC,QAAQ;YAChB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EACJ,gBAAgB;YAClB,qCAAqC,EACnC,KAAK;YACP,oBAAoB,EAClB,KAAK;YACP,gBAAgB,EACd,KAAK;SACR,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EACN,KAAK,CAAC,QAAQ;QAChB,iBAAiB,EAAE,KAAK;QACxB,MAAM,EACJ,oBAAoB;QACtB,qCAAqC,EACnC,KAAK;QACP,oBAAoB,EAClB,KAAK;QACP,gBAAgB,EACd,KAAK;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"focus-control.js","sourceRoot":"","sources":["../../src/capture/focus-control.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Focus control: manual focus (MF), single autofocus (AF-S) and continuous autofocus (AF-C), focus\n * lock, and the focus-priority or release-priority check before the shutter fires.\n *\n * Focus is always a distance along the optical axis (a focus plane) or infinity, never a distance\n * on screen. The focus \"actuator\" is ideal: it focuses on the target observations it is given. It\n * does not model a real AF sensor, a focus-ring scale or how long focusing takes. Losing a target,\n * reacquiring it, locking focus and the release-priority decision are separate state changes.\n * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceProvenance\n} from \"../core/evidence-provenance.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  parseFocusPlane,\n  type FocusPlane\n} from \"../optics/focus-state.js\";\nimport { requireInputObject, requireInputKeys, rejectUnknownFields } from \"../core/record-validation.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport const FOCUS_CONTROL_PROFILE_SCHEMA_VERSION =\n  \"0.1.0\" as const;\nexport const FOCUS_CONTROL_STATE_VERSION =\n  \"0.1.0\" as const;\n\nexport type FocusControlMode =\n  | \"manual\"\n  | \"single-af\"\n  | \"continuous-af\";\n\nexport type FocusAcquisitionState =\n  | \"idle\"\n  | \"acquiring\"\n  | \"acquired\"\n  | \"target-lost\"\n  | \"locked\";\n\nexport type FocusReleasePriority =\n  | \"focus-priority\"\n  | \"release-priority\"\n  | \"balanced\";\n\nexport type FocusTargetLossReason =\n  | \"occluded\"\n  | \"out-of-frame\"\n  | \"identity-lost\"\n  | \"outside-focus-area\";\n\nexport interface FocusControlProfile {\n  schemaVersion:\n    typeof FOCUS_CONTROL_PROFILE_SCHEMA_VERSION;\n  profileId: string;\n  profileVersion: string;\n  scientificStatus: \"approximation\";\n  supportedModes:\n    readonly FocusControlMode[];\n  actuator: {\n    kind: \"ideal-instantaneous\";\n    evidence:\n      readonly EvidenceProvenance[];\n  };\n  continuousTargetLossPolicy:\n    \"hold-last-focus-require-explicit-reacquisition\";\n  supportedReleasePriorities:\n    readonly FocusReleasePriority[];\n  evidence:\n    readonly EvidenceProvenance[];\n  limitations: readonly string[];\n}\n\ninterface FocusTargetObservationBase {\n  targetId: string;\n  focusAreaId?: string;\n  observedAtSeconds: number;\n}\n\nexport type FocusTargetObservation =\n  | (FocusTargetObservationBase & {\n      kind: \"finite-surface\";\n      /**\n       * Distance along the camera's optical axis (the same convention as\n       * FocusPlane), not the renderer's ray length to the point.\n       */\n      longitudinalDistanceM: number;\n    })\n  | (FocusTargetObservationBase & {\n      kind:\n        \"infinity-environment\";\n    })\n  | (FocusTargetObservationBase & {\n      kind: \"unavailable\";\n      reason:\n        FocusTargetLossReason;\n    });\n\n/**\n * Immutable focus-controller state for MF, AF-S or AF-C.\n *\n * The resolved focus is a finite distance along the optical axis in metres, or infinity.\n * Acquisition, loss, reacquisition and lock records explain why a target can be used. The\n * focus-release check is separate from shutter sequencing. The ideal actuator does not model\n * real AF accuracy or the physical time focusing takes.\n */\nexport interface FocusControlState {\n  version:\n    typeof FOCUS_CONTROL_STATE_VERSION;\n  stateId: string;\n  sourceProfile: {\n    profileId: string;\n    profileVersion: string;\n  };\n  profileLimitations:\n    readonly string[];\n  mode:\n    FocusControlMode;\n  acquisitionState:\n    FocusAcquisitionState;\n  focus:\n    FocusPlane;\n  activeTargetId?: string;\n  activeFocusAreaId?: string;\n  lastEventTimeSeconds: number;\n  focusResolvedAtSeconds:\n    number;\n  locked: boolean;\n  lock?: {\n    lockedAtSeconds: number;\n    resumeAcquisitionState:\n      Exclude<\n        FocusAcquisitionState,\n        \"locked\"\n      >;\n  };\n  actuatorModel:\n    \"ideal-instantaneous\";\n  continuousTargetLossPolicy:\n    \"hold-last-focus-require-explicit-reacquisition\";\n  exposureModified: false;\n  meteringModified: false;\n  whiteBalanceModified: false;\n  subjectTrackingRecognitionModeled:\n    false;\n  rendererCoordinatesConsumed:\n    false;\n  limitations:\n    readonly string[];\n}\n\nexport interface CreateFocusControlStateInput {\n  stateId: string;\n  profile:\n    FocusControlProfile;\n  mode:\n    FocusControlMode;\n  initialFocus:\n    FocusPlane;\n  initialTimeSeconds?: number;\n}\n\nexport interface SetManualFocusStateInput {\n  state:\n    FocusControlState;\n  stateId: string;\n  focus:\n    FocusPlane;\n  eventTimeSeconds: number;\n  commandId?: string;\n}\n\nexport type FocusTargetControlEvent =\n  | \"acquire\"\n  | \"update\";\n\nexport interface ResolveFocusTargetObservationInput {\n  state:\n    FocusControlState;\n  stateId: string;\n  event:\n    FocusTargetControlEvent;\n  observation:\n    FocusTargetObservation;\n}\n\nexport interface FocusTargetResolution {\n  state:\n    FocusControlState;\n  targetObservationApplied:\n    boolean;\n  focusChanged: boolean;\n  acquisitionEvent:\n    FocusTargetControlEvent;\n  actuatorModel:\n    \"ideal-instantaneous\";\n  silentRetargetingPerformed:\n    false;\n}\n\nexport interface SetFocusLockInput {\n  state:\n    FocusControlState;\n  stateId: string;\n  locked: boolean;\n  eventTimeSeconds: number;\n}\n\nexport interface AssessFocusReleaseGateInput {\n  state:\n    FocusControlState;\n  profile:\n    FocusControlProfile;\n  priority:\n    FocusReleasePriority;\n}\n\nexport interface FocusReleaseGateAssessment {\n  priority:\n    FocusReleasePriority;\n  releaseAuthorized: boolean;\n  reason:\n    | \"manual-focus-state\"\n    | \"focus-acquired\"\n    | \"focus-locked\"\n    | \"release-priority-bypasses-focus-gate\"\n    | \"focus-not-acquired\"\n    | \"balanced-policy-not-modeled\";\n  requiresProfileSpecificBalancedPolicy:\n    boolean;\n  opticalFocusModified: false;\n  exposureModified: false;\n}\n\nconst FOCUS_MODES =\n  new Set<FocusControlMode>([\n    \"manual\",\n    \"single-af\",\n    \"continuous-af\"\n  ]);\n\nconst RELEASE_PRIORITIES =\n  new Set<FocusReleasePriority>([\n    \"focus-priority\",\n    \"release-priority\",\n    \"balanced\"\n  ]);\n\nconst TARGET_LOSS_REASONS =\n  new Set<FocusTargetLossReason>([\n    \"occluded\",\n    \"out-of-frame\",\n    \"identity-lost\",\n    \"outside-focus-area\"\n  ]);\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Array.isArray(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be an object.\"\n    );\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction requireNonEmptyString(\n  value: unknown,\n  path: string\n): string {\n  if (\n    typeof value !== \"string\" ||\n    value.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be a non-empty string.\"\n    );\n  }\n  return value.trim();\n}\n\nfunction requireScientificNonEmptyString(\n  value: string,\n  path: string\n): string {\n  if (\n    typeof value !== \"string\" ||\n    value.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be a non-empty string.\"\n    );\n  }\n  return value.trim();\n}\n\nfunction requireScientificNonNegativeFinite(\n  value: number,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value) ||\n    value < 0\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be finite and greater than or equal to zero.\"\n    );\n  }\n  return value;\n}\n\nfunction requireScientificPositiveFinite(\n  value: number,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value) ||\n    value <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be finite and greater than zero.\"\n    );\n  }\n  return value;\n}\n\nfunction parseLimitations(\n  value: unknown,\n  path: string\n): readonly string[] {\n  if (!Array.isArray(value)) {\n    throw new InvalidConfigurationError(\n      path + \" must be an array.\"\n    );\n  }\n  const parsed =\n    value.map((entry, index) =>\n      requireNonEmptyString(\n        entry,\n        path +\n          \"[\" +\n          index +\n          \"]\"\n      )\n    );\n  if (\n    new Set(parsed).size !==\n    parsed.length\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must not contain duplicates.\"\n    );\n  }\n  return parsed;\n}\n\nfunction parseUniqueEnumList<T extends string>(\n  value: unknown,\n  path: string,\n  allowed: ReadonlySet<T>\n): readonly T[] {\n  if (\n    !Array.isArray(value) ||\n    value.length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be a non-empty array.\"\n    );\n  }\n  const parsed =\n    value.map((entry, index) => {\n      if (\n        typeof entry !==\n          \"string\" ||\n        !allowed.has(entry as T)\n      ) {\n        throw new InvalidConfigurationError(\n          path +\n            \"[\" +\n            index +\n            \"] is invalid.\"\n        );\n      }\n      return entry as T;\n    });\n  if (\n    new Set(parsed).size !==\n    parsed.length\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must not contain duplicates.\"\n    );\n  }\n  return parsed;\n}\n\n/**\n * Validates an untrusted focus-control profile and returns it normalized. Unknown enum values,\n * missing required fields and inconsistent scientific data are rejected.\n *\n * Focus is a distance along the optical axis or infinity, never a distance on screen. The ideal\n * actuator focuses on the target observations it is given. It does not model a real AF sensor, a\n * focus-ring scale or focusing time.\n * @param value - Untrusted data. TypeScript types alone are not validation.\n * @returns The validated profile. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function parseFocusControlProfile(\n  value: unknown\n): FocusControlProfile {\n  const record =\n    requireRecord(\n      value,\n      \"focusControlProfile\", [\"schemaVersion\", \"scientificStatus\", \"actuator\", \"continuousTargetLossPolicy\", \"profileId\", \"profileVersion\", \"supportedModes\", \"supportedReleasePriorities\", \"evidence\", \"limitations\"]\n    );\n\n  if (\n    record.schemaVersion !==\n    FOCUS_CONTROL_PROFILE_SCHEMA_VERSION\n  ) {\n    throw new InvalidConfigurationError(\n      'focusControlProfile.schemaVersion must be \"' +\n        FOCUS_CONTROL_PROFILE_SCHEMA_VERSION +\n        '\".'\n    );\n  }\n  if (\n    record.scientificStatus !==\n    \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      'focusControlProfile.scientificStatus must be \"approximation\".'\n    );\n  }\n\n  const actuator =\n    requireRecord(\n      record.actuator,\n      \"focusControlProfile.actuator\", [\"kind\", \"evidence\"]\n    );\n  if (\n    actuator.kind !==\n    \"ideal-instantaneous\"\n  ) {\n    throw new InvalidConfigurationError(\n      'focusControlProfile.actuator.kind must be \"ideal-instantaneous\" in schema 0.1.0.'\n    );\n  }\n  if (\n    record\n      .continuousTargetLossPolicy !==\n    \"hold-last-focus-require-explicit-reacquisition\"\n  ) {\n    throw new InvalidConfigurationError(\n      'focusControlProfile.continuousTargetLossPolicy must be \"hold-last-focus-require-explicit-reacquisition\".'\n    );\n  }\n\n  return {\n    schemaVersion:\n      FOCUS_CONTROL_PROFILE_SCHEMA_VERSION,\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"focusControlProfile.profileId\"\n      ),\n    profileVersion:\n      requireNonEmptyString(\n        record.profileVersion,\n        \"focusControlProfile.profileVersion\"\n      ),\n    scientificStatus:\n      \"approximation\",\n    supportedModes:\n      parseUniqueEnumList(\n        record.supportedModes,\n        \"focusControlProfile.supportedModes\",\n        FOCUS_MODES\n      ),\n    actuator: {\n      kind:\n        \"ideal-instantaneous\",\n      evidence:\n        parseEvidenceList(\n          actuator.evidence,\n          \"focusControlProfile.actuator.evidence\"\n        )\n    },\n    continuousTargetLossPolicy:\n      \"hold-last-focus-require-explicit-reacquisition\",\n    supportedReleasePriorities:\n      parseUniqueEnumList(\n        record\n          .supportedReleasePriorities,\n        \"focusControlProfile.supportedReleasePriorities\",\n        RELEASE_PRIORITIES\n      ),\n    evidence:\n      parseEvidenceList(\n        record.evidence,\n        \"focusControlProfile.evidence\"\n      ),\n    limitations:\n      parseLimitations(\n        record.limitations,\n        \"focusControlProfile.limitations\"\n      )\n  };\n}\n\nfunction cloneJson<T>(\n  value: T\n): T {\n  return JSON.parse(\n    JSON.stringify(value)\n  ) as T;\n}\n\nfunction deepFreeze<T>(\n  value: T\n): T {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Object.isFrozen(value)\n  ) {\n    return value;\n  }\n\n  Object.freeze(value);\n  for (\n    const child of\n    Object.values(\n      value as UnknownRecord\n    )\n  ) {\n    deepFreeze(child);\n  }\n  return value;\n}\n\nfunction immutableState(\n  state:\n    FocusControlState\n): FocusControlState {\n  return deepFreeze(\n    cloneJson(state)\n  );\n}\n\nfunction stateBase(\n  stateId: string,\n  profile:\n    FocusControlProfile,\n  mode:\n    FocusControlMode,\n  focus:\n    FocusPlane,\n  acquisitionState:\n    FocusAcquisitionState,\n  eventTimeSeconds: number,\n  focusResolvedAtSeconds:\n    number,\n  activeTargetId?:\n    string,\n  activeFocusAreaId?:\n    string,\n  lock?:\n    FocusControlState[\"lock\"]\n): FocusControlState {\n  return immutableState({\n    version:\n      FOCUS_CONTROL_STATE_VERSION,\n    stateId:\n      requireScientificNonEmptyString(\n        stateId,\n        \"stateId\"\n      ),\n    sourceProfile: {\n      profileId:\n        profile.profileId,\n      profileVersion:\n        profile.profileVersion\n    },\n    profileLimitations: [\n      ...profile.limitations\n    ],\n    mode,\n    acquisitionState,\n    focus:\n      parseFocusPlane(focus),\n    ...(activeTargetId ===\n    undefined\n      ? {}\n      : {\n          activeTargetId\n        }),\n    ...(activeFocusAreaId ===\n    undefined\n      ? {}\n      : {\n          activeFocusAreaId\n        }),\n    lastEventTimeSeconds:\n      eventTimeSeconds,\n    focusResolvedAtSeconds,\n    locked:\n      acquisitionState ===\n      \"locked\",\n    ...(lock === undefined\n      ? {}\n      : {\n          lock\n        }),\n    actuatorModel:\n      \"ideal-instantaneous\",\n    continuousTargetLossPolicy:\n      profile\n        .continuousTargetLossPolicy,\n    exposureModified: false,\n    meteringModified: false,\n    whiteBalanceModified:\n      false,\n    subjectTrackingRecognitionModeled:\n      false,\n    rendererCoordinatesConsumed:\n      false,\n    limitations: [\n      ...profile.limitations,\n      \"Focus target observations use longitudinal camera-space/conjugate distance, not renderer ray length.\",\n      \"Ideal instantaneous focus actuation is an approximation and does not represent commercial AF speed, error, hunting, recognition, or low-light behavior.\",\n      \"Focus control does not modify exposure, metering, white balance, or scene illumination.\"\n    ]\n  });\n}\n\nfunction requireSupportedMode(\n  profile:\n    FocusControlProfile,\n  mode:\n    FocusControlMode\n): void {\n  if (\n    !profile.supportedModes\n      .includes(mode)\n  ) {\n    throw new InvalidScientificInputError(\n      \"Selected focus-control mode is not supported by the profile.\"\n    );\n  }\n}\n\nfunction requireMonotonicEventTime(\n  current:\n    FocusControlState,\n  eventTimeSeconds: number\n): number {\n  const parsed =\n    requireScientificNonNegativeFinite(\n      eventTimeSeconds,\n      \"eventTimeSeconds\"\n    );\n  if (\n    parsed <\n    current.lastEventTimeSeconds\n  ) {\n    throw new InvalidScientificInputError(\n      \"Focus-control event time must not move backward.\"\n    );\n  }\n  return parsed;\n}\n\nfunction verifyStateProfile(\n  state:\n    FocusControlState,\n  profile:\n    FocusControlProfile\n): void {\n  if (\n    state.sourceProfile\n      .profileId !==\n      profile.profileId ||\n    state.sourceProfile\n      .profileVersion !==\n      profile.profileVersion\n  ) {\n    throw new InvalidScientificInputError(\n      \"Focus-control state/profile identity does not match.\"\n    );\n  }\n}\n\n/**\n * Creates the initial ideal focus-controller state from a profile, a focus plane and a public\n * state ID.\n * @param input - New state ID, profile, focus mode, initial focus plane and optional start time.\n * @returns The initial state. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function createFocusControlState(\n  input:\n    CreateFocusControlStateInput\n): FocusControlState {\n  requireInputKeys(input, \"createFocusControlState\", [\"stateId\", \"profile\", \"mode\", \"initialFocus\", \"initialTimeSeconds\"]);\n  const profile =\n    parseFocusControlProfile(\n      input.profile\n    );\n  requireSupportedMode(\n    profile,\n    input.mode\n  );\n  const time =\n    input.initialTimeSeconds ===\n    undefined\n      ? 0\n      : requireScientificNonNegativeFinite(\n          input.initialTimeSeconds,\n          \"initialTimeSeconds\"\n        );\n\n  return stateBase(\n    input.stateId,\n    profile,\n    input.mode,\n    input.initialFocus,\n    \"idle\",\n    time,\n    time\n  );\n}\n\nfunction stateProfileView(\n  state:\n    FocusControlState\n): FocusControlProfile {\n  return {\n    schemaVersion:\n      FOCUS_CONTROL_PROFILE_SCHEMA_VERSION,\n    profileId:\n      state.sourceProfile\n        .profileId,\n    profileVersion:\n      state.sourceProfile\n        .profileVersion,\n    scientificStatus:\n      \"approximation\",\n    supportedModes: [\n      state.mode\n    ],\n    actuator: {\n      kind:\n        \"ideal-instantaneous\",\n      evidence: []\n    },\n    continuousTargetLossPolicy:\n      state\n        .continuousTargetLossPolicy,\n    supportedReleasePriorities: [\n      \"focus-priority\",\n      \"release-priority\",\n      \"balanced\"\n    ],\n    evidence: [],\n    limitations:\n      state.profileLimitations\n  };\n}\n\n/**\n * Returns the state after manually focusing on the given finite or infinity plane. No lens\n * actuator or focus-ring conversion is modelled.\n * @param input - Current state, new state ID, new focus plane and event time.\n * @returns The new state. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function setManualFocusState(\n  input:\n    SetManualFocusStateInput\n): FocusControlState {\n  requireInputKeys(input, \"setManualFocusState\", [\"state\", \"stateId\", \"focus\", \"eventTimeSeconds\", \"commandId\"]);\n  requireInputObject(input.state, \"state\");\n  if (\n    input.state.mode !==\n    \"manual\"\n  ) {\n    throw new InvalidScientificInputError(\n      \"setManualFocusState requires manual focus mode.\"\n    );\n  }\n  if (input.state.locked) {\n    throw new InvalidScientificInputError(\n      \"Manual focus cannot change while focus lock is active.\"\n    );\n  }\n  if (\n    input.commandId !==\n    undefined\n  ) {\n    requireScientificNonEmptyString(\n      input.commandId,\n      \"commandId\"\n    );\n  }\n  const time =\n    requireMonotonicEventTime(\n      input.state,\n      input.eventTimeSeconds\n    );\n\n  return stateBase(\n    input.stateId,\n    stateProfileView(\n      input.state\n    ),\n    \"manual\",\n    input.focus,\n    \"idle\",\n    time,\n    time\n  );\n}\n\nfunction parseObservation(\n  observation:\n    FocusTargetObservation\n): FocusTargetObservation {\n  const targetId =\n    requireScientificNonEmptyString(\n      observation.targetId,\n      \"observation.targetId\"\n    );\n  const observedAtSeconds =\n    requireScientificNonNegativeFinite(\n      observation\n        .observedAtSeconds,\n      \"observation.observedAtSeconds\"\n    );\n  const focusAreaId =\n    observation.focusAreaId ===\n    undefined\n      ? undefined\n      : requireScientificNonEmptyString(\n          observation.focusAreaId,\n          \"observation.focusAreaId\"\n        );\n\n  if (\n    observation.kind ===\n    \"finite-surface\"\n  ) {\n    return {\n      kind: \"finite-surface\",\n      targetId,\n      ...(focusAreaId ===\n      undefined\n        ? {}\n        : {\n            focusAreaId\n          }),\n      observedAtSeconds,\n      longitudinalDistanceM:\n        requireScientificPositiveFinite(\n          observation\n            .longitudinalDistanceM,\n          \"observation.longitudinalDistanceM\"\n        )\n    };\n  }\n\n  if (\n    observation.kind ===\n    \"infinity-environment\"\n  ) {\n    return {\n      kind:\n        \"infinity-environment\",\n      targetId,\n      ...(focusAreaId ===\n      undefined\n        ? {}\n        : {\n            focusAreaId\n          }),\n      observedAtSeconds\n    };\n  }\n\n  if (\n    observation.kind ===\n      \"unavailable\" &&\n    TARGET_LOSS_REASONS.has(\n      observation.reason\n    )\n  ) {\n    return {\n      kind: \"unavailable\",\n      targetId,\n      ...(focusAreaId ===\n      undefined\n        ? {}\n        : {\n            focusAreaId\n          }),\n      observedAtSeconds,\n      reason:\n        observation.reason\n    };\n  }\n\n  throw new InvalidConfigurationError(\n    \"observation.kind/reason is invalid.\"\n  );\n}\n\nfunction focusFromObservation(\n  observation:\n    Exclude<\n      FocusTargetObservation,\n      {\n        kind: \"unavailable\";\n      }\n    >\n): FocusPlane {\n  if (\n    observation.kind ===\n    \"infinity-environment\"\n  ) {\n    return {\n      kind: \"infinity\"\n    };\n  }\n  return {\n    kind: \"finite\",\n    distanceM:\n      observation\n        .longitudinalDistanceM\n  };\n}\n\nfunction focusEquals(\n  a: FocusPlane,\n  b: FocusPlane\n): boolean {\n  if (\n    a.kind !== b.kind\n  ) {\n    return false;\n  }\n  if (\n    a.kind === \"infinity\" ||\n    b.kind === \"infinity\"\n  ) {\n    return true;\n  }\n  return (\n    a.distanceM ===\n    b.distanceM\n  );\n}\n\nfunction stateFromResolvedTarget(\n  input:\n    ResolveFocusTargetObservationInput,\n  observation:\n    Exclude<\n      FocusTargetObservation,\n      {\n        kind: \"unavailable\";\n      }\n    >\n): FocusTargetResolution {\n  const focus =\n    focusFromObservation(\n      observation\n    );\n  const state =\n    stateBase(\n      input.stateId,\n      stateProfileView(\n        input.state\n      ),\n      input.state.mode,\n      focus,\n      \"acquired\",\n      observation\n        .observedAtSeconds,\n      observation\n        .observedAtSeconds,\n      observation.targetId,\n      observation.focusAreaId\n    );\n  return {\n    state,\n    targetObservationApplied:\n      true,\n    focusChanged:\n      !focusEquals(\n        input.state.focus,\n        focus\n      ),\n    acquisitionEvent:\n      input.event,\n    actuatorModel:\n      \"ideal-instantaneous\",\n    silentRetargetingPerformed:\n      false\n  };\n}\n\nfunction unchangedResolution(\n  input:\n    ResolveFocusTargetObservationInput\n): FocusTargetResolution {\n  return {\n    state: input.state,\n    targetObservationApplied:\n      false,\n    focusChanged: false,\n    acquisitionEvent:\n      input.event,\n    actuatorModel:\n      \"ideal-instantaneous\",\n    silentRetargetingPerformed:\n      false\n  };\n}\n\n/**\n * Applies one target observation (target available or lost) under the selected AF-S or AF-C\n * policy, and records whether the target was acquired or reacquired.\n *\n * The ideal actuator focuses on the observation as given. Target loss, reacquisition, focus\n * lock and release priority are separate state changes.\n * @param input - Current state, new state ID, control event and target observation.\n * @returns The resolution and new state. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function resolveFocusTargetObservation(\n  input:\n    ResolveFocusTargetObservationInput\n): FocusTargetResolution {\n  requireInputKeys(input, \"resolveFocusTargetObservation\", [\"state\", \"stateId\", \"event\", \"observation\"]);\n  if (\n    input.event !== \"acquire\" &&\n    input.event !== \"update\"\n  ) {\n    throw new InvalidConfigurationError(\n      'Focus target event must be \"acquire\" or \"update\".'\n    );\n  }\n  if (\n    input.state.mode ===\n    \"manual\"\n  ) {\n    throw new InvalidScientificInputError(\n      \"Manual focus does not automatically consume autofocus target observations.\"\n    );\n  }\n\n  const observation =\n    parseObservation(\n      input.observation\n    );\n  requireMonotonicEventTime(\n    input.state,\n    observation\n      .observedAtSeconds\n  );\n\n  if (input.state.locked) {\n    return unchangedResolution(\n      input\n    );\n  }\n\n  if (\n    input.state.mode ===\n    \"single-af\"\n  ) {\n    if (\n      input.event ===\n        \"update\" &&\n      input.state\n        .acquisitionState ===\n        \"acquired\"\n    ) {\n      return unchangedResolution(\n        input\n      );\n    }\n    if (\n      input.event !==\n      \"acquire\"\n    ) {\n      throw new InvalidScientificInputError(\n        \"Single AF requires an explicit acquire event before target updates.\"\n      );\n    }\n    if (\n      observation.kind ===\n      \"unavailable\"\n    ) {\n      const state =\n        stateBase(\n          input.stateId,\n          stateProfileView(\n            input.state\n          ),\n          \"single-af\",\n          input.state.focus,\n          \"target-lost\",\n          observation\n            .observedAtSeconds,\n          input.state\n            .focusResolvedAtSeconds,\n          observation.targetId,\n          observation.focusAreaId\n        );\n      return {\n        state,\n        targetObservationApplied:\n          true,\n        focusChanged: false,\n        acquisitionEvent:\n          input.event,\n        actuatorModel:\n          \"ideal-instantaneous\",\n        silentRetargetingPerformed:\n          false\n      };\n    }\n    return stateFromResolvedTarget(\n      input,\n      observation\n    );\n  }\n\n  if (\n    input.event ===\n    \"update\"\n  ) {\n    if (\n      input.state\n        .activeTargetId ===\n      undefined\n    ) {\n      throw new InvalidScientificInputError(\n        \"Continuous AF requires an explicit acquire event before updates.\"\n      );\n    }\n    if (\n      observation.targetId !==\n      input.state\n        .activeTargetId\n    ) {\n      throw new InvalidScientificInputError(\n        \"Continuous AF update targetId must match the active target; silent retargeting is not permitted.\"\n      );\n    }\n    if (\n      input.state\n        .acquisitionState ===\n      \"target-lost\"\n    ) {\n      throw new InvalidScientificInputError(\n        \"Continuous AF target loss requires an explicit acquire event before reacquisition.\"\n      );\n    }\n  }\n\n  if (\n    observation.kind ===\n    \"unavailable\"\n  ) {\n    const state =\n      stateBase(\n        input.stateId,\n        stateProfileView(\n          input.state\n        ),\n        \"continuous-af\",\n        input.state.focus,\n        \"target-lost\",\n        observation\n          .observedAtSeconds,\n        input.state\n          .focusResolvedAtSeconds,\n        observation.targetId,\n        observation.focusAreaId\n      );\n    return {\n      state,\n      targetObservationApplied:\n        true,\n      focusChanged: false,\n      acquisitionEvent:\n        input.event,\n      actuatorModel:\n        \"ideal-instantaneous\",\n      silentRetargetingPerformed:\n        false\n    };\n  }\n\n  return stateFromResolvedTarget(\n    input,\n    observation\n  );\n}\n\n/**\n * Locks or unlocks focus. The physical focus plane does not change.\n * @param input - Current state, new state ID, lock setting and event time.\n * @returns The new state. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function setFocusLock(\n  input:\n    SetFocusLockInput\n): FocusControlState {\n  requireInputKeys(input, \"setFocusLock\", [\"state\", \"stateId\", \"locked\", \"eventTimeSeconds\"]);\n  const time =\n    requireMonotonicEventTime(\n      input.state,\n      input.eventTimeSeconds\n    );\n\n  if (input.locked) {\n    if (input.state.locked) {\n      return input.state;\n    }\n    return stateBase(\n      input.stateId,\n      stateProfileView(\n        input.state\n      ),\n      input.state.mode,\n      input.state.focus,\n      \"locked\",\n      time,\n      input.state\n        .focusResolvedAtSeconds,\n      input.state\n        .activeTargetId,\n      input.state\n        .activeFocusAreaId,\n      {\n        lockedAtSeconds:\n          time,\n        resumeAcquisitionState:\n          input.state\n            .acquisitionState as Exclude<\n              FocusAcquisitionState,\n              \"locked\"\n            >\n      }\n    );\n  }\n\n  if (!input.state.locked) {\n    return input.state;\n  }\n  const resume =\n    input.state.lock\n      ?.resumeAcquisitionState;\n  if (resume === undefined) {\n    throw new InvalidScientificInputError(\n      \"Locked focus state is missing its resume acquisition state.\"\n    );\n  }\n\n  return stateBase(\n    input.stateId,\n    stateProfileView(\n      input.state\n    ),\n    input.state.mode,\n    input.state.focus,\n    resume,\n    time,\n    input.state\n      .focusResolvedAtSeconds,\n    input.state\n      .activeTargetId,\n    input.state\n      .activeFocusAreaId\n  );\n}\n\n/**\n * Reports whether the shutter may be released under the focus-priority or release-priority\n * policy. It does not operate the shutter.\n * @param input - Current state, profile and release priority.\n * @returns The assessment. Read its structured blockers before acting on an authorization.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function assessFocusReleaseGate(\n  input:\n    AssessFocusReleaseGateInput\n): FocusReleaseGateAssessment {\n  requireInputKeys(input, \"assessFocusReleaseGate\", [\"state\", \"profile\", \"priority\"]);\n  const profile =\n    parseFocusControlProfile(\n      input.profile\n    );\n  verifyStateProfile(\n    input.state,\n    profile\n  );\n\n  if (\n    !profile\n      .supportedReleasePriorities\n      .includes(\n        input.priority\n      )\n  ) {\n    throw new InvalidScientificInputError(\n      \"Selected focus/release priority is not supported by the profile.\"\n    );\n  }\n\n  if (\n    input.priority ===\n    \"release-priority\"\n  ) {\n    return {\n      priority:\n        input.priority,\n      releaseAuthorized: true,\n      reason:\n        \"release-priority-bypasses-focus-gate\",\n      requiresProfileSpecificBalancedPolicy:\n        false,\n      opticalFocusModified:\n        false,\n      exposureModified:\n        false\n    };\n  }\n\n  if (\n    input.priority ===\n    \"balanced\"\n  ) {\n    return {\n      priority:\n        input.priority,\n      releaseAuthorized:\n        false,\n      reason:\n        \"balanced-policy-not-modeled\",\n      requiresProfileSpecificBalancedPolicy:\n        true,\n      opticalFocusModified:\n        false,\n      exposureModified:\n        false\n    };\n  }\n\n  if (\n    input.state.mode ===\n    \"manual\"\n  ) {\n    return {\n      priority:\n        input.priority,\n      releaseAuthorized: true,\n      reason:\n        \"manual-focus-state\",\n      requiresProfileSpecificBalancedPolicy:\n        false,\n      opticalFocusModified:\n        false,\n      exposureModified:\n        false\n    };\n  }\n\n  if (\n    input.state\n      .acquisitionState ===\n    \"locked\"\n  ) {\n    return {\n      priority:\n        input.priority,\n      releaseAuthorized: true,\n      reason:\n        \"focus-locked\",\n      requiresProfileSpecificBalancedPolicy:\n        false,\n      opticalFocusModified:\n        false,\n      exposureModified:\n        false\n    };\n  }\n\n  if (\n    input.state\n      .acquisitionState ===\n    \"acquired\"\n  ) {\n    return {\n      priority:\n        input.priority,\n      releaseAuthorized: true,\n      reason:\n        \"focus-acquired\",\n      requiresProfileSpecificBalancedPolicy:\n        false,\n      opticalFocusModified:\n        false,\n      exposureModified:\n        false\n    };\n  }\n\n  return {\n    priority:\n      input.priority,\n    releaseAuthorized: false,\n    reason:\n      \"focus-not-acquired\",\n    requiresProfileSpecificBalancedPolicy:\n      false,\n    opticalFocusModified:\n      false,\n    exposureModified:\n      false\n  };\n}\n"]}

package/dist/capture/host-yield-cadence.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Internal: decides how often native tile loops yield to the host (browser) event loop.
+ *
+ * Tiles stay small, for bounded memory and exact tile identity. But the host's `yieldControl`
+ * callback is awaited only once the work since the last yield reaches a time budget, and always
+ * after the final tile. This only changes when the host gets to run. Tile requests, absolute CFA
+ * (colour filter array) and noise-seed indexing, and every output value are unaffected.
+ * Not exported from the package.
+ */
+/** Default work budget between host yields: about half of a 60 Hz frame. */
+export declare const HOST_YIELD_BUDGET_MILLISECONDS = 8;
+export interface HostYieldCadence {
+    /** Yield once at least this many milliseconds (monotonic clock) have passed since the last yield. 0 yields after every tile. */
+    readonly budgetMilliseconds: number;
+    /** Monotonic clock in milliseconds. */
+    readonly now: () => number;
+}
+export declare const DEFAULT_HOST_YIELD_CADENCE: HostYieldCadence;
+export interface HostYieldGate {
+    /** Restarts the budget, for example at the start of a run and after each host yield finishes. */
+    restart(): void;
+    /** True once the budget since the last restart is spent. */
+    due(): boolean;
+}
+export declare function createHostYieldGate(cadence?: HostYieldCadence): HostYieldGate;

package/dist/capture/host-yield-cadence.js

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Internal: decides how often native tile loops yield to the host (browser) event loop.
+ *
+ * Tiles stay small, for bounded memory and exact tile identity. But the host's `yieldControl`
+ * callback is awaited only once the work since the last yield reaches a time budget, and always
+ * after the final tile. This only changes when the host gets to run. Tile requests, absolute CFA
+ * (colour filter array) and noise-seed indexing, and every output value are unaffected.
+ * Not exported from the package.
+ */
+/** Default work budget between host yields: about half of a 60 Hz frame. */
+export const HOST_YIELD_BUDGET_MILLISECONDS = 8;
+export const DEFAULT_HOST_YIELD_CADENCE = Object.freeze({
+    budgetMilliseconds: HOST_YIELD_BUDGET_MILLISECONDS,
+    now: () => performance.now()
+});
+export function createHostYieldGate(cadence = DEFAULT_HOST_YIELD_CADENCE) {
+    const { budgetMilliseconds, now } = cadence;
+    let since = now();
+    return {
+        restart() { since = now(); },
+        due() { return budgetMilliseconds <= 0 || now() - since >= budgetMilliseconds; }
+    };
+}
+//# sourceMappingURL=host-yield-cadence.js.map

package/dist/capture/host-yield-cadence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-yield-cadence.js","sourceRoot":"","sources":["../../src/capture/host-yield-cadence.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;GAQG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAShD,MAAM,CAAC,MAAM,0BAA0B,GAAqB,MAAM,CAAC,MAAM,CAAC;IACxE,kBAAkB,EAAE,8BAA8B;IAClD,GAAG,EAAE,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;CACrC,CAAC,CAAC;AASH,MAAM,UAAU,mBAAmB,CAAC,UAA4B,0BAA0B;IACxF,MAAM,EAAC,kBAAkB,EAAE,GAAG,EAAC,GAAG,OAAO,CAAC;IAC1C,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;IAClB,OAAO;QACL,OAAO,KAAW,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QAClC,GAAG,KAAc,OAAO,kBAAkB,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,KAAK,IAAI,kBAAkB,CAAC,CAAC,CAAC;KAC1F,CAAC;AACJ,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Internal: decides how often native tile loops yield to the host (browser) event loop.\n *\n * Tiles stay small, for bounded memory and exact tile identity. But the host's `yieldControl`\n * callback is awaited only once the work since the last yield reaches a time budget, and always\n * after the final tile. This only changes when the host gets to run. Tile requests, absolute CFA\n * (colour filter array) and noise-seed indexing, and every output value are unaffected.\n * Not exported from the package.\n */\n\n/** Default work budget between host yields: about half of a 60 Hz frame. */\nexport const HOST_YIELD_BUDGET_MILLISECONDS = 8;\n\nexport interface HostYieldCadence {\n  /** Yield once at least this many milliseconds (monotonic clock) have passed since the last yield. 0 yields after every tile. */\n  readonly budgetMilliseconds: number;\n  /** Monotonic clock in milliseconds. */\n  readonly now: () => number;\n}\n\nexport const DEFAULT_HOST_YIELD_CADENCE: HostYieldCadence = Object.freeze({\n  budgetMilliseconds: HOST_YIELD_BUDGET_MILLISECONDS,\n  now: (): number => performance.now()\n});\n\nexport interface HostYieldGate {\n  /** Restarts the budget, for example at the start of a run and after each host yield finishes. */\n  restart(): void;\n  /** True once the budget since the last restart is spent. */\n  due(): boolean;\n}\n\nexport function createHostYieldGate(cadence: HostYieldCadence = DEFAULT_HOST_YIELD_CADENCE): HostYieldGate {\n  const {budgetMilliseconds, now} = cadence;\n  let since = now();\n  return {\n    restart(): void { since = now(); },\n    due(): boolean { return budgetMilliseconds <= 0 || now() - since >= budgetMilliseconds; }\n  };\n}\n"]}

package/dist/capture/linear-encoding.d.ts

@@ -1,12 +1,14 @@
 import { type CalculationResult } from "../core/calculation-result.js";
 import { type SimulatedCapture, type CaptureLinearPlane, type CaptureLinearImageState } from "./simulated-capture.js";
 export declare const LINEAR_CAPTURE_ENCODING_SCHEMA_VERSION: "0.1.0";
-/** Uniform channel mapping; capture reference white comes from the source plane. */
+/** Version of the `uniform-linear-capture-uint16` model. 0.2.0 made rounding exact: nearest, ties up (Math.round). */
+export declare const LINEAR_CAPTURE_ENCODING_MODEL_VERSION: "0.2.0";
+/** The same linear mapping for every channel. The reference white value comes from the source plane. */
 export interface LinearCaptureEncoding {
     schemaVersion: typeof LINEAR_CAPTURE_ENCODING_SCHEMA_VERSION;
     /** Relative source sample value assigned blackCode; may be negative. */
     blackValue: number;
-    /** Integer code at blackValue, 0..65534. An offset can preserve negative samples. */
+    /** Integer code for blackValue, 0..65534. A nonzero offset can keep negative samples. */
     blackCode: number;
     /** Code at the plane's referenceWhiteValue, strictly above blackCode, at most 65535. */
     referenceWhiteCode: number;
@@ -14,20 +16,20 @@ export interface LinearCaptureEncoding {
     outOfRange: "clip" | "reject";
     rounding: "nearest-ties-up";
 }
-/** Strict allowlisted encoding parser; no default clipping/rounding policy is invented. */
+/** Strictly parses an encoding profile. It never fills in a default clipping or rounding policy. */
 export declare function parseLinearCaptureEncoding(value: unknown): LinearCaptureEncoding;
 export interface LinearCaptureEncodingInput {
     capture: SimulatedCapture;
     planeId: string;
-    /** Prevents substituting a differently interpreted linear plane. */
+    /** Identifies the exact source plane, so a plane with a different meaning cannot be swapped in. */
     requiredImageState: CaptureLinearImageState;
     encoding: LinearCaptureEncoding;
 }
-/** Format-neutral 16-bit unsigned codes; metadata retains color/WB/saturation meaning. */
+/** 16-bit unsigned codes, not tied to a file format. The metadata keeps their colour, white-balance (WB) and saturation meaning. */
 export interface EncodedLinearCapture {
     schemaVersion: typeof LINEAR_CAPTURE_ENCODING_SCHEMA_VERSION;
     captureId: string;
-    /** Sanitized geometry/settings/WB/adopted-white/model provenance without float planes. */
+    /** Cleaned-up copy of the capture's geometry, settings, WB, adopted white and model provenance, without the float planes. */
     captureMetadata: Omit<SimulatedCapture, "planes">;
     sourcePlane: Omit<CaptureLinearPlane, "storage">;
     encoding: LinearCaptureEncoding;
@@ -40,20 +42,20 @@ export interface EncodedLinearCapture {
     scale: number;
     minimumRepresentableValue: number;
     maximumRepresentableValue: number;
-    /** Maximum above-black value / reference-white above-black value. */
+    /** Headroom: (maximum value − black) / (reference white − black). */
     headroomFactor: number;
-    /** 0.5/scale for in-range samples; excludes clipping error. */
+    /** Largest rounding error for in-range samples, 0.5/scale. Clipping error is not included. */
     maximumRoundingError: number;
     clippedLowSampleCount: number;
     clippedHighSampleCount: number;
-    /** No default rendering exposure/display white is chosen by linear encoding. */
+    /** Linear encoding never picks a default rendering exposure or display white. */
     defaultRenderingExposureEv: null;
     samples: readonly number[];
 }
 /**
- * Quantizes one immutable inline float plane without changing its capture data.
+ * Converts one inline float plane to integer codes. The capture data is not changed.
+ *
  * Mapping: blackCode + (sample-blackValue)/(referenceWhiteValue-blackValue)
- * * (referenceWhiteCode-blackCode). Clips only under explicit policy, then rounds.
+ * * (referenceWhiteCode-blackCode). It clips only when the policy says so, then rounds.
  */
 export declare function calculateLinearCaptureEncoding(input: LinearCaptureEncodingInput): CalculationResult<EncodedLinearCapture>;
-//# sourceMappingURL=linear-encoding.d.ts.map

package/dist/capture/linear-encoding.js

@@ -1,10 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Strict allowlisted encoding parser; no default clipping/rounding policy is invented.
- * Quantizes one immutable inline float plane without changing its capture data. Mapping: blackCode +
- * (sample-blackValue)/(referenceWhiteValue-blackValue) * (referenceWhiteCode-blackCode). Clips only
- * under explicit policy, then rounds.
+ * Linear capture encoding: converts a floating-point capture plane to 16-bit unsigned integer
+ * codes with a uniform linear mapping. The capture itself is not changed.
  * @see docs/LINEAR_CAPTURE_ENCODING.md for equations, coordinate/unit conventions, blockers and
  * support limits.
  */
@@ -13,10 +10,12 @@ import { calculatedResult } from "../core/calculation-result.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { parseSimulatedCapture } from "./simulated-capture.js";
 export const LINEAR_CAPTURE_ENCODING_SCHEMA_VERSION = "0.1.0";
+/** Version of the `uniform-linear-capture-uint16` model. 0.2.0 made rounding exact: nearest, ties up (Math.round). */
+export const LINEAR_CAPTURE_ENCODING_MODEL_VERSION = "0.2.0";
 function record(value, keys) {
     return requireAllowlistedRecord(value, keys, "Invalid linear encoding fields.");
 }
-/** Strict allowlisted encoding parser; no default clipping/rounding policy is invented. */
+/** Strictly parses an encoding profile. It never fills in a default clipping or rounding policy. */
 export function parseLinearCaptureEncoding(value) {
     const r = record(value, ["schemaVersion", "blackValue", "blackCode", "referenceWhiteCode", "negativeValues", "outOfRange", "rounding"]);
     if (r.schemaVersion !== LINEAR_CAPTURE_ENCODING_SCHEMA_VERSION || typeof r.blackValue !== "number" || !Number.isFinite(r.blackValue) ||
@@ -31,9 +30,10 @@ export function parseLinearCaptureEncoding(value) {
         outOfRange: r.outOfRange, rounding: r.rounding };
 }
 /**
- * Quantizes one immutable inline float plane without changing its capture data.
+ * Converts one inline float plane to integer codes. The capture data is not changed.
+ *
  * Mapping: blackCode + (sample-blackValue)/(referenceWhiteValue-blackValue)
- * * (referenceWhiteCode-blackCode). Clips only under explicit policy, then rounds.
+ * * (referenceWhiteCode-blackCode). It clips only when the policy says so, then rounds.
  */
 export function calculateLinearCaptureEncoding(input) {
     const r = record(input, ["capture", "planeId", "requiredImageState", "encoding"]);
@@ -60,7 +60,7 @@ export function calculateLinearCaptureEncoding(input) {
     const samples = plane.storage.samples.map((sample) => {
         if (encoding.negativeValues === "reject" && sample < 0)
             throw new InvalidConfigurationError("Negative source values are rejected by encoding policy.");
-        // Compare in the source domain first: finite extremes can clip without overflowing arithmetic.
+        // Compare against the limits in source units first, so a huge finite value can clip without overflowing.
         if (sample < minimum || sample > maximum) {
             if (encoding.outOfRange === "reject")
                 throw new InvalidConfigurationError("Source value exceeds the encoded range.");
@@ -80,18 +80,19 @@ export function calculateLinearCaptureEncoding(input) {
         if (sample === plane.referenceWhiteValue)
             return encoding.referenceWhiteCode;
         const mapped = encoding.blackCode + (sample - encoding.blackValue) / width * codeWidth;
-        // Round nearest, exact binary64 ties toward the larger code. Clamp roundoff at endpoints only.
-        return Math.max(0, Math.min(65535, Math.floor(mapped + .5)));
+        // Round to nearest; exact ties go to the larger code (Math.round; Math.floor(x+.5) wrongly rounds
+        // 0.49999999999999994 up). Clamp only rounding error at the end points; Math.max(0, -0) is +0.
+        return Math.max(0, Math.min(65535, Math.round(mapped)));
     });
     const { storage: _storage, ...sourcePlane } = plane;
     const { planes: _planes, ...captureMetadata } = capture;
     void _storage;
-    void _planes; // Float sample arrays are intentionally omitted from encoded metadata.
+    void _planes; // The float sample arrays are deliberately left out of the encoded metadata.
     return calculatedResult({ schemaVersion: LINEAR_CAPTURE_ENCODING_SCHEMA_VERSION, captureId: capture.captureId, captureMetadata, sourcePlane,
         encoding, sampleLayout: "row-major-interleaved", bitDepth: 16, codeMinimum: 0, codeMaximum: 65535,
         referenceWhiteValue: plane.referenceWhiteValue, scale, minimumRepresentableValue: minimum, maximumRepresentableValue: maximum,
         headroomFactor: (65535 - encoding.blackCode) / codeWidth, maximumRoundingError: .5 / scale,
-        clippedLowSampleCount: low, clippedHighSampleCount: high, defaultRenderingExposureEv: null, samples }, "uniform-linear-capture-uint16", LINEAR_CAPTURE_ENCODING_SCHEMA_VERSION, ["Deterministic unsigned linear codes; no dithering, transfer curve, tone mapping or serializer tags",
+        clippedLowSampleCount: low, clippedHighSampleCount: high, defaultRenderingExposureEv: null, samples }, "uniform-linear-capture-uint16", LINEAR_CAPTURE_ENCODING_MODEL_VERSION, ["Deterministic unsigned linear codes; no dithering, transfer curve, tone mapping or serializer tags",
         "Reference white, capture saturation history, integer maximum and display white remain separate",
         "In-range error bound covers ideal rounding only; binary64 arithmetic can add floating-point error"]);
 }