@photivra/engine 2.17.0 → 2.19.0

package/dist/sensor/spectral-quadrature.js

@@ -14,17 +14,10 @@ import { approximationResult } from "../core/calculation-result.js";
 import { InvalidScientificInputError } from "../core/validation.js";
 import { parseSensorColorSamplingProfile } from "./color-sampling.js";
 import { createSensorSpectralResponseChannelBinding, parseSensorSpectralResponseProfile, resolveSensorSpectralResponseAtWavelength } from "./spectral-response.js";
-import { requireInputKeys } from "../core/record-validation.js";
+import { requireInputKeys, requireInputPositiveFinite as requirePositiveFinite, requireInputNonNegativeSafeInteger as requireNonNegativeSafeInteger } from "../core/record-validation.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
+import { responseCurves } from "./spectral-coverage.js";
 const MAX_SPECTRAL_QUADRATURE_NODES = 100_000;
-function requirePositiveFinite(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isFinite(value) ||
-        value <= 0) {
-        throw new InvalidScientificInputError(path + " must be finite and greater than zero.");
-    }
-    return value;
-}
 function channelResponse(profile, channelId) {
     if (typeof channelId !== "string" ||
         channelId.trim().length === 0) {
@@ -36,24 +29,6 @@ function channelResponse(profile, channelId) {
     }
     return response;
 }
-function responseCurves(response) {
-    if (response.kind ===
-        "effective-external-quantum-efficiency") {
-        return [
-            response.externalQuantumEfficiency
-        ];
-    }
-    if (response.kind ===
-        "effective-spectral-responsivity") {
-        return [
-            response.spectralResponsivity
-        ];
-    }
-    return [
-        response.channelFilterTransmittance,
-        response.detectorExternalQuantumEfficiency
-    ];
-}
 function usableResponseRange(curves) {
     const minimum = Math.max(...curves.map((curve) => curve.samples[0]
         .wavelengthNanometers));
@@ -168,14 +143,6 @@ function planSegments(boundaries, maximumSubintervalWidthNanometers) {
     };
 }
 const SPECTRAL_VALIDATION_TOLERANCE = 1e-10;
-function requireNonNegativeSafeInteger(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isSafeInteger(value) ||
-        value < 0) {
-        throw new InvalidScientificInputError(path + " must be a non-negative safe integer.");
-    }
-    return value;
-}
 function approximatelyEqual(actual, expected, tolerance = SPECTRAL_VALIDATION_TOLERANCE) {
     const scale = Math.max(1, Math.abs(actual), Math.abs(expected));
     return (Math.abs(actual - expected) <=

package/dist/sensor/spectral-quadrature.js.map

@@ -1 +1 @@
-{"version":3,"file":"spectral-quadrature.js","sourceRoot":"","sources":["../../src/sensor/spectral-quadrature.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Spectral quadrature: the wavelength sample points (nodes) and step widths used to integrate light\n * over wavelength for one sensor response channel.\n *\n * Each node is the midpoint of a wavelength interval, with its width dλ in nanometres. The intervals\n * stay inside the range the response supports. Lining nodes up with curve breakpoints does not prove\n * the integral has converged. Discrete (delta-like) emission lines need their own integration and are\n * never silently widened into continuous bins.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport {\n  approximationResult,\n  type CalculationResult\n} from \"../core/calculation-result.js\";\nimport type { EvidenceProvenance } from \"../core/evidence-provenance.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport type {\n  SpectralWavelengthBasis,\n  SpectralWavelengthRangeNanometers\n} from \"../core/spectral.js\";\nimport {\n  parseSensorColorSamplingProfile,\n  type SensorColorSamplingProfile\n} from \"./color-sampling.js\";\nimport {\n  createSensorSpectralResponseChannelBinding,\n  parseSensorSpectralResponseProfile,\n  resolveSensorSpectralResponseAtWavelength,\n  type SensorSpectralReferenceConditions,\n  type SensorSpectralResponseProfile,\n  type SensorSpectralResponseScientificStatus,\n  type SensorSpectralResponseUncertainty\n} from \"./spectral-response.js\";\nimport { requireInputKeys } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\n\nconst MAX_SPECTRAL_QUADRATURE_NODES = 100_000;\n\nexport type SensorSpectralWavelengthRangeNanometers =\n  SpectralWavelengthRangeNanometers;\n\nexport interface CalculateSensorSpectralQuadratureInput {\n  colorSamplingProfile: SensorColorSamplingProfile;\n  spectralResponseProfile: SensorSpectralResponseProfile;\n  channelId: string;\n  wavelengthBasis: SpectralWavelengthBasis;\n  /**\n   * Wavelength interval to sample. It is checked only against the range the\n   * sensor response supports, not against scene-spectrum or optical-transmission\n   * coverage.\n   */\n  wavelengthRangeNanometers:\n    SensorSpectralWavelengthRangeNanometers;\n  /**\n   * Strict upper limit on the width of each midpoint subinterval.\n   *\n   * Response breakpoints and any additional breakpoints split the requested\n   * range first. Each segment is then subdivided until every subinterval is\n   * no wider than this value.\n   */\n  maximumSubintervalWidthNanometers: number;\n  /**\n   * Optional strictly increasing wavelength breakpoints from other continuous\n   * spectral inputs, such as the interpolation points of a scene spectrum or of\n   * optical transmission. Values must be strictly inside the requested range.\n   *\n   * Passing them does not claim those other inputs are available or valid over\n   * the requested range.\n   */\n  additionalBreakpointsNanometers?:\n    readonly number[];\n}\n\nexport interface SensorSpectralQuadratureNode {\n  spectralSampleIndex: number;\n  segmentIndex: number;\n  subdivisionIndex: number;\n  segmentSubdivisionCount: number;\n  /**\n   * Midpoint wavelength for this subinterval. Units: nm in wavelengthBasis.\n   */\n  wavelengthNanometers: number;\n  /**\n   * dλ (wavelength width) this node stands for. Units: nm.\n   *\n   * It is only a wavelength width. It is not response-weighted throughput,\n   * a photon count, radiant energy, current or a dimensionless probability.\n   */\n  wavelengthMeasureNanometers: number;\n  /**\n   * The wavelength width divided by the requested range width (dimensionless).\n   *\n   * Useful for averages, but it is not a sensor-response weight.\n   */\n  normalizedWavelengthWeight: number;\n}\n\nexport interface SensorSpectralQuadrature {\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  sourceResponseKind:\n    SensorSpectralResponseProfile[\"channels\"][number][\"kind\"];\n  responseScope:\n    SensorSpectralResponseProfile[\"channels\"][number][\"responseScope\"];\n  responseScientificStatus:\n    SensorSpectralResponseScientificStatus;\n  responseUncertainty:\n    SensorSpectralResponseUncertainty;\n  responseChannelBinding?: import(\"./spectral-response.js\").SensorSpectralResponseChannelBinding;\n  responseReferenceConditions?:\n    SensorSpectralReferenceConditions;\n  wavelengthBasis: SpectralWavelengthBasis;\n  wavelengthBasisResolved: boolean;\n  wavelengthRangeNanometers:\n    SensorSpectralWavelengthRangeNanometers;\n  responseDeclaredWavelengthRangeNanometers:\n    SensorSpectralWavelengthRangeNanometers;\n  quadratureScheme:\n    \"response-breakpoint-aware-bounded-midpoint\";\n  segmentBoundarySource:\n    \"requested-range-plus-response-knots-plus-optional-additional-breakpoints\";\n  /**\n   * Sorted, unique segment boundaries, including the ends of the requested range.\n   */\n  segmentBoundariesNanometers:\n    readonly number[];\n  maximumSubintervalWidthNanometers: number;\n  segmentCount: number;\n  totalNodeCount: number;\n  normalizedWavelengthWeightSum: number;\n  wavelengthMeasureSumNanometers: number;\n  nodes: readonly SensorSpectralQuadratureNode[];\n  responseKnotAlignmentIncluded: true;\n  componentEvidence: {\n    colorSamplingProfile: readonly EvidenceProvenance[];\n    profile: readonly EvidenceProvenance[];\n    channel: readonly EvidenceProvenance[];\n    curves:\n      readonly (readonly EvidenceProvenance[])[];\n  };\n  /**\n   * Fixed statements of what this result does not include.\n   */\n  responseValuesIncluded: false;\n  responseApplicationPerformed: false;\n  sourceSpectralValuesIncluded: false;\n  spectralIrradianceIncluded: false;\n  spectralPhotonIrradianceIncluded: false;\n  commonSpectralCoverageValidated: false;\n  continuousSpectralDensityQuadratureOnly: true;\n  discreteLineSpectrumIncluded: false;\n  opticalTransmissionIncludedByQuadrature: false;\n  wavelengthIntegrationPerformed: false;\n  spatialIntegrationPerformed: false;\n  temporalIntegrationPerformed: false;\n  photonsCalculated: false;\n  electronsCalculated: false;\n  rawCodeValueProduced: false;\n  convergenceErrorEstimated: false;\n}\n\ninterface ResponseCurveSupport {\n  wavelengthBasis: SpectralWavelengthBasis;\n  samples: readonly {\n    wavelengthNanometers: number;\n  }[];\n  evidence: readonly EvidenceProvenance[];\n}\n\ninterface SegmentPlan {\n  minimum: number;\n  maximum: number;\n  subdivisionCount: number;\n  subintervalWidthNanometers: number;\n}\n\nfunction requirePositiveFinite(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value) ||\n    value <= 0\n  ) {\n    throw new InvalidScientificInputError(\n      path + \" must be finite and greater than zero.\"\n    );\n  }\n  return value;\n}\n\nfunction channelResponse(\n  profile: SensorSpectralResponseProfile,\n  channelId: string\n): SensorSpectralResponseProfile[\"channels\"][number] {\n  if (\n    typeof channelId !== \"string\" ||\n    channelId.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"channelId must be a non-empty string.\"\n    );\n  }\n\n  const response = profile.channels.find(\n    (entry) => entry.channelId === channelId\n  );\n  if (response === undefined) {\n    throw new InvalidScientificInputError(\n      \"No spectral response is declared for the requested channelId.\"\n    );\n  }\n  return response;\n}\n\nfunction responseCurves(\n  response:\n    SensorSpectralResponseProfile[\"channels\"][number]\n): readonly ResponseCurveSupport[] {\n  if (\n    response.kind ===\n    \"effective-external-quantum-efficiency\"\n  ) {\n    return [\n      response.externalQuantumEfficiency\n    ];\n  }\n  if (\n    response.kind ===\n    \"effective-spectral-responsivity\"\n  ) {\n    return [\n      response.spectralResponsivity\n    ];\n  }\n  return [\n    response.channelFilterTransmittance,\n    response.detectorExternalQuantumEfficiency\n  ];\n}\n\nfunction usableResponseRange(\n  curves: readonly ResponseCurveSupport[]\n): SensorSpectralWavelengthRangeNanometers {\n  const minimum = Math.max(\n    ...curves.map(\n      (curve) =>\n        curve.samples[0]!\n          .wavelengthNanometers\n    )\n  );\n  const maximum = Math.min(\n    ...curves.map(\n      (curve) =>\n        curve.samples[\n          curve.samples.length - 1\n        ]!.wavelengthNanometers\n    )\n  );\n\n  if (!(minimum < maximum)) {\n    throw new InvalidScientificInputError(\n      \"Spectral-response curves do not have a usable overlapping wavelength interval.\"\n    );\n  }\n\n  return { minimum, maximum };\n}\n\nfunction parseRequestedRange(\n  input:\n    SensorSpectralWavelengthRangeNanometers,\n  usable:\n    SensorSpectralWavelengthRangeNanometers\n): SensorSpectralWavelengthRangeNanometers {\n  if (\n    typeof input !== \"object\" ||\n    input === null\n  ) {\n    throw new InvalidConfigurationError(\n      \"wavelengthRangeNanometers must be an object.\"\n    );\n  }\n\n  const minimum = requirePositiveFinite(\n    input.minimum,\n    \"wavelengthRangeNanometers.minimum\"\n  );\n  const maximum = requirePositiveFinite(\n    input.maximum,\n    \"wavelengthRangeNanometers.maximum\"\n  );\n\n  if (!(minimum < maximum)) {\n    throw new InvalidScientificInputError(\n      \"wavelengthRangeNanometers.minimum must be less than maximum.\"\n    );\n  }\n\n  if (\n    minimum < usable.minimum ||\n    maximum > usable.maximum\n  ) {\n    throw new InvalidScientificInputError(\n      \"Requested wavelength range must remain inside the usable spectral-response range; clipping, extrapolation, and implicit zero-fill are not permitted.\"\n    );\n  }\n\n  return { minimum, maximum };\n}\n\nfunction additionalBreakpoints(\n  value: readonly number[] | undefined,\n  range:\n    SensorSpectralWavelengthRangeNanometers\n): readonly number[] {\n  if (value === undefined) {\n    return [];\n  }\n  if (!Array.isArray(value)) {\n    throw new InvalidConfigurationError(\n      \"additionalBreakpointsNanometers must be an array when supplied.\"\n    );\n  }\n  if (\n    value.length >=\n    MAX_SPECTRAL_QUADRATURE_NODES\n  ) {\n    throw new InvalidScientificInputError(\n      \"additionalBreakpointsNanometers contains too many entries for the spectral quadrature safety limit.\"\n    );\n  }\n\n  let previous =\n    Number.NEGATIVE_INFINITY;\n\n  return value.map(\n    (entry, index) => {\n      const wavelength =\n        requirePositiveFinite(\n          entry,\n          \"additionalBreakpointsNanometers[\" +\n            index +\n            \"]\"\n        );\n      if (\n        wavelength <= range.minimum ||\n        wavelength >= range.maximum\n      ) {\n        throw new InvalidScientificInputError(\n          \"Additional spectral breakpoints must lie strictly inside the requested wavelength range.\"\n        );\n      }\n      if (wavelength <= previous) {\n        throw new InvalidScientificInputError(\n          \"additionalBreakpointsNanometers must be strictly increasing with no duplicates.\"\n        );\n      }\n      previous = wavelength;\n      return wavelength;\n    }\n  );\n}\n\nfunction partitionBoundaries(\n  curves: readonly ResponseCurveSupport[],\n  range:\n    SensorSpectralWavelengthRangeNanometers,\n  additional:\n    readonly number[]\n): readonly number[] {\n  const boundaries = new Set<number>([\n    range.minimum,\n    range.maximum,\n    ...additional\n  ]);\n\n  for (const curve of curves) {\n    for (const sample of curve.samples) {\n      if (\n        sample.wavelengthNanometers >\n          range.minimum &&\n        sample.wavelengthNanometers <\n          range.maximum\n      ) {\n        boundaries.add(\n          sample.wavelengthNanometers\n        );\n      }\n    }\n  }\n\n  return [...boundaries].sort(\n    (a, b) => a - b\n  );\n}\n\nfunction planSegments(\n  boundaries: readonly number[],\n  maximumSubintervalWidthNanometers: number\n): {\n  segments: readonly SegmentPlan[];\n  totalNodeCount: number;\n} {\n  const segments: SegmentPlan[] = [];\n  let totalNodeCount = 0;\n\n  for (\n    let segmentIndex = 0;\n    segmentIndex < boundaries.length - 1;\n    segmentIndex += 1\n  ) {\n    const minimum =\n      boundaries[segmentIndex]!;\n    const maximum =\n      boundaries[segmentIndex + 1]!;\n    const width =\n      maximum - minimum;\n\n    if (\n      !Number.isFinite(width) ||\n      width <= 0\n    ) {\n      throw new InvalidScientificInputError(\n        \"Spectral quadrature segment widths must be finite and greater than zero.\"\n      );\n    }\n\n    const subdivisionCount =\n      Math.ceil(\n        width /\n          maximumSubintervalWidthNanometers\n      );\n\n    if (\n      !Number.isSafeInteger(\n        subdivisionCount\n      ) ||\n      subdivisionCount <= 0\n    ) {\n      throw new InvalidScientificInputError(\n        \"Spectral quadrature segment subdivision count must be a positive safe integer.\"\n      );\n    }\n\n    totalNodeCount +=\n      subdivisionCount;\n\n    if (\n      !Number.isSafeInteger(\n        totalNodeCount\n      )\n    ) {\n      throw new InvalidScientificInputError(\n        \"Spectral quadrature node count must remain a safe integer.\"\n      );\n    }\n    if (\n      totalNodeCount >\n      MAX_SPECTRAL_QUADRATURE_NODES\n    ) {\n      throw new InvalidScientificInputError(\n        \"Spectral quadrature node count exceeds the safety limit of \" +\n          MAX_SPECTRAL_QUADRATURE_NODES +\n          \".\"\n      );\n    }\n\n    segments.push({\n      minimum,\n      maximum,\n      subdivisionCount,\n      subintervalWidthNanometers:\n        width / subdivisionCount\n    });\n  }\n\n  if (segments.length === 0) {\n    throw new InvalidScientificInputError(\n      \"Spectral quadrature requires at least one non-empty segment.\"\n    );\n  }\n\n  return {\n    segments,\n    totalNodeCount\n  };\n}\n\nconst SPECTRAL_VALIDATION_TOLERANCE = 1e-10;\n\nfunction requireNonNegativeSafeInteger(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isSafeInteger(value) ||\n    value < 0\n  ) {\n    throw new InvalidScientificInputError(\n      path + \" must be a non-negative safe integer.\"\n    );\n  }\n  return value;\n}\n\nfunction approximatelyEqual(\n  actual: number,\n  expected: number,\n  tolerance = SPECTRAL_VALIDATION_TOLERANCE\n): boolean {\n  const scale = Math.max(\n    1,\n    Math.abs(actual),\n    Math.abs(expected)\n  );\n  return (\n    Math.abs(actual - expected) <=\n    tolerance * scale\n  );\n}\n\n/**\n * Rechecks a supplied wavelength plan (node identities, coverage and widths in nanometres) before it\n * is used.\n *\n * Lining nodes up with breakpoints does not prove convergence. Discrete (delta-like) lines need their\n * own integration and are never silently widened into continuous bins.\n * @param quadrature - The input; see `SensorSpectralQuadrature` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function validateSensorSpectralQuadrature(\n  quadrature: SensorSpectralQuadrature\n): Map<number, SensorSpectralQuadratureNode> {\n  if (\n    typeof quadrature !== \"object\" ||\n    quadrature === null ||\n    !Array.isArray(quadrature.nodes)\n  ) {\n    throw new InvalidConfigurationError(\n      \"spectralQuadrature must contain a nodes array.\"\n    );\n  }\n\n  for (const [field, value] of [\n    [\"profileId\", quadrature.profileId],\n    [\n      \"colorSamplingProfileId\",\n      quadrature.colorSamplingProfileId\n    ],\n    [\"channelId\", quadrature.channelId]\n  ] as const) {\n    if (\n      typeof value !== \"string\" ||\n      value.trim().length === 0\n    ) {\n      throw new InvalidConfigurationError(\n        \"spectralQuadrature.\" +\n          field +\n          \" must be a non-empty string.\"\n      );\n    }\n  }\n\n  if (\n    quadrature.wavelengthBasis !== \"air\" &&\n    quadrature.wavelengthBasis !== \"vacuum\" &&\n    quadrature.wavelengthBasis !== \"unspecified\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"spectralQuadrature.wavelengthBasis is invalid.\"\n    );\n  }\n\n  const rangeMinimum = requirePositiveFinite(\n    quadrature.wavelengthRangeNanometers.minimum,\n    \"spectralQuadrature.wavelengthRangeNanometers.minimum\"\n  );\n  const rangeMaximum = requirePositiveFinite(\n    quadrature.wavelengthRangeNanometers.maximum,\n    \"spectralQuadrature.wavelengthRangeNanometers.maximum\"\n  );\n  if (!(rangeMinimum < rangeMaximum)) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature wavelength range minimum must be less than maximum.\"\n    );\n  }\n\n  const maximumSubintervalWidthNanometers =\n    requirePositiveFinite(\n      quadrature.maximumSubintervalWidthNanometers,\n      \"spectralQuadrature.maximumSubintervalWidthNanometers\"\n    );\n\n  if (\n    !Array.isArray(\n      quadrature.segmentBoundariesNanometers\n    ) ||\n    quadrature.segmentBoundariesNanometers.length <\n      2\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature.segmentBoundariesNanometers must contain at least two boundaries.\"\n    );\n  }\n\n  let previousBoundary =\n    Number.NEGATIVE_INFINITY;\n  quadrature.segmentBoundariesNanometers.forEach(\n    (boundary, index) => {\n      const parsed = requirePositiveFinite(\n        boundary,\n        \"spectralQuadrature.segmentBoundariesNanometers[\" +\n          index +\n          \"]\"\n      );\n      if (parsed <= previousBoundary) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature.segmentBoundariesNanometers must be strictly increasing.\"\n        );\n      }\n      previousBoundary = parsed;\n    }\n  );\n\n  const segmentCount =\n    requireNonNegativeSafeInteger(\n      quadrature.segmentCount,\n      \"spectralQuadrature.segmentCount\"\n    );\n  if (\n    segmentCount <= 0 ||\n    segmentCount !==\n      quadrature.segmentBoundariesNanometers.length -\n        1\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature.segmentCount must be positive and match the boundary count.\"\n    );\n  }\n\n  if (\n    !approximatelyEqual(\n      quadrature.segmentBoundariesNanometers[0]!,\n      rangeMinimum\n    ) ||\n    !approximatelyEqual(\n      quadrature.segmentBoundariesNanometers[\n        quadrature.segmentBoundariesNanometers.length -\n          1\n      ]!,\n      rangeMaximum\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature segment boundaries must exactly span the requested wavelength range.\"\n    );\n  }\n\n  const totalNodeCount =\n    requireNonNegativeSafeInteger(\n      quadrature.totalNodeCount,\n      \"spectralQuadrature.totalNodeCount\"\n    );\n  if (\n    totalNodeCount <= 0 ||\n    totalNodeCount !== quadrature.nodes.length\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature.totalNodeCount must be positive and exactly match spectralQuadrature.nodes.length.\"\n    );\n  }\n  if (\n    totalNodeCount >\n    MAX_SPECTRAL_QUADRATURE_NODES\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature.totalNodeCount exceeds the spectral quadrature safety limit.\"\n    );\n  }\n\n  if (\n    quadrature.responseApplicationPerformed !==\n      false ||\n    quadrature.responseValuesIncluded !== false ||\n    quadrature.wavelengthIntegrationPerformed !==\n      false ||\n    quadrature.continuousSpectralDensityQuadratureOnly !==\n      true ||\n    quadrature.discreteLineSpectrumIncluded !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature semantics are incompatible with pre-response continuous-density composition.\"\n    );\n  }\n\n  const span =\n    rangeMaximum - rangeMinimum;\n  const nodesByIndex =\n    new Map<number, SensorSpectralQuadratureNode>();\n  const seenSegmentSubdivisions =\n    new Set<string>();\n  const segmentSubdivisionCounts =\n    new Map<number, number>();\n  const segmentSeenCounts =\n    new Map<number, number>();\n  let measureSum = 0;\n  let normalizedWeightSum = 0;\n\n  quadrature.nodes.forEach(\n    (node, nodeArrayIndex) => {\n      const spectralSampleIndex =\n        requireNonNegativeSafeInteger(\n          node.spectralSampleIndex,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].spectralSampleIndex\"\n        );\n      if (\n        nodesByIndex.has(\n          spectralSampleIndex\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature contains duplicate spectralSampleIndex values.\"\n        );\n      }\n\n      const segmentIndex =\n        requireNonNegativeSafeInteger(\n          node.segmentIndex,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].segmentIndex\"\n        );\n      if (segmentIndex >= segmentCount) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature node segmentIndex is outside the declared segment range.\"\n        );\n      }\n\n      const subdivisionIndex =\n        requireNonNegativeSafeInteger(\n          node.subdivisionIndex,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].subdivisionIndex\"\n        );\n      const segmentSubdivisionCount =\n        requireNonNegativeSafeInteger(\n          node.segmentSubdivisionCount,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].segmentSubdivisionCount\"\n        );\n      if (\n        segmentSubdivisionCount <= 0 ||\n        subdivisionIndex >=\n          segmentSubdivisionCount\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature node subdivision identity is invalid.\"\n        );\n      }\n\n      const priorSegmentCount =\n        segmentSubdivisionCounts.get(\n          segmentIndex\n        );\n      if (\n        priorSegmentCount !== undefined &&\n        priorSegmentCount !==\n          segmentSubdivisionCount\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature nodes disagree on a segment subdivision count.\"\n        );\n      }\n      segmentSubdivisionCounts.set(\n        segmentIndex,\n        segmentSubdivisionCount\n      );\n\n      const subdivisionKey =\n        segmentIndex +\n        \":\" +\n        subdivisionIndex;\n      if (\n        seenSegmentSubdivisions.has(\n          subdivisionKey\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature contains duplicate segment/subdivision identities.\"\n        );\n      }\n      seenSegmentSubdivisions.add(\n        subdivisionKey\n      );\n      segmentSeenCounts.set(\n        segmentIndex,\n        (segmentSeenCounts.get(\n          segmentIndex\n        ) ?? 0) + 1\n      );\n\n      const wavelengthNanometers =\n        requirePositiveFinite(\n          node.wavelengthNanometers,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].wavelengthNanometers\"\n        );\n      const wavelengthMeasureNanometers =\n        requirePositiveFinite(\n          node.wavelengthMeasureNanometers,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].wavelengthMeasureNanometers\"\n        );\n      const normalizedWavelengthWeight =\n        requirePositiveFinite(\n          node.normalizedWavelengthWeight,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].normalizedWavelengthWeight\"\n        );\n\n      const segmentMinimum =\n        quadrature.segmentBoundariesNanometers[\n          segmentIndex\n        ]!;\n      const segmentMaximum =\n        quadrature.segmentBoundariesNanometers[\n          segmentIndex + 1\n        ]!;\n      const expectedMeasure =\n        (segmentMaximum -\n          segmentMinimum) /\n        segmentSubdivisionCount;\n      const expectedWavelength =\n        segmentMinimum +\n        (subdivisionIndex + 0.5) *\n          expectedMeasure;\n      const expectedNormalizedWeight =\n        expectedMeasure / span;\n\n      if (\n        !approximatelyEqual(\n          wavelengthMeasureNanometers,\n          expectedMeasure\n        ) ||\n        !approximatelyEqual(\n          wavelengthNanometers,\n          expectedWavelength\n        ) ||\n        !approximatelyEqual(\n          normalizedWavelengthWeight,\n          expectedNormalizedWeight\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature node geometry/measure does not match its declared segment/subdivision identity.\"\n        );\n      }\n\n      if (\n        wavelengthMeasureNanometers >\n          maximumSubintervalWidthNanometers &&\n        !approximatelyEqual(\n          wavelengthMeasureNanometers,\n          maximumSubintervalWidthNanometers\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature node width exceeds maximumSubintervalWidthNanometers.\"\n        );\n      }\n\n      measureSum +=\n        wavelengthMeasureNanometers;\n      normalizedWeightSum +=\n        normalizedWavelengthWeight;\n      if (\n        !Number.isFinite(measureSum) ||\n        !Number.isFinite(\n          normalizedWeightSum\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature aggregate measures must remain finite.\"\n        );\n      }\n\n      nodesByIndex.set(\n        spectralSampleIndex,\n        node\n      );\n    }\n  );\n\n  for (\n    let spectralSampleIndex = 0;\n    spectralSampleIndex < totalNodeCount;\n    spectralSampleIndex += 1\n  ) {\n    if (\n      !nodesByIndex.has(\n        spectralSampleIndex\n      )\n    ) {\n      throw new InvalidScientificInputError(\n        \"spectralQuadrature spectralSampleIndex values must form the exact contiguous range 0..totalNodeCount-1.\"\n      );\n    }\n  }\n\n  for (\n    let segmentIndex = 0;\n    segmentIndex < segmentCount;\n    segmentIndex += 1\n  ) {\n    const expected =\n      segmentSubdivisionCounts.get(\n        segmentIndex\n      );\n    const seen =\n      segmentSeenCounts.get(\n        segmentIndex\n      ) ?? 0;\n    if (\n      expected === undefined ||\n      seen !== expected\n    ) {\n      throw new InvalidScientificInputError(\n        \"spectralQuadrature must contain every declared subdivision exactly once.\"\n      );\n    }\n  }\n\n  if (\n    !approximatelyEqual(\n      measureSum,\n      span\n    ) ||\n    !approximatelyEqual(\n      normalizedWeightSum,\n      1\n    ) ||\n    !approximatelyEqual(\n      quadrature.wavelengthMeasureSumNanometers,\n      measureSum\n    ) ||\n    !approximatelyEqual(\n      quadrature.normalizedWavelengthWeightSum,\n      normalizedWeightSum\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature aggregate wavelength measures/weights are inconsistent.\"\n    );\n  }\n\n  return nodesByIndex;\n}\n\n/**\n * Builds deterministic wavelength sample points for one exact sensor response\n * channel. It does not apply the response to any spectrum.\n *\n * The requested range must lie fully inside the channel's declared usable\n * range. The response curve's breakpoints, plus any caller-supplied breakpoints\n * from the source spectrum or optics, split that range into segments. Each\n * segment is then subdivided so no midpoint subinterval is wider than\n * maximumSubintervalWidthNanometers.\n *\n * wavelengthMeasureNanometers is dλ in nanometres, not a dimensionless response\n * weight. Multiply it only by a spectral density per nanometre, or convert\n * units explicitly first.\n *\n * QE and A/W responsivity are deliberately not applied. They lead to different\n * signals: QE is photon-to-electron efficiency, while A/W responsivity relates\n * incident radiant power to electrical current. A later step must also match\n * responseScope to the source plane and collection area before integrating any\n * signal.\n */\nexport function calculateSensorSpectralQuadrature(\n  input:\n    CalculateSensorSpectralQuadratureInput\n): CalculationResult<SensorSpectralQuadrature> {\n  requireInputKeys(input, \"calculateSensorSpectralQuadrature\", [\"colorSamplingProfile\", \"spectralResponseProfile\", \"channelId\", \"wavelengthBasis\", \"wavelengthRangeNanometers\", \"maximumSubintervalWidthNanometers\", \"additionalBreakpointsNanometers\"]);\n  const maximumSubintervalWidthNanometers =\n    requirePositiveFinite(\n      input.maximumSubintervalWidthNanometers,\n      \"maximumSubintervalWidthNanometers\"\n    );\n\n  if (\n    input.wavelengthBasis !== \"air\" &&\n    input.wavelengthBasis !== \"vacuum\" &&\n    input.wavelengthBasis !== \"unspecified\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"wavelengthBasis is invalid.\"\n    );\n  }\n\n  const colorProfile =\n    parseSensorColorSamplingProfile(\n      input.colorSamplingProfile\n    );\n  const responseProfile =\n    parseSensorSpectralResponseProfile(\n      input.spectralResponseProfile\n    );\n  const response = channelResponse(\n    responseProfile,\n    input.channelId\n  );\n  const curves =\n    responseCurves(response);\n\n  if (\n    !curves.every(\n      (curve) =>\n        curve.wavelengthBasis ===\n        input.wavelengthBasis\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"wavelengthBasis must exactly match every response curve used by the requested channel.\"\n    );\n  }\n\n  const usable = usableResponseRange(\n    curves\n  );\n  const range = parseRequestedRange(\n    input.wavelengthRangeNanometers,\n    usable\n  );\n  const validationWavelength =\n    range.minimum +\n    (range.maximum - range.minimum) /\n      2;\n  const representative =\n    resolveSensorSpectralResponseAtWavelength(\n      {\n        colorSamplingProfile:\n          colorProfile,\n        spectralResponseProfile:\n          responseProfile,\n        channelId: input.channelId,\n        wavelengthNanometers:\n          validationWavelength,\n        wavelengthBasis:\n          input.wavelengthBasis\n      }\n    ).value;\n\n  const additional =\n    additionalBreakpoints(\n      input.additionalBreakpointsNanometers,\n      range\n    );\n  const boundaries =\n    partitionBoundaries(\n      curves,\n      range,\n      additional\n    );\n  const {\n    segments,\n    totalNodeCount\n  } = planSegments(\n    boundaries,\n    maximumSubintervalWidthNanometers\n  );\n\n  const totalSpan =\n    range.maximum - range.minimum;\n  const nodes:\n    SensorSpectralQuadratureNode[] = [];\n  let spectralSampleIndex = 0;\n\n  for (\n    let segmentIndex = 0;\n    segmentIndex < segments.length;\n    segmentIndex += 1\n  ) {\n    const segment =\n      segments[segmentIndex]!;\n\n    for (\n      let subdivisionIndex = 0;\n      subdivisionIndex <\n      segment.subdivisionCount;\n      subdivisionIndex += 1\n    ) {\n      const wavelengthNanometers =\n        segment.minimum +\n        (subdivisionIndex + 0.5) *\n          segment\n            .subintervalWidthNanometers;\n\n      nodes.push({\n        spectralSampleIndex,\n        segmentIndex,\n        subdivisionIndex,\n        segmentSubdivisionCount:\n          segment.subdivisionCount,\n        wavelengthNanometers,\n        wavelengthMeasureNanometers:\n          segment\n            .subintervalWidthNanometers,\n        normalizedWavelengthWeight:\n          segment\n            .subintervalWidthNanometers /\n          totalSpan\n      });\n\n      spectralSampleIndex += 1;\n    }\n  }\n\n  const normalizedWavelengthWeightSum =\n    nodes.reduce(\n      (sum, node) =>\n        sum +\n        node.normalizedWavelengthWeight,\n      0\n    );\n  const wavelengthMeasureSumNanometers =\n    nodes.reduce(\n      (sum, node) =>\n        sum +\n        node.wavelengthMeasureNanometers,\n      0\n    );\n\n  return approximationResult(\n    {\n      profileId:\n        representative.profileId,\n      colorSamplingProfileId:\n        representative\n          .colorSamplingProfileId,\n      channelId:\n        representative.channelId,\n      sourceResponseKind:\n        representative\n          .sourceResponseKind,\n      responseScope:\n        representative.responseScope,\n      responseScientificStatus:\n        representative\n          .scientificStatus,\n      responseUncertainty:\n        representative.uncertainty,\n      responseChannelBinding:\n        createSensorSpectralResponseChannelBinding(\n          response\n        ),\n      ...(representative.referenceConditions ===\n      undefined\n        ? {}\n        : {\n            responseReferenceConditions:\n              representative.referenceConditions\n          }),\n      wavelengthBasis:\n        input.wavelengthBasis,\n      wavelengthBasisResolved:\n        representative\n          .wavelengthBasisResolved,\n      wavelengthRangeNanometers:\n        range,\n      responseDeclaredWavelengthRangeNanometers:\n        usable,\n      quadratureScheme:\n        \"response-breakpoint-aware-bounded-midpoint\",\n      segmentBoundarySource:\n        \"requested-range-plus-response-knots-plus-optional-additional-breakpoints\",\n      segmentBoundariesNanometers:\n        [...boundaries],\n      maximumSubintervalWidthNanometers,\n      segmentCount:\n        segments.length,\n      totalNodeCount,\n      normalizedWavelengthWeightSum,\n      wavelengthMeasureSumNanometers,\n      nodes,\n      responseKnotAlignmentIncluded:\n        true,\n      componentEvidence: {\n        colorSamplingProfile:\n          colorProfile.evidence,\n        profile:\n          representative\n            .componentEvidence.profile,\n        channel:\n          representative\n            .componentEvidence.channel,\n        curves:\n          representative\n            .componentEvidence.curves\n      },\n      responseValuesIncluded: false,\n      responseApplicationPerformed:\n        false,\n      sourceSpectralValuesIncluded:\n        false,\n      spectralIrradianceIncluded:\n        false,\n      spectralPhotonIrradianceIncluded:\n        false,\n      commonSpectralCoverageValidated:\n        false,\n      continuousSpectralDensityQuadratureOnly:\n        true,\n      discreteLineSpectrumIncluded:\n        false,\n      opticalTransmissionIncludedByQuadrature:\n        false,\n      wavelengthIntegrationPerformed:\n        false,\n      spatialIntegrationPerformed:\n        false,\n      temporalIntegrationPerformed:\n        false,\n      photonsCalculated: false,\n      electronsCalculated: false,\n      rawCodeValueProduced: false,\n      convergenceErrorEstimated: false\n    },\n    \"sensor-spectral-quadrature\",\n    \"1.0.0\",\n    [\n      \"The partition includes requested range edges, response-curve knots, and optional caller-supplied continuous-spectrum/optics breakpoints.\",\n      \"Every segment uses deterministic equal-width midpoint subintervals whose width is bounded by maximumSubintervalWidthNanometers.\",\n      \"Wavelength measures are d-lambda in nanometres and normalized wavelength weights are geometric wavelength measures only; neither is sensor-response weighting.\",\n      \"The requested range is validated against sensor-response support only. Scene-spectrum, optical-transmission, and other spectral-factor coverage are not established by this API.\",\n      \"The response profile, exact channel linkage, wavelength basis, response scope, and response-data provenance are validated and preserved, but response values are not applied at quadrature nodes.\",\n      \"QE and A/W responsivity remain different physical representations and require different compatible downstream photon/power semantics.\",\n      \"Future signal composition must match responseScope to the source plane and collection-area model so upstream transmission is not omitted or double-counted.\",\n      \"This midpoint plan targets continuous spectral-density integration. Discrete/delta-like line spectra require a separate explicit representation rather than being approximated by hidden point masses.\",\n      \"No source spectral values, spectral irradiance, spectral photon irradiance, optical transmission, spatial integration, temporal integration, photon/electron conversion, current calculation, or RAW output is calculated.\",\n      \"Response-knot alignment and a bounded wavelength step do not prove convergence for arbitrary source spectra or other wavelength-dependent factors.\",\n      \"No source-independent convergence/error estimate is reported because integration error depends on the downstream integrand.\"\n    ]\n  );\n}\n"]}
+{"version":3,"file":"spectral-quadrature.js","sourceRoot":"","sources":["../../src/sensor/spectral-quadrature.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Spectral quadrature: the wavelength sample points (nodes) and step widths used to integrate light\n * over wavelength for one sensor response channel.\n *\n * Each node is the midpoint of a wavelength interval, with its width dλ in nanometres. The intervals\n * stay inside the range the response supports. Lining nodes up with curve breakpoints does not prove\n * the integral has converged. Discrete (delta-like) emission lines need their own integration and are\n * never silently widened into continuous bins.\n * @see docs/MOTION_AND_SIGNAL.md for equations, coordinate/unit conventions, blockers and support\n * limits.\n */\n\nimport {\n  approximationResult,\n  type CalculationResult\n} from \"../core/calculation-result.js\";\nimport type { EvidenceProvenance } from \"../core/evidence-provenance.js\";\nimport { InvalidScientificInputError } from \"../core/validation.js\";\nimport type {\n  SpectralWavelengthBasis,\n  SpectralWavelengthRangeNanometers\n} from \"../core/spectral.js\";\nimport {\n  parseSensorColorSamplingProfile,\n  type SensorColorSamplingProfile\n} from \"./color-sampling.js\";\nimport {\n  createSensorSpectralResponseChannelBinding,\n  parseSensorSpectralResponseProfile,\n  resolveSensorSpectralResponseAtWavelength,\n  type SensorSpectralReferenceConditions,\n  type SensorSpectralResponseProfile,\n  type SensorSpectralResponseScientificStatus,\n  type SensorSpectralResponseUncertainty\n} from \"./spectral-response.js\";\nimport { requireInputKeys, requireInputPositiveFinite as requirePositiveFinite, requireInputNonNegativeSafeInteger as requireNonNegativeSafeInteger } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport { responseCurves } from \"./spectral-coverage.js\";\n\nconst MAX_SPECTRAL_QUADRATURE_NODES = 100_000;\n\nexport type SensorSpectralWavelengthRangeNanometers =\n  SpectralWavelengthRangeNanometers;\n\nexport interface CalculateSensorSpectralQuadratureInput {\n  colorSamplingProfile: SensorColorSamplingProfile;\n  spectralResponseProfile: SensorSpectralResponseProfile;\n  channelId: string;\n  wavelengthBasis: SpectralWavelengthBasis;\n  /**\n   * Wavelength interval to sample. It is checked only against the range the\n   * sensor response supports, not against scene-spectrum or optical-transmission\n   * coverage.\n   */\n  wavelengthRangeNanometers:\n    SensorSpectralWavelengthRangeNanometers;\n  /**\n   * Strict upper limit on the width of each midpoint subinterval.\n   *\n   * Response breakpoints and any additional breakpoints split the requested\n   * range first. Each segment is then subdivided until every subinterval is\n   * no wider than this value.\n   */\n  maximumSubintervalWidthNanometers: number;\n  /**\n   * Optional strictly increasing wavelength breakpoints from other continuous\n   * spectral inputs, such as the interpolation points of a scene spectrum or of\n   * optical transmission. Values must be strictly inside the requested range.\n   *\n   * Passing them does not claim those other inputs are available or valid over\n   * the requested range.\n   */\n  additionalBreakpointsNanometers?:\n    readonly number[];\n}\n\nexport interface SensorSpectralQuadratureNode {\n  spectralSampleIndex: number;\n  segmentIndex: number;\n  subdivisionIndex: number;\n  segmentSubdivisionCount: number;\n  /**\n   * Midpoint wavelength for this subinterval. Units: nm in wavelengthBasis.\n   */\n  wavelengthNanometers: number;\n  /**\n   * dλ (wavelength width) this node stands for. Units: nm.\n   *\n   * It is only a wavelength width. It is not response-weighted throughput,\n   * a photon count, radiant energy, current or a dimensionless probability.\n   */\n  wavelengthMeasureNanometers: number;\n  /**\n   * The wavelength width divided by the requested range width (dimensionless).\n   *\n   * Useful for averages, but it is not a sensor-response weight.\n   */\n  normalizedWavelengthWeight: number;\n}\n\nexport interface SensorSpectralQuadrature {\n  profileId: string;\n  colorSamplingProfileId: string;\n  channelId: string;\n  sourceResponseKind:\n    SensorSpectralResponseProfile[\"channels\"][number][\"kind\"];\n  responseScope:\n    SensorSpectralResponseProfile[\"channels\"][number][\"responseScope\"];\n  responseScientificStatus:\n    SensorSpectralResponseScientificStatus;\n  responseUncertainty:\n    SensorSpectralResponseUncertainty;\n  responseChannelBinding?: import(\"./spectral-response.js\").SensorSpectralResponseChannelBinding;\n  responseReferenceConditions?:\n    SensorSpectralReferenceConditions;\n  wavelengthBasis: SpectralWavelengthBasis;\n  wavelengthBasisResolved: boolean;\n  wavelengthRangeNanometers:\n    SensorSpectralWavelengthRangeNanometers;\n  responseDeclaredWavelengthRangeNanometers:\n    SensorSpectralWavelengthRangeNanometers;\n  quadratureScheme:\n    \"response-breakpoint-aware-bounded-midpoint\";\n  segmentBoundarySource:\n    \"requested-range-plus-response-knots-plus-optional-additional-breakpoints\";\n  /**\n   * Sorted, unique segment boundaries, including the ends of the requested range.\n   */\n  segmentBoundariesNanometers:\n    readonly number[];\n  maximumSubintervalWidthNanometers: number;\n  segmentCount: number;\n  totalNodeCount: number;\n  normalizedWavelengthWeightSum: number;\n  wavelengthMeasureSumNanometers: number;\n  nodes: readonly SensorSpectralQuadratureNode[];\n  responseKnotAlignmentIncluded: true;\n  componentEvidence: {\n    colorSamplingProfile: readonly EvidenceProvenance[];\n    profile: readonly EvidenceProvenance[];\n    channel: readonly EvidenceProvenance[];\n    curves:\n      readonly (readonly EvidenceProvenance[])[];\n  };\n  /**\n   * Fixed statements of what this result does not include.\n   */\n  responseValuesIncluded: false;\n  responseApplicationPerformed: false;\n  sourceSpectralValuesIncluded: false;\n  spectralIrradianceIncluded: false;\n  spectralPhotonIrradianceIncluded: false;\n  commonSpectralCoverageValidated: false;\n  continuousSpectralDensityQuadratureOnly: true;\n  discreteLineSpectrumIncluded: false;\n  opticalTransmissionIncludedByQuadrature: false;\n  wavelengthIntegrationPerformed: false;\n  spatialIntegrationPerformed: false;\n  temporalIntegrationPerformed: false;\n  photonsCalculated: false;\n  electronsCalculated: false;\n  rawCodeValueProduced: false;\n  convergenceErrorEstimated: false;\n}\n\ninterface ResponseCurveSupport {\n  wavelengthBasis: SpectralWavelengthBasis;\n  samples: readonly {\n    wavelengthNanometers: number;\n  }[];\n  evidence: readonly EvidenceProvenance[];\n}\n\ninterface SegmentPlan {\n  minimum: number;\n  maximum: number;\n  subdivisionCount: number;\n  subintervalWidthNanometers: number;\n}\n\nfunction channelResponse(\n  profile: SensorSpectralResponseProfile,\n  channelId: string\n): SensorSpectralResponseProfile[\"channels\"][number] {\n  if (\n    typeof channelId !== \"string\" ||\n    channelId.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"channelId must be a non-empty string.\"\n    );\n  }\n\n  const response = profile.channels.find(\n    (entry) => entry.channelId === channelId\n  );\n  if (response === undefined) {\n    throw new InvalidScientificInputError(\n      \"No spectral response is declared for the requested channelId.\"\n    );\n  }\n  return response;\n}\n\nfunction usableResponseRange(\n  curves: readonly ResponseCurveSupport[]\n): SensorSpectralWavelengthRangeNanometers {\n  const minimum = Math.max(\n    ...curves.map(\n      (curve) =>\n        curve.samples[0]!\n          .wavelengthNanometers\n    )\n  );\n  const maximum = Math.min(\n    ...curves.map(\n      (curve) =>\n        curve.samples[\n          curve.samples.length - 1\n        ]!.wavelengthNanometers\n    )\n  );\n\n  if (!(minimum < maximum)) {\n    throw new InvalidScientificInputError(\n      \"Spectral-response curves do not have a usable overlapping wavelength interval.\"\n    );\n  }\n\n  return { minimum, maximum };\n}\n\nfunction parseRequestedRange(\n  input:\n    SensorSpectralWavelengthRangeNanometers,\n  usable:\n    SensorSpectralWavelengthRangeNanometers\n): SensorSpectralWavelengthRangeNanometers {\n  if (\n    typeof input !== \"object\" ||\n    input === null\n  ) {\n    throw new InvalidConfigurationError(\n      \"wavelengthRangeNanometers must be an object.\"\n    );\n  }\n\n  const minimum = requirePositiveFinite(\n    input.minimum,\n    \"wavelengthRangeNanometers.minimum\"\n  );\n  const maximum = requirePositiveFinite(\n    input.maximum,\n    \"wavelengthRangeNanometers.maximum\"\n  );\n\n  if (!(minimum < maximum)) {\n    throw new InvalidScientificInputError(\n      \"wavelengthRangeNanometers.minimum must be less than maximum.\"\n    );\n  }\n\n  if (\n    minimum < usable.minimum ||\n    maximum > usable.maximum\n  ) {\n    throw new InvalidScientificInputError(\n      \"Requested wavelength range must remain inside the usable spectral-response range; clipping, extrapolation, and implicit zero-fill are not permitted.\"\n    );\n  }\n\n  return { minimum, maximum };\n}\n\nfunction additionalBreakpoints(\n  value: readonly number[] | undefined,\n  range:\n    SensorSpectralWavelengthRangeNanometers\n): readonly number[] {\n  if (value === undefined) {\n    return [];\n  }\n  if (!Array.isArray(value)) {\n    throw new InvalidConfigurationError(\n      \"additionalBreakpointsNanometers must be an array when supplied.\"\n    );\n  }\n  if (\n    value.length >=\n    MAX_SPECTRAL_QUADRATURE_NODES\n  ) {\n    throw new InvalidScientificInputError(\n      \"additionalBreakpointsNanometers contains too many entries for the spectral quadrature safety limit.\"\n    );\n  }\n\n  let previous =\n    Number.NEGATIVE_INFINITY;\n\n  return value.map(\n    (entry, index) => {\n      const wavelength =\n        requirePositiveFinite(\n          entry,\n          \"additionalBreakpointsNanometers[\" +\n            index +\n            \"]\"\n        );\n      if (\n        wavelength <= range.minimum ||\n        wavelength >= range.maximum\n      ) {\n        throw new InvalidScientificInputError(\n          \"Additional spectral breakpoints must lie strictly inside the requested wavelength range.\"\n        );\n      }\n      if (wavelength <= previous) {\n        throw new InvalidScientificInputError(\n          \"additionalBreakpointsNanometers must be strictly increasing with no duplicates.\"\n        );\n      }\n      previous = wavelength;\n      return wavelength;\n    }\n  );\n}\n\nfunction partitionBoundaries(\n  curves: readonly ResponseCurveSupport[],\n  range:\n    SensorSpectralWavelengthRangeNanometers,\n  additional:\n    readonly number[]\n): readonly number[] {\n  const boundaries = new Set<number>([\n    range.minimum,\n    range.maximum,\n    ...additional\n  ]);\n\n  for (const curve of curves) {\n    for (const sample of curve.samples) {\n      if (\n        sample.wavelengthNanometers >\n          range.minimum &&\n        sample.wavelengthNanometers <\n          range.maximum\n      ) {\n        boundaries.add(\n          sample.wavelengthNanometers\n        );\n      }\n    }\n  }\n\n  return [...boundaries].sort(\n    (a, b) => a - b\n  );\n}\n\nfunction planSegments(\n  boundaries: readonly number[],\n  maximumSubintervalWidthNanometers: number\n): {\n  segments: readonly SegmentPlan[];\n  totalNodeCount: number;\n} {\n  const segments: SegmentPlan[] = [];\n  let totalNodeCount = 0;\n\n  for (\n    let segmentIndex = 0;\n    segmentIndex < boundaries.length - 1;\n    segmentIndex += 1\n  ) {\n    const minimum =\n      boundaries[segmentIndex]!;\n    const maximum =\n      boundaries[segmentIndex + 1]!;\n    const width =\n      maximum - minimum;\n\n    if (\n      !Number.isFinite(width) ||\n      width <= 0\n    ) {\n      throw new InvalidScientificInputError(\n        \"Spectral quadrature segment widths must be finite and greater than zero.\"\n      );\n    }\n\n    const subdivisionCount =\n      Math.ceil(\n        width /\n          maximumSubintervalWidthNanometers\n      );\n\n    if (\n      !Number.isSafeInteger(\n        subdivisionCount\n      ) ||\n      subdivisionCount <= 0\n    ) {\n      throw new InvalidScientificInputError(\n        \"Spectral quadrature segment subdivision count must be a positive safe integer.\"\n      );\n    }\n\n    totalNodeCount +=\n      subdivisionCount;\n\n    if (\n      !Number.isSafeInteger(\n        totalNodeCount\n      )\n    ) {\n      throw new InvalidScientificInputError(\n        \"Spectral quadrature node count must remain a safe integer.\"\n      );\n    }\n    if (\n      totalNodeCount >\n      MAX_SPECTRAL_QUADRATURE_NODES\n    ) {\n      throw new InvalidScientificInputError(\n        \"Spectral quadrature node count exceeds the safety limit of \" +\n          MAX_SPECTRAL_QUADRATURE_NODES +\n          \".\"\n      );\n    }\n\n    segments.push({\n      minimum,\n      maximum,\n      subdivisionCount,\n      subintervalWidthNanometers:\n        width / subdivisionCount\n    });\n  }\n\n  if (segments.length === 0) {\n    throw new InvalidScientificInputError(\n      \"Spectral quadrature requires at least one non-empty segment.\"\n    );\n  }\n\n  return {\n    segments,\n    totalNodeCount\n  };\n}\n\nconst SPECTRAL_VALIDATION_TOLERANCE = 1e-10;\n\nfunction approximatelyEqual(\n  actual: number,\n  expected: number,\n  tolerance = SPECTRAL_VALIDATION_TOLERANCE\n): boolean {\n  const scale = Math.max(\n    1,\n    Math.abs(actual),\n    Math.abs(expected)\n  );\n  return (\n    Math.abs(actual - expected) <=\n    tolerance * scale\n  );\n}\n\n/**\n * Rechecks a supplied wavelength plan (node identities, coverage and widths in nanometres) before it\n * is used.\n *\n * Lining nodes up with breakpoints does not prove convergence. Discrete (delta-like) lines need their\n * own integration and are never silently widened into continuous bins.\n * @param quadrature - The input; see `SensorSpectralQuadrature` for its fields, units and coordinates.\n * @returns The result. Success does not imply calibration.\n *\n * @see docs/API_REFERENCE.md for the package export and its full type definitions.\n */\nexport function validateSensorSpectralQuadrature(\n  quadrature: SensorSpectralQuadrature\n): Map<number, SensorSpectralQuadratureNode> {\n  if (\n    typeof quadrature !== \"object\" ||\n    quadrature === null ||\n    !Array.isArray(quadrature.nodes)\n  ) {\n    throw new InvalidConfigurationError(\n      \"spectralQuadrature must contain a nodes array.\"\n    );\n  }\n\n  for (const [field, value] of [\n    [\"profileId\", quadrature.profileId],\n    [\n      \"colorSamplingProfileId\",\n      quadrature.colorSamplingProfileId\n    ],\n    [\"channelId\", quadrature.channelId]\n  ] as const) {\n    if (\n      typeof value !== \"string\" ||\n      value.trim().length === 0\n    ) {\n      throw new InvalidConfigurationError(\n        \"spectralQuadrature.\" +\n          field +\n          \" must be a non-empty string.\"\n      );\n    }\n  }\n\n  if (\n    quadrature.wavelengthBasis !== \"air\" &&\n    quadrature.wavelengthBasis !== \"vacuum\" &&\n    quadrature.wavelengthBasis !== \"unspecified\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"spectralQuadrature.wavelengthBasis is invalid.\"\n    );\n  }\n\n  const rangeMinimum = requirePositiveFinite(\n    quadrature.wavelengthRangeNanometers.minimum,\n    \"spectralQuadrature.wavelengthRangeNanometers.minimum\"\n  );\n  const rangeMaximum = requirePositiveFinite(\n    quadrature.wavelengthRangeNanometers.maximum,\n    \"spectralQuadrature.wavelengthRangeNanometers.maximum\"\n  );\n  if (!(rangeMinimum < rangeMaximum)) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature wavelength range minimum must be less than maximum.\"\n    );\n  }\n\n  const maximumSubintervalWidthNanometers =\n    requirePositiveFinite(\n      quadrature.maximumSubintervalWidthNanometers,\n      \"spectralQuadrature.maximumSubintervalWidthNanometers\"\n    );\n\n  if (\n    !Array.isArray(\n      quadrature.segmentBoundariesNanometers\n    ) ||\n    quadrature.segmentBoundariesNanometers.length <\n      2\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature.segmentBoundariesNanometers must contain at least two boundaries.\"\n    );\n  }\n\n  let previousBoundary =\n    Number.NEGATIVE_INFINITY;\n  quadrature.segmentBoundariesNanometers.forEach(\n    (boundary, index) => {\n      const parsed = requirePositiveFinite(\n        boundary,\n        \"spectralQuadrature.segmentBoundariesNanometers[\" +\n          index +\n          \"]\"\n      );\n      if (parsed <= previousBoundary) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature.segmentBoundariesNanometers must be strictly increasing.\"\n        );\n      }\n      previousBoundary = parsed;\n    }\n  );\n\n  const segmentCount =\n    requireNonNegativeSafeInteger(\n      quadrature.segmentCount,\n      \"spectralQuadrature.segmentCount\"\n    );\n  if (\n    segmentCount <= 0 ||\n    segmentCount !==\n      quadrature.segmentBoundariesNanometers.length -\n        1\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature.segmentCount must be positive and match the boundary count.\"\n    );\n  }\n\n  if (\n    !approximatelyEqual(\n      quadrature.segmentBoundariesNanometers[0]!,\n      rangeMinimum\n    ) ||\n    !approximatelyEqual(\n      quadrature.segmentBoundariesNanometers[\n        quadrature.segmentBoundariesNanometers.length -\n          1\n      ]!,\n      rangeMaximum\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature segment boundaries must exactly span the requested wavelength range.\"\n    );\n  }\n\n  const totalNodeCount =\n    requireNonNegativeSafeInteger(\n      quadrature.totalNodeCount,\n      \"spectralQuadrature.totalNodeCount\"\n    );\n  if (\n    totalNodeCount <= 0 ||\n    totalNodeCount !== quadrature.nodes.length\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature.totalNodeCount must be positive and exactly match spectralQuadrature.nodes.length.\"\n    );\n  }\n  if (\n    totalNodeCount >\n    MAX_SPECTRAL_QUADRATURE_NODES\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature.totalNodeCount exceeds the spectral quadrature safety limit.\"\n    );\n  }\n\n  if (\n    quadrature.responseApplicationPerformed !==\n      false ||\n    quadrature.responseValuesIncluded !== false ||\n    quadrature.wavelengthIntegrationPerformed !==\n      false ||\n    quadrature.continuousSpectralDensityQuadratureOnly !==\n      true ||\n    quadrature.discreteLineSpectrumIncluded !==\n      false\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature semantics are incompatible with pre-response continuous-density composition.\"\n    );\n  }\n\n  const span =\n    rangeMaximum - rangeMinimum;\n  const nodesByIndex =\n    new Map<number, SensorSpectralQuadratureNode>();\n  const seenSegmentSubdivisions =\n    new Set<string>();\n  const segmentSubdivisionCounts =\n    new Map<number, number>();\n  const segmentSeenCounts =\n    new Map<number, number>();\n  let measureSum = 0;\n  let normalizedWeightSum = 0;\n\n  quadrature.nodes.forEach(\n    (node, nodeArrayIndex) => {\n      const spectralSampleIndex =\n        requireNonNegativeSafeInteger(\n          node.spectralSampleIndex,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].spectralSampleIndex\"\n        );\n      if (\n        nodesByIndex.has(\n          spectralSampleIndex\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature contains duplicate spectralSampleIndex values.\"\n        );\n      }\n\n      const segmentIndex =\n        requireNonNegativeSafeInteger(\n          node.segmentIndex,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].segmentIndex\"\n        );\n      if (segmentIndex >= segmentCount) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature node segmentIndex is outside the declared segment range.\"\n        );\n      }\n\n      const subdivisionIndex =\n        requireNonNegativeSafeInteger(\n          node.subdivisionIndex,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].subdivisionIndex\"\n        );\n      const segmentSubdivisionCount =\n        requireNonNegativeSafeInteger(\n          node.segmentSubdivisionCount,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].segmentSubdivisionCount\"\n        );\n      if (\n        segmentSubdivisionCount <= 0 ||\n        subdivisionIndex >=\n          segmentSubdivisionCount\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature node subdivision identity is invalid.\"\n        );\n      }\n\n      const priorSegmentCount =\n        segmentSubdivisionCounts.get(\n          segmentIndex\n        );\n      if (\n        priorSegmentCount !== undefined &&\n        priorSegmentCount !==\n          segmentSubdivisionCount\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature nodes disagree on a segment subdivision count.\"\n        );\n      }\n      segmentSubdivisionCounts.set(\n        segmentIndex,\n        segmentSubdivisionCount\n      );\n\n      const subdivisionKey =\n        segmentIndex +\n        \":\" +\n        subdivisionIndex;\n      if (\n        seenSegmentSubdivisions.has(\n          subdivisionKey\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature contains duplicate segment/subdivision identities.\"\n        );\n      }\n      seenSegmentSubdivisions.add(\n        subdivisionKey\n      );\n      segmentSeenCounts.set(\n        segmentIndex,\n        (segmentSeenCounts.get(\n          segmentIndex\n        ) ?? 0) + 1\n      );\n\n      const wavelengthNanometers =\n        requirePositiveFinite(\n          node.wavelengthNanometers,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].wavelengthNanometers\"\n        );\n      const wavelengthMeasureNanometers =\n        requirePositiveFinite(\n          node.wavelengthMeasureNanometers,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].wavelengthMeasureNanometers\"\n        );\n      const normalizedWavelengthWeight =\n        requirePositiveFinite(\n          node.normalizedWavelengthWeight,\n          \"spectralQuadrature.nodes[\" +\n            nodeArrayIndex +\n            \"].normalizedWavelengthWeight\"\n        );\n\n      const segmentMinimum =\n        quadrature.segmentBoundariesNanometers[\n          segmentIndex\n        ]!;\n      const segmentMaximum =\n        quadrature.segmentBoundariesNanometers[\n          segmentIndex + 1\n        ]!;\n      const expectedMeasure =\n        (segmentMaximum -\n          segmentMinimum) /\n        segmentSubdivisionCount;\n      const expectedWavelength =\n        segmentMinimum +\n        (subdivisionIndex + 0.5) *\n          expectedMeasure;\n      const expectedNormalizedWeight =\n        expectedMeasure / span;\n\n      if (\n        !approximatelyEqual(\n          wavelengthMeasureNanometers,\n          expectedMeasure\n        ) ||\n        !approximatelyEqual(\n          wavelengthNanometers,\n          expectedWavelength\n        ) ||\n        !approximatelyEqual(\n          normalizedWavelengthWeight,\n          expectedNormalizedWeight\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature node geometry/measure does not match its declared segment/subdivision identity.\"\n        );\n      }\n\n      if (\n        wavelengthMeasureNanometers >\n          maximumSubintervalWidthNanometers &&\n        !approximatelyEqual(\n          wavelengthMeasureNanometers,\n          maximumSubintervalWidthNanometers\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature node width exceeds maximumSubintervalWidthNanometers.\"\n        );\n      }\n\n      measureSum +=\n        wavelengthMeasureNanometers;\n      normalizedWeightSum +=\n        normalizedWavelengthWeight;\n      if (\n        !Number.isFinite(measureSum) ||\n        !Number.isFinite(\n          normalizedWeightSum\n        )\n      ) {\n        throw new InvalidScientificInputError(\n          \"spectralQuadrature aggregate measures must remain finite.\"\n        );\n      }\n\n      nodesByIndex.set(\n        spectralSampleIndex,\n        node\n      );\n    }\n  );\n\n  for (\n    let spectralSampleIndex = 0;\n    spectralSampleIndex < totalNodeCount;\n    spectralSampleIndex += 1\n  ) {\n    if (\n      !nodesByIndex.has(\n        spectralSampleIndex\n      )\n    ) {\n      throw new InvalidScientificInputError(\n        \"spectralQuadrature spectralSampleIndex values must form the exact contiguous range 0..totalNodeCount-1.\"\n      );\n    }\n  }\n\n  for (\n    let segmentIndex = 0;\n    segmentIndex < segmentCount;\n    segmentIndex += 1\n  ) {\n    const expected =\n      segmentSubdivisionCounts.get(\n        segmentIndex\n      );\n    const seen =\n      segmentSeenCounts.get(\n        segmentIndex\n      ) ?? 0;\n    if (\n      expected === undefined ||\n      seen !== expected\n    ) {\n      throw new InvalidScientificInputError(\n        \"spectralQuadrature must contain every declared subdivision exactly once.\"\n      );\n    }\n  }\n\n  if (\n    !approximatelyEqual(\n      measureSum,\n      span\n    ) ||\n    !approximatelyEqual(\n      normalizedWeightSum,\n      1\n    ) ||\n    !approximatelyEqual(\n      quadrature.wavelengthMeasureSumNanometers,\n      measureSum\n    ) ||\n    !approximatelyEqual(\n      quadrature.normalizedWavelengthWeightSum,\n      normalizedWeightSum\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"spectralQuadrature aggregate wavelength measures/weights are inconsistent.\"\n    );\n  }\n\n  return nodesByIndex;\n}\n\n/**\n * Builds deterministic wavelength sample points for one exact sensor response\n * channel. It does not apply the response to any spectrum.\n *\n * The requested range must lie fully inside the channel's declared usable\n * range. The response curve's breakpoints, plus any caller-supplied breakpoints\n * from the source spectrum or optics, split that range into segments. Each\n * segment is then subdivided so no midpoint subinterval is wider than\n * maximumSubintervalWidthNanometers.\n *\n * wavelengthMeasureNanometers is dλ in nanometres, not a dimensionless response\n * weight. Multiply it only by a spectral density per nanometre, or convert\n * units explicitly first.\n *\n * QE and A/W responsivity are deliberately not applied. They lead to different\n * signals: QE is photon-to-electron efficiency, while A/W responsivity relates\n * incident radiant power to electrical current. A later step must also match\n * responseScope to the source plane and collection area before integrating any\n * signal.\n */\nexport function calculateSensorSpectralQuadrature(\n  input:\n    CalculateSensorSpectralQuadratureInput\n): CalculationResult<SensorSpectralQuadrature> {\n  requireInputKeys(input, \"calculateSensorSpectralQuadrature\", [\"colorSamplingProfile\", \"spectralResponseProfile\", \"channelId\", \"wavelengthBasis\", \"wavelengthRangeNanometers\", \"maximumSubintervalWidthNanometers\", \"additionalBreakpointsNanometers\"]);\n  const maximumSubintervalWidthNanometers =\n    requirePositiveFinite(\n      input.maximumSubintervalWidthNanometers,\n      \"maximumSubintervalWidthNanometers\"\n    );\n\n  if (\n    input.wavelengthBasis !== \"air\" &&\n    input.wavelengthBasis !== \"vacuum\" &&\n    input.wavelengthBasis !== \"unspecified\"\n  ) {\n    throw new InvalidConfigurationError(\n      \"wavelengthBasis is invalid.\"\n    );\n  }\n\n  const colorProfile =\n    parseSensorColorSamplingProfile(\n      input.colorSamplingProfile\n    );\n  const responseProfile =\n    parseSensorSpectralResponseProfile(\n      input.spectralResponseProfile\n    );\n  const response = channelResponse(\n    responseProfile,\n    input.channelId\n  );\n  const curves =\n    responseCurves(response);\n\n  if (\n    !curves.every(\n      (curve) =>\n        curve.wavelengthBasis ===\n        input.wavelengthBasis\n    )\n  ) {\n    throw new InvalidScientificInputError(\n      \"wavelengthBasis must exactly match every response curve used by the requested channel.\"\n    );\n  }\n\n  const usable = usableResponseRange(\n    curves\n  );\n  const range = parseRequestedRange(\n    input.wavelengthRangeNanometers,\n    usable\n  );\n  const validationWavelength =\n    range.minimum +\n    (range.maximum - range.minimum) /\n      2;\n  const representative =\n    resolveSensorSpectralResponseAtWavelength(\n      {\n        colorSamplingProfile:\n          colorProfile,\n        spectralResponseProfile:\n          responseProfile,\n        channelId: input.channelId,\n        wavelengthNanometers:\n          validationWavelength,\n        wavelengthBasis:\n          input.wavelengthBasis\n      }\n    ).value;\n\n  const additional =\n    additionalBreakpoints(\n      input.additionalBreakpointsNanometers,\n      range\n    );\n  const boundaries =\n    partitionBoundaries(\n      curves,\n      range,\n      additional\n    );\n  const {\n    segments,\n    totalNodeCount\n  } = planSegments(\n    boundaries,\n    maximumSubintervalWidthNanometers\n  );\n\n  const totalSpan =\n    range.maximum - range.minimum;\n  const nodes:\n    SensorSpectralQuadratureNode[] = [];\n  let spectralSampleIndex = 0;\n\n  for (\n    let segmentIndex = 0;\n    segmentIndex < segments.length;\n    segmentIndex += 1\n  ) {\n    const segment =\n      segments[segmentIndex]!;\n\n    for (\n      let subdivisionIndex = 0;\n      subdivisionIndex <\n      segment.subdivisionCount;\n      subdivisionIndex += 1\n    ) {\n      const wavelengthNanometers =\n        segment.minimum +\n        (subdivisionIndex + 0.5) *\n          segment\n            .subintervalWidthNanometers;\n\n      nodes.push({\n        spectralSampleIndex,\n        segmentIndex,\n        subdivisionIndex,\n        segmentSubdivisionCount:\n          segment.subdivisionCount,\n        wavelengthNanometers,\n        wavelengthMeasureNanometers:\n          segment\n            .subintervalWidthNanometers,\n        normalizedWavelengthWeight:\n          segment\n            .subintervalWidthNanometers /\n          totalSpan\n      });\n\n      spectralSampleIndex += 1;\n    }\n  }\n\n  const normalizedWavelengthWeightSum =\n    nodes.reduce(\n      (sum, node) =>\n        sum +\n        node.normalizedWavelengthWeight,\n      0\n    );\n  const wavelengthMeasureSumNanometers =\n    nodes.reduce(\n      (sum, node) =>\n        sum +\n        node.wavelengthMeasureNanometers,\n      0\n    );\n\n  return approximationResult(\n    {\n      profileId:\n        representative.profileId,\n      colorSamplingProfileId:\n        representative\n          .colorSamplingProfileId,\n      channelId:\n        representative.channelId,\n      sourceResponseKind:\n        representative\n          .sourceResponseKind,\n      responseScope:\n        representative.responseScope,\n      responseScientificStatus:\n        representative\n          .scientificStatus,\n      responseUncertainty:\n        representative.uncertainty,\n      responseChannelBinding:\n        createSensorSpectralResponseChannelBinding(\n          response\n        ),\n      ...(representative.referenceConditions ===\n      undefined\n        ? {}\n        : {\n            responseReferenceConditions:\n              representative.referenceConditions\n          }),\n      wavelengthBasis:\n        input.wavelengthBasis,\n      wavelengthBasisResolved:\n        representative\n          .wavelengthBasisResolved,\n      wavelengthRangeNanometers:\n        range,\n      responseDeclaredWavelengthRangeNanometers:\n        usable,\n      quadratureScheme:\n        \"response-breakpoint-aware-bounded-midpoint\",\n      segmentBoundarySource:\n        \"requested-range-plus-response-knots-plus-optional-additional-breakpoints\",\n      segmentBoundariesNanometers:\n        [...boundaries],\n      maximumSubintervalWidthNanometers,\n      segmentCount:\n        segments.length,\n      totalNodeCount,\n      normalizedWavelengthWeightSum,\n      wavelengthMeasureSumNanometers,\n      nodes,\n      responseKnotAlignmentIncluded:\n        true,\n      componentEvidence: {\n        colorSamplingProfile:\n          colorProfile.evidence,\n        profile:\n          representative\n            .componentEvidence.profile,\n        channel:\n          representative\n            .componentEvidence.channel,\n        curves:\n          representative\n            .componentEvidence.curves\n      },\n      responseValuesIncluded: false,\n      responseApplicationPerformed:\n        false,\n      sourceSpectralValuesIncluded:\n        false,\n      spectralIrradianceIncluded:\n        false,\n      spectralPhotonIrradianceIncluded:\n        false,\n      commonSpectralCoverageValidated:\n        false,\n      continuousSpectralDensityQuadratureOnly:\n        true,\n      discreteLineSpectrumIncluded:\n        false,\n      opticalTransmissionIncludedByQuadrature:\n        false,\n      wavelengthIntegrationPerformed:\n        false,\n      spatialIntegrationPerformed:\n        false,\n      temporalIntegrationPerformed:\n        false,\n      photonsCalculated: false,\n      electronsCalculated: false,\n      rawCodeValueProduced: false,\n      convergenceErrorEstimated: false\n    },\n    \"sensor-spectral-quadrature\",\n    \"1.0.0\",\n    [\n      \"The partition includes requested range edges, response-curve knots, and optional caller-supplied continuous-spectrum/optics breakpoints.\",\n      \"Every segment uses deterministic equal-width midpoint subintervals whose width is bounded by maximumSubintervalWidthNanometers.\",\n      \"Wavelength measures are d-lambda in nanometres and normalized wavelength weights are geometric wavelength measures only; neither is sensor-response weighting.\",\n      \"The requested range is validated against sensor-response support only. Scene-spectrum, optical-transmission, and other spectral-factor coverage are not established by this API.\",\n      \"The response profile, exact channel linkage, wavelength basis, response scope, and response-data provenance are validated and preserved, but response values are not applied at quadrature nodes.\",\n      \"QE and A/W responsivity remain different physical representations and require different compatible downstream photon/power semantics.\",\n      \"Future signal composition must match responseScope to the source plane and collection-area model so upstream transmission is not omitted or double-counted.\",\n      \"This midpoint plan targets continuous spectral-density integration. Discrete/delta-like line spectra require a separate explicit representation rather than being approximated by hidden point masses.\",\n      \"No source spectral values, spectral irradiance, spectral photon irradiance, optical transmission, spatial integration, temporal integration, photon/electron conversion, current calculation, or RAW output is calculated.\",\n      \"Response-knot alignment and a bounded wavelength step do not prove convergence for arbitrary source spectra or other wavelength-dependent factors.\",\n      \"No source-independent convergence/error estimate is reported because integration error depends on the downstream integrand.\"\n    ]\n  );\n}\n"]}

package/dist/sensor/spectral-response.js

@@ -18,52 +18,13 @@ import { parseEvidenceList } from "../core/evidence-provenance.js";
 import { InvalidScientificInputError } from "../core/validation.js";
 import { parseSpectralWavelengthBasis } from "../core/spectral.js";
 import { parseSensorColorSamplingProfile } from "./color-sampling.js";
-import { requireInputKeys, rejectUnknownFields, rejectUnknownVariantFields, UNCERTAINTY_VARIANT_FIELDS } from "../core/record-validation.js";
+import { requireInputKeys, rejectUnknownVariantFields, UNCERTAINTY_VARIANT_FIELDS, requireConfigRecord as requireRecord, requireConfigString as requireNonEmptyString, parseConfigScientificStatus as parseScientificStatus, requireConfigFiniteNumber as requireFinite, requireConfigFraction as requireFraction, requireConfigNumberAboveZero as requirePositiveFinite } from "../core/record-validation.js";
 /**
  * Current channel-binding format. v2 (package 2.0.0) serializes the parsed channel with sorted keys.
  * v1 (package 1.5.0 and earlier) used the unparsed channel's JSON in insertion order; it is rejected
  * with an explicit version error instead of being compared.
  */
 export const SENSOR_SPECTRAL_RESPONSE_CHANNEL_BINDING_FORMAT = "photivra-spectral-channel-response-canonical-json-v2";
-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;
-}
-function requireFinite(value, path) {
-    if (typeof value !== "number" ||
-        !Number.isFinite(value)) {
-        throw new InvalidConfigurationError(path + " must be a finite number.");
-    }
-    return value;
-}
-function requirePositiveFinite(value, path) {
-    const number = requireFinite(value, path);
-    if (number <= 0) {
-        throw new InvalidConfigurationError(path + " must be greater than zero.");
-    }
-    return number;
-}
-function requireFraction(value, path) {
-    const number = requireFinite(value, path);
-    if (number < 0 || number > 1) {
-        throw new InvalidConfigurationError(path +
-            " must be a finite fraction from 0 through 1.");
-    }
-    return number;
-}
 function requireReusableCurveEvidence(value, path) {
     const evidence = parseEvidenceList(value, path);
     if (!evidence.some((entry) => entry.reuseStatus ===
@@ -245,13 +206,6 @@ function parseResponsivityCurve(value, path) {
         samples: parseResponsivitySamples(record.samples, path + ".samples")
     };
 }
-function parseScientificStatus(value, path) {
-    if (value !== "calibrated" &&
-        value !== "approximation") {
-        throw new InvalidConfigurationError(path + " is invalid.");
-    }
-    return value;
-}
 function validateCalibratedWavelengthBasis(scientificStatus, curves, path) {
     if (scientificStatus === "calibrated" &&
         curves.some((curve) => curve.wavelengthBasis ===