@photivra/engine 1.5.0 → 2.1.0

package/dist/core/spectral-composition.js

@@ -1,24 +1,25 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Parses one continuous spectral-coverage participant. This contract describes support and
- * interpolation breakpoints only. It does not carry spectral values, transmission, response, radiance,
- * or uncertainty.
- * Intersects continuous spectral support and unions all interpolation breakpoints inside the common
- * range. Air/vacuum conversion is never implicit. Discrete lines are deliberately excluded because
- * delta-like line measures require a different integration path from continuous per-nanometre
- * densities.
+ * Combines the wavelength coverage of several spectral inputs (light source, filters, sensor
+ * response) before they are multiplied and integrated.
+ *
+ * Continuous spectra (values per nanometre) and discrete lines (narrow emission lines treated as
+ * delta functions) are handled separately, because they integrate differently. This module
+ * describes wavelength ranges and interpolation breakpoints only, not spectral values.
  * @see docs/SCENE_RADIANCE_AND_ILLUMINATION.md for equations, coordinate/unit conventions, blockers
  * and support limits.
  */
 import { InvalidConfigurationError } from "./configuration-error.js";
 import { parseSpectralWavelengthBasis, parseSpectralWavelengthRangeNanometers } from "./spectral.js";
-function requireRecord(value, path) {
+import { requireInputKeys, rejectUnknownFields } from "./record-validation.js";
+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) {
@@ -86,13 +87,13 @@ function parseBreakpoints(value, range, path) {
     });
 }
 /**
- * Parses one continuous spectral-coverage participant.
+ * Parses the wavelength coverage of one continuous spectral input.
  *
- * This contract describes support and interpolation breakpoints only. It does
- * not carry spectral values, transmission, response, radiance, or uncertainty.
+ * It describes only the wavelength range (support) and interpolation breakpoints. It
+ * carries no spectral values, transmission, response, radiance or uncertainty.
  */
 export function parseSpectralCoverageParticipant(value, path = "spectralCoverageParticipant") {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["wavelengthRangeNanometers", "participantId", "role", "wavelengthBasis", "breakpointsNanometers"]);
     const range = parseSpectralWavelengthRangeNanometers(record.wavelengthRangeNanometers, path +
         ".wavelengthRangeNanometers");
     return {
@@ -105,14 +106,15 @@ export function parseSpectralCoverageParticipant(value, path = "spectralCoverage
     };
 }
 /**
- * Intersects continuous spectral support and unions all interpolation
- * breakpoints inside the common range.
+ * Finds the wavelength range that all continuous inputs share, and collects every
+ * interpolation breakpoint inside it.
  *
- * Air/vacuum conversion is never implicit. Discrete lines are deliberately
- * excluded because delta-like line measures require a different integration
- * path from continuous per-nanometre densities.
+ * Air and vacuum wavelengths are never converted implicitly. Discrete lines are not
+ * accepted here: a delta-like line is integrated differently from a continuous
+ * per-nanometre density.
  */
 export function composeSpectralCoverage(input) {
+    requireInputKeys(input, "composeSpectralCoverage", ["participants"]);
     if (!Array.isArray(input.participants) ||
         input.participants.length === 0) {
         throw new InvalidConfigurationError("participants must be a non-empty array.");
@@ -171,13 +173,13 @@ export function composeSpectralCoverage(input) {
 }
 const LINE_WEIGHT_TOLERANCE = 1e-9;
 /**
- * Parses a normalized set of delta-like discrete spectral lines.
+ * Parses a normalized set of discrete spectral lines (each treated as a delta function).
  *
- * Each weight is an integrated line fraction, not a per-nanometre spectral
- * density sample. The weights must sum to one.
+ * Each weight is the fraction of the total carried by that line. It is not a
+ * per-nanometre density sample. The weights must sum to one.
  */
 export function parseNormalizedDiscreteSpectralLineDistribution(value, path = "discreteSpectralLineDistribution") {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["lineModel", "normalization", "lines", "wavelengthBasis"]);
     if (record.lineModel !==
         "delta-like-integrated") {
         throw new InvalidConfigurationError(path +
@@ -201,7 +203,7 @@ export function parseNormalizedDiscreteSpectralLineDistribution(value, path = "d
         const linePath = path + ".lines[" +
             index +
             "]";
-        const line = requireRecord(entry, linePath);
+        const line = requireRecord(entry, linePath, ["lineId", "wavelengthNanometers", "normalizedIntegratedWeight"]);
         const lineId = requireNonEmptyString(line.lineId, linePath + ".lineId");
         const wavelengthNanometers = requirePositiveFinite(line.wavelengthNanometers, linePath +
             ".wavelengthNanometers");
@@ -255,6 +257,7 @@ function parseQuantityUnit(value, path) {
  * line fractions without inventing a continuous line width.
  */
 export function distributeIntegratedQuantityAcrossDiscreteSpectralLines(input) {
+    requireInputKeys(input, "distributeIntegratedQuantityAcrossDiscreteSpectralLines", ["distribution", "totalIntegratedQuantity", "quantityUnit"]);
     const distribution = parseNormalizedDiscreteSpectralLineDistribution(input.distribution, "distribution");
     const totalIntegratedQuantity = requireNonNegativeFinite(input.totalIntegratedQuantity, "totalIntegratedQuantity");
     const quantityUnit = parseQuantityUnit(input.quantityUnit, "quantityUnit");
@@ -274,11 +277,11 @@ export function distributeIntegratedQuantityAcrossDiscreteSpectralLines(input) {
     };
 }
 /**
- * Integrates a discrete line measure by summing already wavelength-integrated
- * line contributions. No d-lambda factor is applied.
+ * Integrates over discrete lines by summing their contributions, which are already
+ * integrated over wavelength. No dλ (wavelength step) factor is applied.
  */
 export function integrateDiscreteSpectralLineMeasure(measure) {
-    const record = requireRecord(measure, "measure");
+    const record = requireRecord(measure, "measure", ["wavelengthBasis", "quantityUnit", "lineModel", "continuousSpectralDensityAssumed", "wavelengthMeasureMultiplicationRequired", "lines"]);
     const wavelengthBasis = parseResolvedBasis(record.wavelengthBasis, "measure.wavelengthBasis");
     const quantityUnit = parseQuantityUnit(record.quantityUnit, "measure.quantityUnit");
     if (record.lineModel !==
@@ -300,7 +303,7 @@ export function integrateDiscreteSpectralLineMeasure(measure) {
     let integratedQuantity = 0;
     for (let index = 0; index < record.lines.length; index += 1) {
         const linePath = "measure.lines[" + index + "]";
-        const line = requireRecord(record.lines[index], linePath);
+        const line = requireRecord(record.lines[index], linePath, ["lineId", "wavelengthNanometers", "integratedQuantity"]);
         const lineId = requireNonEmptyString(line.lineId, linePath + ".lineId");
         const wavelengthNanometers = requirePositiveFinite(line.wavelengthNanometers, linePath +
             ".wavelengthNanometers");

package/dist/core/spectral-composition.js.map

@@ -1 +1 @@
-{"version":3,"file":"spectral-composition.js","sourceRoot":"","sources":["../../src/core/spectral-composition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spectral-composition.js","sourceRoot":"","sources":["../../src/core/spectral-composition.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Combines the wavelength coverage of several spectral inputs (light source, filters, sensor\n * response) before they are multiplied and integrated.\n *\n * Continuous spectra (values per nanometre) and discrete lines (narrow emission lines treated as\n * delta functions) are handled separately, because they integrate differently. This module\n * describes wavelength ranges and interpolation breakpoints only, not spectral values.\n * @see docs/SCENE_RADIANCE_AND_ILLUMINATION.md for equations, coordinate/unit conventions, blockers\n * and support limits.\n */\n\nimport { InvalidConfigurationError } from \"./configuration-error.js\";\nimport {\n  parseSpectralWavelengthBasis,\n  parseSpectralWavelengthRangeNanometers,\n  type SpectralWavelengthBasis,\n  type SpectralWavelengthRangeNanometers\n} from \"./spectral.js\";\nimport { requireInputKeys, rejectUnknownFields } from \"./record-validation.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport type ResolvedSpectralWavelengthBasis =\n  Exclude<SpectralWavelengthBasis, \"unspecified\">;\n\nexport type SpectralCoverageParticipantRole =\n  | \"illumination-source\"\n  | \"scene-radiance\"\n  | \"material-response\"\n  | \"optical-transmission\"\n  | \"sensor-response\"\n  | \"other\";\n\nexport interface SpectralCoverageParticipant {\n  participantId: string;\n  role: SpectralCoverageParticipantRole;\n  wavelengthBasis:\n    ResolvedSpectralWavelengthBasis;\n  wavelengthRangeNanometers:\n    SpectralWavelengthRangeNanometers;\n  /**\n   * Internal piecewise-continuous breakpoints. Range endpoints are carried\n   * separately and must not be duplicated here.\n   */\n  breakpointsNanometers:\n    readonly number[];\n}\n\nexport interface ComposeSpectralCoverageInput {\n  participants:\n    readonly SpectralCoverageParticipant[];\n}\n\nexport interface SpectralCoverageComposition {\n  wavelengthBasis:\n    ResolvedSpectralWavelengthBasis;\n  commonWavelengthRangeNanometers:\n    SpectralWavelengthRangeNanometers;\n  /**\n   * Common-range endpoints plus every participant breakpoint that falls\n   * strictly inside the common overlap.\n   */\n  segmentBoundariesNanometers:\n    readonly number[];\n  participantIds: readonly string[];\n  participantRoles:\n    readonly SpectralCoverageParticipantRole[];\n  continuousCoverageIntersectionEstablished:\n    true;\n  breakpointUnionEstablished: true;\n  responseValuesApplied: false;\n  spectralDensityIntegrated: false;\n  discreteLinesIncluded: false;\n  airVacuumConversionPerformed: false;\n}\n\nexport interface NormalizedDiscreteSpectralLine {\n  lineId: string;\n  wavelengthNanometers: number;\n  normalizedIntegratedWeight: number;\n}\n\nexport interface NormalizedDiscreteSpectralLineDistribution {\n  wavelengthBasis:\n    ResolvedSpectralWavelengthBasis;\n  lineModel: \"delta-like-integrated\";\n  normalization:\n    \"sum-normalized-integrated-weight-to-one\";\n  lines:\n    readonly NormalizedDiscreteSpectralLine[];\n}\n\nexport type DiscreteSpectralLineQuantityUnit =\n  | \"relative\"\n  | \"W/sr\"\n  | \"W/m^2\"\n  | \"W/m^2/sr\";\n\nexport interface DiscreteSpectralLineMeasureEntry {\n  lineId: string;\n  wavelengthNanometers: number;\n  integratedQuantity: number;\n}\n\nexport interface DiscreteSpectralLineMeasure {\n  wavelengthBasis:\n    ResolvedSpectralWavelengthBasis;\n  quantityUnit:\n    DiscreteSpectralLineQuantityUnit;\n  lineModel: \"delta-like-integrated\";\n  lines:\n    readonly DiscreteSpectralLineMeasureEntry[];\n  continuousSpectralDensityAssumed: false;\n  wavelengthMeasureMultiplicationRequired:\n    false;\n}\n\nexport interface IntegratedDiscreteSpectralLineMeasure {\n  wavelengthBasis:\n    ResolvedSpectralWavelengthBasis;\n  quantityUnit:\n    DiscreteSpectralLineQuantityUnit;\n  integratedQuantity: number;\n  lineCount: number;\n  continuousQuadratureApplied: false;\n  wavelengthMeasureMultiplicationApplied:\n    false;\n}\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Array.isArray(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be an object.\"\n    );\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction requireNonEmptyString(\n  value: unknown,\n  path: string\n): string {\n  if (\n    typeof value !== \"string\" ||\n    value.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be a non-empty string.\"\n    );\n  }\n  return value.trim();\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 InvalidConfigurationError(\n      path +\n        \" must be finite and greater than zero.\"\n    );\n  }\n  return value;\n}\n\nfunction requireNonNegativeFinite(\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 InvalidConfigurationError(\n      path +\n        \" must be finite and greater than or equal to zero.\"\n    );\n  }\n  return value;\n}\n\nfunction parseResolvedBasis(\n  value: unknown,\n  path: string\n): ResolvedSpectralWavelengthBasis {\n  const basis =\n    parseSpectralWavelengthBasis(\n      value,\n      path\n    );\n  if (basis === \"unspecified\") {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be air or vacuum for spectral composition.\"\n    );\n  }\n  return basis;\n}\n\nfunction parseRole(\n  value: unknown,\n  path: string\n): SpectralCoverageParticipantRole {\n  if (\n    value !== \"illumination-source\" &&\n    value !== \"scene-radiance\" &&\n    value !== \"material-response\" &&\n    value !== \"optical-transmission\" &&\n    value !== \"sensor-response\" &&\n    value !== \"other\"\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" is invalid.\"\n    );\n  }\n  return value;\n}\n\nfunction parseBreakpoints(\n  value: unknown,\n  range:\n    SpectralWavelengthRangeNanometers,\n  path: string\n): readonly number[] {\n  if (!Array.isArray(value)) {\n    throw new InvalidConfigurationError(\n      path + \" must be an array.\"\n    );\n  }\n\n  let previous =\n    Number.NEGATIVE_INFINITY;\n  return value.map((entry, index) => {\n    const breakpoint =\n      requirePositiveFinite(\n        entry,\n        path + \"[\" + index + \"]\"\n      );\n    if (\n      breakpoint <= range.minimum ||\n      breakpoint >= range.maximum\n    ) {\n      throw new InvalidConfigurationError(\n        path +\n          \" values must lie strictly inside the participant wavelength range.\"\n      );\n    }\n    if (breakpoint <= previous) {\n      throw new InvalidConfigurationError(\n        path +\n          \" must be strictly increasing with no duplicates.\"\n      );\n    }\n    previous = breakpoint;\n    return breakpoint;\n  });\n}\n\n/**\n * Parses the wavelength coverage of one continuous spectral input.\n *\n * It describes only the wavelength range (support) and interpolation breakpoints. It\n * carries no spectral values, transmission, response, radiance or uncertainty.\n */\nexport function parseSpectralCoverageParticipant(\n  value: unknown,\n  path = \"spectralCoverageParticipant\"\n): SpectralCoverageParticipant {\n  const record = requireRecord(\n    value,\n    path, [\"wavelengthRangeNanometers\", \"participantId\", \"role\", \"wavelengthBasis\", \"breakpointsNanometers\"]\n  );\n  const range =\n    parseSpectralWavelengthRangeNanometers(\n      record.wavelengthRangeNanometers,\n      path +\n        \".wavelengthRangeNanometers\"\n    );\n  return {\n    participantId:\n      requireNonEmptyString(\n        record.participantId,\n        path + \".participantId\"\n      ),\n    role: parseRole(\n      record.role,\n      path + \".role\"\n    ),\n    wavelengthBasis:\n      parseResolvedBasis(\n        record.wavelengthBasis,\n        path + \".wavelengthBasis\"\n      ),\n    wavelengthRangeNanometers:\n      range,\n    breakpointsNanometers:\n      parseBreakpoints(\n        record.breakpointsNanometers,\n        range,\n        path +\n          \".breakpointsNanometers\"\n      )\n  };\n}\n\n/**\n * Finds the wavelength range that all continuous inputs share, and collects every\n * interpolation breakpoint inside it.\n *\n * Air and vacuum wavelengths are never converted implicitly. Discrete lines are not\n * accepted here: a delta-like line is integrated differently from a continuous\n * per-nanometre density.\n */\nexport function composeSpectralCoverage(\n  input: ComposeSpectralCoverageInput\n): SpectralCoverageComposition {\n  requireInputKeys(input, \"composeSpectralCoverage\", [\"participants\"]);\n  if (\n    !Array.isArray(input.participants) ||\n    input.participants.length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"participants must be a non-empty array.\"\n    );\n  }\n\n  const participants =\n    input.participants.map(\n      (entry, index) =>\n        parseSpectralCoverageParticipant(\n          entry,\n          \"participants[\" +\n            index +\n            \"]\"\n        )\n    );\n  const participantIds =\n    participants.map(\n      (entry) => entry.participantId\n    );\n  if (\n    new Set(participantIds).size !==\n    participantIds.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"participants[].participantId must not contain duplicates.\"\n    );\n  }\n\n  const wavelengthBasis =\n    participants[0]!\n      .wavelengthBasis;\n  if (\n    participants.some(\n      (entry) =>\n        entry.wavelengthBasis !==\n        wavelengthBasis\n    )\n  ) {\n    throw new InvalidConfigurationError(\n      \"All spectral-coverage participants must use the same resolved wavelengthBasis; air/vacuum conversion is not implicit.\"\n    );\n  }\n\n  const minimum = Math.max(\n    ...participants.map(\n      (entry) =>\n        entry\n          .wavelengthRangeNanometers\n          .minimum\n    )\n  );\n  const maximum = Math.min(\n    ...participants.map(\n      (entry) =>\n        entry\n          .wavelengthRangeNanometers\n          .maximum\n    )\n  );\n  if (!(minimum < maximum)) {\n    throw new InvalidConfigurationError(\n      \"Spectral-coverage participants do not share a non-empty wavelength interval.\"\n    );\n  }\n\n  const boundaries =\n    new Set<number>([\n      minimum,\n      maximum\n    ]);\n  for (const participant of participants) {\n    for (\n      const breakpoint of\n      participant.breakpointsNanometers\n    ) {\n      if (\n        breakpoint > minimum &&\n        breakpoint < maximum\n      ) {\n        boundaries.add(breakpoint);\n      }\n    }\n  }\n\n  return {\n    wavelengthBasis,\n    commonWavelengthRangeNanometers: {\n      minimum,\n      maximum\n    },\n    segmentBoundariesNanometers:\n      [...boundaries].sort(\n        (a, b) => a - b\n      ),\n    participantIds,\n    participantRoles:\n      participants.map(\n        (entry) => entry.role\n      ),\n    continuousCoverageIntersectionEstablished:\n      true,\n    breakpointUnionEstablished: true,\n    responseValuesApplied: false,\n    spectralDensityIntegrated: false,\n    discreteLinesIncluded: false,\n    airVacuumConversionPerformed: false\n  };\n}\n\nconst LINE_WEIGHT_TOLERANCE = 1e-9;\n\n/**\n * Parses a normalized set of discrete spectral lines (each treated as a delta function).\n *\n * Each weight is the fraction of the total carried by that line. It is not a\n * per-nanometre density sample. The weights must sum to one.\n */\nexport function parseNormalizedDiscreteSpectralLineDistribution(\n  value: unknown,\n  path =\n    \"discreteSpectralLineDistribution\"\n): NormalizedDiscreteSpectralLineDistribution {\n  const record = requireRecord(\n    value,\n    path, [\"lineModel\", \"normalization\", \"lines\", \"wavelengthBasis\"]\n  );\n  if (\n    record.lineModel !==\n    \"delta-like-integrated\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        '.lineModel must be \"delta-like-integrated\".'\n    );\n  }\n  if (\n    record.normalization !==\n    \"sum-normalized-integrated-weight-to-one\"\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        '.normalization must be \"sum-normalized-integrated-weight-to-one\".'\n    );\n  }\n  if (\n    !Array.isArray(record.lines) ||\n    record.lines.length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".lines must be a non-empty array.\"\n    );\n  }\n\n  const wavelengthBasis =\n    parseResolvedBasis(\n      record.wavelengthBasis,\n      path + \".wavelengthBasis\"\n    );\n  let previousWavelength =\n    Number.NEGATIVE_INFINITY;\n  const lineIds: string[] = [];\n  let weightSum = 0;\n\n  const lines = record.lines.map(\n    (entry, index) => {\n      const linePath =\n        path + \".lines[\" +\n        index +\n        \"]\";\n      const line = requireRecord(\n        entry,\n        linePath, [\"lineId\", \"wavelengthNanometers\", \"normalizedIntegratedWeight\"]\n      );\n      const lineId =\n        requireNonEmptyString(\n          line.lineId,\n          linePath + \".lineId\"\n        );\n      const wavelengthNanometers =\n        requirePositiveFinite(\n          line.wavelengthNanometers,\n          linePath +\n            \".wavelengthNanometers\"\n        );\n      if (\n        wavelengthNanometers <=\n        previousWavelength\n      ) {\n        throw new InvalidConfigurationError(\n          path +\n            \".lines wavelengths must be strictly increasing with no duplicates.\"\n        );\n      }\n      previousWavelength =\n        wavelengthNanometers;\n      const normalizedIntegratedWeight =\n        requirePositiveFinite(\n          line.normalizedIntegratedWeight,\n          linePath +\n            \".normalizedIntegratedWeight\"\n        );\n      lineIds.push(lineId);\n      weightSum +=\n        normalizedIntegratedWeight;\n      return {\n        lineId,\n        wavelengthNanometers,\n        normalizedIntegratedWeight\n      };\n    }\n  );\n\n  if (\n    new Set(lineIds).size !==\n    lineIds.length\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".lines[].lineId must not contain duplicates.\"\n    );\n  }\n  if (\n    !Number.isFinite(weightSum) ||\n    Math.abs(weightSum - 1) >\n      LINE_WEIGHT_TOLERANCE\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \".lines normalizedIntegratedWeight values must sum to 1.\"\n    );\n  }\n\n  return {\n    wavelengthBasis,\n    lineModel:\n      \"delta-like-integrated\",\n    normalization:\n      \"sum-normalized-integrated-weight-to-one\",\n    lines\n  };\n}\n\nfunction parseQuantityUnit(\n  value: unknown,\n  path: string\n): DiscreteSpectralLineQuantityUnit {\n  if (\n    value !== \"relative\" &&\n    value !== \"W/sr\" &&\n    value !== \"W/m^2\" &&\n    value !== \"W/m^2/sr\"\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" is invalid.\"\n    );\n  }\n  return value;\n}\n\nexport interface DistributeIntegratedQuantityAcrossDiscreteLinesInput {\n  distribution:\n    NormalizedDiscreteSpectralLineDistribution;\n  totalIntegratedQuantity: number;\n  quantityUnit:\n    DiscreteSpectralLineQuantityUnit;\n}\n\n/**\n * Distributes one wavelength-integrated quantity across normalized discrete\n * line fractions without inventing a continuous line width.\n */\nexport function distributeIntegratedQuantityAcrossDiscreteSpectralLines(\n  input:\n    DistributeIntegratedQuantityAcrossDiscreteLinesInput\n): DiscreteSpectralLineMeasure {\n  requireInputKeys(input, \"distributeIntegratedQuantityAcrossDiscreteSpectralLines\", [\"distribution\", \"totalIntegratedQuantity\", \"quantityUnit\"]);\n  const distribution =\n    parseNormalizedDiscreteSpectralLineDistribution(\n      input.distribution,\n      \"distribution\"\n    );\n  const totalIntegratedQuantity =\n    requireNonNegativeFinite(\n      input.totalIntegratedQuantity,\n      \"totalIntegratedQuantity\"\n    );\n  const quantityUnit =\n    parseQuantityUnit(\n      input.quantityUnit,\n      \"quantityUnit\"\n    );\n\n  return {\n    wavelengthBasis:\n      distribution.wavelengthBasis,\n    quantityUnit,\n    lineModel:\n      \"delta-like-integrated\",\n    lines:\n      distribution.lines.map(\n        (line) => ({\n          lineId: line.lineId,\n          wavelengthNanometers:\n            line.wavelengthNanometers,\n          integratedQuantity:\n            totalIntegratedQuantity *\n            line\n              .normalizedIntegratedWeight\n        })\n      ),\n    continuousSpectralDensityAssumed:\n      false,\n    wavelengthMeasureMultiplicationRequired:\n      false\n  };\n}\n\n/**\n * Integrates over discrete lines by summing their contributions, which are already\n * integrated over wavelength. No dλ (wavelength step) factor is applied.\n */\nexport function integrateDiscreteSpectralLineMeasure(\n  measure:\n    DiscreteSpectralLineMeasure\n): IntegratedDiscreteSpectralLineMeasure {\n  const record = requireRecord(\n    measure,\n    \"measure\", [\"wavelengthBasis\", \"quantityUnit\", \"lineModel\", \"continuousSpectralDensityAssumed\", \"wavelengthMeasureMultiplicationRequired\", \"lines\"]\n  );\n  const wavelengthBasis =\n    parseResolvedBasis(\n      record.wavelengthBasis,\n      \"measure.wavelengthBasis\"\n    );\n  const quantityUnit =\n    parseQuantityUnit(\n      record.quantityUnit,\n      \"measure.quantityUnit\"\n    );\n\n  if (\n    record.lineModel !==\n    \"delta-like-integrated\"\n  ) {\n    throw new InvalidConfigurationError(\n      'measure.lineModel must be \"delta-like-integrated\".'\n    );\n  }\n  if (\n    record.continuousSpectralDensityAssumed !==\n      false ||\n    record.wavelengthMeasureMultiplicationRequired !==\n      false\n  ) {\n    throw new InvalidConfigurationError(\n      \"Discrete spectral line measures must not claim continuous-density or d-lambda integration semantics.\"\n    );\n  }\n  if (\n    !Array.isArray(record.lines) ||\n    record.lines.length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      \"measure.lines must be a non-empty array.\"\n    );\n  }\n\n  let previousWavelength =\n    Number.NEGATIVE_INFINITY;\n  const lineIds: string[] = [];\n  let integratedQuantity = 0;\n\n  for (\n    let index = 0;\n    index < record.lines.length;\n    index += 1\n  ) {\n    const linePath =\n      \"measure.lines[\" + index + \"]\";\n    const line = requireRecord(\n      record.lines[index],\n      linePath, [\"lineId\", \"wavelengthNanometers\", \"integratedQuantity\"]\n    );\n    const lineId =\n      requireNonEmptyString(\n        line.lineId,\n        linePath + \".lineId\"\n      );\n    const wavelengthNanometers =\n      requirePositiveFinite(\n        line.wavelengthNanometers,\n        linePath +\n          \".wavelengthNanometers\"\n      );\n    if (\n      wavelengthNanometers <=\n      previousWavelength\n    ) {\n      throw new InvalidConfigurationError(\n        \"measure.lines wavelengths must be strictly increasing with no duplicates.\"\n      );\n    }\n    previousWavelength =\n      wavelengthNanometers;\n    lineIds.push(lineId);\n\n    integratedQuantity +=\n      requireNonNegativeFinite(\n        line.integratedQuantity,\n        linePath +\n          \".integratedQuantity\"\n      );\n    if (\n      !Number.isFinite(\n        integratedQuantity\n      )\n    ) {\n      throw new InvalidConfigurationError(\n        \"Discrete spectral line integrated quantity must remain finite.\"\n      );\n    }\n  }\n\n  if (\n    new Set(lineIds).size !==\n    lineIds.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"measure.lines[].lineId must not contain duplicates.\"\n    );\n  }\n\n  return {\n    wavelengthBasis,\n    quantityUnit,\n    integratedQuantity,\n    lineCount: record.lines.length,\n    continuousQuadratureApplied: false,\n    wavelengthMeasureMultiplicationApplied:\n      false\n  };\n}\n"]}

package/dist/core/spectral.d.ts

@@ -1,9 +1,9 @@
 /**
- * Explicit wavelength coordinate basis used by renderer-neutral spectral data.
+ * Whether wavelengths are measured in air or in vacuum.
  *
- * "unspecified" is permitted only where a downstream contract explicitly
- * allows unresolved/approximate wavelength coordinates. Calibrated physical
- * composition must resolve the basis before use.
+ * "unspecified" is allowed only where a downstream contract explicitly accepts
+ * unresolved or approximate wavelengths. Calibrated physical calculations must
+ * resolve the basis first.
  */
 export type SpectralWavelengthBasis = "air" | "vacuum" | "unspecified";
 /**
@@ -20,7 +20,7 @@ export interface SpectralWavelengthRangeNanometers {
     maximum: number;
 }
 /**
- * Parses a wavelength basis without inferring air/vacuum conversion.
+ * Parses a wavelength basis. It never converts between air and vacuum.
  */
 export declare function parseSpectralWavelengthBasis(value: unknown, path?: string): SpectralWavelengthBasis;
 /**
@@ -31,4 +31,3 @@ export declare function parseSpectralWavelengthSample(value: unknown, path?: str
  * Parses a positive non-empty wavelength interval in nanometres.
  */
 export declare function parseSpectralWavelengthRangeNanometers(value: unknown, path?: string): SpectralWavelengthRangeNanometers;
-//# sourceMappingURL=spectral.d.ts.map

package/dist/core/spectral.js

@@ -1,17 +1,19 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Parses a wavelength basis without inferring air/vacuum conversion.
- * Parses one positive wavelength coordinate in nanometres.
+ * Wavelength types and parsers: a wavelength basis (air or vacuum), a single wavelength and a
+ * wavelength interval, all in nanometres.
  * @see docs/API_STYLE.md for equations, coordinate/unit conventions, blockers and support limits.
  */
+import { rejectUnknownFields } from "./record-validation.js";
 import { InvalidConfigurationError } from "./configuration-error.js";
-function requireRecord(value, path) {
+function requireRecord(value, path, allowedKeys) {
     if (typeof value !== "object" ||
         value === null ||
         Array.isArray(value)) {
         throw new InvalidConfigurationError(path + " must be an object.");
     }
+    if (allowedKeys !== null)
+        rejectUnknownFields(value, allowedKeys, path);
     return value;
 }
 function requirePositiveFinite(value, path) {
@@ -23,7 +25,7 @@ function requirePositiveFinite(value, path) {
     return value;
 }
 /**
- * Parses a wavelength basis without inferring air/vacuum conversion.
+ * Parses a wavelength basis. It never converts between air and vacuum.
  */
 export function parseSpectralWavelengthBasis(value, path = "wavelengthBasis") {
     if (value !== "air" &&
@@ -37,7 +39,7 @@ export function parseSpectralWavelengthBasis(value, path = "wavelengthBasis") {
  * Parses one positive wavelength coordinate in nanometres.
  */
 export function parseSpectralWavelengthSample(value, path = "spectralSample") {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["wavelengthNanometers"]);
     return {
         wavelengthNanometers: requirePositiveFinite(record.wavelengthNanometers, path + ".wavelengthNanometers")
     };
@@ -46,7 +48,7 @@ export function parseSpectralWavelengthSample(value, path = "spectralSample") {
  * Parses a positive non-empty wavelength interval in nanometres.
  */
 export function parseSpectralWavelengthRangeNanometers(value, path = "wavelengthRangeNanometers") {
-    const record = requireRecord(value, path);
+    const record = requireRecord(value, path, ["minimum", "maximum"]);
     const minimum = requirePositiveFinite(record.minimum, path + ".minimum");
     const maximum = requirePositiveFinite(record.maximum, path + ".maximum");
     if (!(minimum < maximum)) {

package/dist/core/spectral.js.map

@@ -1 +1 @@
-{"version":3,"file":"spectral.js","sourceRoot":"","sources":["../../src/core/spectral.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AA+BrE,SAAS,aAAa,CACpB,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,qBAAqB,CAC7B,CAAC;IACJ,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC,EACV,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,wCAAwC,CAChD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAc,EACd,IAAI,GAAG,iBAAiB;IAExB,IACE,KAAK,KAAK,KAAK;QACf,KAAK,KAAK,QAAQ;QAClB,KAAK,KAAK,aAAa,EACvB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,cAAc,CACtB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,IAAI,GAAG,gBAAgB;IAEvB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO;QACL,oBAAoB,EAClB,qBAAqB,CACnB,MAAM,CAAC,oBAAoB,EAC3B,IAAI,GAAG,uBAAuB,CAC/B;KACJ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sCAAsC,CACpD,KAAc,EACd,IAAI,GAAG,2BAA2B;IAElC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,qBAAqB,CACnC,MAAM,CAAC,OAAO,EACd,IAAI,GAAG,UAAU,CAClB,CAAC;IACF,MAAM,OAAO,GAAG,qBAAqB,CACnC,MAAM,CAAC,OAAO,EACd,IAAI,GAAG,UAAU,CAClB,CAAC;IAEF,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,qCAAqC,CAC7C,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"spectral.js","sourceRoot":"","sources":["../../src/core/spectral.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AA+BrE,SAAS,aAAa,CACpB,KAAc,EACd,IAAY,EACZ,WAAqC;IAErC,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,qBAAqB,CAC7B,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,KAAK,IAAI;QAAE,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACxE,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC,EACV,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,wCAAwC,CAChD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAc,EACd,IAAI,GAAG,iBAAiB;IAExB,IACE,KAAK,KAAK,KAAK;QACf,KAAK,KAAK,QAAQ;QAClB,KAAK,KAAK,aAAa,EACvB,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,cAAc,CACtB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,IAAI,GAAG,gBAAgB;IAEvB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACpE,OAAO;QACL,oBAAoB,EAClB,qBAAqB,CACnB,MAAM,CAAC,oBAAoB,EAC3B,IAAI,GAAG,uBAAuB,CAC/B;KACJ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sCAAsC,CACpD,KAAc,EACd,IAAI,GAAG,2BAA2B;IAElC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,qBAAqB,CACnC,MAAM,CAAC,OAAO,EACd,IAAI,GAAG,UAAU,CAClB,CAAC;IACF,MAAM,OAAO,GAAG,qBAAqB,CACnC,MAAM,CAAC,OAAO,EACd,IAAI,GAAG,UAAU,CAClB,CAAC;IAEF,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,yBAAyB,CACjC,IAAI,GAAG,qCAAqC,CAC7C,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Wavelength types and parsers: a wavelength basis (air or vacuum), a single wavelength and a\n * wavelength interval, all in nanometres.\n * @see docs/API_STYLE.md for equations, coordinate/unit conventions, blockers and support limits.\n */\n\nimport { rejectUnknownFields } from \"./record-validation.js\";\nimport { InvalidConfigurationError } from \"./configuration-error.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\n/**\n * Whether wavelengths are measured in air or in vacuum.\n *\n * \"unspecified\" is allowed only where a downstream contract explicitly accepts\n * unresolved or approximate wavelengths. Calibrated physical calculations must\n * resolve the basis first.\n */\nexport type SpectralWavelengthBasis =\n  | \"air\"\n  | \"vacuum\"\n  | \"unspecified\";\n\n/**\n * One wavelength coordinate expressed in nanometres.\n */\nexport interface SpectralWavelengthSample {\n  wavelengthNanometers: number;\n}\n\n/**\n * Closed wavelength interval expressed in nanometres.\n */\nexport interface SpectralWavelengthRangeNanometers {\n  minimum: number;\n  maximum: number;\n}\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Array.isArray(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be an object.\"\n    );\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction 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 InvalidConfigurationError(\n      path + \" must be finite and greater than zero.\"\n    );\n  }\n  return value;\n}\n\n/**\n * Parses a wavelength basis. It never converts between air and vacuum.\n */\nexport function parseSpectralWavelengthBasis(\n  value: unknown,\n  path = \"wavelengthBasis\"\n): SpectralWavelengthBasis {\n  if (\n    value !== \"air\" &&\n    value !== \"vacuum\" &&\n    value !== \"unspecified\"\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" is invalid.\"\n    );\n  }\n  return value;\n}\n\n/**\n * Parses one positive wavelength coordinate in nanometres.\n */\nexport function parseSpectralWavelengthSample(\n  value: unknown,\n  path = \"spectralSample\"\n): SpectralWavelengthSample {\n  const record = requireRecord(value, path, [\"wavelengthNanometers\"]);\n  return {\n    wavelengthNanometers:\n      requirePositiveFinite(\n        record.wavelengthNanometers,\n        path + \".wavelengthNanometers\"\n      )\n  };\n}\n\n/**\n * Parses a positive non-empty wavelength interval in nanometres.\n */\nexport function parseSpectralWavelengthRangeNanometers(\n  value: unknown,\n  path = \"wavelengthRangeNanometers\"\n): SpectralWavelengthRangeNanometers {\n  const record = requireRecord(value, path, [\"minimum\", \"maximum\"]);\n  const minimum = requirePositiveFinite(\n    record.minimum,\n    path + \".minimum\"\n  );\n  const maximum = requirePositiveFinite(\n    record.maximum,\n    path + \".maximum\"\n  );\n\n  if (!(minimum < maximum)) {\n    throw new InvalidConfigurationError(\n      path + \".minimum must be less than maximum.\"\n    );\n  }\n\n  return { minimum, maximum };\n}\n"]}

package/dist/core/validation.d.ts

@@ -1,7 +1,5 @@
 /**
- * Module boundary and integration notes.
- * Requires a finite number greater than zero.
- * Requires a positive safe integer.
+ * Error types for invalid input and non-finite results, plus basic numeric input checks.
  * @see docs/API_STYLE.md for equations, coordinate/unit conventions, blockers and support limits.
  */
 /**
@@ -12,8 +10,8 @@ export declare class InvalidScientificInputError extends RangeError {
     constructor(message: string);
 }
 /**
- * Error thrown when a scientific calculation would return a non-finite
- * numeric value that is unsafe for JSON and downstream consumers.
+ * Error thrown when a calculation would return a non-finite number (NaN or ±Infinity).
+ * Such values cannot be stored in JSON and break downstream consumers.
  */
 export declare class InvalidScientificResultError extends RangeError {
     readonly code = "INVALID_SCIENTIFIC_RESULT";
@@ -33,4 +31,3 @@ export declare function requirePositiveFinite(name: string, value: number): void
  * @param value Value to validate.
  */
 export declare function requirePositiveInteger(name: string, value: number): void;
-//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.js

@@ -1,8 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Module boundary and integration notes.
- * Requires a finite number greater than zero.
- * Requires a positive safe integer.
+ * Error types for invalid input and non-finite results, plus basic numeric input checks.
  * @see docs/API_STYLE.md for equations, coordinate/unit conventions, blockers and support limits.
  */
 /**
@@ -16,8 +14,8 @@ export class InvalidScientificInputError extends RangeError {
     }
 }
 /**
- * Error thrown when a scientific calculation would return a non-finite
- * numeric value that is unsafe for JSON and downstream consumers.
+ * Error thrown when a calculation would return a non-finite number (NaN or ±Infinity).
+ * Such values cannot be stored in JSON and break downstream consumers.
  */
 export class InvalidScientificResultError extends RangeError {
     code = "INVALID_SCIENTIFIC_RESULT";

package/dist/core/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,UAAU;IAChD,IAAI,GAAG,0BAA0B,CAAC;IAE3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,4BAA6B,SAAQ,UAAU;IACjD,IAAI,GAAG,2BAA2B,CAAC;IAE5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,KAAa;IAC/D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,2BAA2B,CACnC,GAAG,IAAI,6CAA6C,CACrD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,KAAa;IAChE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,2BAA2B,CACnC,GAAG,IAAI,mCAAmC,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;GAGG;AAEH;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,UAAU;IAChD,IAAI,GAAG,0BAA0B,CAAC;IAE3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,4BAA6B,SAAQ,UAAU;IACjD,IAAI,GAAG,2BAA2B,CAAC;IAE5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,KAAa;IAC/D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,2BAA2B,CACnC,GAAG,IAAI,6CAA6C,CACrD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,KAAa;IAChE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,2BAA2B,CACnC,GAAG,IAAI,mCAAmC,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Error types for invalid input and non-finite results, plus basic numeric input checks.\n * @see docs/API_STYLE.md for equations, coordinate/unit conventions, blockers and support limits.\n */\n\n/**\n * Error thrown when a public scientific calculation receives invalid input.\n */\nexport class InvalidScientificInputError extends RangeError {\n  readonly code = \"INVALID_SCIENTIFIC_INPUT\";\n\n  constructor(message: string) {\n    super(message);\n    this.name = \"InvalidScientificInputError\";\n  }\n}\n\n/**\n * Error thrown when a calculation would return a non-finite number (NaN or ±Infinity).\n * Such values cannot be stored in JSON and break downstream consumers.\n */\nexport class InvalidScientificResultError extends RangeError {\n  readonly code = \"INVALID_SCIENTIFIC_RESULT\";\n\n  constructor(message: string) {\n    super(message);\n    this.name = \"InvalidScientificResultError\";\n  }\n}\n\n/**\n * Requires a finite number greater than zero.\n *\n * @param name Public parameter name.\n * @param value Value to validate.\n */\nexport function requirePositiveFinite(name: string, value: number): void {\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new InvalidScientificInputError(\n      `${name} must be a finite number greater than zero.`\n    );\n  }\n}\n\n/**\n * Requires a positive safe integer.\n *\n * @param name Public parameter name.\n * @param value Value to validate.\n */\nexport function requirePositiveInteger(name: string, value: number): void {\n  if (!Number.isSafeInteger(value) || value <= 0) {\n    throw new InvalidScientificInputError(\n      `${name} must be a positive safe integer.`\n    );\n  }\n}\n"]}

package/dist/core/version.d.ts

@@ -1,9 +1,9 @@
 /**
- * Version of the public root-engine release, aligned with the npm package since 1.0.1.
- * New captures and plans record this creator identity; archived records retain theirs.
- * POC, schema and model contracts keep their independent versions.
- * Release checks enforce equality with package.json and the packed distribution.
+ * Version of the engine release. Since 1.0.1 it equals the npm package version.
+ *
+ * New captures and plans record this version as their creator. Archived records keep the
+ * version they were made with. Proof-of-concept (POC), schema and model contracts have their
+ * own versions. Release checks confirm it matches package.json and the packed package.
  * @see docs/RELEASE_1_0_1.md
  */
-export declare const ENGINE_API_VERSION: "1.5.0";
-//# sourceMappingURL=version.d.ts.map
+export declare const ENGINE_API_VERSION: "2.1.0";

package/dist/core/version.js

@@ -1,10 +1,11 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Version of the public root-engine release, aligned with the npm package since 1.0.1.
- * New captures and plans record this creator identity; archived records retain theirs.
- * POC, schema and model contracts keep their independent versions.
- * Release checks enforce equality with package.json and the packed distribution.
+ * Version of the engine release. Since 1.0.1 it equals the npm package version.
+ *
+ * New captures and plans record this version as their creator. Archived records keep the
+ * version they were made with. Proof-of-concept (POC), schema and model contracts have their
+ * own versions. Release checks confirm it matches package.json and the packed package.
  * @see docs/RELEASE_1_0_1.md
  */
-export const ENGINE_API_VERSION = "1.5.0";
+export const ENGINE_API_VERSION = "2.1.0";
 //# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAgB,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAgB,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Version of the engine release. Since 1.0.1 it equals the npm package version.\n *\n * New captures and plans record this version as their creator. Archived records keep the\n * version they were made with. Proof-of-concept (POC), schema and model contracts have their\n * own versions. Release checks confirm it matches package.json and the packed package.\n * @see docs/RELEASE_1_0_1.md\n */\nexport const ENGINE_API_VERSION = \"2.1.0\" as const;\n"]}

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

@@ -85,8 +85,8 @@ export interface ResolvedGenericEquipmentExposureCapabilities {
         settingGrid: ResolvedNumericSettingGrid;
         autoIsoAvailability: GenericCapabilityAvailability;
         /**
-         * Optional Auto-ISO-only bounds. Manual ISO continues to use minimum /
-         * maximum and the complete standard setting grid.
+         * Optional bounds that apply only to Auto ISO. Manual ISO still uses the
+         * minimum, the maximum and the complete standard setting grid.
          */
         autoIsoMinimum?: number;
         autoIsoMaximum?: number;
@@ -102,24 +102,24 @@ export interface ResolveGenericEquipmentExposureCapabilitiesInput {
 /**
  * Parses a generic Photivra body exposure-capability profile.
  *
- * This is capability metadata only. ISO values do not imply noise/gain
- * topology, and shutter-duration capability does not imply one shutter
- * mechanism or sensor-readout schedule.
+ * This is capability metadata only. ISO values say nothing about how noise or
+ * gain is implemented. Shutter-duration capability does not imply a
+ * particular shutter mechanism or sensor-readout schedule.
  */
 export declare function parseGenericBodyExposureCapabilityProfile(value: unknown): GenericBodyExposureCapabilityProfile;
 /**
  * Parses a generic Photivra lens exposure-capability profile.
  *
- * "Widest" is expressed as the smallest available f-number, avoiding the
- * ambiguous phrases minimum/maximum aperture.
+ * "Widest" means the smallest available f-number. This avoids the ambiguous
+ * phrases "minimum aperture" and "maximum aperture".
  */
 export declare function parseGenericLensExposureCapabilityProfile(value: unknown): GenericLensExposureCapabilityProfile;
 /**
  * Resolves the exposure-relevant capability subset for one generic body+lens
  * combination at one selected focal length.
  *
- * Source profiles are immutable inputs. This resolver does not choose exposure
- * settings; it only provides the capability envelope consumed by #99.
+ * The source profiles are not changed. This resolver does not choose exposure
+ * settings. It only provides the range of available settings (the capability
+ * envelope) that the exposure-mode resolvers use.
  */
 export declare function resolveGenericEquipmentExposureCapabilities(input: ResolveGenericEquipmentExposureCapabilitiesInput): ResolvedGenericEquipmentExposureCapabilities;
-//# sourceMappingURL=exposure-capabilities.d.ts.map