@photivra/engine 2.13.0 → 2.14.0

package/docs/api/equipment-generic-tier-presets.md

@@ -16,10 +16,18 @@ This call is synchronous; any supplied provider must follow its explicit synchro
 
 ## GENERIC_EQUIPMENT_TIER_PRESET_VERSION
 
-The exact contract is declared below; use the domain guide for assumptions and staged integration.
+The current preset version (2.14: 2.1.0, third-stop ISO settings).
+
+```ts
+GENERIC_EQUIPMENT_TIER_PRESET_VERSION = "2.1.0" as const
+```
+
+## GENERIC_EQUIPMENT_TIER_PRESET_VERSIONS
+
+Every exact preset version that resolves, oldest first. A version is never retuned in place (`test/generic-tier-presets.test.ts`).
 
 ```ts
-GENERIC_EQUIPMENT_TIER_PRESET_VERSION = "2.0.0" as const
+GENERIC_EQUIPMENT_TIER_PRESET_VERSIONS = Object.freeze(["2.0.0", "2.1.0"] as const)
 ```
 
 ## GENERIC_EQUIPMENT_TIERS
@@ -44,7 +52,7 @@ The exact contract is declared below; use the domain guide for assumptions and s
 
 ```ts
 export interface GenericEquipmentTierSelection {
-  schemaVersion: "0.1.0"; presetVersion: typeof GENERIC_EQUIPMENT_TIER_PRESET_VERSION;
+  schemaVersion: "0.1.0"; presetVersion: GenericTierPresetVersion;
   bodyTier: GenericEquipmentTier; lensTier: GenericEquipmentTier;
   bodyPresetId: string; lensPresetId: string;
   profileReferences: readonly GenericEquipmentTierProfileReference[];

package/docs/api/exports.json

@@ -1,6 +1,6 @@
 {
-  "packageVersion": "2.13.0",
-  "engineApiVersion": "2.13.0",
+  "packageVersion": "2.14.0",
+  "engineApiVersion": "2.14.0",
   "exports": [
     {
       "name": "AbsoluteUncertaintyEstimate",
@@ -2077,6 +2077,26 @@
       "source": "src/color/colorimetry-math.ts",
       "kind": "type"
     },
+    {
+      "name": "COLOR_PATCH_IDS",
+      "source": "src/facade/color-patches.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "COLOR_PATCH_SET_ID",
+      "source": "src/facade/color-patches.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "COLOR_PATCH_SET_VERSION",
+      "source": "src/facade/color-patches.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "COLOR_PATCH_WAVELENGTH_RANGE_NANOMETERS",
+      "source": "src/facade/color-patches.ts",
+      "kind": "runtime"
+    },
     {
       "name": "COLOR_TEMPERATURE_WHITE_BALANCE_INTENT_VERSION",
       "source": "src/color/white-balance.ts",
@@ -2122,6 +2142,41 @@
       "source": "src/color/colorimetry-math.ts",
       "kind": "type"
     },
+    {
+      "name": "ColorPatch",
+      "source": "src/facade/color-patches.ts",
+      "kind": "type"
+    },
+    {
+      "name": "ColorPatchesChartScene",
+      "source": "src/facade/chart-scenes.ts",
+      "kind": "type"
+    },
+    {
+      "name": "ColorPatchGroup",
+      "source": "src/facade/color-patches.ts",
+      "kind": "type"
+    },
+    {
+      "name": "ColorPatchId",
+      "source": "src/facade/color-patches.ts",
+      "kind": "type"
+    },
+    {
+      "name": "ColorPatchReflectance",
+      "source": "src/facade/chart-scenes.ts",
+      "kind": "type"
+    },
+    {
+      "name": "ColorPatchSet",
+      "source": "src/facade/color-patches.ts",
+      "kind": "type"
+    },
+    {
+      "name": "ColorPatchSpectralTerm",
+      "source": "src/facade/color-patches.ts",
+      "kind": "type"
+    },
     {
       "name": "ColorSamplingChannelComposition",
       "source": "src/sensor/capture-color-sampling-binding.ts",
@@ -2922,6 +2977,16 @@
       "source": "src/color/rgb-color-spaces.ts",
       "kind": "runtime"
     },
+    {
+      "name": "evaluateColorPatchReflectance",
+      "source": "src/facade/color-patches.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "EvaluateColorPatchReflectanceInput",
+      "source": "src/facade/color-patches.ts",
+      "kind": "type"
+    },
     {
       "name": "evaluateSceneIlluminationTemporalMultiplier",
       "source": "src/schema/illumination-temporal.ts",
@@ -3367,6 +3432,11 @@
       "source": "src/equipment/generic-tier-presets.ts",
       "kind": "runtime"
     },
+    {
+      "name": "GENERIC_EQUIPMENT_TIER_PRESET_VERSIONS",
+      "source": "src/equipment/generic-tier-presets.ts",
+      "kind": "runtime"
+    },
     {
       "name": "GENERIC_EQUIPMENT_TIERS",
       "source": "src/equipment/generic-tier-presets.ts",
@@ -3407,6 +3477,21 @@
       "source": "src/equipment/release-capabilities.ts",
       "kind": "runtime"
     },
+    {
+      "name": "GENERIC_THIRD_STOP_ISO_SETTINGS",
+      "source": "src/equipment/generic-tier-assets.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "GENERIC_THIRD_STOP_SHUTTER_SECONDS",
+      "source": "src/equipment/generic-tier-assets.ts",
+      "kind": "runtime"
+    },
+    {
+      "name": "GENERIC_WHOLE_STOP_ISO_SETTINGS",
+      "source": "src/equipment/generic-tier-assets.ts",
+      "kind": "runtime"
+    },
     {
       "name": "GenericBodyExposureCapabilityProfile",
       "source": "src/equipment/exposure-capabilities.ts",
@@ -3527,6 +3612,11 @@
       "source": "src/equipment/generic-tier-assets.ts",
       "kind": "type"
     },
+    {
+      "name": "GenericTierPresetVersion",
+      "source": "src/equipment/generic-tier-assets.ts",
+      "kind": "type"
+    },
     {
       "name": "GenericVersionedAsset",
       "source": "src/equipment/generic-tier-assets.ts",
@@ -3582,6 +3672,11 @@
       "source": "src/output/geometric-transforms.ts",
       "kind": "type"
     },
+    {
+      "name": "getColorPatchSet",
+      "source": "src/facade/color-patches.ts",
+      "kind": "runtime"
+    },
     {
       "name": "getImageFormationContract",
       "source": "src/core/image-formation.ts",
@@ -8167,6 +8262,11 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "runtime"
     },
+    {
+      "name": "SIMULATE_CAPTURE_METERING_MODES",
+      "source": "src/facade/simulate-capture.ts",
+      "kind": "runtime"
+    },
     {
       "name": "SIMULATE_DISPLAY_VIEW_DEFAULT_SAMPLES_PER_AXIS",
       "source": "src/facade/simulate-capture.ts",
@@ -8252,6 +8352,11 @@
       "source": "src/facade/simulate-capture.ts",
       "kind": "type"
     },
+    {
+      "name": "SimulateCaptureMetering",
+      "source": "src/facade/simulate-capture.ts",
+      "kind": "type"
+    },
     {
       "name": "SimulateCaptureMotion",
       "source": "src/facade/simulate-capture.ts",

package/docs/api/facade-chart-scenes.md

@@ -97,6 +97,7 @@ CHART_SCENE_DEFAULTS = Object.freeze({
   "slanted-squares": Object.freeze({ columns: 3, rows: 2, sizeFraction: 0.5, angleDegrees: 5, darkReflectance: 0.15, lightReflectance: 0.6 }),
   "line-grid": Object.freeze({ spacing: 1 / 3, lineWidth: 0.01, lineReflectance: 0.42, backgroundReflectance: 0.6 }),
   fiducial: Object.freeze({ radiusFraction: 0.8, ringFraction: 0.18, inverted: false, darkReflectance: 0.05, lightReflectance: 0.8, backgroundReflectance: 0.18 }),
+  "color-patches": Object.freeze({ patchIds: COLOR_PATCH_IDS, gapFraction: 0.1, backgroundReflectance: 0.18 }),
   composite: Object.freeze({ background: Object.freeze({ preset: "uniform" as const, reflectance: 0.18 }) })
 })
 ```
@@ -108,7 +109,7 @@ The exact contract is declared below; use the domain guide for assumptions and s
 ```ts
 CHART_SCENE_PRESETS: readonly ChartScenePresetId[] = Object.freeze(["uniform", "slanted-edge", "siemens-star",
   "step-wedge", "grey-ramp", "checkerboard", "point-grid", "patches", "dead-leaves", "bar-groups", "hyperbolic-wedge", "zone-plate",
-  "slanted-squares", "line-grid", "fiducial", "composite"] as const)
+  "slanted-squares", "line-grid", "fiducial", "color-patches", "composite"] as const)
 ```
 
 ## CHART_SPECTRAL_RANGE_NANOMETERS
@@ -144,7 +145,7 @@ Any chart preset except `composite`: a composite's background or element.
 
 ```ts
 export type ChartElementScene = UniformChartScene | SlantedEdgeChartScene | SiemensStarChartScene | StepWedgeChartScene | GreyRampChartScene |
-  CheckerboardChartScene | PointGridChartScene | PatchChartScene | DeadLeavesChartScene | BarGroupsChartScene | HyperbolicWedgeChartScene |
+  CheckerboardChartScene | PointGridChartScene | PatchChartScene | ColorPatchesChartScene | DeadLeavesChartScene | BarGroupsChartScene | HyperbolicWedgeChartScene |
   ZonePlateChartScene | SlantedSquaresChartScene | LineGridChartScene | FiducialChartScene;
 ```
 
@@ -158,10 +159,11 @@ export interface ChartRectangle { u0: number; v0: number; u1: number; v1: number
 
 ## ChartReflectance
 
-A neutral (spectrally flat) reflectance in [0, 1], or a caller reflectance spectrum (values in [0, 1]).
+A neutral (spectrally flat) reflectance in [0, 1], a caller reflectance spectrum (values in [0, 1]) or, from 2.14, a
+built-in color patch `{ kind: "color-patch", patchId }`.
 
 ```ts
-export type ChartReflectance = number | ColorimetricSpectrum;
+export type ChartReflectance = number | ColorimetricSpectrum | ColorPatchReflectance;
 ```
 
 ## ChartScene
@@ -213,6 +215,35 @@ export interface CheckerboardChartScene {
 }
 ```
 
+## ColorPatchesChartScene
+
+2.14: the built-in Photivra color patches (`getColorPatchSet()`) in a grid, drawn like `patches`: row-major, each
+patch centred in an equal cell with a neutral gap around it. The spectra are the engine's own analytic designs; no
+third-party chart data, names, order or layout are used.
+
+```ts
+export interface ColorPatchesChartScene {
+  preset: "color-patches";
+  /** Patches to draw, row-major, distinct. Default: the whole set in `COLOR_PATCH_IDS` order (30 patches, six per row). */
+  patchIds?: readonly ColorPatchId[];
+  /** Patches per row, 1 to the patch count. Default min(6, patch count). */
+  columns?: number;
+  /** Gap between patches as a fraction of the cell size, [0, 0.5). Default 0.1. */
+  gapFraction?: number;
+  /** Neutral reflectance of the gaps and empty cells. Default 0.18. */
+  backgroundReflectance?: number;
+}
+```
+
+## ColorPatchReflectance
+
+2.14: one of the engine's built-in color patches (see `getColorPatchSet()`): its reflectance spectrum, Photivra's own
+analytic design, rendered through the same spectral path as a caller spectrum.
+
+```ts
+export interface ColorPatchReflectance { kind: "color-patch"; patchId: ColorPatchId }
+```
+
 ## CompositeChartElement
 
 One element of a composite chart: a preset drawn inside its placement rectangle (frame units of the
@@ -346,7 +377,7 @@ The exact contract is declared below; use the domain guide for assumptions and s
 ```ts
 export interface PatchChartScene {
   preset: "patches";
-  /** Caller reflectance per patch, row-major; the facade bundles no colour-chart data. 1..1024 patches. */
+  /** Caller reflectance per patch, row-major; the facade bundles no color-chart data. 1..1024 patches. */
   patches: readonly { patchId: string; reflectance: ChartReflectance }[];
   /** Patches per row. Default ceil(sqrt(patch count)). */
   columns?: number;

package/docs/api/facade-color-patches.md

@@ -0,0 +1,150 @@
+# facade/color-patches.ts public contracts
+
+The package and root API versions are recorded once in [Navigation](../API_REFERENCE.md) · [Developer guide](https://github.com/Photivra/photivra/blob/main/docs/DEVELOPERS.md). Generated signatures retain independent schema/model versions. Only the exports listed here are root-package contracts; module-local helpers are not supported deep imports.
+
+## COLOR_PATCH_IDS
+
+The ids of the built-in patches, in the order of the `color-patches` chart (row-major, six per row).
+
+```ts
+COLOR_PATCH_IDS = Object.freeze([
+  "neutral-1", "neutral-2", "neutral-3", "neutral-4", "neutral-5", "neutral-6",
+  "red", "yellow", "green", "cyan", "blue", "magenta",
+  "red-soft", "yellow-soft", "green-soft", "cyan-soft", "blue-soft", "magenta-soft",
+  "skin-pale", "skin-medium", "skin-tan", "skin-deep", "sky-blue", "foliage-green",
+  "brick-red", "sand", "teal", "lavender", "deep-orange", "deep-violet"
+] as const)
+```
+
+## COLOR_PATCH_SET_ID
+
+Identity of the built-in patch set.
+
+```ts
+COLOR_PATCH_SET_ID = "photivra-color-patches"
+```
+
+## COLOR_PATCH_SET_VERSION
+
+Version of the patch set's spectra and reference values; a change to any spectrum changes it.
+
+```ts
+COLOR_PATCH_SET_VERSION = "1.0.0"
+```
+
+## COLOR_PATCH_WAVELENGTH_RANGE_NANOMETERS
+
+Wavelengths on which every patch spectrum is defined, nanometers, inclusive.
+
+```ts
+COLOR_PATCH_WAVELENGTH_RANGE_NANOMETERS = Object.freeze({ minimum: 360, maximum: 830 })
+```
+
+## ColorPatch
+
+One built-in patch: its id, short code, name, reason for being on the chart, spectrum definition and reference
+colorimetry.
+
+```ts
+export interface ColorPatch {
+  /** Stable API id, e.g. `"skin-medium"`. */
+  patchId: ColorPatchId;
+  /**
+   * Stable short code for labels and printed charts: `PV-` and a group letter and number, e.g. `"PV-N4"`. The letters are
+   * N neutral, S strong, T soft (tint), P skin (portrait), M memory and G gamut-edge, numbered in chart order.
+   */
+  code: string;
+  /** Photivra's own descriptive name, in US English, e.g. `"Studio Gray 4"`; not a third-party color name. */
+  name: string;
+  group: ColorPatchGroup;
+  /** One sentence: why the patch is on the chart. */
+  reason: string;
+  /** The constant b of the formula. */
+  base: number;
+  terms: readonly ColorPatchSpectralTerm[];
+  /**
+   * Reference colorimetry of the reflectance (not of a rendered capture): CIELAB under CIE illuminant D65 with the CIE
+   * 1931 2° observer, the CIE tables at 1 nm over 360–830 nm, white = the perfect diffuser under D65 (Y = 100); and the
+   * sRGB color of that XYZ (CSS Color 4 matrix, after XYZ scaling of the D65 table white to the sRGB white),
+   * 8-bit hex. Rounded for publication: L*, a*, b* to 0.01.
+   */
+  reference: { cielabD65: readonly [number, number, number]; srgbHex: string; inSrgbGamut: boolean };
+}
+```
+
+## ColorPatchGroup
+
+Groups of the patch set, in chart order.
+
+```ts
+export type ColorPatchGroup = "neutral" | "strong" | "soft" | "skin" | "memory" | "gamut-edge";
+```
+
+## ColorPatchId
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+export type ColorPatchId = (typeof COLOR_PATCH_IDS)[number];
+```
+
+## ColorPatchSet
+
+The built-in patch set (see {@link getColorPatchSet}).
+
+```ts
+export interface ColorPatchSet {
+  setId: typeof COLOR_PATCH_SET_ID;
+  version: typeof COLOR_PATCH_SET_VERSION;
+  wavelengthRangeNanometers: { minimum: number; maximum: number };
+  /** Patches per row of the `color-patches` chart's default layout. */
+  columns: number;
+  patches: readonly ColorPatch[];
+}
+```
+
+## ColorPatchSpectralTerm
+
+One term of a patch spectrum (see the module formula).
+
+```ts
+export type ColorPatchSpectralTerm =
+  | { kind: "gaussian"; amplitude: number; centerNanometers: number; standardDeviationNanometers: number }
+  | { kind: "logistic-rise" | "logistic-fall"; amplitude: number; midpointNanometers: number; scaleNanometers: number };
+```
+
+## evaluateColorPatchReflectance
+
+The reflectance (dimensionless, in [0, 1]) of a built-in color patch at one wavelength, from its analytic formula.
+Labeled `approximation`: the spectra are Photivra's own smooth designs, not measurements of a physical sample.
+
+```ts
+export function evaluateColorPatchReflectance(input: EvaluateColorPatchReflectanceInput): CalculationResult<{ reflectance: number }>;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.
+
+## EvaluateColorPatchReflectanceInput
+
+Input of {@link evaluateColorPatchReflectance}.
+
+```ts
+export interface EvaluateColorPatchReflectanceInput {
+  patchId: ColorPatchId;
+  /** Vacuum wavelength, nanometers, in 360–830. */
+  wavelengthNanometers: number;
+}
+```
+
+## getColorPatchSet
+
+The built-in Photivra color-patch set: every patch's id, code, name, group, reason, spectrum parameters and reference CIELAB (D65,
+CIE 1931 2°) and sRGB values. A static, deeply frozen engine contract. Pass a patch to a chart as
+`{ kind: "color-patch", patchId }` wherever a chart reflectance is accepted, or draw the whole set with the
+`color-patches` chart preset.
+
+```ts
+export function getColorPatchSet(): ColorPatchSet;
+```
+
+This call is synchronous; any supplied provider must follow its explicit synchronous contract.

package/docs/api/facade-simulate-capture.md

@@ -21,10 +21,17 @@ export interface DisplayViewResult {
    */
   view: { width: number; height: number; frameWidth: number; frameHeight: number; scaleX: number; scaleY: number; samplesPerAxis: number;
     region?: { x: number; y: number; width: number; height: number } };
-  /** The resolved exposure of the capture this view shows; `standardExposureDeviationStops` and `standardExposureIlluminanceLux` as in {@link SimulateCaptureResult}. */
+  /**
+   * The resolved exposure of the capture this view shows; `standardExposureDeviationStops`, `standardExposureIlluminanceLux`
+   * and `greyCardDeviationStops` as in {@link SimulateCaptureResult}.
+   */
   exposure: { mode: SimulateCaptureExposureMode; settings: { fNumber: number; shutterSeconds: number; iso: number }; ev100: number; standardExposureDeviationStops: number | null;
     /** As in the capture result. */
     standardExposureIlluminanceLux: number | null;
+    /** 2.14: as in the capture result. */
+    greyCardDeviationStops: number | null;
+    /** 2.14: as in the capture result. */
+    metering: SimulateCaptureMetering;
     /** #516: as in the capture result. */
     isoControl: "manual" | "automatic"; autoIso?: SimulateCaptureAutoIsoReport };
   scene: SimulateCaptureResult["scene"];
@@ -136,6 +143,14 @@ whether or not it has a fast method yet; one without runs exact and reports `fal
 SIMULATE_CAPTURE_FAST_OPTIONS = Object.freeze(["lens.diffraction", "sensor.antiAliasing", "sensor.pixelAperture.box", "output.demosaic.ahd"] as const)
 ```
 
+## SIMULATE_CAPTURE_METERING_MODES
+
+The exact contract is declared below; use the domain guide for assumptions and staged integration.
+
+```ts
+SIMULATE_CAPTURE_METERING_MODES: readonly SimulateCaptureMetering[] = Object.freeze(["scene-average", "grey-card"] as const)
+```
+
 ## SIMULATE_DISPLAY_VIEW_DEFAULT_SAMPLES_PER_AXIS
 
 Default stratified samples per axis of a display view (`view.samplesPerAxis`): 16 × 16 sampled real pixels per display pixel with detail, 4 × 4 where it is uniform.
@@ -221,6 +236,8 @@ export interface SimulateCaptureAutoIsoReport {
   slowestPreferredShutterApplied?: boolean;
   /** #504: present only with `slowestPreferredShutterSeconds: "auto"`: how the engine derived it (`estimateAutoIsoSlowestShutter`). */
   automaticSlowestShutter?: SimulateCaptureAutomaticSlowestShutterReport;
+  /** 2.14: present when `exposure.autoIso.isoSteps` is given: the ISO steps Auto ISO chose from. */
+  isoSteps?: "whole-stop" | "third-stop";
 }
 ```
 
@@ -369,6 +386,17 @@ export type SimulateCaptureLensDistortion =
   | { kind: "brown-conrady"; profile: BrownConradyDistortionProfile };
 ```
 
+## SimulateCaptureMetering
+
+2.14: what the meter reads. `scene-average` (the default): the body's 16 × 16-zone meter reads the scene's luminance.
+`grey-card`: incident metering; every zone reads the luminance 0.18·E/π of an 18 % Lambertian grey card under the
+request's illuminance E, so the automatic modes choose settings whose `greyCardDeviationStops` is 0 (up to their steps
+and limits), whatever the scene's reflectances.
+
+```ts
+export type SimulateCaptureMetering = "scene-average" | "grey-card";
+```
+
 ## SimulateCaptureMotion
 
 The exact contract is declared below; use the domain guide for assumptions and staged integration.
@@ -467,13 +495,22 @@ export interface SimulateCaptureOptions {
      *   `maximum` (default: the body's minimum). Outside the body's range or off its ISO grid the request fails; the
      *   engine never clips a limit. When the ISO stops at a limit strictly inside the body's range, the report's
      *   `limitingConstraint` is `"user-iso-maximum"` or `"user-iso-minimum"`.
+     * - `isoSteps` (2.14): `"whole-stop"` (default) lets Auto ISO choose only the whole-stop ISOs of the body's grid
+     *   (100, 200, 400 …), as before the generic bodies gained third-stop settings (preset 2.1.0); `"third-stop"` lets it
+     *   choose every setting (100, 125, 160 …). Manual ISO always takes any setting of the grid. Limits must lie on the
+     *   grid Auto ISO uses.
      */
     autoIso?: { slowestPreferredShutterSeconds?: number | "auto"; afterMaximumIso?: SimulateCaptureAutoIsoAfterMaximum; limits?: AutoIsoLimits;
-      automaticSlowestShutter?: SimulateCaptureAutomaticSlowestShutterOptions };
+      automaticSlowestShutter?: SimulateCaptureAutomaticSlowestShutterOptions; isoSteps?: "whole-stop" | "third-stop" };
     /** Shutter for manual and shutter-priority modes. Default 1/125 s. */
     shutterSeconds?: number;
     /** Exposure compensation applied to the meter target, in stops. Default 0. */
     compensationStops?: number;
+    /**
+     * 2.14: `"scene-average"` (default) or `"grey-card"` (incident metering, see {@link SimulateCaptureMetering}). Manual
+     * exposure does not use the meter's reading, so the setting changes only the automatic modes and Auto ISO.
+     */
+    metering?: SimulateCaptureMetering;
   };
   /**
    * Required: an engine chart (for example `{ preset: "uniform" }`, an 18 % grey card), a declared `material-layers` scene (#491:
@@ -682,6 +719,9 @@ export interface SimulateCaptureResult {
     isoControl: "manual" | "automatic";
     /** #516: present with `iso: "auto"`: how Auto ISO chose `settings.iso` and what limited it. */
     autoIso?: SimulateCaptureAutoIsoReport;
+    /** 2.14: the metering the exposure used (`exposure.metering`; `"scene-average"` when omitted). */
+    metering: SimulateCaptureMetering;
+    /** The scene's average luminance on the meter's zones, cd/m², with either metering. */
     meteredSceneLuminanceCdPerSquareMeter: number;
     /**
      * #515: deviation, in stops, of the exposure used from the CIPA DC-004-2020 standard exposure for the metered luminance L:
@@ -697,6 +737,16 @@ export interface SimulateCaptureResult {
      * radiance does not depend on the illuminance. It may exceed the 1e7 lux that `illuminanceLux` accepts.
      */
     standardExposureIlluminanceLux: number | null;
+    /**
+     * 2.14: deviation, in stops, of the exposure used from the CIPA DC-004-2020 standard exposure of an 18 % Lambertian grey
+     * card under the request's illuminance E (incident metering: the light falling on the scene, as a grey card or a
+     * hand-held incident meter reads it): log2(L_ref(N, t, S) / (0.18·E/π)), with L_ref = 10·N²/(0.65·t·S). Same sign as
+     * `standardExposureDeviationStops` (positive is darker, under). It does not depend on the scene's reflectances; with the
+     * default settings and illuminance it is exactly 0. The exposure modes still meter the scene (`meteredSceneLuminanceCdPerSquareMeter`);
+     * this only reports where the settings used sit against the grey card. Null for a radiance-function scene, whose radiance
+     * does not depend on the illuminance.
+     */
+    greyCardDeviationStops: number | null;
     /** Full output of the existing exposure-mode resolver. */
     resolution: unknown;
   };

package/llms.txt

@@ -6,6 +6,7 @@
 
 - [Agent guide](https://github.com/Photivra/photivra/blob/main/docs/AGENT_GUIDE.md): which function to call, units, reading results, errors and limits
 - [Quick start](https://github.com/Photivra/photivra/blob/main/docs/QUICK_START.md): `simulateCapture()` inputs, defaults, chart presets and output formats
+- [Color patches](https://github.com/Photivra/photivra/blob/main/docs/COLOR_PATCHES.md): the built-in color chart patches (`color-patches` preset, `{ kind: "color-patch", patchId }`), their spectra and CIELAB
 - [Usage guide](https://github.com/Photivra/photivra/blob/main/docs/USAGE.md): worked examples for every public area
 - [API reference](https://github.com/Photivra/photivra/blob/main/docs/API_REFERENCE.md): every root export, with a task-to-function index
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@photivra/engine",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "private": false,
   "description": "Scientific TypeScript engine for camera optics, exposure, focus, motion, sensor sampling, diffraction, and digital imaging calculations.",
   "type": "module",
@@ -73,7 +73,7 @@
     "node": ">=22.13.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node scripts/minify-wgsl-dist.mjs",
     "hooks:install": "node scripts/install-git-hooks.mjs",
     "prepush": "node scripts/prepush.mjs",
     "check:static": "eslint . && tsc --noEmit && npm run check:licenses && npm run check:license-headers && npm run check:identity && npm run check:browser-surface",