@photivra/engine 2.18.0 → 2.19.0

package/dist/capture/release-sequence.js

@@ -11,39 +11,9 @@
 import { InvalidScientificInputError } from "../core/validation.js";
 import { parseGenericReleaseCapabilityProfile } from "../equipment/release-capabilities.js";
 import { parseFocusPlane } from "../optics/focus-state.js";
-import { requireInputKeys } from "../core/record-validation.js";
-import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { requireInputKeys, requireTrimmedConfigString as requireNonEmptyString, requireInputFinite as requireFinite, requireInputFiniteAboveZero as requirePositiveFinite, requireInputFiniteAtLeastZero as requireNonNegativeFinite } from "../core/record-validation.js";
+import { deepFreeze, cloneJson } from "../core/shared-helpers.js";
 export const RELEASE_SEQUENCE_VERSION = "0.1.0";
-function requireNonEmptyString(value, path) {
-    if (typeof value !== "string" ||
-        value.trim().length === 0) {
-        throw new InvalidConfigurationError(path + " must be a non-empty string.");
-    }
-    return value.trim();
-}
-function requireFinite(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isFinite(value)) {
-        throw new InvalidScientificInputError(path + " must be finite.");
-    }
-    return value;
-}
-function requireNonNegativeFinite(value, path) {
-    const parsed = requireFinite(value, path);
-    if (parsed < 0) {
-        throw new InvalidScientificInputError(path +
-            " must be greater than or equal to zero.");
-    }
-    return parsed;
-}
-function requirePositiveFinite(value, path) {
-    const parsed = requireFinite(value, path);
-    if (parsed <= 0) {
-        throw new InvalidScientificInputError(path +
-            " must be greater than zero.");
-    }
-    return parsed;
-}
 function requirePositiveSafeInteger(value, path) {
     if (!Number.isSafeInteger(value) ||
         value <= 0) {
@@ -61,21 +31,6 @@ function requireUint32(value, path) {
     }
     return value;
 }
-function cloneJson(value) {
-    return JSON.parse(JSON.stringify(value));
-}
-function deepFreeze(value) {
-    if (typeof value !== "object" ||
-        value === null ||
-        Object.isFrozen(value)) {
-        return value;
-    }
-    Object.freeze(value);
-    for (const child of Object.values(value)) {
-        deepFreeze(child);
-    }
-    return value;
-}
 function hashFrameSeed(sequenceSeedUint32, frameIndex) {
     let hash = 0x811c9dc5;
     const text = sequenceSeedUint32.toString(10) +

package/dist/capture/release-sequence.js.map

@@ -1 +1 @@
-{"version":3,"file":"release-sequence.js","sourceRoot":"","sources":["../../src/capture/release-sequence.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Shutter-release sequences for stills (single, burst, self-timer, bracketing), scheduled as logical exposures, and\n * cancelling a sequence part-way.\n *\n * This only schedules exposures; how the sensor captures each one is handled elsewhere. Render speed\n * or frame rate is never used as capture timing.\n * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  parseGenericReleaseCapabilityProfile,\n  type GenericExposureBracketAxis,\n  type GenericReleaseCapabilityProfile\n} from \"../equipment/release-capabilities.js\";\nimport type {\n  ResolvedGenericEquipmentExposureCapabilities,\n  ResolvedNumericSettingGrid\n} from \"../equipment/exposure-capabilities.js\";\nimport {\n  parseFocusPlane,\n  type FocusPlane\n} from \"../optics/focus-state.js\";\nimport { requireInputKeys } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nexport const RELEASE_SEQUENCE_VERSION =\n  \"0.1.0\" as const;\n\nexport type ReleaseAutomationState =\n  | \"manual\"\n  | \"locked\"\n  | \"continuous\";\n\nexport interface ReleaseBaseCaptureState {\n  exposure: {\n    aperture: number;\n    shutterSeconds: number;\n    iso: number;\n  };\n  focus: FocusPlane;\n  whiteBalanceStateId?: string;\n  automation: {\n    ae: ReleaseAutomationState;\n    af: ReleaseAutomationState;\n    awb: ReleaseAutomationState;\n  };\n}\n\nexport type ReleaseDrivePolicy =\n  | {\n      kind: \"single\";\n    }\n  | {\n      kind: \"burst\";\n      frameCount: number;\n    }\n  | {\n      kind: \"self-timer\";\n      delaySeconds: number;\n      frameCount: number;\n    };\n\nexport type ReleaseBracketPolicy =\n  | {\n      kind: \"none\";\n    }\n  | {\n      kind: \"exposure\";\n      axis:\n        GenericExposureBracketAxis;\n      offsetsStops:\n        readonly number[];\n    }\n  | {\n      kind: \"focus\";\n      focusStates:\n        readonly FocusPlane[];\n    };\n\nexport interface ResolveReleaseSequenceInput {\n  sequenceId: string;\n  releaseRequestTimeSeconds: number;\n  sequenceSeedUint32: number;\n  drive: ReleaseDrivePolicy;\n  bracket: ReleaseBracketPolicy;\n  requestedCadenceFps?: number;\n  baseState:\n    ReleaseBaseCaptureState;\n  releaseCapabilities:\n    GenericReleaseCapabilityProfile;\n  exposureCapabilities:\n    ResolvedGenericEquipmentExposureCapabilities;\n}\n\nexport type ReleaseTimingConstraint =\n  | \"requested-cadence\"\n  | \"body-maximum-cadence\"\n  | \"exposure-duration\"\n  | \"minimum-inter-frame-gap\";\n\nexport interface ResolvedReleaseFrame {\n  sequenceId: string;\n  frameIndex: number;\n  releaseFrameId: string;\n  exposureStartTimeSeconds: number;\n  exposureEndTimeSeconds: number;\n  sceneTimeSecondsFromSequenceStart:\n    number;\n  startIntervalFromPreviousSeconds:\n    number | null;\n  timingConstraints:\n    readonly ReleaseTimingConstraint[];\n  stochasticSeedUint32: number;\n  exposure: {\n    aperture: number;\n    shutterSeconds: number;\n    iso: number;\n  };\n  focus: FocusPlane;\n  exposureBracketOffsetStops?:\n    number;\n  automation:\n    ReleaseBaseCaptureState[\"automation\"];\n  whiteBalanceStateId?: string;\n}\n\nexport interface ResolvedReleaseSequence {\n  version:\n    typeof RELEASE_SEQUENCE_VERSION;\n  sequenceId: string;\n  status: \"scheduled\";\n  releaseRequestTimeSeconds: number;\n  selfTimerDelaySeconds: number;\n  requestedCadenceFps:\n    number | null;\n  capabilityMaximumCadenceFps:\n    number;\n  minimumInterFrameGapSeconds:\n    number;\n  requestedFrameCount: number;\n  actualFrameCount: number;\n  sequenceSeedUint32: number;\n  baseStateSnapshot:\n    ReleaseBaseCaptureState;\n  frames:\n    readonly ResolvedReleaseFrame[];\n  sensorCaptureModeOwnership:\n    \"separate-logical-capture-contract\";\n  whiteBalanceBracketingPhysicalCaptures:\n    false;\n  preReleaseCaptureModeled:\n    false;\n  bufferMediaThermalSlowdownModeled:\n    false;\n}\n\nexport interface CancelReleaseSequenceInput {\n  sequence:\n    ResolvedReleaseSequence;\n  completedFrameCount: number;\n  cancelledAtSeconds: number;\n}\n\nexport interface CancelledReleaseSequence {\n  version:\n    typeof RELEASE_SEQUENCE_VERSION;\n  sequenceId: string;\n  status: \"cancelled\";\n  cancelledAtSeconds: number;\n  completedFrameCount: number;\n  omittedFrameCount: number;\n  completedFrames:\n    readonly ResolvedReleaseFrame[];\n  sourceSequenceFrameCount: number;\n  sourceSequenceUnmodified: true;\n}\n\nfunction requireNonEmptyString(\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 + \" must be a non-empty string.\"\n    );\n  }\n  return value.trim();\n}\n\nfunction requireFinite(\n  value: number,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value)\n  ) {\n    throw new InvalidScientificInputError(\n      path + \" must be finite.\"\n    );\n  }\n  return value;\n}\n\nfunction requireNonNegativeFinite(\n  value: number,\n  path: string\n): number {\n  const parsed =\n    requireFinite(value, path);\n  if (parsed < 0) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be greater than or equal to zero.\"\n    );\n  }\n  return parsed;\n}\n\nfunction requirePositiveFinite(\n  value: number,\n  path: string\n): number {\n  const parsed =\n    requireFinite(value, path);\n  if (parsed <= 0) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be greater than zero.\"\n    );\n  }\n  return parsed;\n}\n\nfunction requirePositiveSafeInteger(\n  value: number,\n  path: string\n): number {\n  if (\n    !Number.isSafeInteger(value) ||\n    value <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be a positive safe integer.\"\n    );\n  }\n  return value;\n}\n\nfunction requireUint32(\n  value: number,\n  path: string\n): number {\n  if (\n    !Number.isSafeInteger(value) ||\n    value < 0 ||\n    value > 0xffff_ffff\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be an unsigned 32-bit integer.\"\n    );\n  }\n  return value;\n}\n\nfunction cloneJson<T>(value: T): T {\n  return JSON.parse(\n    JSON.stringify(value)\n  ) as T;\n}\n\nfunction deepFreeze<T>(value: T): 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 Record<string, unknown>\n    )\n  ) {\n    deepFreeze(child);\n  }\n  return value;\n}\n\nfunction hashFrameSeed(\n  sequenceSeedUint32: number,\n  frameIndex: number\n): number {\n  let hash = 0x811c9dc5;\n  const text =\n    sequenceSeedUint32.toString(10) +\n    \":\" +\n    frameIndex.toString(10);\n  for (\n    let index = 0;\n    index < text.length;\n    index += 1\n  ) {\n    hash ^= text.charCodeAt(index);\n    hash = Math.imul(\n      hash,\n      0x01000193\n    ) >>> 0;\n  }\n  return hash >>> 0;\n}\n\nfunction includesDriveMode(\n  capabilities:\n    GenericReleaseCapabilityProfile,\n  drive:\n    ReleaseDrivePolicy[\"kind\"]\n): boolean {\n  return capabilities\n    .supportedDriveModes\n    .value.includes(drive);\n}\n\nfunction driveFrameCount(\n  drive: ReleaseDrivePolicy\n): number {\n  if (drive.kind === \"single\") {\n    return 1;\n  }\n  return requirePositiveSafeInteger(\n    drive.frameCount,\n    \"drive.frameCount\"\n  );\n}\n\nfunction bracketFrameCount(\n  bracket:\n    ReleaseBracketPolicy\n): number | null {\n  if (bracket.kind === \"none\") {\n    return null;\n  }\n  const count =\n    bracket.kind === \"exposure\"\n      ? bracket.offsetsStops.length\n      : bracket.focusStates.length;\n  if (count <= 0) {\n    throw new InvalidScientificInputError(\n      \"Bracket sequences must contain at least one frame.\"\n    );\n  }\n  return count;\n}\n\nfunction resolveFrameCount(\n  drive: ReleaseDrivePolicy,\n  bracket:\n    ReleaseBracketPolicy\n): number {\n  const driveCount =\n    driveFrameCount(drive);\n  const bracketCount =\n    bracketFrameCount(bracket);\n\n  if (bracketCount === null) {\n    return driveCount;\n  }\n\n  if (drive.kind === \"burst\") {\n    throw new InvalidScientificInputError(\n      \"Schema 0.1.0 does not combine burst drive with bracketing; choose one multi-frame policy explicitly.\"\n    );\n  }\n\n  if (\n    drive.kind === \"self-timer\" &&\n    driveCount !== bracketCount\n  ) {\n    throw new InvalidScientificInputError(\n      \"Self-timer frameCount must match the bracket frame count.\"\n    );\n  }\n\n  return bracketCount;\n}\n\nfunction validateGridSetting(\n  value: number,\n  minimum: number,\n  maximum: number,\n  grid:\n    ResolvedNumericSettingGrid,\n  path: string\n): void {\n  if (\n    !Number.isFinite(value) ||\n    value < minimum ||\n    value > maximum\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" lies outside the resolved equipment capability range.\"\n    );\n  }\n\n  if (\n    grid.kind ===\n      \"discrete-values\" &&\n    !grid.values.some(\n      (candidate) =>\n        Math.abs(\n          candidate - value\n        ) <=\n        Math.max(\n          1,\n          Math.abs(value)\n        ) *\n          1e-12\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" is not present in the resolved equipment setting grid.\"\n    );\n  }\n}\n\nfunction validateExposure(\n  exposure:\n    ReleaseBaseCaptureState[\"exposure\"],\n  capabilities:\n    ResolvedGenericEquipmentExposureCapabilities,\n  path: string\n): void {\n  validateGridSetting(\n    exposure.aperture,\n    capabilities.aperture\n      .widestAvailableFNumber,\n    capabilities.aperture\n      .narrowestAvailableFNumber,\n    capabilities.aperture\n      .settingGrid,\n    path + \".aperture\"\n  );\n  validateGridSetting(\n    exposure.shutterSeconds,\n    capabilities.shutter\n      .minimumSeconds,\n    capabilities.shutter\n      .maximumSeconds,\n    capabilities.shutter\n      .settingGrid,\n    path + \".shutterSeconds\"\n  );\n  validateGridSetting(\n    exposure.iso,\n    capabilities.iso.minimum,\n    capabilities.iso.maximum,\n    capabilities.iso.settingGrid,\n    path + \".iso\"\n  );\n}\n\nfunction resolveExposureBracket(\n  base:\n    ReleaseBaseCaptureState[\"exposure\"],\n  axis:\n    GenericExposureBracketAxis,\n  offsetStops: number\n): ReleaseBaseCaptureState[\"exposure\"] {\n  requireFinite(\n    offsetStops,\n    \"bracket.offsetsStops[]\"\n  );\n\n  if (axis === \"shutter\") {\n    return {\n      ...base,\n      shutterSeconds:\n        base.shutterSeconds *\n        Math.pow(2, offsetStops)\n    };\n  }\n  if (axis === \"iso\") {\n    return {\n      ...base,\n      iso:\n        base.iso *\n        Math.pow(2, offsetStops)\n    };\n  }\n  return {\n    ...base,\n    aperture:\n      base.aperture /\n      Math.pow(\n        2,\n        offsetStops / 2\n      )\n  };\n}\n\nfunction resolveFrameState(\n  input:\n    ResolveReleaseSequenceInput,\n  frameIndex: number\n): {\n  exposure:\n    ReleaseBaseCaptureState[\"exposure\"];\n  focus: FocusPlane;\n  exposureBracketOffsetStops?:\n    number;\n} {\n  if (input.bracket.kind === \"none\") {\n    return {\n      exposure:\n        cloneJson(\n          input.baseState.exposure\n        ),\n      focus:\n        parseFocusPlane(\n          input.baseState.focus\n        )\n    };\n  }\n\n  if (\n    input.bracket.kind ===\n    \"exposure\"\n  ) {\n    const offset =\n      input.bracket\n        .offsetsStops[\n          frameIndex\n        ];\n    if (offset === undefined) {\n      throw new InvalidScientificInputError(\n        \"Exposure bracket frame index is out of range.\"\n      );\n    }\n    return {\n      exposure:\n        resolveExposureBracket(\n          input.baseState.exposure,\n          input.bracket.axis,\n          offset\n        ),\n      focus:\n        parseFocusPlane(\n          input.baseState.focus\n        ),\n      exposureBracketOffsetStops:\n        offset\n    };\n  }\n\n  const focus =\n    input.bracket\n      .focusStates[frameIndex];\n  if (focus === undefined) {\n    throw new InvalidScientificInputError(\n      \"Focus bracket frame index is out of range.\"\n    );\n  }\n  return {\n    exposure:\n      cloneJson(\n        input.baseState.exposure\n      ),\n    focus:\n      parseFocusPlane(focus)\n  };\n}\n\nfunction validateBracketSupport(\n  input:\n    ResolveReleaseSequenceInput,\n  capabilities:\n    GenericReleaseCapabilityProfile\n): void {\n  if (\n    input.bracket.kind ===\n    \"exposure\"\n  ) {\n    if (\n      capabilities\n        .exposureBracketing\n        .availability.value !==\n      \"supported\"\n    ) {\n      throw new InvalidScientificInputError(\n        \"Exposure bracketing is not supported by the selected release capability profile.\"\n      );\n    }\n    if (\n      !capabilities\n        .exposureBracketing\n        .supportedAxes\n        .includes(\n          input.bracket.axis\n        )\n    ) {\n      throw new InvalidScientificInputError(\n        \"The selected exposure-bracket axis is not supported by the release capability profile.\"\n      );\n    }\n  }\n\n  if (\n    input.bracket.kind ===\n      \"focus\" &&\n    capabilities\n      .focusBracketing\n      .availability.value !==\n      \"supported\"\n  ) {\n    throw new InvalidScientificInputError(\n      \"Focus bracketing is not supported by the selected release capability profile.\"\n    );\n  }\n}\n\nfunction resolveSelfTimerDelay(\n  drive: ReleaseDrivePolicy\n): number {\n  if (drive.kind !== \"self-timer\") {\n    return 0;\n  }\n  return requireNonNegativeFinite(\n    drive.delaySeconds,\n    \"drive.delaySeconds\"\n  );\n}\n\nfunction resolveRequestedCadence(\n  frameCount: number,\n  requestedCadenceFps:\n    number | undefined\n): number | null {\n  if (frameCount <= 1) {\n    if (\n      requestedCadenceFps !==\n      undefined\n    ) {\n      requirePositiveFinite(\n        requestedCadenceFps,\n        \"requestedCadenceFps\"\n      );\n    }\n    return null;\n  }\n  if (\n    requestedCadenceFps ===\n    undefined\n  ) {\n    throw new InvalidScientificInputError(\n      \"requestedCadenceFps is required for a multi-frame physical sequence.\"\n    );\n  }\n  return requirePositiveFinite(\n    requestedCadenceFps,\n    \"requestedCadenceFps\"\n  );\n}\n\nfunction intervalForPreviousFrame(\n  previousFrame:\n    ResolvedReleaseFrame,\n  requestedCadenceFps: number,\n  capabilities:\n    GenericReleaseCapabilityProfile\n): {\n  seconds: number;\n  constraints:\n    readonly ReleaseTimingConstraint[];\n} {\n  const requested =\n    1 / requestedCadenceFps;\n  const capability =\n    1 /\n    capabilities\n      .maximumCadenceFps.value;\n  const exposure =\n    previousFrame\n      .exposure.shutterSeconds;\n  const gap =\n    capabilities\n      .minimumInterFrameGapSeconds\n      .value;\n  const physical =\n    exposure + gap;\n  const seconds =\n    Math.max(\n      requested,\n      capability,\n      physical\n    );\n\n  const tolerance =\n    Math.max(1, seconds) *\n    1e-12;\n  const constraints:\n    ReleaseTimingConstraint[] =\n      [];\n\n  if (\n    Math.abs(\n      seconds - requested\n    ) <= tolerance\n  ) {\n    constraints.push(\n      \"requested-cadence\"\n    );\n  }\n  if (\n    Math.abs(\n      seconds - capability\n    ) <= tolerance\n  ) {\n    constraints.push(\n      \"body-maximum-cadence\"\n    );\n  }\n  if (\n    Math.abs(\n      seconds - physical\n    ) <= tolerance\n  ) {\n    constraints.push(\n      \"exposure-duration\"\n    );\n    if (gap > 0) {\n      constraints.push(\n        \"minimum-inter-frame-gap\"\n      );\n    }\n  }\n\n  return {\n    seconds,\n    constraints\n  };\n}\n\n/**\n * Resolves one deterministic still-release sequence.\n *\n * It schedules logical exposures only; how the sensor captures each one is\n * handled elsewhere. Render speed or frame rate is never used as capture timing.\n */\nexport function resolveReleaseSequence(\n  input:\n    ResolveReleaseSequenceInput\n): ResolvedReleaseSequence {\n  requireInputKeys(input, \"resolveReleaseSequence\", [\"sequenceId\", \"releaseRequestTimeSeconds\", \"sequenceSeedUint32\", \"drive\", \"bracket\", \"requestedCadenceFps\", \"baseState\", \"releaseCapabilities\", \"exposureCapabilities\"]);\n  const sequenceId =\n    requireNonEmptyString(\n      input.sequenceId,\n      \"sequenceId\"\n    );\n  const releaseRequestTime =\n    requireFinite(\n      input\n        .releaseRequestTimeSeconds,\n      \"releaseRequestTimeSeconds\"\n    );\n  const sequenceSeed =\n    requireUint32(\n      input.sequenceSeedUint32,\n      \"sequenceSeedUint32\"\n    );\n\n  const releaseCapabilities =\n    parseGenericReleaseCapabilityProfile(\n      input.releaseCapabilities\n    );\n\n  if (\n    !includesDriveMode(\n      releaseCapabilities,\n      input.drive.kind\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"The selected drive mode is not supported by the release capability profile.\"\n    );\n  }\n\n  validateBracketSupport(\n    input,\n    releaseCapabilities\n  );\n\n  const frameCount =\n    resolveFrameCount(\n      input.drive,\n      input.bracket\n    );\n\n  if (\n    frameCount >\n    releaseCapabilities\n      .maximumLogicalFramesPerSequence\n      .value\n  ) {\n    throw new InvalidScientificInputError(\n      \"Requested sequence frame count exceeds the release capability profile.\"\n    );\n  }\n\n  const requestedCadenceFps =\n    resolveRequestedCadence(\n      frameCount,\n      input.requestedCadenceFps\n    );\n\n  const selfTimerDelay =\n    resolveSelfTimerDelay(\n      input.drive\n    );\n\n  const baseState:\n    ReleaseBaseCaptureState = {\n    exposure:\n      cloneJson(\n        input.baseState.exposure\n      ),\n    focus:\n      parseFocusPlane(\n        input.baseState.focus\n      ),\n    automation:\n      cloneJson(\n        input.baseState.automation\n      ),\n    ...(input.baseState\n      .whiteBalanceStateId ===\n    undefined\n      ? {}\n      : {\n          whiteBalanceStateId:\n            requireNonEmptyString(\n              input.baseState\n                .whiteBalanceStateId,\n              \"baseState.whiteBalanceStateId\"\n            )\n        })\n  };\n\n  validateExposure(\n    baseState.exposure,\n    input.exposureCapabilities,\n    \"baseState.exposure\"\n  );\n\n  const frames:\n    ResolvedReleaseFrame[] = [];\n\n  for (\n    let frameIndex = 0;\n    frameIndex < frameCount;\n    frameIndex += 1\n  ) {\n    const state =\n      resolveFrameState(\n        input,\n        frameIndex\n      );\n    validateExposure(\n      state.exposure,\n      input.exposureCapabilities,\n      \"frames[\" +\n        frameIndex +\n        \"].exposure\"\n    );\n\n    let exposureStartTimeSeconds:\n      number;\n    let startInterval:\n      number | null = null;\n    let timingConstraints:\n      readonly ReleaseTimingConstraint[] =\n        [];\n\n    if (frameIndex === 0) {\n      exposureStartTimeSeconds =\n        releaseRequestTime +\n        selfTimerDelay;\n    } else {\n      const previous =\n        frames[\n          frameIndex - 1\n        ]!;\n      if (\n        requestedCadenceFps ===\n        null\n      ) {\n        throw new InvalidScientificInputError(\n          \"Multi-frame sequence lost its requested cadence.\"\n        );\n      }\n      const interval =\n        intervalForPreviousFrame(\n          previous,\n          requestedCadenceFps,\n          releaseCapabilities\n        );\n      startInterval =\n        interval.seconds;\n      timingConstraints =\n        interval.constraints;\n      exposureStartTimeSeconds =\n        previous\n          .exposureStartTimeSeconds +\n        interval.seconds;\n    }\n\n    const exposureEndTimeSeconds =\n      exposureStartTimeSeconds +\n      state.exposure\n        .shutterSeconds;\n\n    if (\n      !Number.isFinite(\n        exposureStartTimeSeconds\n      ) ||\n      !Number.isFinite(\n        exposureEndTimeSeconds\n      )\n    ) {\n      throw new InvalidScientificInputError(\n        \"Resolved release-sequence timing must remain finite.\"\n      );\n    }\n\n    frames.push({\n      sequenceId,\n      frameIndex,\n      releaseFrameId:\n        sequenceId +\n        \":frame:\" +\n        frameIndex,\n      exposureStartTimeSeconds,\n      exposureEndTimeSeconds,\n      sceneTimeSecondsFromSequenceStart:\n        exposureStartTimeSeconds -\n        releaseRequestTime,\n      startIntervalFromPreviousSeconds:\n        startInterval,\n      timingConstraints,\n      stochasticSeedUint32:\n        hashFrameSeed(\n          sequenceSeed,\n          frameIndex\n        ),\n      exposure:\n        cloneJson(\n          state.exposure\n        ),\n      focus:\n        cloneJson(\n          state.focus\n        ),\n      ...(state\n        .exposureBracketOffsetStops ===\n      undefined\n        ? {}\n        : {\n            exposureBracketOffsetStops:\n              state\n                .exposureBracketOffsetStops\n          }),\n      automation:\n        cloneJson(\n          baseState.automation\n        ),\n      ...(baseState\n        .whiteBalanceStateId ===\n      undefined\n        ? {}\n        : {\n            whiteBalanceStateId:\n              baseState\n                .whiteBalanceStateId\n          })\n    });\n  }\n\n  const sequence:\n    ResolvedReleaseSequence = {\n    version:\n      RELEASE_SEQUENCE_VERSION,\n    sequenceId,\n    status: \"scheduled\",\n    releaseRequestTimeSeconds:\n      releaseRequestTime,\n    selfTimerDelaySeconds:\n      selfTimerDelay,\n    requestedCadenceFps,\n    capabilityMaximumCadenceFps:\n      releaseCapabilities\n        .maximumCadenceFps.value,\n    minimumInterFrameGapSeconds:\n      releaseCapabilities\n        .minimumInterFrameGapSeconds\n        .value,\n    requestedFrameCount:\n      frameCount,\n    actualFrameCount:\n      frames.length,\n    sequenceSeedUint32:\n      sequenceSeed,\n    baseStateSnapshot:\n      baseState,\n    frames,\n    sensorCaptureModeOwnership:\n      \"separate-logical-capture-contract\",\n    whiteBalanceBracketingPhysicalCaptures:\n      false,\n    preReleaseCaptureModeled:\n      false,\n    bufferMediaThermalSlowdownModeled:\n      false\n  };\n\n  return deepFreeze(\n    cloneJson(sequence)\n  );\n}\n\n/**\n * Returns a cancelled copy of a sequence. The original scheduled sequence is not\n * changed, and it is always clear which frames were completed and which were dropped.\n */\nexport function createCancelledReleaseSequence(\n  input:\n    CancelReleaseSequenceInput\n): CancelledReleaseSequence {\n  requireInputKeys(input, \"createCancelledReleaseSequence\", [\"sequence\", \"completedFrameCount\", \"cancelledAtSeconds\"]);\n  const count =\n    requireNonNegativeFinite(\n      input.completedFrameCount,\n      \"completedFrameCount\"\n    );\n  if (\n    !Number.isSafeInteger(count)\n  ) {\n    throw new InvalidScientificInputError(\n      \"completedFrameCount must be a safe integer.\"\n    );\n  }\n  if (\n    count >\n    input.sequence.frames.length\n  ) {\n    throw new InvalidScientificInputError(\n      \"completedFrameCount must not exceed the source sequence frame count.\"\n    );\n  }\n\n  const cancelledAt =\n    requireFinite(\n      input.cancelledAtSeconds,\n      \"cancelledAtSeconds\"\n    );\n\n  const result:\n    CancelledReleaseSequence = {\n    version:\n      RELEASE_SEQUENCE_VERSION,\n    sequenceId:\n      input.sequence.sequenceId,\n    status: \"cancelled\",\n    cancelledAtSeconds:\n      cancelledAt,\n    completedFrameCount: count,\n    omittedFrameCount:\n      input.sequence.frames.length -\n      count,\n    completedFrames:\n      cloneJson(\n        input.sequence.frames.slice(\n          0,\n          count\n        )\n      ),\n    sourceSequenceFrameCount:\n      input.sequence.frames.length,\n    sourceSequenceUnmodified:\n      true\n  };\n\n  return deepFreeze(\n    cloneJson(result)\n  );\n}\n"]}
+{"version":3,"file":"release-sequence.js","sourceRoot":"","sources":["../../src/capture/release-sequence.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Shutter-release sequences for stills (single, burst, self-timer, bracketing), scheduled as logical exposures, and\n * cancelling a sequence part-way.\n *\n * This only schedules exposures; how the sensor captures each one is handled elsewhere. Render speed\n * or frame rate is never used as capture timing.\n * @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  parseGenericReleaseCapabilityProfile,\n  type GenericExposureBracketAxis,\n  type GenericReleaseCapabilityProfile\n} from \"../equipment/release-capabilities.js\";\nimport type {\n  ResolvedGenericEquipmentExposureCapabilities,\n  ResolvedNumericSettingGrid\n} from \"../equipment/exposure-capabilities.js\";\nimport {\n  parseFocusPlane,\n  type FocusPlane\n} from \"../optics/focus-state.js\";\nimport { requireInputKeys, requireTrimmedConfigString as requireNonEmptyString, requireInputFinite as requireFinite, requireInputFiniteAboveZero as requirePositiveFinite, requireInputFiniteAtLeastZero as requireNonNegativeFinite } from \"../core/record-validation.js\";\nimport { deepFreeze, cloneJson } from \"../core/shared-helpers.js\";\n\nexport const RELEASE_SEQUENCE_VERSION =\n  \"0.1.0\" as const;\n\nexport type ReleaseAutomationState =\n  | \"manual\"\n  | \"locked\"\n  | \"continuous\";\n\nexport interface ReleaseBaseCaptureState {\n  exposure: {\n    aperture: number;\n    shutterSeconds: number;\n    iso: number;\n  };\n  focus: FocusPlane;\n  whiteBalanceStateId?: string;\n  automation: {\n    ae: ReleaseAutomationState;\n    af: ReleaseAutomationState;\n    awb: ReleaseAutomationState;\n  };\n}\n\nexport type ReleaseDrivePolicy =\n  | {\n      kind: \"single\";\n    }\n  | {\n      kind: \"burst\";\n      frameCount: number;\n    }\n  | {\n      kind: \"self-timer\";\n      delaySeconds: number;\n      frameCount: number;\n    };\n\nexport type ReleaseBracketPolicy =\n  | {\n      kind: \"none\";\n    }\n  | {\n      kind: \"exposure\";\n      axis:\n        GenericExposureBracketAxis;\n      offsetsStops:\n        readonly number[];\n    }\n  | {\n      kind: \"focus\";\n      focusStates:\n        readonly FocusPlane[];\n    };\n\nexport interface ResolveReleaseSequenceInput {\n  sequenceId: string;\n  releaseRequestTimeSeconds: number;\n  sequenceSeedUint32: number;\n  drive: ReleaseDrivePolicy;\n  bracket: ReleaseBracketPolicy;\n  requestedCadenceFps?: number;\n  baseState:\n    ReleaseBaseCaptureState;\n  releaseCapabilities:\n    GenericReleaseCapabilityProfile;\n  exposureCapabilities:\n    ResolvedGenericEquipmentExposureCapabilities;\n}\n\nexport type ReleaseTimingConstraint =\n  | \"requested-cadence\"\n  | \"body-maximum-cadence\"\n  | \"exposure-duration\"\n  | \"minimum-inter-frame-gap\";\n\nexport interface ResolvedReleaseFrame {\n  sequenceId: string;\n  frameIndex: number;\n  releaseFrameId: string;\n  exposureStartTimeSeconds: number;\n  exposureEndTimeSeconds: number;\n  sceneTimeSecondsFromSequenceStart:\n    number;\n  startIntervalFromPreviousSeconds:\n    number | null;\n  timingConstraints:\n    readonly ReleaseTimingConstraint[];\n  stochasticSeedUint32: number;\n  exposure: {\n    aperture: number;\n    shutterSeconds: number;\n    iso: number;\n  };\n  focus: FocusPlane;\n  exposureBracketOffsetStops?:\n    number;\n  automation:\n    ReleaseBaseCaptureState[\"automation\"];\n  whiteBalanceStateId?: string;\n}\n\nexport interface ResolvedReleaseSequence {\n  version:\n    typeof RELEASE_SEQUENCE_VERSION;\n  sequenceId: string;\n  status: \"scheduled\";\n  releaseRequestTimeSeconds: number;\n  selfTimerDelaySeconds: number;\n  requestedCadenceFps:\n    number | null;\n  capabilityMaximumCadenceFps:\n    number;\n  minimumInterFrameGapSeconds:\n    number;\n  requestedFrameCount: number;\n  actualFrameCount: number;\n  sequenceSeedUint32: number;\n  baseStateSnapshot:\n    ReleaseBaseCaptureState;\n  frames:\n    readonly ResolvedReleaseFrame[];\n  sensorCaptureModeOwnership:\n    \"separate-logical-capture-contract\";\n  whiteBalanceBracketingPhysicalCaptures:\n    false;\n  preReleaseCaptureModeled:\n    false;\n  bufferMediaThermalSlowdownModeled:\n    false;\n}\n\nexport interface CancelReleaseSequenceInput {\n  sequence:\n    ResolvedReleaseSequence;\n  completedFrameCount: number;\n  cancelledAtSeconds: number;\n}\n\nexport interface CancelledReleaseSequence {\n  version:\n    typeof RELEASE_SEQUENCE_VERSION;\n  sequenceId: string;\n  status: \"cancelled\";\n  cancelledAtSeconds: number;\n  completedFrameCount: number;\n  omittedFrameCount: number;\n  completedFrames:\n    readonly ResolvedReleaseFrame[];\n  sourceSequenceFrameCount: number;\n  sourceSequenceUnmodified: true;\n}\n\nfunction requirePositiveSafeInteger(\n  value: number,\n  path: string\n): number {\n  if (\n    !Number.isSafeInteger(value) ||\n    value <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be a positive safe integer.\"\n    );\n  }\n  return value;\n}\n\nfunction requireUint32(\n  value: number,\n  path: string\n): number {\n  if (\n    !Number.isSafeInteger(value) ||\n    value < 0 ||\n    value > 0xffff_ffff\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be an unsigned 32-bit integer.\"\n    );\n  }\n  return value;\n}\n\nfunction hashFrameSeed(\n  sequenceSeedUint32: number,\n  frameIndex: number\n): number {\n  let hash = 0x811c9dc5;\n  const text =\n    sequenceSeedUint32.toString(10) +\n    \":\" +\n    frameIndex.toString(10);\n  for (\n    let index = 0;\n    index < text.length;\n    index += 1\n  ) {\n    hash ^= text.charCodeAt(index);\n    hash = Math.imul(\n      hash,\n      0x01000193\n    ) >>> 0;\n  }\n  return hash >>> 0;\n}\n\nfunction includesDriveMode(\n  capabilities:\n    GenericReleaseCapabilityProfile,\n  drive:\n    ReleaseDrivePolicy[\"kind\"]\n): boolean {\n  return capabilities\n    .supportedDriveModes\n    .value.includes(drive);\n}\n\nfunction driveFrameCount(\n  drive: ReleaseDrivePolicy\n): number {\n  if (drive.kind === \"single\") {\n    return 1;\n  }\n  return requirePositiveSafeInteger(\n    drive.frameCount,\n    \"drive.frameCount\"\n  );\n}\n\nfunction bracketFrameCount(\n  bracket:\n    ReleaseBracketPolicy\n): number | null {\n  if (bracket.kind === \"none\") {\n    return null;\n  }\n  const count =\n    bracket.kind === \"exposure\"\n      ? bracket.offsetsStops.length\n      : bracket.focusStates.length;\n  if (count <= 0) {\n    throw new InvalidScientificInputError(\n      \"Bracket sequences must contain at least one frame.\"\n    );\n  }\n  return count;\n}\n\nfunction resolveFrameCount(\n  drive: ReleaseDrivePolicy,\n  bracket:\n    ReleaseBracketPolicy\n): number {\n  const driveCount =\n    driveFrameCount(drive);\n  const bracketCount =\n    bracketFrameCount(bracket);\n\n  if (bracketCount === null) {\n    return driveCount;\n  }\n\n  if (drive.kind === \"burst\") {\n    throw new InvalidScientificInputError(\n      \"Schema 0.1.0 does not combine burst drive with bracketing; choose one multi-frame policy explicitly.\"\n    );\n  }\n\n  if (\n    drive.kind === \"self-timer\" &&\n    driveCount !== bracketCount\n  ) {\n    throw new InvalidScientificInputError(\n      \"Self-timer frameCount must match the bracket frame count.\"\n    );\n  }\n\n  return bracketCount;\n}\n\nfunction validateGridSetting(\n  value: number,\n  minimum: number,\n  maximum: number,\n  grid:\n    ResolvedNumericSettingGrid,\n  path: string\n): void {\n  if (\n    !Number.isFinite(value) ||\n    value < minimum ||\n    value > maximum\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" lies outside the resolved equipment capability range.\"\n    );\n  }\n\n  if (\n    grid.kind ===\n      \"discrete-values\" &&\n    !grid.values.some(\n      (candidate) =>\n        Math.abs(\n          candidate - value\n        ) <=\n        Math.max(\n          1,\n          Math.abs(value)\n        ) *\n          1e-12\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" is not present in the resolved equipment setting grid.\"\n    );\n  }\n}\n\nfunction validateExposure(\n  exposure:\n    ReleaseBaseCaptureState[\"exposure\"],\n  capabilities:\n    ResolvedGenericEquipmentExposureCapabilities,\n  path: string\n): void {\n  validateGridSetting(\n    exposure.aperture,\n    capabilities.aperture\n      .widestAvailableFNumber,\n    capabilities.aperture\n      .narrowestAvailableFNumber,\n    capabilities.aperture\n      .settingGrid,\n    path + \".aperture\"\n  );\n  validateGridSetting(\n    exposure.shutterSeconds,\n    capabilities.shutter\n      .minimumSeconds,\n    capabilities.shutter\n      .maximumSeconds,\n    capabilities.shutter\n      .settingGrid,\n    path + \".shutterSeconds\"\n  );\n  validateGridSetting(\n    exposure.iso,\n    capabilities.iso.minimum,\n    capabilities.iso.maximum,\n    capabilities.iso.settingGrid,\n    path + \".iso\"\n  );\n}\n\nfunction resolveExposureBracket(\n  base:\n    ReleaseBaseCaptureState[\"exposure\"],\n  axis:\n    GenericExposureBracketAxis,\n  offsetStops: number\n): ReleaseBaseCaptureState[\"exposure\"] {\n  requireFinite(\n    offsetStops,\n    \"bracket.offsetsStops[]\"\n  );\n\n  if (axis === \"shutter\") {\n    return {\n      ...base,\n      shutterSeconds:\n        base.shutterSeconds *\n        Math.pow(2, offsetStops)\n    };\n  }\n  if (axis === \"iso\") {\n    return {\n      ...base,\n      iso:\n        base.iso *\n        Math.pow(2, offsetStops)\n    };\n  }\n  return {\n    ...base,\n    aperture:\n      base.aperture /\n      Math.pow(\n        2,\n        offsetStops / 2\n      )\n  };\n}\n\nfunction resolveFrameState(\n  input:\n    ResolveReleaseSequenceInput,\n  frameIndex: number\n): {\n  exposure:\n    ReleaseBaseCaptureState[\"exposure\"];\n  focus: FocusPlane;\n  exposureBracketOffsetStops?:\n    number;\n} {\n  if (input.bracket.kind === \"none\") {\n    return {\n      exposure:\n        cloneJson(\n          input.baseState.exposure\n        ),\n      focus:\n        parseFocusPlane(\n          input.baseState.focus\n        )\n    };\n  }\n\n  if (\n    input.bracket.kind ===\n    \"exposure\"\n  ) {\n    const offset =\n      input.bracket\n        .offsetsStops[\n          frameIndex\n        ];\n    if (offset === undefined) {\n      throw new InvalidScientificInputError(\n        \"Exposure bracket frame index is out of range.\"\n      );\n    }\n    return {\n      exposure:\n        resolveExposureBracket(\n          input.baseState.exposure,\n          input.bracket.axis,\n          offset\n        ),\n      focus:\n        parseFocusPlane(\n          input.baseState.focus\n        ),\n      exposureBracketOffsetStops:\n        offset\n    };\n  }\n\n  const focus =\n    input.bracket\n      .focusStates[frameIndex];\n  if (focus === undefined) {\n    throw new InvalidScientificInputError(\n      \"Focus bracket frame index is out of range.\"\n    );\n  }\n  return {\n    exposure:\n      cloneJson(\n        input.baseState.exposure\n      ),\n    focus:\n      parseFocusPlane(focus)\n  };\n}\n\nfunction validateBracketSupport(\n  input:\n    ResolveReleaseSequenceInput,\n  capabilities:\n    GenericReleaseCapabilityProfile\n): void {\n  if (\n    input.bracket.kind ===\n    \"exposure\"\n  ) {\n    if (\n      capabilities\n        .exposureBracketing\n        .availability.value !==\n      \"supported\"\n    ) {\n      throw new InvalidScientificInputError(\n        \"Exposure bracketing is not supported by the selected release capability profile.\"\n      );\n    }\n    if (\n      !capabilities\n        .exposureBracketing\n        .supportedAxes\n        .includes(\n          input.bracket.axis\n        )\n    ) {\n      throw new InvalidScientificInputError(\n        \"The selected exposure-bracket axis is not supported by the release capability profile.\"\n      );\n    }\n  }\n\n  if (\n    input.bracket.kind ===\n      \"focus\" &&\n    capabilities\n      .focusBracketing\n      .availability.value !==\n      \"supported\"\n  ) {\n    throw new InvalidScientificInputError(\n      \"Focus bracketing is not supported by the selected release capability profile.\"\n    );\n  }\n}\n\nfunction resolveSelfTimerDelay(\n  drive: ReleaseDrivePolicy\n): number {\n  if (drive.kind !== \"self-timer\") {\n    return 0;\n  }\n  return requireNonNegativeFinite(\n    drive.delaySeconds,\n    \"drive.delaySeconds\"\n  );\n}\n\nfunction resolveRequestedCadence(\n  frameCount: number,\n  requestedCadenceFps:\n    number | undefined\n): number | null {\n  if (frameCount <= 1) {\n    if (\n      requestedCadenceFps !==\n      undefined\n    ) {\n      requirePositiveFinite(\n        requestedCadenceFps,\n        \"requestedCadenceFps\"\n      );\n    }\n    return null;\n  }\n  if (\n    requestedCadenceFps ===\n    undefined\n  ) {\n    throw new InvalidScientificInputError(\n      \"requestedCadenceFps is required for a multi-frame physical sequence.\"\n    );\n  }\n  return requirePositiveFinite(\n    requestedCadenceFps,\n    \"requestedCadenceFps\"\n  );\n}\n\nfunction intervalForPreviousFrame(\n  previousFrame:\n    ResolvedReleaseFrame,\n  requestedCadenceFps: number,\n  capabilities:\n    GenericReleaseCapabilityProfile\n): {\n  seconds: number;\n  constraints:\n    readonly ReleaseTimingConstraint[];\n} {\n  const requested =\n    1 / requestedCadenceFps;\n  const capability =\n    1 /\n    capabilities\n      .maximumCadenceFps.value;\n  const exposure =\n    previousFrame\n      .exposure.shutterSeconds;\n  const gap =\n    capabilities\n      .minimumInterFrameGapSeconds\n      .value;\n  const physical =\n    exposure + gap;\n  const seconds =\n    Math.max(\n      requested,\n      capability,\n      physical\n    );\n\n  const tolerance =\n    Math.max(1, seconds) *\n    1e-12;\n  const constraints:\n    ReleaseTimingConstraint[] =\n      [];\n\n  if (\n    Math.abs(\n      seconds - requested\n    ) <= tolerance\n  ) {\n    constraints.push(\n      \"requested-cadence\"\n    );\n  }\n  if (\n    Math.abs(\n      seconds - capability\n    ) <= tolerance\n  ) {\n    constraints.push(\n      \"body-maximum-cadence\"\n    );\n  }\n  if (\n    Math.abs(\n      seconds - physical\n    ) <= tolerance\n  ) {\n    constraints.push(\n      \"exposure-duration\"\n    );\n    if (gap > 0) {\n      constraints.push(\n        \"minimum-inter-frame-gap\"\n      );\n    }\n  }\n\n  return {\n    seconds,\n    constraints\n  };\n}\n\n/**\n * Resolves one deterministic still-release sequence.\n *\n * It schedules logical exposures only; how the sensor captures each one is\n * handled elsewhere. Render speed or frame rate is never used as capture timing.\n */\nexport function resolveReleaseSequence(\n  input:\n    ResolveReleaseSequenceInput\n): ResolvedReleaseSequence {\n  requireInputKeys(input, \"resolveReleaseSequence\", [\"sequenceId\", \"releaseRequestTimeSeconds\", \"sequenceSeedUint32\", \"drive\", \"bracket\", \"requestedCadenceFps\", \"baseState\", \"releaseCapabilities\", \"exposureCapabilities\"]);\n  const sequenceId =\n    requireNonEmptyString(\n      input.sequenceId,\n      \"sequenceId\"\n    );\n  const releaseRequestTime =\n    requireFinite(\n      input\n        .releaseRequestTimeSeconds,\n      \"releaseRequestTimeSeconds\"\n    );\n  const sequenceSeed =\n    requireUint32(\n      input.sequenceSeedUint32,\n      \"sequenceSeedUint32\"\n    );\n\n  const releaseCapabilities =\n    parseGenericReleaseCapabilityProfile(\n      input.releaseCapabilities\n    );\n\n  if (\n    !includesDriveMode(\n      releaseCapabilities,\n      input.drive.kind\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"The selected drive mode is not supported by the release capability profile.\"\n    );\n  }\n\n  validateBracketSupport(\n    input,\n    releaseCapabilities\n  );\n\n  const frameCount =\n    resolveFrameCount(\n      input.drive,\n      input.bracket\n    );\n\n  if (\n    frameCount >\n    releaseCapabilities\n      .maximumLogicalFramesPerSequence\n      .value\n  ) {\n    throw new InvalidScientificInputError(\n      \"Requested sequence frame count exceeds the release capability profile.\"\n    );\n  }\n\n  const requestedCadenceFps =\n    resolveRequestedCadence(\n      frameCount,\n      input.requestedCadenceFps\n    );\n\n  const selfTimerDelay =\n    resolveSelfTimerDelay(\n      input.drive\n    );\n\n  const baseState:\n    ReleaseBaseCaptureState = {\n    exposure:\n      cloneJson(\n        input.baseState.exposure\n      ),\n    focus:\n      parseFocusPlane(\n        input.baseState.focus\n      ),\n    automation:\n      cloneJson(\n        input.baseState.automation\n      ),\n    ...(input.baseState\n      .whiteBalanceStateId ===\n    undefined\n      ? {}\n      : {\n          whiteBalanceStateId:\n            requireNonEmptyString(\n              input.baseState\n                .whiteBalanceStateId,\n              \"baseState.whiteBalanceStateId\"\n            )\n        })\n  };\n\n  validateExposure(\n    baseState.exposure,\n    input.exposureCapabilities,\n    \"baseState.exposure\"\n  );\n\n  const frames:\n    ResolvedReleaseFrame[] = [];\n\n  for (\n    let frameIndex = 0;\n    frameIndex < frameCount;\n    frameIndex += 1\n  ) {\n    const state =\n      resolveFrameState(\n        input,\n        frameIndex\n      );\n    validateExposure(\n      state.exposure,\n      input.exposureCapabilities,\n      \"frames[\" +\n        frameIndex +\n        \"].exposure\"\n    );\n\n    let exposureStartTimeSeconds:\n      number;\n    let startInterval:\n      number | null = null;\n    let timingConstraints:\n      readonly ReleaseTimingConstraint[] =\n        [];\n\n    if (frameIndex === 0) {\n      exposureStartTimeSeconds =\n        releaseRequestTime +\n        selfTimerDelay;\n    } else {\n      const previous =\n        frames[\n          frameIndex - 1\n        ]!;\n      if (\n        requestedCadenceFps ===\n        null\n      ) {\n        throw new InvalidScientificInputError(\n          \"Multi-frame sequence lost its requested cadence.\"\n        );\n      }\n      const interval =\n        intervalForPreviousFrame(\n          previous,\n          requestedCadenceFps,\n          releaseCapabilities\n        );\n      startInterval =\n        interval.seconds;\n      timingConstraints =\n        interval.constraints;\n      exposureStartTimeSeconds =\n        previous\n          .exposureStartTimeSeconds +\n        interval.seconds;\n    }\n\n    const exposureEndTimeSeconds =\n      exposureStartTimeSeconds +\n      state.exposure\n        .shutterSeconds;\n\n    if (\n      !Number.isFinite(\n        exposureStartTimeSeconds\n      ) ||\n      !Number.isFinite(\n        exposureEndTimeSeconds\n      )\n    ) {\n      throw new InvalidScientificInputError(\n        \"Resolved release-sequence timing must remain finite.\"\n      );\n    }\n\n    frames.push({\n      sequenceId,\n      frameIndex,\n      releaseFrameId:\n        sequenceId +\n        \":frame:\" +\n        frameIndex,\n      exposureStartTimeSeconds,\n      exposureEndTimeSeconds,\n      sceneTimeSecondsFromSequenceStart:\n        exposureStartTimeSeconds -\n        releaseRequestTime,\n      startIntervalFromPreviousSeconds:\n        startInterval,\n      timingConstraints,\n      stochasticSeedUint32:\n        hashFrameSeed(\n          sequenceSeed,\n          frameIndex\n        ),\n      exposure:\n        cloneJson(\n          state.exposure\n        ),\n      focus:\n        cloneJson(\n          state.focus\n        ),\n      ...(state\n        .exposureBracketOffsetStops ===\n      undefined\n        ? {}\n        : {\n            exposureBracketOffsetStops:\n              state\n                .exposureBracketOffsetStops\n          }),\n      automation:\n        cloneJson(\n          baseState.automation\n        ),\n      ...(baseState\n        .whiteBalanceStateId ===\n      undefined\n        ? {}\n        : {\n            whiteBalanceStateId:\n              baseState\n                .whiteBalanceStateId\n          })\n    });\n  }\n\n  const sequence:\n    ResolvedReleaseSequence = {\n    version:\n      RELEASE_SEQUENCE_VERSION,\n    sequenceId,\n    status: \"scheduled\",\n    releaseRequestTimeSeconds:\n      releaseRequestTime,\n    selfTimerDelaySeconds:\n      selfTimerDelay,\n    requestedCadenceFps,\n    capabilityMaximumCadenceFps:\n      releaseCapabilities\n        .maximumCadenceFps.value,\n    minimumInterFrameGapSeconds:\n      releaseCapabilities\n        .minimumInterFrameGapSeconds\n        .value,\n    requestedFrameCount:\n      frameCount,\n    actualFrameCount:\n      frames.length,\n    sequenceSeedUint32:\n      sequenceSeed,\n    baseStateSnapshot:\n      baseState,\n    frames,\n    sensorCaptureModeOwnership:\n      \"separate-logical-capture-contract\",\n    whiteBalanceBracketingPhysicalCaptures:\n      false,\n    preReleaseCaptureModeled:\n      false,\n    bufferMediaThermalSlowdownModeled:\n      false\n  };\n\n  return deepFreeze(\n    cloneJson(sequence)\n  );\n}\n\n/**\n * Returns a cancelled copy of a sequence. The original scheduled sequence is not\n * changed, and it is always clear which frames were completed and which were dropped.\n */\nexport function createCancelledReleaseSequence(\n  input:\n    CancelReleaseSequenceInput\n): CancelledReleaseSequence {\n  requireInputKeys(input, \"createCancelledReleaseSequence\", [\"sequence\", \"completedFrameCount\", \"cancelledAtSeconds\"]);\n  const count =\n    requireNonNegativeFinite(\n      input.completedFrameCount,\n      \"completedFrameCount\"\n    );\n  if (\n    !Number.isSafeInteger(count)\n  ) {\n    throw new InvalidScientificInputError(\n      \"completedFrameCount must be a safe integer.\"\n    );\n  }\n  if (\n    count >\n    input.sequence.frames.length\n  ) {\n    throw new InvalidScientificInputError(\n      \"completedFrameCount must not exceed the source sequence frame count.\"\n    );\n  }\n\n  const cancelledAt =\n    requireFinite(\n      input.cancelledAtSeconds,\n      \"cancelledAtSeconds\"\n    );\n\n  const result:\n    CancelledReleaseSequence = {\n    version:\n      RELEASE_SEQUENCE_VERSION,\n    sequenceId:\n      input.sequence.sequenceId,\n    status: \"cancelled\",\n    cancelledAtSeconds:\n      cancelledAt,\n    completedFrameCount: count,\n    omittedFrameCount:\n      input.sequence.frames.length -\n      count,\n    completedFrames:\n      cloneJson(\n        input.sequence.frames.slice(\n          0,\n          count\n        )\n      ),\n    sourceSequenceFrameCount:\n      input.sequence.frames.length,\n    sourceSequenceUnmodified:\n      true\n  };\n\n  return deepFreeze(\n    cloneJson(result)\n  );\n}\n"]}

package/dist/color/white-balance.d.ts

@@ -159,6 +159,7 @@ export interface CreateLockedWhiteBalanceStateInput {
     stateId: string;
     sourceState: ResolvedWhiteBalanceState;
 }
+export declare function requireFraction(value: unknown, path: string): number;
 /**
  * Parses generic WB presets and AWB policies.
  *
@@ -166,6 +167,7 @@ export interface CreateLockedWhiteBalanceStateInput {
  * treated as a universal Kelvin value or as any manufacturer's behaviour.
  */
 export declare function parseWhiteBalanceProfile(value: unknown): WhiteBalanceProfile;
+export declare function requireScientificFinite(value: number, path: string): number;
 /** Resolves a WB preset defined by the profile. No universal label-to-Kelvin rule is applied. */
 export declare function resolvePresetWhiteBalance(input: ResolvePresetWhiteBalanceInput): ResolvedWhiteBalanceState;
 /** Resolves explicit manual camera-linear channel gains. */

package/dist/color/white-balance.js

@@ -11,42 +11,13 @@
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError } from "../core/validation.js";
-import { requireInputObject, requireInputKeys, rejectUnknownFields } from "../core/record-validation.js";
+import { requireInputObject, requireInputKeys, requireConfigRecord as requireRecord, requireTrimmedConfigString as requireNonEmptyString, requireTrimmedConfigString as requireScientificNonEmptyString, requireConfigFinite as requireFinite, requireConfigNonNegativeSafeInteger as requireNonNegativeSafeInteger, parseConfigLimitations as parseLimitations, requireConfigFiniteAboveZero as requirePositiveFinite } from "../core/record-validation.js";
 import { calculateChromaticityFromCorrelatedColorTemperature, calculatePortableChromaticityFromCorrelatedColorTemperature } from "./illuminants.js";
 import { multiplyMatrixVector, parseMatrix3x3, xyzOfChromaticity } from "./colorimetry-math.js";
 export const WHITE_BALANCE_PROFILE_SCHEMA_VERSION = "0.1.0";
 export const WHITE_BALANCE_STATE_VERSION = "0.1.0";
 export const COLOR_TEMPERATURE_WHITE_BALANCE_INTENT_VERSION = "0.1.0";
-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) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new InvalidConfigurationError(path + " must be a non-empty string.");
-    }
-    return value.trim();
-}
-function requireFinite(value, path) {
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new InvalidConfigurationError(path + " must be finite.");
-    }
-    return value;
-}
-function requirePositiveFinite(value, path) {
-    const parsed = requireFinite(value, path);
-    if (parsed <= 0) {
-        throw new InvalidConfigurationError(path + " must be greater than zero.");
-    }
-    return parsed;
-}
-function requireFraction(value, path) {
+export function requireFraction(value, path) {
     const parsed = requireFinite(value, path);
     if (parsed < 0 || parsed > 1) {
         throw new InvalidConfigurationError(path + " must be from zero through one.");
@@ -61,16 +32,6 @@ function parseChannelGains(value, path) {
         blue: requirePositiveFinite(record.blue, path + ".blue")
     };
 }
-function parseLimitations(value, path) {
-    if (!Array.isArray(value)) {
-        throw new InvalidConfigurationError(path + " must be an array.");
-    }
-    const parsed = value.map((entry, index) => requireNonEmptyString(entry, path + "[" + index + "]"));
-    if (new Set(parsed).size !== parsed.length) {
-        throw new InvalidConfigurationError(path + " must not contain duplicates.");
-    }
-    return parsed;
-}
 function parseOptionalLimitations(value, path) {
     return value === undefined ? undefined : parseLimitations(value, path);
 }
@@ -171,13 +132,7 @@ export function parseWhiteBalanceProfile(value) {
         limitations: parseLimitations(record.limitations, "whiteBalanceProfile.limitations")
     };
 }
-function requireScientificNonEmptyString(value, path) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new InvalidConfigurationError(path + " must be a non-empty string.");
-    }
-    return value.trim();
-}
-function requireScientificFinite(value, path) {
+export function requireScientificFinite(value, path) {
     if (!Number.isFinite(value)) {
         throw new InvalidScientificInputError(path + " must be finite.");
     }
@@ -530,14 +485,6 @@ export function createLockedWhiteBalanceState(input) {
         limitations: [...source.limitations]
     });
 }
-function requireNonNegativeSafeInteger(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isSafeInteger(value) ||
-        value < 0) {
-        throw new InvalidConfigurationError(path + " must be a non-negative safe integer.");
-    }
-    return value;
-}
 function requirePositiveSafeInteger(value, path) {
     const parsed = requireNonNegativeSafeInteger(value, path);
     if (parsed <= 0) {