@photivra/engine 1.4.0 → 2.0.0

package/dist/exposure/metering-target.js.map

@@ -1 +1 @@
-{"version":3,"file":"metering-target.js","sourceRoot":"","sources":["../../src/exposure/metering-target.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metering-target.js","sourceRoot":"","sources":["../../src/exposure/metering-target.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Meter targets: a frozen metering result that camera-control logic uses as its exposure target.\n *\n * The target copies the meter snapshot by value. Later changes to the scene or light do not change\n * it. This is what the engine provides for AE lock (auto-exposure lock).\n *\n * Exposure compensation is set as an absolute value. It is always worked out again from the base\n * target without compensation, so repeated UI updates cannot build up floating-point or control\n * drift. Positive compensation asks for more exposure.\n * @see docs/USAGE.md for the equations, units, coordinate conventions, known blockers and support\n * limits.\n */\n\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport type {\n  ExposureMeteringResult\n} from \"./metering.js\";\nimport type {\n  SceneRadianceTemporalExposureMeteringResult\n} from \"./metering-temporal.js\";\nimport { requireInputObject, requireInputKeys } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nexport const EXPOSURE_METER_TARGET_SCHEMA_VERSION =\n  \"0.1.0\" as const;\n\nexport type ExposureMeterTargetSourceResult =\n  | ExposureMeteringResult\n  | SceneRadianceTemporalExposureMeteringResult;\n\nexport type ExposureMeterTargetSourceKind =\n  | \"spatial-metering-result\"\n  | \"temporal-metering-result\";\n\nexport interface ExposureMeterSnapshotIdentity {\n  sourceKind:\n    ExposureMeterTargetSourceKind;\n  measurementId: string;\n  sceneStateId: string;\n  meteringProfileId: string;\n}\n\ninterface ExposureMeterTargetBase {\n  schemaVersion:\n    typeof EXPOSURE_METER_TARGET_SCHEMA_VERSION;\n  targetId: string;\n  sourceMeterSnapshot:\n    ExposureMeterSnapshotIdentity;\n  scientificStatus: \"approximation\";\n  inputDomain:\n    \"relative-pre-exposure-linear-signal\";\n  baseTargetRelativeSignal: number;\n  meteredRelativeSignal: number;\n  exposureCompensationStops: number;\n  exposureCompensationApplied: boolean;\n  meterMeasurementMutated: false;\n  sourceMeterSnapshotPreserved: true;\n  resultReusableForAeLock: true;\n  automaticExposureResolved: false;\n  intendedConsumer:\n    \"exposure-mode-resolver\";\n}\n\nexport type ExposureMeterTarget =\n  | (ExposureMeterTargetBase & {\n      status: \"resolved\";\n      baseRequiredExposureScaleToTarget:\n        number;\n      baseExposureOffsetStopsToTarget:\n        number;\n      requiredExposureScaleToTarget:\n        number;\n      exposureOffsetStopsToTarget:\n        number;\n    })\n  | (ExposureMeterTargetBase & {\n      status: \"no-signal\";\n      baseRequiredExposureScaleResolved:\n        false;\n      baseExposureOffsetStopsResolved:\n        false;\n      requiredExposureScaleResolved:\n        false;\n      exposureOffsetStopsResolved:\n        false;\n    });\n\nexport interface CreateExposureMeterTargetInput {\n  targetId: string;\n  meterResult:\n    ExposureMeterTargetSourceResult;\n}\n\nexport interface SetExposureCompensationOnMeterTargetInput {\n  targetId: string;\n  baseTarget: ExposureMeterTarget;\n  exposureCompensationStops: number;\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 + \" must be a non-empty string.\"\n    );\n  }\n  return value.trim();\n}\n\nfunction requireFinite(\n  value: unknown,\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 requirePositiveFinite(\n  value: unknown,\n  path: string\n): number {\n  const parsed = requireFinite(\n    value,\n    path\n  );\n  if (parsed <= 0) {\n    throw new InvalidScientificInputError(\n      path + \" must be greater than zero.\"\n    );\n  }\n  return parsed;\n}\n\nfunction requireNonNegativeFinite(\n  value: unknown,\n  path: string\n): number {\n  const parsed = requireFinite(\n    value,\n    path\n  );\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 meterSnapshotIdentity(\n  result:\n    ExposureMeterTargetSourceResult\n): ExposureMeterSnapshotIdentity {\n  const hasSpatialId =\n    \"measurementId\" in result;\n  const hasTemporalId =\n    \"temporalMeasurementId\" in\n    result;\n\n  if (\n    hasSpatialId === hasTemporalId\n  ) {\n    throw new InvalidScientificInputError(\n      \"meterResult must identify exactly one spatial or temporal metering result.\"\n    );\n  }\n\n  return {\n    sourceKind: hasSpatialId\n      ? \"spatial-metering-result\"\n      : \"temporal-metering-result\",\n    measurementId:\n      requireNonEmptyString(\n        hasSpatialId\n          ? result.measurementId\n          : result\n              .temporalMeasurementId,\n        hasSpatialId\n          ? \"meterResult.measurementId\"\n          : \"meterResult.temporalMeasurementId\"\n      ),\n    sceneStateId:\n      requireNonEmptyString(\n        result.sceneStateId,\n        \"meterResult.sceneStateId\"\n      ),\n    meteringProfileId:\n      requireNonEmptyString(\n        result.profileId,\n        \"meterResult.profileId\"\n      )\n  };\n}\n\nfunction validateCommonMeterResult(\n  result:\n    ExposureMeterTargetSourceResult\n): void {\n  requireInputObject(result, \"result input\");\n  if (\n    result.scientificStatus !==\n    \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      'meterResult.scientificStatus must be \"approximation\" for schema 0.1.0.'\n    );\n  }\n  if (\n    result.inputDomain !==\n    \"relative-pre-exposure-linear-signal\"\n  ) {\n    throw new InvalidConfigurationError(\n      'meterResult.inputDomain must be \"relative-pre-exposure-linear-signal\".'\n    );\n  }\n  if (\n    result.exposureCompensationApplied !==\n    false\n  ) {\n    throw new InvalidScientificInputError(\n      \"meterResult must be the uncompensated base metering result.\"\n    );\n  }\n  if (\n    result.automaticExposureResolved !==\n    false\n  ) {\n    throw new InvalidScientificInputError(\n      \"meterResult must precede automatic exposure resolution.\"\n    );\n  }\n  if (\n    result.resultReusableForAeLock !==\n    true\n  ) {\n    throw new InvalidScientificInputError(\n      \"meterResult must preserve reusable meter-result identity.\"\n    );\n  }\n\n  requirePositiveFinite(\n    result.targetRelativeSignal,\n    \"meterResult.targetRelativeSignal\"\n  );\n  requireNonNegativeFinite(\n    result.meteredRelativeSignal,\n    \"meterResult.meteredRelativeSignal\"\n  );\n}\n\nfunction createBaseTargetFields(\n  targetId: string,\n  meterResult:\n    ExposureMeterTargetSourceResult\n): ExposureMeterTargetBase {\n  validateCommonMeterResult(\n    meterResult\n  );\n\n  return {\n    schemaVersion:\n      EXPOSURE_METER_TARGET_SCHEMA_VERSION,\n    targetId:\n      requireNonEmptyString(\n        targetId,\n        \"targetId\"\n      ),\n    sourceMeterSnapshot:\n      meterSnapshotIdentity(\n        meterResult\n      ),\n    scientificStatus: \"approximation\",\n    inputDomain:\n      \"relative-pre-exposure-linear-signal\",\n    baseTargetRelativeSignal:\n      meterResult.targetRelativeSignal,\n    meteredRelativeSignal:\n      meterResult.meteredRelativeSignal,\n    exposureCompensationStops: 0,\n    exposureCompensationApplied:\n      false,\n    meterMeasurementMutated: false,\n    sourceMeterSnapshotPreserved:\n      true,\n    resultReusableForAeLock: true,\n    automaticExposureResolved: false,\n    intendedConsumer:\n      \"exposure-mode-resolver\"\n  };\n}\n\n/**\n * Freezes one metering result into a stable relative exposure target, for\n * camera-control logic to use.\n *\n * The target copies the meter snapshot by value. Later changes to the scene or\n * light do not change it. This is what the engine provides for AE lock\n * (auto-exposure lock).\n */\nexport function createExposureMeterTargetFromMeteringResult(\n  input:\n    CreateExposureMeterTargetInput\n): ExposureMeterTarget {\n  requireInputKeys(input, \"createExposureMeterTargetFromMeteringResult\", [\"targetId\", \"meterResult\"]);\n  const base =\n    createBaseTargetFields(\n      input.targetId,\n      input.meterResult\n    );\n\n  if (\n    input.meterResult.status ===\n    \"no-signal\"\n  ) {\n    if (\n      input.meterResult\n        .meteredRelativeSignal !== 0\n    ) {\n      throw new InvalidScientificInputError(\n        \"A no-signal meter result must have meteredRelativeSignal equal to zero.\"\n      );\n    }\n    return {\n      ...base,\n      status: \"no-signal\",\n      baseRequiredExposureScaleResolved:\n        false,\n      baseExposureOffsetStopsResolved:\n        false,\n      requiredExposureScaleResolved:\n        false,\n      exposureOffsetStopsResolved:\n        false\n    };\n  }\n\n  const meteredRelativeSignal =\n    requirePositiveFinite(\n      input.meterResult\n        .meteredRelativeSignal,\n      \"meterResult.meteredRelativeSignal\"\n    );\n  const baseScale =\n    base.baseTargetRelativeSignal /\n    meteredRelativeSignal;\n  if (\n    !Number.isFinite(baseScale) ||\n    baseScale <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Base required exposure scale must remain finite and greater than zero.\"\n    );\n  }\n  const baseStops =\n    Math.log2(baseScale);\n  if (!Number.isFinite(baseStops)) {\n    throw new InvalidScientificInputError(\n      \"Base exposure offset must remain finite.\"\n    );\n  }\n\n  return {\n    ...base,\n    status: \"resolved\",\n    baseRequiredExposureScaleToTarget:\n      baseScale,\n    baseExposureOffsetStopsToTarget:\n      baseStops,\n    requiredExposureScaleToTarget:\n      baseScale,\n    exposureOffsetStopsToTarget:\n      baseStops\n  };\n}\n\nfunction validateBaseTarget(\n  target: ExposureMeterTarget\n): void {\n  requireInputObject(target, \"target input\");\n  if (\n    target.schemaVersion !==\n    EXPOSURE_METER_TARGET_SCHEMA_VERSION\n  ) {\n    throw new InvalidConfigurationError(\n      'baseTarget.schemaVersion must be \"' +\n        EXPOSURE_METER_TARGET_SCHEMA_VERSION +\n        '\".'\n    );\n  }\n  requireNonEmptyString(\n    target.targetId,\n    \"baseTarget.targetId\"\n  );\n  requireInputObject(target.sourceMeterSnapshot, \"baseTarget.sourceMeterSnapshot\");\n  requireNonEmptyString(\n    target\n      .sourceMeterSnapshot\n      .measurementId,\n    \"baseTarget.sourceMeterSnapshot.measurementId\"\n  );\n  requireNonEmptyString(\n    target\n      .sourceMeterSnapshot\n      .sceneStateId,\n    \"baseTarget.sourceMeterSnapshot.sceneStateId\"\n  );\n  requireNonEmptyString(\n    target\n      .sourceMeterSnapshot\n      .meteringProfileId,\n    \"baseTarget.sourceMeterSnapshot.meteringProfileId\"\n  );\n  if (\n    target\n      .sourceMeterSnapshot\n      .sourceKind !==\n      \"spatial-metering-result\" &&\n    target\n      .sourceMeterSnapshot\n      .sourceKind !==\n      \"temporal-metering-result\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"baseTarget.sourceMeterSnapshot.sourceKind is invalid.\"\n    );\n  }\n  if (\n    target.scientificStatus !==\n      \"approximation\" ||\n    target.inputDomain !==\n      \"relative-pre-exposure-linear-signal\" ||\n    target.meterMeasurementMutated !==\n      false ||\n    target.sourceMeterSnapshotPreserved !==\n      true ||\n    target.resultReusableForAeLock !==\n      true ||\n    target.automaticExposureResolved !==\n      false ||\n    target.intendedConsumer !==\n      \"exposure-mode-resolver\"\n  ) {\n    throw new InvalidScientificInputError(\n      \"baseTarget does not satisfy the exposure-meter target boundary.\"\n    );\n  }\n  requirePositiveFinite(\n    target.baseTargetRelativeSignal,\n    \"baseTarget.baseTargetRelativeSignal\"\n  );\n  requireNonNegativeFinite(\n    target.meteredRelativeSignal,\n    \"baseTarget.meteredRelativeSignal\"\n  );\n\n  if (target.status === \"resolved\") {\n    requirePositiveFinite(\n      target\n        .baseRequiredExposureScaleToTarget,\n      \"baseTarget.baseRequiredExposureScaleToTarget\"\n    );\n    requireFinite(\n      target\n        .baseExposureOffsetStopsToTarget,\n      \"baseTarget.baseExposureOffsetStopsToTarget\"\n    );\n  } else if (\n    target.meteredRelativeSignal !== 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"A no-signal baseTarget must preserve zero meteredRelativeSignal.\"\n    );\n  }\n}\n\n/**\n * Sets an absolute exposure-compensation value on a frozen meter target.\n *\n * Compensation is always worked out again from the base target without\n * compensation, so repeated UI updates cannot build up floating-point or\n * control drift. Positive compensation asks for more exposure.\n */\nexport function setExposureCompensationOnMeterTarget(\n  input:\n    SetExposureCompensationOnMeterTargetInput\n): ExposureMeterTarget {\n  requireInputKeys(input, \"setExposureCompensationOnMeterTarget\", [\"targetId\", \"baseTarget\", \"exposureCompensationStops\"]);\n  validateBaseTarget(\n    input.baseTarget\n  );\n  const targetId =\n    requireNonEmptyString(\n      input.targetId,\n      \"targetId\"\n    );\n  if (\n    targetId ===\n    input.baseTarget.targetId\n  ) {\n    throw new InvalidScientificInputError(\n      \"A compensated target must use a new targetId so changed control state cannot hide behind the same identity.\"\n    );\n  }\n\n  const compensation =\n    requireFinite(\n      input.exposureCompensationStops,\n      \"exposureCompensationStops\"\n    );\n  const common = {\n    ...input.baseTarget,\n    targetId,\n    exposureCompensationStops:\n      compensation,\n    exposureCompensationApplied:\n      compensation !== 0,\n    meterMeasurementMutated:\n      false as const,\n    sourceMeterSnapshotPreserved:\n      true as const,\n    resultReusableForAeLock:\n      true as const,\n    automaticExposureResolved:\n      false as const\n  };\n\n  if (\n    input.baseTarget.status ===\n    \"no-signal\"\n  ) {\n    return {\n      ...common,\n      status: \"no-signal\",\n      baseRequiredExposureScaleResolved:\n        false,\n      baseExposureOffsetStopsResolved:\n        false,\n      requiredExposureScaleResolved:\n        false,\n      exposureOffsetStopsResolved:\n        false\n    };\n  }\n\n  const compensatedStops =\n    input.baseTarget\n      .baseExposureOffsetStopsToTarget +\n    compensation;\n  const compensatedScale =\n    input.baseTarget\n      .baseRequiredExposureScaleToTarget *\n    Math.pow(2, compensation);\n\n  if (\n    !Number.isFinite(\n      compensatedStops\n    ) ||\n    !Number.isFinite(\n      compensatedScale\n    ) ||\n    compensatedScale <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Compensated exposure target must remain finite and greater than zero.\"\n    );\n  }\n\n  return {\n    ...common,\n    status: \"resolved\",\n    baseRequiredExposureScaleToTarget:\n      input.baseTarget\n        .baseRequiredExposureScaleToTarget,\n    baseExposureOffsetStopsToTarget:\n      input.baseTarget\n        .baseExposureOffsetStopsToTarget,\n    requiredExposureScaleToTarget:\n      compensatedScale,\n    exposureOffsetStopsToTarget:\n      compensatedStops\n  };\n}\n"]}

package/dist/exposure/metering-temporal.d.ts

@@ -1,11 +1,13 @@
 /**
- * Module boundary and integration notes.
- * Meters a declared weighted time-average of scene-radiance-derived relative pre-exposure samples.
- * Every temporal sample must already be explicitly bound to one #85 temporal illumination profile and
- * one capture time in the first-opening-boundary-phase reference. Spatial metering is performed first
- * in the same declared profile, then those scalar pre-exposure measurements are combined linearly by
- * caller-declared normalized time weights.
- * @see docs/USAGE.md for equations, coordinate/unit conventions, blockers and support limits.
+ * Metering over time: a declared weighted time average of relative meter samples taken before the
+ * exposure (pre-exposure) and derived from scene radiance. Useful for flickering light.
+ *
+ * Each time sample must already be bound to one temporal illumination profile and one capture time.
+ * Times are measured from the first opening-boundary phase (when the shutter starts to open). Each
+ * time sample is metered spatially first, with the same declared profile. The resulting single
+ * values are then combined linearly using normalized time weights that the caller declares.
+ * @see docs/USAGE.md for the equations, units, coordinate conventions, known blockers and support
+ * limits.
  */
 import { type CalculationResult } from "../core/calculation-result.js";
 import { type ExposureMeteringPolicy, type ExposureMeteringProfile } from "./metering.js";
@@ -62,15 +64,14 @@ export type SceneRadianceTemporalExposureMeteringResult = (SceneRadianceTemporal
     exposureOffsetStopsResolved: false;
 });
 /**
- * Meters a declared weighted time-average of scene-radiance-derived relative
- * pre-exposure samples.
+ * Meters a declared weighted time average of relative pre-exposure samples
+ * derived from scene radiance.
  *
- * Every temporal sample must already be explicitly bound to one #85 temporal
- * illumination profile and one capture time in the
- * first-opening-boundary-phase reference. Spatial metering is performed first
- * in the same declared profile, then those scalar pre-exposure measurements are
- * combined linearly by caller-declared normalized time weights.
+ * Each time sample must already be bound to one temporal illumination profile
+ * and one capture time, measured from the first opening-boundary phase. Each
+ * time sample is metered spatially first, with the same declared profile. The
+ * resulting single values are then combined linearly using normalized time
+ * weights that the caller declares.
  */
 export declare function meterSceneRadianceTemporalExposure(input: MeterSceneRadianceTemporalExposureInput): CalculationResult<SceneRadianceTemporalExposureMeteringResult>;
 export {};
-//# sourceMappingURL=metering-temporal.d.ts.map

package/dist/exposure/metering-temporal.js

@@ -1,21 +1,25 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Meters a declared weighted time-average of scene-radiance-derived relative pre-exposure samples.
- * Every temporal sample must already be explicitly bound to one #85 temporal illumination profile and
- * one capture time in the first-opening-boundary-phase reference. Spatial metering is performed first
- * in the same declared profile, then those scalar pre-exposure measurements are combined linearly by
- * caller-declared normalized time weights.
- * @see docs/USAGE.md for equations, coordinate/unit conventions, blockers and support limits.
+ * Metering over time: a declared weighted time average of relative meter samples taken before the
+ * exposure (pre-exposure) and derived from scene radiance. Useful for flickering light.
+ *
+ * Each time sample must already be bound to one temporal illumination profile and one capture time.
+ * Times are measured from the first opening-boundary phase (when the shutter starts to open). Each
+ * time sample is metered spatially first, with the same declared profile. The resulting single
+ * values are then combined linearly using normalized time weights that the caller declares.
+ * @see docs/USAGE.md for the equations, units, coordinate conventions, known blockers and support
+ * limits.
  */
 import { approximationResult } from "../core/calculation-result.js";
 import { InvalidScientificInputError } from "../core/validation.js";
 import { meterRelativeExposure, parseExposureMeteringProfile } from "./metering.js";
+import { requireInputKeys, requireInputObject } from "../core/record-validation.js";
+import { InvalidConfigurationError } from "../core/configuration-error.js";
 const NORMALIZED_WEIGHT_TOLERANCE = 1e-9;
 function requireNonEmptyString(value, path) {
     if (typeof value !== "string" ||
         value.trim().length === 0) {
-        throw new InvalidScientificInputError(path + " must be a non-empty string.");
+        throw new InvalidConfigurationError(path + " must be a non-empty string.");
     }
     return value.trim();
 }
@@ -49,30 +53,48 @@ function contextKey(sampleSet) {
     });
 }
 /**
- * Meters a declared weighted time-average of scene-radiance-derived relative
- * pre-exposure samples.
+ * Meters a declared weighted time average of relative pre-exposure samples
+ * derived from scene radiance.
  *
- * Every temporal sample must already be explicitly bound to one #85 temporal
- * illumination profile and one capture time in the
- * first-opening-boundary-phase reference. Spatial metering is performed first
- * in the same declared profile, then those scalar pre-exposure measurements are
- * combined linearly by caller-declared normalized time weights.
+ * Each time sample must already be bound to one temporal illumination profile
+ * and one capture time, measured from the first opening-boundary phase. Each
+ * time sample is metered spatially first, with the same declared profile. The
+ * resulting single values are then combined linearly using normalized time
+ * weights that the caller declares.
  */
 export function meterSceneRadianceTemporalExposure(input) {
+    requireInputKeys(input, "meterSceneRadianceTemporalExposure", ["temporalMeasurementId", "profile", "policy", "temporalSamples"]);
     const temporalMeasurementId = requireNonEmptyString(input.temporalMeasurementId, "temporalMeasurementId");
     const profile = parseExposureMeteringProfile(input.profile);
+    if (profile.policy.kind ===
+        "highlight-priority") {
+        // A time average of per-snapshot quantiles is not the quantile of the time-averaged signal.
+        throw new InvalidScientificInputError("highlight-priority is a spatial quantile, not a linear signal mean; temporal averaging of snapshot quantiles is not defined by this model.");
+    }
+    requireInputObject(input.policy, "policy");
     if (input.policy.kind !==
         "weighted-time-average") {
-        throw new InvalidScientificInputError('policy.kind must be "weighted-time-average".');
+        throw new InvalidConfigurationError('policy.kind must be "weighted-time-average".');
     }
     if (input.policy.timeReference !==
         "first-opening-boundary-phase") {
-        throw new InvalidScientificInputError('policy.timeReference must be "first-opening-boundary-phase".');
+        throw new InvalidConfigurationError('policy.timeReference must be "first-opening-boundary-phase".');
     }
     if (!Array.isArray(input.temporalSamples) ||
         input.temporalSamples.length === 0) {
-        throw new InvalidScientificInputError("temporalSamples must be a non-empty array.");
+        throw new InvalidConfigurationError("temporalSamples must be a non-empty array.");
     }
+    input.temporalSamples.forEach((entry, index) => {
+        const path = "temporalSamples[" + index + "]";
+        requireInputObject(entry, path);
+        const sampleSet = entry.sampleSet;
+        requireInputObject(sampleSet, path + ".sampleSet");
+        requireInputObject(sampleSet.sourceContext, path + ".sampleSet.sourceContext");
+        requireInputObject(sampleSet.sourceContext.temporal, path + ".sampleSet.sourceContext.temporal");
+        requireInputObject(sampleSet.captureGeometry, path + ".sampleSet.captureGeometry");
+        requireInputObject(sampleSet.captureGeometry.orientedCapture, path + ".sampleSet.captureGeometry.orientedCapture");
+        requireInputObject(sampleSet.captureGeometry.activeCapture, path + ".sampleSet.captureGeometry.activeCapture");
+    });
     const firstSampleSet = input.temporalSamples[0]
         .sampleSet;
     const firstContext = firstSampleSet.sourceContext;
@@ -198,7 +220,7 @@ export function meterSceneRadianceTemporalExposure(input) {
                 meteredRelativeSignal)
         };
     return approximationResult(result, "scene-radiance-relative-temporal-metering", "1.0.0", [
-        "Each temporal sample is a renderer/provider-supplied relative pre-exposure reduction bound to the same #85 scene-radiance context.",
+        "Each temporal sample is a renderer/provider-supplied relative pre-exposure reduction bound to the same scene-radiance provider context.",
         "Spectral radiance is not converted to calibrated luminance or a camera spectral-meter response by this model.",
         "Time averaging is explicit and linear in the declared relative pre-exposure signal domain.",
         "Temporal sample weights are caller-declared, positive, normalized to one, and are not inferred from source waveform frequency or sensor readout timing.",

package/dist/exposure/metering-temporal.js.map

@@ -1 +1 @@
-{"version":3,"file":"metering-temporal.js","sourceRoot":"","sources":["../../src/exposure/metering-temporal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metering-temporal.js","sourceRoot":"","sources":["../../src/exposure/metering-temporal.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Metering over time: a declared weighted time average of relative meter samples taken before the\n * exposure (pre-exposure) and derived from scene radiance. Useful for flickering light.\n *\n * Each time sample must already be bound to one temporal illumination profile and one capture time.\n * Times are measured from the first opening-boundary phase (when the shutter starts to open). Each\n * time sample is metered spatially first, with the same declared profile. The resulting single\n * values are then combined linearly using normalized time weights that the caller declares.\n * @see docs/USAGE.md for the equations, units, coordinate conventions, known blockers and support\n * limits.\n */\n\nimport {\n  approximationResult,\n  type CalculationResult\n} from \"../core/calculation-result.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport {\n  meterRelativeExposure,\n  parseExposureMeteringProfile,\n  type ExposureMeteringPolicy,\n  type ExposureMeteringProfile\n} from \"./metering.js\";\nimport type {\n  SceneRadianceDerivedExposureMeteringSampleSet\n} from \"./metering-scene-radiance.js\";\nimport { requireInputKeys, requireInputObject } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nconst NORMALIZED_WEIGHT_TOLERANCE =\n  1e-9;\n\nexport interface SceneRadianceTemporalMeteringSample {\n  normalizedTimeWeight: number;\n  sampleSet:\n    SceneRadianceDerivedExposureMeteringSampleSet;\n}\n\nexport interface MeterSceneRadianceTemporalExposureInput {\n  temporalMeasurementId: string;\n  profile: ExposureMeteringProfile;\n  policy: {\n    kind: \"weighted-time-average\";\n    timeReference:\n      \"first-opening-boundary-phase\";\n  };\n  temporalSamples:\n    readonly SceneRadianceTemporalMeteringSample[];\n}\n\ninterface SceneRadianceTemporalExposureMeteringResultBase {\n  temporalMeasurementId: string;\n  sceneStateId: string;\n  profileId: string;\n  scientificStatus: \"approximation\";\n  inputDomain:\n    \"relative-pre-exposure-linear-signal\";\n  captureRegion:\n    \"oriented-active-capture\";\n  spatialPolicyKind:\n    ExposureMeteringPolicy[\"kind\"];\n  temporalPolicyKind:\n    \"weighted-time-average\";\n  timeReference:\n    \"first-opening-boundary-phase\";\n  temporalSampleCount: number;\n  normalizedTimeWeightSum: number;\n  captureTimeRangeSecondsFromReference: {\n    minimum: number;\n    maximum: number;\n  };\n  targetRelativeSignal: number;\n  meteredRelativeSignal: number;\n  outputCropUsedForMetering: false;\n  exposureCompensationApplied: false;\n  finalToneMappingUsed: false;\n  displayGammaUsed: false;\n  calibratedLuminanceClaimAuthorized:\n    false;\n  calibratedSceneRadianceClaimAuthorized:\n    false;\n  automaticExposureResolved: false;\n  resultReusableForAeLock: true;\n  temporalAveragingExplicit: true;\n  flashTtlMeteringPerformed: false;\n}\n\nexport type SceneRadianceTemporalExposureMeteringResult =\n  | (SceneRadianceTemporalExposureMeteringResultBase & {\n      status: \"resolved\";\n      requiredExposureScaleToTarget:\n        number;\n      exposureOffsetStopsToTarget:\n        number;\n    })\n  | (SceneRadianceTemporalExposureMeteringResultBase & {\n      status: \"no-signal\";\n      requiredExposureScaleResolved:\n        false;\n      exposureOffsetStopsResolved:\n        false;\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 + \" must be a non-empty string.\"\n    );\n  }\n  return value.trim();\n}\n\nfunction requireNormalizedWeight(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value) ||\n    value <= 0 ||\n    value > 1\n  ) {\n    throw new InvalidScientificInputError(\n      path +\n        \" must be finite and in (0, 1].\"\n    );\n  }\n  return value;\n}\n\nfunction contextKey(\n  sampleSet:\n    SceneRadianceDerivedExposureMeteringSampleSet\n): string {\n  const context =\n    sampleSet.sourceContext;\n  const geometry =\n    sampleSet.captureGeometry;\n  return JSON.stringify({\n    sceneId: context.sceneId,\n    sceneStateId:\n      context.sceneStateId,\n    providerProfileId:\n      context.providerProfileId,\n    illuminationProfileId:\n      context.illuminationProfileId,\n    materialResponseProfileId:\n      context.materialResponseProfileId,\n    derivationProfileId:\n      context.derivationProfileId,\n    materialResponseFidelity:\n      context.materialResponseFidelity,\n    orientation:\n      geometry.orientedCapture\n        .orientation,\n    activeNativeRect:\n      geometry.activeCapture.nativeRect,\n    activeImagingArea:\n      geometry.activeCapture.imagingArea,\n    orientedImagingArea:\n      geometry.orientedCapture\n        .imagingArea\n  });\n}\n\n/**\n * Meters a declared weighted time average of relative pre-exposure samples\n * derived from scene radiance.\n *\n * Each time sample must already be bound to one temporal illumination profile\n * and one capture time, measured from the first opening-boundary phase. Each\n * time sample is metered spatially first, with the same declared profile. The\n * resulting single values are then combined linearly using normalized time\n * weights that the caller declares.\n */\nexport function meterSceneRadianceTemporalExposure(\n  input:\n    MeterSceneRadianceTemporalExposureInput\n): CalculationResult<\n  SceneRadianceTemporalExposureMeteringResult\n> {\n  requireInputKeys(input, \"meterSceneRadianceTemporalExposure\", [\"temporalMeasurementId\", \"profile\", \"policy\", \"temporalSamples\"]);\n  const temporalMeasurementId =\n    requireNonEmptyString(\n      input.temporalMeasurementId,\n      \"temporalMeasurementId\"\n    );\n\n  const profile =\n    parseExposureMeteringProfile(\n      input.profile\n    );\n\n  if (\n    profile.policy.kind ===\n    \"highlight-priority\"\n  ) {\n    // A time average of per-snapshot quantiles is not the quantile of the time-averaged signal.\n    throw new InvalidScientificInputError(\n      \"highlight-priority is a spatial quantile, not a linear signal mean; temporal averaging of snapshot quantiles is not defined by this model.\"\n    );\n  }\n  requireInputObject(input.policy, \"policy\");\n  if (\n    input.policy.kind !==\n    \"weighted-time-average\"\n  ) {\n    throw new InvalidConfigurationError(\n      'policy.kind must be \"weighted-time-average\".'\n    );\n  }\n  if (\n    input.policy.timeReference !==\n    \"first-opening-boundary-phase\"\n  ) {\n    throw new InvalidConfigurationError(\n      'policy.timeReference must be \"first-opening-boundary-phase\".'\n    );\n  }\n  if (\n    !Array.isArray(\n      input.temporalSamples\n    ) ||\n    input.temporalSamples.length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"temporalSamples must be a non-empty array.\"\n    );\n  }\n\n  input.temporalSamples.forEach((entry, index) => {\n    const path = \"temporalSamples[\" + index + \"]\";\n    requireInputObject(entry, path);\n    const sampleSet = entry.sampleSet;\n    requireInputObject(sampleSet, path + \".sampleSet\");\n    requireInputObject(sampleSet.sourceContext, path + \".sampleSet.sourceContext\");\n    requireInputObject(sampleSet.sourceContext.temporal, path + \".sampleSet.sourceContext.temporal\");\n    requireInputObject(sampleSet.captureGeometry, path + \".sampleSet.captureGeometry\");\n    requireInputObject(sampleSet.captureGeometry.orientedCapture, path + \".sampleSet.captureGeometry.orientedCapture\");\n    requireInputObject(sampleSet.captureGeometry.activeCapture, path + \".sampleSet.captureGeometry.activeCapture\");\n  });\n  const firstSampleSet =\n    input.temporalSamples[0]!\n      .sampleSet;\n  const firstContext =\n    firstSampleSet.sourceContext;\n  if (\n    firstContext.temporal.kind !==\n    \"registered-time-varying\"\n  ) {\n    throw new InvalidScientificInputError(\n      \"Temporal metering requires scene-radiance sample sets with registered-time-varying source context.\"\n    );\n  }\n\n  const expectedContextKey =\n    contextKey(firstSampleSet);\n  const sceneStateId =\n    firstSampleSet.sceneStateId;\n  const temporalProfileId =\n    firstContext.temporal\n      .illuminationTemporalProfileId;\n\n  let weightSum = 0;\n  let meteredRelativeSignal = 0;\n  let previousTime =\n    Number.NEGATIVE_INFINITY;\n  let minimumTime =\n    Number.POSITIVE_INFINITY;\n  let maximumTime =\n    Number.NEGATIVE_INFINITY;\n\n  for (\n    let index = 0;\n    index <\n    input.temporalSamples.length;\n    index += 1\n  ) {\n    const entry =\n      input.temporalSamples[index]!;\n    const path =\n      \"temporalSamples[\" +\n      index +\n      \"]\";\n    const weight =\n      requireNormalizedWeight(\n        entry.normalizedTimeWeight,\n        path +\n          \".normalizedTimeWeight\"\n      );\n    const sampleSet =\n      entry.sampleSet;\n    const context =\n      sampleSet.sourceContext;\n\n    if (\n      context.temporal.kind !==\n      \"registered-time-varying\"\n    ) {\n      throw new InvalidScientificInputError(\n        path +\n          \".sampleSet must use registered-time-varying source context.\"\n      );\n    }\n    if (\n      context.temporal\n        .illuminationTemporalProfileId !==\n      temporalProfileId\n    ) {\n      throw new InvalidScientificInputError(\n        \"All temporal metering samples must bind the same illuminationTemporalProfileId.\"\n      );\n    }\n    if (\n      sampleSet.sceneStateId !==\n      sceneStateId ||\n      context.sceneStateId !==\n      sceneStateId\n    ) {\n      throw new InvalidScientificInputError(\n        \"All temporal metering samples must bind the same sceneStateId.\"\n      );\n    }\n    if (\n      contextKey(sampleSet) !==\n      expectedContextKey\n    ) {\n      throw new InvalidScientificInputError(\n        \"All temporal metering samples must share the same scene/provider/material/derivation/capture-geometry context.\"\n      );\n    }\n\n    const captureTime =\n      context.temporal\n        .captureTimeSecondsFromReference;\n    if (\n      !Number.isFinite(captureTime)\n    ) {\n      throw new InvalidScientificInputError(\n        path +\n          \" capture time must be finite.\"\n      );\n    }\n    if (\n      captureTime <= previousTime\n    ) {\n      throw new InvalidScientificInputError(\n        \"Temporal metering capture times must be strictly increasing.\"\n      );\n    }\n    previousTime = captureTime;\n    minimumTime = Math.min(\n      minimumTime,\n      captureTime\n    );\n    maximumTime = Math.max(\n      maximumTime,\n      captureTime\n    );\n\n    const spatialMeter =\n      meterRelativeExposure({\n        profile,\n        sampleSet\n      });\n    meteredRelativeSignal +=\n      spatialMeter.value\n        .meteredRelativeSignal *\n      weight;\n    weightSum += weight;\n  }\n\n  if (\n    !Number.isFinite(weightSum) ||\n    Math.abs(weightSum - 1) >\n      NORMALIZED_WEIGHT_TOLERANCE\n  ) {\n    throw new InvalidScientificInputError(\n      \"temporalSamples normalizedTimeWeight values must sum to 1.\"\n    );\n  }\n  if (\n    !Number.isFinite(\n      meteredRelativeSignal\n    ) ||\n    meteredRelativeSignal < 0\n  ) {\n    throw new InvalidScientificInputError(\n      \"Temporal metered relative signal must remain finite and non-negative.\"\n    );\n  }\n\n  const base = {\n    temporalMeasurementId,\n    sceneStateId,\n    profileId:\n      profile.profileId,\n    scientificStatus:\n      \"approximation\" as const,\n    inputDomain:\n      \"relative-pre-exposure-linear-signal\" as const,\n    captureRegion:\n      \"oriented-active-capture\" as const,\n    spatialPolicyKind:\n      profile.policy.kind,\n    temporalPolicyKind:\n      \"weighted-time-average\" as const,\n    timeReference:\n      \"first-opening-boundary-phase\" as const,\n    temporalSampleCount:\n      input.temporalSamples.length,\n    normalizedTimeWeightSum: 1,\n    captureTimeRangeSecondsFromReference: {\n      minimum: minimumTime,\n      maximum: maximumTime\n    },\n    targetRelativeSignal:\n      profile.target\n        .targetRelativeSignal,\n    meteredRelativeSignal,\n    outputCropUsedForMetering:\n      false as const,\n    exposureCompensationApplied:\n      false as const,\n    finalToneMappingUsed:\n      false as const,\n    displayGammaUsed:\n      false as const,\n    calibratedLuminanceClaimAuthorized:\n      false as const,\n    calibratedSceneRadianceClaimAuthorized:\n      false as const,\n    automaticExposureResolved:\n      false as const,\n    resultReusableForAeLock:\n      true as const,\n    temporalAveragingExplicit:\n      true as const,\n    flashTtlMeteringPerformed:\n      false as const\n  };\n\n  const result:\n    SceneRadianceTemporalExposureMeteringResult =\n    meteredRelativeSignal === 0\n      ? {\n          ...base,\n          status: \"no-signal\",\n          requiredExposureScaleResolved:\n            false,\n          exposureOffsetStopsResolved:\n            false\n        }\n      : {\n          ...base,\n          status: \"resolved\",\n          requiredExposureScaleToTarget:\n            profile.target\n              .targetRelativeSignal /\n            meteredRelativeSignal,\n          exposureOffsetStopsToTarget:\n            Math.log2(\n              profile.target\n                .targetRelativeSignal /\n                meteredRelativeSignal\n            )\n        };\n\n  return approximationResult(\n    result,\n    \"scene-radiance-relative-temporal-metering\",\n    \"1.0.0\",\n    [\n      \"Each temporal sample is a renderer/provider-supplied relative pre-exposure reduction bound to the same scene-radiance provider context.\",\n      \"Spectral radiance is not converted to calibrated luminance or a camera spectral-meter response by this model.\",\n      \"Time averaging is explicit and linear in the declared relative pre-exposure signal domain.\",\n      \"Temporal sample weights are caller-declared, positive, normalized to one, and are not inferred from source waveform frequency or sensor readout timing.\",\n      \"All temporal samples share one committed sceneStateId and one provider/material/derivation/capture-geometry context.\",\n      \"Exposure compensation and automatic aperture/shutter/ISO resolution remain downstream.\",\n      \"This ambient meter does not implement flash/TTL metering.\"\n    ]\n  );\n}\n"]}

package/dist/exposure/metering.d.ts

@@ -1,12 +1,15 @@
 /**
- * Module boundary and integration notes.
- * Parses one generic relative exposure-metering profile. Schema 0.1.0 is approximation-only and
- * consumes relative pre-exposure linear signal. It deliberately does not claim luminance, spectral
- * radiance, sensor-plane irradiance, or a specific manufacturer's meter calibration.
- * Meters relative pre-exposure linear signal over the actual oriented active capture frame. The first
- * contract is an educational/relative approximation. It is intentionally independent of final output
- * crop, display/tone mapping, exposure compensation, and automatic exposure setting resolution.
- * @see docs/USAGE.md for equations, coordinate/unit conventions, blockers and support limits.
+ * Generic relative exposure metering.
+ *
+ * The profile parser reads one metering profile. Schema 0.1.0 is an approximation only. It works on
+ * relative linear signal measured before the exposure (pre-exposure). It deliberately does not claim
+ * luminance, spectral radiance, sensor-plane irradiance or any manufacturer's meter calibration.
+ *
+ * The meter works over the actual active capture frame, in its capture orientation. This first
+ * contract is an educational, relative approximation. It deliberately ignores the final output crop,
+ * display and tone mapping, exposure compensation and the choice of automatic exposure settings.
+ * @see docs/USAGE.md for the equations, units, coordinate conventions, known blockers and support
+ * limits.
  */
 import { type CalculationResult } from "../core/calculation-result.js";
 import { type EvidenceProvenance } from "../core/evidence-provenance.js";
@@ -23,10 +26,47 @@ export type ExposureMeteringPolicy = {
     centerOrientedCaptureUv: NormalizedRasterUv;
     radiusFractionOfCaptureDiagonal: number;
 } | {
+    /**
+     * Weighted average that emphasises highlights (unchanged since 1.x).
+     * Brighter samples get the weight `minimumWeightFraction + (1 -
+     * minimumWeightFraction) * (signal / maximum)^exponent`. The weighted mean
+     * is then placed at the profile target.
+     *
+     * This is NOT highlight protection. No sample is placed relative to
+     * saturation. In a mostly mid-grey scene with a small bright area, it
+     * underexposes the mid-tones compared with uniform metering, yet does not
+     * guarantee headroom. Use `highlight-priority` to keep highlights below
+     * saturation.
+     */
     kind: "highlight-weighted";
     minimumWeightFraction: number;
     exponent: number;
+} | {
+    /**
+     * Highlight-priority placement. The area-weighted `highlightPercentile`
+     * quantile of the relative pre-exposure signal is placed `headroomStops`
+     * below `saturationRelativeSignal`. The profile target must state that
+     * placement exactly: `targetRelativeSignal = saturationRelativeSignal *
+     * 2^-headroomStops` (see {@link calculateHighlightPriorityPlacementSignal}).
+     */
+    kind: "highlight-priority";
+    /** Area-weighted quantile in (0, 1]; 1 places the brightest sample. */
+    highlightPercentile: number;
+    /** Relative pre-exposure signal at which the declared output saturates. */
+    saturationRelativeSignal: number;
+    /** Non-negative headroom in stops between the placed highlight and saturation. */
+    headroomStops: number;
 };
+/** Diagnostics reported only for the highlight-priority policy. */
+export interface HighlightPriorityMeteringDiagnostics {
+    highlightPercentile: number;
+    /** Lower area-weighted quantile (inverse empirical CDF) of the samples. */
+    percentileRelativeSignal: number;
+    saturationRelativeSignal: number;
+    headroomStops: number;
+    placementRelativeSignal: number;
+    quantileDefinition: "area-weighted-lower-quantile-inverse-empirical-cdf";
+}
 export interface ExposureMeteringProfile {
     schemaVersion: typeof EXPOSURE_METERING_PROFILE_SCHEMA_VERSION;
     profileId: string;
@@ -89,6 +129,8 @@ interface ExposureMeteringResultBase {
     calibratedSceneRadianceClaimAuthorized: false;
     automaticExposureResolved: false;
     resultReusableForAeLock: true;
+    /** Present only for the highlight-priority policy. */
+    highlightPriority?: HighlightPriorityMeteringDiagnostics;
 }
 export type ExposureMeteringResult = (ExposureMeteringResultBase & {
     status: "resolved";
@@ -103,22 +145,27 @@ export interface MeterRelativeExposureInput {
     profile: ExposureMeteringProfile;
     sampleSet: ExposureMeteringSampleSet;
 }
+/**
+ * Relative signal at which a highlight-priority profile places its highlight
+ * percentile: `saturationRelativeSignal * 2^-headroomStops`.
+ */
+export declare function calculateHighlightPriorityPlacementSignal(saturationRelativeSignal: number, headroomStops: number): number;
 /**
  * Parses one generic relative exposure-metering profile.
  *
- * Schema 0.1.0 is approximation-only and consumes relative pre-exposure
- * linear signal. It deliberately does not claim luminance, spectral radiance,
- * sensor-plane irradiance, or a specific manufacturer's meter calibration.
+ * Schema 0.1.0 is an approximation only. It works on relative linear signal
+ * measured before the exposure. It deliberately does not claim luminance,
+ * spectral radiance, sensor-plane irradiance or any manufacturer's meter
+ * calibration.
  */
 export declare function parseExposureMeteringProfile(value: unknown): ExposureMeteringProfile;
 /**
- * Meters relative pre-exposure linear signal over the actual oriented active
- * capture frame.
+ * Meters relative pre-exposure linear signal over the actual active capture
+ * frame, in its capture orientation.
  *
- * The first contract is an educational/relative approximation. It is
- * intentionally independent of final output crop, display/tone mapping,
- * exposure compensation, and automatic exposure setting resolution.
+ * This first contract is an educational, relative approximation. It
+ * deliberately ignores the final output crop, display and tone mapping,
+ * exposure compensation and the choice of automatic exposure settings.
  */
 export declare function meterRelativeExposure(input: MeterRelativeExposureInput): CalculationResult<ExposureMeteringResult>;
 export {};
-//# sourceMappingURL=metering.d.ts.map